@starterlib/ui 0.10.3 → 0.10.5

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

@@ -1,7 +1,7 @@
 import { AnnonceLocale, Icone, TailleDAvatar, TailleDIconeFixe, TonDAvatar } from "@starterlib/ui";
 import * as i0 from "@angular/core";
 import { Ton, TonSemantique } from "@starterlib/util";
-import { Montant } from "@starterlib/util/valeurs";
+import { BlocDeDocument, DocumentStructure, EmphaseDeDocument, LienDeDocument, Montant, MorceauDeTexte } from "@starterlib/util/valeurs";
 export type TypeMasque = 'iban' | 'carte' | 'telephone' | 'reference';
 /**
  * `ligne` : dans le flux d'une phrase ou d'une cellule. `tuile` : la tuile de la planche 2
@@ -1579,5 +1579,67 @@ export declare class StCode {
     "copie": "copie";
   }, never, never, true, never>;
 }
+/** Un titre de page va de 1 a 6 ; un document en occupe trois, decales. */
+type NiveauDeTitre = 2 | 3 | 4 | 5;
+/**
+ * Un document structure (`DocumentStructure` de `@starterlib/util/valeurs`) rendu PAR GABARIT :
+ * aide, mentions legales, confidentialite, declaration d'accessibilite, message de maintenance
+ * (lot 280, N11).
+ *
+ * ```html
+ * <st-document [document]="mentions()" />
+ * ```
+ *
+ * ⚠️ **Aucun HTML, aucun puits DOM.** Chaque noeud a son element dans le gabarit (`@for`,
+ * `@switch`) : titres, paragraphes, listes, `<strong>`, `<em>`, liens. Le texte est interpole,
+ * jamais interprete — `require-trusted-types-for 'script'` n'a rien a refuser, et un catalogue
+ * forge ne peut rien injecter.
+ *
+ * ⚠️ **Des liens internes seulement**, suivis par le routeur : le document ne mene jamais a une
+ * autre origine. `validerLeDocument` (et le schema publie) refuse deja un lien qui n'est pas un
+ * chemin `/...` ; le composant, lui, ne rend qu'un document ainsi valide.
+ *
+ * ⚠️ **Des liens legers.** Un `<a>` natif par lien — `href` prepare par `Location` (la base de
+ * l'application comprise), l'apparence du lien de phrase du socle — et UN ecouteur de clic sur
+ * l'hote, qui confie la navigation au routeur. Un `stLink` et un `routerLink` par lien coutaient
+ * 464 ms pour 2 000 liens au banc (lot 280) : une page d'aide ne doit pas figer l'ecran.
+ *
+ * ⚠️ **Les titres suivent la page.** Un document commence au niveau 2 (sous le `h1` de la page) ;
+ * `niveauDeDepart` le decale quand il vit plus bas (dans une section `h2`, il commence a 3). Un
+ * niveau ne saute jamais.
+ */
+export declare class StDocument {
+  readonly document: import("@angular/core").InputSignal<DocumentStructure>;
+  /** Le niveau du premier titre du document dans la page : 2 (defaut) ou 3. */
+  readonly niveauDeDepart: import("@angular/core").InputSignal<2 | 3>;
+  private readonly decalage;
+  private readonly routeur;
+  private readonly emplacement;
+  /** L'adresse d'un lien interne, telle que le navigateur l'ouvrira (base de l'application comprise). */
+  protected adresse(chemin: string): string;
+  /**
+   * Un clic sur un lien du document : le routeur navigue, sans recharger. Un clic du milieu ou
+   * avec une touche (nouvel onglet, nouvelle fenetre) reste au navigateur, comme pour `routerLink`.
+   */
+  protected suivre(evenement: MouseEvent): void;
+  protected niveau(bloc: Extract<BlocDeDocument, {
+    type: 'titre';
+  }>): NiveauDeTitre;
+  protected estLien(morceau: MorceauDeTexte): morceau is LienDeDocument;
+  protected estEmphase(morceau: MorceauDeTexte): morceau is EmphaseDeDocument;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StDocument, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StDocument, "st-document", never, {
+    "document": {
+      "alias": "document";
+      "required": true;
+      "isSignal": true;
+    };
+    "niveauDeDepart": {
+      "alias": "niveauDeDepart";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 
 export {};

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

@@ -1,95 +1,164 @@
 import * as i0 from "@angular/core";
+import { InjectionToken, Provider, Signal } from "@angular/core";
+import { CatalogueDuPointDEntree } from "@starterlib/ui";
+import { StDialog } from "@starterlib/ui/surfaces";
 /**
- * `rail` (lot 176) : RESERVE au rail de 72 px de la planche 6 (D22 : tiroir sous `md`, rail de `md` a
- * `xl`, colonne au-dela), que le lot 235 dessine. Le type est fixe des la 0.9 pour que ce lot ne
- * change pas une sortie publique (`modeEffectif`) ; d'ici la, le rail se rend en colonne.
+ * Les libelles de `@starterlib/ui/navigation` (lot 235) : le catalogue par point d'entree (AD-10,
+ * D154), comme ceux de l'arbre et des formulaires. La langue suit celle du dictionnaire du tronc ;
+ * le nom du repere de navigation (`navigationPrincipale`), lui, reste au tronc.
+ */
+export interface LibellesNavigation {
+  /** Le titre visible du tiroir, qui le nomme (« Menu ») : distinct du nom du `<nav>` qu'il contient. */
+  readonly menu: string;
+  /** La fermeture visible du tiroir, obligatoire au tactile (APG dialog). */
+  readonly fermerLeMenu: string;
+}
+export declare const LIBELLES_NAVIGATION_FR: LibellesNavigation;
+export declare const LIBELLES_NAVIGATION_EN: LibellesNavigation;
+/**
+ * Les catalogues de la navigation par langue (sous-etiquette primaire : `fr`, `en`). Une
+ * application qui ajoute une langue au dictionnaire du tronc ajoute la sienne ici, par
+ * `fournirLibellesNavigation({ de: ... })`.
+ */
+export declare const ST_LIBELLES_NAVIGATION: InjectionToken<Readonly<Record<string, LibellesNavigation>>>;
+/** Ajoute (ou remplace) des catalogues de la navigation, par langue. */
+export declare function fournirLibellesNavigation(catalogues: Readonly<Record<string, LibellesNavigation>>): Provider;
+/**
+ * Le catalogue de la langue du dictionnaire du tronc ; le francais quand la langue n'en a pas, un
+ * repli signale en developpement (D-29). A appeler dans un contexte d'injection.
+ */
+export declare function libellesDeLaNavigation(): Signal<LibellesNavigation>;
+/**
+ * Le catalogue de la navigation ET la langue de son repli (`catalogueDuPointDEntree`) : `lang` de
+ * ce qu'il ecrit seul (D-29). A appeler dans un contexte d'injection.
+ */
+export declare function catalogueDeLaNavigation(): Signal<CatalogueDuPointDEntree<LibellesNavigation>>;
+/**
+ * `auto` suit D22 (planche 6) : tiroir sous `md`, rail de `md` a `xl`, colonne des `xl`.
+ * `rail` (lot 235) : une colonne de 72 px (`--st-largeur-rail`) qui ne montre que les icones des
+ * liens ; le libelle de chacun parait en infobulle au survol et au focus, et reste son nom.
  */
 export type ModeDeNavigation = 'auto' | 'persistant' | 'modal' | 'rail';
+/** Ce que la navigation rend REELLEMENT : `repli` est le tiroir ouvert sans couche. */
+export type DispositionDeNavigation = 'colonne' | 'rail' | 'tiroir' | 'repli';
 /**
- * Navigation laterale : une region a cote du contenu sur grand ecran, un tiroir
- * sur petit ecran.
+ * Navigation laterale : une colonne a cote du contenu sur grand ecran, un rail d'icones entre
+ * `md` et `xl`, un tiroir sur petit ecran (D22).
  *
  * ```html
  * <st-app-shell>
- *   <button entete stButton [stSidenavToggle]="navigation">Menu</button>
- *   <st-sidenav navigation #navigation etiquette="Navigation principale">
- *     <a routerLink="/comptes">Comptes</a>
+ *   <st-header entete>
+ *     <button bascule stIconButton icone="menu" etiquette="Menu" [stSidenavToggle]="navigation"></button>
+ *     <st-lang-switch secondaire … />
+ *   </st-header>
+ *   <st-sidenav navigation #navigation>
+ *     <a stNavLink="/comptes"><st-icon nom="portefeuille" taille="24" />Comptes</a>
+ *     <st-lang-switch secondaire … />
+ *     <a pied stNavLink="/deconnexion"><st-icon nom="deconnexion" taille="24" />Se deconnecter</a>
  *   </st-sidenav>
  *   …
  * </st-app-shell>
  * ```
  *
- * ⚠️ **Deux modes, jamais confondus.** Persistante, c'est une REGION de la page :
- * aucun piege, rien a ouvrir. Modale, c'est un TIROIR, donc un `StDialog` — role,
- * piegeage du focus, Echap, retour du focus au bouton — et non une region
- * glissee par-dessus la page avec un peu de CSS, qui laisserait le clavier
- * parcourir la page cachee dessous.
+ * ⚠️ **Des modes jamais confondus.** En colonne et en rail, c'est une REGION de la page : aucun
+ * piege, rien a ouvrir ; la colonne est COLLANTE sous l'en-tete et defile en elle-meme. En tiroir,
+ * c'est un `StDialog` — role, piegeage du focus, Echap, retour du focus au bouton — nomme par son
+ * titre visible « Menu », avec sa fermeture « Fermer le menu » ; le `<nav>` qu'il contient garde
+ * son nom. Jamais une region glissee par-dessus la page avec un peu de CSS, qui laisserait le
+ * clavier parcourir la page cachee dessous.
+ *
+ * ⚠️ **Elle porte son propre `<nav>`, et un seul a la fois.** En tiroir, la region en ligne
+ * DISPARAIT : laissee en place, elle resterait un repere vide.
  *
- * ⚠️ **Elle porte son propre `<nav>`, et un seul a la fois.** Sur petit ecran,
- * la region en ligne DISPARAIT quand le tiroir prend le relais : laissee en
- * place, elle resterait un repere de navigation vide, que le lecteur d'ecran
- * proposerait sans rien y trouver.
+ * ⚠️ **Aucun echec silencieux.** Si le module des surfaces ne se charge pas (hors ligne, cache
+ * vide), le tiroir s'ouvre EN LIGNE, sous l'en-tete, sans voile ni piege (`data-mode="repli"`) :
+ * un simple depliant, qu'Echap et toute navigation referment.
  *
- * Un lien suivi dans le tiroir le ferme : `StDialog` se ferme a toute navigation
- * du routeur.
+ * Deux creneaux : `[pied]` en bas de la navigation (deconnexion, aide, version), `[secondaire]`
+ * pour les actions que l'en-tete retire sous `md` (langue, theme), reproposees par le tiroir.
+ * Un lien suivi dans le tiroir le ferme : `StDialog` se ferme a toute navigation du routeur.
  */
 export declare class StSidenav {
   private readonly injecteur;
   private readonly libelles;
+  /** « Menu » et « Fermer le menu » : le catalogue du point d'entree (D154), et sa langue de repli. */
+  protected readonly catalogue: import("@angular/core").Signal<import("@starterlib/ui").CatalogueDuPointDEntree<import("@starterlib/ui/navigation").LibellesNavigation>>;
   /**
-   * Nom du repere. `null` : « Navigation principale », du dictionnaire. A
-   * renseigner des qu'une page compte deux navigations, qui doivent se
-   * distinguer.
+   * Nom du repere de navigation. `null` : « Navigation principale », du dictionnaire. A
+   * renseigner des qu'une page compte deux navigations, qui doivent se distinguer. Le tiroir,
+   * lui, se nomme toujours « Menu ».
    */
   readonly etiquette: import("@angular/core").InputSignal<string | null>;
   protected readonly etiquetteLue: import("@angular/core").Signal<string>;
-  /** `auto` : persistante sur grand ecran, tiroir en dessous. */
+  /** `auto` : colonne des `xl`, rail de `md` a `xl`, tiroir en dessous (D22). */
   readonly mode: import("@angular/core").InputSignal<ModeDeNavigation>;
-  protected readonly identifiant: string;
+  /**
+   * Identifiant du `<nav>` : celui que le bouton de bascule vise par `aria-controls` (lot 234),
+   * present en ligne ou dans le tiroir ouvert. Tiroir ferme, le `<nav>` n'existe pas encore, et
+   * `aria-expanded="false"` dit pourquoi.
+   */
+  readonly identifiant: string;
+  protected readonly identifiantDuTitre: string;
+  private readonly ecranMoyen;
   private readonly ecranLarge;
   /** Mode reellement applique. Lu par le bouton, qui ne s'affiche qu'en tiroir. */
   readonly modeEffectif: import("@angular/core").Signal<"persistant" | "modal" | "rail">;
   private readonly ouvertInterne;
   readonly ouvert: import("@angular/core").Signal<boolean>;
+  private readonly repliInterne;
+  /** Tiroir ouvert SANS couche : le module des surfaces n'a pas pu etre charge. */
+  readonly repli: import("@angular/core").Signal<boolean>;
+  /** Ce que la navigation rend, pose en `data-disposition` sur le `<nav>` : la feuille le lit. */
+  protected readonly disposition: import("@angular/core").Signal<DispositionDeNavigation>;
   private readonly chargementDuTiroir;
   /**
    * Le module du tiroir se charge encore, passe `rythme.delai.attente` (03 §3.9,
-   * MV-12). Lu par le bouton de bascule, qui pose `aria-busy` : sans lui,
-   * l'ouverture differee etait INVISIBLE, et un second clic semblait necessaire.
-   * Pas d'indicateur dans un bouton-icone de 44 px : le curseur d'attente suffit.
+   * MV-12). Lu par le bouton de bascule, qui pose `aria-busy` et le curseur d'attente : sans
+   * lui, l'ouverture differee etait INVISIBLE, et un second clic semblait necessaire.
    */
   readonly enAttente: import("@angular/core").Signal<boolean>;
   private readonly gabarit;
   private reference;
   private ouvertureEnCours;
+  private demande;
   private detruit;
   /**
    * Le service de dialogue, charge a la PREMIERE ouverture et garde ensuite.
-   * Rend `null` si le composant a ete detruit pendant l'attente.
+   * Rend `null` si le composant a ete detruit pendant l'attente ; LEVE si le module ne se charge
+   * pas (le repli s'en charge).
    *
    * ⚠️ Le specificateur etant dans la carte d'importation de l'application
    * federee, cet import dynamique resout vers l'INSTANCE PARTAGEE du point
    * d'entree : le tiroir emploie le meme `StDialog`, le meme recouvrement et la
-   * meme pile que le reste de l'application. Un import dynamique ne dedouble
-   * rien ; il decale seulement le moment du telechargement.
+   * meme pile que le reste de l'application.
    *
-   * ⚠️ **Le controle de destruction est ICI, avant `injecteur.get`, et non chez
-   * l'appelant.** Un injecteur detruit ne rend pas `undefined` : il LEVE
-   * (NG0205). Le controle place apres la resolution du service arrivait donc
-   * trop tard, et une navigation pendant le chargement du module produisait un
-   * rejet non gere — invisible en developpement, remonte comme erreur
-   * applicative en production, puisque `basculer()` appelle `ouvrir()` sans
-   * attendre sa promesse.
+   * ⚠️ **Le controle de destruction est ICI, avant `injecteur.get`.** Un injecteur detruit ne rend
+   * pas `undefined` : il LEVE (NG0205).
    */
+  /**
+   * Le module des surfaces, charge a la demande (ADR 0031, decision 3). Une methode a part : un
+   * essai y simule le module injoignable (hors ligne), que le repli doit rattraper.
+   */
+  protected chargerLesSurfaces(): Promise<{
+    readonly StDialog: typeof StDialog;
+  }>;
   private serviceDeDialogue;
   constructor();
   /**
-   * Ouvre le tiroir. Asynchrone depuis la 0.8.0 : le module du dialogue se
-   * charge a la demande. La promesse est tenue quand le tiroir est a l'ecran —
-   * un test l'attend, l'appelant ordinaire n'a rien a en faire.
+   * Charge le module du tiroir sans rien montrer : le bouton de bascule l'appelle a l'INTENTION
+   * (survol, focus, appui), et le clic trouve le module deja la. Sans effet s'il l'est deja ; un
+   * echec est rattrape par l'ouverture, qui bascule alors en repli.
+   */
+  precharger(): void;
+  /**
+   * Ouvre le tiroir. Asynchrone : le module du dialogue se charge a la demande. La promesse est
+   * tenue quand le tiroir est a l'ecran (ou le repli en ligne) — un test l'attend, l'appelant
+   * ordinaire n'a rien a en faire. Elle ne rejette jamais.
    */
   ouvrir(): Promise<void>;
   fermer(): void;
+  /** Echap et la navigation referment le repli ; le tiroir, lui, a les siens. */
+  protected fermerLeRepli(): void;
   /** Reste synchrone : c'est ce que lit la liaison de clic du bouton. */
   basculer(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<StSidenav, never>;
@@ -104,25 +173,38 @@ export declare class StSidenav {
       "required": false;
       "isSignal": true;
     };
-  }, {}, never, ["*"], true, never>;
+  }, {}, never, ["*", "[secondaire]", "[pied]"], true, never>;
 }
 /**
  * Bouton qui ouvre la navigation en tiroir.
  *
- * ⚠️ **Masque quand la navigation est persistante.** Un bouton « Menu » qui ne
- * fait rien, parce que la navigation est deja affichee a cote, est un arret de
- * tabulation inutile et une promesse non tenue.
+ * ```html
+ * <button stIconButton icone="menu" etiquette="Menu" [stSidenavToggle]="navigation"></button>
+ * ```
+ *
+ * ⚠️ **Sur un `<button>` natif, et nulle part ailleurs** (lot 234) : le selecteur
+ * est `button[stSidenavToggle]`. Pose sur un `<div>` ou un `<a>`, il ne s'applique
+ * pas et le gabarit ne compile plus — un contrat d'hote impose plutot que
+ * documente : clavier (Entree, Espace), role et focus viennent du bouton.
+ *
+ * ⚠️ **Masque quand la navigation n'est pas un tiroir** (colonne, rail). Un bouton
+ * « Menu » qui ne fait rien, parce que la navigation est deja affichee a cote, est
+ * un arret de tabulation inutile et une promesse non tenue.
  *
  * ⚠️ `aria-expanded` suit l'ouverture du tiroir : sans lui, rien ne dit a qui
- * n'en voit pas l'effet que le bouton a agi.
+ * n'en voit pas l'effet que le bouton a agi. `aria-controls` vise le `<nav>` de
+ * la navigation (`StSidenav.identifiant`), present des que le tiroir est ouvert.
+ * En repli sans couche (lot 235), ce n'est plus un dialogue : `aria-haspopup` tombe.
  *
- * `aria-busy` pendant le chargement DIFFERE du tiroir, passe le delai d'attente
- * (MV-12) : le clic a ete pris, la navigation arrive.
+ * **Chargement a l'intention** (lot 235) : survol, focus et appui prechargent le
+ * module du tiroir ; le clic le trouve le plus souvent deja la. Sinon, `aria-busy`
+ * et le curseur d'attente, passe le delai d'attente (MV-12) : le clic a ete pris,
+ * la navigation arrive ; un second clic, pendant ce temps, ne fait rien.
  */
 export declare class StSidenavToggle {
   readonly stSidenavToggle: import("@angular/core").InputSignal<StSidenav>;
   static ɵfac: i0.ɵɵFactoryDeclaration<StSidenavToggle, never>;
-  static ɵdir: i0.ɵɵDirectiveDeclaration<StSidenavToggle, "[stSidenavToggle]", never, {
+  static ɵdir: i0.ɵɵDirectiveDeclaration<StSidenavToggle, "button[stSidenavToggle]", never, {
     "stSidenavToggle": {
       "alias": "stSidenavToggle";
       "required": true;

package/types/starterlib-ui.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from "@angular/core";
-import { AnimationCallbackEvent, DestroyRef, EnvironmentProviders, InjectionToken, Provider, Signal } from "@angular/core";
+import { AnimationCallbackEvent, DestroyRef, EnvironmentProviders, InjectionToken, OnInit, Provider, Signal } from "@angular/core";
 import { ChoixDeTheme, ETATS_DE_BLOC, EtatDeBloc, Langue, MoyenDeCeremonie, Ton, TonSemantique, VarianteDErreur, VarianteDErreur as VarianteDErreur$1, sansCommandesDeDirection } from "@starterlib/util";
 import { EtatDeDocument, ListesDAdresses, NatureDeRegion, RechercheDAdresses } from "@starterlib/util/valeurs";
 import * as i1 from "@angular/router";
@@ -2531,8 +2531,9 @@ export declare class StLienEtendu {
  */
 export type TailleDeTitreDePage = 'xl' | '2xl' | '3xl' | '4xl';
 /**
- * Titre de page : le `h1`, ses puces, sa precision et les actions qui lui sont
- * attachees.
+ * Titre de page : le `h1`, son aide contextuelle (`[aide]`, lot 280), ses puces, sa precision et
+ * les actions qui lui sont attachees. L'aide et les puces vont sur la rangee du titre, HORS de la
+ * balise : leur texte n'entre pas dans le nom du titre.
  *
  * ⚠️ Il rend une **vraie balise de titre**, un `h1` par defaut : `StNavigation`
  * de `@starterlib/core` vise le titre de niveau 1 pour y poser le focus apres
@@ -2596,7 +2597,7 @@ export declare class StPageTitle {
       "required": false;
       "isSignal": true;
     };
-  }, {}, never, ["*", "[puces]", "[precision]", "[actions]"], true, never>;
+  }, {}, never, ["*", "[aide]", "[puces]", "[precision]", "[actions]"], true, never>;
 }
 /** Un maillon du fil. Sans `lien`, il n'est pas cliquable. */
 export interface MaillonDeFil {
@@ -2905,9 +2906,10 @@ export declare class StAppShell {
  * que l'hote charge). Des `md`, la ligne ne se replie jamais ; dessous, les actions passent sur
  * une ligne de plus plutot que de deborder (WCAG 1.4.10).
  *
- * ⚠️ `secondaire` (langue, theme) marque ce qui pourra quitter l'en-tete sous `md` quand le
- * tiroir de navigation le reproposera (lot 234). D'ici la, l'attribut ne retire rien : masquer
- * une action sans repli la rendrait inatteignable sur un telephone.
+ * ⚠️ `secondaire` (langue, theme) marque ce qui QUITTE l'en-tete sous `md` (lot 235) : le tiroir
+ * de navigation le repropose, a condition que l'application l'y projette aussi
+ * (`<st-lang-switch secondaire … />` dans `st-sidenav`). Sans ce second exemplaire, l'action
+ * serait inatteignable sur un telephone : ne rien marquer `secondaire` garde tout dans l'en-tete.
  *
  * ```html
  * <st-header>
@@ -2973,15 +2975,18 @@ export declare class StFooter {
 }
 /**
  * Lien de navigation principale, pose en attribut sur un `<a>` natif :
- * `routerLink`, etat actif, icone et pastille, en un seul geste.
+ * `routerLink`, etat courant, icone et pastille, en un seul geste.
  *
  * ```html
  * <st-sidenav navigation>
- *   <a stNavLink="/comptes"><st-icon nom="fichier" />Comptes</a>
+ *   <a stNavLink="/"><st-icon nom="maison" taille="24" />Accueil</a>
+ *   <a stNavLink="/comptes"><st-icon nom="portefeuille" taille="24" />Comptes</a>
  *   <a [stNavLink]="['/messages']">
- *     Messages<span class="st-vh">, 5 non lus</span>
+ *     <st-icon nom="messages" taille="24" />
+ *     Messagerie<span class="st-vh">, 5 non lus</span>
  *     <st-badge [valeur]="5" />
  *   </a>
+ *   <a stNavLink="/aide"><st-icon nom="casque" taille="24" />Aide<st-icon fin nom="lien-externe" /></a>
  * </st-sidenav>
  * ```
  *
@@ -2992,32 +2997,60 @@ export declare class StFooter {
  * l'observateur de rupture pour un lien. Et la coquille le PEINT : le second
  * critere de l'ADR 0031 le garde au tronc pour la meme raison.
  *
- * ⚠️ **L'etat actif est porte par `aria-current="page"`**, pose par le routeur,
+ * **Une grille, une colonne d'icone reservee** (lot 234) : l'icone de tete dans
+ * une colonne de 24 px, TOUJOURS reservee — un lien sans icone garde son libelle
+ * aligne sur les autres —, le libelle, puis la pastille (`st-badge`) ou une icone
+ * de fin (`st-icon fin` : `lien-externe`, `chevron-droite`), l'une ou l'autre.
+ * L'ordre du DOM est celui de l'ecran (icone, libelle, fin), quel que soit
+ * l'ordre d'ecriture. Le libelle tient sur UNE ligne et se tronque par une
+ * ellipse : une navigation ne se replie jamais, et le nom accessible, lui, reste
+ * entier.
+ *
+ * ⚠️ **L'etat courant est porte par `aria-current="page"`**, pose par le routeur,
  * et c'est sur lui que la feuille se branche — jamais sur la seule couleur : le
- * lien courant se lit a sa graisse et au marqueur sur son bord de depart, qui
- * survivent au contraste force. La classe `st-nav-link--actif` accompagne, pour
- * qui veut y accrocher un style.
+ * lien courant se lit a sa graisse et au marqueur de 3 px sur son bord de depart,
+ * qui survivent au contraste force (D22 : fond `surface-conteneur-bas`, texte
+ * `texte-primaire` 600, marqueur et icone `primaire`). La classe
+ * `st-nav-link--actif` accompagne, pour qui veut y accrocher un style.
+ *
+ * ⚠️ **Le lien racine est exact par defaut.** `stNavLink="/"` sans
+ * `optionsDActivation` ne s'allume que sur `/` : en inclusion, il serait courant
+ * sur TOUTES les pages. Poser `optionsDActivation` l'emporte toujours.
  *
  * ⚠️ La pastille est `aria-hidden` : le compte qu'elle affiche doit entrer
  * dans le nom du lien, par un texte lisible par lecteur seulement (`.st-vh`),
- * compose par l'appelant.
+ * compose par l'appelant. En developpement, un `st-badge` sans `.st-vh` dans le
+ * lien est signale.
  *
  * Un composant et non une directive, parce qu'il RANGE ce qu'on lui projette :
- * l'icone devant, la pastille derriere, le libelle entre les deux, sans que
- * l'ordre d'ecriture compte.
- */
-export declare class StNavLink {
+ * l'icone devant, la pastille derriere, le libelle entre les deux. Un lien qu'on
+ * ne peut pas suivre ne se rend pas (`@if` cote application) : jamais
+ * `aria-disabled` sur un lien de navigation.
+ */
+export declare class StNavLink implements OnInit {
+  private readonly lien;
+  private readonly actif;
+  private readonly routeur;
+  /** L'objet d'options de `RouterLinkActive` avant toute liaison : `optionsDActivation` le remplace. */
+  private readonly optionsParDefaut;
   constructor();
+  ngOnInit(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<StNavLink, never>;
-  static ɵcmp: i0.ɵɵComponentDeclaration<StNavLink, "a[stNavLink]", never, {}, {}, never, ["st-icon", "*", "st-badge"], true, [{
+  static ɵcmp: i0.ɵɵComponentDeclaration<StNavLink, "a[stNavLink]", never, {}, {}, never, ["st-icon:not([fin])", "*", "st-badge, st-icon[fin]"], true, [{
     directive: typeof i1.RouterLink;
     inputs: {
       "routerLink": "stNavLink";
+      "target": "target";
       "queryParams": "queryParams";
       "fragment": "fragment";
       "queryParamsHandling": "queryParamsHandling";
-      "replaceUrl": "replaceUrl";
       "state": "state";
+      "info": "info";
+      "relativeTo": "relativeTo";
+      "preserveFragment": "preserveFragment";
+      "skipLocationChange": "skipLocationChange";
+      "replaceUrl": "replaceUrl";
+      "browserUrl": "browserUrl";
     };
     outputs: {};
   }, {
@@ -3037,6 +3070,7 @@ export declare class StNavLink {
  *   <st-breadcrumb forme="compacte" separateur="/" [maillons]="maillons" />
  *   <st-tag surtitre ton="primaire" variante="attenuee" casse="capitales" point libelle="Tresorerie" />
  *   Mes operations
+ *   <st-help-button aide sujet="Mes operations">{{ t('tresorerie.aide.operations') }}</st-help-button>
  *   <st-tag puces casse="capitales" taille="sm" libelle="ISO-20022" />
  *   <button stButton variante="primaire" actions>Exporter</button>
  *   <st-tabs etiquette="Vue" [onglets]="onglets" [(selection)]="vue" />
@@ -3044,10 +3078,15 @@ export declare class StNavLink {
  * ```
  *
  * Emplacements : `st-breadcrumb` (par element), `[surtitre]` et `[meta]` au-dessus du titre,
- * contenu par defaut = TEXTE du titre, `[puces]` sur sa rangee, `[precision]` (texte riche, a
- * codes) sous lui, `[actions]` a droite des `lg` et dessous avant, `st-tabs` ou
+ * contenu par defaut = TEXTE du titre, `[aide]` puis `[puces]` sur sa rangee, `[precision]` (texte
+ * riche, a codes) sous lui, `[actions]` a droite des `lg` et dessous avant, `st-tabs` ou
  * `st-segmented-control` (par element) en bas.
  *
+ * L'aide contextuelle de la page (lot 280) : un `st-help-button` (`@starterlib/ui/surfaces`) dans
+ * `[aide]`, juste apres le titre et HORS de lui. Son texte est la cle `<perimetre>.aide.<page>`,
+ * soeur du titre de la route `<perimetre>.pages.<page>` : l'etape `i18n` de `starter-web verify`
+ * exige cette cle pour chaque route du manifeste, et refuse une aide sans page.
+ *
  * ⚠️ Le fil et les onglets se reconnaissent a leur ELEMENT (`st-breadcrumb`,
  * `st-tabs`), pas a un attribut : `onglets` est deja le nom d'une entree de
  * `st-tabs`, et un attribut nu du meme nom lui passerait une chaine vide. Un
@@ -3115,7 +3154,7 @@ export declare class StPageHeader {
       "required": false;
       "isSignal": true;
     };
-  }, {}, never, ["st-breadcrumb", "[surtitre]", "[meta]", "*", "[puces]", "[precision]", "[actions]", "st-tabs, st-nav-tabs, st-segmented-control"], true, never>;
+  }, {}, never, ["st-breadcrumb", "[surtitre]", "[meta]", "*", "[aide]", "[puces]", "[precision]", "[actions]", "st-tabs, st-nav-tabs, st-segmented-control"], true, never>;
 }
 /**
  * Barre fine de progression d'une navigation, sous l'en-tete.