@starterlib/ui 0.8.0 → 0.9.1

package/LICENCES-TIERCES.md

@@ -0,0 +1,236 @@
+# Licences tierces de `@starterlib/ui`
+
+Ce paquet livre un seul actif d'origine tierce : le sprite d'icones `assets/icones/sprite.svg` (et
+son catalogue `assets/icones/catalogue.json`). Aucune bibliotheque d'icones n'est une dependance du
+paquet ; les symboles sont derives a la construction du depot, puis versionnes.
+
+## Material Symbols Outlined
+
+- **Oeuvre** : Material Symbols Outlined, Copyright Google LLC.
+- **Licence** : Apache License, Version 2.0 ; texte integral ci-dessous.
+- **Version derivee** : police Material Symbols Outlined v374 servie par Google Fonts (axes `wght`
+  et `FILL`), empreinte SHA-256
+  `77f9711f3f896a1d7a34ab95cffc45cfb17d84c223f197c1b90faa0d043006e9` ; instance `wght` 400,
+  `GRAD` 0, `opsz` 24, `FILL` 0 (contours) et 1 (jumeaux `-plein`). Index des noms :
+  `@material-symbols/svg-400` 0.47.5.
+- **Modifications** (Apache 2.0, section 4 b) : les contours TrueType de la police sont convertis en
+  chemins SVG (`tools/icones/police-material.mjs`) dans la grille de 960 unites de Material, sans
+  retouche du dessin ; les contours d'aire nulle et les paires de contours opposes qui s'annulent
+  sont retires ; chaque symbole recoit un nom francais (`icones/catalogue.json` du depot source).
+- **Recompositions** (Apache 2.0, section 4 b : oeuvres derivees, modifiees) : trois symboles n'ont
+  pas de glyphe Material a leur sens et sont RECOMPOSES dans le depot a partir de contours de Material
+  Symbols v374, dans la meme grille ; ils relevent donc de la meme licence :
+  - `iban` : cadre de `credit_card` repris, lignes de segments dessinees dans le depot ;
+  - `carte-bancaire-cadenas` : `credit_card` echancree et `lock` reduit de moitie ;
+  - `coffre-fort` : caisson de `check_box_outline_blank`, cadran fait d'arcs de `circle` reduits de
+    moitie, pene dessine dans le depot.
+
+  Le catalogue source le declare (`origine.derive`), et `pnpm icones:check` exige que chaque dessin
+  du depot declare ses glyphes d'origine, ou se declare original.
+
+---
+
+```text
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+```

package/README.md

@@ -14,9 +14,10 @@ des dependances de pair : c'est l'application qui les installe, et elles doivent
 etre **identiques dans l'hote et dans chaque remote**. Deux versions du socle
 dans le meme navigateur, ce sont deux jeux de jetons d'injection.
 
-## Onze points d'entree
+## Quinze points d'entree
 
-Deux criteres, dans cet ordre.
+Deux criteres, dans cet ordre (le douzieme, `sens`, le treizieme, `parcours`, et le
+quatorzieme, `qr`, et le quinzieme, `messagerie`, depuis la 0.9.0 : lots 228, 243, 264 et 266).
 
 1. **La dependance** (ADR 0003) : un composant sort du tronc quand il traine un
    pair lourd, et le point d'entree ou il va se choisit par ce qu'il EST pour
@@ -27,19 +28,23 @@ Deux criteres, dans cet ordre.
    lui coute plein tarif au premier ecran, et ne coute RIEN au remote qui
    l'affiche, puisque le tronc y est deja charge.
 
