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

package/dist/features/column-faceting/columnFacetingFeature.d.ts

@@ -2,6 +2,12 @@ import { TableFeature } from "../../types/TableFeatures.js";
 //#region src/features/column-faceting/columnFacetingFeature.d.ts
 /**
  * Feature that derives faceted row models, unique values, and min/max values for filters.
+ *
+ * These APIs are deliberately not memoized at this layer: the stock
+ * `createFaceted*` factories memoize internally (like every other stock row
+ * model), and an extra memo layer here would freeze custom factories whose
+ * data changes independently of the faceted row model. Custom factories own
+ * their memoization.
  */
 declare const columnFacetingFeature: TableFeature;
 //#endregion

package/dist/features/column-faceting/columnFacetingFeature.js

@@ -1,51 +1,29 @@
-import { assignPrototypeAPIs, assignTableAPIs, callMemoOrStaticFn } from "../../utils.js";
+import { assignPrototypeAPIs, assignTableAPIs } from "../../utils.js";
 import { column_getFacetedMinMaxValues, column_getFacetedRowModel, column_getFacetedUniqueValues, table_getGlobalFacetedMinMaxValues, table_getGlobalFacetedRowModel, table_getGlobalFacetedUniqueValues } from "./columnFacetingFeature.utils.js";
 
 //#region src/features/column-faceting/columnFacetingFeature.ts
 /**
 * Feature that derives faceted row models, unique values, and min/max values for filters.
+*
+* These APIs are deliberately not memoized at this layer: the stock
+* `createFaceted*` factories memoize internally (like every other stock row
+* model), and an extra memo layer here would freeze custom factories whose
+* data changes independently of the faceted row model. Custom factories own
+* their memoization.
 */
 const columnFacetingFeature = {
 	assignColumnPrototype: (prototype, table) => {
 		assignPrototypeAPIs("columnFacetingFeature", prototype, table, {
-			column_getFacetedRowModel: {
-				memoDeps: () => [
-					table.getPreFilteredRowModel().rows,
-					table.atoms.columnFilters?.get(),
-					table.atoms.globalFilter?.get(),
-					table.getFilteredRowModel().rows
-				],
-				fn: (column) => column_getFacetedRowModel(column, column.table)
-			},
-			column_getFacetedMinMaxValues: {
-				memoDeps: (column) => [callMemoOrStaticFn(column, "getFacetedRowModel", column_getFacetedRowModel, column.table).flatRows],
-				fn: (column) => column_getFacetedMinMaxValues(column, column.table)
-			},
-			column_getFacetedUniqueValues: {
-				memoDeps: (column) => [callMemoOrStaticFn(column, "getFacetedRowModel", column_getFacetedRowModel, column.table).flatRows],
-				fn: (column) => column_getFacetedUniqueValues(column, column.table)
-			}
+			column_getFacetedRowModel: { fn: (column) => column_getFacetedRowModel(column, column.table) },
+			column_getFacetedMinMaxValues: { fn: (column) => column_getFacetedMinMaxValues(column, column.table) },
+			column_getFacetedUniqueValues: { fn: (column) => column_getFacetedUniqueValues(column, column.table) }
 		});
 	},
 	constructTableAPIs: (table) => {
 		assignTableAPIs("columnFacetingFeature", table, {
-			table_getGlobalFacetedRowModel: {
-				memoDeps: () => [
-					table.getPreFilteredRowModel().rows,
-					table.atoms.columnFilters?.get(),
-					table.atoms.globalFilter?.get(),
-					table.getFilteredRowModel().rows
-				],
-				fn: () => table_getGlobalFacetedRowModel(table)
-			},
-			table_getGlobalFacetedMinMaxValues: {
-				memoDeps: () => [callMemoOrStaticFn(table, "getGlobalFacetedRowModel", table_getGlobalFacetedRowModel).flatRows],
-				fn: () => table_getGlobalFacetedMinMaxValues(table)
-			},
-			table_getGlobalFacetedUniqueValues: {
-				memoDeps: () => [callMemoOrStaticFn(table, "getGlobalFacetedRowModel", table_getGlobalFacetedRowModel).flatRows],
-				fn: () => table_getGlobalFacetedUniqueValues(table)
-			}
+			table_getGlobalFacetedRowModel: { fn: () => table_getGlobalFacetedRowModel(table) },
+			table_getGlobalFacetedMinMaxValues: { fn: () => table_getGlobalFacetedMinMaxValues(table) },
+			table_getGlobalFacetedUniqueValues: { fn: () => table_getGlobalFacetedUniqueValues(table) }
 		});
 	}
 };

package/dist/features/column-faceting/columnFacetingFeature.utils.js

