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

package/dist/types/TableFeatures.d.cts

@@ -1,22 +1,46 @@
 import { CellData, RowData, UnionToIntersection } from "./type-utils.cjs";
 import { CoreFeatures } from "../core/coreFeatures.cjs";
-import { SortFn } from "../features/row-sorting/rowSortingFeature.types.cjs";
 import { Row } from "./Row.cjs";
 import { FilterFn } from "../features/column-filtering/columnFilteringFeature.types.cjs";
+import { SortFn } from "../features/row-sorting/rowSortingFeature.types.cjs";
 import { TableState_All } from "./TableState.cjs";
+import { ColumnDefBase_All } from "./ColumnDef.cjs";
 import { TableOptions_All } from "./TableOptions.cjs";
 import { Table } from "./Table.cjs";
-import { ColumnDefBase_All } from "./ColumnDef.cjs";
+import { Column } from "./Column.cjs";
 import { StockFeatures } from "../features/stockFeatures.cjs";
 import { RowModel } from "../core/row-models/coreRowModelsFeature.types.cjs";
 import { AggregationFn } from "../features/column-grouping/columnGroupingFeature.types.cjs";
 
 //#region src/types/TableFeatures.d.ts
+/**
+ * Detects whether a type is `any`.
+ *
+ * Several feature-map helpers need a separate `any` path so broad generic
+ * usage still exposes all known feature APIs instead of narrowing to no keys.
+ */
 type IsAny<T> = 0 extends 1 & T ? true : false;
+/**
+ * Converts a union to an intersection, returning `{}` for `never`.
+ *
+ * This keeps empty feature-map lookups usable as an intersection member.
+ */
 type UnionToIntersectionOrEmpty<T> = [T] extends [never] ? {} : UnionToIntersection<T> & {};
+/**
+ * Extracts the API/types contributed by the features present in `TFeatures`.
+ *
+ * `TFeatureMap` maps feature keys to the types they contribute. When
+ * `TFeatures` is `any`, all feature-map entries are included to preserve the
+ * permissive behavior expected by broad table types. Otherwise, only entries
+ * whose keys are present in `TFeatures` are intersected together.
+ */
 type ExtractFeatureMapTypes<TFeatures extends TableFeatures, TFeatureMap extends object> = IsAny<TFeatures> extends true ? UnionToIntersection<TFeatureMap[keyof TFeatureMap]> : UnionToIntersectionOrEmpty<TFeatureMap[Extract<keyof TFeatures, keyof TFeatureMap>]>;
 /**
- * This is an interface that you can delcaration-merge into to allow for custom plugins to be added to the table.
+ * Declaration-merge target for custom table features.
+ *
+ * Add custom feature keys here so `TableFeatures` can accept them in the
+ * `features` option and use the same feature-map extraction system as built-in
+ * features.
  */
 interface Plugins {}
 /**
@@ -36,19 +60,61 @@ type NonFeatureKeys = 'aggregationFns' | 'columnMeta' | 'coreRowModel' | 'expand
  * interface to get the same validation from `tableFeatures()`.
  */
 interface FeatureSlotPrereqs {
+  /**
+   * Named aggregation functions are only meaningful when grouping is enabled.
+   */
   aggregationFns: 'columnGroupingFeature';
+  /**
+   * Column resizing builds on the column sizing state and APIs.
+   */
   columnResizingFeature: 'columnSizingFeature';
+  /**
+   * Expanded row-model factories require row expanding APIs and state.
+   */
   expandedRowModel: 'rowExpandingFeature';
+  /**
+   * Faceted min/max factories require column faceting APIs.
+   */
   facetedMinMaxValues: 'columnFacetingFeature';
+  /**
+   * Faceted row-model factories require column faceting APIs.
+   */
   facetedRowModel: 'columnFacetingFeature';
+  /**
+   * Faceted unique-value factories require column faceting APIs.
+   */
   facetedUniqueValues: 'columnFacetingFeature';
+  /**
+   * Filtered row-model factories require column filtering APIs and state.
+   */
   filteredRowModel: 'columnFilteringFeature';
+  /**
+   * Named filter functions are only meaningful when column filtering is enabled.
+   */
   filterFns: 'columnFilteringFeature';
+  /**
+   * Filter metadata types are only read and written by filtering features.
+   */
   filterMeta: 'columnFilteringFeature';
+  /**
+   * Global filtering builds on column filtering state and filter functions.
+   */
   globalFilteringFeature: 'columnFilteringFeature';
+  /**
+   * Grouped row-model factories require column grouping APIs and state.
+   */
   groupedRowModel: 'columnGroupingFeature';
+  /**
+   * Paginated row-model factories require row pagination APIs and state.
+   */
   paginatedRowModel: 'rowPaginationFeature';
+  /**
+   * Sorted row-model factories require row sorting APIs and state.
+   */
   sortedRowModel: 'rowSortingFeature';
+  /**
+   * Named sorting functions are only meaningful when row sorting is enabled.
+   */
   sortFns: 'rowSortingFeature';
 }
 /**
@@ -60,6 +126,15 @@ interface FeatureSlotPrereqs {
  * naming the feature that needs to be added.
  */
 type ValidateFeatureSlots<TFeatures extends TableFeatures> = IsAny<TFeatures> extends true ? {} : { [K in keyof TFeatures as K extends keyof FeatureSlotPrereqs ? K : never]: K extends keyof FeatureSlotPrereqs ? [Extract<FeatureSlotPrereqs[K], keyof TFeatures>] extends [never] ? `Error: '${K & string}' requires '${FeatureSlotPrereqs[K] & string}' to be included in this table's features.` : TFeatures[K] : never };
