{
  "contract_version": "gab_105_contract_v1",
  "gab_id": "GAB-105",
  "canonical_name": "MemoryMatchingPairs",
  "module_owner": "EdTechMemoryLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "matching_id",
    "items",
    "col_left_label",
    "col_right_label"
  ],
  "optional_fields": [
    "title",
    "instructions",
    "status_idle",
    "feedback_success",
    "accessibility"
  ],
  "field_types": {
    "matching_id": "string — identifiant unique de l'instance",
    "items": "array<{pair_id:string, left:string, right:string}> — minimum 2 paires",
    "col_left_label": "string — libellé de la colonne gauche",
    "col_right_label": "string — libellé de la colonne droite",
    "instructions": "string — consigne affichée au-dessus de la grille",
    "status_idle": "string — message d'état initial",
    "feedback_success": "string — message affiché quand toutes les paires sont trouvées",
    "accessibility": "object{keyboard_navigable:boolean, focus_visible:boolean, prefers_reduced_motion:boolean}"
  },
  "constraints": [
    "items : minimum 2 paires, chaque paire porte un pair_id unique et symétrique (même valeur côté gauche et côté droit).",
    "Le moteur apparie L.pair_id === R.pair_id — aucun contenu pédagogique en dur dans le HTML.",
    "La colonne droite est présentée mélangée par le moteur (order aléatoire) pour l'exercice.",
    "feedback_success affiché uniquement quand matDone === items.length."
  ],
  "blocked_conditions": [
    "items absent ou tableau vide",
    "col_left_label absent",
    "col_right_label absent"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "aria-label sur les colonnes"
  ],
  "qa_cases": [
    { "case": "instance conforme 3 paires", "expected": "rendu complet, association fonctionnelle, 0 erreur" },
    { "case": "items vide", "expected": "BLOCKED listant 'items absent ou tableau vide'" },
    { "case": "col_left_label absent", "expected": "BLOCKED listant 'col_left_label absent'" },
    { "case": "mauvaise paire sélectionnée", "expected": "animation shake + reset de la sélection" },
    { "case": "toutes paires trouvées", "expected": "feedback_success affiché" },
    { "case": "instance externe injectée (init(ext))", "expected": "rendu change sans modifier le HTML" },
    { "case": "responsive 375/768/1024", "expected": "aucun débordement horizontal" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-105",
    "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)."
  }
}