Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Use this as the complete breaking-change checklist, not merely a quick start. V9 is treated as the current API. Migrate the app to Svelte 5 before migrating Table; the v9 adapter has no Svelte 3/4 compatibility layer.
Framework prerequisite: Svelte 5 (svelte ^5.0.0).
Recommended Migration Order
Upgrade to Svelte 5 and replace v8 stores with runes/getters.
Rename createSvelteTable to createTable.
Define explicit tableFeatures, then move row models and registries into it.
Update state reads/ownership and rendering.
Apply every shared API and type rename below.
Use stockFeatures only as a temporary audit bridge; explicit features are the production target.
Per-slice callbacks, external atoms, or store subscription
Available feature imports are cellSelectionFeature, columnFilteringFeature, globalFilteringFeature, rowSortingFeature, rowPaginationFeature, rowSelectionFeature, rowExpandingFeature, rowPinningFeature, columnPinningFeature, columnVisibilityFeature, columnOrderingFeature, columnSizingFeature, columnResizingFeature, rowAggregationFeature, columnGroupingFeature, and columnFacetingFeature. An API does not exist unless its feature is registered. Put a feature before its dependent slot in the same tableFeatures call. Aggregation is independent from grouping: register rowAggregationFeature for aggregation APIs and add columnGroupingFeature only for grouped rows.
Row-model mapping
v8 option
v9 slot and factory
getFilteredRowModel()
filteredRowModel: createFilteredRowModel() after column filtering
getSortedRowModel()
sortedRowModel: createSortedRowModel() after row sorting
getPaginationRowModel()
paginatedRowModel: createPaginatedRowModel() after pagination
getExpandedRowModel()
expandedRowModel: createExpandedRowModel() after expanding
getGroupedRowModel()
groupedRowModel: createGroupedRowModel() after grouping
getFacetedRowModel()
facetedRowModel: createFacetedRowModel() after faceting
getFacetedMinMaxValues()
facetedMinMaxValues: createFacetedMinMaxValues()
getFacetedUniqueValues()
facetedUniqueValues: createFacetedUniqueValues()
Factories take no arguments. Register filterFns, sortFns, and aggregationFns as sibling feature slots holding individually imported built-ins (filterFn_includesString, sortFn_alphanumeric, aggregationFn_sum) under their conventional keys. The full registry objects still work but bundle every built-in.
Svelte State Migration
Reactive option inputs must remain live: use getters for rune values such as data and controlled state slices.
table.getState().sorting becomes the narrow table.atoms.sorting.get() read. Use table.store.get() when code intentionally needs the complete state.
Table atom, store, and API reads become reactive inside templates, $derived, $derived.by, and $effect; use native $derived values for projections.
Remove second-argument selectors from createTable and createAppTable (if present from an earlier v9 version), replace table.state, and remove subscribeTable / SubscribeSource imports.
SvelteTable now has two generic parameters, AppSvelteTable has five, and useTableContext no longer accepts a selected-state generic.
For Svelte-owned controlled slices, use createTableState and matching onSortingChange, onPaginationChange, and other per-slice callbacks.
For shared ownership, provide atoms created by @tanstack/svelte-store through atoms. Never provide both atoms.pagination and state.pagination.
Subscribe to table.store to observe every state change. Do not port the removed top-level onStateChange.
Treat table.baseAtoms as internal writable state; prefer feature APIs or external atoms.
Rendering and Composition
v8
v9
flexRender(...) / <svelte:component>
<FlexRender {cell} />, <FlexRender {header} />, or <FlexRender {footer} />
Component returned directly
renderComponent(Component, props)
Svelte snippet content
renderSnippet(snippet, props)
Repeated raw options
tableOptions(...) composition
Repeated table conventions
createTableHook({ features, ... }) and its pre-bound helpers
createTableHook returns a feature-bound table creator and column helper; use it for application-wide conventions, not as a required migration step.
Complete Shared Breaking-Change Map
Instance methods
Row, cell, column, header, and related object methods now live on shared prototypes and use this. Call row.getValue(...), cell.getContext(), column.getCanSort(), and header.getContext() on their instances. Do not destructure them or pass them as bare callbacks. They are not own enumerable properties, so object spread, Object.keys, and JSON serialization do not preserve them. Table methods are not affected.
This is logical region naming, not automatic DOM direction handling. Prefer CSS inset-inline-start/inset-inline-end. columnResizeDirection is unchanged.
Feature and state splits
enablePinning splits into enableColumnPinning and enableRowPinning.
Interactive resizing requires both columnSizingFeature and columnResizingFeature; fixed widths need only sizing.
All other _-prefixed internal APIs are removed, including _getPinnedRows, _getFacetedRowModel, _getFacetedMinMaxValues, and _getFacetedUniqueValues; do not seek replacements unless a public API is documented.
getIsSomeRowsSelected() and getIsSomePageRowsSelected() now mean at least one, including all. For an indeterminate checkbox, combine “some” with !getIsAllRowsSelected() or !getIsAllPageRowsSelected().
TypeScript Migration
Core types now take TFeatures first: ColumnDef<typeof features, Person>, Column<typeof features, Person>, Row<typeof features, Person>, Table<typeof features, Person>.
Replace createColumnHelper<Person>() with createColumnHelper<typeof features, Person>(); wrap arrays in columnHelper.columns([...]) for inference.
With stockFeatures, use StockFeatures as the feature type.
TableMeta and ColumnMeta declaration merging still works only after adding TFeatures first. Prefer per-table tableMeta/columnMeta: metaHelper<...>() slots.
Replace global FilterFns, SortFns, AggregationFns, and FilterMeta augmentation with filterFns, sortFns, aggregationFns, and filterMeta: metaHelper<...>() slots. Registered keys become valid string references.
Prefer explicit object row types; RowData is restricted to records or arrays.
Common Migration Failures
CRITICAL: Running v9 on Svelte 3/4
Upgrade to Svelte 5 first. Writable-store-era table setup is not a supported v9 adapter contract.
HIGH: Moving the feature but not its row model
Register both the feature and its create*RowModel() slot. Leaving get*RowModel on table options silently leaves the v9 processing pipeline incomplete.
HIGH: Snapshotting a rune value
Use get data() { return data }; a one-time data snapshot does not remain reactive.
HIGH: Keeping removed Svelte selectors
Remove second arguments from createTable and createAppTable, replace selected table.state reads with table.atoms.<slice>.get() or table.store.get(), and remove subscribeTable, SubscribeSource, and selected-state generic parameters. V9 intentionally has no compatibility layer for these APIs.
HIGH: Destructuring instance methods
Keep calls bound to row/cell/column/header instances; shallow copies do not contain prototype methods.
Final Checklist
Svelte is version 5+; old writable-store patterns are removed.
createSvelteTable is replaced by createTable.
Explicit features, row models, and function registries are in tableFeatures.
getCoreRowModel and the separate rowModels shape are removed.
Reactive inputs and controlled slices use getters/runes; state reads use v9 surfaces.
Svelte creation selectors, table.state, subscribeTable, SubscribeSource, and selected-state generic parameters are removed.
onStateChange is replaced; atom/state ownership does not overlap.
Rendering uses FlexRender, renderComponent, or renderSnippet.
Prototype method calls, pinning, sizing/resizing, sorting, row, and selection semantics are audited.
Helpers, types, meta, registries, and RowData use the v9 generic/slot shapes.
Temporary stockFeatures usage has an explicit removal plan.
API Discovery
Verify the installed target in node_modules/@tanstack/svelte-table/dist/index.d.ts and its adapter sources. Verify feature slots and the exact installed v9 APIs in node_modules/@tanstack/table-core/dist/; do not reconstruct v9 APIs from v8 memory.
