{
  "contract_version": "gab_058_contract_v1",
  "gab_id": "GAB-058",
  "canonical_name": "StoryCliffhanger",
  "module_owner": "EdTechStoryLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "cliffhanger_id",
    "body",
    "primary_cta",
    "reveal_text"
  ],
  "optional_fields": [
    "icon",
    "question"
  ],
  "field_types": {
    "cliffhanger_id": "string — identifiant unique de l'instance cliffhanger",
    "icon": "string — emoji décoratif (ex: ⚡, 😱)",
    "body": "string — texte narratif principal créant le suspense",
    "question": "string — question rhétorique accrochant l'élève",
    "primary_cta": "object{label, label_revealed, action} — bouton de révélation",
    "reveal_text": "string — texte révélé au clic du CTA (suite narrative)"
  },
  "constraints": [
    "body : texte non vide, créant une tension narrative sans résolution.",
    "reveal_text : texte non vide, révélé uniquement après interaction CTA.",
    "primary_cta.label et label_revealed distincts — label avant clic, label_revealed après.",
    "primary_cta.action doit être 'reveal_next'.",
    "icon : optionnel, emoji unique (1 caractère visible).",
    "question : optionnel, phrase interrogative accrochant l'élève avant révélation."
  ],
  "blocked_conditions": [
    "body absent ou vide (BLOCKED)",
    "reveal_text absent ou vide (BLOCKED)",
    "primary_cta absent ou sans label (BLOCKED)"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "bouton CTA accessible au clavier (Enter/Space)",
    "aria-live sur la zone de révélation"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet avec CTA actif, 0 erreur" },
    { "case": "clic CTA", "expected": "reveal_text affiché, bouton désactivé, label_revealed affiché" },
    { "case": "body absent", "expected": "BLOCKED listé dans le moteur" },
    { "case": "reveal_text absent", "expected": "BLOCKED listé dans le moteur" },
    { "case": "primary_cta absent", "expected": "BLOCKED listé dans le moteur" },
    { "case": "instance externe injectée via init(ext)", "expected": "le rendu change sans modifier le HTML" },
    { "case": "responsive 375/768/1024", "expected": "aucun débordement horizontal" },
    { "case": "prefers-reduced-motion", "expected": "animations désactivées, rendu stable" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-058",
    "note": "Ce schema VALIDE l'instance. Le contrat pédagogique complet (input_contract/validation_logic/feedback_scoring_logic) vit dans le CORE-GAB officiel, pas ici (évite la duplication)."
  }
}
