@tanstack/table-core 9.0.0-beta.7 → 9.0.0-beta.70

package/dist/features/row-selection/rowSelectionFeature.js

@@ -1,11 +1,17 @@
 import { assignPrototypeAPIs, assignTableAPIs, makeStateUpdater } from "../../utils.js";
-import { getDefaultRowSelectionState, row_getCanMultiSelect, row_getCanSelect, row_getCanSelectSubRows, row_getIsAllSubRowsSelected, row_getIsSelected, row_getIsSomeSelected, row_getToggleSelectedHandler, row_toggleSelected, table_getFilteredSelectedRowModel, table_getGroupedSelectedRowModel, table_getIsAllPageRowsSelected, table_getIsAllRowsSelected, table_getIsSomePageRowsSelected, table_getIsSomeRowsSelected, table_getPreSelectedRowModel, table_getSelectedRowModel, table_getToggleAllPageRowsSelectedHandler, table_getToggleAllRowsSelectedHandler, table_resetRowSelection, table_setRowSelection, table_toggleAllPageRowsSelected, table_toggleAllRowsSelected } from "./rowSelectionFeature.utils.js";
+import { getDefaultRowSelectionState, row_getCanMultiSelect, row_getCanSelect, row_getCanSelectSubRows, row_getIsAllSubRowsSelected, row_getIsSelected, row_getIsSomeSelected, row_getToggleSelectedHandler, row_toggleSelected, table_getFilteredSelectedRowModel, table_getGroupedSelectedRowModel, table_getIsAllPageRowsSelected, table_getIsAllRowsSelected, table_getIsSomePageRowsSelected, table_getIsSomeRowsSelected, table_getPreSelectedRowModel, table_getSelectedRowIds, table_getSelectedRowModel, table_getToggleAllPageRowsSelectedHandler, table_getToggleAllRowsSelectedHandler, table_resetRowSelection, table_setRowSelection, table_toggleAllPageRowsSelected, table_toggleAllRowsSelected } from "./rowSelectionFeature.utils.js";
 
 //#region src/features/row-selection/rowSelectionFeature.ts
 /**
 * Feature that adds row selection state and APIs for row and page selection.
 */
 const rowSelectionFeature = {
+	initTableInstanceData: (table) => {
+		table._lastSelectedRowId = null;
+	},
+	resetTableInstanceData: (table) => {
+		table._lastSelectedRowId = null;
+	},
 	getInitialState: (initialState) => {
 		return {
 			rowSelection: getDefaultRowSelectionState(),
@@ -17,53 +23,91 @@ const rowSelectionFeature = {
 			onRowSelectionChange: makeStateUpdater("rowSelection", table),
 			enableRowSelection: true,
 			enableMultiRowSelection: true,
-			enableSubRowSelection: true
+			enableRowRangeSelection: true,
+			enableSubRowSelection: true,
+			isRowRangeSelectionEvent: (event) => {
+				const rangeEvent = event;
+				return Boolean(rangeEvent.shiftKey || rangeEvent.nativeEvent?.shiftKey);
+			}
 		};
 	},
 	assignRowPrototype: (prototype, table) => {
 		assignPrototypeAPIs("rowSelectionFeature", prototype, table, {
 			row_toggleSelected: { fn: (row, value, opts) => row_toggleSelected(row, value, opts) },
 			row_getIsSelected: { fn: (row) => row_getIsSelected(row) },
-			row_getIsSomeSelected: { fn: (row) => row_getIsSomeSelected(row) },
-			row_getIsAllSubRowsSelected: { fn: (row) => row_getIsAllSubRowsSelected(row) },
+			row_getIsSomeSelected: {
+				fn: (row) => row_getIsSomeSelected(row),
+				memoDeps: (row) => [
+					row.subRows,
+					row.table.atoms.rowSelection?.get(),
+					row.table.options.enableRowSelection
+				]
+			},
+			row_getIsAllSubRowsSelected: {
+				fn: (row) => row_getIsAllSubRowsSelected(row),
+				memoDeps: (row) => [
+					row.subRows,
+					row.table.atoms.rowSelection?.get(),
+					row.table.options.enableRowSelection
+				]
+			},
 			row_getCanSelect: { fn: (row) => row_getCanSelect(row) },
 			row_getCanSelectSubRows: { fn: (row) => row_getCanSelectSubRows(row) },
 			row_getCanMultiSelect: { fn: (row) => row_getCanMultiSelect(row) },
-			row_getToggleSelectedHandler: { fn: (row) => row_getToggleSelectedHandler(row) }
+			row_getToggleSelectedHandler: { fn: (row, opts) => row_getToggleSelectedHandler(row, opts) }
 		});
 	},
 	constructTableAPIs: (table) => {
 		assignTableAPIs("rowSelectionFeature", table, {
 			table_setRowSelection: { fn: (updater) => table_setRowSelection(table, updater) },
 			table_resetRowSelection: { fn: (defaultState) => table_resetRowSelection(table, defaultState) },
-			table_toggleAllRowsSelected: { fn: (value) => table_toggleAllRowsSelected(table, value) },
-			table_toggleAllPageRowsSelected: { fn: (value) => table_toggleAllPageRowsSelected(table, value) },
+			table_toggleAllRowsSelected: { fn: (value, opts) => table_toggleAllRowsSelected(table, value, opts) },
+			table_toggleAllPageRowsSelected: { fn: (value, opts) => table_toggleAllPageRowsSelected(table, value, opts) },
 			table_getPreSelectedRowModel: { fn: () => table_getPreSelectedRowModel(table) },
 			table_getSelectedRowModel: {
 				fn: () => table_getSelectedRowModel(table),
-				memoDeps: () => {
-					var _table$atoms$rowSelec;
-					return [(_table$atoms$rowSelec = table.atoms.rowSelection) === null || _table$atoms$rowSelec === void 0 ? void 0 : _table$atoms$rowSelec.get(), table.getCoreRowModel()];
-				}
+				memoDeps: () => [table.atoms.rowSelection?.get(), table.getCoreRowModel()]
 			},
 			table_getFilteredSelectedRowModel: {
 				fn: () => table_getFilteredSelectedRowModel(table),
-				memoDeps: () => {
-					var _table$atoms$rowSelec2;
-					return [(_table$atoms$rowSelec2 = table.atoms.rowSelection) === null || _table$atoms$rowSelec2 === void 0 ? void 0 : _table$atoms$rowSelec2.get(), table.getFilteredRowModel()];
-				}
+				memoDeps: () => [table.atoms.rowSelection?.get(), table.getFilteredRowModel()]
 			},
 			table_getGroupedSelectedRowModel: {
 				fn: () => table_getGroupedSelectedRowModel(table),
-				memoDeps: () => {
-					var _table$atoms$rowSelec3;
-					return [(_table$atoms$rowSelec3 = table.atoms.rowSelection) === null || _table$atoms$rowSelec3 === void 0 ? void 0 : _table$atoms$rowSelec3.get(), table.getSortedRowModel()];
-				}
+				memoDeps: () => [table.atoms.rowSelection?.get(), table.getSortedRowModel()]
+			},
+			table_getSelectedRowIds: {
+				fn: () => table_getSelectedRowIds(table),
+				memoDeps: () => [table.atoms.rowSelection?.get()]
+			},
+			table_getIsAllRowsSelected: {
+				fn: () => table_getIsAllRowsSelected(table),
+				memoDeps: () => [
+					table.atoms.rowSelection?.get(),
+					table.getFilteredRowModel(),
+					table.options.enableRowSelection
+				]
+			},
+			table_getIsAllPageRowsSelected: {
+				fn: () => table_getIsAllPageRowsSelected(table),
+				memoDeps: () => [
+					table.atoms.rowSelection?.get(),
+					table.getPaginatedRowModel(),
+					table.options.enableRowSelection
+				]
+			},
+			table_getIsSomeRowsSelected: {
+				fn: () => table_getIsSomeRowsSelected(table),
+				memoDeps: () => [table.atoms.rowSelection?.get()]
+			},
+			table_getIsSomePageRowsSelected: {
+				fn: () => table_getIsSomePageRowsSelected(table),
+				memoDeps: () => [
+					table.atoms.rowSelection?.get(),
+					table.getPaginatedRowModel(),
+					table.options.enableRowSelection
+				]
 			},
-			table_getIsAllRowsSelected: { fn: () => table_getIsAllRowsSelected(table) },
-			table_getIsAllPageRowsSelected: { fn: () => table_getIsAllPageRowsSelected(table) },
-			table_getIsSomeRowsSelected: { fn: () => table_getIsSomeRowsSelected(table) },
-			table_getIsSomePageRowsSelected: { fn: () => table_getIsSomePageRowsSelected(table) },
 			table_getToggleAllRowsSelectedHandler: { fn: () => table_getToggleAllRowsSelectedHandler(table) },
 			table_getToggleAllPageRowsSelectedHandler: { fn: () => table_getToggleAllPageRowsSelectedHandler(table) }
 		});
@@ -71,5 +115,4 @@ const rowSelectionFeature = {
 };
 
 //#endregion
-export { rowSelectionFeature };
-//# sourceMappingURL=rowSelectionFeature.js.map
+export { rowSelectionFeature };

package/dist/features/row-selection/rowSelectionFeature.types.d.ts

@@ -1,14 +1,28 @@
 import { OnChangeFn, RowData, Updater } from "../../types/type-utils.js";
 import { Row } from "../../types/Row.js";
-import { TableFeatures } from "../../types/TableFeatures.js";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
-
+import { TableFeatures } from "../../types/TableFeatures.js";
 //#region src/features/row-selection/rowSelectionFeature.types.d.ts
-type RowSelectionState = Record<string, boolean | undefined>;
+type RowSelectionState = Record<string, true>;
+/**
+ * Controls how toggling a row affects its descendants.
+ */
+interface ToggleSelectedOptions {
+  /**
+   * Whether selectable child rows should be toggled recursively. Defaults to
+   * `true`.
+   */
+  selectChildren?: boolean;
+}
 interface TableState_RowSelection {
   rowSelection: RowSelectionState;
 }
-interface TableOptions_RowSelection<TFeatures extends TableFeatures, TData extends RowData> {
+interface TableOptions_RowSelection<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  /**
+   * Enables inclusive row range selection through
+   * `row.getToggleSelectedHandler()`. Defaults to `true`.
+   */
+  enableRowRangeSelection?: boolean;
   /**
    * Allows rows to be selected alongside other rows.
    *
@@ -28,6 +42,14 @@ interface TableOptions_RowSelection<TFeatures extends TableFeatures, TData exten
    * grouping features and defaults to `true`.
    */
   enableSubRowSelection?: boolean | ((row: Row<TFeatures, TData>) => boolean);
+  /**
+   * Determines whether a row-selection handler event should select or
+   * deselect the inclusive range from the most recent handler interaction.
+   *
+   * By default, events with `shiftKey` directly on the event or on
+   * `event.nativeEvent` are treated as range-selection events.
+   */
+  isRowRangeSelectionEvent?: (event: unknown) => boolean;
   /**
    * Called with an updater when row selection state changes. Pair this with
    * `state.rowSelection` when using external state; external atoms can own the
@@ -62,16 +84,23 @@ interface Row_RowSelection {
   getIsSomeSelected: () => boolean;
   /**
    * Creates a checkbox-style handler that toggles this row's selected state.
+   * Pass the original checkbox click event, or a framework event whose
+   * `nativeEvent` is that click, so Shift range selection can detect the
+   * modifier key.
    */
-  getToggleSelectedHandler: () => (event: unknown) => void;
+  getToggleSelectedHandler: (opts?: ToggleSelectedOptions) => (event: unknown) => void;
   /**
    * Selects/deselects the row.
    */
-  toggleSelected: (value?: boolean, opts?: {
-    selectChildren?: boolean;
-  }) => void;
+  toggleSelected: (value?: boolean, opts?: ToggleSelectedOptions) => void;
 }
-interface Table_RowSelection<TFeatures extends TableFeatures, TData extends RowData> {
+interface Table_RowSelection<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  /**
+   * The most recent row interacted with through the row selection handler.
+   *
+   * @internal
+   */
+  _lastSelectedRowId: string | null;
   /**
    * Builds a selected-row model from rows after filtering.
    */
@@ -80,6 +109,10 @@ interface Table_RowSelection<TFeatures extends TableFeatures, TData extends RowD
    * Builds a selected-row model from rows after grouping.
    */
   getGroupedSelectedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Returns the ids of all selected rows.
+   */
+  getSelectedRowIds: () => Array<string>;
   /**
    * Checks whether every selectable row on the current page is selected.
    */
@@ -89,11 +122,11 @@ interface Table_RowSelection<TFeatures extends TableFeatures, TData extends RowD
    */
   getIsAllRowsSelected: () => boolean;
   /**
-   * Checks whether the current page has a partial row selection.
+   * Checks whether at least one selectable row on the current page is selected.
    */
   getIsSomePageRowsSelected: () => boolean;
   /**
-   * Checks whether filtered rows have a partial row selection.
+   * Checks whether at least one row id is selected.
    */
   getIsSomeRowsSelected: () => boolean;
   /**
@@ -125,12 +158,15 @@ interface Table_RowSelection<TFeatures extends TableFeatures, TData extends RowD
   /**
    * Selects/deselects all rows on the current page.
    */
-  toggleAllPageRowsSelected: (value?: boolean) => void;
+  toggleAllPageRowsSelected: (value?: boolean, opts?: {
+    deselectAll?: boolean;
+  }) => void;
   /**
    * Selects/deselects all rows in the table.
    */
-  toggleAllRowsSelected: (value?: boolean) => void;
+  toggleAllRowsSelected: (value?: boolean, opts?: {
+    deselectAll?: boolean;
+  }) => void;
 }
 //#endregion
-export { RowSelectionState, Row_RowSelection, TableOptions_RowSelection, TableState_RowSelection, Table_RowSelection };
-//# sourceMappingURL=rowSelectionFeature.types.d.ts.map
+export { RowSelectionState, Row_RowSelection, TableOptions_RowSelection, TableState_RowSelection, Table_RowSelection, ToggleSelectedOptions };

package/dist/features/row-selection/rowSelectionFeature.utils.d.ts

@@ -1,10 +1,9 @@
 import { RowData, Updater } from "../../types/type-utils.js";
-import { RowSelectionState } from "./rowSelectionFeature.types.js";
+import { RowSelectionState, ToggleSelectedOptions } from "./rowSelectionFeature.types.js";
 import { Row } from "../../types/Row.js";
-import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table_Internal } from "../../types/Table.js";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
-
+import { Table } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
 //#region src/features/row-selection/rowSelectionFeature.utils.d.ts
 /**
  * Creates the default row selection state.
@@ -29,7 +28,7 @@ declare function getDefaultRowSelectionState(): RowSelectionState;
  * table_setRowSelection(table, (old) => ({ ...old, [rowId]: true }))
  * ```
  */
-declare function table_setRowSelection<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<RowSelectionState>): void;
+declare function table_setRowSelection<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, updater: Updater<RowSelectionState>): void;
 /**
  * Resets `rowSelection` to the configured initial state or feature default.
  *
@@ -42,7 +41,7 @@ declare function table_setRowSelection<TFeatures extends TableFeatures, TData ex
  * table_resetRowSelection(table, true)
  * ```
  */
