migrate-v8-to-v9
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.
How do I install this agent skill?
npx skills add https://github.com/tanstack/table --skill migrate-v8-to-v9Is this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides technical documentation and instructions for migrating Angular Table from version 8 to version 9. It focuses on API changes, state management, and rendering updates within Angular 19+ environments. No security risks or malicious patterns were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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-v9and itstable-stateskill. 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 | Architecture mappings |
getState, onStateChange, controlled ownership, observation, or reset changes | State mappings |
| Aggregation, logical pinning, sizing/resizing, sorting names, or selection predicates | Feature API mappings |
Explicit generics, column helpers, scoped meta, registry augmentation, or RowData | TypeScript mappings |
Complete audit checklist
- 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
featuresobject 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
stockFeaturesonly as a temporary parity aid and record an explicit-feature follow-up. - Remove
getCoreRowModel()unless supplying a deliberate customcoreRowModelslot. - Move all remaining
get*RowModel()options (or a removedrowModels: {...}object, if present) tocreate*RowModel()feature slots. - Register each dependent feature before its row-model slot.
- Move
filterFns,sortingFns/sortFns, andaggregationFnsinto feature slots, registering individually imported built-ins; pass no registries to factories. - Register
rowAggregationFeatureindependently and migrate custom aggregation callables to context-basedAggregationFnDefdefinitions. - Register
columnFilteringFeaturebefore global filtering and filter/facet dependencies. - Register
columnSizingFeaturebeforecolumnResizingFeature. - Replace
table.getState()and top-levelonStateChangeaccording 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/rightkey, argument, comparison, method family, and sticky CSS declaration with logical start/end equivalents. - Split table-level
enablePinning; preserve column-defenablePinningwhere intended. - Split sizing/resizing features and rename the resizing state, setter, and callback.
- Replace every
sortingFn/SortingFn/sortingFnsspelling with its v9sort*spelling. - Remove every consumed underscore-prefixed internal API.
- Recheck indeterminate selection logic against the new "at least one" semantics.
- Add
TFeaturesto 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
RowDataconstraint. - 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
useLegacyTableafter 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tanstack/table/migrate-v8-to-v9">View migrate-v8-to-v9 on skillZs</a>