-| Point d'entree               | Contenu                                                                                                | Pairs lourds importes statiquement                                         |
-| ---------------------------- | ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
-| `@starterlib/ui`             | le TRONC : noyau, icone, texte, actions, etats, retour, indicateurs, structure, transverses, `st-code` | aucun                                                                      |
-| `@starterlib/ui/saisie`      | les champs de formulaire, le calendrier, le televersement                                              | aucun (des TYPES d'`@angular/forms`)                                       |
-| `@starterlib/ui/listes`      | liste, liste de description, table de donnees, pagination, tri, filtres                                | aucun                                                                      |
-| `@starterlib/ui/donnees`     | montant, date, date relative, nombre, valeur masquee, indicateur chiffre                               | aucun                                                                      |
-| `@starterlib/ui/libelles-en` | le catalogue anglais                                                                                   | aucun                                                                      |
-| `@starterlib/ui/surfaces`    | ce qui se pose AU-DESSUS de la page : menu, dialogues, tiroirs, messages ephemeres                     | `@angular/cdk/{a11y,dialog,keycodes,overlay,portal}`, `@angular/aria/menu` |
-| `@starterlib/ui/navigation`  | la navigation laterale                                                                                 | `@angular/cdk/layout` — et rien d'autre                                    |
-| `@starterlib/ui/onglets`     | les onglets et leurs panneaux                                                                          | `@angular/aria/tabs`                                                       |
-| `@starterlib/ui/selection`   | liste deroulante filtrante, choix multiple                                                             | `@angular/aria/{combobox,listbox}`, `@angular/cdk/overlay`                 |
-| `@starterlib/ui/arbre`       | l'arborescence                                                                                         | `@angular/aria/tree`                                                       |
-| `@starterlib/ui/formulaires` | les champs qui LISENT leur saisie : montant, date, plage de dates                                      | le code d'`@angular/forms` (`transformedValue`)                            |
+| Point d'entree               | Contenu                                                                                                                                                                                                                                                                                                                                                                             | Pairs lourds importes statiquement                                         |
+| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| `@starterlib/ui`             | le TRONC : noyau, icone, texte, actions, etats, retour, indicateurs (dont `st-tag-group`), structure, transverses, `st-code`                                                                                                                                                                                                                                                        | aucun                                                                      |
+| `@starterlib/ui/saisie`      | les champs de formulaire, les groupes de cases et de radios, la matrice de cases, la rangee de champs, les consentements, les cartes de choix, le calendrier, le televersement, les etiquettes libres (`st-tag-input`), le champ d'adresse et la liste des pays (`st-address-fieldset`, `st-country-field`)                                                                         | aucun (des TYPES d'`@angular/forms`)                                       |
+| `@starterlib/ui/listes`      | liste, liste de description, liste a verifier (`st-review-list`), table de donnees, pagination, tri, filtres, sections repliables (`st-disclosure`, `st-accordion`), documents stockes (`st-document-list`, `st-attachment`), chronologie (`st-timeline`), avant et apres (`st-value-change`, `st-change-list`), actions de masse (`st-selection-bar`), export (`st-export-action`) | aucun                                                                      |
+| `@starterlib/ui/donnees`     | montant, date, date relative, compte, nombre (`st-number`), duree (`st-duration`), valeur masquee, indicateur chiffre, recapitulatif de montants (`st-amount-summary`), jauge (`st-meter`), echeance (`st-deadline`), personnes (`st-person`, `st-avatar-group`), groupe d'indicateurs (`st-stat-group`), barres et repartition (`st-bar-list`, `st-repartition`)                   | aucun                                                                      |
+| `@starterlib/ui/libelles-en` | le catalogue anglais                                                                                                                                                                                                                                                                                                                                                                | aucun                                                                      |
+| `@starterlib/ui/surfaces`    | ce qui se pose AU-DESSUS de la page : menu, dialogues, tiroirs, messages ephemeres, aide contextuelle (`st-help-button`), bouton scinde (`st-split-button`), menu de compte (`st-user-menu`), confirmation legere (`[stPopconfirm]`)                                                                                                                                                | `@angular/cdk/{a11y,dialog,keycodes,overlay,portal}`, `@angular/aria/menu` |
+| `@starterlib/ui/navigation`  | la navigation laterale, les onglets de navigation par routes (`st-nav-tabs`), le sommaire d'ancres (`st-page-nav`)                                                                                                                                                                                                                                                                  | `@angular/cdk/layout` — et rien d'autre                                    |
+| `@starterlib/ui/onglets`     | les onglets et leurs panneaux                                                                                                                                                                                                                                                                                                                                                       | `@angular/aria/tabs`                                                       |
+| `@starterlib/ui/selection`   | liste deroulante filtrante, choix multiple, recherche d'adresse (`st-address-search`), liste des pays filtrable (`st-country-combobox`)                                                                                                                                                                                                                                             | `@angular/aria/{combobox,listbox}`, `@angular/cdk/overlay`                 |
+| `@starterlib/ui/arbre`       | l'arborescence                                                                                                                                                                                                                                                                                                                                                                      | `@angular/aria/tree`                                                       |
+| `@starterlib/ui/formulaires` | les champs qui LISENT leur saisie : montant, date, plage de dates, heure (`st-time-field`), plage de montants (`st-amount-range`), recurrence d'un virement (`st-recurrence-field`)                                                                                                                                                                                                 | le code d'`@angular/forms` (`transformedValue`)                            |
+| `@starterlib/ui/sens`        | le sens d'ecriture du CDK tenu a jour avec `dir` (`provideSensDuDocument`, pose par l'hote)                                                                                                                                                                                                                                                                                         | `@angular/cdk/bidi` — et rien d'autre                                      |
+| `@starterlib/ui/parcours`    | les patrons composites d'un parcours : refus du serveur (`st-refusal`), issue d'une operation (`st-outcome`), assistant par etapes (`st-wizard`, `st-wizard-step`), dossier a completer (`st-task-list`), ceremonie de second facteur (`st-challenge`) et codes de secours (`st-recovery-codes`)                                                                                    | aucun                                                                      |
+| `@starterlib/ui/qr`          | le code QR : l'encodeur pur (`encoderQr`, ISO/IEC 18004) et son dessin (`st-qr-code`), pour l'enrolement d'un authentificateur et le virement a scanner                                                                                                                                                                                                                             | aucun                                                                      |
+| `@starterlib/ui/messagerie`  | les echanges d'un dossier : le fil (`st-message-thread`), le message (`st-message`), le composeur (`st-message-composer`), en texte brut ; ses libelles avec lui (AD-10)                                                                                                                                                                                                            | aucun                                                                      |
 
 ```ts
 import { StButton, StCard, StError } from '@starterlib/ui';
@@ -52,20 +57,33 @@ import { StTabs } from '@starterlib/ui/onglets';
 import { StCombobox, StMultiselect } from '@starterlib/ui/selection';
 import { StTree } from '@starterlib/ui/arbre';
 import { StAmountField, StDateField } from '@starterlib/ui/formulaires';
+import { provideSensDuDocument } from '@starterlib/ui/sens';
 ```
 
