@tanstack/table-core 9.0.0-beta.8 → 9.0.0-beta.80

package/dist/features/row-pinning/rowPinningFeature.js

@@ -24,10 +24,7 @@ const rowPinningFeature = {
 			row_getIsPinned: { fn: (row) => row_getIsPinned(row) },
 			row_getPinnedIndex: {
 				fn: (row) => row_getPinnedIndex(row),
-				memoDeps: (row) => {
-					var _row$table$atoms$rowP;
-					return [row.table.getRowModel().rows, (_row$table$atoms$rowP = row.table.atoms.rowPinning) === null || _row$table$atoms$rowP === void 0 ? void 0 : _row$table$atoms$rowP.get()];
-				}
+				memoDeps: (row) => [row.table.getRowModel().rows, row.table.atoms.rowPinning?.get()]
 			},
 			row_pin: { fn: (row, position, includeLeafRows, includeParentRows) => row_pin(row, position, includeLeafRows, includeParentRows) }
 		});
@@ -39,29 +36,19 @@ const rowPinningFeature = {
 			table_getIsSomeRowsPinned: { fn: (position) => table_getIsSomeRowsPinned(table, position) },
 			table_getTopRows: {
 				fn: () => table_getTopRows(table),
-				memoDeps: () => {
-					var _table$atoms$rowPinni;
-					return [table.getRowModel().rows, (_table$atoms$rowPinni = table.atoms.rowPinning) === null || _table$atoms$rowPinni === void 0 || (_table$atoms$rowPinni = _table$atoms$rowPinni.get()) === null || _table$atoms$rowPinni === void 0 ? void 0 : _table$atoms$rowPinni.top];
-				}
+				memoDeps: () => [table.getRowModel().rows, table.atoms.rowPinning?.get()?.top]
 			},
 			table_getBottomRows: {
 				fn: () => table_getBottomRows(table),
-				memoDeps: () => {
-					var _table$atoms$rowPinni2;
-					return [table.getRowModel().rows, (_table$atoms$rowPinni2 = table.atoms.rowPinning) === null || _table$atoms$rowPinni2 === void 0 || (_table$atoms$rowPinni2 = _table$atoms$rowPinni2.get()) === null || _table$atoms$rowPinni2 === void 0 ? void 0 : _table$atoms$rowPinni2.bottom];
-				}
+				memoDeps: () => [table.getRowModel().rows, table.atoms.rowPinning?.get()?.bottom]
 			},
 			table_getCenterRows: {
 				fn: () => table_getCenterRows(table),
-				memoDeps: () => {
-					var _table$atoms$rowPinni3;
-					return [table.getRowModel().rows, (_table$atoms$rowPinni3 = table.atoms.rowPinning) === null || _table$atoms$rowPinni3 === void 0 ? void 0 : _table$atoms$rowPinni3.get()];
-				}
+				memoDeps: () => [table.getRowModel().rows, table.atoms.rowPinning?.get()]
 			}
 		});
 	}
 };
 
 //#endregion
-export { rowPinningFeature };
-//# sourceMappingURL=rowPinningFeature.js.map
+export { rowPinningFeature };

package/dist/features/row-pinning/rowPinningFeature.types.d.ts

@@ -1,7 +1,6 @@
 import { OnChangeFn, RowData, Updater } from "../../types/type-utils.js";
 import { Row } from "../../types/Row.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
