@akcelik/strct 5.4.0 → 5.5.0

package/package.json

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

@@ -937,6 +937,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 +976,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. */
@@ -5260,11 +5276,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 +5503,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 +5518,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 +6613,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 +6633,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. */
@@ -6811,6 +6848,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 +6869,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>;
 }
 
 /**