@tanstack/vue-table 9.0.0-beta.21 → 9.0.0-beta.23

package/dist/createTableHook.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createTableHook.cjs","names":["FlexRender","useTable","mergeProxy"],"sources":["../src/createTableHook.ts"],"sourcesContent":["import { createColumnHelper as coreCreateColumnHelper } from '@tanstack/table-core'\nimport { defineComponent, h, inject, provide } from 'vue'\nimport { FlexRender } from './FlexRender'\nimport { mergeProxy } from './merge-proxy'\nimport { useTable } from './useTable'\nimport type { TableOptionsWithReactiveData, VueTable } from './useTable'\nimport type { FlexRenderCell, FlexRenderHeader } from './FlexRender'\nimport type { Component, InjectionKey, PropType, VNodeChild } from 'vue'\nimport type {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  Cell,\n  CellContext,\n  CellData,\n  Column,\n  ColumnDef,\n  DeepKeys,\n  DeepValue,\n  DisplayColumnDef,\n  GroupColumnDef,\n  Header,\n  IdentifiedColumnDef,\n  NoInfer,\n  Row,\n  RowData,\n  Table,\n  TableFeatures,\n  TableState,\n} from '@tanstack/table-core'\n\nexport type ComponentType<T extends Record<string, any>> = Component<T>\n\nexport type AppCellContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n> = {\n  cell: Cell<TFeatures, TData, TValue> &\n    TCellComponents & { FlexRender: Component }\n  column: Column<TFeatures, TData, TValue>\n  getValue: CellContext<TFeatures, TData, TValue>['getValue']\n  renderValue: CellContext<TFeatures, TData, TValue>['renderValue']\n  row: Row<TFeatures, TData>\n  table: Table<TFeatures, TData>\n}\n\nexport type AppHeaderContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = {\n  column: Column<TFeatures, TData, TValue>\n  header: Header<TFeatures, TData, TValue> &\n    THeaderComponents & { FlexRender: Component }\n  table: Table<TFeatures, TData>\n}\n\nexport type AppColumnDefTemplate<TProps extends object> =\n  | string\n  | ((props: TProps) => any)\n\nexport type AppColumnDefBase<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  IdentifiedColumnDef<TFeatures, TData, TValue>,\n  'cell' | 'header' | 'footer'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, TValue, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, TValue, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, TValue, THeaderComponents>\n  >\n}\n\nexport type AppDisplayColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  DisplayColumnDef<TFeatures, TData, unknown>,\n  'cell' | 'header' | 'footer'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, unknown, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n}\n\nexport type AppGroupColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  GroupColumnDef<TFeatures, TData, unknown>,\n  'cell' | 'header' | 'footer' | 'columns'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, unknown, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  columns?: Array<ColumnDef<TFeatures, TData, unknown>>\n}\n\nexport type AppColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = {\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? AppColumnDefBase<\n          TFeatures,\n          TData,\n          TValue,\n          TCellComponents,\n          THeaderComponents\n        > & { id: string }\n      : AppColumnDefBase<\n          TFeatures,\n          TData,\n          TValue,\n          TCellComponents,\n          THeaderComponents\n        >,\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TFeatures, TData, TValue>\n    : AccessorKeyColumnDef<TFeatures, TData, TValue>\n  columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n    columns: [...TColumns],\n  ) => Array<ColumnDef<TFeatures, TData, any>> & [...TColumns]\n  display: (\n    column: AppDisplayColumnDef<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >,\n  ) => DisplayColumnDef<TFeatures, TData, unknown>\n  group: (\n    column: AppGroupColumnDef<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >,\n  ) => GroupColumnDef<TFeatures, TData, unknown>\n}\n\nexport type CreateTableHookOptions<\n  TFeatures extends TableFeatures,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  TableOptionsWithReactiveData<TFeatures, any>,\n  'columns' | 'data' | 'store' | 'state' | 'initialState'\n> & {\n  tableComponents?: TTableComponents\n  cellComponents?: TCellComponents\n  headerComponents?: THeaderComponents\n}\n\nexport interface AppTableProps {}\n\nexport interface AppCellProps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  cell: Cell<TFeatures, TData, TValue>\n}\n\nexport interface AppHeaderProps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  header: Header<TFeatures, TData, TValue>\n}\n\nexport type AppVueTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = VueTable<TFeatures, TData> &\n  NoInfer<TTableComponents> & {\n    AppTable: Component<AppTableProps>\n    AppCell: Component<AppCellProps<TFeatures, TData>>\n    AppHeader: Component<AppHeaderProps<TFeatures, TData>>\n    AppFooter: Component<AppHeaderProps<TFeatures, TData>>\n    FlexRender: typeof AppFlexRender\n  }\n\nexport const AppFlexRender = defineComponent({\n  name: 'TableFlexRender',\n  props: {\n    cell: {\n      type: Object as PropType<FlexRenderCell>,\n      default: undefined,\n    },\n    header: {\n      type: Object as PropType<FlexRenderHeader>,\n      default: undefined,\n    },\n    footer: {\n      type: Object as PropType<FlexRenderHeader>,\n      default: undefined,\n    },\n  },\n  setup(props) {\n    return () => {\n      if (props.cell) {\n        return h(FlexRender, {\n          render: props.cell.column.columnDef.cell,\n          props: props.cell.getContext(),\n        })\n      }\n\n      if (props.header) {\n        return h(FlexRender, {\n          render: props.header.column.columnDef.header,\n          props: props.header.getContext(),\n        })\n      }\n\n      if (props.footer) {\n        return h(FlexRender, {\n          render: props.footer.column.columnDef.footer,\n          props: props.footer.getContext(),\n        })\n      }\n\n      return null\n    }\n  },\n})\n\n/**\n * Creates app-scoped Vue table helpers with features, row models, and\n * renderable component maps pre-bound.\n *\n * Use this when an app or design system wants typed `useAppTable`, a pre-bound\n * column helper, and context helpers for table, cell, and header components.\n *\n * @example\n * ```ts\n * const { useAppTable, createAppColumnHelper } = createTableHook({\n *   features,\n *   tableComponents: {},\n *   cellComponents: {},\n *   headerComponents: {},\n * })\n * ```\n */\nexport function createTableHook<\n  TFeatures extends TableFeatures,\n  const TTableComponents extends Record<string, ComponentType<any>>,\n  const TCellComponents extends Record<string, ComponentType<any>>,\n  const THeaderComponents extends Record<string, ComponentType<any>>,\n>({\n  tableComponents,\n  cellComponents,\n  headerComponents,\n  ...defaultTableOptions\n}: CreateTableHookOptions<\n  TFeatures,\n  TTableComponents,\n  TCellComponents,\n  THeaderComponents\n>) {\n  const TableContext = Symbol('TableContext') as InjectionKey<\n    VueTable<TFeatures, any>\n  >\n  const CellContext = Symbol('CellContext') as InjectionKey<\n    Cell<TFeatures, any, any>\n  >\n  const HeaderContext = Symbol('HeaderContext') as InjectionKey<\n    Header<TFeatures, any, any>\n  >\n\n  function createAppColumnHelper<TData extends RowData>(): AppColumnHelper<\n    TFeatures,\n    TData,\n    TCellComponents,\n    THeaderComponents\n  > {\n    return coreCreateColumnHelper<TFeatures, TData>() as AppColumnHelper<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  function useTableContext<TData extends RowData = RowData>(): VueTable<\n    TFeatures,\n    TData\n  > {\n    const table = inject(TableContext)\n\n    if (!table) {\n      throw new Error(\n        '`useTableContext` must be used within an `AppTable` component. ' +\n          'Make sure your component is wrapped with `<table.AppTable>...</table.AppTable>`.',\n      )\n    }\n\n    return table as VueTable<TFeatures, TData>\n  }\n\n  function useCellContext<TValue extends CellData = CellData>(): Cell<\n    TFeatures,\n    any,\n    TValue\n  > {\n    const cell = inject(CellContext)\n\n    if (!cell) {\n      throw new Error(\n        '`useCellContext` must be used within an `AppCell` component. ' +\n          'Make sure your component is wrapped with `<table.AppCell :cell=\"cell\">...</table.AppCell>`.',\n      )\n    }\n\n    return cell as Cell<TFeatures, any, TValue>\n  }\n\n  function useHeaderContext<TValue extends CellData = CellData>(): Header<\n    TFeatures,\n    any,\n    TValue\n  > {\n    const header = inject(HeaderContext)\n\n    if (!header) {\n      throw new Error(\n        '`useHeaderContext` must be used within an `AppHeader` or `AppFooter` component.',\n      )\n    }\n\n    return header as Header<TFeatures, any, TValue>\n  }\n\n  const CellFlexRender = defineComponent({\n    name: 'AppCellFlexRender',\n    setup() {\n      const cell = useCellContext()\n      return () => h(AppFlexRender, { cell })\n    },\n  })\n\n  const HeaderFlexRender = defineComponent({\n    name: 'AppHeaderFlexRender',\n    setup() {\n      const header = useHeaderContext()\n      return () => h(AppFlexRender, { header })\n    },\n  })\n\n  const FooterFlexRender = defineComponent({\n    name: 'AppFooterFlexRender',\n    setup() {\n      const header = useHeaderContext()\n      return () => h(AppFlexRender, { footer: header })\n    },\n  })\n\n  function useAppTable<TData extends RowData>(\n    tableOptions: Omit<\n      TableOptionsWithReactiveData<TFeatures, TData>,\n      'features'\n    >,\n  ): AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  > {\n    const mergedOptions = mergeProxy(\n      defaultTableOptions,\n      tableOptions,\n    ) as TableOptionsWithReactiveData<TFeatures, TData>\n\n    const table = useTable<TFeatures, TData>(mergedOptions)\n\n    const AppTable = defineComponent({\n      name: 'AppTable',\n      setup(_, { slots }) {\n        provide(TableContext, table)\n        return () => {\n          return slots.default?.()\n        }\n      },\n    })\n\n    const AppCell = defineComponent({\n      name: 'AppCell',\n      props: {\n        cell: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const cell = props.cell as Cell<TFeatures, TData, any>\n\n        provide(CellContext, cell)\n\n        const extendedCell = Object.assign(cell, {\n          FlexRender: CellFlexRender,\n          ...(cellComponents ?? {}),\n        }) as Cell<TFeatures, TData, any> &\n          TCellComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ cell: extendedCell })\n        }\n      },\n    })\n\n    const AppHeader = defineComponent({\n      name: 'AppHeader',\n      props: {\n        header: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const header = props.header as Header<TFeatures, TData, any>\n\n        provide(HeaderContext, header)\n\n        const extendedHeader = Object.assign(header, {\n          FlexRender: HeaderFlexRender,\n          ...(headerComponents ?? {}),\n        }) as Header<TFeatures, TData, any> &\n          THeaderComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ header: extendedHeader })\n        }\n      },\n    })\n\n    const AppFooter = defineComponent({\n      name: 'AppFooter',\n      props: {\n        header: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const header = props.header as Header<TFeatures, TData, any>\n\n        provide(HeaderContext, header)\n\n        const extendedHeader = Object.assign(header, {\n          FlexRender: FooterFlexRender,\n          ...(headerComponents ?? {}),\n        }) as Header<TFeatures, TData, any> &\n          THeaderComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ header: extendedHeader })\n        }\n      },\n    })\n\n    return Object.assign(table, {\n      AppTable,\n      AppCell,\n      AppHeader,\n      AppFooter,\n      FlexRender: AppFlexRender,\n      ...(tableComponents ?? {}),\n    }) as AppVueTable<\n      TFeatures,\n      TData,\n      TableState<TFeatures>,\n      TTableComponents,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  return {\n    appFeatures: defaultTableOptions.features as TFeatures,\n    createAppColumnHelper,\n    useAppTable,\n    useTableContext,\n    useCellContext,\n    useHeaderContext,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"createTableHook.cjs","names":["FlexRender","useTable","mergeProxy"],"sources":["../src/createTableHook.ts"],"sourcesContent":["import { createColumnHelper as coreCreateColumnHelper } from '@tanstack/table-core'\nimport { defineComponent, h, inject, provide } from 'vue'\nimport { FlexRender } from './FlexRender'\nimport { mergeProxy } from './merge-proxy'\nimport { useTable } from './useTable'\nimport type { TableOptionsWithReactiveData, VueTable } from './useTable'\nimport type { FlexRenderCell, FlexRenderHeader } from './FlexRender'\nimport type { Component, InjectionKey, PropType, VNodeChild } from 'vue'\nimport type {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  Cell,\n  CellContext,\n  CellData,\n  Column,\n  ColumnDef,\n  DeepKeys,\n  DeepValue,\n  DisplayColumnDef,\n  GroupColumnDef,\n  Header,\n  IdentifiedColumnDef,\n  NoInfer,\n  Row,\n  RowData,\n  Table,\n  TableFeatures,\n  TableState,\n} from '@tanstack/table-core'\n\nexport type ComponentType<T extends Record<string, any>> = Component<T>\n\nexport type AppCellContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n> = {\n  cell: Cell<TFeatures, TData, TValue> &\n    TCellComponents & { FlexRender: Component }\n  column: Column<TFeatures, TData, TValue>\n  getValue: CellContext<TFeatures, TData, TValue>['getValue']\n  renderValue: CellContext<TFeatures, TData, TValue>['renderValue']\n  row: Row<TFeatures, TData>\n  table: Table<TFeatures, TData>\n}\n\nexport type AppHeaderContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = {\n  column: Column<TFeatures, TData, TValue>\n  header: Header<TFeatures, TData, TValue> &\n    THeaderComponents & { FlexRender: Component }\n  table: Table<TFeatures, TData>\n}\n\nexport type AppColumnDefTemplate<TProps extends object> =\n  | string\n  | ((props: TProps) => any)\n\nexport type AppColumnDefBase<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  IdentifiedColumnDef<TFeatures, TData, TValue>,\n  'cell' | 'header' | 'footer'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, TValue, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, TValue, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, TValue, THeaderComponents>\n  >\n}\n\nexport type AppDisplayColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  DisplayColumnDef<TFeatures, TData, unknown>,\n  'cell' | 'header' | 'footer'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, unknown, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n}\n\nexport type AppGroupColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  GroupColumnDef<TFeatures, TData, unknown>,\n  'cell' | 'header' | 'footer' | 'columns'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, unknown, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  columns?: Array<ColumnDef<TFeatures, TData, unknown>>\n}\n\nexport type AppColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = {\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? AppColumnDefBase<\n          TFeatures,\n          TData,\n          TValue,\n          TCellComponents,\n          THeaderComponents\n        > & { id: string }\n      : AppColumnDefBase<\n          TFeatures,\n          TData,\n          TValue,\n          TCellComponents,\n          THeaderComponents\n        >,\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TFeatures, TData, TValue>\n    : AccessorKeyColumnDef<TFeatures, TData, TValue>\n  columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n    columns: [...TColumns],\n  ) => Array<ColumnDef<TFeatures, TData, any>> & [...TColumns]\n  display: (\n    column: AppDisplayColumnDef<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >,\n  ) => DisplayColumnDef<TFeatures, TData, unknown>\n  group: (\n    column: AppGroupColumnDef<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >,\n  ) => GroupColumnDef<TFeatures, TData, unknown>\n}\n\nexport type CreateTableHookOptions<\n  TFeatures extends TableFeatures,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  TableOptionsWithReactiveData<TFeatures, any>,\n  'columns' | 'data' | 'store' | 'state' | 'initialState'\n> & {\n  tableComponents?: TTableComponents\n  cellComponents?: TCellComponents\n  headerComponents?: THeaderComponents\n}\n\nexport interface AppTableProps {}\n\nexport interface AppCellProps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  cell: Cell<TFeatures, TData, TValue>\n}\n\nexport interface AppHeaderProps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  header: Header<TFeatures, TData, TValue>\n}\n\nexport type AppVueTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = VueTable<TFeatures, TData> &\n  NoInfer<TTableComponents> & {\n    AppTable: Component<AppTableProps>\n    AppCell: Component<AppCellProps<TFeatures, TData>>\n    AppHeader: Component<AppHeaderProps<TFeatures, TData>>\n    AppFooter: Component<AppHeaderProps<TFeatures, TData>>\n    FlexRender: typeof AppFlexRender\n  }\n\nexport interface CreateTableHookResult<\n  TFeatures extends TableFeatures,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> {\n  /** The features object that was passed to `createTableHook`. */\n  appFeatures: TFeatures\n  /**\n   * A column helper pre-bound to `TFeatures` and the registered components, so\n   * the cell/header/footer render props expose the bound components.\n   */\n  createAppColumnHelper: <TData extends RowData>() => AppColumnHelper<\n    TFeatures,\n    TData,\n    TCellComponents,\n    THeaderComponents\n  >\n  /**\n   * Creates a table with the `App*` wrapper components and registered\n   * `tableComponents` attached. `TData` is inferred from the `data` option.\n   */\n  useAppTable: <TData extends RowData>(\n    tableOptions: Omit<\n      TableOptionsWithReactiveData<TFeatures, TData>,\n      'features'\n    >,\n  ) => AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  >\n  /**\n   * Reads the table provided by the nearest `<table.AppTable>`. This is the same\n   * extended instance `useAppTable` returns, so the `App*` components and your\n   * `tableComponents` are available on it.\n   */\n  useTableContext: <TData extends RowData = RowData>() => AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  >\n  /**\n   * Reads the cell provided by the nearest `<table.AppCell>`, extended with your\n   * `cellComponents` and a context-bound `FlexRender`.\n   */\n  useCellContext: <TValue extends CellData = CellData>() => Cell<\n    TFeatures,\n    any,\n    TValue\n  > &\n    TCellComponents & { FlexRender: Component }\n  /**\n   * Reads the header provided by the nearest `<table.AppHeader>` /\n   * `<table.AppFooter>`, extended with your `headerComponents` and a\n   * context-bound `FlexRender`.\n   */\n  useHeaderContext: <TValue extends CellData = CellData>() => Header<\n    TFeatures,\n    any,\n    TValue\n  > &\n    THeaderComponents & { FlexRender: Component }\n}\n\nexport const AppFlexRender = defineComponent({\n  name: 'TableFlexRender',\n  props: {\n    cell: {\n      type: Object as PropType<FlexRenderCell>,\n      default: undefined,\n    },\n    header: {\n      type: Object as PropType<FlexRenderHeader>,\n      default: undefined,\n    },\n    footer: {\n      type: Object as PropType<FlexRenderHeader>,\n      default: undefined,\n    },\n  },\n  setup(props) {\n    return () => {\n      if (props.cell) {\n        return h(FlexRender, {\n          render: props.cell.column.columnDef.cell,\n          props: props.cell.getContext(),\n        })\n      }\n\n      if (props.header) {\n        return h(FlexRender, {\n          render: props.header.column.columnDef.header,\n          props: props.header.getContext(),\n        })\n      }\n\n      if (props.footer) {\n        return h(FlexRender, {\n          render: props.footer.column.columnDef.footer,\n          props: props.footer.getContext(),\n        })\n      }\n\n      return null\n    }\n  },\n})\n\n/**\n * Creates app-scoped Vue table helpers with features, row models, and\n * renderable component maps pre-bound.\n *\n * Use this when an app or design system wants typed `useAppTable`, a pre-bound\n * column helper, and context helpers for table, cell, and header components.\n *\n * @example\n * ```ts\n * const { useAppTable, createAppColumnHelper } = createTableHook({\n *   features,\n *   tableComponents: {},\n *   cellComponents: {},\n *   headerComponents: {},\n * })\n * ```\n */\nexport function createTableHook<\n  TFeatures extends TableFeatures,\n  const TTableComponents extends Record<string, ComponentType<any>>,\n  const TCellComponents extends Record<string, ComponentType<any>>,\n  const THeaderComponents extends Record<string, ComponentType<any>>,\n>({\n  tableComponents,\n  cellComponents,\n  headerComponents,\n  ...defaultTableOptions\n}: CreateTableHookOptions<\n  TFeatures,\n  TTableComponents,\n  TCellComponents,\n  THeaderComponents\n>): CreateTableHookResult<\n  TFeatures,\n  TTableComponents,\n  TCellComponents,\n  THeaderComponents\n> {\n  const TableContext = Symbol('TableContext') as InjectionKey<\n    VueTable<TFeatures, any>\n  >\n  const CellContext = Symbol('CellContext') as InjectionKey<\n    Cell<TFeatures, any, any>\n  >\n  const HeaderContext = Symbol('HeaderContext') as InjectionKey<\n    Header<TFeatures, any, any>\n  >\n\n  function createAppColumnHelper<TData extends RowData>(): AppColumnHelper<\n    TFeatures,\n    TData,\n    TCellComponents,\n    THeaderComponents\n  > {\n    return coreCreateColumnHelper<TFeatures, TData>() as AppColumnHelper<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  function useTableContext<TData extends RowData = RowData>(): AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  > {\n    const table = inject(TableContext)\n\n    if (!table) {\n      throw new Error(\n        '`useTableContext` must be used within an `AppTable` component. ' +\n          'Make sure your component is wrapped with `<table.AppTable>...</table.AppTable>`.',\n      )\n    }\n\n    // The value provided by `<table.AppTable>` is the extended table (the App*\n    // wrapper components and `tableComponents` are Object.assign-ed onto the same\n    // instance `useAppTable` returns), so this asserts the runtime shape.\n    return table as unknown as AppVueTable<\n      TFeatures,\n      TData,\n      TableState<TFeatures>,\n      TTableComponents,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  function useCellContext<TValue extends CellData = CellData>(): Cell<\n    TFeatures,\n    any,\n    TValue\n  > &\n    TCellComponents & { FlexRender: Component } {\n    const cell = inject(CellContext)\n\n    if (!cell) {\n      throw new Error(\n        '`useCellContext` must be used within an `AppCell` component. ' +\n          'Make sure your component is wrapped with `<table.AppCell :cell=\"cell\">...</table.AppCell>`.',\n      )\n    }\n\n    // `<table.AppCell>` Object.assign-es `cellComponents` and `FlexRender` onto\n    // the same cell instance it provides, so this asserts the runtime shape.\n    return cell as unknown as Cell<TFeatures, any, TValue> &\n      TCellComponents & { FlexRender: Component }\n  }\n\n  function useHeaderContext<TValue extends CellData = CellData>(): Header<\n    TFeatures,\n    any,\n    TValue\n  > &\n    THeaderComponents & { FlexRender: Component } {\n    const header = inject(HeaderContext)\n\n    if (!header) {\n      throw new Error(\n        '`useHeaderContext` must be used within an `AppHeader` or `AppFooter` component.',\n      )\n    }\n\n    // `<table.AppHeader>` / `<table.AppFooter>` Object.assign `headerComponents`\n    // and `FlexRender` onto the same header instance they provide.\n    return header as unknown as Header<TFeatures, any, TValue> &\n      THeaderComponents & { FlexRender: Component }\n  }\n\n  const CellFlexRender = defineComponent({\n    name: 'AppCellFlexRender',\n    setup() {\n      const cell = useCellContext()\n      return () => h(AppFlexRender, { cell })\n    },\n  })\n\n  const HeaderFlexRender = defineComponent({\n    name: 'AppHeaderFlexRender',\n    setup() {\n      const header = useHeaderContext()\n      return () => h(AppFlexRender, { header })\n    },\n  })\n\n  const FooterFlexRender = defineComponent({\n    name: 'AppFooterFlexRender',\n    setup() {\n      const header = useHeaderContext()\n      return () => h(AppFlexRender, { footer: header })\n    },\n  })\n\n  function useAppTable<TData extends RowData>(\n    tableOptions: Omit<\n      TableOptionsWithReactiveData<TFeatures, TData>,\n      'features'\n    >,\n  ): AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  > {\n    const mergedOptions = mergeProxy(\n      defaultTableOptions,\n      tableOptions,\n    ) as TableOptionsWithReactiveData<TFeatures, TData>\n\n    const table = useTable<TFeatures, TData>(mergedOptions)\n\n    const AppTable = defineComponent({\n      name: 'AppTable',\n      setup(_, { slots }) {\n        provide(TableContext, table)\n        return () => {\n          return slots.default?.()\n        }\n      },\n    })\n\n    const AppCell = defineComponent({\n      name: 'AppCell',\n      props: {\n        cell: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const cell = props.cell as Cell<TFeatures, TData, any>\n\n        provide(CellContext, cell)\n\n        const extendedCell = Object.assign(cell, {\n          FlexRender: CellFlexRender,\n          ...(cellComponents ?? {}),\n        }) as Cell<TFeatures, TData, any> &\n          TCellComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ cell: extendedCell })\n        }\n      },\n    })\n\n    const AppHeader = defineComponent({\n      name: 'AppHeader',\n      props: {\n        header: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const header = props.header as Header<TFeatures, TData, any>\n\n        provide(HeaderContext, header)\n\n        const extendedHeader = Object.assign(header, {\n          FlexRender: HeaderFlexRender,\n          ...(headerComponents ?? {}),\n        }) as Header<TFeatures, TData, any> &\n          THeaderComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ header: extendedHeader })\n        }\n      },\n    })\n\n    const AppFooter = defineComponent({\n      name: 'AppFooter',\n      props: {\n        header: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const header = props.header as Header<TFeatures, TData, any>\n\n        provide(HeaderContext, header)\n\n        const extendedHeader = Object.assign(header, {\n          FlexRender: FooterFlexRender,\n          ...(headerComponents ?? {}),\n        }) as Header<TFeatures, TData, any> &\n          THeaderComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ header: extendedHeader })\n        }\n      },\n    })\n\n    return Object.assign(table, {\n      AppTable,\n      AppCell,\n      AppHeader,\n      AppFooter,\n      FlexRender: AppFlexRender,\n      ...(tableComponents ?? {}),\n    }) as AppVueTable<\n      TFeatures,\n      TData,\n      TableState<TFeatures>,\n      TTableComponents,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  return {\n    // `TableOptionsWithReactiveData` widens `features` to allow a reactive ref,\n    // so this narrows it back to the resolved `TFeatures` for `appFeatures`.\n    appFeatures: defaultTableOptions.features as TFeatures,\n    createAppColumnHelper,\n    useAppTable,\n    useTableContext,\n    useCellContext,\n    useHeaderContext,\n  }\n}\n"],"mappings":"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"}

