@akcelik/strct 5.1.0 → 5.2.0

package/package.json

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

@@ -3776,6 +3776,8 @@ interface StrctDatagridLabels {
     filterPlaceholder: string;
     clearFilter: string;
     editCell: string;
+    /** How an editable cell says, to assistive tech, that it can be edited. */
+    editCellInstructions: string;
     toggleChildren: string;
     quickFilter: string;
     /** `paging="more"`: the button that asks for the next slice. */
@@ -3982,6 +3984,14 @@ declare class StrctDatagrid {
      * selection; the user's subsequent toggles are preserved until the next change.
      */
     readonly initialSelection: _angular_core.InputSignal<readonly unknown[] | null>;
+    /**
+     * The selection itself, two-way, for `selectionMode="multiple"` — what
+     * `selectedId` is for single mode. Write it and the grid checks those rows
+     * and counts them; the user's own picks write back, in the order they were
+     * made. `null` (the default) means the consumer does not drive the
+     * selection, so a grid that only seeds with `initialSelection` is unchanged.
+     */
+    readonly selectedIds: _angular_core.ModelSignal<readonly unknown[] | null>;
     /** Override any user-visible / assistive string (partial; merged over defaults). */
     readonly labels: _angular_core.InputSignal<Partial<StrctDatagridLabels>>;
     /** Effective labels (defaults + overrides). */
@@ -4004,6 +4014,7 @@ declare class StrctDatagrid {
         filterPlaceholder: string;
         clearFilter: string;
         editCell: string;
+        editCellInstructions: string;
         toggleChildren: string;
         quickFilter: string;
         loadMore: string;
@@ -4018,6 +4029,17 @@ declare class StrctDatagrid {
     readonly virtual: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Scroll viewport height in px (virtual mode). */
     readonly viewportHeight: _angular_core.InputSignal<number>;
+    /**
+     * Bound the grid's own scroll box (px), with a sticky header — what
+     * `viewportHeight` does for `virtual`, for every other grid: a grouped
+     * picker inside a dialog scrolls instead of growing the page.
+     */
+    readonly maxHeight: _angular_core.InputSignal<number | null>;
+    /**
+     * Show a pencil on an editable cell when it is hovered or focused. A mouse
+     * user finds an editable cell by double-clicking one; nothing said so.
+     */
+    readonly editHint: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Uniform row height in px (virtual mode; tune when `compact`). */
     readonly rowHeight: _angular_core.InputSignal<number>;
     /**
@@ -4112,6 +4134,8 @@ declare class StrctDatagrid {
     private readonly menu;
     protected readonly detailDef: _angular_core.Signal<StrctRowDetailDef | undefined>;
     protected readonly actionBarDef: _angular_core.Signal<StrctDatagridActionBar | undefined>;
+    /** A read-only grid with a note needed an empty action bar to show it. */
+    protected readonly actionBarCaptionDef: _angular_core.Signal<StrctDatagridActionBarCaption | undefined>;
     private readonly cellDefs;
     private readonly cellMap;
     readonly page: _angular_core.WritableSignal<number>;
@@ -4197,6 +4221,36 @@ declare class StrctDatagrid {
     protected isEditingCell(row: StrctRow, col: StrctDatagridColumn): boolean;
     /** The value a typed editor holds while it is open (committed on Enter / blur). */
     protected readonly editDraft: _angular_core.WritableSignal<unknown>;
+    /**
+     * Keyboard access to editable cells (FR-49-02). An editable cell opened only
+     * on double-click, so a keyboard user could not reach one at all.
+     *
+     * The editable cells of a grid form one roving tab stop, as a toolbar's
+     * buttons do: Tab reaches the grid, the arrow keys move between cells,
+     * Enter or F2 opens the editor and Escape closes it — focus coming back to
+     * the cell either way, so the next key press continues from where the user
+     * was. While an editor is open, Tab commits it and opens the next cell, the
+     * way a spreadsheet fills a row.
+     */
+    protected readonly editHintId: string;
+    /** The cell that currently holds the grid's editable-cell tab stop. */
+    private readonly activeEditCell;
+    private readonly editableColumns;
+    protected readonly hasEditableColumn: _angular_core.Signal<boolean>;
+    protected editCellTabindex(row: StrctRow, col: StrctDatagridColumn): number;
+    protected onEditCellFocus(row: StrctRow, col: StrctDatagridColumn): void;
+    /** Every editable cell in DOM order — the order the arrows walk. */
+    private editCells;
+    /**
+     * Move focus `delta` cells along (or `delta` rows, when `byRow`). Focusing
+     * the cell runs its own focus handler, so the roving tab stop follows.
+     */
+    private moveEditFocus;
+    /** Commit whatever the open editor holds, by the kind of editor it is. */
+    private commitOpenEditor;
+    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;
     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. */
@@ -4241,6 +4295,12 @@ declare class StrctDatagrid {
     private readonly treeFlat;
     protected readonly sorted: _angular_core.Signal<StrctRow[]>;
     protected readonly paged: _angular_core.Signal<StrctRow[]>;
+    /**
+     * The footer exists for the count, the column chooser, the sync button and
+     * whichever pager applies — `paging="more"` used to replace all of it, and a
+     * chooser on a grid with no pager had nowhere to live.
+     */
+    protected readonly showFooter: _angular_core.Signal<boolean>;
     /** Full count for the pager / footer (server total in lazy mode). */
     protected readonly totalCount: _angular_core.Signal<number>;
     private readonly scrollTop;
@@ -4368,7 +4428,7 @@ 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; }; "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; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "viewportHeight": { "alias": "viewportHeight"; "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"; "columnState": "columnStateChange"; "filters": "filtersChange"; "quickFilter": "quickFilterChange"; "selectionChange": "selectionChange"; "syncChange": "syncChange"; "rowAction": "rowAction"; "lazyLoad": "lazyLoad"; "cellEdit": "cellEdit"; }, ["detailDef", "actionBarDef", "cellDefs"], ["[strctDatagridActionBarCaption]", "[strctDatagridActionBar]"], 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; }; "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>;
 }
 
 /** Timeline node state colors. */