Migrate TanStack Table from v8 to v9 by auditing API usage, state ownership, features, and TypeScript types. Follow a shared checklist and relevant mappings to preserve existing behavior and verify the updated table.
中文简介正在准备中。当前显示英语简介。
原文查看原文说明
Audit and migrate Table v8 to v9. Inventory affected APIs, follow the shared checklist, and read only the required architecture, state, feature, and TypeScript mappings.
Updating feature registration and state management
Resolving TypeScript changes during migration
Verifying table interactions after migration
包含的文件(5)
SKILL.md7.2 KB
references/architecture.md7.9 KB
references/feature-apis.md6.8 KB
references/state.md2.9 KB
references/typescript.md2.9 KB
SKILL.md(原文)
安装前可以查看交给 AI 代理的指令内容。
Migrate Table v8 to v9
Read core first. Audit every item below before choosing detailed mappings. This shared checklist owns the complete core migration; the installed adapter's migration skill owns construction, rendering, framework requirements, and reactive wiring.
Procedure
Establish passing tests for the existing table and inventory its enabled interactions, imports, options, and state owners.
Follow the whole audit checklist. Read a mapping reference when the audit finds affected code; preserve behavior while migrating features and construction.
Load the installed adapter with intent load <package>#migrate-v8-to-v9 and its table-state skill. Substitute the actual adapter package. React, Preact, Solid, Svelte, Vue, Angular, and Lit have migration skills; Alpine, Ember, and Octane have no v8 adapter migration journey.
Type-check, exercise every enabled interaction and client/server stage, and complete the explicit v9 setup.
Treat useLegacyTable as a deprecated React-only bridge for an existing incremental migration. It bundles every feature, can exceed the v8 bundle, and is not the target architecture. Its only entrypoint is @tanstack/react-table/legacy.
Read mappings for affected code
Audit finds
Read
Feature registration, row-model factories, function slots, bound methods, or consumed internals
Load the installed framework adapter's migration and table-state skills.
Replace the v8 adapter constructor/hook/controller with its v9 entrypoint.
Add a stable features object to every table.
Inventory every feature API used by table, row, column, cell, and header code; register each stock feature the table actually uses.
Use stockFeatures only as a temporary parity aid and record an explicit-feature follow-up.
Remove getCoreRowModel() unless supplying a deliberate custom coreRowModel slot.
Move all remaining get*RowModel() options (or a removed rowModels: {...} object, if present) to create*RowModel() feature slots.
Register each dependent feature before its row-model slot.
Move filterFns, sortingFns/sortFns, and aggregationFns into feature slots, registering individually imported built-ins; pass no registries to factories.
Register rowAggregationFeature independently and migrate custom aggregation callables to context-based AggregationFnDef definitions.
Register columnFilteringFeature before global filtering and filter/facet dependencies.
Register columnSizingFeature before columnResizingFeature.
Replace table.getState() and top-level onStateChange according to the adapter state guide.
Verify every controlled slice has an update path; verify externally owned atoms are reset by their owner.
Audit destructured, spread, serialized, or bare-callback instance methods.
Replace every column-pinning left/right key, argument, comparison, method family, and sticky CSS declaration with logical start/end equivalents.
Split table-level enablePinning; preserve column-def enablePinning where intended.
Split sizing/resizing features and rename the resizing state, setter, and callback.
Replace every sortingFn/SortingFn/sortingFns spelling with its v9 sort* spelling.
Remove every consumed underscore-prefixed internal API.
Recheck indeterminate selection logic against the new "at least one" semantics.
Add TFeatures to unavoidable explicit core types, helpers, and retained meta augmentation; otherwise restore inference.
Replace function-registry and filter-meta declaration merging with per-table slots where appropriate.
Ensure every row is a record or array under the stricter RowData constraint.
Migrate adapter-specific rendering, reactive data inputs, and subscription primitives.
Type-check without any/casts added merely to suppress migration failures.
Test sorting, filtering, faceting, grouping, expansion, pagination, selection, ordering, pinning, sizing, and resizing where enabled.
Test client/server ownership for every row-model pipeline stage and ensure manual modes receive already-processed data.
Test LTR and RTL layouts when column pinning or resizing is enabled.
Remove useLegacyTable after the incremental migration step that required it.
Completion checks
Missing feature APIs must be resolved through registration, not casts. Keep v8 get*RowModel configuration and physical pinning names out of the final v9 setup. Remove temporary stockFeatures or useLegacyTable use when the incremental step no longer needs them.
After behavior parity, consider tableOptions() for reusable configuration, createTableHook() for app conventions, narrower subscriptions, and scoped meta. These are optional improvements, not extra required breakages. Use the adapter's getting-started skill to reach its app-hook reference when adopting that pattern.
Installed API discovery
Start at node_modules/@tanstack/table-core/dist/index.d.ts and the relevant feature declarations. Resolve the installed package root if the package manager uses another layout. The adapter migration skill names its published declaration route; follow that route for framework APIs instead of applying another adapter's names.
Build table data processing with TanStack Table v9 while keeping data and column definitions stable. The skill guides type inference, which determines types automatically, row identity, optional features, and checks for missing APIs.
Build a Table v9 plugin when built-in settings and typed metadata are insufficient. Guides custom state, options, and methods, with initialization hooks and runtime checks to ensure declared APIs actually exist and reset correctly.
中文简介正在准备中。当前显示英语简介。
Add reusable custom table behavior
Design plugin state and reset behavior
Keep declared APIs consistent with runtime behavior
Connect React Table v9 to Devtools, a development inspection interface. Configure table registration, unique keys, and enabled settings, and diagnose missing panels while understanding registration cleanup and the separate entrypoint for explicit production use.
Register Angular TanStack Table v9 instances with Devtools, a tool for developers. The skill covers unique table keys, registration that responds to changes, automatic cleanup, and the different setup rules for development and production.
中文简介正在准备中。当前显示英语简介。
Register an Angular table with Devtools
Investigate a table that fails to register
Enable or remove registration as conditions change
Connect Preact Table v9 to Devtools, a development inspection interface. This skill guides package selection, unique table keys, registration settings, and development-only behavior to help diagnose tables that do not appear.