+/**
+ * Complete feature registry for a table.
+ *
+ * This type combines core features, stock features, declaration-merged custom
+ * plugins, row-model factory slots, function registries, and type-only meta
+ * slots. The concrete `features` object passed to `tableFeatures()` determines
+ * which feature APIs are included throughout table, row, column, cell, header,
+ * options, and state types.
+ */
 interface TableFeatures extends Partial<CoreFeatures>, Partial<StockFeatures>, Partial<Plugins> {
   /**
    * Registry of aggregation functions available to this table by name.
@@ -174,38 +249,102 @@ interface TableFeatures extends Partial<CoreFeatures>, Partial<StockFeatures>, P
    */
   tableMeta?: object;
 }
+/**
+ * Lifecycle hooks and defaults contributed by a table feature.
+ *
+ * Feature objects are registered in the table's `features` option. They can
+ * contribute default state/options, default column definitions, table APIs,
+ * shared prototype APIs for rows/columns/headers/cells, and per-instance row
+ * or column data.
+ */
 interface TableFeature {
   /**
-   * Assigns Cell APIs to the cell prototype for memory-efficient method sharing.
-   * This is called once per table to build a shared prototype for all cells.
+   * Adds feature methods to the shared cell prototype for a table.
+   *
+   * This runs lazily the first time a cell is constructed for a table. Methods
+   * assigned here are shared by every cell instance created by that table, so
+   * this hook should be used for APIs and memoized methods rather than
+   * per-cell mutable data.
    */
   assignCellPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table<TFeatures, TData>) => void;
   /**
-   * Assigns Column APIs to the column prototype for memory-efficient method sharing.
-   * This is called once per table to build a shared prototype for all columns.
+   * Adds feature methods to the shared column prototype for a table.
+   *
+   * This runs lazily the first time a column is constructed for a table.
+   * Methods assigned here are shared by every column instance created by that
+   * table, so this hook should be used for APIs and memoized methods rather
+   * than per-column mutable data.
    */
   assignColumnPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table<TFeatures, TData>) => void;
   /**
-   * Assigns Header APIs to the header prototype for memory-efficient method sharing.
-   * This is called once per table to build a shared prototype for all headers.
+   * Adds feature methods to the shared header prototype for a table.
+   *
+   * This runs lazily the first time a header is constructed for a table.
+   * Methods assigned here are shared by every header instance created by that
+   * table, so this hook should be used for APIs and memoized methods rather
+   * than per-header mutable data.
    */
   assignHeaderPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table<TFeatures, TData>) => void;
   /**
-   * Assigns Row APIs to the row prototype for memory-efficient method sharing.
-   * This is called once per table to build a shared prototype for all rows.
+   * Adds feature methods to the shared row prototype for a table.
+   *
+   * This runs lazily the first time a row is constructed for a table. Methods
+   * assigned here are shared by every row instance created by that table, so
+   * this hook should be used for APIs and memoized methods rather than per-row
+   * mutable data.
    */
   assignRowPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table<TFeatures, TData>) => void;
   /**
-   * Assigns Table APIs to the table instance.
-   * Unlike row/cell/column/header, the table is a singleton so methods are assigned directly.
+   * Adds feature APIs directly to the table instance.
+   *
+   * The table is a singleton, unlike rows, columns, headers, and cells, so
+   * table APIs are assigned directly instead of through a shared prototype.
+   * This runs while the table is being constructed, after options and initial
+   * state have been resolved.
    */
   constructTableAPIs?: <TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>) => void;
