@starterlib/ui 0.8.0 → 0.9.1

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

@@ -1,18 +1,58 @@
-import * as _angular_core from '@angular/core';
-import * as _starterlib_ui from '@starterlib/ui';
-import { AnnonceLocale } from '@starterlib/ui';
-import { ControleDeSaisie, OptionDeListe, ContratDeChamp } from '@starterlib/ui/saisie';
-import { FormValueControl } from '@angular/forms/signals';
-
+import { AnnonceLocale } from "@starterlib/ui";
+import { ContratDeChamp, ControleDeSaisie, OptionDeListe, PresentationDeLibelle } from "@starterlib/ui/saisie";
+import { SuggestionDAdresse, sansCommandesDeDirection } from "@starterlib/util";
+import * as i0 from "@angular/core";
+import { TemplateRef } from "@angular/core";
+import { FormValueControl } from "@angular/forms/signals";
+/** Contexte du gabarit d'option de `st-combobox`. */
+export interface ContexteDOption {
+  /** L'option rendue. */
+  readonly $implicit: OptionDeListe;
+  /**
+   * L'option porte-t-elle la coche ? Meme etat que la coche posee par le composant : l'option
+   * `aria-selected`, celle qu'Entree retiendrait (la selection suit l'option active au clavier).
+   */
+  readonly choisie: boolean;
+}
+/**
+ * Rendu d'une option de `st-combobox`, quand deux lignes de texte ne suffisent pas (code mono et
+ * libelle, planche 15) :
+ *
+ * ```html
+ * <st-combobox libelle="Instrument" [options]="instruments">
+ *   <ng-template stOption let-option>
+ *     <span class="code">{{ option.valeur }}</span> {{ option.libelle }}
+ *   </ng-template>
+ * </st-combobox>
+ * ```
+ *
+ * ⚠️ **Ce que le gabarit AFFICHE est ce qui se LIT.** L'option est nommee par le texte que le
+ * gabarit rend (`aria-labelledby` vers une seconde copie, masquee, du meme rendu) : le code de l'exemple fait partie du nom, une
+ * commande vocale le trouve (WCAG 1.3.1, 2.5.3). L'`aide` reste lue en description. Le `libelle`
+ * sert toujours au filtrage, a la recherche au clavier et au texte du champ une fois le choix fait :
+ * que le gabarit le rende, pour que le nom commence par ce que la personne tape.
+ *
+ * Le gabarit est donc rendu deux fois par option : qu'il reste leger et sans effet de bord. Sa
+ * copie visible est INERTE (`inert`) : une option ne contient aucun element interactif, et un
+ * lien ou un bouton qui s'y glisserait ne prendrait jamais le focus.
+ *
+ * Sans gabarit, l'option rend son `libelle` (son nom) et, dessous, son `aide` en texte discret.
+ */
+export declare class StOption {
+  readonly gabarit: TemplateRef<ContexteDOption>;
+  static ngTemplateContextGuard(_directive: StOption, _contexte: unknown): _contexte is ContexteDOption;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StOption, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<StOption, "ng-template[stOption]", never, {}, {}, never, never, true, never>;
+}
 /** `local` : le composant filtre `options`. `distant` : l'application filtre, sur `recherche`. */
