@tanstack/table-core 9.0.0-alpha.42 → 9.0.0-alpha.46

package/src/core/columns/constructColumn.ts

@@ -27,6 +27,11 @@ function getColumnPrototype<
   return table._columnPrototype
 }
 
+/**
+ * Constructs a column instance from normalized table internals.
+ *
+ * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+ */
 export function constructColumn<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -60,10 +65,11 @@ export function constructColumn<
   } else if (accessorKey) {
     // Support deep accessor keys
     if (accessorKey.includes('.')) {
+      const keys = accessorKey.split('.')
       accessorFn = (originalRow: TData) => {
         let result = originalRow as Record<string, any> | undefined
 
-        for (const key of accessorKey.split('.')) {
+        for (const key of keys) {
           result = result?.[key]
           if (process.env.NODE_ENV === 'development' && result === undefined) {
             console.warn(

package/src/core/columns/coreColumnsFeature.ts

@@ -6,6 +6,7 @@ import {
   table_getAllFlatColumns,
   table_getAllFlatColumnsById,
   table_getAllLeafColumns,
+  table_getAllLeafColumnsById,
   table_getColumn,
   table_getDefaultColumnDef,
 } from './coreColumnsFeature.utils'
@@ -26,6 +27,11 @@ export interface CoreColumnsFeatureConstructors<
   // TableOptions: TableOptions_Columns<TFeatures, TData>
 }
 
+/**
+ * Creates the stock core columns feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 export function constructCoreColumnsFeature<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -76,6 +82,10 @@ export function constructCoreColumnsFeature<
             table.options.groupedColumnMode,
           ],
         },
+        table_getAllLeafColumnsById: {
+          fn: () => table_getAllLeafColumnsById(table),
+          memoDeps: () => [table.getAllLeafColumns()],
+        },
         table_getColumn: {
           fn: (columnId) => table_getColumn(table, columnId),
         },

package/src/core/columns/coreColumnsFeature.types.ts

@@ -96,6 +96,10 @@ export interface Table_Columns<
    * Returns all leaf-node columns in the table flattened to a single level. This does not include parent columns.
    */
   getAllLeafColumns: () => Array<Column<TFeatures, TData, unknown>>
+  /**
+   * Returns a map of all leaf-node columns by their ID. This does not include parent columns.
+   */
+  getAllLeafColumnsById: () => Record<string, Column<TFeatures, TData, unknown>>
   /**
    * Returns a single column by its ID.
    */

package/src/core/columns/coreColumnsFeature.utils.ts

@@ -11,6 +11,16 @@ import type {
 } from '../../types/ColumnDef'
 import type { Column } from '../../types/Column'
 
+/**
+ * Returns flat columns for a column.
+ *
+ * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ *
+ * @example
+ * ```ts
+ * const value = column_getFlatColumns(column)
+ * ```
+ */
 export function column_getFlatColumns<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -21,6 +31,16 @@ export function column_getFlatColumns<
   return [column, ...column.columns.flatMap((col) => col.getFlatColumns())]
 }
 
+/**
+ * Returns leaf columns for a column.
+ *
+ * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ *
+ * @example
+ * ```ts
+ * const value = column_getLeafColumns(column)
+ * ```
+ */
 export function column_getLeafColumns<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -43,6 +63,16 @@ export function column_getLeafColumns<
   return [column]
 }
 
+/**
+ * Returns default column def for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getDefaultColumnDef(table)
+ * ```
+ */
 export function table_getDefaultColumnDef<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -72,6 +102,16 @@ export function table_getDefaultColumnDef<
   } as Partial<ColumnDef<TFeatures, TData, unknown>>
 }
 
+/**
+ * Returns all columns for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getAllColumns(table)
+ * ```
+ */
 export function table_getAllColumns<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -103,6 +143,16 @@ export function table_getAllColumns<
   return recurseColumns(table.options.columns)
 }
 
+/**
+ * Returns all flat columns for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getAllFlatColumns(table)
+ * ```
+ */
 export function table_getAllFlatColumns<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -112,21 +162,39 @@ export function table_getAllFlatColumns<
   return table.getAllColumns().flatMap((column) => column.getFlatColumns())
 }
 
+/**
+ * Returns all flat columns by id for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getAllFlatColumnsById(table)
+ * ```
+ */
 export function table_getAllFlatColumnsById<
   TFeatures extends TableFeatures,
   TData extends RowData,
 >(
   table: Table_Internal<TFeatures, TData>,
 ): Record<string, Column<TFeatures, TData, unknown>> {
-  return table.getAllFlatColumns().reduce(
-    (acc, column) => {
-      acc[column.id] = column
-      return acc
-    },
-    {} as Record<string, Column<TFeatures, TData, unknown>>,
-  )
+  const result: Record<string, Column<TFeatures, TData, unknown>> = {}
+  for (const column of table.getAllFlatColumns()) {
+    result[column.id] = column
+  }
+  return result
 }
 
