@ktortu/aaa 0.9.8 → 0.10.0

package/fesm2022/ktortu-aaa.mjs

@@ -5,6 +5,7 @@ export * from '@ktortu/aaa/dialog';
 export * from '@ktortu/aaa/disclosure';
 export * from '@ktortu/aaa/forms';
 export * from '@ktortu/aaa/i18n';
+export * from '@ktortu/aaa/icon';
 export * from '@ktortu/aaa/menu';
 export * from '@ktortu/aaa/snackbar';
 export * from '@ktortu/aaa/tabs';

package/fesm2022/ktortu-aaa.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ktortu-aaa.mjs","sources":["../../../../projects/ktortu/aaa/src/public-api.ts","../../../../projects/ktortu/aaa/src/ktortu-aaa.ts"],"sourcesContent":["/*\n * Public API Surface of @ktortu/aaa\n */\nexport * from '@ktortu/aaa/button';\nexport * from '@ktortu/aaa/card';\nexport * from '@ktortu/aaa/cdk';\nexport * from '@ktortu/aaa/dialog';\nexport * from '@ktortu/aaa/disclosure';\nexport * from '@ktortu/aaa/forms';\nexport * from '@ktortu/aaa/i18n';\nexport * from '@ktortu/aaa/menu';\nexport * from '@ktortu/aaa/snackbar';\nexport * from '@ktortu/aaa/tabs';\nexport * from '@ktortu/aaa/tooltip';\nexport * from '@ktortu/aaa/progress-bar';\nexport * from '@ktortu/aaa/layout';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA;;AAEG;;ACFH;;AAEG"}
+{"version":3,"file":"ktortu-aaa.mjs","sources":["../../../../projects/ktortu/aaa/src/public-api.ts","../../../../projects/ktortu/aaa/src/ktortu-aaa.ts"],"sourcesContent":["/*\n * Public API Surface of @ktortu/aaa\n */\nexport * from '@ktortu/aaa/button';\nexport * from '@ktortu/aaa/card';\nexport * from '@ktortu/aaa/cdk';\nexport * from '@ktortu/aaa/dialog';\nexport * from '@ktortu/aaa/disclosure';\nexport * from '@ktortu/aaa/forms';\nexport * from '@ktortu/aaa/i18n';\nexport * from '@ktortu/aaa/icon';\nexport * from '@ktortu/aaa/menu';\nexport * from '@ktortu/aaa/snackbar';\nexport * from '@ktortu/aaa/tabs';\nexport * from '@ktortu/aaa/tooltip';\nexport * from '@ktortu/aaa/progress-bar';\nexport * from '@ktortu/aaa/layout';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA;;AAEG;;ACFH;;AAEG"}

package/forms/styles/field-box.css

@@ -87,7 +87,7 @@
     color: inherit;
     font: inherit;
     caret-color: var(--field-caret-color, auto); /* bascule (thème terminal, etc.) */
-    padding-inline-end: 0.5rem;
+    padding-inline-end: var(--field-input-padding-end, 0.5rem);
   }
 
   .kt-field-box__input:disabled {
@@ -95,6 +95,16 @@
     color: color-mix(in srgb, currentColor 50%, transparent);
   }
 
+  /* Types temporels natifs (date/time/datetime-local/month) : l'indicateur natif de sélecteur
+   (calendrier/horloge) vit à la FIN de l'input et gère déjà son propre espacement. Le respir de
+   fin « texte » ne protège ici aucune saisie libre : il ne ferait que repousser ce picto vers
+   l'intérieur (renfoncement de 1.25rem = box 0.75 + input 0.5, incohérent avec les champs texte).
+   On remet donc le token à 0 ; la gouttière commune reste le padding de la boîte (0.75rem). La
+   propriété consommatrice est LOGIQUE => l'indicateur bascule aussi côté départ en RTL. */
+  .kt-field-box__input:is([type='date'], [type='time'], [type='datetime-local'], [type='month']) {
+    --field-input-padding-end: 0;
+  }
+
   /* Datalist : masque la flèche déroulante native (Chromium) sur les champs texte/number. Le
    pseudo-élément étant partagé avec l'icône de picker des champs date/heure (qui peuvent eux
    aussi porter un `list`), on restreint aux types concernés pour ne pas masquer leur picker. */

package/forms/styles/tokens.css

@@ -35,6 +35,11 @@
     --field-padding-y: 0.5rem;
     --field-gap: 0.375rem;
     --field-control-gap: 0.5rem;
+    /* Respir de fin propre à l'input (texte/caret), distinct de la gouttière de la boîte
+     (--field-padding-x) et de l'écart entre contrôles (--field-control-gap). Neutralisé à 0 pour
+     les champs temporels natifs (cf. field-box.css : l'indicateur de picker gère son propre
+     espacement, ce respir ne ferait que le décaler vers l'intérieur). */
+    --field-input-padding-end: 0.5rem;
     /* Largeur du champ : un seul réglage pilote tous les champs. Défaut `auto` (remplit le
      conteneur en bloc, se dimensionne au contenu en flex). Ex. global : --field-width: 320px. */
     --field-width: auto;

