@akcelik/strct 4.7.0 → 4.8.0

package/package.json

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

@@ -3413,6 +3413,8 @@ interface StrctDatagridLabels {
     /** Row-checkbox label factory: receives the row's id (`rowId`) or its
      *  1-based index, so every row's checkbox gets a distinct name. */
     selectRowFor: (id: string) => string;
+    /** Label of a group header's select-all checkbox (`groupSelect`). */
+    selectAllInGroup: (group: string) => string;
     openDetail: string;
     toggleDetail: string;
     closeDetail: string;
@@ -3555,6 +3557,23 @@ declare class StrctDatagrid {
      * that replace the row objects. Defaults to object identity.
      */
     readonly rowId: _angular_core.InputSignal<StrctRowId | null>;
+    /**
+     * How many rows a user may pick. `selectable` remains the boolean for
+     * `multiple`, so nothing changes for a grid that already uses it; picking
+     * exactly one row is grid behaviour rather than a column of radios the
+     * consumer builds and wires by hand.
+     */
+    readonly selectionMode: _angular_core.InputSignal<"none" | "multiple" | "single">;
+    /** Two-way single selection: the row id (per `rowId`), or null. */
+    readonly selectedId: _angular_core.ModelSignal<unknown>;
+    /**
+     * Whether a row may be picked. Return `false` to lock it, or a string to lock
+     * it AND say why — shown as the row's tooltip and given to assistive tech as
+     * the control's description, following the `hint` convention.
+     */
+    readonly rowSelectable: _angular_core.InputSignal<((row: StrctRow) => boolean | string) | null>;
+    /** With `groupBy` and multiple selection: a tri-state checkbox per group. */
+    readonly groupSelect: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Per-row action menu resolver. When set, each row gets a trailing actions
      * column with a vertical-dots (kebab) button that opens this row's menu.
@@ -3578,6 +3597,7 @@ declare class StrctDatagrid {
         selectAll: string;
         selectRow: string;
         selectRowFor: (id: string) => string;
+        selectAllInGroup: (group: string) => string;
         openDetail: string;
         toggleDetail: string;
         closeDetail: string;
@@ -3825,6 +3845,27 @@ declare class StrctDatagrid {
     protected readonly somePageSelected: _angular_core.Signal<boolean>;
     /** Dev-mode check that row identities can do their job (see util/dev-warn). */
     private diagnoseIdentity;
+    /** `selectionMode` wins; `selectable` is the pre-4.8 spelling of 'multiple'. */
+    protected readonly mode: _angular_core.Signal<"none" | "multiple" | "single">;
+    protected readonly hasSelectionColumn: _angular_core.Signal<boolean>;
+    /** One radio group per grid instance. */
+    protected readonly radioName: string;
+    /**
+     * Why a row cannot be picked: `null` when it can, `''` when it cannot with no
+     * reason given, or the reason. A locked row keeps its normal colours — a
+     * locked candidate is still worth reading — and stays reachable, so the
+     * reason can be read.
+     */
+    lockedReason(row: StrctRow): string | null;
+    /** Click anywhere on the row picks it, in single mode only. */
+    protected onRowPick(row: StrctRow): void;
+    /** Pick exactly this row. `selectionChange` still fires, with one element. */
+    selectSingle(row: StrctRow): void;
+    /** Rows of one group that are actually pickable. */
+    private groupRows;
+    protected groupAllSelected(key: unknown): boolean;
+    protected groupSomeSelected(key: unknown): boolean;
+    protected toggleGroupSelection(key: unknown): void;
     /** Resolve a row's stable identity: its `rowId` value, or the row object
      *  itself when there is no `rowId` or it resolves to null/undefined. */
     private idOf;
@@ -3900,7 +3941,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; }; "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; }; }, { "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; }; "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"; "columnState": "columnStateChange"; "filters": "filtersChange"; "quickFilter": "quickFilterChange"; "selectionChange": "selectionChange"; "syncChange": "syncChange"; "rowAction": "rowAction"; "lazyLoad": "lazyLoad"; "cellEdit": "cellEdit"; }, ["detailDef", "actionBarDef", "cellDefs"], ["[strctDatagridActionBarCaption]", "[strctDatagridActionBar]"], true, never>;
 }
 
 /** Timeline node state colors. */