-type FiltrageDeListe = 'local' | 'distant';
+export type FiltrageDeListe = 'local' | 'distant';
 /**
  * Liste de choix a filtrer en tapant, sur `@angular/aria/combobox` et
  * `@angular/aria/listbox`.
  *
  * ```html
  * <st-combobox libelle="Beneficiaire" [options]="beneficiaires" [formField]="virement.beneficiaire" />
- * <!-- liste servie par le serveur : -->
+ * <!-- liste servie par le serveur, temporisee : -->
  * <st-combobox libelle="Commune" filtrage="distant" [options]="communes()"
  *   (recherche)="terme.set($event)" [formField]="adresse.commune" />
  * ```
@@ -26,44 +66,205 @@ type FiltrageDeListe = 'local' | 'distant';
  * - La liste s'ouvre a la frappe et a la fleche bas ; Entree choisit, Echap
  *   ferme. Le focus reste dans le champ (`aria-activedescendant`).
  * - Le nombre de resultats s'annonce apres la frappe, une fois : le lecteur
- *   d'ecran ne voit pas la liste se reduire.
+ *   d'ecran ne voit pas la liste se reduire — en local comme en distant, des
+ *   que l'application remplace `options` pendant une recherche en cours.
  * - ⚠️ **Quitter le champ sans choisir rend le texte du choix precedent.** Un
  *   texte qui ne correspond a aucune option ne reste pas affiche comme s'il etait
  *   retenu ; un champ vide, lui, retire le choix.
+ * - ⚠️ **La frappe n'est jamais effacee par une reponse du serveur** (A1124,
+ *   A1151) : le texte affiche ne depend que du CHOIX (`value`), jamais de
+ *   `options` — une liste remplacee pendant que la personne tape ne touche pas
+ *   a ce qu'elle a ecrit. Si le libelle du choix n'etait pas encore connu (liste
+ *   servie vide au depart, valeur preremplie par le serveur), il se met a jour
+ *   des que `options` l'apporte, mais seulement hors frappe et hors focus.
  * - La liste est posee dans la couche superieure du navigateur (`popover`) par le
  *   CDK : un dialogue ou un tableau defilant ne la rogne pas.
+ * - `readonly` : le champ reste tabulable et lisible, mais ne s'ouvre plus (Fleche
+ *   bas, Entree, Espace et la frappe sans effet), comme `st-select`.
+ * - Le CHOIX retenu s'affiche en graisse semi (planche 13-2) : ce qui est tape, et
+ *   pas encore choisi, reste en graisse normale — on voit ce qui partira.
+ * - Une option porte son `aide` sur une seconde ligne, lue en description. Avec un
+ *   gabarit `stOption`, l'option est nommee par le texte que le gabarit rend (ce qui
+ *   se voit se lit), et ce contenu est inerte (voir `StOption`).
+ * - `chargement` (distant, reponse attendue) : l'indicateur prend la place du
+ *   chevron apres le delai d'attente, `aria-busy` sur le champ et la liste. Le
+ *   composant affiche ce que `options` contient : une liste vide pendant l'attente
+ *   ne dit pas « Aucun resultat » (ni a l'ecran ni a l'annonce) mais « Chargement en
+ *   cours » ; le nombre de resultats s'annonce a la FIN de l'attente.
+ * - `longueurMinimale` (distant) : sous ce nombre de caracteres, une liste vide dit « Saisissez
+ *   au moins 3 caracteres. » et non « Aucun resultat » — l'application ne cherche pas encore, ce
+ *   n'est pas une recherche sans reponse.
  *
- * ⚠️ En `distant`, `recherche` est emis a chaque frappe : a l'application de
- * temporiser, et de ne pas mettre le terme dans l'adresse (SEC-6).
+ * ⚠️ En `distant`, `recherche` n'est emis QU'EN MODE DISTANT (jamais en local, ou
+ * l'application n'a rien a filtrer elle-meme), et TEMPORISE (`temporisationEnMs`,
+ * 250 ms par defaut) : la derniere frappe gagne, sauf un champ vide qui part
+ * aussitot. A l'application de ne jamais mettre le terme dans l'adresse (SEC-6).
  */
