first commit

screens/widgets/control_groups/hover_controls.py

@@ -0,0 +1,21 @@
+from ..controls.c_text import c_text
+
+# 3.1 (Confort) — interactions au survol : mécanisme générique, disponible
+# sur TOUS les widgets (via UNIVERSAL_CONTROLS), pour révéler un texte
+# différent quand le joueur survole l'élément avec la souris — le cas
+# d'usage documenté : survoler un nom révèle l'adresse réelle, survoler un
+# lien révèle l'URL réelle. Laisser vide = aucun changement au survol (donc
+# aucune régression sur les jeux existants, dont l'attribut est absent).
+# Rendu : voir render_element_html.py (attribut data-hover-text) et
+# bindHoverTexts() dans templates/play.html (échange du texte au survol,
+# ignore volontairement les éléments qui ont des enfants — conteneurs — pour
+# ne jamais écraser une mise en page imbriquée).
+HOVER_CONTROLS = [
+    c_text(
+        "survol_texte",
+        "Texte affiché au survol de la souris",
+        "attr:_survol_texte",
+        placeholder="ex. mathilde.d@forgebase.fr, https://vrai-lien.exemple...",
+        group="Survol",
+    ),
+]