{
  "contract_version": "gab_138_contract_v1",
  "gab_id": "GAB-138",
  "canonical_name": "InteractiveSimulationSimple",
  "module_owner": "EdTechInteractiveLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "simulation_id",
    "instruction",
    "factor_label",
    "states",
    "output_label"
  ],
  "optional_fields": [
    "primary_cta",
    "_note_dev"
  ],
  "field_types": {
    "simulation_id": "string — identifiant unique de la simulation",
    "instruction": "string — consigne affichée au-dessus du contrôle",
    "factor_label": "string — libellé du facteur contrôlable",
    "states": "array<{key:string, label:string, output_value:number, output_bar_pct:number(0..100), result_text:string, default?:boolean}> — exactement 3 états (low/mid/high recommandés)",
    "output_label": "string — libellé de la métrique observée",
    "primary_cta": "object{label:string, action:string}"
  },
  "constraints": [
    "states doit contenir au moins 2 entrées.",
    "output_bar_pct doit être dans [0, 100].",
    "Au plus 1 état peut porter default:true.",
    "Chaque key d'état doit être unique dans le tableau states.",
    "result_text : texte fourni tel quel depuis la source — ne pas inventer."
  ],
  "blocked_conditions": [
    "simulation_id absent (BLOCKED)",
    "states vide ou absent (BLOCKED)",
    "factor_label absent (BLOCKED)"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "aria_labels_on_buttons"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet, 3 boutons, valeur+barre+texte corrects à l'état par défaut" },
    { "case": "champ requis manquant (simulation_id absent)", "expected": "BLOCKED listant le champ" },
    { "case": "states vide", "expected": "BLOCKED — states vide ou absent" },
    { "case": "clic état 'low'", "expected": "output_value=35, bar=25%, result_text déclinant affiché" },
    { "case": "clic état 'high'", "expected": "output_value=175, bar=90%, result_text croissance affiché" },
    { "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" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-138",
    "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)."
  }
}