@tanstack/react-table 9.0.0-alpha.33 → 9.0.0-alpha.34

package/dist/useLegacyTable.js

@@ -2,7 +2,7 @@
 
 import { useTable } from "./useTable.js";
 import { aggregationFns, createColumnHelper, createExpandedRowModel, createFacetedMinMaxValues, createFacetedRowModel, createFacetedUniqueValues, createFilteredRowModel, createGroupedRowModel, createPaginatedRowModel, createSortedRowModel, filterFns, sortFns, stockFeatures } from "@tanstack/table-core";
-import { useMemo } from "react";
+import { useCallback, useMemo } from "react";
 
 //#region src/useLegacyTable.ts
 /**
@@ -132,11 +132,20 @@ function legacyCreateColumnHelper() {
 function useLegacyTable(options) {
 	const { getCoreRowModel: _getCoreRowModel, getFilteredRowModel, getSortedRowModel, getPaginationRowModel, getExpandedRowModel, getGroupedRowModel, getFacetedRowModel, getFacetedMinMaxValues, getFacetedUniqueValues, ...restOptions } = options;
 	const _rowModels = {};
-	if (getFilteredRowModel) _rowModels.filteredRowModel = createFilteredRowModel(filterFns);
-	if (getSortedRowModel) _rowModels.sortedRowModel = createSortedRowModel(sortFns);
+	if (getFilteredRowModel) _rowModels.filteredRowModel = createFilteredRowModel({
+		...filterFns,
+		...options.filterFns
+	});
+	if (getSortedRowModel) _rowModels.sortedRowModel = createSortedRowModel({
+		...sortFns,
+		...options.sortFns
+	});
 	if (getPaginationRowModel) _rowModels.paginatedRowModel = createPaginatedRowModel();
 	if (getExpandedRowModel) _rowModels.expandedRowModel = createExpandedRowModel();
-	if (getGroupedRowModel) _rowModels.groupedRowModel = createGroupedRowModel(aggregationFns);
+	if (getGroupedRowModel) _rowModels.groupedRowModel = createGroupedRowModel({
+		...aggregationFns,
+		...options.aggregationFns
+	});
 	if (getFacetedRowModel) _rowModels.facetedRowModel = createFacetedRowModel();
 	if (getFacetedMinMaxValues) _rowModels.facetedMinMaxValues = createFacetedMinMaxValues();
 	if (getFacetedUniqueValues) _rowModels.facetedUniqueValues = createFacetedUniqueValues();
@@ -145,10 +154,27 @@ function useLegacyTable(options) {
 		_features: stockFeatures,
 		_rowModels
 	}, (state) => state);
+	const getState = useCallback(() => {
+		return {
+			...table.state,
+			columns: void 0,
+			data: void 0
+		};
+	}, [table]);
+	const setState = useCallback((state) => {
+		Object.entries(state).forEach(([key, value]) => {
+			table.baseAtoms[key].set(value);
+		});
+	}, [table]);
 	return useMemo(() => ({
 		...table,
-		getState: () => table.state
-	}), [table]);
+		getState,
+		setState
+	}), [
+		table,
+		getState,
+		setState
+	]);
 }
 
 //#endregion

package/dist/useLegacyTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLegacyTable.js","names":[],"sources":["../src/useLegacyTable.ts"],"sourcesContent":["'use client'\n\nimport {\n  aggregationFns,\n  createColumnHelper,\n  createExpandedRowModel,\n  createFacetedMinMaxValues,\n  createFacetedRowModel,\n  createFacetedUniqueValues,\n  createFilteredRowModel,\n  createGroupedRowModel,\n  createPaginatedRowModel,\n  createSortedRowModel,\n  filterFns,\n  sortFns,\n  stockFeatures,\n} from '@tanstack/table-core'\nimport { useMemo } from 'react'\nimport { useTable } from './useTable'\nimport type {\n  Cell,\n  Column,\n  ColumnDef,\n  CreateRowModels_All,\n  Header,\n  HeaderGroup,\n  Row,\n  RowData,\n  RowModel,\n  StockFeatures,\n  Table,\n  TableOptions,\n  TableState,\n} from '@tanstack/table-core'\nimport type { ReactTable } from './useTable'\n\n// =============================================================================\n// V8-style row model factory functions\n// These are stub functions that act as markers for useLegacyTable to know\n// which row models to enable. They don't actually do anything - the real\n// implementation is handled by useLegacyTable internally.\n// =============================================================================\n\n/**\n * @deprecated Use `createFilteredRowModel(filterFns)` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the filtered row model.\n */\nexport function getFilteredRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createSortedRowModel(sortFns)` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the sorted row model.\n */\nexport function getSortedRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createPaginatedRowModel()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the paginated row model.\n */\nexport function getPaginationRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createExpandedRowModel()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the expanded row model.\n */\nexport function getExpandedRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createGroupedRowModel(aggregationFns)` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the grouped row model.\n */\nexport function getGroupedRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createFacetedRowModel()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the faceted row model.\n */\nexport function getFacetedRowModel<\n  TData extends RowData,\n>(): FacetedRowModelFactory<TData> {\n  return (() => () => {}) as unknown as FacetedRowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createFacetedMinMaxValues()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the faceted min/max values.\n */\nexport function getFacetedMinMaxValues<\n  TData extends RowData,\n>(): FacetedMinMaxValuesFactory<TData> {\n  return (() => () => undefined) as unknown as FacetedMinMaxValuesFactory<TData>\n}\n\n/**\n * @deprecated Use `createFacetedUniqueValues()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the faceted unique values.\n */\nexport function getFacetedUniqueValues<\n  TData extends RowData,\n>(): FacetedUniqueValuesFactory<TData> {\n  return (() => () => new Map()) as unknown as FacetedUniqueValuesFactory<TData>\n}\n\n/**\n * @deprecated The core row model is always created automatically in v9.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It does nothing - the core row model is always available.\n */\nexport function getCoreRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n// =============================================================================\n// Type definitions\n// =============================================================================\n\n/**\n * Row model factory function type from v8 API\n */\ntype RowModelFactory<TData extends RowData> = (\n  table: Table<StockFeatures, TData>,\n) => () => RowModel<StockFeatures, TData>\n\n/**\n * Faceted row model factory function type from v8 API\n */\ntype FacetedRowModelFactory<TData extends RowData> = (\n  table: Table<StockFeatures, TData>,\n  columnId: string,\n) => () => RowModel<StockFeatures, TData>\n\n/**\n * Faceted min/max values factory function type from v8 API\n */\ntype FacetedMinMaxValuesFactory<TData extends RowData> = (\n  table: Table<StockFeatures, TData>,\n  columnId: string,\n) => () => undefined | [number, number]\n\n/**\n * Faceted unique values factory function type from v8 API\n */\ntype FacetedUniqueValuesFactory<TData extends RowData> = (\n  table: Table<StockFeatures, TData>,\n  columnId: string,\n) => () => Map<any, number>\n\n/**\n * Legacy v8-style row model options\n */\nexport interface LegacyRowModelOptions<TData extends RowData> {\n  /**\n   * Returns the core row model for the table.\n   * @deprecated This option is no longer needed in v9. The core row model is always created automatically.\n   */\n  getCoreRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the filtered row model for the table.\n   * @deprecated Use `_rowModels.filteredRowModel` with `createFilteredRowModel(filterFns)` instead.\n   */\n  getFilteredRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the sorted row model for the table.\n   * @deprecated Use `_rowModels.sortedRowModel` with `createSortedRowModel(sortFns)` instead.\n   */\n  getSortedRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the paginated row model for the table.\n   * @deprecated Use `_rowModels.paginatedRowModel` with `createPaginatedRowModel()` instead.\n   */\n  getPaginationRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the expanded row model for the table.\n   * @deprecated Use `_rowModels.expandedRowModel` with `createExpandedRowModel()` instead.\n   */\n  getExpandedRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the grouped row model for the table.\n   * @deprecated Use `_rowModels.groupedRowModel` with `createGroupedRowModel(aggregationFns)` instead.\n   */\n  getGroupedRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the faceted row model for a column.\n   * @deprecated Use `_rowModels.facetedRowModel` with `createFacetedRowModel()` instead.\n   */\n  getFacetedRowModel?: FacetedRowModelFactory<TData>\n  /**\n   * Returns the faceted min/max values for a column.\n   * @deprecated Use `_rowModels.facetedMinMaxValues` with `createFacetedMinMaxValues()` instead.\n   */\n  getFacetedMinMaxValues?: FacetedMinMaxValuesFactory<TData>\n  /**\n   * Returns the faceted unique values for a column.\n   * @deprecated Use `_rowModels.facetedUniqueValues` with `createFacetedUniqueValues()` instead.\n   */\n  getFacetedUniqueValues?: FacetedUniqueValuesFactory<TData>\n}\n\n/**\n * Legacy v8-style table options that work with useLegacyTable.\n *\n * This type omits `_features` and `_rowModels` and instead accepts the v8-style\n * `get*RowModel` function options.\n *\n * @deprecated This is a compatibility layer for migrating from v8. Use `useTable` with explicit `_features` and `_rowModels` instead.\n */\nexport type LegacyTableOptions<TData extends RowData> = Omit<\n  TableOptions<StockFeatures, TData>,\n  '_features' | '_rowModels'\n> &\n  LegacyRowModelOptions<TData>\n\n/**\n * Legacy table instance type that includes the v8-style `getState()` method.\n *\n * @deprecated Use `useTable` with explicit state selection instead.\n */\nexport type LegacyReactTable<TData extends RowData> = ReactTable<\n  StockFeatures,\n  TData,\n  TableState<StockFeatures>\n> & {\n  /**\n   * Returns the current table state.\n   * @deprecated In v9, access state directly via `table.state` or use `table.store.state` for the full state.\n   */\n  getState: () => TableState<StockFeatures>\n}\n\n// =============================================================================\n// Legacy type aliases - StockFeatures hardcoded for simpler prop typing with useLegacyTable\n// =============================================================================\n\n/** @deprecated Use Column<TFeatures, TData, TValue> with useTable instead. */\nexport type LegacyColumn<TData extends RowData, TValue = unknown> = Column<\n  StockFeatures,\n  TData,\n  TValue\n>\n\n/** @deprecated Use Row<TFeatures, TData> with useTable instead. */\nexport type LegacyRow<TData extends RowData> = Row<StockFeatures, TData>\n\n/** @deprecated Use Cell<TFeatures, TData, TValue> with useTable instead. */\nexport type LegacyCell<TData extends RowData, TValue = unknown> = Cell<\n  StockFeatures,\n  TData,\n  TValue\n>\n\n/** @deprecated Use Header<TFeatures, TData, TValue> with useTable instead. */\nexport type LegacyHeader<TData extends RowData, TValue = unknown> = Header<\n  StockFeatures,\n  TData,\n  TValue\n>\n\n/** @deprecated Use HeaderGroup<TFeatures, TData> with useTable instead. */\nexport type LegacyHeaderGroup<TData extends RowData> = HeaderGroup<\n  StockFeatures,\n  TData\n>\n\n/** @deprecated Use ColumnDef<TFeatures, TData, TValue> with useTable instead. */\nexport type LegacyColumnDef<\n  TData extends RowData,\n  TValue = unknown,\n> = ColumnDef<StockFeatures, TData, TValue>\n\n/** @deprecated Use Table<TFeatures, TData> with useTable instead. */\nexport type LegacyTable<TData extends RowData> = Table<StockFeatures, TData>\n\n// =============================================================================\n// Legacy column helper - StockFeatures hardcoded\n// =============================================================================\n\n/**\n * @deprecated Use `createColumnHelper<TFeatures, TData>()` with useTable instead.\n *\n * A column helper with StockFeatures pre-bound for use with useLegacyTable.\n * Only requires TData—no need to specify TFeatures.\n */\nexport function legacyCreateColumnHelper<TData extends RowData>() {\n  return createColumnHelper<StockFeatures, TData>()\n}\n\n// =============================================================================\n// useLegacyTable hook\n// =============================================================================\n\n/**\n * @deprecated This hook is provided as a compatibility layer for migrating from TanStack Table v8.\n *\n * Use the new `useTable` hook instead with explicit `_features` and `_rowModels`:\n *\n * ```tsx\n * // New v9 API\n * const _features = tableFeatures({\n *   columnFilteringFeature,\n *   rowSortingFeature,\n *   rowPaginationFeature,\n * })\n *\n * const table = useTable({\n *   _features,\n *   _rowModels: {\n *     filteredRowModel: createFilteredRowModel(filterFns),\n *     sortedRowModel: createSortedRowModel(sortFns),\n *     paginatedRowModel: createPaginatedRowModel(),\n *   },\n *   columns,\n *   data,\n * })\n * ```\n *\n * Key differences from v8:\n * - Features are tree-shakeable - only import what you use\n * - Row models are explicitly passed via `_rowModels`\n * - Use `table.Subscribe` for fine-grained re-renders\n * - State is accessed via `table.state` after selecting with the 2nd argument\n *\n * @param options - Legacy v8-style table options\n * @returns A table instance with the full state subscribed and a `getState()` method\n */\nexport function useLegacyTable<TData extends RowData>(\n  options: LegacyTableOptions<TData>,\n): LegacyReactTable<TData> {\n  const {\n    // Extract legacy row model options\n    getCoreRowModel: _getCoreRowModel,\n    getFilteredRowModel,\n    getSortedRowModel,\n    getPaginationRowModel,\n    getExpandedRowModel,\n    getGroupedRowModel,\n    getFacetedRowModel,\n    getFacetedMinMaxValues,\n    getFacetedUniqueValues,\n    // Rest of the options\n    ...restOptions\n  } = options\n\n  // Build the _rowModels object based on which legacy options were provided\n  const _rowModels: CreateRowModels_All<StockFeatures, TData> = {}\n\n  // Map v8 row model factories to v9 _rowModels\n  // Note: getCoreRowModel is handled automatically in v9, so we ignore it\n\n  if (getFilteredRowModel) {\n    _rowModels.filteredRowModel = createFilteredRowModel(filterFns)\n  }\n\n  if (getSortedRowModel) {\n    _rowModels.sortedRowModel = createSortedRowModel(sortFns)\n  }\n\n  if (getPaginationRowModel) {\n    _rowModels.paginatedRowModel = createPaginatedRowModel()\n  }\n\n  if (getExpandedRowModel) {\n    _rowModels.expandedRowModel = createExpandedRowModel()\n  }\n\n  if (getGroupedRowModel) {\n    _rowModels.groupedRowModel = createGroupedRowModel(aggregationFns)\n  }\n\n  if (getFacetedRowModel) {\n    _rowModels.facetedRowModel = createFacetedRowModel()\n  }\n\n  if (getFacetedMinMaxValues) {\n    _rowModels.facetedMinMaxValues = createFacetedMinMaxValues()\n  }\n\n  if (getFacetedUniqueValues) {\n    _rowModels.facetedUniqueValues = createFacetedUniqueValues()\n  }\n\n  // Call useTable with the v9 API, subscribing to all state changes\n  const table = useTable<StockFeatures, TData, TableState<StockFeatures>>(\n    {\n      ...restOptions,\n      _features: stockFeatures,\n      _rowModels,\n    } as TableOptions<StockFeatures, TData>,\n    (state) => state,\n  )\n\n  return useMemo(\n    () =>\n      ({\n        ...table,\n        getState: () => table.state,\n      }) as LegacyReactTable<TData>,\n    [table],\n  )\n}\n"],"mappings":";;;;;;;;;;;;;AAiDA,SAAgB,sBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,oBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,wBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,sBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,qBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,qBAEmB;AACjC,qBAAoB;;;;;;;;AAStB,SAAgB,yBAEuB;AACrC,qBAAoB;;;;;;;;AAStB,SAAgB,yBAEuB;AACrC,qCAAoB,IAAI,KAAK;;;;;;;;AAS/B,SAAgB,kBAEY;AAC1B,qBAAoB;;;;;;;;AA6KtB,SAAgB,2BAAkD;AAChE,QAAO,oBAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCnD,SAAgB,eACd,SACyB;CACzB,MAAM,EAEJ,iBAAiB,kBACjB,qBACA,mBACA,uBACA,qBACA,oBACA,oBACA,wBACA,wBAEA,GAAG,gBACD;CAGJ,MAAM,aAAwD,EAAE;AAKhE,KAAI,oBACF,YAAW,mBAAmB,uBAAuB,UAAU;AAGjE,KAAI,kBACF,YAAW,iBAAiB,qBAAqB,QAAQ;AAG3D,KAAI,sBACF,YAAW,oBAAoB,yBAAyB;AAG1D,KAAI,oBACF,YAAW,mBAAmB,wBAAwB;AAGxD,KAAI,mBACF,YAAW,kBAAkB,sBAAsB,eAAe;AAGpE,KAAI,mBACF,YAAW,kBAAkB,uBAAuB;AAGtD,KAAI,uBACF,YAAW,sBAAsB,2BAA2B;AAG9D,KAAI,uBACF,YAAW,sBAAsB,2BAA2B;CAI9D,MAAM,QAAQ,SACZ;EACE,GAAG;EACH,WAAW;EACX;EACD,GACA,UAAU,MACZ;AAED,QAAO,eAEF;EACC,GAAG;EACH,gBAAgB,MAAM;EACvB,GACH,CAAC,MAAM,CACR"}
+{"version":3,"file":"useLegacyTable.js","names":[],"sources":["../src/useLegacyTable.ts"],"sourcesContent":["'use client'\n\nimport {\n  aggregationFns,\n  createColumnHelper,\n  createExpandedRowModel,\n  createFacetedMinMaxValues,\n  createFacetedRowModel,\n  createFacetedUniqueValues,\n  createFilteredRowModel,\n  createGroupedRowModel,\n  createPaginatedRowModel,\n  createSortedRowModel,\n  filterFns,\n  sortFns,\n  stockFeatures,\n} from '@tanstack/table-core'\nimport { useCallback, useMemo } from 'react'\nimport { useTable } from './useTable'\nimport type {\n  AggregationFns,\n  Cell,\n  Column,\n  ColumnDef,\n  CreateRowModels_All,\n  FilterFns,\n  Header,\n  HeaderGroup,\n  Row,\n  RowData,\n  RowModel,\n  SortFns,\n  StockFeatures,\n  Table,\n  TableOptions,\n  TableState,\n} from '@tanstack/table-core'\nimport type { ReactTable } from './useTable'\n\n// =============================================================================\n// V8-style row model factory functions\n// These are stub functions that act as markers for useLegacyTable to know\n// which row models to enable. They don't actually do anything - the real\n// implementation is handled by useLegacyTable internally.\n// =============================================================================\n\n/**\n * @deprecated Use `createFilteredRowModel(filterFns)` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the filtered row model.\n */\nexport function getFilteredRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createSortedRowModel(sortFns)` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the sorted row model.\n */\nexport function getSortedRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createPaginatedRowModel()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the paginated row model.\n */\nexport function getPaginationRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createExpandedRowModel()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the expanded row model.\n */\nexport function getExpandedRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createGroupedRowModel(aggregationFns)` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the grouped row model.\n */\nexport function getGroupedRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createFacetedRowModel()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the faceted row model.\n */\nexport function getFacetedRowModel<\n  TData extends RowData,\n>(): FacetedRowModelFactory<TData> {\n  return (() => () => {}) as unknown as FacetedRowModelFactory<TData>\n}\n\n/**\n * @deprecated Use `createFacetedMinMaxValues()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the faceted min/max values.\n */\nexport function getFacetedMinMaxValues<\n  TData extends RowData,\n>(): FacetedMinMaxValuesFactory<TData> {\n  return (() => () => undefined) as unknown as FacetedMinMaxValuesFactory<TData>\n}\n\n/**\n * @deprecated Use `createFacetedUniqueValues()` with the new `useTable` hook instead.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It acts as a marker to enable the faceted unique values.\n */\nexport function getFacetedUniqueValues<\n  TData extends RowData,\n>(): FacetedUniqueValuesFactory<TData> {\n  return (() => () => new Map()) as unknown as FacetedUniqueValuesFactory<TData>\n}\n\n/**\n * @deprecated The core row model is always created automatically in v9.\n *\n * This is a stub function for v8 API compatibility with `useLegacyTable`.\n * It does nothing - the core row model is always available.\n */\nexport function getCoreRowModel<\n  TData extends RowData,\n>(): RowModelFactory<TData> {\n  return (() => () => {}) as unknown as RowModelFactory<TData>\n}\n\n// =============================================================================\n// Type definitions\n// =============================================================================\n\n/**\n * Row model factory function type from v8 API\n */\ntype RowModelFactory<TData extends RowData> = (\n  table: Table<StockFeatures, TData>,\n) => () => RowModel<StockFeatures, TData>\n\n/**\n * Faceted row model factory function type from v8 API\n */\ntype FacetedRowModelFactory<TData extends RowData> = (\n  table: Table<StockFeatures, TData>,\n  columnId: string,\n) => () => RowModel<StockFeatures, TData>\n\n/**\n * Faceted min/max values factory function type from v8 API\n */\ntype FacetedMinMaxValuesFactory<TData extends RowData> = (\n  table: Table<StockFeatures, TData>,\n  columnId: string,\n) => () => undefined | [number, number]\n\n/**\n * Faceted unique values factory function type from v8 API\n */\ntype FacetedUniqueValuesFactory<TData extends RowData> = (\n  table: Table<StockFeatures, TData>,\n  columnId: string,\n) => () => Map<any, number>\n\n/**\n * Legacy v8-style row model options\n */\nexport interface LegacyRowModelOptions<TData extends RowData> {\n  /**\n   * Returns the core row model for the table.\n   * @deprecated This option is no longer needed in v9. The core row model is always created automatically.\n   */\n  getCoreRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the filtered row model for the table.\n   * @deprecated Use `_rowModels.filteredRowModel` with `createFilteredRowModel(filterFns)` instead.\n   */\n  getFilteredRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the sorted row model for the table.\n   * @deprecated Use `_rowModels.sortedRowModel` with `createSortedRowModel(sortFns)` instead.\n   */\n  getSortedRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the paginated row model for the table.\n   * @deprecated Use `_rowModels.paginatedRowModel` with `createPaginatedRowModel()` instead.\n   */\n  getPaginationRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the expanded row model for the table.\n   * @deprecated Use `_rowModels.expandedRowModel` with `createExpandedRowModel()` instead.\n   */\n  getExpandedRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the grouped row model for the table.\n   * @deprecated Use `_rowModels.groupedRowModel` with `createGroupedRowModel(aggregationFns)` instead.\n   */\n  getGroupedRowModel?: RowModelFactory<TData>\n  /**\n   * Returns the faceted row model for a column.\n   * @deprecated Use `_rowModels.facetedRowModel` with `createFacetedRowModel()` instead.\n   */\n  getFacetedRowModel?: FacetedRowModelFactory<TData>\n  /**\n   * Returns the faceted min/max values for a column.\n   * @deprecated Use `_rowModels.facetedMinMaxValues` with `createFacetedMinMaxValues()` instead.\n   */\n  getFacetedMinMaxValues?: FacetedMinMaxValuesFactory<TData>\n  /**\n   * Returns the faceted unique values for a column.\n   * @deprecated Use `_rowModels.facetedUniqueValues` with `createFacetedUniqueValues()` instead.\n   */\n  getFacetedUniqueValues?: FacetedUniqueValuesFactory<TData>\n  /**\n   * Additional filter functions to apply to the table.\n   * @deprecated Use `_rowModels.filteredRowModel` with `createFilteredRowModel(filterFns)` instead.\n   */\n  filterFns?: FilterFns\n  /**\n   * Additional sort functions to apply to the table.\n   * @deprecated Use `_rowModels.sortedRowModel` with `createSortedRowModel(sortFns)` instead.\n   */\n  sortFns?: SortFns\n  /**\n   * Additional aggregation functions to apply to the table.\n   * @deprecated Use `_rowModels.groupedRowModel` with `createGroupedRowModel(aggregationFns)` instead.\n   */\n  aggregationFns?: AggregationFns\n}\n\n/**\n * Legacy v8-style table options that work with useLegacyTable.\n *\n * This type omits `_features` and `_rowModels` and instead accepts the v8-style\n * `get*RowModel` function options.\n *\n * @deprecated This is a compatibility layer for migrating from v8. Use `useTable` with explicit `_features` and `_rowModels` instead.\n */\nexport type LegacyTableOptions<TData extends RowData> = Omit<\n  TableOptions<StockFeatures, TData>,\n  '_features' | '_rowModels'\n> &\n  LegacyRowModelOptions<TData>\n\n/**\n * Legacy table instance type that includes the v8-style `getState()` method.\n *\n * @deprecated Use `useTable` with explicit state selection instead.\n */\nexport type LegacyReactTable<TData extends RowData> = ReactTable<\n  StockFeatures,\n  TData,\n  TableState<StockFeatures>\n> & {\n  /**\n   * Returns the current table state.\n   * @deprecated In v9, access state directly via `table.state` or use `table.store.state` for the full state.\n   */\n  getState: () => TableState<StockFeatures>\n  /**\n   * Sets the current table state.\n   * @deprecated In v9, access state directly via `table.baseAtoms`\n   */\n  setState: (state: TableState<StockFeatures>) => void\n}\n\n// =============================================================================\n// Legacy type aliases - StockFeatures hardcoded for simpler prop typing with useLegacyTable\n// =============================================================================\n\n/** @deprecated Use Column<TFeatures, TData, TValue> with useTable instead. */\nexport type LegacyColumn<TData extends RowData, TValue = unknown> = Column<\n  StockFeatures,\n  TData,\n  TValue\n>\n\n/** @deprecated Use Row<TFeatures, TData> with useTable instead. */\nexport type LegacyRow<TData extends RowData> = Row<StockFeatures, TData>\n\n/** @deprecated Use Cell<TFeatures, TData, TValue> with useTable instead. */\nexport type LegacyCell<TData extends RowData, TValue = unknown> = Cell<\n  StockFeatures,\n  TData,\n  TValue\n>\n\n/** @deprecated Use Header<TFeatures, TData, TValue> with useTable instead. */\nexport type LegacyHeader<TData extends RowData, TValue = unknown> = Header<\n  StockFeatures,\n  TData,\n  TValue\n>\n\n/** @deprecated Use HeaderGroup<TFeatures, TData> with useTable instead. */\nexport type LegacyHeaderGroup<TData extends RowData> = HeaderGroup<\n  StockFeatures,\n  TData\n>\n\n/** @deprecated Use ColumnDef<TFeatures, TData, TValue> with useTable instead. */\nexport type LegacyColumnDef<\n  TData extends RowData,\n  TValue = unknown,\n> = ColumnDef<StockFeatures, TData, TValue>\n\n/** @deprecated Use Table<TFeatures, TData> with useTable instead. */\nexport type LegacyTable<TData extends RowData> = Table<StockFeatures, TData>\n\n// =============================================================================\n// Legacy column helper - StockFeatures hardcoded\n// =============================================================================\n\n/**\n * @deprecated Use `createColumnHelper<TFeatures, TData>()` with useTable instead.\n *\n * A column helper with StockFeatures pre-bound for use with useLegacyTable.\n * Only requires TData—no need to specify TFeatures.\n */\nexport function legacyCreateColumnHelper<TData extends RowData>() {\n  return createColumnHelper<StockFeatures, TData>()\n}\n\n// =============================================================================\n// useLegacyTable hook\n// =============================================================================\n\n/**\n * @deprecated This hook is provided as a compatibility layer for migrating from TanStack Table v8.\n *\n * Use the new `useTable` hook instead with explicit `_features` and `_rowModels`:\n *\n * ```tsx\n * // New v9 API\n * const _features = tableFeatures({\n *   columnFilteringFeature,\n *   rowSortingFeature,\n *   rowPaginationFeature,\n * })\n *\n * const table = useTable({\n *   _features,\n *   _rowModels: {\n *     filteredRowModel: createFilteredRowModel(filterFns),\n *     sortedRowModel: createSortedRowModel(sortFns),\n *     paginatedRowModel: createPaginatedRowModel(),\n *   },\n *   columns,\n *   data,\n * })\n * ```\n *\n * Key differences from v8:\n * - Features are tree-shakeable - only import what you use\n * - Row models are explicitly passed via `_rowModels`\n * - Use `table.Subscribe` for fine-grained re-renders\n * - State is accessed via `table.state` after selecting with the 2nd argument\n *\n * @param options - Legacy v8-style table options\n * @returns A table instance with the full state subscribed and a `getState()` method\n */\nexport function useLegacyTable<TData extends RowData>(\n  options: LegacyTableOptions<TData>,\n): LegacyReactTable<TData> {\n  const {\n    // Extract legacy row model options\n    getCoreRowModel: _getCoreRowModel,\n    getFilteredRowModel,\n    getSortedRowModel,\n    getPaginationRowModel,\n    getExpandedRowModel,\n    getGroupedRowModel,\n    getFacetedRowModel,\n    getFacetedMinMaxValues,\n    getFacetedUniqueValues,\n    // Rest of the options\n    ...restOptions\n  } = options\n\n  // Build the _rowModels object based on which legacy options were provided\n  const _rowModels: CreateRowModels_All<StockFeatures, TData> = {}\n\n  // Map v8 row model factories to v9 _rowModels\n  // Note: getCoreRowModel is handled automatically in v9, so we ignore it\n\n  if (getFilteredRowModel) {\n    _rowModels.filteredRowModel = createFilteredRowModel({\n      ...filterFns,\n      ...options.filterFns,\n    })\n  }\n\n  if (getSortedRowModel) {\n    _rowModels.sortedRowModel = createSortedRowModel({\n      ...sortFns,\n      ...options.sortFns,\n    })\n  }\n\n  if (getPaginationRowModel) {\n    _rowModels.paginatedRowModel = createPaginatedRowModel()\n  }\n\n  if (getExpandedRowModel) {\n    _rowModels.expandedRowModel = createExpandedRowModel()\n  }\n\n  if (getGroupedRowModel) {\n    _rowModels.groupedRowModel = createGroupedRowModel({\n      ...aggregationFns,\n      ...options.aggregationFns,\n    })\n  }\n\n  if (getFacetedRowModel) {\n    _rowModels.facetedRowModel = createFacetedRowModel()\n  }\n\n  if (getFacetedMinMaxValues) {\n    _rowModels.facetedMinMaxValues = createFacetedMinMaxValues()\n  }\n\n  if (getFacetedUniqueValues) {\n    _rowModels.facetedUniqueValues = createFacetedUniqueValues()\n  }\n\n  // Call useTable with the v9 API, subscribing to all state changes\n  const table = useTable<StockFeatures, TData, TableState<StockFeatures>>(\n    {\n      ...restOptions,\n      _features: stockFeatures,\n      _rowModels,\n    } as TableOptions<StockFeatures, TData>,\n    (state) => state,\n  )\n\n  const getState = useCallback(() => {\n    // all state except for columns and data\n    return {\n      ...table.state,\n      columns: undefined,\n      data: undefined,\n    }\n  }, [table])\n\n  const setState = useCallback(\n    (state: TableState<StockFeatures>) => {\n      Object.entries(state).forEach(([key, value]) => {\n        // @ts-expect-error - baseAtoms is indexed by dynamic string keys\n        table.baseAtoms[key].set(value)\n      })\n    },\n    [table],\n  )\n\n  return useMemo(\n    () =>\n      ({\n        ...table,\n        getState,\n        setState,\n      }) as LegacyReactTable<TData>,\n    [table, getState, setState],\n  )\n}\n"],"mappings":";;;;;;;;;;;;;AAoDA,SAAgB,sBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,oBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,wBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,sBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,qBAEY;AAC1B,qBAAoB;;;;;;;;AAStB,SAAgB,qBAEmB;AACjC,qBAAoB;;;;;;;;AAStB,SAAgB,yBAEuB;AACrC,qBAAoB;;;;;;;;AAStB,SAAgB,yBAEuB;AACrC,qCAAoB,IAAI,KAAK;;;;;;;;AAS/B,SAAgB,kBAEY;AAC1B,qBAAoB;;;;;;;;AAiMtB,SAAgB,2BAAkD;AAChE,QAAO,oBAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCnD,SAAgB,eACd,SACyB;CACzB,MAAM,EAEJ,iBAAiB,kBACjB,qBACA,mBACA,uBACA,qBACA,oBACA,oBACA,wBACA,wBAEA,GAAG,gBACD;CAGJ,MAAM,aAAwD,EAAE;AAKhE,KAAI,oBACF,YAAW,mBAAmB,uBAAuB;EACnD,GAAG;EACH,GAAG,QAAQ;EACZ,CAAC;AAGJ,KAAI,kBACF,YAAW,iBAAiB,qBAAqB;EAC/C,GAAG;EACH,GAAG,QAAQ;EACZ,CAAC;AAGJ,KAAI,sBACF,YAAW,oBAAoB,yBAAyB;AAG1D,KAAI,oBACF,YAAW,mBAAmB,wBAAwB;AAGxD,KAAI,mBACF,YAAW,kBAAkB,sBAAsB;EACjD,GAAG;EACH,GAAG,QAAQ;EACZ,CAAC;AAGJ,KAAI,mBACF,YAAW,kBAAkB,uBAAuB;AAGtD,KAAI,uBACF,YAAW,sBAAsB,2BAA2B;AAG9D,KAAI,uBACF,YAAW,sBAAsB,2BAA2B;CAI9D,MAAM,QAAQ,SACZ;EACE,GAAG;EACH,WAAW;EACX;EACD,GACA,UAAU,MACZ;CAED,MAAM,WAAW,kBAAkB;AAEjC,SAAO;GACL,GAAG,MAAM;GACT,SAAS;GACT,MAAM;GACP;IACA,CAAC,MAAM,CAAC;CAEX,MAAM,WAAW,aACd,UAAqC;AACpC,SAAO,QAAQ,MAAM,CAAC,SAAS,CAAC,KAAK,WAAW;AAE9C,SAAM,UAAU,KAAK,IAAI,MAAM;IAC/B;IAEJ,CAAC,MAAM,CACR;AAED,QAAO,eAEF;EACC,GAAG;EACH;EACA;EACD,GACH;EAAC;EAAO;EAAU;EAAS,CAC5B"}

package/dist/useTable.cjs

@@ -11,12 +11,12 @@ let _tanstack_react_store = require("@tanstack/react-store");
 function useTable(tableOptions, selector = () => ({})) {
 	const [table] = (0, react.useState)(() => {
 		const tableInstance = (0, _tanstack_table_core.constructTable)(tableOptions);
-		tableInstance.Subscribe = function SubscribeBound(props) {
+		tableInstance.Subscribe = ((props) => {
 			return require_Subscribe.Subscribe({
 				...props,
 				table: tableInstance
 			});
-		};
+		});
 		tableInstance.FlexRender = require_FlexRender.FlexRender;
 		return tableInstance;
 	});

package/dist/useTable.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useTable.cjs","names":["Subscribe","FlexRender","shallow"],"sources":["../src/useTable.ts"],"sourcesContent":["'use client'\n\nimport { useMemo, useState } from 'react'\nimport { constructTable } from '@tanstack/table-core'\nimport { shallow, useSelector } from '@tanstack/react-store'\nimport { FlexRender } from './FlexRender'\nimport { Subscribe } from './Subscribe'\nimport type {\n  CellData,\n  NoInfer,\n  RowData,\n  Table,\n  TableFeatures,\n  TableOptions,\n  TableState,\n} from '@tanstack/table-core'\nimport type { FunctionComponent, ReactNode } from 'react'\nimport type { FlexRenderProps } from './FlexRender'\nimport type { SubscribeProps } from './Subscribe'\n\nexport type ReactTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected = {},\n> = Table<TFeatures, TData> & {\n  /**\n   * A React HOC (Higher Order Component) that allows you to subscribe to the table state.\n   *\n   * This is useful for opting into state re-renders for specific parts of the table state.\n   *\n   * @example\n   * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>\n   *   {({ rowSelection }) => ( // important to include `{() => {()}}` syntax\n   *     <tr key={row.id}>\n            // render the row\n   *     </tr>\n   *   ))}\n   * </table.Subscribe>\n   */\n  Subscribe: <TSelected>(props: {\n    selector: (state: NoInfer<TableState<TFeatures>>) => TSelected\n    children: ((state: TSelected) => ReactNode) | ReactNode\n  }) => ReturnType<FunctionComponent>\n  /**\n   * A React component that renders headers, cells, or footers with custom markup.\n   * Use this utility component instead of manually calling flexRender.\n   *\n   * @example\n   * ```tsx\n   * <table.FlexRender cell={cell} />\n   * <table.FlexRender header={header} />\n   * <table.FlexRender footer={footer} />\n   * ```\n   *\n   * This replaces calling `flexRender` directly like this:\n   * ```tsx\n   * flexRender(cell.column.columnDef.cell, cell.getContext())\n   * flexRender(header.column.columnDef.header, header.getContext())\n   * flexRender(footer.column.columnDef.footer, footer.getContext())\n   * ```\n   */\n  FlexRender: <TValue extends CellData = CellData>(\n    props: FlexRenderProps<TFeatures, TData, TValue>,\n  ) => ReactNode\n  /**\n   * The selected state of the table. This state may not match the structure of `table.store.state` because it is selected by the `selector` function that you pass as the 2nd argument to `useTable`.\n   *\n   * @example\n   * const table = useTable(options, (state) => ({ globalFilter: state.globalFilter })) // only globalFilter is part of the selected state\n   *\n   * console.log(table.state.globalFilter)\n   */\n  readonly state: Readonly<TSelected> & {\n    columns: TableOptions<TFeatures, TData>['columns']\n    data: TableOptions<TFeatures, TData>['data']\n  }\n}\n\nexport function useTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected = {},\n>(\n  tableOptions: TableOptions<TFeatures, TData>,\n  selector: (state: TableState<TFeatures>) => TSelected = () =>\n    ({}) as TSelected,\n): ReactTable<TFeatures, TData, TSelected> {\n  const [table] = useState(() => {\n    const tableInstance = constructTable(tableOptions) as ReactTable<\n      TFeatures,\n      TData,\n      TSelected\n    >\n\n    tableInstance.Subscribe = function SubscribeBound<TSelected>(\n      props: Omit<SubscribeProps<TFeatures, TData, TSelected>, 'table'>,\n    ) {\n      return Subscribe({ ...props, table: tableInstance })\n    }\n\n    tableInstance.FlexRender = FlexRender\n\n    return tableInstance\n  })\n\n  // sync table options on every render\n  table.setOptions((prev) => ({\n    ...prev,\n    ...tableOptions,\n  }))\n\n  const selectorWithDataAndColumns = (state: TableState<TFeatures>) => ({\n    columns: tableOptions.columns,\n    data: tableOptions.data,\n    ...selector(state),\n  })\n\n  const state = useSelector(table.store, selectorWithDataAndColumns, {\n    compare: shallow,\n  })\n\n  return useMemo(\n    () => ({\n      ...table,\n      state,\n    }),\n    [state, table],\n  ) as ReactTable<TFeatures, TData, TSelected>\n}\n"],"mappings":";;;;;;;;;;AA8EA,SAAgB,SAKd,cACA,kBACG,EAAE,GACoC;CACzC,MAAM,CAAC,mCAAwB;EAC7B,MAAM,yDAA+B,aAAa;AAMlD,gBAAc,YAAY,SAAS,eACjC,OACA;AACA,UAAOA,4BAAU;IAAE,GAAG;IAAO,OAAO;IAAe,CAAC;;AAGtD,gBAAc,aAAaC;AAE3B,SAAO;GACP;AAGF,OAAM,YAAY,UAAU;EAC1B,GAAG;EACH,GAAG;EACJ,EAAE;CAEH,MAAM,8BAA8B,WAAkC;EACpE,SAAS,aAAa;EACtB,MAAM,aAAa;EACnB,GAAG,SAAS,MAAM;EACnB;CAED,MAAM,+CAAoB,MAAM,OAAO,4BAA4B,EACjE,SAASC,+BACV,CAAC;AAEF,kCACS;EACL,GAAG;EACH;EACD,GACD,CAAC,OAAO,MAAM,CACf"}
+{"version":3,"file":"useTable.cjs","names":["Subscribe","FlexRender","shallow"],"sources":["../src/useTable.ts"],"sourcesContent":["'use client'\n\nimport { useMemo, useState } from 'react'\nimport { constructTable } from '@tanstack/table-core'\nimport { shallow, useSelector } from '@tanstack/react-store'\nimport { FlexRender } from './FlexRender'\nimport { Subscribe } from './Subscribe'\nimport type {\n  CellData,\n  RowData,\n  Table,\n  TableFeatures,\n  TableOptions,\n  TableState,\n} from '@tanstack/table-core'\nimport type { Atom, ReadonlyAtom } from '@tanstack/react-store'\nimport type { FunctionComponent, ReactNode } from 'react'\nimport type { FlexRenderProps } from './FlexRender'\nimport type { SubscribePropsWithStore } from './Subscribe'\n\nexport type ReactTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected = {},\n> = Table<TFeatures, TData> & {\n  /**\n   * A React HOC (Higher Order Component) that allows you to subscribe to the table state.\n   *\n   * This is useful for opting into state re-renders for specific parts of the table state.\n   *\n   * Pass `atom` to subscribe to a single slice atom instead of the full `table.store`.\n   *\n   * @example\n   * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>\n   *   {({ rowSelection }) => (\n   *     <tr key={row.id}>...</tr>\n   *   )}\n   * </table.Subscribe>\n   *\n   * @example\n   * <table.Subscribe atom={table.atoms.rowSelection}>\n   *   {(rowSelection) => <div>...</div>}\n   * </table.Subscribe>\n   *\n   * @example\n   * <table.Subscribe atom={table.atoms.rowSelection} selector={(s) => s?.[row.id]}>\n   *   {() => <tr key={row.id}>...</tr>}\n   * </table.Subscribe>\n   */\n  /**\n   * Overloads (not a single union) so `selector` callbacks get correct contextual\n   * types in JSX; a union of two `selector` signatures degrades to implicit `any`.\n   *\n   * Atom **without** `selector` is a separate overload so children receive `TAtomValue`\n   * (identity projection). If `selector` were optional on one overload, `TSubSelected`\n   * would default to `unknown` instead of inferring from the atom.\n   *\n   * The **atom** overloads are listed first so `TAtomValue` is inferred from `atom`.\n   */\n  Subscribe: {\n    <TAtomValue>(props: {\n      atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>\n      selector?: undefined\n      children: ((state: TAtomValue) => ReactNode) | ReactNode\n    }): ReturnType<FunctionComponent>\n    <TAtomValue, TSubSelected>(props: {\n      atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>\n      selector: (state: TAtomValue) => TSubSelected\n      children: ((state: TSubSelected) => ReactNode) | ReactNode\n    }): ReturnType<FunctionComponent>\n    <TSubSelected>(\n      props: Omit<\n        SubscribePropsWithStore<TFeatures, TData, TSubSelected>,\n        'table'\n      >,\n    ): ReturnType<FunctionComponent>\n  }\n  /**\n   * A React component that renders headers, cells, or footers with custom markup.\n   * Use this utility component instead of manually calling flexRender.\n   *\n   * @example\n   * ```tsx\n   * <table.FlexRender cell={cell} />\n   * <table.FlexRender header={header} />\n   * <table.FlexRender footer={footer} />\n   * ```\n   *\n   * This replaces calling `flexRender` directly like this:\n   * ```tsx\n   * flexRender(cell.column.columnDef.cell, cell.getContext())\n   * flexRender(header.column.columnDef.header, header.getContext())\n   * flexRender(footer.column.columnDef.footer, footer.getContext())\n   * ```\n   */\n  FlexRender: <TValue extends CellData = CellData>(\n    props: FlexRenderProps<TFeatures, TData, TValue>,\n  ) => ReactNode\n  /**\n   * The selected state of the table. This state may not match the structure of `table.store.state` because it is selected by the `selector` function that you pass as the 2nd argument to `useTable`.\n   *\n   * @example\n   * const table = useTable(options, (state) => ({ globalFilter: state.globalFilter })) // only globalFilter is part of the selected state\n   *\n   * console.log(table.state.globalFilter)\n   */\n  readonly state: Readonly<TSelected> & {\n    columns: TableOptions<TFeatures, TData>['columns']\n    data: TableOptions<TFeatures, TData>['data']\n  }\n}\n\nexport function useTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected = {},\n>(\n  tableOptions: TableOptions<TFeatures, TData>,\n  selector: (state: TableState<TFeatures>) => TSelected = () =>\n    ({}) as TSelected,\n): ReactTable<TFeatures, TData, TSelected> {\n  const [table] = useState(() => {\n    const tableInstance = constructTable(tableOptions) as ReactTable<\n      TFeatures,\n      TData,\n      TSelected\n    >\n\n    tableInstance.Subscribe = ((props: any) => {\n      return Subscribe({\n        ...props,\n        table: tableInstance,\n      })\n    }) as ReactTable<TFeatures, TData, TSelected>['Subscribe']\n\n    tableInstance.FlexRender = FlexRender\n\n    return tableInstance\n  })\n\n  // sync table options on every render\n  table.setOptions((prev) => ({\n    ...prev,\n    ...tableOptions,\n  }))\n\n  const selectorWithDataAndColumns = (state: TableState<TFeatures>) => ({\n    columns: tableOptions.columns,\n    data: tableOptions.data,\n    ...selector(state),\n  })\n\n  const state = useSelector(table.store, selectorWithDataAndColumns, {\n    compare: shallow,\n  })\n\n  return useMemo(\n    () => ({\n      ...table,\n      state,\n    }),\n    [state, table],\n  ) as ReactTable<TFeatures, TData, TSelected>\n}\n"],"mappings":";;;;;;;;;;AAgHA,SAAgB,SAKd,cACA,kBACG,EAAE,GACoC;CACzC,MAAM,CAAC,mCAAwB;EAC7B,MAAM,yDAA+B,aAAa;AAMlD,gBAAc,cAAc,UAAe;AACzC,UAAOA,4BAAU;IACf,GAAG;IACH,OAAO;IACR,CAAC;;AAGJ,gBAAc,aAAaC;AAE3B,SAAO;GACP;AAGF,OAAM,YAAY,UAAU;EAC1B,GAAG;EACH,GAAG;EACJ,EAAE;CAEH,MAAM,8BAA8B,WAAkC;EACpE,SAAS,aAAa;EACtB,MAAM,aAAa;EACnB,GAAG,SAAS,MAAM;EACnB;CAED,MAAM,+CAAoB,MAAM,OAAO,4BAA4B,EACjE,SAASC,+BACV,CAAC;AAEF,kCACS;EACL,GAAG;EACH;EACD,GACD,CAAC,OAAO,MAAM,CACf"}

package/dist/useTable.d.cts

@@ -1,6 +1,8 @@
 import { FlexRenderProps } from "./FlexRender.cjs";
-import { CellData, NoInfer, RowData, Table, TableFeatures, TableOptions, TableState } from "@tanstack/table-core";
+import { SubscribePropsWithStore } from "./Subscribe.cjs";
+import { CellData, RowData, Table, TableFeatures, TableOptions, TableState } from "@tanstack/table-core";
 import { FunctionComponent, ReactNode } from "react";
+import { Atom, ReadonlyAtom } from "@tanstack/react-store";
 
 //#region src/useTable.d.ts
 type ReactTable<TFeatures extends TableFeatures, TData extends RowData, TSelected = {}> = Table<TFeatures, TData> & {
@@ -9,19 +11,48 @@ type ReactTable<TFeatures extends TableFeatures, TData extends RowData, TSelecte
    *
    * This is useful for opting into state re-renders for specific parts of the table state.
    *
+   * Pass `atom` to subscribe to a single slice atom instead of the full `table.store`.
+   *
    * @example
    * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>
-   *   {({ rowSelection }) => ( // important to include `{() => {()}}` syntax
-   *     <tr key={row.id}>
-            // render the row
-   *     </tr>
-   *   ))}
+   *   {({ rowSelection }) => (
+   *     <tr key={row.id}>...</tr>
+   *   )}
+   * </table.Subscribe>
+   *
+   * @example
+   * <table.Subscribe atom={table.atoms.rowSelection}>
+   *   {(rowSelection) => <div>...</div>}
+   * </table.Subscribe>
+   *
+   * @example
+   * <table.Subscribe atom={table.atoms.rowSelection} selector={(s) => s?.[row.id]}>
+   *   {() => <tr key={row.id}>...</tr>}
    * </table.Subscribe>
    */
-  Subscribe: <TSelected>(props: {
-    selector: (state: NoInfer<TableState<TFeatures>>) => TSelected;
-    children: ((state: TSelected) => ReactNode) | ReactNode;
-  }) => ReturnType<FunctionComponent>;
+  /**
+   * Overloads (not a single union) so `selector` callbacks get correct contextual
+   * types in JSX; a union of two `selector` signatures degrades to implicit `any`.
+   *
+   * Atom **without** `selector` is a separate overload so children receive `TAtomValue`
+   * (identity projection). If `selector` were optional on one overload, `TSubSelected`
+   * would default to `unknown` instead of inferring from the atom.
+   *
+   * The **atom** overloads are listed first so `TAtomValue` is inferred from `atom`.
+   */
+  Subscribe: {
+    <TAtomValue>(props: {
+      atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>;
+      selector?: undefined;
+      children: ((state: TAtomValue) => ReactNode) | ReactNode;
+    }): ReturnType<FunctionComponent>;
+    <TAtomValue, TSubSelected>(props: {
+      atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>;
+      selector: (state: TAtomValue) => TSubSelected;
+      children: ((state: TSubSelected) => ReactNode) | ReactNode;
+    }): ReturnType<FunctionComponent>;
+    <TSubSelected>(props: Omit<SubscribePropsWithStore<TFeatures, TData, TSubSelected>, 'table'>): ReturnType<FunctionComponent>;
+  };
   /**
    * A React component that renders headers, cells, or footers with custom markup.
    * Use this utility component instead of manually calling flexRender.

package/dist/useTable.d.ts

@@ -1,6 +1,8 @@
 import { FlexRenderProps } from "./FlexRender.js";
-import { CellData, NoInfer, RowData, Table, TableFeatures, TableOptions, TableState } from "@tanstack/table-core";
+import { SubscribePropsWithStore } from "./Subscribe.js";
+import { CellData, RowData, Table, TableFeatures, TableOptions, TableState } from "@tanstack/table-core";
 import { FunctionComponent, ReactNode } from "react";
+import { Atom, ReadonlyAtom } from "@tanstack/react-store";
 
 //#region src/useTable.d.ts
 type ReactTable<TFeatures extends TableFeatures, TData extends RowData, TSelected = {}> = Table<TFeatures, TData> & {
@@ -9,19 +11,48 @@ type ReactTable<TFeatures extends TableFeatures, TData extends RowData, TSelecte
    *
    * This is useful for opting into state re-renders for specific parts of the table state.
    *
+   * Pass `atom` to subscribe to a single slice atom instead of the full `table.store`.
+   *
    * @example
    * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>
-   *   {({ rowSelection }) => ( // important to include `{() => {()}}` syntax
-   *     <tr key={row.id}>
-            // render the row
-   *     </tr>
-   *   ))}
+   *   {({ rowSelection }) => (
+   *     <tr key={row.id}>...</tr>
+   *   )}
+   * </table.Subscribe>
+   *
+   * @example
+   * <table.Subscribe atom={table.atoms.rowSelection}>
+   *   {(rowSelection) => <div>...</div>}
+   * </table.Subscribe>
+   *
+   * @example
+   * <table.Subscribe atom={table.atoms.rowSelection} selector={(s) => s?.[row.id]}>
+   *   {() => <tr key={row.id}>...</tr>}
    * </table.Subscribe>
    */
-  Subscribe: <TSelected>(props: {
-    selector: (state: NoInfer<TableState<TFeatures>>) => TSelected;
-    children: ((state: TSelected) => ReactNode) | ReactNode;
-  }) => ReturnType<FunctionComponent>;
+  /**
+   * Overloads (not a single union) so `selector` callbacks get correct contextual
+   * types in JSX; a union of two `selector` signatures degrades to implicit `any`.
+   *
+   * Atom **without** `selector` is a separate overload so children receive `TAtomValue`
+   * (identity projection). If `selector` were optional on one overload, `TSubSelected`
+   * would default to `unknown` instead of inferring from the atom.
+   *
+   * The **atom** overloads are listed first so `TAtomValue` is inferred from `atom`.
+   */
+  Subscribe: {
+    <TAtomValue>(props: {
+      atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>;
+      selector?: undefined;
+      children: ((state: TAtomValue) => ReactNode) | ReactNode;
+    }): ReturnType<FunctionComponent>;
+    <TAtomValue, TSubSelected>(props: {
+      atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>;
+      selector: (state: TAtomValue) => TSubSelected;
+      children: ((state: TSubSelected) => ReactNode) | ReactNode;
+    }): ReturnType<FunctionComponent>;
+    <TSubSelected>(props: Omit<SubscribePropsWithStore<TFeatures, TData, TSubSelected>, 'table'>): ReturnType<FunctionComponent>;
+  };
   /**
    * A React component that renders headers, cells, or footers with custom markup.
    * Use this utility component instead of manually calling flexRender.

package/dist/useTable.js

@@ -10,12 +10,12 @@ import { shallow, useSelector } from "@tanstack/react-store";
 function useTable(tableOptions, selector = () => ({})) {
 	const [table] = useState(() => {
 		const tableInstance = constructTable(tableOptions);
-		tableInstance.Subscribe = function SubscribeBound(props) {
+		tableInstance.Subscribe = ((props) => {
 			return Subscribe({
 				...props,
 				table: tableInstance
 			});
-		};
+		});
 		tableInstance.FlexRender = FlexRender;
 		return tableInstance;
 	});

package/dist/useTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTable.js","names":[],"sources":["../src/useTable.ts"],"sourcesContent":["'use client'\n\nimport { useMemo, useState } from 'react'\nimport { constructTable } from '@tanstack/table-core'\nimport { shallow, useSelector } from '@tanstack/react-store'\nimport { FlexRender } from './FlexRender'\nimport { Subscribe } from './Subscribe'\nimport type {\n  CellData,\n  NoInfer,\n  RowData,\n  Table,\n  TableFeatures,\n  TableOptions,\n  TableState,\n} from '@tanstack/table-core'\nimport type { FunctionComponent, ReactNode } from 'react'\nimport type { FlexRenderProps } from './FlexRender'\nimport type { SubscribeProps } from './Subscribe'\n\nexport type ReactTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected = {},\n> = Table<TFeatures, TData> & {\n  /**\n   * A React HOC (Higher Order Component) that allows you to subscribe to the table state.\n   *\n   * This is useful for opting into state re-renders for specific parts of the table state.\n   *\n   * @example\n   * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>\n   *   {({ rowSelection }) => ( // important to include `{() => {()}}` syntax\n   *     <tr key={row.id}>\n            // render the row\n   *     </tr>\n   *   ))}\n   * </table.Subscribe>\n   */\n  Subscribe: <TSelected>(props: {\n    selector: (state: NoInfer<TableState<TFeatures>>) => TSelected\n    children: ((state: TSelected) => ReactNode) | ReactNode\n  }) => ReturnType<FunctionComponent>\n  /**\n   * A React component that renders headers, cells, or footers with custom markup.\n   * Use this utility component instead of manually calling flexRender.\n   *\n   * @example\n   * ```tsx\n   * <table.FlexRender cell={cell} />\n   * <table.FlexRender header={header} />\n   * <table.FlexRender footer={footer} />\n   * ```\n   *\n   * This replaces calling `flexRender` directly like this:\n   * ```tsx\n   * flexRender(cell.column.columnDef.cell, cell.getContext())\n   * flexRender(header.column.columnDef.header, header.getContext())\n   * flexRender(footer.column.columnDef.footer, footer.getContext())\n   * ```\n   */\n  FlexRender: <TValue extends CellData = CellData>(\n    props: FlexRenderProps<TFeatures, TData, TValue>,\n  ) => ReactNode\n  /**\n   * The selected state of the table. This state may not match the structure of `table.store.state` because it is selected by the `selector` function that you pass as the 2nd argument to `useTable`.\n   *\n   * @example\n   * const table = useTable(options, (state) => ({ globalFilter: state.globalFilter })) // only globalFilter is part of the selected state\n   *\n   * console.log(table.state.globalFilter)\n   */\n  readonly state: Readonly<TSelected> & {\n    columns: TableOptions<TFeatures, TData>['columns']\n    data: TableOptions<TFeatures, TData>['data']\n  }\n}\n\nexport function useTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected = {},\n>(\n  tableOptions: TableOptions<TFeatures, TData>,\n  selector: (state: TableState<TFeatures>) => TSelected = () =>\n    ({}) as TSelected,\n): ReactTable<TFeatures, TData, TSelected> {\n  const [table] = useState(() => {\n    const tableInstance = constructTable(tableOptions) as ReactTable<\n      TFeatures,\n      TData,\n      TSelected\n    >\n\n    tableInstance.Subscribe = function SubscribeBound<TSelected>(\n      props: Omit<SubscribeProps<TFeatures, TData, TSelected>, 'table'>,\n    ) {\n      return Subscribe({ ...props, table: tableInstance })\n    }\n\n    tableInstance.FlexRender = FlexRender\n\n    return tableInstance\n  })\n\n  // sync table options on every render\n  table.setOptions((prev) => ({\n    ...prev,\n    ...tableOptions,\n  }))\n\n  const selectorWithDataAndColumns = (state: TableState<TFeatures>) => ({\n    columns: tableOptions.columns,\n    data: tableOptions.data,\n    ...selector(state),\n  })\n\n  const state = useSelector(table.store, selectorWithDataAndColumns, {\n    compare: shallow,\n  })\n\n  return useMemo(\n    () => ({\n      ...table,\n      state,\n    }),\n    [state, table],\n  ) as ReactTable<TFeatures, TData, TSelected>\n}\n"],"mappings":";;;;;;;;;AA8EA,SAAgB,SAKd,cACA,kBACG,EAAE,GACoC;CACzC,MAAM,CAAC,SAAS,eAAe;EAC7B,MAAM,gBAAgB,eAAe,aAAa;AAMlD,gBAAc,YAAY,SAAS,eACjC,OACA;AACA,UAAO,UAAU;IAAE,GAAG;IAAO,OAAO;IAAe,CAAC;;AAGtD,gBAAc,aAAa;AAE3B,SAAO;GACP;AAGF,OAAM,YAAY,UAAU;EAC1B,GAAG;EACH,GAAG;EACJ,EAAE;CAEH,MAAM,8BAA8B,WAAkC;EACpE,SAAS,aAAa;EACtB,MAAM,aAAa;EACnB,GAAG,SAAS,MAAM;EACnB;CAED,MAAM,QAAQ,YAAY,MAAM,OAAO,4BAA4B,EACjE,SAAS,SACV,CAAC;AAEF,QAAO,eACE;EACL,GAAG;EACH;EACD,GACD,CAAC,OAAO,MAAM,CACf"}
+{"version":3,"file":"useTable.js","names":[],"sources":["../src/useTable.ts"],"sourcesContent":["'use client'\n\nimport { useMemo, useState } from 'react'\nimport { constructTable } from '@tanstack/table-core'\nimport { shallow, useSelector } from '@tanstack/react-store'\nimport { FlexRender } from './FlexRender'\nimport { Subscribe } from './Subscribe'\nimport type {\n  CellData,\n  RowData,\n  Table,\n  TableFeatures,\n  TableOptions,\n  TableState,\n} from '@tanstack/table-core'\nimport type { Atom, ReadonlyAtom } from '@tanstack/react-store'\nimport type { FunctionComponent, ReactNode } from 'react'\nimport type { FlexRenderProps } from './FlexRender'\nimport type { SubscribePropsWithStore } from './Subscribe'\n\nexport type ReactTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected = {},\n> = Table<TFeatures, TData> & {\n  /**\n   * A React HOC (Higher Order Component) that allows you to subscribe to the table state.\n   *\n   * This is useful for opting into state re-renders for specific parts of the table state.\n   *\n   * Pass `atom` to subscribe to a single slice atom instead of the full `table.store`.\n   *\n   * @example\n   * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>\n   *   {({ rowSelection }) => (\n   *     <tr key={row.id}>...</tr>\n   *   )}\n   * </table.Subscribe>\n   *\n   * @example\n   * <table.Subscribe atom={table.atoms.rowSelection}>\n   *   {(rowSelection) => <div>...</div>}\n   * </table.Subscribe>\n   *\n   * @example\n   * <table.Subscribe atom={table.atoms.rowSelection} selector={(s) => s?.[row.id]}>\n   *   {() => <tr key={row.id}>...</tr>}\n   * </table.Subscribe>\n   */\n  /**\n   * Overloads (not a single union) so `selector` callbacks get correct contextual\n   * types in JSX; a union of two `selector` signatures degrades to implicit `any`.\n   *\n   * Atom **without** `selector` is a separate overload so children receive `TAtomValue`\n   * (identity projection). If `selector` were optional on one overload, `TSubSelected`\n   * would default to `unknown` instead of inferring from the atom.\n   *\n   * The **atom** overloads are listed first so `TAtomValue` is inferred from `atom`.\n   */\n  Subscribe: {\n    <TAtomValue>(props: {\n      atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>\n      selector?: undefined\n      children: ((state: TAtomValue) => ReactNode) | ReactNode\n    }): ReturnType<FunctionComponent>\n    <TAtomValue, TSubSelected>(props: {\n      atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>\n      selector: (state: TAtomValue) => TSubSelected\n      children: ((state: TSubSelected) => ReactNode) | ReactNode\n    }): ReturnType<FunctionComponent>\n    <TSubSelected>(\n      props: Omit<\n        SubscribePropsWithStore<TFeatures, TData, TSubSelected>,\n        'table'\n      >,\n    ): ReturnType<FunctionComponent>\n  }\n  /**\n   * A React component that renders headers, cells, or footers with custom markup.\n   * Use this utility component instead of manually calling flexRender.\n   *\n   * @example\n   * ```tsx\n   * <table.FlexRender cell={cell} />\n   * <table.FlexRender header={header} />\n   * <table.FlexRender footer={footer} />\n   * ```\n   *\n   * This replaces calling `flexRender` directly like this:\n   * ```tsx\n   * flexRender(cell.column.columnDef.cell, cell.getContext())\n   * flexRender(header.column.columnDef.header, header.getContext())\n   * flexRender(footer.column.columnDef.footer, footer.getContext())\n   * ```\n   */\n  FlexRender: <TValue extends CellData = CellData>(\n    props: FlexRenderProps<TFeatures, TData, TValue>,\n  ) => ReactNode\n  /**\n   * The selected state of the table. This state may not match the structure of `table.store.state` because it is selected by the `selector` function that you pass as the 2nd argument to `useTable`.\n   *\n   * @example\n   * const table = useTable(options, (state) => ({ globalFilter: state.globalFilter })) // only globalFilter is part of the selected state\n   *\n   * console.log(table.state.globalFilter)\n   */\n  readonly state: Readonly<TSelected> & {\n    columns: TableOptions<TFeatures, TData>['columns']\n    data: TableOptions<TFeatures, TData>['data']\n  }\n}\n\nexport function useTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected = {},\n>(\n  tableOptions: TableOptions<TFeatures, TData>,\n  selector: (state: TableState<TFeatures>) => TSelected = () =>\n    ({}) as TSelected,\n): ReactTable<TFeatures, TData, TSelected> {\n  const [table] = useState(() => {\n    const tableInstance = constructTable(tableOptions) as ReactTable<\n      TFeatures,\n      TData,\n      TSelected\n    >\n\n    tableInstance.Subscribe = ((props: any) => {\n      return Subscribe({\n        ...props,\n        table: tableInstance,\n      })\n    }) as ReactTable<TFeatures, TData, TSelected>['Subscribe']\n\n    tableInstance.FlexRender = FlexRender\n\n    return tableInstance\n  })\n\n  // sync table options on every render\n  table.setOptions((prev) => ({\n    ...prev,\n    ...tableOptions,\n  }))\n\n  const selectorWithDataAndColumns = (state: TableState<TFeatures>) => ({\n    columns: tableOptions.columns,\n    data: tableOptions.data,\n    ...selector(state),\n  })\n\n  const state = useSelector(table.store, selectorWithDataAndColumns, {\n    compare: shallow,\n  })\n\n  return useMemo(\n    () => ({\n      ...table,\n      state,\n    }),\n    [state, table],\n  ) as ReactTable<TFeatures, TData, TSelected>\n}\n"],"mappings":";;;;;;;;;AAgHA,SAAgB,SAKd,cACA,kBACG,EAAE,GACoC;CACzC,MAAM,CAAC,SAAS,eAAe;EAC7B,MAAM,gBAAgB,eAAe,aAAa;AAMlD,gBAAc,cAAc,UAAe;AACzC,UAAO,UAAU;IACf,GAAG;IACH,OAAO;IACR,CAAC;;AAGJ,gBAAc,aAAa;AAE3B,SAAO;GACP;AAGF,OAAM,YAAY,UAAU;EAC1B,GAAG;EACH,GAAG;EACJ,EAAE;CAEH,MAAM,8BAA8B,WAAkC;EACpE,SAAS,aAAa;EACtB,MAAM,aAAa;EACnB,GAAG,SAAS,MAAM;EACnB;CAED,MAAM,QAAQ,YAAY,MAAM,OAAO,4BAA4B,EACjE,SAAS,SACV,CAAC;AAEF,QAAO,eACE;EACL,GAAG;EACH;EACD,GACD,CAAC,OAAO,MAAM,CACf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/react-table",
-  "version": "9.0.0-alpha.33",
+  "version": "9.0.0-alpha.34",
   "description": "Headless UI for building powerful tables & datagrids for React.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -33,6 +33,10 @@
       "import": "./dist/legacy.js",
       "require": "./dist/legacy.cjs"
     },
+    "./static-functions": {
+      "import": "./dist/static-functions.js",
+      "require": "./dist/static-functions.cjs"
+    },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
@@ -45,7 +49,7 @@
   ],
   "dependencies": {
     "@tanstack/react-store": "^0.11.0",
-    "@tanstack/table-core": "9.0.0-alpha.33"
+    "@tanstack/table-core": "9.0.0-alpha.34"
   },
   "devDependencies": {
     "@eslint-react/eslint-plugin": "^4.2.3",

package/src/Subscribe.ts

@@ -1,8 +1,8 @@
 'use client'
 
 import { shallow, useSelector } from '@tanstack/react-store'
+import type { Atom, ReadonlyAtom } from '@tanstack/react-store'
 import type {
-  NoInfer,
   RowData,
   Table,
   TableFeatures,
@@ -10,35 +10,94 @@ import type {
 } from '@tanstack/table-core'
 import type { FunctionComponent, ReactNode } from 'react'
 
-export type SubscribeProps<
+/**
+ * Subscribe to `table.store` (full table state). The selector receives the full
+ * {@link TableState}.
+ */
+export type SubscribePropsWithStore<
   TFeatures extends TableFeatures,
   TData extends RowData,
-  TSelected = {},
+  TSelected,
 > = {
-  /**
-   * The table instance to subscribe to. Required when using as a standalone component.
-   * Not needed when using as `table.Subscribe`.
-   */
   table: Table<TFeatures, TData>
   /**
-   * A selector function that selects the part of the table state to subscribe to.
-   * This allows for fine-grained reactivity by only re-rendering when the selected state changes.
-   */
-  selector: (state: NoInfer<TableState<TFeatures>>) => TSelected
-  /**
-   * The children to render. Can be a function that receives the selected state, or a React node.
+   * Select from full table state. Re-renders when the selected value changes
+   * (shallow compare).
+   *
+   * Required in store mode so you never accidentally subscribe to the whole
+   * store without an explicit projection.
    */
+  selector: (state: TableState<TFeatures>) => TSelected
   children: ((state: TSelected) => ReactNode) | ReactNode
 }
 
+/**
+ * Subscribe to the full value of a slice atom (e.g. `table.atoms.rowSelection`).
+ * Omitting `selector` is equivalent to the identity selector — children receive
+ * `TAtomValue`.
+ */
+export type SubscribePropsWithAtomIdentity<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TAtomValue,
+> = {
+  table: Table<TFeatures, TData>
+  atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>
+  selector?: undefined
+  children: ((state: TAtomValue) => ReactNode) | ReactNode
+}
+
+/**
+ * Subscribe to a projected value from a slice atom. The selector receives the
+ * atom value; children receive the projected `TSelected`.
+ */
+export type SubscribePropsWithAtomWithSelector<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TAtomValue,
+  TSelected,
+> = {
+  table: Table<TFeatures, TData>
+  atom: Atom<TAtomValue> | ReadonlyAtom<TAtomValue>
+  selector: (state: TAtomValue) => TSelected
+  children: ((state: TSelected) => ReactNode) | ReactNode
+}
+
+/**
+ * Subscribe to a single slice atom (identity or projected). Prefer
+ * {@link SubscribePropsWithAtomIdentity} or {@link SubscribePropsWithAtomWithSelector}
+ * for clearer inference when `selector` is omitted.
+ */
+export type SubscribePropsWithAtom<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TAtomValue,
+  TSelected = TAtomValue,
+> =
+  | SubscribePropsWithAtomIdentity<TFeatures, TData, TAtomValue>
+  | SubscribePropsWithAtomWithSelector<TFeatures, TData, TAtomValue, TSelected>
+
+export type SubscribeProps<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TSelected = unknown,
+  TAtomValue = unknown,
+> =
+  | SubscribePropsWithStore<TFeatures, TData, TSelected>
+  | SubscribePropsWithAtomIdentity<TFeatures, TData, TAtomValue>
+  | SubscribePropsWithAtomWithSelector<TFeatures, TData, TAtomValue, TSelected>
+
 /**
  * A React component that allows you to subscribe to the table state.
  *
  * This is useful for opting into state re-renders for specific parts of the table state.
  *
+ * For `table.Subscribe` from `useTable`, prefer that API — it uses overloads so JSX
+ * contextual typing works. This standalone component uses a union `props` type.
+ *
  * @example
  * ```tsx
- * // As a standalone component
+ * // As a standalone component — full store
  * <Subscribe table={table} selector={(state) => ({ rowSelection: state.rowSelection })}>
  *   {({ rowSelection }) => (
  *     <div>Selected rows: {Object.keys(rowSelection).length}</div>
@@ -48,6 +107,26 @@ export type SubscribeProps<
  *
  * @example
  * ```tsx
+ * // Entire slice atom (no selector)
+ * <Subscribe table={table} atom={table.atoms.rowSelection}>
+ *   {(rowSelection) => <div>...</div>}
+ * </Subscribe>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Project atom value (e.g. one row’s selection)
+ * <Subscribe
+ *   table={table}
+ *   atom={table.atoms.rowSelection}
+ *   selector={(rowSelection) => rowSelection?.[row.id]}
+ * >
+ *   {(selected) => <tr data-selected={!!selected}>...</tr>}
+ * </Subscribe>
+ * ```
+ *
+ * @example
+ * ```tsx
  * // As table.Subscribe (table instance method)
  * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>
  *   {({ rowSelection }) => (
@@ -59,15 +138,52 @@ export type SubscribeProps<
 export function Subscribe<
   TFeatures extends TableFeatures,
   TData extends RowData,
-  TSelected = {},
+  TAtomValue,
+>(
+  props: SubscribePropsWithAtomIdentity<TFeatures, TData, TAtomValue>,
+): ReturnType<FunctionComponent>
+export function Subscribe<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TAtomValue,
+  TSelected,
+>(
+  props: SubscribePropsWithAtomWithSelector<
+    TFeatures,
+    TData,
+    TAtomValue,
+    TSelected
+  >,
+): ReturnType<FunctionComponent>
+export function Subscribe<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TSelected,
 >(
-  props: SubscribeProps<TFeatures, TData, TSelected>,
+  props: SubscribePropsWithStore<TFeatures, TData, TSelected>,
+): ReturnType<FunctionComponent>
+export function Subscribe<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TSelected,
+  TAtomValue,
+>(
+  props: SubscribeProps<TFeatures, TData, TSelected, TAtomValue>,
 ): ReturnType<FunctionComponent> {
-  const selected = useSelector(props.table.store, props.selector, {
-    compare: shallow,
-  })
+  const source = 'atom' in props ? props.atom : props.table.store
+  const selectFn =
+    'atom' in props ? (props.selector ?? ((x: unknown) => x)) : props.selector
+
+  const selected = useSelector(
+    // Atom and store share the same selection protocol; union args need a widen for TS.
+    source,
+    selectFn as Parameters<typeof useSelector>[1],
+    {
+      compare: shallow,
+    },
+  ) as TSelected
 
   return typeof props.children === 'function'
-    ? props.children(selected)
+    ? (props.children as (state: TSelected) => ReactNode)(selected)
     : props.children
 }

package/src/static-functions.ts

@@ -0,0 +1 @@
+export * from '@tanstack/table-core/static-functions'