@starterlib/ui 0.2.0 → 0.4.0

package/types/starterlib-ui.d.ts

@@ -1,7 +1,9 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Signal, Provider, Resource, TemplateRef } from '@angular/core';
-import { Ton, Montant, TonSemantique, EtatDeBloc } from '@starterlib/util';
+import { InjectionToken, Signal, Provider, DestroyRef, Resource, TemplateRef } from '@angular/core';
+import { Ton, Montant, TonSemantique, DateIso, PlageDeDates, DescriptionDeFichier, ChoixDeTheme, Langue, EtatDeBloc } from '@starterlib/util';
 export { ETATS_DE_BLOC, EtatDeBloc } from '@starterlib/util';
+import { ValidationError, FormValueControl, FormCheckboxControl } from '@angular/forms/signals';
+import * as _starterlib_ui from '@starterlib/ui';
 
 /**
  * Les textes que les composants portent eux-memes.
@@ -31,6 +33,7 @@ interface LibellesUi {
     /** Valeur technique copiable. */
     readonly copier: string;
     readonly copieEffectuee: string;
+    readonly copieImpossible: string;
     /** Valeur masquee. */
     readonly afficher: string;
     readonly masquer: string;
@@ -42,6 +45,83 @@ interface LibellesUi {
     /** Lien sortant, etiquette de retrait, temps relatif. */
     readonly nouvelleFenetre: string;
     readonly retirer: string;
+    /** Structure */
+    readonly filDAriane: string;
+    readonly allerAuContenu: string;
+    readonly navigationPrincipale: string;
+    /** Transverses */
+    readonly theme: string;
+    readonly themeSysteme: string;
+    readonly themeClair: string;
+    readonly themeSombre: string;
+    readonly langue: string;
+    readonly reessayerDans: (duree: string) => string;
+    readonly reessayerMaintenant: string;
+    readonly sessionBientotExpiree: string;
+    readonly sessionExpireDans: (duree: string) => string;
+    readonly resterConnecte: string;
+    readonly seDeconnecter: string;
+    /** Saisie */
+    readonly obligatoire: string;
+    readonly champObligatoire: string;
+    readonly valeurInvalide: string;
+    readonly adresseInvalide: string;
+    readonly formatInvalide: string;
+    readonly longueurMinimale: (minimum: number) => string;
+    readonly longueurMaximale: (maximum: number) => string;
+    readonly valeurMinimale: (minimum: string) => string;
+    readonly valeurMaximale: (maximum: string) => string;
+    readonly caracteresRestants: (restants: number) => string;
+    readonly caracteresEnTrop: (enTrop: number) => string;
+    readonly erreursACorriger: (nombre: number) => string;
+    readonly afficherLeMotDePasse: string;
+    readonly codeAChiffres: (longueur: number) => string;
+    readonly ibanInvalide: string;
+    readonly telephoneInvalide: string;
+    readonly exempleDIban: string;
+    readonly rechercher: string;
+    readonly fermerLeMessage: string;
+    /** Montants */
+    readonly montantIllisible: (exemple: string) => string;
+    readonly tropDeDecimales: (decimales: number) => string;
+    readonly deviseDuMontant: (devise: string) => string;
+    /** Dates */
+    readonly lettreDuJour: string;
+    readonly lettreDuMois: string;
+    readonly lettreDeLAnnee: string;
+    readonly formatDeDate: (motif: string, exemple: string) => string;
+    readonly dateIllisible: (motif: string, exemple: string) => string;
+    readonly dateTropTot: (date: string) => string;
+    readonly dateTropTard: (date: string) => string;
+    readonly finAvantDebut: string;
+    readonly dateDeDebut: string;
+    readonly dateDeFin: string;
+    readonly choisirDansLeCalendrier: (champ: string) => string;
+    readonly moisPrecedent: string;
+    readonly moisSuivant: string;
+    readonly aideDuCalendrier: string;
+    /** Listes de choix */
+    readonly choisir: string;
+    readonly nombreDeResultats: (nombre: number) => string;
+    readonly nombreDeSelections: (nombre: number) => string;
+    readonly retirerLeChoix: (choix: string) => string;
+    readonly afficherLesChoix: (champ: string) => string;
+    /** Fichiers */
+    readonly choisirDesFichiers: string;
+    readonly choisirUnFichier: string;
+    readonly ouDeposerIci: string;
+    readonly aucunFichier: string;
+    readonly nombreDeFichiers: (nombre: number) => string;
+    readonly retirerLeFichier: (fichier: string) => string;
+    readonly fichierTropVolumineux: (fichier: string, taille: string) => string;
+    readonly typeDeFichierRefuse: (fichier: string) => string;
+    readonly tropDeFichiers: (nombre: number) => string;
+    readonly typesAcceptes: (types: string) => string;
+    readonly tailleMaximale: (taille: string) => string;
+    /** Dialogues */
+    readonly confirmer: string;
+    readonly annuler: string;
+    readonly recopierPourConfirmer: (texte: string) => string;
     readonly aLInstant: string;
 }
 /**
@@ -53,6 +133,14 @@ interface LibellesUi {
  * 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.
  */
+/**
+ * ⚠️ Les textes AFFICHES portent leurs accents. La regle « sans accents » du
+ * depot vise la documentation et les commentaires, jamais ce que lit la
+ * personne qui utilise l'application : « Reessayer » ou « Aucun resultat » sont
+ * des fautes a l'ecran, et une synthese vocale les prononce de travers. La 0.2.0
+ * les a livres ainsi. Les accents s'ecrivent en sequence d'echappement, comme
+ * l'apostrophe typographique, pour garder la source en ASCII.
+ */
 declare const LIBELLES_FR: LibellesUi;
 /** Traduction anglaise du meme dictionnaire. La paire est obligatoire. */
 declare const LIBELLES_EN: LibellesUi;
@@ -143,6 +231,59 @@ declare const REGION_VIVANTE_PARENTE: InjectionToken<true>;
  */
 declare const FUSEAU_PAR_DEFAUT: InjectionToken<string>;
 
+/**
+ * Texte d'une petite region vivante propre a un composant.
+ *
+ * ```ts
+ * protected readonly annonce = new AnnonceLocale(inject(DestroyRef));
+ * // gabarit : <span class="st-vh" aria-live="polite">{{ annonce.texte() }}</span>
+ * ```
+ *
+ * ⚠️ La region doit exister VIDE dans le gabarit des la creation du composant ;
+ * cette classe ne gere que son texte.
+ *
+ * ⚠️ Nee de deux defauts de `st-code` en 0.2.0 : un `onDestroy` enregistre a
+ * chaque clic, et une confirmation identique reposee dans la meme tache — la
+ * seconde copie n'etait jamais annoncee.
+ */
+declare class AnnonceLocale {
+    private readonly contenu;
+    private minuteries;
+    readonly texte: _angular_core.Signal<string>;
+    constructor(destruction: DestroyRef);
+    annoncer(message: string): void;
+    private arreter;
+}
+
+/** Issue d'une copie. */
+type IssueDeCopie = 'copie' | 'indisponible' | 'refusee';
+/**
+ * Ecrit un texte dans le presse-papiers.
+ *
+ * ⚠️ Trois issues, et non deux. `navigator.clipboard` n'existe qu'en contexte
+ * securise (HTTPS, ou `localhost`) : absent, c'est `indisponible`. Present, il
+ * peut encore refuser — permission, document sans focus — et c'est `refusee`.
+ * Confondre les deux conduit a cacher un bouton qui aurait fonctionne au clic
+ * suivant, ou a laisser croire qu'une copie a eu lieu.
+ *
+ * ⚠️ Ce qui entre dans le presse-papiers en sort difficilement : les
+ * gestionnaires d'historique le conservent, et la synchronisation entre
+ * appareils le propage. Jamais de secret — mot de passe, jeton, code a usage
+ * unique — et une donnee sensible seulement a la demande explicite de la
+ * personne.
+ */
+declare function copierDansLePressePapiers(document: Document, texte: string): Promise<IssueDeCopie>;
+/** Vrai si le navigateur expose un presse-papiers ecrivable par script. */
+declare function pressePapiersDisponible(document: Document): boolean;
+
+/**
+ * Formate une duree en secondes : « 45 s », « 2 min 05 s ».
+ *
+ * Unites courtes de la langue donnee, par `Intl.NumberFormat` : l'ordre, les
+ * espaces et les abreviations suivent la locale, sans table maison.
+ */
+declare function formaterDuree(totalEnSecondes: number, locale: string): string;
+
 type TailleDIcone = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 /** Une icone prend n'importe quel ton sauf `inverse`, qui vise un fond plein. */
 type TonDIcone = Exclude<Ton, 'inverse'>;
