@tanstack/table-core 9.0.0-beta.76 → 9.0.0-beta.77

package/dist/features/row-expanding/rowExpandingFeature.utils.d.ts

@@ -48,6 +48,9 @@ declare function table_setExpanded<TFeatures extends TableFeatures, TData extend
  * an empty map. Omitting the value toggles based on whether all rows are
  * currently expanded.
  *
+ * The call is a no-op (no `onExpandedChange`) when no row can expand or when
+ * the requested state matches the current state exactly.
+ *
  * @example
  * ```ts
  * table_toggleAllRowsExpanded(table)
@@ -100,10 +103,12 @@ declare function table_getToggleAllRowsExpandedHandler<TFeatures extends TableFe
  */
 declare function table_getIsSomeRowsExpanded<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): boolean;
 /**
- * Checks whether every row in the current row model is expanded.
+ * Checks whether every expandable row in the current row model is expanded.
  *
  * The special expanded-all value `true` returns true immediately. Empty
- * expanded state returns false.
+ * expanded state returns false. Rows that cannot expand are ignored, so a
+ * materialized expanded-all map (which only contains expandable row ids)
+ * still counts as all rows expanded.
  *
  * @example
  * ```ts
@@ -114,8 +119,8 @@ declare function table_getIsAllRowsExpanded<TFeatures extends TableFeatures, TDa
 /**
  * Computes the deepest expanded row id depth.
  *
- * Row ids are split on `.`; expanded-all state scans the current row model,
- * while explicit expanded state scans its expanded id keys.
+ * Row ids are split on `.`; expanded-all state scans the current row model's
+ * expandable rows, while explicit expanded state scans its expanded id keys.
  *
  * @example
  * ```ts
@@ -127,8 +132,12 @@ declare function table_getExpandedDepth<TFeatures extends TableFeatures, TData e
  * Expands or collapses this row.
  *
  * Omitting `expanded` toggles the row. If the current state is expanded-all,
- * the function first materializes that state into a row-id map before applying
- * the row-specific change.
+ * the function first materializes that state into a row-id map (containing
+ * only expandable row ids) before applying the row-specific change.
+ *
+ * The call is a no-op (no `onExpandedChange`) when the requested state matches
+ * the current state, or when expanding a row that cannot expand. Collapsing is
+ * always allowed so stale expanded ids can be cleaned up.
  *
  * @example
  * ```ts

package/dist/features/row-expanding/rowExpandingFeature.utils.js

@@ -52,14 +52,24 @@ function table_setExpanded(table, updater) {
 * an empty map. Omitting the value toggles based on whether all rows are
 * currently expanded.
 *
+* The call is a no-op (no `onExpandedChange`) when no row can expand or when
+* the requested state matches the current state exactly.
+*
 * @example
 * ```ts
 * table_toggleAllRowsExpanded(table)
 * ```
 */
 function table_toggleAllRowsExpanded(table, expanded) {
-	if (expanded ?? !table_getIsAllRowsExpanded(table)) table_setExpanded(table, true);
-	else table_setExpanded(table, makeObjectMap());
+	const currentExpanded = table.atoms.expanded?.get() ?? {};
+	if (expanded ?? !table_getIsAllRowsExpanded(table)) {
+		if (currentExpanded === true) return;
+		if (!table_getCanSomeRowsExpand(table)) return;
+		table_setExpanded(table, true);
+	} else {
+		if (currentExpanded !== true && !Object.keys(currentExpanded).length) return;
+		table_setExpanded(table, makeObjectMap());
+	}
 }
 /**
 * Resets `expanded` to the configured initial state or feature default.
@@ -119,10 +129,12 @@ function table_getIsSomeRowsExpanded(table) {
 	return expanded === true || Object.values(expanded).some(Boolean);
 }
 /**
-* Checks whether every row in the current row model is expanded.
+* Checks whether every expandable row in the current row model is expanded.
 *
 * The special expanded-all value `true` returns true immediately. Empty
-* expanded state returns false.
+* expanded state returns false. Rows that cannot expand are ignored, so a
+* materialized expanded-all map (which only contains expandable row ids)
+* still counts as all rows expanded.
 *
 * @example
 * ```ts
@@ -133,14 +145,16 @@ function table_getIsAllRowsExpanded(table) {
 	const expanded = table.atoms.expanded?.get() ?? {};
 	if (expanded === true) return true;
 	if (!Object.keys(expanded).length) return false;
-	if (table.getRowModel().flatRows.some((row) => !row_getIsExpanded(row))) return false;
+	const expandableRows = table.getRowModel().flatRows.filter((row) => row_getCanExpand(row));
+	if (!expandableRows.length) return false;
+	if (expandableRows.some((row) => !row_getIsExpanded(row))) return false;
 	return true;
 }
 /**
 * Computes the deepest expanded row id depth.
 *
-* Row ids are split on `.`; expanded-all state scans the current row model,
-* while explicit expanded state scans its expanded id keys.
+* Row ids are split on `.`; expanded-all state scans the current row model's
+* expandable rows, while explicit expanded state scans its expanded id keys.
 *
 * @example
 * ```ts
@@ -149,7 +163,8 @@ function table_getIsAllRowsExpanded(table) {
 */
 function table_getExpandedDepth(table) {
 	let maxDepth = 0;
-	(table.atoms.expanded?.get() === true ? Object.keys(table.getRowModel().rowsById) : Object.keys(table.atoms.expanded?.get() ?? {})).forEach((id) => {
+	const expanded = table.atoms.expanded?.get();
+	(expanded === true ? Object.values(table.getRowModel().rowsById).filter((row) => row_getCanExpand(row)).map((row) => row.id) : Object.keys(expanded ?? {})).forEach((id) => {
 		const splitId = id.split(".");
 		maxDepth = Math.max(maxDepth, splitId.length);
 	});
@@ -159,8 +174,12 @@ function table_getExpandedDepth(table) {
 * Expands or collapses this row.
 *
 * Omitting `expanded` toggles the row. If the current state is expanded-all,
-* the function first materializes that state into a row-id map before applying
-* the row-specific change.
+* the function first materializes that state into a row-id map (containing
+* only expandable row ids) before applying the row-specific change.
+*
+* The call is a no-op (no `onExpandedChange`) when the requested state matches
+* the current state, or when expanding a row that cannot expand. Collapsing is
+* always allowed so stale expanded ids can be cleaned up.
 *
 * @example
 * ```ts
@@ -168,19 +187,23 @@ function table_getExpandedDepth(table) {
 * ```
 */
 function row_toggleExpanded(row, expanded) {
+	const currentExpanded = row.table.atoms.expanded?.get() ?? {};
+	const currentExists = currentExpanded === true || isExpandedRowId(currentExpanded, row.id);
+	const targetExpanded = expanded ?? !currentExists;
+	if (targetExpanded === currentExists) return;
+	if (targetExpanded && !row_getCanExpand(row)) return;
 	table_setExpanded(row.table, (old) => {
 		const exists = old === true ? true : isExpandedRowId(old, row.id);
 		let oldExpanded = makeObjectMap();
-		if (old === true) Object.keys(row.table.getRowModel().rowsById).forEach((rowId) => {
-			oldExpanded[rowId] = true;
+		if (old === true) Object.values(row.table.getRowModel().rowsById).forEach((rowModelRow) => {
+			if (row_getCanExpand(rowModelRow)) oldExpanded[rowModelRow.id] = true;
 		});
 		else oldExpanded = Object.assign(makeObjectMap(), old);
-		expanded = expanded ?? !exists;
-		if (!exists && expanded) {
+		if (!exists && targetExpanded) {
 			oldExpanded[row.id] = true;
 			return oldExpanded;
 		}
-		if (exists && !expanded) {
+		if (exists && !targetExpanded) {
 			const rest = makeObjectMap();
 			const rowIds = Object.keys(oldExpanded);
 			for (let i = 0; i < rowIds.length; i++) {

package/dist/features/row-pagination/createPaginatedRowModel.js

@@ -45,7 +45,10 @@ function _createPaginatedRowModel(table) {
 		rowsById
 	};
 	paginatedRowModel.flatRows = [];
+	const seenFlatRows = /* @__PURE__ */ new Set();
 	const handleRow = (row) => {
+		if (seenFlatRows.has(row.id)) return;
+		seenFlatRows.add(row.id);
 		paginatedRowModel.flatRows.push(row);
 		if (row.subRows.length) row.subRows.forEach(handleRow);
 	};

package/dist/features/row-sorting/rowSortingFeature.types.d.ts

@@ -89,11 +89,15 @@ interface ColumnDef_RowSorting<in out TFeatures extends TableFeatures, in out TD
   /**
    * The priority of undefined values when sorting this column.
    * - `false`
-   *   - Undefined values will be considered tied and need to be sorted by the next column filter or original index (whichever applies)
+   *   - Undefined values will be passed to the sorting function like any other value with no special handling; the sorting function is responsible for handling them
    * - `-1`
    *   - Undefined values will be sorted with higher priority (ascending) (if ascending, undefined will appear on the beginning of the list)
    * - `1`
    *   - Undefined values will be sorted with lower priority (descending) (if ascending, undefined will appear on the end of the list)
+   * - `'first'`
+   *   - Undefined values will be pushed to the beginning of the list regardless of sort direction
+   * - `'last'`
+   *   - Undefined values will be pushed to the end of the list regardless of sort direction
    */
   sortUndefined?: false | -1 | 1 | 'first' | 'last';
 }
@@ -127,9 +131,11 @@ interface Column_RowSorting<in out TFeatures extends TableFeatures, in out TData
    */
   getIsSorted: () => false | SortDirection;
   /**
-   * Returns the next sorting order.
+   * Returns the next sorting order. Pass `multi` to resolve the order for a
+   * multi-sort toggle, where `enableMultiRemove` governs whether the cycle can
+   * remove the sort.
    */
-  getNextSortingOrder: () => SortDirection | false;
+  getNextSortingOrder: (multi?: boolean) => SortDirection | false;
   /**
    * Finds this column's position in the ordered sorting state.
    */

package/dist/features/row-sorting/rowSortingFeature.utils.d.ts

@@ -67,10 +67,13 @@ declare function table_autoResetSorting<TFeatures extends TableFeatures, TData e
  */
 declare function column_getAutoSortFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): SortFn<TFeatures, TData>;
 /**
- * Chooses the default first sort direction from the first filtered row value.
+ * Chooses the default first sort direction from sampled filtered row values.
  *
- * String columns start ascending so alphabetical order is natural; other value
- * types start descending.
+ * The first non-nullish value among the sampled rows decides: string columns
+ * start ascending so alphabetical order is natural; other value types (or
+ * columns with no non-nullish sample) start descending. Sampling past leading
+ * nullish values keeps the toggle cycle stable when sorting or a data swap
+ * moves an empty value into the first row.
  *
  * @example
  * ```ts
@@ -95,8 +98,8 @@ declare function column_getSortFn<TFeatures extends TableFeatures, TData extends
  * Applies the next sorting state for this column.
  *
  * The toggle can add, replace, flip, or remove this column's sort entry. Multi
- * sorting respects `enableMultiSort`, `maxMultiSortColCount`, and the `multi`
- * argument.
+ * sorting respects `enableMultiSort`, `enableMultiRemove`,
+ * `maxMultiSortColCount`, and the `multi` argument.
  *
  * @example
  * ```ts

package/dist/features/row-sorting/rowSortingFeature.utils.js

@@ -103,10 +103,13 @@ function column_getAutoSortFn(column) {
 	return sortFn_basic;
 }
 /**
-* Chooses the default first sort direction from the first filtered row value.
+* Chooses the default first sort direction from sampled filtered row values.
 *
-* String columns start ascending so alphabetical order is natural; other value
-* types start descending.
+* The first non-nullish value among the sampled rows decides: string columns
+* start ascending so alphabetical order is natural; other value types (or
+* columns with no non-nullish sample) start descending. Sampling past leading
+* nullish values keeps the toggle cycle stable when sorting or a data swap
+* moves an empty value into the first row.
 *
 * @example
 * ```ts
@@ -114,8 +117,12 @@ function column_getAutoSortFn(column) {
 * ```
 */
 function column_getAutoSortDir(column) {
-	const firstRow = column.table.getFilteredRowModel().flatRows[0];
-	if (typeof (firstRow ? firstRow.getValue(column.id) : void 0) === "string") return "asc";
+	const firstRows = column.table.getFilteredRowModel().flatRows.slice(0, 10);
+	for (let i = 0; i < firstRows.length; i++) {
+		const value = firstRows[i].getValue(column.id);
+		if (value == null) continue;
+		return typeof value === "string" ? "asc" : "desc";
+	}
 	return "desc";
 }
 /**
@@ -142,8 +149,8 @@ function column_getSortFn(column) {
 * Applies the next sorting state for this column.
 *
 * The toggle can add, replace, flip, or remove this column's sort entry. Multi
-* sorting respects `enableMultiSort`, `maxMultiSortColCount`, and the `multi`
-* argument.
+* sorting respects `enableMultiSort`, `enableMultiRemove`,
+* `maxMultiSortColCount`, and the `multi` argument.
 *
 * @example
 * ```ts
@@ -151,7 +158,7 @@ function column_getSortFn(column) {
 * ```
 */
 function column_toggleSorting(column, desc, multi) {
-	const nextSortingOrder = column_getNextSortingOrder(column);
+	const nextSortingOrder = column_getNextSortingOrder(column, multi && column_getCanMultiSort(column));
 	const hasManualValue = typeof desc !== "undefined";
 	table_setSorting(column.table, (old) => {
 		const existingIndex = old.findIndex((d) => d.id === column.id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/table-core",
-  "version": "9.0.0-beta.76",
+  "version": "9.0.0-beta.77",
   "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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76'
+  library_version: '9.0.0-beta.77'
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76'
+  library_version: '9.0.0-beta.77'
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76'
+  library_version: '9.0.0-beta.77'
 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.76'
+  library_version: '9.0.0-beta.77'
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76'
+  library_version: '9.0.0-beta.77'
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76',
+    library_version: '9.0.0-beta.77',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/row-selection/SKILL.md

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

package/skills/sorting/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.76',
+    library_version: '9.0.0-beta.77',
   }
 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.76'
+  library_version: '9.0.0-beta.77'
 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.76'
+  library_version: '9.0.0-beta.77'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:docs/guide/helpers.md'