@tanstack/react-table 9.0.0-alpha.4 → 9.0.0-alpha.40

package/dist/useLegacyTable.js.map

@@ -0,0 +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 { 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\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()\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 */\nexport type 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 */\nexport type 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 */\nexport type 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 */\nexport type 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    },\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      ...table,\n      getState,\n      setState,\n    }),\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,oBAAmB;;;;;;;;AASrB,SAAgB,yBAEuB;AACrC,oCAAmB,IAAI,KAAK;;;;;;;;AAS9B,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,eACE;EACL,GAAG;EACH;EACA;EACD,GACD;EAAC;EAAO;EAAU;EAAS,CAC5B"}

package/dist/useTable.cjs

@@ -0,0 +1,41 @@
+'use client';
+
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_FlexRender = require('./FlexRender.cjs');
+const require_Subscribe = require('./Subscribe.cjs');
+let _tanstack_table_core = require("@tanstack/table-core");
+let react = require("react");
+let _tanstack_react_store = require("@tanstack/react-store");
+
+//#region src/useTable.ts
+function useTable(tableOptions, selector = () => ({})) {
+	const [table] = (0, react.useState)(() => {
+		const tableInstance = (0, _tanstack_table_core.constructTable)(tableOptions);
+		tableInstance.Subscribe = ((props) => {
+			return require_Subscribe.Subscribe({
+				...props,
+				table: tableInstance
+			});
+		});
+		tableInstance.FlexRender = require_FlexRender.FlexRender;
+		return tableInstance;
+	});
+	table.setOptions((prev) => ({
+		...prev,
+		...tableOptions
+	}));
+	const state = (0, _tanstack_react_store.useSelector)(table.store, selector, { compare: _tanstack_react_store.shallow });
+	return (0, react.useMemo)(() => ({
+		...table,
+		options: tableOptions,
+		state
+	}), [
+		table,
+		tableOptions,
+		state
+	]);
+}
+
+//#endregion
+exports.useTable = useTable;
+//# sourceMappingURL=useTable.cjs.map

package/dist/useTable.cjs.map

