@akcelik/strct 4.16.0 → 4.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "4.16.0",
+  "version": "4.17.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

@@ -3679,6 +3679,10 @@ interface StrctDatagridLabels {
     editCell: string;
     toggleChildren: string;
     quickFilter: string;
+    /** `paging="more"`: the button that asks for the next slice. */
+    loadMore: string;
+    /** `paging="more"`: what the footer says it is showing. */
+    showing: (shown: number, total?: number) => string;
 }
 /** Resolves a stable identity for a row: a property key, or a function. */
 type StrctRowId = string | ((row: StrctRow) => unknown);
@@ -3721,6 +3725,17 @@ interface StrctDatagridColumn {
     editorMin?: number;
     editorMax?: number;
     editorStep?: number;
+    /** The look of a cell is column metadata, not a cell template. */
+    mono?: boolean;
+    muted?: boolean;
+    /** Aligns to the end with tabular figures — a counter reads as a column. */
+    numeric?: boolean;
+    /** Shown in `--t3` when the value is null / undefined / '' (default: blank). */
+    emptyText?: string;
+    /** Read as the value by assistive tech in place of `emptyText`'s glyph. */
+    emptyLabel?: string;
+    /** A quiet second line in the cell, from `row[descriptionKey]`. */
+    descriptionKey?: string;
 }
 /** Per-column filter state: contains-text, or the checked value set. */
 type StrctDatagridFilters = Record<string, string | unknown[]>;
@@ -3836,6 +3851,23 @@ declare class StrctDatagrid {
      * the control's description, following the `hint` convention.
      */
     readonly rowSelectable: _angular_core.InputSignal<((row: StrctRow) => boolean | string) | null>;
+    /** No outer border, radius or shadow — for a grid inside a bordered panel. */
+    readonly flush: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The grid's title, rendered above the header and used as its accessible name. */
+    readonly caption: _angular_core.InputSignal<string>;
+    /**
+     * `'more'` swaps the pager for a count and a Load more button — the shape a
+     * cursor API can answer. The consumer appends rows; the grid does not page.
+     */
+    readonly paging: _angular_core.InputSignal<"pages" | "more">;
+    /** Whether there is another slice to ask for. */
+    readonly hasMore: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** A slice is on its way: the button waits with a spinner. */
+    readonly loadingMore: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The grand total, when the API knows it — "Showing the latest 50 of 812". */
+    readonly moreTotal: _angular_core.InputSignal<number | null>;
+    /** The user asked for the next slice. */
+    readonly loadMore: _angular_core.OutputEmitterRef<void>;
     /** With `groupBy` and multiple selection: a tri-state checkbox per group. */
     readonly groupSelect: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
@@ -3875,6 +3907,8 @@ declare class StrctDatagrid {
         editCell: string;
         toggleChildren: string;
         quickFilter: string;
+        loadMore: string;
+        showing: (shown: number, total?: number) => string;
     }>;
     /**
      * Virtual scrolling for large data sets: only the rows inside the viewport
@@ -4065,6 +4099,9 @@ declare class StrctDatagrid {
     /** The value a typed editor holds while it is open (committed on Enter / blur). */
     protected readonly editDraft: _angular_core.WritableSignal<unknown>;
     protected startEdit(row: StrctRow, col: StrctDatagridColumn): void;
+    protected readonly captionId: string;
+    /** Whether a cell has nothing to show and the column says what to show then. */
+    protected isBlank(row: StrctRow, col: StrctDatagridColumn): boolean;
     /** A select column reads as its option's label, not as the stored value. */
     protected displayValue(row: StrctRow, col: StrctDatagridColumn): unknown;
     /** Close the editor and emit `cellEdit` when the value actually changed. */
@@ -4232,7 +4269,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; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "selectedId": { "alias": "selectedId"; "required": false; "isSignal": true; }; "rowSelectable": { "alias": "rowSelectable"; "required": false; "isSignal": true; }; "groupSelect": { "alias": "groupSelect"; "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; }; }, { "selectedId": "selectedIdChange"; "columnState": "columnStateChange"; "filters": "filtersChange"; "quickFilter": "quickFilterChange"; "selectionChange": "selectionChange"; "syncChange": "syncChange"; "rowAction": "rowAction"; "lazyLoad": "lazyLoad"; "cellEdit": "cellEdit"; }, ["detailDef", "actionBarDef", "cellDefs"], ["[strctDatagridActionBarCaption]", "[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; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "selectedId": { "alias": "selectedId"; "required": false; "isSignal": true; }; "rowSelectable": { "alias": "rowSelectable"; "required": false; "isSignal": true; }; "flush": { "alias": "flush"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "paging": { "alias": "paging"; "required": false; "isSignal": true; }; "hasMore": { "alias": "hasMore"; "required": false; "isSignal": true; }; "loadingMore": { "alias": "loadingMore"; "required": false; "isSignal": true; }; "moreTotal": { "alias": "moreTotal"; "required": false; "isSignal": true; }; "groupSelect": { "alias": "groupSelect"; "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; }; }, { "selectedId": "selectedIdChange"; "loadMore": "loadMore"; "columnState": "columnStateChange"; "filters": "filtersChange"; "quickFilter": "quickFilterChange"; "selectionChange": "selectionChange"; "syncChange": "syncChange"; "rowAction": "rowAction"; "lazyLoad": "lazyLoad"; "cellEdit": "cellEdit"; }, ["detailDef", "actionBarDef", "cellDefs"], ["[strctDatagridActionBarCaption]", "[strctDatagridActionBar]"], true, never>;
 }
 
 /** Timeline node state colors. */