@starterlib/ui 0.1.1 → 0.2.0

package/types/starterlib-ui.d.ts

@@ -1,7 +1,81 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Provider, TemplateRef } from '@angular/core';
-import { Montant } from '@starterlib/util';
+import { InjectionToken, Signal, Provider, Resource, TemplateRef } from '@angular/core';
+import { Ton, Montant, TonSemantique, EtatDeBloc } from '@starterlib/util';
+export { ETATS_DE_BLOC, EtatDeBloc } from '@starterlib/util';
 
+/**
+ * Les textes que les composants portent eux-memes.
+ *
+ * ⚠️ Ce ne sont pas « les textes de l'application » : le socle ne connait aucun
+ * ecran. Ce sont les quelques mots qu'un composant doit dire sans que
+ * l'appelant ait a les fournir a chaque usage — le nom d'un bouton de copie,
+ * l'annonce d'un chargement, la mention d'une ouverture dans une autre fenetre.
+ * Tout le reste est un `input` de l'appelant.
+ *
+ * Les entrees a trou sont des FONCTIONS, et non des gabarits a interpoler :
+ * l'ordre des mots change d'une langue a l'autre (« IBAN se terminant par
+ * 2606 » contre « IBAN ending in 2606 »), et une fonction laisse la langue
+ * decider, sans inventer un mini-langage de gabarit dans la librairie.
+ */
+interface LibellesUi {
+    /** Indicateur d'activite, et etat de chargement d'un bloc. */
+    readonly chargementEnCours: string;
+    readonly erreurSurvenue: string;
+    readonly aucunResultat: string;
+    readonly horsConnexion: string;
+    /** Erreur : action de rejeu, et etiquette de l'identifiant technique. */
+    readonly reessayer: string;
+    readonly identifiantDeTrace: string;
+    /** Etiquette du code machine affiche a cote du message. */
+    readonly codeTechnique: string;
+    /** Valeur technique copiable. */
+    readonly copier: string;
+    readonly copieEffectuee: string;
+    /** Valeur masquee. */
+    readonly afficher: string;
+    readonly masquer: string;
+    readonly valeurMasqueeANouveau: string;
+    readonly natureIban: string;
+    readonly natureCarte: string;
+    readonly natureTelephone: string;
+    readonly seTerminantPar: (nature: string, quatreDerniers: string) => string;
+    /** Lien sortant, etiquette de retrait, temps relatif. */
+    readonly nouvelleFenetre: string;
+    readonly retirer: string;
+    readonly aLInstant: string;
+}
+/**
+ * Defaut francais, identique mot pour mot aux textes ecrits en dur jusqu'a la
+ * 0.1.1 : une application qui ne fournit rien ne change pas de comportement.
+ *
+ * Il existe pour que le socle reste utilisable sans i18n, pas pour dispenser
+ * d'en avoir une. Une application bilingue DOIT fournir son propre dictionnaire
+ * sous forme de signal — sinon la moitie de l'interface reste en francais quand
+ * l'utilisateur passe a l'anglais, et rien ne le signale.
+ */
+declare const LIBELLES_FR: LibellesUi;
+/** Traduction anglaise du meme dictionnaire. La paire est obligatoire. */
+declare const LIBELLES_EN: LibellesUi;
+
+/**
+ * Locale de formatage des montants, des dates et des nombres, **sous forme de
+ * signal**.
+ *
+ * ⚠️ Pourquoi pas `LOCALE_ID` : il est fige au demarrage de l'application. Or
+ * l'ADR 0014 du backend exige de changer de langue SANS recharger — la coquille
+ * detient la langue, et tout doit basculer d'un coup. Un composant qui lit
+ * `LOCALE_ID` continuerait d'afficher « 1 234,50 € » dans une interface passee
+ * a l'anglais.
+ *
+ * Le defaut lit `LOCALE_ID` : une application qui ne fournit rien garde le
+ * comportement d'avant, simplement sans pouvoir changer de langue a chaud.
+ */
+declare const ST_LOCALE: InjectionToken<Signal<string>>;
+/**
+ * Textes portes par les composants eux-memes, sous forme de signal pour la
+ * meme raison que la locale.
+ */
+declare const ST_LIBELLES: InjectionToken<Signal<LibellesUi>>;
 /**
  * Chemin du sprite SVG des icones, **fourni par l'application**.
  *
@@ -28,6 +102,29 @@ declare const CHEMIN_DU_SPRITE: InjectionToken<string>;
  * pourraient viser deux sprites differents.
  */
 declare function fournirCheminDuSprite(chemin: string): Provider;
+/** Ce que l'application fournit a `@starterlib/ui`, et rien d'autre. */
+interface ConfigurationUi {
+    /** Obligatoire : voir `CHEMIN_DU_SPRITE`. */
+    readonly cheminDuSprite: string;
+    /**
+     * Locale de formatage. Un signal quand la langue change a l'execution, ce
+     * qui est le cas des que la coquille porte un selecteur de langue.
+     */
+    readonly locale?: Signal<string> | string;
+    /** Textes portes par les composants. Un signal, pour la meme raison. */
+    readonly libelles?: Signal<LibellesUi> | LibellesUi;
+    /** Fuseau de rendu des dates. Vient de la personne connectee, pas du poste. */
+    readonly fuseau?: string;
+}
+/**
+ * Configure `@starterlib/ui` pour toute l'application.
+ *
+ * ⚠️ A appeler dans l'HOTE uniquement. Dans un assemblage federe, un remote qui
+ * la rappellerait poserait un second jeu de valeurs dans son injecteur de
+ * route : deux locales, deux dictionnaires, et la moitie de l'ecran resterait
+ * dans l'ancienne langue apres une bascule.
+ */
+declare function provideStarterUi(configuration: ConfigurationUi): Provider[];
 /**
  * Marque la presence d'une region vivante possedee par un ancetre, en pratique
  * le composant `st-state`.
@@ -46,15 +143,9 @@ declare const REGION_VIVANTE_PARENTE: InjectionToken<true>;
  */
 declare const FUSEAU_PAR_DEFAUT: InjectionToken<string>;
 
-/**
- * Les cinq etats que tout bloc consommant l'API doit traiter. Le type les
- * enumere pour qu'aucun ne s'oublie : un `switch` non exhaustif ne compile pas.
- */
-type EtatDeBloc = 'chargement' | 'erreur' | 'vide' | 'hors-ligne' | 'succes';
-declare const ETATS_DE_BLOC: readonly EtatDeBloc[];
-
 type TailleDIcone = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-type TonDIcone = 'courant' | 'discret' | 'primaire' | 'succes' | 'avertissement' | 'danger';