@@ -0,0 +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  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 `source` to subscribe to a single atom or store (e.g. `table.atoms.rowSelection`\n   * or `table.optionsStore`) 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 source={table.atoms.rowSelection}>\n   *   {(rowSelection) => <div>...</div>}\n   * </table.Subscribe>\n   *\n   * @example\n   * <table.Subscribe source={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   * Source **without** `selector` is a separate overload so children receive `TSourceValue`\n   * (identity projection). If `selector` were optional on one overload, `TSubSelected`\n   * would default to `unknown` instead of inferring from the source.\n   *\n   * The **source** overloads are listed first so `TSourceValue` is inferred from `source`.\n   */\n  Subscribe: {\n    <TSourceValue>(props: {\n      source: Atom<TSourceValue> | ReadonlyAtom<TSourceValue>\n      selector?: undefined\n      children: ((state: TSourceValue) => ReactNode) | ReactNode\n    }): ReturnType<FunctionComponent>\n    <TSourceValue, TSubSelected>(props: {\n      source: Atom<TSourceValue> | ReadonlyAtom<TSourceValue>\n      selector: (state: TSourceValue) => 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 state = useSelector(table.store, selector, { compare: shallow })\n\n  // we know this is not the most efficient way to return the table,\n  // but it is required for the react compiler to work\n  return useMemo(\n    () => ({\n      ...table,\n      options: tableOptions,\n      state,\n    }),\n    [table, tableOptions, state],\n  ) as ReactTable<TFeatures, TData, TSelected>\n}\n"],"mappings":";;;;;;;;;;AAiHA,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,+CAAoB,MAAM,OAAO,UAAU,EAAE,SAASC,+BAAS,CAAC;AAItE,kCACS;EACL,GAAG;EACH,SAAS;EACT;EACD,GACD;EAAC;EAAO;EAAc;EAAM,CAC7B"}

package/dist/useTable.d.cts

@@ -0,0 +1,92 @@
+import { FlexRenderProps } from "./FlexRender.cjs";
+import { SubscribePropsWithStore } from "./Subscribe.cjs";
+import { FunctionComponent, ReactNode } from "react";
+import { CellData, RowData, Table, TableFeatures, TableOptions, TableState } from "@tanstack/table-core";
+import { Atom, ReadonlyAtom } from "@tanstack/react-store";
+
+//#region src/useTable.d.ts
+type ReactTable<TFeatures extends TableFeatures, TData extends RowData, TSelected = {}> = Table<TFeatures, TData> & {
+  /**
+   * A React HOC (Higher Order 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.
+   *
+   * Pass `source` to subscribe to a single atom or store (e.g. `table.atoms.rowSelection`
+   * or `table.optionsStore`) instead of the full `table.store`.
+   *
+   * @example
+   * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>
+   *   {({ rowSelection }) => (
+   *     <tr key={row.id}>...</tr>
+   *   )}
+   * </table.Subscribe>
+   *
+   * @example
+   * <table.Subscribe source={table.atoms.rowSelection}>
+   *   {(rowSelection) => <div>...</div>}
+   * </table.Subscribe>
+   *
+   * @example
+   * <table.Subscribe source={table.atoms.rowSelection} selector={(s) => s?.[row.id]}>
+   *   {() => <tr key={row.id}>...</tr>}
+   * </table.Subscribe>
+   */
+  /**
+   * Overloads (not a single union) so `selector` callbacks get correct contextual
+   * types in JSX; a union of two `selector` signatures degrades to implicit `any`.
+   *
+   * Source **without** `selector` is a separate overload so children receive `TSourceValue`
+   * (identity projection). If `selector` were optional on one overload, `TSubSelected`
+   * would default to `unknown` instead of inferring from the source.
+   *
+   * The **source** overloads are listed first so `TSourceValue` is inferred from `source`.
+   */
+  Subscribe: {
+    <TSourceValue>(props: {
+      source: Atom<TSourceValue> | ReadonlyAtom<TSourceValue>;
+      selector?: undefined;
+      children: ((state: TSourceValue) => ReactNode) | ReactNode;
+    }): ReturnType<FunctionComponent>;
+    <TSourceValue, TSubSelected>(props: {
+      source: Atom<TSourceValue> | ReadonlyAtom<TSourceValue>;
+      selector: (state: TSourceValue) => 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.
+   *
+   * @example
+   * ```tsx
+   * <table.FlexRender cell={cell} />
+   * <table.FlexRender header={header} />
+   * <table.FlexRender footer={footer} />
+   * ```
+   *
+   * This replaces calling `flexRender` directly like this:
+   * ```tsx
+   * flexRender(cell.column.columnDef.cell, cell.getContext())
+   * flexRender(header.column.columnDef.header, header.getContext())
+   * flexRender(footer.column.columnDef.footer, footer.getContext())
+   * ```
+   */
+  FlexRender: <TValue extends CellData = CellData>(props: FlexRenderProps<TFeatures, TData, TValue>) => ReactNode;
+  /**
+   * 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`.
+   *
+   * @example
+   * const table = useTable(options, (state) => ({ globalFilter: state.globalFilter })) // only globalFilter is part of the selected state
+   *
+   * console.log(table.state.globalFilter)
+   */
+  readonly state: Readonly<TSelected> & {
+    columns: TableOptions<TFeatures, TData>['columns'];
+    data: TableOptions<TFeatures, TData>['data'];
+  };
+};
+declare function useTable<TFeatures extends TableFeatures, TData extends RowData, TSelected = {}>(tableOptions: TableOptions<TFeatures, TData>, selector?: (state: TableState<TFeatures>) => TSelected): ReactTable<TFeatures, TData, TSelected>;
+//#endregion
+export { ReactTable, useTable };
+//# sourceMappingURL=useTable.d.cts.map

package/dist/useTable.d.ts

@@ -0,0 +1,92 @@
+import { FlexRenderProps } from "./FlexRender.js";
+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> & {
+  /**
+   * A React HOC (Higher Order 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.
+   *
+   * Pass `source` to subscribe to a single atom or store (e.g. `table.atoms.rowSelection`
+   * or `table.optionsStore`) instead of the full `table.store`.
+   *
+   * @example
+   * <table.Subscribe selector={(state) => ({ rowSelection: state.rowSelection })}>
+   *   {({ rowSelection }) => (
+   *     <tr key={row.id}>...</tr>
+   *   )}
+   * </table.Subscribe>
+   *
+   * @example
+   * <table.Subscribe source={table.atoms.rowSelection}>
+   *   {(rowSelection) => <div>...</div>}
+   * </table.Subscribe>
+   *
+   * @example
+   * <table.Subscribe source={table.atoms.rowSelection} selector={(s) => s?.[row.id]}>
+   *   {() => <tr key={row.id}>...</tr>}
+   * </table.Subscribe>
+   */
+  /**
+   * Overloads (not a single union) so `selector` callbacks get correct contextual
+   * types in JSX; a union of two `selector` signatures degrades to implicit `any`.
+   *
+   * Source **without** `selector` is a separate overload so children receive `TSourceValue`
+   * (identity projection). If `selector` were optional on one overload, `TSubSelected`
+   * would default to `unknown` instead of inferring from the source.
+   *
+   * The **source** overloads are listed first so `TSourceValue` is inferred from `source`.
+   */
+  Subscribe: {
+    <TSourceValue>(props: {
+      source: Atom<TSourceValue> | ReadonlyAtom<TSourceValue>;
+      selector?: undefined;
+      children: ((state: TSourceValue) => ReactNode) | ReactNode;
+    }): ReturnType<FunctionComponent>;
+    <TSourceValue, TSubSelected>(props: {
+      source: Atom<TSourceValue> | ReadonlyAtom<TSourceValue>;
+      selector: (state: TSourceValue) => 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.
+   *
+   * @example
+   * ```tsx
+   * <table.FlexRender cell={cell} />
+   * <table.FlexRender header={header} />
+   * <table.FlexRender footer={footer} />
+   * ```
+   *
+   * This replaces calling `flexRender` directly like this:
+   * ```tsx
+   * flexRender(cell.column.columnDef.cell, cell.getContext())
+   * flexRender(header.column.columnDef.header, header.getContext())
+   * flexRender(footer.column.columnDef.footer, footer.getContext())
+   * ```
+   */
+  FlexRender: <TValue extends CellData = CellData>(props: FlexRenderProps<TFeatures, TData, TValue>) => ReactNode;
+  /**
+   * 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`.
+   *
+   * @example
+   * const table = useTable(options, (state) => ({ globalFilter: state.globalFilter })) // only globalFilter is part of the selected state
+   *
+   * console.log(table.state.globalFilter)
+   */
+  readonly state: Readonly<TSelected> & {
+    columns: TableOptions<TFeatures, TData>['columns'];
+    data: TableOptions<TFeatures, TData>['data'];
+  };
+};
+declare function useTable<TFeatures extends TableFeatures, TData extends RowData, TSelected = {}>(tableOptions: TableOptions<TFeatures, TData>, selector?: (state: TableState<TFeatures>) => TSelected): ReactTable<TFeatures, TData, TSelected>;
+//#endregion
+export { ReactTable, useTable };
+//# sourceMappingURL=useTable.d.ts.map

package/dist/useTable.js

@@ -0,0 +1,40 @@
+'use client';
+
+import { FlexRender } from "./FlexRender.js";
+import { Subscribe } from "./Subscribe.js";
+import { constructTable } from "@tanstack/table-core";
+import { useMemo, useState } from "react";
+import { shallow, useSelector } from "@tanstack/react-store";
+
+//#region src/useTable.ts
+function useTable(tableOptions, selector = () => ({})) {
+	const [table] = useState(() => {
+		const tableInstance = constructTable(tableOptions);
+		tableInstance.Subscribe = ((props) => {
+			return Subscribe({
+				...props,
+				table: tableInstance
+			});
+		});
+		tableInstance.FlexRender = FlexRender;
+		return tableInstance;
+	});
+	table.setOptions((prev) => ({
+		...prev,
+		...tableOptions
+	}));
+	const state = useSelector(table.store, selector, { compare: shallow });
+	return useMemo(() => ({
+		...table,
+		options: tableOptions,
+		state
+	}), [
+		table,
+		tableOptions,
+		state
+	]);
+}
+
+//#endregion
+export { useTable };
+//# sourceMappingURL=useTable.js.map

package/dist/useTable.js.map

@@ -0,0 +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  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 `source` to subscribe to a single atom or store (e.g. `table.atoms.rowSelection`\n   * or `table.optionsStore`) 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 source={table.atoms.rowSelection}>\n   *   {(rowSelection) => <div>...</div>}\n   * </table.Subscribe>\n   *\n   * @example\n   * <table.Subscribe source={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   * Source **without** `selector` is a separate overload so children receive `TSourceValue`\n   * (identity projection). If `selector` were optional on one overload, `TSubSelected`\n   * would default to `unknown` instead of inferring from the source.\n   *\n   * The **source** overloads are listed first so `TSourceValue` is inferred from `source`.\n   */\n  Subscribe: {\n    <TSourceValue>(props: {\n      source: Atom<TSourceValue> | ReadonlyAtom<TSourceValue>\n      selector?: undefined\n      children: ((state: TSourceValue) => ReactNode) | ReactNode\n    }): ReturnType<FunctionComponent>\n    <TSourceValue, TSubSelected>(props: {\n      source: Atom<TSourceValue> | ReadonlyAtom<TSourceValue>\n      selector: (state: TSourceValue) => 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 state = useSelector(table.store, selector, { compare: shallow })\n\n  // we know this is not the most efficient way to return the table,\n  // but it is required for the react compiler to work\n  return useMemo(\n    () => ({\n      ...table,\n      options: tableOptions,\n      state,\n    }),\n    [table, tableOptions, state],\n  ) as ReactTable<TFeatures, TData, TSelected>\n}\n"],"mappings":";;;;;;;;;AAiHA,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,QAAQ,YAAY,MAAM,OAAO,UAAU,EAAE,SAAS,SAAS,CAAC;AAItE,QAAO,eACE;EACL,GAAG;EACH,SAAS;EACT;EACD,GACD;EAAC;EAAO;EAAc;EAAM,CAC7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/react-table",
-  "version": "9.0.0-alpha.4",
+  "version": "9.0.0-alpha.40",
   "description": "Headless UI for building powerful tables & datagrids for React.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -21,41 +21,58 @@
     "datagrid"
   ],
   "type": "module",
-  "types": "dist/esm/index.d.ts",
-  "main": "dist/cjs/index.cjs",
-  "module": "dist/esm/index.js",
+  "types": "./dist/index.d.cts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/esm/index.d.ts",
-        "default": "./dist/esm/index.js"
-      },
-      "require": {
-        "types": "./dist/cjs/index.d.cts",
-        "default": "./dist/cjs/index.cjs"
-      }
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./flex-render": {
+      "import": "./dist/flex-render.js",
+      "require": "./dist/flex-render.cjs"
+    },
+    "./legacy": {
+      "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,
   "engines": {
-    "node": ">=12"
+    "node": ">=16"
   },
   "files": [
     "dist",
     "src"
   ],
   "dependencies": {
-    "@tanstack/table-core": "9.0.0-alpha.4"
+    "@tanstack/react-store": "^0.11.0",
+    "@tanstack/table-core": "9.0.0-alpha.39"
   },
   "devDependencies": {
-    "@types/react": "^18.3.0",
-    "@vitejs/plugin-react": "^4.2.1",
-    "react": "^18.3.0"
+    "@eslint-react/eslint-plugin": "^4.2.3",
+    "@types/react": "^19.2.14",
+    "@vitejs/plugin-react": "^6.0.1",
+    "eslint-plugin-react-compiler": "19.1.0-rc.2",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "react": "^19.2.5"
   },
   "peerDependencies": {
-    "react": ">=16.8",
-    "react-dom": ">=16.8"
+    "react": ">=18"
   },
-  "scripts": {}
+  "scripts": {
+    "clean": "rimraf ./build && rimraf ./dist",
+    "test:eslint": "eslint ./src",
+    "test:lib": "vitest --passWithNoTests",
+    "test:lib:dev": "pnpm test:lib --watch",
+    "test:types": "tsc",
+    "test:build": "publint --strict",
+    "build": "tsdown"
+  }
 }

package/src/FlexRender.tsx

@@ -0,0 +1,147 @@
+import React from 'react'
+import type {
+  Cell,
+  CellData,
+  Header,
+  RowData,
+  TableFeatures,
+} from '@tanstack/table-core'
+import type { ComponentType, JSX, ReactNode } from 'react'
+
+export type Renderable<TProps> = ReactNode | ComponentType<TProps>
+
+function isReactComponent<TProps>(
+  component: unknown,
+): component is ComponentType<TProps> {
+  return (
+    isClassComponent(component) ||
+    typeof component === 'function' ||
+    isExoticComponent(component)
+  )
+}
+
+function isClassComponent(component: any) {
+  return (
+    typeof component === 'function' &&
+    (() => {
+      const proto = Object.getPrototypeOf(component)
+      return proto.prototype && proto.prototype.isReactComponent
+    })()
+  )
+}
+
+function isExoticComponent(component: any) {
+  return (
+    typeof component === 'object' &&
+    typeof component.$$typeof === 'symbol' &&
+    ['react.memo', 'react.forward_ref'].includes(component.$$typeof.description)
+  )
+}
+
+/**
+ * If rendering headers, cells, or footers with custom markup, use flexRender instead of `cell.getValue()` or `cell.renderValue()`.
+ * @example flexRender(cell.column.columnDef.cell, cell.getContext())
+ */
+export function flexRender<TProps extends object>(
+  Comp: Renderable<TProps>,
+  props: TProps,
+): ReactNode | JSX.Element {
+  return !Comp ? null : isReactComponent<TProps>(Comp) ? (
+    <Comp {...props} />
+  ) : (
+    Comp
+  )
+}
+
+/**
+ * Simplified component wrapper of `flexRender`. Use this utility component to render headers, cells, or footers with custom markup.
+ * Only one prop (`cell`, `header`, or `footer`) may be passed.
+ * @example <FlexRender cell={cell} />
+ * @example <FlexRender header={header} />
+ * @example <FlexRender footer={footer} />
+ */
+export type FlexRenderProps<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+> =
+  | { cell: Cell<TFeatures, TData, TValue>; header?: never; footer?: never }
+  | {
+      header: Header<TFeatures, TData, TValue>
+      cell?: never
+      footer?: never
+    }
+  | {
+      footer: Header<TFeatures, TData, TValue>
+      cell?: never
+      header?: never
+    }
+
+/**
+ * Simplified component wrapper of `flexRender`. Use this utility component to render headers, cells, or footers with custom markup.
+ * Only one prop (`cell`, `header`, or `footer`) may be passed.
+ * @example
+ * ```tsx
+ * <FlexRender cell={cell} />
+ * <FlexRender header={header} />
+ * <FlexRender footer={footer} />
+ * ```
+ *
+ * This replaces calling `flexRender` directly like this:
+ * ```tsx
+ * flexRender(cell.column.columnDef.cell, cell.getContext())
+ * flexRender(header.column.columnDef.header, header.getContext())
+ * flexRender(footer.column.columnDef.footer, footer.getContext())
+ * ```
+ */
+export function FlexRender<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+>(props: FlexRenderProps<TFeatures, TData, TValue>) {
+  if ('cell' in props && props.cell) {
+    const cell = props.cell
+    const def = cell.column.columnDef
+    // When the column-grouping feature is registered, a cell can be in one of
+    // three special modes that should not render `columnDef.cell` directly:
+    //   - aggregated: render `columnDef.aggregatedCell` (falling back to
+    //     `columnDef.cell` if the column did not define one)
+    //   - placeholder: a duplicate value within a group — render nothing
+    //   - grouped: the group header cell — let the consumer render this; we
+    //     fall through to `columnDef.cell` so the existing behavior is
+    //     preserved (consumers that want a custom group header typically
+    //     branch on `cell.getIsGrouped()` themselves before calling FlexRender)
+    // The optional-chaining + cast keeps this safe when the grouping feature
+    // is not registered (the methods are absent at the type level then).
+    const groupingCell = cell as typeof cell & {
+      getIsAggregated?: () => boolean
+      getIsPlaceholder?: () => boolean
+    }
+    const groupingDef = def as typeof def & {
+      aggregatedCell?: typeof def.cell
+    }
+    if (groupingCell.getIsAggregated?.()) {
+      return flexRender(
+        groupingDef.aggregatedCell ?? def.cell,
+        cell.getContext(),
+      )
+    }
+    if (groupingCell.getIsPlaceholder?.()) {
+      return null
+    }
+    return flexRender(def.cell, cell.getContext())
+  }
+  if ('header' in props && props.header) {
+    return flexRender(
+      props.header.column.columnDef.header,
+      props.header.getContext(),
+    )
+  }
+  if ('footer' in props && props.footer) {
+    return flexRender(
+      props.footer.column.columnDef.footer,
+      props.footer.getContext(),
+    )
+  }
+  return null
+}