Refonte : vrai widget "Personnage" visuel (remplace l'UI de la Phase 7)

L'utilisateur a testé la Phase 7 (sprites pilotés via un menu déroulant
+ zone de texte dans la logique de flow) et l'a rejetée à raison : ce
n'est pas comme ça qu'un moteur de jeu (Phaser, Unity) gère un
personnage. Cette refonte remplace tout le flux d'AUTEURING par un vrai
widget visuel — le moteur d'exécution de la Phase 7 (runSpriteAnimation,
activeSpriteAnimations, orientation, kind="sprite" de la Timeline) reste
inchangé.

Nouveau widget "personnage" (screens/widgets/registry.py) :
- Rendu serveur dédié (special_render, screens/rendering/render_personnage.py)
  qui affiche la pose "idle" dès le HTML généré — jamais une image
  cassée à configurer après coup.
- Toutes ses données (source Forge ou sprites propres au créateur, quel
  personnage/quelles animations) vivent dans une seule clé JSON
  _personnage_data (screens/rendering/personnage_data.py), sans aucune
  migration de schéma (même patron que c_clause_list).
- Nouvelle échappatoire "custom_panel", symétrique à "special_render" mais
  pour le panneau de propriétés : ce widget affiche une galerie/un import
  de sprites sur-mesure plutôt que les contrôles génériques.

Galerie visuelle de personnages Forge (VRAIES miniatures, pas un emoji) :
- Panneau gauche "🎭 Personnages" : pose un personnage déjà configuré,
  animé immédiatement.
- Panneau droit (propriétés) : change le personnage Forge de l'élément
  sélectionné, ou importe les animations d'un sprite personnalisé.
- static/js/screen_edit/personnage-preview.js : lance l'aperçu animé de
  CHAQUE personnage du canevas dès le chargement de la page et après
  toute sauvegarde — le cœur de la demande ("je dois voir ça bouger").

Sélecteur d'animation à miniatures (nœud de flow "Jouer une animation" et
clip de Timeline "sprite") : remplace le menu déroulant/la zone de texte
par une grille de vraies miniatures, scopée aux SEULES animations du
personnage réellement ciblé (ELEMENT_ANIMATIONS_MAP, résolu côté serveur
à partir des propriétés de cet élément précis) — jamais un catalogue
global. Le format stocké sur le nœud/le clip ({frames, fps, loop}) est
inchangé, seule l'UI d'édition change.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

routes/elements/__init__.py

@@ -10,4 +10,5 @@ from . import (
     element_duplicate,
     element_rename,
     element_tab_add,
+    element_set_personnage_data,
 )

routes/elements/element_add.py

@@ -24,4 +24,15 @@ def element_add(slug, screen_id):
         # défaut à la création plutôt que de repartir d'une icône neutre que
         # l'utilisateur devrait ensuite changer manuellement.
         screens.save_element_controls(slug, new_id, {"ctrl_icon_class": icon_slug})
+    if widget == "personnage":
+        # Posé depuis la galerie "🎭 Personnages" (voir addPersonnageElement()
+        # dans tree-panels.js) : remplace le personnage Forge par défaut
+        # (male-adventurer, voir default_style_for_widget.py) par celui
+        # réellement cliqué, ou bascule sur une source "custom" vide si la
+        # tuile "➕ Sprite personnalisé" a été choisie.
+        forge_character = request.form.get("forge_character")
+        if forge_character == "__custom__":
+            screens.set_personnage_data(slug, new_id, {"source": "custom", "animations": {}})
+        elif forge_character and forge_character in screens.SPRITE_LIBRARY:
+            screens.set_personnage_data(slug, new_id, {"source": "forge", "forge_character": forge_character})
     return redirect(url_for("screen_edit", slug=slug, screen_id=screen_id, selected=new_id))

routes/elements/element_set_personnage_data.py

@@ -0,0 +1,21 @@
+from flask import request, jsonify
+
+import screens
+
+from core.flask_app import app
+
+
+@app.route("/game/<slug>/elements/<int:element_id>/personnage", methods=["POST"])
+def element_set_personnage_data(slug, element_id):
+    """Change le personnage Forge d'un élément déjà posé (galerie du
+    panneau de propriétés), ou met à jour ses animations personnalisées
+    (import de frames) — voir personnage-panel.js. Renvoie les animations
+    résolues pour que le client relance immédiatement l'aperçu animé sans
+    recharger la page (voir personnage-preview.js)."""
+    body = request.get_json(silent=True) or {}
+    el = screens.get_element(slug, element_id)
+    if not el:
+        return jsonify({"error": "élément introuvable"}), 404
+    screens.set_personnage_data(slug, element_id, body)
+    el = screens.get_element(slug, element_id)
+    return jsonify({"ok": True, "animations": screens.resolve_personnage_animations(el)})

routes/screens/screen_edit.py

@@ -19,6 +19,7 @@ def screen_edit(slug, screen_id):
     element_types = screens.list_element_types(slug)
     selected_id = request.args.get("selected", type=int)
     selected_controls = None
+    personnage_data = None
     if selected_id:
         selected_el = next((e for e in elements if e["id"] == selected_id), None)
         if selected_el:
@@ -28,6 +29,11 @@ def screen_edit(slug, screen_id):
                 if owning_type:
                     template_definition_id = owning_type.get("bound_definition_id")
             selected_controls = screens.controls_with_values(slug, selected_el, template_definition_id)
+            if selected_el.get("widget") == "personnage":
+                # Phase 8 — panneau de propriétés sur-mesure (custom_panel,
+                # voir registry.py) : pas de controls génériques à afficher,
+                # juste la source (Forge/personnalisée) et son contenu.
+                personnage_data = screens.resolve_personnage_data(selected_el)
     children_of = {}
     for el in elements:
         if el.get("parent_id"):
@@ -51,6 +57,12 @@ def screen_edit(slug, screen_id):
     flow_edges = screens.list_flow_edges(slug, screen_id)
     elements_labels = {el["id"]: screens.element_label(el, screens.WIDGETS) for el in elements}
     screens_map = {s["id"]: s["name"] for s in all_screens}
+    # Phase 8 — sélecteur d'animation à miniatures (nœud de flow "Jouer une
+    # animation" / clip de Timeline "sprite") : scopé aux SEULES animations
+    # de l'élément personnage réellement ciblé, jamais un catalogue global.
+    element_animations_map = {
+        el["id"]: screens.resolve_personnage_animations(el) for el in elements if el.get("widget") == "personnage"
+    }
     animation_clips = screens.list_animation_clips(slug, screen_id)
     global_variables = db.list_global_variables(slug)
     custom_events = db.list_custom_events(slug)
@@ -76,6 +88,8 @@ def screen_edit(slug, screen_id):
         element_orientation_values=screens.ELEMENT_ORIENTATION_VALUES,
         sprite_library=screens.SPRITE_LIBRARY,
         sprite_library_json=json.dumps(screens.SPRITE_LIBRARY),
+        personnage_data=personnage_data,
+        element_animations_map_json=json.dumps(element_animations_map),
         data_operations=screens.DATA_OPERATIONS,
         data_operation_labels=screens.DATA_OPERATION_LABELS,
         definitions=definitions, definitions_json=json.dumps(definitions_data),