+  /**
+   * Returns default column definition options contributed by this feature.
+   *
+   * These defaults are merged into the table's default column definition before
+   * `options.defaultColumn` and before each user-supplied column definition is
+   * resolved, so users can override values supplied here.
+   */
   getDefaultColumnDef?: <TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>() => ColumnDefBase_All<TFeatures, TData, TValue>;
+  /**
+   * Returns default table options contributed by this feature.
+   *
+   * This runs while table options are being resolved. Use it for option
+   * defaults such as feature enablement flags and default state-updater
+   * callbacks. User-supplied table options take precedence over values returned
+   * here.
+   */
   getDefaultTableOptions?: <TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>) => Partial<TableOptions_All<TFeatures, TData>>;
+  /**
+   * Returns this feature's initial table state.
+   *
+   * The incoming `initialState` contains state accumulated from earlier
+   * features and user-provided initial state. Return a complete state object
+   * for this feature, preserving `initialState` so user-provided values can
+   * override feature defaults.
+   */
   getInitialState?: (initialState: Partial<TableState_All>) => TableState_All;
   /**
-   * Initializes instance-specific data on each row (e.g., caches).
-   * Methods should be assigned via assignRowPrototype instead.
+   * Initializes instance-specific data on each column.
+   *
+   * This runs for every constructed column after core column fields such as
+   * `id`, `depth`, `parent`, `columnDef`, and `columns` have been assigned.
+   * Use this for per-column mutable data, caches, or annotations. Shared
+   * methods should be assigned via `assignColumnPrototype` instead.
+   */
+  initColumnInstanceData?: <TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>) => void;
+  /**
+   * Initializes instance-specific data on each row.
+   *
+   * This runs for every constructed row after core row fields such as `id`,
+   * `index`, `depth`, `original`, `parentId`, and `subRows` have been assigned.
+   * Use this for per-row mutable data, caches, or annotations. Shared methods
+   * should be assigned via `assignRowPrototype` instead.
    */
   initRowInstanceData?: <TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>) => void;
 }

package/dist/types/TableFeatures.d.ts

@@ -1,22 +1,46 @@
 import { CellData, RowData, UnionToIntersection } from "./type-utils.js";
 import { CoreFeatures } from "../core/coreFeatures.js";
-import { SortFn } from "../features/row-sorting/rowSortingFeature.types.js";
 import { Row } from "./Row.js";
 import { FilterFn } from "../features/column-filtering/columnFilteringFeature.types.js";
+import { SortFn } from "../features/row-sorting/rowSortingFeature.types.js";
 import { TableState_All } from "./TableState.js";
+import { ColumnDefBase_All } from "./ColumnDef.js";
 import { TableOptions_All } from "./TableOptions.js";
 import { Table } from "./Table.js";
-import { ColumnDefBase_All } from "./ColumnDef.js";
+import { Column } from "./Column.js";
 import { StockFeatures } from "../features/stockFeatures.js";
 import { RowModel } from "../core/row-models/coreRowModelsFeature.types.js";
 import { AggregationFn } from "../features/column-grouping/columnGroupingFeature.types.js";
 
 //#region src/types/TableFeatures.d.ts
+/**
+ * Detects whether a type is `any`.
+ *
+ * Several feature-map helpers need a separate `any` path so broad generic
+ * usage still exposes all known feature APIs instead of narrowing to no keys.
+ */
 type IsAny<T> = 0 extends 1 & T ? true : false;