package/forms/switch/switch.css

@@ -143,6 +143,12 @@
     user-select: none;
   }
 
+  /* Label vide (ni texte ni contenu projeté — switch nommé via ariaLabel) : masqué pour ne pas
+     réserver l'écart flex de la rangée. Le label reste dans le DOM pour accueillir la projection. */
+  .kt-switch-label:empty {
+    display: none;
+  }
+
   .kt-switch-field--disabled .kt-switch-label {
     cursor: not-allowed;
     color: var(--field-hint-color, #5f6368);

package/icon/icon.css

@@ -0,0 +1,52 @@
+@layer kt-aaa.components {
+  /* Styles de la primitive d'icône autonome [ktIcon]. Global : chargé via l'agrégat styles.css,
+   applicable partout où la directive est posée. Ciblé par la CLASSE `.kt-icon` (posée en dur sur
+   l'hôte par la directive) et NON par l'attribut de sélecteur : un binding `[ktIcon]="x"` ne reflète
+   aucun attribut dans le DOM, la classe reste le seul marqueur fiable. Leviers = BASCULES NON déclarées
+   (le fallback var() fait foi) : --kt-icon-font / --kt-icon-font-weight / --kt-icon-font-variation (posées
+   par la directive quand une police du registre est résolue, sinon cascade globale) + --kt-icon-size
+   (posée par [size]) + --kt-icon-overflow (bascule d'opt-out du rognage de la boîte ligature). */
+
+  .kt-icon {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex: none;
+    /* Taille pilotée par --kt-icon-size (posée par [size]) ; défaut relatif au texte du contexte. */
+    font-size: var(--kt-icon-size, 1.25em);
+    line-height: 1;
+    /* Couleur héritée du texte courant (currentColor) : l'icône suit son contexte sans réglage. */
+    color: inherit;
+    /* Alignement propre au fil du texte (icône ↔ libellé adjacent). */
+    vertical-align: middle;
+    -webkit-font-smoothing: antialiased;
+  }
+
+  /* Rendu de la LIGATURE (nom → glyphe) via un pseudo-élément, comme Button/Field.
+   Police : --kt-icon-font (posée par la directive si police du registre résolue) > cascade globale
+   > Material Symbols Outlined. Un set NON-ligature (Font Awesome…) se projette dans l'hôte (ktIcon
+   vide) : aucun ::before n'est alors rendu. */
+  .kt-icon[data-icon]::before {
+    content: attr(data-icon);
+    font-family: var(--kt-icon-font, 'Material Symbols Outlined');
+    font-weight: var(--kt-icon-font-weight, normal);
+    font-style: normal;
+    font-size: 1em; /* = taille de l'hôte (--kt-icon-size) */
+    line-height: 1;
+    font-variation-settings: var(--kt-icon-font-variation, normal);
+    font-feature-settings: 'liga';
+  }
+
+  /* Boîte réservée (1 em, carrée) UNIQUEMENT en mode ligature : évite le décalage de mise en page au
+   chargement de la police et masque le clignotement du nom en clair (FOUT) tant que la police n'est
+   pas prête. `clip` + une petite marge tolèrent un léger débordement d'encre (polices tierces dont le
+   glyphe dépasse le cadratin) sans rogner, tout en bridant le texte de repli. Bascule d'opt-out via
+   --kt-icon-overflow (ex. `visible`). Non appliqué au mode projeté (contenu de largeur libre). */
+  .kt-icon[data-icon] {
+    inline-size: 1em;
+    block-size: 1em;
+    overflow: hidden; /* Fallback pour WebView < 90 */
+    overflow: var(--kt-icon-overflow, clip);
+    overflow-clip-margin: 0.15em;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ktortu/aaa",
-  "version": "0.9.8",
+  "version": "0.10.0",
   "description": "Bibliothèque de composants Angular headless + thémés par tokens CSS.",
   "keywords": [
     "angular",
@@ -85,6 +85,10 @@
       "types": "./types/ktortu-aaa-i18n.d.ts",
       "default": "./fesm2022/ktortu-aaa-i18n.mjs"
     },
+    "./icon": {
+      "types": "./types/ktortu-aaa-icon.d.ts",
+      "default": "./fesm2022/ktortu-aaa-icon.mjs"
+    },
     "./layout": {
       "types": "./types/ktortu-aaa-layout.d.ts",
       "default": "./fesm2022/ktortu-aaa-layout.mjs"

package/styles/icon.css

@@ -0,0 +1,7 @@
+@layer kt-aaa.tokens, kt-aaa.base, kt-aaa.components;
+
+/* Icône autonome (directive ktIcon) : apparence pure (aucun token dédié — cf. les bascules
+   --kt-icon-font / --kt-icon-font-weight / --kt-icon-size du socle). Nécessite le socle
+   (@ktortu/aaa/foundation.css) et le chargement d'une police d'icônes côté application.
+     @import '@ktortu/aaa/icon.css'; */
+@import '../icon/icon.css';

package/styles/styles.css

@@ -15,6 +15,7 @@
    importez aussi '@angular/cdk/overlay-prebuilt.css'. */
 
 @import './foundation.css';
+@import './icon.css';
 @import './tabs.css';
 @import './forms.css';
 @import './button.css';

package/types/ktortu-aaa-dialog.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnInit, OnDestroy, Provider } from '@angular/core';
+import { OnInit, OnDestroy, InjectionToken, Provider } from '@angular/core';
 import { DialogConfig, DialogRef, CdkDialogContainer } from '@angular/cdk/dialog';
 import { ComponentType } from '@angular/cdk/portal';
 import * as _ktortu_aaa_dialog from '@ktortu/aaa/dialog';
@@ -105,6 +105,10 @@ declare class KtDialogClose {
  * aria-labelledby). En usage simple — titre nu sans header — [ktDialogTitle] conserve son propre
  * padding : ce header n'est à utiliser que pour les en-têtes composés (icône, close top-right…).
  *
+ * ⚠️ Ne rend RIEN par lui-même — pas de bouton de fermeture implicite : c'est vous qui posez la
+ * croix (cf. exemple). En présentation `sheet`, l'option `sheetCloseButton` en rend une
+ * automatiquement, hors flux ; les deux ensemble feraient doublon (le conteneur avertit en dev).
+ *
  * @example
  * ```html
  * <header ktDialogHeader>
@@ -163,7 +167,7 @@ declare class KtDialogFocusInitial {
 }
 /**
  * @deprecated ADR-0005 — la poignée est désormais RENDUE AUTOMATIQUEMENT par `KtDialogContainer`
- * en présentation `sheet` (opt-out : panelClass additionnel `kt-dialog--no-handle`), et le
+ * en présentation `sheet` (opt-out : option typée `sheetHandle: false`), et le
  * drag-to-dismiss s'attrape sur TOUTE la surface de la sheet (scroll-snap natif). Cette
  * directive est INERTE et son hôte est masqué (évite une double poignée) : retirez-la de vos
  * templates. Sera supprimée dans une prochaine version majeure.
@@ -207,6 +211,63 @@ declare const KT_DIALOG_AAA_DEFAULTS: DialogConfig;
  * @returns Un `Provider` pour le token `DEFAULT_DIALOG_CONFIG`.
  */
 declare function provideKtDialogDefaults(overrides?: Partial<DialogConfig>): Provider;
+/**
+ * Options MAISON du dialog (≠ {@link KT_DIALOG_AAA_DEFAULTS}, qui porte la config du CDK).
+ * Conforme à l'ADR-0003 : un token `KT_*_CONFIG` par entry-point, défauts anglais neutres,
+ * cascade `option d'ouverture ?? token ?? défaut`.
+ *
+ * Toutes les clés actuelles ne concernent que la présentation `sheet` (préfixe `sheet*`) : sur les
+ * présentations `centered` / `fullscreen`, la place d'un bouton de fermeture est un
+ * `[ktDialogHeader]`, où on le POSE soi-même, dans le flux. Un usage hors sheet déclenche un
+ * avertissement en mode dev.
+ */
+interface KtDialogConfig {
+    /**
+     * Bouton de fermeture AUTO-RENDU en haut de la carte, en présentation `sheet`.
+     *
+     * Désactivé par défaut, pour une raison de COMPATIBILITÉ, pas d'ergonomie : `[ktDialogHeader]`
+     * ne rend aucune croix (c'est une simple rangée flex), mais un dialog qui en compose un y place
+     * généralement la sienne à la main. Activer l'option par défaut ferait donc apparaître une
+     * DEUXIÈME croix chez ces consommateurs-là sans qu'ils aient rien changé.
+     *
+     * Recommandé sur toute sheet qui ne pose pas déjà son propre bouton de fermeture en tête.
+     * @default false
+     */
+    sheetCloseButton: boolean;
+    /** Nom accessible du bouton de fermeture auto-rendu (WCAG 4.1.2). @default 'Close' */
+    sheetCloseLabel: string;
+    /** Poignée décorative auto-rendue en présentation `sheet` (ADR-0005). @default true */
+    sheetHandle: boolean;
+}
+/**
+ * Défauts effectifs des options maison du dialog. Objet `Required` figé : c'est la SOURCE des
+ * valeurs de repli, lue à la fois par l'ouvreur (résolution) et par le conteneur (fusion
+ * idempotente), et énumérée par la garde de complétude i18n.
+ */
+declare const DEFAULT_KT_DIALOG_CONFIG: Required<KtDialogConfig>;
+/**
+ * Token des options maison du dialog. Deux usages, un seul chemin de résolution :
+ * - **application** : fourni via {@link provideKtDialog} (valeur partielle) ;
+ * - **par ouverture** : `injectKtDialogOpener` REFOURNIT ce même token, déjà RÉSOLU, dans
+ *   l'injecteur du conteneur (canal `container.providers` du CDK). Le conteneur fusionne
+ *   toujours par-dessus {@link DEFAULT_KT_DIALOG_CONFIG} : l'opération est idempotente sur une
+ *   valeur déjà résolue, et reste correcte si le conteneur est monté sans passer par l'ouvreur.
+ */
+declare const KT_DIALOG_CONFIG: InjectionToken<Partial<KtDialogConfig>>;
+/**
+ * Enregistre les options maison du dialog pour l'application (ou un sous-arbre).
+ * Complémentaire de {@link provideKtDialogDefaults}, qui porte la config du CDK : les deux
+ * coexistent et ne se recouvrent pas.
+ *
+ * @example
+ * ```ts
+ * // app.config.ts — bouton de fermeture sur toutes les bottom-sheets
+ * providers: [provideKtDialog({ sheetCloseButton: true })];
+ * ```
+ * @param config Options partielles fusionnées par-dessus `DEFAULT_KT_DIALOG_CONFIG`.
+ * @returns Un `Provider` pour le token `KT_DIALOG_CONFIG`.
+ */
+declare function provideKtDialog(config: Partial<KtDialogConfig>): Provider;
 /**
  * Présentation du dialog, CHOISIE EXPLICITEMENT PAR LE DÉVELOPPEUR à l'ouverture (option
  * `presentation` de `injectKtDialogOpener`). Aucune bascule CSS automatique : le dev décide.
@@ -236,8 +297,11 @@ type KtDialogPresentation = 'centered' | 'fullscreen' | 'sheet' | 'centered-full
  */
 declare function resolveKtDialogPanelClass(presentation?: KtDialogPresentation, compact?: boolean): string[];
 
-/** Config d'ouverture sans le champ `data` (fourni séparément, typé), enrichie de `presentation`. */
-type KtDialogOpenerConfig<D, R, C> = Omit<DialogConfig<D, DialogRef<R, C>>, 'data'> & {
+/**
+ * Config d'ouverture sans le champ `data` (fourni séparément, typé), enrichie de `presentation` et
+ * des options maison de {@link KtDialogConfig} (surcharge par ouverture de `KT_DIALOG_CONFIG`).
+ */
+type KtDialogOpenerConfig<D, R, C> = Omit<DialogConfig<D, DialogRef<R, C>>, 'data'> & Partial<KtDialogConfig> & {
     /** Présentation du dialog (cf. `KtDialogPresentation`) — choisie par le dev. Résolue à CHAQUE
         ouverture : les variantes responsive lisent le signal d'écran compact. Défaut : `'centered'`.
         Combinée à un éventuel `panelClass` additionnel. */
@@ -343,6 +407,11 @@ declare class KtDialogContainer extends CdkDialogContainer {
     private readonly platformId;
     private readonly destroyRef;
     private readonly bodyScrollLock;
+    /** Options maison RÉSOLUES. `injectKtDialogOpener` refournit `KT_DIALOG_CONFIG` déjà résolu dans
+        l'injecteur du conteneur : la fusion ci-dessous est alors un no-op. Elle reste indispensable
+        quand le conteneur est monté sans l'ouvreur (`dialog.open` brut), où le token remonte à
+        l'application et n'est que partiel. Un seul chemin de code, idempotent. */
+    protected readonly ktConfig: Required<KtDialogConfig>;
     protected readonly isClosing: i0.WritableSignal<boolean>;
     /** Armé quand l'ouverture a dépassé 50px : un repos à ~0 est alors forcément le snap « fermé ». */
     private sheetArmed;
@@ -355,9 +424,25 @@ declare class KtDialogContainer extends CdkDialogContainer {
         renomme ce membre, on dégrade proprement vers `null` au lieu de casser le rendu du conteneur. */
     protected get ariaLabelledBy(): string | null;
     constructor();
+    /** Garde-fous dev sur la config maison : usage hors sheet, double bouton de fermeture, opt-out
+        déprécié de la poignée. On AVERTIT sans jamais corriger en silence — un masquage automatique
+        dépendrait de l'ordre de rendu du portail et serait indébogable. */
+    private warnOnConfigMisuse;
     protected isSheet(): boolean;
-    /** Poignée décorative auto-rendue en présentation sheet. Opt-out : panelClass `kt-dialog--no-handle`. */
+    /** panelClass d'opt-out historique de la poignée — repli DÉPRÉCIÉ, remplacé par `sheetHandle`. */
+    private hasLegacyNoHandleClass;
+    /** Poignée décorative auto-rendue en présentation sheet (ADR-0005). Opt-out : option `sheetHandle`
+        (le panelClass historique reste honoré, en déprécié). */
     protected showSheetHandle(): boolean;
+    /** Bouton de fermeture auto-rendu : opt-in `sheetCloseButton`, et UNIQUEMENT en présentation sheet
+        (ailleurs, la croix se pose à la main dans un `[ktDialogHeader]` — cf. `KtDialogConfig`). */
+    protected showSheetClose(): boolean;
+    /** Clic sur le bouton de fermeture auto-rendu. Ne consulte VOLONTAIREMENT pas `disableClose` :
+        contrairement au tap-extérieur et à Échap (fermetures « par inadvertance » que `disableClose`
+        protège), ce bouton est une sortie EXPLICITEMENT demandée par le dev via `sheetCloseButton` —
+        le combiner à `disableClose` est le patron « une seule sortie contrôlée ». Le drapeau
+        `isClosing` garde l'idempotence face à un geste de glissement simultané. */
+    protected onSheetCloseClick(): void;
     /** Tap sur le spacer (zone extérieure à la carte) = fermeture, façon backdrop. Le conteneur
         captant désormais le tactile (pointer-events auto, requis pour le drag iOS), le clic ne
         traverse plus vers le backdrop CDK : on porte donc ICI la fermeture au tap-extérieur, en
@@ -531,5 +616,5 @@ declare class KtQuickDialog {
     static ɵprov: i0.ɵɵInjectableDeclaration<KtQuickDialog>;
 }
 
-export { KT_DIALOG_AAA_DEFAULTS, KtAlertDialog, KtConfirmDialog, KtDialogActions, KtDialogClose, KtDialogContainer, KtDialogContent, KtDialogDescription, KtDialogFocusInitial, KtDialogHeader, KtDialogImports, KtDialogSheetHandle, KtDialogTitle, KtQuickDialog, defineKtDialog, injectAlertDialog, injectConfirmDialog, injectKtDialogOpener, provideKtDialogDefaults, resolveKtDialogPanelClass };
-export type { KtAlertData, KtAlertDialogVariant, KtAlertOptions, KtConfirmConfig, KtConfirmResult, KtDecideConfig, KtDialogColor, KtDialogContract, KtDialogOpenerConfig, KtDialogPresentation };
+export { DEFAULT_KT_DIALOG_CONFIG, KT_DIALOG_AAA_DEFAULTS, KT_DIALOG_CONFIG, KtAlertDialog, KtConfirmDialog, KtDialogActions, KtDialogClose, KtDialogContainer, KtDialogContent, KtDialogDescription, KtDialogFocusInitial, KtDialogHeader, KtDialogImports, KtDialogSheetHandle, KtDialogTitle, KtQuickDialog, defineKtDialog, injectAlertDialog, injectConfirmDialog, injectKtDialogOpener, provideKtDialog, provideKtDialogDefaults, resolveKtDialogPanelClass };
+export type { KtAlertData, KtAlertDialogVariant, KtAlertOptions, KtConfirmConfig, KtConfirmResult, KtDecideConfig, KtDialogColor, KtDialogConfig, KtDialogContract, KtDialogOpenerConfig, KtDialogPresentation };

package/types/ktortu-aaa-forms.d.ts

@@ -547,9 +547,19 @@ declare class KtPasswordField extends KtBaseInputField<string> implements FormVa
  * Permet d'activer ou désactiver une option avec effet immédiat.
  * Intégré aux Signal Forms de l'application via FormValueControl.
  *
+ * Libellé : `label` (texte) par défaut ; un contenu projeté le remplace pour les rendus riches
+ * (image + texte, spans empilés…). `ariaLabel` porte alors le nom accessible si le contenu projeté
+ * n'a pas de texte (WCAG 4.1.2). Même règle que `kt-checkbox` / `kt-radio`.
+ *
  * @example
  * ```html
+ * <!-- Simple -->
  * <kt-switch label="Notifications par e-mail" [(value)]="emailNotif" />
+ *
+ * <!-- Contenu projeté (image + texte) -->
+ * <kt-switch [(value)]="emailNotif">
+ *   <img ngSrc="/assets/mail.png" width="20" height="20" alt="" /> Notifications par e-mail
+ * </kt-switch>
  * ```
  */
 declare class KtSwitch implements FormValueControl<boolean> {
@@ -574,7 +584,7 @@ declare class KtSwitch implements FormValueControl<boolean> {
     readonly name: _angular_core.InputSignal<string>;
     /** id imposé (sélecteurs de test stables) ; sinon auto-généré, anti-collision. @default undefined */
     readonly id: _angular_core.InputSignal<string | undefined>;
-    /** Texte du libellé associé à la bascule. @default undefined */
+    /** Texte du libellé (remplacé visuellement par un contenu projeté). @default undefined */
     readonly label: _angular_core.InputSignal<string | undefined>;
     /** Texte d'aide affiché sous la bascule (masqué quand une erreur s'affiche). @default undefined */
     readonly hint: _angular_core.InputSignal<string | undefined>;
@@ -585,6 +595,7 @@ declare class KtSwitch implements FormValueControl<boolean> {
     /** Afficher toutes les erreurs au lieu de la première seule. @default KT_FIELD_CONFIG.showAllErrors ?? false */
     readonly showAllErrors: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly switchBtn;
+    private readonly el;
     private readonly errorResolver;
     private readonly idGen;
     private readonly uid;
@@ -605,7 +616,7 @@ declare class KtSwitch implements FormValueControl<boolean> {
     protected toggle(): void;
     protected onSpacebar(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtSwitch, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtSwitch, "kt-switch", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "errorMatcher": { "alias": "errorMatcher"; "required": false; "isSignal": true; }; "showAllErrors": { "alias": "showAllErrors"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtSwitch, "kt-switch", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "errorMatcher": { "alias": "errorMatcher"; "required": false; "isSignal": true; }; "showAllErrors": { "alias": "showAllErrors"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
 }
 
 /**

package/types/ktortu-aaa-i18n.d.ts

@@ -2,6 +2,7 @@ import { EnvironmentProviders } from '@angular/core';
 import { KtFieldConfig, KtSelectConfigOptions, KtChipsConfig } from '@ktortu/aaa/forms';
 import { KtSnackbarConfig } from '@ktortu/aaa/snackbar';
 import { KtTabsConfig } from '@ktortu/aaa/tabs';
+import { KtDialogConfig } from '@ktortu/aaa/dialog';
 
 /**
  * Agrégat de TOUS les libellés traduisibles de la lib, groupés par famille de composants.
@@ -23,6 +24,8 @@ interface KtTranslations {
     snackbar?: Partial<KtSnackbarConfig>;
     /** Libellés de la pagination des onglets → {@link KT_TABS_CONFIG}. */
     tabs?: Partial<KtTabsConfig>;
+    /** Libellés du dialog (`sheetCloseLabel`) → {@link KT_DIALOG_CONFIG}. */
+    dialog?: Partial<KtDialogConfig>;
 }
 /**
  * Enregistre, en un seul appel, les libellés fournis sur les tokens de config de la lib.

package/types/ktortu-aaa-icon.d.ts

@@ -0,0 +1,158 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, Provider } from '@angular/core';
+
+/**
+ * Définition d'une police d'icônes **à ligatures** enregistrée dans le registre (cf.
+ * {@link KtIconConfig}). Le registre ne charge AUCUNE police : il se contente d'associer un alias
+ * court à la famille CSS réelle (à vous de charger le fichier de police, façon « apportez la vôtre »).
+ */
+interface KtIconFont {
+    /** Famille de police CSS réelle (ex. `'Material Symbols Rounded'`). Valeur `font-family` brute :
+        si elle commence par un chiffre ou contient des caractères spéciaux, la citer vous-même. */
+    family: string;
+    /** Graisse par défaut de cette police (ex. `300` ou `'normal'`). @default hérité de `--kt-icon-font-weight` */
+    weight?: string | number;
+    /** `font-variation-settings` par défaut (polices variables, ex. `"'FILL' 0, 'wght' 300"`). @default `normal` */
+    variationSettings?: string;
+}
+/**
+ * Défauts applicables à toutes les icônes `[ktIcon]` (registre de polices + police par défaut),
+ * fournis via {@link provideKtIcon}. Fourni en `Partial` : on ne déclare que ce qu'on veut.
+ */
+interface KtIconConfig {
+    /** Registre `alias → police`. L'alias est ensuite choisi sur la primitive via `[font]`. */
+    fonts: Record<string, KtIconFont>;
+    /** Alias utilisé quand aucune police n'est précisée sur la primitive (`[font]` absent). */
+    defaultFont: string;
+}
+/**
+ * Interface d'**enregistrement des alias de POLICE** à augmenter côté application pour typer l'input
+ * `[font]` et obtenir son **autocomplétion** dans les templates. Vide par défaut : sans augmentation,
+ * `[font]` accepte n'importe quelle chaîne (dégradation gracieuse, zéro config).
+ *
+ * Nommée `KtIconFontRegistry` (et non `KtIconRegistry`) à dessein : le nom générique reste réservé à
+ * un futur registre de **noms d'icônes** (SVG), qui bénéficiera du même mécanisme.
+ *
+ * @example Recette à source unique (le même objet type ET fournit le registre) :
+ * ```ts
+ * // app-icons.ts
+ * export const APP_ICON_FONTS = {
+ *   material: { family: 'Material Symbols Outlined' },
+ *   rounded: { family: 'Material Symbols Rounded', variationSettings: "'FILL' 0, 'wght' 300" },
+ * } as const;
+ *
+ * declare module '@ktortu/aaa/icon' {
+ *   // Injecte les clés de APP_ICON_FONTS comme alias connus → autocomplétion de [font].
+ *   // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ *   interface KtIconFontRegistry extends Record<keyof typeof APP_ICON_FONTS, unknown> {}
+ * }
+ *
+ * // app.config.ts
+ * providers: [provideKtIcon({ fonts: APP_ICON_FONTS, defaultFont: 'material' })];
+ * ```
+ */
+interface KtIconFontRegistry {
+}
+/**
+ * Alias de police connus : l'union des clés de {@link KtIconFontRegistry} une fois augmentée, sinon
+ * `string` (registre vide → chaîne libre). Le tuple `[…] extends […]` évite la distribution du
+ * conditionnel sur l'union.
+ */
+type KtIconFontAlias = [keyof KtIconFontRegistry] extends [never] ? string : keyof KtIconFontRegistry;
+declare const KT_ICON_CONFIG: InjectionToken<Partial<KtIconConfig>>;
+/**
+ * Fournit un registre de polices d'icônes (alias → famille) et l'alias par défaut, pour un
+ * sous-arbre ou l'application entière. Combiné à l'augmentation de {@link KtIconFontRegistry}, il
+ * offre l'autocomplétion typée de l'input `[font]`.
+ *
+ * `defaultFont` est **contraint aux clés de `fonts`** passées dans le même appel : un typo devient
+ * une erreur de compilation (pas de repli silencieux de toutes les icônes sur la police globale).
+ *
+ * @example
+ * ```ts
+ * providers: [
+ *   provideKtIcon({
+ *     fonts: {
+ *       material: { family: 'Material Symbols Outlined' },
+ *       rounded: { family: 'Material Symbols Rounded' },
+ *     },
+ *     defaultFont: 'material', // 'rouded' → erreur TS
+ *   }),
+ * ];
+ * ```
+ */
+declare function provideKtIcon<F extends Record<string, KtIconFont>>(config: {
+    fonts?: F;
+    defaultFont?: keyof F & string;
+}): Provider;
+/**
+ * Primitive d'icône **autonome** : pose une icône seule (en-tête, item de liste, badge d'état…),
+ * là où le bouton et les champs ne suffisent pas. Directive présentationnelle — **jamais focusable
+ * ni cliquable** (pour une icône cliquable, utilisez `ktButton iconOnly`).
+ *
+ * Sélecteur d'attribut `[ktIcon]` (camelCase) ; l'hôte reçoit la classe stable `.kt-icon` (cible du
+ * style et du harness). Ne pas confondre avec le slot de projection `[kt-icon]` (kebab) de
+ * `kt-nav-item`, qui est un autre mécanisme.
+ *
+ * Deux régimes, comme dans le reste de la lib :
+ * - **Ligature** (`[ktIcon]="nom"`) : le nom devient un glyphe via une police d'icônes à ligatures
+ *   (défaut `--kt-icon-font` → Material Symbols Outlined). Choisissez une autre police enregistrée
+ *   via `[font]`.
+ * - **Projection** (set à classes, ex. Font Awesome, ou SVG en ligne) : laissez `ktIcon` vide et
+ *   projetez votre markup dans l'élément ; la primitive ne fait que l'habiller (taille, couleur
+ *   héritée, alignement). Le contenu projeté **ne doit jamais être focusable** (l'hôte décoratif
+ *   porte `aria-hidden` : un descendant focusable violerait WCAG 4.1.2).
+ *
+ * Accessibilité : **décorative par défaut** (`aria-hidden`). Fournissez `[ariaLabel]` (ou un
+ * `aria-label` natif) pour une icône **porteuse de sens** (bascule en `role="img"`).
+ *
+ * @example
+ * ```html
+ * <!-- Ligature autonome, taille et couleur héritées du contexte ; `fill` = version remplie -->
+ * <span ktIcon="home"></span>
+ * <span ktIcon="favorite" fill size="2rem" style="color: var(--kt-primary)"></span>
+ *
+ * <!-- Set à classes (Font Awesome) : projection, ktIcon reste vide -->
+ * <span ktIcon><i class="fa-solid fa-user"></i></span>
+ *
+ * <!-- Icône porteuse de sens (nommée pour les lecteurs d'écran) -->
+ * <span ktIcon="error" ariaLabel="Erreur" style="color: var(--kt-danger)"></span>
+ * ```
+ */
+declare class KtIcon {
+    private readonly config;
+    private readonly auditEnabled;
+    private readonly platformId;
+    private readonly host;
+    private readonly nativeAriaLabel;
+    /** Nom de l'icône (ligature). Laisser vide pour projeter un set à classes / un SVG. @default '' */
+    readonly ktIcon: _angular_core.InputSignal<string>;
+    /** Alias de police d'icônes du registre (cf. {@link provideKtIcon}). @default `KtIconConfig.defaultFont` */
+    readonly font: _angular_core.InputSignal<string | undefined>;
+    /** Nom accessible : le fournir rend l'icône **porteuse de sens** (`role="img"`). Aligné sur `ktButton`.
+        @default undefined (icône décorative ; un `aria-label` natif reste toutefois préservé) */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Taille de l'icône (longueur CSS, ex. `'24px'`, `'2rem'`, `'1.5em'`). @default `1.25em` (héritée du contexte) */
+    readonly size: _angular_core.InputSignal<string | undefined>;
+    /** Version **remplie** plutôt que contour, pour les polices variables à axe `FILL` (Material Symbols).
+        Force `FILL` à 1 en préservant les autres axes (graisse…) ; sans effet sur une police sans cet axe.
+        Nécessite une police chargée **avec l'axe FILL ajustable** (ex. Google Fonts :
+        `…Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200`).
+        @default false (contour) */
+    readonly fill: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Nom rendu en ligature : coupé, `null` si vide (aucun `::before`, laisse place à la projection). */
+    protected readonly renderedName: _angular_core.Signal<string | null>;
+    /** Libellé accessible résolu : input prioritaire, sinon `aria-label` natif préservé, sinon `null` (décorative). */
+    protected readonly accessibleLabel: _angular_core.Signal<string | null>;
+    /** Police résolue depuis le registre : alias explicite, sinon police par défaut du provider. */
+    private readonly resolvedFont;
+    protected readonly resolvedFamily: _angular_core.Signal<string | null>;
+    protected readonly resolvedWeight: _angular_core.Signal<string | null>;
+    protected readonly resolvedVariation: _angular_core.Signal<string | null>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtIcon, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KtIcon, "[ktIcon]", never, { "ktIcon": { "alias": "ktIcon"; "required": false; "isSignal": true; }; "font": { "alias": "font"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fill": { "alias": "fill"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { KT_ICON_CONFIG, KtIcon, provideKtIcon };
+export type { KtIconConfig, KtIconFont, KtIconFontAlias, KtIconFontRegistry };

package/types/ktortu-aaa-layout.d.ts

@@ -77,11 +77,21 @@ declare class KtToolbarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtToolbarComponent, "kt-toolbar", never, {}, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Item de navigation : projette une icône dans son slot dédié + un libellé.
+ *
+ * Le slot d'icône accepte :
+ * - la directive `[ktIcon]` (primitive d'icône `@ktortu/aaa/icon`), forme canonique.
+ * - l'attribut de projection `kt-icon` (historique/legacy).
+ *
+ * Note : la classe `.kt-icon` (posée à l'exécution par la directive) n'est PAS un critère de
+ * projection valable (ng-content matche la forme statique du template) — d'où le sélecteur d'attribut.
+ */
 declare class KtNavItemComponent {
     label: _angular_core.InputSignal<string>;
     protected readonly layout: KtLayoutService;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtNavItemComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtNavItemComponent, "kt-nav-item", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; }, {}, never, ["[kt-icon]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtNavItemComponent, "kt-nav-item", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; }, {}, never, ["[ktIcon], [kt-icon]", "*"], true, never>;
 }
 
 /**

package/types/ktortu-aaa-tooltip.d.ts

@@ -75,6 +75,22 @@ declare class KtTooltip implements OnDestroy {
     ngOnDestroy(): void;
     protected show(): void;
     protected hide(): void;
+    /**
+     * Fermeture immédiate à l'activation de la cible (clic souris, tap tactile, stylet).
+     * Dès que l'utilisateur AGIT sur l'élément (typiquement un bouton qui ouvre une bottom sheet ou un
+     * dialog), l'infobulle a fini son rôle : on la ferme sans attendre le hideDelay, et on purge un
+     * affichage en attente pour qu'il ne surgisse pas après coup.
+     *
+     * Sans ce déclencheur, une infobulle affichée au survol SURVIVAIT à l'ouverture d'un overlay : le
+     * pointeur reste sur la cible (aucun `mouseleave`) et un clic ne défocalise pas toujours (aucun
+     * `focusout` fiable, ex. Safari/Firefox macOS). Comme l'infobulle est un popover en top layer, elle
+     * flottait alors AU-DESSUS de l'overlay (lui empilé au z-index) — impossible à masquer autrement.
+     *
+     * `pointerdown` (et non `click`) car il précède l'ouverture de l'overlay et le déplacement de focus
+     * → zéro flash. On ne fait ni preventDefault ni stopPropagation : l'action native (clic) doit suivre
+     * son cours. Le cas clavier (Entrée/Espace) reste couvert par `focusout` quand l'overlay prend le focus.
+     */
+    protected onActivate(): void;
     protected onEscape(event: Event): void;
     private dismiss;
     private ensureTip;

package/types/ktortu-aaa.d.ts

@@ -5,6 +5,7 @@ export * from '@ktortu/aaa/dialog';
 export * from '@ktortu/aaa/disclosure';
 export * from '@ktortu/aaa/forms';
 export * from '@ktortu/aaa/i18n';
+export * from '@ktortu/aaa/icon';
 export * from '@ktortu/aaa/menu';
 export * from '@ktortu/aaa/snackbar';
 export * from '@ktortu/aaa/tabs';