package/dist/createTableHook.d.cts

@@ -66,6 +66,41 @@ type AppVueTable<TFeatures extends TableFeatures, TData extends RowData, TSelect
   AppFooter: Component<AppHeaderProps<TFeatures, TData>>;
   FlexRender: typeof AppFlexRender;
 };
+interface CreateTableHookResult<TFeatures extends TableFeatures, TTableComponents extends Record<string, ComponentType<any>>, TCellComponents extends Record<string, ComponentType<any>>, THeaderComponents extends Record<string, ComponentType<any>>> {
+  /** The features object that was passed to `createTableHook`. */
+  appFeatures: TFeatures;
+  /**
+   * A column helper pre-bound to `TFeatures` and the registered components, so
+   * the cell/header/footer render props expose the bound components.
+   */
+  createAppColumnHelper: <TData extends RowData>() => AppColumnHelper<TFeatures, TData, TCellComponents, THeaderComponents>;
+  /**
+   * Creates a table with the `App*` wrapper components and registered
+   * `tableComponents` attached. `TData` is inferred from the `data` option.
+   */
+  useAppTable: <TData extends RowData>(tableOptions: Omit<TableOptionsWithReactiveData<TFeatures, TData>, 'features'>) => AppVueTable<TFeatures, TData, TableState<TFeatures>, TTableComponents, TCellComponents, THeaderComponents>;
+  /**
+   * Reads the table provided by the nearest `<table.AppTable>`. This is the same
+   * extended instance `useAppTable` returns, so the `App*` components and your
+   * `tableComponents` are available on it.
+   */
+  useTableContext: <TData extends RowData = RowData>() => AppVueTable<TFeatures, TData, TableState<TFeatures>, TTableComponents, TCellComponents, THeaderComponents>;
+  /**
+   * Reads the cell provided by the nearest `<table.AppCell>`, extended with your
+   * `cellComponents` and a context-bound `FlexRender`.
+   */
+  useCellContext: <TValue extends CellData = CellData>() => Cell<TFeatures, any, TValue> & TCellComponents & {
+    FlexRender: Component;
+  };
+  /**
+   * Reads the header provided by the nearest `<table.AppHeader>` /
+   * `<table.AppFooter>`, extended with your `headerComponents` and a
+   * context-bound `FlexRender`.
+   */
+  useHeaderContext: <TValue extends CellData = CellData>() => Header<TFeatures, any, TValue> & THeaderComponents & {
+    FlexRender: Component;
+  };
+}
 declare const AppFlexRender: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   cell: {
     type: PropType<FlexRenderCell>;
@@ -121,14 +156,7 @@ declare function createTableHook<TFeatures extends TableFeatures, const TTableCo
   cellComponents,
   headerComponents,
   ...defaultTableOptions
-}: CreateTableHookOptions<TFeatures, TTableComponents, TCellComponents, THeaderComponents>): {
-  appFeatures: TFeatures;
-  createAppColumnHelper: <TData extends RowData>() => AppColumnHelper<TFeatures, TData, TCellComponents, THeaderComponents>;
-  useAppTable: <TData extends RowData>(tableOptions: Omit<TableOptionsWithReactiveData<TFeatures, TData>, "features">) => AppVueTable<TFeatures, TData, TableState<TFeatures>, TTableComponents, TCellComponents, THeaderComponents>;
-  useTableContext: <TData extends RowData = RowData>() => VueTable<TFeatures, TData>;
-  useCellContext: <TValue extends CellData = unknown>() => Cell<TFeatures, any, TValue>;
-  useHeaderContext: <TValue extends CellData = unknown>() => Header<TFeatures, any, TValue>;
-};
+}: CreateTableHookOptions<TFeatures, TTableComponents, TCellComponents, THeaderComponents>): CreateTableHookResult<TFeatures, TTableComponents, TCellComponents, THeaderComponents>;
 //#endregion
