@mk-kit/ui 0.35.0 → 0.37.0

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

@@ -543,13 +543,53 @@ declare class MkDialog {
     readonly titleId: _angular_core.InputSignal<string>;
     /** Hide the header close button. */
     readonly hideClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Let the user move the dialog by dragging its header (pointer / touch) or
+     * with the arrow keys on the grip that appears in the header. Double-click
+     * the header or press Home on the grip to snap back to the centre.
+     */
+    readonly draggable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Let the user resize the dialog from the corner grip (pointer / touch, or
+     * arrow keys on the grip; Home resets). The panel never grows past the
+     * viewport or shrinks below a usable minimum.
+     */
+    readonly resizable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly destroyRef;
+    /** The body-level overlay panel this dialog lives in (`null` when inline). */
+    private panelEl;
+    /** Current drag offset from the centred position, px. */
+    private offset;
     constructor();
     /** Close the surrounding overlay, if any. */
     protected close(): void;
+    /** Snap back to the centred, preset-sized panel. */
+    reset(): void;
+    protected onHeaderPointerDown(event: PointerEvent): void;
+    protected onGripPointerDown(event: PointerEvent): void;
+    protected onResizerPointerDown(event: PointerEvent): void;
+    protected onHeaderDoubleClick(event: MouseEvent): void;
+    protected onGripKeydown(event: KeyboardEvent): void;
+    protected onResizerKeydown(event: KeyboardEvent): void;
+    private static arrowDelta;
+    private startPointer;
+    /** Move the panel to `(x, y)` px from its centred spot, kept inside the viewport. */
+    private moveTo;
+    /** Resize the panel to `w × h` px within [minimum, viewport]. */
+    private resizeTo;
+    /**
+     * Once the user takes hold, the entrance animation must never run again —
+     * toggling `animation` back on (as a transient class would) restarts it,
+     * so the panel would blink after every drag. The class is never removed.
+     */
+    private markMoved;
+    private clampIntoView;
+    private isRtl;
+    private panel;
     /** Point the owning dialog panel's `aria-labelledby` at the title element. */
     private wireLabelledBy;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkDialog, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkDialog, "mk-dialog", never, { "dialogTitle": { "alias": "dialogTitle"; "required": false; "isSignal": true; }; "titleId": { "alias": "titleId"; "required": false; "isSignal": true; }; "hideClose": { "alias": "hideClose"; "required": false; "isSignal": true; }; }, {}, never, ["[mkDialogHeader], mk-dialog-title", "*", "[mkDialogFooter]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkDialog, "mk-dialog", never, { "dialogTitle": { "alias": "dialogTitle"; "required": false; "isSignal": true; }; "titleId": { "alias": "titleId"; "required": false; "isSignal": true; }; "hideClose": { "alias": "hideClose"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; }, {}, never, ["[mkDialogHeader], mk-dialog-title", "*", "[mkDialogFooter]"], true, never>;
 }
 
 /** Data contract for {@link MkConfirmDialog} / `MkDialogService.confirm`. */
@@ -1266,5 +1306,74 @@ declare class MkTourService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MkTourService>;
 }
 