+/**
+ * Returns all leaf columns for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getAllLeafColumns(table)
+ * ```
+ */
 export function table_getAllLeafColumns<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -140,9 +208,42 @@ export function table_getAllLeafColumns<
     table,
     'getOrderColumns',
     table_getOrderColumnsFn,
-  )(leafColumns as any) as any
+  )(leafColumns)
+}
+
+/**
+ * Returns all leaf columns by id for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getAllLeafColumnsById(table)
+ * ```
+ */
+export function table_getAllLeafColumnsById<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+>(
+  table: Table_Internal<TFeatures, TData>,
+): Record<string, Column<TFeatures, TData, unknown>> {
+  const result: Record<string, Column<TFeatures, TData, unknown>> = {}
+  for (const column of table.getAllLeafColumns()) {
+    result[column.id] = column
+  }
+  return result
 }
 
+/**
+ * Returns column for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getColumn(table)
+ * ```
+ */
 export function table_getColumn<
   TFeatures extends TableFeatures,
   TData extends RowData,

package/src/core/coreFeatures.ts

@@ -16,6 +16,11 @@ export interface CoreFeatures {
   coreTablesFeature: typeof coreTablesFeature
 }
 
+/**
+ * The built-in core feature set required by every table.
+ *
+ * These features provide table, column, row, header, cell, and core row-model behavior before optional feature plugins are added.
+ */
 export const coreFeatures: CoreFeatures = {
   coreCellsFeature,
   coreColumnsFeature,

package/src/core/headers/buildHeaderGroups.ts

@@ -8,6 +8,11 @@ import type { Header } from '../../types/Header'
 import type { HeaderGroup } from '../../types/HeaderGroup'
 import type { Column } from '../../types/Column'
 
+/**
+ * Builds the nested header group structure for a table.
+ *
+ * The result accounts for visible leaf columns, pinned column groups, and placeholder headers needed to render multi-level headers.
+ */
 export function buildHeaderGroups<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -65,7 +70,8 @@ export function buildHeaderGroups<
     headersToGroup.forEach((headerToGroup) => {
       // What is the latest (last) parent column?
 
-      const latestPendingParentHeader = [...pendingParentHeaders].reverse()[0]
+      const latestPendingParentHeader =
+        pendingParentHeaders[pendingParentHeaders.length - 1]
 
       const isLeafHeader = headerToGroup.column.depth === headerGroup.depth
 

package/src/core/headers/constructHeader.ts

@@ -22,6 +22,11 @@ function getHeaderPrototype<
   return table._headerPrototype
 }
 
+/**
+ * Constructs a header instance from normalized table internals.
+ *
+ * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+ */
 export function constructHeader<
   TFeatures extends TableFeatures,
   TData extends RowData,

package/src/core/headers/coreHeadersFeature.ts

@@ -28,6 +28,11 @@ export interface CoreHeadersFeatureConstructors<
   // Table: Table_Headers<TFeatures, TData>
 }
 
+/**
+ * Creates the stock core headers feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 export function constructCoreHeadersFeature<
   TFeatures extends TableFeatures,
   TData extends RowData,

package/src/core/headers/coreHeadersFeature.utils.ts

@@ -4,7 +4,10 @@ import {
   table_getLeftHeaderGroups,
   table_getRightHeaderGroups,
 } from '../../features/column-pinning/columnPinningFeature.utils'
-import { table_getVisibleLeafColumns } from '../../features/column-visibility/columnVisibilityFeature.utils'
+import {
+  column_getIsVisible,
+  table_getVisibleLeafColumns,
+} from '../../features/column-visibility/columnVisibilityFeature.utils'
 import { callMemoOrStaticFn } from '../../utils'
 import { buildHeaderGroups } from './buildHeaderGroups'
 import type { Table_Internal } from '../../types/Table'
@@ -14,6 +17,16 @@ import type { TableFeatures } from '../../types/TableFeatures'
 import type { Header_Header } from './coreHeadersFeature.types'
 import type { Column } from '../../types/Column'
 
+/**
+ * Returns leaf headers for a header.
+ *
+ * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ *
+ * @example
+ * ```ts
+ * const value = header_getLeafHeaders(header)
+ * ```
+ */
 export function header_getLeafHeaders<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -33,6 +46,16 @@ export function header_getLeafHeaders<
   return leafHeaders
 }
 