-export { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, createTableHook };
+export { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, CreateTableHookResult, createTableHook };
 //# sourceMappingURL=createTableHook.d.cts.map

package/dist/createTableHook.d.ts

@@ -66,6 +66,41 @@ type AppVueTable<TFeatures extends TableFeatures, TData extends RowData, TSelect
   AppFooter: Component<AppHeaderProps<TFeatures, TData>>;
   FlexRender: typeof AppFlexRender;
 };
+interface CreateTableHookResult<TFeatures extends TableFeatures, TTableComponents extends Record<string, ComponentType<any>>, TCellComponents extends Record<string, ComponentType<any>>, THeaderComponents extends Record<string, ComponentType<any>>> {
+  /** The features object that was passed to `createTableHook`. */
+  appFeatures: TFeatures;
+  /**
+   * A column helper pre-bound to `TFeatures` and the registered components, so
+   * the cell/header/footer render props expose the bound components.
+   */
+  createAppColumnHelper: <TData extends RowData>() => AppColumnHelper<TFeatures, TData, TCellComponents, THeaderComponents>;
+  /**
+   * Creates a table with the `App*` wrapper components and registered
+   * `tableComponents` attached. `TData` is inferred from the `data` option.
+   */
+  useAppTable: <TData extends RowData>(tableOptions: Omit<TableOptionsWithReactiveData<TFeatures, TData>, 'features'>) => AppVueTable<TFeatures, TData, TableState<TFeatures>, TTableComponents, TCellComponents, THeaderComponents>;
+  /**
+   * Reads the table provided by the nearest `<table.AppTable>`. This is the same
+   * extended instance `useAppTable` returns, so the `App*` components and your
+   * `tableComponents` are available on it.
+   */
+  useTableContext: <TData extends RowData = RowData>() => AppVueTable<TFeatures, TData, TableState<TFeatures>, TTableComponents, TCellComponents, THeaderComponents>;
+  /**
+   * Reads the cell provided by the nearest `<table.AppCell>`, extended with your
+   * `cellComponents` and a context-bound `FlexRender`.
+   */
+  useCellContext: <TValue extends CellData = CellData>() => Cell<TFeatures, any, TValue> & TCellComponents & {
+    FlexRender: Component;
+  };
+  /**
+   * Reads the header provided by the nearest `<table.AppHeader>` /
+   * `<table.AppFooter>`, extended with your `headerComponents` and a
+   * context-bound `FlexRender`.
+   */
+  useHeaderContext: <TValue extends CellData = CellData>() => Header<TFeatures, any, TValue> & THeaderComponents & {
+    FlexRender: Component;
+  };
+}
 declare const AppFlexRender: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   cell: {
     type: PropType<FlexRenderCell>;
@@ -121,14 +156,7 @@ declare function createTableHook<TFeatures extends TableFeatures, const TTableCo
   cellComponents,
   headerComponents,
   ...defaultTableOptions
-}: CreateTableHookOptions<TFeatures, TTableComponents, TCellComponents, THeaderComponents>): {
-  appFeatures: TFeatures;
-  createAppColumnHelper: <TData extends RowData>() => AppColumnHelper<TFeatures, TData, TCellComponents, THeaderComponents>;
-  useAppTable: <TData extends RowData>(tableOptions: Omit<TableOptionsWithReactiveData<TFeatures, TData>, "features">) => AppVueTable<TFeatures, TData, TableState<TFeatures>, TTableComponents, TCellComponents, THeaderComponents>;
-  useTableContext: <TData extends RowData = RowData>() => VueTable<TFeatures, TData>;
-  useCellContext: <TValue extends CellData = unknown>() => Cell<TFeatures, any, TValue>;
-  useHeaderContext: <TValue extends CellData = unknown>() => Header<TFeatures, any, TValue>;
-};
+}: CreateTableHookOptions<TFeatures, TTableComponents, TCellComponents, THeaderComponents>): CreateTableHookResult<TFeatures, TTableComponents, TCellComponents, THeaderComponents>;
 //#endregion
-export { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, createTableHook };
+export { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, CreateTableHookResult, createTableHook };
 //# sourceMappingURL=createTableHook.d.ts.map

package/dist/createTableHook.js.map

