@tanstack/table-core 9.0.0-beta.2 → 9.0.0-beta.20

package/src/core/columns/coreColumnsFeature.ts

@@ -10,91 +10,64 @@ import {
   table_getColumn,
   table_getDefaultColumnDef,
 } from './coreColumnsFeature.utils'
-import type { RowData } from '../../types/type-utils'
-import type { TableFeature, TableFeatures } from '../../types/TableFeatures'
-// import type {
-//   Column_Column,
-//   TableOptions_Columns,
-//   Table_Columns,
-// } from './coreColumnsFeature.types'
-
-export interface CoreColumnsFeatureConstructors<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
-> {
-  // Column: Column_Column<TFeatures, TData>
-  // Table: Table_Columns<TFeatures, TData>
-  // TableOptions: TableOptions_Columns<TFeatures, TData>
-}
+import type { TableFeature } from '../../types/TableFeatures'
 
 /**
- * Creates the stock core columns feature.
- *
- * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ * Core feature that builds the column tree and exposes table/column column APIs.
  */
-export function constructCoreColumnsFeature<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
->(): TableFeature<CoreColumnsFeatureConstructors<TFeatures, TData>> {
-  return {
-    assignColumnPrototype: (prototype, table) => {
-      assignPrototypeAPIs('coreColumnsFeature', prototype, table, {
-        column_getFlatColumns: {
-          fn: (column) => column_getFlatColumns(column),
-          memoDeps: (column) => [column.table.options.columns],
-        },
-        column_getLeafColumns: {
-          fn: (column) => column_getLeafColumns(column),
-          memoDeps: (column) => [
-            column.table.atoms.columnOrder?.get(),
-            column.table.atoms.grouping?.get(),
-            column.table.options.columns,
-            column.table.options.groupedColumnMode,
-          ],
-        },
-      })
-    },
+export const coreColumnsFeature: TableFeature = {
+  assignColumnPrototype: (prototype, table) => {
+    assignPrototypeAPIs('coreColumnsFeature', prototype, table, {
+      column_getFlatColumns: {
+        fn: (column) => column_getFlatColumns(column),
+        memoDeps: (column) => [column.table.options.columns],
+      },
+      column_getLeafColumns: {
+        fn: (column) => column_getLeafColumns(column),
+        memoDeps: (column) => [
+          column.table.atoms.columnOrder?.get(),
+          column.table.atoms.grouping?.get(),
+          column.table.options.columns,
+          column.table.options.groupedColumnMode,
+        ],
+      },
+    })
+  },
 
-    constructTableAPIs: (table) => {
-      assignTableAPIs('coreColumnsFeature', table, {
-        table_getDefaultColumnDef: {
-          fn: () => table_getDefaultColumnDef(table),
-          memoDeps: () => [table.options.defaultColumn],
-        },
-        table_getAllColumns: {
-          fn: () => table_getAllColumns(table),
-          memoDeps: () => [table.options.columns],
-        },
-        table_getAllFlatColumns: {
-          fn: () => table_getAllFlatColumns(table),
-          memoDeps: () => [table.options.columns],
-        },
-        table_getAllFlatColumnsById: {
-          fn: () => table_getAllFlatColumnsById(table),
-          memoDeps: () => [table.options.columns],
-        },
-        table_getAllLeafColumns: {
-          fn: () => table_getAllLeafColumns(table),
-          memoDeps: () => [
-            table.atoms.columnOrder?.get(),
-            table.atoms.grouping?.get(),
-            table.options.columns,
-            table.options.groupedColumnMode,
-          ],
-        },
-        table_getAllLeafColumnsById: {
-          fn: () => table_getAllLeafColumnsById(table),
-          memoDeps: () => [table.getAllLeafColumns()],
-        },
-        table_getColumn: {
-          fn: (columnId) => table_getColumn(table, columnId),
-        },
-      })
-    },
-  }
+  constructTableAPIs: (table) => {
+    assignTableAPIs('coreColumnsFeature', table, {
+      table_getDefaultColumnDef: {
+        fn: () => table_getDefaultColumnDef(table),
+        memoDeps: () => [table.options.defaultColumn],
+      },
+      table_getAllColumns: {
+        fn: () => table_getAllColumns(table),
+        memoDeps: () => [table.options.columns],
+      },
+      table_getAllFlatColumns: {
+        fn: () => table_getAllFlatColumns(table),
+        memoDeps: () => [table.options.columns],
+      },
+      table_getAllFlatColumnsById: {
+        fn: () => table_getAllFlatColumnsById(table),
+        memoDeps: () => [table.options.columns],
+      },
+      table_getAllLeafColumns: {
+        fn: () => table_getAllLeafColumns(table),
+        memoDeps: () => [
+          table.atoms.columnOrder?.get(),
+          table.atoms.grouping?.get(),
+          table.options.columns,
+          table.options.groupedColumnMode,
+        ],
+      },
+      table_getAllLeafColumnsById: {
+        fn: () => table_getAllLeafColumnsById(table),
+        memoDeps: () => [table.getAllLeafColumns()],
+      },
+      table_getColumn: {
+        fn: (columnId) => table_getColumn(table, columnId),
+      },
+    })
+  },
 }
-
-/**
- * The Core Columns feature provides the core column functionality.
- */
-export const coreColumnsFeature = constructCoreColumnsFeature()

package/src/core/columns/coreColumnsFeature.types.ts

@@ -5,8 +5,8 @@ import type { AccessorFn, ColumnDef } from '../../types/ColumnDef'
 import type { Column } from '../../types/Column'
 
 export interface Column_CoreProperties<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
   TValue extends CellData = CellData,
 > {
   /**
@@ -43,8 +43,8 @@ export interface Column_CoreProperties<
 }
 
 export interface Column_Column<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
   TValue extends CellData = CellData,
 > extends Column_CoreProperties<TFeatures, TData, TValue> {
   /**
@@ -59,8 +59,8 @@ export interface Column_Column<
 }
 
 export interface TableOptions_Columns<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
   TValue extends CellData = CellData,
 > {
   /**
@@ -74,8 +74,8 @@ export interface TableOptions_Columns<
 }
 
 export interface Table_Columns<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
 > {
   /**
    * Returns a map of all flat columns by their ID.

package/src/core/columns/coreColumnsFeature.utils.ts

@@ -1,4 +1,4 @@
-import { callMemoOrStaticFn } from '../../utils'
+import { callMemoOrStaticFn, makeObjectMap } from '../../utils'
 import { table_getOrderColumnsFn } from '../../features/column-ordering/columnOrderingFeature.utils'
 import { constructColumn } from './constructColumn'
 import type { Table_Internal } from '../../types/Table'
@@ -185,7 +185,7 @@ export function table_getAllFlatColumnsById<
 >(
   table: Table_Internal<TFeatures, TData>,
 ): Record<string, Column<TFeatures, TData, unknown>> {
-  const result: Record<string, Column<TFeatures, TData, unknown>> = {}
+  const result = makeObjectMap<Column<TFeatures, TData, unknown>>()
   const flatColumns = table.getAllFlatColumns()
   for (let i = 0; i < flatColumns.length; i++) {
     const column = flatColumns[i]!
@@ -218,7 +218,7 @@ export function table_getAllLeafColumns<
     table,
     'getOrderColumns',
     table_getOrderColumnsFn,
-  )(leafColumns)
+  )(leafColumns) as Array<Column<TFeatures, TData, unknown>>
 }
 
 /**
@@ -238,7 +238,7 @@ export function table_getAllLeafColumnsById<
 >(
   table: Table_Internal<TFeatures, TData>,
 ): Record<string, Column<TFeatures, TData, unknown>> {
-  const result: Record<string, Column<TFeatures, TData, unknown>> = {}
+  const result = makeObjectMap<Column<TFeatures, TData, unknown>>()
   const leafColumns = table.getAllLeafColumns()
   for (let i = 0; i < leafColumns.length; i++) {
     const column = leafColumns[i]!

package/src/core/coreFeatures.ts

@@ -7,7 +7,7 @@ import { coreTablesFeature } from './table/coreTablesFeature'
 import type { TableReactivityBindings } from '../reactivity'
 
 export interface CoreFeatures {
-  coreReativityFeature?: TableReactivityBindings
+  coreReactivityFeature?: TableReactivityBindings
   coreCellsFeature: typeof coreCellsFeature
   coreColumnsFeature: typeof coreColumnsFeature
   coreHeadersFeature: typeof coreHeadersFeature

package/src/core/headers/buildHeaderGroups.ts

@@ -60,7 +60,7 @@ export function buildHeaderGroups<
       depth,
       id: [headerFamily, `${depth}`].filter(Boolean).join('_'),
       headers: [],
-    } as any
+    }
 
     // The parent columns we're going to scan next
     const pendingParentHeaders: Array<Header<TFeatures, TData, TValue>> = []
@@ -113,7 +113,9 @@ export function buildHeaderGroups<
         pendingParentHeaders.push(header)
       }
 
-      headerGroup.headers.push(headerToGroup)
+      headerGroup.headers.push(
+        headerToGroup as Header<TFeatures, TData, unknown>,
+      )
       headerToGroup.headerGroup = headerGroup
     })
 

package/src/core/headers/coreHeadersFeature.ts

@@ -7,72 +7,50 @@ import {
   table_getHeaderGroups,
   table_getLeafHeaders,
 } from './coreHeadersFeature.utils'
-import type { RowData } from '../../types/type-utils'
-import type { TableFeature, TableFeatures } from '../../types/TableFeatures'
-// import type { Header_Header, Table_Headers } from './coreHeadersFeature.types'
-
-export interface CoreHeadersFeatureConstructors<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
-> {
-  // Header: Header_Header<TFeatures, TData>
-  // Table: Table_Headers<TFeatures, TData>
-}
+import type { TableFeature } from '../../types/TableFeatures'
 
 /**
- * Creates the stock core headers feature.
- *
- * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ * Core feature that builds header groups and exposes header context APIs.
  */
-export function constructCoreHeadersFeature<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
->(): TableFeature<CoreHeadersFeatureConstructors<TFeatures, TData>> {
-  return {
-    assignHeaderPrototype: (prototype, table) => {
-      assignPrototypeAPIs('coreHeadersFeature', prototype, table, {
-        header_getLeafHeaders: {
-          fn: (header) => header_getLeafHeaders(header),
-          memoDeps: (header) => [header.column.table.options.columns],
-        },
-        header_getContext: {
-          fn: (header) => header_getContext(header),
-          memoDeps: (header) => [header.column.table.options.columns],
-        },
-      })
-    },
+export const coreHeadersFeature: TableFeature = {
+  assignHeaderPrototype: (prototype, table) => {
+    assignPrototypeAPIs('coreHeadersFeature', prototype, table, {
+      header_getLeafHeaders: {
+        fn: (header) => header_getLeafHeaders(header),
+        memoDeps: (header) => [header.column.table.options.columns],
+      },
+      header_getContext: {
+        fn: (header) => header_getContext(header),
+        memoDeps: (header) => [header.column.table.options.columns],
+      },
+    })
+  },
 
-    constructTableAPIs: (table) => {
-      assignTableAPIs('coreHeadersFeature', table, {
-        table_getHeaderGroups: {
-          fn: () => table_getHeaderGroups(table),
-          memoDeps: () => [
-            table.options.columns,
-            table.atoms.columnOrder?.get(),
-            table.atoms.grouping?.get(),
-            table.atoms.columnPinning?.get(),
-            table.atoms.columnVisibility?.get(),
-            table.options.groupedColumnMode,
-          ],
-        },
-        table_getFooterGroups: {
-          fn: () => table_getFooterGroups(table),
-          memoDeps: () => [table.getHeaderGroups()],
-        },
-        table_getFlatHeaders: {
-          fn: () => table_getFlatHeaders(table),
-          memoDeps: () => [table.getHeaderGroups()],
-        },
-        table_getLeafHeaders: {
-          fn: () => table_getLeafHeaders(table),
-          memoDeps: () => [table.getHeaderGroups()],
-        },
-      })
-    },
-  }
+  constructTableAPIs: (table) => {
+    assignTableAPIs('coreHeadersFeature', table, {
+      table_getHeaderGroups: {
+        fn: () => table_getHeaderGroups(table),
+        memoDeps: () => [
+          table.options.columns,
+          table.atoms.columnOrder?.get(),
+          table.atoms.grouping?.get(),
+          table.atoms.columnPinning?.get(),
+          table.atoms.columnVisibility?.get(),
+          table.options.groupedColumnMode,
+        ],
+      },
+      table_getFooterGroups: {
+        fn: () => table_getFooterGroups(table),
+        memoDeps: () => [table.getHeaderGroups()],
+      },
+      table_getFlatHeaders: {
+        fn: () => table_getFlatHeaders(table),
+        memoDeps: () => [table.getHeaderGroups()],
+      },
+      table_getLeafHeaders: {
+        fn: () => table_getLeafHeaders(table),
+        memoDeps: () => [table.getHeaderGroups()],
+      },
+    })
+  },
 }
-
-/**
- * The Core Headers feature provides the core header functionality.
- */
-export const coreHeadersFeature = constructCoreHeadersFeature()

package/src/core/headers/coreHeadersFeature.types.ts

@@ -1,13 +1,13 @@
 import type { CellData, RowData } from '../../types/type-utils'
 import type { TableFeatures } from '../../types/TableFeatures'
-import type { Table } from '../../types/Table'
+import type { Table, Table_Internal } from '../../types/Table'
 import type { Header } from '../../types/Header'
 import type { HeaderGroup } from '../../types/HeaderGroup'
 import type { Column } from '../../types/Column'
 
 export interface Table_Headers<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
 > {
   /**
    * Builds the visible header groups for the current column tree, visibility,
@@ -30,8 +30,8 @@ export interface Table_Headers<
 }
 
 export interface HeaderContext<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
   TValue extends CellData = CellData,
 > {
   /**
@@ -49,8 +49,8 @@ export interface HeaderContext<
 }
 
 export interface Header_CoreProperties<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
   TValue extends CellData = CellData,
 > {
   /**
@@ -96,12 +96,12 @@ export interface Header_CoreProperties<
   /**
    * Reference to the parent table instance.
    */
-  table: Table<TFeatures, TData>
+  table: Table_Internal<TFeatures, TData>
 }
 
 export interface Header_Header<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
   TValue extends CellData = CellData,
 > extends Header_CoreProperties<TFeatures, TData, TValue> {
   /**
@@ -115,8 +115,8 @@ export interface Header_Header<
 }
 
 export interface HeaderGroup_Header<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
   TValue extends CellData = CellData,
 > {
   depth: number

package/src/core/headers/coreHeadersFeature.utils.ts

@@ -86,7 +86,7 @@ export function table_getHeaderGroups<
     table,
     'getVisibleLeafColumns',
     table_getVisibleLeafColumns,
-  ) as Array<Column<TFeatures, TData, unknown>>
+  )
 
   // Fast path: no columns are pinned — skip per-side lookups, partition, and spread.
   if (!left.length && !right.length) {

package/src/core/row-models/coreRowModelsFeature.ts

@@ -13,71 +13,50 @@ import {
   table_getRowModel,
   table_getSortedRowModel,
 } from './coreRowModelsFeature.utils'
-import type { RowData } from '../../types/type-utils'
-import type { TableFeature, TableFeatures } from '../../types/TableFeatures'
-// import type { Table_RowModels } from './coreRowModelsFeature.types'
-
-export interface CoreRowModelsFeatureConstructors<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
-> {
-  // Table: Table_RowModels<TFeatures, TData>
-}
+import type { TableFeature } from '../../types/TableFeatures'
 
 /**
- * Creates the stock core row models feature.
- *
- * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ * Core feature that wires table row-model accessors and row-model caches.
  */
-export function constructCoreRowModelsFeature<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
->(): TableFeature<CoreRowModelsFeatureConstructors<TFeatures, TData>> {
-  return {
-    constructTableAPIs: (table) => {
-      assignTableAPIs('coreRowModelsFeature', table, {
-        table_getCoreRowModel: {
-          fn: () => table_getCoreRowModel(table),
-        },
-        table_getPreFilteredRowModel: {
-          fn: () => table_getPreFilteredRowModel(table),
-        },
-        table_getFilteredRowModel: {
-          fn: () => table_getFilteredRowModel(table),
-        },
-        table_getPreGroupedRowModel: {
-          fn: () => table_getPreGroupedRowModel(table),
-        },
-        table_getGroupedRowModel: {
-          fn: () => table_getGroupedRowModel(table),
-        },
-        table_getPreSortedRowModel: {
-          fn: () => table_getPreSortedRowModel(table),
-        },
-        table_getSortedRowModel: {
-          fn: () => table_getSortedRowModel(table),
-        },
-        table_getPreExpandedRowModel: {
-          fn: () => table_getPreExpandedRowModel(table),
-        },
-        table_getExpandedRowModel: {
-          fn: () => table_getExpandedRowModel(table),
-        },
-        table_getPrePaginatedRowModel: {
-          fn: () => table_getPrePaginatedRowModel(table),
-        },
-        table_getPaginatedRowModel: {
-          fn: () => table_getPaginatedRowModel(table),
-        },
-        table_getRowModel: {
-          fn: () => table_getRowModel(table),
-        },
-      })
-    },
-  }
+export const coreRowModelsFeature: TableFeature = {
+  constructTableAPIs: (table) => {
+    assignTableAPIs('coreRowModelsFeature', table, {
+      table_getCoreRowModel: {
+        fn: () => table_getCoreRowModel(table),
+      },
+      table_getPreFilteredRowModel: {
+        fn: () => table_getPreFilteredRowModel(table),
+      },
+      table_getFilteredRowModel: {
+        fn: () => table_getFilteredRowModel(table),
+      },
+      table_getPreGroupedRowModel: {
+        fn: () => table_getPreGroupedRowModel(table),
+      },
+      table_getGroupedRowModel: {
+        fn: () => table_getGroupedRowModel(table),
+      },
+      table_getPreSortedRowModel: {
+        fn: () => table_getPreSortedRowModel(table),
+      },
+      table_getSortedRowModel: {
+        fn: () => table_getSortedRowModel(table),
+      },
+      table_getPreExpandedRowModel: {
+        fn: () => table_getPreExpandedRowModel(table),
+      },
+      table_getExpandedRowModel: {
+        fn: () => table_getExpandedRowModel(table),
+      },
+      table_getPrePaginatedRowModel: {
+        fn: () => table_getPrePaginatedRowModel(table),
+      },
+      table_getPaginatedRowModel: {
+        fn: () => table_getPaginatedRowModel(table),
+      },
+      table_getRowModel: {
+        fn: () => table_getRowModel(table),
+      },
+    })
+  },
 }
-
-/**
- * The Core Row Models feature provides the core row model functionality.
- */
-export const coreRowModelsFeature = constructCoreRowModelsFeature()

package/src/core/row-models/coreRowModelsFeature.types.ts

@@ -10,41 +10,24 @@ import type { TableFeatures } from '../../types/TableFeatures'
 import type { RowData } from '../../types/type-utils'
 
 export interface RowModel<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
 > {
   rows: Array<Row<TFeatures, TData>>
   flatRows: Array<Row<TFeatures, TData>>
   rowsById: Record<string, Row<TFeatures, TData>>
 }
 
-export interface CreateRowModel_Plugins {}
-
-export interface CreateRowModel_Core<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
-> extends CreateRowModel_Plugins {
-  /**
-   * Optional factory for the core row model. When omitted, the built-in
-   * `createCoreRowModel()` factory is used.
-   */
-  coreRowModel?: (
-    table: Table<TFeatures, TData>,
-  ) => () => RowModel<TFeatures, TData>
-}
-
-export interface CachedRowModel_Plugins {}
-
 export interface CachedRowModel_Core<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
-> extends CachedRowModel_Plugins {
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
+> {
   coreRowModel: () => RowModel<TFeatures, TData>
 }
 
 export interface Table_RowModels_Core<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
+  in out TFeatures extends TableFeatures,
+  in out TData extends RowData,
 > {
   /**
    * Returns the core row model before any processing has been applied.