-declare function table_resetRowSelection<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
+declare function table_resetRowSelection<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, defaultState?: boolean): void;
 /**
  * Selects or deselects every selectable row before grouping.
  *
@@ -54,7 +53,9 @@ declare function table_resetRowSelection<TFeatures extends TableFeatures, TData
  * table_toggleAllRowsSelected(table)
  * ```
  */
-declare function table_toggleAllRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, value?: boolean): void;
+declare function table_toggleAllRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, value?: boolean, opts?: {
+  deselectAll?: boolean;
+}): void;
 /**
  * Selects or deselects every selectable row on the current page.
  *
@@ -66,7 +67,9 @@ declare function table_toggleAllRowsSelected<TFeatures extends TableFeatures, TD
  * table_toggleAllPageRowsSelected(table)
  * ```
  */
-declare function table_toggleAllPageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, value?: boolean): void;
+declare function table_toggleAllPageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, value?: boolean, opts?: {
+  deselectAll?: boolean;
+}): void;
 /**
  * Reads the row model before row selection is projected into selected rows.
  *
@@ -78,7 +81,7 @@ declare function table_toggleAllPageRowsSelected<TFeatures extends TableFeatures
  * const rowsBeforeSelection = table_getPreSelectedRowModel(table)
  * ```
  */
