@tanstack/table-core 9.0.0-beta.45 → 9.0.0-beta.47

package/skills/column-filtering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:
@@ -23,17 +23,22 @@ This skill builds on `core`, `table-features`, and `client-vs-server`. Filtering
 import {
   columnFilteringFeature,
   createFilteredRowModel,
-  filterFns,
+  filterFn_includesString,
   tableFeatures,
 } from '@tanstack/table-core'
 
 export const features = tableFeatures({
   columnFilteringFeature,
   filteredRowModel: createFilteredRowModel(),
-  filterFns,
+  filterFns: { includesString: filterFn_includesString },
 })
 ```
 
+Import individual `filterFn_*` built-ins and register only those your columns
+reference by string name or that `filterFn: 'auto'` should resolve for your
+data types. The full `filterFns` registry object still works but bundles every
+built-in.
+
 ## Core Patterns
 
 ```ts

package/skills/column-ordering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/column-pinning/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features', 'column-sizing']
 sources:

package/skills/column-resizing/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features', 'column-sizing']
 sources:

package/skills/column-sizing/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/column-visibility/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/core/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.45'
+  library_version: '9.0.0-beta.47'
 sources:
   - 'TanStack/table:docs/overview.md'
   - 'TanStack/table:docs/guide/tables.md'

package/skills/custom-features/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.45'
+  library_version: '9.0.0-beta.47'
 requires: ['core', 'table-features', 'typescript']
 sources:
   - 'TanStack/table:docs/framework/react/guide/custom-features.md'

package/skills/expanding/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/global-filtering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features', 'client-vs-server', 'column-filtering']
 sources:
@@ -23,7 +23,7 @@ This skill builds on `core`, `table-features`, `client-vs-server`, and `column-f
 import {
   columnFilteringFeature,
   createFilteredRowModel,
-  filterFns,
+  filterFn_includesString,
   globalFilteringFeature,
   tableFeatures,
 } from '@tanstack/table-core'
@@ -32,7 +32,7 @@ export const features = tableFeatures({
   columnFilteringFeature,
   globalFilteringFeature,
   filteredRowModel: createFilteredRowModel(),
-  filterFns,
+  filterFns: { includesString: filterFn_includesString },
 })
 ```
 

package/skills/grouping/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:
@@ -21,7 +21,7 @@ This skill builds on `core`, `table-features`, and `client-vs-server`. Grouping
 
 ```ts
 import {
-  aggregationFns,
+  aggregationFn_sum,
   columnGroupingFeature,
   createGroupedRowModel,
   tableFeatures,
@@ -30,10 +30,15 @@ import {
 export const features = tableFeatures({
   columnGroupingFeature,
   groupedRowModel: createGroupedRowModel(),
-  aggregationFns,
+  aggregationFns: { sum: aggregationFn_sum },
 })
 ```
 
+Import individual `aggregationFn_*` built-ins and register only those your
+columns reference by string name or that `aggregationFn: 'auto'` should
+resolve (numbers resolve to `sum`, dates to `extent`). The full
+`aggregationFns` registry object still works but bundles every built-in.
+
 ## Core Patterns
 
 ```ts

package/skills/migrate-v8-to-v9/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: lifecycle
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.45'
+  library_version: '9.0.0-beta.47'
 requires: ['core', 'table-features', 'typescript']
 sources:
   - 'TanStack/table:docs/framework/react/guide/migrating.md'
@@ -42,9 +42,9 @@ import {
   createFilteredRowModel,
   createSortedRowModel,
   columnFilteringFeature,
-  filterFns,
+  filterFn_includesString,
   rowSortingFeature,
-  sortFns,
+  sortFn_alphanumeric,
   tableFeatures,
 } from '@tanstack/table-core'
 
@@ -53,8 +53,8 @@ export const features = tableFeatures({
   rowSortingFeature,
   filteredRowModel: createFilteredRowModel(),
   sortedRowModel: createSortedRowModel(),
-  filterFns,
-  sortFns,
+  filterFns: { includesString: filterFn_includesString },
+  sortFns: { alphanumeric: sortFn_alphanumeric },
 })
 ```
 
@@ -118,7 +118,7 @@ Move registries from table options or factory arguments into these feature slots
 | `filterFns`      | `filterFns`      |
 | `aggregationFns` | `aggregationFns` |
 
-Register built-ins only when needed, or spread them with custom functions. A slot's keys become the valid string names in column definitions.
+Register only the built-ins the table references by string name, importing each individually (`filterFn_includesString`, `sortFn_alphanumeric`, `aggregationFn_sum`, and so on) alongside any custom functions. The full registry objects (`filterFns`, `sortFns`, `aggregationFns` exports) still work but bundle every built-in. A slot's keys become the valid string names in column definitions, and `'auto'` resolves only registered functions.
 
 ### 3. Migrate state reads and whole-state observation
 
