@ktortu/aaa 0.9.7 → 0.9.9

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>;
 }
 
 /**
@@ -998,6 +1009,11 @@ declare abstract class KtBaseSelect<T, V = T> {
     readonly hideLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Masquer visuellement le bloc d'erreur. @default KT_FIELD_CONFIG.hideErrors ?? false */
     readonly hideErrors: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Bouton « effacer » (×) sur le champ quand une valeur est sélectionnée (même contrat que
+        `clearable` de BaseInputField ; single vide la sélection, multi vide toute la sélection). @default false */
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Libellé i18n du bouton « effacer ». @default 'Clear' (ou KT_FIELD_CONFIG.clearLabel) */
+    readonly clearLabel: _angular_core.InputSignal<string>;
     /** Affiche un champ de recherche en tête du popup (desktop) / de la sheet (téléphone).
         Pour les listes longues ; le texte tapé ne sert qu'à filtrer (réinitialisé à la fermeture). @default false */
     readonly filterable: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1098,11 +1114,27 @@ declare abstract class KtBaseSelect<T, V = T> {
     protected refocusTriggerAfterFilterClose(): void;
     /** Fermeture synchrone du Popover (l'effect, différé, ne re-cachera pas : flag popoverShown). */
     protected closePopupNow(): void;
-    private readonly sheetDrag;
-    protected onDragStart(event: PointerEvent): void;
+    private sheetEl;
+    private sheetState;
+    /** Armé quand l'ouverture a dépassé 50px : un repos à ~0 est alors forcément le snap « fermé »
+        (et non la position initiale) — même logique que le prototype du spike. */
+    private sheetArmed;
+    private sheetCloseTimer;
+    private resetSheetState;
+    private prefersReducedMotion;
+    /** Entrée de la sheet : position « fermée » puis scroll animé vers le snap « ouvert ». */
+    private openSheetByScroll;
+    /** Détection du snap « fermé » par position de scroll (ni scrollsnapchange ni scrollend :
+        non interopérables — cf. ADR-0005). Un geste de l'utilisateur qui amène la sheet au repos
+        à 0 EST la fermeture ; les fermetures programmatiques y convergent aussi. */
+    private readonly onSheetScroll;
+    /** La molette ne ferme JAMAIS la sheet (pas de geste souris — ADR-0005) : seule la listbox
+        peut consommer, dans les limites de son propre défilement. */
+    private readonly onSheetWheel;
+    private finalizeSheetClose;
     private animateAndCloseSelect;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtBaseSelect<any, any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KtBaseSelect<any, any>, never, never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "optionDisabled": { "alias": "optionDisabled"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "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; }; "helpText": { "alias": "helpText"; "required": false; "isSignal": true; }; "helpLabel": { "alias": "helpLabel"; "required": false; "isSignal": true; }; "customDescribedBy": { "alias": "customDescribedBy"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMatcher": { "alias": "errorMatcher"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "hideLabel": { "alias": "hideLabel"; "required": false; "isSignal": true; }; "hideErrors": { "alias": "hideErrors"; "required": false; "isSignal": true; }; "filterable": { "alias": "filterable"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "filterLabel": { "alias": "filterLabel"; "required": false; "isSignal": true; }; "filterFn": { "alias": "filterFn"; "required": false; "isSignal": true; }; "maxVisibleOptions": { "alias": "maxVisibleOptions"; "required": false; "isSignal": true; }; "truncatedResultsText": { "alias": "truncatedResultsText"; "required": false; "isSignal": true; }; "truncatedResultsAnnouncement": { "alias": "truncatedResultsAnnouncement"; "required": false; "isSignal": true; }; }, { "helpClick": "helpClick"; "touched": "touchedChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KtBaseSelect<any, any>, never, never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "optionDisabled": { "alias": "optionDisabled"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "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; }; "helpText": { "alias": "helpText"; "required": false; "isSignal": true; }; "helpLabel": { "alias": "helpLabel"; "required": false; "isSignal": true; }; "customDescribedBy": { "alias": "customDescribedBy"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMatcher": { "alias": "errorMatcher"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "hideLabel": { "alias": "hideLabel"; "required": false; "isSignal": true; }; "hideErrors": { "alias": "hideErrors"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "filterable": { "alias": "filterable"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "filterLabel": { "alias": "filterLabel"; "required": false; "isSignal": true; }; "filterFn": { "alias": "filterFn"; "required": false; "isSignal": true; }; "maxVisibleOptions": { "alias": "maxVisibleOptions"; "required": false; "isSignal": true; }; "truncatedResultsText": { "alias": "truncatedResultsText"; "required": false; "isSignal": true; }; "truncatedResultsAnnouncement": { "alias": "truncatedResultsAnnouncement"; "required": false; "isSignal": true; }; }, { "helpClick": "helpClick"; "touched": "touchedChange"; }, never, never, true, never>;
 }
 
 /** Contexte typé reçu par le template d'une option (`ktSelectOption`). */
@@ -1191,6 +1223,10 @@ declare class KtSelect<T, V = T> extends KtBaseSelect<T, V> implements FormValue
     protected readonly triggerDef: _angular_core.Signal<KtSelectTriggerDef<any> | undefined>;
     /** Fermer le popup après une sélection (sémantique single ; le multi reste ouvert). */
     private readonly closeOnSelect;
+    /** Affiche le bouton « effacer » (×) sur le champ dès qu'une valeur est présente (`clearable`).
+        Basé sur `value()` et non `selectedOption()` : une clé orpheline (option retirée des données)
+        reste effaçable. */
+    protected readonly showClear: _angular_core.Signal<boolean>;
     /** Option correspondant à la valeur courante (clé extraite, ou objet si `optionValue` est omis). */
     protected readonly selectedOption: _angular_core.Signal<T | null>;
     /** Valeur du listbox : tableau de clés (0 ou 1 élément en single). */
@@ -1199,6 +1235,8 @@ declare class KtSelect<T, V = T> extends KtBaseSelect<T, V> implements FormValue
     /** La sélection courante est-elle masquée par le filtre ou la troncation ? (≠ retirée des données). */
     private isSelectionFilteredOut;
     private commitSelection;
+    /** Efface la sélection depuis le champ (bouton `clearable`) et rend le focus au trigger. */
+    protected clearSelection(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtSelect<any, any>, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtSelect<any, any>, "kt-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "selectionChange": "selectionChange"; }, ["optionDef", "triggerDef"], ["[ktFieldHelp]"], true, never>;
 }
@@ -1390,10 +1428,6 @@ declare class KtMultiSelect<T, V = T> extends KtBaseSelect<T, V> implements Form
     /** Émis à chaque (dé)sélection. Payload : `{ value, options }` — `value` le tableau des valeurs émises
         (clés ou objets), `options` les objets options correspondants, dans l'ordre de sélection. */
     readonly selectionChange: _angular_core.OutputEmitterRef<KtMultiSelectSelectionChange<T, V>>;
-    /** Bouton « tout effacer » sur le champ (même contrat que `clearable` de BaseInputField). @default false */
-    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Libellé i18n du bouton « tout effacer ». @default 'Clear' (ou KT_FIELD_CONFIG.clearLabel) */
-    readonly clearLabel: _angular_core.InputSignal<string>;
     /** Barre « Tout sélectionner / Tout effacer » en tête du popup (bascule le popup en panneau dialog). */
     readonly selectionActions: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Nombre maximal de chips affichés avant repli derrière un bouton « +N more ». Défaut : illimité. */
@@ -1454,7 +1488,7 @@ declare class KtMultiSelect<T, V = T> extends KtBaseSelect<T, V> implements Form
     /** Annonce immédiate (action ponctuelle, pas de débounce) du total sélectionné. */
     private announceSelectionCount;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtMultiSelect<any, any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtMultiSelect<any, any>, "kt-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "selectionActions": { "alias": "selectionActions"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "selectionChange": "selectionChange"; }, ["optionDef", "triggerDef", "chipDef"], ["[ktFieldHelp]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtMultiSelect<any, any>, "kt-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "selectionActions": { "alias": "selectionActions"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "selectionChange": "selectionChange"; }, ["optionDef", "triggerDef", "chipDef"], ["[ktFieldHelp]"], true, never>;
 }
 
 /** Portée de transition des chips. Fourni par `ChipList` (via `useExisting`) ; injecté en
@@ -1718,12 +1752,30 @@ declare class KtChipList<T> implements ChipTransitionScope {
         Public : permet au parent d'annoncer des actions liées (ex. « tout effacer »). */
     announce(text: string): void;
     private activeTransition;
+    /**
+     * Vrai sur le moteur WebKit (Safari desktop + TOUS les navigateurs iOS, qui embarquent WebKit).
+     *
+     * Contournement DOCUMENTÉ et RÉVERSIBLE d'un bug de compositing des View Transitions au niveau
+     * document sur WebKit : après la transition, les chips (hôtes d'éléments custom dont le
+     * `view-transition-name` est posé puis retiré dynamiquement) ne se repeignent pas — seules les
+     * croix « retirer » (boutons natifs, compositées sur une couche distincte) subsistent à l'écran.
+     * Touche aussi bien le retrait que le déplier/replier : les deux passent par ce wrapper.
+     *
+     * Le défaut n'est PAS feature-detectable : `startViewTransition` répond présente puis rate le
+     * rendu final, d'où la détection de MOTEUR. `navigator.vendor` est gelé pour compat — vaut
+     * « Apple Computer, Inc. » sur WebKit UNIQUEMENT (Blink = « Google Inc. », Gecko = « »). On NE
+     * gate PAS sur l'absence de la variante scopée `element.startViewTransition` : cela exclurait
+     * Firefox à tort (transition document parfaitement rendue chez lui). À RETIRER quand Safari
+     * corrigera le compositing.
+     */
+    private isWebKitEngine;
     /** Exécute `action` dans une View Transition (morph des chips qui se déplacent, entrée/sortie
         stylées via `::view-transition-*(.chip-transition)` — cf. tokens.css). Transition SCOPÉE à
         l'élément quand le navigateur le permet (`element.startViewTransition`, Chrome 147+) ; sinon
         transition document — dans les deux cas, seuls les chips de CETTE liste sont nommés (cf.
-        `transitioning`). Fallback : action directe si l'API est absente ou si l'utilisateur
-        préfère moins de mouvement. */
+        `transitioning`). Fallback : action directe (retrait/dépli instantané, état final garanti
+        correct) si l'API est absente, si l'utilisateur préfère moins de mouvement, ou sur WebKit
+        (bug de compositing, cf. `isWebKitEngine`). */
     private withViewTransition;
     /** Retrait demandé : annonce, émet vers le parent (qui met à jour `items`), puis focus
         le chip suivant — sinon `emptyFocusTarget` (le bouton focusé disparaît du DOM). */

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;