@tanstack/table-core 9.0.0-beta.1 → 9.0.0-beta.11

package/skills/pagination/SKILL.md

@@ -34,13 +34,13 @@ import {
 } from '@tanstack/table-core'
 import type { PaginationState } from '@tanstack/table-core'
 
-const features = tableFeatures({ rowPaginationFeature })
+const features = tableFeatures({
+  rowPaginationFeature,
+  paginatedRowModel: createPaginatedRowModel(),
+})
 
 const table = constructTable({
   features,
-  rowModels: {
-    paginatedRowModel: createPaginatedRowModel(),
-  },
   columns,
   data,
   initialState: {
@@ -126,7 +126,7 @@ const { data: dataQuery } = useQuery({
 
 const table = useTable({
   features: tableFeatures({ rowPaginationFeature }),
-  rowModels: {}, // no paginatedRowModel — server paginates
+  // no paginatedRowModel registered — server paginates
   data: dataQuery?.rows ?? EMPTY,
   columns,
   manualPagination: true,
@@ -141,12 +141,15 @@ const table = useTable({
 ### Disable auto page reset when filters change
 
 ```ts
+const features = tableFeatures({
+  rowPaginationFeature,
+  columnFilteringFeature,
+  paginatedRowModel: createPaginatedRowModel(),
+  filteredRowModel: createFilteredRowModel(),
+  filterFns,
+})
 const table = constructTable({
-  features: tableFeatures({ rowPaginationFeature, columnFilteringFeature }),
-  rowModels: {
-    paginatedRowModel: createPaginatedRowModel(),
-    filteredRowModel: createFilteredRowModel(filterFns),
-  },
+  features,
   columns,
   data,
   autoResetPageIndex: false, // keep current page while user types in a filter
@@ -174,7 +177,6 @@ Wrong:
 // getPageCount() returns 1, next/prev buttons are disabled
 const table = useTable({
   features: tableFeatures({ rowPaginationFeature }),
-  rowModels: {},
   data, // only 10 rows for the current page
   columns,
   manualPagination: true,
@@ -189,7 +191,6 @@ Correct:
 ```tsx
 const table = useTable({
   features: tableFeatures({ rowPaginationFeature }),
-  rowModels: {},
   data: dataQuery.rows,
   columns,
   manualPagination: true,
@@ -223,8 +224,10 @@ Correct:
 ```tsx
 const [pagination, setPagination] = useState({ pageIndex: 0, pageSize: 25 })
 const table = useTable({
-  features: tableFeatures({ rowPaginationFeature }),
-  rowModels: { paginatedRowModel: createPaginatedRowModel() },
+  features: tableFeatures({
+    rowPaginationFeature,
+    paginatedRowModel: createPaginatedRowModel(),
+  }),
   columns,
   data,
   state: { pagination },
@@ -241,12 +244,9 @@ Source: docs/guide/pagination.md
 Wrong:
 
 ```ts
+// features already has paginatedRowModel + filteredRowModel registered
 const table = useTable({
   features,
-  rowModels: {
-    paginatedRowModel: createPaginatedRowModel(),
-    filteredRowModel: createFilteredRowModel(filterFns),
-  },
   columns,
   data,
   autoResetPageIndex: false, // user on page 5, then filters down to 2 pages
@@ -366,8 +366,10 @@ Correct:
 
 ```ts
 const table = useTable({
-  features: tableFeatures({ rowPaginationFeature }),
-  rowModels: { paginatedRowModel: createPaginatedRowModel() },
+  features: tableFeatures({
+    rowPaginationFeature,
+    paginatedRowModel: createPaginatedRowModel(),
+  }),
   columns,
   data,
 })

package/skills/row-expanding/SKILL.md

@@ -35,12 +35,14 @@ import {
 } from '@tanstack/table-core'
 import type { ExpandedState } from '@tanstack/table-core'
 
-const features = tableFeatures({ rowExpandingFeature })
+const features = tableFeatures({
+  rowExpandingFeature,
+  expandedRowModel: createExpandedRowModel(),
+})
 
 // Tree mode — data has nested subRows
 const table = constructTable({
   features,
-  rowModels: { expandedRowModel: createExpandedRowModel() },
   columns,
   data,
   getSubRows: (row) => row.subRows,
@@ -50,7 +52,6 @@ const table = constructTable({
 // Or detail-panel mode — every row can expand to a sub-component
 const detailTable = constructTable({
   features,
-  rowModels: { expandedRowModel: createExpandedRowModel() },
   columns,
   data,
   getRowCanExpand: () => true,
@@ -120,11 +121,12 @@ const detailTable = constructTable({
 
 ```ts
 const table = constructTable({
-  features: tableFeatures({ rowExpandingFeature, rowPaginationFeature }),
-  rowModels: {
+  features: tableFeatures({
+    rowExpandingFeature,
+    rowPaginationFeature,
     expandedRowModel: createExpandedRowModel(),
     paginatedRowModel: createPaginatedRowModel(),
-  },
+  }),
   columns,
   data,
   getSubRows: (r) => r.subRows,
@@ -138,11 +140,13 @@ const table = constructTable({
 
 ```ts
 const table = constructTable({
-  features: tableFeatures({ rowExpandingFeature, columnFilteringFeature }),
-  rowModels: {
+  features: tableFeatures({
+    rowExpandingFeature,
+    columnFilteringFeature,
     expandedRowModel: createExpandedRowModel(),
-    filteredRowModel: createFilteredRowModel(filterFns),
-  },
+    filteredRowModel: createFilteredRowModel(),
+    filterFns,
+  }),
   columns,
   data,
   getSubRows: (r) => r.subRows,
@@ -171,7 +175,6 @@ Correct:
 // For pure tree data, omit getRowCanExpand and let it auto-detect:
 const table = useTable({
   features,
-  rowModels: { expandedRowModel: createExpandedRowModel() },
   columns,
   data,
   getSubRows: (row) => row.subRows,
@@ -180,8 +183,10 @@ const table = useTable({
 
 // For pure detail panels, override and skip getSubRows:
 const table = useTable({
-  features: tableFeatures({ rowExpandingFeature }),
-  rowModels: { expandedRowModel: createExpandedRowModel() },
+  features: tableFeatures({
+    rowExpandingFeature,
+    expandedRowModel: createExpandedRowModel(),
+  }),
   columns,
   data,
   getRowCanExpand: () => true,
@@ -210,10 +215,6 @@ Correct:
 // Default behavior — children flow through pagination, pageSize is enforced:
 const table = useTable({
   features,
-  rowModels: {
-    expandedRowModel: createExpandedRowModel(),
-    paginatedRowModel: createPaginatedRowModel(),
-  },
   columns,
   data,
   getSubRows: (r) => r.subRows,
@@ -268,8 +269,10 @@ Wrong:
 ```ts
 // manualExpanding bypasses the expanded row model; sub-rows are never flattened
 const table = useTable({
-  features: tableFeatures({ rowExpandingFeature }),
-  rowModels: { expandedRowModel: createExpandedRowModel() }, // ignored
+  features: tableFeatures({
+    rowExpandingFeature,
+    expandedRowModel: createExpandedRowModel(), // ignored when manualExpanding: true
+  }),
   columns,
   data,
   getSubRows: (r) => r.subRows,
@@ -284,7 +287,7 @@ Correct:
 // a pre-flattened view based on which rows are expanded.
 const table = useTable({
   features: tableFeatures({ rowExpandingFeature }),
-  rowModels: {}, // no expandedRowModel for manual mode
+  // no expandedRowModel registered for manual mode
   columns,
   data: dataQuery.data, // server returns flattened rows when expanded
   manualExpanding: true,
@@ -294,8 +297,10 @@ const table = useTable({
 
 // For client-side tree, omit manualExpanding:
 const clientTable = useTable({
-  features: tableFeatures({ rowExpandingFeature }),
-  rowModels: { expandedRowModel: createExpandedRowModel() },
+  features: tableFeatures({
+    rowExpandingFeature,
+    expandedRowModel: createExpandedRowModel(),
+  }),
   columns,
   data,
   getSubRows: (r) => r.subRows,
@@ -329,9 +334,12 @@ Correct:
 
 ```ts
 const table = useTable({
-  features: tableFeatures({ rowExpandingFeature }),
-  rowModels: { expandedRowModel: createExpandedRowModel() },
-  columns, data,
+  features: tableFeatures({
+    rowExpandingFeature,
+    expandedRowModel: createExpandedRowModel(),
+  }),
+  columns,
+  data,
   getSubRows: (r) => r.subRows,
 })
 

package/skills/row-pinning/SKILL.md

@@ -35,13 +35,14 @@ import {
 } from '@tanstack/table-core'
 import type { RowPinningState } from '@tanstack/table-core'
 
-const features = tableFeatures({ rowPinningFeature, rowPaginationFeature })
+const features = tableFeatures({
+  rowPinningFeature,
+  rowPaginationFeature,
+  paginatedRowModel: createPaginatedRowModel(),
+})
 
 const table = constructTable({
   features,
-  rowModels: {
-    paginatedRowModel: createPaginatedRowModel(),
-  },
   columns,
   data,
   getRowId: (row) => row.userId, // ← essentially mandatory
@@ -97,8 +98,12 @@ row.pin('top', /* includeLeafRows */ true, /* includeParentRows */ false)
 
 ```ts
 const table = constructTable({
-  features: tableFeatures({ rowPinningFeature, columnFilteringFeature }),
-  rowModels: { filteredRowModel: createFilteredRowModel(filterFns) },
+  features: tableFeatures({
+    rowPinningFeature,
+    columnFilteringFeature,
+    filteredRowModel: createFilteredRowModel(),
+    filterFns,
+  }),
   columns,
   data,
   getRowId: (row) => row.id,
@@ -247,7 +252,6 @@ Correct:
 ```ts
 const table = useTable({
   features: tableFeatures({ rowPinningFeature }),
-  rowModels: {},
   columns,
   data,
   getRowId: (row) => row.id,

package/skills/row-selection/SKILL.md

@@ -40,7 +40,6 @@ const features = tableFeatures({ rowSelectionFeature })
 
 const table = constructTable({
   features,
-  rowModels: {},
   columns,
   data,
   getRowId: (row) => row.id, // ← essentially mandatory
@@ -80,7 +79,6 @@ columnHelper.display({
 ```tsx
 const table = useTable({
   features: tableFeatures({ rowSelectionFeature }),
-  rowModels: {},
   columns,
   data,
   getRowId: (row) => row.id,
@@ -370,7 +368,6 @@ Correct:
 ```ts
 const table = useTable({
   features: tableFeatures({ rowSelectionFeature }),
-  rowModels: {},
   columns,
   data,
   getRowId: (row) => row.id,

package/skills/setup/SKILL.md

@@ -2,12 +2,14 @@
 name: setup
 description: >
   Install a TanStack Table v9 framework adapter and wire up a first table with
-  `tableFeatures({...})` declaring `features`, an `rowModels` map of factory
-  results (`createSortedRowModel(sortFns)`, `createFilteredRowModel(filterFns)`,
-  `createPaginatedRowModel()`, …), a `createColumnHelper<typeof features, TData>()`
-  column set, and the framework `useTable` / `injectTable` / `createTable` /
-  `constructTable` entry point. Covers the registry model, why `features` must
-  be module-scoped, when to reach for `stockFeatures`, and `coreFeatures`.
+  `tableFeatures({...})` declaring `features` (which now also carries row model
+  factories like `sortedRowModel: createSortedRowModel()`, `filteredRowModel:
+  createFilteredRowModel()`, `paginatedRowModel: createPaginatedRowModel()`, and
+  fn registries like `sortFns`/`filterFns`), a
+  `createColumnHelper<typeof features, TData>()` column set, and the framework
+  `useTable` / `injectTable` / `createTable` / `constructTable` entry point.
+  Covers the registry model, why `features` must be module-scoped, when to reach
+  for `stockFeatures`, and `coreFeatures`.
 type: core
 library: tanstack-table
 library_version: '9.0.0-alpha.48'
@@ -27,7 +29,7 @@ This skill builds on `tanstack-table/state-management` and `tanstack-table/colum
 
 ## Setup
 
-TanStack Table v9 separates a framework-agnostic core (`@tanstack/table-core`) from per-framework adapters. Every table — vanilla or framework — must declare two new v9-required options at construction time: `features` (the registry of feature plugins) and `rowModels` (the map of pipeline factories).
+TanStack Table v9 separates a framework-agnostic core (`@tanstack/table-core`) from per-framework adapters. Every table — vanilla or framework — must declare the `features` option at construction time: the registry of feature plugins, row model factories, and fn registries.
 
 ```ts
 // Framework-agnostic, using @tanstack/table-core directly.
@@ -44,7 +46,12 @@ type Person = { firstName: string; lastName: string; age: number }
 
 // 1. Declare features at MODULE scope (stable reference). This is required —
 //    a fresh `features` object on every call destroys feature registration.
-const features = tableFeatures({ rowSortingFeature })
+const features = tableFeatures({
+  rowSortingFeature,
+  // Row model factories and fn registries live on the features object.
+  sortedRowModel: createSortedRowModel(),
+  sortFns,
+})
 
 // 2. Build a column helper bound to BOTH TFeatures and TData.
 const columnHelper = createColumnHelper<typeof features, Person>()
@@ -62,10 +69,6 @@ const data: Person[] = [
 
 const table = constructTable({
   features,
-  rowModels: {
-    // Pair every feature with its matching row-model factory.
-    sortedRowModel: createSortedRowModel(sortFns),
-  },
   columns,
   data,
 })
@@ -92,7 +95,6 @@ Framework adapters wrap this with reactivity:
 const features = tableFeatures({}) // core features only
 const table = constructTable({
   features,
-  rowModels: {}, // core row model auto-included
   columns,
   data,
 })
@@ -118,15 +120,15 @@ const features = tableFeatures({
   rowSortingFeature,
   rowPaginationFeature,
   columnFilteringFeature,
+  sortedRowModel: createSortedRowModel(),
+  filteredRowModel: createFilteredRowModel(),
+  paginatedRowModel: createPaginatedRowModel(),
+  sortFns,
+  filterFns,
 })
 
 const table = constructTable({
   features,
-  rowModels: {
-    sortedRowModel: createSortedRowModel(sortFns),
-    filteredRowModel: createFilteredRowModel(filterFns),
-    paginatedRowModel: createPaginatedRowModel(),
-  },
   columns,
   data,
 })
@@ -144,10 +146,8 @@ const features = tableFeatures({})
 
 const table = constructTable({
   features,
-  rowModels: {},
   columns,
   data,
-  _rowModelFns: {},
   // Use the vanilla binding when no framework adapter exists
   _processingMode: 'core',
 })
@@ -178,24 +178,22 @@ Wrong:
 ```ts
 // rowSortingFeature missing — table.setSorting / state.sorting unavailable
 const features = tableFeatures({}) // empty
-const table = useTable({ features, rowModels: {}, columns, data })
+const table = useTable({ features, columns, data })
 table.setSorting([{ id: 'age', desc: true }]) // ❌ does not exist on this table type
 ```
 
 Correct:
 
 ```ts
-// Register every feature you intend to use; pair with its row model when applicable
-const features = tableFeatures({ rowSortingFeature, rowPaginationFeature })
-const table = useTable({
-  features,
-  rowModels: {
-    sortedRowModel: createSortedRowModel(sortFns),
-    paginatedRowModel: createPaginatedRowModel(),
-  },
-  columns,
-  data,
+// Register every feature you intend to use; include its row model factory and fns
+const features = tableFeatures({
+  rowSortingFeature,
+  rowPaginationFeature,
+  sortedRowModel: createSortedRowModel(),
+  paginatedRowModel: createPaginatedRowModel(),
+  sortFns,
 })
+const table = useTable({ features, columns, data })
 ```
 
 In v9, `features` is a tree-shakeable registry — TypeScript hides APIs for unregistered features and the runtime atom is never created. Agents who see `table.setColumnFilters` "missing" often incorrectly conclude the API was removed.
@@ -231,16 +229,15 @@ import {
   sortFns,
 } from '@tanstack/react-table'
 
-const features = tableFeatures({ rowSortingFeature })
-const table = useTable({
-  features,
-  rowModels: { sortedRowModel: createSortedRowModel(sortFns) },
-  columns,
-  data,
+const features = tableFeatures({
+  rowSortingFeature,
+  sortedRowModel: createSortedRowModel(),
+  sortFns,
 })
+const table = useTable({ features, columns, data })
 ```
 
-v7→v8 and v8→v9 both reshaped the API substantially. Agents trained on older data confidently emit v7/v8 shapes; v9 enforces `features` + `rowModels`.
+v7→v8 and v8→v9 both reshaped the API substantially. Agents trained on older data confidently emit v7/v8 shapes; v9 requires `features` with row model factories registered on it.
 
 Source: maintainer interview (Phase 4, 2026-05-17)
 
@@ -252,7 +249,7 @@ Wrong:
 function MyTable() {
   // ❌ new object every render — destroys stable feature registration
   const features = tableFeatures({ rowSortingFeature })
-  const table = useTable({ features, rowModels: {}, columns, data })
+  const table = useTable({ features, columns, data })
 }
 ```
 
@@ -263,7 +260,7 @@ Correct:
 const features = tableFeatures({ rowSortingFeature })
 
 function MyTable() {
-  const table = useTable({ features, rowModels: {}, columns, data })
+  const table = useTable({ features, columns, data })
 }
 ```
 
@@ -277,31 +274,26 @@ Wrong:
 
 ```ts
 // rowSortingFeature missing — sortedRowModel is orphaned and never runs
-const features = tableFeatures({ rowPaginationFeature })
-const table = useTable({
-  features,
-  rowModels: {
-    sortedRowModel: createSortedRowModel(sortFns), // no-op
-    paginatedRowModel: createPaginatedRowModel(),
-  },
-  columns,
-  data,
+const features = tableFeatures({
+  rowPaginationFeature,
+  sortedRowModel: createSortedRowModel(), // no-op without rowSortingFeature
+  paginatedRowModel: createPaginatedRowModel(),
+  sortFns,
 })
+const table = useTable({ features, columns, data })
 ```
 
 Correct:
 
 ```ts
-const features = tableFeatures({ rowSortingFeature, rowPaginationFeature })
-const table = useTable({
-  features,
-  rowModels: {
-    sortedRowModel: createSortedRowModel(sortFns),
-    paginatedRowModel: createPaginatedRowModel(),
-  },
-  columns,
-  data,
+const features = tableFeatures({
+  rowSortingFeature,
+  rowPaginationFeature,
+  sortedRowModel: createSortedRowModel(),
+  paginatedRowModel: createPaginatedRowModel(),
+  sortFns,
 })
+const table = useTable({ features, columns, data })
 ```
 
 Row-model factories only run if their matching feature is in `features`. Runtime silently degrades.
@@ -322,12 +314,12 @@ const sortedData = useMemo(() => [...data].sort((a, b) => /* …custom… */), [
 Correct:
 
 ```ts
-const table = useTable({
-  features: tableFeatures({ rowSortingFeature }),
-  rowModels: { sortedRowModel: createSortedRowModel(sortFns) },
-  columns,
-  data,
+const features = tableFeatures({
+  rowSortingFeature,
+  sortedRowModel: createSortedRowModel(),
+  sortFns,
 })
+const table = useTable({ features, columns, data })
 // then: table.setSorting(...), column.toggleSorting(), header.getToggleSortingHandler()
 ```
 
@@ -368,7 +360,6 @@ Wrong:
 // ❌ Fresh [] each render — infinite loop when items is undefined
 const table = useTable({
   features,
-  rowModels: {},
   columns,
   data: items ?? [],
 })
@@ -382,7 +373,6 @@ const EMPTY: Person[] = []
 
 const table = useTable({
   features,
-  rowModels: {},
   columns,
   data: items ?? EMPTY,
 })

package/skills/sorting/SKILL.md

@@ -2,7 +2,7 @@
 name: sorting
 description: >
   Sort rows in TanStack Table v9 with the `sortedRowModel` stage. Covers
-  `rowSortingFeature` + `createSortedRowModel(sortFns)`, the built-in `sortFns`
+  `rowSortingFeature` + `createSortedRowModel()` (registered on `features`), the built-in `sortFns`
   registry (renamed from v8 `sortingFns`), `state.sorting` (SortingState =
   Array<{ id, desc }>), `onSortingChange`, `columnDef.sortFn`
   (string | function | 'auto'), `sortDescFirst`, `sortUndefined`
@@ -47,7 +47,11 @@ type Person = {
   status: 'single' | 'complicated' | 'relationship'
 }
 
-const features = tableFeatures({ rowSortingFeature })
+const features = tableFeatures({
+  rowSortingFeature,
+  sortedRowModel: createSortedRowModel(),
+  sortFns,
+})
 const columnHelper = createColumnHelper<typeof features, Person>()
 
 const columns = columnHelper.columns([
@@ -61,9 +65,6 @@ const columns = columnHelper.columns([
 
 const table = constructTable({
   features,
-  rowModels: {
-    sortedRowModel: createSortedRowModel(sortFns),
-  },
   columns,
   data,
   initialState: { sorting: [] satisfies SortingState },
@@ -143,7 +144,7 @@ const { data } = useQuery({
 
 const table = useTable({
   features: tableFeatures({ rowSortingFeature }),
-  rowModels: {}, // omit sortedRowModel — server sorts
+  // omit sortedRowModel from features — server sorts
   columns,
   data,
   manualSorting: true,
@@ -175,20 +176,19 @@ columnHelper.accessor('firstName', {
   sortFn: 'alphanumeric',
 })
 
-const table = useTable({
-  features: tableFeatures({ rowSortingFeature }),
-  rowModels: {
-    sortedRowModel: createSortedRowModel({
-      ...sortFns,
-      myCustom: (a, b, id) => a.original[id] - b.original[id],
-    }),
+const features = tableFeatures({
+  rowSortingFeature,
+  sortedRowModel: createSortedRowModel(),
+  sortFns: {
+    ...sortFns,
+    myCustom: (a, b, id) => a.original[id] - b.original[id],
   },
-  columns,
-  data,
 })
+
+const table = useTable({ features, columns, data })
 ```
 
-v9 renamed `columnDef.sortingFn → sortFn`, `tableOptions.sortingFns → sortFns`, exported registry `sortingFns → sortFns`. The new column option defaults to `'auto'` and falls back to `sortFn_basic` when lookup misses — wrong names sort wrong, silently.
+v9 renamed `columnDef.sortingFn → sortFn`, the fn registry slot `sortingFns → sortFns` (now registered on `features`), exported registry `sortingFns → sortFns`. The new column option defaults to `'auto'` and falls back to `sortFn_basic` when lookup misses — wrong names sort wrong, silently.
 
 Source: packages/table-core/src/features/row-sorting/rowSortingFeature.utils.ts
 
@@ -326,12 +326,12 @@ const sortedData = useMemo(
 Correct:
 
 ```ts
-const table = useTable({
-  features: tableFeatures({ rowSortingFeature }),
-  rowModels: { sortedRowModel: createSortedRowModel(sortFns) },
-  columns,
-  data,
+const features = tableFeatures({
+  rowSortingFeature,
+  sortedRowModel: createSortedRowModel(),
+  sortFns,
 })
+const table = useTable({ features, columns, data })
 // table.setSorting(...), column.toggleSorting(), header.getToggleSortingHandler()
 ```