@akcelik/strct 4.4.1 → 4.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "4.4.1",
+  "version": "4.6.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/styles/_base.scss

@@ -57,6 +57,56 @@ kbd,
   font-family: var(--mono);
 }
 
+// The three text tones every screen uses. Without them a consumer writes
+// `style="font-size:12.5px;color:var(--t3)"` — 147 times, in one app.
+.strct-text-muted {
+  color: var(--t3);
+}
+
+.strct-text-hint {
+  color: var(--t3);
+  font-size: var(--text-sm);
+  line-height: 1.5;
+}
+
+.strct-text-overline {
+  font-size: var(--text-xs);
+  font-weight: 600;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: var(--t2);
+}
+
+// Inline code in running text: horizontal padding only and inherited
+// line-height, so a code span never changes a paragraph's leading.
+.strct-code-inline {
+  font-family: var(--mono);
+  font-size: var(--text-sm);
+  background: var(--bg-2);
+  border-radius: var(--radius-sm);
+  padding: 0 0.35em;
+  line-height: inherit;
+  white-space: nowrap;
+}
+
+.strct-code-inline--copyable {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding-inline-end: 0.15em;
+}
+
+.strct-code-inline--copyable .strct-copy {
+  padding: 1px 3px;
+}
+
+.strct-text-lede {
+  color: var(--t2);
+  font-size: var(--text-md);
+  line-height: 1.55;
+  max-width: 72ch;
+}
+
 :focus-visible {
   outline: 2px solid var(--acc50);
   outline-offset: 2px;

package/types/akcelik-strct.d.ts

@@ -562,6 +562,11 @@ declare class StrctPageHeaderActions {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctPageHeaderActions, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctPageHeaderActions, "[strctPageHeaderActions]", never, {}, {}, never, never, true, never>;
 }
+/** Sits beside the title, on its baseline — a state badge, a version. */
+declare class StrctPageHeaderTitleMeta {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctPageHeaderTitleMeta, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctPageHeaderTitleMeta, "[strctPageHeaderTitleMeta]", never, {}, {}, never, never, true, never>;
+}
 /**
  * Page header — the top of every console object page: an optional breadcrumb
  * row, a title + subtitle, and actions aligned to the end. Default content
@@ -579,8 +584,53 @@ declare class StrctPageHeader {
     readonly subtitle: _angular_core.InputSignal<string>;
     /** Draw a hairline divider under the header. */
     readonly divider: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Heading level — the document outline (a page's h1, a pane's h2). */
+    readonly level: _angular_core.InputSignal<1 | 2 | 3>;
+    /** `page` — as today; `pane` — the smaller header a side pane wants. */
+    readonly size: _angular_core.InputSignal<"page" | "pane">;
+    /** Optional leading icon, e.g. the kind of object the page is about. */
+    readonly icon: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctPageHeader, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctPageHeader, "strct-page-header", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; }, {}, never, ["[strctPageHeaderCrumbs]", "[strctPageHeaderActions]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctPageHeader, "strct-page-header", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; "level": { "alias": "level"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, ["[strctPageHeaderCrumbs]", "[strctPageHeaderTitleMeta]", "[strctPageHeaderActions]", "*"], true, never>;
+}
+
+/** Follows the heading on its line — a badge, a count, a status dot. */
+declare class StrctSectionHeaderMeta {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSectionHeaderMeta, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctSectionHeaderMeta, "[strctSectionHeaderMeta]", never, {}, {}, never, never, true, never>;
+}
+/** Goes to the end of the heading row (the `strctPageHeaderActions` precedent). */
+declare class StrctSectionHeaderActions {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSectionHeaderActions, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctSectionHeaderActions, "[strctSectionHeaderActions]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * The title of a section within a page. `strct-page-header` is the page's `h1`
+ * and `strct-card-header` needs a card; the section between the two had no
+ * component, so consumers wrote an uppercase `h3` by hand — the single largest
+ * source of hand-written CSS in the app this came from.
+ *
+ *   <strct-section-header heading="Proxy" description="How the appliance reaches the internet." [level]="3">
+ *     <strct-badge strctSectionHeaderMeta status="success">Tested</strct-badge>
+ *     <button strct-button strctSectionHeaderActions size="sm" variant="outline">Edit proxy…</button>
+ *   </strct-section-header>
+ *
+ * `level` sets the element (`h2`–`h6`) and `appearance` sets the look, so the
+ * document outline stays correct whatever the section is styled like.
+ */
+declare class StrctSectionHeader {
+    /** Section title. */
+    readonly heading: _angular_core.InputSignal<string>;
+    /** One line under the heading. */
+    readonly description: _angular_core.InputSignal<string>;
+    /** Heading level — the document outline, independent of `appearance`. */
+    readonly level: _angular_core.InputSignal<2 | 3 | 5 | 4 | 6>;
+    /** `title` — sentence case; `overline` — uppercase, letter-spaced, quieter. */
+    readonly appearance: _angular_core.InputSignal<"title" | "overline">;
+    /** Hairline under the header, like `strct-page-header`. */
+    readonly divider: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSectionHeader, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSectionHeader, "strct-section-header", never, { "heading": { "alias": "heading"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "level": { "alias": "level"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; }, {}, never, ["[strctSectionHeaderMeta]", "[strctSectionHeaderActions]", "*"], true, never>;
 }
 
 /** Button visual variants. */
@@ -672,9 +722,25 @@ declare class StrctAvatar {
     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>;
 }
 
-/** Progress bar color variants. */
-type StrctProgressStatus = 'accent' | 'success' | 'warning' | 'critical';
-/** Horizontal value/usage bar. `<strct-progress [value]="72" status="warning" />`. */
+/** Progress bar color variants. `neutral` is the quiet one: queued, idle, unknown. */
+type StrctProgressStatus = 'neutral' | 'accent' | 'success' | 'warning' | 'critical';
+/** One stacked fill of a multi-value bar (used now, plus what would arrive …). */
+interface StrctProgressSegment {
+    value: number;
+    status?: StrctProgressStatus;
+    /** Names this part in the accessible text ("Used 61%, arriving 22%"). */
+    label?: string;
+}
+/**
+ * Horizontal value/usage bar. `<strct-progress [value]="72" status="warning" />`.
+ *
+ * **Meter mode.** A capacity bar says what it measures and how much, next to
+ * the bar: `visibleLabel` puts `label` at the start of a row above the track,
+ * `showValue` puts `valueText` (default `${value}%`) at its end, and `caption`
+ * adds a quiet line under it. `segments` stacks more than one fill, and
+ * `indeterminate` is a task that is running but reports no percentage. Every
+ * one of these is off by default, so a plain bar renders exactly as before.
+ */
 declare class StrctProgress {
     /** Current value. */
     readonly value: _angular_core.InputSignal<number>;
@@ -682,6 +748,18 @@ declare class StrctProgress {
     readonly label: _angular_core.InputSignal<string>;
     /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctProgressStatus>;
+    /** Show `label` above the bar as well as announcing it. */
+    readonly visibleLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Show the value at the end of the row above the bar. */
+    readonly showValue: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** What `showValue` prints — "293 GB of 512 GB". Defaults to `${value}%`. */
+    readonly valueText: _angular_core.InputSignal<string>;
+    /** A quiet line under the bar — "219 GB free across 2 nodes". */
+    readonly caption: _angular_core.InputSignal<string>;
+    /** Running, but with no percentage to report. */
+    readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Stack several fills (used now + what would arrive); clamped to 100 total. */
+    readonly segments: _angular_core.InputSignal<StrctProgressSegment[] | null>;
     /**
      * Optional value-driven thresholds. When set, the component picks its own
      * status from the value instead of the caller computing it: `value >= critical`
@@ -691,10 +769,17 @@ declare class StrctProgress {
      */
     readonly thresholds: _angular_core.InputSignal<StrctThresholds | null>;
     protected readonly clamped: _angular_core.Signal<number>;
+    /** Segments as widths that together never exceed the track. */
+    protected readonly stacked: _angular_core.Signal<{
+        width: number;
+        status: StrctProgressStatus;
+    }[] | null>;
+    /** What a screen reader reads instead of the bare number. */
+    protected readonly valueDescription: _angular_core.Signal<string | null>;
     /** Status after applying thresholds (falls back to `status` when none set). */
     protected readonly resolvedStatus: _angular_core.Signal<StrctProgressStatus>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctProgress, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctProgress, "strct-progress", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctProgress, "strct-progress", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "visibleLabel": { "alias": "visibleLabel"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "valueText": { "alias": "valueText"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "segments": { "alias": "segments"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** Spinner size variants. */
@@ -705,8 +790,14 @@ declare class StrctSpinner {
     readonly size: _angular_core.InputSignal<StrctSpinnerSize>;
     /** Accessible label (localizable). */
     readonly label: _angular_core.InputSignal<string>;
+    /**
+     * Visible text beside the ring — "Reading…". It becomes the accessible name
+     * too, so the spinner is not announced as "Loading" while it says something
+     * else on screen.
+     */
+    readonly caption: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSpinner, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSpinner, "strct-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSpinner, "strct-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -796,12 +887,31 @@ declare class StrctCard {
 declare class StrctCardHeader {
     /** Optional leading icon (StrctIcon set). */
     readonly icon: _angular_core.InputSignal<string>;
+    /** Card title. Left empty, the default slot renders as before. */
+    readonly heading: _angular_core.InputSignal<string>;
+    /** `title` — as today; `overline` — uppercase, letter-spaced, quieter. */
+    readonly appearance: _angular_core.InputSignal<"title" | "overline">;
     /** Accessible labels for the collapse toggle (localizable). */
     readonly collapseLabel: _angular_core.InputSignal<string>;
     readonly expandLabel: _angular_core.InputSignal<string>;
     protected readonly card: StrctCard | null;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCardHeader, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCardHeader, "strct-card-header", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "collapseLabel": { "alias": "collapseLabel"; "required": false; "isSignal": true; }; "expandLabel": { "alias": "expandLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCardHeader, "strct-card-header", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "collapseLabel": { "alias": "collapseLabel"; "required": false; "isSignal": true; }; "expandLabel": { "alias": "expandLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[strctCardHeaderMeta]", "*", "[strctCardHeaderNote]", "[strctCardHeaderActions]"], true, never>;
+}
+/** Follows the card's heading on its line — a badge, a count. */
+declare class StrctCardHeaderMeta {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCardHeaderMeta, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctCardHeaderMeta, "[strctCardHeaderMeta]", never, {}, {}, never, never, true, never>;
+}
+/** Quiet text at the end of the header row, before the actions; ellipsised. */
+declare class StrctCardHeaderNote {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCardHeaderNote, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctCardHeaderNote, "[strctCardHeaderNote]", never, {}, {}, never, never, true, never>;
+}
+/** Buttons at the end of the header row. */
+declare class StrctCardHeaderActions {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCardHeaderActions, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctCardHeaderActions, "[strctCardHeaderActions]", never, {}, {}, never, never, true, never>;
 }
 /** Body section of a {@link StrctCard}. */
 declare class StrctCardBlock {
@@ -2077,6 +2187,30 @@ declare class StrctCode {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCode, "strct-code", never, { "code": { "alias": "code"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "language": { "alias": "language"; "required": false; "isSignal": true; }; "copyable": { "alias": "copyable"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "lineNumbers": { "alias": "lineNumbers"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "collapseLabel": { "alias": "collapseLabel"; "required": false; "isSignal": true; }; "expandLabel": { "alias": "expandLabel"; "required": false; "isSignal": true; }; "regionLabel": { "alias": "regionLabel"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, never, true, never>;
 }
 
+/**
+ * A command, a path or an identifier **inside a sentence**, set as code:
+ *
+ *   Run <code strctCode>hyperstructctl doctor</code> on the appliance.
+ *   <code strctCode copyable>host-01m3e2e0000000000000000001</code>
+ *
+ * `strct-code` is a block and `strct-kbd` means a key on the keyboard, so an
+ * identifier in running text had nothing but hand-written CSS. The padding is
+ * horizontal only and the line-height is inherited, so a code span never
+ * changes the leading of the paragraph it sits in.
+ *
+ * `copyable` appends the library's own `strct-copy` button (icon-only, with its
+ * copied / failed feedback) rather than re-implementing the clipboard.
+ */
+declare class StrctCodeInline {
+    /** Append a copy button that copies this element's text. */
+    readonly copyable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly host;
+    private readonly vcr;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCodeInline, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctCodeInline, "[strctCode]", never, { "copyable": { "alias": "copyable"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /** One active filter chip in a {@link StrctFilterBar}. */
 interface StrctFilterChip {
     /** Stable identity, returned with (removed). */
@@ -3287,6 +3421,11 @@ declare class StrctRowDetailDef {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctRowDetailDef, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctRowDetailDef, "[strctRowDetail]", never, {}, {}, never, never, true, never>;
 }
+/** Muted note inside the action bar, before the buttons. */
+declare class StrctDatagridActionBarCaption {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDatagridActionBarCaption, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctDatagridActionBarCaption, "[strctDatagridActionBarCaption]", never, {}, {}, never, never, true, never>;
+}
 /** Marks the persistent action-bar (toolbar) content shown above the grid. */
 declare class StrctDatagridActionBar {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDatagridActionBar, never>;
@@ -3685,7 +3824,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; }; "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>;
+    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"], ["[strctDatagridActionBarCaption]", "[strctDatagridActionBar]"], true, never>;
 }
 
 /** Timeline node state colors. */
@@ -4554,7 +4693,7 @@ declare class StrctToastOutlet {
 }
 
 /** Preset zero/permission/error states with a sensible icon + tone. */
-type StrctEmptyVariant = 'empty' | 'denied' | 'error' | 'notfound';
+type StrctEmptyVariant = 'empty' | 'denied' | 'error' | 'notfound' | 'loading';
 /**
  * A centered empty / permission / error state — an icon, a title, an optional
  * description and a slot for call-to-action buttons. Project actions as children.
@@ -4572,11 +4711,16 @@ declare class StrctEmptyState {
     /** Override the preset tone (neutral / warning / critical / accent). */
     readonly tone: _angular_core.InputSignal<string>;
     readonly title: _angular_core.InputSignal<string>;
+    /**
+     * `sm` is the inline row a 240px frame wants: a 16px icon with the title and
+     * description on one line. A page-sized empty state stays `md`.
+     */
+    readonly size: _angular_core.InputSignal<"md" | "sm">;
     readonly description: _angular_core.InputSignal<string>;
     protected readonly resolvedIcon: _angular_core.Signal<string>;
     protected readonly toneClass: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctEmptyState, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctEmptyState, "strct-empty-state", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctEmptyState, "strct-empty-state", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 /**
@@ -5687,6 +5831,11 @@ declare class StrctDatetimePicker implements ControlValueAccessor {
  * `selectionLabel` factory) with a × button that emits `(cleared)`.
  * `strct-toolbar-spacer` pushes following actions to the far end.
  */
+/** Muted note on the toolbar's row — placed before the spacer. */
+declare class StrctToolbarCaption {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctToolbarCaption, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctToolbarCaption, "[strctToolbarCaption]", never, {}, {}, never, never, true, never>;
+}
 declare class StrctToolbar {
     private readonly host;
     /** Accessible name of the toolbar (localizable). */
@@ -5708,7 +5857,7 @@ declare class StrctToolbar {
     /** Tabbable controls inside the bar, in DOM order. */
     private items;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctToolbar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctToolbar, "strct-toolbar", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "selectionCount": { "alias": "selectionCount"; "required": false; "isSignal": true; }; "divided": { "alias": "divided"; "required": false; "isSignal": true; }; "selectionLabel": { "alias": "selectionLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; }, { "cleared": "cleared"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctToolbar, "strct-toolbar", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "selectionCount": { "alias": "selectionCount"; "required": false; "isSignal": true; }; "divided": { "alias": "divided"; "required": false; "isSignal": true; }; "selectionLabel": { "alias": "selectionLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; }, { "cleared": "cleared"; }, never, ["[strctToolbarCaption]", "*"], true, never>;
 }
 /**
  * Flex spacer for `strct-toolbar` — pushes the actions after it to the far
@@ -5972,5 +6121,5 @@ declare class StrctHeatmap {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctHeatmap, "strct-heatmap", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "cols": { "alias": "cols"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "colLabelEvery": { "alias": "colLabelEvery"; "required": false; "isSignal": true; }; "colLabel": { "alias": "colLabel"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "summaryFormat": { "alias": "summaryFormat"; "required": false; "isSignal": true; }; "cellHeight": { "alias": "cellHeight"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "rowLabelWidth": { "alias": "rowLabelWidth"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { FOCUSABLE_SELECTOR, STRCT_DP_DOW, STRCT_DP_DOW_FULL, STRCT_DP_MONTHS, STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_ICON_NAMES, STRCT_MASKS, STRCT_NOTIFICATION_HISTORY_LIMIT, STRCT_PALETTES, STRCT_RAW_ICONS, STRCT_TIME_RANGE_PRESETS, STRCT_WIZARD_DEFAULTS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCascadeColumn, StrctCascadeHost, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChart, StrctCheckbox, StrctChips, StrctCode, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctConfirmOutlet, StrctConfirmService, StrctContextMenu, StrctContextMenuTrigger, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatepicker, StrctDatetimePicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFile, StrctFilterBar, StrctFlow, StrctFooter, StrctGauge, StrctHeader, StrctHeatmap, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInlineEdit, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLogViewer, StrctLogin, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctModalContent, StrctNav, StrctNavItem, StrctNotificationCenter, StrctNumber, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPagination, StrctPassword, StrctPopover, StrctPopoverTrigger, StrctProgress, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderItem, StrctRowDetailDef, StrctSearchbox, StrctSectionMenu, StrctSegmented, StrctSelect, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSignpostTrigger, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStatusDot, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctToolbar, StrctToolbarSpacer, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctTreeSelect, StrctVerticalNav, StrctWatermark, StrctWizard, StrctWizardAside, focusFirstIn, keepTabInside, lockBodyScroll, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, restoreFocus, saveFocusedElement, strctComputeDiff, strctDpPad, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctValidationIcon, strctValidationTone, unlockBodyScroll };
-export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartSummaryInfo, StrctChartThreshold, StrctChartType, StrctColumn, StrctCommandItem, StrctConfirmOptions, StrctConfirmTone, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowDirection, StrctFlowNode, StrctFlowOrientation, StrctHeatmapCell, StrctHeatmapSummaryInfo, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLogLine, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctNotification, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressStatus, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctStatusDotSize, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeDropEvent, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus, StrctWizardDefaults };
+export { FOCUSABLE_SELECTOR, STRCT_DP_DOW, STRCT_DP_DOW_FULL, STRCT_DP_MONTHS, STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_ICON_NAMES, STRCT_MASKS, STRCT_NOTIFICATION_HISTORY_LIMIT, STRCT_PALETTES, STRCT_RAW_ICONS, STRCT_TIME_RANGE_PRESETS, STRCT_WIZARD_DEFAULTS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCardHeaderActions, StrctCardHeaderMeta, StrctCardHeaderNote, StrctCascadeColumn, StrctCascadeHost, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChart, StrctCheckbox, StrctChips, StrctCode, StrctCodeInline, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctConfirmOutlet, StrctConfirmService, StrctContextMenu, StrctContextMenuTrigger, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatagridActionBarCaption, StrctDatepicker, StrctDatetimePicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFile, StrctFilterBar, StrctFlow, StrctFooter, StrctGauge, StrctHeader, StrctHeatmap, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInlineEdit, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLogViewer, StrctLogin, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctModalContent, StrctNav, StrctNavItem, StrctNotificationCenter, StrctNumber, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPageHeaderTitleMeta, StrctPagination, StrctPassword, StrctPopover, StrctPopoverTrigger, StrctProgress, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderItem, StrctRowDetailDef, StrctSearchbox, StrctSectionHeader, StrctSectionHeaderActions, StrctSectionHeaderMeta, StrctSectionMenu, StrctSegmented, StrctSelect, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSignpostTrigger, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStatusDot, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctToolbar, StrctToolbarCaption, StrctToolbarSpacer, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctTreeSelect, StrctVerticalNav, StrctWatermark, StrctWizard, StrctWizardAside, focusFirstIn, keepTabInside, lockBodyScroll, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, restoreFocus, saveFocusedElement, strctComputeDiff, strctDpPad, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctValidationIcon, strctValidationTone, unlockBodyScroll };
+export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartSummaryInfo, StrctChartThreshold, StrctChartType, StrctColumn, StrctCommandItem, StrctConfirmOptions, StrctConfirmTone, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowDirection, StrctFlowNode, StrctFlowOrientation, StrctHeatmapCell, StrctHeatmapSummaryInfo, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLogLine, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctNotification, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressSegment, StrctProgressStatus, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctStatusDotSize, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeDropEvent, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus, StrctWizardDefaults };