@akcelik/strct 4.15.0 → 4.17.0

package/package.json

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

@@ -824,6 +824,17 @@ type StrctAvatarStatus = 'none' | 'online' | 'busy' | 'offline';
  *   <strct-avatar name="Ada Lovelace" status="online" />
  */
 declare class StrctAvatar {
+    /**
+     * An icon instead of initials — a group, an assistant, a brand mark. An
+     * `src` image still wins.
+     */
+    readonly icon: _angular_core.InputSignal<string>;
+    /** `square` for a thing rather than a person (a group, an app). */
+    readonly shape: _angular_core.InputSignal<"circle" | "square">;
+    /** Surface tone. `neutral` keeps the default grey tile. */
+    readonly tone: _angular_core.InputSignal<StrctStatus | "accent-soft">;
+    /** The icon scales with the avatar. */
+    protected readonly iconSize: _angular_core.Signal<22 | 13 | 17>;
     /** Image URL. */
     readonly src: _angular_core.InputSignal<string>;
     /** Display name (used for initials when src is absent). */
@@ -834,7 +845,7 @@ declare class StrctAvatar {
     readonly status: _angular_core.InputSignal<StrctAvatarStatus>;
     protected readonly initials: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctAvatar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctAvatar, "strct-avatar", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctAvatar, "strct-avatar", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** Progress bar color variants. `neutral` is the quiet one: queued, idle, unknown. */
@@ -1402,6 +1413,10 @@ declare class StrctTree {
      * with taller rows for touch-friendly or low-density consoles.
      */
     readonly density: _angular_core.InputSignal<"compact" | "comfortable">;
+    /** A bordered surface around the tree — for a picker inside a dialog. */
+    readonly framed: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Caps the height in px; the tree scrolls inside its frame. */
+    readonly maxHeight: _angular_core.InputSignal<number | null>;
     /** Per-node right-click menu resolver. */
     readonly nodeMenu: _angular_core.InputSignal<StrctTreeNodeMenuFn | null>;
     /**
@@ -1521,7 +1536,7 @@ declare class StrctTree {
     /** Toggle a node's expansion, updating state and emitting outputs. */
     toggleNode(node: StrctTreeNodeData): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctTree, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTree, "strct-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "nodeMenu": { "alias": "nodeMenu"; "required": false; "isSignal": true; }; "canDrag": { "alias": "canDrag"; "required": false; "isSignal": true; }; "canDrop": { "alias": "canDrop"; "required": false; "isSignal": true; }; "dragExpandDelay": { "alias": "dragExpandDelay"; "required": false; "isSignal": true; }; "chevronAriaLabel": { "alias": "chevronAriaLabel"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; }, { "nodeDrop": "nodeDrop"; "nodeActivated": "nodeActivated"; "nodeMenuSelect": "nodeMenuSelect"; "expandedIds": "expandedIdsChange"; "expandedChange": "expandedChange"; "nodeToggled": "nodeToggled"; }, ["projectedNodes"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTree, "strct-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "framed": { "alias": "framed"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "nodeMenu": { "alias": "nodeMenu"; "required": false; "isSignal": true; }; "canDrag": { "alias": "canDrag"; "required": false; "isSignal": true; }; "canDrop": { "alias": "canDrop"; "required": false; "isSignal": true; }; "dragExpandDelay": { "alias": "dragExpandDelay"; "required": false; "isSignal": true; }; "chevronAriaLabel": { "alias": "chevronAriaLabel"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; }, { "nodeDrop": "nodeDrop"; "nodeActivated": "nodeActivated"; "nodeMenuSelect": "nodeMenuSelect"; "expandedIds": "expandedIdsChange"; "expandedChange": "expandedChange"; "nodeToggled": "nodeToggled"; }, ["projectedNodes"], ["*"], true, never>;
 }
 
 /** Fixed modal width presets: sm 480 · md 640 · lg 860 · xl 1080 (px). */
@@ -3517,8 +3532,12 @@ interface StrctDescItem {
     /** Dim the value (secondary information). */
     muted?: boolean;
 }
-/** Value alignment for the stacked (non-inline) layout. */
-type StrctDescAlign = 'between' | 'start';
+/**
+ * Value alignment for the stacked (non-inline) layout. `grid` gives the list
+ * one label column sized to its longest label, so every value starts on the
+ * same vertical line — what a hand-built `auto 1fr` grid is usually for.
+ */
+type StrctDescAlign = 'between' | 'start' | 'grid';
 /**
  * Compact definition list: aligned `label : value` rows with an optional trailing
  * slot. The `inline` variant is the horizontal "stat strip" (label-value pairs in
@@ -3541,8 +3560,10 @@ declare class StrctDescriptionList {
     readonly inline: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Value alignment in stacked mode. */
     readonly align: _angular_core.InputSignal<StrctDescAlign>;
+    /** Fixes the label column of `align="grid"` (e.g. `'160px'`). */
+    readonly labelWidth: _angular_core.InputSignal<string | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDescriptionList, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDescriptionList, "strct-description-list", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDescriptionList, "strct-description-list", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "labelWidth": { "alias": "labelWidth"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 /**
  * One projected `label → value` row inside a `<strct-description-list>`. The
@@ -3555,8 +3576,16 @@ declare class StrctDesc {
     readonly mono: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Dim the projected value. */
     readonly muted: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** A status dot before the label — "Agent · connected". */
+    readonly status: _angular_core.InputSignal<StrctStatus | null>;
+    /** Accessible text for that dot; empty falls back to the per-status default. */
+    readonly statusLabel: _angular_core.InputSignal<string>;
+    /** A leading icon before the label. */
+    readonly icon: _angular_core.InputSignal<string>;
+    /** A quiet second line under the value — "last seen 12 s ago". */
+    readonly note: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDesc, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDesc, "strct-desc", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "mono": { "alias": "mono"; "required": false; "isSignal": true; }; "muted": { "alias": "muted"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDesc, "strct-desc", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "mono": { "alias": "mono"; "required": false; "isSignal": true; }; "muted": { "alias": "muted"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "statusLabel": { "alias": "statusLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "note": { "alias": "note"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 /** Column definition for the table. */
@@ -3650,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);
@@ -3692,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[]>;
@@ -3807,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>;
     /**
@@ -3846,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
@@ -4036,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. */
@@ -4203,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. */