@@ -279,7 +279,7 @@ Do not confuse new capabilities with required breakages. After the table works,
 - [ ] Remove `getCoreRowModel()` unless supplying a deliberate custom `coreRowModel` slot.
 - [ ] Move all remaining `get*RowModel()` options or earlier-beta `rowModels` entries to `create*RowModel()` feature slots.
 - [ ] Register each dependent feature before its row-model slot.
-- [ ] Move `filterFns`, `sortingFns`/`sortFns`, and `aggregationFns` into feature slots; pass no registries to factories.
+- [ ] Move `filterFns`, `sortingFns`/`sortFns`, and `aggregationFns` into feature slots, registering individually imported built-ins; pass no registries to factories.
 - [ ] 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.

package/skills/pagination/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/row-pinning/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/row-selection/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/sorting/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.45',
+    library_version: '9.0.0-beta.47',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:
@@ -23,17 +23,23 @@ This skill builds on `core`, `table-features`, and `client-vs-server`. Sorting s
 import {
   createSortedRowModel,
   rowSortingFeature,
-  sortFns,
+  sortFn_alphanumeric,
+  sortFn_text,
   tableFeatures,
 } from '@tanstack/table-core'
 
 export const features = tableFeatures({
   rowSortingFeature,
   sortedRowModel: createSortedRowModel(),
-  sortFns,
+  sortFns: { alphanumeric: sortFn_alphanumeric, text: sortFn_text },
 })
 ```
 
+Import individual `sortFn_*` built-ins and register only those your columns
+reference by string name or that `sortFn: 'auto'` should resolve for your data
+types. The full `sortFns` registry object still works but bundles every
+built-in; numeric columns fall back to a basic comparator without registration.
+
 ## Core Patterns
 
 ```ts

package/skills/table-features/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.45'
+  library_version: '9.0.0-beta.47'
 requires: ['core']
 sources:
   - 'TanStack/table:docs/guide/row-models.md'
@@ -22,26 +22,26 @@ This skill builds on `core`. Read it first for the headless model and stable inp
 
 ```ts
 import {
-  aggregationFns,
+  aggregationFn_sum,
   columnGroupingFeature,
   createFilteredRowModel,
   createSortedRowModel,
   columnFilteringFeature,
-  filterFns,
+  filterFn_includesString,
   rowSortingFeature,
-  sortFns,
+  sortFn_alphanumeric,
   tableFeatures,
 } from '@tanstack/table-core'
 
 export const features = tableFeatures({
   columnFilteringFeature,
   filteredRowModel: createFilteredRowModel(),
-  filterFns,
+  filterFns: { includesString: filterFn_includesString },
   columnGroupingFeature,
-  aggregationFns,
+  aggregationFns: { sum: aggregationFn_sum },
   rowSortingFeature,
   sortedRowModel: createSortedRowModel(),
-  sortFns,
+  sortFns: { alphanumeric: sortFn_alphanumeric },
 })
 ```
 
