Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
21 changes: 11 additions & 10 deletions _artifacts/domain_map.yaml
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
library:
name: '@tanstack/table'
version: '9.0.0-beta.52'
version: '9.0.0-beta.53'
repository: 'https://github.com/TanStack/table'
homepage: 'https://tanstack.com/table'
description: 'Headless, framework-agnostic data-grid state and row-processing primitives with tree-shakeable v9 features and framework adapters.'
primary_framework: 'framework-agnostic'
monorepo: true
package_version_overrides:
'@tanstack/match-sorter-utils': '9.0.0-beta.41'

meta:
generated_by: '@tanstack/intent scaffold domain discovery'
Expand All @@ -20,7 +19,7 @@ meta:
scope:
goals:
- 'Route agents to the correct package and skill, then correct common foot-guns and misconceptions.'
- 'Use docs and examples for intended workflows, and direct exact API discovery to the installed package src directory.'
- 'Use docs and examples for intended workflows, and direct exact API discovery to installed package declarations (dist/**/*.d.ts).'
- 'Teach headless rendering, feature registration, row-model ownership, framework state, and v8-to-v9 changes as foundations.'
included:
- 'All 17 public workspace packages.'
Expand Down Expand Up @@ -105,11 +104,13 @@ custom_feature_depth_contract:
- 'The table_/column_/row_/cell_/header_ static-name prefixes, self argument difference, optional memoDeps, and absence of per-object assign*APIs utilities.'

api_discovery_policy:
rule: 'For exact exports, option types, state shapes, and instance APIs, inspect src in the installed package before inventing an API or relying on memory.'
adapter_entrypoint: 'node_modules/@tanstack/<framework>-table/src/index.ts'
core_entrypoint: 'node_modules/@tanstack/table-core/src/index.ts'
feature_source: 'node_modules/@tanstack/table-core/src/features/<feature>/'
fallback: 'If source is unavailable because the package manager omitted it, inspect the matching declarations and the installed package version; do not substitute v8 or another adapter API.'
rule: 'For exact exports, option types, state shapes, and instance APIs, inspect dist declarations (.d.ts) in the installed package before inventing an API or relying on memory.'
adapter_entrypoint: 'node_modules/@tanstack/<framework>-table/dist/index.d.ts'
core_entrypoint: 'node_modules/@tanstack/table-core/dist/index.d.ts'
feature_source: 'node_modules/@tanstack/table-core/dist/features/<feature>/'
ember_entrypoint: 'node_modules/@tanstack/ember-table/declarations/index.d.ts'
angular_entrypoint: 'node_modules/@tanstack/angular-table/dist/types/'
fallback: 'If declarations are unavailable, resolve the installed package root and inspect published types; do not open package src/ or substitute v8 / another adapter API.'

coverage:
ignored_packages:
Expand Down Expand Up @@ -1573,7 +1574,7 @@ issue_evidence:

documentation_read:
narrative_docs: 'All 187 narrative Markdown documents were inventoried by title, headings, and admonitions; foundational, feature, state, migration, composable, and virtualization guides were deep-read.'
generated_references: 'All 828 generated reference documents were inventoried for exports and API categories; exact API truth is delegated to shipped src in skills.'
generated_references: 'All 828 generated reference documents were inventoried for exports and API categories; exact API truth is delegated to installed dist declarations (.d.ts) in skills.'
examples: 'All 277 example directories were inventoried; basic, state, composable, Query, Virtual, feature, and Devtools-relevant examples were sampled or deep-read by skill.'
source: 'All public package entrypoints, tableFeatures prerequisites, core construction/state precedence, all 14 feature implementations/defaults, createTableHook implementations, Devtools registration, and match-sorter-utils source were inspected.'
community: 'Recent v9 issues plus recurring high-signal issues and GitHub discussions were reviewed for failure modes and misconceptions.'
Expand Down Expand Up @@ -1613,7 +1614,7 @@ maintainer_interview:
phase_2_summary:
- 'Primary journeys are first table setup, adding a feature, v8-to-v9 migration, server-data decisions, and performance debugging.'
- 'Table is headless and compatible with component libraries/design systems, but no library-specific skills are in scope.'
- 'Feature skills should be short, edge-case-first, and route exact API discovery to shipped src.'
- 'Feature skills should be short, edge-case-first, and route exact API discovery to installed dist declarations (.d.ts).'
- 'Framework state guides, createTableHook, Query, and Virtual require dedicated adapter guidance where source exists.'
- 'Worker row models are excluded and useLegacyTable must not be promoted.'
phase_4_completed: true
Expand Down
28 changes: 15 additions & 13 deletions _artifacts/skill_spec.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Generate 75 short package-local skills across all 17 public packages. A loaded s