-declare function table_getPreSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getPreSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Builds a row model containing selected rows from the core row model.
  *
@@ -90,7 +93,11 @@ declare function table_getPreSelectedRowModel<TFeatures extends TableFeatures, T
  * const selectedRows = table_getSelectedRowModel(table)
  * ```
  */
-declare function table_getSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData> | {
+  rows: never[];
+  flatRows: never[];
+  rowsById: Record<string, unknown>;
+};
 /**
  * Builds a row model containing selected rows from the filtered row model.
  *
@@ -102,7 +109,11 @@ declare function table_getSelectedRowModel<TFeatures extends TableFeatures, TDat
  * const selectedRows = table_getFilteredSelectedRowModel(table)
  * ```
  */
-declare function table_getFilteredSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getFilteredSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData> | {
+  rows: never[];
+  flatRows: never[];
+  rowsById: Record<string, unknown>;
+};
 /**
  * Builds a row model containing selected rows from the grouped row model.
  *
@@ -114,7 +125,20 @@ declare function table_getFilteredSelectedRowModel<TFeatures extends TableFeatur
  * const selectedRows = table_getGroupedSelectedRowModel(table)
  * ```
  */
-declare function table_getGroupedSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getGroupedSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData> | {
+  rows: never[];
+  flatRows: never[];
+  rowsById: Record<string, unknown>;
+};
+/**
+ * Returns the ids of all selected rows.
+ *
+ * @example
+ * ```ts
+ * const selectedRowIds = table_getSelectedRowIds(table)
+ * ```
+ */
+declare function table_getSelectedRowIds<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): Array<string>;
 /**
  * Checks whether every selectable filtered row is selected.
  *
@@ -126,7 +150,7 @@ declare function table_getGroupedSelectedRowModel<TFeatures extends TableFeature
  * const allSelected = table_getIsAllRowsSelected(table)
  * ```
  */