@@ -63,19 +63,22 @@ const features = tableFeatures({
 ```ts
 const features = tableFeatures({
   columnFilteringFeature,
-  filterFns,
+  filterFns: { includesString: filterFn_includesString },
   rowSortingFeature,
-  sortFns,
+  sortFns: { alphanumeric: sortFn_alphanumeric },
   columnGroupingFeature,
-  aggregationFns,
+  aggregationFns: { sum: aggregationFn_sum },
 })
 ```
 
 `filterFns`, `sortFns`, and `aggregationFns` are feature slots, not table
 options. They respectively require `columnFilteringFeature`,
-`rowSortingFeature`, and `columnGroupingFeature`. A registered key can be used
-as a typed string name; pass a function directly when no registry name is
-needed.
+`rowSortingFeature`, and `columnGroupingFeature`. Import individual built-ins
+(`filterFn_*`, `sortFn_*`, `aggregationFn_*`) and register them under their
+conventional keys; the full registry objects (`filterFns`, `sortFns`,
+`aggregationFns` exports) still work but bundle every built-in. A registered
+key can be used as a typed string name, and `'auto'` resolves only registered
+functions; pass a function directly when no registry name is needed.
 
 ### Prefer explicit features
 

package/skills/typescript/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.45'
+  library_version: '9.0.0-beta.47'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:docs/guide/helpers.md'

package/src/features/column-filtering/columnFilteringFeature.types.ts

@@ -3,6 +3,7 @@ import type {
   CellData,
   OnChangeFn,
   RowData,
+  TransformDataValueFn,
   Updater,
 } from '../../types/type-utils'
 import type { IsAny, TableFeatures } from '../../types/TableFeatures'
@@ -66,8 +67,67 @@ export interface FilterFn<
     filterValue: any,
     addMeta?: (meta: ExtractFilterMeta<TFeatures>) => void,
   ): boolean
+  /**
+   * Removes the filter from `state.columnFilters` when the filter value fails
+   * this test (e.g. empty strings for text filters).
+   */
   autoRemove?: ColumnFilterAutoRemoveTestFn<TFeatures, TData>
+  /**
+   * Normalizes the filter value before filtering runs.
+   *
+   * The table applies this once per filter (not per row) and passes the
+   * resolved value to the filter function as `filterValue`.
+   */
   resolveFilterValue?: TransformFilterValueFn<TFeatures, TData>
+  /**
+   * Normalizes each row's value before it is compared against the filter
+   * value. Only honored by filter functions built with `constructFilterFn`
+   * (including all built-in filter functions).
+   */
+  resolveDataValue?: TransformDataValueFn
+}
+
+/**
+ * The definition object accepted by `constructFilterFn`.
+ *
+ * `filter` is a value-level comparator: it receives the row's (resolved) data
+ * value and the (resolved) filter value instead of the whole row, so
+ * normalization concerns stay in `resolveDataValue`/`resolveFilterValue`.
+ */
+export interface FilterFnDef<
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
+> {
+  filter: (
+    dataValue: any,
+    filterValue: any,
+    row: Row<TFeatures, TData>,
+    columnId: string,
+    addMeta?: (meta: ExtractFilterMeta<TFeatures>) => void,
+  ) => boolean
+  autoRemove?: (filterValue: any) => boolean
+  resolveFilterValue?: (filterValue: any) => any
+  resolveDataValue?: TransformDataValueFn
+}
+
+/**
+ * The shape returned by `constructFilterFn`: a `FilterFn` with its definition
+ * attached, so variants can be built by spreading it into another
+ * `constructFilterFn` call.
+ *
+ * The call signature is generic so a created filter function can be used with
+ * any table's rows, regardless of the feature set it was defined against.
+ */
+export interface CreatedFilterFn<
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
+> extends FilterFnDef<TFeatures, TData> {
+  <TRowFeatures extends TableFeatures, TRowData extends RowData>(
+    row: Row<TRowFeatures, TRowData>,
+    columnId: string,
+    filterValue: any,
+    addMeta?: (meta: ExtractFilterMeta<TRowFeatures>) => void,
+  ): boolean
 }
 
 export type TransformFilterValueFn<

package/src/features/column-filtering/columnFilteringFeature.utils.ts