@@ -160,7 +301,7 @@ type TonDIcone = Exclude<Ton, 'inverse'>;
  */
 declare class StIcon {
     private readonly cheminDuSprite;
-    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 nom: _angular_core.InputSignal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "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. */
@@ -179,7 +320,7 @@ declare class StIcon {
  * reference `use` vers un identifiant absent ne rend RIEN, sans erreur, et le
  * defaut passe la revue.
  */
-declare const NOMS_DICONE: readonly ["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"];
+declare const NOMS_DICONE: readonly ["boite-vide", "calendrier", "cercle", "cercle-coche", "cercle-croix", "cercle-info", "chevron-bas", "chevron-droite", "chevron-gauche", "chevron-haut", "coche", "copie", "corbeille", "croix", "fichier", "hors-ligne", "lien-externe", "menu", "oeil", "oeil-barre", "plus", "rafraichir", "recherche", "serveur", "televerser", "triangle-alerte", "utilisateur"];
 type NomDIcone = (typeof NOMS_DICONE)[number];
 
 type VarianteDeTexte = 'corps' | 'corps-sm' | 'discret' | 'legende' | 'mono';
@@ -336,23 +477,34 @@ declare class StButton {
     readonly variante: _angular_core.InputSignal<VarianteDeBouton>;
     readonly taille: _angular_core.InputSignal<TailleDeBouton>;
     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>;
+    readonly iconeAvant: _angular_core.InputSignal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "triangle-alerte" | "utilisateur" | null>;
+    readonly iconeApres: _angular_core.InputSignal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "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.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * L'action existe mais n'est pas disponible : une condition n'est pas encore
+     * remplie.
+     *
+     * ⚠️ `aria-disabled` et NON l'attribut natif `disabled`, qui retire le bouton
+     * de l'ordre de tabulation. Une personne au clavier ne l'atteindrait plus, et
+     * ne decouvrirait donc jamais la condition qui le bloque — le bouton aurait
+     * simplement disparu de son parcours. Ici il reste atteignable, annonce comme
+     * indisponible, et ses clics sont avales.
+     */
+    readonly indisponible: _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
      * `discret`), un indicateur en ton inverse tombait a 1,00:1 — invisible.
      */
-    readonly tonDuChargement: _angular_core.Signal<TonDeSpinner>;
+    protected readonly tonDuChargement: _angular_core.Signal<TonDeSpinner>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StButton, never>;
-    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>;
+    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; }; "indisponible": { "alias": "indisponible"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 type VarianteDeBoutonIcone = Extract<VarianteDeBouton, 'discret' | 'secondaire' | 'danger'>;
@@ -364,7 +516,7 @@ type VarianteDeBoutonIcone = Extract<VarianteDeBouton, 'discret' | 'secondaire'
  * de facon fiable.
  */
 declare class StIconButton {
-    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 icone: _angular_core.InputSignal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "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>;
@@ -437,7 +589,6 @@ declare class StButtonGroup {
  */
 declare class StCode {
     private readonly document;
-    private readonly destruction;
     private readonly libelles;
     readonly valeur: _angular_core.InputSignal<string>;
     readonly copiable: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -448,9 +599,7 @@ declare class StCode {
     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;
-    protected readonly texteDeConfirmation: _angular_core.Signal<string>;
+    protected readonly annonce: AnnonceLocale;
     /**
      * 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
@@ -476,7 +625,6 @@ type TypeMasque = 'iban' | 'carte' | 'telephone';
  */
 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>;
@@ -488,9 +636,14 @@ declare class StMasked {
     readonly revelation: _angular_core.OutputEmitterRef<{
         type: TypeMasque;
     }>;
-    private readonly annonce;
-    protected readonly texteDAnnonce: _angular_core.Signal<string>;
+    /**
+     * ⚠️ Par `AnnonceLocale`, et non par un signal pose directement. La 0.2.0
+     * reposait « Valeur masquee a nouveau » a l'identique : aucune mutation, donc
+     * une seconde remise en masque jamais annoncee.
+     */
+    protected readonly annonce: AnnonceLocale;
     private minuterie;
+    constructor();
     protected readonly valeurMasquee: _angular_core.Signal<string>;
     protected readonly valeurAffichee: _angular_core.Signal<string>;
     /**
@@ -655,7 +808,7 @@ 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<"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 icone: _angular_core.InputSignal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "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>;
@@ -748,7 +901,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<"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 icone: _angular_core.InputSignal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "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>;
@@ -786,7 +939,7 @@ declare class StError {
     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 icone: _angular_core.Signal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "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; }; "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>;
@@ -813,6 +966,1427 @@ declare class StOfflineBanner {
     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>;
 }
 
+type ReliefDeCarte = 'plat' | 'pose' | 'flottant';
+type RembourrageDeCarte = 'aucun' | 'sm' | 'md' | 'lg';
+/**
+ * Surface qui regroupe un contenu.
+ *
+ * ⚠️ **Elle n'est jamais cliquable en entier**, et c'est un refus delibere. Une
+ * carte munie d'un `(click)` produit, pour qui ecoute la page, UN seul controle
+ * dont le nom accessible est tout le texte de la carte — titre, montant, date,
+ * mention legale d'un trait. Elle est aussi injoignable au clavier sans
+ * `tabindex`, qui la ferait alors annoncer deux fois.
+ *
+ * Le motif correct : un lien ou un bouton unique DANS la carte, etendu
+ * visuellement a toute sa surface par la classe `st-carte__lien-etendu`. Le
+ * nom accessible reste celui du lien, le clavier fonctionne sans rien ajouter,
+ * et la zone cliquable est la meme.
+ *
+ * ```html
+ * <st-card>
+ *   <st-heading [niveau]="3">
+ *     <a class="st-carte__lien-etendu" routerLink="/comptes/12">Compte courant</a>
+ *   </st-heading>
+ *   <st-money [montant]="solde" />
+ * </st-card>
+ * ```
+ */
+declare class StCard {
+    readonly relief: _angular_core.InputSignal<ReliefDeCarte>;
+    readonly rembourrage: _angular_core.InputSignal<RembourrageDeCarte>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StCard, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StCard, "st-card", never, { "relief": { "alias": "relief"; "required": false; "isSignal": true; }; "rembourrage": { "alias": "rembourrage"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Regroupement de contenu, expose comme REPERE de navigation quand il porte un
+ * nom.
+ *
+ * ⚠️ Le point qui decide de tout : `role="region"` n'est expose comme repere
+ * que s'il a un NOM ACCESSIBLE. Sans nom, la plupart des lecteurs d'ecran
+ * l'ignorent purement et simplement — la balise est la, le repere n'existe pas,
+ * et rien ne le signale. Le composant refuse donc de poser le role quand il ne
+ * peut pas le nommer : une section anonyme reste un simple bloc, ce qu'elle est
+ * reellement.
+ *
+ * Deux facons de la nommer, et la seconde vaut mieux : `titreDe` pointe le
+ * titre deja affiche, ce qui garde un seul texte a traduire et a maintenir.
+ *
+ * ```html
+ * <st-heading [niveau]="2" identifiant="titre-operations">Operations</st-heading>
+ * <st-section titreDe="titre-operations">…</st-section>
+ * ```
+ */
+declare class StSection {
+    /** Nom accessible ecrit a la main. A preferer `titreDe` quand un titre existe. */
+    readonly etiquette: _angular_core.InputSignal<string | null>;
+    /** Identifiant du titre qui nomme la section. Prime sur `etiquette`. */
+    readonly titreDe: _angular_core.InputSignal<string | null>;
+    readonly espacement: _angular_core.InputSignal<"sm" | "md" | "lg" | "aucun">;
+    protected readonly estUnRepere: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSection, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StSection, "st-section", never, { "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; "titreDe": { "alias": "titreDe"; "required": false; "isSignal": true; }; "espacement": { "alias": "espacement"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+type OrientationDeSeparateur = 'horizontale' | 'verticale';
+/**
+ * Trait de separation.
+ *
+ * ⚠️ **Decoratif par defaut, et c'est le bon defaut.** Un `<hr>` porte le role
+ * `separator` de facon implicite, que les lecteurs d'ecran annoncent. Sur une
+ * page qui en compte huit — ce qui est courant dans une liste de reglages — la
+ * lecture est ponctuee de huit « separateur » qui n'apprennent rien.
+ *
+ * Le role ne se pose que lorsque le trait porte vraiment du sens : il separe
+ * alors deux GROUPES que rien d'autre ne distingue, comme les sections d'un
+ * menu. Regle de tri : si le retirer ne retire aucune information, il est
+ * decoratif.
+ */
+declare class StDivider {
+    readonly orientation: _angular_core.InputSignal<OrientationDeSeparateur>;
+    /** Le trait separe deux groupes distincts, et doit donc etre annonce. */
+    readonly porteurDeSens: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StDivider, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StDivider, "st-divider", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "porteurDeSens": { "alias": "porteurDeSens"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Titre de page : le `h1`, et les actions qui lui sont attachees.
+ *
+ * ⚠️ Il rend une **vraie balise `h1`**, la ou `st-heading` porte
+ * `role="heading"` sur son hote. La raison est precise : `StNavigation` de
+ * `@starterlib/core` vise le titre de niveau 1 pour y poser le focus apres une
+ * navigation, et une vraie balise est ce que trouvent aussi les extensions, le
+ * mode lecture et les outils d'audit. Un `h1` par page, jamais deux.
+ *
+ * ⚠️ **Il ne gere PAS le focus**, et ce n'est pas un oubli. Le noyau le fait
+ * deja a chaque changement de route. Deux mecanismes qui deplacent le focus a
+ * la meme milliseconde ne se completent pas : ils se battent, et le gagnant
+ * depend de l'ordre de rendu — donc du hasard.
+ *
+ * ```html
+ * <st-page-title>
+ *   Mes operations
+ *   <button stButton variante="primaire" actions>Exporter</button>
+ * </st-page-title>
+ * ```
+ */
+declare class StPageTitle {
+    /** Texte secondaire sous le titre. Jamais porteur d'information critique. */
+    readonly precision: _angular_core.InputSignal<string | null>;
+    /** Cible d'un `aria-labelledby` : une region se nomme par son titre. */
+    readonly identifiant: _angular_core.InputSignal<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StPageTitle, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StPageTitle, "st-page-title", never, { "precision": { "alias": "precision"; "required": false; "isSignal": true; }; "identifiant": { "alias": "identifiant"; "required": false; "isSignal": true; }; }, {}, never, ["*", "[actions]"], true, never>;
+}
+
+/** Un maillon du fil. Sans `lien`, il n'est pas cliquable. */
+interface MaillonDeFil {
+    readonly libelle: string;
+    /**
+     * Chemin INTERNE de l'application, suivi par le routeur.
+     *
+     * ⚠️ Jamais une adresse externe : un fil d'Ariane decrit ou l'on se trouve
+     * dans CETTE application. Passe par le routeur, un domaine tiers n'est pas
+     * une destination possible.
+     */
+    readonly lien?: string;
+}
+/**
+ * Fil d'Ariane.
+ *
+ * ⚠️ **Le dernier maillon n'est pas un lien.** C'est la page courante : un lien
+ * vers l'endroit ou l'on se trouve deja n'apporte rien, et il ajoute un arret
+ * de tabulation sur chaque page du site. Il porte `aria-current="page"`, qui
+ * est ce que le lecteur d'ecran annonce a sa place.
+ *
+ * ⚠️ **Les separateurs sont poses en `aria-hidden`.** Un chevron ou une barre
+ * oblique laisses dans l'arbre d'accessibilite se lit « barre oblique » entre
+ * chaque maillon : « Accueil barre oblique Comptes barre oblique Operations ».
+ * Les poser en contenu engendre par CSS ne suffit pas — Chrome et Firefox
+ * exposent `content` a l'arbre d'accessibilite.
+ *
+ * ⚠️ La liste est ORDONNEE (`ol`) : l'ordre des maillons est l'information.
+ *
+ * ⚠️ **Les liens passent par le routeur.** La premiere version posait des
+ * `href` bruts : dans une SPA, un clic quittait l'application, repassait par la
+ * coquille du BFF et perdait tout l'etat en memoire — sur le composant de
+ * navigation le plus clique apres le menu.
+ */
+declare class StBreadcrumb {
+    private readonly libelles;
+    readonly maillons: _angular_core.InputSignal<readonly MaillonDeFil[]>;
+    /** `null` : le texte vient du dictionnaire de l'application. */
+    readonly etiquette: _angular_core.InputSignal<string | null>;
+    /** Caractere de separation. Muet pour les technologies d'assistance. */
+    readonly separateur: _angular_core.InputSignal<string>;
+    protected readonly etiquetteLue: _angular_core.Signal<string>;
+    /** Le dernier maillon est la page courante, jamais un lien. */
+    protected readonly derniereIndice: _angular_core.Signal<number>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StBreadcrumb, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StBreadcrumb, "st-breadcrumb", never, { "maillons": { "alias": "maillons"; "required": true; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; "separateur": { "alias": "separateur"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Identifiant par defaut du contenu principal, pose par `st-app-shell`. */
+declare const IDENTIFIANT_DU_CONTENU_PRINCIPAL = "contenu-principal";
+/**
+ * Lien d'evitement : aller au contenu sans traverser la navigation.
+ *
+ * WCAG 2.4.1. Sans lui, chaque page impose a qui navigue au clavier de
+ * traverser l'en-tete et tout le menu avant d'atteindre ce qu'il est venu lire —
+ * trente arrets de tabulation, a chaque changement de page.
+ *
+ * ⚠️ **Le focus est pose par script, et la navigation par ancre est annulee.**
+ * Deux raisons, et chacune suffit :
+ *
+ * 1. Un `href="#contenu"` se resout contre `<base href>`. Sous
+ *    `/ui/<interface>/`, il vise `/ui/<interface>/#contenu` : un rechargement
+ *    complet de la coquille, au lieu d'un saut dans la page.
+ * 2. Suivre une ancre deplace la vue sans toujours deplacer le FOCUS. La
+ *    tabulation suivante repart alors du lien d'evitement, et le saut n'a servi
+ *    a rien.
+ *
+ * Le `href` reste pose : c'est lui qui fait du lien un lien, pour le lecteur
+ * d'ecran comme pour le clic du milieu.
+ *
+ * ⚠️ Il doit etre le PREMIER element focalisable du document. Le composant ne
+ * peut pas l'imposer ; `st-app-shell` le fait.
+ */
+declare class StSkipLink {
+    private readonly document;
+    private readonly libelles;
+    /** Identifiant de l'element a atteindre. */
+    readonly cible: _angular_core.InputSignal<string>;
+    /** `null` : le texte vient du dictionnaire de l'application. */
+    readonly libelle: _angular_core.InputSignal<string | null>;
+    protected readonly libelleLu: _angular_core.Signal<string>;
+    protected readonly ancre: _angular_core.Signal<string>;
+    protected aller(evenement: MouseEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSkipLink, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StSkipLink, "st-skip-link", never, { "cible": { "alias": "cible"; "required": false; "isSignal": true; }; "libelle": { "alias": "libelle"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Coquille d'une application : lien d'evitement, en-tete, navigation, contenu
+ * principal, pied de page.
+ *
+ * ```html
+ * <st-app-shell>
+ *   <ng-container entete>…</ng-container>
+ *   <ng-container navigation>…</ng-container>
+ *   <router-outlet />
+ *   <ng-container pied>…</ng-container>
+ * </st-app-shell>
+ * ```
+ *
+ * ⚠️ Son role est de garantir les REPERES, et un seul de chaque. Une page qui
+ * compte deux `main` — frequent quand une micro-SPA pose le sien dans celui de
+ * la coquille — prive le lecteur d'ecran du raccourci « aller au contenu
+ * principal » : il ne sait plus lequel viser. Les remotes ne posent donc
+ * jamais de `main`, `header` ni `footer` de premier niveau.
+ *
+ * ⚠️ Le lien d'evitement est rendu EN PREMIER, avant l'en-tete : c'est la seule
+ * place ou il sert. Place apres, il faut deja avoir traverse ce qu'il permet
+ * d'eviter.
+ *
+ * Le contenu principal porte l'identifiant vise par le lien d'evitement.
+ * Le focus de navigation, lui, vise le titre de niveau 1 : voir `StNavigation`
+ * de `@starterlib/core`. Les deux se completent — l'un au chargement d'une
+ * page, l'autre a chaque changement de route.
+ *
+ * ⚠️ La coquille ne pose PAS de `<nav>` autour de la navigation : c'est
+ * `st-sidenav` qui porte ce repere. Pose ici aussi, il s'imbriquerait — le
+ * lecteur d'ecran annoncerait « navigation, navigation » — et resterait vide
+ * sur petit ecran, quand le contenu part dans le tiroir.
+ */
+declare class StAppShell {
+    protected readonly identifiantDuContenu = "contenu-principal";
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StAppShell, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StAppShell, "st-app-shell", never, {}, {}, never, ["[entete]", "[navigation]", "*", "[pied]"], true, never>;
+}
+
+/**
+ * Contenu de l'en-tete : bouton de navigation, marque, puis actions.
+ *
+ * ```html
+ * <st-app-shell>
+ *   <st-header entete>
+ *     <button bascule stButton [stSidenavToggle]="navigation">Menu</button>
+ *     <a marque routerLink="/"><st-logo nom="Banque Exemple" clair="/logo.svg" /></a>
+ *     <st-lang-switch [courante]="langue.courante()" (choisie)="langue.changer($event)" />
+ *     <button stButton [stMenuTrigger]="compte">Mon compte</button>
+ *   </st-header>
+ * </st-app-shell>
+ * ```
+ *
+ * ⚠️ **Aucun repere pose ici.** Le `header` de `st-app-shell` est deja le
+ * repere « banniere » ; en ajouter un second dans le premier ferait annoncer
+ * deux bannieres.
+ *
+ * ⚠️ **Composition, pas assemblage.** Il ne cree ni menu, ni bascule, ni logo :
+ * il les place. C'est ce qui le garde dans le tronc — importer `st-menu` l'aurait
+ * fait sortir vers un point d'entree secondaire — et qui laisse chaque SPA
+ * choisir ses actions.
+ *
+ * L'ordre du DOM est l'ordre de lecture et de tabulation : bouton de
+ * navigation, marque, actions. Il n'est jamais inverse par le style.
+ */
+declare class StHeader {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StHeader, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StHeader, "st-header", never, {}, {}, never, ["[bascule]", "[marque]", "*"], true, never>;
+}
+
+type TonDeBanniere = TonSemantique;
+/**
+ * Message de page, persistant jusqu'a ce qu'on le ferme.
+ *
+ * Distinct de `st-offline-banner`, qui dit un fait qu'on ne peut pas fermer, et
+ * de `st-error`, qui remplace un contenu au lieu de l'accompagner.
+ *
+ * ⚠️ **Elle est une region vivante, et ce n'est pas redondant au chargement.**
+ * Un lecteur d'ecran annonce les MUTATIONS d'une region qu'il observe deja :
+ * une banniere presente des l'affichage est lue avec la page, une fois, puis
+ * son apparition ulterieure est annoncee. Le meme mecanisme sert les deux cas.
+ *
+ * ⚠️ Le ton `danger` passe en `alert` (assertif) : une operation qui vient
+ * d'echouer doit interrompre. Les autres restent en `status`, sinon une
+ * confirmation couperait la lecture en cours et ferait perdre sa place.
+ *
+ * ⚠️ Comme `st-spinner` et `st-error`, elle se tait dans une region vivante
+ * existante : sans cela, le lecteur annonce deux fois le meme message.
+ */
+declare class StBanner {
+    private readonly element;
+    private readonly regionParente;
+    private readonly libelles;
+    readonly ton: _angular_core.InputSignal<TonSemantique>;
+    readonly message: _angular_core.InputSignal<string>;
+    /** Titre court au-dessus du message. Le message seul suffit le plus souvent. */
+    readonly titre: _angular_core.InputSignal<string | null>;
+    readonly fermable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** `null` : le texte vient du dictionnaire de l'application. */
+    readonly libelleFermeture: _angular_core.InputSignal<string | null>;
+    readonly ferme: _angular_core.OutputEmitterRef<void>;
+    protected readonly icone: _angular_core.Signal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "triangle-alerte" | "utilisateur">;
+    protected readonly libelleFermetureLu: _angular_core.Signal<string>;
+    protected readonly roleLu: _angular_core.Signal<"status" | "alert" | null>;
+    /**
+     * ⚠️ Le focus est DEPLACE avant l'emission. Sans cela, le bouton disparait
+     * sous le doigt de l'utilisateur clavier, le focus retombe sur le corps du
+     * document, et la navigation repart du haut de la page — le meme defaut que
+     * sur une liste d'etiquettes, et l'un des plus frequents.
+     */
+    protected fermer(): void;
+    /**
+     * Cible, dans l'ordre : le premier element focalisable qui SUIT la banniere
+     * dans le document, sinon le dernier qui la precede, sinon le conteneur s'il
+     * est focalisable par script.
+     *
+     * ⚠️ L'ordre du DOCUMENT, et non les descendants du voisin. La premiere
+     * version cherchait dans `nextElementSibling` : un bouton pose directement
+     * apres la banniere n'etait pas trouve, puisqu'il n'est pas son propre
+     * descendant, et le focus retombait sur le corps du document.
+     */
+    private deplacerLeFocus;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StBanner, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StBanner, "st-banner", never, { "ton": { "alias": "ton"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": true; "isSignal": true; }; "titre": { "alias": "titre"; "required": false; "isSignal": true; }; "fermable": { "alias": "fermable"; "required": false; "isSignal": true; }; "libelleFermeture": { "alias": "libelleFermeture"; "required": false; "isSignal": true; }; }, { "ferme": "ferme"; }, never, ["*"], true, never>;
+}
+
+type TonDeMessage = TonSemantique;
+/**
+ * Message court attache a une zone precise : une aide sous un champ, une
+ * consequence sous un choix, une contrainte au-dessus d'un bouton.
+ *
+ * Distinct de `st-banner`, qui parle de la PAGE et se ferme.
+ *
+ * ⚠️ **Aucun role, aucune region vivante**, et c'est la difference qui compte.
+ * Un message en ligne est lu quand on atteint l'endroit auquel il se rattache ;
+ * en faire une region vivante le ferait annoncer hors contexte, et une
+ * vingtaine de champs produiraient vingt annonces a l'ouverture de l'ecran.
+ *
+ * ⚠️ Pour une erreur de SAISIE, ce composant ne suffit pas : le champ doit
+ * porter `aria-describedby` vers l'identifiant du message, sans quoi le lien
+ * entre les deux n'existe que visuellement. C'est `st-form-field` de la
+ * vague 3 qui posera ce lien.
+ */
+declare class StInlineMessage {
+    readonly ton: _angular_core.InputSignal<TonSemantique>;
+    /** Cible d'un `aria-describedby` pose par le champ decrit. */
+    readonly identifiant: _angular_core.InputSignal<string | null>;
+    protected readonly icone: _angular_core.Signal<"copie" | "boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "triangle-alerte" | "utilisateur">;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StInlineMessage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StInlineMessage, "st-inline-message", never, { "ton": { "alias": "ton"; "required": false; "isSignal": true; }; "identifiant": { "alias": "identifiant"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Forme minimale d'une erreur de validation, telle que Signal Forms la rend :
+ * un genre, et parfois un message.
+ *
+ * Structurelle, pour ne pas importer `@angular/forms` a l'execution (audit de la
+ * vague 3, V3-1). Les proprietes propres a chaque genre — `minLength`, `max`… —
+ * se lisent par leur nom.
+ */
+interface ErreurAffichable {
+    readonly kind: string;
+    readonly message?: string;
+}
+/**
+ * Le texte d'une erreur, dans la langue courante.
+ *
+ * ⚠️ **Un `message` fourni l'emporte toujours.** Un validateur metier, ou une
+ * erreur du serveur deja traduite, en sait plus que le genre : « IBAN d'un pays
+ * non pris en charge » vaut mieux que « Le format n'est pas valide ».
+ *
+ * ⚠️ **Un genre inconnu rend un message generique, jamais le genre brut.**
+ * Afficher `ibanChecksum` a une personne qui saisit un IBAN, c'est lui montrer le
+ * code source.
+ *
+ * La locale sert aux messages qui citent un format, une date ou une taille : « au
+ * format jj/mm/aaaa » n'est pas « mm/dd/yyyy ».
+ */
+declare function messageDErreur(erreur: ErreurAffichable, libelles: LibellesUi, locale?: string): string;
+/** Le motif a taper dans la langue courante : `jj/mm/aaaa`. */
+declare function motifLocal(libelles: LibellesUi, locale: string): string;
+/**
+ * Un jour superieur a 12 : « 31/03/2026 » montre sans ambiguite ou va le jour,
+ * ce que « 01/02/2026 » ne dit pas.
+ */
+declare function exempleDeDate(locale: string): string;
+/**
+ * Erreur d'IBAN, a brancher sur un schema :
+ *
+ * ```ts
+ * validate(chemin.iban, ({ value }) => erreurIban(value()));
+ * ```
+ *
+ * Une fonction pure plutot qu'une regle toute faite : fournir la regle
+ * importerait `validate` d'`@angular/forms` A L'EXECUTION, et le socle ne
+ * l'importe que pour ses types (audit de la vague 3, V3-1).
+ *
+ * ⚠️ Confort de saisie, jamais controle (SEC-5) : le serveur revalide. Un champ
+ * vide n'est pas « invalide » ici — c'est `required` qui le dit, avec le bon
+ * message.
+ */
+declare function erreurIban(valeur: string): ErreurAffichable | null;
+/**
+ * Erreur de FORME d'un numero de telephone : chiffres, `+` de tete facultatif,
+ * de 4 a 15 chiffres — la longueur maximale d'un numero international (E.164).
+ *
+ * ```ts
+ * validate(chemin.telephone, ({ value }) => erreurTelephone(value()));
+ * ```
+ *
+ * ⚠️ Une forme valide ne dit pas que le numero existe : seul le serveur le sait.
+ * Un champ vide n'est pas une erreur de forme : l'obligation est une autre regle.
+ */
+declare function erreurTelephone(valeur: string): ErreurAffichable | null;
+/** Bornes d'une date, en ISO. Absente : pas de borne. */
+interface BornesDeDate {
+    readonly min?: DateIso | null;
+    readonly max?: DateIso | null;
+}
+/**
+ * Erreur de bornes d'une date, a brancher sur un schema :
+ *
+ * ```ts
+ * validate(chemin.naissance, ({ value }) => erreurDate(value(), { max: aujourdHui }));
+ * ```
+ *
+ * Les bornes du schema et celles passees au calendrier doivent etre les memes :
+ * le calendrier grise, le schema refuse une date tapee a la main.
+ */
+declare function erreurDate(valeur: DateIso | null, bornes: BornesDeDate): ErreurAffichable | null;
+/** Une fin anterieure au debut. Une borne manquante n'est pas une erreur de plage. */
+declare function erreurPlageDeDates(plage: PlageDeDates): ErreurAffichable | null;
+/** Regles de `st-file-upload`, les memes que ses entrees. */
+interface ReglesDeFichiers {
+    /** Attribut `accept` : `.pdf, image/*`. */
+    readonly accept?: string;
+    /** En octets. */
+    readonly tailleMax?: number;
+    readonly nombreMax?: number;
+}
+/**
+ * Erreurs d'une liste de fichiers, une par fichier refuse, pour dire LEQUEL :
+ *
+ * ```ts
+ * validate(chemin.pieces, ({ value }) => erreursDeFichiers(value(), regles));
+ * ```
+ *
+ * ⚠️ Confort, jamais securite (SEC-5) : le type se deduit de l'extension, et le
+ * serveur relit le contenu.
+ */
+declare function erreursDeFichiers(fichiers: readonly DescriptionDeFichier[], regles: ReglesDeFichiers): ErreurAffichable[];
+/**
+ * Erreurs a afficher par un champ qui LIT sa saisie (`transformedValue`) : celles
+ * du formulaire, plus les erreurs de lecture qu'il ne connait pas encore.
+ *
+ * ⚠️ Relie a un formulaire, un champ recoit ses erreurs de lecture DANS `errors`,
+ * par Signal Forms. Employe seul, par `[(value)]`, il ne les recoit nulle part :
+ * sans cette fusion, « 12,5,3 » s'afficherait sans le moindre message. Une erreur
+ * deja presente — meme genre, meme partie — n'est pas repetee.
+ */
+declare function fusionnerErreurs(formulaire: readonly ValidationError.WithOptionalFieldTree[], lecture: readonly ValidationError.WithoutFieldTree[]): readonly ErreurAffichable[];
+
+/** Elements natifs qui portent la saisie d'un champ du socle. */
+type ElementDeSaisie = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+/**
+ * Base des champs du socle : le contrat Signal Forms, ecrit une fois — tout sauf
+ * `value`, dont le type depend du champ (texte, montant, date).
+ *
+ * ⚠️ **Une base, et non une copie par champ.** Neuf membres de contrat recopies
+ * dans six composants, c'est six occasions d'en oublier un — et l'oubli ne se
+ * voit pas : un champ sans `touched` n'affiche jamais ses erreurs, un champ sans
+ * reflet de `hidden` ne se masque pas, et rien n'echoue.
+ *
+ * Les noms restent anglais : voir le glossaire, § 8.
+ *
+ * Le gabarit du champ doit nommer son element natif `#champ`, et le brancher sur
+ * `touch` a la perte du focus.
+ */
+declare abstract class ContratDeChamp {
+    readonly libelle: _angular_core.InputSignal<string>;
+    readonly aide: _angular_core.InputSignal<string | null>;
+    readonly errors: _angular_core.InputSignal<readonly ValidationError.WithOptionalFieldTree[]>;
+    readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly touch: _angular_core.OutputEmitterRef<void>;
+    private readonly champ;
+    /** Appele par Signal Forms pour amener le focus sur un champ en erreur. */
+    focus(options?: FocusOptions): void;
+    protected texteSaisi(evenement: Event): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContratDeChamp, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ContratDeChamp, never, never, { "libelle": { "alias": "libelle"; "required": true; "isSignal": true; }; "aide": { "alias": "aide"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, { "touch": "touch"; }, never, never, true, never>;
+}
+/** Base des champs dont la valeur est le texte saisi. */
+declare abstract class ControleDeSaisie extends ContratDeChamp implements FormValueControl<string> {
+    readonly value: _angular_core.ModelSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ControleDeSaisie, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ControleDeSaisie, never, never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+/**
+ * `empilee` : etiquette au-dessus du controle, pour un champ texte.
+ * `case` : controle AVANT son etiquette, pour une case a cocher ou un interrupteur.
+ */
+type DispositionDeChamp = 'empilee' | 'case';
+/**
+ * Etiquette, aide, erreur et controle d'un champ de saisie — et le cablage qui
+ * les relie.
+ *
+ * ⚠️ **Le SEUL endroit ou ce cablage existe** (audit de la vague 3, V3-2). Chaque
+ * champ du socle l'emploie au lieu de refaire identifiants, `aria-describedby` et
+ * `aria-invalid` : c'est precisement le code que l'on croit fini et qui se perd,
+ * un champ specialise a la fois.
+ *
+ * L'ordre visuel suit celui de la lecture : etiquette, aide, erreur, controle.
+ * L'erreur est AU-DESSUS du controle, pour etre vue avant de retaper.
+ *
+ * ⚠️ **L'erreur n'est pas une region vivante.** Annoncee a la perte du focus, elle
+ * couperait la lecture du champ suivant, ou la personne est deja passee. Elle est
+ * reliee au controle, donc lue quand on y revient ; a l'envoi, c'est le
+ * recapitulatif d'erreurs qui prend le focus et les enumere.
+ */
+declare class StFormField {
+    private readonly libelles;
+    private readonly locale;
+    private readonly element;
+    /**
+     * ⚠️ OBLIGATOIRE et toujours visible (UX-1). Un texte indicatif ne le remplace
+     * jamais : il disparait a la premiere frappe.
+     */
+    readonly libelle: _angular_core.InputSignal<string>;
+    /** Aide permanente : format attendu, exemple. Lue apres l'etiquette. */
+    readonly aide: _angular_core.InputSignal<string | null>;
+    /** Texte complementaire tenu a jour par le controle, comme un compteur. */
+    readonly complement: _angular_core.InputSignal<string | null>;
+    readonly erreurs: _angular_core.InputSignal<readonly ErreurAffichable[]>;
+    /**
+     * ⚠️ Faux tant que la personne n'a pas quitte le champ ou tente l'envoi (UX-3) :
+     * un formulaire vierge couvert d'erreurs accuse avant qu'on ait rien fait.
+     */
+    readonly afficherErreurs: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly obligatoire: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * ⚠️ Change l'ordre VISUEL, jamais celui du document : l'etiquette reste
+     * reliee par `for`, et l'ordre de tabulation ne passe que par le controle.
+     */
+    readonly disposition: _angular_core.InputSignal<DispositionDeChamp>;
+    /**
+     * Etiquette lue mais non affichee.
+     *
+     * ⚠️ Reservee a la RECHERCHE, ou l'icone, le bouton et la position en tete de
+     * page disent deja le but du champ. Partout ailleurs, une etiquette masquee est
+     * l'etiquette qui manque au moment ou l'on tape (UX-1).
+     */
+    readonly libelleMasque: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Identifiants du champ, lus par `stControleDeChamp` et par le gabarit. */
+    readonly identifiants: {
+        readonly controle: string;
+        readonly libelle: `${string}-libelle`;
+        readonly aide: `${string}-aide`;
+        readonly complement: `${string}-complement`;
+        readonly erreur: `${string}-erreur`;
+    };
+    protected readonly libelleObligatoire: _angular_core.Signal<string>;
+    /** Messages a afficher, dans la langue courante. Vide tant qu'ils ne doivent pas l'etre. */
+    protected readonly messages: _angular_core.Signal<string[]>;
+    /**
+     * Un clic sur l'etiquette d'un controle non natif n'y mene pas de lui-meme :
+     * on y amene le focus, comme le navigateur le fait pour un champ natif.
+     */
+    protected focaliserLeControle(): void;
+    /** Lu par le controle pour `aria-invalid`. */
+    readonly enErreur: _angular_core.Signal<boolean>;
+    /**
+     * ⚠️ Seuls les elements PRESENTS sont references : un `aria-describedby` qui
+     * vise un identifiant absent est ignore par certains lecteurs d'ecran — tout
+     * entier, y compris les references valides qui l'accompagnent.
+     */
+    readonly descriptions: _angular_core.Signal<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StFormField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StFormField, "st-form-field", never, { "libelle": { "alias": "libelle"; "required": true; "isSignal": true; }; "aide": { "alias": "aide"; "required": false; "isSignal": true; }; "complement": { "alias": "complement"; "required": false; "isSignal": true; }; "erreurs": { "alias": "erreurs"; "required": false; "isSignal": true; }; "afficherErreurs": { "alias": "afficherErreurs"; "required": false; "isSignal": true; }; "obligatoire": { "alias": "obligatoire"; "required": false; "isSignal": true; }; "disposition": { "alias": "disposition"; "required": false; "isSignal": true; }; "libelleMasque": { "alias": "libelleMasque"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+/**
+ * Pose sur l'element natif d'un champ le cablage de son `st-form-field` :
+ * identifiant, description, invalidite, obligation.
+ *
+ * ⚠️ `aria-required` et NON l'attribut `required` natif. Le natif declenche la
+ * validation du navigateur a l'envoi : une bulle « Veuillez renseigner ce champ »
+ * dans la langue du NAVIGATEUR, pas dans celle de l'application, et qui double
+ * le message du socle.
+ */
+declare class StControleDeChamp {
+    protected readonly champ: StFormField;
+    /**
+     * ⚠️ `label for` n'etiquette que les elements natifs de formulaire. Le
+     * declencheur d'une selection multiple est un `div` de role `combobox` : sans
+     * `aria-labelledby`, il n'aurait aucun nom, et l'etiquette visible ne dirait
+     * rien au lecteur d'ecran.
+     */
+    protected readonly etiquetable: boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StControleDeChamp, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StControleDeChamp, "[stControleDeChamp]", never, {}, {}, never, never, true, never>;
+}
+
+type TypeDeSaisie = 'text' | 'email' | 'tel' | 'url' | 'search';
+/**
+ * Champ de saisie d'une ligne, integre a Signal Forms.
+ *
+ * ```html
+ * <st-input libelle="Nom du beneficiaire" autocomplete="name" [formField]="virement.beneficiaire" />
+ * <!-- ou, sans formulaire : -->
+ * <st-input libelle="Reference" [(value)]="reference" />
+ * ```
+ *
+ * ⚠️ **Contrat Signal Forms, noms anglais.** `value`, `errors`, `touched`,
+ * `disabled`… sont cherches PAR LEUR NOM par la directive `[formField]` : les
+ * traduire romprait l'integration sans la moindre erreur (audit de la vague 3,
+ * V3-1). L'import d'`@angular/forms` est un import de TYPE : aucun code n'entre
+ * dans le paquet.
+ *
+ * ⚠️ **Pas d'attribut `maxlength` natif.** Il TRONQUE en silence un texte colle
+ * trop long : la personne croit avoir saisi sa reference entiere, et n'en envoie
+ * que le debut. La limite passe par la validation, qui DIT le depassement.
+ */
+declare class StInput extends ControleDeSaisie {
+    readonly type: _angular_core.InputSignal<TypeDeSaisie>;
+    /**
+     * WCAG 1.3.5 : identifie le but du champ, pour le remplissage automatique et les
+     * aides techniques. `null` : laisse le navigateur decider.
+     */
+    readonly autocomplete: _angular_core.InputSignal<string | null>;
+    /** Clavier virtuel adapte : `numeric`, `decimal`, `email`… */
+    readonly inputmode: _angular_core.InputSignal<string | null>;
+    protected surSaisie(evenement: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StInput, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StInput, "st-input", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "inputmode": { "alias": "inputmode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Zone de texte, integree a Signal Forms, avec compteur quand une longueur
+ * maximale est fixee.
+ *
+ * ⚠️ **Le compteur n'est pas annonce a chaque frappe** : une region vivante qui
+ * change a chaque caractere recouvre ce que la personne tape. Il est RELIE a la
+ * zone — donc lu quand on y revient — et seuls les seuils (20, 10, 0 restants)
+ * et le depassement s'annoncent (UX-11).
+ *
+ * ⚠️ **Pas de `maxlength` natif**, meme raison que `st-input` : un texte colle
+ * serait tronque en silence. Le compteur affiche le depassement, la validation
+ * le refuse.
+ */
+declare class StTextarea extends ControleDeSaisie {
+    private readonly libelles;
+    readonly lignes: _angular_core.InputSignal<number>;
+    /** Contrat Signal Forms : la longueur maximale fixee par le schema. */
+    readonly maxLength: _angular_core.InputSignal<number | undefined>;
+    protected readonly annonce: AnnonceLocale;
+    private readonly restants;
+    protected readonly compteur: _angular_core.Signal<string | null>;
+    constructor();
+    protected surSaisie(evenement: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StTextarea, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StTextarea, "st-textarea", never, { "lignes": { "alias": "lignes"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Groupe de controles, nomme par sa QUESTION.
+ *
+ * ⚠️ `fieldset` et `legend` natifs (UX-7). Sans legende, un lecteur d'ecran
+ * annonce « Oui, bouton radio » et « Non, bouton radio » : la reponse, jamais la
+ * question. La legende est lue a l'entree dans le groupe.
+ *
+ * C'est le pendant de `st-form-field` pour un GROUPE : l'aide et l'erreur sont
+ * reliees au `fieldset` par `aria-describedby`, et l'erreur porte sur le groupe
+ * entier — « Choisissez un mode de reglement » — et non sur chaque option.
+ *
+ * ⚠️ L'obligation se dit dans la legende, en texte : `aria-required` n'est pas
+ * valide sur un groupe, et `required` natif ferait parler le navigateur dans sa
+ * propre langue.
+ */
+declare class StFieldset {
+    private readonly libelles;
+    private readonly locale;
+    /** La question posee par le groupe. Obligatoire. */
+    readonly legende: _angular_core.InputSignal<string>;
+    readonly aide: _angular_core.InputSignal<string | null>;
+    readonly erreurs: _angular_core.InputSignal<readonly ErreurAffichable[]>;
+    readonly afficherErreurs: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly obligatoire: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly base;
+    protected readonly identifiantAide: string;
+    protected readonly identifiantErreur: string;
+    protected readonly libelleObligatoire: _angular_core.Signal<string>;
+    protected readonly messages: _angular_core.Signal<string[]>;
+    protected readonly enErreur: _angular_core.Signal<boolean>;
+    protected readonly descriptions: _angular_core.Signal<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StFieldset, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StFieldset, "st-fieldset", never, { "legende": { "alias": "legende"; "required": true; "isSignal": true; }; "aide": { "alias": "aide"; "required": false; "isSignal": true; }; "erreurs": { "alias": "erreurs"; "required": false; "isSignal": true; }; "afficherErreurs": { "alias": "afficherErreurs"; "required": false; "isSignal": true; }; "obligatoire": { "alias": "obligatoire"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Case a cocher, integree a Signal Forms.
+ *
+ * ```html
+ * <st-checkbox libelle="J'accepte les conditions generales" [formField]="inscription.conditions" />
+ * ```
+ *
+ * Un element `input type="checkbox"` natif : Espace coche, l'etat est annonce,
+ * et la case suit le reglage de contraste du systeme sans rien ecrire.
+ *
+ * ⚠️ **Pour un choix a envoyer avec un formulaire.** Un reglage qui s'applique
+ * IMMEDIATEMENT est un `st-switch` : la case promet un effet a l'envoi, et
+ * l'interrupteur un effet tout de suite (UX-8).
+ */
+declare class StCheckbox implements FormCheckboxControl {
+    readonly libelle: _angular_core.InputSignal<string>;
+    readonly aide: _angular_core.InputSignal<string | null>;
+    /** Contrat Signal Forms. */
+    readonly checked: _angular_core.ModelSignal<boolean>;
+    readonly errors: _angular_core.InputSignal<readonly ValidationError.WithOptionalFieldTree[]>;
+    readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly touch: _angular_core.OutputEmitterRef<void>;
+    private readonly champ;
+    focus(options?: FocusOptions): void;
+    protected surChangement(evenement: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StCheckbox, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StCheckbox, "st-checkbox", never, { "libelle": { "alias": "libelle"; "required": true; "isSignal": true; }; "aide": { "alias": "aide"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touch": "touch"; }, never, never, true, never>;
+}
+
+/** Une option du groupe. */
+interface OptionRadio {
+    readonly valeur: string;
+    readonly libelle: string;
+    /** Precision sous le libelle, reliee a l'option. */
+    readonly aide?: string;
+    readonly desactivee?: boolean;
+}
+/**
+ * Groupe de boutons radio, integre a Signal Forms.
+ *
+ * ```html
+ * <st-radio-group legende="Mode de reglement" [options]="modes" [formField]="commande.mode" />
+ * ```
+ *
+ * ⚠️ **De vrais boutons radio natifs** : un seul arret de tabulation pour le
+ * groupe, deplacement aux fleches, « 2 sur 3 » annonce. Les recrire en ARIA,
+ * c'est cent lignes pour obtenir moins bien — meme raison que `st-theme-toggle`.
+ *
+ * ⚠️ **L'erreur porte sur le groupe**, par `st-fieldset`, et non sur chaque option :
+ * « Choisissez un mode de reglement », une fois.
+ *
+ * `touch` n'est emis que lorsque le focus QUITTE le groupe : passer d'une option a
+ * l'autre aux fleches n'est pas une fin de saisie, et l'erreur n'a pas a surgir
+ * pendant qu'on choisit.
+ */
+declare class StRadioGroup implements FormValueControl<string> {
+    private readonly element;
+    readonly legende: _angular_core.InputSignal<string>;
+    readonly aide: _angular_core.InputSignal<string | null>;
+    readonly options: _angular_core.InputSignal<readonly OptionRadio[]>;
+    /** Contrat Signal Forms. */
+    readonly value: _angular_core.ModelSignal<string>;
+    readonly errors: _angular_core.InputSignal<readonly ValidationError.WithOptionalFieldTree[]>;
+    readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly touch: _angular_core.OutputEmitterRef<void>;
+    /** Nom partage par les options : sans lui, chaque radio forme son propre groupe. */
+    private readonly nomParDefaut;
+    protected nomDuGroupe(): string;
+    protected identifiantAide(indice: number): string;
+    /** Focus sur l'option cochee, sinon la premiere disponible : c'est l'arret du groupe. */
+    focus(options?: FocusOptions): void;
+    protected choisir(valeur: string): void;
+    protected aLaSortie(evenement: FocusEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StRadioGroup, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StRadioGroup, "st-radio-group", never, { "legende": { "alias": "legende"; "required": true; "isSignal": true; }; "aide": { "alias": "aide"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+}
+
+/**
+ * Interrupteur : un reglage qui s'applique IMMEDIATEMENT.
+ *
+ * ```html
+ * <st-switch libelle="Notifications par SMS" [(checked)]="sms" (checkedChange)="enregistrer($event)" />
+ * ```
+ *
+ * ⚠️ **Jamais dans un formulaire a envoyer** (UX-8). Un interrupteur promet que
+ * l'effet a lieu au basculement ; pose au-dessus d'un bouton « Enregistrer », il
+ * ment — la personne croit le reglage applique, quitte la page, et le perd. Pour
+ * un choix envoye plus tard, c'est `st-checkbox`.
+ *
+ * C'est pourquoi il n'affiche aucune erreur de validation : un reglage immediat
+ * ne se valide pas a l'envoi. Un refus du serveur se dit par un message, et
+ * l'interrupteur revient a son etat precedent.
+ *
+ * ⚠️ Une case a cocher native avec `role="switch"` : Espace bascule, l'etiquette
+ * est reliee par `for`, et le lecteur d'ecran annonce « active » ou
+ * « desactive » — mieux qu'un `div` qui imiterait tout cela.
+ */
+declare class StSwitch implements FormCheckboxControl {
+    readonly libelle: _angular_core.InputSignal<string>;
+    readonly aide: _angular_core.InputSignal<string | null>;
+    /** Contrat Signal Forms. */
+    readonly checked: _angular_core.ModelSignal<boolean>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly touch: _angular_core.OutputEmitterRef<void>;
+    private readonly champ;
+    focus(options?: FocusOptions): void;
+    protected surChangement(evenement: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSwitch, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StSwitch, "st-switch", never, { "libelle": { "alias": "libelle"; "required": true; "isSignal": true; }; "aide": { "alias": "aide"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touch": "touch"; }, never, never, true, never>;
+}
+
+/** Une ligne du recapitulatif. */
+interface LigneDErreur {
+    readonly libelle: string | null;
+    readonly message: string;
+    readonly aller: () => void;
+}
+/**
+ * Recapitulatif des erreurs d'un formulaire, a l'envoi.
+ *
+ * ```html
+ * <st-error-summary [erreurs]="tentative() ? virement().errorSummary() : []" />
+ * ```
+ *
+ * ⚠️ **Il prend le focus en apparaissant** (UX-5). Sans lui, une personne au
+ * clavier ou au lecteur d'ecran appuie sur « Envoyer », et rien ne se passe : le
+ * champ refuse est en haut de la page, hors de sa vue, et personne ne le lui dit.
+ *
+ * ⚠️ **Chaque ligne nomme son champ.** « Ce champ est obligatoire. » repete cinq
+ * fois n'apprend rien ; « Nom du beneficiaire : ce champ est obligatoire. », si.
+ * Le libelle est lu sur l'element lie au champ, par Signal Forms — sans registre,
+ * et quel que soit le composant.
+ *
+ * ⚠️ **Une ligne par champ**, la premiere erreur seulement : trois erreurs sur le
+ * meme IBAN font trois lignes pour une seule correction.
+ *
+ * ⚠️ **Une region nommee par son titre.** Un `div` sans role ne PEUT pas porter
+ * `aria-labelledby` : le nom serait ignore, et le focus n'annoncerait rien. En
+ * region, il annonce « 2 erreurs a corriger » a l'arrivee du focus, et se
+ * retrouve dans la liste des reperes.
+ *
+ * Chaque ligne amene le focus sur son champ : c'est le champ, et non la ligne,
+ * qu'il faut corriger. Une erreur rattachee au formulaire entier — un refus du
+ * serveur sur un champ inconnu — s'affiche sans lien.
+ */
+declare class StErrorSummary {
+    private readonly libelles;
+    private readonly locale;
+    private readonly element;
+    private readonly injecteur;
+    readonly erreurs: _angular_core.InputSignal<readonly ValidationError.WithOptionalFieldTree[]>;
+    /** `null` : « N erreurs a corriger », du dictionnaire. */
+    readonly titre: _angular_core.InputSignal<string | null>;
+    /** Unique par instance : deux recapitulatifs sur une page partageraient leur titre. */
+    protected readonly identifiantDuTitre: string;
+    protected readonly lignes: _angular_core.Signal<readonly LigneDErreur[]>;
+    protected readonly titreLu: _angular_core.Signal<string>;
+    constructor();
+    /** A appeler apres un envoi refuse, quand le recapitulatif etait deja visible. */
+    focus(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StErrorSummary, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StErrorSummary, "st-error-summary", never, { "erreurs": { "alias": "erreurs"; "required": true; "isSignal": true; }; "titre": { "alias": "titre"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** `connexion` : un mot de passe existant. `creation` : un nouveau. */
+type UsageDuMotDePasse = 'connexion' | 'creation';
+/**
+ * Mot de passe, avec revelation.
+ *
+ * ```html
+ * <st-password-field libelle="Mot de passe" usage="creation" [regles]="regles" [formField]="compte.motDePasse" />
+ * ```
+ *
+ * ⚠️ **`autocomplete` selon l'usage** (SEC-2) : `current-password` a la connexion,
+ * `new-password` a la creation — c'est ce qui fait proposer par le gestionnaire
+ * un mot de passe FORT au bon endroit, et non l'ancien.
+ *
+ * ⚠️ **Le collage n'est jamais bloque** (SEC-1, NIST SP 800-63B) : l'interdire
+ * pousse vers des mots de passe courts, retenus de tete, et casse les
+ * gestionnaires de mots de passe.
+ *
+ * ⚠️ **Revele, il se remasque des que le focus quitte le champ, et a l'envoi du
+ * formulaire** (SEC-4) : un mot de passe laisse en clair reste lisible par-dessus
+ * l'epaule, sur l'ecran suivant comme sur celui-ci. L'envoi par Entree ne fait
+ * pas quitter le champ : d'ou l'ecoute de `submit`, qui remonte jusqu'au document.
+ *
+ * Le bouton de revelation est un bouton bascule : `aria-pressed` porte l'etat, et
+ * l'etiquette ne change PAS — « Masquer le mot de passe, enfonce » se lirait
+ * comme une double negation.
+ *
+ * ⚠️ **Aucun indicateur de « force »**, et c'est un refus. Une estimation faite
+ * dans le navigateur donne « fort » a `Motdepasse1!` : elle rassure a tort. Les
+ * regles sont affichees AVANT la saisie (UX-10), et c'est le serveur qui verifie —
+ * y compris contre les mots de passe deja divulgues, qu'aucune regle locale ne
+ * voit.
+ */
+declare class StPasswordField extends ControleDeSaisie {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    private readonly element;
+    readonly usage: _angular_core.InputSignal<UsageDuMotDePasse>;
+    /** Regles affichees avant la saisie, comme aide du champ. */
+    readonly regles: _angular_core.InputSignal<readonly string[]>;
+    protected readonly revele: _angular_core.WritableSignal<boolean>;
+    protected readonly autocomplete: _angular_core.Signal<"current-password" | "new-password">;
+    protected readonly aideLue: _angular_core.Signal<string | null>;
+    protected basculer(): void;
+    protected surSaisie(evenement: Event): void;
+    protected aLEnvoi(evenement: Event): void;
+    protected aLaSortie(evenement: FocusEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StPasswordField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StPasswordField, "st-password-field", never, { "usage": { "alias": "usage"; "required": false; "isSignal": true; }; "regles": { "alias": "regles"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Code a usage unique : second facteur, code recu par SMS ou par courriel.
+ *
+ * ⚠️ **UN seul champ, pas six cases** (UX-9). Six champs cassent le collage, le
+ * remplissage automatique du code recu par SMS, et la lecture au lecteur d'ecran,
+ * qui annonce six champs sans nom au lieu d'un seul.
+ *
+ * ⚠️ `autocomplete="one-time-code"` : iOS et Android proposent alors le code recu,
+ * d'un toucher. Clavier numerique par `inputmode`, et NON par `type="number"`,
+ * qui retire les zeros de tete et accepte « 1e5 ».
+ *
+ * ⚠️ **Aucun envoi automatique** a la sixieme saisie : un formulaire qui part de
+ * lui-meme surprend (WCAG 3.2.2), et part aussi avec un code mal colle. Le code
+ * colle est nettoye de ses espaces et tirets — « 123 456 » —, jamais tronque.
+ */
+declare class StOtpField extends ControleDeSaisie {
+    private readonly libelles;
+    readonly longueur: _angular_core.InputSignal<number>;
+    protected readonly aideLue: _angular_core.Signal<string>;
+    protected surSaisie(evenement: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StOtpField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StOtpField, "st-otp-field", never, { "longueur": { "alias": "longueur"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Champ de recherche : un repere, un champ, un bouton.
+ *
+ * ```html
+ * <st-search-field libelle="Rechercher un beneficiaire" (recherche)="filtrer($event)" />
+ * ```
+ *
+ * ⚠️ **Un repere `search`** : la recherche se retrouve dans la liste des reperes du
+ * lecteur d'ecran, a cote de la navigation et du contenu.
+ *
+ * L'etiquette est lue sans etre affichee — seule exception au socle (UX-1) : la
+ * loupe, le bouton et la position disent deja le but du champ.
+ *
+ * ⚠️ **Jamais dans l'adresse quand le terme est personnel** (SEC-6). Chercher un
+ * nom, un IBAN ou un numero en `?q=` inscrit la donnee dans l'historique, dans les
+ * journaux des intermediaires, et dans l'en-tete `Referer` des pages suivantes.
+ * `recherche` emet le terme : c'est a l'appelant de ne pas le mettre dans l'URL.
+ */
+declare class StSearchField extends ControleDeSaisie {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    /** Emis a la validation — Entree ou bouton —, et non a chaque frappe. */
+    readonly recherche: _angular_core.OutputEmitterRef<string>;
+    protected surSaisie(evenement: Event): void;
+    protected lancer(evenement?: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSearchField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StSearchField, "st-search-field", never, {}, { "recherche": "recherche"; }, never, never, true, never>;
+}
+
+/**
+ * IBAN. La valeur du modele est NORMALISEE — sans espaces, en majuscules —, et
+ * l'affichage groupe par quatre.
+ *
+ * ```html
+ * <st-iban-field libelle="IBAN du beneficiaire" [formField]="virement.iban" />
+ * <!-- schema : validate(chemin.iban, ({ value }) => erreurIban(value())) -->
+ * ```
+ *
+ * ⚠️ **Le groupement se fait a la sortie du champ, jamais pendant la frappe.**
+ * Reformater a chaque caractere deplace le curseur a la fin : corriger une
+ * erreur au milieu de 27 caracteres devient impossible, chaque frappe renvoyant a
+ * la fin de la ligne.
+ *
+ * ⚠️ **Aucune verification de validite ici** : elle appartient au schema, par
+ * `erreurIban`, pour s'afficher au bon moment et par le bon canal. Et elle reste un
+ * confort (SEC-5) : le serveur revalide.
+ *
+ * `autocapitalize="characters"` et correction orthographique coupee : un IBAN
+ * n'est pas un mot, et une correction automatique le fausserait.
+ */
+declare class StIbanField extends ControleDeSaisie {
+    private readonly libelles;
+    private readonly enSaisie;
+    private readonly brut;
+    protected readonly aideLue: _angular_core.Signal<string>;
+    /**
+     * Brut pendant la saisie ; groupe par quatre au repos. Une valeur changee de
+     * l'exterieur pendant la saisie — remise a zero du formulaire — l'emporte sur
+     * le brut, qui ne la represente plus.
+     */
+    protected readonly affichage: _angular_core.Signal<string>;
+    protected auFocus(): void;
+    protected surSaisie(evenement: Event): void;
+    protected aLaSortie(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StIbanField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StIbanField, "st-iban-field", never, {}, {}, never, never, true, never>;
+}
+
+/** `tel` : numero complet, indicatif compris. `tel-national` : sans indicatif. */
+type RemplissageDeTelephone = 'tel' | 'tel-national';
+/**
+ * Numero de telephone. La valeur du modele ne garde que les chiffres et le `+` de
+ * tete ; la saisie s'affiche telle qu'elle a ete tapee.
+ *
+ * ```html
+ * <st-phone-field libelle="Telephone portable" [formField]="contact.telephone" />
+ * <!-- schema : validate(chemin.telephone, ({ value }) => erreurTelephone(value())) -->
+ * ```
+ *
+ * ⚠️ **Aucun formatage automatique.** Le groupement des chiffres depend du pays,
+ * et reformater pendant la frappe renvoie le curseur en fin de ligne. La saisie
+ * reste celle de la personne, espaces et points compris.
+ *
+ * ⚠️ **Pas de selecteur de pays, pas de verification par pays.** Il faudrait une
+ * table des plans de numerotation, lourde et souvent perimee : c'est au serveur
+ * de dire si le numero existe (SEC-5). `erreurTelephone` ne verifie que la forme.
+ *
+ * `type="tel"`, et jamais `type="number"` : un numero n'est pas une quantite, et le
+ * champ numerique retire le zero de tete et le `+`.
+ */
+declare class StPhoneField extends ControleDeSaisie {
+    readonly autocomplete: _angular_core.InputSignal<RemplissageDeTelephone>;
+    private readonly brut;
+    /**
+     * La saisie telle que tapee, tant qu'elle represente encore la valeur ; une
+     * valeur changee de l'exterieur — remise a zero, pre-remplissage — l'emporte.
+     */
+    protected readonly affichage: _angular_core.Signal<string>;
+    protected surSaisie(evenement: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StPhoneField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StPhoneField, "st-phone-field", never, { "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Un choix d'une liste : `st-select`, `st-combobox`, `st-multiselect`.
+ *
+ * La `valeur` part dans le modele, le `libelle` s'affiche : un identifiant
+ * technique ne s'affiche jamais, et un libelle traduit ne s'envoie jamais.
+ */
+interface OptionDeListe {
+    readonly valeur: string;
+    readonly libelle: string;
+    readonly desactivee?: boolean;
+    /** Regroupe les options consecutives sous un intitule (`optgroup`). */
+    readonly groupe?: string;
+}
+/** Sans accents ni casse : « eleve » trouve « Élève ». */
+declare function normaliserPourRecherche(texte: string): string;
+/** Options dont le libelle CONTIENT le texte cherche, sans accents ni casse. */
+declare function filtrerOptions(options: readonly OptionDeListe[], recherche: string): readonly OptionDeListe[];
+
+interface BlocDOptions {
+    readonly groupe: string | null;
+    readonly options: readonly OptionDeListe[];
+}
+/**
+ * Liste deroulante, sur un `select` NATIF.
+ *
+ * ```html
+ * <st-select libelle="Pays" [options]="pays" autocomplete="country" [formField]="adresse.pays" />
+ * ```
+ *
+ * ⚠️ **Natif, et non une liste ARIA** (FE-4). Le `select` natif ouvre le selecteur
+ * du systeme sur mobile, se remplit automatiquement, se parcourt a la lettre, et
+ * se lit partout. Une liste recomposee en ARIA ne fait jamais mieux sur ces
+ * points ; elle ne se justifie que pour filtrer une longue liste — c'est
+ * `st-combobox` — ou choisir plusieurs valeurs — `st-multiselect`.
+ *
+ * La premiere option, vide, dit « Choisir… » : sans elle, la premiere vraie
+ * option paraitrait choisie alors que personne ne l'a fait. Le modele vaut
+ * alors `''`, que `required` refuse.
+ *
+ * `readonly` n'existe pas sur un `select` : le champ annonce `aria-readonly` et
+ * ignore le changement, plutot que d'etre desactive — un champ desactive sort de
+ * l'ordre de tabulation, et sa valeur ne se lit plus.
+ */
+declare class StSelect extends ControleDeSaisie {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    readonly options: _angular_core.InputSignal<readonly OptionDeListe[]>;
+    /** Texte de l'option vide. Par defaut : « Choisir… ». */
+    readonly texteVide: _angular_core.InputSignal<string | null>;
+    /** WCAG 1.3.5 : `country`, `sex`, `honorific-prefix`… */
+    readonly autocomplete: _angular_core.InputSignal<string | null>;
+    /** Options consecutives d'un meme groupe, dans l'ordre fourni. */
+    protected readonly blocs: _angular_core.Signal<readonly BlocDOptions[]>;
+    protected surChoix(evenement: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSelect, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StSelect, "st-select", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "texteVide": { "alias": "texteVide"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+interface Jour {
+    readonly date: DateIso;
+    /** Jour d'un mois voisin : cellule vide, la date vit dans son propre mois. */
+    readonly horsDuMois: boolean;
+    readonly numero: string;
+    readonly nom: string;
+    readonly horsBornes: boolean;
+    readonly choisi: boolean;
+    readonly dansLaPlage: boolean;
+    readonly aujourdHui: boolean;
+}
+/**
+ * Calendrier d'un mois, pour choisir une date.
+ *
+ * ```html
+ * <st-calendar [selection]="depart()" dateMin="2026-09-17" (choix)="depart.set($event)" />
+ * ```
+ *
+ * ⚠️ **Une aide, jamais la seule voie.** Dans `st-date-field`, le calendrier
+ * complete un champ texte : une date de naissance se tape plus vite qu'elle ne se
+ * cherche mois par mois, et un calendrier reste penible au lecteur d'ecran.
+ *
+ * ⚠️ **Le clavier navigue de DATE en date, pas de cellule en cellule** (decision
+ * D7 de l'audit de la vague 3). Fleche droite le 30 septembre mene au 1er
+ * octobre ; Page suivante change de mois, Maj + Page d'annee ; Debut et Fin vont
+ * aux bords de la semaine de la LOCALE. La grille d'Angular Aria deplace un focus
+ * entre cellules affichees : il aurait fallu la contourner sur chaque touche qui
+ * compte, et elle aurait fait entrer le CDK dans les formulaires.
+ *
+ * Semaine commencant au jour de la locale, noms de jours et de mois dans la
+ * langue courante, « aujourd'hui » dans le fuseau de la personne
+ * (`FUSEAU_PAR_DEFAUT`) et non celui du poste.
+ */
+declare class StCalendar {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    private readonly locale;
+    private readonly element;
+    private readonly injecteur;
+    private readonly aujourdHui;
+    readonly selection: _angular_core.InputSignal<string | null>;
+    readonly dateMin: _angular_core.InputSignal<string | null>;
+    readonly dateMax: _angular_core.InputSignal<string | null>;
+    /** Periode a faire ressortir, pour un choix de plage. */
+    readonly plage: _angular_core.InputSignal<PlageDeDates | null>;
+    readonly choix: _angular_core.OutputEmitterRef<string>;
+    /** Echap : le conteneur decide de fermer, et ou rendre le focus. */
+    readonly fermeture: _angular_core.OutputEmitterRef<void>;
+    protected readonly identifiants: {
+        readonly titre: `${string}-titre`;
+        readonly aide: `${string}-aide`;
+    };
+    /** La date qui porte le focus. Suit la selection, bornee. */
+    private readonly active;
+    private readonly premierJour;
+    protected readonly titre: _angular_core.Signal<string>;
+    protected readonly joursDeLaSemaine: _angular_core.Signal<{
+        court: string;
+        long: string;
+    }[]>;
+    protected readonly semaines: _angular_core.Signal<readonly (readonly Jour[])[]>;
+    protected readonly moisPrecedentPossible: _angular_core.Signal<boolean>;
+    protected readonly moisSuivantPossible: _angular_core.Signal<boolean>;
+    protected estActive(date: DateIso): boolean;
+    /** Amene le focus sur la date active. */
+    focus(): void;
+    protected changerDeMois(ecart: number): void;
+    protected choisir(jour: Jour): void;
+    protected surTouche(evenement: KeyboardEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StCalendar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StCalendar, "st-calendar", never, { "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "dateMin": { "alias": "dateMin"; "required": false; "isSignal": true; }; "dateMax": { "alias": "dateMax"; "required": false; "isSignal": true; }; "plage": { "alias": "plage"; "required": false; "isSignal": true; }; }, { "choix": "choix"; "fermeture": "fermeture"; }, never, never, true, never>;
+}
+
+/**
+ * Choix de fichiers, sur un `input type="file"` natif.
+ *
+ * ```html
+ * <st-file-upload libelle="Justificatifs" accept=".pdf, image/*" [tailleMax]="5_000_000" multiple
+ *   [formField]="dossier.pieces" />
+ * <!-- schema : validate(chemin.pieces, ({ value }) => erreursDeFichiers(value(), regles)) -->
+ * ```
+ *
+ * Le modele est la liste des `File` choisis. L'envoi appartient a l'application,
+ * par `@starterlib/core` : le composant choisit, il ne televerse pas.
+ *
+ * ⚠️ **L'element natif reste la voie principale** (FE-4) : il ouvre le selecteur
+ * du systeme, l'appareil photo sur mobile, et se commande au clavier. Il est
+ * masque visuellement, pas retire : le bouton affiche est son etiquette. Le
+ * depot par glisser est un complement a la souris, jamais la seule voie.
+ *
+ * ⚠️ **Aucun apercu d'image** (SEC-7). Un apercu passe par une adresse `blob:`
+ * que la politique de securite du contenu doit autoriser, et un SVG affiche peut
+ * porter du script. Le nom et la taille suffisent a reconnaitre un fichier.
+ *
+ * ⚠️ **`accept`, `tailleMax` et `nombreMax` sont un confort** (SEC-5) : ils
+ * s'affichent en aide et filtrent le selecteur du systeme, mais la verification
+ * est dans le schema — `erreursDeFichiers` —, et le serveur relit le contenu.
+ *
+ * Chaque changement de la liste s'annonce : « 2 fichiers choisis ». Un fichier
+ * retire rend le focus au bouton de retrait suivant, ou au choix de fichiers : le
+ * focus ne tombe jamais sur le document.
+ */
+declare class StFileUpload extends ContratDeChamp implements FormValueControl<readonly File[]> {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    private readonly locale;
+    private readonly element;
+    private readonly injecteur;
+    readonly value: _angular_core.ModelSignal<readonly File[]>;
+    /** Attribut `accept` natif : `.pdf, image/*`. */
+    readonly accept: _angular_core.InputSignal<string>;
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** En octets. Affiche en aide ; la verification est dans le schema. */
+    readonly tailleMax: _angular_core.InputSignal<number | null>;
+    protected readonly annonce: AnnonceLocale;
+    protected readonly survol: _angular_core.WritableSignal<boolean>;
+    protected readonly aideLue: _angular_core.Signal<string | null>;
+    protected readonly lignes: _angular_core.Signal<{
+        fichier: File;
+        cle: string;
+        taille: string;
+    }[]>;
+    protected surChoix(evenement: Event): void;
+    protected surSurvol(evenement: DragEvent): void;
+    protected surDepot(evenement: DragEvent): void;
+    protected retirer(indice: number): void;
+    protected aLaSortie(evenement: FocusEvent): void;
+    private ajouter;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StFileUpload, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StFileUpload, "st-file-upload", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "tailleMax": { "alias": "tailleMax"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+/**
+ * Choix du theme : systeme, clair, sombre.
+ *
+ * ⚠️ **Trois etats, donc PAS un interrupteur.** `role="switch"` et
+ * `aria-pressed` sont binaires : poses sur un choix a trois valeurs, ils
+ * annoncent « active » ou « desactive » sans jamais dire lequel des trois est
+ * retenu. Un groupe de boutons radio dit exactement « Sombre, bouton radio,
+ * coche, 3 sur 3 ».
+ *
+ * ⚠️ **Composant de PRESENTATION.** Il n'injecte pas `StTheme` : `ui` ne depend
+ * pas de `@starterlib/core` (ADR 0003). La coquille le relie au noyau :
+ *
+ * ```html
+ * <st-theme-toggle [choix]="theme.choix()" (choisi)="theme.choisir($event)" />
+ * ```
+ */
+declare class StThemeToggle {
+    private readonly libelles;
+    readonly choix: _angular_core.InputSignal<ChoixDeTheme>;
+    /** Legende visible. Masquee par defaut, mais toujours lue : elle nomme le groupe. */
+    readonly legendeVisible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly choisi: _angular_core.OutputEmitterRef<ChoixDeTheme>;
+    /** Unique par instance : deux bascules sur la meme page partageraient leur groupe radio. */
+    protected readonly nom: string;
+    protected readonly legende: _angular_core.Signal<string>;
+    protected readonly options: _angular_core.Signal<{
+        valeur: ChoixDeTheme;
+        libelle: string;
+    }[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StThemeToggle, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StThemeToggle, "st-theme-toggle", never, { "choix": { "alias": "choix"; "required": true; "isSignal": true; }; "legendeVisible": { "alias": "legendeVisible"; "required": false; "isSignal": true; }; }, { "choisi": "choisi"; }, never, never, true, never>;
+}
+
+/**
+ * Choix de la langue de l'interface.
+ *
+ * ⚠️ **Chaque option porte son propre `lang`.** Sans lui, un lecteur d'ecran
+ * regle en francais lit « English » avec une voix francaise, et le mot devient
+ * incomprehensible pour la personne anglophone qui cherchait justement a
+ * l'entendre.
+ *
+ * ⚠️ **Composant de PRESENTATION.** Il n'injecte pas `StLangue` : `ui` ne depend
+ * pas de `@starterlib/core` (ADR 0003). La coquille le relie au noyau :
+ *
+ * ```html
+ * <st-lang-switch [courante]="langue.courante()" (choisie)="langue.changer($event)" />
+ * ```
+ */
+declare class StLangSwitch {
+    private readonly libelles;
+    readonly courante: _angular_core.InputSignal<Langue>;
+    readonly langues: _angular_core.InputSignal<readonly Langue[]>;
+    readonly legendeVisible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly choisie: _angular_core.OutputEmitterRef<Langue>;
+    protected readonly nom: string;
+    protected readonly legende: _angular_core.Signal<string>;
+    protected readonly options: _angular_core.Signal<{
+        code: Langue;
+        endonyme: string;
+    }[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StLangSwitch, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StLangSwitch, "st-lang-switch", never, { "courante": { "alias": "courante"; "required": true; "isSignal": true; }; "langues": { "alias": "langues"; "required": false; "isSignal": true; }; "legendeVisible": { "alias": "legendeVisible"; "required": false; "isSignal": true; }; }, { "choisie": "choisie"; }, never, never, true, never>;
+}
+
+/**
+ * Bouton qui copie une valeur : reference de virement, adresse de depot, lien
+ * de partage.
+ *
+ * ⚠️ **Un element, et non un attribut pose sur un `<button>`.** La confirmation
+ * passe par une region vivante voisine du bouton ; posee DANS le bouton, elle
+ * entrerait dans son nom accessible, qui deviendrait « Copier Copie ».
+ *
+ * ⚠️ **Le libelle du bouton ne change pas** apres la copie, pour la raison que
+ * donne `st-code` : le lecteur d'ecran annoncerait un autre controle que celui
+ * qu'il a sous le doigt.
+ *
+ * ⚠️ **Jamais de secret.** Ce qui entre dans le presse-papiers est conserve par
+ * les gestionnaires d'historique et synchronise entre appareils : ni mot de
+ * passe, ni jeton, ni code a usage unique.
+ *
+ * Sans presse-papiers — hors contexte securise — le bouton n'est pas rendu : un
+ * controle qui ne peut rien faire ne doit pas s'offrir.
+ */
+declare class StCopyButton {
+    private readonly document;
+    private readonly libelles;
+    readonly valeur: _angular_core.InputSignal<string>;
+    /**
+     * `null` : le texte vient du dictionnaire de l'application.
+     *
+     * ⚠️ En icone seule, c'est le nom accessible du bouton : il doit dire CE qui
+     * est copie quand la page en offre plusieurs — « Copier l'IBAN » et non
+     * « Copier » repete cinq fois.
+     */
+    readonly libelle: _angular_core.InputSignal<string | null>;
+    readonly iconeSeule: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly messageDeConfirmation: _angular_core.InputSignal<string | null>;
+    readonly copie: _angular_core.OutputEmitterRef<string>;
+    protected readonly annonce: AnnonceLocale;
+    protected readonly disponible: boolean;
+    protected readonly libelleLu: _angular_core.Signal<string>;
+    protected copier(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StCopyButton, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StCopyButton, "st-copy-button", never, { "valeur": { "alias": "valeur"; "required": true; "isSignal": true; }; "libelle": { "alias": "libelle"; "required": false; "isSignal": true; }; "iconeSeule": { "alias": "iconeSeule"; "required": false; "isSignal": true; }; "messageDeConfirmation": { "alias": "messageDeConfirmation"; "required": false; "isSignal": true; }; }, { "copie": "copie"; }, never, never, true, never>;
+}
+
+/**
+ * Compte a rebours avant un nouvel essai, pour une reponse `429` et son en-tete
+ * `Retry-After`.
+ *
+ * ```html
+ * @if (erreur.reessayerDans !== null) {
+ *   <st-timer [secondes]="erreur.reessayerDans" (termine)="reessayable.set(true)" />
+ * }
+ * ```
+ *
+ * ⚠️ **Il n'annonce PAS chaque seconde.** Une region vivante qui change toutes les
+ * secondes recouvre tout ce que le lecteur d'ecran essaie de dire, et empeche de
+ * lire le formulaire que la personne est justement en train de garder pret. Le
+ * decompte porte `role="timer"`, dont la valeur implicite est
+ * `aria-live="off"` : il se LIT quand on l'atteint. Seule la fin s'annonce.
+ *
+ * ⚠️ **Le temps restant se calcule contre l'horloge, pas en comptant les
+ * battements.** Un onglet en arriere-plan voit ses minuteries ralenties a une par
+ * minute : un compteur decremente a chaque battement afficherait encore
+ * « 45 s » a son retour, bien apres que le serveur a leve la limite.
+ */
+declare class StTimer {
+    private readonly libelles;
+    private readonly locale;
+    /** Duree d'attente en secondes, telle que `Retry-After` la donne. */
+    readonly secondes: _angular_core.InputSignal<number>;
+    readonly termine: _angular_core.OutputEmitterRef<void>;
+    protected readonly annonce: AnnonceLocale;
+    private readonly restant;
+    private echeance;
+    private minuterie;
+    protected readonly texte: _angular_core.Signal<string>;
+    constructor();
+    private demarrer;
+    private battre;
+    private arreter;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StTimer, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StTimer, "st-timer", never, { "secondes": { "alias": "secondes"; "required": true; "isSignal": true; }; }, { "termine": "termine"; }, never, never, true, never>;
+}
+
+/**
+ * Logo de l'organisation, en variante claire, sombre et monochrome.
+ *
+ * ⚠️ **Le texte alternatif est le NOM de l'organisation, jamais « logo ».** Un
+ * lecteur d'ecran annonce deja « image » : « Logo Banque Exemple » se lit
+ * « image, logo Banque Exemple ». Pose dans un lien vers l'accueil, ce nom
+ * devient celui du lien — il doit donc dire ou il mene.
+ *
+ * ⚠️ **Decoratif quand le nom est ecrit a cote.** Le repeter ferait lire
+ * « Banque Exemple Banque Exemple ».
+ *
+ * La variante suit le theme EFFECTIF pose par `StTheme` sur `<html data-theme>`,
+ * et non `prefers-color-scheme` : une personne qui a choisi le clair sur un
+ * systeme sombre doit voir le logo clair. Sous contraste force, la variante
+ * monochrome prend le relais — un logo en couleurs peut y disparaitre sur le
+ * fond impose.
+ *
+ * Les images viennent de la meme origine : la politique de securite du contenu
+ * n'autorise pas d'autre source d'image sans extension explicite cote BFF.
+ */
+declare class StLogo {
+    /** Nom de l'organisation : c'est le texte alternatif. */
+    readonly nom: _angular_core.InputSignal<string>;
+    readonly clair: _angular_core.InputSignal<string>;
+    /** `null` : la variante claire sert aussi sur fond sombre. */
+    readonly sombre: _angular_core.InputSignal<string | null>;
+    /** `null` : aucune variante dediee au contraste force. */
+    readonly monochrome: _angular_core.InputSignal<string | null>;
+    readonly decoratif: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly hauteur: _angular_core.InputSignal<string>;
+    protected readonly texteAlternatif: _angular_core.Signal<string>;
+    protected readonly sourceSombre: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StLogo, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StLogo, "st-logo", never, { "nom": { "alias": "nom"; "required": true; "isSignal": true; }; "clair": { "alias": "clair"; "required": true; "isSignal": true; }; "sombre": { "alias": "sombre"; "required": false; "isSignal": true; }; "monochrome": { "alias": "monochrome"; "required": false; "isSignal": true; }; "decoratif": { "alias": "decoratif"; "required": false; "isSignal": true; }; "hauteur": { "alias": "hauteur"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Impose les cinq etats a un bloc qui consomme l'API, et centralise leur
  * annonce.
@@ -871,7 +2445,7 @@ declare class StState<T> {
     private readonly valeurRetenue;
     /** Etat deduit de la ressource, valeur retenue comprise. */
     private readonly etatDeLaRessource;
-    readonly etatEffectif: _angular_core.Signal<EtatDeBloc>;
+    protected readonly etatEffectif: _angular_core.Signal<EtatDeBloc>;
     /**
      * Une valeur est affichee, et une autre arrive — par rappel explicite ou par
      * changement de parametre.
@@ -881,7 +2455,7 @@ declare class StState<T> {
     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<{
+    protected readonly contexte: _angular_core.Signal<{
         $implicit: unknown;
     }>;
     /**
@@ -890,7 +2464,7 @@ declare class StState<T> {
      * l'illusion que les cinq etats sont traites. Il vaut mieux que le manque se
      * voie, en developpement.
      */
-    readonly gabaritDeLEtat: _angular_core.Signal<TemplateRef<unknown> | null>;
+    protected readonly gabaritDeLEtat: _angular_core.Signal<TemplateRef<unknown> | null>;
     private readonly chargementVisible;
     /** La silhouette par defaut, une fois le delai anti-clignotement passe. */
     protected readonly montreLaSilhouetteParDefaut: _angular_core.Signal<boolean>;
@@ -962,5 +2536,5 @@ declare class StChargement {
 /** 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, 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 };
+export { AnnonceLocale, CHEMIN_DU_SPRITE, ContratDeChamp, ControleDeSaisie, FUSEAU_PAR_DEFAUT, GABARITS_D_ETAT, IDENTIFIANT_DU_CONTENU_PRINCIPAL, LIBELLES_EN, LIBELLES_FR, NOMS_DICONE, REGION_VIVANTE_PARENTE, ST_LIBELLES, ST_LOCALE, StAppShell, StAvatar, StBadge, StBanner, StBreadcrumb, StButton, StButtonGroup, StCalendar, StCard, StChargement, StCheckbox, StCode, StControleDeChamp, StCopyButton, StCount, StDate, StDivider, StEmpty, StErreur, StError, StErrorSummary, StFieldset, StFileUpload, StFormField, StHeader, StHeading, StHorsLigne, StIbanField, StIcon, StIconButton, StInlineMessage, StInput, StLangSwitch, StLink, StLogo, StMasked, StMoney, StOfflineBanner, StOtpField, StPageTitle, StPasswordField, StPhoneField, StProgress, StRadioGroup, StRelativeTime, StSearchField, StSection, StSelect, StSkeleton, StSkipLink, StSpinner, StState, StStatusPill, StSucces, StSwitch, StTag, StText, StTextarea, StThemeToggle, StTimer, StVide, copierDansLePressePapiers, erreurDate, erreurIban, erreurPlageDeDates, erreurTelephone, erreursDeFichiers, exempleDeDate, filtrerOptions, formaterDuree, fournirCheminDuSprite, fusionnerErreurs, messageDErreur, motifLocal, normaliserPourRecherche, pressePapiersDisponible, provideStarterUi };
+export type { BornesDeDate, ConfigurationUi, DispositionDeChamp, ElementDeSaisie, ErreurAffichable, FormatDeDate, GraisseDeTexte, IssueDeCopie, LibellesUi, MaillonDeFil, NiveauDeTitre, NomDIcone, OptionDeListe, OptionRadio, OrientationDeSeparateur, ReglesDeFichiers, ReliefDeCarte, RembourrageDeCarte, RemplissageDeTelephone, TailleDIcone, TailleDeBouton, TailleDeSpinner, TailleDeTitre, TonDIcone, TonDeBadge, TonDeBanniere, TonDeMessage, TonDeProgression, TonDeSpinner, TonDeStatut, TypeDeSaisie, TypeMasque, UsageDuMotDePasse, VarianteDErreur, VarianteDeBouton, VarianteDeBoutonIcone, VarianteDeLien, VarianteDeSquelette, VarianteDeTexte };