@starterlib/ui 0.7.2 → 0.8.0

package/types/starterlib-ui-saisie.d.ts

@@ -0,0 +1,924 @@
+import { DateIso, PlageDeDates, DescriptionDeFichier } from '@starterlib/util';
+import { ValidationError, FormValueControl, FormCheckboxControl } from '@angular/forms/signals';
+import * as _starterlib_ui from '@starterlib/ui';
+import { LibellesUi, AnnonceLocale } from '@starterlib/ui';
+import * as _angular_core from '@angular/core';
+
+/**
+ * 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>;
+}
+
+/**
+ * Cle d'un fichier choisi : deux choix du meme fichier ne l'ajoutent pas deux
+ * fois, et l'application s'en sert pour dire ou en est chaque televersement.
+ */
+declare function cleDeFichier(fichier: File): string;
+/**
+ * Ou en est un fichier, vu de l'application. `message` dit POURQUOI un fichier
+ * est refuse — « antivirus indisponible » et « type refuse » n'appellent pas la
+ * meme suite (UX-3 de la 0.6.0).
+ */
+interface EtatDeTeleversementAffiche {
+    readonly etape: 'en-cours' | 'depose' | 'refuse';
+    /** 0 a 100, pendant l'envoi. */
+    readonly progression?: number;
+    readonly message?: string;
+}
+/**
+ * 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.
+ *
+ * ⚠️ **Il ne televerse pas.** `etats` dit ou en est chaque fichier, et le bouton
+ * de la ligne devient « Annuler » pendant l'envoi : le trajet — declaration, depot
+ * pre-signe, confirmation antivirus — vit dans `StTeleversement`
+ * (`@starterlib/core`), seul a parler au reseau.
+ */
+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>;
+    /**
+     * Ou en est chaque fichier, par `cleDeFichier`. Le composant AFFICHE ce trajet,
+     * il ne le fait pas : `StTeleversement` de `@starterlib/core` s'en charge.
+     */
+    readonly etats: _angular_core.InputSignal<ReadonlyMap<string, EtatDeTeleversementAffiche> | 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;
+        etat: EtatDeTeleversementAffiche | null;
+    }[]>;
+    protected surChoix(evenement: Event): void;
+    protected surSurvol(evenement: DragEvent): void;
+    protected surDepot(evenement: DragEvent): void;
+    /** Emis quand la personne interrompt un envoi : c'est l'application qui annule. */
+    readonly annulation: _angular_core.OutputEmitterRef<File>;
+    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; }; "etats": { "alias": "etats"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "annulation": "annulation"; }, never, never, true, never>;
+}
+
+export { ContratDeChamp, ControleDeSaisie, StCalendar, StCheckbox, StControleDeChamp, StErrorSummary, StFieldset, StFileUpload, StFormField, StIbanField, StInput, StOtpField, StPasswordField, StPhoneField, StRadioGroup, StSearchField, StSelect, StSwitch, StTextarea, cleDeFichier, erreurDate, erreurIban, erreurPlageDeDates, erreurTelephone, erreursDeFichiers, exempleDeDate, filtrerOptions, fusionnerErreurs, messageDErreur, motifLocal, normaliserPourRecherche };
+export type { BornesDeDate, DispositionDeChamp, ElementDeSaisie, ErreurAffichable, EtatDeTeleversementAffiche, OptionDeListe, OptionRadio, ReglesDeFichiers, RemplissageDeTelephone, TypeDeSaisie, UsageDuMotDePasse };