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

package/dist/core/rows/coreRowsFeature.utils.d.cts

@@ -5,15 +5,116 @@ import { Table_Internal } from "../../types/Table.cjs";
 import { Cell } from "../../types/Cell.cjs";
 
 //#region src/core/rows/coreRowsFeature.utils.d.ts
+/**
+ * Returns value for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getValue(row)
+ * ```
+ */
 declare function row_getValue<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): unknown;
+/**
+ * Returns unique values for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getUniqueValues(row)
+ * ```
+ */
 declare function row_getUniqueValues<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): unknown;
+/**
+ * Returns a renderable row value for a column.
+ *
+ * If the accessor value is nullish, the table's `renderFallbackValue` is used
+ * instead.
+ *
+ * @example
+ * ```ts
+ * const value = row_renderValue(row)
+ * ```
+ */
 declare function row_renderValue<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): any;
+/**
+ * Returns leaf rows for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getLeafRows(row)
+ * ```
+ */
 declare function row_getLeafRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Array<Row<TFeatures, TData>>;
+/**
+ * Returns parent row for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getParentRow(row)
+ * ```
+ */
 declare function row_getParentRow<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Row<TFeatures, TData> | undefined;
+/**
+ * Returns parent rows for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getParentRows(row)
+ * ```
+ */
 declare function row_getParentRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Row<TFeatures, TData>[];
+/**
+ * Returns all cells for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getAllCells(row)
+ * ```
+ */
 declare function row_getAllCells<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Array<Cell<TFeatures, TData, unknown>>;
+/**
+ * Returns all cells by column id for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getAllCellsByColumnId(row)
+ * ```
+ */
 declare function row_getAllCellsByColumnId<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Record<string, Cell<TFeatures, TData, unknown>>;
+/**
+ * Returns row id for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getRowId(table)
+ * ```
+ */
 declare function table_getRowId<TFeatures extends TableFeatures, TData extends RowData>(originalRow: TData, table: Table_Internal<TFeatures, TData>, index: number, parent?: Row<TFeatures, TData>): string;
+/**
+ * Returns row for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getRow(table)
+ * ```
+ */
 declare function table_getRow<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, rowId: string, searchAll?: boolean): Row<TFeatures, TData>;
 //#endregion
 export { row_getAllCells, row_getAllCellsByColumnId, row_getLeafRows, row_getParentRow, row_getParentRows, row_getUniqueValues, row_getValue, row_renderValue, table_getRow, table_getRowId };

package/dist/core/rows/coreRowsFeature.utils.d.ts

@@ -5,15 +5,116 @@ import { Table_Internal } from "../../types/Table.js";
 import { Cell } from "../../types/Cell.js";
 
 //#region src/core/rows/coreRowsFeature.utils.d.ts
+/**
+ * Returns value for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getValue(row)
+ * ```
+ */
 declare function row_getValue<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): unknown;
+/**
+ * Returns unique values for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getUniqueValues(row)
+ * ```
+ */
 declare function row_getUniqueValues<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): unknown;
+/**
+ * Returns a renderable row value for a column.
+ *
+ * If the accessor value is nullish, the table's `renderFallbackValue` is used
+ * instead.
+ *
+ * @example
+ * ```ts
+ * const value = row_renderValue(row)
+ * ```
+ */
 declare function row_renderValue<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): any;
+/**
+ * Returns leaf rows for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getLeafRows(row)
+ * ```
+ */
 declare function row_getLeafRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Array<Row<TFeatures, TData>>;
+/**
+ * Returns parent row for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getParentRow(row)
+ * ```
+ */
 declare function row_getParentRow<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Row<TFeatures, TData> | undefined;
+/**
+ * Returns parent rows for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getParentRows(row)
+ * ```
+ */
 declare function row_getParentRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Row<TFeatures, TData>[];
+/**
+ * Returns all cells for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getAllCells(row)
+ * ```
+ */
 declare function row_getAllCells<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Array<Cell<TFeatures, TData, unknown>>;
+/**
+ * Returns all cells by column id for a row.
+ *
+ * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+ *
+ * @example
+ * ```ts
+ * const value = row_getAllCellsByColumnId(row)
+ * ```
+ */
 declare function row_getAllCellsByColumnId<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Record<string, Cell<TFeatures, TData, unknown>>;
+/**
+ * Returns row id for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getRowId(table)
+ * ```
+ */
 declare function table_getRowId<TFeatures extends TableFeatures, TData extends RowData>(originalRow: TData, table: Table_Internal<TFeatures, TData>, index: number, parent?: Row<TFeatures, TData>): string;
+/**
+ * Returns row for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getRow(table)
+ * ```
+ */
 declare function table_getRow<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, rowId: string, searchAll?: boolean): Row<TFeatures, TData>;
 //#endregion
 export { row_getAllCells, row_getAllCellsByColumnId, row_getLeafRows, row_getParentRow, row_getParentRows, row_getUniqueValues, row_getValue, row_renderValue, table_getRow, table_getRowId };

package/dist/core/rows/coreRowsFeature.utils.js

@@ -2,6 +2,16 @@ import { flattenBy } from "../../utils.js";
 import { constructCell } from "../cells/constructCell.js";
 
 //#region src/core/rows/coreRowsFeature.utils.ts
