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

package/dist/types/TableFeatures.d.ts

@@ -0,0 +1,214 @@
+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 { TableState_All } from "./TableState.js";
+import { TableOptions_All } from "./TableOptions.js";
+import { Table_Internal } from "./Table.js";
+import { ColumnDefBase_All } from "./ColumnDef.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
+type IsAny<T> = 0 extends 1 & T ? true : false;
+type UnionToIntersectionOrEmpty<T> = [T] extends [never] ? {} : UnionToIntersection<T> & {};
+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.
+ */
+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.
+ */
+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()`.
+ */
+interface FeatureSlotPrereqs {
+  aggregationFns: 'columnGroupingFeature';
+  columnResizingFeature: 'columnSizingFeature';
+  expandedRowModel: 'rowExpandingFeature';
+  facetedMinMaxValues: 'columnFacetingFeature';
+  facetedRowModel: 'columnFacetingFeature';
+  facetedUniqueValues: 'columnFacetingFeature';
+  filteredRowModel: 'columnFilteringFeature';
+  filterFns: 'columnFilteringFeature';
+  filterMeta: 'columnFilteringFeature';
+  globalFilteringFeature: 'columnFilteringFeature';
+  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.
+ */
+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 };
+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;
+}
+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;
+}
+//#endregion
+export { ExtractFeatureMapTypes, FeatureSlotPrereqs, IsAny, NonFeatureKeys, Plugins, TableFeature, TableFeatures, ValidateFeatureSlots };
+//# sourceMappingURL=TableFeatures.d.ts.map

package/dist/types/TableOptions.d.cts

@@ -0,0 +1,69 @@
+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_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_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.cjs";
+import { TableOptions_Table } from "../core/table/coreTablesFeature.types.cjs";
+import { TableOptions_Cell } from "../core/cells/coreCellsFeature.types.cjs";
+import { ExtractFeatureMapTypes, NonFeatureKeys, TableFeatures } from "./TableFeatures.cjs";
+import { TableOptions_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.cjs";
+
+//#region src/types/TableOptions.d.ts
+/**
+ * Core options that are always available on a table, before optional feature
+ * options are mixed in.
+ */
+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> as `debug${Capitalize<K>}`]?: boolean };
+type DebugOptions<TFeatures extends TableFeatures> = {
+  debugAll?: boolean;
+  debugCache?: boolean;
+  debugCells?: boolean;
+  debugColumns?: boolean;
+  debugHeaders?: boolean;
+  debugRows?: boolean;
+  debugTable?: boolean;
+} & DebugKeysFor<CoreFeatures & TFeatures>;
+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;
+}
+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.
+ */
+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.
+ */
+type TableOptions_All<TFeatures extends TableFeatures, TData extends RowData> = TableOptions_Core<TFeatures, TData> & Partial<TableOptions_FeatureMap_All<TFeatures, TData>>;
+//#endregion
+export { DebugOptions, TableOptions, TableOptions_All, TableOptions_Core, TableOptions_FeatureMap, TableOptions_FeatureMap_All };
+//# sourceMappingURL=TableOptions.d.cts.map

package/dist/types/TableOptions.d.ts

@@ -0,0 +1,69 @@
+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_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_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.js";
+import { TableOptions_Table } from "../core/table/coreTablesFeature.types.js";
+import { TableOptions_Cell } from "../core/cells/coreCellsFeature.types.js";
+import { ExtractFeatureMapTypes, NonFeatureKeys, TableFeatures } from "./TableFeatures.js";
+import { TableOptions_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.js";
+
+//#region src/types/TableOptions.d.ts
+/**
+ * Core options that are always available on a table, before optional feature
+ * options are mixed in.
+ */
+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> as `debug${Capitalize<K>}`]?: boolean };
+type DebugOptions<TFeatures extends TableFeatures> = {
+  debugAll?: boolean;
+  debugCache?: boolean;
+  debugCells?: boolean;
+  debugColumns?: boolean;
+  debugHeaders?: boolean;
+  debugRows?: boolean;
+  debugTable?: boolean;
+} & DebugKeysFor<CoreFeatures & TFeatures>;
+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;
+}
+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.
+ */
+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.
+ */
+type TableOptions_All<TFeatures extends TableFeatures, TData extends RowData> = TableOptions_Core<TFeatures, TData> & Partial<TableOptions_FeatureMap_All<TFeatures, TData>>;
+//#endregion
+export { DebugOptions, TableOptions, TableOptions_All, TableOptions_Core, TableOptions_FeatureMap, TableOptions_FeatureMap_All };
+//# sourceMappingURL=TableOptions.d.ts.map

package/dist/types/TableState.d.cts

@@ -0,0 +1,48 @@
+import { TableState_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.cjs";
+import { TableState_RowSorting } from "../features/row-sorting/rowSortingFeature.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_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.cjs";
+import { ExtractFeatureMapTypes, TableFeatures } from "./TableFeatures.cjs";
+import { TableState_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.cjs";
+
+//#region src/types/TableState.d.ts
+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.
+ */
+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.
+ */
+type TableState_All = Partial<TableState<TableFeatures>>;
+//#endregion
+export { TableState, TableState_All, TableState_FeatureMap };
+//# sourceMappingURL=TableState.d.cts.map

package/dist/types/TableState.d.ts

@@ -0,0 +1,48 @@
+import { TableState_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.js";
+import { TableState_RowSorting } from "../features/row-sorting/rowSortingFeature.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_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.js";
+import { ExtractFeatureMapTypes, TableFeatures } from "./TableFeatures.js";
+import { TableState_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.js";
+
+//#region src/types/TableState.d.ts
+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.
+ */
+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.
+ */
+type TableState_All = Partial<TableState<TableFeatures>>;
+//#endregion
+export { TableState, TableState_All, TableState_FeatureMap };
+//# sourceMappingURL=TableState.d.ts.map

package/dist/types/type-utils.d.cts

@@ -0,0 +1,23 @@
+//#region src/types/type-utils.d.ts
+type Updater<T> = T | ((old: T) => T);
+type OnChangeFn<T> = (updaterOrValue: Updater<T>) => void;
+type RowData = Record<string, any> | Array<any>;
+type CellData = unknown;
+type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+type RequiredKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) extends ((x: infer R) => any) ? R : never;
+type ComputeRange<N extends number, Result extends Array<unknown> = []> = Result['length'] extends N ? Result : ComputeRange<N, [...Result, Result['length']]>;
+type Index40 = ComputeRange<40>[number];
+type IsTuple<T> = T extends ReadonlyArray<any> & {
+  length: infer Length;
+} ? Length extends Index40 ? T : never : never;
+type AllowedIndexes<Tuple extends ReadonlyArray<any>, Keys extends number = never> = Tuple extends readonly [] ? Keys : Tuple extends readonly [infer _, ...infer Tail] ? AllowedIndexes<Tail, Keys | Tail['length']> : Keys;
+type DeepKeys<T, TDepth extends Array<any> = []> = TDepth['length'] extends 5 ? never : unknown extends T ? string : T extends ReadonlyArray<any> & IsTuple<T> ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth> : T extends Array<any> ? DeepKeys<T[number], [...TDepth, any]> : T extends Date ? never : T extends object ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth> : never;
+type DeepKeysPrefix<T, TPrefix, TDepth extends Array<any>> = TPrefix extends keyof T & (number | string) ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}` : never;
+type DeepValue<T, TProp> = T extends Record<string | number, any> ? TProp extends `${infer TBranch}.${infer TDeepProp}` ? DeepValue<T[TBranch], TDeepProp> : T[TProp & string] : never;
+type NoInfer<T> = [T][T extends any ? 0 : never];
+type Getter<TValue> = <TTValue = TValue>() => NoInfer<TTValue>;
+type Prettify<T> = { [K in keyof T]: T[K] } & unknown;
+//#endregion
+export { CellData, DeepKeys, DeepValue, Getter, NoInfer, OnChangeFn, PartialKeys, Prettify, RequiredKeys, RowData, UnionToIntersection, Updater };
+//# sourceMappingURL=type-utils.d.cts.map