+/**
+ * Converts a union to an intersection, returning `{}` for `never`.
+ *
+ * This keeps empty feature-map lookups usable as an intersection member.
+ */
 type UnionToIntersectionOrEmpty<T> = [T] extends [never] ? {} : UnionToIntersection<T> & {};
+/**
+ * Extracts the API/types contributed by the features present in `TFeatures`.
+ *
+ * `TFeatureMap` maps feature keys to the types they contribute. When
+ * `TFeatures` is `any`, all feature-map entries are included to preserve the
+ * permissive behavior expected by broad table types. Otherwise, only entries
+ * whose keys are present in `TFeatures` are intersected together.
+ */
 type ExtractFeatureMapTypes<TFeatures extends TableFeatures, TFeatureMap extends object> = IsAny<TFeatures> extends true ? UnionToIntersection<TFeatureMap[keyof TFeatureMap]> : UnionToIntersectionOrEmpty<TFeatureMap[Extract<keyof TFeatures, keyof TFeatureMap>]>;
 /**
- * This is an interface that you can delcaration-merge into to allow for custom plugins to be added to the table.
+ * Declaration-merge target for custom table features.
+ *
+ * Add custom feature keys here so `TableFeatures` can accept them in the
+ * `features` option and use the same feature-map extraction system as built-in
+ * features.
  */
 interface Plugins {}
 /**
@@ -36,19 +60,61 @@ type NonFeatureKeys = 'aggregationFns' | 'columnMeta' | 'coreRowModel' | 'expand
  * interface to get the same validation from `tableFeatures()`.
  */
 interface FeatureSlotPrereqs {
+  /**
+   * Named aggregation functions are only meaningful when grouping is enabled.
+   */
   aggregationFns: 'columnGroupingFeature';
+  /**
+   * Column resizing builds on the column sizing state and APIs.
+   */
   columnResizingFeature: 'columnSizingFeature';
+  /**
+   * Expanded row-model factories require row expanding APIs and state.
+   */
   expandedRowModel: 'rowExpandingFeature';
+  /**
+   * Faceted min/max factories require column faceting APIs.
+   */
   facetedMinMaxValues: 'columnFacetingFeature';
+  /**
+   * Faceted row-model factories require column faceting APIs.
+   */
   facetedRowModel: 'columnFacetingFeature';
+  /**
+   * Faceted unique-value factories require column faceting APIs.
+   */
   facetedUniqueValues: 'columnFacetingFeature';
+  /**
+   * Filtered row-model factories require column filtering APIs and state.
+   */
   filteredRowModel: 'columnFilteringFeature';
+  /**
+   * Named filter functions are only meaningful when column filtering is enabled.
+   */
   filterFns: 'columnFilteringFeature';
+  /**
+   * Filter metadata types are only read and written by filtering features.
+   */
   filterMeta: 'columnFilteringFeature';
+  /**
+   * Global filtering builds on column filtering state and filter functions.
+   */
   globalFilteringFeature: 'columnFilteringFeature';
+  /**
+   * Grouped row-model factories require column grouping APIs and state.
+   */
   groupedRowModel: 'columnGroupingFeature';
+  /**
+   * Paginated row-model factories require row pagination APIs and state.
+   */
   paginatedRowModel: 'rowPaginationFeature';
+  /**
+   * Sorted row-model factories require row sorting APIs and state.
+   */
   sortedRowModel: 'rowSortingFeature';
+  /**
+   * Named sorting functions are only meaningful when row sorting is enabled.
+   */
   sortFns: 'rowSortingFeature';
 }
 /**
@@ -60,6 +126,15 @@ interface FeatureSlotPrereqs {
  * naming the feature that needs to be added.
  */
 type ValidateFeatureSlots<TFeatures extends TableFeatures> = IsAny<TFeatures> extends true ? {} : { [K in keyof TFeatures as K extends keyof FeatureSlotPrereqs ? K : never]: K extends keyof FeatureSlotPrereqs ? [Extract<FeatureSlotPrereqs[K], keyof TFeatures>] extends [never] ? `Error: '${K & string}' requires '${FeatureSlotPrereqs[K] & string}' to be included in this table's features.` : TFeatures[K] : never };
