@tanstack/table-core 9.0.0-alpha.8 → 9.0.0-beta.2

package/README.md

@@ -0,0 +1,127 @@
+<div align="center">
+  <img src="./media/header_table.png" alt="TanStack Table">
+</div>
+
+<br />
+
+<div align="center">
+<a href="https://npmjs.com/package/@tanstack/react-table" target="\_parent">
+  <img alt="npm downloads" src="https://img.shields.io/npm/dm/@tanstack/react-table.svg" />
+</a>
+<a href="https://github.com/tanstack/table" target="\_parent">
+  <img alt="github stars" src="https://img.shields.io/github/stars/tanstack/react-table.svg?style=social&label=Star" />
+</a>
+<a href="https://bundlephobia.com/result?p=@tanstack/react-table@latest" target="\_parent">
+  <img alt="bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/react-table@latest" />
+</a>
+</div>
+
+<div align="center">
+<a href="#badge">
+  <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
+</a>
+<a href="https://bestofjs.org/projects/tanstack-table"><img alt="Best of JS" src="https://img.shields.io/endpoint?url=https://bestofjs-serverless.now.sh/api/project-badge?fullName=TanStack%2Ftable%26since=daily" /></a>
+  <a href="https://twitter.com/tan_stack"><img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/></a>
+</div>
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+</div>
+
+# TanStack Table
+
+> [!NOTE]
+> You may know TanStack Table by the adapter names:
+>
+> - [Angular Table](https://tanstack.com/table/alpha/docs/framework/angular/angular-table)
+> - [Lit Table](https://tanstack.com/table/alpha/docs/framework/lit/lit-table)
+> - [React Table](https://tanstack.com/table/alpha/docs/framework/react/react-table)
+> - [Solid Table](https://tanstack.com/table/alpha/docs/framework/solid/solid-table)
+> - [Svelte Table](https://tanstack.com/table/alpha/docs/framework/svelte/svelte-table)
+> - [Vue Table](https://tanstack.com/table/alpha/docs/framework/vue/vue-table)
+
+A headless table library for building powerful datagrids with full control over markup, styles, and behavior.
+
+- Framework‑agnostic core with bindings for React, Vue & Solid
+- 100% customizable — bring your own UI, components, and styles
+- Sorting, filtering, grouping, aggregation & row selection
+- Lightweight, virtualizable & server‑side friendly
+
+### <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!
+- Participate in [GitHub discussions](https://github.com/TanStack/table/discussions)
+- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
+- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions
+
+## Partners
+
+<table align="center">
+  <tr>
+    <td>
+        <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS">
+			<picture>
+			  <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-CMcuvjEy.svg" height="40" />
+			  <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-DVMJ2jHi.svg" height="40" />
+			  <img src="https://tanstack.com/assets/coderabbit-light-DVMJ2jHi.svg" height="40" alt="CodeRabbit" />
+			</picture>        
+		</a>
+    </td>
+    <td padding="20">
+      <a href="https://www.cloudflare.com?utm_source=tanstack">
+         <picture>
+		  <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-DQDB7UaL.svg" height="60" />
+		  <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-CPufaW0B.svg" height="60" />
+		  <img src="https://tanstack.com/assets/cloudflare-black-CPufaW0B.svg" height="60" alt="Cloudflare" />
+		</picture>
+      </a>
+    </td>
+    <td>
+     <a href="https://ag-grid.com/react-data-grid/?utm_source=reacttable&utm_campaign=githubreacttable" style="display: flex; align-items: center; border: none;">
+       <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="./media/ag-grid-dark.svg" height="40" />
+        <source media="(prefers-color-scheme: light)" srcset="./media/ag-grid-light.svg" height="40" />
+        <img src="https://raw.githubusercontent.com/tannerlinsley/files/master/partners/ag-grid.svg" height="60" alt="AG Grid" />
+      </picture>
+      </a>
+    </td>
+  </tr>
+</table>
+
+<div align="center">
+<img src="./media/partner_logo.svg" alt="Table & you?" height="65">
+<p>
+We're looking for TanStack Table Partners to join our mission! Partner with us to push the boundaries of TanStack Table and build amazing things together.
+</p>
+<a href="mailto:partners@tanstack.com?subject=TanStack Table Partnership"><b>LET'S CHAT</b></a>
+</div>
+
+## Explore the TanStack Ecosystem
+
+- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
+- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
+- <a href="https://github.com/tanstack/devtools"><b>TanStack DevTools</b></a> – Unified devtools panel
+- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
+- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching <br/>
+- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
+- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
+- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
+- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
+- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
+- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering
+
+… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>
+
+<!-- USE THE FORCE LUKE -->

package/dist/core/cells/constructCell.cjs

@@ -0,0 +1,34 @@
+
+//#region src/core/cells/constructCell.ts
+/**
+* Creates or retrieves the cell prototype for a table.
+* The prototype is cached on the table and shared by all cell instances.
+*/
+function getCellPrototype(table) {
+	if (!table._cellPrototype) {
+		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;
+}
+/**
+* Constructs a cell instance from normalized table internals.
+*
+* This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+*/
+function constructCell(column, row, table) {
+	const cellPrototype = getCellPrototype(table);
+	const cell = Object.create(cellPrototype);
+	cell.column = column;
+	cell.id = `${row.id}_${column.id}`;
+	cell.row = row;
+	return cell;
+}
+
+//#endregion
+exports.constructCell = constructCell;
+//# sourceMappingURL=constructCell.cjs.map

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

@@ -0,0 +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    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,MAAM;EAC/B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;EAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,yCAAS,IAAI,oGAAsB,MAAM,gBAAgB,KAAK;EAChE;CACF;CACA,OAAO,MAAM;AACf;;;;;;AAOA,SAAgB,cAKd,QACA,KACA,OACgC;CAEhC,MAAM,gBAAgB,iBAAiB,KAAK;CAC5C,MAAM,OAAO,OAAO,OAAO,aAAa;CAOxC,KAAK,SAAS;CACd,KAAK,KAAK,GAAG,IAAI,GAAG,GAAG,OAAO;CAC9B,KAAK,MAAM;CAEX,OAAO;AACT"}

package/dist/core/cells/constructCell.d.cts

@@ -0,0 +1,17 @@
+import { CellData, RowData } from "../../types/type-utils.cjs";
+import { Column } from "../../types/Column.cjs";
+import { Row } from "../../types/Row.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { Cell } from "../../types/Cell.cjs";
+
+//#region src/core/cells/constructCell.d.ts
+/**
+ * Constructs a cell instance from normalized table internals.
+ *
+ * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+ */
+declare function constructCell<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>, row: Row<TFeatures, TData>, table: Table_Internal<TFeatures, TData>): Cell<TFeatures, TData, TValue>;
+//#endregion
+export { constructCell };
+//# sourceMappingURL=constructCell.d.cts.map

package/dist/core/cells/constructCell.d.ts

@@ -0,0 +1,17 @@
+import { CellData, RowData } from "../../types/type-utils.js";
+import { Column } from "../../types/Column.js";
+import { Row } from "../../types/Row.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Table_Internal } from "../../types/Table.js";
+import { Cell } from "../../types/Cell.js";
+
+//#region src/core/cells/constructCell.d.ts
+/**
+ * Constructs a cell instance from normalized table internals.
+ *
+ * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+ */
+declare function constructCell<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>, row: Row<TFeatures, TData>, table: Table_Internal<TFeatures, TData>): Cell<TFeatures, TData, TValue>;
+//#endregion
+export { constructCell };
+//# sourceMappingURL=constructCell.d.ts.map

package/dist/core/cells/constructCell.js

@@ -0,0 +1,33 @@
+//#region src/core/cells/constructCell.ts
+/**
+* Creates or retrieves the cell prototype for a table.
+* The prototype is cached on the table and shared by all cell instances.
+*/
+function getCellPrototype(table) {
+	if (!table._cellPrototype) {
+		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;
+}
+/**
+* Constructs a cell instance from normalized table internals.
+*
+* This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+*/
+function constructCell(column, row, table) {
+	const cellPrototype = getCellPrototype(table);
+	const cell = Object.create(cellPrototype);
+	cell.column = column;
+	cell.id = `${row.id}_${column.id}`;
+	cell.row = row;
+	return cell;
+}
+
+//#endregion
+export { constructCell };
+//# sourceMappingURL=constructCell.js.map

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

@@ -0,0 +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    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,MAAM;EAC/B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;EAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,yCAAS,IAAI,oGAAsB,MAAM,gBAAgB,KAAK;EAChE;CACF;CACA,OAAO,MAAM;AACf;;;;;;AAOA,SAAgB,cAKd,QACA,KACA,OACgC;CAEhC,MAAM,gBAAgB,iBAAiB,KAAK;CAC5C,MAAM,OAAO,OAAO,OAAO,aAAa;CAOxC,KAAK,SAAS;CACd,KAAK,KAAK,GAAG,IAAI,GAAG,GAAG,OAAO;CAC9B,KAAK,MAAM;CAEX,OAAO;AACT"}

package/dist/core/cells/coreCellsFeature.cjs

@@ -0,0 +1,30 @@
+const require_utils = require('../../utils.cjs');
+const require_coreCellsFeature_utils = require('./coreCellsFeature.utils.cjs');
+
+//#region src/core/cells/coreCellsFeature.ts
+/**
+* Creates the stock core cells feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
+function constructCoreCellsFeature() {
+	return { assignCellPrototype: (prototype, table) => {
+		require_utils.assignPrototypeAPIs("coreCellsFeature", prototype, table, {
+			cell_getValue: { fn: (cell) => require_coreCellsFeature_utils.cell_getValue(cell) },
+			cell_renderValue: { fn: (cell) => require_coreCellsFeature_utils.cell_renderValue(cell) },
+			cell_getContext: {
+				fn: (cell) => require_coreCellsFeature_utils.cell_getContext(cell),
+				memoDeps: (cell) => [cell]
+			}
+		});
+	} };
+}
+/**
+* The Core Cells feature provides the core cell functionality.
+*/
+const coreCellsFeature = constructCoreCellsFeature();
+
+//#endregion
+exports.constructCoreCellsFeature = constructCoreCellsFeature;
+exports.coreCellsFeature = coreCellsFeature;
+//# sourceMappingURL=coreCellsFeature.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreCellsFeature.cjs","names":["cell_getValue","cell_renderValue","cell_getContext"],"sources":["../../../src/core/cells/coreCellsFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs } from '../../utils'\nimport {\n  cell_getContext,\n  cell_getValue,\n  cell_renderValue,\n} from './coreCellsFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type { Cell_Cell, TableOptions_Cell } from './coreCellsFeature.types'\n\nexport interface CoreCellsFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Cell: Cell_Cell<TableFeatures, RowData>\n  // TableOptions: TableOptions_Cell\n}\n\n/**\n * Creates the stock core cells feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructCoreCellsFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<CoreCellsFeatureConstructors<TFeatures, TData>> {\n  return {\n    assignCellPrototype: (prototype, table) => {\n      assignPrototypeAPIs('coreCellsFeature', prototype, table, {\n        cell_getValue: {\n          fn: (cell) => cell_getValue(cell),\n        },\n        cell_renderValue: {\n          fn: (cell) => cell_renderValue(cell),\n        },\n        cell_getContext: {\n          fn: (cell) => cell_getContext(cell),\n          memoDeps: (cell) => [cell],\n        },\n      })\n    },\n  }\n}\n\n/**\n * The Core Cells feature provides the core cell functionality.\n */\nexport const coreCellsFeature = constructCoreCellsFeature()\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,4BAGkD;CAChE,OAAO,EACL,sBAAsB,WAAW,UAAU;EACzC,kCAAoB,oBAAoB,WAAW,OAAO;GACxD,eAAe,EACb,KAAK,SAASA,6CAAc,IAAI,EAClC;GACA,kBAAkB,EAChB,KAAK,SAASC,gDAAiB,IAAI,EACrC;GACA,iBAAiB;IACf,KAAK,SAASC,+CAAgB,IAAI;IAClC,WAAW,SAAS,CAAC,IAAI;GAC3B;EACF,CAAC;CACH,EACF;AACF;;;;AAKA,MAAa,mBAAmB,0BAA0B"}

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

@@ -0,0 +1,18 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/core/cells/coreCellsFeature.d.ts
+interface CoreCellsFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock core cells feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
+declare function constructCoreCellsFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<CoreCellsFeatureConstructors<TFeatures, TData>>;
+/**
+ * The Core Cells feature provides the core cell functionality.
+ */
+declare const coreCellsFeature: TableFeature<CoreCellsFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { CoreCellsFeatureConstructors, constructCoreCellsFeature, coreCellsFeature };
+//# sourceMappingURL=coreCellsFeature.d.cts.map

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

@@ -0,0 +1,18 @@
+import { RowData } from "../../types/type-utils.js";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/core/cells/coreCellsFeature.d.ts
+interface CoreCellsFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock core cells feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
+declare function constructCoreCellsFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<CoreCellsFeatureConstructors<TFeatures, TData>>;
+/**
+ * The Core Cells feature provides the core cell functionality.
+ */
+declare const coreCellsFeature: TableFeature<CoreCellsFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { CoreCellsFeatureConstructors, constructCoreCellsFeature, coreCellsFeature };
+//# sourceMappingURL=coreCellsFeature.d.ts.map

package/dist/core/cells/coreCellsFeature.js

@@ -0,0 +1,29 @@
+import { assignPrototypeAPIs } from "../../utils.js";
+import { cell_getContext, cell_getValue, cell_renderValue } from "./coreCellsFeature.utils.js";
+
+//#region src/core/cells/coreCellsFeature.ts
+/**
+* Creates the stock core cells feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
+function constructCoreCellsFeature() {
+	return { assignCellPrototype: (prototype, table) => {
+		assignPrototypeAPIs("coreCellsFeature", prototype, table, {
+			cell_getValue: { fn: (cell) => cell_getValue(cell) },
+			cell_renderValue: { fn: (cell) => cell_renderValue(cell) },
+			cell_getContext: {
+				fn: (cell) => cell_getContext(cell),
+				memoDeps: (cell) => [cell]
+			}
+		});
+	} };
+}
+/**
+* The Core Cells feature provides the core cell functionality.
+*/
+const coreCellsFeature = constructCoreCellsFeature();
+
+//#endregion
+export { constructCoreCellsFeature, coreCellsFeature };
+//# sourceMappingURL=coreCellsFeature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreCellsFeature.js","names":[],"sources":["../../../src/core/cells/coreCellsFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs } from '../../utils'\nimport {\n  cell_getContext,\n  cell_getValue,\n  cell_renderValue,\n} from './coreCellsFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type { Cell_Cell, TableOptions_Cell } from './coreCellsFeature.types'\n\nexport interface CoreCellsFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Cell: Cell_Cell<TableFeatures, RowData>\n  // TableOptions: TableOptions_Cell\n}\n\n/**\n * Creates the stock core cells feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructCoreCellsFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<CoreCellsFeatureConstructors<TFeatures, TData>> {\n  return {\n    assignCellPrototype: (prototype, table) => {\n      assignPrototypeAPIs('coreCellsFeature', prototype, table, {\n        cell_getValue: {\n          fn: (cell) => cell_getValue(cell),\n        },\n        cell_renderValue: {\n          fn: (cell) => cell_renderValue(cell),\n        },\n        cell_getContext: {\n          fn: (cell) => cell_getContext(cell),\n          memoDeps: (cell) => [cell],\n        },\n      })\n    },\n  }\n}\n\n/**\n * The Core Cells feature provides the core cell functionality.\n */\nexport const coreCellsFeature = constructCoreCellsFeature()\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,4BAGkD;CAChE,OAAO,EACL,sBAAsB,WAAW,UAAU;EACzC,oBAAoB,oBAAoB,WAAW,OAAO;GACxD,eAAe,EACb,KAAK,SAAS,cAAc,IAAI,EAClC;GACA,kBAAkB,EAChB,KAAK,SAAS,iBAAiB,IAAI,EACrC;GACA,iBAAiB;IACf,KAAK,SAAS,gBAAgB,IAAI;IAClC,WAAW,SAAS,CAAC,IAAI;GAC3B;EACF,CAAC;CACH,EACF;AACF;;;;AAKA,MAAa,mBAAmB,0BAA0B"}

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

@@ -0,0 +1,57 @@
+import { CellData, Getter, RowData } from "../../types/type-utils.cjs";
+import { Column } from "../../types/Column.cjs";
+import { Row } from "../../types/Row.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Table, Table_Internal } from "../../types/Table.cjs";
+import { Cell } from "../../types/Cell.cjs";
+
+//#region src/core/cells/coreCellsFeature.types.d.ts
+interface CellContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  cell: Cell<TFeatures, TData, TValue>;
+  column: Column<TFeatures, TData, TValue>;
+  getValue: Getter<TValue>;
+  renderValue: Getter<TValue | null>;
+  row: Row<TFeatures, TData>;
+  table: Table<TFeatures, TData>;
+}
+interface Cell_CoreProperties<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  /**
+   * The associated Column object for the cell.
+   */
+  column: Column<TFeatures, TData, TValue>;
+  /**
+   * The unique ID for the cell across the entire table.
+   */
+  id: string;
+  /**
+   * The associated Row object for the cell.
+   */
+  row: Row<TFeatures, TData>;
+  /**
+   * Reference to the parent table instance.
+   */
+  table: Table_Internal<TFeatures, TData>;
+}
+interface Cell_Cell<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> extends Cell_CoreProperties<TFeatures, TData, TValue> {
+  /**
+   * Returns the rendering context (or props) for cell-based components like cells and aggregated cells. Use these props with your framework's `flexRender` utility to render these using the template of your choice:
+   */
+  getContext: () => CellContext<TFeatures, TData, TValue>;
+  /**
+   * Returns the value for the cell, accessed via the associated column's accessor key or accessor function.
+   */
+  getValue: CellContext<TFeatures, TData, TValue>['getValue'];
+  /**
+   * Renders the value for a cell the same as `getValue`, but will return the `renderFallbackValue` if no value is found.
+   */
+  renderValue: CellContext<TFeatures, TData, TValue>['renderValue'];
+}
+interface TableOptions_Cell {
+  /**
+   * Value used when the desired value is not found in the data.
+   */
+  renderFallbackValue?: any;
+}
+//#endregion
+export { CellContext, Cell_Cell, Cell_CoreProperties, TableOptions_Cell };
+//# sourceMappingURL=coreCellsFeature.types.d.cts.map

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

@@ -0,0 +1,57 @@
+import { CellData, Getter, RowData } from "../../types/type-utils.js";
+import { Column } from "../../types/Column.js";
+import { Row } from "../../types/Row.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Table, Table_Internal } from "../../types/Table.js";
+import { Cell } from "../../types/Cell.js";
+
+//#region src/core/cells/coreCellsFeature.types.d.ts
+interface CellContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  cell: Cell<TFeatures, TData, TValue>;
+  column: Column<TFeatures, TData, TValue>;
+  getValue: Getter<TValue>;
+  renderValue: Getter<TValue | null>;
+  row: Row<TFeatures, TData>;
+  table: Table<TFeatures, TData>;
+}
+interface Cell_CoreProperties<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  /**
+   * The associated Column object for the cell.
+   */
+  column: Column<TFeatures, TData, TValue>;
+  /**
+   * The unique ID for the cell across the entire table.
+   */
+  id: string;
+  /**
+   * The associated Row object for the cell.
+   */
+  row: Row<TFeatures, TData>;
+  /**
+   * Reference to the parent table instance.
+   */
+  table: Table_Internal<TFeatures, TData>;
+}
+interface Cell_Cell<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> extends Cell_CoreProperties<TFeatures, TData, TValue> {
+  /**
+   * Returns the rendering context (or props) for cell-based components like cells and aggregated cells. Use these props with your framework's `flexRender` utility to render these using the template of your choice:
+   */
+  getContext: () => CellContext<TFeatures, TData, TValue>;
+  /**
+   * Returns the value for the cell, accessed via the associated column's accessor key or accessor function.
+   */
+  getValue: CellContext<TFeatures, TData, TValue>['getValue'];
+  /**
+   * Renders the value for a cell the same as `getValue`, but will return the `renderFallbackValue` if no value is found.
+   */
+  renderValue: CellContext<TFeatures, TData, TValue>['renderValue'];
+}
+interface TableOptions_Cell {
+  /**
+   * Value used when the desired value is not found in the data.
+   */
+  renderFallbackValue?: any;
+}
+//#endregion
+export { CellContext, Cell_Cell, Cell_CoreProperties, TableOptions_Cell };
+//# sourceMappingURL=coreCellsFeature.types.d.ts.map

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

@@ -0,0 +1,57 @@
+
+//#region src/core/cells/coreCellsFeature.utils.ts
+/**
+* Reads this cell's accessor value from its owning row and column.
+*
+* This is the standalone implementation behind `cell.getValue()`, useful when
+* importing static APIs instead of calling methods from the cell prototype.
+*
+* @example
+* ```ts
+* const value = cell_getValue(cell)
+* ```
+*/
+function cell_getValue(cell) {
+	return cell.row.getValue(cell.column.id);
+}
+/**
+* Reads the value that should be rendered for this cell.
+*
+* Nullish accessor values are replaced with `table.options.renderFallbackValue`,
+* matching the behavior of `cell.renderValue()`.
+*
+* @example
+* ```ts
+* const rendered = cell_renderValue(cell)
+* ```
+*/
+function cell_renderValue(cell) {
+	return cell.getValue() ?? cell.table.options.renderFallbackValue;
+}
+/**
+* Builds the render context passed to a column's `cell` template.
+*
+* 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 context = cell_getContext(cell)
+* ```
+*/
+function cell_getContext(cell) {
+	return {
+		table: cell.table,
+		column: cell.column,
+		row: cell.row,
+		cell,
+		getValue: () => cell.getValue(),
+		renderValue: () => cell.renderValue()
+	};
+}
+
+//#endregion
+exports.cell_getContext = cell_getContext;
+exports.cell_getValue = cell_getValue;
+exports.cell_renderValue = cell_renderValue;
+//# sourceMappingURL=coreCellsFeature.utils.cjs.map

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

@@ -0,0 +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 * 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,EAAE;AACzC;;;;;;;;;;;;AAaA,SAAgB,iBAId,MAAsC;CACtC,OAAO,KAAK,SAAS,KAAK,KAAK,MAAM,QAAQ;AAC/C;;;;;;;;;;;;AAaA,SAAgB,gBAId,MAAsC;CACtC,OAAO;EACL,OAAO,KAAK;EACZ,QAAQ,KAAK;EACb,KAAK,KAAK;EACJ;EAEN,gBAAgB,KAAK,SAAS;EAC9B,mBAAmB,KAAK,YAAY;CACtC;AACF"}

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

@@ -0,0 +1,53 @@
+import { CellData, NoInfer, RowData } from "../../types/type-utils.cjs";
+import { Column } from "../../types/Column.cjs";
+import { Row } from "../../types/Row.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { Cell } from "../../types/Cell.cjs";
+//#region src/core/cells/coreCellsFeature.utils.d.ts
+/**
+ * Reads this cell's accessor value from its owning row and column.
+ *
+ * This is the standalone implementation behind `cell.getValue()`, useful when
+ * importing static APIs instead of calling methods from the cell prototype.
+ *
+ * @example
+ * ```ts
+ * const value = cell_getValue(cell)
+ * ```
+ */
+declare function cell_getValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(cell: Cell<TFeatures, TData, TValue>): TValue;
+/**
+ * Reads the value that should be rendered for this cell.
+ *
+ * Nullish accessor values are replaced with `table.options.renderFallbackValue`,
+ * matching the behavior of `cell.renderValue()`.
+ *
+ * @example
+ * ```ts
+ * 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;
+/**
+ * Builds the render context passed to a column's `cell` template.
+ *
+ * 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 context = cell_getContext(cell)
+ * ```
+ */
+declare function cell_getContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(cell: Cell<TFeatures, TData, TValue>): {
+  table: Table_Internal<TFeatures, TData>;
+  column: Column<TFeatures, TData, TValue>;
+  row: Row<TFeatures, TData>;
+  cell: Cell<TFeatures, TData, TValue>;
+  getValue: () => NoInfer<TValue>;
+  renderValue: () => NoInfer<TValue | null>;
+};
+//#endregion
+export { cell_getContext, cell_getValue, cell_renderValue };
+//# sourceMappingURL=coreCellsFeature.utils.d.cts.map