@@ -1 +1 @@
-{"version":3,"file":"createTableHook.js","names":["coreCreateColumnHelper"],"sources":["../src/createTableHook.ts"],"sourcesContent":["import { createColumnHelper as coreCreateColumnHelper } from '@tanstack/table-core'\nimport { defineComponent, h, inject, provide } from 'vue'\nimport { FlexRender } from './FlexRender'\nimport { mergeProxy } from './merge-proxy'\nimport { useTable } from './useTable'\nimport type { TableOptionsWithReactiveData, VueTable } from './useTable'\nimport type { FlexRenderCell, FlexRenderHeader } from './FlexRender'\nimport type { Component, InjectionKey, PropType, VNodeChild } from 'vue'\nimport type {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  Cell,\n  CellContext,\n  CellData,\n  Column,\n  ColumnDef,\n  DeepKeys,\n  DeepValue,\n  DisplayColumnDef,\n  GroupColumnDef,\n  Header,\n  IdentifiedColumnDef,\n  NoInfer,\n  Row,\n  RowData,\n  Table,\n  TableFeatures,\n  TableState,\n} from '@tanstack/table-core'\n\nexport type ComponentType<T extends Record<string, any>> = Component<T>\n\nexport type AppCellContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n> = {\n  cell: Cell<TFeatures, TData, TValue> &\n    TCellComponents & { FlexRender: Component }\n  column: Column<TFeatures, TData, TValue>\n  getValue: CellContext<TFeatures, TData, TValue>['getValue']\n  renderValue: CellContext<TFeatures, TData, TValue>['renderValue']\n  row: Row<TFeatures, TData>\n  table: Table<TFeatures, TData>\n}\n\nexport type AppHeaderContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = {\n  column: Column<TFeatures, TData, TValue>\n  header: Header<TFeatures, TData, TValue> &\n    THeaderComponents & { FlexRender: Component }\n  table: Table<TFeatures, TData>\n}\n\nexport type AppColumnDefTemplate<TProps extends object> =\n  | string\n  | ((props: TProps) => any)\n\nexport type AppColumnDefBase<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  IdentifiedColumnDef<TFeatures, TData, TValue>,\n  'cell' | 'header' | 'footer'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, TValue, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, TValue, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, TValue, THeaderComponents>\n  >\n}\n\nexport type AppDisplayColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  DisplayColumnDef<TFeatures, TData, unknown>,\n  'cell' | 'header' | 'footer'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, unknown, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n}\n\nexport type AppGroupColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  GroupColumnDef<TFeatures, TData, unknown>,\n  'cell' | 'header' | 'footer' | 'columns'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, unknown, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  columns?: Array<ColumnDef<TFeatures, TData, unknown>>\n}\n\nexport type AppColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = {\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? AppColumnDefBase<\n          TFeatures,\n          TData,\n          TValue,\n          TCellComponents,\n          THeaderComponents\n        > & { id: string }\n      : AppColumnDefBase<\n          TFeatures,\n          TData,\n          TValue,\n          TCellComponents,\n          THeaderComponents\n        >,\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TFeatures, TData, TValue>\n    : AccessorKeyColumnDef<TFeatures, TData, TValue>\n  columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n    columns: [...TColumns],\n  ) => Array<ColumnDef<TFeatures, TData, any>> & [...TColumns]\n  display: (\n    column: AppDisplayColumnDef<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >,\n  ) => DisplayColumnDef<TFeatures, TData, unknown>\n  group: (\n    column: AppGroupColumnDef<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >,\n  ) => GroupColumnDef<TFeatures, TData, unknown>\n}\n\nexport type CreateTableHookOptions<\n  TFeatures extends TableFeatures,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  TableOptionsWithReactiveData<TFeatures, any>,\n  'columns' | 'data' | 'store' | 'state' | 'initialState'\n> & {\n  tableComponents?: TTableComponents\n  cellComponents?: TCellComponents\n  headerComponents?: THeaderComponents\n}\n\nexport interface AppTableProps {}\n\nexport interface AppCellProps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  cell: Cell<TFeatures, TData, TValue>\n}\n\nexport interface AppHeaderProps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  header: Header<TFeatures, TData, TValue>\n}\n\nexport type AppVueTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = VueTable<TFeatures, TData> &\n  NoInfer<TTableComponents> & {\n    AppTable: Component<AppTableProps>\n    AppCell: Component<AppCellProps<TFeatures, TData>>\n    AppHeader: Component<AppHeaderProps<TFeatures, TData>>\n    AppFooter: Component<AppHeaderProps<TFeatures, TData>>\n    FlexRender: typeof AppFlexRender\n  }\n\nexport const AppFlexRender = defineComponent({\n  name: 'TableFlexRender',\n  props: {\n    cell: {\n      type: Object as PropType<FlexRenderCell>,\n      default: undefined,\n    },\n    header: {\n      type: Object as PropType<FlexRenderHeader>,\n      default: undefined,\n    },\n    footer: {\n      type: Object as PropType<FlexRenderHeader>,\n      default: undefined,\n    },\n  },\n  setup(props) {\n    return () => {\n      if (props.cell) {\n        return h(FlexRender, {\n          render: props.cell.column.columnDef.cell,\n          props: props.cell.getContext(),\n        })\n      }\n\n      if (props.header) {\n        return h(FlexRender, {\n          render: props.header.column.columnDef.header,\n          props: props.header.getContext(),\n        })\n      }\n\n      if (props.footer) {\n        return h(FlexRender, {\n          render: props.footer.column.columnDef.footer,\n          props: props.footer.getContext(),\n        })\n      }\n\n      return null\n    }\n  },\n})\n\n/**\n * Creates app-scoped Vue table helpers with features, row models, and\n * renderable component maps pre-bound.\n *\n * Use this when an app or design system wants typed `useAppTable`, a pre-bound\n * column helper, and context helpers for table, cell, and header components.\n *\n * @example\n * ```ts\n * const { useAppTable, createAppColumnHelper } = createTableHook({\n *   features,\n *   tableComponents: {},\n *   cellComponents: {},\n *   headerComponents: {},\n * })\n * ```\n */\nexport function createTableHook<\n  TFeatures extends TableFeatures,\n  const TTableComponents extends Record<string, ComponentType<any>>,\n  const TCellComponents extends Record<string, ComponentType<any>>,\n  const THeaderComponents extends Record<string, ComponentType<any>>,\n>({\n  tableComponents,\n  cellComponents,\n  headerComponents,\n  ...defaultTableOptions\n}: CreateTableHookOptions<\n  TFeatures,\n  TTableComponents,\n  TCellComponents,\n  THeaderComponents\n>) {\n  const TableContext = Symbol('TableContext') as InjectionKey<\n    VueTable<TFeatures, any>\n  >\n  const CellContext = Symbol('CellContext') as InjectionKey<\n    Cell<TFeatures, any, any>\n  >\n  const HeaderContext = Symbol('HeaderContext') as InjectionKey<\n    Header<TFeatures, any, any>\n  >\n\n  function createAppColumnHelper<TData extends RowData>(): AppColumnHelper<\n    TFeatures,\n    TData,\n    TCellComponents,\n    THeaderComponents\n  > {\n    return coreCreateColumnHelper<TFeatures, TData>() as AppColumnHelper<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  function useTableContext<TData extends RowData = RowData>(): VueTable<\n    TFeatures,\n    TData\n  > {\n    const table = inject(TableContext)\n\n    if (!table) {\n      throw new Error(\n        '`useTableContext` must be used within an `AppTable` component. ' +\n          'Make sure your component is wrapped with `<table.AppTable>...</table.AppTable>`.',\n      )\n    }\n\n    return table as VueTable<TFeatures, TData>\n  }\n\n  function useCellContext<TValue extends CellData = CellData>(): Cell<\n    TFeatures,\n    any,\n    TValue\n  > {\n    const cell = inject(CellContext)\n\n    if (!cell) {\n      throw new Error(\n        '`useCellContext` must be used within an `AppCell` component. ' +\n          'Make sure your component is wrapped with `<table.AppCell :cell=\"cell\">...</table.AppCell>`.',\n      )\n    }\n\n    return cell as Cell<TFeatures, any, TValue>\n  }\n\n  function useHeaderContext<TValue extends CellData = CellData>(): Header<\n    TFeatures,\n    any,\n    TValue\n  > {\n    const header = inject(HeaderContext)\n\n    if (!header) {\n      throw new Error(\n        '`useHeaderContext` must be used within an `AppHeader` or `AppFooter` component.',\n      )\n    }\n\n    return header as Header<TFeatures, any, TValue>\n  }\n\n  const CellFlexRender = defineComponent({\n    name: 'AppCellFlexRender',\n    setup() {\n      const cell = useCellContext()\n      return () => h(AppFlexRender, { cell })\n    },\n  })\n\n  const HeaderFlexRender = defineComponent({\n    name: 'AppHeaderFlexRender',\n    setup() {\n      const header = useHeaderContext()\n      return () => h(AppFlexRender, { header })\n    },\n  })\n\n  const FooterFlexRender = defineComponent({\n    name: 'AppFooterFlexRender',\n    setup() {\n      const header = useHeaderContext()\n      return () => h(AppFlexRender, { footer: header })\n    },\n  })\n\n  function useAppTable<TData extends RowData>(\n    tableOptions: Omit<\n      TableOptionsWithReactiveData<TFeatures, TData>,\n      'features'\n    >,\n  ): AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  > {\n    const mergedOptions = mergeProxy(\n      defaultTableOptions,\n      tableOptions,\n    ) as TableOptionsWithReactiveData<TFeatures, TData>\n\n    const table = useTable<TFeatures, TData>(mergedOptions)\n\n    const AppTable = defineComponent({\n      name: 'AppTable',\n      setup(_, { slots }) {\n        provide(TableContext, table)\n        return () => {\n          return slots.default?.()\n        }\n      },\n    })\n\n    const AppCell = defineComponent({\n      name: 'AppCell',\n      props: {\n        cell: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const cell = props.cell as Cell<TFeatures, TData, any>\n\n        provide(CellContext, cell)\n\n        const extendedCell = Object.assign(cell, {\n          FlexRender: CellFlexRender,\n          ...(cellComponents ?? {}),\n        }) as Cell<TFeatures, TData, any> &\n          TCellComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ cell: extendedCell })\n        }\n      },\n    })\n\n    const AppHeader = defineComponent({\n      name: 'AppHeader',\n      props: {\n        header: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const header = props.header as Header<TFeatures, TData, any>\n\n        provide(HeaderContext, header)\n\n        const extendedHeader = Object.assign(header, {\n          FlexRender: HeaderFlexRender,\n          ...(headerComponents ?? {}),\n        }) as Header<TFeatures, TData, any> &\n          THeaderComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ header: extendedHeader })\n        }\n      },\n    })\n\n    const AppFooter = defineComponent({\n      name: 'AppFooter',\n      props: {\n        header: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const header = props.header as Header<TFeatures, TData, any>\n\n        provide(HeaderContext, header)\n\n        const extendedHeader = Object.assign(header, {\n          FlexRender: FooterFlexRender,\n          ...(headerComponents ?? {}),\n        }) as Header<TFeatures, TData, any> &\n          THeaderComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ header: extendedHeader })\n        }\n      },\n    })\n\n    return Object.assign(table, {\n      AppTable,\n      AppCell,\n      AppHeader,\n      AppFooter,\n      FlexRender: AppFlexRender,\n      ...(tableComponents ?? {}),\n    }) as AppVueTable<\n      TFeatures,\n      TData,\n      TableState<TFeatures>,\n      TTableComponents,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  return {\n    appFeatures: defaultTableOptions.features as TFeatures,\n    createAppColumnHelper,\n    useAppTable,\n    useTableContext,\n    useCellContext,\n    useHeaderContext,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"createTableHook.js","names":["coreCreateColumnHelper"],"sources":["../src/createTableHook.ts"],"sourcesContent":["import { createColumnHelper as coreCreateColumnHelper } from '@tanstack/table-core'\nimport { defineComponent, h, inject, provide } from 'vue'\nimport { FlexRender } from './FlexRender'\nimport { mergeProxy } from './merge-proxy'\nimport { useTable } from './useTable'\nimport type { TableOptionsWithReactiveData, VueTable } from './useTable'\nimport type { FlexRenderCell, FlexRenderHeader } from './FlexRender'\nimport type { Component, InjectionKey, PropType, VNodeChild } from 'vue'\nimport type {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  Cell,\n  CellContext,\n  CellData,\n  Column,\n  ColumnDef,\n  DeepKeys,\n  DeepValue,\n  DisplayColumnDef,\n  GroupColumnDef,\n  Header,\n  IdentifiedColumnDef,\n  NoInfer,\n  Row,\n  RowData,\n  Table,\n  TableFeatures,\n  TableState,\n} from '@tanstack/table-core'\n\nexport type ComponentType<T extends Record<string, any>> = Component<T>\n\nexport type AppCellContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n> = {\n  cell: Cell<TFeatures, TData, TValue> &\n    TCellComponents & { FlexRender: Component }\n  column: Column<TFeatures, TData, TValue>\n  getValue: CellContext<TFeatures, TData, TValue>['getValue']\n  renderValue: CellContext<TFeatures, TData, TValue>['renderValue']\n  row: Row<TFeatures, TData>\n  table: Table<TFeatures, TData>\n}\n\nexport type AppHeaderContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = {\n  column: Column<TFeatures, TData, TValue>\n  header: Header<TFeatures, TData, TValue> &\n    THeaderComponents & { FlexRender: Component }\n  table: Table<TFeatures, TData>\n}\n\nexport type AppColumnDefTemplate<TProps extends object> =\n  | string\n  | ((props: TProps) => any)\n\nexport type AppColumnDefBase<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  IdentifiedColumnDef<TFeatures, TData, TValue>,\n  'cell' | 'header' | 'footer'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, TValue, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, TValue, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, TValue, THeaderComponents>\n  >\n}\n\nexport type AppDisplayColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  DisplayColumnDef<TFeatures, TData, unknown>,\n  'cell' | 'header' | 'footer'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, unknown, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n}\n\nexport type AppGroupColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  GroupColumnDef<TFeatures, TData, unknown>,\n  'cell' | 'header' | 'footer' | 'columns'\n> & {\n  cell?: AppColumnDefTemplate<\n    AppCellContext<TFeatures, TData, unknown, TCellComponents>\n  >\n  header?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  footer?: AppColumnDefTemplate<\n    AppHeaderContext<TFeatures, TData, unknown, THeaderComponents>\n  >\n  columns?: Array<ColumnDef<TFeatures, TData, unknown>>\n}\n\nexport type AppColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = {\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? AppColumnDefBase<\n          TFeatures,\n          TData,\n          TValue,\n          TCellComponents,\n          THeaderComponents\n        > & { id: string }\n      : AppColumnDefBase<\n          TFeatures,\n          TData,\n          TValue,\n          TCellComponents,\n          THeaderComponents\n        >,\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TFeatures, TData, TValue>\n    : AccessorKeyColumnDef<TFeatures, TData, TValue>\n  columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n    columns: [...TColumns],\n  ) => Array<ColumnDef<TFeatures, TData, any>> & [...TColumns]\n  display: (\n    column: AppDisplayColumnDef<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >,\n  ) => DisplayColumnDef<TFeatures, TData, unknown>\n  group: (\n    column: AppGroupColumnDef<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >,\n  ) => GroupColumnDef<TFeatures, TData, unknown>\n}\n\nexport type CreateTableHookOptions<\n  TFeatures extends TableFeatures,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = Omit<\n  TableOptionsWithReactiveData<TFeatures, any>,\n  'columns' | 'data' | 'store' | 'state' | 'initialState'\n> & {\n  tableComponents?: TTableComponents\n  cellComponents?: TCellComponents\n  headerComponents?: THeaderComponents\n}\n\nexport interface AppTableProps {}\n\nexport interface AppCellProps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  cell: Cell<TFeatures, TData, TValue>\n}\n\nexport interface AppHeaderProps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  header: Header<TFeatures, TData, TValue>\n}\n\nexport type AppVueTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TSelected,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> = VueTable<TFeatures, TData> &\n  NoInfer<TTableComponents> & {\n    AppTable: Component<AppTableProps>\n    AppCell: Component<AppCellProps<TFeatures, TData>>\n    AppHeader: Component<AppHeaderProps<TFeatures, TData>>\n    AppFooter: Component<AppHeaderProps<TFeatures, TData>>\n    FlexRender: typeof AppFlexRender\n  }\n\nexport interface CreateTableHookResult<\n  TFeatures extends TableFeatures,\n  TTableComponents extends Record<string, ComponentType<any>>,\n  TCellComponents extends Record<string, ComponentType<any>>,\n  THeaderComponents extends Record<string, ComponentType<any>>,\n> {\n  /** The features object that was passed to `createTableHook`. */\n  appFeatures: TFeatures\n  /**\n   * A column helper pre-bound to `TFeatures` and the registered components, so\n   * the cell/header/footer render props expose the bound components.\n   */\n  createAppColumnHelper: <TData extends RowData>() => AppColumnHelper<\n    TFeatures,\n    TData,\n    TCellComponents,\n    THeaderComponents\n  >\n  /**\n   * Creates a table with the `App*` wrapper components and registered\n   * `tableComponents` attached. `TData` is inferred from the `data` option.\n   */\n  useAppTable: <TData extends RowData>(\n    tableOptions: Omit<\n      TableOptionsWithReactiveData<TFeatures, TData>,\n      'features'\n    >,\n  ) => AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  >\n  /**\n   * Reads the table provided by the nearest `<table.AppTable>`. This is the same\n   * extended instance `useAppTable` returns, so the `App*` components and your\n   * `tableComponents` are available on it.\n   */\n  useTableContext: <TData extends RowData = RowData>() => AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  >\n  /**\n   * Reads the cell provided by the nearest `<table.AppCell>`, extended with your\n   * `cellComponents` and a context-bound `FlexRender`.\n   */\n  useCellContext: <TValue extends CellData = CellData>() => Cell<\n    TFeatures,\n    any,\n    TValue\n  > &\n    TCellComponents & { FlexRender: Component }\n  /**\n   * Reads the header provided by the nearest `<table.AppHeader>` /\n   * `<table.AppFooter>`, extended with your `headerComponents` and a\n   * context-bound `FlexRender`.\n   */\n  useHeaderContext: <TValue extends CellData = CellData>() => Header<\n    TFeatures,\n    any,\n    TValue\n  > &\n    THeaderComponents & { FlexRender: Component }\n}\n\nexport const AppFlexRender = defineComponent({\n  name: 'TableFlexRender',\n  props: {\n    cell: {\n      type: Object as PropType<FlexRenderCell>,\n      default: undefined,\n    },\n    header: {\n      type: Object as PropType<FlexRenderHeader>,\n      default: undefined,\n    },\n    footer: {\n      type: Object as PropType<FlexRenderHeader>,\n      default: undefined,\n    },\n  },\n  setup(props) {\n    return () => {\n      if (props.cell) {\n        return h(FlexRender, {\n          render: props.cell.column.columnDef.cell,\n          props: props.cell.getContext(),\n        })\n      }\n\n      if (props.header) {\n        return h(FlexRender, {\n          render: props.header.column.columnDef.header,\n          props: props.header.getContext(),\n        })\n      }\n\n      if (props.footer) {\n        return h(FlexRender, {\n          render: props.footer.column.columnDef.footer,\n          props: props.footer.getContext(),\n        })\n      }\n\n      return null\n    }\n  },\n})\n\n/**\n * Creates app-scoped Vue table helpers with features, row models, and\n * renderable component maps pre-bound.\n *\n * Use this when an app or design system wants typed `useAppTable`, a pre-bound\n * column helper, and context helpers for table, cell, and header components.\n *\n * @example\n * ```ts\n * const { useAppTable, createAppColumnHelper } = createTableHook({\n *   features,\n *   tableComponents: {},\n *   cellComponents: {},\n *   headerComponents: {},\n * })\n * ```\n */\nexport function createTableHook<\n  TFeatures extends TableFeatures,\n  const TTableComponents extends Record<string, ComponentType<any>>,\n  const TCellComponents extends Record<string, ComponentType<any>>,\n  const THeaderComponents extends Record<string, ComponentType<any>>,\n>({\n  tableComponents,\n  cellComponents,\n  headerComponents,\n  ...defaultTableOptions\n}: CreateTableHookOptions<\n  TFeatures,\n  TTableComponents,\n  TCellComponents,\n  THeaderComponents\n>): CreateTableHookResult<\n  TFeatures,\n  TTableComponents,\n  TCellComponents,\n  THeaderComponents\n> {\n  const TableContext = Symbol('TableContext') as InjectionKey<\n    VueTable<TFeatures, any>\n  >\n  const CellContext = Symbol('CellContext') as InjectionKey<\n    Cell<TFeatures, any, any>\n  >\n  const HeaderContext = Symbol('HeaderContext') as InjectionKey<\n    Header<TFeatures, any, any>\n  >\n\n  function createAppColumnHelper<TData extends RowData>(): AppColumnHelper<\n    TFeatures,\n    TData,\n    TCellComponents,\n    THeaderComponents\n  > {\n    return coreCreateColumnHelper<TFeatures, TData>() as AppColumnHelper<\n      TFeatures,\n      TData,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  function useTableContext<TData extends RowData = RowData>(): AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  > {\n    const table = inject(TableContext)\n\n    if (!table) {\n      throw new Error(\n        '`useTableContext` must be used within an `AppTable` component. ' +\n          'Make sure your component is wrapped with `<table.AppTable>...</table.AppTable>`.',\n      )\n    }\n\n    // The value provided by `<table.AppTable>` is the extended table (the App*\n    // wrapper components and `tableComponents` are Object.assign-ed onto the same\n    // instance `useAppTable` returns), so this asserts the runtime shape.\n    return table as unknown as AppVueTable<\n      TFeatures,\n      TData,\n      TableState<TFeatures>,\n      TTableComponents,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  function useCellContext<TValue extends CellData = CellData>(): Cell<\n    TFeatures,\n    any,\n    TValue\n  > &\n    TCellComponents & { FlexRender: Component } {\n    const cell = inject(CellContext)\n\n    if (!cell) {\n      throw new Error(\n        '`useCellContext` must be used within an `AppCell` component. ' +\n          'Make sure your component is wrapped with `<table.AppCell :cell=\"cell\">...</table.AppCell>`.',\n      )\n    }\n\n    // `<table.AppCell>` Object.assign-es `cellComponents` and `FlexRender` onto\n    // the same cell instance it provides, so this asserts the runtime shape.\n    return cell as unknown as Cell<TFeatures, any, TValue> &\n      TCellComponents & { FlexRender: Component }\n  }\n\n  function useHeaderContext<TValue extends CellData = CellData>(): Header<\n    TFeatures,\n    any,\n    TValue\n  > &\n    THeaderComponents & { FlexRender: Component } {\n    const header = inject(HeaderContext)\n\n    if (!header) {\n      throw new Error(\n        '`useHeaderContext` must be used within an `AppHeader` or `AppFooter` component.',\n      )\n    }\n\n    // `<table.AppHeader>` / `<table.AppFooter>` Object.assign `headerComponents`\n    // and `FlexRender` onto the same header instance they provide.\n    return header as unknown as Header<TFeatures, any, TValue> &\n      THeaderComponents & { FlexRender: Component }\n  }\n\n  const CellFlexRender = defineComponent({\n    name: 'AppCellFlexRender',\n    setup() {\n      const cell = useCellContext()\n      return () => h(AppFlexRender, { cell })\n    },\n  })\n\n  const HeaderFlexRender = defineComponent({\n    name: 'AppHeaderFlexRender',\n    setup() {\n      const header = useHeaderContext()\n      return () => h(AppFlexRender, { header })\n    },\n  })\n\n  const FooterFlexRender = defineComponent({\n    name: 'AppFooterFlexRender',\n    setup() {\n      const header = useHeaderContext()\n      return () => h(AppFlexRender, { footer: header })\n    },\n  })\n\n  function useAppTable<TData extends RowData>(\n    tableOptions: Omit<\n      TableOptionsWithReactiveData<TFeatures, TData>,\n      'features'\n    >,\n  ): AppVueTable<\n    TFeatures,\n    TData,\n    TableState<TFeatures>,\n    TTableComponents,\n    TCellComponents,\n    THeaderComponents\n  > {\n    const mergedOptions = mergeProxy(\n      defaultTableOptions,\n      tableOptions,\n    ) as TableOptionsWithReactiveData<TFeatures, TData>\n\n    const table = useTable<TFeatures, TData>(mergedOptions)\n\n    const AppTable = defineComponent({\n      name: 'AppTable',\n      setup(_, { slots }) {\n        provide(TableContext, table)\n        return () => {\n          return slots.default?.()\n        }\n      },\n    })\n\n    const AppCell = defineComponent({\n      name: 'AppCell',\n      props: {\n        cell: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const cell = props.cell as Cell<TFeatures, TData, any>\n\n        provide(CellContext, cell)\n\n        const extendedCell = Object.assign(cell, {\n          FlexRender: CellFlexRender,\n          ...(cellComponents ?? {}),\n        }) as Cell<TFeatures, TData, any> &\n          TCellComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ cell: extendedCell })\n        }\n      },\n    })\n\n    const AppHeader = defineComponent({\n      name: 'AppHeader',\n      props: {\n        header: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const header = props.header as Header<TFeatures, TData, any>\n\n        provide(HeaderContext, header)\n\n        const extendedHeader = Object.assign(header, {\n          FlexRender: HeaderFlexRender,\n          ...(headerComponents ?? {}),\n        }) as Header<TFeatures, TData, any> &\n          THeaderComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ header: extendedHeader })\n        }\n      },\n    })\n\n    const AppFooter = defineComponent({\n      name: 'AppFooter',\n      props: {\n        header: {\n          type: Object as PropType<object>,\n          required: true,\n        },\n      },\n      setup(props, { slots }) {\n        const header = props.header as Header<TFeatures, TData, any>\n\n        provide(HeaderContext, header)\n\n        const extendedHeader = Object.assign(header, {\n          FlexRender: FooterFlexRender,\n          ...(headerComponents ?? {}),\n        }) as Header<TFeatures, TData, any> &\n          THeaderComponents & { FlexRender: Component }\n\n        return () => {\n          return slots.default?.({ header: extendedHeader })\n        }\n      },\n    })\n\n    return Object.assign(table, {\n      AppTable,\n      AppCell,\n      AppHeader,\n      AppFooter,\n      FlexRender: AppFlexRender,\n      ...(tableComponents ?? {}),\n    }) as AppVueTable<\n      TFeatures,\n      TData,\n      TableState<TFeatures>,\n      TTableComponents,\n      TCellComponents,\n      THeaderComponents\n    >\n  }\n\n  return {\n    // `TableOptionsWithReactiveData` widens `features` to allow a reactive ref,\n    // so this narrows it back to the resolved `TFeatures` for `appFeatures`.\n    appFeatures: defaultTableOptions.features as TFeatures,\n    createAppColumnHelper,\n    useAppTable,\n    useTableContext,\n    useCellContext,\n    useHeaderContext,\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { FlexRender, FlexRenderCell, FlexRenderHeader, flexRender } from "./FlexRender.cjs";
 import { TableOptionsWithReactiveData, VueTable, useTable } from "./useTable.cjs";
-import { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, createTableHook } from "./createTableHook.cjs";
+import { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, CreateTableHookResult, createTableHook } from "./createTableHook.cjs";
 export * from "@tanstack/table-core";
-export { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, FlexRender, FlexRenderCell, FlexRenderHeader, TableOptionsWithReactiveData, VueTable, createTableHook, flexRender, useTable };
+export { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, CreateTableHookResult, FlexRender, FlexRenderCell, FlexRenderHeader, TableOptionsWithReactiveData, VueTable, createTableHook, flexRender, useTable };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { FlexRender, FlexRenderCell, FlexRenderHeader, flexRender } from "./FlexRender.js";
 import { TableOptionsWithReactiveData, VueTable, useTable } from "./useTable.js";
-import { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, createTableHook } from "./createTableHook.js";
+import { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, CreateTableHookResult, createTableHook } from "./createTableHook.js";
 export * from "@tanstack/table-core";
-export { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, FlexRender, FlexRenderCell, FlexRenderHeader, TableOptionsWithReactiveData, VueTable, createTableHook, flexRender, useTable };
+export { AppCellContext, AppCellProps, AppColumnDefBase, AppColumnDefTemplate, AppColumnHelper, AppDisplayColumnDef, AppFlexRender, AppGroupColumnDef, AppHeaderContext, AppHeaderProps, AppTableProps, AppVueTable, ComponentType, CreateTableHookOptions, CreateTableHookResult, FlexRender, FlexRenderCell, FlexRenderHeader, TableOptionsWithReactiveData, VueTable, createTableHook, flexRender, useTable };

package/dist/useTable.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useTable.cjs","names":["mergeProxy","flatMerge","vueReactivity"],"sources":["../src/useTable.ts"],"sourcesContent":["import { getCurrentScope, onScopeDispose, unref, watch } from 'vue'\nimport { constructTable } from '@tanstack/table-core'\nimport { flatMerge, mergeProxy } from './merge-proxy'\nimport { vueReactivity } from './reactivity'\nimport type {\n  RowData,\n  Table,\n  TableFeatures,\n  TableOptions,\n  TableState,\n} from '@tanstack/table-core'\nimport type { MaybeRef, VNode } from 'vue'\n\nexport type TableOptionsWithReactiveData<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = {\n  [K in keyof TableOptions<TFeatures, TData>]: K extends 'data'\n    ? MaybeRef<ReadonlyArray<TData>>\n    : MaybeRef<TableOptions<TFeatures, TData>[K]>\n}\n\nfunction getOptionsWithReactiveValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(options: TableOptionsWithReactiveData<TFeatures, TData>) {\n  const resolvedOptions: Record<string, unknown> = {}\n\n  for (const key of Object.keys(options)) {\n    resolvedOptions[key] = unref(\n      options[key as keyof TableOptionsWithReactiveData<TFeatures, TData>],\n    )\n  }\n\n  return mergeProxy(options, resolvedOptions)\n}\n\nfunction getReactiveOptionDeps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(options: TableOptionsWithReactiveData<TFeatures, TData>) {\n  return Object.keys(options).map((key) =>\n    unref(options[key as keyof TableOptionsWithReactiveData<TFeatures, TData>]),\n  )\n}\n\nexport type VueTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = Omit<Table<TFeatures, TData>, 'store'> & {\n  /**\n   * @deprecated Prefer `table.atoms.<slice>.get()` for slice snapshots, or\n   * `table.Subscribe` for explicit subscriptions. `table.store.state` is a\n   * current-value snapshot and is easy to misuse in render code.\n   */\n  readonly store: Table<TFeatures, TData>['store']\n  /** Creates a reactive render boundary. The child function reads the table\n   * atoms it needs, so Vue only tracks those atom reads.\n   */\n  Subscribe: (props: {\n    children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>\n  }) => VNode | Array<VNode>\n}\n\n/**\n * Creates a Vue table instance backed by Vue-aware TanStack Store atoms.\n *\n * Table options may contain Vue refs or computed values. The adapter unwraps\n * those reactive inputs, watches them with synchronous flushing, and keeps the\n * table options in sync. Use `table.Subscribe` or native Vue computed values\n * around `table.atoms.<slice>.get()` for selected reactive reads.\n *\n * @example\n * ```ts\n * const table = useTable(\n *   {\n *     features,\n *     columns,\n *     data,\n *   },\n * )\n * ```\n */\nexport function useTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  tableOptions:\n    | TableOptions<TFeatures, TData>\n    | TableOptionsWithReactiveData<TFeatures, TData>,\n): VueTable<TFeatures, TData> {\n  const syncTableOptions = (\n    table: Table<TFeatures, TData>,\n    options: TableOptionsWithReactiveData<TFeatures, TData>,\n  ) => {\n    table.setOptions((prev) =>\n      flatMerge(prev, getOptionsWithReactiveValues(options)),\n    )\n  }\n\n  const reactivity = vueReactivity()\n\n  const mergedOptions = mergeProxy(tableOptions, {\n    features: {\n      coreReactivityFeature: reactivity,\n      ...(unref(tableOptions.features) ?? {}),\n    },\n  }) as TableOptionsWithReactiveData<TFeatures, TData>\n\n  const resolvedOptions = mergeProxy(\n    getOptionsWithReactiveValues(mergedOptions),\n    {\n      // Remove state and onStateChange - store handles it internally\n      mergeOptions: (\n        defaultOptions: TableOptions<TFeatures, TData>,\n        newOptions: Partial<TableOptions<TFeatures, TData>>,\n      ) => {\n        return flatMerge(defaultOptions, newOptions)\n      },\n    },\n  ) as TableOptions<TFeatures, TData>\n\n  const coreTable = constructTable(resolvedOptions)\n  const table = coreTable as unknown as VueTable<TFeatures, TData>\n\n  if (getCurrentScope()) {\n    onScopeDispose(() => reactivity.unmount?.())\n  }\n\n  watch(\n    () => getReactiveOptionDeps(mergedOptions),\n    () => {\n      syncTableOptions(coreTable, mergedOptions)\n    },\n    { immediate: true },\n  )\n\n  watch(\n    () => {\n      const controlledState = unref(tableOptions.state) as\n        | Record<string, unknown>\n        | undefined\n      const controlledAtoms = unref(tableOptions.atoms) as\n        | Record<string, unknown>\n        | undefined\n\n      if (!controlledState) {\n        return []\n      }\n\n      const controlledValues: Array<unknown> = []\n\n      for (const key of Object.keys(table.initialState)) {\n        if (!(key in controlledState) || controlledAtoms?.[key] !== undefined) {\n          continue\n        }\n\n        // Reading only controlled state slices here lets Vue subscribe to\n        // getters/computed values that are passed through `options.state`.\n        controlledValues.push(controlledState[key])\n      }\n\n      return controlledValues\n    },\n    (controlledValues) => {\n      if (controlledValues.length > 0) {\n        syncTableOptions(coreTable, mergedOptions)\n      }\n    },\n    { immediate: true },\n  )\n\n  table.Subscribe = (props: {\n    children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>\n  }) => {\n    return props.children(table.atoms)\n  }\n\n  return table\n}\n"],"mappings":";;;;;;AAsBA,SAAS,6BAGP,SAAyD;CACzD,MAAM,kBAA2C,CAAC;CAElD,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GACnC,gBAAgB,sBACd,QAAQ,IACV;CAGF,OAAOA,+BAAW,SAAS,eAAe;AAC5C;AAEA,SAAS,sBAGP,SAAyD;CACzD,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,KAAK,uBACzB,QAAQ,IAA4D,CAC5E;AACF;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,SAId,cAG4B;CAC5B,MAAM,oBACJ,OACA,YACG;EACH,MAAM,YAAY,SAChBC,8BAAU,MAAM,6BAA6B,OAAO,CAAC,CACvD;CACF;CAEA,MAAM,aAAaC,iCAAc;CAEjC,MAAM,gBAAgBF,+BAAW,cAAc,EAC7C,UAAU;EACR,uBAAuB;EACvB,kBAAU,aAAa,QAAQ,KAAK,CAAC;CACvC,EACF,CAAC;CAeD,MAAM,qDAbkBA,+BACtB,6BAA6B,aAAa,GAC1C,EAEE,eACE,gBACA,eACG;EACH,OAAOC,8BAAU,gBAAgB,UAAU;CAC7C,EACF,CAG6C,CAAC;CAChD,MAAM,QAAQ;CAEd,6BAAoB,GAClB,8BAAqB;;2CAAW,kGAAU;EAAC;CAG7C,qBACQ,sBAAsB,aAAa,SACnC;EACJ,iBAAiB,WAAW,aAAa;CAC3C,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,qBACQ;EACJ,MAAM,iCAAwB,aAAa,KAAK;EAGhD,MAAM,iCAAwB,aAAa,KAAK;EAIhD,IAAI,CAAC,iBACH,OAAO,CAAC;EAGV,MAAM,mBAAmC,CAAC;EAE1C,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,YAAY,GAAG;GACjD,IAAI,EAAE,OAAO,uFAAoB,gBAAkB,UAAS,QAC1D;GAKF,iBAAiB,KAAK,gBAAgB,IAAI;EAC5C;EAEA,OAAO;CACT,IACC,qBAAqB;EACpB,IAAI,iBAAiB,SAAS,GAC5B,iBAAiB,WAAW,aAAa;CAE7C,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,MAAM,aAAa,UAEb;EACJ,OAAO,MAAM,SAAS,MAAM,KAAK;CACnC;CAEA,OAAO;AACT"}
+{"version":3,"file":"useTable.cjs","names":["mergeProxy","flatMerge","vueReactivity"],"sources":["../src/useTable.ts"],"sourcesContent":["import { getCurrentScope, onScopeDispose, unref, watch } from 'vue'\nimport { constructTable } from '@tanstack/table-core'\nimport { flatMerge, mergeProxy } from './merge-proxy'\nimport { vueReactivity } from './reactivity'\nimport type {\n  RowData,\n  Table,\n  TableFeatures,\n  TableOptions,\n} from '@tanstack/table-core'\nimport type { MaybeRef, VNode } from 'vue'\n\nexport type TableOptionsWithReactiveData<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = {\n  [K in keyof TableOptions<TFeatures, TData>]: K extends 'data'\n    ? MaybeRef<ReadonlyArray<TData>>\n    : MaybeRef<TableOptions<TFeatures, TData>[K]>\n}\n\nfunction getOptionsWithReactiveValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(options: TableOptionsWithReactiveData<TFeatures, TData>) {\n  const resolvedOptions: Record<string, unknown> = {}\n\n  for (const key of Object.keys(options)) {\n    resolvedOptions[key] = unref(\n      options[key as keyof TableOptionsWithReactiveData<TFeatures, TData>],\n    )\n  }\n\n  return mergeProxy(options, resolvedOptions)\n}\n\nfunction getReactiveOptionDeps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(options: TableOptionsWithReactiveData<TFeatures, TData>) {\n  return Object.keys(options).map((key) =>\n    unref(options[key as keyof TableOptionsWithReactiveData<TFeatures, TData>]),\n  )\n}\n\nexport type VueTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = Table<TFeatures, TData> & {\n  /** Creates a reactive render boundary. The child function reads the table\n   * atoms it needs, so Vue only tracks those atom reads.\n   */\n  Subscribe: (props: {\n    children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>\n  }) => VNode | Array<VNode>\n}\n\n/**\n * Creates a Vue table instance backed by Vue-aware TanStack Store atoms.\n *\n * Table options may contain Vue refs or computed values. The adapter unwraps\n * those reactive inputs, watches them with synchronous flushing, and keeps the\n * table options in sync. Use `table.Subscribe` or native Vue computed values\n * around `table.atoms.<slice>.get()` for selected reactive reads.\n *\n * @example\n * ```ts\n * const table = useTable(\n *   {\n *     features,\n *     columns,\n *     data,\n *   },\n * )\n * ```\n */\nexport function useTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  tableOptions:\n    | TableOptions<TFeatures, TData>\n    | TableOptionsWithReactiveData<TFeatures, TData>,\n): VueTable<TFeatures, TData> {\n  const syncTableOptions = (\n    table: Table<TFeatures, TData>,\n    options: TableOptionsWithReactiveData<TFeatures, TData>,\n  ) => {\n    table.setOptions((prev) =>\n      flatMerge(prev, getOptionsWithReactiveValues(options)),\n    )\n  }\n\n  const reactivity = vueReactivity()\n\n  const mergedOptions = mergeProxy(tableOptions, {\n    features: {\n      coreReactivityFeature: reactivity,\n      ...(unref(tableOptions.features) ?? {}),\n    },\n  }) as TableOptionsWithReactiveData<TFeatures, TData>\n\n  const resolvedOptions = mergeProxy(\n    getOptionsWithReactiveValues(mergedOptions),\n    {\n      // Remove state and onStateChange - store handles it internally\n      mergeOptions: (\n        defaultOptions: TableOptions<TFeatures, TData>,\n        newOptions: Partial<TableOptions<TFeatures, TData>>,\n      ) => {\n        return flatMerge(defaultOptions, newOptions)\n      },\n    },\n  ) as TableOptions<TFeatures, TData>\n\n  const coreTable = constructTable(resolvedOptions)\n  const table = coreTable as unknown as VueTable<TFeatures, TData>\n\n  if (getCurrentScope()) {\n    onScopeDispose(() => reactivity.unmount?.())\n  }\n\n  watch(\n    () => getReactiveOptionDeps(mergedOptions),\n    () => {\n      syncTableOptions(coreTable, mergedOptions)\n    },\n    { immediate: true },\n  )\n\n  watch(\n    () => {\n      const controlledState = unref(tableOptions.state) as\n        | Record<string, unknown>\n        | undefined\n      const controlledAtoms = unref(tableOptions.atoms) as\n        | Record<string, unknown>\n        | undefined\n\n      if (!controlledState) {\n        return []\n      }\n\n      const controlledValues: Array<unknown> = []\n\n      for (const key of Object.keys(table.initialState)) {\n        if (!(key in controlledState) || controlledAtoms?.[key] !== undefined) {\n          continue\n        }\n\n        // Reading only controlled state slices here lets Vue subscribe to\n        // getters/computed values that are passed through `options.state`.\n        controlledValues.push(controlledState[key])\n      }\n\n      return controlledValues\n    },\n    (controlledValues) => {\n      if (controlledValues.length > 0) {\n        syncTableOptions(coreTable, mergedOptions)\n      }\n    },\n    { immediate: true },\n  )\n\n  table.Subscribe = (props: {\n    children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>\n  }) => {\n    return props.children(table.atoms as Table<TFeatures, TData>['atoms'])\n  }\n\n  return table\n}\n"],"mappings":";;;;;;AAqBA,SAAS,6BAGP,SAAyD;CACzD,MAAM,kBAA2C,CAAC;CAElD,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GACnC,gBAAgB,sBACd,QAAQ,IACV;CAGF,OAAOA,+BAAW,SAAS,eAAe;AAC5C;AAEA,SAAS,sBAGP,SAAyD;CACzD,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,KAAK,uBACzB,QAAQ,IAA4D,CAC5E;AACF;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,SAId,cAG4B;CAC5B,MAAM,oBACJ,OACA,YACG;EACH,MAAM,YAAY,SAChBC,8BAAU,MAAM,6BAA6B,OAAO,CAAC,CACvD;CACF;CAEA,MAAM,aAAaC,iCAAc;CAEjC,MAAM,gBAAgBF,+BAAW,cAAc,EAC7C,UAAU;EACR,uBAAuB;EACvB,kBAAU,aAAa,QAAQ,KAAK,CAAC;CACvC,EACF,CAAC;CAeD,MAAM,qDAbkBA,+BACtB,6BAA6B,aAAa,GAC1C,EAEE,eACE,gBACA,eACG;EACH,OAAOC,8BAAU,gBAAgB,UAAU;CAC7C,EACF,CAG6C,CAAC;CAChD,MAAM,QAAQ;CAEd,6BAAoB,GAClB,8BAAqB;;2CAAW,kGAAU;EAAC;CAG7C,qBACQ,sBAAsB,aAAa,SACnC;EACJ,iBAAiB,WAAW,aAAa;CAC3C,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,qBACQ;EACJ,MAAM,iCAAwB,aAAa,KAAK;EAGhD,MAAM,iCAAwB,aAAa,KAAK;EAIhD,IAAI,CAAC,iBACH,OAAO,CAAC;EAGV,MAAM,mBAAmC,CAAC;EAE1C,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,YAAY,GAAG;GACjD,IAAI,EAAE,OAAO,uFAAoB,gBAAkB,UAAS,QAC1D;GAKF,iBAAiB,KAAK,gBAAgB,IAAI;EAC5C;EAEA,OAAO;CACT,IACC,qBAAqB;EACpB,IAAI,iBAAiB,SAAS,GAC5B,iBAAiB,WAAW,aAAa;CAE7C,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,MAAM,aAAa,UAEb;EACJ,OAAO,MAAM,SAAS,MAAM,KAAyC;CACvE;CAEA,OAAO;AACT"}

package/dist/useTable.d.cts

@@ -3,13 +3,7 @@ import { MaybeRef, VNode } from "vue";
 
 //#region src/useTable.d.ts
 type TableOptionsWithReactiveData<TFeatures extends TableFeatures, TData extends RowData> = { [K in keyof TableOptions<TFeatures, TData>]: K extends 'data' ? MaybeRef<ReadonlyArray<TData>> : MaybeRef<TableOptions<TFeatures, TData>[K]> };
-type VueTable<TFeatures extends TableFeatures, TData extends RowData> = Omit<Table<TFeatures, TData>, 'store'> & {
-  /**
-   * @deprecated Prefer `table.atoms.<slice>.get()` for slice snapshots, or
-   * `table.Subscribe` for explicit subscriptions. `table.store.state` is a
-   * current-value snapshot and is easy to misuse in render code.
-   */
-  readonly store: Table<TFeatures, TData>['store'];
+type VueTable<TFeatures extends TableFeatures, TData extends RowData> = Table<TFeatures, TData> & {
   /** Creates a reactive render boundary. The child function reads the table
    * atoms it needs, so Vue only tracks those atom reads.
    */

package/dist/useTable.d.ts

@@ -3,13 +3,7 @@ import { RowData, Table, TableFeatures, TableOptions } from "@tanstack/table-cor
 
 //#region src/useTable.d.ts
 type TableOptionsWithReactiveData<TFeatures extends TableFeatures, TData extends RowData> = { [K in keyof TableOptions<TFeatures, TData>]: K extends 'data' ? MaybeRef<ReadonlyArray<TData>> : MaybeRef<TableOptions<TFeatures, TData>[K]> };
-type VueTable<TFeatures extends TableFeatures, TData extends RowData> = Omit<Table<TFeatures, TData>, 'store'> & {
-  /**
-   * @deprecated Prefer `table.atoms.<slice>.get()` for slice snapshots, or
-   * `table.Subscribe` for explicit subscriptions. `table.store.state` is a
-   * current-value snapshot and is easy to misuse in render code.
-   */
-  readonly store: Table<TFeatures, TData>['store'];
+type VueTable<TFeatures extends TableFeatures, TData extends RowData> = Table<TFeatures, TData> & {
   /** Creates a reactive render boundary. The child function reads the table
    * atoms it needs, so Vue only tracks those atom reads.
    */

package/dist/useTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTable.js","names":[],"sources":["../src/useTable.ts"],"sourcesContent":["import { getCurrentScope, onScopeDispose, unref, watch } from 'vue'\nimport { constructTable } from '@tanstack/table-core'\nimport { flatMerge, mergeProxy } from './merge-proxy'\nimport { vueReactivity } from './reactivity'\nimport type {\n  RowData,\n  Table,\n  TableFeatures,\n  TableOptions,\n  TableState,\n} from '@tanstack/table-core'\nimport type { MaybeRef, VNode } from 'vue'\n\nexport type TableOptionsWithReactiveData<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = {\n  [K in keyof TableOptions<TFeatures, TData>]: K extends 'data'\n    ? MaybeRef<ReadonlyArray<TData>>\n    : MaybeRef<TableOptions<TFeatures, TData>[K]>\n}\n\nfunction getOptionsWithReactiveValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(options: TableOptionsWithReactiveData<TFeatures, TData>) {\n  const resolvedOptions: Record<string, unknown> = {}\n\n  for (const key of Object.keys(options)) {\n    resolvedOptions[key] = unref(\n      options[key as keyof TableOptionsWithReactiveData<TFeatures, TData>],\n    )\n  }\n\n  return mergeProxy(options, resolvedOptions)\n}\n\nfunction getReactiveOptionDeps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(options: TableOptionsWithReactiveData<TFeatures, TData>) {\n  return Object.keys(options).map((key) =>\n    unref(options[key as keyof TableOptionsWithReactiveData<TFeatures, TData>]),\n  )\n}\n\nexport type VueTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = Omit<Table<TFeatures, TData>, 'store'> & {\n  /**\n   * @deprecated Prefer `table.atoms.<slice>.get()` for slice snapshots, or\n   * `table.Subscribe` for explicit subscriptions. `table.store.state` is a\n   * current-value snapshot and is easy to misuse in render code.\n   */\n  readonly store: Table<TFeatures, TData>['store']\n  /** Creates a reactive render boundary. The child function reads the table\n   * atoms it needs, so Vue only tracks those atom reads.\n   */\n  Subscribe: (props: {\n    children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>\n  }) => VNode | Array<VNode>\n}\n\n/**\n * Creates a Vue table instance backed by Vue-aware TanStack Store atoms.\n *\n * Table options may contain Vue refs or computed values. The adapter unwraps\n * those reactive inputs, watches them with synchronous flushing, and keeps the\n * table options in sync. Use `table.Subscribe` or native Vue computed values\n * around `table.atoms.<slice>.get()` for selected reactive reads.\n *\n * @example\n * ```ts\n * const table = useTable(\n *   {\n *     features,\n *     columns,\n *     data,\n *   },\n * )\n * ```\n */\nexport function useTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  tableOptions:\n    | TableOptions<TFeatures, TData>\n    | TableOptionsWithReactiveData<TFeatures, TData>,\n): VueTable<TFeatures, TData> {\n  const syncTableOptions = (\n    table: Table<TFeatures, TData>,\n    options: TableOptionsWithReactiveData<TFeatures, TData>,\n  ) => {\n    table.setOptions((prev) =>\n      flatMerge(prev, getOptionsWithReactiveValues(options)),\n    )\n  }\n\n  const reactivity = vueReactivity()\n\n  const mergedOptions = mergeProxy(tableOptions, {\n    features: {\n      coreReactivityFeature: reactivity,\n      ...(unref(tableOptions.features) ?? {}),\n    },\n  }) as TableOptionsWithReactiveData<TFeatures, TData>\n\n  const resolvedOptions = mergeProxy(\n    getOptionsWithReactiveValues(mergedOptions),\n    {\n      // Remove state and onStateChange - store handles it internally\n      mergeOptions: (\n        defaultOptions: TableOptions<TFeatures, TData>,\n        newOptions: Partial<TableOptions<TFeatures, TData>>,\n      ) => {\n        return flatMerge(defaultOptions, newOptions)\n      },\n    },\n  ) as TableOptions<TFeatures, TData>\n\n  const coreTable = constructTable(resolvedOptions)\n  const table = coreTable as unknown as VueTable<TFeatures, TData>\n\n  if (getCurrentScope()) {\n    onScopeDispose(() => reactivity.unmount?.())\n  }\n\n  watch(\n    () => getReactiveOptionDeps(mergedOptions),\n    () => {\n      syncTableOptions(coreTable, mergedOptions)\n    },\n    { immediate: true },\n  )\n\n  watch(\n    () => {\n      const controlledState = unref(tableOptions.state) as\n        | Record<string, unknown>\n        | undefined\n      const controlledAtoms = unref(tableOptions.atoms) as\n        | Record<string, unknown>\n        | undefined\n\n      if (!controlledState) {\n        return []\n      }\n\n      const controlledValues: Array<unknown> = []\n\n      for (const key of Object.keys(table.initialState)) {\n        if (!(key in controlledState) || controlledAtoms?.[key] !== undefined) {\n          continue\n        }\n\n        // Reading only controlled state slices here lets Vue subscribe to\n        // getters/computed values that are passed through `options.state`.\n        controlledValues.push(controlledState[key])\n      }\n\n      return controlledValues\n    },\n    (controlledValues) => {\n      if (controlledValues.length > 0) {\n        syncTableOptions(coreTable, mergedOptions)\n      }\n    },\n    { immediate: true },\n  )\n\n  table.Subscribe = (props: {\n    children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>\n  }) => {\n    return props.children(table.atoms)\n  }\n\n  return table\n}\n"],"mappings":";;;;;;AAsBA,SAAS,6BAGP,SAAyD;CACzD,MAAM,kBAA2C,CAAC;CAElD,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GACnC,gBAAgB,OAAO,MACrB,QAAQ,IACV;CAGF,OAAO,WAAW,SAAS,eAAe;AAC5C;AAEA,SAAS,sBAGP,SAAyD;CACzD,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,KAAK,QAC/B,MAAM,QAAQ,IAA4D,CAC5E;AACF;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,SAId,cAG4B;CAC5B,MAAM,oBACJ,OACA,YACG;EACH,MAAM,YAAY,SAChB,UAAU,MAAM,6BAA6B,OAAO,CAAC,CACvD;CACF;CAEA,MAAM,aAAa,cAAc;CAEjC,MAAM,gBAAgB,WAAW,cAAc,EAC7C,UAAU;EACR,uBAAuB;EACvB,GAAI,MAAM,aAAa,QAAQ,KAAK,CAAC;CACvC,EACF,CAAC;CAeD,MAAM,YAAY,eAbM,WACtB,6BAA6B,aAAa,GAC1C,EAEE,eACE,gBACA,eACG;EACH,OAAO,UAAU,gBAAgB,UAAU;CAC7C,EACF,CAG6C,CAAC;CAChD,MAAM,QAAQ;CAEd,IAAI,gBAAgB,GAClB,qBAAqB;;2CAAW,kGAAU;EAAC;CAG7C,YACQ,sBAAsB,aAAa,SACnC;EACJ,iBAAiB,WAAW,aAAa;CAC3C,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,YACQ;EACJ,MAAM,kBAAkB,MAAM,aAAa,KAAK;EAGhD,MAAM,kBAAkB,MAAM,aAAa,KAAK;EAIhD,IAAI,CAAC,iBACH,OAAO,CAAC;EAGV,MAAM,mBAAmC,CAAC;EAE1C,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,YAAY,GAAG;GACjD,IAAI,EAAE,OAAO,uFAAoB,gBAAkB,UAAS,QAC1D;GAKF,iBAAiB,KAAK,gBAAgB,IAAI;EAC5C;EAEA,OAAO;CACT,IACC,qBAAqB;EACpB,IAAI,iBAAiB,SAAS,GAC5B,iBAAiB,WAAW,aAAa;CAE7C,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,MAAM,aAAa,UAEb;EACJ,OAAO,MAAM,SAAS,MAAM,KAAK;CACnC;CAEA,OAAO;AACT"}
+{"version":3,"file":"useTable.js","names":[],"sources":["../src/useTable.ts"],"sourcesContent":["import { getCurrentScope, onScopeDispose, unref, watch } from 'vue'\nimport { constructTable } from '@tanstack/table-core'\nimport { flatMerge, mergeProxy } from './merge-proxy'\nimport { vueReactivity } from './reactivity'\nimport type {\n  RowData,\n  Table,\n  TableFeatures,\n  TableOptions,\n} from '@tanstack/table-core'\nimport type { MaybeRef, VNode } from 'vue'\n\nexport type TableOptionsWithReactiveData<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = {\n  [K in keyof TableOptions<TFeatures, TData>]: K extends 'data'\n    ? MaybeRef<ReadonlyArray<TData>>\n    : MaybeRef<TableOptions<TFeatures, TData>[K]>\n}\n\nfunction getOptionsWithReactiveValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(options: TableOptionsWithReactiveData<TFeatures, TData>) {\n  const resolvedOptions: Record<string, unknown> = {}\n\n  for (const key of Object.keys(options)) {\n    resolvedOptions[key] = unref(\n      options[key as keyof TableOptionsWithReactiveData<TFeatures, TData>],\n    )\n  }\n\n  return mergeProxy(options, resolvedOptions)\n}\n\nfunction getReactiveOptionDeps<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(options: TableOptionsWithReactiveData<TFeatures, TData>) {\n  return Object.keys(options).map((key) =>\n    unref(options[key as keyof TableOptionsWithReactiveData<TFeatures, TData>]),\n  )\n}\n\nexport type VueTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = Table<TFeatures, TData> & {\n  /** Creates a reactive render boundary. The child function reads the table\n   * atoms it needs, so Vue only tracks those atom reads.\n   */\n  Subscribe: (props: {\n    children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>\n  }) => VNode | Array<VNode>\n}\n\n/**\n * Creates a Vue table instance backed by Vue-aware TanStack Store atoms.\n *\n * Table options may contain Vue refs or computed values. The adapter unwraps\n * those reactive inputs, watches them with synchronous flushing, and keeps the\n * table options in sync. Use `table.Subscribe` or native Vue computed values\n * around `table.atoms.<slice>.get()` for selected reactive reads.\n *\n * @example\n * ```ts\n * const table = useTable(\n *   {\n *     features,\n *     columns,\n *     data,\n *   },\n * )\n * ```\n */\nexport function useTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  tableOptions:\n    | TableOptions<TFeatures, TData>\n    | TableOptionsWithReactiveData<TFeatures, TData>,\n): VueTable<TFeatures, TData> {\n  const syncTableOptions = (\n    table: Table<TFeatures, TData>,\n    options: TableOptionsWithReactiveData<TFeatures, TData>,\n  ) => {\n    table.setOptions((prev) =>\n      flatMerge(prev, getOptionsWithReactiveValues(options)),\n    )\n  }\n\n  const reactivity = vueReactivity()\n\n  const mergedOptions = mergeProxy(tableOptions, {\n    features: {\n      coreReactivityFeature: reactivity,\n      ...(unref(tableOptions.features) ?? {}),\n    },\n  }) as TableOptionsWithReactiveData<TFeatures, TData>\n\n  const resolvedOptions = mergeProxy(\n    getOptionsWithReactiveValues(mergedOptions),\n    {\n      // Remove state and onStateChange - store handles it internally\n      mergeOptions: (\n        defaultOptions: TableOptions<TFeatures, TData>,\n        newOptions: Partial<TableOptions<TFeatures, TData>>,\n      ) => {\n        return flatMerge(defaultOptions, newOptions)\n      },\n    },\n  ) as TableOptions<TFeatures, TData>\n\n  const coreTable = constructTable(resolvedOptions)\n  const table = coreTable as unknown as VueTable<TFeatures, TData>\n\n  if (getCurrentScope()) {\n    onScopeDispose(() => reactivity.unmount?.())\n  }\n\n  watch(\n    () => getReactiveOptionDeps(mergedOptions),\n    () => {\n      syncTableOptions(coreTable, mergedOptions)\n    },\n    { immediate: true },\n  )\n\n  watch(\n    () => {\n      const controlledState = unref(tableOptions.state) as\n        | Record<string, unknown>\n        | undefined\n      const controlledAtoms = unref(tableOptions.atoms) as\n        | Record<string, unknown>\n        | undefined\n\n      if (!controlledState) {\n        return []\n      }\n\n      const controlledValues: Array<unknown> = []\n\n      for (const key of Object.keys(table.initialState)) {\n        if (!(key in controlledState) || controlledAtoms?.[key] !== undefined) {\n          continue\n        }\n\n        // Reading only controlled state slices here lets Vue subscribe to\n        // getters/computed values that are passed through `options.state`.\n        controlledValues.push(controlledState[key])\n      }\n\n      return controlledValues\n    },\n    (controlledValues) => {\n      if (controlledValues.length > 0) {\n        syncTableOptions(coreTable, mergedOptions)\n      }\n    },\n    { immediate: true },\n  )\n\n  table.Subscribe = (props: {\n    children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>\n  }) => {\n    return props.children(table.atoms as Table<TFeatures, TData>['atoms'])\n  }\n\n  return table\n}\n"],"mappings":";;;;;;AAqBA,SAAS,6BAGP,SAAyD;CACzD,MAAM,kBAA2C,CAAC;CAElD,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GACnC,gBAAgB,OAAO,MACrB,QAAQ,IACV;CAGF,OAAO,WAAW,SAAS,eAAe;AAC5C;AAEA,SAAS,sBAGP,SAAyD;CACzD,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,KAAK,QAC/B,MAAM,QAAQ,IAA4D,CAC5E;AACF;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,SAId,cAG4B;CAC5B,MAAM,oBACJ,OACA,YACG;EACH,MAAM,YAAY,SAChB,UAAU,MAAM,6BAA6B,OAAO,CAAC,CACvD;CACF;CAEA,MAAM,aAAa,cAAc;CAEjC,MAAM,gBAAgB,WAAW,cAAc,EAC7C,UAAU;EACR,uBAAuB;EACvB,GAAI,MAAM,aAAa,QAAQ,KAAK,CAAC;CACvC,EACF,CAAC;CAeD,MAAM,YAAY,eAbM,WACtB,6BAA6B,aAAa,GAC1C,EAEE,eACE,gBACA,eACG;EACH,OAAO,UAAU,gBAAgB,UAAU;CAC7C,EACF,CAG6C,CAAC;CAChD,MAAM,QAAQ;CAEd,IAAI,gBAAgB,GAClB,qBAAqB;;2CAAW,kGAAU;EAAC;CAG7C,YACQ,sBAAsB,aAAa,SACnC;EACJ,iBAAiB,WAAW,aAAa;CAC3C,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,YACQ;EACJ,MAAM,kBAAkB,MAAM,aAAa,KAAK;EAGhD,MAAM,kBAAkB,MAAM,aAAa,KAAK;EAIhD,IAAI,CAAC,iBACH,OAAO,CAAC;EAGV,MAAM,mBAAmC,CAAC;EAE1C,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,YAAY,GAAG;GACjD,IAAI,EAAE,OAAO,uFAAoB,gBAAkB,UAAS,QAC1D;GAKF,iBAAiB,KAAK,gBAAgB,IAAI;EAC5C;EAEA,OAAO;CACT,IACC,qBAAqB;EACpB,IAAI,iBAAiB,SAAS,GAC5B,iBAAiB,WAAW,aAAa;CAE7C,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,MAAM,aAAa,UAEb;EACJ,OAAO,MAAM,SAAS,MAAM,KAAyC;CACvE;CAEA,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/vue-table",
-  "version": "9.0.0-beta.21",
+  "version": "9.0.0-beta.23",
   "description": "Headless UI for building powerful tables & datagrids for Vue.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -51,7 +51,7 @@
   ],
   "dependencies": {
     "@tanstack/store": "^0.11.0",
-    "@tanstack/table-core": "9.0.0-beta.21"
+    "@tanstack/table-core": "9.0.0-beta.23"
   },
   "devDependencies": {
     "@vitejs/plugin-vue": "^6.0.7",

package/src/createTableHook.ts

@@ -226,6 +226,77 @@ export type AppVueTable<
     FlexRender: typeof AppFlexRender
   }
 
+export interface CreateTableHookResult<
+  TFeatures extends TableFeatures,
+  TTableComponents extends Record<string, ComponentType<any>>,
+  TCellComponents extends Record<string, ComponentType<any>>,
+  THeaderComponents extends Record<string, ComponentType<any>>,
+> {
+  /** The features object that was passed to `createTableHook`. */
+  appFeatures: TFeatures
+  /**
+   * A column helper pre-bound to `TFeatures` and the registered components, so
+   * the cell/header/footer render props expose the bound components.
+   */
+  createAppColumnHelper: <TData extends RowData>() => AppColumnHelper<
+    TFeatures,
+    TData,
+    TCellComponents,
+    THeaderComponents
+  >
+  /**
+   * Creates a table with the `App*` wrapper components and registered
+   * `tableComponents` attached. `TData` is inferred from the `data` option.
+   */
+  useAppTable: <TData extends RowData>(
+    tableOptions: Omit<
+      TableOptionsWithReactiveData<TFeatures, TData>,
+      'features'
+    >,
+  ) => AppVueTable<
+    TFeatures,
+    TData,
+    TableState<TFeatures>,
+    TTableComponents,
+    TCellComponents,
+    THeaderComponents
+  >
+  /**
+   * Reads the table provided by the nearest `<table.AppTable>`. This is the same
+   * extended instance `useAppTable` returns, so the `App*` components and your
+   * `tableComponents` are available on it.
+   */
+  useTableContext: <TData extends RowData = RowData>() => AppVueTable<
+    TFeatures,
+    TData,
+    TableState<TFeatures>,
+    TTableComponents,
+    TCellComponents,
+    THeaderComponents
+  >
+  /**
+   * Reads the cell provided by the nearest `<table.AppCell>`, extended with your
+   * `cellComponents` and a context-bound `FlexRender`.
+   */
+  useCellContext: <TValue extends CellData = CellData>() => Cell<
+    TFeatures,
+    any,
+    TValue
+  > &
+    TCellComponents & { FlexRender: Component }
+  /**
+   * Reads the header provided by the nearest `<table.AppHeader>` /
+   * `<table.AppFooter>`, extended with your `headerComponents` and a
+   * context-bound `FlexRender`.
+   */
+  useHeaderContext: <TValue extends CellData = CellData>() => Header<
+    TFeatures,
+    any,
+    TValue
+  > &
+    THeaderComponents & { FlexRender: Component }
+}
+
 export const AppFlexRender = defineComponent({
   name: 'TableFlexRender',
   props: {
@@ -302,7 +373,12 @@ export function createTableHook<
   TTableComponents,
   TCellComponents,
   THeaderComponents
->) {
+>): CreateTableHookResult<
+  TFeatures,
+  TTableComponents,
+  TCellComponents,
+  THeaderComponents
+> {
   const TableContext = Symbol('TableContext') as InjectionKey<
     VueTable<TFeatures, any>
   >
@@ -327,9 +403,13 @@ export function createTableHook<
     >
   }
 
-  function useTableContext<TData extends RowData = RowData>(): VueTable<
+  function useTableContext<TData extends RowData = RowData>(): AppVueTable<
     TFeatures,
-    TData
+    TData,
+    TableState<TFeatures>,
+    TTableComponents,
+    TCellComponents,
+    THeaderComponents
   > {
     const table = inject(TableContext)
 
@@ -340,14 +420,25 @@ export function createTableHook<
       )
     }
 
-    return table as VueTable<TFeatures, TData>
+    // The value provided by `<table.AppTable>` is the extended table (the App*
+    // wrapper components and `tableComponents` are Object.assign-ed onto the same
+    // instance `useAppTable` returns), so this asserts the runtime shape.
+    return table as unknown as AppVueTable<
+      TFeatures,
+      TData,
+      TableState<TFeatures>,
+      TTableComponents,
+      TCellComponents,
+      THeaderComponents
+    >
   }
 
   function useCellContext<TValue extends CellData = CellData>(): Cell<
     TFeatures,
     any,
     TValue
-  > {
+  > &
+    TCellComponents & { FlexRender: Component } {
     const cell = inject(CellContext)
 
     if (!cell) {
@@ -357,14 +448,18 @@ export function createTableHook<
       )
     }
 
-    return cell as Cell<TFeatures, any, TValue>
+    // `<table.AppCell>` Object.assign-es `cellComponents` and `FlexRender` onto
+    // the same cell instance it provides, so this asserts the runtime shape.
+    return cell as unknown as Cell<TFeatures, any, TValue> &
+      TCellComponents & { FlexRender: Component }
   }
 
   function useHeaderContext<TValue extends CellData = CellData>(): Header<
     TFeatures,
     any,
     TValue
-  > {
+  > &
+    THeaderComponents & { FlexRender: Component } {
     const header = inject(HeaderContext)
 
     if (!header) {
@@ -373,7 +468,10 @@ export function createTableHook<
       )
     }
 
-    return header as Header<TFeatures, any, TValue>
+    // `<table.AppHeader>` / `<table.AppFooter>` Object.assign `headerComponents`
+    // and `FlexRender` onto the same header instance they provide.
+    return header as unknown as Header<TFeatures, any, TValue> &
+      THeaderComponents & { FlexRender: Component }
   }
 
   const CellFlexRender = defineComponent({
@@ -523,6 +621,8 @@ export function createTableHook<
   }
 
   return {
+    // `TableOptionsWithReactiveData` widens `features` to allow a reactive ref,
+    // so this narrows it back to the resolved `TFeatures` for `appFeatures`.
     appFeatures: defaultTableOptions.features as TFeatures,
     createAppColumnHelper,
     useAppTable,

package/src/useTable.ts

@@ -7,7 +7,6 @@ import type {
   Table,
   TableFeatures,
   TableOptions,
-  TableState,
 } from '@tanstack/table-core'
 import type { MaybeRef, VNode } from 'vue'
 
@@ -47,13 +46,7 @@ function getReactiveOptionDeps<
 export type VueTable<
   TFeatures extends TableFeatures,
   TData extends RowData,
-> = Omit<Table<TFeatures, TData>, 'store'> & {
-  /**
-   * @deprecated Prefer `table.atoms.<slice>.get()` for slice snapshots, or
-   * `table.Subscribe` for explicit subscriptions. `table.store.state` is a
-   * current-value snapshot and is easy to misuse in render code.
-   */
-  readonly store: Table<TFeatures, TData>['store']
+> = Table<TFeatures, TData> & {
   /** Creates a reactive render boundary. The child function reads the table
    * atoms it needs, so Vue only tracks those atom reads.
    */
@@ -173,7 +166,7 @@ export function useTable<
   table.Subscribe = (props: {
     children: (atoms: Table<TFeatures, TData>['atoms']) => VNode | Array<VNode>
   }) => {
-    return props.children(table.atoms)
+    return props.children(table.atoms as Table<TFeatures, TData>['atoms'])
   }
 
   return table