+/**
+ * Complete feature registry for a table.
+ *
+ * This type combines core features, stock features, declaration-merged custom
+ * plugins, row-model factory slots, function registries, and type-only meta
+ * slots. The concrete `features` object passed to `tableFeatures()` determines
+ * which feature APIs are included throughout table, row, column, cell, header,
+ * options, and state types.
+ */
 interface TableFeatures extends Partial<CoreFeatures>, Partial<StockFeatures>, Partial<Plugins> {
   /**
    * Registry of aggregation functions available to this table by name.
@@ -174,38 +249,102 @@ interface TableFeatures extends Partial<CoreFeatures>, Partial<StockFeatures>, P
    */
   tableMeta?: object;
 }
+/**
+ * Lifecycle hooks and defaults contributed by a table feature.
+ *
+ * Feature objects are registered in the table's `features` option. They can
+ * contribute default state/options, default column definitions, table APIs,
+ * shared prototype APIs for rows/columns/headers/cells, and per-instance row
+ * or column data.
+ */
 interface TableFeature {
   /**
-   * Assigns Cell APIs to the cell prototype for memory-efficient method sharing.
-   * This is called once per table to build a shared prototype for all cells.
+   * Adds feature methods to the shared cell prototype for a table.
+   *
+   * This runs lazily the first time a cell is constructed for a table. Methods
+   * assigned here are shared by every cell instance created by that table, so
+   * this hook should be used for APIs and memoized methods rather than
+   * per-cell mutable data.
    */
   assignCellPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table<TFeatures, TData>) => void;
   /**
-   * Assigns Column APIs to the column prototype for memory-efficient method sharing.
-   * This is called once per table to build a shared prototype for all columns.
+   * Adds feature methods to the shared column prototype for a table.
+   *
+   * This runs lazily the first time a column is constructed for a table.
+   * Methods assigned here are shared by every column instance created by that
+   * table, so this hook should be used for APIs and memoized methods rather
+   * than per-column mutable data.
    */
   assignColumnPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table<TFeatures, TData>) => void;
   /**
-   * Assigns Header APIs to the header prototype for memory-efficient method sharing.
-   * This is called once per table to build a shared prototype for all headers.
+   * Adds feature methods to the shared header prototype for a table.
+   *
+   * This runs lazily the first time a header is constructed for a table.
+   * Methods assigned here are shared by every header instance created by that
+   * table, so this hook should be used for APIs and memoized methods rather
+   * than per-header mutable data.
    */
   assignHeaderPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table<TFeatures, TData>) => void;
   /**
-   * Assigns Row APIs to the row prototype for memory-efficient method sharing.
-   * This is called once per table to build a shared prototype for all rows.
+   * Adds feature methods to the shared row prototype for a table.
+   *
+   * This runs lazily the first time a row is constructed for a table. Methods
+   * assigned here are shared by every row instance created by that table, so
+   * this hook should be used for APIs and memoized methods rather than per-row
+   * mutable data.
    */
   assignRowPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table<TFeatures, TData>) => void;
   /**
-   * Assigns Table APIs to the table instance.
-   * Unlike row/cell/column/header, the table is a singleton so methods are assigned directly.
+   * Adds feature APIs directly to the table instance.
+   *
+   * The table is a singleton, unlike rows, columns, headers, and cells, so
+   * table APIs are assigned directly instead of through a shared prototype.
+   * This runs while the table is being constructed, after options and initial
+   * state have been resolved.
    */
   constructTableAPIs?: <TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>) => void;
+  /**
+   * Returns default column definition options contributed by this feature.
+   *
+   * These defaults are merged into the table's default column definition before
+   * `options.defaultColumn` and before each user-supplied column definition is
+   * resolved, so users can override values supplied here.
+   */
   getDefaultColumnDef?: <TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>() => ColumnDefBase_All<TFeatures, TData, TValue>;
+  /**
+   * Returns default table options contributed by this feature.
+   *
+   * This runs while table options are being resolved. Use it for option
+   * defaults such as feature enablement flags and default state-updater
+   * callbacks. User-supplied table options take precedence over values returned
+   * here.
+   */
   getDefaultTableOptions?: <TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>) => Partial<TableOptions_All<TFeatures, TData>>;
