@starterlib/ui 0.3.0 → 0.5.0

package/types/starterlib-ui.d.ts

@@ -1,7 +1,9 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Signal, Provider, DestroyRef, Resource, TemplateRef } from '@angular/core';
-import { Ton, Montant, TonSemantique, ChoixDeTheme, Langue, EtatDeBloc } from '@starterlib/util';
+import { InjectionToken, Signal, Provider, DestroyRef, TemplateRef, Resource } 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.
@@ -59,7 +61,83 @@ interface LibellesUi {
     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;
+    /** Listes et tableaux */
+    readonly pagination: string;
+    readonly pagePrecedente: string;
+    readonly pageSuivante: string;
+    readonly pageNumero: (numero: number) => string;
+    readonly afficherPlus: string;
+    readonly lignesParPage: string;
+    readonly selectionnerLaPage: (nombre: number) => string;
+    readonly selectionnerLaLigne: (ligne: string) => string;
+    readonly lignesSelectionnees: (nombre: number) => string;
+    readonly trieCroissant: (colonne: string) => string;
+    readonly trieDecroissant: (colonne: string) => string;
+    readonly tableauVide: string;
+    readonly nonRenseigne: string;
+    readonly filtres: string;
+    readonly filtresActifs: string;
+    readonly retirerLeFiltre: (filtre: string) => string;
+    readonly effacerLesFiltres: string;
+    readonly filtreRetire: (filtre: string) => string;
+    readonly filtresEffaces: string;
     /** Dialogues */
     readonly confirmer: string;
     readonly annuler: string;
@@ -243,7 +321,7 @@ type TonDIcone = Exclude<Ton, 'inverse'>;
  */
 declare class StIcon {
     private readonly cheminDuSprite;
-    readonly nom: _angular_core.InputSignal<"copie" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "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" | "tri" | "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. */
@@ -262,7 +340,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", "tri", "triangle-alerte", "utilisateur"];
 type NomDIcone = (typeof NOMS_DICONE)[number];
 
 type VarianteDeTexte = 'corps' | 'corps-sm' | 'discret' | 'legende' | 'mono';
@@ -419,8 +497,8 @@ 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<"copie" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "corbeille" | "croix" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "triangle-alerte" | "utilisateur" | null>;
-    readonly iconeApres: _angular_core.InputSignal<"copie" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "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" | "tri" | "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" | "tri" | "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
@@ -458,7 +536,7 @@ type VarianteDeBoutonIcone = Extract<VarianteDeBouton, 'discret' | 'secondaire'
  * de facon fiable.
  */
 declare class StIconButton {
-    readonly icone: _angular_core.InputSignal<"copie" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "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" | "tri" | "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>;
@@ -750,7 +828,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<"copie" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "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" | "tri" | "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>;
@@ -843,7 +921,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<"copie" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "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" | "tri" | "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>;
@@ -881,7 +959,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<"copie" | "boite-vide" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "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" | "tri" | "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>;
@@ -1209,7 +1287,7 @@ declare class StBanner {
     /** `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" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "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" | "tri" | "triangle-alerte" | "utilisateur">;
     protected readonly libelleFermetureLu: _angular_core.Signal<string>;
     protected readonly roleLu: _angular_core.Signal<"status" | "alert" | null>;
     /**
@@ -1255,11 +1333,1323 @@ 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" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "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" | "tri" | "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>;
+}
+
+/**
+ * `pages` : page precedente et suivante, pour un tableau.
+ * `suite` : « Afficher plus », pour une liste qui s'allonge.
+ */
+type ModeDePagination = 'pages' | 'suite';
+/** Ce qui peut recevoir le focus apres un changement de page. */
+interface Focalisable {
+    focus(options?: FocusOptions): void;
+}
+/**
+ * Pagination d'une liste par curseur.
+ *
+ * ```html
+ * <st-data-table #tableau … />
+ * <st-pagination
+ *   [numero]="navigation.numeroDePage()"
+ *   [precedenteDisponible]="navigation.precedenteDisponible()"
+ *   [suivanteDisponible]="page.value()?.hasMore ?? false"
+ *   [chargement]="page.isLoading()"
+ *   [cible]="tableau"
+ *   (precedente)="navigation.precedente()"
+ *   (suivante)="navigation.suivante(page.value())"
+ * />
+ * ```
+ *
+ * ⚠️ **Ni total, ni numeros cliquables** : le backend ne compte pas et ne va que
+ * vers l'avant (audit de la vague 4, V4-2). « Page 3 » se dit ; « page 3 sur 12 »
+ * serait invente.
+ *
+ * ⚠️ **Boutons indisponibles, jamais desactives** : sur la derniere page, « Page
+ * suivante » garde le focus qu'il avait. Desactive, il le perdrait, et le lecteur
+ * d'ecran retomberait sur le debut du document.
+ *
+ * ⚠️ **Apres un changement de page, le focus va a la `cible`** — la legende du
+ * tableau — et « Page 2 » s'annonce (UX-13). Sans cela, la personne au clavier
+ * reste en bas, sur « Page suivante », sans savoir que le contenu au-dessus a
+ * change.
+ */
+declare class StPagination {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    private readonly injecteur;
+    readonly mode: _angular_core.InputSignal<ModeDePagination>;
+    /** A partir de 1. */
+    readonly numero: _angular_core.InputSignal<number>;
+    readonly precedenteDisponible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly suivanteDisponible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly chargement: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Nom de la navigation, quand une page en porte plusieurs. */
+    readonly etiquette: _angular_core.InputSignal<string | null>;
+    /** Tailles proposees ; vide, pas de choix. Plafonnees a 100. */
+    readonly taillesDePage: _angular_core.InputSignal<readonly number[]>;
+    readonly taille: _angular_core.ModelSignal<number>;
+    /** Recoit le focus apres un changement de page. */
+    readonly cible: _angular_core.InputSignal<Focalisable | (() => Focalisable | null) | null>;
+    readonly precedente: _angular_core.OutputEmitterRef<void>;
+    readonly suivante: _angular_core.OutputEmitterRef<void>;
+    protected readonly annonce: AnnonceLocale;
+    protected readonly tailles: _angular_core.Signal<number[]>;
+    protected readonly etiquetteLue: _angular_core.Signal<string>;
+    constructor();
+    protected surTaille(evenement: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StPagination, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StPagination, "st-pagination", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "numero": { "alias": "numero"; "required": false; "isSignal": true; }; "precedenteDisponible": { "alias": "precedenteDisponible"; "required": false; "isSignal": true; }; "suivanteDisponible": { "alias": "suivanteDisponible"; "required": false; "isSignal": true; }; "chargement": { "alias": "chargement"; "required": false; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; "taillesDePage": { "alias": "taillesDePage"; "required": false; "isSignal": true; }; "taille": { "alias": "taille"; "required": false; "isSignal": true; }; "cible": { "alias": "cible"; "required": false; "isSignal": true; }; }, { "taille": "tailleChange"; "precedente": "precedente"; "suivante": "suivante"; }, never, never, true, never>;
+}
+
+/** Une paire terme et valeur. `description` nulle : « Non renseigne ». */
+interface ElementDeDescription {
+    /** Relie l'element a un gabarit `stDescription`. Par defaut : le terme. */
+    readonly cle?: string;
+    readonly terme: string;
+    readonly description: string | null;
+}
+/** Contexte d'un gabarit de description. */
+interface ContexteDeDescription {
+    readonly $implicit: ElementDeDescription;
+}
+/**
+ * Valeur riche d'un element : montant, date, valeur masquee.
+ *
+ * ```html
+ * <ng-template stDescription="iban" let-element>
+ *   <st-masked nature="iban" [valeur]="compte().iban" />
+ * </ng-template>
+ * ```
+ */
+declare class StDescription {
+    readonly cle: _angular_core.InputSignal<string>;
+    readonly gabarit: TemplateRef<ContexteDeDescription>;
+    static ngTemplateContextGuard(_directive: StDescription, _contexte: unknown): _contexte is ContexteDeDescription;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StDescription, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StDescription, "ng-template[stDescription]", never, { "cle": { "alias": "stDescription"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * Liste de descriptions : les proprietes d'un objet, sur une page de detail.
+ *
+ * ```html
+ * <st-description-list [elements]="[
+ *   { terme: 'Reference', description: commande().reference },
+ *   { cle: 'montant', terme: 'Montant', description: null },
+ * ]">
+ *   <ng-template stDescription="montant"><st-money [valeur]="commande().montant" /></ng-template>
+ * </st-description-list>
+ * ```
+ *
+ * ⚠️ **Un vrai `dl`, rendu par le composant.** Le lecteur d'ecran annonce « liste de
+ * descriptions, 4 elements » et lit chaque terme avec sa valeur. Ecrits par
+ * l'application et projetes, `dt` et `dd` echapperaient aux styles du composant,
+ * et un `div` mal place rendrait la liste invalide.
+ *
+ * ⚠️ **Une valeur absente se dit** : « — » a l'ecran, « Non renseigne » au lecteur
+ * d'ecran. Une cellule vide ne distingue pas « aucun » de « pas encore charge ».
+ *
+ * En colonnes quand la place le permet, empile en dessous : la largeur est celle
+ * du CONTENEUR, pas de l'ecran — la meme liste dans une carte etroite s'empile
+ * aussi sur un grand ecran (UX-18).
+ */
+declare class StDescriptionList {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    readonly elements: _angular_core.InputSignal<readonly ElementDeDescription[]>;
+    private readonly gabarits;
+    protected readonly lignes: _angular_core.Signal<{
+        element: ElementDeDescription;
+        gabarit: TemplateRef<ContexteDeDescription> | null;
+    }[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StDescriptionList, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StDescriptionList, "st-description-list", never, { "elements": { "alias": "elements"; "required": true; "isSignal": true; }; }, {}, ["gabarits"], never, true, never>;
+}
+
+/** Contexte d'un gabarit d'element de liste. */
+interface ContexteDElementDeListe<T> {
+    readonly $implicit: T;
+    readonly indice: number;
+}
+/**
+ * Rendu d'un element, type par `[stElementDeListeDe]` :
+ *
+ * ```html
+ * <ng-template stElementDeListe [stElementDeListeDe]="expeditions()" let-expedition>
+ *   <a [routerLink]="['/expeditions', expedition.id]">{{ expedition.reference }}</a>
+ * </ng-template>
+ * ```
+ */
+declare class StElementDeListe<T> {
+    /** Sert seulement au typage du contexte ; nom de l'attribut, d'ou l'absence d'alias. */
+    readonly stElementDeListeDe: _angular_core.InputSignal<readonly T[] | null | undefined>;
+    readonly gabarit: TemplateRef<ContexteDElementDeListe<T>>;
+    static ngTemplateContextGuard<T>(_directive: StElementDeListe<T>, _contexte: unknown): _contexte is ContexteDElementDeListe<T>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StElementDeListe<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StElementDeListe<any>, "ng-template[stElementDeListe]", never, { "stElementDeListeDe": { "alias": "stElementDeListeDe"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * Liste d'objets : expeditions, notifications, documents. La forme mobile d'un
+ * tableau (UX-5).
+ *
+ * ```html
+ * <st-list #liste etiquette="Mes expeditions" [elements]="expeditions()" cle="id">
+ *   <ng-template stElementDeListe [stElementDeListeDe]="expeditions()" let-expedition>…</ng-template>
+ * </st-list>
+ * <st-pagination mode="suite" [cible]="liste" … />
+ * ```
+ *
+ * ⚠️ **Un lien DANS l'element, jamais un element cliquable** (UX-3) : le lien a un
+ * nom, s'ouvre dans un onglet, et laisse les autres boutons de l'element
+ * atteignables.
+ *
+ * ⚠️ **`focus()` va au premier element AJOUTE** depuis le dernier affichage : apres
+ * « Afficher plus », la lecture reprend la ou la liste s'est allongee, et non en
+ * tete. Apres un filtre, la liste raccourcit, et le focus va au premier element.
+ *
+ * `track` par la cle : un rafraichissement garde le focus sur le bon element.
+ */
+declare class StList<T> {
+    private readonly element;
+    readonly elements: _angular_core.InputSignal<readonly T[]>;
+    /** Propriete qui identifie un element. */
+    readonly cle: _angular_core.InputSignal<keyof T & string>;
+    /** Nom de la liste, lu a l'entree. */
+    readonly etiquette: _angular_core.InputSignal<string | null>;
+    /** `ol` quand l'ordre a un sens : etapes, classement. */
+    readonly ordonnee: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Contenu en cours de remplacement : `aria-busy`. */
+    readonly chargement: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly gabarit: _angular_core.Signal<StElementDeListe<any> | undefined>;
+    private indiceDuPremierAjout;
+    protected readonly lignes: _angular_core.Signal<{
+        valeur: T;
+        indice: number;
+        identifiant: string;
+    }[]>;
+    constructor();
+    /** Focus sur le premier element ajoute, ou sur le premier. */
+    focus(options?: FocusOptions): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StList<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StList<any>, "st-list", never, { "elements": { "alias": "elements"; "required": true; "isSignal": true; }; "cle": { "alias": "cle"; "required": true; "isSignal": true; }; "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; "ordonnee": { "alias": "ordonnee"; "required": false; "isSignal": true; }; "chargement": { "alias": "chargement"; "required": false; "isSignal": true; }; }, {}, ["gabarit"], never, true, never>;
+}
+
+type SensDeTri = 'croissant' | 'decroissant';
+/**
+ * Bouton de tri d'une colonne, pose DANS l'en-tete : `<th><button stSortHeader>`.
+ *
+ * ⚠️ **Le bouton, pas l'en-tete cliquable** : un `th` n'est ni focalisable ni
+ * annonce comme actionnable. Et l'etat se porte par `aria-sort` sur le `th`, que
+ * `st-data-table` pose sur la SEULE colonne triee (FE-3).
+ *
+ * ⚠️ **Ne trie rien.** Il dit l'intention ; c'est le serveur qui trie, et le
+ * contrat actuel ne le fait pas (audit de la vague 4, V4-3). Trier la page
+ * affichee ferait croire a un tri de toute la liste.
+ *
+ * Une colonne non triee montre deux chevrons, pour se signaler triable sans
+ * attendre le survol ; l'icone est decorative, l'etat est lu par `aria-sort`.
+ */
+declare class StSortHeader {
+    readonly sens: _angular_core.InputSignal<SensDeTri | 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" | "tri" | "triangle-alerte" | "utilisateur">;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StSortHeader, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StSortHeader, "button[stSortHeader]", never, { "sens": { "alias": "sens"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/** Une colonne, decrite en donnees. */
+interface ColonneDeTableau {
+    /** Identifie la colonne ; par defaut, la propriete affichee. */
+    readonly cle: string;
+    readonly libelle: string;
+    /** `fin` pour les nombres et les montants (UX-4). */
+    readonly alignement?: 'debut' | 'fin';
+    /** Seulement si le SERVEUR trie sur cette colonne (V4-3). */
+    readonly triable?: boolean;
+    /** Libelle lu mais non affiche : colonne d'actions. Jamais vide. */
+    readonly libelleMasque?: boolean;
+}
+interface TriDeTableau {
+    readonly cle: string;
+    readonly sens: SensDeTri;
+}
+type DensiteDeTableau = 'confortable' | 'compacte';
+/** Contexte d'un gabarit de cellule. */
+interface ContexteDeCellule<T> {
+    readonly $implicit: T;
+    readonly colonne: ColonneDeTableau;
+}
+/**
+ * Rendu d'une cellule, type par `[stCelluleDe]` :
+ *
+ * ```html
+ * <ng-template stCellule="montant" [stCelluleDe]="lignes()" let-ligne>
+ *   <st-money [valeur]="ligne.montant" />
+ * </ng-template>
+ * ```
+ */
+declare class StCellule<T> {
+    readonly cle: _angular_core.InputSignal<string>;
+    /** Sert seulement au typage du contexte ; nom de l'attribut, d'ou l'absence d'alias. */
+    readonly stCelluleDe: _angular_core.InputSignal<readonly T[] | null | undefined>;
+    readonly gabarit: TemplateRef<ContexteDeCellule<T>>;
+    static ngTemplateContextGuard<T>(_directive: StCellule<T>, _contexte: unknown): _contexte is ContexteDeCellule<T>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StCellule<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StCellule<any>, "ng-template[stCellule]", never, { "cle": { "alias": "stCellule"; "required": true; "isSignal": true; }; "stCelluleDe": { "alias": "stCelluleDe"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Contenu du tableau vide : un `st-empty`, avec son action. */
+declare class StTableauVide {
+    readonly gabarit: TemplateRef<unknown>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StTableauVide, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StTableauVide, "ng-template[stTableauVide]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Tableau de donnees, sur un `<table>` NATIF.
+ *
+ * ```html
+ * <st-data-table #tableau legende="Expeditions" [colonnes]="colonnes" [lignes]="lignes()"
+ *   cle="id" selectionnable [(selection)]="choisies" [chargement]="page.isLoading()">
+ *   <ng-template stCellule="reference" [stCelluleDe]="lignes()" let-ligne>
+ *     <a [routerLink]="['/expeditions', ligne.id]">{{ ligne.reference }}</a>
+ *   </ng-template>
+ *   <button stButton stActionsDeTableau (click)="exporter()">Exporter</button>
+ * </st-data-table>
+ * ```
+ *
+ * ⚠️ **Un tableau, pas une grille** (audit de la vague 4, V4-1). Le lecteur d'ecran
+ * sait parcourir un `<table>` de cellule en cellule ; une grille ARIA remplacerait
+ * ce parcours par les fleches, et rendrait les liens des cellules plus durs a
+ * atteindre. Ni Material, ni `CdkTable` : pas de pair dans le tronc.
+ *
+ * - **Legende obligatoire** (UX-1), et une colonne d'en-tete de ligne — la premiere
+ *   par defaut — pour que chaque cellule se lise avec sa ligne (UX-2).
+ * - **Zone de defilement nommee** : focalisable quand le tableau deborde (UX-6),
+ *   colonne figee sans masquer le focus (UX-7), en-tete fige seulement avec
+ *   `hauteurMax` (UX-8).
+ * - **Selection de la PAGE, par cle** (V4-4) : elle ne garde que les lignes encore
+ *   affichees, et se vide donc au changement de page.
+ * - **Tri PILOTE** : le tableau dit la demande et l'annonce, il ne reordonne
+ *   jamais les lignes (V4-3).
+ * - **Chargement** : squelette au premier, lignes gardees et `aria-busy` ensuite
+ *   (UX-11).
+ * - Export, actions de masse : zone `stActionsDeTableau`, et le SERVEUR fait le
+ *   travail (V4-5, SEC-4, SEC-5).
+ */
+declare class StDataTable<T> {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    readonly legende: _angular_core.InputSignal<string>;
+    /** Lue mais non affichee, quand un titre visible nomme deja le tableau. */
+    readonly legendeMasquee: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly colonnes: _angular_core.InputSignal<readonly ColonneDeTableau[]>;
+    readonly lignes: _angular_core.InputSignal<readonly T[]>;
+    /** Propriete qui identifie une ligne. Jamais l'indice (FE-1). */
+    readonly cle: _angular_core.InputSignal<keyof T & string>;
+    /** Colonne lue comme en-tete de chaque ligne. Par defaut : la premiere. */
+    readonly enTeteDeLigne: _angular_core.InputSignal<string | null>;
+    readonly premiereColonneFigee: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Hauteur maximale, `32rem` : l'en-tete se fige, le corps defile. */
+    readonly hauteurMax: _angular_core.InputSignal<string | null>;
+    readonly densite: _angular_core.InputSignal<DensiteDeTableau>;
+    readonly chargement: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly selectionnable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly selection: _angular_core.ModelSignal<readonly string[]>;
+    readonly tri: _angular_core.ModelSignal<TriDeTableau | null>;
+    /** Texte du tableau vide, sans gabarit `stTableauVide`. */
+    readonly texteVide: _angular_core.InputSignal<string | null>;
+    private readonly gabarits;
+    protected readonly gabaritVide: _angular_core.Signal<StTableauVide | undefined>;
+    private readonly zone;
+    protected readonly annonce: AnnonceLocale;
+    protected readonly deborde: _angular_core.WritableSignal<boolean>;
+    protected readonly largeurFigee: _angular_core.WritableSignal<number>;
+    protected readonly identifiants: {
+        readonly legende: `${string}-legende`;
+        readonly selection: `${string}-selection`;
+    };
+    protected readonly cleDEnTete: _angular_core.Signal<string>;
+    protected readonly cellules: _angular_core.Signal<{
+        colonne: ColonneDeTableau;
+        gabarit: TemplateRef<ContexteDeCellule<any>> | null;
+        enTete: boolean;
+    }[]>;
+    protected readonly rangees: _angular_core.Signal<{
+        valeur: T;
+        identifiant: string;
+        nom: string | null;
+        choisie: boolean;
+    }[]>;
+    protected readonly squelette: _angular_core.Signal<number[]>;
+    protected readonly nombreDeColonnes: _angular_core.Signal<number>;
+    protected readonly colonnesDeSquelette: _angular_core.Signal<number[]>;
+    protected readonly toutesChoisies: _angular_core.Signal<boolean>;
+    protected readonly quelquesChoisies: _angular_core.Signal<boolean>;
+    constructor();
+    /** Amene le focus sur le tableau : sa legende est lue (UX-13). */
+    focus(options?: FocusOptions): void;
+    protected sensDe(colonne: ColonneDeTableau): SensDeTri | null;
+    protected ariaSort(colonne: ColonneDeTableau): string | null;
+    protected trier(colonne: ColonneDeTableau): void;
+    protected basculerTout(): void;
+    protected basculer(identifiant: string): void;
+    protected texteDe(ligne: T, colonne: ColonneDeTableau): string | null;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StDataTable<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StDataTable<any>, "st-data-table", never, { "legende": { "alias": "legende"; "required": true; "isSignal": true; }; "legendeMasquee": { "alias": "legendeMasquee"; "required": false; "isSignal": true; }; "colonnes": { "alias": "colonnes"; "required": true; "isSignal": true; }; "lignes": { "alias": "lignes"; "required": true; "isSignal": true; }; "cle": { "alias": "cle"; "required": true; "isSignal": true; }; "enTeteDeLigne": { "alias": "enTeteDeLigne"; "required": false; "isSignal": true; }; "premiereColonneFigee": { "alias": "premiereColonneFigee"; "required": false; "isSignal": true; }; "hauteurMax": { "alias": "hauteurMax"; "required": false; "isSignal": true; }; "densite": { "alias": "densite"; "required": false; "isSignal": true; }; "chargement": { "alias": "chargement"; "required": false; "isSignal": true; }; "selectionnable": { "alias": "selectionnable"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "tri": { "alias": "tri"; "required": false; "isSignal": true; }; "texteVide": { "alias": "texteVide"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "tri": "triChange"; }, ["gabarits", "gabaritVide"], ["[stActionsDeTableau]"], true, never>;
+}
+
+/**
+ * Filtre actif, retirable : « Statut : Expediee ✕ ».
+ *
+ * ```html
+ * <button stFilterChip libelle="Statut : Expediee" (click)="retirer('statut')"></button>
+ * ```
+ *
+ * ⚠️ **Toute la puce est le bouton**, et son nom CONTIENT le texte visible —
+ * « Retirer le filtre Statut : Expediee » (WCAG 2.5.3) : une commande vocale
+ * « cliquer Statut » l'atteint. Une croix seule, a cote d'un texte inerte, serait
+ * une cible de quelques pixels sans nom.
+ */
+declare class StFilterChip {
+    private readonly libelles;
+    readonly libelle: _angular_core.InputSignal<string>;
+    protected readonly nom: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StFilterChip, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StFilterChip, "button[stFilterChip]", never, { "libelle": { "alias": "libelle"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Un filtre en vigueur, tel qu'il se lit : « Statut : Expediee ». */
+interface FiltreActif {
+    readonly cle: string;
+    readonly libelle: string;
+}
+/**
+ * Barre de filtres : les champs, puis les filtres en vigueur, retirables.
+ *
+ * ```html
+ * <st-filter-bar [filtresActifs]="actifs()" (retrait)="retirer($event)" (effacement)="effacer()">
+ *   <st-select libelle="Statut" [options]="statuts" [(value)]="statut" />
+ * </st-filter-bar>
+ * ```
+ *
+ * Un formulaire NOMME : repere « Filtres » dans la liste des reperes du lecteur
+ * d'ecran. Pas un repere `search` : un `st-search-field` pose dedans en porte deja
+ * un, et deux reperes imbriques se liraient en double.
+ *
+ * ⚠️ **Les filtres s'appliquent au changement**, par l'application : Entree dans
+ * un champ n'envoie rien, et ne recharge pas la page.
+ *
+ * ⚠️ **Retirer un filtre rend le focus a la puce suivante**, sinon a la
+ * precedente, sinon au formulaire ; « Effacer les filtres » le rend au formulaire
+ * (UX-14). Le focus ne tombe jamais sur le document, et le retrait s'annonce.
+ *
+ * ⚠️ **Dans l'adresse, des valeurs d'enumeration seulement** (SEC-2) : un texte
+ * cherche, un nom, un IBAN n'y vont pas. Le composant ne touche pas a l'adresse ;
+ * la regle est pour l'application qui le ferait.
+ */
+declare class StFilterBar {
+    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
+    private readonly element;
+    private readonly injecteur;
+    /** Nom du formulaire. Par defaut : « Filtres ». */
+    readonly etiquette: _angular_core.InputSignal<string | null>;
+    readonly filtresActifs: _angular_core.InputSignal<readonly FiltreActif[]>;
+    readonly retrait: _angular_core.OutputEmitterRef<string>;
+    readonly effacement: _angular_core.OutputEmitterRef<void>;
+    protected readonly annonce: AnnonceLocale;
+    protected readonly identifiantActifs: string;
+    protected readonly etiquetteLue: _angular_core.Signal<string>;
+    protected retirer(filtre: FiltreActif, indice: number): void;
+    protected effacer(): void;
+    private apresLeRendu;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StFilterBar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StFilterBar, "st-filter-bar", never, { "etiquette": { "alias": "etiquette"; "required": false; "isSignal": true; }; "filtresActifs": { "alias": "filtresActifs"; "required": false; "isSignal": true; }; }, { "retrait": "retrait"; "effacement": "effacement"; }, never, ["*"], true, never>;
+}
+
 /**
  * Choix du theme : systeme, clair, sombre.
  *
@@ -1591,5 +2981,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 { AnnonceLocale, CHEMIN_DU_SPRITE, 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, StCard, StChargement, StCode, StCopyButton, StCount, StDate, StDivider, StEmpty, StErreur, StError, StHeader, StHeading, StHorsLigne, StIcon, StIconButton, StInlineMessage, StLangSwitch, StLink, StLogo, StMasked, StMoney, StOfflineBanner, StPageTitle, StProgress, StRelativeTime, StSection, StSkeleton, StSkipLink, StSpinner, StState, StStatusPill, StSucces, StTag, StText, StThemeToggle, StTimer, StVide, copierDansLePressePapiers, formaterDuree, fournirCheminDuSprite, pressePapiersDisponible, provideStarterUi };
-export type { ConfigurationUi, FormatDeDate, GraisseDeTexte, IssueDeCopie, LibellesUi, MaillonDeFil, NiveauDeTitre, NomDIcone, OrientationDeSeparateur, ReliefDeCarte, RembourrageDeCarte, TailleDIcone, TailleDeBouton, TailleDeSpinner, TailleDeTitre, TonDIcone, TonDeBadge, TonDeBanniere, TonDeMessage, 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, StCellule, StChargement, StCheckbox, StCode, StControleDeChamp, StCopyButton, StCount, StDataTable, StDate, StDescription, StDescriptionList, StDivider, StElementDeListe, StEmpty, StErreur, StError, StErrorSummary, StFieldset, StFileUpload, StFilterBar, StFilterChip, StFormField, StHeader, StHeading, StHorsLigne, StIbanField, StIcon, StIconButton, StInlineMessage, StInput, StLangSwitch, StLink, StList, StLogo, StMasked, StMoney, StOfflineBanner, StOtpField, StPageTitle, StPagination, StPasswordField, StPhoneField, StProgress, StRadioGroup, StRelativeTime, StSearchField, StSection, StSelect, StSkeleton, StSkipLink, StSortHeader, StSpinner, StState, StStatusPill, StSucces, StSwitch, StTableauVide, 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, ColonneDeTableau, ConfigurationUi, ContexteDElementDeListe, ContexteDeCellule, ContexteDeDescription, DensiteDeTableau, DispositionDeChamp, ElementDeDescription, ElementDeSaisie, ErreurAffichable, FiltreActif, Focalisable, FormatDeDate, GraisseDeTexte, IssueDeCopie, LibellesUi, MaillonDeFil, ModeDePagination, NiveauDeTitre, NomDIcone, OptionDeListe, OptionRadio, OrientationDeSeparateur, ReglesDeFichiers, ReliefDeCarte, RembourrageDeCarte, RemplissageDeTelephone, SensDeTri, TailleDIcone, TailleDeBouton, TailleDeSpinner, TailleDeTitre, TonDIcone, TonDeBadge, TonDeBanniere, TonDeMessage, TonDeProgression, TonDeSpinner, TonDeStatut, TriDeTableau, TypeDeSaisie, TypeMasque, UsageDuMotDePasse, VarianteDErreur, VarianteDeBouton, VarianteDeBoutonIcone, VarianteDeLien, VarianteDeSquelette, VarianteDeTexte };