@akcelik/strct 3.0.0 → 3.1.1

package/package.json

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

@@ -3155,7 +3155,8 @@ declare class StrctDatagridActionBar {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctDatagridActionBar, "[strctDatagridActionBar]", never, {}, {}, never, never, true, never>;
 }
 /**
- * Interactive data table: sortable columns, row selection, expandable detail
+ * Interactive data table: sortable columns, row selection (Shift-click a row
+ * checkbox to carry its new state across a whole block), expandable detail
  * rows, a batch action bar and built-in paging.
  *   <strct-datagrid [columns]="cols" [rows]="data" selectable expandable [pageSize]="10">
  *     <button strct-button strctDatagridActions size="sm">Migrate</button>
@@ -3469,7 +3470,8 @@ declare class StrctDatagrid {
     private readonly selectionRows;
     protected readonly allPageSelected: _angular_core.Signal<boolean>;
     protected readonly somePageSelected: _angular_core.Signal<boolean>;
-    /** Resolve a row's stable identity (defaults to the row object itself). */
+    /** 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;
     protected rowKey(row: StrctRow): unknown;
     protected cellTemplate(key: string): TemplateRef<StrctCellContext> | null;
@@ -3518,6 +3520,19 @@ declare class StrctDatagrid {
     protected isSelected(row: StrctRow): boolean;
     protected isExpanded(row: StrctRow): boolean;
     toggleExpand(row: StrctRow): void;
+    /** The row a Shift-click measures its range from: the last one toggled on
+     *  its own. A range leaves it where it is, so successive Shift-clicks
+     *  re-project from the same origin instead of walking the anchor along. */
+    private rangeAnchor;
+    /** Set by the row checkbox's click, consumed by the `toggleRow` that the
+     *  same interaction fires immediately after. */
+    private rangeIntent;
+    protected noteRangeIntent(event: MouseEvent): void;
+    /**
+     * Toggle one row. Shift-clicking a row checkbox instead applies the clicked
+     * box's new state across every row between the anchor and this one — so a
+     * Shift-click selects a block, and Shift-clicking a checked box clears one.
+     */
     toggleRow(row: StrctRow): void;
     toggleAll(): void;
     clearSelection(): void;