+  /**
+   * Returns this feature's initial table state.
+   *
+   * The incoming `initialState` contains state accumulated from earlier
+   * features and user-provided initial state. Return a complete state object
+   * for this feature, preserving `initialState` so user-provided values can
+   * override feature defaults.
+   */
   getInitialState?: (initialState: Partial<TableState_All>) => TableState_All;
   /**
-   * Initializes instance-specific data on each row (e.g., caches).
-   * Methods should be assigned via assignRowPrototype instead.
+   * Initializes instance-specific data on each column.
+   *
+   * This runs for every constructed column after core column fields such as
+   * `id`, `depth`, `parent`, `columnDef`, and `columns` have been assigned.
+   * Use this for per-column mutable data, caches, or annotations. Shared
+   * methods should be assigned via `assignColumnPrototype` instead.
+   */
+  initColumnInstanceData?: <TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>) => void;
+  /**
+   * Initializes instance-specific data on each row.
+   *
+   * This runs for every constructed row after core row fields such as `id`,
+   * `index`, `depth`, `original`, `parentId`, and `subRows` have been assigned.
+   * Use this for per-row mutable data, caches, or annotations. Shared methods
+   * should be assigned via `assignRowPrototype` instead.
    */
   initRowInstanceData?: <TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>) => void;
 }

package/dist/types/TableOptions.d.cts

