{
  "contract_version": "gab_114_contract_v1",
  "gab_id": "GAB-114",
  "canonical_name": "MemoryMiniDeckInline",
  "module_owner": "EdTechMemoryLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "deck_id",
    "title",
    "items",
    "primary_cta"
  ],
  "optional_fields": [
    "subtitle",
    "context_banner",
    "_note_dev"
  ],
  "field_types": {
    "deck_id": "string — identifiant unique du deck",
    "title": "string — titre affiché dans l'en-tête de la carte",
    "subtitle": "string — sous-titre contextuel (matière, époque…)",
    "context_banner": "string — bandeau contextuel indiquant la position dans la page (ex. après frise Visual)",
    "items": "array<{item_id:string, front_icon:string, back_text:string}> — min 1 item",
    "primary_cta": "object{label:string, label_done:string, icon:string, icon_done:string, action:string}"
  },
  "constraints": [
    "items ne doit pas être vide : minimum 1 carte.",
    "primary_cta.label est le libellé structurel du bouton — vient exclusivement du JSON.",
    "front_icon : emoji ou texte court affiché recto avant retournement.",
    "back_text : texte affiché verso après retournement — contenu pédagogique réel (non inventé).",
    "Une fois le CTA activé, le bouton est désactivé (label_done + icon_done)."
  ],
  "blocked_conditions": [
    "title absent",
    "items vides ou absents",
    "primary_cta.label absent"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "aria-label sur chaque carte (back_text)",
    "Enter/Space retourne une carte"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet, cartes retournables, CTA actif" },
    { "case": "items vides", "expected": "BLOCKED listant 'items vides ou absents'" },
    { "case": "title absent", "expected": "BLOCKED listant 'title absent'" },
    { "case": "primary_cta.label absent", "expected": "BLOCKED listant 'primary_cta.label absent'" },
    { "case": "clic carte → retournement", "expected": "verso visible (back_text), re-clic = recto (front_icon)" },
    { "case": "CTA cliqué", "expected": "bouton désactivé, label_done + icon_done affichés" },
    { "case": "instance externe injectée via init(ext)", "expected": "rendu change sans modifier le HTML" },
    { "case": "responsive 375/768", "expected": "grid 2 colonnes sur mobile, 4 colonnes sur desktop" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-114",
    "note": "Ce schema VALIDE l'instance. Le contrat pédagogique complet vit dans le CORE-GAB officiel, pas ici."
  }
}