@akcelik/strct 5.7.0 → 5.8.0

package/package.json

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

@@ -734,6 +734,11 @@ declare class StrctList {
      * `strct-list-item [wrap]` turns it on for one row.
      */
     readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Drop the rows' inline padding, so a list of statements lines up with the
+     * paragraphs around it instead of sitting 12px inside them.
+     */
+    readonly flush: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Hairline between rows. */
     readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Shown when the list has no items. */
@@ -742,7 +747,7 @@ declare class StrctList {
     readonly label: _angular_core.InputSignal<string>;
     protected readonly items: _angular_core.Signal<readonly StrctListItem[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctList, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctList, "strct-list", never, { "dense": { "alias": "dense"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, ["items"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctList, "strct-list", never, { "dense": { "alias": "dense"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "flush": { "alias": "flush"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, ["items"], ["*"], true, never>;
 }
 
 /** Follows the heading on its line — a badge, a count, a status dot. */
@@ -2526,17 +2531,24 @@ declare class StrctCodeInline {
     readonly value: _angular_core.InputSignal<string>;
     /** Long ids wrap instead of overflowing a narrow card. */
     readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * What the copy button is called. Two spans in the same drawer are both
+     * "Copy" without it; these are "Copy thumbprint" and "Copy serial number".
+     */
+    readonly copyLabel: _angular_core.InputSignal<string>;
     private readonly host;
     private readonly vcr;
     private readonly destroyRef;
     /** The button, once it exists; and a counter the observer bumps. */
     private readonly copyRef;
     private readonly revision;
+    /** The host exists: nothing may be created into it before that. */
+    private readonly rendered;
     constructor();
     /** What the element says, without the copy button's own content. */
     private ownText;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctCodeInline, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctCodeInline, "[strctCode]", never, { "copyable": { "alias": "copyable"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctCodeInline, "[strctCode]", never, { "copyable": { "alias": "copyable"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "copyLabel": { "alias": "copyLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** One active filter chip in a {@link StrctFilterBar}. */
@@ -2645,8 +2657,15 @@ declare class StrctFieldHint {
  * 9px above the label's line, because the column centres on a 34px control.
  */
 declare class StrctFieldValue {
+    /**
+     * What the slot holds. Text (the default) reads on the label's own line; a
+     * `control` — a segmented picker, a small button, a switch with its own box
+     * — is centred where a real control in this column would be, rather than
+     * pushed down by the padding that puts text on the line.
+     */
+    readonly strctFieldValue: _angular_core.InputSignal<"" | "text" | "control">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctFieldValue, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctFieldValue, "[strctFieldValue]", never, {}, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctFieldValue, "[strctFieldValue]", never, { "strctFieldValue": { "alias": "strctFieldValue"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 /**
  * Wrapper that opts a run of `layout="inline"` fields out of the hairlines
@@ -2810,6 +2829,8 @@ declare class StrctToggle implements ControlValueAccessor {
      * `[strctControlDescription]` projects one with markup in it.
      */
     readonly description: _angular_core.InputSignal<string>;
+    /** The switch's accessible name, where no visible label gives it one. */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
     private readonly n;
     protected readonly descId: string;
     protected readonly labelId: string;
@@ -2827,7 +2848,7 @@ declare class StrctToggle implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctToggle, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctToggle, "strct-toggle", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; }, {}, ["projected"], ["[strctControlDescription]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctToggle, "strct-toggle", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, ["projected"], ["[strctControlDescription]", "*"], true, never>;
 }
 
 /**
@@ -3418,6 +3439,12 @@ declare class StrctSelect implements ControlValueAccessor {
     readonly options: _angular_core.InputSignal<StrctOption[]>;
     /** Muted text shown while no value is selected (localizable). */
     readonly placeholder: _angular_core.InputSignal<string>;
+    /**
+     * The control's accessible name, where it is not inside a `strct-field`.
+     * ARIA does not let a `combobox` take its name from its content, so a bare
+     * select — a filter above a list, a cell editor — has none without this.
+     */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
     /** Accessible name of the listbox (localizable). */
     readonly listLabel: _angular_core.InputSignal<string>;
     /** Text shown when `options` is empty (localizable). */
@@ -3464,7 +3491,7 @@ declare class StrctSelect implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSelect, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSelect, "strct-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "listLabel": { "alias": "listLabel"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSelect, "strct-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "listLabel": { "alias": "listLabel"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface DayCell {
@@ -3892,7 +3919,12 @@ interface StrctDatagridColumn {
      */
     editor?: 'text' | 'number' | 'select';
     /** Options for `editor: 'select'` (the library's own option shape). */
-    editorOptions?: StrctOption[];
+    /**
+     * The choices an `editor: 'select'` offers. A function is asked per row: a
+     * rule that holds a value the host no longer reports lists it for that row
+     * only, rather than every row's picker carrying every other row's.
+     */
+    editorOptions?: StrctOption[] | ((row: StrctRow) => StrctOption[]);
     /** Bounds and step for `editor: 'number'`. */
     editorMin?: number;
     editorMax?: number;
@@ -4325,6 +4357,8 @@ declare class StrctDatagrid {
     protected onEditCellKeydown(row: StrctRow, col: StrctDatagridColumn, event: KeyboardEvent): void;
     /** Put focus back on the cell an editor just left, so the keys keep working. */
     private refocusCell;
+    /** A column's choices, asked per row when the column gives a function. */
+    protected editorOptionsFor(row: StrctRow, col: StrctDatagridColumn): StrctOption[];
     protected startEdit(row: StrctRow, col: StrctDatagridColumn): void;
     protected readonly captionId: string;
     /** Whether a cell has nothing to show and the column says what to show then. */
@@ -6544,6 +6578,12 @@ interface StrctLegendItem {
     disabled?: boolean;
     /** Why a `disabled` row cannot be picked; its title and its description. */
     reason?: string;
+    /**
+     * What the row is, for any row — "vm.cpu.wait — CPU ready (written by the
+     * agent)". `reason` is the why-not of a row that cannot be picked; this is
+     * the what of one that can.
+     */
+    description?: string;
 }
 /**
  * A chart's key is a component. The same swatch · label · value rows serve a
@@ -6760,6 +6800,12 @@ declare class StrctWindow {
     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>;
+    /**
+     * Whatever the consumer needs to recognise this window elsewhere — a session
+     * id, the object it shows. The dock passes it to `[strctWindowDockItem]`, so
+     * an app no longer keeps its own window-to-thing index.
+     */
+    readonly data: _angular_core.InputSignal<unknown>;
     /**
      * 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
@@ -6838,7 +6884,7 @@ declare class StrctWindow {
     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; }; "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"; "outsidePointer": "outsidePointer"; }, 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; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "titleDblclick": { "alias": "titleDblclick"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "minimized": "minimizedChange"; "maximized": "maximizedChange"; "bounds": "boundsChange"; "closed": "closed"; "titleDblclicked": "titleDblclicked"; "outsidePointer": "outsidePointer"; }, never, ["[strctWindowTitleMeta]", "[strctWindowActions]", "*", "[strctWindowStatus]"], true, never>;
 }
 /**
  * What a dock chip shows, when the window's heading is not enough — a status
@@ -6863,6 +6909,11 @@ 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>;
+    /**
+     * The name of each chip itself — what restoring it does: "Show the console
+     * of APP02". The window is passed, so its `data` can shape the sentence.
+     */
+    readonly restoreLabel: _angular_core.InputSignal<(w: StrctWindow) => string>;
     /** What each chip shows, when a heading is not enough. */
     protected readonly itemTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
     /**
@@ -6877,7 +6928,7 @@ declare class StrctWindowDock {
     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; }; "restoreMode": { "alias": "restoreMode"; "required": false; "isSignal": true; }; }, { "restoreRequest": "restoreRequest"; }, ["itemTpl"], 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; }; "restoreLabel": { "alias": "restoreLabel"; "required": false; "isSignal": true; }; "restoreMode": { "alias": "restoreMode"; "required": false; "isSignal": true; }; }, { "restoreRequest": "restoreRequest"; }, ["itemTpl"], never, true, never>;
 }
 
 /** Who wrote a message. */