-Les aretes internes admises, et elles seules : `saisie`, `listes`, `donnees`,
-`surfaces`, `navigation` et `arbre` importent le tronc ; `formulaires` et
-`selection` importent en plus `saisie`, parce qu'une liste deroulante et un
-champ de montant sont d'abord des CHAMPS. `navigation` atteint `surfaces` par
-`import()` seulement : le dialogue du tiroir ne pese pas sur le premier rendu.
+`sens` ne porte aucun composant : il remplace le `Directionality` du CDK, qui ne lit `dir` qu'a sa
+construction, par un sens qui suit `<html dir>` et `<body dir>`. Sans lui, une couche ouverte apres
+une bascule de langue vers la droite a gauche (`StLangue`) s'ecrit de gauche a droite, et les
+fleches d'`@angular/aria` restent celles de la gauche vers la droite. L'hote le pose une fois, a cote
+de `provideStarterUi` (recette `docs/recettes/assembler-une-spa.md` §3).
+
+Les aretes internes admises, et elles seules (`DEPENDANCES_ADMISES` de
+`tools/verifier-paquets.mjs`) : `saisie`, `listes`, `donnees`, `surfaces`,
+`navigation`, `onglets` (ses icones, depuis le lot 236), `arbre` et `qr`
+importent le tronc ; `formulaires` et `selection` importent en plus `saisie`,
+parce qu'une liste deroulante et un champ de montant sont d'abord des CHAMPS ;
+`parcours` et `messagerie` composent le tronc, `saisie`, `listes` et `donnees`,
+et aucun point d'entree n'importe `parcours`, `messagerie` ni `qr`.
+`libelles-en` et `sens` n'importent aucun autre point d'entree : le catalogue
+anglais ne lit du tronc que le TYPE `LibellesUi`. `navigation` atteint
+`surfaces` par `import()` seulement : le dialogue du tiroir ne pese pas sur le
+premier rendu.
 
 ### Ce qui reste des anciens specificateurs
 