-export { MK_TOUR_DATA, MkAlert, MkBanner, MkBottomSheet, MkBottomSheetService, MkConfirmDialog, MkDialog, MkDialogService, MkDialogTitle, MkHovercard, MkHovercardTrigger, MkLoadingBar, MkLoadingBarService, MkNotificationCenter, MkPopconfirm, MkPopconfirmTrigger, MkPopover, MkPopoverTrigger, MkPromptDialog, MkResult, MkSnackbar, MkSnackbarContainer, MkSnackbarRef, MkSnackbarService, MkToast, MkToastContainer, MkToastService, MkTooltip, MkTooltipPanel, MkTourPopup, MkTourService };
+/**
+ * The translucent panel with a spinner that `mkBlockUi` and
+ * `MkBlockUiService` drop over a region or the page.
+ */
+declare class MkBlockUiOverlay {
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    readonly message: _angular_core.WritableSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkBlockUiOverlay, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkBlockUiOverlay, "mk-block-ui-overlay", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Block UI — cover the host element with a translucent panel and spinner
+ * while something loads, so its contents can neither be read nor operated:
+ * a card refreshing, a form submitting, a table re-fetching.
+ *
+ * Children get `inert` (no clicks, no Tab stops) and the host `aria-busy`.
+ * `mkBlockUiDelay` (ms) holds the overlay back for quick operations so the
+ * screen does not flash.
+ *
+ * ```html
+ * <mk-card [mkBlockUi]="saving()" mkBlockUiMessage="Saving…">…</mk-card>
+ * <form [mkBlockUi]="submitting()" [mkBlockUiDelay]="300">…</form>
+ * ```
+ */
+declare class MkBlockUi {
+    private readonly host;
+    private readonly document;
+    private readonly injector;
+    private readonly appRef;
+    /** Block while `true`. */
+    readonly mkBlockUi: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Text under the spinner (also its accessible label). */
+    readonly mkBlockUiMessage: _angular_core.InputSignal<string>;
+    /** Wait this many ms before showing, to avoid a flash on fast operations. */
+    readonly mkBlockUiDelay: _angular_core.InputSignalWithTransform<number, unknown>;
+    private mounted;
+    private timer;
+    constructor();
+    private mount;
+    private unmount;
+    private cancelTimer;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkBlockUi, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MkBlockUi, "[mkBlockUi]", never, { "mkBlockUi": { "alias": "mkBlockUi"; "required": false; "isSignal": true; }; "mkBlockUiMessage": { "alias": "mkBlockUiMessage"; "required": false; "isSignal": true; }; "mkBlockUiDelay": { "alias": "mkBlockUiDelay"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * Block the whole page. Reference-counted: every `block()` returns a release
+ * function, and the overlay disappears once all of them have been called.
+ *
+ * ```ts
+ * const release = this.blockUi.block('Exporting…');
+ * try { await this.api.export(); } finally { release(); }
+ * ```
+ */
+declare class MkBlockUiService {
+    private readonly document;
+    private readonly injector;
+    private readonly appRef;
+    private mounted;
+    private readonly _count;
+    /** Number of active blocks. */
+    readonly count: _angular_core.Signal<number>;
+    /** Show the page overlay (or update its message); call the returned function to release. */
+    block(message?: string): () => void;
+    /** True while the page is blocked. */
+    isBlocked(): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkBlockUiService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MkBlockUiService>;
+}
+
+export { MK_TOUR_DATA, MkAlert, MkBanner, MkBlockUi, MkBlockUiOverlay, MkBlockUiService, MkBottomSheet, MkBottomSheetService, MkConfirmDialog, MkDialog, MkDialogService, MkDialogTitle, MkHovercard, MkHovercardTrigger, MkLoadingBar, MkLoadingBarService, MkNotificationCenter, MkPopconfirm, MkPopconfirmTrigger, MkPopover, MkPopoverTrigger, MkPromptDialog, MkResult, MkSnackbar, MkSnackbarContainer, MkSnackbarRef, MkSnackbarService, MkToast, MkToastContainer, MkToastService, MkTooltip, MkTooltipPanel, MkTourPopup, MkTourService };
 export type { MkAlertTone, MkAlertVariant, MkBottomSheetConfig, MkConfirmDialogData, MkDialogConfig, MkDialogSize, MkNotification, MkPromptDialogData, MkResultIconVariant, MkResultStatus, MkResultTone, MkSnackbarConfig, MkSnackbarDismissReason, MkSnackbarItem, MkSnackbarTone, MkToastAction, MkToastConfig, MkToastItem, MkToastTone, MkTourController, MkTourData, MkTourStep };

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

@@ -83,8 +83,24 @@ declare class MkFormField implements MkFieldContext {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Control size; nested controls inherit it. */
     readonly size: _angular_core.InputSignal<MkSize>;
+    /**
+     * Where the label sits: above the control (default), or `float` — inside
+     * the control, sliding up once it is focused or has a value. Floating works
+     * with `mkInput` / textarea and any control bound with `ngModel` or a
+     * `formControl`; the placeholder stays hidden until the label has moved.
+     */
+    readonly labelPosition: _angular_core.InputSignal<"top" | "float">;
+    private readonly host;
     /** The projected control's form binding, when it has one. */
     private readonly ngControl;
+    /** 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). */
+    private readonly domValue;
+    /** The field holds a non-empty value (drives the floating label). */
+    protected readonly hasValue: _angular_core.Signal<boolean>;
+    /** Track a native control's value for the floating label when nothing else reports it. */
+    protected readDomValue(target: EventTarget | null): void;
     /**
      * Bumped on every change of the bound control so the computed state below
      * re-reads it. `AbstractControl` is not signal-based, so this bridges its
@@ -120,7 +136,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; }; }, {}, ["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; }; }, {}, ["ngControl"], ["*"], true, never>;
 }
 
 /** One field-level error to surface in {@link MkFormErrorSummary}. */
@@ -602,6 +618,251 @@ declare class MkSelect implements ControlValueAccessor, OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkSelect, "mk-select", never, { "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>;
 }
 
+/** One row of an `mk-listbox`. */
+interface MkListboxOption {
+    /** Text shown (and matched by typeahead / the filter). */
+    label: string;
+    /** Value committed to the model when selected. */
+    value: unknown;
+    /** Secondary line under the label. */
+    description?: string;
+    /** Skipped by keyboard, not selectable. */
+    disabled?: boolean;
+    /** Options sharing a `group` render under one heading (keep them adjacent). */
+    group?: string;
+}
+/** A rendered row: either a group heading or an option with its index in the visible list. */
+type Row = {
+    kind: 'group';
+    label: string;
+    id: string;
+} | {
+    kind: 'option';
+    option: MkListboxOption;
+    index: number;
+};
+/**
+ * Listbox — a standalone, always-visible selection list (the ARIA `listbox`
+ * pattern) for one or many values: settings panes, "choose a template"
+ * pickers, side-by-side assignments, any place a dropdown would hide choices
+ * the user should see at once.
+ *
+ * Keyboard: Up / Down move, Home / End jump, PageUp / PageDown skip ten,
+ * type to jump to a label, Enter / Space select (toggle when `multiple`),
+ * Shift+Arrow / Shift+click extend a range, Ctrl/Cmd+A selects all. Focus
+ * stays on the list (`aria-activedescendant`). With `filterable`, a search
+ * box above the list narrows it by label or description.
+ *
+ * Implements `ControlValueAccessor` and a two-way `value` model — a single
+ * value, or an array when `multiple`.
+ *
+ * ```html
+ * <mk-listbox [options]="plans" [(value)]="plan" ariaLabel="Plan" />
+ * <mk-listbox multiple filterable [options]="people" [(ngModel)]="reviewers" />
+ * ```
+ */
+declare class MkListbox implements ControlValueAccessor, OnDestroy {
+    private readonly field;
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    private readonly listRef;
+    /** The rows to choose from. */
+    readonly options: _angular_core.InputSignal<readonly MkListboxOption[]>;
+    /** Allow several values; the model becomes an array. */
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Show a search box that narrows the list by label / description. */
+    readonly filterable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly filterPlaceholder: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Single-select only: moving with the arrow keys selects immediately
+     * (default `true`); `false` requires Enter / Space to commit.
+     */
+    readonly selectionFollowsFocus: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Control size. Ignored when nested in an `mk-form-field`. */
+    readonly size: _angular_core.InputSignal<MkSize>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Accessible name when there is no visible label / form field. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabelledby: _angular_core.InputSignal<string | undefined>;
+    /** Text shown when no option matches the filter. */
+    readonly emptyText: _angular_core.InputSignal<string | undefined>;
+    /** Two-way value: one value, or an array when `multiple`. */
+    readonly value: _angular_core.ModelSignal<unknown>;
+    /** Emitted after the user changes the selection (not on programmatic writes). */
+    readonly change: _angular_core.OutputEmitterRef<unknown>;
+    readonly listId: string;
+    protected readonly filterId: string;
+    protected readonly query: _angular_core.WritableSignal<string>;
+    protected readonly activeIndex: _angular_core.WritableSignal<number>;
+    private readonly cvaDisabled;
+    private onChange;
+    private onTouched;
+    private typeahead;
+    private typeaheadTimer?;
+    /** Range anchor for Shift selection (index in the visible list). */
+    private anchor;
+    protected readonly effectiveSize: _angular_core.Signal<MkSize>;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly isInvalid: _angular_core.Signal<boolean>;
+    protected readonly labelledBy: _angular_core.Signal<string | null>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    /** Options that match the filter, in source order. */
+    protected readonly visible: _angular_core.Signal<MkListboxOption[]>;
+    /** Visible options with group headings interleaved. */
+    protected readonly rows: _angular_core.Signal<Row[]>;
+    protected readonly selectedValues: _angular_core.Signal<unknown[]>;
+    protected readonly activeId: _angular_core.Signal<string | null>;
+    constructor();
+    protected optionId(index: number): string;
+    protected isSelected(option: MkListboxOption): boolean;
+    /** Focus the list. */
+    focus(): void;
+    protected onOptionClick(index: number, event: MouseEvent): void;
+    protected onFilterInput(event: Event): void;
+    protected onFilterKeydown(event: KeyboardEvent): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected onBlur(): void;
+    /** Move the active row by `delta` (wrapping for ±1), extending the selection with Shift. */
+    private step;
+    private jump;
+    private firstEnabled;
+    private lastEnabled;
+    private typeaheadSearch;
+    private commit;
+    /** Select every enabled option between two visible indexes (replacing, or adding to, the selection). */
+    private selectRange;
+    private selectAll;
+    private emit;
+    ngOnDestroy(): void;
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkListbox, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkListbox, "mk-listbox", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "filterable": { "alias": "filterable"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "selectionFollowsFocus": { "alias": "selectionFollowsFocus"; "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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "change": "change"; }, never, never, true, never>;
+}
+
+/** One node of a cascader: a leaf, or a parent with `children`. */
+interface MkCascaderOption {
+    label: string;
+    value: unknown;
+    children?: readonly MkCascaderOption[];
+    disabled?: boolean;
+}
+/**
+ * Cascader — a select whose choices are a hierarchy shown as side-by-side
+ * columns (region → country → city, category → subcategory, org unit → team).
+ * Each pick opens the next column; picking a leaf commits the whole path.
+ *
+ * The value is the **path** of option values (`['eu', 'pl', 'krk']`) by
+ * default, or just the leaf's value with `valueMode="leaf"`. Parents are only
+ * selectable with `selectParents` (a click on one then commits, and its
+ * children stay reachable).
+ *
+ * Keyboard: Up / Down move within a column, Right opens the children, Left
+ * goes back, Enter / Space selects, typing jumps to a label, Escape closes.
+ * `expandTrigger="hover"` opens columns on pointer hover as well as click.
+ *
+ * Implements `ControlValueAccessor` and a two-way `value` model.
+ *
+ * ```html
+ * <mk-cascader [options]="regions" [(value)]="location" placeholder="Where?" clearable />
+ * ```
+ */
+declare class MkCascader implements ControlValueAccessor, OnDestroy {
+    private readonly field;
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    private readonly host;
+    private readonly injector;
+    private readonly triggerRef;
+    private readonly panelRef;
+    /** The hierarchy to choose from. */
+    readonly options: _angular_core.InputSignal<readonly MkCascaderOption[]>;
+    /** Two-way value: the path of values (default) or the leaf value (`valueMode="leaf"`). */
+    readonly value: _angular_core.ModelSignal<unknown>;
+    /** Bind the full path of values (default) or only the chosen option's value. */
+    readonly valueMode: _angular_core.InputSignal<"path" | "leaf">;
+    /** Allow committing a parent option (click / Enter on it) instead of leaves only. */
+    readonly selectParents: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Open the next column on click (default) or also on pointer hover. */
+    readonly expandTrigger: _angular_core.InputSignal<"click" | "hover">;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Text between the labels of the chosen path. */
+    readonly separator: _angular_core.InputSignal<string>;
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Control size. Ignored when nested in an `mk-form-field`. */
+    readonly size: _angular_core.InputSignal<MkSize>;
+    /** Emitted after the user commits or clears a value. */
+    readonly change: _angular_core.OutputEmitterRef<unknown>;
+    readonly triggerId: string;
+    readonly panelId: string;
+    readonly valueId: string;
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    /** Row index highlighted in each open column, left to right. */
+    protected readonly activePath: _angular_core.WritableSignal<number[]>;
+    private readonly cvaDisabled;
+    private onChange;
+    private onTouched;
+    private typeahead;
+    private typeaheadTimer?;
+    protected readonly effectiveSize: _angular_core.Signal<MkSize>;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly isInvalid: _angular_core.Signal<boolean>;
+    protected readonly isRequired: _angular_core.Signal<boolean>;
+    protected readonly labelledBy: _angular_core.Signal<string | null>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    /** The options along the committed value, or `[]`. */
+    protected readonly selectedPath: _angular_core.Signal<MkCascaderOption[]>;
+    protected readonly displayLabel: _angular_core.Signal<string>;
+    /**
+     * Columns rendered in the panel: the root list, then the children of every
+     * opened parent along the active path. The last entry of the path is the
+     * cursor — resting on a parent does not open it (click, hover or → does).
+     */
+    protected readonly columns: _angular_core.Signal<readonly MkCascaderOption[][]>;
+    /** The column the keyboard cursor is in. */
+    private readonly cursorColumn;
+    protected readonly activeId: _angular_core.Signal<string | null>;
+    constructor();
+    protected optionId(column: number, row: number): string;
+    protected isOnPath(column: number, row: number): boolean;
+    protected isSelected(column: number, option: MkCascaderOption): boolean;
+    protected isCursor(column: number, row: number): boolean;
+    protected toggle(): void;
+    protected openPanel(): void;
+    protected close(restoreFocus?: boolean): void;
+    protected onTriggerKeydown(event: KeyboardEvent): void;
+    protected onFocusOut(event: FocusEvent): void;
+    protected onPanelFocusout(event: FocusEvent): void;
+    protected onOptionClick(column: number, row: number): void;
+    protected onOptionHover(column: number, row: number): void;
+    protected clear(event: Event): void;
+    protected onPanelKeydown(event: KeyboardEvent): void;
+    /** Point the cursor at `(column, row)`, trimming any deeper columns. */
+    private setCursor;
+    /** Open the children of `(column, row)` and move the cursor onto the first enabled one. */
+    private expand;
+    private stepRow;
+    private firstEnabled;
+    private lastEnabled;
+    private typeaheadSearch;
+    private commit;
+    private emit;
+    /** Row indexes of a path of options. */
+    private indexPath;
+    /** Depth-first search for the option whose value is `value` (leaf mode). */
+    private findPath;
+    ngOnDestroy(): void;
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkCascader, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkCascader, "mk-cascader", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueMode": { "alias": "valueMode"; "required": false; "isSignal": true; }; "selectParents": { "alias": "selectParents"; "required": false; "isSignal": true; }; "expandTrigger": { "alias": "expandTrigger"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "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"; "change": "change"; }, never, never, true, never>;
+}
+
 /** A single suggestion for {@link MkAutocomplete}. */
 interface MkAutocompleteOption {
     /** Text shown to the user and used as the input display value when chosen. */
@@ -3582,5 +3843,5 @@ declare class MkRangeSlider implements ControlValueAccessor, Validator, OnDestro
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkRangeSlider, "mk-range-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; }; "minLabel": { "alias": "minLabel"; "required": false; "isSignal": true; }; "maxLabel": { "alias": "maxLabel"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
-export { MK_CARD_BRAND_NAMES, MK_IBAN_LENGTHS, MK_KEYBOARD_LAYOUT_QWERTY_PL, MK_PHONE_COUNTRIES, MK_POSTAL_FORMATS, MK_TAX_ID_FORMATS, MkAutocomplete, MkButtonToggle, MkButtonToggleGroup, MkCardNumberInput, MkCodeEditor, MkColorPicker, MkCurrencyInput, MkFileUpload, MkFormErrorSummary, MkFormField, MkI18nInput, MkIbanInput, MkInput, MkInputGroup, MkMention, MkMentionPanel, MkMultiSelect, MkNumberInput, MkNumericKeypad, MkOnScreenKeyboard, MkOnScreenKeyboardTrigger, MkOtp, MkPasswordInput, MkPhoneInput, MkPostalCodeInput, MkRadio, MkRadioGroup, MkRangeSlider, MkRating, MkRepeater, MkRepeaterEmpty, MkRepeaterRow, MkSelect, MkSignaturePad, MkSlider, MkSubmitInput, MkSwitch, MkTagInput, MkTaxIdInput, MkTransferList, MkTreeSelect, mkCountryFlag, mkDetectCardBrand, mkIbanChecksum, mkIbanIsValid, mkIbanValidator, mkLuhnCheck, mkNipChecksum, mkPostalCodeValidator, mkPostalFormat, mkTaxIdFormat, mkTaxIdIsValid, mkTaxIdValidator };
-export type { MkAutocompleteFilterMode, MkAutocompleteOption, MkCardBrand, MkCodeValidity, MkFormError, MkI18nLocale, MkI18nValue, MkKeyboardActionKey, MkKeyboardKey, MkKeyboardLayout, MkMentionFilterMode, MkMentionOption, MkMentionSearchEvent, MkMentionSelectEvent, MkMultiSelectFilterMode, MkMultiSelectOption, MkNumericKeypadMode, MkOnScreenKeyboardTarget, MkPasswordRule, MkPhoneCountry, MkPhoneValue, MkPostalFormat, MkRange, MkRepeaterRowContext, MkSelectOption, MkTaxIdFormat, MkTransferItem, MkUploadFile, MkUploadFn, MkUploadRejection, MkUploadStatus, MkUploadValueFormat };
+export { MK_CARD_BRAND_NAMES, MK_IBAN_LENGTHS, MK_KEYBOARD_LAYOUT_QWERTY_PL, MK_PHONE_COUNTRIES, MK_POSTAL_FORMATS, MK_TAX_ID_FORMATS, MkAutocomplete, MkButtonToggle, MkButtonToggleGroup, MkCardNumberInput, MkCascader, MkCodeEditor, MkColorPicker, MkCurrencyInput, MkFileUpload, MkFormErrorSummary, MkFormField, MkI18nInput, MkIbanInput, MkInput, MkInputGroup, MkListbox, MkMention, MkMentionPanel, MkMultiSelect, MkNumberInput, MkNumericKeypad, MkOnScreenKeyboard, MkOnScreenKeyboardTrigger, MkOtp, MkPasswordInput, MkPhoneInput, MkPostalCodeInput, MkRadio, MkRadioGroup, MkRangeSlider, MkRating, MkRepeater, MkRepeaterEmpty, MkRepeaterRow, MkSelect, MkSignaturePad, MkSlider, MkSubmitInput, MkSwitch, MkTagInput, MkTaxIdInput, MkTransferList, MkTreeSelect, mkCountryFlag, mkDetectCardBrand, mkIbanChecksum, mkIbanIsValid, mkIbanValidator, mkLuhnCheck, mkNipChecksum, mkPostalCodeValidator, mkPostalFormat, mkTaxIdFormat, mkTaxIdIsValid, mkTaxIdValidator };
+export type { MkAutocompleteFilterMode, MkAutocompleteOption, MkCardBrand, MkCascaderOption, MkCodeValidity, MkFormError, MkI18nLocale, MkI18nValue, MkKeyboardActionKey, MkKeyboardKey, MkKeyboardLayout, MkListboxOption, MkMentionFilterMode, MkMentionOption, MkMentionSearchEvent, MkMentionSelectEvent, MkMultiSelectFilterMode, MkMultiSelectOption, MkNumericKeypadMode, MkOnScreenKeyboardTarget, MkPasswordRule, MkPhoneCountry, MkPhoneValue, MkPostalFormat, MkRange, MkRepeaterRowContext, MkSelectOption, MkTaxIdFormat, MkTransferItem, MkUploadFile, MkUploadFn, MkUploadRejection, MkUploadStatus, MkUploadValueFormat };

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

@@ -37,7 +37,8 @@ declare class MkIcon {
 
 /**
  * IconRegistry — the name → SVG store behind `<mk-icon name="…">`. The built-in
- * {@link MK_DEFAULT_ICONS} set is registered on construction; add your own SVGs
+ * sets — the hand-made {@link MK_DEFAULT_ICONS} and the Lucide-derived
+ * {@link MK_EXTENDED_ICONS} — are registered on construction; add your own SVGs
  * (from a sprite, a design export, anything) with {@link register} /
  * {@link registerIcons}.
  *
@@ -105,4 +106,7 @@ declare const MK_MATERIAL_ICON_ALIASES: Readonly<Record<string, string>>;
  */
 declare function provideMkMaterialIcons(): EnvironmentProviders;
 
-export { MK_DEFAULT_ICONS, MK_MATERIAL_ICON_ALIASES, MkIcon, MkIconRegistry, provideMkMaterialIcons };
+/** Name → SVG markup map of the Lucide-derived icons registered by default. */
+declare const MK_EXTENDED_ICONS: Readonly<Record<string, string>>;
+
+export { MK_DEFAULT_ICONS, MK_EXTENDED_ICONS, MK_MATERIAL_ICON_ALIASES, MkIcon, MkIconRegistry, provideMkMaterialIcons };