{
  "contract_version": "gab_149_contract_v1",
  "gab_id": "GAB-149",
  "canonical_name": "InteractiveFeedbackOverlay",
  "module_owner": "EdTechInteractiveLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "overlay_id",
    "title",
    "feedback_text"
  ],
  "optional_fields": [
    "icon",
    "trigger_label",
    "close_label",
    "context_hint",
    "primary_cta"
  ],
  "field_types": {
    "overlay_id": "string — identifiant unique de l'instance overlay",
    "title": "string — titre affiché dans l'en-tête de l'overlay",
    "icon": "string — emoji ou caractère unique affiché dans l'icône de l'overlay",
    "feedback_text": "string HTML — texte de feedback (peut contenir <b> pour mise en gras)",
    "trigger_label": "string — libellé du bouton déclencheur",
    "close_label": "string — libellé du bouton de fermeture (ex: '✕')",
    "context_hint": "string — texte d'invite contextuel affiché dans la zone de simulation avant déclenchement",
    "primary_cta": "object{label, action} — CTA structurel dont le libellé vient du JSON"
  },
  "constraints": [
    "feedback_text peut contenir du HTML inline limité (<b>, <em>, <strong>) — pas de balises structurelles.",
    "overlay_id doit être unique par page de manipulation interactive.",
    "icon : 1 seul emoji ou caractère — jamais une chaîne longue.",
    "Ce gabarit est transversal : il se superpose à n'importe quelle manipulation interactive (SortLab, HypothesisTest, ScenarioBranch…). Il ne gère pas lui-même la logique de déclenchement — c'est le gabarit parent qui appelle ENGINE.show()."
  ],
  "blocked_conditions": [
    "title absent",
    "feedback_text absent",
    "overlay_id absent"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "aria-label sur le bouton de fermeture"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet, overlay masqué au départ, visible après clic trigger" },
    { "case": "champ requis manquant", "expected": "BLOCKED listant le champ" },
    { "case": "instance externe injectée via ENGINE.init(ext)", "expected": "le rendu change sans modifier le HTML" },
    { "case": "clic trigger", "expected": "overlay s'affiche avec animation (translateY 0, opacity 1)" },
    { "case": "clic close", "expected": "overlay se masque" },
    { "case": "responsive 375/768/1024", "expected": "aucun débordement horizontal, overlay adapté à la largeur du stage" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-149",
    "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)."
  }
}