-`@starterlib/ui/interactions` **survit, deprecie**, comme baril de
-re-exports vers `navigation`, `onglets`, `selection` et `arbre` : un remote
-reste en 0.7.x recoit la MEME CLASSE que l'hote, et la migration se fait
-service par service. ⚠️ Ce qui s'importe du baril pese les quatre familles.
+`@starterlib/ui/interactions`, le baril de re-exports vers `navigation`,
+`onglets`, `selection` et `arbre` deprecie depuis la 0.8.0, est **retire en
+0.9.0** (lot 176, ADR web 0006 : avant la 1.0, rien de deprecie n'est garde) :
+importer le point d'entree etroit.
 
 Le tronc, lui, **ne re-exporte pas** `saisie`, `listes`, `donnees` ni
 `libelles-en` : ces points d'entree importent le tronc, et un tronc qui les
@@ -89,24 +107,24 @@ construit (`pnpm paquets:check`), **au specificateur exact** : `navigation` a
 droit a `@angular/cdk/layout`, et un `@angular/cdk/overlay` qui s'y glisserait
 echoue avant la publication. Une regle non outillee est une opinion.
 
-⚠️ **En federation, chaque point d'entree se partage SEPAREMENT.** Ce sont onze
+⚠️ **En federation, chaque point d'entree se partage SEPAREMENT.** Ce sont quinze
 specificateurs de module distincts : partager `@starterlib/ui` ne couvre aucun
-des dix autres. Omis de la configuration, chaque remote en embarque sa propre
+des quatorze autres. Omis de la configuration, chaque remote en embarque sa propre
 copie — et la regle `singleton: true, strictVersion: true` qui protege le tronc
 ne protege plus rien au-dessus. Le decoupage achete l'independance de
-CHARGEMENT, jamais celle de VERSION : les onze portent le numero de leur paquet.
+CHARGEMENT, jamais celle de VERSION : les quinze portent le numero de leur paquet.
 
 ```js
 // federation.config.mjs de l'hote ET de chaque remote
-import { partageDuSocle } from '@starterlib/core/federation';
+import { partageAngular, partageDuSocle } from '@starterlib/core/federation';
 
-shared: { ...share({ ...ANGULAR_ET_RXJS, ...partageDuSocle('0.8') }) }
+shared: { ...share({ ...partageAngular('22.2', '7.8'), ...partageDuSocle('0.9') }) }
 ```
 
 ⚠️ **Cette liste ne se recopie plus.** Depuis la 0.8.0 elle est publiee par
-`@starterlib/core/federation` : `partageDuSocle(train)` rend les **seize**
-specificateurs du socle — les onze de `ui`, le baril deprecie, `tokens`, `util`,
-`core` et `core/federation` —, chacun en `singleton: true, strictVersion: true,
+`@starterlib/core/federation` : `partageDuSocle(train)` rend les **dix-neuf**
+specificateurs du socle — les quinze de `ui`, `tokens`, `util`, `core` et
+`core/federation` —, chacun en `singleton: true, strictVersion: true,
 includeSecondaries: false`. La raison n'est pas la commodite : une ligne oubliee
 **n'est pas une erreur de construction**, le specificateur se duplique simplement
 dans le remote, avec son etat. Passer de quatre a douze specificateurs `ui` en
@@ -147,10 +165,14 @@ sinon la bascule de langue ne touche pas les composants du socle.
 
 ## Sprite d'icones — a cabler avant le premier rendu
 
-`st-icon` lit un sprite SVG servi **en meme origine**. Le paquet livre l'actif,
-l'application le sert et en donne le chemin. Aucun chemin par defaut : une
-reference `use` qui ne resout pas ne leve rien, et toutes les icones resteraient
-vides en silence.
+`st-icon` lit un sprite SVG servi **en meme origine** : un symbole Material
+Symbols Outlined par nom du catalogue, plus les jumeaux pleins, derives de la
+police a la construction, sous licence Apache 2.0 (`LICENCES-TIERCES.md` du
+paquet). Le paquet livre l'actif et son catalogue
+(`assets/icones/catalogue.json`, qui les enumere), l'application le sert et en
+donne le chemin. Aucun chemin par defaut : une reference `use` qui ne resout pas
+ne leve rien, et toutes les icones resteraient vides en silence. Aucune police
+d'icones, jamais.
 
 `angular.json`, cible `build` :
 
@@ -186,6 +208,29 @@ de `@starterlib/tokens`. Sans la feuille, tout s'affiche sans style.
 @import '@starterlib/tokens/styles/starter-tokens.css';
 ```
 
+## Feuille des couches (0.9.0)
+
+`@starterlib/ui/styles/couches.css`, chargee par l'HOTE apres la feuille de
+jetons : voile des dialogues et des tiroirs (`.st-voile`, fondu sur
+`--st-duree-normale`), largeurs par defaut des panneaux (`.st-dialogue`,
+`.st-tiroir`), pseudo-elements des transitions de vue. Recette :
+[docs/recettes/assembler-une-spa.md](../../docs/recettes/assembler-une-spa.md).
+
+## Mouvement (0.9.0)
+
+Une entree est un fondu plus un deplacement court, une sortie un fondu ; rien ne
+bouge pendant une saisie, le focus et les erreurs ne s'animent pas. Tout lit les
+jetons de duree : sous mouvement reduit (preference du systeme ou
+`data-mouvement="reduit"`), les durees et les deplacements valent zero, seules les
+boucles d'attente continuent, en respirant. Pour un composant d'application :
+
+- `affichageDiffere(actif)` — rien avant `rythme.delai.attente`, puis au moins
+  `rythme.tenue.affichageMinimal` : une attente sans clignotement ;
+- `fonduDeSortie($event)` pour `(animate.leave)`, `fonduDEntree(element)`,
+  `fermerApresLaSortie(element, detacher)` pour une couche ;
+- le mixin Sass `sous-mouvement-reduit` (partiel `ruptures`) pour une BOUCLE,
+  jamais pour une transition.
+
 ## Ce qui est livre
 
 Vague 1 : etats (`st-spinner`, `st-skeleton`, `st-empty`, `st-error`,
@@ -200,7 +245,8 @@ Vague 2 :
 - **Tronc** — structure (`st-app-shell`, `st-header`, `st-skip-link`, `st-page-title`,
   `st-breadcrumb`, `st-section`, `st-card`, `st-divider`), retour (`st-banner`,
   `st-inline-message`), transverses (`st-theme-toggle`,
-  `st-lang-switch`, `st-copy-button`, `st-timer`, `st-logo`).
+  `st-lang-switch`, `st-copy-button`, `st-timer`, `st-logo` ; `st-privacy-toggle` et
+  `ST_MONTANTS_MASQUES` en 0.9.0, lot 256 : masquer les montants de tout l'ecran).
 - **`ui/surfaces`** — `StDialog` (dialogue, tiroir, feuille inferieure),
   `StConfirmDialog`, `StToast`, `st-idle-warning`, `stTooltip`, `st-popover`.
 - **`ui/onglets`** — `st-tabs`, `st-tab-panel`, `stTabContent` ; **`ui/navigation`**
@@ -212,11 +258,14 @@ Vague 3 — la saisie, sur Signal Forms :
 - **`ui/saisie`** (le tronc avant la 0.8.0) — `st-form-field`, `st-input`, `st-textarea`, `st-fieldset`,
   `st-checkbox`, `st-radio-group`, `st-switch`, `st-error-summary`,
   `st-password-field`, `st-otp-field`, `st-search-field`, `st-iban-field`,
-  `st-phone-field`, `st-select` (natif), `st-file-upload`, `st-calendar` ;
+  `st-select` (natif), `st-file-upload`, `st-calendar` ;
   messages d'erreur traduits et fonctions de schema (`erreurIban`,
   `erreurTelephone`, `erreurDate`, `erreurPlageDeDates`, `erreursDeFichiers`).
-- **`ui/selection`** — `st-combobox`, `st-multiselect`.
-- **`ui/formulaires`** — `st-amount-field`, `st-date-field`, `st-date-range`.
+- **`ui/selection`** — `st-combobox`, `st-multiselect` ; `st-address-search` et
+  `st-country-combobox` (0.9.0, la liste des pays filtrable, sur `st-combobox`).
+- **`ui/formulaires`** — `st-amount-field`, `st-date-field`, `st-date-range`,
+  `st-phone-field` (dans `ui/saisie` avant la 0.9.0), `st-time-field` (0.9.0, avec
+  `erreurHeure` dans `ui/saisie`).
 
 Un champ s'emploie avec un formulaire, par `[formField]`, ou seul, par
 `[(value)]`. Les regles d'un schema sont des fonctions PURES du socle, a brancher
@@ -282,15 +331,19 @@ S17) — ce que la coquille et les remotes assemblent :
   zone sure), `st-footer` (mentions, version, statut), `stNavLink`
   (`routerLink` + `aria-current="page"`, icone et pastille), `st-page-header`
   (fil, `h1`, actions, onglets), `st-route-progress` (barre fine, rien avant
-  200 ms), `st-auth-shell` (gabarit pleine page), `st-stepper` (`ol`,
+  200 ms), `st-auth-shell` (gabarit pleine page, carte de 450 px des `md`),
+  `st-splash-screen` (ecran de demarrage `clair` ou `marque`, statut differe ;
+  amorce statique `styles/amorce.css` avant le JavaScript), `st-stepper` (`ol`,
   `aria-current="step"`), `st-settings-row` (groupe nomme et decrit).
