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",
    ),
]