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

package/src/features/table-reactivity/tableReactivityFeature.ts

@@ -16,11 +16,11 @@ export function constructReactivityFeature<
 }): TableFeature<TableReactivityFeatureConstructors<TFeatures, TData>> {
   return {
     constructTableAPIs: (table) => {
-      table.store = bindStore(table.store, bindings.stateNotifier)
       table.optionsStore = bindStore(
         table.optionsStore,
         bindings.optionsNotifier,
       )
+      table.atoms = bindAtoms(table.atoms, bindings.stateNotifier)
     },
   }
 }
@@ -45,3 +45,48 @@ const bindStore = <T extends Store<any> | ReadonlyStore<any>>(
 
   return store
 }
+
+// Wraps an atoms/baseAtoms map so that `.get()` on any individual atom
+// calls the framework notifier first — matching how `bindStore` wraps
+// `store.state`. The proxy also transparently forwards missing slices
+// (atoms for features not registered on this table) as `undefined`.
+const bindAtoms = <T extends object>(atoms: T, notifier?: () => unknown): T => {
+  if (!notifier) return atoms
+  // Cache wrapped atoms so referential identity is stable per slice.
+  const wrappedCache = new Map<PropertyKey, any>()
+  return new Proxy(atoms, {
+    get(target, prop, receiver) {
+      const atom = Reflect.get(target, prop, receiver) as unknown
+      if (!atom || typeof prop !== 'string' || !isAtomLike(atom)) {
+        return atom
+      }
+      if (wrappedCache.has(prop)) return wrappedCache.get(prop)
+      const originalGet = atom.get.bind(atom)
+      const wrapped = new Proxy(atom, {
+        get(atomTarget, atomProp, atomReceiver) {
+          if (atomProp === 'get') {
+            return () => {
+              notifier()
+              return originalGet()
+            }
+          }
+          return Reflect.get(atomTarget, atomProp, atomReceiver)
+        },
+      })
+      wrappedCache.set(prop, wrapped)
+      return wrapped
+    },
+  })
+}
+
+interface AtomLike {
+  get: () => unknown
+}
+
+function isAtomLike(value: unknown): value is AtomLike {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    typeof (value as { get?: unknown }).get === 'function'
+  )
+}

package/src/index.ts

@@ -31,38 +31,32 @@ export * from './utils'
 export * from './core/cells/constructCell'
 export * from './core/cells/coreCellsFeature'
 export * from './core/cells/coreCellsFeature.types'
-export * from './core/cells/coreCellsFeature.utils'
 
 // Columns
 export * from './core/columns/constructColumn'
 export * from './core/columns/coreColumnsFeature'
 export * from './core/columns/coreColumnsFeature.types'
-export * from './core/columns/coreColumnsFeature.utils'
 
 // Headers
 export * from './core/headers/buildHeaderGroups'
 export * from './core/headers/constructHeader'
 export * from './core/headers/coreHeadersFeature'
 export * from './core/headers/coreHeadersFeature.types'
-export * from './core/headers/coreHeadersFeature.utils'
 
 // Rows
 export * from './core/rows/constructRow'
 export * from './core/rows/coreRowsFeature'
 export * from './core/rows/coreRowsFeature.types'
-export * from './core/rows/coreRowsFeature.utils'
 
 // Row Models
 export * from './core/row-models/coreRowModelsFeature'
 export * from './core/row-models/coreRowModelsFeature.types'
-export * from './core/row-models/coreRowModelsFeature.utils'
 export * from './core/row-models/createCoreRowModel'
 
 // Tables
 export * from './core/table/constructTable'
 export * from './core/table/coreTablesFeature'
 export * from './core/table/coreTablesFeature.types'