-- **Tronc, actions et donnees** — `st-form-actions` (barre collee en bas,
-  jamais fixee), `st-stat` (tendance par forme et texte).
+- **Tronc, actions** — `st-form-actions` (barre collee en bas, jamais fixee) ;
+  **`ui/donnees`** — `st-stat` (tendance par forme et texte, ou en argent par
+  `montant`, masquee avec l'ecran en 0.9.0).
 - **`ui/surfaces`** — `st-toolbar` (une action principale, les secondaires
   repliees dans un menu « Plus » sous `md`).
-- **`st-icon`** — `sprite` et `nomMetier` pour les icones d'un remote
-  (`docs/recettes/sprite-d-icones.md`, section 7) ; `st-progress` prend une
-  `epaisseur` fine.
+- **`st-icon`** — `icone` (nom du socle, jumeau plein ou `iconeMetier(...)`),
+  `variante`, `miroir`, crans fixes en rem ; `sprite` et `nomMetier` pour les
+  icones d'un remote (`docs/recettes/sprite-d-icones.md`, section 9) ;
+  `st-progress` prend une `epaisseur` fine.
 - **Feuilles** — chaque `:hover` sous `@media (hover: hover)`, les points de
   rupture lus dans le partiel `_ruptures.scss` de `@starterlib/tokens`
   (`@include st.depuis('lg')`), gardes dans `styles/gardes-de-feuille.spec.ts`.
@@ -307,7 +360,8 @@ jsdom ne calcule ni mise en page ni cascade :
 - taille de chaque cible de pointage (24 px au moins, WCAG 2.5.8) ;
 - anneau de focus a chaque arret de tabulation, au VRAI clavier, et son contraste
   contre ce qui l'entoure ;
-- encre de chaque icone, lue par le moteur de rendu, dans une zone sure commune.
+- encre de chaque icone, lue par le moteur de rendu (`mesurerUnSprite`), dans la
+  grille, et le miroir de chaque nom sous ecriture de droite a gauche.
 
 Voir `docs/audit-design-2026-09-17.md` pour ce que ces mesures ont corrige.