+/** Une icone prend n'importe quel ton sauf `inverse`, qui vise un fond plein. */
+type TonDIcone = Exclude<Ton, 'inverse'>;
 /**
  * Icone tiree d'un sprite SVG servi en meme origine.
  *
@@ -69,13 +160,13 @@ type TonDIcone = 'courant' | 'discret' | 'primaire' | 'succes' | 'avertissement'
  */
 declare class StIcon {
     private readonly cheminDuSprite;
-    readonly nom: _angular_core.InputSignal<"hors-ligne" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
+    readonly nom: _angular_core.InputSignal<"boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
     readonly taille: _angular_core.InputSignal<TailleDIcone>;
     readonly ton: _angular_core.InputSignal<TonDIcone>;
     /** `null` : l'icone est decorative et reste muette pour les lecteurs. */
     readonly etiquette: _angular_core.InputSignal<string | null>;
-    readonly estDecorative: _angular_core.Signal<boolean>;
-    readonly reference: _angular_core.Signal<string>;
+    protected readonly estDecorative: _angular_core.Signal<boolean>;
+    protected readonly reference: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StIcon, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StIcon, "st-icon", never, { "nom": { "alias": "nom"; "required": true; "isSignal": true; }; "taille": { "alias": "taille"; "required": false; "isSignal": true; }; "ton": { "alias": "ton"; "required": false; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -103,7 +194,7 @@ type GraisseDeTexte = 'normale' | 'moyenne' | 'semi';
 declare class StText {
     readonly variante: _angular_core.InputSignal<VarianteDeTexte>;
     readonly graisse: _angular_core.InputSignal<GraisseDeTexte>;
-    readonly enLigne: _angular_core.InputSignal<boolean>;
+    readonly enLigne: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Nombre de lignes au-dela duquel le texte est coupe.
      *
@@ -134,13 +225,13 @@ declare class StHeading {
     readonly taille: _angular_core.InputSignal<TailleDeTitre | null>;
     /** Cible d'un `aria-labelledby` : une region se nomme par son titre. */
     readonly identifiant: _angular_core.InputSignal<string | null>;
-    readonly tailleEffective: _angular_core.Signal<TailleDeTitre>;
+    protected readonly tailleEffective: _angular_core.Signal<TailleDeTitre>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StHeading, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StHeading, "st-heading", never, { "niveau": { "alias": "niveau"; "required": true; "isSignal": true; }; "taille": { "alias": "taille"; "required": false; "isSignal": true; }; "identifiant": { "alias": "identifiant"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 type TailleDeSpinner = 'sm' | 'md' | 'lg';
-type TonDeSpinner = 'courant' | 'primaire' | 'inverse';
+type TonDeSpinner = Extract<Ton, 'neutre' | 'primaire' | 'inverse'>;
 /**
  * Indicateur d'activite indeterminee.
  *
@@ -156,15 +247,18 @@ type TonDeSpinner = 'courant' | 'primaire' | 'inverse';
  */
 declare class StSpinner {
     private readonly regionParente;
+    private readonly libelles;
     readonly taille: _angular_core.InputSignal<TailleDeSpinner>;
     readonly ton: _angular_core.InputSignal<TonDeSpinner>;
-    readonly etiquette: _angular_core.InputSignal<string>;
-    readonly sAnnonce: _angular_core.Signal<boolean>;
+    /** `null` : le texte vient du dictionnaire de l'application. */
+    readonly etiquette: _angular_core.InputSignal<string | null>;
+    protected readonly etiquetteLue: _angular_core.Signal<string>;
+    protected readonly sAnnonce: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSpinner, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StSpinner, "st-spinner", never, { "taille": { "alias": "taille"; "required": false; "isSignal": true; }; "ton": { "alias": "ton"; "required": false; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type TonDeProgression = 'primaire' | 'succes' | 'danger';
+type TonDeProgression = Extract<Ton, 'primaire' | 'succes' | 'danger'>;
 /**
  * Barre de progression, determinee ou indeterminee.
  *
@@ -181,10 +275,10 @@ declare class StProgress {
     readonly ton: _angular_core.InputSignal<TonDeProgression>;
     /** Texte lu a la place du pourcentage quand celui-ci n'est pas parlant. */
     readonly texteDeValeur: _angular_core.InputSignal<string | null>;
-    readonly estIndeterminee: _angular_core.Signal<boolean>;
+    protected readonly estIndeterminee: _angular_core.Signal<boolean>;
     /** Omis quand la progression est indeterminee : l'annoncer serait faux. */
-    readonly valeurAnnoncee: _angular_core.Signal<number | null>;
-    readonly pourcentage: _angular_core.Signal<number>;
+    protected readonly valeurAnnoncee: _angular_core.Signal<number | null>;
+    protected readonly pourcentage: _angular_core.Signal<number>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StProgress, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StProgress, "st-progress", never, { "valeur": { "alias": "valeur"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": true; "isSignal": true; }; "ton": { "alias": "ton"; "required": false; "isSignal": true; }; "texteDeValeur": { "alias": "texteDeValeur"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -204,14 +298,20 @@ declare class StSkeleton {
     readonly variante: _angular_core.InputSignal<VarianteDeSquelette>;
     readonly lignes: _angular_core.InputSignal<number>;
     readonly colonnes: _angular_core.InputSignal<number>;
-    readonly anime: _angular_core.InputSignal<boolean>;
-    readonly indicesDeLigne: _angular_core.Signal<number[]>;
-    readonly indicesDeColonne: _angular_core.Signal<number[]>;
+    readonly anime: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly indicesDeLigne: _angular_core.Signal<number[]>;
+    protected readonly indicesDeColonne: _angular_core.Signal<number[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSkeleton, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StSkeleton, "st-skeleton", never, { "variante": { "alias": "variante"; "required": false; "isSignal": true; }; "lignes": { "alias": "lignes"; "required": false; "isSignal": true; }; "colonnes": { "alias": "colonnes"; "required": false; "isSignal": true; }; "anime": { "alias": "anime"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type VarianteDeBouton = 'primaire' | 'secondaire' | 'discret' | 'destructeur';
+/**
+ * ⚠️ Une variante dit quel FOND le bouton prend, pas ce qu'il signifie ; c'est
+ * un axe distinct du ton, et il le reste. Mais son quatrieme membre s'appelle
+ * `danger` comme partout ailleurs : il n'y a aucune raison qu'un bouton rouge
+ * et une pastille rouge portent deux mots differents.
+ */
+type VarianteDeBouton = 'primaire' | 'secondaire' | 'discret' | 'danger';
 type TailleDeBouton = 'sm' | 'md' | 'lg';
 /**
  * Bouton du socle, pose en ATTRIBUT sur un `<button>` natif.
@@ -235,15 +335,15 @@ type TailleDeBouton = 'sm' | 'md' | 'lg';
 declare class StButton {
     readonly variante: _angular_core.InputSignal<VarianteDeBouton>;
     readonly taille: _angular_core.InputSignal<TailleDeBouton>;
-    readonly pleineLargeur: _angular_core.InputSignal<boolean>;
-    readonly iconeAvant: _angular_core.InputSignal<"hors-ligne" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur" | null>;
-    readonly iconeApres: _angular_core.InputSignal<"hors-ligne" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur" | null>;
+    readonly pleineLargeur: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly iconeAvant: _angular_core.InputSignal<"boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur" | null>;
+    readonly iconeApres: _angular_core.InputSignal<"boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur" | null>;
     /**
      * Action en cours. Tant qu'il vaut vrai, les clics sont avales : c'est le
      * mecanisme d'anti double soumission. L'appelant doit le lever DES la
      * soumission, pas a l'arrivee de la reponse.
      */
-    readonly chargement: _angular_core.InputSignal<boolean>;
+    readonly chargement: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Le ton suit le FOND du bouton, et non le bouton en general : sur une
      * variante posee sur la surface (`secondaire`, qui est le defaut, et
@@ -255,7 +355,7 @@ declare class StButton {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StButton, "button[stButton]", never, { "variante": { "alias": "variante"; "required": false; "isSignal": true; }; "taille": { "alias": "taille"; "required": false; "isSignal": true; }; "pleineLargeur": { "alias": "pleineLargeur"; "required": false; "isSignal": true; }; "iconeAvant": { "alias": "iconeAvant"; "required": false; "isSignal": true; }; "iconeApres": { "alias": "iconeApres"; "required": false; "isSignal": true; }; "chargement": { "alias": "chargement"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-type VarianteDeBoutonIcone = 'discret' | 'secondaire' | 'destructeur';
+type VarianteDeBoutonIcone = Extract<VarianteDeBouton, 'discret' | 'secondaire' | 'danger'>;
 /**
  * Bouton reduit a une icone, pose en attribut sur un `<button>` natif.
  *
@@ -264,15 +364,22 @@ type VarianteDeBoutonIcone = 'discret' | 'secondaire' | 'destructeur';
  * de facon fiable.
  */
 declare class StIconButton {
-    readonly icone: _angular_core.InputSignal<"hors-ligne" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
+    readonly icone: _angular_core.InputSignal<"boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
     /** Nom accessible du controle. Sans lui, l'icone ne dit rien. */
     readonly etiquette: _angular_core.InputSignal<string>;
     readonly variante: _angular_core.InputSignal<VarianteDeBoutonIcone>;
     readonly taille: _angular_core.InputSignal<"sm" | "md">;
-    /** `null` : le bouton n'est pas a deux etats et n'annonce aucune pression. */
-    readonly enfonce: _angular_core.ModelSignal<boolean | null>;
+    /**
+     * `null` : le bouton n'est pas a deux etats et n'annonce aucune pression.
+     *
+     * ⚠️ Une ENTREE, et non un `model`. Le composant ne bascule rien de lui-meme :
+     * l'etat enfonce reflete une donnee que l'appelant detient. En `model`,
+     * `[(enfonce)]` compilait et ne remontait jamais — une liaison bidirectionnelle
+     * muette est pire qu'absente, puisqu'elle se relit comme fonctionnelle.
+     */
+    readonly enfonce: _angular_core.InputSignal<boolean | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StIconButton, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StIconButton, "button[stIconButton]", never, { "icone": { "alias": "icone"; "required": true; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": true; "isSignal": true; }; "variante": { "alias": "variante"; "required": false; "isSignal": true; }; "taille": { "alias": "taille"; "required": false; "isSignal": true; }; "enfonce": { "alias": "enfonce"; "required": false; "isSignal": true; }; }, { "enfonce": "enfonceChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StIconButton, "button[stIconButton]", never, { "icone": { "alias": "icone"; "required": true; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": true; "isSignal": true; }; "variante": { "alias": "variante"; "required": false; "isSignal": true; }; "taille": { "alias": "taille"; "required": false; "isSignal": true; }; "enfonce": { "alias": "enfonce"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type VarianteDeLien = 'texte' | 'autonome' | 'discret';
@@ -287,11 +394,16 @@ type VarianteDeLien = 'texte' | 'autonome' | 'discret';
  * quiconque regarde l'ecran.
  */
 declare class StLink {
+    private readonly libelles;
     readonly variante: _angular_core.InputSignal<VarianteDeLien>;
     /** Ouvre dans un nouvel onglet, et l'annonce dans le nom accessible. */
-    readonly externe: _angular_core.InputSignal<boolean>;
-    /** Mention lue par les lecteurs d'ecran quand le lien sort du site. */
-    readonly mentionExterne: _angular_core.InputSignal<string>;
+    readonly externe: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Mention lue par les lecteurs d'ecran quand le lien sort du site.
+     * `null` : le texte vient du dictionnaire de l'application.
+     */
+    readonly mentionExterne: _angular_core.InputSignal<string | null>;
+    protected readonly mentionExterneLue: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StLink, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StLink, "a[stLink]", never, { "variante": { "alias": "variante"; "required": false; "isSignal": true; }; "externe": { "alias": "externe"; "required": false; "isSignal": true; }; "mentionExterne": { "alias": "mentionExterne"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
@@ -309,7 +421,7 @@ declare class StButtonGroup {
     readonly etiquette: _angular_core.InputSignal<string>;
     readonly orientation: _angular_core.InputSignal<"horizontale" | "verticale">;
     /** Boutons jointifs, rayons fusionnes. */
-    readonly attache: _angular_core.InputSignal<boolean>;
+    readonly attache: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StButtonGroup, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StButtonGroup, "st-button-group", never, { "etiquette": { "alias": "etiquette"; "required": true; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "attache": { "alias": "attache"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
@@ -326,24 +438,28 @@ declare class StButtonGroup {
 declare class StCode {
     private readonly document;
     private readonly destruction;
+    private readonly libelles;
     readonly valeur: _angular_core.InputSignal<string>;
-    readonly etiquette: _angular_core.InputSignal<string>;
-    readonly copiable: _angular_core.InputSignal<boolean>;
-    readonly libelleCopier: _angular_core.InputSignal<string>;
-    readonly messageDeConfirmation: _angular_core.InputSignal<string>;
+    readonly copiable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** `null` : les textes viennent du dictionnaire de l'application. */
+    readonly etiquette: _angular_core.InputSignal<string | null>;
+    readonly libelleCopier: _angular_core.InputSignal<string | null>;
+    readonly messageDeConfirmation: _angular_core.InputSignal<string | null>;
+    protected readonly etiquetteLue: _angular_core.Signal<string>;
+    protected readonly libelleCopierLu: _angular_core.Signal<string>;
     readonly copie: _angular_core.OutputEmitterRef<string>;
     private readonly confirmation;
     private minuterie;
-    readonly texteDeConfirmation: _angular_core.Signal<string>;
+    protected readonly texteDeConfirmation: _angular_core.Signal<string>;
     /**
      * Le bouton n'apparait que si le navigateur sait copier. Sans presse-papiers,
      * un bouton qui ne fait rien vaut moins que la selection manuelle, que la
      * feuille garde possible (`user-select: all`).
      */
-    readonly copiePossible: _angular_core.Signal<boolean>;
+    protected readonly copiePossible: _angular_core.Signal<boolean>;
     protected auClicDeCopie(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StCode, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StCode, "st-code", never, { "valeur": { "alias": "valeur"; "required": true; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; "copiable": { "alias": "copiable"; "required": false; "isSignal": true; }; "libelleCopier": { "alias": "libelleCopier"; "required": false; "isSignal": true; }; "messageDeConfirmation": { "alias": "messageDeConfirmation"; "required": false; "isSignal": true; }; }, { "copie": "copie"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StCode, "st-code", never, { "valeur": { "alias": "valeur"; "required": true; "isSignal": true; }; "copiable": { "alias": "copiable"; "required": false; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; "libelleCopier": { "alias": "libelleCopier"; "required": false; "isSignal": true; }; "messageDeConfirmation": { "alias": "messageDeConfirmation"; "required": false; "isSignal": true; }; }, { "copie": "copie"; }, never, never, true, never>;
 }
 
 type TypeMasque = 'iban' | 'carte' | 'telephone';
@@ -359,24 +475,31 @@ type TypeMasque = 'iban' | 'carte' | 'telephone';
  * journal.
  */
 declare class StMasked {
+    private readonly libelles;
     private readonly destruction;
     readonly valeur: _angular_core.InputSignal<string>;
     readonly type: _angular_core.InputSignal<TypeMasque>;
     readonly revele: _angular_core.ModelSignal<boolean>;
-    readonly revelationAutorisee: _angular_core.InputSignal<boolean>;
+    readonly revelationAutorisee: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly dureeDeRevelationEnSecondes: _angular_core.InputSignal<number>;
-    readonly libelleAfficher: _angular_core.InputSignal<string>;
-    readonly libelleMasquer: _angular_core.InputSignal<string>;
+    /** `null` : les textes viennent du dictionnaire de l'application. */
+    readonly libelleAfficher: _angular_core.InputSignal<string | null>;
+    readonly libelleMasquer: _angular_core.InputSignal<string | null>;
     readonly revelation: _angular_core.OutputEmitterRef<{
         type: TypeMasque;
     }>;
     private readonly annonce;
-    readonly texteDAnnonce: _angular_core.Signal<string>;
+    protected readonly texteDAnnonce: _angular_core.Signal<string>;
     private minuterie;
-    readonly valeurMasquee: _angular_core.Signal<string>;
-    readonly valeurAffichee: _angular_core.Signal<string>;
-    readonly nomAccessible: _angular_core.Signal<string>;
-    readonly libelleDuBouton: _angular_core.Signal<string>;
+    protected readonly valeurMasquee: _angular_core.Signal<string>;
+    protected readonly valeurAffichee: _angular_core.Signal<string>;
+    /**
+     * La nature et la tournure viennent du dictionnaire : l'ordre des mots change
+     * d'une langue a l'autre, « IBAN se terminant par 2606 » contre « IBAN ending
+     * in 2606 ». Une chaine a trous ne suffirait pas.
+     */
+    protected readonly nomAccessible: _angular_core.Signal<string>;
+    protected readonly libelleDuBouton: _angular_core.Signal<string>;
     private valeurLisible;
     protected basculer(): void;
     private masquer;
@@ -398,11 +521,11 @@ declare class StMasked {
 declare class StMoney {
     private readonly locale;
     readonly valeur: _angular_core.InputSignal<Montant>;
-    readonly signeExplicite: _angular_core.InputSignal<boolean>;
-    readonly sansDevise: _angular_core.InputSignal<boolean>;
+    readonly signeExplicite: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly sansDevise: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly taille: _angular_core.InputSignal<"sm" | "md" | "lg" | "xl">;
-    readonly signe: _angular_core.Signal<"negatif" | "positif" | "nul">;
-    readonly texte: _angular_core.Signal<string>;
+    protected readonly signe: _angular_core.Signal<"negatif" | "positif" | "nul">;
+    protected readonly texte: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StMoney, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StMoney, "st-money", never, { "valeur": { "alias": "valeur"; "required": true; "isSignal": true; }; "signeExplicite": { "alias": "signeExplicite"; "required": false; "isSignal": true; }; "sansDevise": { "alias": "sansDevise"; "required": false; "isSignal": true; }; "taille": { "alias": "taille"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -425,12 +548,33 @@ declare class StDate {
     readonly valeur: _angular_core.InputSignal<string | Date>;
     readonly format: _angular_core.InputSignal<FormatDeDate>;
     readonly fuseau: _angular_core.InputSignal<string | null>;
+    /**
+     * Une DATE DE CALENDRIER (`2026-09-12`) n'est pas un instant : une date de
+     * naissance, une echeance ou un jour de valeur n'ont pas d'heure, et ne
+     * doivent pas changer de jour selon le fuseau de qui les regarde.
+     *
+     * ⚠️ Le piege est dans la norme : `new Date('2026-09-12')` vaut minuit UTC,
+     * donc le 11 septembre partout a l'ouest de Greenwich. Une echeance affichee
+     * la veille est un defaut que personne ne voit depuis l'Europe.
+     */
+    private readonly estDateDeCalendrier;
     private readonly date;
-    readonly estValide: _angular_core.Signal<boolean>;
-    readonly iso: _angular_core.Signal<string | null>;
-    readonly texte: _angular_core.Signal<string>;
+    protected readonly estValide: _angular_core.Signal<boolean>;
+    /**
+     * Le fuseau de rendu. Pour une date de calendrier, c'est UTC : la valeur a
+     * ete construite a minuit UTC, la relire en UTC rend donc le jour ecrit.
+     */
+    private readonly fuseauDeRendu;
+    /**
+     * Une date de calendrier porte `2026-09-12`, sans heure ni decalage : c'est
+     * la forme que la norme HTML attend, et la seule qui ne mente pas.
+     */
+    protected readonly iso: _angular_core.Signal<string | null>;
+    /** Une date sans heure ne peut pas en afficher une. */
+    private readonly optionsDeFormat;
+    protected readonly texte: _angular_core.Signal<string>;
     /** Forme longue, lue par les technologies d'assistance. */
-    readonly texteAccessible: _angular_core.Signal<string | null>;
+    protected readonly texteAccessible: _angular_core.Signal<string | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StDate, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StDate, "st-date", never, { "valeur": { "alias": "valeur"; "required": true; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "fuseau": { "alias": "fuseau"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -447,20 +591,21 @@ declare class StDate {
  */
 declare class StRelativeTime {
     private readonly locale;
+    private readonly libelles;
     private readonly fuseau;
     readonly valeur: _angular_core.InputSignal<string | Date>;
-    readonly rafraichir: _angular_core.InputSignal<boolean>;
+    readonly rafraichir: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Au-dela de ce nombre de jours, la date absolue est plus parlante. */
     readonly seuilAbsoluEnJours: _angular_core.InputSignal<number>;
     private readonly destruction;
     private readonly maintenant;
     constructor();
     private dateEnMillisecondes;
-    readonly estValide: _angular_core.Signal<boolean>;
-    readonly iso: _angular_core.Signal<string | null>;
-    readonly depasseLeSeuil: _angular_core.Signal<boolean>;
-    readonly texte: _angular_core.Signal<string>;
-    readonly texteAccessible: _angular_core.Signal<string>;
+    protected readonly estValide: _angular_core.Signal<boolean>;
+    protected readonly iso: _angular_core.Signal<string | null>;
+    protected readonly depasseLeSeuil: _angular_core.Signal<boolean>;
+    protected readonly texte: _angular_core.Signal<string>;
+    protected readonly texteAccessible: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StRelativeTime, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StRelativeTime, "st-relative-time", never, { "valeur": { "alias": "valeur"; "required": true; "isSignal": true; }; "rafraichir": { "alias": "rafraichir"; "required": false; "isSignal": true; }; "seuilAbsoluEnJours": { "alias": "seuilAbsoluEnJours"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -477,17 +622,22 @@ declare class StRelativeTime {
 declare class StCount {
     private readonly locale;
     readonly valeur: _angular_core.InputSignal<number>;
-    readonly ton: _angular_core.InputSignal<"courant" | "discret">;
+    readonly ton: _angular_core.InputSignal<"neutre" | "discret">;
     /** `null` : jamais d'abreviation. */
     readonly abregerAuDela: _angular_core.InputSignal<number | null>;
-    readonly estAbrege: _angular_core.Signal<boolean>;
-    readonly texteComplet: _angular_core.Signal<string>;
-    readonly texte: _angular_core.Signal<string>;
+    protected readonly estAbrege: _angular_core.Signal<boolean>;
+    protected readonly texteComplet: _angular_core.Signal<string>;
+    protected readonly texte: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StCount, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StCount, "st-count", never, { "valeur": { "alias": "valeur"; "required": true; "isSignal": true; }; "ton": { "alias": "ton"; "required": false; "isSignal": true; }; "abregerAuDela": { "alias": "abregerAuDela"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type TonDeStatut = 'neutre' | 'info' | 'succes' | 'avertissement' | 'danger';
+/**
+ * ⚠️ `primaire` et non « info » : les deux designaient deja la meme couleur
+ * d'accent, et rien ne distinguait un statut « info » d'un statut « primaire »
+ * ailleurs dans le socle.
+ */
+type TonDeStatut = TonSemantique;
 /**
  * Pastille de statut.
  *
@@ -505,13 +655,13 @@ declare class StStatusPill {
     readonly statut: _angular_core.InputSignal<string>;
     /** Texte deja traduit par l'appelant : le socle ne traduit rien. */
     readonly libelle: _angular_core.InputSignal<string>;
-    readonly icone: _angular_core.InputSignal<"hors-ligne" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
-    readonly ton: _angular_core.InputSignal<TonDeStatut>;
+    readonly icone: _angular_core.InputSignal<"boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
+    readonly ton: _angular_core.InputSignal<TonSemantique>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StStatusPill, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StStatusPill, "st-status-pill", never, { "statut": { "alias": "statut"; "required": true; "isSignal": true; }; "libelle": { "alias": "libelle"; "required": true; "isSignal": true; }; "icone": { "alias": "icone"; "required": true; "isSignal": true; }; "ton": { "alias": "ton"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type TonDeBadge = 'neutre' | 'primaire' | 'succes' | 'avertissement' | 'danger';
+type TonDeBadge = TonSemantique;
 /**
  * Pastille de comptage superposee a un autre element.
  *
@@ -524,10 +674,10 @@ type TonDeBadge = 'neutre' | 'primaire' | 'succes' | 'avertissement' | 'danger';
 declare class StBadge {
     readonly valeur: _angular_core.InputSignal<string | number | null>;
     readonly max: _angular_core.InputSignal<number>;
-    readonly ton: _angular_core.InputSignal<TonDeBadge>;
+    readonly ton: _angular_core.InputSignal<TonSemantique>;
     /** Point seul, sans chiffre : signale une nouveaute sans la quantifier. */
-    readonly point: _angular_core.InputSignal<boolean>;
-    readonly texte: _angular_core.Signal<string>;
+    readonly point: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly texte: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StBadge, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StBadge, "st-badge", never, { "valeur": { "alias": "valeur"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "ton": { "alias": "ton"; "required": false; "isSignal": true; }; "point": { "alias": "point"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -542,12 +692,14 @@ declare class StBadge {
  */
 declare class StTag {
     private readonly element;
+    private readonly libelles;
     readonly libelle: _angular_core.InputSignal<string>;
-    readonly supprimable: _angular_core.InputSignal<boolean>;
-    readonly ton: _angular_core.InputSignal<"primaire" | "neutre">;
-    readonly prefixeDeSuppression: _angular_core.InputSignal<string>;
+    readonly supprimable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly ton: _angular_core.InputSignal<"neutre" | "primaire">;
+    /** `null` : le texte vient du dictionnaire de l'application. */
+    readonly prefixeDeSuppression: _angular_core.InputSignal<string | null>;
     readonly supprime: _angular_core.OutputEmitterRef<void>;
-    readonly libelleDeSuppression: _angular_core.Signal<string>;
+    protected readonly libelleDeSuppression: _angular_core.Signal<string>;
     protected auRetrait(): void;
     /**
      * Cible, dans l'ordre : le bouton de l'etiquette suivante, celui de la
@@ -575,12 +727,12 @@ declare class StAvatar {
      * `true` quand le nom figure deja a cote de l'avatar, ce qui est le cas
      * courant : l'avatar devient alors decoratif et se tait.
      */
-    readonly nomAdjacent: _angular_core.InputSignal<boolean>;
+    readonly nomAdjacent: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly imageEchouee;
-    readonly afficheLImage: _angular_core.Signal<boolean>;
-    readonly initiales: _angular_core.Signal<string>;
+    protected readonly afficheLImage: _angular_core.Signal<boolean>;
+    protected readonly initiales: _angular_core.Signal<string>;
     /** Vide quand le nom est deja lisible a cote : eviter la double lecture. */
-    readonly texteAlternatif: _angular_core.Signal<string>;
+    protected readonly texteAlternatif: _angular_core.Signal<string>;
     protected auxEchecsDImage(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StAvatar, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StAvatar, "st-avatar", never, { "nom": { "alias": "nom"; "required": true; "isSignal": true; }; "sourceImage": { "alias": "sourceImage"; "required": false; "isSignal": true; }; "taille": { "alias": "taille"; "required": false; "isSignal": true; }; "forme": { "alias": "forme"; "required": false; "isSignal": true; }; "nomAdjacent": { "alias": "nomAdjacent"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -596,7 +748,7 @@ declare class StAvatar {
 declare class StEmpty {
     readonly titre: _angular_core.InputSignal<string>;
     readonly description: _angular_core.InputSignal<string | null>;
-    readonly icone: _angular_core.InputSignal<"hors-ligne" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
+    readonly icone: _angular_core.InputSignal<"boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
     readonly niveauDuTitre: _angular_core.InputSignal<NiveauDeTitre>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StEmpty, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StEmpty, "st-empty", never, { "titre": { "alias": "titre"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icone": { "alias": "icone"; "required": false; "isSignal": true; }; "niveauDuTitre": { "alias": "niveauDuTitre"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -617,6 +769,7 @@ type VarianteDErreur = 'hors-ligne' | 'serveur' | 'client';
  */
 declare class StError {
     private readonly regionParente;
+    private readonly libelles;
     readonly variante: _angular_core.InputSignal<VarianteDErreur>;
     /** Code machine stable, tel que rendu par le backend. */
     readonly code: _angular_core.InputSignal<string>;
@@ -624,15 +777,19 @@ declare class StError {
     readonly message: _angular_core.InputSignal<string>;
     readonly traceId: _angular_core.InputSignal<string | null>;
     readonly niveauDuTitre: _angular_core.InputSignal<NiveauDeTitre>;
-    readonly rejouable: _angular_core.InputSignal<boolean>;
-    readonly libelleRejeu: _angular_core.InputSignal<string>;
-    readonly rejeuEnCours: _angular_core.InputSignal<boolean>;
-    readonly etiquetteDeTrace: _angular_core.InputSignal<string>;
+    readonly rejouable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly rejeuEnCours: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** `null` : les textes viennent du dictionnaire de l'application. */
+    readonly libelleRejeu: _angular_core.InputSignal<string | null>;
+    readonly etiquetteDeTrace: _angular_core.InputSignal<string | null>;
     readonly rejeu: _angular_core.OutputEmitterRef<void>;
-    readonly icone: _angular_core.Signal<"hors-ligne" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
-    readonly sAnnonce: _angular_core.Signal<boolean>;
+    protected readonly libelleRejeuLu: _angular_core.Signal<string>;
+    protected readonly etiquetteDeTraceLue: _angular_core.Signal<string>;
+    protected readonly etiquetteDuCode: _angular_core.Signal<string>;
+    protected readonly icone: _angular_core.Signal<"boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur">;
+    protected readonly sAnnonce: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StError, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StError, "st-error", never, { "variante": { "alias": "variante"; "required": false; "isSignal": true; }; "code": { "alias": "code"; "required": true; "isSignal": true; }; "titre": { "alias": "titre"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": true; "isSignal": true; }; "traceId": { "alias": "traceId"; "required": false; "isSignal": true; }; "niveauDuTitre": { "alias": "niveauDuTitre"; "required": false; "isSignal": true; }; "rejouable": { "alias": "rejouable"; "required": false; "isSignal": true; }; "libelleRejeu": { "alias": "libelleRejeu"; "required": false; "isSignal": true; }; "rejeuEnCours": { "alias": "rejeuEnCours"; "required": false; "isSignal": true; }; "etiquetteDeTrace": { "alias": "etiquetteDeTrace"; "required": false; "isSignal": true; }; }, { "rejeu": "rejeu"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StError, "st-error", never, { "variante": { "alias": "variante"; "required": false; "isSignal": true; }; "code": { "alias": "code"; "required": true; "isSignal": true; }; "titre": { "alias": "titre"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": true; "isSignal": true; }; "traceId": { "alias": "traceId"; "required": false; "isSignal": true; }; "niveauDuTitre": { "alias": "niveauDuTitre"; "required": false; "isSignal": true; }; "rejouable": { "alias": "rejouable"; "required": false; "isSignal": true; }; "rejeuEnCours": { "alias": "rejeuEnCours"; "required": false; "isSignal": true; }; "libelleRejeu": { "alias": "libelleRejeu"; "required": false; "isSignal": true; }; "etiquetteDeTrace": { "alias": "etiquetteDeTrace"; "required": false; "isSignal": true; }; }, { "rejeu": "rejeu"; }, never, never, true, never>;
 }
 
 /**
@@ -650,7 +807,7 @@ declare class StError {
 declare class StOfflineBanner {
     readonly message: _angular_core.InputSignal<string>;
     readonly libelleRejeu: _angular_core.InputSignal<string | null>;
-    readonly rejeuEnCours: _angular_core.InputSignal<boolean>;
+    readonly rejeuEnCours: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly rejeu: _angular_core.OutputEmitterRef<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StOfflineBanner, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StOfflineBanner, "st-offline-banner", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; "libelleRejeu": { "alias": "libelleRejeu"; "required": false; "isSignal": true; }; "rejeuEnCours": { "alias": "rejeuEnCours"; "required": false; "isSignal": true; }; }, { "rejeu": "rejeu"; }, never, never, true, never>;
@@ -660,29 +817,73 @@ declare class StOfflineBanner {
  * Impose les cinq etats a un bloc qui consomme l'API, et centralise leur
  * annonce.
  *
+ * Deux usages. Le plus courant passe la ressource, et l'etat s'en deduit :
+ *
+ * ```html
+ * <st-state [ressource]="operations">
+ *   <ng-template [stSucces]="operations" let-page>…</ng-template>
+ *   <ng-template stErreur let-erreur><st-error … /></ng-template>
+ *   <ng-template stVide><st-empty … /></ng-template>
+ * </st-state>
+ * ```
+ *
+ * L'autre pose `[etat]` a la main, pour un bloc qui ne vient pas d'une
+ * ressource — une soumission de formulaire, par exemple.
+ *
+ * ⚠️ Un RECHARGEMENT garde le contenu affiche. Revenir a la silhouette a chaque
+ * changement de filtre fait clignoter la page entiere et perd la position de
+ * lecture ; seul le premier chargement n'a rien a montrer.
+ *
  * ⚠️ L'hote ne porte PAS `role="status"`, contrairement a ce qu'on attendrait :
  * un remplacement de contenu A L'INTERIEUR d'une region vivante fait relire
  * tout le sous-arbre par le lecteur d'ecran a chaque bascule d'etat. Seule une
- * petite zone masquee porte l'annonce, qui tient en quelques mots. L'hote se
- * contente d'`aria-busy`.
- *
- * Il fournit `REGION_VIVANTE_PARENTE` : les composants qu'il rend (indicateur
- * de chargement, erreur) detectent sa presence et se taisent, au lieu
- * d'annoncer une deuxieme fois le meme fait.
- */
-declare class StState {
-    readonly etat: _angular_core.InputSignal<EtatDeBloc>;
-    /** Le chemin nominal. Obligatoire : un bloc sans succes n'a pas de raison d'etre. */
-    readonly succes: _angular_core.InputSignal<TemplateRef<unknown>>;
-    readonly chargement: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly erreur: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly vide: _angular_core.InputSignal<TemplateRef<unknown> | null>;
-    readonly horsLigne: _angular_core.InputSignal<TemplateRef<unknown> | null>;
+ * petite zone masquee porte l'annonce, qui tient en quelques mots.
+ */
+declare class StState<T> {
+    private readonly libelles;
+    /** La ressource dont l'etat se deduit. */
+    readonly ressource: _angular_core.InputSignal<Resource<T> | null>;
+    /** Etat pose a la main. Il prime sur la ressource quand les deux existent. */
+    readonly etat: _angular_core.InputSignal<EtatDeBloc | null>;
+    /** Ce qui compte comme « vide » : par defaut, une collection sans element. */
+    readonly estVide: _angular_core.InputSignal<(valeur: T) => boolean>;
     /** Silhouette par defaut du chargement. `null` : un indicateur tournant. */
     readonly squelette: _angular_core.InputSignal<VarianteDeSquelette | null>;
     readonly lignesDeSquelette: _angular_core.InputSignal<number>;
-    readonly annonces: _angular_core.InputSignal<Readonly<Record<EtatDeBloc, string>>>;
-    readonly annonce: _angular_core.Signal<string>;
+    /** `null` : les annonces viennent du dictionnaire de l'application. */
+    readonly annonces: _angular_core.InputSignal<Readonly<Record<EtatDeBloc, string>> | null>;
+    private readonly gabaritSucces;
+    private readonly gabaritErreur;
+    private readonly gabaritVide;
+    private readonly gabaritHorsLigne;
+    private readonly gabaritChargement;
+    private readonly instantane;
+    /**
+     * La derniere valeur connue, gardee pendant qu'une autre se charge.
+     *
+     * ⚠️ Necessaire, et pas seulement confortable : un changement de PARAMETRE
+     * n'est pas un `reload`. Angular traite le premier comme une nouvelle
+     * requete — statut « loading », valeur videe. Sans cette memoire, changer un
+     * filtre ou tourner une page ferait donc disparaitre le tableau, clignoter la
+     * page, et perdre la position de lecture. Une erreur, elle, ne garde rien :
+     * afficher des donnees perimees sous un message d'erreur serait mentir.
+     */
+    private readonly valeurRetenue;
+    /** Etat deduit de la ressource, valeur retenue comprise. */
+    private readonly etatDeLaRessource;
+    readonly etatEffectif: _angular_core.Signal<EtatDeBloc>;
+    /**
+     * Une valeur est affichee, et une autre arrive — par rappel explicite ou par
+     * changement de parametre.
+     */
+    protected readonly enRechargement: _angular_core.Signal<boolean>;
+    protected readonly enAttente: _angular_core.Signal<boolean>;
+    private readonly annoncesLues;
+    protected readonly annonce: _angular_core.Signal<string>;
+    /** Contexte passe au gabarit : la valeur en succes, l'erreur en erreur. */
+    readonly contexte: _angular_core.Signal<{
+        $implicit: unknown;
+    }>;
     /**
      * Les etats degrades n'ont pas de rendu par defaut : afficher un texte
      * generique a la place d'un vrai ecran vide ou d'une vraie erreur donnerait
@@ -690,11 +891,76 @@ declare class StState {
      * voie, en developpement.
      */
     readonly gabaritDeLEtat: _angular_core.Signal<TemplateRef<unknown> | null>;
-    readonly montreLaSilhouetteParDefaut: _angular_core.Signal<boolean>;
+    private readonly chargementVisible;
+    /** La silhouette par defaut, une fois le delai anti-clignotement passe. */
+    protected readonly montreLaSilhouetteParDefaut: _angular_core.Signal<boolean>;
+    constructor();
     private signalerSiAbsent;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StState, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StState, "st-state", never, { "etat": { "alias": "etat"; "required": true; "isSignal": true; }; "succes": { "alias": "succes"; "required": true; "isSignal": true; }; "chargement": { "alias": "chargement"; "required": false; "isSignal": true; }; "erreur": { "alias": "erreur"; "required": false; "isSignal": true; }; "vide": { "alias": "vide"; "required": false; "isSignal": true; }; "horsLigne": { "alias": "horsLigne"; "required": false; "isSignal": true; }; "squelette": { "alias": "squelette"; "required": false; "isSignal": true; }; "lignesDeSquelette": { "alias": "lignesDeSquelette"; "required": false; "isSignal": true; }; "annonces": { "alias": "annonces"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StState<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StState<any>, "st-state", never, { "ressource": { "alias": "ressource"; "required": false; "isSignal": true; }; "etat": { "alias": "etat"; "required": false; "isSignal": true; }; "estVide": { "alias": "estVide"; "required": false; "isSignal": true; }; "squelette": { "alias": "squelette"; "required": false; "isSignal": true; }; "lignesDeSquelette": { "alias": "lignesDeSquelette"; "required": false; "isSignal": true; }; "annonces": { "alias": "annonces"; "required": false; "isSignal": true; }; }, {}, ["gabaritSucces", "gabaritErreur", "gabaritVide", "gabaritHorsLigne", "gabaritChargement"], never, true, never>;
+}
+
+/**
+ * Les gabarits des cinq etats, declares DANS `<st-state>`.
+ *
+ * ⚠️ Pourquoi des directives de contenu plutot que des entrees `TemplateRef` :
+ * un `<ng-template>` declare a l'exterieur du composant appartient a
+ * l'injecteur de l'endroit ou il est ECRIT, pas de celui qui le rend. Les
+ * fournisseurs de `st-state` — dont `REGION_VIVANTE_PARENTE`, qui fait taire
+ * les annonces en double — ne l'atteignaient donc pas, et l'erreur etait
+ * annoncee deux fois. Passer par le contenu rend la declaration a l'exterieur
+ * impossible : le defaut ne peut plus revenir.
+ */
+declare class StSucces<T> {
+    readonly gabarit: TemplateRef<{
+        $implicit: Exclude<T, undefined>;
+    }>;
+    /**
+     * La ressource n'est lue nulle part : elle porte le TYPE de la valeur, pour
+     * que `let-valeur` soit type dans le gabarit au lieu d'etre `unknown`.
+     */
+    readonly stSucces: _angular_core.InputSignal<Resource<T> | undefined>;
+    /**
+     * `Exclude<T, undefined>` : une ressource sans valeur initiale se type
+     * `T | undefined`, mais st-state ne rend ce gabarit QUE lorsqu'une valeur
+     * existe. Sans cela, chaque gabarit de succes devrait ecrire `page?.length`
+     * pour un cas qui ne se produit pas.
+     */
+    static ngTemplateContextGuard<T>(_directive: StSucces<T>, _contexte: unknown): _contexte is {
+        $implicit: Exclude<T, undefined>;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSucces<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StSucces<any>, "ng-template[stSucces]", never, { "stSucces": { "alias": "stSucces"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Erreur. Le contexte porte l'erreur elle-meme, pour l'afficher ou la traduire. */
+declare class StErreur {
+    readonly gabarit: TemplateRef<{
+        $implicit: unknown;
+    }>;
+    static ngTemplateContextGuard(_directive: StErreur, _contexte: unknown): _contexte is {
+        $implicit: unknown;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StErreur, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StErreur, "ng-template[stErreur]", never, {}, {}, never, never, true, never>;
+}
+declare class StVide {
+    readonly gabarit: TemplateRef<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StVide, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StVide, "ng-template[stVide]", never, {}, {}, never, never, true, never>;
+}
+declare class StHorsLigne {
+    readonly gabarit: TemplateRef<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StHorsLigne, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StHorsLigne, "ng-template[stHorsLigne]", never, {}, {}, never, never, true, never>;
+}
+/** Chargement sur mesure. Sans lui, `st-state` rend sa silhouette par defaut. */
+declare class StChargement {
+    readonly gabarit: TemplateRef<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StChargement, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StChargement, "ng-template[stChargement]", never, {}, {}, never, never, true, never>;
 }
+/** Toutes les directives de gabarit, a importer d'un coup. */
+declare const GABARITS_D_ETAT: readonly [typeof StSucces, typeof StErreur, typeof StVide, typeof StHorsLigne, typeof StChargement];
 
-export { CHEMIN_DU_SPRITE, ETATS_DE_BLOC, FUSEAU_PAR_DEFAUT, NOMS_DICONE, REGION_VIVANTE_PARENTE, StAvatar, StBadge, StButton, StButtonGroup, StCode, StCount, StDate, StEmpty, StError, StHeading, StIcon, StIconButton, StLink, StMasked, StMoney, StOfflineBanner, StProgress, StRelativeTime, StSkeleton, StSpinner, StState, StStatusPill, StTag, StText, fournirCheminDuSprite };
-export type { EtatDeBloc, FormatDeDate, GraisseDeTexte, NiveauDeTitre, NomDIcone, TailleDIcone, TailleDeBouton, TailleDeSpinner, TailleDeTitre, TonDIcone, TonDeBadge, TonDeProgression, TonDeSpinner, TonDeStatut, TypeMasque, VarianteDErreur, VarianteDeBouton, VarianteDeBoutonIcone, VarianteDeLien, VarianteDeSquelette, VarianteDeTexte };
+export { CHEMIN_DU_SPRITE, FUSEAU_PAR_DEFAUT, GABARITS_D_ETAT, LIBELLES_EN, LIBELLES_FR, NOMS_DICONE, REGION_VIVANTE_PARENTE, ST_LIBELLES, ST_LOCALE, StAvatar, StBadge, StButton, StButtonGroup, StChargement, StCode, StCount, StDate, StEmpty, StErreur, StError, StHeading, StHorsLigne, StIcon, StIconButton, StLink, StMasked, StMoney, StOfflineBanner, StProgress, StRelativeTime, StSkeleton, StSpinner, StState, StStatusPill, StSucces, StTag, StText, StVide, fournirCheminDuSprite, provideStarterUi };
+export type { ConfigurationUi, FormatDeDate, GraisseDeTexte, LibellesUi, NiveauDeTitre, NomDIcone, TailleDIcone, TailleDeBouton, TailleDeSpinner, TailleDeTitre, TonDIcone, TonDeBadge, TonDeProgression, TonDeSpinner, TonDeStatut, TypeMasque, VarianteDErreur, VarianteDeBouton, VarianteDeBoutonIcone, VarianteDeLien, VarianteDeSquelette, VarianteDeTexte };