-
 //#region src/features/row-pinning/rowPinningFeature.types.d.ts
 type RowPinningPosition = false | 'top' | 'bottom';
 interface RowPinningState {
@@ -11,7 +10,7 @@ interface RowPinningState {
 interface TableState_RowPinning {
   rowPinning: RowPinningState;
 }
-interface TableOptions_RowPinning<TFeatures extends TableFeatures, TData extends RowData> {
+interface TableOptions_RowPinning<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
    * Allows rows to be pinned to top or bottom regions.
    *
@@ -50,7 +49,7 @@ interface Row_RowPinning {
    */
   pin: (position: RowPinningPosition, includeLeafRows?: boolean, includeParentRows?: boolean) => void;
 }
-interface Table_RowPinning<TFeatures extends TableFeatures, TData extends RowData> {
+interface Table_RowPinning<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
    * Gets rows pinned to the bottom region.
    */
@@ -79,5 +78,4 @@ interface Table_RowPinning<TFeatures extends TableFeatures, TData extends RowDat
   setRowPinning: (updater: Updater<RowPinningState>) => void;
 }
 //#endregion
-export { RowPinningDefaultOptions, RowPinningPosition, RowPinningState, Row_RowPinning, TableOptions_RowPinning, TableState_RowPinning, Table_RowPinning };
-//# sourceMappingURL=rowPinningFeature.types.d.ts.map
+export { RowPinningDefaultOptions, RowPinningPosition, RowPinningState, Row_RowPinning, TableOptions_RowPinning, TableState_RowPinning, Table_RowPinning };

package/dist/features/row-pinning/rowPinningFeature.utils.d.ts

@@ -1,9 +1,8 @@
 import { RowData, Updater } from "../../types/type-utils.js";
 import { RowPinningPosition, RowPinningState } from "./rowPinningFeature.types.js";
 import { Row } from "../../types/Row.js";
+import { Table } from "../../types/Table.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table_Internal } from "../../types/Table.js";
-
 //#region src/features/row-pinning/rowPinningFeature.utils.d.ts
 /**
  * Creates the default row pinning state.
@@ -28,7 +27,7 @@ declare function getDefaultRowPinningState(): RowPinningState;
  * table_setRowPinning(table, (old) => ({ ...old, top: [rowId] }))
  * ```
  */
-declare function table_setRowPinning<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<RowPinningState>): void;
+declare function table_setRowPinning<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, updater: Updater<RowPinningState>): void;
 /**
  * Resets `rowPinning` to the configured initial state or feature default.
  *
@@ -42,7 +41,7 @@ declare function table_setRowPinning<TFeatures extends TableFeatures, TData exte
  * table_resetRowPinning(table, true)
  * ```
  */
-declare function table_resetRowPinning<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
+declare function table_resetRowPinning<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, defaultState?: boolean): void;
 /**
  * Checks whether any rows are pinned.
  *
@@ -54,7 +53,7 @@ declare function table_resetRowPinning<TFeatures extends TableFeatures, TData ex
  * const hasPinnedRows = table_getIsSomeRowsPinned(table)
  * ```
  */
-declare function table_getIsSomeRowsPinned<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, position?: RowPinningPosition): boolean;
+declare function table_getIsSomeRowsPinned<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, position?: RowPinningPosition): boolean;
 /**
  * Resolves the visible rows pinned to the top region.
  *
@@ -66,7 +65,7 @@ declare function table_getIsSomeRowsPinned<TFeatures extends TableFeatures, TDat
  * const rows = table_getTopRows(table)
  * ```
  */
-declare function table_getTopRows<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Row<TFeatures, TData>>;
+declare function table_getTopRows<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): Array<Row<TFeatures, TData>>;
 /**
  * Resolves the visible rows pinned to the bottom region.
  *
@@ -78,7 +77,7 @@ declare function table_getTopRows<TFeatures extends TableFeatures, TData extends
  * const rows = table_getBottomRows(table)
  * ```
  */
-declare function table_getBottomRows<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Row<TFeatures, TData>>;
+declare function table_getBottomRows<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): Array<Row<TFeatures, TData>>;
 /**
  * Resolves rows that are not pinned to top or bottom.
  *
@@ -90,7 +89,7 @@ declare function table_getBottomRows<TFeatures extends TableFeatures, TData exte
  * const rows = table_getCenterRows(table)
  * ```
  */
-declare function table_getCenterRows<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Row<TFeatures, TData>>;
+declare function table_getCenterRows<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): Array<Row<TFeatures, TData>>;
 /**
  * Checks whether this row can be pinned.
  *
@@ -139,5 +138,4 @@ declare function row_getPinnedIndex<TFeatures extends TableFeatures, TData exten
  */
 declare function row_pin<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, position: RowPinningPosition, includeLeafRows?: boolean, includeParentRows?: boolean): void;
 //#endregion
-export { getDefaultRowPinningState, row_getCanPin, row_getIsPinned, row_getPinnedIndex, row_pin, table_getBottomRows, table_getCenterRows, table_getIsSomeRowsPinned, table_getTopRows, table_resetRowPinning, table_setRowPinning };
-//# sourceMappingURL=rowPinningFeature.utils.d.ts.map
+export { getDefaultRowPinningState, row_getCanPin, row_getIsPinned, row_getPinnedIndex, row_pin, table_getBottomRows, table_getCenterRows, table_getIsSomeRowsPinned, table_getTopRows, table_resetRowPinning, table_setRowPinning };