1. Correct the user or agent mental model.
2. Show the smallest reliable setup or decision pattern.
3. Route exact API discovery to src shipped in the installed package.
3. Route exact API discovery to installed package declarations (`dist/**/*.d.ts`, Ember `declarations/**/*.d.ts`, Angular `dist/types/*.d.ts`).

The skills should not enumerate every option or method. That duplicates generated reference docs, ages badly, and encourages agents to recall the wrong major version.

Expand All @@ -35,20 +35,22 @@ The skills should not enumerate every option or method. That duplicates generate

Use evidence in this order:

1. Installed package src for exact exports, type signatures, feature prerequisites, defaults, and instance APIs.
1. Installed package declarations (`.d.ts`) for exact exports, type signatures, feature prerequisites, defaults, and instance APIs.
2. Current v9 guides for intended mental models and supported workflows.
3. Current examples for maintained composition and rendering patterns.
4. Recent and recurring GitHub issues/discussions for silent failures and misconceptions.

Every skill that discusses APIs must tell the consuming agent how to inspect the matching installed source. Preferred routes:
Every skill that discusses APIs must tell the consuming agent how to inspect the matching installed declarations. Preferred routes:

- Adapter API: node_modules/@tanstack/FRAMEWORK-table/src/index.ts, then the exported implementation/type file.
- Core API: node_modules/@tanstack/table-core/src/index.ts.
- Stock feature API: node_modules/@tanstack/table-core/src/features/FEATURE/.
- Devtools API: node_modules/@tanstack/FRAMEWORK-table-devtools/src/index.ts or @tanstack/table-devtools/src/index.ts.
- Fuzzy ranking API: node_modules/@tanstack/match-sorter-utils/src/index.ts.
- Adapter API: node_modules/@tanstack/FRAMEWORK-table/dist/index.d.ts, then the matching exported `*.d.ts` file.
- Core API: node_modules/@tanstack/table-core/dist/index.d.ts.
- Stock feature API: node_modules/@tanstack/table-core/dist/features/FEATURE/.
- Ember API: node_modules/@tanstack/ember-table/declarations/index.d.ts (and sibling `declarations/*.d.ts`).
- Angular API: node_modules/@tanstack/angular-table/dist/types/\*.d.ts (bundled public API; do not expect `src/helpers/` under the published package).
- Devtools API: node_modules/@tanstack/FRAMEWORK-table-devtools/dist/index.d.ts or @tanstack/table-devtools/dist/index.d.ts.
- Fuzzy ranking API: node_modules/@tanstack/match-sorter-utils/dist/index.d.ts.

Do not direct agents to a GitHub main-branch source file when an installed package is available. Installed source keeps guidance aligned with the consumer package version.
Do not open package `src/` under `node_modules` (it is not published). Do not direct agents to a GitHub main-branch source file when an installed package is available. Installed declarations keep guidance aligned with the consumer package version.

## Skill writing contract

Expand All @@ -75,7 +77,7 @@ Use this default structure:
2. Setup: imports and the smallest valid configuration.
3. Two to four decision or implementation patterns.
4. Common mistakes: at least three concrete failures with correction.
5. API discovery: exact installed src route and identifiers to inspect.
5. API discovery: exact installed declaration route (`.d.ts`) and identifiers to inspect.
6. Cross-skill routing only when another skill owns the next decision.