-declare function table_getIsAllRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
+declare function table_getIsAllRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): boolean;
 /**
  * Checks whether every selectable row on the current page is selected.
  *
@@ -137,31 +161,27 @@ declare function table_getIsAllRowsSelected<TFeatures extends TableFeatures, TDa
  * const allPageRowsSelected = table_getIsAllPageRowsSelected(table)
  * ```
  */
-declare function table_getIsAllPageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
+declare function table_getIsAllPageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): boolean;
 /**
- * Checks whether selection is partially applied across filtered rows.
+ * Checks whether at least one row id is selected.
  *
- * The result is true when at least one row id is selected but fewer ids are
- * selected than the current filtered flat row count.
+ * The result stays true when every row is selected.
  *
  * @example
  * ```ts
  * const someRowsSelected = table_getIsSomeRowsSelected(table)
  * ```
  */
-declare function table_getIsSomeRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
+declare function table_getIsSomeRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): boolean;
 /**
- * Checks whether the current page has a partial selection.
- *
- * This is false when all selectable page rows are selected. Otherwise it is true
- * if any selectable page row or descendant is selected.
+ * Checks whether at least one selectable row on the current page is selected.
  *
  * @example
  * ```ts
  * const somePageRowsSelected = table_getIsSomePageRowsSelected(table)
  * ```
  */