package/dist/features/row-pinning/rowPinningFeature.utils.js

@@ -31,8 +31,7 @@ function getDefaultRowPinningState() {
 * ```
 */
 function table_setRowPinning(table, updater) {
-	var _table$options$onRowP, _table$options;
-	(_table$options$onRowP = (_table$options = table.options).onRowPinningChange) === null || _table$options$onRowP === void 0 || _table$options$onRowP.call(_table$options, updater);
+	table.options.onRowPinningChange?.(updater);
 }
 /**
 * Resets `rowPinning` to the configured initial state or feature default.
@@ -62,23 +61,21 @@ function table_resetRowPinning(table, defaultState) {
 * ```
 */
 function table_getIsSomeRowsPinned(table, position) {
-	var _table$atoms$rowPinni;
-	const rowPinning = (_table$atoms$rowPinni = table.atoms.rowPinning) === null || _table$atoms$rowPinni === void 0 ? void 0 : _table$atoms$rowPinni.get();
-	if (!position) return Boolean((rowPinning === null || rowPinning === void 0 ? void 0 : rowPinning.top.length) || (rowPinning === null || rowPinning === void 0 ? void 0 : rowPinning.bottom.length));
-	return Boolean(rowPinning === null || rowPinning === void 0 ? void 0 : rowPinning[position].length);
+	const rowPinning = table.atoms.rowPinning?.get();
+	if (!position) return Boolean(rowPinning?.top.length || rowPinning?.bottom.length);
+	return Boolean(rowPinning?.[position].length);
 }
 function table_getPinnedRows(table, position) {
-	var _table$atoms$rowPinni2;
 	const visibleRows = table.getRowModel().rows;
-	const pinnedRowIds = ((_table$atoms$rowPinni2 = table.atoms.rowPinning) === null || _table$atoms$rowPinni2 === void 0 || (_table$atoms$rowPinni2 = _table$atoms$rowPinni2.get()) === null || _table$atoms$rowPinni2 === void 0 ? void 0 : _table$atoms$rowPinni2[position]) ?? [];
+	const pinnedRowIds = table.atoms.rowPinning?.get()?.[position] ?? [];
 	const keepPinnedRows = table.options.keepPinnedRows ?? true;
 	const result = [];
 	for (let i = 0; i < pinnedRowIds.length; i++) {
 		const rowId = pinnedRowIds[i];
 		let row;
 		if (keepPinnedRows) {
-			const fullRow = table.getRow(rowId, true);
-			if (row_getIsAllParentsExpanded(fullRow)) row = fullRow;
+			const fullRow = table.getPrePaginatedRowModel().rowsById[rowId] ?? table.getCoreRowModel().rowsById[rowId];
+			if (fullRow && row_getIsAllParentsExpanded(fullRow)) row = fullRow;
 		} else row = visibleRows.find((r) => r.id === rowId);
 		if (!row) continue;
 		row.position = position;
@@ -126,10 +123,9 @@ function table_getBottomRows(table) {
 * ```
 */
 function table_getCenterRows(table) {
-	var _table$atoms$rowPinni3;
-	const { top, bottom } = ((_table$atoms$rowPinni3 = table.atoms.rowPinning) === null || _table$atoms$rowPinni3 === void 0 ? void 0 : _table$atoms$rowPinni3.get()) ?? getDefaultRowPinningState();
+	const { top, bottom } = table.atoms.rowPinning?.get() ?? getDefaultRowPinningState();
 	const allRows = table.getRowModel().rows;
-	const topAndBottom = new Set([...top, ...bottom]);
+	const topAndBottom = /* @__PURE__ */ new Set([...top, ...bottom]);
 	return allRows.filter((d) => !topAndBottom.has(d.id));
 }
 /**
@@ -160,8 +156,7 @@ function row_getCanPin(row) {
 * ```
 */
 function row_getIsPinned(row) {
-	var _row$table$atoms$rowP;
-	const { top, bottom } = ((_row$table$atoms$rowP = row.table.atoms.rowPinning) === null || _row$table$atoms$rowP === void 0 ? void 0 : _row$table$atoms$rowP.get()) ?? getDefaultRowPinningState();
+	const { top, bottom } = row.table.atoms.rowPinning?.get() ?? getDefaultRowPinningState();
 	return top.includes(row.id) ? "top" : bottom.includes(row.id) ? "bottom" : false;
 }
 /**
@@ -193,7 +188,7 @@ function row_getPinnedIndex(row) {
 function row_pin(row, position, includeLeafRows, includeParentRows) {
 	const leafRowIds = includeLeafRows ? row.getLeafRows().map(({ id }) => id) : [];
 	const parentRowIds = includeParentRows ? row.getParentRows().map(({ id }) => id) : [];
-	const rowIds = new Set([
+	const rowIds = /* @__PURE__ */ new Set([
 		...parentRowIds,
 		row.id,
 		...leafRowIds
@@ -215,5 +210,4 @@ function row_pin(row, position, includeLeafRows, includeParentRows) {
 }
 
 //#endregion
-export { getDefaultRowPinningState, row_getCanPin, row_getIsPinned, row_getPinnedIndex, row_pin, table_getBottomRows, table_getCenterRows, table_getIsSomeRowsPinned, table_getTopRows, table_resetRowPinning, table_setRowPinning };
-//# sourceMappingURL=rowPinningFeature.utils.js.map
+export { getDefaultRowPinningState, row_getCanPin, row_getIsPinned, row_getPinnedIndex, row_pin, table_getBottomRows, table_getCenterRows, table_getIsSomeRowsPinned, table_getTopRows, table_resetRowPinning, table_setRowPinning };

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

@@ -1,10 +1,8 @@
 import { TableFeature } from "../../types/TableFeatures.js";
-
 //#region src/features/row-selection/rowSelectionFeature.d.ts
 /**
  * Feature that adds row selection state and APIs for row and page selection.
  */
 declare const rowSelectionFeature: TableFeature;
 //#endregion
-export { rowSelectionFeature };
-//# sourceMappingURL=rowSelectionFeature.d.ts.map
+export { rowSelectionFeature };

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,93 @@ 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.options.enableSubRowSelection
+				]
+			},
+			table_getIsAllPageRowsSelected: {
+				fn: () => table_getIsAllPageRowsSelected(table),
+				memoDeps: () => [
+					table.atoms.rowSelection?.get(),
+					table.getPaginatedRowModel(),
+					table.options.enableRowSelection,
+					table.options.enableSubRowSelection
+				]
+			},
+			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 +117,4 @@ const rowSelectionFeature = {
 };
 
 //#endregion
-export { rowSelectionFeature };
-//# sourceMappingURL=rowSelectionFeature.js.map
+export { rowSelectionFeature };

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

@@ -1,14 +1,39 @@
 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 and ancestors.
+ */
+interface ToggleSelectedOptions {
+  /**
+   * Whether selectable child rows should be toggled recursively. Defaults to
+   * `true`.
+   */
+  selectChildren?: boolean;
+  /**
+   * Whether ancestor row ids should be removed from the selection when this
+   * row is deselected. Useful after a parent cascade wrote the parent id into
+   * state and a child is later deselected. Defaults to `false`.
+   *
+   * Ancestor ids are removed even when the ancestor itself cannot be selected.
+   * Like the other targeted deselection paths, pruning is not gated by
+   * `enableRowSelection`; only the bulk select-all paths preserve
+   * non-selectable rows.
+   */
+  deselectParents?: 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.
    *
@@ -25,9 +50,18 @@ interface TableOptions_RowSelection<TFeatures extends TableFeatures, TData exten
    * Controls whether selecting a parent row also selects its subRows.
    *
    * Provide a predicate to decide per row. This is most useful with expanding or
-   * grouping features and defaults to `true`.
+   * grouping features and defaults to `true`. Select-all and the all-selected
+   * getters also skip descendants of parents that block sub-row selection.
    */
   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 +96,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,20 +121,26 @@ 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.
+   * Sub-rows whose ancestors block sub-row selection are ignored.
    */
   getIsAllPageRowsSelected: () => boolean;
   /**
    * Checks whether every selectable filtered row is selected.
+   * Sub-rows whose ancestors block sub-row selection are ignored.
    */
   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 +172,18 @@ 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.
+   *
+   * Deselecting keeps rows that cannot be selected in the selection map unless
+   * `opts.deselectAll` is `true`.
    */
-  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 };