@ktortu/aaa 0.9.0 → 0.9.2

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

@@ -1,8 +1,8 @@
 import * as _angular_core from '@angular/core';
 import { InjectionToken, Signal, Provider, TemplateRef, ModelSignal, ElementRef, PipeTransform } from '@angular/core';
-import * as _ktortu_aaa_forms from '@ktortu/aaa/forms';
 import * as _angular_forms_signals from '@angular/forms/signals';
-import { WithOptionalFieldTree, ValidationError, FormValueControl } from '@angular/forms/signals';
+import { ValidationError, WithOptionalFieldTree, FormValueControl } from '@angular/forms/signals';
+import * as _ktortu_aaa_forms from '@ktortu/aaa/forms';
 import { Listbox } from '@angular/aria/listbox';
 import { Combobox } from '@angular/aria/combobox';
 import { KtViewport } from '@ktortu/aaa/cdk';
@@ -21,6 +21,16 @@ interface KtFieldErrorState {
 }
 /** Décide QUAND afficher les erreurs d'un champ (équivalent signal de l'ErrorStateMatcher Material). */
 type KtFieldErrorMatcher = (state: KtFieldErrorState) => boolean;
+/** Erreur à résoudre en message : la `ValidationError` de Signal Forms. Selon le `kind`, ses
+    sous-types portent des params typés (`min`, `max`, `minLength`, `maxLength`, `minDate`,
+    `maxDate`, `pattern`…) lisibles via {@link ktErrorParam}. */
+type KtResolvableError = ValidationError;
+/** Fabrique de message par défaut pour un `kind` : reçoit l'erreur complète (params accessibles). */
+type KtErrorMessageFactory = (error: KtResolvableError) => string;
+/** Messages d'erreur par défaut indexés par `kind`. Valeur statique (kinds sans param : `required`,
+    `email`) ou fabrique (kinds paramétrés : `min`, `minLength`…). Une chaîne vide (`''`) supprime
+    l'affichage du message — le champ reste invalide, mais sans texte (cf. récap d'erreurs externe). */
+type KtFieldErrorMessages = Record<string, string | KtErrorMessageFactory>;
 /** Apparence du chrome de champ. `fill` = label au-dessus (défaut historique) ; `outline` = bordure
     + label flottant qui se loge dans la bordure (transition douce depuis Angular Material « outline »). */
 type KtFieldAppearance = 'fill' | 'outline';
