@starterlib/tokens 0.9.1 → 0.10.0

package/README.md

@@ -176,8 +176,24 @@ nomme ce que l'ecran charge ; le TypeScript garde le vocabulaire de l'echelle ty
 
 ## API TypeScript
 
+Deux points d'entree depuis la 0.10.0 (greffe 268c). L'entree principale ne porte que ce qu'une
+application lit A L'EXECUTION : partagee en singleton par la federation, elle part entiere au
+premier ecran de la coquille.
+
 ```ts
-import { themeClair, themeSombre, primitives, rapportDeContraste, apca } from '@starterlib/tokens';
+import { delai, tenue, RUPTURES } from '@starterlib/tokens';
+```
+
+- `rythme` (`delai`, `tenue`) : les delais et tenues que les composants lisent en
+  TypeScript (D3).
+- `RUPTURES` : les points de rupture en px, en rem et en requete de media ; `rupture`, l'echelle
+  dont ils derivent ; `partielDesRuptures()`, le partiel Sass engendre.
+
+Le reste est le MOTEUR des jetons, que lisent les outils, les essais et le banc — jamais une
+application, qui lit ses jetons dans la feuille :
+
+```ts
+import { themeClair, themeSombre, rapportDeContraste, apca } from '@starterlib/tokens/moteur';
 ```
 
 - `themeClair` et `themeSombre` : les couleurs semantiques, chacune une `CouleurHex`
@@ -188,14 +204,15 @@ import { themeClair, themeSombre, primitives, rapportDeContraste, apca } from '@
   `densite`, `focus`, `plan`, `duree`, `courbe`, `deplacement`, `cadence`,
   `cadenceMinimale` : les echelles ; `mouvementReduit` et `mouvementGele` : ce que
   la feuille met a zero.
-- `rythme` (`delai`, `tenue`) : les delais et tenues que les composants lisent en
-  TypeScript (D3).
 - `stylesTypographiques`, `policesDuSocle` : typographie et polices.
-- `RUPTURES` : les points de rupture en px, en rem et en requete de media.
 - `rapportDeContraste(a, b)` (WCAG), `apca(texte, fond)` (Lc, APCA 0.0.98G-4g),
   `composer(premierPlan, fond)` : employes par les tests du depot.
 - `rolesDesPrimitives()` : quel role porte quel pas (le nuancier le lit).
-- `jetonsDtcg()` : les jetons au format DTCG (ci-dessous).
+- `feuilleDeJetons()`, `jetonsDtcg()` : la feuille et les jetons au format DTCG (ci-dessous).
+
+⚠️ Le moteur n'entre dans aucun module livre de `core` ni d'`ui` : le lint le refuse dans leur
+code, et `pnpm paquets:check` sur le code construit (`ENTREES_D_OUTILLAGE`). Il n'importe rien, pas
+meme l'entree principale : son module construit se charge seul.
 
 ## Format DTCG