+/**
+* Returns value for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getValue(row)
+* ```
+*/
 function row_getValue(row, columnId) {
 	if (row._valuesCache.hasOwnProperty(columnId)) return row._valuesCache[columnId];
 	const column = row.table.getColumn(columnId);
@@ -9,6 +19,16 @@ function row_getValue(row, columnId) {
 	row._valuesCache[columnId] = column.accessorFn(row.original, row.index);
 	return row._valuesCache[columnId];
 }
+/**
+* Returns unique values for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getUniqueValues(row)
+* ```
+*/
 function row_getUniqueValues(row, columnId) {
 	if (row._uniqueValuesCache.hasOwnProperty(columnId)) return row._uniqueValuesCache[columnId];
 	const column = row.table.getColumn(columnId);
@@ -20,15 +40,56 @@ function row_getUniqueValues(row, columnId) {
 	row._uniqueValuesCache[columnId] = column.columnDef.getUniqueValues(row.original, row.index);
 	return row._uniqueValuesCache[columnId];
 }
+/**
+* Returns a renderable row value for a column.
+*
+* If the accessor value is nullish, the table's `renderFallbackValue` is used
+* instead.
+*
+* @example
+* ```ts
+* const value = row_renderValue(row)
+* ```
+*/
 function row_renderValue(row, columnId) {
 	return row.getValue(columnId) ?? row.table.options.renderFallbackValue;
 }
+/**
+* Returns leaf rows for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getLeafRows(row)
+* ```
+*/
 function row_getLeafRows(row) {
 	return flattenBy(row.subRows, (d) => d.subRows);
 }
+/**
+* Returns parent row for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getParentRow(row)
+* ```
+*/
 function row_getParentRow(row) {
 	return row.parentId ? row.table.getRow(row.parentId, true) : void 0;
 }
+/**
+* Returns parent rows for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getParentRows(row)
+* ```
+*/
 function row_getParentRows(row) {
 	const parentRows = [];
 	let currentRow = row;
@@ -40,21 +101,60 @@ function row_getParentRows(row) {
 	}
 	return parentRows.reverse();
 }
+/**
+* Returns all cells for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getAllCells(row)
+* ```
+*/
 function row_getAllCells(row) {
 	return row.table.getAllLeafColumns().map((column) => {
 		return constructCell(column, row, row.table);
 	});
 }
+/**
+* Returns all cells by column id for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getAllCellsByColumnId(row)
+* ```
+*/
 function row_getAllCellsByColumnId(row) {
-	return row.getAllCells().reduce((acc, cell) => {
-		acc[cell.column.id] = cell;
-		return acc;
-	}, {});
+	const result = {};
+	for (const cell of row.getAllCells()) result[cell.column.id] = cell;
+	return result;
 }
+/**
+* Returns row id for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getRowId(table)
+* ```
+*/
 function table_getRowId(originalRow, table, index, parent) {
 	var _table$options$getRow, _table$options;
 	return ((_table$options$getRow = (_table$options = table.options).getRowId) === null || _table$options$getRow === void 0 ? void 0 : _table$options$getRow.call(_table$options, originalRow, index, parent)) ?? `${parent ? [parent.id, index].join(".") : index}`;
 }
+/**
+* Returns row for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getRow(table)
+* ```
+*/
 function table_getRow(table, rowId, searchAll) {
 	let row = (searchAll ? table.getPrePaginatedRowModel() : table.getRowModel()).rowsById[rowId];
 	if (!row) {

package/dist/core/rows/coreRowsFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreRowsFeature.utils.js","names":[],"sources":["../../../src/core/rows/coreRowsFeature.utils.ts"],"sourcesContent":["import { flattenBy } from '../../utils'\nimport { constructCell } from '../cells/constructCell'\nimport type { Table_Internal } from '../../types/Table'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\n\nexport function row_getValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  if (row._valuesCache.hasOwnProperty(columnId)) {\n    return row._valuesCache[columnId]\n  }\n\n  const column = row.table.getColumn(columnId)\n\n  if (!column?.accessorFn) {\n    return undefined\n  }\n\n  row._valuesCache[columnId] = column.accessorFn(row.original, row.index)\n\n  return row._valuesCache[columnId]\n}\n\nexport function row_getUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  if (row._uniqueValuesCache.hasOwnProperty(columnId)) {\n    return row._uniqueValuesCache[columnId]\n  }\n\n  const column = row.table.getColumn(columnId)\n\n  if (!column?.accessorFn) {\n    return undefined\n  }\n\n  if (!column.columnDef.getUniqueValues) {\n    row._uniqueValuesCache[columnId] = [row.getValue(columnId)]\n    return row._uniqueValuesCache[columnId]\n  }\n\n  row._uniqueValuesCache[columnId] = column.columnDef.getUniqueValues(\n    row.original,\n    row.index,\n  )\n\n  return row._uniqueValuesCache[columnId]\n}\n\nexport function row_renderValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  return row.getValue(columnId) ?? row.table.options.renderFallbackValue\n}\n\nexport function row_getLeafRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): Array<Row<TFeatures, TData>> {\n  return flattenBy(row.subRows, (d) => d.subRows)\n}\n\nexport function row_getParentRow<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return row.parentId ? row.table.getRow(row.parentId, true) : undefined\n}\n\nexport function row_getParentRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const parentRows: Array<Row<TFeatures, TData>> = []\n  let currentRow = row\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  while (true) {\n    const parentRow = currentRow.getParentRow()\n    if (!parentRow) break\n    parentRows.push(parentRow)\n    currentRow = parentRow\n  }\n  return parentRows.reverse()\n}\n\nexport function row_getAllCells<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): Array<Cell<TFeatures, TData, unknown>> {\n  return row.table.getAllLeafColumns().map((column) => {\n    return constructCell(column, row, row.table)\n  })\n}\n\nexport function row_getAllCellsByColumnId<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return row.getAllCells().reduce(\n    (acc, cell) => {\n      acc[cell.column.id] = cell\n      return acc\n    },\n    {} as Record<string, Cell<TFeatures, TData, unknown>>,\n  )\n}\n\nexport function table_getRowId<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  originalRow: TData,\n  table: Table_Internal<TFeatures, TData>,\n  index: number,\n  parent?: Row<TFeatures, TData>,\n) {\n  return (\n    table.options.getRowId?.(originalRow, index, parent) ??\n    `${parent ? [parent.id, index].join('.') : index}`\n  )\n}\n\nexport function table_getRow<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  rowId: string,\n  searchAll?: boolean,\n): Row<TFeatures, TData> {\n  // TODO - simplify this across different row models\n  let row = (searchAll ? table.getPrePaginatedRowModel() : table.getRowModel())\n    .rowsById[rowId]\n\n  if (!row) {\n    row = table.getCoreRowModel().rowsById[rowId]\n    if (!row) {\n      if (process.env.NODE_ENV === 'development') {\n        throw new Error(`getRow could not find row with ID: ${rowId}`)\n      }\n      throw new Error()\n    }\n  }\n\n  return row\n}\n"],"mappings":";;;;AAQA,SAAgB,aAGd,KAA4B,UAAkB;AAC9C,KAAI,IAAI,aAAa,eAAe,SAAS,CAC3C,QAAO,IAAI,aAAa;CAG1B,MAAM,SAAS,IAAI,MAAM,UAAU,SAAS;AAE5C,KAAI,kDAAC,OAAQ,YACX;AAGF,KAAI,aAAa,YAAY,OAAO,WAAW,IAAI,UAAU,IAAI,MAAM;AAEvE,QAAO,IAAI,aAAa;;AAG1B,SAAgB,oBAGd,KAA4B,UAAkB;AAC9C,KAAI,IAAI,mBAAmB,eAAe,SAAS,CACjD,QAAO,IAAI,mBAAmB;CAGhC,MAAM,SAAS,IAAI,MAAM,UAAU,SAAS;AAE5C,KAAI,kDAAC,OAAQ,YACX;AAGF,KAAI,CAAC,OAAO,UAAU,iBAAiB;AACrC,MAAI,mBAAmB,YAAY,CAAC,IAAI,SAAS,SAAS,CAAC;AAC3D,SAAO,IAAI,mBAAmB;;AAGhC,KAAI,mBAAmB,YAAY,OAAO,UAAU,gBAClD,IAAI,UACJ,IAAI,MACL;AAED,QAAO,IAAI,mBAAmB;;AAGhC,SAAgB,gBAGd,KAA4B,UAAkB;AAC9C,QAAO,IAAI,SAAS,SAAS,IAAI,IAAI,MAAM,QAAQ;;AAGrD,SAAgB,gBAGd,KAA0D;AAC1D,QAAO,UAAU,IAAI,UAAU,MAAM,EAAE,QAAQ;;AAGjD,SAAgB,iBAGd,KAA4B;AAC5B,QAAO,IAAI,WAAW,IAAI,MAAM,OAAO,IAAI,UAAU,KAAK,GAAG;;AAG/D,SAAgB,kBAGd,KAA4B;CAC5B,MAAM,aAA2C,EAAE;CACnD,IAAI,aAAa;AAEjB,QAAO,MAAM;EACX,MAAM,YAAY,WAAW,cAAc;AAC3C,MAAI,CAAC,UAAW;AAChB,aAAW,KAAK,UAAU;AAC1B,eAAa;;AAEf,QAAO,WAAW,SAAS;;AAG7B,SAAgB,gBAGd,KAAoE;AACpE,QAAO,IAAI,MAAM,mBAAmB,CAAC,KAAK,WAAW;AACnD,SAAO,cAAc,QAAQ,KAAK,IAAI,MAAM;GAC5C;;AAGJ,SAAgB,0BAGd,KAA4B;AAC5B,QAAO,IAAI,aAAa,CAAC,QACtB,KAAK,SAAS;AACb,MAAI,KAAK,OAAO,MAAM;AACtB,SAAO;IAET,EAAE,CACH;;AAGH,SAAgB,eAId,aACA,OACA,OACA,QACA;;AACA,oDACE,MAAM,SAAQ,6GAAW,aAAa,OAAO,OAAO,KACpD,GAAG,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,GAAG;;AAI/C,SAAgB,aAId,OACA,OACA,WACuB;CAEvB,IAAI,OAAO,YAAY,MAAM,yBAAyB,GAAG,MAAM,aAAa,EACzE,SAAS;AAEZ,KAAI,CAAC,KAAK;AACR,QAAM,MAAM,iBAAiB,CAAC,SAAS;AACvC,MAAI,CAAC,KAAK;AACR,OAAI,QAAQ,IAAI,aAAa,cAC3B,OAAM,IAAI,MAAM,sCAAsC,QAAQ;AAEhE,SAAM,IAAI,OAAO;;;AAIrB,QAAO"}
+{"version":3,"file":"coreRowsFeature.utils.js","names":[],"sources":["../../../src/core/rows/coreRowsFeature.utils.ts"],"sourcesContent":["import { flattenBy } from '../../utils'\nimport { constructCell } from '../cells/constructCell'\nimport type { Table_Internal } from '../../types/Table'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\n\n/**\n * Returns value for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getValue(row)\n * ```\n */\nexport function row_getValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  if (row._valuesCache.hasOwnProperty(columnId)) {\n    return row._valuesCache[columnId]\n  }\n\n  const column = row.table.getColumn(columnId)\n\n  if (!column?.accessorFn) {\n    return undefined\n  }\n\n  row._valuesCache[columnId] = column.accessorFn(row.original, row.index)\n\n  return row._valuesCache[columnId]\n}\n\n/**\n * Returns unique values for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getUniqueValues(row)\n * ```\n */\nexport function row_getUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  if (row._uniqueValuesCache.hasOwnProperty(columnId)) {\n    return row._uniqueValuesCache[columnId]\n  }\n\n  const column = row.table.getColumn(columnId)\n\n  if (!column?.accessorFn) {\n    return undefined\n  }\n\n  if (!column.columnDef.getUniqueValues) {\n    row._uniqueValuesCache[columnId] = [row.getValue(columnId)]\n    return row._uniqueValuesCache[columnId]\n  }\n\n  row._uniqueValuesCache[columnId] = column.columnDef.getUniqueValues(\n    row.original,\n    row.index,\n  )\n\n  return row._uniqueValuesCache[columnId]\n}\n\n/**\n * Returns a renderable row value for a column.\n *\n * If the accessor value is nullish, the table's `renderFallbackValue` is used\n * instead.\n *\n * @example\n * ```ts\n * const value = row_renderValue(row)\n * ```\n */\nexport function row_renderValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  return row.getValue(columnId) ?? row.table.options.renderFallbackValue\n}\n\n/**\n * Returns leaf rows for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getLeafRows(row)\n * ```\n */\nexport function row_getLeafRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): Array<Row<TFeatures, TData>> {\n  return flattenBy(row.subRows, (d) => d.subRows)\n}\n\n/**\n * Returns parent row for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getParentRow(row)\n * ```\n */\nexport function row_getParentRow<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return row.parentId ? row.table.getRow(row.parentId, true) : undefined\n}\n\n/**\n * Returns parent rows for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getParentRows(row)\n * ```\n */\nexport function row_getParentRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const parentRows: Array<Row<TFeatures, TData>> = []\n  let currentRow = row\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  while (true) {\n    const parentRow = currentRow.getParentRow()\n    if (!parentRow) break\n    parentRows.push(parentRow)\n    currentRow = parentRow\n  }\n  return parentRows.reverse()\n}\n\n/**\n * Returns all cells for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getAllCells(row)\n * ```\n */\nexport function row_getAllCells<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): Array<Cell<TFeatures, TData, unknown>> {\n  return row.table.getAllLeafColumns().map((column) => {\n    return constructCell(column, row, row.table)\n  })\n}\n\n/**\n * Returns all cells by column id for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getAllCellsByColumnId(row)\n * ```\n */\nexport function row_getAllCellsByColumnId<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const result: Record<string, Cell<TFeatures, TData, unknown>> = {}\n  for (const cell of row.getAllCells()) {\n    result[cell.column.id] = cell\n  }\n  return result\n}\n\n/**\n * Returns row id for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getRowId(table)\n * ```\n */\nexport function table_getRowId<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  originalRow: TData,\n  table: Table_Internal<TFeatures, TData>,\n  index: number,\n  parent?: Row<TFeatures, TData>,\n) {\n  return (\n    table.options.getRowId?.(originalRow, index, parent) ??\n    `${parent ? [parent.id, index].join('.') : index}`\n  )\n}\n\n/**\n * Returns row for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getRow(table)\n * ```\n */\nexport function table_getRow<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  rowId: string,\n  searchAll?: boolean,\n): Row<TFeatures, TData> {\n  // TODO - simplify this across different row models\n  let row = (searchAll ? table.getPrePaginatedRowModel() : table.getRowModel())\n    .rowsById[rowId]\n\n  if (!row) {\n    row = table.getCoreRowModel().rowsById[rowId]\n    if (!row) {\n      if (process.env.NODE_ENV === 'development') {\n        throw new Error(`getRow could not find row with ID: ${rowId}`)\n      }\n      throw new Error()\n    }\n  }\n\n  return row\n}\n"],"mappings":";;;;;;;;;;;;;;AAkBA,SAAgB,aAGd,KAA4B,UAAkB;CAC9C,IAAI,IAAI,aAAa,eAAe,SAAS,EAC3C,OAAO,IAAI,aAAa;CAG1B,MAAM,SAAS,IAAI,MAAM,UAAU,SAAS;CAE5C,IAAI,kDAAC,OAAQ,aACX;CAGF,IAAI,aAAa,YAAY,OAAO,WAAW,IAAI,UAAU,IAAI,MAAM;CAEvE,OAAO,IAAI,aAAa;;;;;;;;;;;;AAa1B,SAAgB,oBAGd,KAA4B,UAAkB;CAC9C,IAAI,IAAI,mBAAmB,eAAe,SAAS,EACjD,OAAO,IAAI,mBAAmB;CAGhC,MAAM,SAAS,IAAI,MAAM,UAAU,SAAS;CAE5C,IAAI,kDAAC,OAAQ,aACX;CAGF,IAAI,CAAC,OAAO,UAAU,iBAAiB;EACrC,IAAI,mBAAmB,YAAY,CAAC,IAAI,SAAS,SAAS,CAAC;EAC3D,OAAO,IAAI,mBAAmB;;CAGhC,IAAI,mBAAmB,YAAY,OAAO,UAAU,gBAClD,IAAI,UACJ,IAAI,MACL;CAED,OAAO,IAAI,mBAAmB;;;;;;;;;;;;;AAchC,SAAgB,gBAGd,KAA4B,UAAkB;CAC9C,OAAO,IAAI,SAAS,SAAS,IAAI,IAAI,MAAM,QAAQ;;;;;;;;;;;;AAarD,SAAgB,gBAGd,KAA0D;CAC1D,OAAO,UAAU,IAAI,UAAU,MAAM,EAAE,QAAQ;;;;;;;;;;;;AAajD,SAAgB,iBAGd,KAA4B;CAC5B,OAAO,IAAI,WAAW,IAAI,MAAM,OAAO,IAAI,UAAU,KAAK,GAAG;;;;;;;;;;;;AAa/D,SAAgB,kBAGd,KAA4B;CAC5B,MAAM,aAA2C,EAAE;CACnD,IAAI,aAAa;CAEjB,OAAO,MAAM;EACX,MAAM,YAAY,WAAW,cAAc;EAC3C,IAAI,CAAC,WAAW;EAChB,WAAW,KAAK,UAAU;EAC1B,aAAa;;CAEf,OAAO,WAAW,SAAS;;;;;;;;;;;;AAa7B,SAAgB,gBAGd,KAAoE;CACpE,OAAO,IAAI,MAAM,mBAAmB,CAAC,KAAK,WAAW;EACnD,OAAO,cAAc,QAAQ,KAAK,IAAI,MAAM;GAC5C;;;;;;;;;;;;AAaJ,SAAgB,0BAGd,KAA4B;CAC5B,MAAM,SAA0D,EAAE;CAClE,KAAK,MAAM,QAAQ,IAAI,aAAa,EAClC,OAAO,KAAK,OAAO,MAAM;CAE3B,OAAO;;;;;;;;;;;;AAaT,SAAgB,eAId,aACA,OACA,OACA,QACA;;CACA,mDACE,MAAM,SAAQ,6GAAW,aAAa,OAAO,OAAO,KACpD,GAAG,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,GAAG;;;;;;;;;;;;AAc/C,SAAgB,aAId,OACA,OACA,WACuB;CAEvB,IAAI,OAAO,YAAY,MAAM,yBAAyB,GAAG,MAAM,aAAa,EACzE,SAAS;CAEZ,IAAI,CAAC,KAAK;EACR,MAAM,MAAM,iBAAiB,CAAC,SAAS;EACvC,IAAI,CAAC,KAAK;GACR,IAAI,QAAQ,IAAI,aAAa,eAC3B,MAAM,IAAI,MAAM,sCAAsC,QAAQ;GAEhE,MAAM,IAAI,OAAO;;;CAIrB,OAAO"}

package/dist/core/table/constructTable.cjs

@@ -1,8 +1,14 @@
 const require_utils = require('../../utils.cjs');
+const require_coreTablesFeature_utils = require('./coreTablesFeature.utils.cjs');
 const require_coreFeatures = require('../coreFeatures.cjs');
 const require_coreReactivityFeature_utils = require('../reactivity/coreReactivityFeature.utils.cjs');
 
 //#region src/core/table/constructTable.ts
+/**
+* Builds the initial table state from registered features and user initial state.
+*
+* Each feature contributes its default state before user-provided `initialState` values are merged in.
+*/
 function getInitialTableState(features, initialState = {}) {
 	Object.values(features).forEach((feature) => {
 		var _feature$getInitialSt;
@@ -10,6 +16,11 @@ function getInitialTableState(features, initialState = {}) {
 	});
 	return require_utils.cloneState(initialState);
 }
+/**
+* Constructs a table instance from normalized table internals.
+*
+* This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+*/
 function constructTable(tableOptions) {
 	const _reactivity = tableOptions._features.coreReativityFeature;
 	const table = {
@@ -20,38 +31,42 @@ function constructTable(tableOptions) {
 		},
 		_rowModels: {},
 		_rowModelFns: {},
-		get options() {
-			return this.optionsStore.get();
-		},
-		set options(value) {
-			this.optionsStore.set(() => value);
-		},
 		baseAtoms: {},
 		atoms: {}
 	};
 	const featuresList = Object.values(table._features);
-	const defaultOptions = featuresList.reduce((obj, feature) => {
-		var _feature$getDefaultTa;
-		return Object.assign(obj, (_feature$getDefaultTa = feature.getDefaultTableOptions) === null || _feature$getDefaultTa === void 0 ? void 0 : _feature$getDefaultTa.call(feature, table));
-	}, {});
-	table.optionsStore = _reactivity.createWritableAtom({
-		...defaultOptions,
+	const mergedOptions = {
+		...featuresList.reduce((obj, feature) => {
+			var _feature$getDefaultTa;
+			return Object.assign(obj, (_feature$getDefaultTa = feature.getDefaultTableOptions) === null || _feature$getDefaultTa === void 0 ? void 0 : _feature$getDefaultTa.call(feature, table));
+		}, {}),
 		...tableOptions
-	}, { debugName: "table/optionsStore" });
+	};
+	if (_reactivity.createOptionsStore) {
+		table.optionsStore = _reactivity.createWritableAtom(mergedOptions, { debugName: "table/optionsStore" });
+		Object.defineProperty(table, "options", {
+			configurable: true,
+			enumerable: true,
+			get() {
+				return table.optionsStore.get();
+			},
+			set(value) {
+				table.optionsStore.set(() => value);
+			}
+		});
+	} else table.options = mergedOptions;
 	table.initialState = getInitialTableState(table._features, table.options.initialState);
 	const stateKeys = Object.keys(table.initialState);
 	for (const key of stateKeys) {
 		table.baseAtoms[key] = _reactivity.createWritableAtom(table.initialState[key], { debugName: `table/baseAtoms/${key}` });
 		table.atoms[key] = _reactivity.createReadonlyAtom(() => {
-			var _opts$atoms;
-			const opts = table.optionsStore.get();
-			const state = opts.state;
-			if (key in (state ?? {})) return state[key];
-			const externalAtom = (_opts$atoms = opts.atoms) === null || _opts$atoms === void 0 ? void 0 : _opts$atoms[key];
+			var _table$options$atoms;
+			const externalAtom = (_table$options$atoms = table.options.atoms) === null || _table$options$atoms === void 0 ? void 0 : _table$options$atoms[key];
 			if (externalAtom) return externalAtom.get();
 			return table.baseAtoms[key].get();
 		}, { debugName: `table/atoms/${key}` });
 	}
+	require_coreTablesFeature_utils.table_syncExternalStateToBaseAtoms(table);
 	table.store = require_coreReactivityFeature_utils.atomToStore(_reactivity.createReadonlyAtom(() => {
 		const snapshot = {};
 		for (const key of stateKeys) snapshot[key] = table.atoms[key].get();
@@ -67,7 +82,7 @@ function constructTable(tableOptions) {
 
   Row Models: ${rowModels.length ? rowModels.join("\n              ") : "(none)"}
 
-  States:     ${states.join("\n              ")}`);
+  States:     ${states.join("\n              ")}\n`, { table });
 	}
 	for (const feature of featuresList) {
 		var _feature$constructTab;

package/dist/core/table/constructTable.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constructTable.cjs","names":["cloneState","coreFeatures","atomToStore"],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../utils'\nimport { atomToStore } from '../reactivity/coreReactivityFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState } from '../../types/TableState'\n\nexport function getInitialTableState<TFeatures extends TableFeatures>(\n  features: TFeatures,\n  initialState: Partial<TableState<TFeatures>> | undefined = {},\n): TableState<TFeatures> {\n  Object.values(features).forEach((feature) => {\n    initialState = feature.getInitialState?.(initialState) ?? initialState\n  })\n  return cloneState(initialState) as TableState<TFeatures>\n}\n\nexport function constructTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(tableOptions: TableOptions<TFeatures, TData>): Table<TFeatures, TData> {\n  const _reactivity = tableOptions._features.coreReativityFeature!\n\n  const table = {\n    _reactivity,\n    _features: { ...coreFeatures, ...tableOptions._features },\n    _rowModels: {},\n    _rowModelFns: {},\n    get options() {\n      return this.optionsStore.get()\n    },\n    set options(value) {\n      this.optionsStore.set(() => value)\n    },\n    baseAtoms: {},\n    atoms: {},\n  } as Table_Internal<TFeatures, TData>\n\n  const featuresList: Array<TableFeature<{}>> = Object.values(table._features)\n\n  const defaultOptions = featuresList.reduce((obj, feature) => {\n    return Object.assign(obj, feature.getDefaultTableOptions?.(table))\n  }, {}) as TableOptions<TFeatures, TData>\n\n  // @ts-ignore - direct set\n  table.optionsStore = _reactivity.createWritableAtom<\n    TableOptions<TFeatures, TData>\n  >({ ...defaultOptions, ...tableOptions }, { debugName: 'table/optionsStore' })\n\n  table.initialState = getInitialTableState(\n    table._features,\n    table.options.initialState,\n  )\n\n  const stateKeys = Object.keys(table.initialState) as Array<\n    string & keyof TableState<TFeatures>\n  >\n\n  for (const key of stateKeys) {\n    // create writable base atom\n    table.baseAtoms[key] = _reactivity.createWritableAtom(\n      table.initialState[key],\n      {\n        debugName: `table/baseAtoms/${key}`,\n      },\n    ) as any\n\n    // create readonly derived atom: on each get(), read current options (state, then external atom, then base)\n    ;(table.atoms as any)[key] = _reactivity.createReadonlyAtom(\n      () => {\n        // Reading optionsStore.get() keeps this reactive to setOptions\n        const opts = table.optionsStore.get()\n        const state = opts.state\n        if (key in (state ?? {})) {\n          return state![key]\n        }\n        const externalAtom = opts.atoms?.[key]\n        if (externalAtom) {\n          return externalAtom.get()\n        }\n        return table.baseAtoms[key].get()\n      },\n      { debugName: `table/atoms/${key}` },\n    )\n  }\n\n  table.store = atomToStore(\n    _reactivity.createReadonlyAtom(\n      () => {\n        const snapshot = {} as TableState<TFeatures>\n        for (const key of stateKeys) {\n          snapshot[key] = table.atoms[key].get()\n        }\n        return snapshot\n      },\n      { debugName: 'table/store' },\n    ),\n  )\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.keys(table.options._rowModels || {})\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}`,\n    )\n  }\n\n  for (const feature of featuresList) {\n    feature.constructTableAPIs?.(table)\n  }\n\n  return table\n}\n"],"mappings":";;;;;AASA,SAAgB,qBACd,UACA,eAA2D,EAAE,EACtC;AACvB,QAAO,OAAO,SAAS,CAAC,SAAS,YAAY;;AAC3C,2CAAe,QAAQ,6GAAkB,aAAa,KAAI;GAC1D;AACF,QAAOA,yBAAW,aAAa;;AAGjC,SAAgB,eAGd,cAAuE;CACvE,MAAM,cAAc,aAAa,UAAU;CAE3C,MAAM,QAAQ;EACZ;EACA,WAAW;GAAE,GAAGC;GAAc,GAAG,aAAa;GAAW;EACzD,YAAY,EAAE;EACd,cAAc,EAAE;EAChB,IAAI,UAAU;AACZ,UAAO,KAAK,aAAa,KAAK;;EAEhC,IAAI,QAAQ,OAAO;AACjB,QAAK,aAAa,UAAU,MAAM;;EAEpC,WAAW,EAAE;EACb,OAAO,EAAE;EACV;CAED,MAAM,eAAwC,OAAO,OAAO,MAAM,UAAU;CAE5E,MAAM,iBAAiB,aAAa,QAAQ,KAAK,YAAY;;AAC3D,SAAO,OAAO,OAAO,8BAAK,QAAQ,oHAAyB,MAAM,CAAC;IACjE,EAAE,CAAC;AAGN,OAAM,eAAe,YAAY,mBAE/B;EAAE,GAAG;EAAgB,GAAG;EAAc,EAAE,EAAE,WAAW,sBAAsB,CAAC;AAE9E,OAAM,eAAe,qBACnB,MAAM,WACN,MAAM,QAAQ,aACf;CAED,MAAM,YAAY,OAAO,KAAK,MAAM,aAAa;AAIjD,MAAK,MAAM,OAAO,WAAW;AAE3B,QAAM,UAAU,OAAO,YAAY,mBACjC,MAAM,aAAa,MACnB,EACE,WAAW,mBAAmB,OAC/B,CACF;AAGA,EAAC,MAAM,MAAc,OAAO,YAAY,yBACjC;;GAEJ,MAAM,OAAO,MAAM,aAAa,KAAK;GACrC,MAAM,QAAQ,KAAK;AACnB,OAAI,QAAQ,SAAS,EAAE,EACrB,QAAO,MAAO;GAEhB,MAAM,8BAAe,KAAK,iEAAQ;AAClC,OAAI,aACF,QAAO,aAAa,KAAK;AAE3B,UAAO,MAAM,UAAU,KAAK,KAAK;KAEnC,EAAE,WAAW,eAAe,OAAO,CACpC;;AAGH,OAAM,QAAQC,gDACZ,YAAY,yBACJ;EACJ,MAAM,WAAW,EAAE;AACnB,OAAK,MAAM,OAAO,UAChB,UAAS,OAAO,MAAM,MAAM,KAAK,KAAK;AAExC,SAAO;IAET,EAAE,WAAW,eAAe,CAC7B,CACF;AAED,KACE,QAAQ,IAAI,aAAa,kBACxB,aAAa,YAAY,aAAa,aACvC;EACA,MAAM,WAAW,OAAO,KAAK,MAAM,UAAU;EAC7C,MAAM,YAAY,OAAO,KAAK,MAAM,QAAQ,cAAc,EAAE,CAAC;EAC7D,MAAM,SAAS,OAAO,KAAK,MAAM,aAAa;AAE9C,UAAQ,IACN;;gBAEU,SAAS,KAAK,mBAAmB,CAAC;;gBAElC,UAAU,SAAS,UAAU,KAAK,mBAAmB,GAAG,SAAS;;gBAEjE,OAAO,KAAK,mBAAmB,GAC1C;;AAGH,MAAK,MAAM,WAAW,cAAc;;AAClC,mCAAQ,wGAAqB,MAAM;;AAGrC,QAAO"}
+{"version":3,"file":"constructTable.cjs","names":["cloneState","coreFeatures","atomToStore"],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../utils'\nimport { atomToStore } from '../reactivity/coreReactivityFeature.utils'\nimport { table_syncExternalStateToBaseAtoms } from './coreTablesFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState } from '../../types/TableState'\n\n/**\n * Builds the initial table state from registered features and user initial state.\n *\n * Each feature contributes its default state before user-provided `initialState` values are merged in.\n */\nexport function getInitialTableState<TFeatures extends TableFeatures>(\n  features: TFeatures,\n  initialState: Partial<TableState<TFeatures>> | undefined = {},\n): TableState<TFeatures> {\n  Object.values(features).forEach((feature) => {\n    initialState = feature.getInitialState?.(initialState) ?? initialState\n  })\n  return cloneState(initialState) as TableState<TFeatures>\n}\n\n/**\n * Constructs a table 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 constructTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(tableOptions: TableOptions<TFeatures, TData>): Table<TFeatures, TData> {\n  const _reactivity = tableOptions._features.coreReativityFeature!\n\n  const table = {\n    _reactivity,\n    _features: { ...coreFeatures, ...tableOptions._features },\n    _rowModels: {},\n    _rowModelFns: {},\n    baseAtoms: {},\n    atoms: {},\n  } as Table_Internal<TFeatures, TData>\n\n  const featuresList: Array<TableFeature<{}>> = Object.values(table._features)\n\n  const defaultOptions = featuresList.reduce((obj, feature) => {\n    return Object.assign(obj, feature.getDefaultTableOptions?.(table))\n  }, {}) as TableOptions<TFeatures, TData>\n\n  const mergedOptions = { ...defaultOptions, ...tableOptions }\n\n  if (_reactivity.createOptionsStore) {\n    // @ts-ignore - direct set\n    table.optionsStore = _reactivity.createWritableAtom<\n      TableOptions<TFeatures, TData>\n    >(mergedOptions, { debugName: 'table/optionsStore' })\n    Object.defineProperty(table, 'options', {\n      configurable: true,\n      enumerable: true,\n      get() {\n        return table.optionsStore!.get()\n      },\n      set(value) {\n        table.optionsStore!.set(() => value) // or your real update shape\n      },\n    })\n  } else {\n    table.options = mergedOptions\n  }\n\n  table.initialState = getInitialTableState(\n    table._features,\n    table.options.initialState,\n  )\n\n  const stateKeys = Object.keys(table.initialState) as Array<\n    string & keyof TableState<TFeatures>\n  >\n\n  for (const key of stateKeys) {\n    // create writable base atom\n    table.baseAtoms[key] = _reactivity.createWritableAtom(\n      table.initialState[key],\n      {\n        debugName: `table/baseAtoms/${key}`,\n      },\n    ) as any\n\n    // create readonly derived atom: on each get(), read either external atom or base atom\n    ;(table.atoms as any)[key] = _reactivity.createReadonlyAtom(\n      () => {\n        const externalAtom = table.options.atoms?.[key]\n        if (externalAtom) {\n          return externalAtom.get()\n        }\n        return table.baseAtoms[key].get()\n      },\n      { debugName: `table/atoms/${key}` },\n    )\n  }\n\n  table_syncExternalStateToBaseAtoms(table)\n\n  table.store = atomToStore(\n    _reactivity.createReadonlyAtom(\n      () => {\n        const snapshot = {} as TableState<TFeatures>\n        for (const key of stateKeys) {\n          snapshot[key] = table.atoms[key].get()\n        }\n        return snapshot\n      },\n      { debugName: 'table/store' },\n    ),\n  )\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.keys(table.options._rowModels || {})\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}\\n`,\n      { table },\n    )\n  }\n\n  for (const feature of featuresList) {\n    feature.constructTableAPIs?.(table)\n  }\n\n  return table\n}\n"],"mappings":";;;;;;;;;;;AAeA,SAAgB,qBACd,UACA,eAA2D,EAAE,EACtC;CACvB,OAAO,OAAO,SAAS,CAAC,SAAS,YAAY;;EAC3C,yCAAe,QAAQ,6GAAkB,aAAa,KAAI;GAC1D;CACF,OAAOA,yBAAW,aAAa;;;;;;;AAQjC,SAAgB,eAGd,cAAuE;CACvE,MAAM,cAAc,aAAa,UAAU;CAE3C,MAAM,QAAQ;EACZ;EACA,WAAW;GAAE,GAAGC;GAAc,GAAG,aAAa;GAAW;EACzD,YAAY,EAAE;EACd,cAAc,EAAE;EAChB,WAAW,EAAE;EACb,OAAO,EAAE;EACV;CAED,MAAM,eAAwC,OAAO,OAAO,MAAM,UAAU;CAM5E,MAAM,gBAAgB;EAAE,GAJD,aAAa,QAAQ,KAAK,YAAY;;GAC3D,OAAO,OAAO,OAAO,8BAAK,QAAQ,oHAAyB,MAAM,CAAC;KACjE,EAAE,CAEoC;EAAE,GAAG;EAAc;CAE5D,IAAI,YAAY,oBAAoB;EAElC,MAAM,eAAe,YAAY,mBAE/B,eAAe,EAAE,WAAW,sBAAsB,CAAC;EACrD,OAAO,eAAe,OAAO,WAAW;GACtC,cAAc;GACd,YAAY;GACZ,MAAM;IACJ,OAAO,MAAM,aAAc,KAAK;;GAElC,IAAI,OAAO;IACT,MAAM,aAAc,UAAU,MAAM;;GAEvC,CAAC;QAEF,MAAM,UAAU;CAGlB,MAAM,eAAe,qBACnB,MAAM,WACN,MAAM,QAAQ,aACf;CAED,MAAM,YAAY,OAAO,KAAK,MAAM,aAAa;CAIjD,KAAK,MAAM,OAAO,WAAW;EAE3B,MAAM,UAAU,OAAO,YAAY,mBACjC,MAAM,aAAa,MACnB,EACE,WAAW,mBAAmB,OAC/B,CACF;EAGA,AAAC,MAAM,MAAc,OAAO,YAAY,yBACjC;;GACJ,MAAM,uCAAe,MAAM,QAAQ,mFAAQ;GAC3C,IAAI,cACF,OAAO,aAAa,KAAK;GAE3B,OAAO,MAAM,UAAU,KAAK,KAAK;KAEnC,EAAE,WAAW,eAAe,OAAO,CACpC;;CAGH,mEAAmC,MAAM;CAEzC,MAAM,QAAQC,gDACZ,YAAY,yBACJ;EACJ,MAAM,WAAW,EAAE;EACnB,KAAK,MAAM,OAAO,WAChB,SAAS,OAAO,MAAM,MAAM,KAAK,KAAK;EAExC,OAAO;IAET,EAAE,WAAW,eAAe,CAC7B,CACF;CAED,IACE,QAAQ,IAAI,aAAa,kBACxB,aAAa,YAAY,aAAa,aACvC;EACA,MAAM,WAAW,OAAO,KAAK,MAAM,UAAU;EAC7C,MAAM,YAAY,OAAO,KAAK,MAAM,QAAQ,cAAc,EAAE,CAAC;EAC7D,MAAM,SAAS,OAAO,KAAK,MAAM,aAAa;EAE9C,QAAQ,IACN;;gBAEU,SAAS,KAAK,mBAAmB,CAAC;;gBAElC,UAAU,SAAS,UAAU,KAAK,mBAAmB,GAAG,SAAS;;gBAEjE,OAAO,KAAK,mBAAmB,CAAC,KAC1C,EAAE,OAAO,CACV;;CAGH,KAAK,MAAM,WAAW,cAAc;;EAClC,iCAAQ,wGAAqB,MAAM;;CAGrC,OAAO"}

package/dist/core/table/constructTable.d.cts

@@ -5,7 +5,17 @@ import { TableFeatures } from "../../types/TableFeatures.cjs";
 import { Table } from "../../types/Table.cjs";
 
 //#region src/core/table/constructTable.d.ts
+/**
+ * Builds the initial table state from registered features and user initial state.
+ *
+ * Each feature contributes its default state before user-provided `initialState` values are merged in.
+ */
 declare function getInitialTableState<TFeatures extends TableFeatures>(features: TFeatures, initialState?: Partial<TableState<TFeatures>> | undefined): TableState<TFeatures>;
+/**
+ * Constructs a table 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 constructTable<TFeatures extends TableFeatures, TData extends RowData>(tableOptions: TableOptions<TFeatures, TData>): Table<TFeatures, TData>;
 //#endregion
 export { constructTable, getInitialTableState };

package/dist/core/table/constructTable.d.ts

@@ -5,7 +5,17 @@ import { TableFeatures } from "../../types/TableFeatures.js";
 import { Table } from "../../types/Table.js";
 
 //#region src/core/table/constructTable.d.ts
+/**
+ * Builds the initial table state from registered features and user initial state.
+ *
+ * Each feature contributes its default state before user-provided `initialState` values are merged in.
+ */
 declare function getInitialTableState<TFeatures extends TableFeatures>(features: TFeatures, initialState?: Partial<TableState<TFeatures>> | undefined): TableState<TFeatures>;
+/**
+ * Constructs a table 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 constructTable<TFeatures extends TableFeatures, TData extends RowData>(tableOptions: TableOptions<TFeatures, TData>): Table<TFeatures, TData>;
 //#endregion
 export { constructTable, getInitialTableState };