@tanstack/table-core 9.0.0-beta.73 → 9.0.0-beta.74

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

@@ -85,7 +85,8 @@ const rowSelectionFeature = {
 				memoDeps: () => [
 					table.atoms.rowSelection?.get(),
 					table.getFilteredRowModel(),
-					table.options.enableRowSelection
+					table.options.enableRowSelection,
+					table.options.enableSubRowSelection
 				]
 			},
 			table_getIsAllPageRowsSelected: {
@@ -93,7 +94,8 @@ const rowSelectionFeature = {
 				memoDeps: () => [
 					table.atoms.rowSelection?.get(),
 					table.getPaginatedRowModel(),
-					table.options.enableRowSelection
+					table.options.enableRowSelection,
+					table.options.enableSubRowSelection
 				]
 			},
 			table_getIsSomeRowsSelected: {

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

@@ -5,7 +5,7 @@ import { TableFeatures } from "../../types/TableFeatures.js";
 //#region src/features/row-selection/rowSelectionFeature.types.d.ts
 type RowSelectionState = Record<string, true>;
 /**
- * Controls how toggling a row affects its descendants.
+ * Controls how toggling a row affects its descendants and ancestors.
  */
 interface ToggleSelectedOptions {
   /**
@@ -13,6 +13,17 @@ interface ToggleSelectedOptions {
    * `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;
@@ -39,7 +50,8 @@ interface TableOptions_RowSelection<in out TFeatures extends TableFeatures, in o
    * 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);
   /**
@@ -115,10 +127,12 @@ interface Table_RowSelection<in out TFeatures extends TableFeatures, in out TDat
   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;
   /**
@@ -163,6 +177,9 @@ interface Table_RowSelection<in out TFeatures extends TableFeatures, in out TDat
   }) => 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, opts?: {
     deselectAll?: boolean;

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

@@ -46,7 +46,10 @@ declare function table_resetRowSelection<TFeatures extends TableFeatures, TData
  * Selects or deselects every selectable row before grouping.
  *
  * Omitting `value` toggles based on `table_getIsAllRowsSelected(table)`.
- * Deselecting removes matching ids from the existing selection map.
+ * Selecting skips sub-rows whose ancestors block descent via
+ * `enableSubRowSelection`. Deselecting removes matching selectable ids from the
+ * existing selection map; rows that cannot be selected keep their selection
+ * unless `opts.deselectAll` is `true`.
  *
  * @example
  * ```ts
@@ -143,7 +146,8 @@ declare function table_getSelectedRowIds<TFeatures extends TableFeatures, TData
  * Checks whether every selectable filtered row is selected.
  *
  * The result is false when there are no filtered rows or when selection state is
- * empty.
+ * empty. Sub-rows whose ancestors block descent via `enableSubRowSelection` are
+ * ignored, matching the rows that `table_toggleAllRowsSelected` selects.
  *
  * @example
  * ```ts
@@ -154,7 +158,8 @@ declare function table_getIsAllRowsSelected<TFeatures extends TableFeatures, TDa
 /**
  * Checks whether every selectable row on the current page is selected.
  *
- * Non-selectable rows are ignored for this calculation.
+ * Non-selectable rows are ignored for this calculation, as are sub-rows whose
+ * ancestors block descent via `enableSubRowSelection`.
  *
  * @example
  * ```ts
@@ -211,7 +216,8 @@ declare function table_getToggleAllPageRowsSelectedHandler<TFeatures extends Tab
  *
  * Omitting `value` toggles the row. Child rows are selected recursively unless
  * `opts.selectChildren` is `false`, sub-row selection is disabled, or the row
- * only supports single selection.
+ * only supports single selection. Pass `deselectParents: true` to also remove
+ * ancestor row ids from the selection when this row is deselected.
  *
  * @example
  * ```ts
@@ -219,7 +225,7 @@ declare function table_getToggleAllPageRowsSelectedHandler<TFeatures extends Tab
  * row_toggleSelected(row, true)
  * row_toggleSelected(row, false)
  * row_toggleSelected(row, true, { selectChildren: false })
- * row_toggleSelected(row, false, { selectChildren: false })
+ * row_toggleSelected(row, false, { deselectParents: true })
  * ```
  */
 declare function row_toggleSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, value?: boolean, opts?: ToggleSelectedOptions): void;
@@ -299,7 +305,8 @@ declare function row_getCanMultiSelect<TFeatures extends TableFeatures, TData ex
  * `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.
+ * display-order interval, and `deselectParents: true` to remove ancestor row
+ * ids from the selection when rows are deselected.
  *
  * @example
  * ```ts

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

@@ -49,7 +49,10 @@ function table_resetRowSelection(table, defaultState) {
 * Selects or deselects every selectable row before grouping.
 *
 * Omitting `value` toggles based on `table_getIsAllRowsSelected(table)`.
-* Deselecting removes matching ids from the existing selection map.
+* Selecting skips sub-rows whose ancestors block descent via
+* `enableSubRowSelection`. Deselecting removes matching selectable ids from the
+* existing selection map; rows that cannot be selected keep their selection
+* unless `opts.deselectAll` is `true`.
 *
 * @example
 * ```ts
@@ -63,11 +66,13 @@ function table_toggleAllRowsSelected(table, value, opts) {
 		if (opts?.deselectAll && !value) return makeObjectMap();
 		const rowSelection = Object.assign(makeObjectMap(), old);
 		const preGroupedFlatRows = table.getPreGroupedRowModel().flatRows;
-		if (value) preGroupedFlatRows.forEach((row) => {
-			if (row_getCanSelect(row)) rowSelection[row.id] = true;
-		});
-		else preGroupedFlatRows.forEach((row) => {
-			delete rowSelection[row.id];
+		if (value) {
+			const subtreeCache = /* @__PURE__ */ new Map();
+			preGroupedFlatRows.forEach((row) => {
+				if (isRowSelectableInSelectAll(row, subtreeCache)) rowSelection[row.id] = true;
+			});
+		} else preGroupedFlatRows.forEach((row) => {
+			if (row_getCanSelect(row)) delete rowSelection[row.id];
 		});
 		return rowSelection;
 	});
@@ -90,7 +95,7 @@ function table_toggleAllPageRowsSelected(table, value, opts) {
 		if (opts?.deselectAll && !resolvedValue) return makeObjectMap();
 		const rowSelection = Object.assign(makeObjectMap(), old);
 		table.getRowModel().rows.forEach((row) => {
-			mutateRowIsSelected(rowSelection, row.id, resolvedValue, true, table);
+			mutateRowIsSelected(rowSelection, row.id, resolvedValue, true, table, true);
 		});
 		return rowSelection;
 	});
@@ -184,7 +189,8 @@ function table_getSelectedRowIds(table) {
 * Checks whether every selectable filtered row is selected.
 *
 * The result is false when there are no filtered rows or when selection state is
-* empty.
+* empty. Sub-rows whose ancestors block descent via `enableSubRowSelection` are
+* ignored, matching the rows that `table_toggleAllRowsSelected` selects.
 *
 * @example
 * ```ts
@@ -196,14 +202,16 @@ function table_getIsAllRowsSelected(table) {
 	const rowSelection = table.atoms.rowSelection?.get() ?? {};
 	let isAllRowsSelected = Boolean(preGroupedFlatRows.length && Object.keys(rowSelection).length);
 	if (isAllRowsSelected) {
-		if (preGroupedFlatRows.some((row) => row_getCanSelect(row) && !isRowSelected(row, rowSelection))) isAllRowsSelected = false;
+		const subtreeCache = /* @__PURE__ */ new Map();
+		if (preGroupedFlatRows.some((row) => !isRowSelected(row, rowSelection) && isRowSelectableInSelectAll(row, subtreeCache))) isAllRowsSelected = false;
 	}
 	return isAllRowsSelected;
 }
 /**
 * Checks whether every selectable row on the current page is selected.
 *
-* Non-selectable rows are ignored for this calculation.
+* Non-selectable rows are ignored for this calculation, as are sub-rows whose
+* ancestors block descent via `enableSubRowSelection`.
 *
 * @example
 * ```ts
@@ -211,11 +219,17 @@ function table_getIsAllRowsSelected(table) {
 * ```
 */
 function table_getIsAllPageRowsSelected(table) {
-	const paginationFlatRows = table.getPaginatedRowModel().flatRows.filter((row) => row_getCanSelect(row));
+	const paginationFlatRows = table.getPaginatedRowModel().flatRows;
 	const rowSelection = table.atoms.rowSelection?.get() ?? {};
-	let isAllPageRowsSelected = !!paginationFlatRows.length;
-	if (isAllPageRowsSelected && paginationFlatRows.some((row) => !isRowSelected(row, rowSelection))) isAllPageRowsSelected = false;
-	return isAllPageRowsSelected;
+	const subtreeCache = /* @__PURE__ */ new Map();
+	let sawSelectableRow = false;
+	for (let i = 0; i < paginationFlatRows.length; i++) {
+		const row = paginationFlatRows[i];
+		if (!isRowSelected(row, rowSelection)) {
+			if (isRowSelectableInSelectAll(row, subtreeCache)) return false;
+		} else if (!sawSelectableRow && isRowSelectableInSelectAll(row, subtreeCache)) sawSelectableRow = true;
+	}
+	return sawSelectableRow;
 }
 /**
 * Checks whether at least one row id is selected.
@@ -278,7 +292,8 @@ function table_getToggleAllPageRowsSelectedHandler(table) {
 *
 * Omitting `value` toggles the row. Child rows are selected recursively unless
 * `opts.selectChildren` is `false`, sub-row selection is disabled, or the row
-* only supports single selection.
+* only supports single selection. Pass `deselectParents: true` to also remove
+* ancestor row ids from the selection when this row is deselected.
 *
 * @example
 * ```ts
@@ -286,7 +301,7 @@ function table_getToggleAllPageRowsSelectedHandler(table) {
 * row_toggleSelected(row, true)
 * row_toggleSelected(row, false)
 * row_toggleSelected(row, true, { selectChildren: false })
-* row_toggleSelected(row, false, { selectChildren: false })
+* row_toggleSelected(row, false, { deselectParents: true })
 * ```
 */
 function row_toggleSelected(row, value, opts) {
@@ -295,6 +310,7 @@ function row_toggleSelected(row, value, opts) {
 		value = typeof value !== "undefined" ? value : !isSelected;
 		const rowSelection = Object.assign(makeObjectMap(), old);
 		mutateRowIsSelected(rowSelection, row.id, value, (opts?.selectChildren ?? true) && row_getCanMultiSelect(row), row.table);
+		if (!value && opts?.deselectParents) pruneAncestorRowIds(rowSelection, row);
 		return rowSelection;
 	});
 }
@@ -392,7 +408,8 @@ function row_getCanMultiSelect(row) {
 * `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.
+* display-order interval, and `deselectParents: true` to remove ancestor row
+* ids from the selection when rows are deselected.
 *
 * @example
 * ```ts
@@ -407,7 +424,7 @@ function row_getToggleSelectedHandler(row, opts) {
 		const table = row.table;
 		const checked = event.target.checked;
 		const anchorId = table._lastSelectedRowId;
-		if (!(table.options.enableRowRangeSelection !== false && anchorId !== null && row_getCanMultiSelect(row) && (table.options.isRowRangeSelectionEvent?.(e) ?? false)) || !selectRowRange(row, anchorId, checked, opts?.selectChildren ?? true)) row_toggleSelected(row, checked, opts);
+		if (!(table.options.enableRowRangeSelection !== false && anchorId !== null && row_getCanMultiSelect(row) && (table.options.isRowRangeSelectionEvent?.(e) ?? false)) || !selectRowRange(row, anchorId, checked, opts)) row_toggleSelected(row, checked, opts);
 		table._lastSelectedRowId = row.id;
 	};
 }
@@ -422,7 +439,8 @@ function row_getToggleSelectedHandler(row, opts) {
 * selection updater; non-selectable and non-multi-selectable rows are skipped.
 * Returns `false` when the interaction should fall back to an ordinary toggle.
 */
-function selectRowRange(row, anchorId, value, includeChildren) {
+function selectRowRange(row, anchorId, value, opts) {
+	const includeChildren = opts?.selectChildren ?? true;
 	const table = row.table;
 	const rows = table.getRowsInDisplayOrder();
 	const anchorRow = table.getPrePaginatedRowModel().rowsById[anchorId] ?? table.getCoreRowModel().rowsById[anchorId];
@@ -440,19 +458,65 @@ function selectRowRange(row, anchorId, value, includeChildren) {
 			const rangeRow = rows[index];
 			if (!row_getCanSelect(rangeRow) || !row_getCanMultiSelect(rangeRow)) continue;
 			mutateRowIsSelected(rowSelection, rangeRow.id, value, includeChildren, table);
+			if (!value && opts?.deselectParents) pruneAncestorRowIds(rowSelection, rangeRow);
 		}
 		return rowSelection;
 	});
 	return true;
 }
-const mutateRowIsSelected = (rowSelection, rowId, value, includeChildren, table) => {
+function mutateRowIsSelected(rowSelection, rowId, value, includeChildren, table, respectCanSelectOnDeselect) {
 	const row = table.getRow(rowId, true);
 	if (value) {
 		if (!row_getCanMultiSelect(row)) Object.keys(rowSelection).forEach((key) => delete rowSelection[key]);
 		if (row_getCanSelect(row)) rowSelection[rowId] = true;
-	} else delete rowSelection[rowId];
-	if (includeChildren && row.subRows.length && row_getCanSelectSubRows(row)) row.subRows.forEach((r) => mutateRowIsSelected(rowSelection, r.id, value, includeChildren, table));
-};
+	} else if (!respectCanSelectOnDeselect || row_getCanSelect(row)) delete rowSelection[rowId];
+	if (includeChildren && row.subRows.length && row_getCanSelectSubRows(row)) row.subRows.forEach((r) => mutateRowIsSelected(rowSelection, r.id, value, includeChildren, table, respectCanSelectOnDeselect));
+}
+/**
+* Returns whether a select-all cascade can reach this row: the row itself is
+* selectable and no ancestor blocks descent via `enableSubRowSelection`.
+*
+* `subtreeCache` memoizes the per-ancestor verdict for one select-all pass, so
+* ancestor chains shared by sibling rows are only walked (and the
+* `enableSubRowSelection` predicate only invoked) once per unique ancestor.
+*/
+function isRowSelectableInSelectAll(row, subtreeCache) {
+	if (!row_getCanSelect(row)) return false;
+	const table = row.table;
+	if (table.options.enableSubRowSelection === true) return true;
+	const parentId = row.parentId;
+	if (parentId === void 0) return true;
+	const cached = subtreeCache.get(parentId);
+	if (cached !== void 0) return cached;
+	const rowsById = table.getCoreRowModel().rowsById;
+	const visited = [];
+	let selectable = true;
+	let currentId = parentId;
+	while (currentId !== void 0) {
+		const known = subtreeCache.get(currentId);
+		if (known !== void 0) {
+			selectable = known;
+			break;
+		}
+		visited.push(currentId);
+		const parent = rowsById[currentId] ?? table.getRow(currentId, true);
+		if (!row_getCanSelectSubRows(parent)) {
+			selectable = false;
+			break;
+		}
+		currentId = parent.parentId;
+	}
+	visited.forEach((id) => subtreeCache.set(id, selectable));
+	return selectable;
+}
+function pruneAncestorRowIds(rowSelection, row) {
+	const rowsById = row.table.getCoreRowModel().rowsById;
+	let parentId = row.parentId;
+	while (parentId !== void 0) {
+		delete rowSelection[parentId];
+		parentId = (rowsById[parentId] ?? row.table.getRow(parentId, true)).parentId;
+	}
+}
 function selectRowsRecursively(rows, rowSelection, selectedFlatRows, selectedRowsById) {
 	const result = [];
 	for (let i = 0; i < rows.length; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/table-core",
-  "version": "9.0.0-beta.73",
+  "version": "9.0.0-beta.74",
   "description": "Headless UI for building powerful tables & datagrids for TS/JS.",
   "author": "Tanner Linsley",
   "license": "MIT",

package/skills/aggregation/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/api-not-found/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.73'
+  library_version: '9.0.0-beta.74'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:packages/table-core/src/index.ts'

package/skills/cell-selection/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/cell-spanning/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/client-vs-server/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.73'
+  library_version: '9.0.0-beta.74'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:docs/guide/row-models.md'

package/skills/column-faceting/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'column-filtering']
 sources:

package/skills/column-filtering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/column-ordering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/column-pinning/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'column-sizing']
 sources:

package/skills/column-resizing/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'column-sizing']
 sources:

package/skills/column-sizing/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/column-visibility/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/core/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.73'
+  library_version: '9.0.0-beta.74'
 sources:
   - 'TanStack/table:docs/overview.md'
   - 'TanStack/table:docs/guide/tables.md'

package/skills/custom-features/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.73'
+  library_version: '9.0.0-beta.74'
 requires: ['core', 'table-features', 'typescript']
 sources:
   - 'TanStack/table:docs/framework/react/guide/custom-features.md'

package/skills/expanding/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/global-filtering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'client-vs-server', 'column-filtering']
 sources:

package/skills/grouping/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/migrate-v8-to-v9/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: lifecycle
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.73'
+  library_version: '9.0.0-beta.74'
 requires: ['core', 'table-features', 'typescript']
 sources:
   - 'TanStack/table:docs/framework/react/guide/migrating.md'

package/skills/pagination/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/row-pinning/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/row-selection/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: row-selection
 description: >
-  Maintain rowSelection ID state with stable getRowId, single, multi, subrow, and Shift-range rules, selected row models, handler anchors, and manual-pagination semantics. Load when implementing getToggleSelectedHandler, enableRowRangeSelection, selectChildren, or selected IDs that outlive loaded Row objects.
+  Maintain rowSelection ID state with stable getRowId, single, multi, subrow, and Shift-range rules, selected row models, handler anchors, and manual-pagination semantics. Load when implementing getToggleSelectedHandler, enableRowRangeSelection, selectChildren, deselectParents, or selected IDs that outlive loaded Row objects.
 metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features']
 sources:
