@akcelik/strct 1.11.0 → 1.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "1.11.0",
+  "version": "1.13.0",
   "description": "UIStruct — a standalone Angular component library with a tokenised, multi-palette theme system, built for datacenter / infrastructure management UIs.",
   "author": "Serkan Akcelik <serkan.akcelik@gmail.com>",
   "license": "MIT",

package/types/akcelik-strct.d.ts

@@ -330,9 +330,17 @@ declare class StrctIcon {
     private readonly sanitizer;
     /**
      * Icon name. Typed to autocomplete the built-in set while still accepting
-     * any string, since `registerStrctIcon` can add names at runtime.
+     * any string, since `registerStrctIcon` can add names at runtime. For a
+     * compile-time guarantee use `strictName` instead.
      */
     readonly name: _angular_core.InputSignal<StrctIconName | (string & {})>;
+    /**
+     * Strict alternative to `name`: typed as the bare `StrctIconName` union, so
+     * a mistyped built-in name is a BUILD error under strict templates —
+     * `strictName="sheildCheck"` fails to compile. Wins over `name` when both
+     * are set. Use `name` for runtime-registered custom icons.
+     */
+    readonly strictName: _angular_core.InputSignal<StrctIconName | null>;
     /** Icon size in pixels. */
     readonly size: _angular_core.InputSignal<number>;
     /** Stroke width for outline icons. */
@@ -341,12 +349,14 @@ declare class StrctIcon {
     readonly badge: _angular_core.InputSignal<StrctIconBadge>;
     /** Accessible label for the icon. When empty the icon is hidden from assistive tech. */
     readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** The effective name: `strictName` wins when set. */
+    protected readonly iconName: _angular_core.Signal<StrctIconName | (string & {})>;
     /** True when the named icon is a full-SVG (raw) icon registered by the app. */
     protected readonly isRaw: _angular_core.Signal<boolean>;
     protected readonly svg: _angular_core.Signal<SafeHtml>;
     protected readonly rawSvg: _angular_core.Signal<SafeHtml>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctIcon, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctIcon, "strct-icon", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctIcon, "strct-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "strictName": { "alias": "strictName"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** Overlay positioning strategies. */
@@ -2063,11 +2073,24 @@ declare class StrctInputOtp implements ControlValueAccessor {
     readonly length: _angular_core.InputSignal<number>;
     /** Mask each box as a password dot. */
     readonly masked: _angular_core.InputSignal<boolean>;
+    /**
+     * Focus box 0 on first render — the "second-factor step just appeared"
+     * case, declaratively.
+     */
+    readonly autofocus: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Insert a visual separator every N boxes (0 = none): `groupSize=3` renders
+     * `nnn – nnn`, mirroring how authenticator apps display the code.
+     */
+    readonly groupSize: _angular_core.InputSignal<number>;
     readonly slots: _angular_core.WritableSignal<string[]>;
     readonly isDisabled: _angular_core.WritableSignal<boolean>;
     protected readonly indices: _angular_core.Signal<number[]>;
     private onChange;
     private onTouched;
+    constructor();
+    /** Move the caret to a box — e.g. back to 0 after clearing a rejected code. */
+    focus(index?: number): void;
     onInput(i: number, event: Event): void;
     onKeydown(i: number, event: KeyboardEvent): void;
     onPaste(event: ClipboardEvent): void;
@@ -2079,7 +2102,7 @@ declare class StrctInputOtp implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctInputOtp, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctInputOtp, "strct-input-otp", never, { "length": { "alias": "length"; "required": false; "isSignal": true; }; "masked": { "alias": "masked"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctInputOtp, "strct-input-otp", never, { "length": { "alias": "length"; "required": false; "isSignal": true; }; "masked": { "alias": "masked"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "groupSize": { "alias": "groupSize"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** Knob accent color variants. */
@@ -2702,6 +2725,13 @@ declare class StrctDatagrid {
     readonly quickFilterFields: _angular_core.InputSignal<string[] | null>;
     /** Render the built-in quick-filter searchbox in the toolbar. */
     readonly quickFilterable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Where the built-in box sits in the toolbar. `'end'` (default) follows the
+     * console convention: action verbs lead on the left, view controls sit at
+     * the far right — and the box keeps a stable position across grids whose
+     * button sets differ.
+     */
+    readonly quickFilterAlign: _angular_core.InputSignal<"end" | "start">;
     /**
      * Tree-grid: the row property holding a row's children array. Rows render
      * hierarchically with indent + carets; sorting applies per sibling level;
@@ -2799,6 +2829,14 @@ declare class StrctDatagrid {
     protected startEdit(row: StrctRow, col: StrctDatagridColumn): void;
     protected commitEdit(row: StrctRow, col: StrctDatagridColumn, event: Event): void;
     protected cancelEdit(event?: Event): void;
+    /**
+     * `singleLine` reveal: hovering a cell whose content is actually clipped
+     * gets the full text as a native `title`. Hover-lazy (one delegated
+     * listener, zero render cost — virtual grids pay nothing for unhovered
+     * cells), covers plain and `strctCell`-templated cells alike via
+     * `textContent`, and self-corrects after a column resize.
+     */
+    protected revealIfClipped(event: Event): void;
     /** Active (non-empty) filter entries. */
     private readonly activeFilters;
     private readonly quickTerm;
@@ -2886,7 +2924,7 @@ declare class StrctDatagrid {
     private commitSelection;
     private compare;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDatagrid, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDatagrid, "strct-datagrid", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "detailPane": { "alias": "detailPane"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "singleLine": { "alias": "singleLine"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; "columnChooser": { "alias": "columnChooser"; "required": false; "isSignal": true; }; "sync": { "alias": "sync"; "required": false; "isSignal": true; }; "footerActionsDisabled": { "alias": "footerActionsDisabled"; "required": false; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "initialSelection": { "alias": "initialSelection"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "viewportHeight": { "alias": "viewportHeight"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "stateKey": { "alias": "stateKey"; "required": false; "isSignal": true; }; "columnState": { "alias": "columnState"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "groupBy": { "alias": "groupBy"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "quickFilter": { "alias": "quickFilter"; "required": false; "isSignal": true; }; "quickFilterFields": { "alias": "quickFilterFields"; "required": false; "isSignal": true; }; "quickFilterable": { "alias": "quickFilterable"; "required": false; "isSignal": true; }; "childrenKey": { "alias": "childrenKey"; "required": false; "isSignal": true; }; }, { "columnState": "columnStateChange"; "filters": "filtersChange"; "quickFilter": "quickFilterChange"; "selectionChange": "selectionChange"; "syncChange": "syncChange"; "rowAction": "rowAction"; "lazyLoad": "lazyLoad"; "cellEdit": "cellEdit"; }, ["detailDef", "actionBarDef", "cellDefs"], ["[strctDatagridActionBar]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDatagrid, "strct-datagrid", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "detailPane": { "alias": "detailPane"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "singleLine": { "alias": "singleLine"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; "columnChooser": { "alias": "columnChooser"; "required": false; "isSignal": true; }; "sync": { "alias": "sync"; "required": false; "isSignal": true; }; "footerActionsDisabled": { "alias": "footerActionsDisabled"; "required": false; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "initialSelection": { "alias": "initialSelection"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "viewportHeight": { "alias": "viewportHeight"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "stateKey": { "alias": "stateKey"; "required": false; "isSignal": true; }; "columnState": { "alias": "columnState"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "groupBy": { "alias": "groupBy"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "quickFilter": { "alias": "quickFilter"; "required": false; "isSignal": true; }; "quickFilterFields": { "alias": "quickFilterFields"; "required": false; "isSignal": true; }; "quickFilterable": { "alias": "quickFilterable"; "required": false; "isSignal": true; }; "quickFilterAlign": { "alias": "quickFilterAlign"; "required": false; "isSignal": true; }; "childrenKey": { "alias": "childrenKey"; "required": false; "isSignal": true; }; }, { "columnState": "columnStateChange"; "filters": "filtersChange"; "quickFilter": "quickFilterChange"; "selectionChange": "selectionChange"; "syncChange": "syncChange"; "rowAction": "rowAction"; "lazyLoad": "lazyLoad"; "cellEdit": "cellEdit"; }, ["detailDef", "actionBarDef", "cellDefs"], ["[strctDatagridActionBar]"], true, never>;
 }
 
 /** Timeline node state colors. */