@akcelik/strct 0.4.0 → 0.5.0

package/types/akcelik-strct.d.ts

@@ -3,8 +3,11 @@ import { OnDestroy, TemplateRef } from '@angular/core';
 import { SafeHtml } from '@angular/platform-browser';
 import { ControlValueAccessor } from '@angular/forms';
 
+/** Available color palettes. */
 type StrctPalette = 'arctic' | 'ember' | 'sage';
+/** Light or dark mode. */
 type StrctMode = 'dark' | 'light';
+/** Metadata for a color palette. */
 interface StrctPaletteInfo {
     id: StrctPalette;
     /** Human label, shown in switchers. */
@@ -73,27 +76,34 @@ declare const STRCT_RAW_ICONS: Record<string, string>;
 declare function registerStrctIcon(name: string, content: string, options?: {
     raw?: boolean;
 }): void;
-type StrctIconBadge = 'none' | 'ok' | 'warn' | 'crit' | 'off' | 'info';
+/** Icon status dot variants. */
+type StrctIconBadge = 'none' | 'success' | 'warning' | 'critical' | 'off' | 'info';
 /**
- * Inline stroke icon. `<strct-icon name="host" badge="ok" />` renders the host
+ * Inline stroke icon. `<strct-icon name="host" badge="success" />` renders the host
  * glyph with a green status dot (a "running host"). Unknown names render
  * nothing rather than throwing.
  */
 declare class StrctIcon {
     private readonly sanitizer;
+    /** Icon name from the STRCT_ICONS registry. */
     readonly name: _angular_core.InputSignal<string>;
+    /** Icon size in pixels. */
     readonly size: _angular_core.InputSignal<number>;
+    /** Stroke width for outline icons. */
     readonly strokeWidth: _angular_core.InputSignal<number>;
     /** Optional status dot overlaid on the glyph (object state). */
     readonly badge: _angular_core.InputSignal<StrctIconBadge>;
+    /** Accessible label for the icon. When empty the icon is hidden from assistive tech. */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
     /** True when the named icon is a full-SVG (raw) icon registered by the app. */
     protected readonly isRaw: _angular_core.Signal<boolean>;
     protected readonly svg: _angular_core.Signal<SafeHtml>;
     protected readonly rawSvg: _angular_core.Signal<SafeHtml>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctIcon, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctIcon, "strct-icon", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctIcon, "strct-icon", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Overlay positioning strategies. */
 type StrctOverlayPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'right' | 'left';
 /**
  * Positions an overlay panel with `position: fixed` relative to an anchor
@@ -111,10 +121,13 @@ type StrctOverlayPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-
 declare class StrctOverlay implements OnDestroy {
     private readonly el;
     private readonly zone;
+    /** Anchor element for positioning. */
     readonly anchor: _angular_core.InputSignal<HTMLElement>;
+    /** Preferred placement relative to the anchor. */
     readonly placement: _angular_core.InputSignal<StrctOverlayPlacement>;
     /** Match the panel width to the anchor (combobox / date / cascade fields). */
     readonly matchWidth: _angular_core.InputSignal<boolean>;
+    /** Gap between anchor and panel in pixels. */
     readonly gap: _angular_core.InputSignal<number>;
     private readonly onScrollResize;
     private bound;
@@ -138,8 +151,13 @@ declare class StrctShell {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctShell, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctShell, "strct-shell", never, {}, {}, never, ["strct-header", "*", "strct-footer"], true, never>;
 }
+/** Shared layout state between shell parts. */
+declare class StrctShellService {
+    readonly mobileNavOpen: _angular_core.WritableSignal<boolean>;
+}
 /** Top application bar. Holds brand on the left and actions on the right. */
 declare class StrctHeader {
+    protected readonly shell: StrctShellService;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctHeader, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctHeader, "strct-header", never, {}, {}, never, ["*"], true, never>;
 }
@@ -151,6 +169,7 @@ declare class StrctFooter {
 
 /** Scrollable left sidebar surface. Holds the icon nav and/or a tree. */
 declare class StrctVerticalNav {
+    protected readonly shell: StrctShellService;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctVerticalNav, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctVerticalNav, "strct-vertical-nav", never, {}, {}, never, ["*"], true, never>;
 }
@@ -161,7 +180,9 @@ declare class StrctNav {
 }
 /** A single icon tab inside `<strct-nav>`. */
 declare class StrctNavItem {
+    /** Whether the item is active / selected. */
     readonly active: _angular_core.InputSignal<boolean>;
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctNavItem, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctNavItem, "strct-nav-item", never, { "active": { "alias": "active"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -179,13 +200,17 @@ declare class StrctNavItem {
  *   </strct-login>
  */
 declare class StrctLogin {
+    /** Maximum width in pixels. */
     readonly maxWidth: _angular_core.InputSignal<number>;
+    /** Enable two-panel split layout. */
     readonly split: _angular_core.InputSignalWithTransform<boolean, unknown>;
     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; }; }, {}, never, ["[strctLoginAside]", "[strctLoginMain]", "*"], true, never>;
 }
 
-type StrctButtonVariant = 'primary' | 'danger' | 'outline' | 'flat' | 'neutral';
+/** Button visual variants. */
+type StrctButtonVariant = 'primary' | 'critical' | 'outline' | 'flat' | 'neutral';
+/** Button size variants. */
 type StrctButtonSize = 'md' | 'sm' | 'mini';
 /**
  * Styles a native `<button>` / `<a>` so it stays fully accessible and form-aware.
@@ -198,10 +223,13 @@ type StrctButtonSize = 'md' | 'sm' | 'mini';
  *   <a strct-button variant="flat" size="sm" href="...">Cancel</a>
  */
 declare class StrctButton {
+    /** Visual variant. */
     readonly variant: _angular_core.InputSignal<StrctButtonVariant>;
+    /** Size variant. */
     readonly size: _angular_core.InputSignal<StrctButtonSize>;
     /** Opt in to a filled surface (use sparingly, for the primary action). */
     readonly solid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Expand to full width. */
     readonly block: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Square padding for a single-icon button. */
     readonly iconOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -214,9 +242,11 @@ declare class StrctButtonGroup {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctButtonGroup, "strct-button-group", never, {}, {}, never, ["*"], true, never>;
 }
 
-type StrctBadgeStatus = 'neutral' | 'accent' | 'success' | 'warning' | 'danger';
+/** Badge color variants. */
+type StrctBadgeStatus = 'neutral' | 'accent' | 'success' | 'warning' | 'critical';
 /** Small inline status pill: `<strct-badge status="success">Active</strct-badge>`. */
 declare class StrctBadge {
+    /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctBadgeStatus>;
     /** Opt-in filled style instead of the default outlined style. */
     readonly solid: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -224,48 +254,63 @@ declare class StrctBadge {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctBadge, "strct-badge", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "solid": { "alias": "solid"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-type StrctTagStatus = 'neutral' | 'accent' | 'success' | 'warning' | 'danger';
+/** Tag color variants. */
+type StrctTagStatus = 'neutral' | 'accent' | 'success' | 'warning' | 'critical';
 /**
  * Compact, optionally removable chip.
  *   <strct-tag status="accent" removable (removed)="drop()">Frontend</strct-tag>
  */
 declare class StrctTag {
+    /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctTagStatus>;
+    /** Show a remove button. */
     readonly removable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Emitted when the user clicks the remove button. */
     readonly removed: _angular_core.OutputEmitterRef<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctTag, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTag, "strct-tag", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
 }
 
+/** Avatar size variants. */
 type StrctAvatarSize = 'sm' | 'md' | 'lg';
+/** Avatar presence status variants. */
 type StrctAvatarStatus = 'none' | 'online' | 'busy' | 'offline';
 /**
  * Circular avatar: an image when `src` is set, otherwise initials from `name`.
  *   <strct-avatar name="Ada Lovelace" status="online" />
  */
 declare class StrctAvatar {
+    /** Image URL. */
     readonly src: _angular_core.InputSignal<string>;
+    /** Display name (used for initials when src is absent). */
     readonly name: _angular_core.InputSignal<string>;
+    /** Size variant. */
     readonly size: _angular_core.InputSignal<StrctAvatarSize>;
+    /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctAvatarStatus>;
     protected readonly initials: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctAvatar, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctAvatar, "strct-avatar", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type StrctProgressStatus = 'accent' | 'success' | 'warning' | 'danger';
+/** Progress bar color variants. */
+type StrctProgressStatus = 'accent' | 'success' | 'warning' | 'critical';
 /** Horizontal value/usage bar. `<strct-progress [value]="72" status="warning" />`. */
 declare class StrctProgress {
+    /** Current value. */
     readonly value: _angular_core.InputSignal<number>;
+    /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctProgressStatus>;
     protected readonly clamped: _angular_core.Signal<number>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctProgress, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctProgress, "strct-progress", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Spinner size variants. */
 type StrctSpinnerSize = 'sm' | 'md' | 'lg';
 /** Indeterminate loading ring. `<strct-spinner size="sm" />`. */
 declare class StrctSpinner {
+    /** Size variant. */
     readonly size: _angular_core.InputSignal<StrctSpinnerSize>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSpinner, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSpinner, "strct-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -277,13 +322,17 @@ declare class StrctSpinner {
  *   <strct-skeleton circle width="40px" height="40px" />
  */
 declare class StrctSkeleton {
+    /** Width (CSS length). */
     readonly width: _angular_core.InputSignal<string>;
+    /** Height in pixels. */
     readonly height: _angular_core.InputSignal<string>;
+    /** Circle. */
     readonly circle: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSkeleton, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSkeleton, "strct-skeleton", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "circle": { "alias": "circle"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Direction the speed-dial actions expand. */
 type StrctSpeedDialDirection = 'up' | 'down' | 'left' | 'right';
 /**
  * Floating action button that fans out to reveal actions. Project icon buttons
@@ -295,7 +344,9 @@ type StrctSpeedDialDirection = 'up' | 'down' | 'left' | 'right';
  */
 declare class StrctSpeedDial {
     private readonly host;
+    /** Icon name. */
     readonly icon: _angular_core.InputSignal<string>;
+    /** Direction the actions fan out. */
     readonly direction: _angular_core.InputSignal<StrctSpeedDialDirection>;
     readonly open: _angular_core.WritableSignal<boolean>;
     toggle(): void;
@@ -317,14 +368,17 @@ declare class StrctCard {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCard, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCard, "strct-card", never, {}, {}, never, ["*"], true, never>;
 }
+/** Header section of a {@link StrctCard}. */
 declare class StrctCardHeader {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCardHeader, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCardHeader, "strct-card-header", never, {}, {}, never, ["*"], true, never>;
 }
+/** Body section of a {@link StrctCard}. */
 declare class StrctCardBlock {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCardBlock, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCardBlock, "strct-card-block", never, {}, {}, never, ["*"], true, never>;
 }
+/** Footer section of a {@link StrctCard}. */
 declare class StrctCardFooter {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCardFooter, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCardFooter, "strct-card-footer", never, {}, {}, never, ["*"], true, never>;
@@ -337,7 +391,9 @@ declare class StrctAccordion {
 }
 /** Collapsible panel with a header. `expanded` is two-way bindable. */
 declare class StrctAccordionPanel {
+    /** Panel heading. */
     readonly heading: _angular_core.InputSignal<string>;
+    /** Whether the panel is open (two-way). */
     readonly expanded: _angular_core.ModelSignal<boolean>;
     toggle(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctAccordionPanel, never>;
@@ -346,7 +402,9 @@ declare class StrctAccordionPanel {
 
 /** A single tab. Place inside `<strct-tabs>`; `label` names its button. */
 declare class StrctTab {
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
+    /** Static disable flag. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly _active;
     readonly active: _angular_core.Signal<boolean>;
@@ -372,7 +430,7 @@ interface StrctMenuItem {
     label?: string;
     icon?: string;
     /** Destructive styling. */
-    danger?: boolean;
+    critical?: boolean;
     disabled?: boolean;
     /** Render a separator instead of an entry (label is ignored). */
     divider?: boolean;
@@ -391,12 +449,19 @@ interface StrctMenuItem {
  */
 declare class StrctMenuPanel {
     private readonly host;
+    /** Menu items to display. */
     readonly items: _angular_core.InputSignal<StrctMenuItem[]>;
+    /** Arbitrary payload passed to item actions. */
     readonly data: _angular_core.InputSignal<unknown>;
+    /** Horizontal position in pixels. */
     readonly x: _angular_core.InputSignal<number>;
+    /** Vertical position in pixels. */
     readonly y: _angular_core.InputSignal<number>;
+    /** Render as a nested submenu panel. */
     readonly submenu: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Emitted when an item is selected. */
     readonly select: _angular_core.OutputEmitterRef<StrctMenuItem>;
+    /** Emitted when the menu requests closing. */
     readonly close: _angular_core.OutputEmitterRef<void>;
     /** ArrowLeft inside a submenu — asks the parent to close it. */
     readonly back: _angular_core.OutputEmitterRef<void>;
@@ -429,8 +494,11 @@ declare class StrctContextMenuTrigger implements OnDestroy {
     private readonly envInjector;
     private readonly zone;
     private readonly doc;
+    /** Menu items to display. */
     readonly items: _angular_core.InputSignal<StrctMenuItem[]>;
+    /** Arbitrary payload passed to item actions. */
     readonly data: _angular_core.InputSignal<unknown>;
+    /** Emitted when a menu item is selected. */
     readonly menuSelect: _angular_core.OutputEmitterRef<StrctMenuItem>;
     private ref;
     private readonly onClose;
@@ -471,17 +539,22 @@ interface StrctTreeMenuEvent {
  *  - **Data:** pass a `[node]` object that recurses over its `children` —
  *    used internally by `<strct-tree [nodes]>`.
  *
- *   <strct-tree-node label="Group" icon="layers" badge="ok" [(expanded)]="open">
+ *   <strct-tree-node label="Group" icon="layers" badge="success" [(expanded)]="open">
  *     <strct-tree-node label="Leaf" icon="vm" [active]="true" />
  *   </strct-tree-node>
  */
 declare class StrctTreeNode {
     /** Data-driven node; when set, label/icon/children come from it. */
     readonly node: _angular_core.InputSignal<StrctTreeNodeData | null>;
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
+    /** Icon name. */
     readonly icon: _angular_core.InputSignal<string | undefined>;
+    /** Status dot variant. */
     readonly badge: _angular_core.InputSignal<StrctIconBadge>;
+    /** Whether the item is active / selected. */
     readonly active: _angular_core.InputSignal<boolean>;
+    /** Whether the panel is open (two-way). */
     readonly expanded: _angular_core.ModelSignal<boolean>;
     /** Per-node menu resolver (data mode); bubbles down the recursion. */
     readonly nodeMenu: _angular_core.InputSignal<StrctTreeNodeMenuFn | null>;
@@ -526,6 +599,7 @@ declare class StrctTree {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTree, "strct-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "nodeMenu": { "alias": "nodeMenu"; "required": false; "isSignal": true; }; }, { "nodeActivated": "nodeActivated"; "nodeMenuSelect": "nodeMenuSelect"; }, never, ["*"], true, never>;
 }
 
+/** Modal width presets. */
 type StrctModalSize = 'sm' | 'md' | 'lg';
 /**
  * Overlay dialog with two-way `open`:
@@ -539,12 +613,17 @@ type StrctModalSize = 'sm' | 'md' | 'lg';
 declare class StrctModal {
     private readonly elementRef;
     private readonly doc;
+    /** Whether the panel is open (two-way). */
     readonly open: _angular_core.ModelSignal<boolean>;
+    /** Dialog title. */
     readonly title: _angular_core.InputSignal<string>;
+    /** Size variant. */
     readonly size: _angular_core.InputSignal<StrctModalSize>;
+    /** Hide the footer slot. */
     readonly hideFooter: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Allow closing via backdrop click / Escape. */
-    readonly dismissable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Emitted when the alert is dismissed. */
     readonly closed: _angular_core.OutputEmitterRef<void>;
     protected readonly titleId: string;
     /** Element that had focus before the dialog opened, restored on close. */
@@ -561,7 +640,7 @@ declare class StrctModal {
     private focusable;
     private focusInitial;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctModal, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctModal, "strct-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "hideFooter": { "alias": "hideFooter"; "required": false; "isSignal": true; }; "dismissable": { "alias": "dismissable"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*", "[strctModalFooter]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctModal, "strct-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "hideFooter": { "alias": "hideFooter"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*", "[strctModalFooter]"], true, never>;
 }
 
 /**
@@ -569,12 +648,13 @@ declare class StrctModal {
  *   <strct-dropdown align="end">
  *     <button strct-button strctDropdownTrigger>Actions</button>
  *     <strct-dropdown-item>Rename</strct-dropdown-item>
- *     <strct-dropdown-item danger>Delete</strct-dropdown-item>
+ *     <strct-dropdown-item critical>Delete</strct-dropdown-item>
  *   </strct-dropdown>
  */
 declare class StrctDropdown {
     private readonly host;
-    readonly align: _angular_core.InputSignal<"end" | "start">;
+    /** Horizontal alignment of the menu. */
+    readonly align: _angular_core.InputSignal<"start" | "end">;
     readonly open: _angular_core.WritableSignal<boolean>;
     toggle(): void;
     close(): void;
@@ -585,10 +665,12 @@ declare class StrctDropdown {
 }
 /** A selectable row inside a `<strct-dropdown>`. */
 declare class StrctDropdownItem {
-    readonly danger: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Danger. */
+    readonly critical: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Static disable flag. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDropdownItem, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDropdownItem, "strct-dropdown-item", never, { "danger": { "alias": "danger"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDropdownItem, "strct-dropdown-item", never, { "critical": { "alias": "critical"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 /** Thin separator between groups of menu items. */
 declare class StrctDropdownDivider {
@@ -603,7 +685,7 @@ declare class StrctDropdownDivider {
  *     <div>Right-click here</div>
  *     <ng-container strctContextMenuItems>
  *       <strct-dropdown-item>Open</strct-dropdown-item>
- *       <strct-dropdown-item danger>Delete</strct-dropdown-item>
+ *       <strct-dropdown-item critical>Delete</strct-dropdown-item>
  *     </ng-container>
  *   </strct-context-menu>
  */
@@ -634,6 +716,7 @@ declare class StrctContextMenu {
  */
 declare class StrctSubmenu {
     private readonly host;
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
     /** Optional leading icon; when omitted the icon column is still reserved so
      *  the label stays aligned with sibling items that do have icons. */
@@ -648,6 +731,7 @@ declare class StrctSubmenu {
 
 /** A single wizard step. `label` names it in the step header. */
 declare class StrctStep {
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
     /** When false, the wizard's Next / Finish is disabled on this step. */
     readonly canAdvance: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -668,7 +752,9 @@ declare class StrctWizard {
     readonly submitting: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Show a Cancel button on the left. */
     readonly cancelable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Emitted when the user clicks Finish. */
     readonly finished: _angular_core.OutputEmitterRef<void>;
+    /** Emitted when the user clicks Cancel. */
     readonly cancelled: _angular_core.OutputEmitterRef<void>;
     /** Emits the new step index after a Back / Next move. */
     readonly stepChange: _angular_core.OutputEmitterRef<number>;
@@ -690,6 +776,7 @@ declare class StrctWizard {
  *   <strct-divider vertical />
  */
 declare class StrctDivider {
+    /** Render as a vertical rule. */
     readonly vertical: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDivider, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDivider, "strct-divider", never, { "vertical": { "alias": "vertical"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -702,6 +789,7 @@ declare class StrctBreadcrumb {
 }
 /** One crumb. Mark the final one `current`. */
 declare class StrctBreadcrumbItem {
+    /** Mark as the current page. */
     readonly current: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctBreadcrumbItem, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctBreadcrumbItem, "strct-breadcrumb-item", never, { "current": { "alias": "current"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -713,8 +801,11 @@ type PageToken = number | 'dots';
  *   <strct-pagination [total]="240" [pageSize]="20" [(page)]="page" />
  */
 declare class StrctPagination {
+    /** Total number of items. */
     readonly total: _angular_core.InputSignal<number>;
+    /** Rows per page (0 disables paging). */
     readonly pageSize: _angular_core.InputSignal<number>;
+    /** Current page (two-way). */
     readonly page: _angular_core.ModelSignal<number>;
     readonly pageCount: _angular_core.Signal<number>;
     protected readonly pages: _angular_core.Signal<PageToken[]>;
@@ -733,8 +824,11 @@ declare class StrctPagination {
  *   </strct-field>
  */
 declare class StrctField {
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
+    /** Show a required marker on the label. */
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Helper text shown below the field. */
     readonly hint: _angular_core.InputSignal<string>;
     /** Error message (string or first-of array); falsy clears the error state. */
     readonly error: _angular_core.InputSignal<string | string[] | null | undefined>;
@@ -823,7 +917,9 @@ declare class StrctRadioGroup implements ControlValueAccessor {
 }
 /** One option inside a `<strct-radio-group>`. */
 declare class StrctRadio {
+    /** Current value. */
     readonly value: _angular_core.InputSignal<unknown>;
+    /** Static disable flag. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     protected readonly group: StrctRadioGroup;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctRadio, never>;
@@ -835,10 +931,15 @@ declare class StrctRadio {
  *   <strct-range [min]="0" [max]="100" [(ngModel)]="volume" showValue />
  */
 declare class StrctRange implements ControlValueAccessor {
+    /** Minimum allowed value. */
     readonly min: _angular_core.InputSignal<number>;
+    /** Maximum allowed value or top of the value axis. */
     readonly max: _angular_core.InputSignal<number>;
+    /** Step increment. */
     readonly step: _angular_core.InputSignal<number>;
+    /** Display the current numeric value. */
     readonly showValue: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Static disable flag. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly value: _angular_core.WritableSignal<number>;
     readonly isDisabled: _angular_core.WritableSignal<boolean>;
@@ -860,8 +961,11 @@ declare class StrctRange implements ControlValueAccessor {
  *   <strct-password [(ngModel)]="pw" meter />
  */
 declare class StrctPassword implements ControlValueAccessor {
+    /** Placeholder text when empty. */
     readonly placeholder: _angular_core.InputSignal<string>;
+    /** Show a strength meter. */
     readonly meter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Static disable flag. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly value: _angular_core.WritableSignal<string>;
     readonly revealed: _angular_core.WritableSignal<boolean>;
@@ -887,8 +991,11 @@ declare class StrctPassword implements ControlValueAccessor {
  *   <strct-file [(ngModel)]="files" multiple accept="image/*" />
  */
 declare class StrctFile implements ControlValueAccessor {
+    /** Multiple. */
     readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Accept. */
     readonly accept: _angular_core.InputSignal<string>;
+    /** Static disable flag. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly files: _angular_core.WritableSignal<File[]>;
     readonly dragging: _angular_core.WritableSignal<boolean>;
@@ -911,8 +1018,11 @@ declare class StrctFile implements ControlValueAccessor {
 
 /** Star rating input. CVA value is the selected count (0–max). */
 declare class StrctRating implements ControlValueAccessor {
+    /** Maximum allowed value or top of the value axis. */
     readonly max: _angular_core.InputSignal<number>;
+    /** Size variant. */
     readonly size: _angular_core.InputSignal<number>;
+    /** Prevent user interaction. */
     readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly value: _angular_core.WritableSignal<number>;
     readonly hover: _angular_core.WritableSignal<number>;
@@ -935,7 +1045,9 @@ declare class StrctRating implements ControlValueAccessor {
  *   <strct-chips [(ngModel)]="labels" placeholder="Add a tag…" />
  */
 declare class StrctChips implements ControlValueAccessor {
+    /** Placeholder text when empty. */
     readonly placeholder: _angular_core.InputSignal<string>;
+    /** Allow duplicate tags. */
     readonly allowDuplicates: _angular_core.InputSignal<boolean>;
     readonly value: _angular_core.WritableSignal<string[]>;
     readonly draft: _angular_core.WritableSignal<string>;
@@ -961,7 +1073,9 @@ declare class StrctChips implements ControlValueAccessor {
  */
 declare class StrctInputOtp implements ControlValueAccessor {
     private readonly host;
+    /** Number of OTP boxes. */
     readonly length: _angular_core.InputSignal<number>;
+    /** Mask each box as a password dot. */
     readonly masked: _angular_core.InputSignal<boolean>;
     readonly slots: _angular_core.WritableSignal<string[]>;
     readonly isDisabled: _angular_core.WritableSignal<boolean>;
@@ -982,7 +1096,8 @@ declare class StrctInputOtp implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctInputOtp, "strct-input-otp", never, { "length": { "alias": "length"; "required": false; "isSignal": true; }; "masked": { "alias": "masked"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type StrctKnobStatus = 'accent' | 'success' | 'warning' | 'danger';
+/** Knob accent color variants. */
+type StrctKnobStatus = 'accent' | 'success' | 'warning' | 'critical';
 /**
  * Rotary dial input. Drag (up/down), arrow keys, Home/End or the wheel change
  * the value. CVA-compatible.
@@ -990,12 +1105,19 @@ type StrctKnobStatus = 'accent' | 'success' | 'warning' | 'danger';
  */
 declare class StrctKnob implements ControlValueAccessor {
     private readonly elementRef;
+    /** Minimum allowed value. */
     readonly min: _angular_core.InputSignal<number>;
+    /** Maximum allowed value or top of the value axis. */
     readonly max: _angular_core.InputSignal<number>;
+    /** Step increment. */
     readonly step: _angular_core.InputSignal<number>;
+    /** Size variant. */
     readonly size: _angular_core.InputSignal<number>;
+    /** Stroke thickness in pixels. */
     readonly thickness: _angular_core.InputSignal<number>;
+    /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctKnobStatus>;
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
     readonly value: _angular_core.WritableSignal<number>;
     readonly isDisabled: _angular_core.WritableSignal<boolean>;
@@ -1044,7 +1166,9 @@ declare const STRCT_MASKS: {
  *   <strct-input-mask mask="HH:HH:HH:HH:HH:HH" uppercase [(ngModel)]="mac" />
  */
 declare class StrctInputMask implements ControlValueAccessor {
+    /** Mask pattern (9=digit, A=letter, H=hex, *=alnum). */
     readonly mask: _angular_core.InputSignal<string>;
+    /** Placeholder text when empty. */
     readonly placeholder: _angular_core.InputSignal<string>;
     /** Upper-case entered letters (handy for hex MAC / WWPN). */
     readonly uppercase: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1064,6 +1188,7 @@ declare class StrctInputMask implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctInputMask, "strct-input-mask", never, { "mask": { "alias": "mask"; "required": true; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "uppercase": { "alias": "uppercase"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One option in a combobox or similar list. */
 interface StrctOption {
     value: unknown;
     label: string;
@@ -1076,8 +1201,12 @@ interface StrctOption {
 declare class StrctCombobox implements ControlValueAccessor {
     private readonly host;
     protected readonly listId: string;
+    /** Available options. */
     readonly options: _angular_core.InputSignal<StrctOption[]>;
+    /** Placeholder text when empty. */
     readonly placeholder: _angular_core.InputSignal<string>;
+    /** Show a skeleton placeholder while options are loading. */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly query: _angular_core.WritableSignal<string>;
     readonly value: _angular_core.WritableSignal<unknown>;
     readonly open: _angular_core.WritableSignal<boolean>;
@@ -1103,7 +1232,7 @@ declare class StrctCombobox implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCombobox, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCombobox, "strct-combobox", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCombobox, "strct-combobox", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface DayCell {
@@ -1117,6 +1246,7 @@ interface DayCell {
  */
 declare class StrctDatepicker implements ControlValueAccessor {
     private readonly host;
+    /** Placeholder text when empty. */
     readonly placeholder: _angular_core.InputSignal<string>;
     protected readonly dow: string[];
     readonly value: _angular_core.WritableSignal<string>;
@@ -1154,6 +1284,7 @@ declare class StrctDatepicker implements ControlValueAccessor {
  */
 declare class StrctColorPicker implements ControlValueAccessor {
     private readonly host;
+    /** Custom palette swatches. */
     readonly swatches: _angular_core.InputSignal<string[]>;
     readonly value: _angular_core.WritableSignal<string>;
     readonly draft: _angular_core.WritableSignal<string>;
@@ -1176,6 +1307,7 @@ declare class StrctColorPicker implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctColorPicker, "strct-color-picker", never, { "swatches": { "alias": "swatches"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One option in a cascade select. */
 interface StrctCascadeOption {
     label: string;
     value?: unknown;
@@ -1192,6 +1324,7 @@ declare abstract class StrctCascadeHost {
  */
 declare class StrctCascadeNode {
     private readonly host;
+    /** Option. */
     readonly option: _angular_core.InputSignal<StrctCascadeOption>;
     readonly open: _angular_core.WritableSignal<boolean>;
     protected readonly hasChildren: _angular_core.Signal<boolean>;
@@ -1207,7 +1340,9 @@ declare class StrctCascadeNode {
  */
 declare class StrctCascadeSelect extends StrctCascadeHost implements ControlValueAccessor {
     private readonly elementRef;
+    /** Available options. */
     readonly options: _angular_core.InputSignal<StrctCascadeOption[]>;
+    /** Placeholder text when empty. */
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly value: _angular_core.WritableSignal<unknown>;
     readonly open: _angular_core.WritableSignal<boolean>;
@@ -1229,12 +1364,14 @@ declare class StrctCascadeSelect extends StrctCascadeHost implements ControlValu
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCascadeSelect, "strct-cascade-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Column definition for the table. */
 interface StrctColumn {
     key: string;
     label: string;
     align?: 'start' | 'center' | 'end';
     width?: string;
 }
+/** Shorthand for a record-shaped table/datagrid row. */
 type StrctRow = Record<string, unknown>;
 /** Context passed to a per-column cell template. */
 interface StrctCellContext {
@@ -1250,10 +1387,11 @@ interface StrctCellContext {
  * is the directive value; the row, value and column are the template context:
  *
  *   <ng-template strctCell="status" let-row let-value="value">
- *     <strct-badge [status]="row['ok'] ? 'success' : 'danger'">{{ value }}</strct-badge>
+ *     <strct-badge [status]="row['success'] ? 'success' : 'critical'">{{ value }}</strct-badge>
  *   </ng-template>
  */
 declare class StrctCellDef {
+    /** Key. */
     readonly key: _angular_core.InputSignal<string>;
     readonly template: TemplateRef<StrctCellContext>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCellDef, never>;
@@ -1265,20 +1403,28 @@ declare class StrctCellDef {
  *   <strct-table [columns]="cols" [rows]="data" hover />
  */
 declare class StrctTable {
+    /** Column definitions. */
     readonly columns: _angular_core.InputSignal<StrctColumn[]>;
+    /** Data rows. */
     readonly rows: _angular_core.InputSignal<StrctRow[]>;
+    /** Enable zebra-striping. */
     readonly striped: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Highlight rows on hover. */
     readonly hover: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Message shown when there are no rows. */
     readonly emptyText: _angular_core.InputSignal<string>;
+    /** Show skeleton rows while data is loading. */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly cellDefs;
     private readonly cellMap;
     protected cellTemplate(key: string): TemplateRef<StrctCellContext> | null;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctTable, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTable, "strct-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "striped": { "alias": "striped"; "required": false; "isSignal": true; }; "hover": { "alias": "hover"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; }, {}, ["cellDefs"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTable, "strct-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "striped": { "alias": "striped"; "required": false; "isSignal": true; }; "hover": { "alias": "hover"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, ["cellDefs"], never, true, never>;
 }
 
 /** Resolves a stable identity for a row: a property key, or a function. */
 type StrctRowId = string | ((row: StrctRow) => unknown);
+/** Column definition for the datagrid. */
 interface StrctDatagridColumn {
     key: string;
     label: string;
@@ -1309,23 +1455,32 @@ declare class StrctDatagridActionBar {
  *   </strct-datagrid>
  */
 declare class StrctDatagrid {
+    /** Column definitions. */
     readonly columns: _angular_core.InputSignal<StrctDatagridColumn[]>;
+    /** Data rows. */
     readonly rows: _angular_core.InputSignal<StrctRow[]>;
+    /** Rows per page (0 disables paging). */
     readonly pageSize: _angular_core.InputSignal<number>;
+    /** Enable row selection. */
     readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Expand a row in place to reveal its detail template below it. */
     readonly expandable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Collapse the grid to a single column and open a side detail pane for the
      *  clicked row (distinct from {@link expandable}). */
     readonly detailPane: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Compact density mode. */
     readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Message shown when there are no rows. */
     readonly emptyText: _angular_core.InputSignal<string>;
+    /** Show skeleton rows while data is loading. */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Stable row identity (property key or function). Set this for live-refreshing
      * data so selection, expansion and the active detail row survive re-fetches
      * that replace the row objects. Defaults to object identity.
      */
     readonly rowId: _angular_core.InputSignal<StrctRowId | null>;
+    /** Emitted when the selection changes. */
     readonly selectionChange: _angular_core.OutputEmitterRef<StrctRow[]>;
     protected readonly detailDef: _angular_core.Signal<StrctRowDetailDef | undefined>;
     protected readonly actionBarDef: _angular_core.Signal<StrctDatagridActionBar | undefined>;
@@ -1373,10 +1528,11 @@ 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; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, ["detailDef", "actionBarDef", "cellDefs"], ["[strctDatagridActionBar]", "[strctDatagridActions]"], 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; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, ["detailDef", "actionBarDef", "cellDefs"], ["[strctDatagridActionBar]", "[strctDatagridActions]"], true, never>;
 }
 
-type StrctTimelineState = 'default' | 'current' | 'success' | 'warning' | 'danger';
+/** Timeline node state colors. */
+type StrctTimelineState = 'default' | 'current' | 'success' | 'warning' | 'critical';
 /** Vertical timeline container. Wraps `<strct-timeline-item>` children. */
 declare class StrctTimeline {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctTimeline, never>;
@@ -1384,7 +1540,9 @@ declare class StrctTimeline {
 }
 /** A timeline entry: a node on the rail plus a title and projected body. */
 declare class StrctTimelineItem {
+    /** Dialog title. */
     readonly title: _angular_core.InputSignal<string>;
+    /** State. */
     readonly state: _angular_core.InputSignal<StrctTimelineState>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctTimelineItem, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTimelineItem, "strct-timeline-item", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -1397,20 +1555,27 @@ declare class StrctStack {
 }
 /** A label + value row. The value is projected content. */
 declare class StrctStackItem {
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctStackItem, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctStackItem, "strct-stack-item", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-type StrctChartStatus = 'accent' | 'success' | 'warning' | 'danger';
+/** Chart / gauge / sparkline status colors. */
+type StrctChartStatus = 'accent' | 'success' | 'warning' | 'critical';
 /**
  * Tiny inline trend line. `<strct-sparkline [data]="[3,5,4,8,6,9]" area />`.
  */
 declare class StrctSparkline {
+    /** Data array. */
     readonly data: _angular_core.InputSignal<number[]>;
+    /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctChartStatus>;
+    /** Fill the area under the line. */
     readonly area: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Width (CSS length). */
     readonly width: _angular_core.InputSignal<number>;
+    /** Height in pixels. */
     readonly height: _angular_core.InputSignal<number>;
     protected readonly color: _angular_core.Signal<string>;
     private readonly points;
@@ -1420,16 +1585,22 @@ declare class StrctSparkline {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSparkline, "strct-sparkline", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "area": { "alias": "area"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Chart rendering types (line, area, bar). */
 type StrctChartType = 'line' | 'area' | 'bar';
 /**
  * Single-series chart (line / area / bar). Dependency-free SVG, token-coloured.
  *   <strct-chart [data]="cpu" type="area" [labels]="hours" status="warning" />
  */
 declare class StrctChart {
+    /** Data array. */
     readonly data: _angular_core.InputSignal<number[]>;
+    /** Visual type / variant. */
     readonly type: _angular_core.InputSignal<StrctChartType>;
+    /** X-axis labels. */
     readonly labels: _angular_core.InputSignal<string[]>;
+    /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctChartStatus>;
+    /** Height in pixels. */
     readonly height: _angular_core.InputSignal<number>;
     /** Override the top of the value axis (defaults to the data max + headroom). */
     readonly max: _angular_core.InputSignal<number | null>;
@@ -1460,6 +1631,7 @@ declare class StrctChart {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctChart, "strct-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** A single weighted slice of a donut chart. */
 interface StrctDonutSegment {
     value: number;
     label?: string;
@@ -1471,10 +1643,15 @@ interface StrctDonutSegment {
  *                centerValue="8" centerLabel="VMs" />
  */
 declare class StrctDonut {
+    /** Weighted segments. */
     readonly segments: _angular_core.InputSignal<StrctDonutSegment[]>;
+    /** Size variant. */
     readonly size: _angular_core.InputSignal<number>;
+    /** Stroke thickness in pixels. */
     readonly thickness: _angular_core.InputSignal<number>;
+    /** Value shown in the donut center. */
     readonly centerValue: _angular_core.InputSignal<string | number>;
+    /** Label shown in the donut center. */
     readonly centerLabel: _angular_core.InputSignal<string>;
     protected readonly half: _angular_core.Signal<number>;
     protected readonly radius: _angular_core.Signal<number>;
@@ -1493,10 +1670,15 @@ declare class StrctDonut {
  *   <strct-gauge [value]="72" status="warning" label="CPU" />
  */
 declare class StrctGauge {
+    /** Current value. */
     readonly value: _angular_core.InputSignal<number>;
+    /** Visual status color. */
     readonly status: _angular_core.InputSignal<StrctChartStatus>;
+    /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
+    /** Size variant. */
     readonly size: _angular_core.InputSignal<number>;
+    /** Stroke thickness in pixels. */
     readonly thickness: _angular_core.InputSignal<number>;
     protected readonly clamped: _angular_core.Signal<number>;
     protected readonly half: _angular_core.Signal<number>;
@@ -1509,17 +1691,22 @@ declare class StrctGauge {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctGauge, "strct-gauge", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type StrctAlertType = 'info' | 'success' | 'warning' | 'danger';
+/** Alert visual types. */
+type StrctAlertType = 'info' | 'success' | 'warning' | 'critical';
 /** Inline contextual banner. `<strct-alert type="warning">…</strct-alert>`. */
 declare class StrctAlert {
+    /** Visual type / variant. */
     readonly type: _angular_core.InputSignal<StrctAlertType>;
+    /** Show a dismiss button. */
     readonly closable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Emitted when the alert is dismissed. */
     readonly closed: _angular_core.OutputEmitterRef<void>;
-    protected readonly icon: _angular_core.Signal<"info" | "success" | "warning" | "danger">;
+    protected readonly icon: _angular_core.Signal<"success" | "warning" | "critical" | "info">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctAlert, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctAlert, "strct-alert", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*"], true, never>;
 }
 
+/** Tooltip placement relative to the host element. */
 type StrctTooltipPosition = 'top' | 'bottom' | 'left' | 'right';
 /**
  * Lightweight hover/focus tooltip. Renders a fixed-positioned bubble so it is
@@ -1531,7 +1718,9 @@ declare class StrctTooltip {
     private readonly renderer;
     private readonly doc;
     private bubble;
+    /** Tooltip text. */
     readonly strctTooltip: _angular_core.InputSignal<string>;
+    /** Tooltip placement relative to the host. */
     readonly tooltipPosition: _angular_core.InputSignal<StrctTooltipPosition>;
     protected show(): void;
     protected hide(): void;
@@ -1540,6 +1729,7 @@ declare class StrctTooltip {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctTooltip, "[strctTooltip]", never, { "strctTooltip": { "alias": "strctTooltip"; "required": true; "isSignal": true; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Signpost popover placement. */
 type StrctSignpostPosition = 'top' | 'bottom' | 'left' | 'right';
 /**
  * A click-triggered popover with an arrow, for contextual help / detail.
@@ -1551,6 +1741,7 @@ type StrctSignpostPosition = 'top' | 'bottom' | 'left' | 'right';
  */
 declare class StrctSignpost {
     private readonly host;
+    /** Popover placement relative to the trigger. */
     readonly position: _angular_core.InputSignal<StrctSignpostPosition>;
     readonly open: _angular_core.WritableSignal<boolean>;
     toggle(): void;
@@ -1562,7 +1753,9 @@ declare class StrctSignpost {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSignpost, "strct-signpost", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; }, {}, never, ["[strctSignpostTrigger]", "*"], true, never>;
 }
 
-type StrctToastType = 'info' | 'success' | 'warning' | 'danger';
+/** Toast visual types. */
+type StrctToastType = 'info' | 'success' | 'warning' | 'critical';
+/** A single toast notification. */
 interface StrctToast {
     id: number;
     type: StrctToastType;
@@ -1570,6 +1763,7 @@ interface StrctToast {
     /** Auto-dismiss after this many ms; 0 keeps it until dismissed. */
     duration: number;
 }
+/** Options passed when creating a toast. */
 interface StrctToastOptions {
     type?: StrctToastType;
     duration?: number;
@@ -1587,7 +1781,7 @@ declare class StrctToastService {
     info(message: string, duration?: number): number;
     success(message: string, duration?: number): number;
     warning(message: string, duration?: number): number;
-    danger(message: string, duration?: number): number;
+    critical(message: string, duration?: number): number;
     dismiss(id: number): void;
     clear(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctToastService, never>;
@@ -1601,5 +1795,5 @@ declare class StrctToastOutlet {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctToastOutlet, "strct-toast-outlet", never, {}, {}, never, never, true, never>;
 }
 
-export { STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_MASKS, STRCT_PALETTES, STRCT_RAW_ICONS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCascadeHost, StrctCascadeNode, StrctCascadeSelect, StrctCellDef, StrctChart, StrctCheckbox, StrctChips, StrctColorPicker, StrctCombobox, StrctContextMenu, StrctContextMenuTrigger, StrctDatagrid, StrctDatagridActionBar, StrctDatepicker, StrctDivider, StrctDonut, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctField, StrctFile, StrctFooter, StrctGauge, StrctHeader, StrctIcon, StrctInput, StrctInputMask, StrctInputOtp, StrctKnob, StrctLogin, StrctMenuPanel, StrctModal, StrctNav, StrctNavItem, StrctOverlay, StrctPagination, StrctPassword, StrctProgress, StrctRadio, StrctRadioGroup, StrctRange, StrctRating, StrctRowDetailDef, StrctShell, StrctSignpost, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctStack, StrctStackItem, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctTooltip, StrctTree, StrctTreeNode, StrctVerticalNav, StrctWizard, registerStrctIcon };
+export { STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_MASKS, STRCT_PALETTES, STRCT_RAW_ICONS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCascadeHost, StrctCascadeNode, StrctCascadeSelect, StrctCellDef, StrctChart, StrctCheckbox, StrctChips, StrctColorPicker, StrctCombobox, StrctContextMenu, StrctContextMenuTrigger, StrctDatagrid, StrctDatagridActionBar, StrctDatepicker, StrctDivider, StrctDonut, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctField, StrctFile, StrctFooter, StrctGauge, StrctHeader, StrctIcon, StrctInput, StrctInputMask, StrctInputOtp, StrctKnob, StrctLogin, StrctMenuPanel, StrctModal, StrctNav, StrctNavItem, StrctOverlay, StrctPagination, StrctPassword, StrctProgress, StrctRadio, StrctRadioGroup, StrctRange, StrctRating, StrctRowDetailDef, StrctShell, StrctShellService, StrctSignpost, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctStack, StrctStackItem, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctTooltip, StrctTree, StrctTreeNode, StrctVerticalNav, StrctWizard, registerStrctIcon };
 export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartStatus, StrctChartType, StrctColumn, StrctDatagridColumn, StrctDonutSegment, StrctIconBadge, StrctKnobStatus, StrctMenuItem, StrctModalSize, StrctMode, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressStatus, StrctRow, StrctRowId, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctTagStatus, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn };