@ngneers/controls 0.0.1-next.1 → 0.0.1-next.2

package/types/ngneers-controls-otp.d.ts

@@ -179,6 +179,8 @@ declare class NgnOtp extends ValueControlBase<'otp', string | null> {
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -187,6 +189,18 @@ declare class NgnOtp extends ValueControlBase<'otp', string | null> {
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     /**
      * The number of character cells the code is split across.
@@ -229,6 +243,11 @@ declare class NgnOtp extends ValueControlBase<'otp', string | null> {
     protected onBeforeInput(index: number, event: InputEvent): void;
     protected onKeyDown(index: number, event: KeyboardEvent): void;
     protected onPaste(event: ClipboardEvent): void;
+    /**
+     * Mark touched once focus leaves the whole group — moving between cells keeps
+     * the host focused, so those intra-cell hops don't count as a blur.
+     */
+    protected onFocusOut(event: FocusEvent): void;
     /** Clears every cell (also serves a surrounding field's clear button). */
     clearValue(): boolean;
     private _setCell;

package/types/ngneers-controls-paginator.d.ts

@@ -202,6 +202,8 @@ declare class NgnPaginator extends NgnBase<'paginator'> {
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -210,15 +212,41 @@ declare class NgnPaginator extends NgnBase<'paginator'> {
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     /**
-     * Total number of items to paginate.
+     * Total number of items to paginate. Required in `'pages'` mode (drives the
+     * page count); ignored in `'compact'` mode.
      */
-    readonly totalItems: _angular_core.InputSignal<number>;
+    readonly totalItems: _angular_core.InputSignal<number | undefined>;
     /**
      * Number of items per page. If not set, the first value from {@link possiblePageSizes} is used.
      */
     readonly pageSize: _angular_core.ModelSignal<number | undefined>;
+    /**
+     * Layout mode.
+     * - `'pages'`: full paginator with numbered page buttons (needs {@link totalItems}).
+     * - `'compact'`: prev/next buttons only, no page indicators, no total required.
+     * @default 'pages'
+     */
+    readonly mode: _angular_core.InputSignal<"pages" | "compact">;
+    /**
+     * `'compact'` mode only: whether a next page exists. Disables the "next" button
+     * when `false`. Bind to a lazy data source's `hasMore`.
+     * @default true
+     */
+    readonly hasNext: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Possible page sizes to choose from.
      * @default [5, 10, 25, 50]
@@ -251,7 +279,7 @@ declare class NgnPaginator extends NgnBase<'paginator'> {
         [klass: string]: string;
     };
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnPaginator, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnPaginator, "ngn-paginator", never, { "totalItems": { "alias": "totalItems"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "possiblePageSizes": { "alias": "possiblePageSizes"; "required": false; "isSignal": true; }; "fixedPageSize": { "alias": "fixedPageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "value": "value"; "page": "pageChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnPaginator, "ngn-paginator", never, { "totalItems": { "alias": "totalItems"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "hasNext": { "alias": "hasNext"; "required": false; "isSignal": true; }; "possiblePageSizes": { "alias": "possiblePageSizes"; "required": false; "isSignal": true; }; "fixedPageSize": { "alias": "fixedPageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "value": "value"; "page": "pageChange"; }, never, never, true, never>;
 }
 
 export { NgnPaginator };

package/types/ngneers-controls-rating.d.ts

@@ -0,0 +1,69 @@
+import * as _ngneers_controls_custom_types from '@ngneers/controls-custom-types';
+import * as _iconify_types from '@iconify/types';
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as _ngneers_controls_api_ng from '@ngneers/controls/api/ng';
+import * as _ngneers_controls_themes from '@ngneers/controls-themes';
+import { ValueControlBase } from '@ngneers/controls/base';
+
+/** Context for a custom {@link NgnRating} symbol template. */
+interface RatingIndicatorContext {
+    /** Fill ratio for this symbol, 0..1. */
+    $implicit: number;
+    /** Zero-based symbol index. */
+    index: number;
+}
+declare abstract class RatingTemplates extends ValueControlBase<'rating', number | null> {
+    private readonly _userIndicatorTemplate;
+    /**
+     * Custom template for a single symbol. Receives the fill ratio (`$implicit`,
+     * 0..1) and `index`. Can also be set with an `<ng-template #indicator>`.
+     * When set, it replaces the default full/empty icon rendering per symbol.
+     */
+    readonly indicatorTemplate: _angular_core.InputSignal<TemplateRef<RatingIndicatorContext> | null>;
+    protected readonly resolvedIndicatorTemplate: _angular_core.Signal<TemplateRef<RatingIndicatorContext> | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RatingTemplates, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RatingTemplates, never, never, { "indicatorTemplate": { "alias": "indicatorTemplate"; "required": false; "isSignal": true; }; }, {}, ["_userIndicatorTemplate"], never, true, never>;
+}
+
+/**
+ * @category control
+ */
+declare class NgnRating extends RatingTemplates {
+    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"rating", ["root", "symbol", "full", "empty", "invalid", "readonly", "disabled"], readonly []>>;
+    private readonly _hover;
+    /** Number of symbols. @default 5 */
+    readonly count: _angular_core.InputSignal<number>;
+    /** The value increment; supports fractions (e.g. 0.5). @default 1 */
+    readonly step: _angular_core.InputSignal<number>;
+    /** The filled symbol icon. Falls back to a filled star ({@link https://tabler.io/icons}). */
+    readonly iconFull: _angular_core.InputSignal<_iconify_types.IconifyIcon | _ngneers_controls_custom_types.NgnIconEntry | undefined>;
+    /** The empty symbol icon. Falls back to an outline star. */
+    readonly iconEmpty: _angular_core.InputSignal<_iconify_types.IconifyIcon | _ngneers_controls_custom_types.NgnIconEntry | undefined>;
+    /** Clicking the current value clears the rating back to `null`. @default true */
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Accessible value text; overrides the numeric readout. */
+    readonly valueText: _angular_core.InputSignal<string | undefined>;
+    /** Function producing accessible value text from the value. */
+    readonly valueTextFn: _angular_core.InputSignal<((value: number) => string) | undefined>;
+    /** The value the UI should paint: hover preview when hovering, else the model value. */
+    protected readonly displayValue: _angular_core.Signal<number>;
+    /** Zero-based indices for the symbols. */
+    protected readonly symbols: _angular_core.Signal<number[]>;
+    protected readonly valueTextValue: _angular_core.Signal<string | null>;
+    /** Fill ratio 0..1 for symbol `index` given the current display value (hover ?? value). */
+    protected fillRatio(index: number): number;
+    protected onKeyDown(event: KeyboardEvent): void;
+    /** Pointer moved over symbol `index` at fractional `offset` (0..1 within the symbol). */
+    protected onPointerMove(event: PointerEvent, index: number): void;
+    protected clearHover(): void;
+    protected onClick(event: PointerEvent, index: number): void;
+    /** Resolve the stepped value for a pointer position within symbol `index`. */
+    private valueAt;
+    private clamp;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnRating, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnRating, "ngn-rating", never, { "count": { "alias": "count"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "iconFull": { "alias": "iconFull"; "required": false; "isSignal": true; }; "iconEmpty": { "alias": "iconEmpty"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "valueText": { "alias": "valueText"; "required": false; "isSignal": true; }; "valueTextFn": { "alias": "valueTextFn"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { NgnRating, RatingTemplates };
+export type { RatingIndicatorContext };

package/types/ngneers-controls-scroll-shadow.d.ts

@@ -3,9 +3,10 @@ import * as _ngneers_controls_api_ng from '@ngneers/controls/api/ng';
 import * as _ngneers_controls_themes from '@ngneers/controls-themes';
 
 declare class NgnScrollShadow {
-    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"scrollShadow", ["root", "scrolled-start", "scrolled-end", "scrolled-top", "scrolled-bottom"], readonly []>>;
+    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"scrollShadow", ["root", "scrolled-start", "scrolled-end", "scrolled-top", "scrolled-bottom", "overlay", "surface", "unstyled"], readonly []>>;
     private readonly _el;
     private readonly _injector;
+    private readonly _renderer;
     /**
      * Which scroll axis to track and add shadow classes for.
      * @default 'horizontal'
@@ -17,9 +18,17 @@ declare class NgnScrollShadow {
      * @default undefined
      */
     readonly scrollShadowTarget: _angular_core.InputSignal<HTMLElement | undefined>;
+    /**
+     * Suppress the built-in edge-shadow overlay's styling (the theme hides it). The overlay element
+     * is still injected but rendered inert, so it never disturbs the scroll container's layout.
+     * Set this when the consumer paints its own shadows off the `scrolled-*` classes — e.g. the
+     * table anchors them to its sticky-column edges, reusing the shared `--ngn-scroll-shadow-color`.
+     * @default false
+     */
+    readonly unstyled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnScrollShadow, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgnScrollShadow, "[ngnScrollShadow]", never, { "ngnScrollShadow": { "alias": "ngnScrollShadow"; "required": false; "isSignal": true; }; "scrollShadowTarget": { "alias": "scrollShadowTarget"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgnScrollShadow, "[ngnScrollShadow]", never, { "ngnScrollShadow": { "alias": "ngnScrollShadow"; "required": false; "isSignal": true; }; "scrollShadowTarget": { "alias": "scrollShadowTarget"; "required": false; "isSignal": true; }; "unstyled": { "alias": "ngnScrollShadowUnstyled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { NgnScrollShadow };

package/types/ngneers-controls-scroller.d.ts

@@ -48,6 +48,8 @@ declare class NgnScroller<T> extends ScrollerTemplates<T> {
     protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"scroller", ["root", "virtual", "item", "item-sticky"], readonly []>>;
     private readonly _el;
     private readonly _scrollAmount;
+    /** Remaining vertical scroll distance to the bottom (px). Proxied from the host scroll directive. */
+    readonly distanceFromEnd: _angular_core.Signal<number>;
     /**
      * The items to be displayed in the scroller.
      * This is a required input and should be an array of items of type {@link T}.
@@ -131,7 +133,7 @@ declare class NgnScroller<T> extends ScrollerTemplates<T> {
         index: number;
     }): unknown;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnScroller<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnScroller<any>, "ngn-scroller, [ngn-scroller]", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "fieldId": { "alias": "fieldId"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "virtualPadding": { "alias": "virtualPadding"; "required": false; "isSignal": true; }; "focusable": { "alias": "focusable"; "required": false; "isSignal": true; }; "fieldSticky": { "alias": "fieldSticky"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.NgnScrollAmount; inputs: { "ngnScrollAmountContainer": "scrollContainer"; }; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnScroller<any>, "ngn-scroller, [ngn-scroller]", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "fieldId": { "alias": "fieldId"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "virtualPadding": { "alias": "virtualPadding"; "required": false; "isSignal": true; }; "focusable": { "alias": "focusable"; "required": false; "isSignal": true; }; "fieldSticky": { "alias": "fieldSticky"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.NgnScrollAmount; inputs: { "ngnScrollAmountContainer": "scrollContainer"; }; outputs: {}; }]>;
 }
 
 declare class NgnScrollerItem implements AfterViewInit {

package/types/ngneers-controls-select.d.ts

@@ -109,7 +109,7 @@ type SelectFilterFn<T extends object> = FilterFn<NgnItem<T>>;
  */
 declare class NgnSelect<V, Editable extends boolean = false, Multiple extends boolean = false> extends SelectTemplates<V, Editable, Multiple> {
     readonly isFieldControl = true;
-    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
+    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "empty", "placeholder", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
         readonly class: "popover";
         readonly template: _ngneers_controls_themes.ControlTemplate<"popover", ["root", "content", "content-closing"], readonly []>;
     }, {
@@ -123,7 +123,7 @@ declare class NgnSelect<V, Editable extends boolean = false, Multiple extends bo
         }]>;
     }, {
         readonly class: "filter";
-        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
             readonly class: "input";
             readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
             readonly projected: true;
@@ -285,6 +285,8 @@ declare class NgnSelect<V, Editable extends boolean = false, Multiple extends bo
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -293,6 +295,18 @@ declare class NgnSelect<V, Editable extends boolean = false, Multiple extends bo
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     private readonly _popover;
     private readonly _field;
@@ -377,7 +391,17 @@ declare class NgnSelect<V, Editable extends boolean = false, Multiple extends bo
      * @default multiple()
      */
     readonly checkbox: _angular_core.InputSignal<boolean | undefined>;
+    /**
+     * Text shown in the trigger when no value is selected.
+     * @default undefined
+     */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
     protected readonly maybeCallback: typeof maybeCallback;
+    /**
+     * Whether the control holds no value. Drives the empty status class and lets a
+     * wrapping {@link NgnInputField} float its label. See {@link value}.
+     */
+    readonly empty: Signal<boolean>;
     private readonly _listbox;
     private _userChangedEditableInput;
     protected get anchorElement(): HTMLElement;
@@ -405,7 +429,7 @@ declare class NgnSelect<V, Editable extends boolean = false, Multiple extends bo
     protected onEditableChange(value: string | null): void;
     protected potentiallyBlurred(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnSelect<any, any, any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnSelect<any, any, any>, "ngn-select", never, { "popoverOptions": { "alias": "popoverOptions"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterText": { "alias": "filterText"; "required": false; "isSignal": true; }; "iconFilter": { "alias": "iconFilter"; "required": false; "isSignal": true; }; "iconDropdown": { "alias": "iconDropdown"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "editableAutoFilter": { "alias": "editableAutoFilter"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "scrollToSelectedItemOnOpen": { "alias": "scrollToSelectedItemOnOpen"; "required": false; "isSignal": true; }; "tabindex": { "alias": "tabindex"; "required": false; "isSignal": true; }; "checkbox": { "alias": "checkbox"; "required": false; "isSignal": true; }; }, {}, ["_customEditableInput"], ["[ngnInput]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnSelect<any, any, any>, "ngn-select", never, { "popoverOptions": { "alias": "popoverOptions"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterText": { "alias": "filterText"; "required": false; "isSignal": true; }; "iconFilter": { "alias": "iconFilter"; "required": false; "isSignal": true; }; "iconDropdown": { "alias": "iconDropdown"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "editableAutoFilter": { "alias": "editableAutoFilter"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "scrollToSelectedItemOnOpen": { "alias": "scrollToSelectedItemOnOpen"; "required": false; "isSignal": true; }; "tabindex": { "alias": "tabindex"; "required": false; "isSignal": true; }; "checkbox": { "alias": "checkbox"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, {}, ["_customEditableInput"], ["[ngnInput]"], true, never>;
 }
 
 export { NgnSelect };

package/types/ngneers-controls-snackbar.d.ts

@@ -224,6 +224,8 @@ declare class NgnSnackbar extends SnackbarTemplates implements OnInit {
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -232,6 +234,18 @@ declare class NgnSnackbar extends SnackbarTemplates implements OnInit {
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     private readonly _host;
     /** Heading text shown at the top of the snackbar. Overridden by {@link templateHeader}. */

package/types/ngneers-controls-splitter.d.ts

@@ -336,6 +336,8 @@ declare class NgnSplitter extends NgnBase<'splitter'> implements OnDestroy {
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -344,6 +346,18 @@ declare class NgnSplitter extends NgnBase<'splitter'> implements OnDestroy {
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     /**
      * The layout of the splitter.

package/types/ngneers-controls-state.d.ts

@@ -75,7 +75,7 @@ declare class NgnState extends NgnBase<'state'> {
         readonly projected: true;
     }, {
         readonly class: "input-field";
-        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
             readonly class: "input";
             readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
             readonly projected: true;
@@ -83,7 +83,7 @@ declare class NgnState extends NgnBase<'state'> {
         readonly projected: true;
     }]>>;
     protected readonly icon: _angular_core.Signal<_iconify_types.IconifyIcon | _ngneers_controls_custom_types.NgnIconEntry | undefined>;
-    protected readonly defaultIcon: _angular_core.Signal<"accordion-collapse" | "accordion-expand" | "breadcrumb-separator" | "breadcrumb-overflow" | "calendar-trigger" | "calendar-previous-month" | "calendar-next-month" | "checkbox-checked" | "checkbox-indeterminate" | "chip-remove" | "dialog-close" | "drawer-close" | "dropdown-toggle" | "edit-confirm" | "filter-active" | "filter-inactive" | "filter-remove" | "hint-info" | "hint-success" | "hint-warning" | "hint-error" | "input-clear" | "menu-submenu" | "paginator-previous" | "paginator-next" | "search" | "sort-neutral" | "sort-ascending" | "sort-descending" | "spin-decrement" | "spin-increment" | "table-group-toggle" | "tabs-scroll-left" | "tabs-scroll-right" | "toast-close" | "snackbar-close" | "upload-trigger" | "upload-done" | "upload-failed" | "upload-retry" | "upload-cancel" | "upload-remove" | undefined>;
+    protected readonly defaultIcon: _angular_core.Signal<"accordion-collapse" | "accordion-expand" | "breadcrumb-separator" | "breadcrumb-overflow" | "calendar-trigger" | "calendar-previous-month" | "calendar-next-month" | "checkbox-checked" | "checkbox-indeterminate" | "chip-remove" | "dialog-close" | "drawer-close" | "dropdown-toggle" | "edit-confirm" | "filter-active" | "filter-inactive" | "filter-remove" | "hint-info" | "hint-success" | "hint-warning" | "hint-error" | "input-clear" | "menu-submenu" | "paginator-previous" | "paginator-next" | "rating-full" | "rating-empty" | "search" | "sort-neutral" | "sort-ascending" | "sort-descending" | "spin-decrement" | "spin-increment" | "stepper-completed" | "table-group-toggle" | "tabs-scroll-left" | "tabs-scroll-right" | "toast-close" | "snackbar-close" | "upload-trigger" | "upload-done" | "upload-failed" | "upload-retry" | "upload-cancel" | "upload-remove" | undefined>;
     /**
      * Accessible label for the current state: the explicit {@link label} input,
      * else a localized default for the applied kind. `undefined` when the

package/types/ngneers-controls-stepper.d.ts

@@ -0,0 +1,68 @@
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as _ngneers_controls_api_ng from '@ngneers/controls/api/ng';
+import * as _ngneers_controls_themes from '@ngneers/controls-themes';
+import { NgnBase } from '@ngneers/controls/base';
+import * as _ngneers_controls_custom_types from '@ngneers/controls-custom-types';
+import * as _iconify_types from '@iconify/types';
+
+/**
+ * A single step within an `ngn-stepper`. Declares the step's header metadata and
+ * projects its content via `<ng-template #content>`.
+ * @category control
+ */
+declare class NgnStep extends NgnBase<'stepper'> {
+    protected readonly theme: null;
+    /** The step's header label. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Custom marker icon; when unset the 1-based step number is shown. */
+    readonly iconStep: _angular_core.InputSignal<_iconify_types.IconifyIcon | _ngneers_controls_custom_types.NgnIconEntry | undefined>;
+    /** Marks the step optional (shown as a hint; skippable in linear mode). @default false */
+    readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Disables navigation to this step. @default false */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Renders the step's marker in an error state. @default false */
+    readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Whether the step is complete. The app sets this; in linear mode it gates
+     * forward navigation past this step. @default false
+     */
+    readonly completed: _angular_core.ModelSignal<boolean>;
+    readonly content: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnStep, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnStep, "ngn-step", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "iconStep": { "alias": "iconStep"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "completed": { "alias": "completed"; "required": false; "isSignal": true; }; }, { "completed": "completedChange"; }, ["content"], never, true, never>;
+}
+
+/**
+ * @category control
+ */
+declare class NgnStepper extends NgnBase<'stepper'> {
+    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"stepper", ["root", "header", "step", "marker", "marker-index", "marker-icon", "connector", "label", "optional", "content", "active", "completed", "error", "disabled"], readonly []>>;
+    protected readonly steps: _angular_core.Signal<readonly NgnStep[]>;
+    /** The header buttons' roving items, in step order (one per step; connectors are plain spans). */
+    private readonly _rovingItems;
+    /** The active step index (zero-based). @default 0 */
+    readonly active: _angular_core.ModelSignal<number>;
+    /** Gate forward navigation on prior steps being `completed`. @default false */
+    readonly linear: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Lazily render step content (forwarded to `ngn-defer`). @default true */
+    readonly lazy: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Keep opened step content in the DOM to preserve state (forwarded to `ngn-defer`). @default true */
+    readonly cache: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Index of the first step that is not yet completed (the furthest reachable in linear mode).
+     * Optional steps are exempt — an incomplete optional step never blocks forward progress.
+     */
+    private readonly _firstIncomplete;
+    constructor();
+    /** Whether navigation to `index` is currently permitted. */
+    canGoTo(index: number): boolean;
+    goTo(index: number): void;
+    next(): void;
+    previous(): void;
+    protected onHeaderActivate(index: number): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnStepper, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnStepper, "ngn-stepper", never, { "active": { "alias": "active"; "required": false; "isSignal": true; }; "linear": { "alias": "linear"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "cache": { "alias": "cache"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; }, ["steps"], never, true, never>;
+}
+
+export { NgnStep, NgnStepper };