-declare function table_getIsSomePageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
+declare function table_getIsSomePageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): boolean;
 /**
  * Creates a checkbox-style handler that selects or deselects all rows.
  *
@@ -173,7 +193,7 @@ declare function table_getIsSomePageRowsSelected<TFeatures extends TableFeatures
  * const onChange = table_getToggleAllRowsSelectedHandler(table)
  * ```
  */
-declare function table_getToggleAllRowsSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): (e: unknown) => void;
+declare function table_getToggleAllRowsSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): (e: unknown) => void;
 /**
  * Creates a checkbox-style handler that selects or deselects current page rows.
  *
@@ -185,21 +205,24 @@ declare function table_getToggleAllRowsSelectedHandler<TFeatures extends TableFe
  * const onChange = table_getToggleAllPageRowsSelectedHandler(table)
  * ```
  */
-declare function table_getToggleAllPageRowsSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): (e: unknown) => void;
+declare function table_getToggleAllPageRowsSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): (e: unknown) => void;
 /**
  * Selects or deselects this row.
  *
  * Omitting `value` toggles the row. Child rows are selected recursively unless
- * `opts.selectChildren` is `false` or sub-row selection is disabled.
+ * `opts.selectChildren` is `false`, sub-row selection is disabled, or the row
+ * only supports single selection.
  *
  * @example
  * ```ts
  * row_toggleSelected(row)
+ * row_toggleSelected(row, true)
+ * row_toggleSelected(row, false)
+ * row_toggleSelected(row, true, { selectChildren: false })
+ * row_toggleSelected(row, false, { selectChildren: false })
  * ```
  */
