scripts/build_demo_dialogues.py

@@ -0,0 +1,177 @@
+"""Crée un jeu de démo "Démo — Dialogues & Surbrillance" qui exerce, bout
+en bout, les trois mécanismes de guidage du joueur déjà présents dans le
+moteur (voir README, section "Survol, séquences temporisées, surbrillance,
+overlay, verrouillage") :
+
+  - Écran 1 "Tutoriel" : une boîte de dialogue (widget "superposition")
+    s'ouvre TOUTE SEULE à l'affichage de l'écran (déclencheur "affichage"),
+    accueille le joueur et lui indique quoi faire. Son bouton "OK" la
+    referme ET met un autre bouton en surbrillance (liseré clignotant) pour
+    guider le clic suivant. Cliquer ce bouton met fin à la surbrillance, le
+    désactive (grisé, ne peut plus être recliqué) et ouvre une DEUXIÈME
+    boîte de dialogue "Bravo" en réaction au clic — fermable à son tour.
+  - Écran 2 "Message différé" : une boîte de dialogue "arrive toute seule"
+    3 secondes après l'affichage de l'écran (déclencheur "affichage" ->
+    action "attendre" -> action "Modifier un élément → Visibilité"), sans
+    aucune action du joueur — utile pour un message de mentor/notification.
+
+Ce script utilise le VRAI client de test Flask contre les VRAIES routes de
+l'appli (mêmes routes que celles appelées par le navigateur), et crée un
+jeu PERSISTANT sous projects/ (contrairement aux tests pytest, il n'est
+PAS supprimé à la fin) — pensé pour être ouvert et joué dans le navigateur
+après coup.
+
+Usage : python3 scripts/build_demo_dialogues.py
+"""
+import json
+import re
+import sys
+import os
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from core.flask_app import app
+from core import jinja_filters  # noqa: F401 - enregistre les filtres Jinja
+import routes  # noqa: F401 - enregistre toutes les routes
+
+
+def _redirect_id(resp, pattern):
+    return int(re.search(pattern, resp.headers["Location"]).group(1))
+
+
+def _create_screen(client, slug, name):
+    resp = client.post(f"/game/{slug}/screens/new", data={"name": name}, follow_redirects=False)
+    return _redirect_id(resp, r"/screens/(\d+)/edit")
+
+
+def _add_element(client, slug, screen_id, widget):
+    resp = client.post(f"/game/{slug}/screens/{screen_id}/elements/add", data={"widget": widget}, follow_redirects=False)
+    return _redirect_id(resp, r"selected=(\d+)")
+
+
+def _add_child(client, slug, parent_id, widget):
+    resp = client.post(f"/game/{slug}/elements/{parent_id}/children/add", data={"widget": widget}, follow_redirects=False)
+    return _redirect_id(resp, r"selected=(\d+)")
+
+
+def _save(client, slug, element_id, **ctrl):
+    data = {f"ctrl_{k}": v for k, v in ctrl.items()}
+    client.post(f"/game/{slug}/elements/{element_id}/save", data=data)
+
+
+def _add_node(client, slug, screen_id, **fields):
+    resp = client.post(
+        f"/game/{slug}/screens/{screen_id}/flow/nodes/add",
+        data=json.dumps({**fields}),
+        content_type="application/json",
+    )
+    assert resp.status_code == 200, resp.get_data(as_text=True)
+    return resp.get_json()["id"]
+
+
+def _add_edge(client, slug, screen_id, from_id, to_id, from_port="out"):
+    resp = client.post(
+        f"/game/{slug}/screens/{screen_id}/flow/edges/add",
+        data=json.dumps({"from_node_id": from_id, "from_port": from_port, "to_node_id": to_id}),
+        content_type="application/json",
+    )
+    assert resp.status_code == 200, resp.get_data(as_text=True)
+
+
+def _modifier_element(client, slug, screen_id, target_id, prop, value):
+    return _add_node(
+        client, slug, screen_id,
+        node_type="action", action_type="modifier_element",
+        target_element_id=target_id, element_property=prop, element_value=value,
+    )
+
+
+def build():
+    app.config["TESTING"] = True
+    with app.test_client() as client:
+        resp = client.post("/games/new", data={"name": "Demo Dialogues Surbrillance"}, follow_redirects=False)
+        assert resp.status_code == 302, resp.get_data(as_text=True)
+        slug = resp.headers["Location"].rstrip("/").split("/")[-1]
+        print(f"Jeu créé : slug={slug}")
+
+        # ---------------- Écran 1 : Tutoriel ----------------
+        screen1 = _create_screen(client, slug, "Tutoriel")
+
+        overlay_bienvenue = _add_element(client, slug, screen1, "superposition")
+        _save(client, slug, overlay_bienvenue, couleur_boite="#20263a", arrondi="16")
+        t1 = _add_child(client, slug, overlay_bienvenue, "titre")
+        _save(client, slug, t1, content="Bienvenue !")
+        t2 = _add_child(client, slug, overlay_bienvenue, "texte")
+        _save(client, slug, t2, content="Ce petit tutoriel te montre comment fonctionnent les dialogues et la surbrillance. Clique sur OK pour commencer.")
+        btn_ok = _add_child(client, slug, overlay_bienvenue, "bouton")
+        _save(client, slug, btn_ok, content="OK, c'est parti")
+
+        btn_target = _add_element(client, slug, screen1, "bouton")
+        _save(client, slug, btn_target, content="Clique-moi !")
+
+        overlay_bravo = _add_element(client, slug, screen1, "superposition")
+        _save(client, slug, overlay_bravo, couleur_boite="#1f3a24", arrondi="16")
+        t3 = _add_child(client, slug, overlay_bravo, "titre")
+        _save(client, slug, t3, content="Bravo !")
+        t4 = _add_child(client, slug, overlay_bravo, "texte")
+        _save(client, slug, t4, content="Tu as cliqué le bon bouton. Le tutoriel est terminé.")
+        btn_close_bravo = _add_child(client, slug, overlay_bravo, "bouton")
+        _save(client, slug, btn_close_bravo, content="Fermer")
+
+        # Déclencheur "affichage" (écran entier) -> ouvre le dialogue de bienvenue.
+        trig_affichage = _add_node(client, slug, screen1, node_type="trigger", trigger_event="affichage")
+        act_open_bienvenue = _modifier_element(client, slug, screen1, overlay_bienvenue, "visibilite", "visible")
+        _add_edge(client, slug, screen1, trig_affichage, act_open_bienvenue)
+
+        # Clic sur "OK" -> ferme le dialogue de bienvenue ET met le bouton cible en surbrillance.
+        trig_ok = _add_node(client, slug, screen1, node_type="trigger", trigger_element_id=btn_ok, trigger_event="clic")
+        act_close_bienvenue = _modifier_element(client, slug, screen1, overlay_bienvenue, "visibilite", "masque")
+        act_highlight_on = _modifier_element(client, slug, screen1, btn_target, "surbrillance", "on")
+        _add_edge(client, slug, screen1, trig_ok, act_close_bienvenue)
+        _add_edge(client, slug, screen1, trig_ok, act_highlight_on)
+
+        # Clic sur le bouton cible -> arrête la surbrillance, le désactive, ouvre "Bravo".
+        trig_target = _add_node(client, slug, screen1, node_type="trigger", trigger_element_id=btn_target, trigger_event="clic")
+        act_highlight_off = _modifier_element(client, slug, screen1, btn_target, "surbrillance", "off")
+        act_lock_target = _modifier_element(client, slug, screen1, btn_target, "desactive", "on")
+        act_open_bravo = _modifier_element(client, slug, screen1, overlay_bravo, "visibilite", "visible")
+        _add_edge(client, slug, screen1, trig_target, act_highlight_off)
+        _add_edge(client, slug, screen1, trig_target, act_lock_target)
+        _add_edge(client, slug, screen1, trig_target, act_open_bravo)
+
+        # Clic sur "Fermer" (dans "Bravo") -> referme "Bravo".
+        trig_close_bravo = _add_node(client, slug, screen1, node_type="trigger", trigger_element_id=btn_close_bravo, trigger_event="clic")
+        act_close_bravo = _modifier_element(client, slug, screen1, overlay_bravo, "visibilite", "masque")
+        _add_edge(client, slug, screen1, trig_close_bravo, act_close_bravo)
+
+        # ---------------- Écran 2 : Message différé ----------------
+        screen2 = _create_screen(client, slug, "Message différé")
+
+        overlay_mentor = _add_element(client, slug, screen2, "superposition")
+        _save(client, slug, overlay_mentor, couleur_boite="#2a2440", arrondi="16")
+        t5 = _add_child(client, slug, overlay_mentor, "titre")
+        _save(client, slug, t5, content="Message du mentor")
+        t6 = _add_child(client, slug, overlay_mentor, "texte")
+        _save(client, slug, t6, content="Ce message est apparu tout seul, 3 secondes après l'arrivée sur cet écran — sans aucun clic.")
+        btn_close_mentor = _add_child(client, slug, overlay_mentor, "bouton")
+        _save(client, slug, btn_close_mentor, content="Fermer")
+
+        info2 = _add_element(client, slug, screen2, "texte")
+        _save(client, slug, info2, content="Attends 3 secondes sans rien faire : un message va apparaître tout seul.")
+
+        trig_affichage2 = _add_node(client, slug, screen2, node_type="trigger", trigger_event="affichage")
+        act_wait = _add_node(client, slug, screen2, node_type="action", action_type="attendre", data_value="3")
+        act_open_mentor = _modifier_element(client, slug, screen2, overlay_mentor, "visibilite", "visible")
+        _add_edge(client, slug, screen2, trig_affichage2, act_wait)
+        _add_edge(client, slug, screen2, act_wait, act_open_mentor)
+
+        trig_close_mentor = _add_node(client, slug, screen2, node_type="trigger", trigger_element_id=btn_close_mentor, trigger_event="clic")
+        act_close_mentor = _modifier_element(client, slug, screen2, overlay_mentor, "visibilite", "masque")
+        _add_edge(client, slug, screen2, trig_close_mentor, act_close_mentor)
+
+        print(f"Terminé. Ouvre http://127.0.0.1:5050/game/{slug}/play pour tester.")
+        print(f"Éditeur : http://127.0.0.1:5050/game/{slug}/screens/{screen1}/edit")
+
+
+if __name__ == "__main__":
+    build()