@akcelik/strct 1.10.2 → 1.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "1.10.2",
+  "version": "1.12.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. */
@@ -2489,6 +2499,7 @@ interface StrctDatagridLabels {
     clearFilter: string;
     editCell: string;
     toggleChildren: string;
+    quickFilter: string;
 }
 /** Resolves a stable identity for a row: a property key, or a function. */
 type StrctRowId = string | ((row: StrctRow) => unknown);
@@ -2531,6 +2542,8 @@ interface StrctDatagridLazyState {
     sortDir: SortDir;
     /** Active per-column filters (empty object when none). */
     filters: StrctDatagridFilters;
+    /** The global quick-filter term ('' when none). */
+    quickFilter: string;
 }
 /** Persistable user column preferences (widths from resize, hidden from the
  *  chooser, order from drag-reorder). */
@@ -2644,6 +2657,7 @@ declare class StrctDatagrid {
         clearFilter: string;
         editCell: string;
         toggleChildren: string;
+        quickFilter: string;
     }>;
     /**
      * Virtual scrolling for large data sets: only the rows inside the viewport
@@ -2687,6 +2701,17 @@ declare class StrctDatagrid {
      * mode it is passed through on `lazyLoad` instead.
      */
     readonly filters: _angular_core.ModelSignal<StrctDatagridFilters>;
+    /**
+     * Global quick filter (two-way): one term substring-matched (OR) across
+     * `quickFilterFields` — the console-standard "filter this list fast" box.
+     * Complementary to the per-column `filters` (which AND). Applied before
+     * paging client-side; passed through on `lazyLoad` in server mode.
+     */
+    readonly quickFilter: _angular_core.ModelSignal<string>;
+    /** Columns the quick term scans. Defaults to every column's `key`. */
+    readonly quickFilterFields: _angular_core.InputSignal<string[] | null>;
+    /** Render the built-in quick-filter searchbox in the toolbar. */
+    readonly quickFilterable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Tree-grid: the row property holding a row's children array. Rows render
      * hierarchically with indent + carets; sorting applies per sibling level;
@@ -2784,11 +2809,23 @@ 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;
+    private matchesQuick;
     private matchesFilters;
-    /** Rows surviving the per-column filters (client-side modes only). */
+    /** Rows surviving the quick + per-column filters (client-side modes only). */
     private readonly filteredRows;
+    /** "12 / 480" — shown while any client-side filtering narrows the set. */
+    protected readonly filterNote: _angular_core.Signal<string | null>;
     /** Tree mode: flattened visible rows + per-row depth/children/expanded meta. */
     private readonly treeFlat;
     protected readonly sorted: _angular_core.Signal<StrctRow[]>;
@@ -2867,7 +2904,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; }; "childrenKey": { "alias": "childrenKey"; "required": false; "isSignal": true; }; }, { "columnState": "columnStateChange"; "filters": "filtersChange"; "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; }; "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. */
@@ -3738,6 +3775,8 @@ declare class StrctTimeRangePicker {
     readonly presets: _angular_core.InputSignal<StrctTimeRangePreset[]>;
     /** Popover alignment, as in strct-dropdown. */
     readonly align: _angular_core.InputSignal<"end" | "start">;
+    /** Trigger size — match it to the toolbar's buttons (sm strips). */
+    readonly size: _angular_core.InputSignal<"md" | "sm">;
     /** Localizable strings. */
     readonly dialogLabel: _angular_core.InputSignal<string>;
     readonly quickLabel: _angular_core.InputSignal<string>;
@@ -3762,7 +3801,7 @@ declare class StrctTimeRangePicker {
     private toLocal;
     private formatStamp;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctTimeRangePicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTimeRangePicker, "strct-time-range", never, { "range": { "alias": "range"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "dialogLabel": { "alias": "dialogLabel"; "required": false; "isSignal": true; }; "quickLabel": { "alias": "quickLabel"; "required": false; "isSignal": true; }; "absoluteLabel": { "alias": "absoluteLabel"; "required": false; "isSignal": true; }; "fromLabel": { "alias": "fromLabel"; "required": false; "isSignal": true; }; "toLabel": { "alias": "toLabel"; "required": false; "isSignal": true; }; "applyLabel": { "alias": "applyLabel"; "required": false; "isSignal": true; }; "invalidLabel": { "alias": "invalidLabel"; "required": false; "isSignal": true; }; "placeholderLabel": { "alias": "placeholderLabel"; "required": false; "isSignal": true; }; }, { "range": "rangeChange"; "applied": "applied"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTimeRangePicker, "strct-time-range", never, { "range": { "alias": "range"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "dialogLabel": { "alias": "dialogLabel"; "required": false; "isSignal": true; }; "quickLabel": { "alias": "quickLabel"; "required": false; "isSignal": true; }; "absoluteLabel": { "alias": "absoluteLabel"; "required": false; "isSignal": true; }; "fromLabel": { "alias": "fromLabel"; "required": false; "isSignal": true; }; "toLabel": { "alias": "toLabel"; "required": false; "isSignal": true; }; "applyLabel": { "alias": "applyLabel"; "required": false; "isSignal": true; }; "invalidLabel": { "alias": "invalidLabel"; "required": false; "isSignal": true; }; "placeholderLabel": { "alias": "placeholderLabel"; "required": false; "isSignal": true; }; }, { "range": "rangeChange"; "applied": "applied"; }, never, never, true, never>;
 }
 
 /** A log line: plain text plus an optional severity for tinting. */