@tanstack/table-core 9.0.0-alpha.47 → 9.0.0-alpha.49

package/README.md

@@ -49,6 +49,16 @@ A headless table library for building powerful datagrids with full control over
 
 ### <a href="https://tanstack.com/table">Read the Docs →</a>
 
+## Using an AI Coding Agent?
+
+TanStack Table ships [TanStack Intent](https://github.com/TanStack/intent) skills inside each adapter package. After installing the library, run:
+
+```sh
+npx @tanstack/intent@latest install
+```
+
+to add skill-loading guidance for your agent (Claude Code, Cursor, Copilot, etc.). The same CLI also exposes `intent list` to browse available skills and `intent load <skill>` to print one for inspection. Skills version with the library — your agent gets guidance that matches the version of `@tanstack/<framework>-table` you installed. Only available for v9 and above.
+
 ## Get Involved
 
 - We welcome issues and pull requests!

package/dist/core/cells/coreCellsFeature.utils.cjs

@@ -1,9 +1,10 @@
 
 //#region src/core/cells/coreCellsFeature.utils.ts
 /**
-* Returns value for a cell.
+* Reads this cell's accessor value from its owning row and column.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* This is the standalone implementation behind `cell.getValue()`, useful when
+* importing static APIs instead of calling methods from the cell prototype.
 *
 * @example
 * ```ts
@@ -14,26 +15,28 @@ function cell_getValue(cell) {
 	return cell.row.getValue(cell.column.id);
 }
 /**
-* Returns value for a cell.
+* Reads the value that should be rendered for this cell.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* Nullish accessor values are replaced with `table.options.renderFallbackValue`,
+* matching the behavior of `cell.renderValue()`.
 *
 * @example
 * ```ts
-* const value = cell_renderValue(cell)
+* const rendered = cell_renderValue(cell)
 * ```
 */
 function cell_renderValue(cell) {
 	return cell.getValue() ?? cell.table.options.renderFallbackValue;
 }
 /**
-* Returns context for a cell.
+* Builds the render context passed to a column's `cell` template.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* The returned object includes stable references to the table, row, column, and
+* cell, plus bound `getValue` and `renderValue` helpers for render functions.
 *
 * @example
 * ```ts
-* const value = cell_getContext(cell)
+* const context = cell_getContext(cell)
 * ```
 */
 function cell_getContext(cell) {

package/dist/core/cells/coreCellsFeature.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"coreCellsFeature.utils.cjs","names":[],"sources":["../../../src/core/cells/coreCellsFeature.utils.ts"],"sourcesContent":["import type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Cell } from '../../types/Cell'\n\n/**\n * Returns value for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_getValue(cell)\n * ```\n */\nexport function cell_getValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>): TValue {\n  return cell.row.getValue(cell.column.id)\n}\n\n/**\n * Returns value for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_renderValue(cell)\n * ```\n */\nexport function cell_renderValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return cell.getValue() ?? cell.table.options.renderFallbackValue\n}\n\n/**\n * Returns context for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_getContext(cell)\n * ```\n */\nexport function cell_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return {\n    table: cell.table,\n    column: cell.column,\n    row: cell.row,\n    cell: cell,\n    // Wrap in arrow functions to preserve `this` binding (methods are on prototype)\n    getValue: () => cell.getValue(),\n    renderValue: () => cell.renderValue(),\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,cAId,MAA8C;CAC9C,OAAO,KAAK,IAAI,SAAS,KAAK,OAAO,GAAG;;;;;;;;;;;;AAa1C,SAAgB,iBAId,MAAsC;CACtC,OAAO,KAAK,UAAU,IAAI,KAAK,MAAM,QAAQ;;;;;;;;;;;;AAa/C,SAAgB,gBAId,MAAsC;CACtC,OAAO;EACL,OAAO,KAAK;EACZ,QAAQ,KAAK;EACb,KAAK,KAAK;EACJ;EAEN,gBAAgB,KAAK,UAAU;EAC/B,mBAAmB,KAAK,aAAa;EACtC"}
+{"version":3,"file":"coreCellsFeature.utils.cjs","names":[],"sources":["../../../src/core/cells/coreCellsFeature.utils.ts"],"sourcesContent":["import type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Cell } from '../../types/Cell'\n\n/**\n * Reads this cell's accessor value from its owning row and column.\n *\n * This is the standalone implementation behind `cell.getValue()`, useful when\n * importing static APIs instead of calling methods from the cell prototype.\n *\n * @example\n * ```ts\n * const value = cell_getValue(cell)\n * ```\n */\nexport function cell_getValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>): TValue {\n  return cell.row.getValue(cell.column.id)\n}\n\n/**\n * Reads the value that should be rendered for this cell.\n *\n * Nullish accessor values are replaced with `table.options.renderFallbackValue`,\n * matching the behavior of `cell.renderValue()`.\n *\n * @example\n * ```ts\n * const rendered = cell_renderValue(cell)\n * ```\n */\nexport function cell_renderValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return cell.getValue() ?? cell.table.options.renderFallbackValue\n}\n\n/**\n * Builds the render context passed to a column's `cell` template.\n *\n * The returned object includes stable references to the table, row, column, and\n * cell, plus bound `getValue` and `renderValue` helpers for render functions.\n *\n * @example\n * ```ts\n * const context = cell_getContext(cell)\n * ```\n */\nexport function cell_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return {\n    table: cell.table,\n    column: cell.column,\n    row: cell.row,\n    cell: cell,\n    // Wrap in arrow functions to preserve `this` binding (methods are on prototype)\n    getValue: () => cell.getValue(),\n    renderValue: () => cell.renderValue(),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAgB,cAId,MAA8C;CAC9C,OAAO,KAAK,IAAI,SAAS,KAAK,OAAO,GAAG;;;;;;;;;;;;;AAc1C,SAAgB,iBAId,MAAsC;CACtC,OAAO,KAAK,UAAU,IAAI,KAAK,MAAM,QAAQ;;;;;;;;;;;;;AAc/C,SAAgB,gBAId,MAAsC;CACtC,OAAO;EACL,OAAO,KAAK;EACZ,QAAQ,KAAK;EACb,KAAK,KAAK;EACJ;EAEN,gBAAgB,KAAK,UAAU;EAC/B,mBAAmB,KAAK,aAAa;EACtC"}

package/dist/core/cells/coreCellsFeature.utils.d.cts

@@ -6,9 +6,10 @@ import { Table_Internal } from "../../types/Table.cjs";
 import { Cell } from "../../types/Cell.cjs";
 //#region src/core/cells/coreCellsFeature.utils.d.ts
 /**
- * Returns value for a cell.
+ * Reads this cell's accessor value from its owning row and column.
  *
- * This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+ * This is the standalone implementation behind `cell.getValue()`, useful when
+ * importing static APIs instead of calling methods from the cell prototype.
  *
  * @example
  * ```ts
@@ -17,24 +18,26 @@ import { Cell } from "../../types/Cell.cjs";
  */
 declare function cell_getValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(cell: Cell<TFeatures, TData, TValue>): TValue;
 /**
- * Returns value for a cell.
+ * Reads the value that should be rendered for this cell.
  *
- * This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+ * Nullish accessor values are replaced with `table.options.renderFallbackValue`,
+ * matching the behavior of `cell.renderValue()`.
  *
  * @example
  * ```ts
- * const value = cell_renderValue(cell)
+ * const rendered = cell_renderValue(cell)
  * ```
  */
 declare function cell_renderValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(cell: Cell<TFeatures, TData, TValue>): any;
 /**
- * Returns context for a cell.
+ * Builds the render context passed to a column's `cell` template.
  *
- * This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+ * The returned object includes stable references to the table, row, column, and
+ * cell, plus bound `getValue` and `renderValue` helpers for render functions.
  *
  * @example
  * ```ts
- * const value = cell_getContext(cell)
+ * const context = cell_getContext(cell)
  * ```
  */
 declare function cell_getContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(cell: Cell<TFeatures, TData, TValue>): {

package/dist/core/cells/coreCellsFeature.utils.d.ts

@@ -6,9 +6,10 @@ import { Table_Internal } from "../../types/Table.js";
 import { Cell } from "../../types/Cell.js";
 //#region src/core/cells/coreCellsFeature.utils.d.ts
 /**
- * Returns value for a cell.
+ * Reads this cell's accessor value from its owning row and column.
  *
- * This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+ * This is the standalone implementation behind `cell.getValue()`, useful when
+ * importing static APIs instead of calling methods from the cell prototype.
  *
  * @example
  * ```ts
@@ -17,24 +18,26 @@ import { Cell } from "../../types/Cell.js";
  */
 declare function cell_getValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(cell: Cell<TFeatures, TData, TValue>): TValue;
 /**
- * Returns value for a cell.
+ * Reads the value that should be rendered for this cell.
  *
- * This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+ * Nullish accessor values are replaced with `table.options.renderFallbackValue`,
+ * matching the behavior of `cell.renderValue()`.
  *
  * @example
  * ```ts
- * const value = cell_renderValue(cell)
+ * const rendered = cell_renderValue(cell)
  * ```
  */
 declare function cell_renderValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(cell: Cell<TFeatures, TData, TValue>): any;
 /**
- * Returns context for a cell.
+ * Builds the render context passed to a column's `cell` template.
  *
- * This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+ * The returned object includes stable references to the table, row, column, and
+ * cell, plus bound `getValue` and `renderValue` helpers for render functions.
  *
  * @example
  * ```ts
- * const value = cell_getContext(cell)
+ * const context = cell_getContext(cell)
  * ```
  */
 declare function cell_getContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(cell: Cell<TFeatures, TData, TValue>): {

package/dist/core/cells/coreCellsFeature.utils.js

@@ -1,8 +1,9 @@
 //#region src/core/cells/coreCellsFeature.utils.ts
 /**
-* Returns value for a cell.
+* Reads this cell's accessor value from its owning row and column.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* This is the standalone implementation behind `cell.getValue()`, useful when
+* importing static APIs instead of calling methods from the cell prototype.
 *
 * @example
 * ```ts
@@ -13,26 +14,28 @@ function cell_getValue(cell) {
 	return cell.row.getValue(cell.column.id);
 }
 /**
-* Returns value for a cell.
+* Reads the value that should be rendered for this cell.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* Nullish accessor values are replaced with `table.options.renderFallbackValue`,
+* matching the behavior of `cell.renderValue()`.
 *
 * @example
 * ```ts
-* const value = cell_renderValue(cell)
+* const rendered = cell_renderValue(cell)
 * ```
 */
 function cell_renderValue(cell) {
 	return cell.getValue() ?? cell.table.options.renderFallbackValue;
 }
 /**
-* Returns context for a cell.
+* Builds the render context passed to a column's `cell` template.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* The returned object includes stable references to the table, row, column, and
+* cell, plus bound `getValue` and `renderValue` helpers for render functions.
 *
 * @example
 * ```ts
-* const value = cell_getContext(cell)
+* const context = cell_getContext(cell)
 * ```
 */
 function cell_getContext(cell) {

package/dist/core/cells/coreCellsFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreCellsFeature.utils.js","names":[],"sources":["../../../src/core/cells/coreCellsFeature.utils.ts"],"sourcesContent":["import type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Cell } from '../../types/Cell'\n\n/**\n * Returns value for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_getValue(cell)\n * ```\n */\nexport function cell_getValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>): TValue {\n  return cell.row.getValue(cell.column.id)\n}\n\n/**\n * Returns value for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_renderValue(cell)\n * ```\n */\nexport function cell_renderValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return cell.getValue() ?? cell.table.options.renderFallbackValue\n}\n\n/**\n * Returns context for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_getContext(cell)\n * ```\n */\nexport function cell_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return {\n    table: cell.table,\n    column: cell.column,\n    row: cell.row,\n    cell: cell,\n    // Wrap in arrow functions to preserve `this` binding (methods are on prototype)\n    getValue: () => cell.getValue(),\n    renderValue: () => cell.renderValue(),\n  }\n}\n"],"mappings":";;;;;;;;;;;AAcA,SAAgB,cAId,MAA8C;CAC9C,OAAO,KAAK,IAAI,SAAS,KAAK,OAAO,GAAG;;;;;;;;;;;;AAa1C,SAAgB,iBAId,MAAsC;CACtC,OAAO,KAAK,UAAU,IAAI,KAAK,MAAM,QAAQ;;;;;;;;;;;;AAa/C,SAAgB,gBAId,MAAsC;CACtC,OAAO;EACL,OAAO,KAAK;EACZ,QAAQ,KAAK;EACb,KAAK,KAAK;EACJ;EAEN,gBAAgB,KAAK,UAAU;EAC/B,mBAAmB,KAAK,aAAa;EACtC"}
+{"version":3,"file":"coreCellsFeature.utils.js","names":[],"sources":["../../../src/core/cells/coreCellsFeature.utils.ts"],"sourcesContent":["import type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Cell } from '../../types/Cell'\n\n/**\n * Reads this cell's accessor value from its owning row and column.\n *\n * This is the standalone implementation behind `cell.getValue()`, useful when\n * importing static APIs instead of calling methods from the cell prototype.\n *\n * @example\n * ```ts\n * const value = cell_getValue(cell)\n * ```\n */\nexport function cell_getValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>): TValue {\n  return cell.row.getValue(cell.column.id)\n}\n\n/**\n * Reads the value that should be rendered for this cell.\n *\n * Nullish accessor values are replaced with `table.options.renderFallbackValue`,\n * matching the behavior of `cell.renderValue()`.\n *\n * @example\n * ```ts\n * const rendered = cell_renderValue(cell)\n * ```\n */\nexport function cell_renderValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return cell.getValue() ?? cell.table.options.renderFallbackValue\n}\n\n/**\n * Builds the render context passed to a column's `cell` template.\n *\n * The returned object includes stable references to the table, row, column, and\n * cell, plus bound `getValue` and `renderValue` helpers for render functions.\n *\n * @example\n * ```ts\n * const context = cell_getContext(cell)\n * ```\n */\nexport function cell_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return {\n    table: cell.table,\n    column: cell.column,\n    row: cell.row,\n    cell: cell,\n    // Wrap in arrow functions to preserve `this` binding (methods are on prototype)\n    getValue: () => cell.getValue(),\n    renderValue: () => cell.renderValue(),\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAeA,SAAgB,cAId,MAA8C;CAC9C,OAAO,KAAK,IAAI,SAAS,KAAK,OAAO,GAAG;;;;;;;;;;;;;AAc1C,SAAgB,iBAId,MAAsC;CACtC,OAAO,KAAK,UAAU,IAAI,KAAK,MAAM,QAAQ;;;;;;;;;;;;;AAc/C,SAAgB,gBAId,MAAsC;CACtC,OAAO;EACL,OAAO,KAAK;EACZ,QAAQ,KAAK;EACb,KAAK,KAAK;EACJ;EAEN,gBAAgB,KAAK,UAAU;EAC/B,mBAAmB,KAAK,aAAa;EACtC"}

package/dist/core/columns/coreColumnsFeature.types.d.cts

@@ -40,11 +40,12 @@ interface Column_CoreProperties<TFeatures extends TableFeatures, TData extends R
 }
 interface Column_Column<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> extends Column_CoreProperties<TFeatures, TData, TValue> {
   /**
-   * Returns the flattened array of this column and all child/grand-child columns for this column.
+   * Flattens this column and every descendant column into a single array.
    */
   getFlatColumns: () => Array<Column<TFeatures, TData, TValue>>;
   /**
-   * Returns an array of all leaf-node columns for this column. If a column has no children, it is considered the only leaf-node column.
+   * Collects the terminal leaf columns below this column, or the column itself
+   * when it has no children.
    */
   getLeafColumns: () => Array<Column<TFeatures, TData, TValue>>;
 }
@@ -64,19 +65,19 @@ interface Table_Columns<TFeatures extends TableFeatures, TData extends RowData>
    */
   getAllFlatColumnsById: () => Record<string, Column<TFeatures, TData, unknown>>;
   /**
-   * Returns the default column options to use for all column defs supplied to the table.
+   * Resolves built-in, feature-level, and user-defined default column options.
    */
   getDefaultColumnDef: () => Partial<ColumnDef<TFeatures, TData, unknown>>;
   /**
-   * Returns all columns in the table in their normalized and nested hierarchy.
+   * Normalizes `options.columns` into the table's nested column hierarchy.
    */
   getAllColumns: () => Array<Column<TFeatures, TData, unknown>>;
   /**
-   * Returns all columns in the table flattened to a single level.
+   * Flattens the nested column hierarchy, including parent/group columns.
    */
   getAllFlatColumns: () => Array<Column<TFeatures, TData, unknown>>;
   /**
-   * Returns all leaf-node columns in the table flattened to a single level. This does not include parent columns.
+   * Collects all terminal leaf columns, excluding parent/group columns.
    */
   getAllLeafColumns: () => Array<Column<TFeatures, TData, unknown>>;
   /**

package/dist/core/columns/coreColumnsFeature.types.d.ts

@@ -40,11 +40,12 @@ interface Column_CoreProperties<TFeatures extends TableFeatures, TData extends R
 }
 interface Column_Column<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> extends Column_CoreProperties<TFeatures, TData, TValue> {
   /**
-   * Returns the flattened array of this column and all child/grand-child columns for this column.
+   * Flattens this column and every descendant column into a single array.
    */
   getFlatColumns: () => Array<Column<TFeatures, TData, TValue>>;
   /**
-   * Returns an array of all leaf-node columns for this column. If a column has no children, it is considered the only leaf-node column.
+   * Collects the terminal leaf columns below this column, or the column itself
+   * when it has no children.
    */
   getLeafColumns: () => Array<Column<TFeatures, TData, TValue>>;
 }
@@ -64,19 +65,19 @@ interface Table_Columns<TFeatures extends TableFeatures, TData extends RowData>
    */
   getAllFlatColumnsById: () => Record<string, Column<TFeatures, TData, unknown>>;
   /**
-   * Returns the default column options to use for all column defs supplied to the table.
+   * Resolves built-in, feature-level, and user-defined default column options.
    */
   getDefaultColumnDef: () => Partial<ColumnDef<TFeatures, TData, unknown>>;
   /**
-   * Returns all columns in the table in their normalized and nested hierarchy.
+   * Normalizes `options.columns` into the table's nested column hierarchy.
    */
   getAllColumns: () => Array<Column<TFeatures, TData, unknown>>;
   /**
-   * Returns all columns in the table flattened to a single level.
+   * Flattens the nested column hierarchy, including parent/group columns.
    */
   getAllFlatColumns: () => Array<Column<TFeatures, TData, unknown>>;
   /**
-   * Returns all leaf-node columns in the table flattened to a single level. This does not include parent columns.
+   * Collects all terminal leaf columns, excluding parent/group columns.
    */
   getAllLeafColumns: () => Array<Column<TFeatures, TData, unknown>>;
   /**

package/dist/core/columns/coreColumnsFeature.utils.cjs

@@ -4,26 +4,28 @@ const require_constructColumn = require('./constructColumn.cjs');
 
 //#region src/core/columns/coreColumnsFeature.utils.ts
 /**
-* Returns flat columns for a column.
+* Flattens this column and every descendant column into a single array.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* Group columns appear before their child columns, which matches the normalized
+* column hierarchy produced during table construction.
 *
 * @example
 * ```ts
-* const value = column_getFlatColumns(column)
+* const flatColumns = column_getFlatColumns(column)
 * ```
 */
 function column_getFlatColumns(column) {
 	return [column, ...column.columns.flatMap((col) => col.getFlatColumns())];
 }
 /**
-* Returns leaf columns for a column.
+* Collects the terminal leaf columns below this column.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* Group columns return their ordered descendants. Non-group columns return an
+* array containing only the column itself.
 *
 * @example
 * ```ts
-* const value = column_getLeafColumns(column)
+* const leafColumns = column_getLeafColumns(column)
 * ```
 */
 function column_getLeafColumns(column) {
@@ -34,13 +36,15 @@ function column_getLeafColumns(column) {
 	return [column];
 }
 /**
-* Returns default column def for the table.
+* Merges built-in, feature, and user default column definitions.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Built-in defaults provide a header and fallback cell renderer, feature
+* defaults can add feature-specific column options, and
+* `options.defaultColumn` wins last.
 *
 * @example
 * ```ts
-* const value = table_getDefaultColumnDef(table)
+* const defaultColumn = table_getDefaultColumnDef(table)
 * ```
 */
 function table_getDefaultColumnDef(table) {
@@ -63,13 +67,14 @@ function table_getDefaultColumnDef(table) {
 	};
 }
 /**
-* Returns all columns for the table.
+* Normalizes `options.columns` into the table's nested column tree.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Each column definition is constructed with its parent and depth, and group
+* column children are recursively constructed.
 *
 * @example
 * ```ts
-* const value = table_getAllColumns(table)
+* const columns = table_getAllColumns(table)
 * ```
 */
 function table_getAllColumns(table) {
@@ -84,26 +89,28 @@ function table_getAllColumns(table) {
 	return recurseColumns(table.options.columns);
 }
 /**
-* Returns all flat columns for the table.
+* Flattens every table column, including group columns and leaf columns.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Use this when parent/group columns must be included in addition to data leaf
+* columns.
 *
 * @example
 * ```ts
-* const value = table_getAllFlatColumns(table)
+* const flatColumns = table_getAllFlatColumns(table)
 * ```
 */
 function table_getAllFlatColumns(table) {
 	return table.getAllColumns().flatMap((column) => column.getFlatColumns());
 }
 /**
-* Returns all flat columns by id for the table.
+* Builds an id lookup for every flat column in the table.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Group columns and leaf columns are included. Later columns with the same id
+* replace earlier entries.
 *
 * @example
 * ```ts
-* const value = table_getAllFlatColumnsById(table)
+* const columnsById = table_getAllFlatColumnsById(table)
 * ```
 */
 function table_getAllFlatColumnsById(table) {
@@ -116,13 +123,14 @@ function table_getAllFlatColumnsById(table) {
 	return result;
 }
 /**
-* Returns all leaf columns for the table.
+* Collects all terminal leaf columns in their current table order.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Column ordering features can reorder the collected leaves before the result
+* is returned.
 *
 * @example
 * ```ts
-* const value = table_getAllLeafColumns(table)
+* const leafColumns = table_getAllLeafColumns(table)
 * ```
 */
 function table_getAllLeafColumns(table) {
@@ -130,13 +138,14 @@ function table_getAllLeafColumns(table) {
 	return require_utils.callMemoOrStaticFn(table, "getOrderColumns", require_columnOrderingFeature_utils.table_getOrderColumnsFn)(leafColumns);
 }
 /**
-* Returns all leaf columns by id for the table.
+* Builds an id lookup for terminal leaf columns only.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Parent/group columns are excluded, making this lookup appropriate for row
+* cells and feature state keyed by data columns.
 *
 * @example
 * ```ts
-* const value = table_getAllLeafColumnsById(table)
+* const leavesById = table_getAllLeafColumnsById(table)
 * ```
 */
 function table_getAllLeafColumnsById(table) {
@@ -149,13 +158,14 @@ function table_getAllLeafColumnsById(table) {
 	return result;
 }
 /**
-* Returns column for the table.
+* Looks up a column by id from the flat column map.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* The lookup can return group columns or leaf columns. In development, a
+* missing id logs a warning to help catch stale column references.
 *
 * @example
 * ```ts
-* const value = table_getColumn(table)
+* const column = table_getColumn(table, 'firstName')
 * ```
 */
 function table_getColumn(table, columnId) {

package/dist/core/columns/coreColumnsFeature.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"coreColumnsFeature.utils.cjs","names":["callMemoOrStaticFn","table_getOrderColumnsFn","constructColumn"],"sources":["../../../src/core/columns/coreColumnsFeature.utils.ts"],"sourcesContent":["import { callMemoOrStaticFn } from '../../utils'\nimport { table_getOrderColumnsFn } from '../../features/column-ordering/columnOrderingFeature.utils'\nimport { constructColumn } from './constructColumn'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  ColumnDef,\n  ColumnDefResolved,\n  GroupColumnDef,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\n\n/**\n * Returns flat columns for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = column_getFlatColumns(column)\n * ```\n */\nexport function column_getFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  return [column, ...column.columns.flatMap((col) => col.getFlatColumns())]\n}\n\n/**\n * Returns leaf columns for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = column_getLeafColumns(column)\n * ```\n */\nexport function column_getLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  if (column.columns.length) {\n    const leafColumns = column.columns.flatMap(\n      (col) => col.getLeafColumns(), // recursive\n    )\n\n    return callMemoOrStaticFn(\n      column.table,\n      'getOrderColumns',\n      table_getOrderColumnsFn,\n    )(leafColumns as any) as any\n  }\n\n  return [column]\n}\n\n/**\n * Returns default column def for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getDefaultColumnDef(table)\n * ```\n */\nexport function table_getDefaultColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Partial<ColumnDef<TFeatures, TData, unknown>> {\n  return {\n    header: (props) => {\n      const resolvedColumnDef = props.header.column\n        .columnDef as ColumnDefResolved<{}, TData>\n\n      if (resolvedColumnDef.accessorKey) {\n        return resolvedColumnDef.accessorKey\n      }\n\n      if (resolvedColumnDef.accessorFn) {\n        return resolvedColumnDef.id\n      }\n\n      return null\n    },\n    cell: (props) => props.renderValue<any>()?.toString?.() ?? null,\n    ...Object.values(table._features).reduce((obj, feature) => {\n      return Object.assign(obj, feature.getDefaultColumnDef?.())\n    }, {}),\n    ...table.options.defaultColumn,\n  } as Partial<ColumnDef<TFeatures, TData, unknown>>\n}\n\n/**\n * Returns all columns for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getAllColumns(table)\n * ```\n */\nexport function table_getAllColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const recurseColumns = (\n    colDefs: ReadonlyArray<ColumnDef<TFeatures, TData, unknown>>,\n    parent?: Column<TFeatures, TData, unknown>,\n    depth = 0,\n  ): Array<Column<TFeatures, TData, unknown>> => {\n    return colDefs.map((columnDef) => {\n      const column = constructColumn(table, columnDef, depth, parent)\n\n      const groupingColumnDef = columnDef as GroupColumnDef<\n        TFeatures,\n        TData,\n        unknown\n      >\n\n      column.columns = groupingColumnDef.columns\n        ? recurseColumns(groupingColumnDef.columns, column, depth + 1)\n        : []\n\n      return column\n    })\n  }\n\n  return recurseColumns(table.options.columns)\n}\n\n/**\n * Returns all flat columns for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getAllFlatColumns(table)\n * ```\n */\nexport function table_getAllFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  return table.getAllColumns().flatMap((column) => column.getFlatColumns())\n}\n\n/**\n * Returns all flat columns by id for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getAllFlatColumnsById(table)\n * ```\n */\nexport function table_getAllFlatColumnsById<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Record<string, Column<TFeatures, TData, unknown>> {\n  const result: Record<string, Column<TFeatures, TData, unknown>> = {}\n  const flatColumns = table.getAllFlatColumns()\n  for (let i = 0; i < flatColumns.length; i++) {\n    const column = flatColumns[i]!\n    result[column.id] = column\n  }\n  return result\n}\n\n/**\n * Returns all leaf columns for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getAllLeafColumns(table)\n * ```\n */\nexport function table_getAllLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const leafColumns = table.getAllColumns().flatMap(\n    (c) => c.getLeafColumns(), // recursive\n  )\n  return callMemoOrStaticFn(\n    table,\n    'getOrderColumns',\n    table_getOrderColumnsFn,\n  )(leafColumns)\n}\n\n/**\n * Returns all leaf columns by id for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getAllLeafColumnsById(table)\n * ```\n */\nexport function table_getAllLeafColumnsById<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Record<string, Column<TFeatures, TData, unknown>> {\n  const result: Record<string, Column<TFeatures, TData, unknown>> = {}\n  const leafColumns = table.getAllLeafColumns()\n  for (let i = 0; i < leafColumns.length; i++) {\n    const column = leafColumns[i]!\n    result[column.id] = column\n  }\n  return result\n}\n\n/**\n * Returns column for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getColumn(table)\n * ```\n */\nexport function table_getColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnId: string,\n): Column<TFeatures, TData, unknown> | undefined {\n  const column = table.getAllFlatColumnsById()[columnId]\n\n  if (process.env.NODE_ENV === 'development' && !column) {\n    console.warn(`[Table] Column with id '${columnId}' does not exist.`)\n  }\n\n  return column\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuBA,SAAgB,sBAKd,QACyC;CACzC,OAAO,CAAC,QAAQ,GAAG,OAAO,QAAQ,SAAS,QAAQ,IAAI,gBAAgB,CAAC,CAAC;;;;;;;;;;;;AAa3E,SAAgB,sBAKd,QACyC;CACzC,IAAI,OAAO,QAAQ,QAAQ;EACzB,MAAM,cAAc,OAAO,QAAQ,SAChC,QAAQ,IAAI,gBAAgB,CAC9B;EAED,OAAOA,iCACL,OAAO,OACP,mBACAC,4DACD,CAAC,YAAmB;;CAGvB,OAAO,CAAC,OAAO;;;;;;;;;;;;AAajB,SAAgB,0BAId,OAC+C;CAC/C,OAAO;EACL,SAAS,UAAU;GACjB,MAAM,oBAAoB,MAAM,OAAO,OACpC;GAEH,IAAI,kBAAkB,aACpB,OAAO,kBAAkB;GAG3B,IAAI,kBAAkB,YACpB,OAAO,kBAAkB;GAG3B,OAAO;;EAET,OAAO,UAAU;;uCAAM,aAAkB,2FAAE,gHAAY,KAAI;;EAC3D,GAAG,OAAO,OAAO,MAAM,UAAU,CAAC,QAAQ,KAAK,YAAY;;GACzD,OAAO,OAAO,OAAO,8BAAK,QAAQ,gHAAuB,CAAC;KACzD,EAAE,CAAC;EACN,GAAG,MAAM,QAAQ;EAClB;;;;;;;;;;;;AAaH,SAAgB,oBAId,OAC0C;CAC1C,MAAM,kBACJ,SACA,QACA,QAAQ,MACqC;EAC7C,OAAO,QAAQ,KAAK,cAAc;GAChC,MAAM,SAASC,wCAAgB,OAAO,WAAW,OAAO,OAAO;GAE/D,MAAM,oBAAoB;GAM1B,OAAO,UAAU,kBAAkB,UAC/B,eAAe,kBAAkB,SAAS,QAAQ,QAAQ,EAAE,GAC5D,EAAE;GAEN,OAAO;IACP;;CAGJ,OAAO,eAAe,MAAM,QAAQ,QAAQ;;;;;;;;;;;;AAa9C,SAAgB,wBAId,OAC0C;CAC1C,OAAO,MAAM,eAAe,CAAC,SAAS,WAAW,OAAO,gBAAgB,CAAC;;;;;;;;;;;;AAa3E,SAAgB,4BAId,OACmD;CACnD,MAAM,SAA4D,EAAE;CACpE,MAAM,cAAc,MAAM,mBAAmB;CAC7C,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,SAAS,YAAY;EAC3B,OAAO,OAAO,MAAM;;CAEtB,OAAO;;;;;;;;;;;;AAaT,SAAgB,wBAId,OAC0C;CAC1C,MAAM,cAAc,MAAM,eAAe,CAAC,SACvC,MAAM,EAAE,gBAAgB,CAC1B;CACD,OAAOF,iCACL,OACA,mBACAC,4DACD,CAAC,YAAY;;;;;;;;;;;;AAahB,SAAgB,4BAId,OACmD;CACnD,MAAM,SAA4D,EAAE;CACpE,MAAM,cAAc,MAAM,mBAAmB;CAC7C,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,SAAS,YAAY;EAC3B,OAAO,OAAO,MAAM;;CAEtB,OAAO;;;;;;;;;;;;AAaT,SAAgB,gBAId,OACA,UAC+C;CAC/C,MAAM,SAAS,MAAM,uBAAuB,CAAC;CAE7C,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,QAC7C,QAAQ,KAAK,2BAA2B,SAAS,mBAAmB;CAGtE,OAAO"}
+{"version":3,"file":"coreColumnsFeature.utils.cjs","names":["callMemoOrStaticFn","table_getOrderColumnsFn","constructColumn"],"sources":["../../../src/core/columns/coreColumnsFeature.utils.ts"],"sourcesContent":["import { callMemoOrStaticFn } from '../../utils'\nimport { table_getOrderColumnsFn } from '../../features/column-ordering/columnOrderingFeature.utils'\nimport { constructColumn } from './constructColumn'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  ColumnDef,\n  ColumnDefResolved,\n  GroupColumnDef,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\n\n/**\n * Flattens this column and every descendant column into a single array.\n *\n * Group columns appear before their child columns, which matches the normalized\n * column hierarchy produced during table construction.\n *\n * @example\n * ```ts\n * const flatColumns = column_getFlatColumns(column)\n * ```\n */\nexport function column_getFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  return [column, ...column.columns.flatMap((col) => col.getFlatColumns())]\n}\n\n/**\n * Collects the terminal leaf columns below this column.\n *\n * Group columns return their ordered descendants. Non-group columns return an\n * array containing only the column itself.\n *\n * @example\n * ```ts\n * const leafColumns = column_getLeafColumns(column)\n * ```\n */\nexport function column_getLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  if (column.columns.length) {\n    const leafColumns = column.columns.flatMap(\n      (col) => col.getLeafColumns(), // recursive\n    )\n\n    return callMemoOrStaticFn(\n      column.table,\n      'getOrderColumns',\n      table_getOrderColumnsFn,\n    )(leafColumns as any) as any\n  }\n\n  return [column]\n}\n\n/**\n * Merges built-in, feature, and user default column definitions.\n *\n * Built-in defaults provide a header and fallback cell renderer, feature\n * defaults can add feature-specific column options, and\n * `options.defaultColumn` wins last.\n *\n * @example\n * ```ts\n * const defaultColumn = table_getDefaultColumnDef(table)\n * ```\n */\nexport function table_getDefaultColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Partial<ColumnDef<TFeatures, TData, unknown>> {\n  return {\n    header: (props) => {\n      const resolvedColumnDef = props.header.column\n        .columnDef as ColumnDefResolved<{}, TData>\n\n      if (resolvedColumnDef.accessorKey) {\n        return resolvedColumnDef.accessorKey\n      }\n\n      if (resolvedColumnDef.accessorFn) {\n        return resolvedColumnDef.id\n      }\n\n      return null\n    },\n    cell: (props) => props.renderValue<any>()?.toString?.() ?? null,\n    ...Object.values(table._features).reduce((obj, feature) => {\n      return Object.assign(obj, feature.getDefaultColumnDef?.())\n    }, {}),\n    ...table.options.defaultColumn,\n  } as Partial<ColumnDef<TFeatures, TData, unknown>>\n}\n\n/**\n * Normalizes `options.columns` into the table's nested column tree.\n *\n * Each column definition is constructed with its parent and depth, and group\n * column children are recursively constructed.\n *\n * @example\n * ```ts\n * const columns = table_getAllColumns(table)\n * ```\n */\nexport function table_getAllColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const recurseColumns = (\n    colDefs: ReadonlyArray<ColumnDef<TFeatures, TData, unknown>>,\n    parent?: Column<TFeatures, TData, unknown>,\n    depth = 0,\n  ): Array<Column<TFeatures, TData, unknown>> => {\n    return colDefs.map((columnDef) => {\n      const column = constructColumn(table, columnDef, depth, parent)\n\n      const groupingColumnDef = columnDef as GroupColumnDef<\n        TFeatures,\n        TData,\n        unknown\n      >\n\n      column.columns = groupingColumnDef.columns\n        ? recurseColumns(groupingColumnDef.columns, column, depth + 1)\n        : []\n\n      return column\n    })\n  }\n\n  return recurseColumns(table.options.columns)\n}\n\n/**\n * Flattens every table column, including group columns and leaf columns.\n *\n * Use this when parent/group columns must be included in addition to data leaf\n * columns.\n *\n * @example\n * ```ts\n * const flatColumns = table_getAllFlatColumns(table)\n * ```\n */\nexport function table_getAllFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  return table.getAllColumns().flatMap((column) => column.getFlatColumns())\n}\n\n/**\n * Builds an id lookup for every flat column in the table.\n *\n * Group columns and leaf columns are included. Later columns with the same id\n * replace earlier entries.\n *\n * @example\n * ```ts\n * const columnsById = table_getAllFlatColumnsById(table)\n * ```\n */\nexport function table_getAllFlatColumnsById<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Record<string, Column<TFeatures, TData, unknown>> {\n  const result: Record<string, Column<TFeatures, TData, unknown>> = {}\n  const flatColumns = table.getAllFlatColumns()\n  for (let i = 0; i < flatColumns.length; i++) {\n    const column = flatColumns[i]!\n    result[column.id] = column\n  }\n  return result\n}\n\n/**\n * Collects all terminal leaf columns in their current table order.\n *\n * Column ordering features can reorder the collected leaves before the result\n * is returned.\n *\n * @example\n * ```ts\n * const leafColumns = table_getAllLeafColumns(table)\n * ```\n */\nexport function table_getAllLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const leafColumns = table.getAllColumns().flatMap(\n    (c) => c.getLeafColumns(), // recursive\n  )\n  return callMemoOrStaticFn(\n    table,\n    'getOrderColumns',\n    table_getOrderColumnsFn,\n  )(leafColumns)\n}\n\n/**\n * Builds an id lookup for terminal leaf columns only.\n *\n * Parent/group columns are excluded, making this lookup appropriate for row\n * cells and feature state keyed by data columns.\n *\n * @example\n * ```ts\n * const leavesById = table_getAllLeafColumnsById(table)\n * ```\n */\nexport function table_getAllLeafColumnsById<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Record<string, Column<TFeatures, TData, unknown>> {\n  const result: Record<string, Column<TFeatures, TData, unknown>> = {}\n  const leafColumns = table.getAllLeafColumns()\n  for (let i = 0; i < leafColumns.length; i++) {\n    const column = leafColumns[i]!\n    result[column.id] = column\n  }\n  return result\n}\n\n/**\n * Looks up a column by id from the flat column map.\n *\n * The lookup can return group columns or leaf columns. In development, a\n * missing id logs a warning to help catch stale column references.\n *\n * @example\n * ```ts\n * const column = table_getColumn(table, 'firstName')\n * ```\n */\nexport function table_getColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnId: string,\n): Column<TFeatures, TData, unknown> | undefined {\n  const column = table.getAllFlatColumnsById()[columnId]\n\n  if (process.env.NODE_ENV === 'development' && !column) {\n    console.warn(`[Table] Column with id '${columnId}' does not exist.`)\n  }\n\n  return column\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAwBA,SAAgB,sBAKd,QACyC;CACzC,OAAO,CAAC,QAAQ,GAAG,OAAO,QAAQ,SAAS,QAAQ,IAAI,gBAAgB,CAAC,CAAC;;;;;;;;;;;;;AAc3E,SAAgB,sBAKd,QACyC;CACzC,IAAI,OAAO,QAAQ,QAAQ;EACzB,MAAM,cAAc,OAAO,QAAQ,SAChC,QAAQ,IAAI,gBAAgB,CAC9B;EAED,OAAOA,iCACL,OAAO,OACP,mBACAC,4DACD,CAAC,YAAmB;;CAGvB,OAAO,CAAC,OAAO;;;;;;;;;;;;;;AAejB,SAAgB,0BAId,OAC+C;CAC/C,OAAO;EACL,SAAS,UAAU;GACjB,MAAM,oBAAoB,MAAM,OAAO,OACpC;GAEH,IAAI,kBAAkB,aACpB,OAAO,kBAAkB;GAG3B,IAAI,kBAAkB,YACpB,OAAO,kBAAkB;GAG3B,OAAO;;EAET,OAAO,UAAU;;uCAAM,aAAkB,2FAAE,gHAAY,KAAI;;EAC3D,GAAG,OAAO,OAAO,MAAM,UAAU,CAAC,QAAQ,KAAK,YAAY;;GACzD,OAAO,OAAO,OAAO,8BAAK,QAAQ,gHAAuB,CAAC;KACzD,EAAE,CAAC;EACN,GAAG,MAAM,QAAQ;EAClB;;;;;;;;;;;;;AAcH,SAAgB,oBAId,OAC0C;CAC1C,MAAM,kBACJ,SACA,QACA,QAAQ,MACqC;EAC7C,OAAO,QAAQ,KAAK,cAAc;GAChC,MAAM,SAASC,wCAAgB,OAAO,WAAW,OAAO,OAAO;GAE/D,MAAM,oBAAoB;GAM1B,OAAO,UAAU,kBAAkB,UAC/B,eAAe,kBAAkB,SAAS,QAAQ,QAAQ,EAAE,GAC5D,EAAE;GAEN,OAAO;IACP;;CAGJ,OAAO,eAAe,MAAM,QAAQ,QAAQ;;;;;;;;;;;;;AAc9C,SAAgB,wBAId,OAC0C;CAC1C,OAAO,MAAM,eAAe,CAAC,SAAS,WAAW,OAAO,gBAAgB,CAAC;;;;;;;;;;;;;AAc3E,SAAgB,4BAId,OACmD;CACnD,MAAM,SAA4D,EAAE;CACpE,MAAM,cAAc,MAAM,mBAAmB;CAC7C,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,SAAS,YAAY;EAC3B,OAAO,OAAO,MAAM;;CAEtB,OAAO;;;;;;;;;;;;;AAcT,SAAgB,wBAId,OAC0C;CAC1C,MAAM,cAAc,MAAM,eAAe,CAAC,SACvC,MAAM,EAAE,gBAAgB,CAC1B;CACD,OAAOF,iCACL,OACA,mBACAC,4DACD,CAAC,YAAY;;;;;;;;;;;;;AAchB,SAAgB,4BAId,OACmD;CACnD,MAAM,SAA4D,EAAE;CACpE,MAAM,cAAc,MAAM,mBAAmB;CAC7C,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,SAAS,YAAY;EAC3B,OAAO,OAAO,MAAM;;CAEtB,OAAO;;;;;;;;;;;;;AAcT,SAAgB,gBAId,OACA,UAC+C;CAC/C,MAAM,SAAS,MAAM,uBAAuB,CAAC;CAE7C,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,QAC7C,QAAQ,KAAK,2BAA2B,SAAS,mBAAmB;CAGtE,OAAO"}