Forge-Engine/publish/accessibility_declaration.py

"""Déclaration d'accessibilité exportable (obligation légale RGAA pour
tout service numérique concerné, voir roadmap phase 1.2) — PAS un audit
certifié : un résumé honnête, généré à partir de ce que le moteur de jeu
implémente RÉELLEMENT aujourd'hui (voir static/game/js/play/triggers.js,
dialogue-box-controller.js, game_engine/scenes/render_scene_object.py), à
compléter/faire valider par le créateur du jeu avant publication."""

from datetime import date

_DECLARATION_TEMPLATE = """Déclaration d'accessibilité — {game_name}
Générée le {today} par Forge Engine

Cette déclaration résume l'état d'accessibilité du jeu de formation
"{game_name}" au regard du RGAA (Référentiel Général d'Amélioration de
l'Accessibilité, version française de WCAG 2.1 niveau AA). Elle décrit ce
que le moteur Forge Engine implémente pour TOUT jeu exporté — elle ne
remplace pas un audit RGAA complet réalisé par un expert accessibilité, et
ne couvre pas le contenu propre à ce jeu (texte, images, choix de
couleurs) qui reste sous la responsabilité de son créateur.

CRITÈRES PRIS EN CHARGE PAR LE MOTEUR
--------------------------------------
- Navigation clavier : tout objet de scène réagissant "Au clic" ou "Au
  survol" est focusable (Tab) et activable au clavier (Entrée/Espace),
  en plus de la souris. Les boutons de dialogue/quiz sont de vrais
  <button> HTML.
- Lecteurs d'écran : les boîtes de dialogue et de quiz sont annoncées
  (role="dialog", contenu dynamique signalé par aria-live). Les images de
  personnages/décors reçoivent le nom donné par le créateur du jeu comme
  alternative textuelle, ou sont marquées décoratives (alt="") si aucun
  nom n'a été renseigné. Les icônes seules sont marquées décoratives.
- Structure de page : landmark <main> et titre de page (masqué
  visuellement, lu par les lecteurs d'écran).
- Délai réglable : la révélation de la bonne réponse à une question de
  quiz n'avance plus automatiquement après un délai fixe — l'apprenant
  clique sur "Continuer →" quand il est prêt.
- Confort visuel : les animations en boucle infinie de l'interface
  respectent le réglage système "Réduire les animations"
  (prefers-reduced-motion).
- Contraste des couleurs : un avertissement est affiché au créateur du
  jeu dans l'éditeur de style si le contraste texte/fond de la boîte de
  dialogue/quiz est insuffisant (< 4.5:1) — un choix de couleurs reste
  possible malgré l'avertissement, la vérification finale revient au
  créateur du jeu.

POINTS RESTANT À LA CHARGE DU CRÉATEUR DE CE JEU
--------------------------------------------------
- Choisir des couleurs de texte/fond suffisamment contrastées (le
  moteur avertit, mais n'empêche pas un choix insuffisant).
- Fournir des noms clairs aux personnages/décors qui portent une
  information (le moteur ne peut pas deviner un contenu manquant).
- Ajouter des sous-titres/transcriptions à tout contenu audio ajouté au
  jeu (hors du champ du moteur lui-même).
- Vérifier que le texte des scènes reste compréhensible sans dépendre
  uniquement de la couleur ou de la position.

Cette déclaration a été générée automatiquement et n'engage que la
description de ce que le moteur Forge Engine implémente à la date
ci-dessus — elle ne constitue pas une certification de conformité RGAA
complète du jeu "{game_name}".
"""


def build_accessibility_declaration(game_name: str) -> str:
    """Texte brut (jamais de mise en forme HTML/Markdown à interpréter :
    prévu pour être lu/imprimé/collé tel quel dans un document interne,
    voir routes/game/publish/accessibility_declaration.py)."""
    return _DECLARATION_TEMPLATE.format(game_name=game_name, today=date.today().isoformat())