package/dist/types/type-utils.d.ts

@@ -0,0 +1,23 @@
+//#region src/types/type-utils.d.ts
+type Updater<T> = T | ((old: T) => T);
+type OnChangeFn<T> = (updaterOrValue: Updater<T>) => void;
+type RowData = Record<string, any> | Array<any>;
+type CellData = unknown;
+type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+type RequiredKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) extends ((x: infer R) => any) ? R : never;
+type ComputeRange<N extends number, Result extends Array<unknown> = []> = Result['length'] extends N ? Result : ComputeRange<N, [...Result, Result['length']]>;
+type Index40 = ComputeRange<40>[number];
+type IsTuple<T> = T extends ReadonlyArray<any> & {
+  length: infer Length;
+} ? Length extends Index40 ? T : never : never;
+type AllowedIndexes<Tuple extends ReadonlyArray<any>, Keys extends number = never> = Tuple extends readonly [] ? Keys : Tuple extends readonly [infer _, ...infer Tail] ? AllowedIndexes<Tail, Keys | Tail['length']> : Keys;
+type DeepKeys<T, TDepth extends Array<any> = []> = TDepth['length'] extends 5 ? never : unknown extends T ? string : T extends ReadonlyArray<any> & IsTuple<T> ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth> : T extends Array<any> ? DeepKeys<T[number], [...TDepth, any]> : T extends Date ? never : T extends object ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth> : never;
+type DeepKeysPrefix<T, TPrefix, TDepth extends Array<any>> = TPrefix extends keyof T & (number | string) ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}` : never;
+type DeepValue<T, TProp> = T extends Record<string | number, any> ? TProp extends `${infer TBranch}.${infer TDeepProp}` ? DeepValue<T[TBranch], TDeepProp> : T[TProp & string] : never;
+type NoInfer<T> = [T][T extends any ? 0 : never];
+type Getter<TValue> = <TTValue = TValue>() => NoInfer<TTValue>;
+type Prettify<T> = { [K in keyof T]: T[K] } & unknown;
+//#endregion
+export { CellData, DeepKeys, DeepValue, Getter, NoInfer, OnChangeFn, PartialKeys, Prettify, RequiredKeys, RowData, UnionToIntersection, Updater };
+//# sourceMappingURL=type-utils.d.ts.map