@@ -51,9 +51,13 @@ function column_getFacetedRowModel(column, table) {
 function column_getFacetedUniqueValues(column, table) {
 	const facetedUniqueValues = table._rowModels.facetedUniqueValues ??= makeObjectMap();
 	let facetedUniqueValuesFn = facetedUniqueValues[column.id];
-	if (!facetedUniqueValuesFn) facetedUniqueValuesFn = facetedUniqueValues[column.id] = table.options.features.facetedUniqueValues?.(table, column.id) ?? (() => /* @__PURE__ */ new Map());
+	if (!facetedUniqueValuesFn) facetedUniqueValuesFn = facetedUniqueValues[column.id] = table.options.features.facetedUniqueValues?.(table, column.id) ?? createStableEmptyMapFn();
 	return facetedUniqueValuesFn();
 }
+function createStableEmptyMapFn() {
+	const emptyMap = /* @__PURE__ */ new Map();
+	return () => emptyMap;
+}
 /**
 * Computes min and max numeric facet values for the global filter context.
 *
@@ -99,7 +103,7 @@ function table_getGlobalFacetedRowModel(table) {
 * ```
 */
 function table_getGlobalFacetedUniqueValues(table) {
-	if (!table._rowModels.globalFacetedUniqueValues) table._rowModels.globalFacetedUniqueValues = table.options.features.facetedUniqueValues?.(table, "__global__") ?? (() => /* @__PURE__ */ new Map());
+	if (!table._rowModels.globalFacetedUniqueValues) table._rowModels.globalFacetedUniqueValues = table.options.features.facetedUniqueValues?.(table, "__global__") ?? createStableEmptyMapFn();
 	const facetedUniqueValuesFn = table._rowModels.globalFacetedUniqueValues;
 	return facetedUniqueValuesFn();
 }

package/dist/features/column-filtering/columnFilteringFeature.types.d.ts

@@ -39,6 +39,11 @@ interface FilterFn<in out TFeatures extends TableFeatures, in out TData extends
   /**
    * Removes the filter from `state.columnFilters` when the filter value fails
    * this test (e.g. empty strings for text filters).
+   *
+   * When provided, this test is authoritative: values it keeps stay in filter
+   * state even when they are empty strings, which the default heuristic would
+   * otherwise remove. An `undefined` filter value always clears the filter
+   * regardless.
    */
   autoRemove?: ColumnFilterAutoRemoveTestFn<TFeatures, TData>;
   /**

package/dist/features/column-filtering/columnFilteringFeature.utils.d.ts

@@ -133,7 +133,12 @@ declare function table_resetColumnFilters<TFeatures extends TableFeatures, TData
 /**
  * Returns whether a filter value should be removed from filter state.
  *
- * This checks the filter function's `autoRemove` hook and built-in empty-value rules.
+ * `undefined` always removes: it is the universal "clear this filter"
+ * sentinel used by `setFilterValue(undefined)` and functional updaters. For
+ * any other value, a filter function's `autoRemove` hook is authoritative
+ * when provided, so custom filter functions can keep values (such as empty
+ * strings) that the default heuristic would drop. Without an `autoRemove`
+ * hook, empty strings are removed.
  *
  * @example
  * ```ts

package/dist/features/column-filtering/columnFilteringFeature.utils.js

@@ -199,7 +199,12 @@ function table_resetColumnFilters(table, defaultState) {
 /**
 * Returns whether a filter value should be removed from filter state.
 *
-* This checks the filter function's `autoRemove` hook and built-in empty-value rules.
+* `undefined` always removes: it is the universal "clear this filter"
+* sentinel used by `setFilterValue(undefined)` and functional updaters. For
+* any other value, a filter function's `autoRemove` hook is authoritative
+* when provided, so custom filter functions can keep values (such as empty
+* strings) that the default heuristic would drop. Without an `autoRemove`
+* hook, empty strings are removed.
 *
 * @example
 * ```ts
@@ -207,7 +212,9 @@ function table_resetColumnFilters(table, defaultState) {
 * ```
 */
 function shouldAutoRemoveFilter(filterFn, value, column) {
-	return (filterFn && filterFn.autoRemove ? filterFn.autoRemove(value, column) : false) || typeof value === "undefined" || typeof value === "string" && !value;
+	if (typeof value === "undefined") return true;
+	if (filterFn?.autoRemove) return !!filterFn.autoRemove(value, column);
+	return typeof value === "string" && !value;
 }
 
 //#endregion

package/dist/features/column-filtering/filterFns.d.ts

@@ -143,7 +143,9 @@ declare const filterFn_betweenInclusive: CreatedFilterFn<any, any>;
  * Keeps rows whose numeric value is inside an inclusive `[min, max]` range.
  *
  * Filter values are normalized so blank endpoints become open-ended and
- * reversed endpoints are swapped.
+ * reversed endpoints are swapped. Only real numbers can fall inside the
+ * range: non-numeric row values (`null`, `undefined`, strings, booleans)
+ * never match.
  */
 declare const filterFn_inNumberRange: CreatedFilterFn<any, any>;
 /**

package/dist/features/column-filtering/filterFns.js

@@ -207,10 +207,13 @@ const filterFn_betweenInclusive = constructFilterFn({
 * Keeps rows whose numeric value is inside an inclusive `[min, max]` range.
 *
 * Filter values are normalized so blank endpoints become open-ended and
-* reversed endpoints are swapped.
+* reversed endpoints are swapped. Only real numbers can fall inside the
+* range: non-numeric row values (`null`, `undefined`, strings, booleans)
+* never match.
 */
 const filterFn_inNumberRange = constructFilterFn({
 	filter: (dataValue, filterValue) => {
+		if (typeof dataValue !== "number" || Number.isNaN(dataValue)) return false;
 		const [min, max] = filterValue;
 		return dataValue >= min && dataValue <= max;
 	},

package/dist/features/column-filtering/filterRowsUtils.js

@@ -67,6 +67,7 @@ function filterRowModelFromRoot(rowsToFilter, filterRow, table) {
 			filteredRows.push(row);
 			newFilteredFlatRows.push(row);
 			newFilteredRowsById[row.id] = row;
+			if (row.subRows.length && depth >= maxDepth) addSubRowsToFlatArrays(row.subRows, newFilteredFlatRows, newFilteredRowsById);
 		}
 		return filteredRows;
 	};
@@ -76,6 +77,13 @@ function filterRowModelFromRoot(rowsToFilter, filterRow, table) {
 		rowsById: newFilteredRowsById
 	};
 }
+function addSubRowsToFlatArrays(subRows, flatRows, rowsById) {
+	for (const subRow of subRows) {
+		flatRows.push(subRow);
+		rowsById[subRow.id] = subRow;
+		if (subRow.subRows.length) addSubRowsToFlatArrays(subRow.subRows, flatRows, rowsById);
+	}
+}
 
 //#endregion
 export { filterRows };

package/dist/features/column-visibility/columnVisibilityFeature.utils.d.ts

@@ -23,7 +23,9 @@ declare function getDefaultColumnVisibilityState(): ColumnVisibilityState;
  * Updates this column's visibility when hiding is allowed.
  *
  * Passing `visible` stores that value. Omitting it flips the column's current
- * visibility state. Columns that cannot hide are start unchanged.
+ * visibility state. Group columns update their hideable leaf columns because
+ * visibility state is keyed by leaf column ids. Columns that cannot hide stay
+ * unchanged.
  *
  * @example
  * ```ts

package/dist/features/column-visibility/columnVisibilityFeature.utils.js

@@ -20,7 +20,9 @@ function getDefaultColumnVisibilityState() {
 * Updates this column's visibility when hiding is allowed.
 *
 * Passing `visible` stores that value. Omitting it flips the column's current
-* visibility state. Columns that cannot hide are start unchanged.
+* visibility state. Group columns update their hideable leaf columns because
+* visibility state is keyed by leaf column ids. Columns that cannot hide stay
+* unchanged.
 *
 * @example
 * ```ts
@@ -30,7 +32,12 @@ function getDefaultColumnVisibilityState() {
 function column_toggleVisibility(column, visible) {
 	if (column_getCanHide(column)) table_setColumnVisibility(column.table, (old) => {
 		const next = Object.assign(makeObjectMap(), old);
-		next[column.id] = visible ?? !callMemoOrStaticFn(column, "getIsVisible", column_getIsVisible);
+		const nextVisible = visible ?? !callMemoOrStaticFn(column, "getIsVisible", column_getIsVisible);
+		const leafColumns = column.getLeafColumns();
+		for (let i = 0; i < leafColumns.length; i++) {
+			const leafColumn = leafColumns[i];
+			if (column_getCanHide(leafColumn)) next[leafColumn.id] = nextVisible;
+		}
 		return next;
 	});
 }

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.78",
   "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.78',
   }
 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.78'
 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.78',
   }
 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.78',
   }
 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.78'
 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.78',
   }
 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.78',
   }
 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.78',
   }
 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.78',
   }
 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.78',
   }
 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.78',
   }
 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.78',
   }
 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.78'
 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.78'
 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.78',
   }
 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.78',
   }
 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.78',
   }
 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.78'
 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.78',
   }
 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.78',
   }
 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.78',
   }
 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.78',
   }
 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.78'
 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.78'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:docs/guide/helpers.md'