origam 2.20.0 → 2.22.0

package/CHANGELOG.md

@@ -18,6 +18,105 @@ This project follows [Semantic Versioning](https://semver.org).
 
 ## [Unreleased]
 
+## [2.22.0] - 2026-10-07
+
+### Added — `attach` sur `OrigamCommandPalette`, `OrigamSnackbarGroup` et `OrigamDrawer`
+
+Ces trois composants codaient en dur `<teleport to="body">` et n'offraient **aucun moyen de
+rediriger** la cible, alors que toute la famille Overlay — Tooltip, Snackbar, Dialog, Menu, via
+`IOverlayProps` — portait déjà `attach`. C'était une surface à moitié implémentée, et la directive
+d'`adr-007-directional-props.md` est explicite : *si un format existe, il existe partout ; on ne
+fait pas moitié*.
+
+La prop est désormais extraite dans `interfaces/Commons/attach.interface.ts` (`IAttachProps`) au
+lieu d'être redéclarée sur chaque interface, et consommée par le point unique existant,
+`useTeleport`.
+
+**Vérifié sur le parent DOM réel** du nœud téléporté, pas sur l'acceptation de la prop : les 9
+tests `attach` sont **9/9 rouges sur le commit parent**, verts sur la branche.
+
+### Added — `--origam-color__text---tertiary`
+
+Troisième niveau de texte sémantique, déclaré dans `light.css` (`neutral-500`) et `dark.css`
+(`neutral-400`), leurs jumeaux SCSS, et l'union `TTokenName`.
+
+Il était **lu par 27 fichiers** de `packages/marketing` et déclaré **nulle part** : un canal de
+thème mort depuis toujours, qui rendait correctement par son seul repli. Les pages de référence,
+`HomeThemes`, `WhyOrigamThemeDemo`, les pages d'administration et `apple.theme.ts` le consommaient
+tous dans le vide.
+
+⚠️ **Aplatissement assumé** : en mode sombre, `tertiary` et `secondary` résolvent la même valeur
+(`neutral-400`). Il n'existe aucun échelon entre `neutral-400` et `neutral-500`, et `neutral-500`
+sur la surface sombre mesure **4,18:1** — sous le seuil AA de 4,5:1. Un niveau de hiérarchie perdu
+a été préféré à une violation de contraste.
+
+### Fixed — `useTeleport` ne réévaluait jamais sa cible après l'hydratation
+
+Le `computed` qui résout la cible de téléportation n'avait **aucune dépendance réactive** sur
+`document.querySelector`. Sous SSR — et sous Histoire, où chaque story est enveloppée dans un
+`<Suspense>` — la première évaluation pouvait tomber **avant** que l'arbre voisin soit commité dans
+le DOM, et rien ne la redéclenchait ensuite.
+
+Le symptôme n'était pas théorique : quatre tests e2e du site marketing échouaient sur
+« *sans erreur JS console* » et « *pas d'erreur d'hydratation* ».
+
+Le correctif réutilise `useHydration()`, qui porte déjà les deux gardes nécessaires — `IN_BROWSER`
+et `ssr` — au lieu d'un compteur de montage local qui les ignorait. Le défaut touchait **toute la
+famille Overlay**, pas seulement les trois composants de ce lot ; c'est `OrigamDrawer` qui l'a
+révélé.
+
+### Fixed — le thème `origam` sombre posait un `text---tertiary` qui échoue en AA
+
+`origamDarkTheme` fixait `tertiary` à `#737373`, soit **4,18:1** sur la surface sombre. Le défaut
+était invisible parce que le canal n'était alimenté par aucune feuille — mais ce bloc runtime
+**gagne la cascade** sur la feuille, donc déclarer le token sans corriger ce thème n'aurait rien
+réglé en mode sombre. Attrapé par `theme-sheet-parity.spec.ts`, rouge avant / vert après.
+
+## [2.21.0] - 2026-10-01
+
+### Changed — ⚠️ `OrigamBlockquote` : le `variant` est un preset de props, plus un bloc SCSS
+
+Deuxième composant converti après le pilote `OrigamKbd`, et premier de la **famille A** au sens de
+la décision D5. Les cinq valeurs — `default`, `elegant`, `quoted`, `minimal`, `pull` — ne sont plus
+cinq règles CSS : ce sont cinq `Partial<IBlockquoteProps>` dans
+`consts/Blockquote/blockquote.const.ts`, résolus au rang **preset** du resolveur de props.
+
+La garde `no-variant-css` passe de **32 à 27** entrées, sans aucune `Blockquote` restante.
+
+**Ce que ça change pour un consommateur** : une prop écrite au site d'appel **bat désormais le
+variant**. Avant, `<origam-blockquote variant="elegant" font-size="sm">` rendait 18px — la taille
+du variant — et la prop était **inerte**. Elle peint maintenant.
+
+⚠️ **La classe `--variant-{valeur}` est conservée** et reste émise : c'est un crochet d'override
+pour le consommateur. Mais le DS ne livre plus **aucune** règle qui la cible (décision D3), donc une
+feuille applicative qui comptait sur la cascade du DS pour la styler ne trouve plus rien à battre.
+
+⚠️ **Deux effets quittent le variant pour une prop comportementale**, parce qu'ils n'étaient pas du
+style : le marqueur de citation de `quoted` (il *monte un élément*) et l'alignement par défaut de
+`pull`. L'exemption est désormais documentée **sur la prop**, au lieu d'être implicite dans une
+règle CSS.
+
+### Removed — ⚠️ 8 tokens typographiques de variant
+
+`--origam-blockquote__{elegant,minimal,pull}---{font-family,font-size,font-weight,line-height}`
+sont retirés des 4 feuilles et de `TTokenName`. Ils n'avaient **plus aucun lecteur** une fois les
+règles supprimées, et **aucun thème ne les lisait** : chaque échelon visé par le preset est
+byte-pour-byte l'alias que la feuille portait déjà. Le canal de personnalisation n'est pas perdu,
+il a changé de nature — il passe par `theme.variants['origam-blockquote']`, ce que D4 prévoit.
+
+⛔ **Le canal de thème des filets d'accent est préservé, et c'était la contrainte dure du lot.**
+Vérifié en navigateur sur les 8 identités × 2 modes : le thème `editorial`, qui pose
+`--origam-blockquote__accent---width: 3px`, rend **3px avant comme après**, les sept autres
+identités rendant 4px — **zéro écart** sur les variants nus. Le preset porte la chaîne
+`var(--origam-blockquote__accent---width, 4px)` et non une largeur en dur, précisément pour ça.
+
+### Fixed — une non-régression qui affirmait le contraire de ce qu'elle garantissait
+
+`utility-cascade-padding-margin-950.spec.ts` échangeait la **classe** de variant et attendait que
+le style suive — l'inverse de la décision D3, qui veut que cette classe ne porte aucun style du DS.
+Réécrit sur le canal **inline**, avec le contrôle d'actuation qu'il n'avait jamais eu : la garantie
+de #950 tient désormais par un mécanisme plus fort que la spécificité.
+
 ## [2.20.0] - 2026-10-01
 
 ### Added — la grille de props LOGIQUES PAR CÔTÉ, les 20 qui manquaient