+/**
+ * Returns context for a header.
+ *
+ * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ *
+ * @example
+ * ```ts
+ * const value = header_getContext(header)
+ * ```
+ */
 export function header_getContext<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -45,6 +68,16 @@ export function header_getContext<
   }
 }
 
+/**
+ * Returns header groups for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getHeaderGroups(table)
+ * ```
+ */
 export function table_getHeaderGroups<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -56,15 +89,30 @@ export function table_getHeaderGroups<
     table,
     'getVisibleLeafColumns',
     table_getVisibleLeafColumns,
-  ) as unknown as Array<Column<TFeatures, TData, unknown>>
+  ) as Array<Column<TFeatures, TData, unknown>>
+  const leafColumnsById = table.getAllLeafColumnsById()
 
-  const leftColumns = left
-    .map((columnId) => leafColumns.find((d) => d.id === columnId)!)
-    .filter(Boolean)
+  const leftColumns: typeof leafColumns = []
+  for (const columnId of left) {
+    const column = leafColumnsById[columnId]
+    if (
+      column &&
+      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)
+    ) {
+      leftColumns.push(column)
+    }
+  }
 
-  const rightColumns = right
-    .map((columnId) => leafColumns.find((d) => d.id === columnId)!)
-    .filter(Boolean)
+  const rightColumns: typeof leafColumns = []
+  for (const columnId of right) {
+    const column = leafColumnsById[columnId]
+    if (
+      column &&
+      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)
+    ) {
+      rightColumns.push(column)
+    }
+  }
 
   const centerColumns = leafColumns.filter(
     (column) => !left.includes(column.id) && !right.includes(column.id),
@@ -79,6 +127,16 @@ export function table_getHeaderGroups<
   return headerGroups
 }
 
+/**
+ * Returns footer groups for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getFooterGroups(table)
+ * ```
+ */
 export function table_getFooterGroups<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -87,6 +145,16 @@ export function table_getFooterGroups<
   return [...headerGroups].reverse()
 }
 
+/**
+ * Returns flat headers for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getFlatHeaders(table)
+ * ```
+ */
 export function table_getFlatHeaders<
   TFeatures extends TableFeatures,
   TData extends RowData,
@@ -99,6 +167,16 @@ export function table_getFlatHeaders<
     .flat()
 }
 
+/**
+ * Returns leaf headers for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getLeafHeaders(table)
+ * ```
+ */
 export function table_getLeafHeaders<
   TFeatures extends TableFeatures,
   TData extends RowData,

package/src/core/reactivity/coreReactivityFeature.types.ts

@@ -15,6 +15,7 @@ export interface TableAtomOptions<T> extends AtomOptions<T> {
  * scheduling primitives.
  */
 export interface TableReactivityBindings {
+  createOptionsStore: boolean
   /**
    * Creates a writable atom with an initial value.
    */

package/src/core/reactivity/coreReactivityFeature.utils.ts

@@ -2,16 +2,31 @@ import type { Atom, ReadonlyAtom, ReadonlyStore, Store } from '@tanstack/store'
 
 /**
  * Converts a writable atom to the store-compatible shape expected by core.
+ *
+ * @example
+ * ```ts
+ * const store = atomToStore(atom)
+ * ```
  */
 export function atomToStore<T>(atom: Atom<T>): Store<T>
 /**
  * Converts a readonly atom to a readonly store-compatible shape.
+ *
+ * @example
+ * ```ts
+ * const store = atomToStore(atom)
+ * ```
  */
 export function atomToStore<T>(atom: ReadonlyAtom<T>): ReadonlyStore<T>
 /**
  * Bridges atom instances to the `Store`/`ReadonlyStore` API by exposing
  * a `state` getter backed by `atom.get()`, and wiring `setState` for
  * writable atoms.
+ *
+ * @example
+ * ```ts
+ * const store = atomToStore(atom)
+ * ```
  */
 export function atomToStore<T>(
   atom: Atom<T> | ReadonlyAtom<T>,

package/src/core/row-models/coreRowModelsFeature.ts

@@ -24,6 +24,11 @@ export interface CoreRowModelsFeatureConstructors<
   // Table: Table_RowModels<TFeatures, TData>
 }
 
+/**
+ * Creates the stock core row models feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 export function constructCoreRowModelsFeature<
   TFeatures extends TableFeatures,
   TData extends RowData,

package/src/core/row-models/coreRowModelsFeature.types.ts

@@ -25,7 +25,8 @@ export interface CreateRowModel_Core<
   TData extends RowData,
 > extends CreateRowModel_Plugins {
   /**
-   * This required option is a factory for a function that computes and returns the core row model for the table.
+   * Optional factory for the core row model. When omitted, the built-in
+   * `createCoreRowModel()` factory is used.
    */
   coreRowModel?: (
     table: Table<TFeatures, TData>,