{
  "contract_version": "gab_157_contract_v1",
  "gab_id": "GAB-157",
  "canonical_name": "GamePowerUpEducational",
  "module_owner": "EdTechGameLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "powerup_id",
    "instruction",
    "items"
  ],
  "optional_fields": [
    "title",
    "doctrine_hint",
    "primary_cta"
  ],
  "field_types": {
    "instruction": "string — texte d'en-tête affiché au-dessus de la grille",
    "doctrine_hint": "string — rappel de la doctrine pédagogique (un power-up n'achète jamais la réponse)",
    "items": "array<{id,icon,label,description,cost_label,cost_value,locked:boolean,feedback_msg:string|null}>",
    "primary_cta": "object{label,action}"
  },
  "constraints": [
    "items doit contenir au moins 1 élément.",
    "Un item avec locked:true ne déclenche PAS de feedback_msg (null accepté).",
    "cost_value est un entier >= 0 ; 0 pour les items verrouillés.",
    "Un power-up ne doit jamais donner la bonne réponse directement (doctrine pédagogique).",
    "feedback_msg doit éclairer la MÉTHODE, pas révéler la solution."
  ],
  "blocked_conditions": [
    "items absent ou tableau vide",
    "instruction absente",
    "powerup_id absent"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "locked_items_aria_disabled"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet, grille 4 items, 0 erreur" },
    { "case": "items vide", "expected": "BLOCKED listant le champ manquant" },
    { "case": "instruction absente", "expected": "BLOCKED listant le champ manquant" },
    { "case": "item locked cliqué", "expected": "aucun feedback affiché, item non activé" },
    { "case": "item déjà utilisé cliqué", "expected": "aucune action (idempotent)" },
    { "case": "instance externe injectée", "expected": "le rendu change sans modifier le HTML" },
    { "case": "responsive 375/768/1024", "expected": "grille 1 col sur mobile, 2 cols sur desktop, aucun débordement" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-157",
    "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)."
  }
}