@@ -27,8 +27,12 @@ export function getDefaultColumnFiltersState(): ColumnFiltersState {
  * Chooses a built-in filter function from the column's first core row value.
  *
  * Strings use `includesString`, numbers use `inNumberRange`, booleans and
- * objects use `equals`, arrays use `arrIncludes`, and unknown values fall back
- * to `weakEquals`.
+ * objects use `equals`, dates use `inDateRange`, arrays use `arrIncludes`,
+ * and unknown values fall back to `weakEquals`.
+ *
+ * The chosen filter function is looked up in the table's `filterFns`
+ * registry. When it is not registered there, this returns `undefined` and
+ * warns in development instead of substituting a different filter function.
  *
  * @example
  * ```ts
@@ -47,27 +51,33 @@ export function column_getAutoFilterFn<
 
   const value = firstRow ? firstRow.getValue(column.id) : undefined
 
-  if (typeof value === 'string') {
-    return filterFns?.includesString
-  }
+  let filterFnName: string
 
-  if (typeof value === 'number') {
-    return filterFns?.inNumberRange
+  if (typeof value === 'string') {
+    filterFnName = 'includesString'
+  } else if (typeof value === 'number') {
+    filterFnName = 'inNumberRange'
+  } else if (typeof value === 'boolean') {
+    filterFnName = 'equals'
+  } else if (Array.isArray(value)) {
+    filterFnName = 'arrIncludes'
+  } else if (Object.prototype.toString.call(value) === '[object Date]') {
+    filterFnName = 'inDateRange'
+  } else if (value !== null && typeof value === 'object') {
+    filterFnName = 'equals'
+  } else {
+    filterFnName = 'weakEquals'
   }
 
-  if (typeof value === 'boolean') {
-    return filterFns?.equals
-  }
+  const filterFn = filterFns?.[filterFnName]
 
-  if (Array.isArray(value)) {
-    return filterFns?.arrIncludes
-  }
-
-  if (value !== null && typeof value === 'object') {
-    return filterFns?.equals
+  if (process.env.NODE_ENV === 'development' && !filterFn) {
+    console.warn(
+      `filterFn '${filterFnName}' (auto) for column '${column.id}' is not registered`,
+    )
   }
 
-  return filterFns?.weakEquals
+  return filterFn
 }
 
 /**
@@ -98,9 +108,13 @@ export function column_getFilterFn<
       ? column_getAutoFilterFn(column)
       : filterFns?.[column.columnDef.filterFn as string]
 
-  if (process.env.NODE_ENV === 'development' && !filterFn) {
+  if (
+    process.env.NODE_ENV === 'development' &&
+    !filterFn &&
+    column.columnDef.filterFn !== 'auto' // the auto picker warns on its own
+  ) {
     console.warn(
-      `Could not find a valid 'column.filterFn' for column with the ID: ${column.id}.`,
+      `filterFn '${String(column.columnDef.filterFn)}' for column '${column.id}' is not registered`,
     )
   }
 

package/src/features/column-filtering/createFilteredRowModel.ts

@@ -22,8 +22,12 @@ import type {
  *
  * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
  *
- * Register filter functions with the `filterFns` slot on the `features` option:
- * `tableFeatures({ columnFilteringFeature, filteredRowModel: createFilteredRowModel(), filterFns })`.
+ * Register the filter functions you use with the `filterFns` slot on the
+ * `features` option:
+ * `tableFeatures({ columnFilteringFeature, filteredRowModel: createFilteredRowModel(), filterFns: { includesString: filterFn_includesString } })`.
+ * Importing individual `filterFn_*` functions keeps unused built-ins out of
+ * your bundle; filter functions passed directly to the `filterFn` column
+ * option need no registration at all.
  */
 export function createFilteredRowModel<
   TFeatures extends TableFeatures,
@@ -78,7 +82,13 @@ function _createFilteredRowModel<
       return
     }
 
-    const filterFn = column_getFilterFn(column)!
+    const filterFn = column_getFilterFn(column)
+
+    // A dev warning has already fired in column_getFilterFn; ignore the
+    // filter instead of crashing when its filter fn is not registered.
+    if (!filterFn) {
+      return
+    }
 
     resolvedColumnFilters.push({
       id: columnFilter.id,

package/src/features/column-grouping/columnGroupingFeature.types.ts

@@ -4,6 +4,7 @@ import type {
   CellData,
   OnChangeFn,
   RowData,
+  TransformDataValueFn,
   Updater,
 } from '../../types/type-utils'
 import type { IsAny, TableFeatures } from '../../types/TableFeatures'
@@ -26,14 +27,68 @@ export interface RowModelFns_ColumnGrouping<
 
 export interface AggregationFns {}
 
-export type AggregationFn<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
-> = (
-  columnId: string,
-  leafRows: Array<Row<TFeatures, TData>>,
-  childRows: Array<Row<TFeatures, TData>>,
-) => any
+export interface AggregationFn<
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
+> {
+  (
+    columnId: string,
+    leafRows: Array<Row<TFeatures, TData>>,
+    childRows: Array<Row<TFeatures, TData>>,
+  ): any
+  /**
+   * Normalizes each row's value before it is aggregated. Only honored by
+   * aggregation functions built with `constructAggregationFn` (including the
+   * value-based built-in aggregation functions).
+   */
+  resolveDataValue?: TransformDataValueFn
+}
+
+/**
+ * The definition object accepted by `constructAggregationFn`.
+ *
+ * `aggregate` is a value-level reducer: it receives the rows' (resolved)
+ * values instead of the rows themselves, so normalization concerns stay in
+ * `resolveDataValue`.
+ */
+export interface AggregationFnDef<
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
+> {
+  aggregate: (
+    values: Array<any>,
+    rows: Array<Row<TFeatures, TData>>,
+    columnId: string,
+  ) => any
+  /**
+   * Which of the group's rows feed the aggregation: all of its `leafRows`
+   * (the default) or its immediate `childRows`. For nested groups, child rows
+   * expose already-aggregated values, which is faster for reaggregatable
+   * computations like sums and extents.
+   */
+  fromRows?: 'leafRows' | 'childRows'
+  resolveDataValue?: TransformDataValueFn
+}
+
+/**
+ * The shape returned by `constructAggregationFn`: an `AggregationFn` with its
+ * definition attached, so variants can be built by spreading it into another
+ * `constructAggregationFn` call.
+ *
+ * The call signature is generic so a created aggregation function can be used
+ * with any table's rows, regardless of the feature set it was defined
+ * against.
+ */
+export interface CreatedAggregationFn<
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
+> extends AggregationFnDef<TFeatures, TData> {
+  <TRowFeatures extends TableFeatures, TRowData extends RowData>(
+    columnId: string,
+    leafRows: Array<Row<TRowFeatures, TRowData>>,
+    childRows: Array<Row<TRowFeatures, TRowData>>,
+  ): any
+}
 
 export type CustomAggregationFns<
   TFeatures extends TableFeatures,