@mk-kit/ui 0.42.0 → 0.44.0

package/types/mk-kit-ui-forms.d.ts

@@ -1,5 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { OnDestroy, Signal, ElementRef, TemplateRef, OnInit } from '@angular/core';
+import { Field } from '@angular/forms/signals';
 import * as _mk_kit_ui_core from '@mk-kit/ui/core';
 import { MkFieldContext, MkSize, MkVariant, MkTone, MkCodeLanguage, MkPlacement } from '@mk-kit/ui/core';
 export { MkCodeLanguage, mkHighlight } from '@mk-kit/ui/core';
@@ -29,6 +30,29 @@ export * from '@mk-kit/ui/checkbox';
  * is touched or dirty, or its form has been submitted; `errorOn` changes that.
  * `required` and the disabled styling are derived from the control too.
  *
+ * ## Signal Forms
+ *
+ * The same applies to a control bound with Signal Forms' `[formField]`
+ * directive (`@angular/forms/signals`): the field adopts the projected
+ * `FormField` binding and reads `touched()` / `dirty()` / `invalid()` /
+ * `errors()` / `required()` / `disabled()` from its `FieldState`. Errors
+ * written by the schema (`required(p.email)`, `minLength(p.name, 2)`, …) are
+ * rendered through the same `validation` i18n table, a `message` supplied to
+ * the schema rule wins over the table, and `errorMessages` / `errorOn` work
+ * unchanged. Calling `submit()` marks every field touched, so errors surface
+ * on a failed submit exactly as with `formControlName`. When the control is
+ * not projected (or lives deeper), point the field at it with `[field]`.
+ *
+ * ```html
+ * <mk-form-field label="Email">
+ *   <input mkInput type="email" [formField]="f.email" />
+ * </mk-form-field>
+ *
+ * <mk-form-field label="Country" [field]="f.country">
+ *   <mk-select [formField]="f.country" [options]="countries" />
+ * </mk-form-field>
+ * ```
+ *
  * ```html
  * <!-- automatic: message + required marker come from the validators -->
  * <mk-form-field label="Email">
@@ -90,9 +114,24 @@ declare class MkFormField implements MkFieldContext {
      * `formControl`; the placeholder stays hidden until the label has moved.
      */
     readonly labelPosition: _angular_core.InputSignal<"top" | "float">;
+    /**
+     * Signal Forms field to read state from explicitly (`[field]="f.email"`).
+     * Not needed when the projected control carries the `[formField]` binding —
+     * the wrapper finds that itself; set it when the control is nested deeper
+     * or when the wrapper should follow a field it does not contain.
+     */
+    readonly field: _angular_core.InputSignal<Field<unknown> | null>;
     private readonly host;
     /** The projected control's form binding, when it has one. */
     private readonly ngControl;
+    /** The projected control's Signal Forms `[formField]` binding, when it has one. */
+    private readonly signalField;
+    /**
+     * The Signal Forms field state driving this wrapper — the explicit `field`
+     * input first, else the projected `[formField]` binding. `undefined` for a
+     * reactive-forms / template-driven control.
+     */
+    private readonly fieldState;
     /** A control inside the field has focus. */
     protected readonly focused: _angular_core.WritableSignal<boolean>;
     /** Last value read straight from a native control (fallback when no NgControl). */
@@ -136,7 +175,7 @@ declare class MkFormField implements MkFieldContext {
      */
     readonly describedBy: _angular_core.Signal<string | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkFormField, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkFormField, "mk-form-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "errorOn": { "alias": "errorOn"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; }, {}, ["ngControl"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkFormField, "mk-form-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "errorOn": { "alias": "errorOn"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "field": { "alias": "field"; "required": false; "isSignal": true; }; }, {}, ["ngControl", "signalField"], ["*"], true, never>;
 }
 
 /** One field-level error to surface in {@link MkFormErrorSummary}. */
@@ -170,6 +209,24 @@ interface MkFormError {
  * `formControlName` must be a static attribute (`formControlName="email"`,
  * the usual form) rather than a binding.
  *
+ * ## Signal Forms
+ *
+ * Point `field` at a Signal Forms root (`[field]="f"`) instead of `form` and
+ * the summary reads `errorSummary()` from the `FieldTree`: one entry per
+ * invalid field, keyed by dotted path in `labels` / `errorMessages` like the
+ * reactive path. With the default `showOn="submit"` an entry appears once its
+ * field is touched — `submit()` marks every field touched, so a failed submit
+ * lists them all. Clicking an entry focuses the control bound with
+ * `[formField]`. When the summary sits inside the `<form>`, focus also moves
+ * to it after the form's `submit` event, as with `ngSubmit`.
+ *
+ * ```html
+ * <form (submit)="save($event)">
+ *   <mk-form-error-summary [field]="f" [labels]="{ email: 'Email address' }" />
+ *   …
+ * </form>
+ * ```
+ *
  * ```html
  * <!-- automatic -->
  * <form [formGroup]="form" (ngSubmit)="submit()">
