@nanahoshi/mona-ui 0.8.0 → 0.10.0

package/fesm2022/nanahoshi-mona-ui-grid.mjs

@@ -1,2 +1,2 @@
-export { C as CellEditEvent, w as GridAddCommandDirective, x as GridAddEvent, y as GridCancelCommandDirective, z as GridCancelEvent, A as GridCellTemplateDirective, B as GridColumnComponent, D as GridColumnTitleTemplateDirective, E as GridCommandColumnComponent, F as GridComponent, H as GridContextMenuDirective, I as GridDetailTemplateDirective, J as GridEditCommandDirective, K as GridEditEvent, L as GridEditTemplateDirective, M as GridEditableDirective, N as GridExportDirective, O as GridFilterableDirective, P as GridFooterTemplateDirective, Q as GridGroupFooterTemplateDirective, R as GridGroupableDirective, S as GridHeaderTemplateDirective, T as GridNoDataTemplateDirective, U as GridRemoveCommandDirective, V as GridRemoveEvent, W as GridReorderableDirective, X as GridResizableDirective, Y as GridSaveCommandDirective, Z as GridSaveEvent, _ as GridSelectableDirective, $ as GridSortableDirective, a0 as GridStatePersistenceDirective, a1 as GridToolbarTemplateDirective, a2 as GridVirtualScrollDirective, a3 as RowEditEvent } from './nanahoshi-mona-ui-grid-nanahoshi-mona-ui-grid-DWzYyGnb.mjs';
+export { C as CellEditEvent, A as GridAddCommandDirective, B as GridAddEvent, D as GridCancelCommandDirective, E as GridCancelEvent, F as GridCellTemplateDirective, H as GridColumnComponent, I as GridColumnTitleTemplateDirective, J as GridCommandColumnComponent, K as GridComponent, L as GridContextMenuDirective, M as GridDetailTemplateDirective, N as GridEditCommandDirective, O as GridEditEvent, P as GridEditTemplateDirective, Q as GridEditableDirective, R as GridExportDirective, S as GridFilterableDirective, T as GridFooterTemplateDirective, U as GridGroupFooterTemplateDirective, V as GridGroupableDirective, W as GridHeaderTemplateDirective, X as GridNoDataTemplateDirective, Y as GridRemoveCommandDirective, Z as GridRemoveEvent, _ as GridReorderableDirective, $ as GridResizableDirective, a0 as GridRowReorderableDirective, a1 as GridSaveCommandDirective, a2 as GridSaveEvent, a3 as GridSelectableDirective, a4 as GridSortableDirective, a5 as GridStatePersistenceDirective, a6 as GridToolbarTemplateDirective, a7 as GridVirtualScrollDirective, a8 as RowEditEvent, a9 as RowReorderEvent } from './nanahoshi-mona-ui-grid-nanahoshi-mona-ui-grid-DaOemy_G.mjs';
 //# sourceMappingURL=nanahoshi-mona-ui-grid.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanahoshi/mona-ui",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "A very light Angular UI framework",
   "author": "Nanahoshi",
   "repository": {

package/types/nanahoshi-mona-ui-check-box.d.ts

@@ -103,9 +103,8 @@ declare class CheckBoxComponent implements CheckboxVariantInput, CheckmarkVarian
      * @default ""
      */
     readonly userClass: _angular_core.InputSignal<string>;
-    protected onCheckedChange(checked: boolean): void;
-    protected onInputChange(event: Event): void;
     protected onInputBlur(event: FocusEvent): void;
+    protected onInputChange(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckBoxComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckBoxComponent, "mona-check-box", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "labelSize": { "alias": "labelSize"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "inputBlur": "inputBlur"; "inputChange": "inputChange"; "inputFocus": "inputFocus"; "touch": "touch"; }, never, ["*"], true, never>;
 }

package/types/nanahoshi-mona-ui-grid.d.ts

@@ -3,11 +3,11 @@ import * as _angular_core from '@angular/core';
 import { TemplateRef, WritableSignal, OnInit, ElementRef } from '@angular/core';
 import { FieldTree, SchemaOrSchemaFn, ValidationError } from '@angular/forms/signals';
 import { SortDirection, CompositeFilterDescriptor, SortDescriptor, FilterLogic, FilterOperators } from '@nanahoshi/mona-ui/query';
-import { Selector, ImmutableDictionary, ImmutableList, ImmutableSet } from '@mirei/ts-collections';
 import * as _nanahoshi_mona_ui_grid from '@nanahoshi/mona-ui/grid';
 import { CdkDropList, CdkDragEnter, CdkDragStart, CdkDragDrop } from '@angular/cdk/drag-drop';
 import { PageChangeEvent, PageSizeChangeEvent } from '@nanahoshi/mona-ui/pager';
 import { FilterMenuValue } from '@nanahoshi/mona-ui/filter';
+import { Selector, ImmutableDictionary, ImmutableList, ImmutableSet } from '@mirei/ts-collections';
 import * as rxjs from 'rxjs';
 import { Subject, BehaviorSubject } from 'rxjs';
 import { PopupMenuItem } from '@nanahoshi/mona-ui/popup-menu';
@@ -202,8 +202,58 @@ interface GridRemoveEventOptions {
 }
 
 interface SelectableOptions {
+    /**
+     * Enables row selection.
+     */
     enabled?: boolean;
+    /**
+     * Controls whether one or multiple rows can be selected.
+     *
+     * @default "single"
+     */
     mode?: "single" | "multiple";
+    /**
+     * Derives the accessible label for a row's selection checkbox from its data.
+     *
+     * When omitted, the checkbox falls back to a positional label (e.g. "Select row 3").
+     */
+    rowAriaLabel?: (rowData: Record<PropertyKey, unknown>) => string;
+    /**
+     * Determines which rows are affected by the header checkbox.
+     *
+     * - "page": rows on the current paginated page
+     * - "view": all rows in the current filtered and sorted view
+     *
+     * For virtual scrolling, "page" resolves to the complete current view
+     * because virtual scrolling does not have logical pages.
+     *
+     * @default "page"
+     */
+    selectAllScope?: "page" | "view";
+    /**
+     * Whether clicking the row itself changes selection.
+     *
+     * Off by default so that clicking a row to interact with its content (a link, a button,
+     * an editable cell) never silently discards the current selection. Set this to true to
+     * also select rows via a plain click, in addition to checkboxes or application code.
+     *
+     * @default false
+     */
+    selectOnRowClick?: boolean;
+    /**
+     * Displays the built-in checkbox selection column.
+     *
+     * @default false
+     */
+    showCheckboxes?: boolean;
+    /**
+     * Displays a select-all checkbox in the selection-column header.
+     *
+     * Only applies to multiple-selection mode.
+     *
+     * @default true
+     */
+    showSelectAll?: boolean;
 }
 
 interface GroupDescriptor {
@@ -295,8 +345,6 @@ interface EditableOptions {
     schema?: GridEditSchemaFactory;
 }
 
-type GridKeySelector<TData, TKey = unknown> = string | Selector<TData, TKey> | null;
-
 declare class GridEditableDirective {
     #private;
     /**
@@ -328,17 +376,13 @@ declare class GridEditableDirective {
      * @description Emitted when a row edit is committed (row mode only).
      */
     readonly rowEdit: _angular_core.OutputEmitterRef<RowEditEvent>;
-    /**
-     * @description Field name or selector used to keep edited row identity stable when data is rebound.
-     */
-    readonly rowKey: _angular_core.InputSignal<GridKeySelector<unknown>>;
     /**
      * @description Emitted before an edited or new row is saved.
      */
     readonly save: _angular_core.OutputEmitterRef<GridSaveEvent>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridEditableDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridEditableDirective, "mona-grid[monaGridEditable]", never, { "newRowFactory": { "alias": "newRowFactory"; "required": false; "isSignal": true; }; "options": { "alias": "monaGridEditable"; "required": false; "isSignal": true; }; "rowKey": { "alias": "rowKey"; "required": false; "isSignal": true; }; }, { "add": "add"; "cancel": "cancel"; "cellEdit": "cellEdit"; "edit": "edit"; "remove": "remove"; "rowEdit": "rowEdit"; "save": "save"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridEditableDirective, "mona-grid[monaGridEditable]", never, { "newRowFactory": { "alias": "newRowFactory"; "required": false; "isSignal": true; }; "options": { "alias": "monaGridEditable"; "required": false; "isSignal": true; }; }, { "add": "add"; "cancel": "cancel"; "cellEdit": "cellEdit"; "edit": "edit"; "remove": "remove"; "rowEdit": "rowEdit"; "save": "save"; }, never, never, true, never>;
 }
 
 declare class GridFilterableDirective {
@@ -454,6 +498,65 @@ declare class GridResizableDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridResizableDirective, "mona-grid[monaGridResizable]", never, { "options": { "alias": "monaGridResizable"; "required": false; "isSignal": true; }; }, { "columnResize": "columnResize"; }, never, never, true, never>;
 }
 
+interface RowReorderableOptions {
+    /**
+     * Determines whether an individual row may be reordered.
+     *
+     * Rows for which this returns false must show a disabled handle.
+     */
+    canReorder?: (rowData: Record<PropertyKey, unknown>) => boolean;
+    /**
+     * Enables row reordering.
+     *
+     * @default true when the directive is used without a value
+     */
+    enabled?: boolean;
+    /**
+     * Returns the accessible label for a row's reorder handle.
+     *
+     * The default must be positional, such as:
+     * "Reorder row 3"
+     */
+    rowAriaLabel?: (rowData: Record<PropertyKey, unknown>, absoluteIndex: number) => string;
+}
+
+declare class RowReorderEvent<TData extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> extends PreventableEvent {
+    #private;
+    constructor(options: RowReorderEventOptions<TData>);
+    get currentIndex(): number;
+    get currentPageIndex(): number;
+    get previousIndex(): number;
+    get previousPageIndex(): number;
+    get reorderedData(): readonly TData[];
+    get rowData(): TData;
+}
+interface RowReorderEventOptions<TData extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> {
+    currentIndex: number;
+    currentPageIndex: number;
+    previousIndex: number;
+    previousPageIndex: number;
+    reorderedData: readonly TData[];
+    rowData: TData;
+}
+
+declare class GridRowReorderableDirective {
+    #private;
+    /**
+     * @description Enables row reordering via the reorder-handle column. Pass a `RowReorderableOptions`
+     * object to configure it explicitly.
+     * @default ""
+     */
+    readonly options: _angular_core.InputSignal<"" | RowReorderableOptions>;
+    /**
+     * @description Emitted when a row is moved to a new position. The event carries the moved row,
+     * source- and page-relative indices, and the complete reordered application data.
+     */
+    readonly rowReorder: _angular_core.OutputEmitterRef<RowReorderEvent<Record<PropertyKey, unknown>>>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridRowReorderableDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridRowReorderableDirective, "mona-grid[monaGridRowReorderable]", never, { "options": { "alias": "monaGridRowReorderable"; "required": false; "isSignal": true; }; }, { "rowReorder": "rowReorder"; }, never, never, true, never>;
+}
+
 declare class GridSelectableDirective {
     #private;
     /**
@@ -718,6 +821,8 @@ interface ColumnFilterState {
     filterMenuValue?: FilterMenuValue;
 }
 
+type GridKeySelector<TData, TKey = unknown> = string | Selector<TData, TKey> | null;
+
 type ResizeMethod = "auto" | "fitView" | number;
 
 interface ColumnSortState {
@@ -769,6 +874,13 @@ interface PaginationState {
     readonly take: number;
 }
 
+type StructuralColumnKind = "detail" | "reorder" | "selection";
+interface StructuralColumnDescriptor {
+    readonly kind: StructuralColumnKind;
+    readonly visible: boolean;
+    readonly width: number;
+}
+
 interface RowEditDataItem extends Record<string, unknown> {
     readonly $rowId: string;
 }
@@ -777,6 +889,7 @@ declare class GridService {
     readonly addRowData: _angular_core.Signal<Record<PropertyKey, unknown> | null>;
     readonly addRowVisible: _angular_core.Signal<boolean>;
     readonly add$: Subject<GridAddEvent>;
+    readonly allBulkSelectionRowsSelected: _angular_core.Signal<boolean>;
     readonly aggregateColumns: _angular_core.Signal<ImmutableList<Column>>;
     readonly aggregateMap: _angular_core.Signal<ImmutableDictionary<string, GridAggregateBucket>>;
     readonly aggregateRows: _angular_core.Signal<Record<PropertyKey, unknown>[]>;
@@ -785,6 +898,7 @@ declare class GridService {
     readonly appliedSorts: _angular_core.WritableSignal<ImmutableDictionary<string, ColumnSortState>>;
     readonly bodyScrollElement: _angular_core.WritableSignal<HTMLElement | null>;
     readonly bodyTableElement: _angular_core.WritableSignal<HTMLTableElement | null>;
+    readonly bulkSelectionRows: _angular_core.Signal<ImmutableList<Row>>;
     readonly cellEdit$: Subject<CellEditEvent>;
     readonly cancel$: Subject<GridCancelEvent>;
     /** Set of currently collapsed group keys (global, shared by both paginated and virtual list). */
@@ -795,15 +909,16 @@ declare class GridService {
     readonly columns: _angular_core.WritableSignal<ImmutableList<Column>>;
     readonly contextMenuItems: _angular_core.WritableSignal<ImmutableSet<PopupMenuItem>>;
     readonly detailColumnWidth = 36;
+    readonly detailColumnOffset: _angular_core.Signal<number>;
+    readonly detailStructuralWidth: _angular_core.Signal<0 | 36>;
     readonly editBaseDict: _angular_core.Signal<ImmutableDictionary<string, RowEditDataItem>>;
     readonly editContext: _angular_core.Signal<GridEditContext | null>;
     readonly edit$: Subject<GridEditEvent>;
     readonly editViewDict: _angular_core.Signal<ImmutableDictionary<string, RowEditDataItem>>;
     readonly editSession: _angular_core.Signal<GridEditSession | null>;
     readonly editableOptions: _angular_core.WritableSignal<EditableOptions>;
-    readonly editableRowKey: _angular_core.WritableSignal<GridKeySelector<unknown>>;
     readonly editingRowUid: _angular_core.Signal<string | null>;
-    readonly expandedKeys: _angular_core.WritableSignal<ImmutableSet<unknown>>;
+    readonly expandedKeys: _angular_core.WritableSignal<ImmutableSet<string>>;
     readonly filterChange$: Subject<CompositeFilterDescriptor[]>;
     readonly filterableOptions: _angular_core.Signal<FilterableOptions>;
     readonly footerScrollElement: _angular_core.WritableSignal<HTMLElement | null>;
@@ -811,6 +926,7 @@ declare class GridService {
     readonly groupAggregateMap: _angular_core.Signal<ImmutableDictionary<string, GridGroupAggregate>>;
     readonly groupColumnWidth = 36;
     readonly groupColumns: _angular_core.Signal<ImmutableList<Column>>;
+    readonly groupStructuralWidth: _angular_core.Signal<number>;
     readonly groupableOptions: _angular_core.WritableSignal<GroupableOptions>;
     readonly hasLeftLockedColumns: _angular_core.Signal<boolean>;
     readonly hasFooter: _angular_core.Signal<boolean>;
@@ -818,8 +934,12 @@ declare class GridService {
     readonly headerTableElement: _angular_core.WritableSignal<HTMLTableElement | null>;
     readonly horizontalScrollLeft: _angular_core.Signal<number>;
     readonly isInEditMode: _angular_core.Signal<boolean>;
+    readonly lastLeftStructuralOffset: _angular_core.Signal<number | null>;
     readonly leftLockedStructuralWidth: _angular_core.Signal<number>;
     readonly lockedColumnStates: _angular_core.Signal<ReadonlyMap<string, GridLockedColumnState>>;
+    readonly leadingStructuralWidth: _angular_core.Signal<number>;
+    readonly leadingStructuralColumnCount: _angular_core.Signal<number>;
+    readonly leadingLogicalColumnCount: _angular_core.Signal<number>;
     readonly masterDetailEmptyCellWidth: _angular_core.Signal<number>;
     readonly masterDetailRowWidth: _angular_core.Signal<number>;
     readonly masterDetailTemplate: _angular_core.WritableSignal<TemplateRef<unknown> | null>;
@@ -828,9 +948,20 @@ declare class GridService {
     readonly remove$: Subject<GridRemoveEvent>;
     readonly reorderableOptions: _angular_core.Signal<ReorderableOptions>;
     readonly resizableOptions: _angular_core.Signal<ResizableOptions>;
+    readonly rowDragInProgress: _angular_core.Signal<boolean>;
     readonly rowEdit$: Subject<RowEditEvent>;
-    readonly rows: _angular_core.WritableSignal<ImmutableSet<Row>>;
+    readonly rowKey: _angular_core.WritableSignal<GridKeySelector<unknown>>;
+    readonly rowReorder$: Subject<RowReorderEvent<Record<PropertyKey, unknown>>>;
+    readonly rowReorderColumnOffset: _angular_core.Signal<number>;
+    readonly rowReorderColumnVisible: _angular_core.Signal<boolean>;
+    readonly rowReorderColumnWidth = 36;
+    readonly rowReorderDisabledReason: _angular_core.Signal<RowReorderDisabledReason>;
+    readonly rowReorderInteractionEnabled: _angular_core.Signal<boolean>;
+    readonly rowReorderStructuralWidth: _angular_core.Signal<0 | 36>;
+    readonly rowReorderableOptions: _angular_core.Signal<RowReorderableOptions>;
+    readonly rows: _angular_core.WritableSignal<ImmutableList<Row>>;
     readonly save$: Subject<GridSaveEvent>;
+    readonly draggingRowUid: _angular_core.WritableSignal<string | null>;
     readonly scrollEnd$: Subject<void>;
     readonly scrollEndThreshold: _angular_core.WritableSignal<number>;
     readonly scrollbarGutterWidth: _angular_core.Signal<number>;
@@ -840,18 +971,28 @@ declare class GridService {
     readonly selectedKeysChange$: rxjs.Observable<ImmutableSet<unknown>>;
     readonly selectedKeysLoad$: BehaviorSubject<ImmutableSet<unknown>>;
     readonly selectedRows: _angular_core.Signal<ImmutableSet<Row>>;
+    readonly selectionColumnWidth = 40;
+    readonly selectionColumnVisible: _angular_core.Signal<boolean>;
+    readonly selectionColumnOffset: _angular_core.Signal<number>;
+    readonly selectionStructuralWidth: _angular_core.Signal<0 | 40>;
+    readonly someBulkSelectionRowsSelected: _angular_core.Signal<boolean>;
     readonly sortableOptions: _angular_core.WritableSignal<SortableOptions>;
+    readonly structuralColIndexMap: _angular_core.Signal<Map<StructuralColumnKind, number>>;
+    readonly structuralColumns: _angular_core.Signal<readonly StructuralColumnDescriptor[]>;
+    readonly structuralLastKind: _angular_core.Signal<StructuralColumnKind | null>;
     readonly tableWidth: _angular_core.Signal<number | null>;
-    readonly viewPageRows: _angular_core.Signal<ImmutableSet<Row>>;
+    readonly viewPageRows: _angular_core.Signal<ImmutableList<Row>>;
     readonly viewRowCount: _angular_core.Signal<number>;
-    readonly viewRows: _angular_core.Signal<ImmutableSet<Row>>;
+    readonly viewRows: _angular_core.Signal<ImmutableList<Row>>;
     readonly virtualGridMaxBuffer: _angular_core.Signal<number>;
     readonly virtualGridMinBuffer: _angular_core.WritableSignal<number>;
     readonly virtualScrollOptions: _angular_core.WritableSignal<VirtualScrollOptions>;
     readonly visibleColumns: _angular_core.Signal<ImmutableList<Column>>;
+    readonly visibleStructuralColumns: _angular_core.Signal<StructuralColumnDescriptor[]>;
     constructor();
     addGroupColumn(column: Column): void;
     applyState(state: GridState | null, options?: GridStatePersistenceOptions): GridStateLoadResult;
+    canReorderRow(row: Row): boolean;
     cancelAddRow(originalEvent?: Event): boolean;
     cancelEdit(originalEvent?: Event): boolean;
     captureState(options?: GridStatePersistenceOptions): GridState;
@@ -859,17 +1000,18 @@ declare class GridService {
     clearColumnGrouping(column: Column): void;
     commitRowEdit(originalEvent?: Event): boolean;
     deselectAllRows(): void;
+    deselectRow(row: Row): void;
     findTextWidthOfColumn(column: Column, element: HTMLTableCellElement): number;
     getColumnStateId(column: Column): string | null;
     getColumnWidth(column: Column): number;
     getGroupDescriptors(columns: Iterable<Column>): GroupDescriptor[];
+    getRowReorderAriaLabel(row: Row, absoluteIndex: number): string;
     handleMultipleSelection(event: MouseEvent, row: Row): void;
     handleRowClick(event: MouseEvent, row: Row): void;
     handleSingleSelection(event: MouseEvent, row: Row): void;
     isGroupCollapsed(groupKey: string): boolean;
     isRowExpanded(row: Row): boolean;
     isRowSelected(row: Row): boolean;
-    isSelectableGrid(): boolean;
     loadFilters(filters: CompositeFilterDescriptor[]): void;
     loadGroupColumns(descriptors: Iterable<GroupDescriptor>): void;
     loadSelectedKeys(selectedKeys: Iterable<unknown>): void;
@@ -879,9 +1021,11 @@ declare class GridService {
     patchAddCell(field: string, value: unknown): void;
     patchCellEdit(rowUid: string, field: string, value: unknown): void;
     removeRow(row: Row, originalEvent?: Event): boolean;
+    requestRowReorder(row: Row, previousPageIndex: number, currentPageIndex: number): boolean;
     resolveAggregateValue(bucket: GridAggregateBucket | null, aggregateFunction: AggregateFunction | null): unknown;
     saveAddRow(originalEvent?: Event): boolean;
     selectRow(row: Row): void;
+    setBulkSelection(selected: boolean): void;
     setCalculatedWidth(columnId: string, value: number | null): void;
     setCalculatedWidths(widthByColumnId: ReadonlyMap<string, number | null>): void;
     setColumnDefinitions(configs: readonly ColumnConfig[]): void;
@@ -900,8 +1044,10 @@ declare class GridService {
     setReorderableOptions(options: Partial<ReorderableOptions>): void;
     setResizableOptions(options: Partial<ResizableOptions>): void;
     setRowExpanded(row: Row, expanded: boolean): void;
+    setRowReorderableOptions(options: RowReorderableOptions): void;
     setRows(value: Iterable<Record<PropertyKey, unknown>>, rowKey?: GridKeySelector<unknown> | null): void;
     setSelectableOptions(options: SelectableOptions): void;
+    setRowSelected(row: Row, selected: boolean): void;
     setSortableOptions(options: Partial<SortableOptions>): void;
     setScrollEndThreshold(threshold: number): void;
     setVirtualScrollOptions(options: VirtualScrollOptions): void;
@@ -909,6 +1055,7 @@ declare class GridService {
     startCellEdit(uid: string, row: Row, column: Column, originalEvent?: Event): boolean;
     startRowEdit(row: Row, originalEvent?: Event): boolean;
     stopCellEdit(originalEvent?: Event): boolean;
+    structuralColumnOffset(kind: StructuralColumnKind, groupPrefixWidth: number): number;
     toggleGroupCollapse(groupKey: string): void;
     updateColumn(columnId: string, patch: Partial<Omit<Column, "id">>): void;
     private applyColumnIndexes;
@@ -933,6 +1080,7 @@ declare class GridService {
     private measureFallbackScrollbarGutter;
     private orderColumnsByLockBucket;
     private reconcileColumn;
+    private selectRowRange;
     private clearEditSession;
     private createEditSession;
     private patchSessionField;
@@ -952,6 +1100,7 @@ declare class GridService {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<GridService>;
 }
+type RowReorderDisabledReason = "disabled" | "editing" | "filtered" | "grouped" | "single-row" | "sorted" | "virtual-scroll" | null;
 
 declare const gridBaseThemeVariants: (props?: ({
     rounded?: "small" | "none" | "medium" | "large" | null | undefined;
@@ -1053,6 +1202,12 @@ declare class GridComponent<T> implements GridVariantInput {
      * @default "fitView"
      */
     readonly resizeMethod: _angular_core.InputSignal<ResizeMethod>;
+    /**
+     * @description Field name or selector used to derive a stable identity for each row.
+     * The resolved value must be unique within the grid data.
+     * @default null
+     */
+    readonly rowKey: _angular_core.InputSignal<GridKeySelector<unknown>>;
     /**
      * @description Whether the pager is responsive.
      * If set to `true`, the pager will be displayed as a dropdown when the grid width gets smaller.
@@ -1106,8 +1261,8 @@ declare class GridComponent<T> implements GridVariantInput {
     private setResizeObserver;
     private syncToolbarFocusTargets;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<GridComponent<any>, "mona-grid", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizeValues": { "alias": "pageSizeValues"; "required": false; "isSignal": true; }; "resizeMethod": { "alias": "resizeMethod"; "required": false; "isSignal": true; }; "responsivePager": { "alias": "responsivePager"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, ["columnDefinitions", "gridDetailTemplate", "noDataTemplate", "toolbarTemplate"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<GridComponent<any>, "mona-grid", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizeValues": { "alias": "pageSizeValues"; "required": false; "isSignal": true; }; "resizeMethod": { "alias": "resizeMethod"; "required": false; "isSignal": true; }; "rowKey": { "alias": "rowKey"; "required": false; "isSignal": true; }; "responsivePager": { "alias": "responsivePager"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, ["columnDefinitions", "gridDetailTemplate", "noDataTemplate", "toolbarTemplate"], never, true, never>;
 }
 
-export { CellEditEvent, ColumnReorderEvent, ColumnSortEvent, GridAddCommandDirective, GridAddEvent, GridCancelCommandDirective, GridCancelEvent, GridCellTemplateDirective, GridColumnComponent, GridColumnTitleTemplateDirective, GridCommandColumnComponent, GridComponent, GridContextMenuDirective, GridDetailTemplateDirective, GridEditCommandDirective, GridEditEvent, GridEditTemplateDirective, GridEditableDirective, GridExportDirective, GridFilterableDirective, GridFooterTemplateDirective, GridGroupFooterTemplateDirective, GridGroupableDirective, GridHeaderTemplateDirective, GridNoDataTemplateDirective, GridRemoveCommandDirective, GridRemoveEvent, GridReorderableDirective, GridResizableDirective, GridSaveCommandDirective, GridSaveEvent, GridSelectableDirective, GridSortableDirective, GridStatePersistenceDirective, GridToolbarTemplateDirective, GridVirtualScrollDirective, RowEditEvent };
-export type { AggregateFunction, Column, ColumnConfig, ColumnFormat, ColumnKind, ColumnResizeEvent, EditableOptions, FilterableOptions, GridColumnLockedPosition, GridColumnState, GridEditFormContext, GridEditOperation, GridEditSchemaFactory, GridEditSession, GridEditTemplateContext, GridSaveOperation, GridState, GridStateCompositeFilterDescriptor, GridStateFilterDescriptor, GridStateFilterValue, GridStateLoadResult, GridStateLoadStatus, GridStatePersistenceOptions, GridStateSortDescriptor, GridStateVersion, GroupDescriptor, GroupableOptions, ReorderableOptions, ResizableOptions, ResizeMethod, SelectableOptions, SortableOptions };
+export { CellEditEvent, ColumnReorderEvent, ColumnSortEvent, GridAddCommandDirective, GridAddEvent, GridCancelCommandDirective, GridCancelEvent, GridCellTemplateDirective, GridColumnComponent, GridColumnTitleTemplateDirective, GridCommandColumnComponent, GridComponent, GridContextMenuDirective, GridDetailTemplateDirective, GridEditCommandDirective, GridEditEvent, GridEditTemplateDirective, GridEditableDirective, GridExportDirective, GridFilterableDirective, GridFooterTemplateDirective, GridGroupFooterTemplateDirective, GridGroupableDirective, GridHeaderTemplateDirective, GridNoDataTemplateDirective, GridRemoveCommandDirective, GridRemoveEvent, GridReorderableDirective, GridResizableDirective, GridRowReorderableDirective, GridSaveCommandDirective, GridSaveEvent, GridSelectableDirective, GridSortableDirective, GridStatePersistenceDirective, GridToolbarTemplateDirective, GridVirtualScrollDirective, RowEditEvent, RowReorderEvent };
+export type { AggregateFunction, Column, ColumnConfig, ColumnFormat, ColumnKind, ColumnResizeEvent, EditableOptions, FilterableOptions, GridColumnLockedPosition, GridColumnState, GridEditFormContext, GridEditOperation, GridEditSchemaFactory, GridEditSession, GridEditTemplateContext, GridSaveOperation, GridState, GridStateCompositeFilterDescriptor, GridStateFilterDescriptor, GridStateFilterValue, GridStateLoadResult, GridStateLoadStatus, GridStatePersistenceOptions, GridStateSortDescriptor, GridStateVersion, GroupDescriptor, GroupableOptions, ReorderableOptions, ResizableOptions, ResizeMethod, RowReorderableOptions, SelectableOptions, SortableOptions };