{
  "contract_version": "gab_075_contract_v1",
  "gab_id": "GAB-075",
  "canonical_name": "VisualTypedCard",
  "module_owner": "EdTechVisualLearning",
  "renderer_key": "text_cta",
  "required_fields": [
    "gab_id",
    "card_id",
    "cards"
  ],
  "optional_fields": [
    "title",
    "default_type",
    "primary_cta",
    "accessibility",
    "child_safety"
  ],
  "field_types": {
    "card_id": "string — identifiant unique de l'instance",
    "cards": "array<{type:string, cls:string, type_label:string, card_title:string, card_body:string}> — min 1 élément",
    "cards[].type": "enum['definition','formula','date','trap'] — détermine la couleur via cls",
    "cards[].cls": "string — classe CSS appliquée à .vtyp-card (definition|formula|date|trap)",
    "cards[].type_label": "string — badge affiché en haut de la carte (ex: '📖 Définition')",
    "cards[].card_title": "string — titre principal de la carte",
    "cards[].card_body": "string — corps textuel de la carte",
    "default_type": "string — type actif au chargement (doit correspondre à un cards[].type)",
    "primary_cta": "object{label:string, action:string}"
  },
  "constraints": [
    "cards doit contenir au moins 1 élément.",
    "cls doit correspondre à un modificateur CSS valide (definition|formula|date|trap).",
    "default_type si présent doit correspondre à un cards[].type existant.",
    "primary_cta.label est le libellé du bouton structurel — vient du JSON, jamais en dur."
  ],
  "blocked_conditions": [
    "gab_id absent",
    "card_id absent",
    "cards vides ou absents"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "aria_labels",
    "role_tab_on_switches",
    "role_tabpanel_on_card"
  ],
  "qa_cases": [
    { "case": "instance conforme 4 types", "expected": "rendu complet avec 4 boutons switch, carte active = default_type" },
    { "case": "champ requis card_id manquant", "expected": "BLOCKED listant card_id absent" },
    { "case": "cards:[] vide", "expected": "BLOCKED listant cards vides" },
    { "case": "switch vers formula", "expected": "carte prend cls formula + border violet, titre/corps changent" },
    { "case": "switch vers trap", "expected": "carte prend cls trap + border coral, titre/corps changent" },
    { "case": "instance externe injectée via ENGINE.init(ext)", "expected": "le rendu change sans modifier le HTML" },
    { "case": "clic bouton CTA", "expected": "panel ok avec type actif confirmé" },
    { "case": "responsive 375/768/1024", "expected": "aucun débordement horizontal, switch wrap correctement" }
  ],
  "traceability": {
    "derived_from_core_gab": "GAB-075",
    "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)."
  }
}