@tanstack/table-core 9.0.0-alpha.8 → 9.0.0-beta.10

package/src/types/RowModel.ts

@@ -0,0 +1,47 @@
+import type { CachedRowModel_Faceted } from '../features/column-faceting/columnFacetingFeature.types'
+import type { CachedRowModel_Grouped } from '../features/column-grouping/columnGroupingFeature.types'
+import type { CachedRowModel_Filtered } from '../features/column-filtering/columnFilteringFeature.types'
+import type {
+  CachedRowModel_Core,
+  RowModel,
+} from '../core/row-models/coreRowModelsFeature.types'
+import type { CachedRowModel_Expanded } from '../features/row-expanding/rowExpandingFeature.types'
+import type { CachedRowModel_Paginated } from '../features/row-pagination/rowPaginationFeature.types'
+import type { CachedRowModel_Sorted } from '../features/row-sorting/rowSortingFeature.types'
+import type { RowData } from './type-utils'
+import type { ExtractFeatureMapTypes, TableFeatures } from './TableFeatures'
+
+export interface CachedRowModels_FeatureMap<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> {
+  columnFacetingFeature: CachedRowModel_Faceted<TFeatures, TData>
+  columnFilteringFeature: CachedRowModel_Filtered<TFeatures, TData>
+  rowExpandingFeature: CachedRowModel_Expanded<TFeatures, TData>
+  columnGroupingFeature: CachedRowModel_Grouped<TFeatures, TData>
+  rowPaginationFeature: CachedRowModel_Paginated<TFeatures, TData>
+  rowSortingFeature: CachedRowModel_Sorted<TFeatures, TData>
+}
+
+export type CachedRowModels<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> = {
+  CachedRowModel_Core: () => RowModel<TFeatures, TData>
+} & ExtractFeatureMapTypes<
+  TFeatures,
+  CachedRowModels_FeatureMap<TFeatures, TData>
+>
+
+export type CachedRowModel_All<
+  TFeatures extends TableFeatures,
+  TData extends RowData = any,
+> = Partial<
+  CachedRowModel_Core<TFeatures, TData> &
+    CachedRowModel_Expanded<TFeatures, TData> &
+    CachedRowModel_Faceted<TFeatures, TData> &
+    CachedRowModel_Filtered<TFeatures, TData> &
+    CachedRowModel_Grouped<TFeatures, TData> &
+    CachedRowModel_Paginated<TFeatures, TData> &
+    CachedRowModel_Sorted<TFeatures, TData>
+>

package/src/types/RowModelFns.ts