@@ -197,12 +254,17 @@ declare class MkFormErrorSummary {
     readonly errors: _angular_core.InputSignal<readonly MkFormError[]>;
     /** Collect errors from this control tree instead of passing them in. */
     readonly form: _angular_core.InputSignal<AbstractControl<any, any, any> | null>;
+    /**
+     * Collect errors from this Signal Forms field (usually the root returned by
+     * `form()`) instead of `form`. Entries are keyed by dotted path for `labels`.
+     */
+    readonly field: _angular_core.InputSignal<Field<unknown> | null>;
     /** Field names for automatic entries, keyed by control path. */
     readonly labels: _angular_core.InputSignal<Readonly<Record<string, string>>>;
     /** Per-key wording for automatic entries, as on `mk-form-field`. */
     readonly errorMessages: _angular_core.InputSignal<Readonly<Record<string, string | ((err: any) => string)>> | null>;
     /** When automatic entries appear. Defaults to after the form is submitted. */
-    readonly showOn: _angular_core.InputSignal<"always" | "submit">;
+    readonly showOn: _angular_core.InputSignal<"submit" | "always">;
     /** Heading shown above the list. */
     readonly summaryTitle: _angular_core.InputSignal<string>;
     /**
@@ -217,6 +279,12 @@ declare class MkFormErrorSummary {
     constructor();
     /** Whether the surrounding form (if any) has been submitted. */
     private readonly submitted;
+    /**
+     * Entries collected from `field` (a Signal Forms root), each with the element
+     * carrying the field's `[formField]` binding so a click can focus it the way
+     * `focusBoundControl()` would.
+     */
+    private readonly signalEntries;
     /** Entries collected from `form`, when one is set and they should show. */
     private readonly autoErrors;
     /** The entries actually rendered — an explicit `errors` list wins. */
@@ -235,7 +303,7 @@ declare class MkFormErrorSummary {
      */
     private fieldIdFor;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkFormErrorSummary, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkFormErrorSummary, "mk-form-error-summary", ["mkFormErrorSummary"], { "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "showOn": { "alias": "showOn"; "required": false; "isSignal": true; }; "summaryTitle": { "alias": "summaryTitle"; "required": false; "isSignal": true; }; "autoFocus": { "alias": "autoFocus"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkFormErrorSummary, "mk-form-error-summary", ["mkFormErrorSummary"], { "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "field": { "alias": "field"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "showOn": { "alias": "showOn"; "required": false; "isSignal": true; }; "summaryTitle": { "alias": "summaryTitle"; "required": false; "isSignal": true; }; "autoFocus": { "alias": "autoFocus"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -261,6 +329,8 @@ declare class MkFormErrorSummary {
  */
 declare class MkInput implements ControlValueAccessor {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     private readonly group;
     private readonly host;
     private readonly initialId;
@@ -381,6 +451,8 @@ declare class MkInputGroup {
  */
 declare class MkSubmitInput implements ControlValueAccessor {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly inputRef;
@@ -565,6 +637,8 @@ interface MkSelectOption {
  */
 declare class MkSelect implements ControlValueAccessor, OnDestroy {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly triggerRef;
@@ -578,6 +652,8 @@ declare class MkSelect implements ControlValueAccessor, OnDestroy {
     readonly size: _angular_core.InputSignal<MkSize>;
     /** Force invalid styling + `aria-invalid` when used standalone. */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mark required (adds `aria-required`). Set by Signal Forms' `[formField]` from the schema. */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Disable the control. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Two-way selected value. */
@@ -617,7 +693,7 @@ declare class MkSelect implements ControlValueAccessor, OnDestroy {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkSelect, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkSelect, "mk-select", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkSelect, "mk-select", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 /** One row of an `mk-listbox`. */
@@ -665,6 +741,8 @@ type Row = {
  */
 declare class MkListbox implements ControlValueAccessor, OnDestroy {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly listRef;
     /** The rows to choose from. */
@@ -773,6 +851,8 @@ interface MkCascaderOption {
  */
 declare class MkCascader implements ControlValueAccessor, OnDestroy {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly host;
     private readonly injector;
@@ -906,6 +986,8 @@ type MkAutocompleteFilterMode = 'contains' | 'startsWith' | 'none';
  */
 declare class MkAutocomplete implements ControlValueAccessor {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly announcer;
@@ -923,6 +1005,8 @@ declare class MkAutocomplete implements ControlValueAccessor {
     readonly size: _angular_core.InputSignal<MkSize>;
     /** Force invalid styling + `aria-invalid` when used standalone. */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mark required (adds `aria-required`). Set by Signal Forms' `[formField]` from the schema. */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Disable the control. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** How the option list is filtered against the typed text. */
@@ -984,7 +1068,7 @@ declare class MkAutocomplete implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkAutocomplete, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkAutocomplete, "mk-autocomplete", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "minChars": { "alias": "minChars"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "requireSelection": { "alias": "requireSelection"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "search": "search"; "optionSelected": "optionSelected"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkAutocomplete, "mk-autocomplete", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "minChars": { "alias": "minChars"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "requireSelection": { "alias": "requireSelection"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "search": "search"; "optionSelected": "optionSelected"; }, never, never, true, never>;
 }
 
 /** How mention suggestions are narrowed against the typed query. */
@@ -1199,6 +1283,8 @@ type MkMultiSelectFilterMode = 'contains' | 'startsWith' | 'none';
  */
 declare class MkMultiSelect implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     private readonly host;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
@@ -1214,6 +1300,8 @@ declare class MkMultiSelect implements ControlValueAccessor, Validator {
     readonly size: _angular_core.InputSignal<MkSize>;
     /** Force invalid styling + `aria-invalid` when used standalone. */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mark required (adds `aria-required`). Set by Signal Forms' `[formField]` from the schema. */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Disable the control. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** How the option list is filtered against the typed text. */
@@ -1305,7 +1393,7 @@ declare class MkMultiSelect implements ControlValueAccessor, Validator {
     validate(control: AbstractControl): ValidationErrors | null;
     registerOnValidatorChange(fn: () => void): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkMultiSelect, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkMultiSelect, "mk-multi-select", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "minChars": { "alias": "minChars"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "closeOnSelect": { "alias": "closeOnSelect"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "search": "search"; "optionAdded": "optionAdded"; "optionRemoved": "optionRemoved"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkMultiSelect, "mk-multi-select", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "minChars": { "alias": "minChars"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "closeOnSelect": { "alias": "closeOnSelect"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "search": "search"; "optionAdded": "optionAdded"; "optionRemoved": "optionRemoved"; }, never, never, true, never>;
 }
 
 /**
@@ -1321,6 +1409,8 @@ declare class MkMultiSelect implements ControlValueAccessor, Validator {
  */
 declare class MkTagInput implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly announcer;
     private readonly host;
@@ -1343,6 +1433,8 @@ declare class MkTagInput implements ControlValueAccessor, Validator {
     readonly separators: _angular_core.InputSignal<readonly string[]>;
     /** Force invalid styling + `aria-invalid` when used standalone. */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mark required (adds `aria-required`). Set by Signal Forms' `[formField]` from the schema. */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Disable the control. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Control size. Ignored when nested in an `mk-form-field`. */
@@ -1395,7 +1487,7 @@ declare class MkTagInput implements ControlValueAccessor, Validator {
     validate(control: AbstractControl): ValidationErrors | null;
     registerOnValidatorChange(fn: () => void): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkTagInput, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkTagInput, "mk-tag-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "addOnBlur": { "alias": "addOnBlur"; "required": false; "isSignal": true; }; "separators": { "alias": "separators"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "added": "added"; "removed": "removed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkTagInput, "mk-tag-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "addOnBlur": { "alias": "addOnBlur"; "required": false; "isSignal": true; }; "separators": { "alias": "separators"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "added": "added"; "removed": "removed"; }, never, never, true, never>;
 }
 
 /** A single password rule with its current pass/fail state. */
@@ -1416,6 +1508,8 @@ interface MkPasswordRule {
  */
 declare class MkPasswordInput implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly inputRef;
     /** Two-way value. */
@@ -1522,6 +1616,8 @@ type MkTransferSide = 'available' | 'selected';
 declare class MkTransferList implements ControlValueAccessor {
     private readonly host;
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly announcer;
     private readonly injector;
@@ -1785,6 +1881,8 @@ declare class MkRepeater<T = unknown> implements ControlValueAccessor {
  */
 declare class MkTreeSelect implements ControlValueAccessor {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly host;
     private readonly injector;
@@ -2100,6 +2198,8 @@ declare class MkCodeEditor implements ControlValueAccessor, OnDestroy {
     protected readonly describedBy: _angular_core.Signal<string | null>;
     /** Parse error for JSON content, or `null` when valid / empty / plaintext. */
     protected readonly jsonError: _angular_core.Signal<string | null>;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly isInvalid: _angular_core.Signal<boolean>;
     /** `aria-describedby` merging the field's ids with the JSON error id. */
     protected readonly ariaDescribedBy: _angular_core.Signal<string | null>;
@@ -2156,6 +2256,8 @@ declare class MkCodeEditor implements ControlValueAccessor, OnDestroy {
  */
 declare class MkRating implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     /** Number of stars. */
     readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
@@ -2222,14 +2324,16 @@ declare class MkRating implements ControlValueAccessor, Validator {
  */
 declare class MkNumberInput implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly inputRef;
     /** Minimum value. */
     /** Accessible name when the control is used without an `mk-form-field` label. */
     readonly ariaLabel: _angular_core.InputSignal<string>;
-    readonly min: _angular_core.InputSignal<number | null>;
+    readonly min: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
     /** Maximum value. */
-    readonly max: _angular_core.InputSignal<number | null>;
+    readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
     /** Step increment for buttons + Arrow keys. */
     readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
     /** Two-way value. */
@@ -2240,6 +2344,8 @@ declare class MkNumberInput implements ControlValueAccessor, Validator {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Force invalid styling when standalone. */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mark required (adds `aria-required`). Set by Signal Forms' `[formField]` from the schema. */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Control size. Ignored inside an `mk-form-field`. */
     readonly size: _angular_core.InputSignal<MkSize>;
     protected readonly inputId: string;
@@ -2274,7 +2380,7 @@ declare class MkNumberInput implements ControlValueAccessor, Validator {
     validate(control: AbstractControl): ValidationErrors | null;
     registerOnValidatorChange(fn: () => void): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkNumberInput, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkNumberInput, "mk-number-input", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkNumberInput, "mk-number-input", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 type MkNumericKeypadMode = 'pin' | 'quantity' | 'amount';
@@ -2314,9 +2420,9 @@ declare class MkNumericKeypad implements ControlValueAccessor, Validator {
     /** PIN length (`pin` mode only). Reaching it emits `submit`. */
     readonly length: _angular_core.InputSignalWithTransform<number, unknown>;
     /** Lower bound reported through the validator (`quantity`/`amount`). */
-    readonly min: _angular_core.InputSignal<number | null>;
+    readonly min: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
     /** Upper bound reported through the validator (`quantity`/`amount`). */
-    readonly max: _angular_core.InputSignal<number | null>;
+    readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
     /** Mask the echo row in `pin` mode. Default `true`. */
     readonly mask: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Show the echo row above the keys. Default `true`. */
@@ -2508,6 +2614,8 @@ declare class MkOnScreenKeyboardTrigger {
  */
 declare class MkOtp implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly cells;
     /** Number of character boxes. */
@@ -2634,6 +2742,8 @@ interface CountryOption {
  */
 declare class MkPhoneInput implements ControlValueAccessor {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly triggerRef;
@@ -2775,6 +2885,8 @@ declare function mkPostalCodeValidator(country: string, formats?: readonly MkPos
  */
 declare class MkPostalCodeInput implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     /** ISO 3166-1 alpha-2 country whose format applies. */
@@ -2867,6 +2979,8 @@ interface LocaleInfo {
  */
 declare class MkCurrencyInput implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     /** ISO 4217 currency code (`PLN`, `USD`, …). Empty = plain decimal. */
@@ -2878,9 +2992,9 @@ declare class MkCurrencyInput implements ControlValueAccessor, Validator {
     /** Max fraction digits; defaults to the currency's convention (else 2). */
     readonly decimals: _angular_core.InputSignal<number | null>;
     /** Clamp the value to at least this on blur. */
-    readonly min: _angular_core.InputSignal<number | null>;
+    readonly min: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
     /** Clamp the value to at most this on blur. */
-    readonly max: _angular_core.InputSignal<number | null>;
+    readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
     /** Allow a leading minus sign. */
     readonly allowNegative: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Control size. Ignored when nested in an `mk-form-field`. */
@@ -2969,6 +3083,8 @@ declare function mkLuhnCheck(digits: string): boolean;
  */
 declare class MkCardNumberInput implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     /** Show the detected brand as a badge inside the field. */
@@ -3068,6 +3184,8 @@ declare function mkIbanValidator(): ValidatorFn;
  */
 declare class MkIbanInput implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     /** Control size. Ignored when nested in an `mk-form-field`. */
@@ -3195,6 +3313,8 @@ declare function mkTaxIdValidator(country: string): ValidatorFn;
  */
 declare class MkTaxIdInput implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     /** ISO 3166-1 alpha-2 country whose format applies. */
@@ -3277,6 +3397,8 @@ declare class MkTaxIdInput implements ControlValueAccessor, Validator {
 declare class MkSignaturePad implements ControlValueAccessor, OnDestroy {
     private readonly host;
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     private readonly isBrowser;
     /** Localised strings (override globally via `provideMkI18n`). */
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
@@ -3422,6 +3544,8 @@ declare class MkButtonToggleGroup implements ControlValueAccessor {
     private readonly host;
     /** Optional surrounding form field — supplies label/hint/error wiring. */
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Live list of projected toggle items, in DOM order. */
     readonly toggles: _angular_core.Signal<readonly MkButtonToggle[]>;
     /** Allow selecting any number of items (toolbar of `aria-pressed` buttons). */
@@ -3526,6 +3650,8 @@ declare class MkRadio implements OnInit, OnDestroy {
 declare class MkRadioGroup implements ControlValueAccessor, Validator {
     private readonly host;
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Two-way selected value. */
     readonly value: _angular_core.ModelSignal<unknown>;
     /** Disable the whole group. */
@@ -3597,12 +3723,16 @@ declare class MkRadioGroup implements ControlValueAccessor, Validator {
  */
 declare class MkSwitch implements ControlValueAccessor {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Two-way checked (on/off) state. */
     readonly checked: _angular_core.ModelSignal<boolean>;
     /** Disable the control. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Force the invalid visual + `aria-invalid` when used standalone. */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mark required (adds `aria-required`). Set by Signal Forms' `[formField]` from the schema. */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Control size. */
     readonly size: _angular_core.InputSignal<MkSize>;
     /** Semantic color tone for the "on" track. */
@@ -3625,7 +3755,7 @@ declare class MkSwitch implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkSwitch, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkSwitch, "mk-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkSwitch, "mk-switch", never, { "checked": { "alias": "checked"; "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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -3642,6 +3772,8 @@ declare class MkSwitch implements ControlValueAccessor {
  */
 declare class MkSlider implements ControlValueAccessor, Validator, OnDestroy {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     private readonly trackRef;
     private readonly thumbRef;
     /** Minimum value. */
@@ -3654,6 +3786,8 @@ declare class MkSlider implements ControlValueAccessor, Validator, OnDestroy {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Force the invalid visual + `aria-invalid` when used standalone. */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mark required (adds `aria-required`). Set by Signal Forms' `[formField]` from the schema. */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Control size (track/thumb thickness). */
     readonly size: _angular_core.InputSignal<MkSize>;
     /** Semantic color tone for the filled track + thumb. */
@@ -3707,7 +3841,7 @@ declare class MkSlider implements ControlValueAccessor, Validator, OnDestroy {
     validate(control: AbstractControl): ValidationErrors | null;
     registerOnValidatorChange(fn: () => void): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkSlider, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkSlider, "mk-slider", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkSlider, "mk-slider", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 /**
@@ -3721,6 +3855,8 @@ declare class MkSlider implements ControlValueAccessor, Validator, OnDestroy {
  */
 declare class MkColorPicker implements ControlValueAccessor {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly nativeRef;
     /** Two-way hex color value. */
@@ -3780,6 +3916,8 @@ type MkRange = [number, number];
 declare class MkRangeSlider implements ControlValueAccessor, Validator, OnDestroy {
     private readonly host;
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly trackRef;
     private readonly thumbRefs;