-export * from './core/table/coreTablesFeature.utils'
 
 /**
  * RowModelFns
@@ -84,7 +78,6 @@ export * from './features/table-reactivity/tableReactivityFeature'
 // columnFacetingFeature
 export * from './features/column-faceting/columnFacetingFeature'
 export * from './features/column-faceting/columnFacetingFeature.types'
-export * from './features/column-faceting/columnFacetingFeature.utils'
 export * from './features/column-faceting/createFacetedMinMaxValues'
 export * from './features/column-faceting/createFacetedRowModel'
 export * from './features/column-faceting/createFacetedUniqueValues'
@@ -92,71 +85,58 @@ export * from './features/column-faceting/createFacetedUniqueValues'
 // columnFilteringFeature
 export * from './features/column-filtering/columnFilteringFeature'
 export * from './features/column-filtering/columnFilteringFeature.types'
-export * from './features/column-filtering/columnFilteringFeature.utils'
 export * from './features/column-filtering/createFilteredRowModel'
 
 // columnGroupingFeature
 export * from './features/column-grouping/columnGroupingFeature'
 export * from './features/column-grouping/columnGroupingFeature.types'
-export * from './features/column-grouping/columnGroupingFeature.utils'
 export * from './features/column-grouping/createGroupedRowModel'
 
 // columnOrderingFeature
 export * from './features/column-ordering/columnOrderingFeature'
 export * from './features/column-ordering/columnOrderingFeature.types'
-export * from './features/column-ordering/columnOrderingFeature.utils'
 
 // columnPinningFeature
 export * from './features/column-pinning/columnPinningFeature'
 export * from './features/column-pinning/columnPinningFeature.types'
-export * from './features/column-pinning/columnPinningFeature.utils'
 
 // columnResizingFeature
 export * from './features/column-resizing/columnResizingFeature'
 export * from './features/column-resizing/columnResizingFeature.types'
-export * from './features/column-resizing/columnResizingFeature.utils'
 
 // columnSizingFeature
 export * from './features/column-sizing/columnSizingFeature'
 export * from './features/column-sizing/columnSizingFeature.types'
-export * from './features/column-sizing/columnSizingFeature.utils'
 
 // columnVisibilityFeature
 export * from './features/column-visibility/columnVisibilityFeature'
 export * from './features/column-visibility/columnVisibilityFeature.types'
-export * from './features/column-visibility/columnVisibilityFeature.utils'
 
 // globalFilteringFeature
 export * from './features/global-filtering/globalFilteringFeature'
 export * from './features/global-filtering/globalFilteringFeature.types'
-export * from './features/global-filtering/globalFilteringFeature.utils'
 
 // rowExpandingFeature
 export * from './features/row-expanding/rowExpandingFeature'
 export * from './features/row-expanding/rowExpandingFeature.types'
-export * from './features/row-expanding/rowExpandingFeature.utils'
 export * from './features/row-expanding/createExpandedRowModel'
 
 // rowPaginationFeature
 export * from './features/row-pagination/rowPaginationFeature'
 export * from './features/row-pagination/rowPaginationFeature.types'
-export * from './features/row-pagination/rowPaginationFeature.utils'
 export * from './features/row-pagination/createPaginatedRowModel'
 
 // rowPinningFeature
 export * from './features/row-pinning/rowPinningFeature'
 export * from './features/row-pinning/rowPinningFeature.types'
-export * from './features/row-pinning/rowPinningFeature.utils'
 
 // rowSelectionFeature
 export * from './features/row-selection/rowSelectionFeature'
 export * from './features/row-selection/rowSelectionFeature.types'
-export * from './features/row-selection/rowSelectionFeature.utils'
 
 // rowSortingFeature
 export * from './features/row-sorting/rowSortingFeature'
 export * from './features/row-sorting/rowSortingFeature.types'
-export * from './features/row-sorting/rowSortingFeature.utils'
 export * from './features/row-sorting/createSortedRowModel'
 
 // force

package/src/static-functions.ts

@@ -0,0 +1,31 @@
+/**
+ * Static utility functions sub-entry.
+ *
+ * Re-exports all standalone utility functions from each feature's `.utils.ts`
+ * module so consumers that want the functions (without constructing a table)
+ * can grab them from a single path.
+ */
+
+// Core
+export * from './core/cells/coreCellsFeature.utils'
+export * from './core/columns/coreColumnsFeature.utils'
+export * from './core/headers/coreHeadersFeature.utils'
+export * from './core/rows/coreRowsFeature.utils'
+export * from './core/row-models/coreRowModelsFeature.utils'
+export * from './core/table/coreTablesFeature.utils'
+
+// Features
+export * from './features/column-faceting/columnFacetingFeature.utils'
+export * from './features/column-filtering/columnFilteringFeature.utils'
+export * from './features/column-grouping/columnGroupingFeature.utils'
+export * from './features/column-ordering/columnOrderingFeature.utils'
+export * from './features/column-pinning/columnPinningFeature.utils'
+export * from './features/column-resizing/columnResizingFeature.utils'
+export * from './features/column-sizing/columnSizingFeature.utils'
+export * from './features/column-visibility/columnVisibilityFeature.utils'
+export * from './features/global-filtering/globalFilteringFeature.utils'
+export * from './features/row-expanding/rowExpandingFeature.utils'
+export * from './features/row-pagination/rowPaginationFeature.utils'
+export * from './features/row-pinning/rowPinningFeature.utils'
+export * from './features/row-selection/rowSelectionFeature.utils'
+export * from './features/row-sorting/rowSortingFeature.utils'