@@ -0,0 +1,32 @@
+import type { RowModelFns_RowSorting } from '../features/row-sorting/rowSortingFeature.types'
+import type { RowModelFns_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
+import type { RowData } from './type-utils'
+import type { RowModelFns_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
+import type { ExtractFeatureMapTypes, TableFeatures } from './TableFeatures'
+
+export interface RowModelFns_Core {}
+
+export interface RowModelFns_FeatureMap<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> {
+  columnFilteringFeature: RowModelFns_ColumnFiltering<TFeatures, TData>
+  columnGroupingFeature: RowModelFns_ColumnGrouping<TFeatures, TData>
+  rowSortingFeature: RowModelFns_RowSorting<TFeatures, TData>
+}
+
+export type RowModelFns<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> = Partial<
+  ExtractFeatureMapTypes<TFeatures, RowModelFns_FeatureMap<TFeatures, TData>>
+>
+
+export type RowModelFns_All<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> = Partial<
+  RowModelFns_ColumnFiltering<TFeatures, TData> &
+    RowModelFns_ColumnGrouping<TFeatures, TData> &
+    RowModelFns_RowSorting<TFeatures, TData>
+>

package/src/types/Table.ts

@@ -0,0 +1,90 @@
+import type { ReadonlyStore } from '@tanstack/store'
+import type { Table_ColumnFaceting } from '../features/column-faceting/columnFacetingFeature.types'
+import type { Table_ColumnResizing } from '../features/column-resizing/columnResizingFeature.types'
+import type { Table_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
+import type { Table_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
+import type { Table_ColumnPinning } from '../features/column-pinning/columnPinningFeature.types'
+import type { Table_ColumnOrdering } from '../features/column-ordering/columnOrderingFeature.types'
+import type { Table_ColumnVisibility } from '../features/column-visibility/columnVisibilityFeature.types'
+import type { Table_ColumnSizing } from '../features/column-sizing/columnSizingFeature.types'
+import type { Table_RowPinning } from '../features/row-pinning/rowPinningFeature.types'
+import type { Table_GlobalFiltering } from '../features/global-filtering/globalFilteringFeature.types'
+import type { Table_RowExpanding } from '../features/row-expanding/rowExpandingFeature.types'
+import type { Table_RowPagination } from '../features/row-pagination/rowPaginationFeature.types'
+import type { Table_RowSelection } from '../features/row-selection/rowSelectionFeature.types'
+import type { Table_RowSorting } from '../features/row-sorting/rowSortingFeature.types'
+import type { Table_RowModels } from '../core/row-models/coreRowModelsFeature.types'
+import type { CachedRowModel_All } from './RowModel'
+import type { RowModelFns_All } from './RowModelFns'
+import type { TableState_All } from './TableState'
+import type { RowData } from './type-utils'
+import type { ExtractFeatureMapTypes, TableFeatures } from './TableFeatures'
+import type { Table_Columns } from '../core/columns/coreColumnsFeature.types'
+import type { Table_Headers } from '../core/headers/coreHeadersFeature.types'
+import type { Table_Rows } from '../core/rows/coreRowsFeature.types'
+import type {
+  Atoms_All,
+  BaseAtoms_All,
+  ExternalAtoms_All,
+  Table_Table,
+} from '../core/table/coreTablesFeature.types'
+import type { TableOptions_All } from './TableOptions'
+
+/**
+ * The core table object that only includes the core table functionality such as column, header, row, and table APIS.
+ * No features are included.
+ */
+export type Table_Core<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> = Table_Table<TFeatures, TData> &
+  Table_Columns<TFeatures, TData> &
+  Table_Rows<TFeatures, TData> &
+  Table_RowModels<TFeatures, TData> &
+  Table_Headers<TFeatures, TData>
+
+export interface Table_FeatureMap<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> {
+  columnFilteringFeature: Table_ColumnFiltering
+  columnGroupingFeature: Table_ColumnGrouping<TFeatures, TData>
+  columnOrderingFeature: Table_ColumnOrdering<TFeatures, TData>
+  columnPinningFeature: Table_ColumnPinning<TFeatures, TData>
+  columnResizingFeature: Table_ColumnResizing
+  columnSizingFeature: Table_ColumnSizing
+  columnVisibilityFeature: Table_ColumnVisibility<TFeatures, TData>
+  columnFacetingFeature: Table_ColumnFaceting<TFeatures, TData>
+  globalFilteringFeature: Table_GlobalFiltering<TFeatures, TData>
+  rowExpandingFeature: Table_RowExpanding<TFeatures, TData>
+  rowPaginationFeature: Table_RowPagination<TFeatures, TData>
+  rowPinningFeature: Table_RowPinning<TFeatures, TData>
+  rowSelectionFeature: Table_RowSelection<TFeatures, TData>
+  rowSortingFeature: Table_RowSorting<TFeatures, TData>
+}
+
+/**
+ * The table object that includes both the core table functionality and the features that are enabled via the `features` table option.
+ */
+export type Table<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> = Table_Core<TFeatures, TData> &
+  ExtractFeatureMapTypes<TFeatures, Table_FeatureMap<TFeatures, TData>>
+
+export type Table_Internal<
+  TFeatures extends TableFeatures,
+  TData extends RowData = any,
+> = Table<TFeatures, TData> & {
+  _rowModels: CachedRowModel_All<TFeatures, TData>
+  _rowModelFns: RowModelFns_All<TFeatures, TData>
+  options: TableOptions_All<TFeatures, TData> & {
+    state?: TableState_All
+    initialState?: TableState_All
+    atoms?: ExternalAtoms_All
+  }
+  initialState: TableState_All
+  baseAtoms: BaseAtoms_All
+  atoms: Atoms_All
+  store: ReadonlyStore<TableState_All>
+}

package/src/types/TableFeatures.ts

@@ -0,0 +1,295 @@
+import type { CoreFeatures } from '../core/coreFeatures'
+import type { CellData, RowData, UnionToIntersection } from './type-utils'
+import type { ColumnDefBase_All } from './ColumnDef'
+import type { Row } from './Row'
+import type { Table_Internal } from './Table'
+import type { TableOptions_All } from './TableOptions'
+import type { TableState_All } from './TableState'
+import type { StockFeatures } from '../features/stockFeatures'
+import type { RowModel } from '../core/row-models/coreRowModelsFeature.types'
+import type { FilterFn } from '../features/column-filtering/columnFilteringFeature.types'
+import type { SortFn } from '../features/row-sorting/rowSortingFeature.types'
+import type { AggregationFn } from '../features/column-grouping/columnGroupingFeature.types'
+
+export type IsAny<T> = 0 extends 1 & T ? true : false
+type UnionToIntersectionOrEmpty<T> = [T] extends [never]
+  ? {}
+  : UnionToIntersection<T> & {}
+
+export 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.
+ */
+export interface Plugins {}
+
+/**
+ * Keys of the `features` option that are not table features themselves.
+ *
+ * These slots carry per-table types (`tableMeta`, `columnMeta`), row model
+ * factories, and row model function registries. They are stripped from the
+ * table's registered `_features` at runtime and excluded from feature-derived
+ * options such as the generated `debug*` keys.
+ */
+export type NonFeatureKeys =
+  | 'aggregationFns'
+  | 'columnMeta'
+  | 'coreRowModel'
+  | 'expandedRowModel'
+  | 'facetedMinMaxValues'
+  | 'facetedRowModel'
+  | 'facetedUniqueValues'
+  | 'filterFns'
+  | 'filterMeta'
+  | 'filteredRowModel'
+  | 'groupedRowModel'
+  | 'paginatedRowModel'
+  | 'sortFns'
+  | 'sortedRowModel'
+  | 'tableMeta'
+
+/**
+ * Maps each row model and fn registry slot to the feature(s) that must be
+ * registered alongside it in the same features object.
+ *
+ * Custom features can declaration-merge their own slot prerequisites into this
+ * interface to get the same validation from `tableFeatures()`.
+ */
+export interface FeatureSlotPrereqs {
+  aggregationFns: 'columnGroupingFeature'
+  columnResizingFeature: 'columnSizingFeature' // columnSizingFeature is required for columnResizingFeature
+  expandedRowModel: 'rowExpandingFeature'
+  facetedMinMaxValues: 'columnFacetingFeature'
+  facetedRowModel: 'columnFacetingFeature'
+  facetedUniqueValues: 'columnFacetingFeature'
+  filteredRowModel: 'columnFilteringFeature'
+  filterFns: 'columnFilteringFeature'
+  filterMeta: 'columnFilteringFeature'
+  globalFilteringFeature: 'columnFilteringFeature' // columnFilteringFeature is required for globalFilteringFeature
+  groupedRowModel: 'columnGroupingFeature'
+  paginatedRowModel: 'rowPaginationFeature'
+  sortedRowModel: 'rowSortingFeature'
+  sortFns: 'rowSortingFeature'
+}
+
+/**
+ * Validates that every row model and fn registry slot in a features object is
+ * accompanied by its prerequisite feature.
+ *
+ * Slots whose prerequisite is missing have their type replaced with a literal
+ * error message, so the offending property fails to type-check with a message
+ * naming the feature that needs to be added.
+ */
+export 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
+      }
+
+export interface TableFeatures
+  extends Partial<CoreFeatures>, Partial<StockFeatures>, Partial<Plugins> {
+  /**
+   * Registry of aggregation functions available to this table by name.
+   *
+   * Keys registered here become the valid string values for `aggregationFn` on
+   * column definitions, with full inference. Spread the exported
+   * `aggregationFns` to register the built-in aggregation functions:
+   * `aggregationFns: { ...aggregationFns, myCustomAggregationFn }`.
+   */
+  aggregationFns?: Record<string, AggregationFn<any, any>>
+  /**
+   * Type-only slot for declaring the type of `columnDef.meta` for all columns
+   * of this table.
+   *
+   * Pass a phantom value: `columnMeta: {} as MyColumnMeta`. The value itself is
+   * ignored and stripped from the table's registered features at runtime — only
+   * its type is used, inferred wherever `TFeatures` flows.
+   *
+   * When omitted, the global declaration-merged `ColumnMeta` interface applies.
+   */
+  columnMeta?: object
+  /**
+   * Factory for the table's core (unmodified) row model. Defaults to the
+   * built-in `createCoreRowModel()` when omitted.
+   */
+  coreRowModel?: (table: any) => () => RowModel<any, any>
+  /**
+   * Factory for the client-side expanded row model. Pass the exported
+   * `createExpandedRowModel()` or implement your own. Not needed for
+   * server-side expansion.
+   */
+  expandedRowModel?: (table: any) => () => RowModel<any, any>
+  /**
+   * Factory for per-column faceted min/max values. Pass the exported
+   * `createFacetedMinMaxValues()` or implement your own. Not needed for
+   * server-side faceting.
+   */
+  facetedMinMaxValues?: (
+    table: any,
+    columnId: string,
+  ) => () => [number, number] | undefined
+  /**
+   * Factory for the per-column faceted row model. Pass the exported
+   * `createFacetedRowModel()` or implement your own. Not needed for
+   * server-side faceting.
+   */
+  facetedRowModel?: (table: any, columnId: string) => () => RowModel<any, any>
+  /**
+   * Factory for per-column faceted unique values. Pass the exported
+   * `createFacetedUniqueValues()` or implement your own. Not needed for
+   * server-side faceting.
+   */
+  facetedUniqueValues?: (table: any, columnId: string) => () => Map<any, number>
+  /**
+   * Factory for the client-side filtered row model. Pass the exported
+   * `createFilteredRowModel()` or implement your own. Not needed for
+   * server-side filtering.
+   */
+  filteredRowModel?: (table: any) => () => RowModel<any, any>
+  /**
+   * Registry of filter functions available to this table by name.
+   *
+   * Keys registered here become the valid string values for `filterFn` on
+   * column definitions and the `globalFilterFn` option, with full inference.
+   * Spread the exported `filterFns` to register the built-in filter functions:
+   * `filterFns: { ...filterFns, myCustomFilterFn }`.
+   */
+  filterFns?: Record<string, FilterFn<any, any>>
+  /**
+   * Type-only slot for declaring the type of the filter meta that filter
+   * functions attach to rows via `addMeta` and that is read back from
+   * `row.columnFiltersMeta`.
+   *
+   * Pass a phantom value: `filterMeta: {} as MyFilterMeta` (or
+   * `metaHelper<MyFilterMeta>()`). The value itself is ignored and stripped
+   * from the table's registered features at runtime; only its type is used.
+   *
+   * When omitted, the global declaration-merged `FilterMeta` interface applies.
+   */
+  filterMeta?: object
+  /**
+   * Factory for the client-side grouped row model. Pass the exported
+   * `createGroupedRowModel()` or implement your own. Not needed for
+   * server-side grouping.
+   */
+  groupedRowModel?: (table: any) => () => RowModel<any, any>
+  /**
+   * Factory for the client-side paginated row model. Pass the exported
+   * `createPaginatedRowModel()` or implement your own. Not needed for
+   * server-side pagination.
+   */
+  paginatedRowModel?: (table: any) => () => RowModel<any, any>
+  /**
+   * Factory for the client-side sorted row model. Pass the exported
+   * `createSortedRowModel()` or implement your own. Not needed for
+   * server-side sorting.
+   */
+  sortedRowModel?: (table: any) => () => RowModel<any, any>
+  /**
+   * Registry of sorting functions available to this table by name.
+   *
+   * Keys registered here become the valid string values for `sortFn` on column
+   * definitions, with full inference. Spread the exported `sortFns` to register
+   * the built-in sorting functions: `sortFns: { ...sortFns, myCustomSortFn }`.
+   */
+  sortFns?: Record<string, SortFn<any, any>>
+  /**
+   * Type-only slot for declaring the type of this table's `options.meta`.
+   *
+   * Pass a phantom value: `tableMeta: {} as MyTableMeta`. The value itself is
+   * ignored and stripped from the table's registered features at runtime — only
+   * its type is used, inferred wherever `TFeatures` flows.
+   *
+   * When omitted, the global declaration-merged `TableMeta` interface applies.
+   */
+  tableMeta?: object
+}
+
+export 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.
+   */
+  assignCellPrototype?: <
+    TFeatures extends TableFeatures,
+    TData extends RowData,
+  >(
+    prototype: Record<string, any>,
+    table: Table_Internal<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.
+   */
+  assignColumnPrototype?: <
+    TFeatures extends TableFeatures,
+    TData extends RowData,
+  >(
+    prototype: Record<string, any>,
+    table: Table_Internal<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.
+   */
+  assignHeaderPrototype?: <
+    TFeatures extends TableFeatures,
+    TData extends RowData,
+  >(
+    prototype: Record<string, any>,
+    table: Table_Internal<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.
+   */
+  assignRowPrototype?: <TFeatures extends TableFeatures, TData extends RowData>(
+    prototype: Record<string, any>,
+    table: Table_Internal<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.
+   */
+  constructTableAPIs?: <TFeatures extends TableFeatures, TData extends RowData>(
+    table: Table_Internal<TFeatures, TData>,
+  ) => void
+  getDefaultColumnDef?: <
+    TFeatures extends TableFeatures,
+    TData extends RowData,
+    TValue extends CellData = CellData,
+  >() => ColumnDefBase_All<TFeatures, TData, TValue>
+  getDefaultTableOptions?: <
+    TFeatures extends TableFeatures,
+    TData extends RowData,
+  >(
+    table: Table_Internal<TFeatures, TData>,
+  ) => Partial<TableOptions_All<TFeatures, TData>>
+  getInitialState?: (initialState: Partial<TableState_All>) => TableState_All
+  /**
+   * Initializes instance-specific data on each row (e.g., caches).
+   * Methods should be assigned via assignRowPrototype instead.
+   */
+  initRowInstanceData?: <
+    TFeatures extends TableFeatures,
+    TData extends RowData,
+  >(
+    row: Row<TFeatures, TData>,
+  ) => void
+}

package/src/types/TableOptions.ts

@@ -0,0 +1,108 @@
+import type { CoreFeatures } from '../core/coreFeatures'
+import type { TableOptions_Cell } from '../core/cells/coreCellsFeature.types'
+import type { TableOptions_Columns } from '../core/columns/coreColumnsFeature.types'
+import type { TableOptions_Rows } from '../core/rows/coreRowsFeature.types'
+import type { TableOptions_Table } from '../core/table/coreTablesFeature.types'
+import type { TableOptions_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
+import type { TableOptions_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
+import type { TableOptions_ColumnOrdering } from '../features/column-ordering/columnOrderingFeature.types'
+import type { TableOptions_ColumnPinning } from '../features/column-pinning/columnPinningFeature.types'
+import type { TableOptions_ColumnResizing } from '../features/column-resizing/columnResizingFeature.types'
+import type { TableOptions_ColumnSizing } from '../features/column-sizing/columnSizingFeature.types'
+import type { TableOptions_ColumnVisibility } from '../features/column-visibility/columnVisibilityFeature.types'
+import type { TableOptions_GlobalFiltering } from '../features/global-filtering/globalFilteringFeature.types'
+import type { TableOptions_RowExpanding } from '../features/row-expanding/rowExpandingFeature.types'
+import type { TableOptions_RowPagination } from '../features/row-pagination/rowPaginationFeature.types'
+import type { TableOptions_RowPinning } from '../features/row-pinning/rowPinningFeature.types'
+import type { TableOptions_RowSelection } from '../features/row-selection/rowSelectionFeature.types'
+import type { TableOptions_RowSorting } from '../features/row-sorting/rowSortingFeature.types'
+import type { RowData, UnionToIntersection } from './type-utils'
+import type {
+  ExtractFeatureMapTypes,
+  NonFeatureKeys,
+  TableFeatures,
+} from './TableFeatures'
+
+/**
+ * Core options that are always available on a table, before optional feature
+ * options are mixed in.
+ */
+export interface TableOptions_Core<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+>
+  extends
+    TableOptions_Table<TFeatures, TData>,
+    TableOptions_Cell,
+    TableOptions_Columns<TFeatures, TData>,
+    TableOptions_Rows<TFeatures, TData> {}
+
+type DebugKeysFor<TFeatures extends TableFeatures> = {
+  [K in Exclude<
+    keyof TFeatures & string,
+    NonFeatureKeys // meta, row model, and fn registry slots, not real features
+  > as `debug${Capitalize<K>}`]?: boolean
+}
+
+export type DebugOptions<TFeatures extends TableFeatures> = {
+  debugAll?: boolean
+  debugCache?: boolean
+  debugCells?: boolean
+  debugColumns?: boolean
+  debugHeaders?: boolean
+  debugRows?: boolean
+  debugTable?: boolean
+} & DebugKeysFor<CoreFeatures & TFeatures>
+
+export interface TableOptions_FeatureMap<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> {
+  columnFilteringFeature: TableOptions_ColumnFiltering<TFeatures, TData>
+  columnGroupingFeature: TableOptions_ColumnGrouping
+  columnOrderingFeature: TableOptions_ColumnOrdering
+  columnPinningFeature: TableOptions_ColumnPinning
+  columnResizingFeature: TableOptions_ColumnResizing
+  columnSizingFeature: TableOptions_ColumnSizing
+  columnVisibilityFeature: TableOptions_ColumnVisibility
+  globalFilteringFeature: TableOptions_GlobalFiltering<TFeatures, TData>
+  rowExpandingFeature: TableOptions_RowExpanding<TFeatures, TData>
+  rowPaginationFeature: TableOptions_RowPagination
+  rowPinningFeature: TableOptions_RowPinning<TFeatures, TData>
+  rowSelectionFeature: TableOptions_RowSelection<TFeatures, TData>
+  rowSortingFeature: TableOptions_RowSorting
+}
+
+export type TableOptions_FeatureMap_All<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> = UnionToIntersection<
+  TableOptions_FeatureMap<TFeatures, TData>[keyof TableOptions_FeatureMap<
+    TFeatures,
+    TData
+  >]
+>
+
+/**
+ * Complete table options for a specific feature set.
+ *
+ * Feature options are included only when their feature is present in
+ * `TFeatures`, then custom feature/plugin options and debug options are mixed
+ * in.
+ */
+export type TableOptions<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> = TableOptions_Core<TFeatures, TData> &
+  ExtractFeatureMapTypes<TFeatures, TableOptions_FeatureMap<TFeatures, TData>> &
+  DebugOptions<TFeatures>
+
+/**
+ * Internal broad option shape used where feature code may need to read options
+ * from features that are not present in the current generic feature set.
+ */
+export type TableOptions_All<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> = TableOptions_Core<TFeatures, TData> &
+  Partial<TableOptions_FeatureMap_All<TFeatures, TData>>

package/src/types/TableState.ts

@@ -0,0 +1,47 @@
+import type { TableState_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
+import type { TableState_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
+import type { TableState_ColumnOrdering } from '../features/column-ordering/columnOrderingFeature.types'
+import type { TableState_ColumnPinning } from '../features/column-pinning/columnPinningFeature.types'
+import type { TableState_ColumnResizing } from '../features/column-resizing/columnResizingFeature.types'
+import type { TableState_ColumnSizing } from '../features/column-sizing/columnSizingFeature.types'
+import type { TableState_ColumnVisibility } from '../features/column-visibility/columnVisibilityFeature.types'
+import type { TableState_GlobalFiltering } from '../features/global-filtering/globalFilteringFeature.types'
+import type { TableState_RowExpanding } from '../features/row-expanding/rowExpandingFeature.types'
+import type { TableState_RowPagination } from '../features/row-pagination/rowPaginationFeature.types'
+import type { TableState_RowPinning } from '../features/row-pinning/rowPinningFeature.types'
+import type { TableState_RowSelection } from '../features/row-selection/rowSelectionFeature.types'
+import type { TableState_RowSorting } from '../features/row-sorting/rowSortingFeature.types'
+import type { ExtractFeatureMapTypes, TableFeatures } from './TableFeatures'
+
+export interface TableState_FeatureMap {
+  columnFilteringFeature: TableState_ColumnFiltering
+  columnGroupingFeature: TableState_ColumnGrouping
+  columnOrderingFeature: TableState_ColumnOrdering
+  columnPinningFeature: TableState_ColumnPinning
+  columnResizingFeature: TableState_ColumnResizing
+  columnSizingFeature: TableState_ColumnSizing
+  columnVisibilityFeature: TableState_ColumnVisibility
+  globalFilteringFeature: TableState_GlobalFiltering
+  rowExpandingFeature: TableState_RowExpanding
+  rowPaginationFeature: TableState_RowPagination
+  rowPinningFeature: TableState_RowPinning
+  rowSelectionFeature: TableState_RowSelection
+  rowSortingFeature: TableState_RowSorting
+}
+
+/**
+ * Complete table state for a specific feature set.
+ *
+ * State slices are included only when their feature is present in `TFeatures`,
+ * then custom feature/plugin state is mixed in.
+ */
+export type TableState<TFeatures extends TableFeatures> =
+  ExtractFeatureMapTypes<TFeatures, TableState_FeatureMap>
+
+/**
+ * Internal broad state shape containing every registered feature state slice.
+ *
+ * Feature internals use this when they may need to inspect optional slices owned
+ * by other features.
+ */
+export type TableState_All = Partial<TableState<TableFeatures>>