Do not add a reference folder by default. Add one only when a large migration mapping or framework-specific content cannot stay concise in SKILL.md. Progressive disclosure is a size tool, not permission to recreate all docs as references.
Expand Down Expand Up @@ -176,7 +178,7 @@ Skill versions ship with package versions. After release tooling calculates pack
- table-features — explicit registration, prerequisites, row-model/function slots, tree-shaking.
- client-vs-server — choose ownership for filtering/grouping/sorting/expanding/pagination.
- typescript — columnHelper, meta helpers, tableOptions, inference, avoid manual generics.
- api-not-found — inspect installed src, feature gating, version/adapter mismatch, prototypes.
- api-not-found — inspect installed declarations, feature gating, version/adapter mismatch, prototypes.
- custom-features — plugin lifecycle after exhausting built-in APIs and meta.
- migrate-v8-to-v9 — shared breaking changes and adapter migration routing.

Expand All @@ -203,7 +205,7 @@ Each feature skill must:
- name only row-model and registry slots relevant to that feature;
- state its tableFeatures prerequisites;
- distinguish state from row processing and renderer behavior;
- route exact API discovery to its shipped feature directory;
- route exact API discovery to its shipped feature directory under `dist/features/`;
- include feature-specific edge cases from domain_map.yaml.

Do not combine all column layout features into one summary. Their plugin prerequisites and CSS responsibilities differ enough to route independently.
Expand Down Expand Up @@ -346,7 +348,7 @@ All Devtools skills must emphasize the required non-empty table options.key, lif
- Query: data source and manual processing boundaries, not Table rendering.
- Virtual: final Table models and renderer geometry, never tableFeatures.
- Context: createTableHook skills; mention context over prop drilling when a registered reusable component needs typed table/cell/header access.
- API lookup: api-not-found establishes the workflow; every other skill includes its direct installed src route.
- API lookup: api-not-found establishes the workflow; every other skill includes its direct installed declaration route.

## Anti-patterns forbidden during generation

Expand Down
5 changes: 2 additions & 3 deletions _artifacts/skill_tree.yaml
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
library:
name: '@tanstack/table'
version: '9.0.0-beta.52'
version: '9.0.0-beta.53'
repository: 'https://github.com/TanStack/table'
description: 'Headless data-grid state and row processing with tree-shakeable v9 features and framework adapters.'
package_version_overrides:
'@tanstack/match-sorter-utils': '9.0.0-beta.41'
generated_from:
domain_map: '_artifacts/domain_map.yaml'
skill_spec: '_artifacts/skill_spec.md'
Expand Down Expand Up @@ -89,7 +88,7 @@ skills:
domain: foundations
path: 'packages/table-core/skills/api-not-found/SKILL.md'
package: 'packages/table-core'
description: 'Diagnose missing TanStack Table exports, options, state slices, and instance methods by checking the installed package src, adapter/version mismatches, tableFeatures registration, and v9 prototype APIs before inventing replacements.'
description: 'Diagnose missing TanStack Table exports, options, state slices, and instance methods by checking the installed package declarations (dist/**/*.d.ts), adapter/version mismatches, tableFeatures registration, and v9 prototype APIs before inventing replacements.'
requires: ['core', 'table-features']
sources:
- 'TanStack/table:packages/table-core/src/index.ts'
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/aggregation/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/basic-app-table/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
"test:e2e": "PLAYWRIGHT_TEST_DIR=$PWD/tests/e2e playwright test --config ../../../playwright.config.ts"
},
"dependencies": {
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/basic-create-table/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/basic-dynamic-columns/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/basic-external-atoms/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"@tanstack/store": "^0.11.0",
"alpinejs": "^3.15.12"
},
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/basic-external-state/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/column-ordering/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/column-pinning-split/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/column-pinning-sticky/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/column-pinning/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/column-resizing-performant/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/column-resizing/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/column-sizing/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/column-visibility/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/custom-plugin/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/expanding/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/filters-faceted/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/filters/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/grouped-aggregation/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/grouping/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/header-groups/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/pagination/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/row-pinning/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/row-selection/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/sorting-dynamic-data/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
2 changes: 1 addition & 1 deletion examples/alpine/sorting/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
},
"dependencies": {
"@faker-js/faker": "^10.5.0",
"@tanstack/alpine-table": "^9.0.0-beta.52",
"@tanstack/alpine-table": "^9.0.0-beta.53",
"alpinejs": "^3.15.12"
},
"devDependencies": {
Expand Down
Loading
Loading