@@ -1,21 +1,21 @@
 import { RowData, UnionToIntersection } from "./type-utils.cjs";
 import { CoreFeatures } from "../core/coreFeatures.cjs";
 import { TableOptions_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.cjs";
-import { TableOptions_RowSorting } from "../features/row-sorting/rowSortingFeature.types.cjs";
+import { TableOptions_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.cjs";
 import { TableOptions_ColumnSizing } from "../features/column-sizing/columnSizingFeature.types.cjs";
 import { TableOptions_ColumnPinning } from "../features/column-pinning/columnPinningFeature.types.cjs";
-import { TableOptions_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.cjs";
-import { TableOptions_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.cjs";
-import { TableOptions_Columns } from "../core/columns/coreColumnsFeature.types.cjs";
-import { TableOptions_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.cjs";
 import { TableOptions_RowExpanding } from "../features/row-expanding/rowExpandingFeature.types.cjs";
 import { TableOptions_RowPinning } from "../features/row-pinning/rowPinningFeature.types.cjs";
 import { TableOptions_RowSelection } from "../features/row-selection/rowSelectionFeature.types.cjs";
 import { TableOptions_Rows } from "../core/rows/coreRowsFeature.types.cjs";
 import { TableOptions_ColumnFiltering } from "../features/column-filtering/columnFilteringFeature.types.cjs";
+import { TableOptions_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.cjs";
+import { TableOptions_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.cjs";
 import { TableOptions_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.cjs";
-import { TableOptions_Table } from "../core/table/coreTablesFeature.types.cjs";
+import { TableOptions_RowSorting } from "../features/row-sorting/rowSortingFeature.types.cjs";
 import { TableOptions_Cell } from "../core/cells/coreCellsFeature.types.cjs";
+import { TableOptions_Columns } from "../core/columns/coreColumnsFeature.types.cjs";
+import { TableOptions_Table } from "../core/table/coreTablesFeature.types.cjs";
 import { ExtractFeatureMapTypes, NonFeatureKeys, TableFeatures } from "./TableFeatures.cjs";
 import { TableOptions_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.cjs";
 

package/dist/types/TableOptions.d.ts

@@ -1,21 +1,21 @@
 import { RowData, UnionToIntersection } from "./type-utils.js";
 import { CoreFeatures } from "../core/coreFeatures.js";
 import { TableOptions_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.js";
-import { TableOptions_RowSorting } from "../features/row-sorting/rowSortingFeature.types.js";
+import { TableOptions_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.js";
 import { TableOptions_ColumnSizing } from "../features/column-sizing/columnSizingFeature.types.js";
 import { TableOptions_ColumnPinning } from "../features/column-pinning/columnPinningFeature.types.js";
-import { TableOptions_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.js";
-import { TableOptions_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.js";
-import { TableOptions_Columns } from "../core/columns/coreColumnsFeature.types.js";
-import { TableOptions_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.js";
 import { TableOptions_RowExpanding } from "../features/row-expanding/rowExpandingFeature.types.js";
 import { TableOptions_RowPinning } from "../features/row-pinning/rowPinningFeature.types.js";
 import { TableOptions_RowSelection } from "../features/row-selection/rowSelectionFeature.types.js";
 import { TableOptions_Rows } from "../core/rows/coreRowsFeature.types.js";
 import { TableOptions_ColumnFiltering } from "../features/column-filtering/columnFilteringFeature.types.js";
+import { TableOptions_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.js";
+import { TableOptions_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.js";
 import { TableOptions_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.js";
-import { TableOptions_Table } from "../core/table/coreTablesFeature.types.js";
+import { TableOptions_RowSorting } from "../features/row-sorting/rowSortingFeature.types.js";
 import { TableOptions_Cell } from "../core/cells/coreCellsFeature.types.js";
+import { TableOptions_Columns } from "../core/columns/coreColumnsFeature.types.js";
+import { TableOptions_Table } from "../core/table/coreTablesFeature.types.js";
 import { ExtractFeatureMapTypes, NonFeatureKeys, TableFeatures } from "./TableFeatures.js";
 import { TableOptions_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.js";
 

package/dist/types/TableState.d.cts

@@ -1,15 +1,15 @@
 import { TableState_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.cjs";
-import { TableState_RowSorting } from "../features/row-sorting/rowSortingFeature.types.cjs";
+import { TableState_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.cjs";
 import { TableState_ColumnSizing } from "../features/column-sizing/columnSizingFeature.types.cjs";
 import { TableState_ColumnPinning } from "../features/column-pinning/columnPinningFeature.types.cjs";
-import { TableState_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.cjs";
-import { TableState_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.cjs";
-import { TableState_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.cjs";
 import { TableState_RowExpanding } from "../features/row-expanding/rowExpandingFeature.types.cjs";
 import { TableState_RowPinning } from "../features/row-pinning/rowPinningFeature.types.cjs";
 import { TableState_RowSelection } from "../features/row-selection/rowSelectionFeature.types.cjs";
 import { TableState_ColumnFiltering } from "../features/column-filtering/columnFilteringFeature.types.cjs";
+import { TableState_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.cjs";
+import { TableState_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.cjs";
 import { TableState_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.cjs";
+import { TableState_RowSorting } from "../features/row-sorting/rowSortingFeature.types.cjs";
 import { ExtractFeatureMapTypes, TableFeatures } from "./TableFeatures.cjs";
 import { TableState_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.cjs";
 

package/dist/types/TableState.d.ts

@@ -1,15 +1,15 @@
 import { TableState_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.js";
-import { TableState_RowSorting } from "../features/row-sorting/rowSortingFeature.types.js";
+import { TableState_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.js";
 import { TableState_ColumnSizing } from "../features/column-sizing/columnSizingFeature.types.js";
 import { TableState_ColumnPinning } from "../features/column-pinning/columnPinningFeature.types.js";
-import { TableState_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.js";
-import { TableState_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.js";
-import { TableState_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.js";
 import { TableState_RowExpanding } from "../features/row-expanding/rowExpandingFeature.types.js";
 import { TableState_RowPinning } from "../features/row-pinning/rowPinningFeature.types.js";
 import { TableState_RowSelection } from "../features/row-selection/rowSelectionFeature.types.js";
 import { TableState_ColumnFiltering } from "../features/column-filtering/columnFilteringFeature.types.js";
+import { TableState_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.js";
+import { TableState_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.js";
 import { TableState_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.js";
+import { TableState_RowSorting } from "../features/row-sorting/rowSortingFeature.types.js";
 import { ExtractFeatureMapTypes, TableFeatures } from "./TableFeatures.js";
 import { TableState_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/table-core",
-  "version": "9.0.0-beta.19",
+  "version": "9.0.0-beta.20",
   "description": "Headless UI for building powerful tables & datagrids for TS/JS.",
   "author": "Tanner Linsley",
   "license": "MIT",

package/src/core/columns/constructColumn.ts

@@ -115,5 +115,11 @@ export function constructColumn<
   column.id = `${String(id)}`
   column.parent = parent
 
+  // Initialize instance-specific data for features that need it
+  const features = Object.values(table._features)
+  for (let i = 0; i < features.length; i++) {
+    features[i]!.initColumnInstanceData?.(column)
+  }
+
   return column as Column<TFeatures, TData, TValue>
 }