@@ -65,6 +65,20 @@ export function getDisplayedRowsOnlyHandler(row: Row<typeof features, Person>) {
 
 The default `selectChildren: true` recursively changes selectable descendants of parents encountered in the range. Set it to `false` when collapsed descendants outside the display-order interval must remain unchanged.
 
+### Prune stale parent ids on child deselection
+
+```ts
+export function getPruningHandler(row: Row<typeof features, Person>) {
+  return row.getToggleSelectedHandler({ deselectParents: true })
+}
+```
+
+Selecting a parent cascades its id plus selectable descendant ids into state, but deselecting a child later leaves the parent id behind by default (some tables treat state ids as literal selections, e.g. with `selectChildren: false`). The default `deselectParents: false` preserves that; set it to `true` so deselecting any row also deletes every ancestor id, keeping `row.getIsSelected()` honest for parents. Applies to `toggleSelected` and both plain and Shift-range handler paths.
+
+### Select-all honors sub-row selection rules
+
+With `enableSubRowSelection: false` (or a per-row predicate), `table.toggleAllRowsSelected()` skips descendants of blocking parents, and `getIsAllRowsSelected()`/`getIsAllPageRowsSelected()` exclude those descendants from the all-selected computation, so the header checkbox still reads checked. Deselect-all skips rows whose `enableRowSelection` resolves false, preserving their selection; use `toggleAllRowsSelected(false, { deselectAll: true })` or `resetRowSelection(true)` to clear everything including disabled and out-of-model ids.
+
 ## Common Mistakes
 
 ### [HIGH] Expecting selection to clean itself

package/skills/sorting/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.73',
+    library_version: '9.0.0-beta.74',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/table-features/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.73'
+  library_version: '9.0.0-beta.74'
 requires: ['core']
 sources:
   - 'TanStack/table:docs/guide/row-models.md'

package/skills/typescript/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.73'
+  library_version: '9.0.0-beta.74'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:docs/guide/helpers.md'