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

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/constructCell.cjs

@@ -7,9 +7,10 @@
 function getCellPrototype(table) {
 	if (!table._cellPrototype) {
 		table._cellPrototype = { table };
-		for (const feature of Object.values(table._features)) {
-			var _feature$assignCellPr;
-			(_feature$assignCellPr = feature.assignCellPrototype) === null || _feature$assignCellPr === void 0 || _feature$assignCellPr.call(feature, table._cellPrototype, table);
+		const features = Object.values(table._features);
+		for (let i = 0; i < features.length; i++) {
+			var _assignCellPrototype, _ref;
+			(_assignCellPrototype = (_ref = features[i]).assignCellPrototype) === null || _assignCellPrototype === void 0 || _assignCellPrototype.call(_ref, table._cellPrototype, table);
 		}
 	}
 	return table._cellPrototype;

package/dist/core/cells/constructCell.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constructCell.cjs","names":[],"sources":["../../../src/core/cells/constructCell.ts"],"sourcesContent":["import type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\nimport type { Column } from '../../types/Column'\nimport type { Cell_CoreProperties } from './coreCellsFeature.types'\n\n/**\n * Creates or retrieves the cell prototype for a table.\n * The prototype is cached on the table and shared by all cell instances.\n */\nfunction getCellPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._cellPrototype) {\n    table._cellPrototype = { table }\n    for (const feature of Object.values(table._features)) {\n      feature.assignCellPrototype?.(table._cellPrototype, table)\n    }\n  }\n  return table._cellPrototype\n}\n\n/**\n * Constructs a cell instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructCell<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n  row: Row<TFeatures, TData>,\n  table: Table_Internal<TFeatures, TData>,\n): Cell<TFeatures, TData, TValue> {\n  // Create cell with shared prototype for memory efficiency\n  const cellPrototype = getCellPrototype(table)\n  const cell = Object.create(cellPrototype) as Cell_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  cell.column = column\n  cell.id = `${row.id}_${column.id}`\n  cell.row = row\n\n  return cell as Cell<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;;AAYA,SAAS,iBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,gBAAgB;EACzB,MAAM,iBAAiB,EAAE,OAAO;EAChC,KAAK,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU,EAAE;;GACpD,iCAAQ,yGAAsB,MAAM,gBAAgB,MAAM;;;CAG9D,OAAO,MAAM;;;;;;;AAQf,SAAgB,cAKd,QACA,KACA,OACgC;CAEhC,MAAM,gBAAgB,iBAAiB,MAAM;CAC7C,MAAM,OAAO,OAAO,OAAO,cAAc;CAOzC,KAAK,SAAS;CACd,KAAK,KAAK,GAAG,IAAI,GAAG,GAAG,OAAO;CAC9B,KAAK,MAAM;CAEX,OAAO"}
+{"version":3,"file":"constructCell.cjs","names":[],"sources":["../../../src/core/cells/constructCell.ts"],"sourcesContent":["import type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\nimport type { Column } from '../../types/Column'\nimport type { Cell_CoreProperties } from './coreCellsFeature.types'\n\n/**\n * Creates or retrieves the cell prototype for a table.\n * The prototype is cached on the table and shared by all cell instances.\n */\nfunction getCellPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._cellPrototype) {\n    table._cellPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignCellPrototype?.(table._cellPrototype, table)\n    }\n  }\n  return table._cellPrototype\n}\n\n/**\n * Constructs a cell instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructCell<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n  row: Row<TFeatures, TData>,\n  table: Table_Internal<TFeatures, TData>,\n): Cell<TFeatures, TData, TValue> {\n  // Create cell with shared prototype for memory efficiency\n  const cellPrototype = getCellPrototype(table)\n  const cell = Object.create(cellPrototype) as Cell_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  cell.column = column\n  cell.id = `${row.id}_${column.id}`\n  cell.row = row\n\n  return cell as Cell<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;;AAYA,SAAS,iBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,gBAAgB;EACzB,MAAM,iBAAiB,EAAE,OAAO;EAChC,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU;EAC/C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,yCAAS,IAAI,oGAAsB,MAAM,gBAAgB,MAAM;;;CAGnE,OAAO,MAAM;;;;;;;AAQf,SAAgB,cAKd,QACA,KACA,OACgC;CAEhC,MAAM,gBAAgB,iBAAiB,MAAM;CAC7C,MAAM,OAAO,OAAO,OAAO,cAAc;CAOzC,KAAK,SAAS;CACd,KAAK,KAAK,GAAG,IAAI,GAAG,GAAG,OAAO;CAC9B,KAAK,MAAM;CAEX,OAAO"}

package/dist/core/cells/constructCell.js

@@ -6,9 +6,10 @@
 function getCellPrototype(table) {
 	if (!table._cellPrototype) {
 		table._cellPrototype = { table };
-		for (const feature of Object.values(table._features)) {
-			var _feature$assignCellPr;
-			(_feature$assignCellPr = feature.assignCellPrototype) === null || _feature$assignCellPr === void 0 || _feature$assignCellPr.call(feature, table._cellPrototype, table);
+		const features = Object.values(table._features);
+		for (let i = 0; i < features.length; i++) {
+			var _assignCellPrototype, _ref;
+			(_assignCellPrototype = (_ref = features[i]).assignCellPrototype) === null || _assignCellPrototype === void 0 || _assignCellPrototype.call(_ref, table._cellPrototype, table);
 		}
 	}
 	return table._cellPrototype;

package/dist/core/cells/constructCell.js.map

@@ -1 +1 @@
-{"version":3,"file":"constructCell.js","names":[],"sources":["../../../src/core/cells/constructCell.ts"],"sourcesContent":["import type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\nimport type { Column } from '../../types/Column'\nimport type { Cell_CoreProperties } from './coreCellsFeature.types'\n\n/**\n * Creates or retrieves the cell prototype for a table.\n * The prototype is cached on the table and shared by all cell instances.\n */\nfunction getCellPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._cellPrototype) {\n    table._cellPrototype = { table }\n    for (const feature of Object.values(table._features)) {\n      feature.assignCellPrototype?.(table._cellPrototype, table)\n    }\n  }\n  return table._cellPrototype\n}\n\n/**\n * Constructs a cell instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructCell<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n  row: Row<TFeatures, TData>,\n  table: Table_Internal<TFeatures, TData>,\n): Cell<TFeatures, TData, TValue> {\n  // Create cell with shared prototype for memory efficiency\n  const cellPrototype = getCellPrototype(table)\n  const cell = Object.create(cellPrototype) as Cell_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  cell.column = column\n  cell.id = `${row.id}_${column.id}`\n  cell.row = row\n\n  return cell as Cell<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;AAYA,SAAS,iBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,gBAAgB;EACzB,MAAM,iBAAiB,EAAE,OAAO;EAChC,KAAK,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU,EAAE;;GACpD,iCAAQ,yGAAsB,MAAM,gBAAgB,MAAM;;;CAG9D,OAAO,MAAM;;;;;;;AAQf,SAAgB,cAKd,QACA,KACA,OACgC;CAEhC,MAAM,gBAAgB,iBAAiB,MAAM;CAC7C,MAAM,OAAO,OAAO,OAAO,cAAc;CAOzC,KAAK,SAAS;CACd,KAAK,KAAK,GAAG,IAAI,GAAG,GAAG,OAAO;CAC9B,KAAK,MAAM;CAEX,OAAO"}
+{"version":3,"file":"constructCell.js","names":[],"sources":["../../../src/core/cells/constructCell.ts"],"sourcesContent":["import type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\nimport type { Column } from '../../types/Column'\nimport type { Cell_CoreProperties } from './coreCellsFeature.types'\n\n/**\n * Creates or retrieves the cell prototype for a table.\n * The prototype is cached on the table and shared by all cell instances.\n */\nfunction getCellPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._cellPrototype) {\n    table._cellPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignCellPrototype?.(table._cellPrototype, table)\n    }\n  }\n  return table._cellPrototype\n}\n\n/**\n * Constructs a cell instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructCell<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n  row: Row<TFeatures, TData>,\n  table: Table_Internal<TFeatures, TData>,\n): Cell<TFeatures, TData, TValue> {\n  // Create cell with shared prototype for memory efficiency\n  const cellPrototype = getCellPrototype(table)\n  const cell = Object.create(cellPrototype) as Cell_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  cell.column = column\n  cell.id = `${row.id}_${column.id}`\n  cell.row = row\n\n  return cell as Cell<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;AAYA,SAAS,iBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,gBAAgB;EACzB,MAAM,iBAAiB,EAAE,OAAO;EAChC,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU;EAC/C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,yCAAS,IAAI,oGAAsB,MAAM,gBAAgB,MAAM;;;CAGnE,OAAO,MAAM;;;;;;;AAQf,SAAgB,cAKd,QACA,KACA,OACgC;CAEhC,MAAM,gBAAgB,iBAAiB,MAAM;CAC7C,MAAM,OAAO,OAAO,OAAO,cAAc;CAOzC,KAAK,SAAS;CACd,KAAK,KAAK,GAAG,IAAI,GAAG,GAAG,OAAO;CAC9B,KAAK,MAAM;CAEX,OAAO"}

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/constructColumn.cjs

@@ -7,9 +7,10 @@
 function getColumnPrototype(table) {
 	if (!table._columnPrototype) {
 		table._columnPrototype = { table };
-		for (const feature of Object.values(table._features)) {
-			var _feature$assignColumn;
-			(_feature$assignColumn = feature.assignColumnPrototype) === null || _feature$assignColumn === void 0 || _feature$assignColumn.call(feature, table._columnPrototype, table);
+		const features = Object.values(table._features);
+		for (let i = 0; i < features.length; i++) {
+			var _assignColumnPrototyp, _ref;
+			(_assignColumnPrototyp = (_ref = features[i]).assignColumnPrototype) === null || _assignColumnPrototyp === void 0 || _assignColumnPrototyp.call(_ref, table._columnPrototype, table);
 		}
 	}
 	return table._columnPrototype;
@@ -32,7 +33,8 @@ function constructColumn(table, columnDef, depth, parent) {
 		const keys = accessorKey.split(".");
 		accessorFn = (originalRow) => {
 			let result = originalRow;
-			for (const key of keys) {
+			for (let i = 0; i < keys.length; i++) {
+				const key = keys[i];
 				result = result === null || result === void 0 ? void 0 : result[key];
 				if (process.env.NODE_ENV === "development" && result === void 0) console.warn(`"${key}" in deeply nested key "${accessorKey}" returned undefined.`);
 			}

package/dist/core/columns/constructColumn.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constructColumn.cjs","names":[],"sources":["../../../src/core/columns/constructColumn.ts"],"sourcesContent":["import {} from '../../utils'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  AccessorFn,\n  ColumnDef,\n  ColumnDefResolved,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\nimport type { Column_CoreProperties } from './coreColumnsFeature.types'\n\n/**\n * Creates or retrieves the column prototype for a table.\n * The prototype is cached on the table and shared by all column instances.\n */\nfunction getColumnPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._columnPrototype) {\n    table._columnPrototype = { table }\n    for (const feature of Object.values(table._features)) {\n      feature.assignColumnPrototype?.(table._columnPrototype, table)\n    }\n  }\n  return table._columnPrototype\n}\n\n/**\n * Constructs a column instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnDef: ColumnDef<TFeatures, TData, TValue>,\n  depth: number,\n  parent?: Column<TFeatures, TData, TValue>,\n): Column<TFeatures, TData, TValue> {\n  const defaultColumn = table.getDefaultColumnDef()\n\n  const resolvedColumnDef = {\n    ...defaultColumn,\n    ...columnDef,\n  } as ColumnDefResolved<{}, TData, TValue>\n\n  const accessorKey = resolvedColumnDef.accessorKey\n\n  const id =\n    resolvedColumnDef.id ??\n    (accessorKey ? accessorKey.replaceAll('.', '_') : undefined) ??\n    (typeof resolvedColumnDef.header === 'string'\n      ? resolvedColumnDef.header\n      : undefined)\n\n  let accessorFn: AccessorFn<TData, TValue> | undefined\n\n  if (resolvedColumnDef.accessorFn) {\n    accessorFn = resolvedColumnDef.accessorFn\n  } else if (accessorKey) {\n    // Support deep accessor keys\n    if (accessorKey.includes('.')) {\n      const keys = accessorKey.split('.')\n      accessorFn = (originalRow: TData) => {\n        let result = originalRow as Record<string, any> | undefined\n\n        for (const key of keys) {\n          result = result?.[key]\n          if (process.env.NODE_ENV === 'development' && result === undefined) {\n            console.warn(\n              `\"${key}\" in deeply nested key \"${accessorKey}\" returned undefined.`,\n            )\n          }\n        }\n\n        return result as TValue\n      }\n    } else {\n      accessorFn = (originalRow: TData) =>\n        (originalRow as any)[resolvedColumnDef.accessorKey]\n    }\n  }\n\n  if (!id) {\n    if (process.env.NODE_ENV === 'development') {\n      throw new Error(\n        resolvedColumnDef.accessorFn\n          ? `coreColumnsFeature require an id when using an accessorFn`\n          : `coreColumnsFeature require an id when using a non-string header`,\n      )\n    }\n    throw new Error()\n  }\n\n  // Create column with shared prototype for memory efficiency\n  const columnPrototype = getColumnPrototype(table)\n  const column = Object.create(columnPrototype) as Column_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  column.accessorFn = accessorFn\n  column.columnDef = resolvedColumnDef as ColumnDef<TFeatures, TData, TValue>\n  column.columns = []\n  column.depth = depth\n  column.id = `${String(id)}`\n  column.parent = parent\n\n  return column as Column<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;;AAgBA,SAAS,mBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,kBAAkB;EAC3B,MAAM,mBAAmB,EAAE,OAAO;EAClC,KAAK,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU,EAAE;;GACpD,iCAAQ,2GAAwB,MAAM,kBAAkB,MAAM;;;CAGlE,OAAO,MAAM;;;;;;;AAQf,SAAgB,gBAKd,OACA,WACA,OACA,QACkC;CAGlC,MAAM,oBAAoB;EACxB,GAHoB,MAAM,qBAGV;EAChB,GAAG;EACJ;CAED,MAAM,cAAc,kBAAkB;CAEtC,MAAM,KACJ,kBAAkB,OACjB,cAAc,YAAY,WAAW,KAAK,IAAI,GAAG,YACjD,OAAO,kBAAkB,WAAW,WACjC,kBAAkB,SAClB;CAEN,IAAI;CAEJ,IAAI,kBAAkB,YACpB,aAAa,kBAAkB;MAC1B,IAAI,aAET,IAAI,YAAY,SAAS,IAAI,EAAE;EAC7B,MAAM,OAAO,YAAY,MAAM,IAAI;EACnC,cAAc,gBAAuB;GACnC,IAAI,SAAS;GAEb,KAAK,MAAM,OAAO,MAAM;IACtB,yDAAS,OAAS;IAClB,IAAI,QAAQ,IAAI,aAAa,iBAAiB,WAAW,QACvD,QAAQ,KACN,IAAI,IAAI,0BAA0B,YAAY,uBAC/C;;GAIL,OAAO;;QAGT,cAAc,gBACX,YAAoB,kBAAkB;CAI7C,IAAI,CAAC,IAAI;EACP,IAAI,QAAQ,IAAI,aAAa,eAC3B,MAAM,IAAI,MACR,kBAAkB,aACd,8DACA,kEACL;EAEH,MAAM,IAAI,OAAO;;CAInB,MAAM,kBAAkB,mBAAmB,MAAM;CACjD,MAAM,SAAS,OAAO,OAAO,gBAAgB;CAO7C,OAAO,aAAa;CACpB,OAAO,YAAY;CACnB,OAAO,UAAU,EAAE;CACnB,OAAO,QAAQ;CACf,OAAO,KAAK,GAAG,OAAO,GAAG;CACzB,OAAO,SAAS;CAEhB,OAAO"}
+{"version":3,"file":"constructColumn.cjs","names":[],"sources":["../../../src/core/columns/constructColumn.ts"],"sourcesContent":["import {} from '../../utils'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  AccessorFn,\n  ColumnDef,\n  ColumnDefResolved,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\nimport type { Column_CoreProperties } from './coreColumnsFeature.types'\n\n/**\n * Creates or retrieves the column prototype for a table.\n * The prototype is cached on the table and shared by all column instances.\n */\nfunction getColumnPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._columnPrototype) {\n    table._columnPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignColumnPrototype?.(table._columnPrototype, table)\n    }\n  }\n  return table._columnPrototype\n}\n\n/**\n * Constructs a column instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnDef: ColumnDef<TFeatures, TData, TValue>,\n  depth: number,\n  parent?: Column<TFeatures, TData, TValue>,\n): Column<TFeatures, TData, TValue> {\n  const defaultColumn = table.getDefaultColumnDef()\n\n  const resolvedColumnDef = {\n    ...defaultColumn,\n    ...columnDef,\n  } as ColumnDefResolved<{}, TData, TValue>\n\n  const accessorKey = resolvedColumnDef.accessorKey\n\n  const id =\n    resolvedColumnDef.id ??\n    (accessorKey ? accessorKey.replaceAll('.', '_') : undefined) ??\n    (typeof resolvedColumnDef.header === 'string'\n      ? resolvedColumnDef.header\n      : undefined)\n\n  let accessorFn: AccessorFn<TData, TValue> | undefined\n\n  if (resolvedColumnDef.accessorFn) {\n    accessorFn = resolvedColumnDef.accessorFn\n  } else if (accessorKey) {\n    // Support deep accessor keys\n    if (accessorKey.includes('.')) {\n      const keys = accessorKey.split('.')\n      accessorFn = (originalRow: TData) => {\n        let result = originalRow as Record<string, any> | undefined\n\n        for (let i = 0; i < keys.length; i++) {\n          const key = keys[i]!\n          result = result?.[key]\n          if (process.env.NODE_ENV === 'development' && result === undefined) {\n            console.warn(\n              `\"${key}\" in deeply nested key \"${accessorKey}\" returned undefined.`,\n            )\n          }\n        }\n\n        return result as TValue\n      }\n    } else {\n      accessorFn = (originalRow: TData) =>\n        (originalRow as any)[resolvedColumnDef.accessorKey]\n    }\n  }\n\n  if (!id) {\n    if (process.env.NODE_ENV === 'development') {\n      throw new Error(\n        resolvedColumnDef.accessorFn\n          ? `coreColumnsFeature require an id when using an accessorFn`\n          : `coreColumnsFeature require an id when using a non-string header`,\n      )\n    }\n    throw new Error()\n  }\n\n  // Create column with shared prototype for memory efficiency\n  const columnPrototype = getColumnPrototype(table)\n  const column = Object.create(columnPrototype) as Column_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  column.accessorFn = accessorFn\n  column.columnDef = resolvedColumnDef as ColumnDef<TFeatures, TData, TValue>\n  column.columns = []\n  column.depth = depth\n  column.id = `${String(id)}`\n  column.parent = parent\n\n  return column as Column<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;;AAgBA,SAAS,mBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,kBAAkB;EAC3B,MAAM,mBAAmB,EAAE,OAAO;EAClC,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU;EAC/C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,0CAAS,IAAI,wGAAwB,MAAM,kBAAkB,MAAM;;;CAGvE,OAAO,MAAM;;;;;;;AAQf,SAAgB,gBAKd,OACA,WACA,OACA,QACkC;CAGlC,MAAM,oBAAoB;EACxB,GAHoB,MAAM,qBAGV;EAChB,GAAG;EACJ;CAED,MAAM,cAAc,kBAAkB;CAEtC,MAAM,KACJ,kBAAkB,OACjB,cAAc,YAAY,WAAW,KAAK,IAAI,GAAG,YACjD,OAAO,kBAAkB,WAAW,WACjC,kBAAkB,SAClB;CAEN,IAAI;CAEJ,IAAI,kBAAkB,YACpB,aAAa,kBAAkB;MAC1B,IAAI,aAET,IAAI,YAAY,SAAS,IAAI,EAAE;EAC7B,MAAM,OAAO,YAAY,MAAM,IAAI;EACnC,cAAc,gBAAuB;GACnC,IAAI,SAAS;GAEb,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;IACpC,MAAM,MAAM,KAAK;IACjB,yDAAS,OAAS;IAClB,IAAI,QAAQ,IAAI,aAAa,iBAAiB,WAAW,QACvD,QAAQ,KACN,IAAI,IAAI,0BAA0B,YAAY,uBAC/C;;GAIL,OAAO;;QAGT,cAAc,gBACX,YAAoB,kBAAkB;CAI7C,IAAI,CAAC,IAAI;EACP,IAAI,QAAQ,IAAI,aAAa,eAC3B,MAAM,IAAI,MACR,kBAAkB,aACd,8DACA,kEACL;EAEH,MAAM,IAAI,OAAO;;CAInB,MAAM,kBAAkB,mBAAmB,MAAM;CACjD,MAAM,SAAS,OAAO,OAAO,gBAAgB;CAO7C,OAAO,aAAa;CACpB,OAAO,YAAY;CACnB,OAAO,UAAU,EAAE;CACnB,OAAO,QAAQ;CACf,OAAO,KAAK,GAAG,OAAO,GAAG;CACzB,OAAO,SAAS;CAEhB,OAAO"}

package/dist/core/columns/constructColumn.js

@@ -6,9 +6,10 @@
 function getColumnPrototype(table) {
 	if (!table._columnPrototype) {
 		table._columnPrototype = { table };
-		for (const feature of Object.values(table._features)) {
-			var _feature$assignColumn;
-			(_feature$assignColumn = feature.assignColumnPrototype) === null || _feature$assignColumn === void 0 || _feature$assignColumn.call(feature, table._columnPrototype, table);
+		const features = Object.values(table._features);
+		for (let i = 0; i < features.length; i++) {
+			var _assignColumnPrototyp, _ref;
+			(_assignColumnPrototyp = (_ref = features[i]).assignColumnPrototype) === null || _assignColumnPrototyp === void 0 || _assignColumnPrototyp.call(_ref, table._columnPrototype, table);
 		}
 	}
 	return table._columnPrototype;
@@ -31,7 +32,8 @@ function constructColumn(table, columnDef, depth, parent) {
 		const keys = accessorKey.split(".");
 		accessorFn = (originalRow) => {
 			let result = originalRow;
-			for (const key of keys) {
+			for (let i = 0; i < keys.length; i++) {
+				const key = keys[i];
 				result = result === null || result === void 0 ? void 0 : result[key];
 				if (process.env.NODE_ENV === "development" && result === void 0) console.warn(`"${key}" in deeply nested key "${accessorKey}" returned undefined.`);
 			}

package/dist/core/columns/constructColumn.js.map

@@ -1 +1 @@
-{"version":3,"file":"constructColumn.js","names":[],"sources":["../../../src/core/columns/constructColumn.ts"],"sourcesContent":["import {} from '../../utils'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  AccessorFn,\n  ColumnDef,\n  ColumnDefResolved,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\nimport type { Column_CoreProperties } from './coreColumnsFeature.types'\n\n/**\n * Creates or retrieves the column prototype for a table.\n * The prototype is cached on the table and shared by all column instances.\n */\nfunction getColumnPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._columnPrototype) {\n    table._columnPrototype = { table }\n    for (const feature of Object.values(table._features)) {\n      feature.assignColumnPrototype?.(table._columnPrototype, table)\n    }\n  }\n  return table._columnPrototype\n}\n\n/**\n * Constructs a column instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnDef: ColumnDef<TFeatures, TData, TValue>,\n  depth: number,\n  parent?: Column<TFeatures, TData, TValue>,\n): Column<TFeatures, TData, TValue> {\n  const defaultColumn = table.getDefaultColumnDef()\n\n  const resolvedColumnDef = {\n    ...defaultColumn,\n    ...columnDef,\n  } as ColumnDefResolved<{}, TData, TValue>\n\n  const accessorKey = resolvedColumnDef.accessorKey\n\n  const id =\n    resolvedColumnDef.id ??\n    (accessorKey ? accessorKey.replaceAll('.', '_') : undefined) ??\n    (typeof resolvedColumnDef.header === 'string'\n      ? resolvedColumnDef.header\n      : undefined)\n\n  let accessorFn: AccessorFn<TData, TValue> | undefined\n\n  if (resolvedColumnDef.accessorFn) {\n    accessorFn = resolvedColumnDef.accessorFn\n  } else if (accessorKey) {\n    // Support deep accessor keys\n    if (accessorKey.includes('.')) {\n      const keys = accessorKey.split('.')\n      accessorFn = (originalRow: TData) => {\n        let result = originalRow as Record<string, any> | undefined\n\n        for (const key of keys) {\n          result = result?.[key]\n          if (process.env.NODE_ENV === 'development' && result === undefined) {\n            console.warn(\n              `\"${key}\" in deeply nested key \"${accessorKey}\" returned undefined.`,\n            )\n          }\n        }\n\n        return result as TValue\n      }\n    } else {\n      accessorFn = (originalRow: TData) =>\n        (originalRow as any)[resolvedColumnDef.accessorKey]\n    }\n  }\n\n  if (!id) {\n    if (process.env.NODE_ENV === 'development') {\n      throw new Error(\n        resolvedColumnDef.accessorFn\n          ? `coreColumnsFeature require an id when using an accessorFn`\n          : `coreColumnsFeature require an id when using a non-string header`,\n      )\n    }\n    throw new Error()\n  }\n\n  // Create column with shared prototype for memory efficiency\n  const columnPrototype = getColumnPrototype(table)\n  const column = Object.create(columnPrototype) as Column_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  column.accessorFn = accessorFn\n  column.columnDef = resolvedColumnDef as ColumnDef<TFeatures, TData, TValue>\n  column.columns = []\n  column.depth = depth\n  column.id = `${String(id)}`\n  column.parent = parent\n\n  return column as Column<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;AAgBA,SAAS,mBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,kBAAkB;EAC3B,MAAM,mBAAmB,EAAE,OAAO;EAClC,KAAK,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU,EAAE;;GACpD,iCAAQ,2GAAwB,MAAM,kBAAkB,MAAM;;;CAGlE,OAAO,MAAM;;;;;;;AAQf,SAAgB,gBAKd,OACA,WACA,OACA,QACkC;CAGlC,MAAM,oBAAoB;EACxB,GAHoB,MAAM,qBAGV;EAChB,GAAG;EACJ;CAED,MAAM,cAAc,kBAAkB;CAEtC,MAAM,KACJ,kBAAkB,OACjB,cAAc,YAAY,WAAW,KAAK,IAAI,GAAG,YACjD,OAAO,kBAAkB,WAAW,WACjC,kBAAkB,SAClB;CAEN,IAAI;CAEJ,IAAI,kBAAkB,YACpB,aAAa,kBAAkB;MAC1B,IAAI,aAET,IAAI,YAAY,SAAS,IAAI,EAAE;EAC7B,MAAM,OAAO,YAAY,MAAM,IAAI;EACnC,cAAc,gBAAuB;GACnC,IAAI,SAAS;GAEb,KAAK,MAAM,OAAO,MAAM;IACtB,yDAAS,OAAS;IAClB,IAAI,QAAQ,IAAI,aAAa,iBAAiB,WAAW,QACvD,QAAQ,KACN,IAAI,IAAI,0BAA0B,YAAY,uBAC/C;;GAIL,OAAO;;QAGT,cAAc,gBACX,YAAoB,kBAAkB;CAI7C,IAAI,CAAC,IAAI;EACP,IAAI,QAAQ,IAAI,aAAa,eAC3B,MAAM,IAAI,MACR,kBAAkB,aACd,8DACA,kEACL;EAEH,MAAM,IAAI,OAAO;;CAInB,MAAM,kBAAkB,mBAAmB,MAAM;CACjD,MAAM,SAAS,OAAO,OAAO,gBAAgB;CAO7C,OAAO,aAAa;CACpB,OAAO,YAAY;CACnB,OAAO,UAAU,EAAE;CACnB,OAAO,QAAQ;CACf,OAAO,KAAK,GAAG,OAAO,GAAG;CACzB,OAAO,SAAS;CAEhB,OAAO"}
+{"version":3,"file":"constructColumn.js","names":[],"sources":["../../../src/core/columns/constructColumn.ts"],"sourcesContent":["import {} from '../../utils'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  AccessorFn,\n  ColumnDef,\n  ColumnDefResolved,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\nimport type { Column_CoreProperties } from './coreColumnsFeature.types'\n\n/**\n * Creates or retrieves the column prototype for a table.\n * The prototype is cached on the table and shared by all column instances.\n */\nfunction getColumnPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._columnPrototype) {\n    table._columnPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignColumnPrototype?.(table._columnPrototype, table)\n    }\n  }\n  return table._columnPrototype\n}\n\n/**\n * Constructs a column instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnDef: ColumnDef<TFeatures, TData, TValue>,\n  depth: number,\n  parent?: Column<TFeatures, TData, TValue>,\n): Column<TFeatures, TData, TValue> {\n  const defaultColumn = table.getDefaultColumnDef()\n\n  const resolvedColumnDef = {\n    ...defaultColumn,\n    ...columnDef,\n  } as ColumnDefResolved<{}, TData, TValue>\n\n  const accessorKey = resolvedColumnDef.accessorKey\n\n  const id =\n    resolvedColumnDef.id ??\n    (accessorKey ? accessorKey.replaceAll('.', '_') : undefined) ??\n    (typeof resolvedColumnDef.header === 'string'\n      ? resolvedColumnDef.header\n      : undefined)\n\n  let accessorFn: AccessorFn<TData, TValue> | undefined\n\n  if (resolvedColumnDef.accessorFn) {\n    accessorFn = resolvedColumnDef.accessorFn\n  } else if (accessorKey) {\n    // Support deep accessor keys\n    if (accessorKey.includes('.')) {\n      const keys = accessorKey.split('.')\n      accessorFn = (originalRow: TData) => {\n        let result = originalRow as Record<string, any> | undefined\n\n        for (let i = 0; i < keys.length; i++) {\n          const key = keys[i]!\n          result = result?.[key]\n          if (process.env.NODE_ENV === 'development' && result === undefined) {\n            console.warn(\n              `\"${key}\" in deeply nested key \"${accessorKey}\" returned undefined.`,\n            )\n          }\n        }\n\n        return result as TValue\n      }\n    } else {\n      accessorFn = (originalRow: TData) =>\n        (originalRow as any)[resolvedColumnDef.accessorKey]\n    }\n  }\n\n  if (!id) {\n    if (process.env.NODE_ENV === 'development') {\n      throw new Error(\n        resolvedColumnDef.accessorFn\n          ? `coreColumnsFeature require an id when using an accessorFn`\n          : `coreColumnsFeature require an id when using a non-string header`,\n      )\n    }\n    throw new Error()\n  }\n\n  // Create column with shared prototype for memory efficiency\n  const columnPrototype = getColumnPrototype(table)\n  const column = Object.create(columnPrototype) as Column_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  column.accessorFn = accessorFn\n  column.columnDef = resolvedColumnDef as ColumnDef<TFeatures, TData, TValue>\n  column.columns = []\n  column.depth = depth\n  column.id = `${String(id)}`\n  column.parent = parent\n\n  return column as Column<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;AAgBA,SAAS,mBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,kBAAkB;EAC3B,MAAM,mBAAmB,EAAE,OAAO;EAClC,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU;EAC/C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,0CAAS,IAAI,wGAAwB,MAAM,kBAAkB,MAAM;;;CAGvE,OAAO,MAAM;;;;;;;AAQf,SAAgB,gBAKd,OACA,WACA,OACA,QACkC;CAGlC,MAAM,oBAAoB;EACxB,GAHoB,MAAM,qBAGV;EAChB,GAAG;EACJ;CAED,MAAM,cAAc,kBAAkB;CAEtC,MAAM,KACJ,kBAAkB,OACjB,cAAc,YAAY,WAAW,KAAK,IAAI,GAAG,YACjD,OAAO,kBAAkB,WAAW,WACjC,kBAAkB,SAClB;CAEN,IAAI;CAEJ,IAAI,kBAAkB,YACpB,aAAa,kBAAkB;MAC1B,IAAI,aAET,IAAI,YAAY,SAAS,IAAI,EAAE;EAC7B,MAAM,OAAO,YAAY,MAAM,IAAI;EACnC,cAAc,gBAAuB;GACnC,IAAI,SAAS;GAEb,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;IACpC,MAAM,MAAM,KAAK;IACjB,yDAAS,OAAS;IAClB,IAAI,QAAQ,IAAI,aAAa,iBAAiB,WAAW,QACvD,QAAQ,KACN,IAAI,IAAI,0BAA0B,YAAY,uBAC/C;;GAIL,OAAO;;QAGT,cAAc,gBACX,YAAoB,kBAAkB;CAI7C,IAAI,CAAC,IAAI;EACP,IAAI,QAAQ,IAAI,aAAa,eAC3B,MAAM,IAAI,MACR,kBAAkB,aACd,8DACA,kEACL;EAEH,MAAM,IAAI,OAAO;;CAInB,MAAM,kBAAkB,mBAAmB,MAAM;CACjD,MAAM,SAAS,OAAO,OAAO,gBAAgB;CAO7C,OAAO,aAAa;CACpB,OAAO,YAAY;CACnB,OAAO,UAAU,EAAE;CACnB,OAAO,QAAQ;CACf,OAAO,KAAK,GAAG,OAAO,GAAG;CACzB,OAAO,SAAS;CAEhB,OAAO"}

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>>;
   /**