@zevra/ui 0.36.0 → 0.38.0

package/DECISIONS.md

@@ -1655,3 +1655,84 @@ C'est exactement ce qu'il a fait au premier jet, et il avait raison.
 Il a aussi rendu un service immédiat : un `git checkout` d'essai avait
 annulé le nettoyage de `tokens.css`, encore non commité. Le garde a signalé
 la régression dans la minute.
+
+## L'infobulle se pose en bas de l'écran sur téléphone (29/08/2026, 0.37.0)
+
+Le commentaire de `.zv-tooltip` annonçait la dette : « le centrage sur une
+cible collée au bord peut encore la décaler : limite connue, une variante
+d'ancrage latéral s'arbitrera si le cas se présente ». Le cas s'est présenté,
+et il est mesurable.
+
+Sur le tableau de bord de mcp-factory, à 375 px, le document fait **416 px**
+de large : barre de défilement horizontale sur toute la page. En masquant les
+seules infobulles il retombe à 360. Elles sont la cause ENTIÈRE, le bloc de
+code n'y est pour rien.
+
+Le mécanisme : `left: 50%; transform: translateX(-50%)` sur une cible proche
+du bord droit. Le plafond `max-width: calc(100vw - 40px)` ne corrigeait rien,
+puisque ce n'est pas la largeur qui déborde mais la POSITION.
+
+⚠️ Le débordement par la droite, lui, s'entend : il crée un défilement
+horizontal sur TOUTE la page, y compris là où l'infobulle n'est pas. C'est ce
+qui le rend cher, et facile à imputer au mauvais bloc.
+
+**La variante d'ancrage latéral a été écartée.** Elle aurait obligé chaque
+app à choisir le bon côté pour chaque bulle (quarante et une sur ce seul
+tableau de bord) et à le refaire à chaque déplacement d'un bouton. Une
+correction qui se re-décide à chaque intégration n'est pas une correction.
+
+Sous le point de rupture, la bulle CESSE DE FLOTTER au-dessus de sa cible :
+elle se pose en bas de l'écran, pleine largeur, en `position: fixed`. Le
+débordement devient impossible par construction, quelle que soit la place de
+la cible. C'est aussi le seul endroit où une bulle reste lisible sur 320 px
+sans se replier en cinq lignes au-dessus d'un bouton.
+
+**Le desktop ne bouge pas d'un pixel** : tout est dans la requête média, et
+la règle hors média n'est pas touchée.
+
+Ce que ça ne règle PAS, et qui reste vrai : le tactile ne survole pas. Une
+bulle ne s'ouvre au doigt que si sa cible prend le focus au tap, ce qui vaut
+d'un bouton et pas d'un texte. La doctrine du composant tient donc plus que
+jamais : l'infobulle est un COMPLÉMENT DISPENSABLE, et l'information
+nécessaire passe par `aria-describedby` et par le texte visible. Une app qui
+y met la raison d'un bouton grisé s'en remet à un geste que la moitié de ses
+visiteurs n'ont pas.
+
+## Les liens de la barre tombent avec le burger (29/08/2026, 0.38.0)
+
+`.zv-nav__links` n'était masquée sous le point de rupture que pour
+`zv-nav--riche`, dont le seuil est 1150 px et qui vise les barres denses. Sur
+une barre normale, sous 768 px, le burger apparaissait ET les liens
+restaient : deux navigations pour une, et un débordement au premier libellé
+un peu long.
+
+Le commentaire du module disait pourtant l'intention, deux règles plus haut :
+« le burger n'existe que là où les liens disparaissent ». C'était vrai dans un
+sens seulement.
+
+**Ce que faisaient les consommateurs.** memoire, landing, lexform et
+mcp-factory posaient `zv-only-desktop` à la main sur `NavLinks` ; campus
+passait par `zv-nav--riche`. Quatre sur cinq collaient la même rustine, et
+memoire avait écrit le commentaire qui l'explique : « `.zv-nav__links` n'est
+pas masquée d'office ». Une rustine que tout le monde recopie est un défaut
+du paquet, pas un usage.
+
+**Pourquoi ce n'était pas déjà fait, et pourquoi ça l'est maintenant.** Le
+commentaire d'origine donnait la raison : masquer d'office « casserait les
+pages sans burger ». C'est juste, et ça méritait mieux qu'une classe à poser
+partout. La règle est donc conditionnée par `:has(.zv-nav__burger)` : les
+liens ne disparaissent QUE là où un burger les remplace. L'objection tombe
+sans rien sacrifier, et la phrase écrite plus haut devient vraie dans les
+deux sens.
+
+`:has()` est déjà employé neuf fois dans le paquet, dont `.zv-header:has(>
+.zv-nav)`. Ce n'est pas une nouveauté qu'on introduit ici.
+
+**Ce qui a été écarté** : masquer d'office et documenter qu'il faut un
+burger. Ça déplace la charge sur l'intégrateur pour un cas que le CSS sait
+détecter lui-même, et ça casse toute barre existante sans burger le jour de
+la montée de version.
+
+Aucun consommateur ne régresse : les quatre qui posaient `zv-only-desktop`
+obtiennent le même rendu (la classe devient redondante, elle peut partir),
+et campus masque déjà à 1150, ce qui contient 768.

package/dist/css-inline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css-inline.d.ts","sourceRoot":"","sources":["../react/css-inline.ts"],"names":[],"mappings":"AAGA;;;iEAGiE;AACjE,eAAO,MAAM,WAAW,EAAE,MAAyvxR,CAAA;AAEnxxR;;;yBAGyB;AACzB,eAAO,MAAM,WAAW,EAAE,MAAk4B,CAAA"}
+{"version":3,"file":"css-inline.d.ts","sourceRoot":"","sources":["../react/css-inline.ts"],"names":[],"mappings":"AAGA;;;iEAGiE;AACjE,eAAO,MAAM,WAAW,EAAE,MAAim1R,CAAA;AAE3n1R;;;yBAGyB;AACzB,eAAO,MAAM,WAAW,EAAE,MAAk4B,CAAA"}