-declare class StCombobox extends ControleDeSaisie {
-    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
-    private readonly element;
-    private readonly injecteur;
-    readonly options: _angular_core.InputSignal<readonly OptionDeListe[]>;
-    readonly filtrage: _angular_core.InputSignal<FiltrageDeListe>;
-    /** Texte tape, a chaque frappe. Sert au filtrage `distant`. */
-    readonly recherche: _angular_core.OutputEmitterRef<string>;
-    protected readonly annonce: AnnonceLocale;
-    protected readonly ouvert: _angular_core.WritableSignal<boolean>;
-    /** Texte du champ : le libelle du choix, tant que la personne ne tape pas. */
-    protected readonly texte: _angular_core.WritableSignal<string>;
-    /** Ce qui filtre : vide a l'ouverture par la fleche, pour montrer toute la liste. */
-    private readonly filtre;
-    /** Option active dans la liste ; le choix n'est retenu qu'a la validation. */
-    protected readonly surlignee: _angular_core.WritableSignal<string[]>;
-    protected readonly visibles: _angular_core.Signal<readonly OptionDeListe[]>;
-    private readonly liste;
-    constructor();
-    protected surSaisie(evenement: Event): void;
-    protected basculer(): void;
-    protected valider(): void;
-    protected aLaSortie(evenement: FocusEvent): void;
-    private libelleDe;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StCombobox, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StCombobox, "st-combobox", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "filtrage": { "alias": "filtrage"; "required": false; "isSignal": true; }; }, { "recherche": "recherche"; }, never, never, true, never>;
+export declare class StCombobox extends ControleDeSaisie {
+  /**
+   * Un texte de donnees : sans commande de direction, et isole par son element (`dir="auto"` ou
+   * `<bdi>`), il ne reordonne ni lui-meme ni ce qui l'entoure (audit du 2026-09-26, S-1 ; audit
+   * etendu du 2026-09-27, A-2).
+   */
+  protected readonly affichable: typeof sansCommandesDeDirection;
+  protected readonly libelles: import("@angular/core").Signal<import("@starterlib/ui").LibellesUi>;
+  private readonly locale;
+  private readonly element;
+  private readonly injecteur;
+  private readonly document;
+  readonly options: import("@angular/core").InputSignal<readonly OptionDeListe[]>;
+  readonly filtrage: import("@angular/core").InputSignal<FiltrageDeListe>;
+  /** Glyphe de tete, decoratif (planche 13 : banque, entreprise). */
+  readonly icone: import("@angular/core").InputSignal<"accessibilite" | "appareils" | "arborescence" | "asterisque" | "badge-coche" | "banque" | "batiment" | "bifurcation" | "billets" | "billets-envoi" | "billets-pile" | "boite" | "boite-de-reception" | "bouclier" | "bouclier-alerte" | "bouclier-coche" | "bouclier-coeur" | "bouclier-croix" | "bouclier-moitie" | "bouclier-recherche" | "bouclier-utilisateur" | "boussole" | "bouton-curseur" | "bulle-question" | "cadenas" | "cadenas-horloge" | "cadenas-ouvert" | "cadre-pied" | "cadre-texte" | "calendrier" | "calendrier-evenement" | "calendrier-horloge" | "calendrier-jour" | "calques" | "carte-bancaire" | "carte-bancaire-barre" | "carte-bancaire-cadenas" | "carte-contact" | "carte-identite" | "cartes-empilees" | "case-cochee" | "casse" | "cercle" | "cercle-alerte" | "cercle-chevron-bas" | "cercle-coche" | "cercle-coche-ouvert" | "cercle-croix" | "cercle-info" | "cercle-moins" | "cercle-plus" | "cercle-question" | "certificat" | "chandelier" | "chargement" | "cheque" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "chevrons-droite" | "chevrons-haut-bas" | "cle" | "cloche" | "cloche-sonnerie" | "coche" | "code" | "code-qr" | "code-qr-scanner" | "coffre-fort" | "colonnes" | "connexion" | "contraste" | "copie" | "corbeille" | "corbeille-croix" | "courriel" | "crayon" | "croix" | "curseur-clic" | "deconnexion" | "devise" | "disposition" | "dollar" | "dossier" | "dossier-barre" | "dossier-ouvert" | "double-coche" | "echange" | "eclair" | "empreinte-digitale" | "enregistrer" | "entree" | "envoyer" | "epaisseur-de-trait" | "epingle" | "etoile" | "euro" | "fichier" | "fichier-image" | "fichier-pdf" | "fichier-texte" | "filtre" | "filtre-barre" | "filtre-lignes" | "fleche-bas" | "fleche-bas-gauche" | "fleche-bas-ligne" | "fleche-droite" | "fleche-gauche" | "fleche-haut" | "fleche-haut-droite" | "fleche-haut-ligne" | "fleche-large-haut" | "fleches-gauche-droite" | "flocon" | "flou" | "formes" | "globe" | "graphique-anneau" | "graphique-barres" | "graphique-barres-cadre" | "graphique-camembert" | "graphique-ligne" | "graphique-lignes" | "grille" | "grille-lignes" | "hexagone" | "historique" | "horloge" | "horloge-fleche" | "iban" | "imprimer" | "interdit" | "jalons" | "jauge" | "lien" | "lien-externe" | "lignes" | "lignes-crayon" | "liste" | "liste-coche" | "liste-controle" | "liste-numerotee" | "luminosite" | "lune" | "maillet" | "maison" | "marque-page" | "menu" | "menu-ouvert" | "message" | "minuteur" | "mise-au-point" | "mise-en-page-image" | "moins" | "nuage-barre" | "nuage-televerser" | "octogone-alerte" | "oeil" | "oeil-barre" | "panneau-gauche" | "parametres" | "parapluie" | "parchemin" | "pieces" | "plus" | "pointeur" | "points" | "points-verticaux" | "portefeuille" | "portefeuille-cartes" | "presse-papiers-coche" | "presse-papiers-horloge" | "priorite-haute" | "rafraichir" | "recherche" | "recherche-barre" | "recherche-texte" | "rectangle-points" | "recu" | "redemarrer" | "reglages" | "regle" | "reseau-jauge" | "rotation-arriere" | "routeur" | "sablier" | "sablier-bas" | "sablier-haut" | "sac-argent" | "sans-contact" | "serveur" | "soleil" | "style-de-trait" | "synchro" | "synchro-probleme" | "tableau" | "tableau-de-bord" | "tableau-de-bord-plus" | "tablette" | "tabulation" | "telecharger" | "telephone-mobile" | "televerser" | "tendance-baisse" | "tendance-hausse" | "terminal" | "tirelire" | "triangle-alerte" | "triangle-bas" | "triangle-haut" | "trombone" | "utilisateur" | "utilisateur-crayon" | "utilisateurs" | "wifi" | "wifi-barre" | null>;
+  /** Le style de l'etiquette (voir `st-form-field`). */
+  readonly presentation: import("@angular/core").InputSignal<PresentationDeLibelle>;
+  /**
+   * Reponse attendue du serveur (mode `distant`) : indicateur a la place du chevron apres
+   * `rythme.delai.attente`, `aria-busy`, options affichees conservees. Le composant n'appelle
+   * jamais le reseau : c'est l'etat de la ressource de l'application (`isLoading()`).
+   */
+  readonly chargement: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Bouton « Effacer le choix » a cote du chevron, des qu'un choix est fait (planche 13). */
+  readonly effacable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /**
+   * Delai avant l'emission de `recherche` en mode `distant`, et avant l'annonce du nombre de
+   * resultats en mode `local` : la derniere frappe gagne.
+   */
+  readonly temporisationEnMs: import("@angular/core").InputSignalWithTransform<number, unknown>;
+  /**
+   * Distant : le nombre de caracteres a partir duquel l'application cherche. Au-dessous, une liste
+   * vide le dit (« Saisissez au moins 3 caracteres. »). `0` : aucun minimum.
+   */
+  readonly longueurMinimale: import("@angular/core").InputSignalWithTransform<number, unknown>;
+  /** Texte tape, temporise. Sert au filtrage `distant` ; jamais emis en `local`. */
+  readonly recherche: import("@angular/core").OutputEmitterRef<string>;
+  protected readonly annonce: AnnonceLocale;
+  protected readonly gabaritDOption: import("@angular/core").Signal<StOption | undefined>;
+  /** L'indicateur n'apparait qu'apres le delai d'attente et reste le temps minimal (P6). */
+  protected readonly attenteVisible: import("@angular/core").Signal<boolean>;
+  protected readonly ouvert: import("@angular/core").WritableSignal<boolean>;
+  /**
+   * Texte du champ : le libelle du choix, tant que la personne ne tape pas.
+   *
+   * ⚠️ La SOURCE est `value` SEULE (et non une fonction unique qui lirait aussi
+   * `options`) : un `linkedSignal` a une seule fonction se recalcule — et ECRASE
+   * ce que la personne tape — a CHAQUE dependance lue par cette fonction qui
+   * change, `options` comprise. En mode `distant`, l'application remplace
+   * `options` a chaque reponse : la frappe partirait a la premiere reponse
+   * servie apres un choix (A1124, A1151). En scindant source et calcul, seul un
+   * changement de VALEUR (un choix, ou `aLaSortie`) reinitialise le texte ;
+   * `options` est lue `untracked`, comme une simple consultation.
+   */
+  protected readonly texte: import("@angular/core").WritableSignal<string>;
+  /** Ce qui filtre : vide a l'ouverture par la fleche, pour montrer toute la liste. */
+  private readonly filtre;
+  /** Option active dans la liste ; le choix n'est retenu qu'a la validation. */
+  protected readonly surlignee: import("@angular/core").WritableSignal<string[]>;
+  protected readonly visibles: import("@angular/core").Signal<readonly OptionDeListe[]>;
+  protected readonly blocs: import("@angular/core").Signal<readonly import("@starterlib/ui/saisie").BlocDOptions[]>;
+  /** Distant : un terme tape, plus court que ce que l'application cherche. */
+  protected readonly tropCourt: import("@angular/core").Signal<boolean>;
+  /** Le bouton « Effacer le choix » est-il rendu ? Pilote aussi la place reservee au champ :
+   * une seule cible tactile par defaut (chevron seul), doublee seulement quand ce bouton
+   * s'ajoute — jamais 88 px reserves pour un bouton qui n'existe pas. */
+  protected readonly afficherEffacer: import("@angular/core").Signal<boolean>;
+  /** Le texte affiche est-il le libelle du choix retenu (et non une frappe en cours) ? */
+  protected readonly choixAffiche: import("@angular/core").Signal<boolean>;
+  protected readonly idListe: string;
+  private readonly liste;
+  private readonly champNatif;
+  private minuterie;
+  private derniereAnnonce;
+  constructor();
+  protected surSaisie(evenement: Event): void;
+  /**
+   * Local : le nombre de resultats se dit apres `temporisationEnMs`, la derniere frappe gagnant, et
+   * seulement s'il a change depuis la derniere annonce, comme en distant. A chaque frappe, meme
+   * inchange, il recouvrait l'echo des lettres tapees (audit UI du 2026-09-27, D-16). La minuterie
+   * est celle de la recherche distante : un choix, une sortie ou un effacement l'annulent aussi.
+   */
+  private annoncerLeNombreLocal;
+  /** Emet `recherche`, temporise : la derniere frappe gagne, un champ vide part aussitot. */
+  private emettreRecherche;
+  /**
+   * Annule la recherche temporisee en attente : un choix, une sortie du champ ou un effacement
+   * survenu avant la fin du delai ne doit pas emettre `recherche` pour un terme abandonne (sinon
+   * l'application remplace `options` apres coup, pour une saisie qui n'existe plus).
+   */
+  private annulerRecherche;
+  protected basculer(): void;
+  /** Vide le choix et le texte d'un coup (bouton « Effacer le choix », `effacable`). */
+  protected effacer(): void;
+  /**
+   * Le clic sur le listbox valide l'option ACTIVE — mais un en-tete de groupe (`role="group"`,
+   * pas une option) est DANS le listbox et fait remonter son clic ici : sans ce garde, cliquer
+   * un intitule de groupe validerait l'option active comme un choix involontaire.
+   */
+  protected surClic(evenement: MouseEvent): void;
+  protected valider(): void;
+  protected aLaSortie(evenement: FocusEvent): void;
+  protected idDuGroupe(indice: number): string;
+  /** Id du contenu rendu par le gabarit `stOption`, qui NOMME l'option (`aria-labelledby`). */
+  protected idDuContenu(indiceDuBloc: number, indice: number): string;
+  /** Id de l'aide d'une option, lue en description (`aria-describedby`). */
+  protected idDeLAide(indiceDuBloc: number, indice: number): string;
+  private libelleDe;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StCombobox, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StCombobox, "st-combobox", never, {
+    "options": {
+      "alias": "options";
+      "required": true;
+      "isSignal": true;
+    };
+    "filtrage": {
+      "alias": "filtrage";
+      "required": false;
+      "isSignal": true;
+    };
+    "icone": {
+      "alias": "icone";
+      "required": false;
+      "isSignal": true;
+    };
+    "presentation": {
+      "alias": "presentation";
+      "required": false;
+      "isSignal": true;
+    };
+    "chargement": {
+      "alias": "chargement";
+      "required": false;
+      "isSignal": true;
+    };
+    "effacable": {
+      "alias": "effacable";
+      "required": false;
+      "isSignal": true;
+    };
+    "temporisationEnMs": {
+      "alias": "temporisationEnMs";
+      "required": false;
+      "isSignal": true;
+    };
+    "longueurMinimale": {
+      "alias": "longueurMinimale";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "recherche": "recherche";
+  }, ["gabaritDOption"], never, true, never>;
+}
+/**
+ * `auto` (defaut) : jusqu'a trois libelles, puis « N choix ». `liste` : toujours les libelles
+ * (passe a la ligne, ne rogne jamais). `nombre` : toujours « N choix ».
+ */
+export type ResumeDeMultiselect = 'auto' | 'liste' | 'nombre';
+/** Un morceau du resume : le libelle d'une option (isole a l'affichage), ou un mot de la langue. */
+interface MorceauDeResume {
+  readonly texte: string;
+  readonly libelle: boolean;
 }
-
 /**
  * Choix de plusieurs valeurs dans une liste, sur `@angular/aria/combobox` et
  * `@angular/aria/listbox`.
@@ -75,38 +276,213 @@ declare class StCombobox extends ControleDeSaisie {
  * Le modele est la liste des VALEURS choisies, dans l'ordre des options.
  *
  * - Fleche bas, Entree ou Espace ouvrent la liste ; Espace coche ou decoche
- *   l'option active sans fermer ; Echap ferme.
- * - ⚠️ **Chaque choix reste visible et retirable** sous le champ, par un bouton
- *   « Retirer … ». Un resume « 3 choix » dans le declencheur ne dit pas lesquels,
- *   et obligerait a rouvrir la liste pour en retirer un.
+ *   l'option active sans fermer, et l'annonce a chaque fois (« Epargne, coche,
+ *   2 choix ») : le lecteur d'ecran ne voit ni la case ni le total changer seul ;
+ *   Echap ferme.
+ * - ⚠️ **Chaque choix reste visible et retirable** sous le champ, dans une liste
+ *   NOMMEE (« Choix retenus »), par un bouton « Retirer … ». Un resume « 3 choix »
+ *   dans le declencheur ne dit pas lesquels, et obligerait a rouvrir la liste pour
+ *   en retirer un ; « Tout retirer » vide les deux d'un coup.
  * - Un choix retire rend le focus au retrait suivant, ou au champ : le focus ne
  *   tombe jamais sur le document.
+ * - `readonly` : le declencheur reste tabulable, ne s'ouvre plus, et les puces
+ *   perdent leur croix de retrait (rien a modifier en lecture seule).
  *
  * ⚠️ Sous une dizaine d'options, un groupe de cases a cocher (`st-fieldset` et
  * `st-checkbox`) est plus simple : tout est visible, rien a ouvrir.
  */
-declare class StMultiselect extends ContratDeChamp implements FormValueControl<readonly string[]> {
-    protected readonly libelles: _angular_core.Signal<_starterlib_ui.LibellesUi>;
-    private readonly element;
-    private readonly injecteur;
-    readonly value: _angular_core.ModelSignal<readonly string[]>;
-    readonly options: _angular_core.InputSignal<readonly OptionDeListe[]>;
-    protected readonly annonce: AnnonceLocale;
-    protected readonly ouvert: _angular_core.WritableSignal<boolean>;
-    private readonly liste;
-    /** La liste d'Aria attend un tableau modifiable ; le modele, lui, est en lecture seule. */
-    protected readonly valeursDeListe: _angular_core.Signal<string[]>;
-    protected readonly choisies: _angular_core.Signal<OptionDeListe[]>;
-    protected readonly resume: _angular_core.Signal<string>;
-    constructor();
-    /** Le declencheur n'est pas un champ natif : la base ne le trouve pas par `#champ`. */
-    focus(options?: FocusOptions): void;
-    protected surChoix(valeurs: readonly string[]): void;
-    protected retirer(valeur: string, indice: number): void;
-    protected aLaSortie(evenement: FocusEvent): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StMultiselect, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StMultiselect, "st-multiselect", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+export declare class StMultiselect extends ContratDeChamp implements FormValueControl<readonly string[]> {
+  /**
+   * Un texte de donnees : sans commande de direction, et isole par son element (`dir="auto"` ou
+   * `<bdi>`), il ne reordonne ni lui-meme ni ce qui l'entoure (audit du 2026-09-26, S-1 ; audit
+   * etendu du 2026-09-27, A-2).
+   */
+  protected readonly affichable: typeof sansCommandesDeDirection;
+  protected readonly libelles: import("@angular/core").Signal<import("@starterlib/ui").LibellesUi>;
+  private readonly locale;
+  private readonly element;
+  private readonly injecteur;
+  readonly value: import("@angular/core").ModelSignal<readonly string[]>;
+  readonly options: import("@angular/core").InputSignal<readonly OptionDeListe[]>;
+  /** Comment le resume se dit dans le declencheur. */
+  readonly modeDeResume: import("@angular/core").InputSignal<ResumeDeMultiselect>;
+  /** Bouton « Tout retirer » sous les puces, des qu'il y a au moins deux choix. */
+  readonly toutRetirer: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** La liste « Choix retenus » sous le declencheur. Sans elle, le resume seul dit les choix. */
+  readonly puces: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  protected readonly annonce: AnnonceLocale;
+  protected readonly ouvert: import("@angular/core").WritableSignal<boolean>;
+  private readonly liste;
+  protected readonly idListe: string;
+  /** La liste d'Aria attend un tableau modifiable ; le modele, lui, est en lecture seule. */
+  protected readonly valeursDeListe: import("@angular/core").Signal<string[]>;
+  protected readonly choisies: import("@angular/core").Signal<OptionDeListe[]>;
+  protected readonly blocs: import("@angular/core").Signal<readonly import("@starterlib/ui/saisie").BlocDOptions[]>;
+  /**
+   * Le resume du declencheur, en morceaux. Chaque libelle y est un texte de donnees comme dans les
+   * options et les puces : sans commande de direction, et isole a l'affichage (`dir="auto"`) ; il
+   * y passait brut (audit UI du 2026-09-27, D-5). La liste prend la forme de la langue
+   * (`Intl.ListFormat` sur `ST_LOCALE` : « Livret A et Compte courant », « Livret A and Compte
+   * courant »), et non une virgule ecrite en dur (D-28).
+   */
+  protected readonly resume: import("@angular/core").Signal<readonly MorceauDeResume[]>;
+  constructor();
+  /** Le declencheur n'est pas un champ natif : la base ne le trouve pas par `#champ`. */
+  focus(options?: FocusOptions): void;
+  /**
+   * A chaque coche ou decoche (clic, ou Espace sur l'option active) : le modele se range dans
+   * l'ordre des options (et non des clics), et l'annonce dit l'option ET le nouveau total —
+   * jamais l'un sans l'autre, car un lecteur d'ecran ne voit ni la case ni le compte changer seul.
+   */
+  protected surChoix(valeurs: readonly string[]): void;
+  protected retirer(valeur: string, indice: number): void;
+  /** Vide tous les choix d'un coup et rend le focus au declencheur. */
+  protected retirerTout(): void;
+  protected aLaSortie(evenement: FocusEvent): void;
+  protected idDuGroupe(indice: number): string;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StMultiselect, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StMultiselect, "st-multiselect", never, {
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "options": {
+      "alias": "options";
+      "required": true;
+      "isSignal": true;
+    };
+    "modeDeResume": {
+      "alias": "modeDeResume";
+      "required": false;
+      "isSignal": true;
+    };
+    "toutRetirer": {
+      "alias": "toutRetirer";
+      "required": false;
+      "isSignal": true;
+    };
+    "puces": {
+      "alias": "puces";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "value": "valueChange";
+  }, never, never, true, never>;
+}
+/**
+ * Recherche d'adresse, a inserer dans `st-address-fieldset` : elle interroge la source que l'HOTE
+ * a reliee une fois (`ST_RECHERCHE_D_ADRESSES`), et reporte l'adresse choisie dans les champs.
+ *
+ * ```html
+ * <st-address-fieldset libelle="Adresse de residence" [formField]="formulaire.adresse">
+ *   <st-address-search />
+ * </st-address-fieldset>
+ * ```
+ *
+ * ⚠️ **Le composant n'appelle jamais le reseau** : il appelle l'interface `RechercheDAdresses`
+ * (`@starterlib/util`), que le noyau implemente (relais du BFF, Photon). Sans source reliee, il
+ * ne rend rien : le champ d'adresse reste entier, et se remplit a la main ou par le navigateur.
+ *
+ * - Patron combobox de l'APG, sur `st-combobox` (distant) : anti-rebond, attente dite, nombre de
+ *   resultats annonce ; sous trois caracteres, rien ne part et la liste le dit.
+ * - La recherche se restreint au pays choisi dans le champ ; `precision` (region, pays) se lit
+ *   en seconde ligne de chaque suggestion.
+ * - Choisir REMPLIT les champs et laisse le focus dans la recherche (WCAG 3.2.2) ; « Adresse
+ *   reportee dans les champs. Verifiez-la. » s'annonce dans la region du champ. Le complement
+ *   saisi n'est jamais efface. Rien n'est remplace sans le choix explicite d'une suggestion.
+ * - Une panne ne bloque rien : un message dit de saisir l'adresse dans les champs.
+ * - L'attribution exigee par la licence des donnees (« © OpenStreetMap ») s'affiche sous la
+ *   recherche, liee a sa page.
+ *
+ * ⚠️ Le texte tape part chez la source a chaque recherche : c'est une donnee personnelle. Le
+ * choix de la source (et d'un relais par le BFF) est celui de l'hote ; voir la recette `adresses`.
+ */
+export declare class StAddressSearch {
+  private readonly source;
+  private readonly champ;
+  protected readonly libelles: import("@angular/core").Signal<import("@starterlib/ui").LibellesUi>;
+  private readonly locale;
+  protected readonly minimum = 3;
+  /** Rendue seulement avec une source ET dans un champ d'adresse. */
+  protected readonly active: boolean;
+  protected readonly attribution: import("@starterlib/util").AttributionDeDonnees | null;
+  /** Le texte tape, temporise par `st-combobox`. */
+  protected readonly terme: import("@angular/core").WritableSignal<string>;
+  /** La suggestion choisie (son identifiant), ou `''`. */
+  protected readonly choix: import("@angular/core").WritableSignal<string>;
+  protected readonly inactive: import("@angular/core").Signal<boolean>;
+  private readonly demande;
+  protected readonly suggestions: import("@angular/core").ResourceRef<readonly SuggestionDAdresse[] | undefined>;
+  /** Les suggestions servies, gardees pour le choix qui suit. */
+  private readonly servies;
+  protected readonly options: import("@angular/core").Signal<OptionDeListe[]>;
+  /** La recherche ou le detail d'une suggestion n'ont pas abouti. */
+  protected readonly indisponible: import("@angular/core").WritableSignal<boolean>;
+  /** Annule le detail en cours quand le composant disparait. */
+  private readonly arret;
+  constructor();
+  protected choisir(id: string): Promise<void>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StAddressSearch, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StAddressSearch, "st-address-search", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Liste des pays a filtrer en tapant : la variante filtrable de `st-country-field`, sur
+ * `st-combobox`. La valeur est le code ISO 3166-1 alpha-2, `''` sans choix.
+ *
+ * ```html
+ * <st-country-combobox libelle="Nationalite" [enTete]="['FR', 'BE', 'CH']" [formField]="f.nationalite" />
+ * ```
+ *
+ * Memes options que `st-country-field` (`optionsDesPays`) : noms par `Intl` dans la langue de la
+ * page, tries par sa collation ; pays frequents en tete, sans etre repetes ; un pays du modele hors
+ * de `codes` reste affiche, nomme et desactive, et `erreurPays` du schema dit pourquoi. La frappe
+ * filtre sans accents ni casse (« etats » trouve « Etats-Unis ») ; le code ISO ne s'affiche jamais.
+ *
+ * ⚠️ **Pour la nationalite, le pays de naissance, la residence fiscale** : des questions sans jeton
+ * de remplissage automatique (WCAG 1.3.5), sur 249 pays, ou taper vaut mieux que faire defiler.
+ * Pour le PAYS D'UNE ADRESSE, `st-country-field` : le navigateur remplit un `select` natif par le
+ * jeton `country`, il ne sait pas choisir une option d'une liste filtrable (ADR 0005, D130).
+ */
+export declare class StCountryCombobox extends ControleDeSaisie {
+  private readonly libelles;
+  private readonly locale;
+  /** Les pays proposes (codes ISO) ; absent : les 249 pays de la norme. */
+  readonly codes: import("@angular/core").InputSignal<readonly string[] | null>;
+  /** Les pays frequents, en tete de liste et dans cet ordre. */
+  readonly enTete: import("@angular/core").InputSignal<readonly string[]>;
+  /** Bouton « Effacer le choix » des qu'un pays est choisi (voir `st-combobox`). */
+  readonly effacable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Le style de l'etiquette (voir `st-form-field`). */
+  readonly presentation: import("@angular/core").InputSignal<PresentationDeLibelle>;
+  private readonly liste;
+  protected readonly options: import("@angular/core").Signal<OptionDeListe[]>;
+  /** Signal Forms amene le focus sur le champ de la liste. */
+  focus(options?: FocusOptions): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StCountryCombobox, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StCountryCombobox, "st-country-combobox", never, {
+    "codes": {
+      "alias": "codes";
+      "required": false;
+      "isSignal": true;
+    };
+    "enTete": {
+      "alias": "enTete";
+      "required": false;
+      "isSignal": true;
+    };
+    "effacable": {
+      "alias": "effacable";
+      "required": false;
+      "isSignal": true;
+    };
+    "presentation": {
+      "alias": "presentation";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
 }
 
-export { StCombobox, StMultiselect };
-export type { FiltrageDeListe };
+export {};

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

@@ -0,0 +1,44 @@
+import { Directionality } from "@angular/cdk/bidi";
+import * as i0 from "@angular/core";
+import { EnvironmentProviders } from "@angular/core";
+/**
+ * Le sens d'ecriture du CDK, tenu a jour avec celui du document (lot 228).
+ *
+ * ⚠️ Le `Directionality` racine du CDK lit `dir` UNE fois, a sa construction. Une bascule a
+ * l'execution — `StLangue`, qui pose `dir` sur `<html>` a chaque changement de langue, ou le reglage
+ * de sens du banc — ne lui parvenait jamais : chaque couche creee ensuite (menu, popover, liste de
+ * choix, dialogue) recevait du CDK `dir="ltr"` sur son hote et s'ecrivait de gauche a droite dans
+ * une page de droite a gauche, bords de debut et de fin inverses ; les fleches des primitives
+ * d'`@angular/aria` (arbre, onglets, menus) restaient celles de la gauche vers la droite.
+ *
+ * Celui-ci suit `dir` sur `<html>` et sur `<body>` (le `<body>` l'emporte, comme au CDK) : sa
+ * valeur, un signal que lisent les primitives d'`@angular/aria`, change, et `change` emet. Une
+ * couche creee apres la bascule porte le bon sens ; une couche deja ouverte garde le sien jusqu'a
+ * sa fermeture.
+ *
+ * La valeur de depart reste celle que le CDK lit a la construction. Ensuite, seul `rtl` se lit de
+ * droite a gauche : le socle n'ecrit que `ltr` ou `rtl`, et `dir="auto"` pose en cours de route se
+ * lit `ltr`.
+ */
+export declare class SensDuDocument extends Directionality {
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<SensDuDocument, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+/**
+ * Fait suivre au CDK le sens d'ecriture du document. A poser une fois, dans les fournisseurs de
+ * l'APPLICATION hote, a cote de `provideStarterUi` :
+ *
+ * ```ts
+ * bootstrapApplication(Coquille, {
+ *   providers: [provideStarterUi({ cheminDuSprite }), provideSensDuDocument()],
+ * });
+ * ```
+ *
+ * Sans lui, une application qui change de sens sans recharger la page (une langue de droite a
+ * gauche) ouvre ses couches dans l'ancien sens. Une application qui ne change jamais de sens n'en a
+ * pas besoin.
+ */
+export declare function provideSensDuDocument(): EnvironmentProviders;
+
+export {};