@akcelik/strct 5.4.0 → 5.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "5.4.0",
+  "version": "5.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/types/akcelik-strct.d.ts

@@ -52,10 +52,16 @@ declare class StrctThemeService {
 declare class StrctThemeSwitcher {
     protected readonly theme: StrctThemeService;
     /** Labels for the Light / Dark mode buttons (localizable). */
+    /**
+     * Where the switcher sits. `header` (the default) reads on `--hdr`;
+     * `surface` is a raised one — a user menu, a settings popover — where the
+     * header's foreground would be invisible.
+     */
+    readonly tone: _angular_core.InputSignal<"header" | "surface">;
     readonly lightLabel: _angular_core.InputSignal<string>;
     readonly darkLabel: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctThemeSwitcher, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctThemeSwitcher, "strct-theme-switcher", never, { "lightLabel": { "alias": "lightLabel"; "required": false; "isSignal": true; }; "darkLabel": { "alias": "darkLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctThemeSwitcher, "strct-theme-switcher", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "lightLabel": { "alias": "lightLabel"; "required": false; "isSignal": true; }; "darkLabel": { "alias": "darkLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -603,7 +609,7 @@ declare class StrctLogin {
         phase: number;
     }[];
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctLogin, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctLogin, "strct-login", never, { "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "split": { "alias": "split"; "required": false; "isSignal": true; }; "art": { "alias": "art"; "required": false; "isSignal": true; }; "brandIcon": { "alias": "brandIcon"; "required": false; "isSignal": true; }; "brandName": { "alias": "brandName"; "required": false; "isSignal": true; }; "tagline": { "alias": "tagline"; "required": false; "isSignal": true; }; }, {}, never, ["[strctLoginAside]", "[strctLoginStatus]", "[strctLoginMain]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctLogin, "strct-login", never, { "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "split": { "alias": "split"; "required": false; "isSignal": true; }; "art": { "alias": "art"; "required": false; "isSignal": true; }; "brandIcon": { "alias": "brandIcon"; "required": false; "isSignal": true; }; "brandName": { "alias": "brandName"; "required": false; "isSignal": true; }; "tagline": { "alias": "tagline"; "required": false; "isSignal": true; }; }, {}, never, ["[strctLoginBrandMeta]", "[strctLoginAside]", "[strctLoginStatus]", "[strctLoginMain]", "*"], true, never>;
 }
 
 /** Marks the breadcrumb row projected above the title. */
@@ -937,6 +943,22 @@ declare class StrctProgress {
     readonly valueText: _angular_core.InputSignal<string>;
     /** A quiet line under the bar — "219 GB free across 2 nodes". */
     readonly caption: _angular_core.InputSignal<string>;
+    /**
+     * The caption's tone. A critical capacity line's note — "2 GB left after the
+     * tightest node" — is the warning; `--t3` says it is an aside.
+     */
+    readonly captionStatus: _angular_core.InputSignal<StrctProgressStatus | null>;
+    /**
+     * The bar's accessible name, when the visible `label` is not it: a column of
+     * per-cluster memory bars would otherwise all be named "Memory". Defaults to
+     * `label`.
+     */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /**
+     * Where `showValue` puts the number: on its own row above the track, or
+     * beside it — which is what a bar inside a table cell wants.
+     */
+    readonly valuePosition: _angular_core.InputSignal<"end" | "top">;
     /** 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. */
@@ -960,7 +982,7 @@ declare class StrctProgress {
     /** 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; }; "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>;
+    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; }; "captionStatus": { "alias": "captionStatus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "valuePosition": { "alias": "valuePosition"; "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. */
@@ -1804,6 +1826,13 @@ declare class StrctDropdown {
     readonly popover: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Accessible name of the popover dialog (localizable). */
     readonly popoverLabel: _angular_core.InputSignal<string>;
+    /**
+     * Only with `popover`: the panel's rows are controls in their own right — a
+     * theme switcher, a filter — so they keep a real tab stop instead of the
+     * `tabindex="-1"` a menu's items carry. Without it nothing inside a popover
+     * can be reached from the keyboard at all.
+     */
+    readonly focusable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly open: _angular_core.WritableSignal<boolean>;
     constructor();
     /** Where focus was when the menu opened — restored on Escape/selection. */
@@ -1836,7 +1865,7 @@ declare class StrctDropdown {
     protected onDocClick(event: MouseEvent): void;
     protected onEscape(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDropdown, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDropdown, "strct-dropdown", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; "popover": { "alias": "popover"; "required": false; "isSignal": true; }; "popoverLabel": { "alias": "popoverLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[strctDropdownTrigger]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDropdown, "strct-dropdown", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; "popover": { "alias": "popover"; "required": false; "isSignal": true; }; "popoverLabel": { "alias": "popoverLabel"; "required": false; "isSignal": true; }; "focusable": { "alias": "focusable"; "required": false; "isSignal": true; }; }, {}, never, ["[strctDropdownTrigger]", "*"], true, never>;
 }
 /**
  * Marks (and upgrades) the dropdown's trigger element. The attribute alone is
@@ -1882,6 +1911,14 @@ declare class StrctDropdownItem {
      */
     readonly hint: _angular_core.InputSignal<string | null | undefined>;
     protected readonly hintId: string;
+    /** The panel this row belongs to, when it is inside one. */
+    private readonly panel;
+    /**
+     * A menu's rows are roved with the arrow keys, so they stay out of the tab
+     * order. A `popover [focusable]` is a panel of real controls, and its rows
+     * keep a tab stop of their own.
+     */
+    protected readonly tabindex: _angular_core.Signal<number | null>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDropdownItem, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDropdownItem, "strct-dropdown-item", never, { "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "critical": { "alias": "critical"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; }, {}, never, ["[strctDropdownItemAction]", "*"], true, never>;
@@ -3088,6 +3125,11 @@ declare class StrctInputOtp implements ControlValueAccessor {
      * `nnn – nnn`, mirroring how authenticator apps display the code.
      */
     readonly groupSize: _angular_core.InputSignal<number>;
+    /**
+     * Spread the boxes across the full width, so the code lines up with a
+     * full-width button under it rather than huddling at the start of the row.
+     */
+    readonly fill: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly slots: _angular_core.WritableSignal<string[]>;
     readonly isDisabled: _angular_core.WritableSignal<boolean>;
     protected readonly indices: _angular_core.Signal<number[]>;
@@ -3107,7 +3149,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; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "groupSize": { "alias": "groupSize"; "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; }; "fill": { "alias": "fill"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** Knob accent color variants. */
@@ -5260,11 +5302,20 @@ declare class StrctHero {
     /** Tighter padding for secondary placements. */
     readonly dense: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
-     * Opt into a polite live region (role="status") for banners whose content
-     * updates after load; static banners should leave this off. Critical heroes
-     * are always role="alert" regardless.
+     * How the banner announces itself. `true` opts a non-critical hero into a
+     * polite live region (`role="status"`), for content that updates after load.
+     * `'polite'` and `'assertive'` say it outright, whatever the status — a page
+     * that renders its verdict on navigation wants `'polite'`, so a critical
+     * hero does not interrupt on every load.
      */
-    readonly live: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly live: _angular_core.InputSignalWithTransform<boolean | "polite" | "assertive", unknown>;
+    /**
+     * A critical hero interrupts by default, because it usually appears in
+     * answer to something the user did. A page that renders a verdict on
+     * navigation would interrupt on every load instead, so `live="polite"` makes
+     * it a `status`; `live="assertive"` asks for `alert` whatever the status.
+     */
+    protected readonly liveRole: _angular_core.Signal<"status" | "alert" | null>;
     protected readonly headingId: string;
     protected readonly resolvedIcon: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctHero, never>;
@@ -5478,6 +5529,12 @@ declare class StrctEmptyState {
     /** Override the preset tone (neutral / warning / critical / accent). */
     readonly tone: _angular_core.InputSignal<string>;
     readonly title: _angular_core.InputSignal<string>;
+    /**
+     * Which heading element the title is. `null` renders a `<p>` — what a
+     * loading state inside a card wants, since it should not add a heading to
+     * the page outline.
+     */
+    readonly titleLevel: _angular_core.InputSignal<2 | 3 | 5 | 4 | 6 | null>;
     /**
      * `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`.
@@ -5487,7 +5544,7 @@ declare class StrctEmptyState {
     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; }; "size": { "alias": "size"; "required": false; "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; }; "titleLevel": { "alias": "titleLevel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 /**
@@ -6582,6 +6639,12 @@ type StrctMediaState = 'content' | 'loading' | 'empty' | 'off' | 'error';
 declare class StrctMediaFrame {
     /** The frame's aspect ratio, as a CSS `aspect-ratio` value. */
     readonly ratio: _angular_core.InputSignal<string>;
+    /**
+     * How the media fills the frame. `cover` crops to fill, as today; `contain`
+     * shows all of it — what a console thumbnail needs, since the corner it
+     * would crop is where the error is.
+     */
+    readonly fit: _angular_core.InputSignal<"cover" | "contain">;
     /** What the frame shows: the projected picture, or why there is none. */
     readonly state: _angular_core.InputSignal<StrctMediaState>;
     /** The placeholder's line ("The VM is off"). */
@@ -6596,7 +6659,7 @@ declare class StrctMediaFrame {
     readonly activated: _angular_core.OutputEmitterRef<void>;
     protected readonly iconName: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctMediaFrame, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctMediaFrame, "strct-media-frame", never, { "ratio": { "alias": "ratio"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "activateLabel": { "alias": "activateLabel"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctMediaFrame, "strct-media-frame", never, { "ratio": { "alias": "ratio"; "required": false; "isSignal": true; }; "fit": { "alias": "fit"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "activateLabel": { "alias": "activateLabel"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["*"], true, never>;
 }
 
 /** Where a window sits and how big it is, in viewport px. */
@@ -6614,6 +6677,14 @@ interface StrctWindowLabels {
     close: string;
     /** The dock's accessible name. */
     dock: string;
+    /**
+     * The tooltip each control shows on hover, when it says more than the name
+     * does — the console's minimise is "stays connected". Empty shows none.
+     */
+    minimizeHint: string;
+    maximizeHint: string;
+    restoreHint: string;
+    closeHint: string;
 }
 /**
  * Knows which windows exist, which is on top, and which are minimised — so the
@@ -6668,8 +6739,18 @@ declare class StrctWindow {
     readonly labels: _angular_core.InputSignal<Partial<StrctWindowLabels>>;
     /** The accessible name of each resize grip. */
     readonly resizeLabel: _angular_core.InputSignal<(corner: string) => string>;
+    /** A leading icon in the title bar, as `strct-page-header [icon]` has. */
+    readonly icon: _angular_core.InputSignal<string>;
+    /**
+     * What a double-click on the title bar does. A console whose content has a
+     * real full screen of its own wants `none` and its own answer to
+     * `(titleDblclick)`.
+     */
+    readonly titleDblclick: _angular_core.InputSignal<"none" | "maximize">;
     /** The window was closed. */
     readonly closed: _angular_core.OutputEmitterRef<void>;
+    /** The title bar was double-clicked, whatever `titleDblclick` then did. */
+    readonly titleDblclicked: _angular_core.OutputEmitterRef<void>;
     protected readonly CORNERS: readonly ["nw", "ne", "sw", "se"];
     protected readonly titleId: string;
     protected readonly L: _angular_core.Signal<StrctWindowLabels>;
@@ -6702,6 +6783,8 @@ declare class StrctWindow {
     private dragMove;
     private dragEnd;
     /** Alt+arrows move the window; Escape minimises it. */
+    protected toggleMaximized(): void;
+    protected onTitleDblclick(): void;
     protected onTitleKeydown(event: KeyboardEvent): void;
     private resizeFrom;
     private readonly onResizeMove;
@@ -6716,13 +6799,32 @@ declare class StrctWindow {
      * the window's origin as well as its size, so the opposite corner stays put.
      */
     private resized;
+    /**
+     * A window dragged off the screen cannot be dragged back: the title bar is
+     * the only handle it has. Keep enough of that bar on screen to grab — the
+     * window may hang off any edge, but never past its own title.
+     */
+    private clamp;
     private setRect;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctWindow, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctWindow, "strct-window", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "minimized": { "alias": "minimized"; "required": false; "isSignal": true; }; "maximized": { "alias": "maximized"; "required": false; "isSignal": true; }; "bounds": { "alias": "bounds"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "palette": { "alias": "palette"; "required": false; "isSignal": true; }; "closeOnOutside": { "alias": "closeOnOutside"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "resizeLabel": { "alias": "resizeLabel"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "minimized": "minimizedChange"; "maximized": "maximizedChange"; "bounds": "boundsChange"; "closed": "closed"; }, never, ["[strctWindowTitleMeta]", "[strctWindowActions]", "*", "[strctWindowStatus]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctWindow, "strct-window", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "minimized": { "alias": "minimized"; "required": false; "isSignal": true; }; "maximized": { "alias": "maximized"; "required": false; "isSignal": true; }; "bounds": { "alias": "bounds"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "palette": { "alias": "palette"; "required": false; "isSignal": true; }; "closeOnOutside": { "alias": "closeOnOutside"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "resizeLabel": { "alias": "resizeLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "titleDblclick": { "alias": "titleDblclick"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "minimized": "minimizedChange"; "maximized": "maximizedChange"; "bounds": "boundsChange"; "closed": "closed"; "titleDblclicked": "titleDblclicked"; }, never, ["[strctWindowTitleMeta]", "[strctWindowActions]", "*", "[strctWindowStatus]"], true, never>;
+}
+/**
+ * What a dock chip shows, when the window's heading is not enough — a status
+ * dot, an icon, a count. The window is the context:
+ *
+ *   <ng-template strctWindowDockItem let-w>
+ *     <strct-status-dot [status]="tone(w)" size="sm" /> {{ w.heading() }}
+ *   </ng-template>
+ */
+declare class StrctWindowDockItem {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctWindowDockItem, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctWindowDockItem, "ng-template[strctWindowDockItem]", never, {}, {}, never, never, true, never>;
 }
 /**
  * Where minimised windows wait. Put it in a toolbar or a status bar; each entry
- * restores its window, and its × closes it.
+ * restores its window — or asks the consumer to, through `(restoreRequest)` —
+ * and its × closes it.
  */
 declare class StrctWindowDock {
     protected readonly service: StrctWindowService;
@@ -6730,8 +6832,21 @@ declare class StrctWindowDock {
     readonly label: _angular_core.InputSignal<string>;
     /** The name of each chip's close button. */
     readonly closeLabel: _angular_core.InputSignal<(heading: string) => string>;
+    /** What each chip shows, when a heading is not enough. */
+    protected readonly itemTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    /**
+     * Who restores a window when its chip is pressed. `dock` does it itself, as
+     * before; `request` only emits `(restoreRequest)`, so an app that allows one
+     * open window at a time can close the other first — the dock's own restore
+     * would walk past that rule.
+     */
+    readonly restoreMode: _angular_core.InputSignal<"dock" | "request">;
+    /** A chip was pressed. Always emitted; with `restoreMode="request"` it is
+     *  the only thing that happens. */
+    readonly restoreRequest: _angular_core.OutputEmitterRef<StrctWindow>;
+    protected onRestore(w: StrctWindow): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctWindowDock, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctWindowDock, "strct-window-dock", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctWindowDock, "strct-window-dock", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; "restoreMode": { "alias": "restoreMode"; "required": false; "isSignal": true; }; }, { "restoreRequest": "restoreRequest"; }, ["itemTpl"], never, true, never>;
 }
 
 /** Who wrote a message. */
@@ -6811,6 +6926,11 @@ declare class StrctChatComposer {
     readonly label: _angular_core.InputSignal<string>;
     /** Disabled while the assistant is busy, say. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Only the send button is disabled: the reader may draft their next question
+     * while a reply is still streaming. `disabled` stops the typing as well.
+     */
+    readonly sendDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** How tall the box grows before it scrolls. */
     readonly maxRows: _angular_core.InputSignal<number>;
     /** The send button's accessible name. */
@@ -6827,7 +6947,7 @@ declare class StrctChatComposer {
     protected onEnter(event: Event): void;
     submit(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctChatComposer, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctChatComposer, "strct-chat-composer", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "sendLabel": { "alias": "sendLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "send": "send"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctChatComposer, "strct-chat-composer", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "sendDisabled": { "alias": "sendDisabled"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "sendLabel": { "alias": "sendLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "send": "send"; }, never, never, true, never>;
 }
 
 /**
@@ -6999,6 +7119,12 @@ declare class StrctPopover {
     readonly placement: _angular_core.InputSignal<StrctOverlayPlacement>;
     /** Accessible name of the popover dialog (localizable). */
     readonly ariaLabel: _angular_core.InputSignal<string>;
+    /**
+     * How wide the panel may get (px). The default suits a sentence; an alarm
+     * list or a drift table wants 340–360. `--strct-popover-max-w` is the same
+     * knob in CSS, for a panel the consumer does not own.
+     */
+    readonly maxWidth: _angular_core.InputSignal<number | null>;
     /**
      * Modal-ish usage: move focus into the panel on open, trap Tab inside and
      * hand focus back to the trigger on close. Off by default — a plain popover
@@ -7015,7 +7141,7 @@ declare class StrctPopover {
     protected onDocClick(event: MouseEvent): void;
     protected onEscape(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctPopover, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctPopover, "strct-popover", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "trap": { "alias": "trap"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[strctPopoverTrigger]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctPopover, "strct-popover", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "trap": { "alias": "trap"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[strctPopoverTrigger]", "*"], true, never>;
 }
 /**
  * Marks (and upgrades) the popover's trigger element. The attribute alone is
@@ -7552,5 +7678,5 @@ declare function strctCheckHostInputs(host: HTMLElement, selector: string, owns:
  */
 declare function strctCheckHostDisplay(host: HTMLElement, selector: string, expected: string): void;
 
-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, StrctAlertActions, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCardHeaderActions, StrctCardHeaderLeading, StrctCardHeaderMeta, StrctCardHeaderNote, StrctCascadeColumn, StrctCascadeHost, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChange, StrctChart, StrctChatAttachment, StrctChatComposer, StrctChatMessage, StrctChatThread, StrctCheckbox, StrctChips, StrctCode, StrctCodeInline, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctConfirmOutlet, StrctConfirmService, StrctContextMenu, StrctContextMenuTrigger, StrctControlDescription, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatagridActionBarCaption, StrctDatepicker, StrctDatetimePicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownItemAction, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFieldGroup, StrctFieldHint, StrctFieldPrefix, StrctFieldSuffix, StrctFieldValue, StrctFile, StrctFilterBar, StrctFlow, StrctFlowNodeTemplate, StrctFooter, StrctGauge, StrctHeader, StrctHeatmap, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInlineEdit, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLegend, StrctList, StrctListItem, StrctListItemDescription, StrctListItemLeading, StrctListItemMeta, StrctListItemTrailing, StrctLiveIndicator, StrctLogViewer, StrctLogin, StrctMediaFrame, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctModalContent, StrctNav, StrctNavItem, StrctNotificationCenter, StrctNumber, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPageHeaderTitleMeta, StrctPagination, StrctPassword, StrctPopover, StrctPopoverTrigger, StrctProgress, StrctQr, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderGroup, StrctReorderHandle, StrctReorderItem, StrctResizeHandle, StrctRowDetailDef, StrctSearchbox, StrctSectionHeader, StrctSectionHeaderActions, StrctSectionHeaderMeta, StrctSectionMenu, StrctSegmented, StrctSelect, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSignpostTrigger, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStatusDot, StrctStep, StrctStepAction, StrctSteps, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctTagLeading, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctToolbar, StrctToolbarCaption, StrctToolbarSpacer, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctTreeSelect, StrctVerticalNav, StrctWatermark, StrctWindow, StrctWindowDock, StrctWindowService, StrctWizard, StrctWizardAside, __qrInternals, focusFirstIn, keepTabInside, lockBodyScroll, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, restoreFocus, saveFocusedElement, strctCheckHostDisplay, strctCheckHostInputs, strctComputeDiff, strctDpPad, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctQrMatrix, strctValidationIcon, strctValidationTone, unlockBodyScroll };
+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, StrctAlertActions, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCardHeaderActions, StrctCardHeaderLeading, StrctCardHeaderMeta, StrctCardHeaderNote, StrctCascadeColumn, StrctCascadeHost, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChange, StrctChart, StrctChatAttachment, StrctChatComposer, StrctChatMessage, StrctChatThread, StrctCheckbox, StrctChips, StrctCode, StrctCodeInline, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctConfirmOutlet, StrctConfirmService, StrctContextMenu, StrctContextMenuTrigger, StrctControlDescription, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatagridActionBarCaption, StrctDatepicker, StrctDatetimePicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownItemAction, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFieldGroup, StrctFieldHint, StrctFieldPrefix, StrctFieldSuffix, StrctFieldValue, StrctFile, StrctFilterBar, StrctFlow, StrctFlowNodeTemplate, StrctFooter, StrctGauge, StrctHeader, StrctHeatmap, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInlineEdit, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLegend, StrctList, StrctListItem, StrctListItemDescription, StrctListItemLeading, StrctListItemMeta, StrctListItemTrailing, StrctLiveIndicator, StrctLogViewer, StrctLogin, StrctMediaFrame, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctModalContent, StrctNav, StrctNavItem, StrctNotificationCenter, StrctNumber, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPageHeaderTitleMeta, StrctPagination, StrctPassword, StrctPopover, StrctPopoverTrigger, StrctProgress, StrctQr, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderGroup, StrctReorderHandle, StrctReorderItem, StrctResizeHandle, StrctRowDetailDef, StrctSearchbox, StrctSectionHeader, StrctSectionHeaderActions, StrctSectionHeaderMeta, StrctSectionMenu, StrctSegmented, StrctSelect, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSignpostTrigger, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStatusDot, StrctStep, StrctStepAction, StrctSteps, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctTagLeading, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctToolbar, StrctToolbarCaption, StrctToolbarSpacer, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctTreeSelect, StrctVerticalNav, StrctWatermark, StrctWindow, StrctWindowDock, StrctWindowDockItem, StrctWindowService, StrctWizard, StrctWizardAside, __qrInternals, focusFirstIn, keepTabInside, lockBodyScroll, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, restoreFocus, saveFocusedElement, strctCheckHostDisplay, strctCheckHostInputs, strctComputeDiff, strctDpPad, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctQrMatrix, strctValidationIcon, strctValidationTone, unlockBodyScroll };
 export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartSummaryInfo, StrctChartThreshold, StrctChartType, StrctChatAuthor, StrctColumn, StrctCommandItem, StrctConfirmOptions, StrctConfirmTone, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowColumn, StrctFlowDirection, StrctFlowEdge, StrctFlowNode, StrctFlowOrientation, StrctHeatmapCell, StrctHeatmapSummaryInfo, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLegendItem, StrctLiveLabels, StrctLiveState, StrctLogLine, StrctMediaState, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuPlacement, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctNotification, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressSegment, StrctProgressStatus, StrctQrEcc, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctReorderMoveEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctStatusDotSize, StrctStepPhase, StrctStepState, StrctStepsLabels, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeDropEvent, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus, StrctWindowBounds, StrctWindowLabels, StrctWizardDefaults };