LifePlay-Revival/Docs/Migration/etat/ST/LISIB/LISIB-SPEC.md

Fiche LISIB-SPEC — Niveau N2 — Modèle prévu Opus 5.5 (orchestrateur) | utilisé claude-opus-5-5 — Agent orchestrateur (session LISIB) — Skills lp-lot, sk-protocol, lp-ue-compat

LISIB-SPEC : rendre lisibles les textes de l'interface hors Settings (2026-10-10)

Statut : approuvée par l'utilisateur le 2026-10-10 (§ 8). Écriture de code après le tag LISIB-avant et l'instantané ; compilation sur BUILD-GO de Big Boss. Base : LISIB-T1-CART.md et son annexe LISIB-T1-inventaire.md (identifiants A1-A56, B1-B20, C1-C50).

1. Cause

La SpinBox du moteur 5.8, quand l'asset ne fixe rien, écrit en gris clair #B7B7B7, taille 12, sur un pinceau gris clair #E6E6E6 : le contraste est d'environ 1,6:1 (LISIB-T1-CART.md § 2). C'est le défaut vu par l'utilisateur dans CharGen.

Une EditableTextBox sans couleur fixée hérite d'un texte clair, posé sur un fond blanc à 80 % : c'est la cause C1 de STD-TXT-DIAG.md, corrigée pour le seul FilenameEntry de CharGen par STE-TXT.