package/src/types/Table.ts

@@ -1,4 +1,4 @@
-import type { ReadonlyStore, Store } from '@tanstack/store'
+import type { ReadonlyStore } from '@tanstack/store'
 import type { Table_ColumnFaceting } from '../features/column-faceting/columnFacetingFeature.types'
 import type { Table_ColumnResizing } from '../features/column-resizing/columnResizingFeature.types'
 import type { Table_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
@@ -22,7 +22,12 @@ import type { ExtractFeatureTypes, TableFeatures } from './TableFeatures'
 import type { Table_Columns } from '../core/columns/coreColumnsFeature.types'
 import type { Table_Headers } from '../core/headers/coreHeadersFeature.types'
 import type { Table_Rows } from '../core/rows/coreRowsFeature.types'
-import type { Table_Table } from '../core/table/coreTablesFeature.types'
+import type {
+  Atoms_All,
+  BaseAtoms_All,
+  ExternalAtoms_All,
+  Table_Table,
+} from '../core/table/coreTablesFeature.types'
 import type { TableOptions_All } from './TableOptions'
 
 /**
@@ -118,8 +123,10 @@ export type Table_Internal<
     _rowModels?: CreateRowModels_All<TFeatures, TData>
     state?: TableState_All
     initialState?: TableState_All
+    atoms?: ExternalAtoms_All
   }
   initialState: TableState_All
-  baseStore: Store<TableState_All>
+  baseAtoms: BaseAtoms_All
+  atoms: Atoms_All
   store: ReadonlyStore<TableState_All>
 }

package/src/utils.ts

@@ -16,14 +16,9 @@ export function makeStateUpdater<
   K extends (string & {}) | keyof TableState_All | keyof TableState<TFeatures>,
 >(key: K, instance: Table<TFeatures, any>) {
   return (updater: Updater<TableState<any>[K & keyof TableState<any>]>) => {
-    instance.baseStore.setState(
-      <TTableState extends TableState_All>(old: TTableState) => {
-        return {
-          ...old,
-          [key]: functionalUpdate(updater, (old as any)[key]),
-        }
-      },
-    )
+    const externalAtom = (instance.options as any).atoms?.[key]
+    const targetAtom = externalAtom ?? (instance.baseAtoms as any)[key]
+    targetAtom.set((old: any) => functionalUpdate(updater, old))
   }
 }