-declare function row_toggleSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, value?: boolean, opts?: {
-  selectChildren?: boolean;
-}): void;
+declare function row_toggleSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, value?: boolean, opts?: ToggleSelectedOptions): void;
 /**
  * Checks whether this row id is selected in `state.rowSelection`.
  *
@@ -273,14 +296,17 @@ declare function row_getCanMultiSelect<TFeatures extends TableFeatures, TData ex
  * Creates a checkbox-style handler that selects or deselects this row.
  *
  * The handler is a no-op when the row cannot be selected and reads
- * `event.target.checked`.
+ * `event.target.checked`. Shift events select or deselect the inclusive range
+ * from the most recent selectable row handled by this table. Pass
+ * `selectChildren: false` to limit changes to rows explicitly present in the
+ * display-order interval.
  *
  * @example
  * ```ts
  * const onChange = row_getToggleSelectedHandler(row)
  * ```
  */
-declare function row_getToggleSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): (e: unknown) => void;
+declare function row_getToggleSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, opts?: ToggleSelectedOptions): (e: unknown) => void;
 /**
  * Builds a row model containing rows selected by the current row selection state.
  *
@@ -292,7 +318,7 @@ declare function row_getToggleSelectedHandler<TFeatures extends TableFeatures, T
  * const selectedRows = selectRowsFn(rowModel)
  * ```
  */
-declare function selectRowsFn<TFeatures extends TableFeatures, TData extends RowData>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function selectRowsFn<TFeatures extends TableFeatures, TData extends RowData>(rowModel: RowModel<TFeatures, TData>, table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Returns whether a row id is selected in the current row selection state.
  *
@@ -301,7 +327,7 @@ declare function selectRowsFn<TFeatures extends TableFeatures, TData extends Row
  * const selected = isRowSelected(row)
  * ```
  */
-declare function isRowSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean;
+declare function isRowSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, rowSelection: RowSelectionState): boolean;
 /**
  * Returns whether all, some, or none of a row's selectable descendants are selected.
  *
@@ -314,5 +340,4 @@ declare function isRowSelected<TFeatures extends TableFeatures, TData extends Ro
  */
 declare function isSubRowSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean | 'some' | 'all';
 //#endregion
-export { getDefaultRowSelectionState, isRowSelected, isSubRowSelected, row_getCanMultiSelect, row_getCanSelect, row_getCanSelectSubRows, row_getIsAllSubRowsSelected, row_getIsSelected, row_getIsSomeSelected, row_getToggleSelectedHandler, row_toggleSelected, selectRowsFn, table_getFilteredSelectedRowModel, table_getGroupedSelectedRowModel, table_getIsAllPageRowsSelected, table_getIsAllRowsSelected, table_getIsSomePageRowsSelected, table_getIsSomeRowsSelected, table_getPreSelectedRowModel, table_getSelectedRowModel, table_getToggleAllPageRowsSelectedHandler, table_getToggleAllRowsSelectedHandler, table_resetRowSelection, table_setRowSelection, table_toggleAllPageRowsSelected, table_toggleAllRowsSelected };
-//# sourceMappingURL=rowSelectionFeature.utils.d.ts.map
+export { getDefaultRowSelectionState, isRowSelected, isSubRowSelected, row_getCanMultiSelect, row_getCanSelect, row_getCanSelectSubRows, row_getIsAllSubRowsSelected, row_getIsSelected, row_getIsSomeSelected, row_getToggleSelectedHandler, row_toggleSelected, selectRowsFn, table_getFilteredSelectedRowModel, table_getGroupedSelectedRowModel, table_getIsAllPageRowsSelected, table_getIsAllRowsSelected, table_getIsSomePageRowsSelected, table_getIsSomeRowsSelected, table_getPreSelectedRowModel, table_getSelectedRowIds, table_getSelectedRowModel, table_getToggleAllPageRowsSelectedHandler, table_getToggleAllRowsSelectedHandler, table_resetRowSelection, table_setRowSelection, table_toggleAllPageRowsSelected, table_toggleAllRowsSelected };