Le comportement est identique en 5.5 : c'est un défaut d'origine, pas une régression (STE-TXT, décision de l'utilisateur).

2. Périmètre proposé (Q1)

• Retenu (recommandé) :

  • les 56 SpinBox du groupe A ;
  • les 16 EditableTextBox du groupe B sans couleur de texte.

  Ce sont tous les cas où le moteur impose un texte clair sur un fond clair, ainsi que les 3 SpinBox à texte noir 70 % (A41 et A52 : lignes de morphes de CharGen ; A47). Ensemble, ils couvrent le « comme dans de nombreux cas » : CharGen (morphes, AntiDeform, randomisation, X/Y/Z), BodyShapeMenu, Builder, CityMenu, ColorSlot, Scene, SexLight, StatAdjust, StatMenu, et les champs de recherche.

• Hors périmètre par défaut : les 50 TextBlock du groupe C.

  • Leur taille et leur couleur sont des choix de l'auteur, dans l'asset. Par exemple : les donateurs en 8, la version à 70 %, les textes rouges d'alerte.
  • Plusieurs sont recolorés en jeu par le graphe (LISIB-T1-CART.md § 3).
  • Proposition : pendant le PIE, l'utilisateur désigne ceux qui gênent. Ils seront traités dans une fiche complémentaire, LISIB-T2, par MCP, widget par widget.

3. Méthode proposée (Q2) : C++ seul, aucun asset modifié

• Nouveau sous-système ULPReadableTextSubsystem (GameInstanceSubsystem), dans Source\LifePlay\LPReadableTextSubsystem.h/.cpp.
• LPSettingsSubsystem n'est pas modifié : le panneau Settings garde son rendu actuel, et le retour arrière reste séparé. Le sous-système reprend les mêmes valeurs de style (§ 4), recopiées et commentées « comme Settings ».
• Fonctionnement : un ticker (FTSTicker), toutes les 0,25 s, parcourt les USpinBox et UEditableTextBox vivants.
  • Un widget est retenu si :
    • il n'est ni objet par défaut ni archétype ;
    • son UUserWidget propriétaire appartient à la GameInstance ;
    • il n'est pas sous SettingsScrollBox (déjà traité) ;
    • il n'a pas encore été traité (ensemble de pointeurs faibles).
  • Le style est posé une fois par widget, puis la Slate le garde dans les membres UMG : il survit à RebuildWidget.
• ERR-088 :
  • EditableTextBox : le style passe uniquement par ULPWidgetStyleLibrary::SetEditableTextBoxStyle, jamais par UEditableTextBox::SetWidgetStyle avec une valeur temporaire.
  • SpinBox : USpinBox::SetWidgetStyle recopie dans le membre, puis la Slate pointe sur &WidgetStyle (SpinBox.cpp:111, :149-154). Aucun risque, c'est déjà l'usage de Settings.
• Survie au graphe :
  • aucun nœud ne repose le style d'une SpinBox ;
  • le flash rouge de FilenameEntry (CharGen, StatMenu) recopie le TextStyle courant, donc la couleur posée survit.
• Avantages :
  • aucune écriture dans CharGen, MainMenu, StatMenu ou GI, donc aucun conflit avec STF-T5b ni STE ;
  • un seul fichier à relire ;
  • retour arrière par un seul revert ;
  • couvre d'office une SpinBox ajoutée plus tard.
• Limite : le style n'est pas visible dans le designer UMG, seulement en PIE et en jeu.
• Autre méthode :
  • par MCP, asset par asset : 72 widgets, 20 assets, dont CharGen et StatMenu, qui sont en file d'attente ;
  • ou les deux méthodes.

4. Valeurs cibles proposées (Q3, Q4)

SpinBox (groupe A)

Élément	Valeur proposée	Source
Fond	(0,06 ; 0,06 ; 0,06 ; 0,95), survol 0,12 / 0,98, actif 0,16 / 1	comme Settings (LPSettingsSubsystem.cpp:337-342)
Remplissage actif (glissé)	bleu (0,2 ; 0,45 ; 0,9 ; 0,85)	comme Settings (:343)
Remplissage au repos et au survol	bleu sombre (0,1 ; 0,22 ; 0,45 ; 0,9)	nouveau. Settings le laisse gris clair (SSpinBox.cpp:240-241), mais les lignes de morphes (plage 0-1) en montrent beaucoup
Texte	blanc opaque, contour noir 2 px (0,95)	comme Settings (:344, :391-395)
Taille	minimum 16 (les 32 SpinBox en 12 passent à 16 ; celles en 16 ou 20 ne bougent pas)	Settings impose 18 ; 16 est proposé pour tenir dans les lignes étroites de Builder et CharGen
Opacité de rendu	1 pour les SpinBox (A41, A52 : 0,7 aujourd'hui)	comme Settings (:389)
Activé / désactivé	inchangé (Settings force SetIsEnabled(true) ; ici, non)	—

EditableTextBox sans couleur (groupe B)

Élément	Valeur proposée	Source
Couleur du texte	noir opaque (0,0,0,1) dans TextStyle.ColorAndOpacity, seulement si elle n'est pas fixée	comme STE-TXT, approuvé en PIE (J2bis)
Fond	inchangé (blanc à 80 %)	—
Taille	minimum 14 (B9, B10, B13 : 9 aujourd'hui ; B20 caché : 10)	—
HintText	inchangé (gris voulu)	STE-TXT, fiche § 5

Les widgets déjà corrigés par STE-TXT (A40 CharGen.VarianceSpinBox et B6 CharGen.FilenameEntry) :

• B6 n'est pas touché, car sa couleur est fixée ;
• A40 prend le style SpinBox (fond sombre, texte blanc), comme A56 dans StatMenu, pour un rendu homogène. Si l'utilisateur préfère garder le noir de STE-TXT, A40 sera exclu par son nom.

5. Fichiers, essais et retour arrière

• Écrits :
  • Source\LifePlay\LPReadableTextSubsystem.h et .cpp (neufs) ;
  • aucun .uasset ;
  • aucun autre fichier source (le module charge seul le nouveau sous-système).
• Entrée du lot :
  • git status --short -- Source/LifePlay vide ;
  • ticket TAG LISIB-avant ;
  • instantané .\Tools\Snapshot.ps1 -Lot LISIB -Path Source\LifePlay.
• BUILD : Tools\Build.ps1 (éditeur), 0 erreur et 0 avertissement nouveau (lp-build), sur BUILD-GO.
• VAL (lp-validator) :
  • relecture du diff ;
  • fins de ligne ;
  • LPTestStringCompat ;
  • recherche d'un appel direct à UEditableTextBox::SetWidgetStyle dans le nouveau code (0 attendu) ;
  • journal en jeu : compte des widgets traités par classe, à comparer à l'inventaire (56 / 16, moins les widgets non ouverts).
• PIE avec l'utilisateur (LISIB-J1), écran par écran :
  • CharGen : morphes, AntiDeform, randomisation, X/Y/Z, Save Preset, avec flash rouge ;
  • BodyShapeMenu ;
  • CityMenu ;
  • Builder et ColorSlot ;
  • StatMenu (Save Preset) ;
  • Scene (TimeoutHours), SexLight, StatAdjust ;
  • champs de recherche : Cursor, TopRight, ContactMenu, CityMenu, Inventory, Journal, LoadExtImg ;
  • Settings : contrôle de non-régression. Critère : le texte de chaque widget visité est lu sans effort, et aucune mise en page n'est cassée.
• Retour arrière : revert du commit, ou Restore.ps1 -Lot LISIB, proposé, jamais lancé sans accord. Aucun asset n'est en jeu.
• Report en 5.5 (main) : hors périmètre. À proposer après la validation, si l'utilisateur le veut.

6. Coût et risques

• Complexité de l'IMPL : a1 b1 c1 d1 e1 f1 = 6 → N2 (lp-impl).
• Charge : le parcours des objets toutes les 0,25 s porte sur moins de 200 widgets. Coût négligeable, à mesurer dans le journal à la VAL.
• Risque de mise en page : le passage de 12 à 16 peut élargir une ligne (Builder). Le PIE le montre ; la taille minimale se règle par une seule constante.

7. Questions à l'utilisateur

• Q1 Périmètre :
  • (a) A + B, soit 56 SpinBox et 16 champs [recommandé] ;
  • (b) (a) + des TextBlock désignés pendant le PIE (fiche LISIB-T2) ;
  • (c) A + B + les 50 TextBlock du groupe C.
• Q2 Méthode :
  • (a) C++ seul, nouveau sous-système [recommandé] ;
  • (b) assets par MCP ;
  • (c) les deux.
• Q3 Aspect des SpinBox :
  • (a) fond sombre et texte blanc, comme Settings, avec le remplissage au repos en bleu sombre [recommandé] ;
  • (b) fond clair gardé, texte noir opaque, comme STE-TXT.
• Q4 Taille minimale des SpinBox :
  • (a) 16 [recommandé] ;
  • (b) 18, comme Settings ;
  • (c) inchangée, couleur seulement.
• Q5 A40 (CharGen.VarianceSpinBox, noir par STE-TXT) :
  • (a) style commun [recommandé] ;
  • (b) exclu.

Réponses : à reporter ici (§ 8) avec la date, puis la fiche LISIB-IMPL est rédigée et BUILD-DEMANDE envoyée à Big Boss.

8. Décisions de l'utilisateur

2026-10-10, réponses aux questions de la session LISIB :

• Q1 : « SpinBox + champs (Recommandé) » → (a) ;
• Q2 : « C++ seul (Recommandé) » → (a) ;
• Q3 : « Comme Settings (Recommandé) » → (a), avec le remplissage au repos en bleu sombre. L'option approuvée inclut A40 au style commun, donc Q5 = (a) ;
• Q4 : « 16 (Recommandé) » → (a). Les champs de saisie en 9 passent à 14.

SPEC approuvée. Suite : fiche LISIB-IMPL, ticket TAG LISIB-avant, instantané, puis BUILD-DEMANDE.