@@ -47,6 +57,11 @@ interface KtFieldConfig {
     /** Message d'erreur d'un `kt-number-field` quand la saisie n'est pas un nombre valide.
         Défaut (anglais neutre) : `'Please enter a valid number.'`. */
     numberParseError: string;
+    /** Messages d'erreur par défaut indexés par `kind` (`required`, `email`, `min`, `minLength`…),
+        fusionnés par-dessus les défauts anglais embarqués (cf. `KT_DEFAULT_FIELD_ERROR_MESSAGES`).
+        Un message explicite passé au validateur Signal Forms (`{ message }`) reste prioritaire ; une
+        valeur `''` supprime le texte d'un `kind`. Défaut : `{}` (on garde les défauts anglais). */
+    errorMessages: Partial<KtFieldErrorMessages>;
     /** Apparence par défaut de tous les champs (`fill` | `outline`). Défaut : `'fill'`. */
     appearance: KtFieldAppearance;
     /** Politique du label flottant en `outline` (`auto` | `always`). Défaut : `'auto'`. */
@@ -54,15 +69,33 @@ interface KtFieldConfig {
 }
 declare const KT_FIELD_CONFIG: InjectionToken<Partial<KtFieldConfig>>;
 /**
- * Fournit des défauts de champ (apparence, libellés, matcher d'erreurs…) pour un sous-arbre ou
- * l'application entière. Idéal pour une transition globale — ex. tout passer en `outline` façon
- * Material en un seul provider.
+ * Fournit des défauts de champ (apparence, libellés, matcher d'erreurs, messages d'erreur par
+ * défaut…) pour un sous-arbre ou l'application entière. Idéal pour une transition globale — ex. tout
+ * passer en `outline` façon Material en un seul provider.
  *
  * @example
  * ```ts
- * // app.config.ts
+ * // app.config.ts — apparence globale
  * providers: [provideKtField({ appearance: 'outline' })]
  * ```
+ *
+ * @example
+ * ```ts
+ * // Surcharger des messages d'erreur par défaut (fusionnés par-dessus les défauts anglais).
+ * // Une fabrique reçoit l'erreur complète : ses params typés sont lisibles via `ktErrorParam`.
+ * providers: [
+ *   provideKtField({
+ *     errorMessages: {
+ *       required: 'Champ obligatoire.',
+ *       minLength: (e) => `Au moins ${ktErrorParam<number>(e, 'minLength')} caractères.`,
+ *       pattern: '', // '' supprime le texte de ce kind : champ rouge, sans message
+ *     },
+ *   }),
+ * ]
+ * ```
+ *
+ * @remarks Pour passer toute la lib en français d'un coup (libellés + messages d'erreur), préférez
+ * `provideKtDefaultFR()` (paquet `@ktortu/aaa/i18n`), qui fournit déjà un dictionnaire complet.
  */
 declare function provideKtField(config: Partial<KtFieldConfig>): Provider;
 /** Parent field interface representing shared states for its controls. */
@@ -131,22 +164,23 @@ declare class KtField implements KtFieldParent {
     /** Politique effective : input ?? KT_FIELD_CONFIG.floatLabel ?? 'auto'. */
     protected readonly resolvedFloatLabel: _angular_core.Signal<KtFloatLabel>;
     private readonly control;
-    private readonly templateTooltip;
-    private readonly projectedTooltip;
-    private readonly activeTooltip;
     private readonly idGen;
     private readonly uid;
     readonly baseId: _angular_core.Signal<string>;
     protected readonly labelId: _angular_core.Signal<string>;
     protected readonly hintId: _angular_core.Signal<string>;
     protected readonly errorId: _angular_core.Signal<string>;
+    protected readonly helpId: _angular_core.Signal<string>;
+    protected readonly helpTemplate: _angular_core.Signal<TemplateRef<unknown> | null>;
+    protected readonly helpString: _angular_core.Signal<string | null>;
+    protected readonly hasHelp: _angular_core.Signal<boolean>;
     protected readonly hasError: _angular_core.Signal<boolean>;
     protected readonly showHint: _angular_core.Signal<boolean>;
     protected readonly displayedErrors: _angular_core.Signal<readonly KtFieldError[]>;
     readonly describedBy: _angular_core.Signal<string | null>;
     protected onHelpClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtField, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtField, "kt-field", never, { "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; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "fieldId": { "alias": "fieldId"; "required": false; "isSignal": true; }; "hideHintWhenInvalid": { "alias": "hideHintWhenInvalid"; "required": false; "isSignal": true; }; "showAllErrors": { "alias": "showAllErrors"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; }, { "helpClick": "helpClick"; }, ["control", "projectedTooltip"], ["[ktFieldHelp]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtField, "kt-field", never, { "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; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "fieldId": { "alias": "fieldId"; "required": false; "isSignal": true; }; "hideHintWhenInvalid": { "alias": "hideHintWhenInvalid"; "required": false; "isSignal": true; }; "showAllErrors": { "alias": "showAllErrors"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; }, { "helpClick": "helpClick"; }, ["control"], ["[ktFieldHelp]", "*"], true, never>;
 }
 
 /** Marque le contrôle (natif ou custom) d'un champ pour que `Field` y câble l'a11y
@@ -170,6 +204,54 @@ declare class KtFieldControl {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KtFieldControl, "[ktFieldControl]", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Lit un param typé d'une `ValidationError` (ex. `min`, `minLength`, `maxLength`, `minDate`…).
+ * Les sous-types d'erreur de Signal Forms exposent ces params, mais le type de base `ValidationError`
+ * ne les déclare pas : ce helper centralise l'accès pour les fabriques de message, sans `any`.
+ *
+ * @example
+ * ```ts
+ * minLength: (e) => `Au moins ${ktErrorParam<number>(e, 'minLength')} caractères.`
+ * ```
+ */
+declare function ktErrorParam<T>(error: KtResolvableError, key: string): T;
+/**
+ * Messages d'erreur **anglais** par défaut de la lib, indexés par `kind`. Couvrent tous les
+ * validateurs natifs de Signal Forms (`required`, `email`, `min`, `max`, `minLength`, `maxLength`,
+ * `minDate`, `maxDate`, `pattern`). Surchargeables famille par famille via `KT_FIELD_CONFIG.errorMessages`
+ * (ou globalement par langue, cf. `provideKtDefaultFR`). Le `numberParseError` reste géré à la source
+ * par `kt-number-field` (kind `parse`).
+ */
+declare const KT_DEFAULT_FIELD_ERROR_MESSAGES: KtFieldErrorMessages;
+/**
+ * Résout le **message par défaut** d'une erreur de validation à partir de son `kind` (et de ses
+ * params typés), en fusionnant les défauts anglais embarqués avec les surcharges du `KT_FIELD_CONFIG`.
+ *
+ * Utilisé par chaque contrôle `kt-*` au moment du rendu, là où la `ValidationError` complète (params)
+ * est encore disponible — `kt-field` reste agnostique de Signal Forms. Précédence du texte affiché :
+ * `message` du validateur > `KT_FIELD_CONFIG.errorMessages[kind]` > défaut anglais > rien.
+ *
+ * Injectable racine : un seul résolveur partagé par tous les champs.
+ */
+declare class KtFieldErrorResolver {
+    private readonly config;
+    /** Map effective : défauts anglais + surcharges du `KT_FIELD_CONFIG`, par `kind`. */
+    private readonly messages;
+    /**
+     * Message par défaut d'une erreur (selon son `kind` + params), ou `undefined` si aucun défaut
+     * n'est connu pour ce `kind` (l'UI n'affiche alors rien).
+     */
+    resolve(error: KtResolvableError): string | undefined;
+    /**
+     * Prépare une liste d'erreurs pour l'affichage : applique la précédence (message du validateur
+     * sinon défaut résolu) et **écarte les erreurs au message vide** — suppression explicite via
+     * `{ message: '' }`. Le champ reste invalide (rouge / `aria-invalid`), simplement sans texte.
+     */
+    resolveAll(errors: readonly KtResolvableError[]): KtFieldError[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtFieldErrorResolver, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<KtFieldErrorResolver>;
+}
+
 /** Base partagée des champs simples (TextField, NumberField) : état FormValueControl,
     présentation (label/hint/prefix/suffix/clear) et politique d'affichage des erreurs.
     La valeur, son parsing et la notion de « vide » sont fournis par la sous-classe.
@@ -187,6 +269,7 @@ declare class KtFieldControl {
     ``` */
 declare abstract class KtBaseInputField<T> {
     protected readonly config: Partial<_ktortu_aaa_forms.KtFieldConfig> | null;
+    private readonly errorResolver;
     /** Valeur du contrôle — déclarée concrètement par la sous-classe. */
     abstract value: ModelSignal<T>;
     /** Marque le champ comme « visité » (déclenche l'affichage des erreurs). Deux-way. @default false */
@@ -201,6 +284,8 @@ declare abstract class KtBaseInputField<T> {
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Le champ a-t-il été modifié depuis sa valeur initiale. @default false */
     readonly dirty: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Validation asynchrone en cours (poussé par `[field]`) : pose `aria-busy` + `data-pending`. @default false */
+    readonly pending: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Liste des erreurs de validation à afficher. @default [] */
     readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
     /** Attribut `name` natif du contrôle. @default '' */
@@ -246,6 +331,8 @@ declare abstract class KtBaseInputField<T> {
     protected readonly inputRef: _angular_core.Signal<ElementRef<HTMLInputElement | HTMLTextAreaElement> | undefined>;
     private readonly matcher;
     protected readonly showInvalid: _angular_core.Signal<boolean>;
+    /** Erreurs prêtes pour `kt-field` : messages par défaut résolus, suppressions (`message: ''`) écartées. */
+    protected readonly displayErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
     protected readonly showClear: _angular_core.Signal<boolean>;
     /** Apparence effective (input ?? config ?? 'fill'). Sert aux templates : forward à `kt-field` et,
         en outline, pose une sentinelle de placeholder pour la détection « rempli » du label flottant. */
@@ -261,6 +348,12 @@ declare abstract class KtBaseInputField<T> {
     protected asText(value: string | TemplateRef<unknown> | undefined): string | null;
     protected onInput(event: Event): void;
     protected onKeyDown(event: KeyboardEvent): void;
+    /** Focus le contrôle natif (utilisé par Signal Forms `focusBoundControl`). */
+    focus(options?: FocusOptions): void;
+    /** Ré-aligne le texte affiché sur la valeur courante (utilisé par Signal Forms `reset`). */
+    reset(): void;
+    /** Représentation texte de la valeur pour l'input natif. Surchargeable par sous-classe. */
+    protected displayValue(): string;
     protected clear(): void;
     /** Parse la saisie brute en valeur typée. */
     protected abstract parse(raw: string): T;
@@ -269,7 +362,7 @@ declare abstract class KtBaseInputField<T> {
     /** La valeur est-elle vide (affichage du bouton d'effacement) ? */
     protected abstract isEmpty(value: T): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtBaseInputField<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KtBaseInputField<any>, never, never, { "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; }; "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; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "prefix": { "alias": "prefix"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "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; }; }, { "touched": "touchedChange"; "helpClick": "helpClick"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KtBaseInputField<any>, never, never, { "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; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "prefix": { "alias": "prefix"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "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; }; }, { "touched": "touchedChange"; "helpClick": "helpClick"; }, never, never, true, never>;
 }
 
 /** Suggestion d'un champ de saisie (rendu `<datalist>`) : soit la valeur seule, soit un couple
@@ -322,6 +415,7 @@ declare class KtNumberField extends KtBaseInputField<number | null> implements F
     protected parse(raw: string): number | null;
     protected onKeyDown(event: KeyboardEvent): void;
     private adjustValue;
+    reset(): void;
     protected emptyValue(): number | null;
     protected isEmpty(value: number | null): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtNumberField, never>;
@@ -342,13 +436,15 @@ declare class KtTextArea extends KtBaseInputField<string> implements FormValueCo
     readonly value: _angular_core.ModelSignal<string>;
     /** Hauteur initiale (lignes). L'autosize est géré en CSS via `field-sizing: content`. @default 3 */
     readonly rows: _angular_core.InputSignal<number>;
+    /** Plancher de caractères (attribut `minlength` natif ; poussé par le validateur minLength). @default undefined */
+    readonly minLength: _angular_core.InputSignal<number | undefined>;
     /** Plafond de caractères ; poussé par le form (validateur maxLength) ou par le consommateur. @default undefined */
     readonly maxLength: _angular_core.InputSignal<number | undefined>;
     protected parse(raw: string): string;
     protected emptyValue(): string;
     protected isEmpty(value: string): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtTextArea, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtTextArea, "kt-text-area", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["[ktFieldHelp]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtTextArea, "kt-text-area", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["[ktFieldHelp]"], true, never>;
 }
 
 /** Types texte dont la valeur reste une string (number/date = composants séparés). */
@@ -367,6 +463,15 @@ declare class KtTextField extends KtBaseInputField<string> implements FormValueC
     readonly value: _angular_core.ModelSignal<string>;
     /** Variante HTML du champ (pilote `type` natif et le clavier mobile). @default 'text' */
     readonly type: _angular_core.InputSignal<KtTextFieldType>;
+    /** Plancher de caractères (attribut `minlength` natif ; poussé par le validateur minLength). @default undefined */
+    readonly minLength: _angular_core.InputSignal<number | undefined>;
+    /** Plafond de caractères (attribut `maxlength` natif ; poussé par le validateur maxLength). @default undefined */
+    readonly maxLength: _angular_core.InputSignal<number | undefined>;
+    /** Motifs de validation (contrat Signal Forms). L'attribut natif `pattern` ne prend qu'une regex →
+        seule la première est posée. @default [] */
+    readonly pattern: _angular_core.InputSignal<readonly RegExp[]>;
+    /** Source de la première regex pour l'attribut `pattern` natif (`null` si aucune). */
+    protected readonly patternAttr: _angular_core.Signal<string>;
     /** Suggestions d'autocomplétion proposées via un `<datalist>` natif (la saisie reste libre).
         Valeurs simples (`string[]`) ou couples `{ value, label }` pour distinguer libellé affiché et
         valeur insérée. @default undefined */
@@ -380,7 +485,49 @@ declare class KtTextField extends KtBaseInputField<string> implements FormValueC
     protected emptyValue(): string;
     protected isEmpty(value: string): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtTextField, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtTextField, "kt-text-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["[ktFieldHelp]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtTextField, "kt-text-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["[ktFieldHelp]"], true, never>;
+}
+
+type KtPasswordAutocomplete = 'current-password' | 'new-password' | 'off';
+/**
+ * Champ mot de passe (valeur `string`) intégré aux Signal Forms via `FormValueControl`.
+ * Inclut un bouton pour masquer/afficher la saisie en clair de manière accessible.
+ *
+ * @example
+ * ```html
+ * <kt-password-field label="Mot de passe" [(value)]="password" required />
+ * ```
+ */
+declare class KtPasswordField extends KtBaseInputField<string> implements FormValueControl<string> {
+    /** Valeur saisie (two-way). @default '' */
+    readonly value: _angular_core.ModelSignal<string>;
+    /** Plancher de caractères (attribut `minlength` natif ; poussé par le validateur minLength). @default undefined */
+    readonly minLength: _angular_core.InputSignal<number | undefined>;
+    /** Plafond de caractères (attribut `maxlength` natif ; poussé par le validateur maxLength). @default undefined */
+    readonly maxLength: _angular_core.InputSignal<number | undefined>;
+    /** Motifs de validation. @default [] */
+    readonly pattern: _angular_core.InputSignal<readonly RegExp[]>;
+    /** Source de la première regex pour l'attribut `pattern` natif (`null` si aucune). */
+    protected readonly patternAttr: _angular_core.Signal<string>;
+    /** Indice d'autoremplissage effectif (par défaut 'current-password'). */
+    protected readonly resolvedAutocomplete: _angular_core.Signal<AutoFill>;
+    /** État de visibilité du mot de passe en clair. @default false */
+    protected readonly isPasswordVisible: _angular_core.WritableSignal<boolean>;
+    /** Type natif de l'input selon l'état de visibilité. */
+    protected readonly inputType: _angular_core.Signal<"text" | "password">;
+    private readonly idGen;
+    private readonly uid;
+    protected readonly inputId: _angular_core.Signal<string>;
+    protected parse(raw: string): string;
+    protected emptyValue(): string;
+    protected isEmpty(value: string): boolean;
+    /**
+     * Bascule l'état de visibilité du mot de passe.
+     * Utilise preventDefault() pour empêcher l'input de perdre le focus.
+     */
+    protected toggleVisibility(event: MouseEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtPasswordField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtPasswordField, "kt-password-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["[ktFieldHelp]"], true, never>;
 }
 
 /**
@@ -407,6 +554,8 @@ declare class KtSwitch implements FormValueControl<boolean> {
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** État « modifié » (entre dans la logique d'affichage des erreurs). @default false */
     readonly dirty: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Validation asynchrone en cours (poussé par `[field]`) : pose `aria-busy` + `data-pending`. @default false */
+    readonly pending: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Erreurs de validation à afficher sous la bascule. @default [] */
     readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
     /** Identifiant logique du contrôle (à titre indicatif). @default '' */
@@ -423,6 +572,8 @@ declare class KtSwitch implements FormValueControl<boolean> {
     readonly errorMatcher: _angular_core.InputSignal<KtFieldErrorMatcher | undefined>;
     /** 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 errorResolver;
     private readonly idGen;
     private readonly uid;
     protected readonly baseId: _angular_core.Signal<string>;
@@ -431,14 +582,18 @@ declare class KtSwitch implements FormValueControl<boolean> {
     protected readonly errorId: _angular_core.Signal<string>;
     private readonly matcher;
     protected readonly showInvalid: _angular_core.Signal<boolean>;
-    protected readonly displayedErrors: _angular_core.Signal<readonly WithOptionalFieldTree<ValidationError>[]>;
+    /** Erreurs résolues (messages par défaut appliqués, suppressions `message: ''` écartées). */
+    protected readonly resolvedErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
+    protected readonly displayedErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
     protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
     protected readonly describedBy: _angular_core.Signal<string | null>;
     constructor();
+    /** Focus le bouton bascule natif (utilisé par Signal Forms `focusBoundControl`). */
+    focus(options?: FocusOptions): void;
     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; }; "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, never, true, never>;
 }
 
 /**
@@ -473,6 +628,8 @@ declare class KtCheckboxGroup<V> implements FormValueControl<V[]> {
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** État « modifié » (entre dans la logique d'affichage des erreurs). @default false */
     readonly dirty: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Validation asynchrone en cours (poussé par `[field]`) : pose `aria-busy` + `data-pending`. @default false */
+    readonly pending: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Erreurs de validation à afficher sous le groupe. @default [] */
     readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
     /** Nom logique du groupe, à titre INDICATIF : contrairement à `kt-radio-group` (où `name` est
@@ -493,6 +650,8 @@ declare class KtCheckboxGroup<V> implements FormValueControl<V[]> {
     readonly showAllErrors: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Égalité des valeurs en mode objet (défaut : identité `===`). */
     readonly compareWith: _angular_core.InputSignal<((a: V, b: V) => boolean) | undefined>;
+    private readonly el;
+    private readonly errorResolver;
     private readonly idGen;
     private readonly uid;
     protected readonly baseId: _angular_core.Signal<string>;
@@ -501,16 +660,20 @@ declare class KtCheckboxGroup<V> implements FormValueControl<V[]> {
     protected readonly errorId: _angular_core.Signal<string>;
     private readonly matcher;
     protected readonly showInvalid: _angular_core.Signal<boolean>;
-    protected readonly displayedErrors: _angular_core.Signal<readonly WithOptionalFieldTree<ValidationError>[]>;
+    /** Erreurs résolues (messages par défaut appliqués, suppressions `message: ''` écartées). */
+    protected readonly resolvedErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
+    protected readonly displayedErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
     protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
     protected readonly describedBy: _angular_core.Signal<string | null>;
     private readonly comparator;
     /** La valeur d'option d'un enfant est-elle dans la sélection ? (lu dans le `computed` enfant) */
     isSelected(optionValue: V): boolean;
+    /** Focus la première case activable (utilisé par Signal Forms `focusBoundControl`). */
+    focus(options?: FocusOptions): void;
     /** Ajoute/retire une valeur d'option de la sélection (émis par un enfant au `change` natif). */
     toggle(optionValue: V, checked: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtCheckboxGroup<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtCheckboxGroup<any>, "kt-checkbox-group", 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; }; "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; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtCheckboxGroup<any>, "kt-checkbox-group", 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; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -562,6 +725,8 @@ declare class KtCheckbox<V = unknown> implements FormValueControl<boolean> {
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** État « modifié » (entre dans la logique d'affichage des erreurs). @default false */
     readonly dirty: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Validation asynchrone en cours (poussé par `[field]`) : pose `aria-busy` + `data-pending`. @default false */
+    readonly pending: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Erreurs de validation à afficher sous la case. @default [] */
     readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
     /** Attribut `name` du `<input>` natif. @default '' */
@@ -580,6 +745,9 @@ declare class KtCheckbox<V = unknown> implements FormValueControl<boolean> {
     readonly showAllErrors: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly inputEl;
     private readonly el;
+    private readonly errorResolver;
+    private readonly auditEnabled;
+    private isDestroyed;
     private readonly idGen;
     private readonly uid;
     protected readonly baseId: _angular_core.Signal<string>;
@@ -592,14 +760,18 @@ declare class KtCheckbox<V = unknown> implements FormValueControl<boolean> {
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     private readonly matcher;
     protected readonly showInvalid: _angular_core.Signal<boolean>;
-    protected readonly displayedErrors: _angular_core.Signal<readonly WithOptionalFieldTree<ValidationError>[]>;
+    /** Erreurs résolues (messages par défaut appliqués, suppressions `message: ''` écartées). */
+    protected readonly resolvedErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
+    protected readonly displayedErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
     protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
     protected readonly describedBy: _angular_core.Signal<string | null>;
     constructor();
+    /** Focus la case native (utilisé par Signal Forms `focusBoundControl`). */
+    focus(options?: FocusOptions): void;
     protected onChange(event: Event): void;
     protected onBlur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtCheckbox<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtCheckbox<any>, "kt-checkbox", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "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; }; "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>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtCheckbox<any>, "kt-checkbox", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "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>;
 }
 
 /**
@@ -635,6 +807,8 @@ declare class KtRadioGroup<V> implements FormValueControl<V | null> {
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** État « modifié » (entre dans la logique d'affichage des erreurs). @default false */
     readonly dirty: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Validation asynchrone en cours (poussé par `[field]`) : pose `aria-busy` + `data-pending`. @default false */
+    readonly pending: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Erreurs de validation à afficher sous le groupe. @default [] */
     readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
     /** Base du `name` partagé par les radios enfants (sinon auto-généré). @default '' */
@@ -653,6 +827,8 @@ declare class KtRadioGroup<V> implements FormValueControl<V | null> {
     readonly showAllErrors: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Égalité des valeurs en mode objet (défaut : identité `===`). Seul rescapé du contrat select. */
     readonly compareWith: _angular_core.InputSignal<((a: V, b: V) => boolean) | undefined>;
+    private readonly el;
+    private readonly errorResolver;
     private readonly idGen;
     private readonly uid;
     protected readonly baseId: _angular_core.Signal<string>;
@@ -663,16 +839,21 @@ declare class KtRadioGroup<V> implements FormValueControl<V | null> {
     protected readonly errorId: _angular_core.Signal<string>;
     private readonly matcher;
     protected readonly showInvalid: _angular_core.Signal<boolean>;
-    protected readonly displayedErrors: _angular_core.Signal<readonly WithOptionalFieldTree<ValidationError>[]>;
+    /** Erreurs résolues (messages par défaut appliqués, suppressions `message: ''` écartées). */
+    protected readonly resolvedErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
+    protected readonly displayedErrors: _angular_core.Signal<_ktortu_aaa_forms.KtFieldError[]>;
     protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
     protected readonly describedBy: _angular_core.Signal<string | null>;
     private readonly comparator;
     /** L'`optionValue` d'un enfant correspond-il à la sélection courante ? (lu dans le `computed` enfant) */
     isSelected(radioValue: V): boolean;
+    /** Focus l'option pertinente (utilisé par Signal Forms `focusBoundControl`) : le radio coché
+        s'il existe, sinon le premier radio activable — conforme au roving tabindex natif. */
+    focus(options?: FocusOptions): void;
     /** Commit d'une sélection émis par un enfant au `change` natif. */
     select(radioValue: V): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtRadioGroup<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtRadioGroup<any>, "kt-radio-group", 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; }; "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; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtRadioGroup<any>, "kt-radio-group", 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; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touched": "touchedChange"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -734,13 +915,18 @@ type KtKeyish<T, R> = keyof T | ((item: T) => R);
       ou la clé extraite quand `optionValue` est fourni). */
 declare abstract class KtBaseSelect<T, V = T> {
     protected readonly fieldConfig: Partial<_ktortu_aaa_forms.KtFieldConfig> | null;
+    private readonly errorResolver;
     protected readonly config: Partial<_ktortu_aaa_forms.KtSelectConfigOptions> | null;
     protected readonly host: ElementRef<HTMLElement>;
-    private readonly ngZone;
     protected readonly doc: Document;
     private readonly platformId;
     private readonly destroyRef;
+    private readonly bodyScrollLock;
     private wasExpanded;
+    private scrollLocked;
+    /** Pose/relâche le verrou de scroll du fond de façon idempotente (n'agit qu'à la transition),
+        via le compteur partagé `KtBodyScrollLock` — deux sheets ouvertes ne se désynchronisent pas. */
+    private setBodyScrollLock;
     /** Liste des options affichées (source de vérité du contrôle). */
     readonly options: _angular_core.InputSignal<readonly T[]>;
     /** Libellé affiché d'une option : clé OU fonction. Défaut : `label`/`name`, sinon `String(option)`. */
@@ -767,6 +953,8 @@ declare abstract class KtBaseSelect<T, V = T> {
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Le champ a-t-il été modifié depuis sa valeur initiale ? Poussé par `[formField]`. @default false */
     readonly dirty: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Validation asynchrone en cours (poussé par `[field]`) : pose `aria-busy` + `data-pending`. @default false */
+    readonly pending: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Erreurs de validation à afficher. Poussé par `[formField]`. @default [] */
     readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
     /** Attribut `name` logique du contrôle (à titre indicatif). @default '' */
@@ -839,10 +1027,7 @@ declare abstract class KtBaseSelect<T, V = T> {
     protected readonly resolvedFilterResultsText: Signal<(count: number) => string>;
     protected readonly resolvedTruncatedResultsText: Signal<(max: number, total: number) => string>;
     protected readonly resolvedTruncatedResultsAnnouncement: Signal<(max: number, total: number) => string>;
-    protected readonly fieldErrors: Signal<{
-        kind: string;
-        message: string | undefined;
-    }[]>;
+    protected readonly fieldErrors: Signal<_ktortu_aaa_forms.KtFieldError[]>;
     private readonly labelAccessor;
     private readonly valueAccessor;
     private readonly disabledAccessor;
@@ -886,6 +1071,11 @@ declare abstract class KtBaseSelect<T, V = T> {
         re-pousse rien (`listboxValue` n'a pas changé) — on resynchronise le modèle du Listbox
         avec les clés sélectionnées actuellement visibles. */
     protected resyncListboxSelection(): void;
+    /** Focus le trigger natif (utilisé par Signal Forms `focusBoundControl`). */
+    focus(options?: FocusOptions): void;
+    /** Referme le panneau et vide le filtre (utilisé par Signal Forms `reset`). La sélection du
+        listbox dérive de `value()` (computed) et se resynchronise seule. */
+    reset(): void;
     /** Desktop filtrable : le focus DOM vit dans le popup (champ/options) — on le rend au trigger
         à la fermeture, sinon il tombe sur `<body>`. (Écran compact : déjà géré par l'effect `compact`.) */
     protected refocusTriggerAfterFilterClose(): void;
@@ -895,7 +1085,7 @@ declare abstract class KtBaseSelect<T, V = T> {
     protected onDragStart(event: PointerEvent): void;
     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; }; "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; }; "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; }; "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`). */
@@ -1343,7 +1533,6 @@ declare class KtChipList<T> implements ChipTransitionScope {
     private readonly doc;
     private readonly platformId;
     private readonly cdr;
-    private readonly ngZone;
     /** Vrai pendant la View Transition de CETTE liste : les chips (standards via Chip,
         custom via tokens.css) ne portent leur `view-transition-name` que dans cette fenêtre. */
     readonly transitioning: _angular_core.WritableSignal<boolean>;
@@ -1383,6 +1572,13 @@ declare class KtChipList<T> implements ChipTransitionScope {
     }>;
     protected readonly itemDef: _angular_core.Signal<KtChipItemDef<any> | undefined>;
     private readonly chips;
+    private static readonly CHIP_FOCUSABLES;
+    private static readonly ROVING_FOCUSABLES;
+    private query;
+    /** Index de l'unique focusable portant `tabindex="0"` : point d'entrée clavier UNIQUE dans la
+        liste (pattern composite WAI-ARIA). Les flèches/Home/End le déplacent ; un focus direct
+        (souris) le resynchronise via `onFocusin`. */
+    protected readonly activeIndex: _angular_core.WritableSignal<number>;
     protected readonly resolvedListLabel: _angular_core.Signal<string>;
     private readonly resolvedRemoveItemLabel;
     private readonly resolvedItemRemovedText;
@@ -1423,6 +1619,8 @@ declare class KtChipList<T> implements ChipTransitionScope {
     /** Déplie/replie ; au dépliage, focus sur le premier chip nouvellement révélé. */
     protected toggleExpanded(): void;
     protected onKeydown(event: KeyboardEvent): void;
+    /** Resynchronise le point de tabulation unique sur l'élément réellement focusé (souris/voix). */
+    protected onFocusin(event: FocusEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KtChipList<any>, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KtChipList<any>, "kt-chip-list", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "itemLabel": { "alias": "itemLabel"; "required": false; "isSignal": true; }; "itemKey": { "alias": "itemKey"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "maxVisible": { "alias": "maxVisible"; "required": false; "isSignal": true; }; "listLabel": { "alias": "listLabel"; "required": false; "isSignal": true; }; "removeItemLabel": { "alias": "removeItemLabel"; "required": false; "isSignal": true; }; "itemRemovedText": { "alias": "itemRemovedText"; "required": false; "isSignal": true; }; "moreLabel": { "alias": "moreLabel"; "required": false; "isSignal": true; }; "lessLabel": { "alias": "lessLabel"; "required": false; "isSignal": true; }; "chipTemplate": { "alias": "chipTemplate"; "required": false; "isSignal": true; }; "emptyFocusTarget": { "alias": "emptyFocusTarget"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, ["itemDef"], never, true, never>;
 }
@@ -1483,6 +1681,12 @@ declare abstract class KtBaseTemporalField<T extends {
     /** Sérialise la valeur au format attendu par l'input natif (précision adaptée au type). */
     protected abstract serialize(value: T): string;
     protected parse(raw: string): T | null;
+    protected displayValue(): string;
+    /** Efface AUSSI l'input natif. L'effet de synchro ignore une mise à `null` quand l'input est
+        focalisé (pour ne pas écraser une saisie partielle en cours), or `clear()` focalise justement
+        le champ — sans ce forçage, le bouton « effacer » (et Échap) resterait sans effet sur les
+        champs temporels. */
+    protected clear(): void;
     protected emptyValue(): T | null;
     protected isEmpty(value: T | null): boolean;
     /** Borne minimale autorisée (membre `min` du contrat `FormValueControl`, aussi posé en attribut
@@ -1555,6 +1759,10 @@ declare abstract class KtBaseTimeTemporalField<T extends {
  * suffira de retirer le polyfill de `main.ts` : ce fichier ne change pas.
  */
 type TemporalImpl = (typeof temporal_polyfill)['Temporal'];
+/** Point d'accès `Temporal` de la lib. Proxy à résolution paresseuse : le namespace réel n'est lu
+    qu'au premier accès de propriété (`Temporal.PlainDate`…), jamais à l'import — ce qui supprime la
+    dépendance à l'ordre d'init des modules et fait booter Safari/WebKit tant que le polyfill est
+    importé dans `main.ts`. */
 declare const Temporal: TemporalImpl;
 
 /** Date civile (jour/mois/année), sans heure ni fuseau — alias de `Temporal.PlainDate`.
@@ -1757,5 +1965,5 @@ declare class KtFixedClock extends KtClock {
     today(): Temporal$1.PlainDate;
 }
 
-export { DEFAULT_KT_SELECT_CONFIG, KT_CHIPS_CONFIG, KT_FIELD, KT_FIELD_CONFIG, KT_SELECT_CONFIG, KtBaseInputField, KtBaseSelect, KtBaseTemporalField, KtBaseTimeTemporalField, KtCheckbox, KtCheckboxGroup, KtChip, KtChipItemDef, KtChipList, KtClock, KtDateField, KtDateTimeField, KtField, KtFieldControl, KtFixedClock, KtInstantField, KtMultiSelect, KtMultiSelectChipDef, KtMultiSelectOptionDef, KtMultiSelectTriggerDef, KtNumberField, KtRadio, KtRadioGroup, KtSelect, KtSelectConfig, KtSelectOptionDef, KtSelectTriggerDef, KtSwitch, KtTemporalDatePipe, KtTextArea, KtTextField, KtTimeField, KtYearMonthField, Temporal, defaultKtFieldErrorMatcher, normalizeKtSuggestions, provideKtField };
-export type { CalendarDate, KtChipItemContext, KtChipsConfig, KtDatalistOption, KtFieldAppearance, KtFieldConfig, KtFieldError, KtFieldErrorMatcher, KtFieldErrorState, KtFieldParent, KtFloatLabel, KtKeyish, KtMultiSelectChipContext, KtMultiSelectOptionContext, KtMultiSelectSelectionChange, KtMultiSelectTriggerContext, KtSelectConfigOptions, KtSelectOptionContext, KtSelectSelectionChange, KtSelectTriggerContext, KtSuggestion, KtTextFieldType, KtTimePrecision, LocalDateTime, Timestamp, WallTime, ZonedTimestamp };
+export { DEFAULT_KT_SELECT_CONFIG, KT_CHIPS_CONFIG, KT_DEFAULT_FIELD_ERROR_MESSAGES, KT_FIELD, KT_FIELD_CONFIG, KT_SELECT_CONFIG, KtBaseInputField, KtBaseSelect, KtBaseTemporalField, KtBaseTimeTemporalField, KtCheckbox, KtCheckboxGroup, KtChip, KtChipItemDef, KtChipList, KtClock, KtDateField, KtDateTimeField, KtField, KtFieldControl, KtFieldErrorResolver, KtFixedClock, KtInstantField, KtMultiSelect, KtMultiSelectChipDef, KtMultiSelectOptionDef, KtMultiSelectTriggerDef, KtNumberField, KtPasswordField, KtRadio, KtRadioGroup, KtSelect, KtSelectConfig, KtSelectOptionDef, KtSelectTriggerDef, KtSwitch, KtTemporalDatePipe, KtTextArea, KtTextField, KtTimeField, KtYearMonthField, Temporal, defaultKtFieldErrorMatcher, ktErrorParam, normalizeKtSuggestions, provideKtField };
+export type { CalendarDate, KtChipItemContext, KtChipsConfig, KtDatalistOption, KtErrorMessageFactory, KtFieldAppearance, KtFieldConfig, KtFieldError, KtFieldErrorMatcher, KtFieldErrorMessages, KtFieldErrorState, KtFieldParent, KtFloatLabel, KtKeyish, KtMultiSelectChipContext, KtMultiSelectOptionContext, KtMultiSelectSelectionChange, KtMultiSelectTriggerContext, KtPasswordAutocomplete, KtResolvableError, KtSelectConfigOptions, KtSelectOptionContext, KtSelectSelectionChange, KtSelectTriggerContext, KtSuggestion, KtTextFieldType, KtTimePrecision, LocalDateTime, Timestamp, WallTime, ZonedTimestamp };