@akcelik/strct 5.7.0 → 5.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "5.7.0",
+  "version": "5.9.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,27 @@ interface StrctDatagridColumn {
      */
     editor?: 'text' | 'number' | 'select';
     /** Options for `editor: 'select'` (the library's own option shape). */
-    editorOptions?: StrctOption[];
+    /**
+     * What this column sorts by, when the cell does not show it: "1.5 TB" is
+     * sorted by its bytes, a formatted date by its timestamp. `null` and `''`
+     * are "unread" and sort last in both directions.
+     */
+    sortValue?: (row: StrctRow) => unknown;
+    /** Full control of the order, when a key is not enough. Wins over `sortValue`. */
+    comparator?: (a: StrctRow, b: StrctRow) => number;
+    /** What an export writes for this column; defaults to the stored value. */
+    exportValue?: (row: StrctRow) => unknown;
+    /**
+     * Hidden until the chooser is asked for it — the column exists, it is just
+     * not one of the defaults. A persisted or bound `columnState` wins.
+     */
+    hidden?: boolean;
+    /**
+     * 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;
@@ -3930,6 +3977,9 @@ interface StrctDatagridColumnState {
     widths?: Record<string, number>;
     hidden?: string[];
     order?: string[];
+    /** The column the operator sorted by, and which way. */
+    sortKey?: string | null;
+    sortDir?: 'asc' | 'desc';
 }
 /** One rendered tbody item: a data row, or a group header. */
 interface DgItem {
@@ -4325,6 +4375,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. */
@@ -4439,11 +4491,28 @@ declare class StrctDatagrid {
     constructor();
     private readPersistedState;
     private applyColumnState;
+    /** Whether a persisted or bound state has already decided what is hidden. */
+    private hiddenDecidedByState;
+    /** Whether the columns' own `hidden` flags have been read (once). */
+    private declaredHiddenApplied;
+    /**
+     * Columns the consumer declared hidden — the default for a column no state
+     * mentions. A list that shows five of twenty columns says so on the columns,
+     * rather than seeding `columnState` and reaching into the library's storage
+     * key to keep from overriding what the operator chose.
+     */
+    private applyDeclaredHidden;
     /**
      * The grid as CSV: header labels + every non-hidden column, all rows in the
      * current order (client mode: the full sorted set, not just the page).
      */
     toCSV(): string;
+    /**
+     * What an export writes for a cell: what the column says, else the stored
+     * value. A templated cell shows "2 h 15 m" and stored 8100; without this the
+     * export carries the seconds, an enum code or a bare `true`.
+     */
+    private exportValueOf;
     /**
      * The grid as a real .xlsx workbook (dependency-free SpreadsheetML):
      * header labels + every non-hidden column in the current order, all rows in
@@ -4502,6 +4571,17 @@ declare class StrctDatagrid {
     /** Emit every selected row: fresh objects from the latest data where
      *  available, the last known snapshot otherwise (off-page lazy rows). */
     private commitSelection;
+    /**
+     * One row's sort key for a column: what the column says to sort by, else the
+     * stored value. A cell that shows "1.5 TB" sorts as text without this, which
+     * puts it before "900 GB"; a date written by toLocaleString sorts across
+     * days and AM/PM by its characters.
+     */
+    private sortKeyOf;
+    /** The column a key belongs to — the comparator and the sort key need it. */
+    private columnOf;
+    /** Compare two rows by a column, honouring its comparator and nulls-last. */
+    private compareRows;
     private compare;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDatagrid, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDatagrid, "strct-datagrid", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "detailPane": { "alias": "detailPane"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "singleLine": { "alias": "singleLine"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; "columnChooser": { "alias": "columnChooser"; "required": false; "isSignal": true; }; "sync": { "alias": "sync"; "required": false; "isSignal": true; }; "footerActionsDisabled": { "alias": "footerActionsDisabled"; "required": false; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "selectedId": { "alias": "selectedId"; "required": false; "isSignal": true; }; "rowSelectable": { "alias": "rowSelectable"; "required": false; "isSignal": true; }; "flush": { "alias": "flush"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "paging": { "alias": "paging"; "required": false; "isSignal": true; }; "hasMore": { "alias": "hasMore"; "required": false; "isSignal": true; }; "loadingMore": { "alias": "loadingMore"; "required": false; "isSignal": true; }; "moreTotal": { "alias": "moreTotal"; "required": false; "isSignal": true; }; "groupSelect": { "alias": "groupSelect"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "initialSelection": { "alias": "initialSelection"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "viewportHeight": { "alias": "viewportHeight"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "editHint": { "alias": "editHint"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "stateKey": { "alias": "stateKey"; "required": false; "isSignal": true; }; "columnState": { "alias": "columnState"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "groupBy": { "alias": "groupBy"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "quickFilter": { "alias": "quickFilter"; "required": false; "isSignal": true; }; "quickFilterFields": { "alias": "quickFilterFields"; "required": false; "isSignal": true; }; "quickFilterable": { "alias": "quickFilterable"; "required": false; "isSignal": true; }; "quickFilterAlign": { "alias": "quickFilterAlign"; "required": false; "isSignal": true; }; "childrenKey": { "alias": "childrenKey"; "required": false; "isSignal": true; }; }, { "selectedId": "selectedIdChange"; "loadMore": "loadMore"; "selectedIds": "selectedIdsChange"; "columnState": "columnStateChange"; "filters": "filtersChange"; "quickFilter": "quickFilterChange"; "selectionChange": "selectionChange"; "syncChange": "syncChange"; "rowAction": "rowAction"; "lazyLoad": "lazyLoad"; "cellEdit": "cellEdit"; }, ["detailDef", "actionBarDef", "actionBarCaptionDef", "cellDefs"], ["[strctDatagridActionBarCaption]", "[strctDatagridActionBar]"], true, never>;
@@ -6544,6 +6624,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 +6846,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 +6930,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 +6955,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 +6974,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. */