{
  "contract_version": "gab_384_contract_v1",
  "gab_id": "GAB-384",
  "canonical_name": "MediaLearningAudioPlayer",
  "module_owner": "EdTechMediaLearning",
  "renderer_key": "media_viewer",
  "required_fields": [
    "gab_id",
    "audio_kind",
    "audio_duration",
    "initial_state_label",
    "playing_state_label",
    "speed_options",
    "transcript_cta_label"
  ],
  "optional_fields": [
    "title",
    "audio_player_id",
    "transcript_text",
    "no_autoplay",
    "accessibility",
    "child_safety",
    "_note_dev"
  ],
  "field_types": {
    "audio_kind": "string — type de média audio (ex: Podcast, Leçon, Interview)",
    "audio_duration": "string — durée affichée (ex: '4 min')",
    "initial_state_label": "string — libellé état pause (ex: 'En pause')",
    "playing_state_label": "string — libellé état lecture (ex: 'Lecture en cours…')",
    "speed_options": "array<{value:string, label:string, default:boolean}> — au moins 1 entrée, exactement 1 default:true",
    "transcript_cta_label": "string — libellé du bouton transcription",
    "transcript_text": "string — contenu de la transcription (fallback texte)",
    "no_autoplay": "boolean — doit être true, jamais false en prod pédagogique",
    "accessibility": "object{keyboard_navigable,focus_visible,prefers_reduced_motion,transcript_fallback}",
    "child_safety": "object{no_autoplay_enforced:boolean, transcript_available:boolean}"
  },
  "constraints": [
    "no_autoplay doit être true — jamais d'autoplay en contexte pédagogique.",
    "speed_options : exactement 1 item avec default:true (vitesse initiale).",
    "transcript_cta_label et transcript_text viennent du JSON, jamais en dur dans le HTML.",
    "Le rendu complet change en remplaçant uniquement le JSON — 0 contenu en dur dans renderer.html."
  ],
  "blocked_conditions": [
    "audio_kind absent",
    "audio_duration absent",
    "initial_state_label absent",
    "playing_state_label absent",
    "speed_options absentes ou vides",
    "transcript_cta_label absent"
  ],
  "accessibility": [
    "keyboard_navigable",
    "focus_visible",
    "prefers_reduced_motion",
    "transcript_fallback"
  ],
  "qa_cases": [
    { "case": "instance conforme", "expected": "rendu complet : bouton play, vitesse par défaut sélectionnée, label transcript, 0 erreur" },
    { "case": "champ requis manquant (ex: speed_options vides)", "expected": "BLOCKED listant le champ manquant" },
    { "case": "clic play → pause", "expected": "bouton bascule ▶/⏸ et libellé état change selon JSON" },
    { "case": "clic vitesse 0.75×", "expected": "chip sélectionnée, panel note affiché avec la valeur" },
    { "case": "clic transcript", "expected": "panel ok affiche transcript_text du JSON" },
    { "case": "instance externe injectée via ENGINE.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-384",
    "note": "renderer_key 'media_viewer' à concevoir (pas de moteur kit de référence). Contenu extrait de INDEX-300-medialearning-GAB-381-385-PLAYABLE.html, bloc data-tpl='384', handlers d384Play/d384Speed/d384Transcript. Ce schema VALIDE l'instance ; le contrat pédagogique complet vit dans le CORE-GAB officiel."
  }
}