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

package/README.md

@@ -1,5 +1,19 @@
 <div align="center">
-  <img src="./media/header_table.png" alt="TanStack Table">
+  <picture>
+    <source
+      media="(prefers-color-scheme: dark)"
+      srcset="https://tanstack.com/api/readme/table.png?theme=dark"
+    />
+    <source
+      media="(prefers-color-scheme: light)"
+      srcset="https://tanstack.com/api/readme/table.png"
+    />
+    <img
+      src="https://tanstack.com/api/readme/table.png"
+      alt="TanStack Table"
+      width="900"
+    />
+  </picture>
 </div>
 
 <br />
@@ -61,7 +75,7 @@ TanStack Table ships [TanStack Intent](https://github.com/TanStack/intent) skill
 npx @tanstack/intent@latest install
 ```
 
-to add skill-loading guidance for your agent (Claude Code, Cursor, Copilot, etc.). The same CLI also exposes `intent list` to browse available skills and `intent load <skill>` to print one for inspection. Skills version with the library — your agent gets guidance that matches the version of `@tanstack/<framework>-table` you installed. Only available for v9 and above.
+to add skill-loading guidance for your agent (Claude Code, Cursor, Copilot, etc.). The same CLI also exposes `intent list` to browse available skills and `intent load <skill>` to print one for inspection. Skills are versioned with the library — your agent gets guidance that matches the version of `@tanstack/<framework>-table` you installed. Only available for v9 and above.
 
 ## Get Involved
 

package/dist/core/columns/coreColumnsFeature.d.ts

@@ -1,7 +1,7 @@
 import { TableFeature } from "../../types/TableFeatures.js";
 //#region src/core/columns/coreColumnsFeature.d.ts
 /**
- * Core feature that builds the column tree and exposes table/column column APIs.
+ * Core feature that builds the column tree and exposes table/column APIs.
  */
 declare const coreColumnsFeature: TableFeature;
 //#endregion

package/dist/core/columns/coreColumnsFeature.js

@@ -3,7 +3,7 @@ import { column_getFlatColumns, column_getLeafColumns, table_getAllColumns, tabl
 
 //#region src/core/columns/coreColumnsFeature.ts
 /**
-* Core feature that builds the column tree and exposes table/column column APIs.
+* Core feature that builds the column tree and exposes table/column APIs.
 */
 const coreColumnsFeature = {
 	assignColumnPrototype: (prototype, table) => {

package/dist/core/headers/coreHeadersFeature.types.d.ts

@@ -49,7 +49,7 @@ interface Header_CoreProperties<in out TFeatures extends TableFeatures, in out T
    */
   column: Column<TFeatures, TData, TValue>;
   /**
-   * The depth of the header, zero-indexed based.
+   * The depth of the header, zero-indexed.
    */
   depth: number;
   /**

package/dist/core/rows/coreRowsFeature.types.d.ts

@@ -95,7 +95,7 @@ interface Row_Row<in out TFeatures extends TableFeatures, in out TData extends R
 }
 interface TableOptions_Rows<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
-   * This optional function is used to derive a unique ID for any given row. If not provided the rows index is used (nested rows join together with `.` using their grandparents' index eg. `index.index.index`). If you need to identify individual rows that are originating from any server-side operations, it's suggested you use this function to return an ID that makes sense regardless of network IO/ambiguity eg. a userId, taskId, database ID field, etc.
+   * This optional function is used to derive a unique ID for any given row. If not provided the row's index is used (nested rows join together with `.` using their grandparents' index e.g. `index.index.index`). If you need to identify individual rows that are originating from any server-side operations, it's suggested you use this function to return an ID that makes sense regardless of network IO/ambiguity e.g. a userId, taskId, database ID field, etc.
    * @example getRowId: row => row.userId
    */
   getRowId?: (originalRow: TData, index: number, parent?: Row<TFeatures, TData>) => string;

package/dist/features/cell-selection/cellSelectionFeature.utils.js

@@ -512,15 +512,15 @@ function getDirectionDelta(direction) {
 * step would leave the grid or find no selectable column.
 */
 function stepCoordinate(table, rowId, columnId, direction) {
-	const rows = table.getRowsInDisplayOrder();
+	const rows = table.getRowModel().rows;
 	const columns = getDisplayOrderedColumns(table);
 	if (!rows.length || !columns.length) return null;
 	const { rowDelta, columnDelta } = getDirectionDelta(direction);
-	const rowIndex = resolveRowIndex(table, rows, rowId);
+	const rowIndex = rows.findIndex((row) => row.id === rowId);
 	const columnIndex = columns.findIndex((column) => column.id === columnId);
 	if (rowIndex < 0 || columnIndex < 0) return null;
 	const merges = callMemoOrStaticFn(table, "getCellSelectionMergeBounds", table_getCellSelectionMergeBounds);
-	let fromRowIndex = rowIndex;
+	let fromRowIndex = rows[rowIndex].getDisplayIndex();
 	let fromColumnIndex = columnIndex;
 	if (merges.length) {
 		const startMerge = findMergeBoundsAt(merges, rowIndex, columnIndex);
@@ -531,7 +531,12 @@ function stepCoordinate(table, rowId, columnId, direction) {
 			if (columnDelta < 0) fromColumnIndex = startMerge.minColumnIndex;
 		}
 	}
-	const nextRowIndex = fromRowIndex + rowDelta;
+	let nextRowIndex = rowIndex + rowDelta;
+	if (rowDelta && fromRowIndex !== rows[rowIndex].getDisplayIndex()) {
+		const edgeRowIndex = rows.findIndex((row) => row.getDisplayIndex() === fromRowIndex);
+		if (edgeRowIndex < 0) return null;
+		nextRowIndex = edgeRowIndex + rowDelta;
+	}
 	if (nextRowIndex < 0 || nextRowIndex >= rows.length) return null;
 	const selectableColumnIds = new Set(getSelectableColumns(table).map((column) => column.id));
 	if (!selectableColumnIds.size) return null;
@@ -555,9 +560,10 @@ function stepCoordinate(table, rowId, columnId, direction) {
 	let landingRowIndex = nextRowIndex;
 	let landingColumnIndex = nextColumnIndex;
 	if (merges.length) {
-		const landingMerge = findMergeBoundsAt(merges, nextRowIndex, nextColumnIndex);
+		const landingMerge = findMergeBoundsAt(merges, rows[nextRowIndex].getDisplayIndex(), nextColumnIndex);
 		if (landingMerge) {
-			landingRowIndex = landingMerge.minRowIndex;
+			landingRowIndex = rows.findIndex((row) => row.getDisplayIndex() === landingMerge.minRowIndex);
+			if (landingRowIndex < 0) return null;
 			landingColumnIndex = landingMerge.minColumnIndex;
 		}
 	}
@@ -584,7 +590,7 @@ function table_moveCellSelection(table, direction) {
 	const ranges = table.atoms.cellSelection?.get();
 	const active = ranges?.[ranges.length - 1];
 	if (!active) {
-		const rows = table.getRowsInDisplayOrder();
+		const rows = table.getRowModel().rows;
 		const columns = getSelectableColumns(table);
 		if (!rows.length || !columns.length) return;
 		table_setFocusedCell(table, rows[0].id, columns[0].id);

package/dist/features/column-grouping/createGroupedRowModel.js

@@ -49,10 +49,7 @@ function _createGroupedRowModel(table) {
 	const rowModel = table.getPreGroupedRowModel();
 	const grouping = table.atoms.grouping?.get();
 	if (!rowModel.rows.length || !grouping?.length) {
-		rowModel.rows.forEach((row) => {
-			row.depth = 0;
-			row.parentId = void 0;
-		});
+		resetRowRelationships(rowModel.rows, 0, void 0);
 		return rowModel;
 	}
 	const existingGrouping = grouping.filter((columnId) => table_getColumn(table, columnId));
@@ -127,6 +124,14 @@ function _createGroupedRowModel(table) {
 		rowsById: groupedRowsById
 	};
 }
+function resetRowRelationships(rows, depth, parentId) {
+	for (let i = 0; i < rows.length; i++) {
+		const row = rows[i];
+		row.depth = depth;
+		row.parentId = parentId;
+		if (row.subRows.length) resetRowRelationships(row.subRows, depth + 1, row.id);
+	}
+}
 function groupBy(table, rows, columnId) {
 	const groupMap = /* @__PURE__ */ new Map();
 	const getGroupingValue = table_getColumn(table, columnId)?.columnDef.getGroupingValue;

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

@@ -58,7 +58,7 @@ interface TableOptions_RowExpanding<in out TFeatures extends TableFeatures, in o
    */
   onExpandedChange?: OnChangeFn<ExpandedState>;
   /**
-   * If `true` expanded rows will be paginated along with the rest of the table (which means expanded rows may span multiple pages). If `false` expanded rows will not be considered for pagination (which means expanded rows will always render on their parents page. This also means more rows will be rendered than the set page size)
+   * If `true` expanded rows will be paginated along with the rest of the table (which means expanded rows may span multiple pages). If `false` expanded rows will not be considered for pagination (which means expanded rows will always render on their parent's page). This also means more rows will be rendered than the set page size.
    */
   paginateExpandedRows?: boolean;
 }

package/dist/features/row-pagination/rowPaginationFeature.types.d.ts

@@ -11,7 +11,7 @@ interface TableState_RowPagination {
 }
 interface TableOptions_RowPagination {
   /**
-   * If set to `true`, pagination will be reset to the first page when page-altering state changes eg. `data` is updated, filters change, grouping changes, etc.
+   * If set to `true`, pagination will be reset to the first page when page-altering state changes e.g. `data` is updated, filters change, grouping changes, etc.
    */
   autoResetPageIndex?: boolean;
   /**

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

@@ -73,7 +73,7 @@ interface ColumnDef_RowSorting<in out TFeatures extends TableFeatures, in out TD
    */
   enableSorting?: boolean;
   /**
-   * Inverts the order of the sorting for this column. This is useful for values that have an inverted best/worst scale where lower numbers are better, eg. a ranking (1st, 2nd, 3rd) or golf-like scoring
+   * Inverts the order of the sorting for this column. This is useful for values that have an inverted best/worst scale where lower numbers are better, e.g. a ranking (1st, 2nd, 3rd) or golf-like scoring
    */
   invertSorting?: boolean;
   /**
@@ -149,7 +149,7 @@ interface Column_RowSorting<in out TFeatures extends TableFeatures, in out TData
    */
   getToggleSortingHandler: () => undefined | ((event: unknown) => void);
   /**
-   * Toggles this columns sorting state. If `desc` is provided, it will force the sort direction to that value. If `isMulti` is provided, it will additivity multi-sort the column (or toggle it if it is already sorted).
+   * Toggles this column's sorting state. If `desc` is provided, it will force the sort direction to that value. If `isMulti` is provided, it will additively multi-sort the column (or toggle it if it is already sorted).
    */
   toggleSorting: (desc?: boolean, isMulti?: boolean) => void;
 }
@@ -175,8 +175,8 @@ interface TableOptions_RowSorting {
   enableSorting?: boolean;
   /**
    * Enables/Disables the ability to remove sorting for the table.
-   * - If `true` then changing sort order will circle like: 'none' -> 'desc' -> 'asc' -> 'none' -> ...
-   * - If `false` then changing sort order will circle like: 'none' -> 'desc' -> 'asc' -> 'desc' -> 'asc' -> ...
+   * - If `true` then changing sort order will cycle like: 'none' -> 'desc' -> 'asc' -> 'none' -> ...
+   * - If `false` then changing sort order will cycle like: 'none' -> 'desc' -> 'asc' -> 'desc' -> 'asc' -> ...
    */
   enableSortingRemoval?: boolean;
   /**

package/dist/utils.d.ts

@@ -122,7 +122,7 @@ type PrototypeAPIObject<TDeps extends ReadonlyArray<any>, TDepArgs> = Record<str
  */
 declare function assignPrototypeAPIs<TFeatures extends TableFeatures, TData extends RowData, TDeps extends ReadonlyArray<any>, TDepArgs>(feature: keyof TFeatures & string, prototype: Record<string, any>, table: Table<TFeatures, TData>, apis: PrototypeAPIObject<TDeps, NoInfer<TDepArgs>>): void;
 /**
- * Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fallback to the static method passed in.
+ * Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fall back to the static method passed in.
  */
 declare function callMemoOrStaticFn<TObject extends Record<string, any>, TArgs extends Array<any>, TReturn>(obj: TObject, fnKey: string, staticFn: (obj: TObject, ...args: TArgs) => TReturn, ...args: TArgs): TReturn;
 //#endregion

package/dist/utils.js

@@ -260,7 +260,7 @@ function assignPrototypeAPIs(feature, prototype, table, apis) {
 	}
 }
 /**
-* Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fallback to the static method passed in.
+* Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fall back to the static method passed in.
 */
 function callMemoOrStaticFn(obj, fnKey, staticFn, ...args) {
 	return obj[fnKey]?.(...args) ?? staticFn(obj, ...args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/table-core",
-  "version": "9.0.0-beta.78",
+  "version": "9.0.0-beta.80",
   "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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78'
+  library_version: '9.0.0-beta.80'
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78'
+  library_version: '9.0.0-beta.80'
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78'
+  library_version: '9.0.0-beta.80'
 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.78'
+  library_version: '9.0.0-beta.80'
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78'
+  library_version: '9.0.0-beta.80'
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78',
+    library_version: '9.0.0-beta.80',
   }
 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.78'
+  library_version: '9.0.0-beta.80'
 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.78'
+  library_version: '9.0.0-beta.80'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:docs/guide/helpers.md'