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

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

@@ -0,0 +1,183 @@
+import { flattenBy } from "../../utils.js";
+import { constructCell } from "../cells/constructCell.js";
+
+//#region src/core/rows/coreRowsFeature.utils.ts
+/**
+* Reads and caches this row's value for a column.
+*
+* The value is produced by the column accessor. Missing columns or display
+* columns without an accessor return `undefined`.
+*
+* @example
+* ```ts
+* const firstName = row_getValue(row, 'firstName')
+* ```
+*/
+function row_getValue(row, columnId) {
+	if (row._valuesCache.hasOwnProperty(columnId)) return row._valuesCache[columnId];
+	const column = row.table.getColumn(columnId);
+	if (!(column === null || column === void 0 ? void 0 : column.accessorFn)) return;
+	row._valuesCache[columnId] = column.accessorFn(row.original, row.index);
+	return row._valuesCache[columnId];
+}
+/**
+* Reads and caches the values used by faceting/grouping for a column.
+*
+* If the column defines `getUniqueValues`, that result is used. Otherwise the
+* row's accessor value is wrapped in a single-item array.
+*
+* @example
+* ```ts
+* const values = row_getUniqueValues(row, 'tags')
+* ```
+*/
+function row_getUniqueValues(row, columnId) {
+	if (row._uniqueValuesCache.hasOwnProperty(columnId)) return row._uniqueValuesCache[columnId];
+	const column = row.table.getColumn(columnId);
+	if (!(column === null || column === void 0 ? void 0 : column.accessorFn)) return;
+	if (!column.columnDef.getUniqueValues) {
+		row._uniqueValuesCache[columnId] = [row.getValue(columnId)];
+		return row._uniqueValuesCache[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, 'firstName')
+* ```
+*/
+function row_renderValue(row, columnId) {
+	return row.getValue(columnId) ?? row.table.options.renderFallbackValue;
+}
+/**
+* Flattens this row's descendant tree into leaf rows.
+*
+* The row itself is not included; only nested `subRows` are walked.
+*
+* @example
+* ```ts
+* const descendants = row_getLeafRows(row)
+* ```
+*/
+function row_getLeafRows(row) {
+	return flattenBy(row.subRows, (d) => d.subRows);
+}
+/**
+* Looks up this row's direct parent, if it has one.
+*
+* Parent lookup searches the pre-pagination row model so parent relationships
+* are available even when the parent is not on the current page.
+*
+* @example
+* ```ts
+* const parent = row_getParentRow(row)
+* ```
+*/
+function row_getParentRow(row) {
+	return row.parentId ? row.table.getRow(row.parentId, true) : void 0;
+}
+/**
+* Collects this row's ancestor chain from root to direct parent.
+*
+* The current row is not included. Rows without a parent return an empty array.
+*
+* @example
+* ```ts
+* const ancestors = row_getParentRows(row)
+* ```
+*/
+function row_getParentRows(row) {
+	const parentRows = [];
+	let currentRow = row;
+	while (true) {
+		const parentRow = currentRow.getParentRow();
+		if (!parentRow) break;
+		parentRows.push(parentRow);
+		currentRow = parentRow;
+	}
+	return parentRows.reverse();
+}
+/**
+* Constructs one cell for each leaf column in this row.
+*
+* The result follows `table.getAllLeafColumns()` order and includes hidden
+* columns; visibility-specific APIs filter this list later.
+*
+* @example
+* ```ts
+* const cells = row_getAllCells(row)
+* ```
+*/
+function row_getAllCells(row) {
+	const columns = row.table.getAllLeafColumns();
+	const cells = new Array(columns.length);
+	for (let i = 0; i < columns.length; i++) cells[i] = constructCell(columns[i], row, row.table);
+	return cells;
+}
+/**
+* Builds a lookup map of this row's cells keyed by column id.
+*
+* This is the static implementation behind `row.getAllCellsByColumnId()`.
+*
+* @example
+* ```ts
+* const cellsById = row_getAllCellsByColumnId(row)
+* ```
+*/
+function row_getAllCellsByColumnId(row) {
+	const result = {};
+	const cells = row.getAllCells();
+	for (let i = 0; i < cells.length; i++) {
+		const cell = cells[i];
+		result[cell.column.id] = cell;
+	}
+	return result;
+}
+/**
+* Resolves the stable id for a row.
+*
+* `options.getRowId` wins when provided. Otherwise root rows use their index
+* and child rows append their index to the parent id, such as `0.2`.
+*
+* @example
+* ```ts
+* const id = table_getRowId(originalRow, table, index, parentRow)
+* ```
+*/
+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}`;
+}
+/**
+* Looks up a row by id from the current or full row model.
+*
+* By default this searches `table.getRowModel()`. Passing `searchAll` searches
+* the pre-pagination model first, then falls back to the core model.
+*
+* @example
+* ```ts
+* const row = table_getRow(table, rowId, true)
+* ```
+*/
+function table_getRow(table, rowId, searchAll) {
+	let row = (searchAll ? table.getPrePaginatedRowModel() : table.getRowModel()).rowsById[rowId];
+	if (!row) {
+		row = table.getCoreRowModel().rowsById[rowId];
+		if (!row) {
+			if (process.env.NODE_ENV === "development") throw new Error(`getRow could not find row with ID: ${rowId}`);
+			throw new Error();
+		}
+	}
+	return row;
+}
+
+//#endregion
+export { row_getAllCells, row_getAllCellsByColumnId, row_getLeafRows, row_getParentRow, row_getParentRows, row_getUniqueValues, row_getValue, row_renderValue, table_getRow, table_getRowId };
+//# sourceMappingURL=coreRowsFeature.utils.js.map

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

@@ -0,0 +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\n/**\n * Reads and caches this row's value for a column.\n *\n * The value is produced by the column accessor. Missing columns or display\n * columns without an accessor return `undefined`.\n *\n * @example\n * ```ts\n * const firstName = row_getValue(row, 'firstName')\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 * Reads and caches the values used by faceting/grouping for a column.\n *\n * If the column defines `getUniqueValues`, that result is used. Otherwise the\n * row's accessor value is wrapped in a single-item array.\n *\n * @example\n * ```ts\n * const values = row_getUniqueValues(row, 'tags')\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, 'firstName')\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 * Flattens this row's descendant tree into leaf rows.\n *\n * The row itself is not included; only nested `subRows` are walked.\n *\n * @example\n * ```ts\n * const descendants = 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 * Looks up this row's direct parent, if it has one.\n *\n * Parent lookup searches the pre-pagination row model so parent relationships\n * are available even when the parent is not on the current page.\n *\n * @example\n * ```ts\n * const parent = 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 * Collects this row's ancestor chain from root to direct parent.\n *\n * The current row is not included. Rows without a parent return an empty array.\n *\n * @example\n * ```ts\n * const ancestors = 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 * Constructs one cell for each leaf column in this row.\n *\n * The result follows `table.getAllLeafColumns()` order and includes hidden\n * columns; visibility-specific APIs filter this list later.\n *\n * @example\n * ```ts\n * const cells = 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  const columns = row.table.getAllLeafColumns()\n  const cells: Array<Cell<TFeatures, TData, unknown>> = new Array(\n    columns.length,\n  )\n  for (let i = 0; i < columns.length; i++) {\n    cells[i] = constructCell(columns[i]!, row, row.table)\n  }\n  return cells\n}\n\n/**\n * Builds a lookup map of this row's cells keyed by column id.\n *\n * This is the static implementation behind `row.getAllCellsByColumnId()`.\n *\n * @example\n * ```ts\n * const cellsById = 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  const cells = row.getAllCells()\n  for (let i = 0; i < cells.length; i++) {\n    const cell = cells[i]!\n    result[cell.column.id] = cell\n  }\n  return result\n}\n\n/**\n * Resolves the stable id for a row.\n *\n * `options.getRowId` wins when provided. Otherwise root rows use their index\n * and child rows append their index to the parent id, such as `0.2`.\n *\n * @example\n * ```ts\n * const id = table_getRowId(originalRow, table, index, parentRow)\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 * Looks up a row by id from the current or full row model.\n *\n * By default this searches `table.getRowModel()`. Passing `searchAll` searches\n * the pre-pagination model first, then falls back to the core model.\n *\n * @example\n * ```ts\n * const row = table_getRow(table, rowId, true)\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":";;;;;;;;;;;;;;;AAmBA,SAAgB,aAGd,KAA4B,UAAkB;CAC9C,IAAI,IAAI,aAAa,eAAe,QAAQ,GAC1C,OAAO,IAAI,aAAa;CAG1B,MAAM,SAAS,IAAI,MAAM,UAAU,QAAQ;CAE3C,IAAI,kDAAC,OAAQ,aACX;CAGF,IAAI,aAAa,YAAY,OAAO,WAAW,IAAI,UAAU,IAAI,KAAK;CAEtE,OAAO,IAAI,aAAa;AAC1B;;;;;;;;;;;;AAaA,SAAgB,oBAGd,KAA4B,UAAkB;CAC9C,IAAI,IAAI,mBAAmB,eAAe,QAAQ,GAChD,OAAO,IAAI,mBAAmB;CAGhC,MAAM,SAAS,IAAI,MAAM,UAAU,QAAQ;CAE3C,IAAI,kDAAC,OAAQ,aACX;CAGF,IAAI,CAAC,OAAO,UAAU,iBAAiB;EACrC,IAAI,mBAAmB,YAAY,CAAC,IAAI,SAAS,QAAQ,CAAC;EAC1D,OAAO,IAAI,mBAAmB;CAChC;CAEA,IAAI,mBAAmB,YAAY,OAAO,UAAU,gBAClD,IAAI,UACJ,IAAI,KACN;CAEA,OAAO,IAAI,mBAAmB;AAChC;;;;;;;;;;;;AAaA,SAAgB,gBAGd,KAA4B,UAAkB;CAC9C,OAAO,IAAI,SAAS,QAAQ,KAAK,IAAI,MAAM,QAAQ;AACrD;;;;;;;;;;;AAYA,SAAgB,gBAGd,KAA0D;CAC1D,OAAO,UAAU,IAAI,UAAU,MAAM,EAAE,OAAO;AAChD;;;;;;;;;;;;AAaA,SAAgB,iBAGd,KAA4B;CAC5B,OAAO,IAAI,WAAW,IAAI,MAAM,OAAO,IAAI,UAAU,IAAI,IAAI;AAC/D;;;;;;;;;;;AAYA,SAAgB,kBAGd,KAA4B;CAC5B,MAAM,aAA2C,CAAC;CAClD,IAAI,aAAa;CAEjB,OAAO,MAAM;EACX,MAAM,YAAY,WAAW,aAAa;EAC1C,IAAI,CAAC,WAAW;EAChB,WAAW,KAAK,SAAS;EACzB,aAAa;CACf;CACA,OAAO,WAAW,QAAQ;AAC5B;;;;;;;;;;;;AAaA,SAAgB,gBAGd,KAAoE;CACpE,MAAM,UAAU,IAAI,MAAM,kBAAkB;CAC5C,MAAM,QAAgD,IAAI,MACxD,QAAQ,MACV;CACA,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,MAAM,KAAK,cAAc,QAAQ,IAAK,KAAK,IAAI,KAAK;CAEtD,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,0BAGd,KAA4B;CAC5B,MAAM,SAA0D,CAAC;CACjE,MAAM,QAAQ,IAAI,YAAY;CAC9B,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,OAAO,MAAM;EACnB,OAAO,KAAK,OAAO,MAAM;CAC3B;CACA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,eAId,aACA,OACA,OACA,QACA;;CACA,mDACE,MAAM,SAAQ,6GAAW,aAAa,OAAO,MAAM,MACnD,GAAG,SAAS,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI;AAE/C;;;;;;;;;;;;AAaA,SAAgB,aAId,OACA,OACA,WACuB;CAEvB,IAAI,OAAO,YAAY,MAAM,wBAAwB,IAAI,MAAM,YAAY,EAAC,CACzE,SAAS;CAEZ,IAAI,CAAC,KAAK;EACR,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS;EACvC,IAAI,CAAC,KAAK;GACR,IAAI,QAAQ,IAAI,aAAa,eAC3B,MAAM,IAAI,MAAM,sCAAsC,OAAO;GAE/D,MAAM,IAAI,MAAM;EAClB;CACF;CAEA,OAAO;AACT"}

package/dist/core/table/constructTable.cjs

@@ -0,0 +1,133 @@
+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;
+		initialState = ((_feature$getInitialSt = feature.getInitialState) === null || _feature$getInitialSt === void 0 ? void 0 : _feature$getInitialSt.call(feature, initialState)) ?? 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.coreReactivityFeature;
+	const { aggregationFns, columnMeta: _columnMeta, coreRowModel, expandedRowModel, facetedMinMaxValues, facetedRowModel, facetedUniqueValues, filterFns, filterMeta: _filterMeta, filteredRowModel, groupedRowModel, paginatedRowModel, sortFns, sortedRowModel, tableMeta: _tableMeta, ...features } = tableOptions.features;
+	const table = {
+		_reactivity,
+		_features: {
+			...require_coreFeatures.coreFeatures,
+			...features
+		},
+		_rowModels: {},
+		_rowModelFns: {
+			aggregationFns,
+			filterFns,
+			sortFns
+		},
+		baseAtoms: {},
+		atoms: {}
+	};
+	const featuresList = Object.values(table._features);
+	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
+	};
+	if (_reactivity.wrapExternalAtoms && mergedOptions.atoms) for (const [atomKey, _atom] of Object.entries(mergedOptions.atoms)) {
+		const atom = _atom;
+		const wrappedAtom = _reactivity.createWritableAtom(atom.get(), { debugName: `externalAtom/${atomKey}` });
+		mergedOptions.atoms[atomKey] = wrappedAtom;
+		let syncExternal = false;
+		const syncAtomToWrappedSub = atom.subscribe((value) => {
+			if (syncExternal) return;
+			wrappedAtom.set(value);
+		});
+		const syncWrappedToAtomSub = wrappedAtom.subscribe((value) => {
+			syncExternal = true;
+			atom.set(value);
+			syncExternal = false;
+		});
+		_reactivity.addSubscription(syncAtomToWrappedSub);
+		_reactivity.addSubscription(syncWrappedToAtomSub);
+	}
+	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 (let i = 0; i < stateKeys.length; i++) {
+		const key = stateKeys[i];
+		table.baseAtoms[key] = _reactivity.createWritableAtom(table.initialState[key], { debugName: `table/baseAtoms/${key}` });
+		table.atoms[key] = _reactivity.createReadonlyAtom(() => {
+			const externalAtoms = table.options.atoms;
+			const externalAtom = externalAtoms === null || externalAtoms === void 0 ? void 0 : externalAtoms[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 (let i = 0; i < stateKeys.length; i++) {
+			const key = stateKeys[i];
+			snapshot[key] = table.atoms[key].get();
+		}
+		return snapshot;
+	}, { debugName: "table/store" }));
+	if (process.env.NODE_ENV === "development" && (tableOptions.debugAll || tableOptions.debugTable)) {
+		const features = Object.keys(table._features);
+		const rowModels = Object.entries({
+			coreRowModel,
+			filteredRowModel,
+			groupedRowModel,
+			sortedRowModel,
+			expandedRowModel,
+			paginatedRowModel,
+			facetedRowModel,
+			facetedMinMaxValues,
+			facetedUniqueValues
+		}).filter(([, factory]) => factory).map(([key]) => key);
+		const states = Object.keys(table.initialState);
+		console.log(`Constructing Table Instance
+
+  Features:   ${features.join("\n              ")}
+
+  Row Models: ${rowModels.length ? rowModels.join("\n              ") : "(none)"}
+
+  States:     ${states.join("\n              ")}\n`, { table });
+	}
+	for (let i = 0; i < featuresList.length; i++) {
+		var _constructTableAPIs, _ref;
+		(_constructTableAPIs = (_ref = featuresList[i]).constructTableAPIs) === null || _constructTableAPIs === void 0 || _constructTableAPIs.call(_ref, table);
+	}
+	return table;
+}
+
+//#endregion
+exports.constructTable = constructTable;
+exports.getInitialTableState = getInitialTableState;
+//# sourceMappingURL=constructTable.cjs.map

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

@@ -0,0 +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 { table_syncExternalStateToBaseAtoms } from './coreTablesFeature.utils'\nimport type { Atom } from '@tanstack/store'\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, TableState_All } 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.coreReactivityFeature!\n\n  // Strip the non-feature slots: type-only meta slots, row model factories,\n  // and row model fn registries all live on the `features` option but are not\n  // table features themselves.\n  const {\n    aggregationFns,\n    columnMeta: _columnMeta,\n    coreRowModel,\n    expandedRowModel,\n    facetedMinMaxValues,\n    facetedRowModel,\n    facetedUniqueValues,\n    filterFns,\n    filterMeta: _filterMeta,\n    filteredRowModel,\n    groupedRowModel,\n    paginatedRowModel,\n    sortFns,\n    sortedRowModel,\n    tableMeta: _tableMeta,\n    ...features\n  } = tableOptions.features\n\n  const table = {\n    _reactivity,\n    _features: { ...coreFeatures, ...features },\n    _rowModels: {},\n    _rowModelFns: { aggregationFns, filterFns, sortFns },\n    baseAtoms: {},\n    atoms: {},\n  } as unknown 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.wrapExternalAtoms && mergedOptions.atoms) {\n    for (const [atomKey, _atom] of Object.entries(mergedOptions.atoms)) {\n      const atom = _atom as Atom<any>\n      const wrappedAtom = _reactivity.createWritableAtom(atom.get(), {\n        debugName: `externalAtom/${atomKey}`,\n      })\n      ;(mergedOptions.atoms as any)[atomKey] = wrappedAtom\n      // Two-way syncing between the original atom and the wrapped one.\n      let syncExternal = false\n      const syncAtomToWrappedSub = atom.subscribe((value) => {\n        if (syncExternal) return\n        wrappedAtom.set(value)\n      })\n      const syncWrappedToAtomSub = wrappedAtom.subscribe((value) => {\n        syncExternal = true\n        atom.set(value)\n        syncExternal = false\n      })\n      _reactivity.addSubscription(syncAtomToWrappedSub)\n      _reactivity.addSubscription(syncWrappedToAtomSub)\n    }\n  }\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_All\n  >\n\n  for (let i = 0; i < stateKeys.length; i++) {\n    const key = stateKeys[i]!\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 externalAtoms = table.options.atoms as\n          | Partial<Record<keyof TableState_All, Atom<unknown>>>\n          | undefined\n        const externalAtom = externalAtoms?.[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> & TableState_All\n        for (let i = 0; i < stateKeys.length; i++) {\n          const key = stateKeys[i]!\n          ;(snapshot as Record<string, unknown>)[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.entries({\n      coreRowModel,\n      filteredRowModel,\n      groupedRowModel,\n      sortedRowModel,\n      expandedRowModel,\n      paginatedRowModel,\n      facetedRowModel,\n      facetedMinMaxValues,\n      facetedUniqueValues,\n    })\n      .filter(([, factory]) => factory)\n      .map(([key]) => key)\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 (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.constructTableAPIs?.(table)\n  }\n\n  return table\n}\n"],"mappings":";;;;;;;;;;;AAgBA,SAAgB,qBACd,UACA,eAA2D,CAAC,GACrC;CACvB,OAAO,OAAO,QAAQ,CAAC,CAAC,SAAS,YAAY;;EAC3C,yCAAe,QAAQ,6GAAkB,YAAY,MAAK;CAC5D,CAAC;CACD,OAAOA,yBAAW,YAAY;AAChC;;;;;;AAOA,SAAgB,eAGd,cAAuE;CACvE,MAAM,cAAc,aAAa,SAAS;CAK1C,MAAM,EACJ,gBACA,YAAY,aACZ,cACA,kBACA,qBACA,iBACA,qBACA,WACA,YAAY,aACZ,kBACA,iBACA,mBACA,SACA,gBACA,WAAW,YACX,GAAG,aACD,aAAa;CAEjB,MAAM,QAAQ;EACZ;EACA,WAAW;GAAE,GAAGC;GAAc,GAAG;EAAS;EAC1C,YAAY,CAAC;EACb,cAAc;GAAE;GAAgB;GAAW;EAAQ;EACnD,WAAW,CAAC;EACZ,OAAO,CAAC;CACV;CAEA,MAAM,eAAoC,OAAO,OAAO,MAAM,SAAS;CAMvE,MAAM,gBAAgB;EAAE,GAJD,aAAa,QAAQ,KAAK,YAAY;;GAC3D,OAAO,OAAO,OAAO,8BAAK,QAAQ,oHAAyB,KAAK,CAAC;EACnE,GAAG,CAAC,CAEoC;EAAG,GAAG;CAAa;CAE3D,IAAI,YAAY,qBAAqB,cAAc,OACjD,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,cAAc,KAAK,GAAG;EAClE,MAAM,OAAO;EACb,MAAM,cAAc,YAAY,mBAAmB,KAAK,IAAI,GAAG,EAC7D,WAAW,gBAAgB,UAC7B,CAAC;EACA,AAAC,cAAc,MAAc,WAAW;EAEzC,IAAI,eAAe;EACnB,MAAM,uBAAuB,KAAK,WAAW,UAAU;GACrD,IAAI,cAAc;GAClB,YAAY,IAAI,KAAK;EACvB,CAAC;EACD,MAAM,uBAAuB,YAAY,WAAW,UAAU;GAC5D,eAAe;GACf,KAAK,IAAI,KAAK;GACd,eAAe;EACjB,CAAC;EACD,YAAY,gBAAgB,oBAAoB;EAChD,YAAY,gBAAgB,oBAAoB;CAClD;CAGF,IAAI,YAAY,oBAAoB;EAElC,MAAM,eAAe,YAAY,mBAE/B,eAAe,EAAE,WAAW,qBAAqB,CAAC;EACpD,OAAO,eAAe,OAAO,WAAW;GACtC,cAAc;GACd,YAAY;GACZ,MAAM;IACJ,OAAO,MAAM,aAAc,IAAI;GACjC;GACA,IAAI,OAAO;IACT,MAAM,aAAc,UAAU,KAAK;GACrC;EACF,CAAC;CACH,OACE,MAAM,UAAU;CAGlB,MAAM,eAAe,qBACnB,MAAM,WACN,MAAM,QAAQ,YAChB;CAEA,MAAM,YAAY,OAAO,KAAK,MAAM,YAAY;CAIhD,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,MAAM,UAAU;EACtB,MAAM,UAAU,OAAO,YAAY,mBACjC,MAAM,aAAa,MACnB,EACE,WAAW,mBAAmB,MAChC,CACF;EAGC,AAAC,MAAM,MAAc,OAAO,YAAY,yBACjC;GACJ,MAAM,gBAAgB,MAAM,QAAQ;GAGpC,MAAM,6EAAe,cAAgB;GACrC,IAAI,cACF,OAAO,aAAa,IAAI;GAE1B,OAAO,MAAM,UAAU,IAAI,CAAE,IAAI;EACnC,GACA,EAAE,WAAW,eAAe,MAAM,CACpC;CACF;CAEA,mEAAmC,KAAK;CAExC,MAAM,QAAQC,gDACZ,YAAY,yBACJ;EACJ,MAAM,WAAW,CAAC;EAClB,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;GACzC,MAAM,MAAM,UAAU;GACrB,AAAC,SAAqC,OAAO,MAAM,MAAM,IAAI,CAAE,IAAI;EACtE;EACA,OAAO;CACT,GACA,EAAE,WAAW,cAAc,CAC7B,CACF;CAEA,IACE,QAAQ,IAAI,aAAa,kBACxB,aAAa,YAAY,aAAa,aACvC;EACA,MAAM,WAAW,OAAO,KAAK,MAAM,SAAS;EAC5C,MAAM,YAAY,OAAO,QAAQ;GAC/B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,CAAC,CAAC,CACC,QAAQ,GAAG,aAAa,OAAO,CAAC,CAChC,KAAK,CAAC,SAAS,GAAG;EACrB,MAAM,SAAS,OAAO,KAAK,MAAM,YAAY;EAE7C,QAAQ,IACN;;gBAEU,SAAS,KAAK,kBAAkB,EAAE;;gBAElC,UAAU,SAAS,UAAU,KAAK,kBAAkB,IAAI,SAAS;;gBAEjE,OAAO,KAAK,kBAAkB,EAAE,KAC1C,EAAE,MAAM,CACV;CACF;CAEA,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;;EAC5C,4CAAa,IAAI,iGAAqB,KAAK;CAC7C;CAEA,OAAO;AACT"}

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

@@ -0,0 +1,22 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { TableState } from "../../types/TableState.cjs";
+import { TableOptions } from "../../types/TableOptions.cjs";
+import { Table } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.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 };
+//# sourceMappingURL=constructTable.d.cts.map

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

@@ -0,0 +1,22 @@
+import { RowData } from "../../types/type-utils.js";
+import { TableState } from "../../types/TableState.js";
+import { TableOptions } from "../../types/TableOptions.js";
+import { Table } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.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 };
+//# sourceMappingURL=constructTable.d.ts.map

package/dist/core/table/constructTable.js

@@ -0,0 +1,132 @@
+import { cloneState } from "../../utils.js";
+import { table_syncExternalStateToBaseAtoms } from "./coreTablesFeature.utils.js";
+import { coreFeatures } from "../coreFeatures.js";
+import { atomToStore } from "../reactivity/coreReactivityFeature.utils.js";
+
+//#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;
+		initialState = ((_feature$getInitialSt = feature.getInitialState) === null || _feature$getInitialSt === void 0 ? void 0 : _feature$getInitialSt.call(feature, initialState)) ?? initialState;
+	});
+	return 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.coreReactivityFeature;
+	const { aggregationFns, columnMeta: _columnMeta, coreRowModel, expandedRowModel, facetedMinMaxValues, facetedRowModel, facetedUniqueValues, filterFns, filterMeta: _filterMeta, filteredRowModel, groupedRowModel, paginatedRowModel, sortFns, sortedRowModel, tableMeta: _tableMeta, ...features } = tableOptions.features;
+	const table = {
+		_reactivity,
+		_features: {
+			...coreFeatures,
+			...features
+		},
+		_rowModels: {},
+		_rowModelFns: {
+			aggregationFns,
+			filterFns,
+			sortFns
+		},
+		baseAtoms: {},
+		atoms: {}
+	};
+	const featuresList = Object.values(table._features);
+	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
+	};
+	if (_reactivity.wrapExternalAtoms && mergedOptions.atoms) for (const [atomKey, _atom] of Object.entries(mergedOptions.atoms)) {
+		const atom = _atom;
+		const wrappedAtom = _reactivity.createWritableAtom(atom.get(), { debugName: `externalAtom/${atomKey}` });
+		mergedOptions.atoms[atomKey] = wrappedAtom;
+		let syncExternal = false;
+		const syncAtomToWrappedSub = atom.subscribe((value) => {
+			if (syncExternal) return;
+			wrappedAtom.set(value);
+		});
+		const syncWrappedToAtomSub = wrappedAtom.subscribe((value) => {
+			syncExternal = true;
+			atom.set(value);
+			syncExternal = false;
+		});
+		_reactivity.addSubscription(syncAtomToWrappedSub);
+		_reactivity.addSubscription(syncWrappedToAtomSub);
+	}
+	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 (let i = 0; i < stateKeys.length; i++) {
+		const key = stateKeys[i];
+		table.baseAtoms[key] = _reactivity.createWritableAtom(table.initialState[key], { debugName: `table/baseAtoms/${key}` });
+		table.atoms[key] = _reactivity.createReadonlyAtom(() => {
+			const externalAtoms = table.options.atoms;
+			const externalAtom = externalAtoms === null || externalAtoms === void 0 ? void 0 : externalAtoms[key];
+			if (externalAtom) return externalAtom.get();
+			return table.baseAtoms[key].get();
+		}, { debugName: `table/atoms/${key}` });
+	}
+	table_syncExternalStateToBaseAtoms(table);
+	table.store = atomToStore(_reactivity.createReadonlyAtom(() => {
+		const snapshot = {};
+		for (let i = 0; i < stateKeys.length; i++) {
+			const key = stateKeys[i];
+			snapshot[key] = table.atoms[key].get();
+		}
+		return snapshot;
+	}, { debugName: "table/store" }));
+	if (process.env.NODE_ENV === "development" && (tableOptions.debugAll || tableOptions.debugTable)) {
+		const features = Object.keys(table._features);
+		const rowModels = Object.entries({
+			coreRowModel,
+			filteredRowModel,
+			groupedRowModel,
+			sortedRowModel,
+			expandedRowModel,
+			paginatedRowModel,
+			facetedRowModel,
+			facetedMinMaxValues,
+			facetedUniqueValues
+		}).filter(([, factory]) => factory).map(([key]) => key);
+		const states = Object.keys(table.initialState);
+		console.log(`Constructing Table Instance
+
+  Features:   ${features.join("\n              ")}
+
+  Row Models: ${rowModels.length ? rowModels.join("\n              ") : "(none)"}
+
+  States:     ${states.join("\n              ")}\n`, { table });
+	}
+	for (let i = 0; i < featuresList.length; i++) {
+		var _constructTableAPIs, _ref;
+		(_constructTableAPIs = (_ref = featuresList[i]).constructTableAPIs) === null || _constructTableAPIs === void 0 || _constructTableAPIs.call(_ref, table);
+	}
+	return table;
+}
+
+//#endregion
+export { constructTable, getInitialTableState };
+//# sourceMappingURL=constructTable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constructTable.js","names":[],"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 { Atom } from '@tanstack/store'\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, TableState_All } 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.coreReactivityFeature!\n\n  // Strip the non-feature slots: type-only meta slots, row model factories,\n  // and row model fn registries all live on the `features` option but are not\n  // table features themselves.\n  const {\n    aggregationFns,\n    columnMeta: _columnMeta,\n    coreRowModel,\n    expandedRowModel,\n    facetedMinMaxValues,\n    facetedRowModel,\n    facetedUniqueValues,\n    filterFns,\n    filterMeta: _filterMeta,\n    filteredRowModel,\n    groupedRowModel,\n    paginatedRowModel,\n    sortFns,\n    sortedRowModel,\n    tableMeta: _tableMeta,\n    ...features\n  } = tableOptions.features\n\n  const table = {\n    _reactivity,\n    _features: { ...coreFeatures, ...features },\n    _rowModels: {},\n    _rowModelFns: { aggregationFns, filterFns, sortFns },\n    baseAtoms: {},\n    atoms: {},\n  } as unknown 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.wrapExternalAtoms && mergedOptions.atoms) {\n    for (const [atomKey, _atom] of Object.entries(mergedOptions.atoms)) {\n      const atom = _atom as Atom<any>\n      const wrappedAtom = _reactivity.createWritableAtom(atom.get(), {\n        debugName: `externalAtom/${atomKey}`,\n      })\n      ;(mergedOptions.atoms as any)[atomKey] = wrappedAtom\n      // Two-way syncing between the original atom and the wrapped one.\n      let syncExternal = false\n      const syncAtomToWrappedSub = atom.subscribe((value) => {\n        if (syncExternal) return\n        wrappedAtom.set(value)\n      })\n      const syncWrappedToAtomSub = wrappedAtom.subscribe((value) => {\n        syncExternal = true\n        atom.set(value)\n        syncExternal = false\n      })\n      _reactivity.addSubscription(syncAtomToWrappedSub)\n      _reactivity.addSubscription(syncWrappedToAtomSub)\n    }\n  }\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_All\n  >\n\n  for (let i = 0; i < stateKeys.length; i++) {\n    const key = stateKeys[i]!\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 externalAtoms = table.options.atoms as\n          | Partial<Record<keyof TableState_All, Atom<unknown>>>\n          | undefined\n        const externalAtom = externalAtoms?.[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> & TableState_All\n        for (let i = 0; i < stateKeys.length; i++) {\n          const key = stateKeys[i]!\n          ;(snapshot as Record<string, unknown>)[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.entries({\n      coreRowModel,\n      filteredRowModel,\n      groupedRowModel,\n      sortedRowModel,\n      expandedRowModel,\n      paginatedRowModel,\n      facetedRowModel,\n      facetedMinMaxValues,\n      facetedUniqueValues,\n    })\n      .filter(([, factory]) => factory)\n      .map(([key]) => key)\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 (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.constructTableAPIs?.(table)\n  }\n\n  return table\n}\n"],"mappings":";;;;;;;;;;;AAgBA,SAAgB,qBACd,UACA,eAA2D,CAAC,GACrC;CACvB,OAAO,OAAO,QAAQ,CAAC,CAAC,SAAS,YAAY;;EAC3C,yCAAe,QAAQ,6GAAkB,YAAY,MAAK;CAC5D,CAAC;CACD,OAAO,WAAW,YAAY;AAChC;;;;;;AAOA,SAAgB,eAGd,cAAuE;CACvE,MAAM,cAAc,aAAa,SAAS;CAK1C,MAAM,EACJ,gBACA,YAAY,aACZ,cACA,kBACA,qBACA,iBACA,qBACA,WACA,YAAY,aACZ,kBACA,iBACA,mBACA,SACA,gBACA,WAAW,YACX,GAAG,aACD,aAAa;CAEjB,MAAM,QAAQ;EACZ;EACA,WAAW;GAAE,GAAG;GAAc,GAAG;EAAS;EAC1C,YAAY,CAAC;EACb,cAAc;GAAE;GAAgB;GAAW;EAAQ;EACnD,WAAW,CAAC;EACZ,OAAO,CAAC;CACV;CAEA,MAAM,eAAoC,OAAO,OAAO,MAAM,SAAS;CAMvE,MAAM,gBAAgB;EAAE,GAJD,aAAa,QAAQ,KAAK,YAAY;;GAC3D,OAAO,OAAO,OAAO,8BAAK,QAAQ,oHAAyB,KAAK,CAAC;EACnE,GAAG,CAAC,CAEoC;EAAG,GAAG;CAAa;CAE3D,IAAI,YAAY,qBAAqB,cAAc,OACjD,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,cAAc,KAAK,GAAG;EAClE,MAAM,OAAO;EACb,MAAM,cAAc,YAAY,mBAAmB,KAAK,IAAI,GAAG,EAC7D,WAAW,gBAAgB,UAC7B,CAAC;EACA,AAAC,cAAc,MAAc,WAAW;EAEzC,IAAI,eAAe;EACnB,MAAM,uBAAuB,KAAK,WAAW,UAAU;GACrD,IAAI,cAAc;GAClB,YAAY,IAAI,KAAK;EACvB,CAAC;EACD,MAAM,uBAAuB,YAAY,WAAW,UAAU;GAC5D,eAAe;GACf,KAAK,IAAI,KAAK;GACd,eAAe;EACjB,CAAC;EACD,YAAY,gBAAgB,oBAAoB;EAChD,YAAY,gBAAgB,oBAAoB;CAClD;CAGF,IAAI,YAAY,oBAAoB;EAElC,MAAM,eAAe,YAAY,mBAE/B,eAAe,EAAE,WAAW,qBAAqB,CAAC;EACpD,OAAO,eAAe,OAAO,WAAW;GACtC,cAAc;GACd,YAAY;GACZ,MAAM;IACJ,OAAO,MAAM,aAAc,IAAI;GACjC;GACA,IAAI,OAAO;IACT,MAAM,aAAc,UAAU,KAAK;GACrC;EACF,CAAC;CACH,OACE,MAAM,UAAU;CAGlB,MAAM,eAAe,qBACnB,MAAM,WACN,MAAM,QAAQ,YAChB;CAEA,MAAM,YAAY,OAAO,KAAK,MAAM,YAAY;CAIhD,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,MAAM,UAAU;EACtB,MAAM,UAAU,OAAO,YAAY,mBACjC,MAAM,aAAa,MACnB,EACE,WAAW,mBAAmB,MAChC,CACF;EAGC,AAAC,MAAM,MAAc,OAAO,YAAY,yBACjC;GACJ,MAAM,gBAAgB,MAAM,QAAQ;GAGpC,MAAM,6EAAe,cAAgB;GACrC,IAAI,cACF,OAAO,aAAa,IAAI;GAE1B,OAAO,MAAM,UAAU,IAAI,CAAE,IAAI;EACnC,GACA,EAAE,WAAW,eAAe,MAAM,CACpC;CACF;CAEA,mCAAmC,KAAK;CAExC,MAAM,QAAQ,YACZ,YAAY,yBACJ;EACJ,MAAM,WAAW,CAAC;EAClB,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;GACzC,MAAM,MAAM,UAAU;GACrB,AAAC,SAAqC,OAAO,MAAM,MAAM,IAAI,CAAE,IAAI;EACtE;EACA,OAAO;CACT,GACA,EAAE,WAAW,cAAc,CAC7B,CACF;CAEA,IACE,QAAQ,IAAI,aAAa,kBACxB,aAAa,YAAY,aAAa,aACvC;EACA,MAAM,WAAW,OAAO,KAAK,MAAM,SAAS;EAC5C,MAAM,YAAY,OAAO,QAAQ;GAC/B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,CAAC,CAAC,CACC,QAAQ,GAAG,aAAa,OAAO,CAAC,CAChC,KAAK,CAAC,SAAS,GAAG;EACrB,MAAM,SAAS,OAAO,KAAK,MAAM,YAAY;EAE7C,QAAQ,IACN;;gBAEU,SAAS,KAAK,kBAAkB,EAAE;;gBAElC,UAAU,SAAS,UAAU,KAAK,kBAAkB,IAAI,SAAS;;gBAEjE,OAAO,KAAK,kBAAkB,EAAE,KAC1C,EAAE,MAAM,CACV;CACF;CAEA,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;;EAC5C,4CAAa,IAAI,iGAAqB,KAAK;CAC7C;CAEA,OAAO;AACT"}

package/dist/core/table/coreTablesFeature.cjs

@@ -0,0 +1,17 @@
+const require_utils = require('../../utils.cjs');
+const require_coreTablesFeature_utils = require('./coreTablesFeature.utils.cjs');
+
+//#region src/core/table/coreTablesFeature.ts
+/**
+* Core feature that adds base table instance APIs such as reset and setOptions.
+*/
+const coreTablesFeature = { constructTableAPIs: (table) => {
+	require_utils.assignTableAPIs("coreTablesFeature", table, {
+		table_reset: { fn: () => require_coreTablesFeature_utils.table_reset(table) },
+		table_setOptions: { fn: (updater) => require_coreTablesFeature_utils.table_setOptions(table, updater) }
+	});
+} };
+
+//#endregion
+exports.coreTablesFeature = coreTablesFeature;
+//# sourceMappingURL=coreTablesFeature.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreTablesFeature.cjs","names":["table_reset","table_setOptions"],"sources":["../../../src/core/table/coreTablesFeature.ts"],"sourcesContent":["import { assignTableAPIs } from '../../utils'\nimport { table_reset, table_setOptions } from './coreTablesFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Core feature that adds base table instance APIs such as reset and setOptions.\n */\nexport const coreTablesFeature: TableFeature = {\n  constructTableAPIs: (table) => {\n    assignTableAPIs('coreTablesFeature', table, {\n      table_reset: {\n        fn: () => table_reset(table),\n      },\n      table_setOptions: {\n        fn: (updater) => table_setOptions(table, updater),\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAOA,MAAa,oBAAkC,EAC7C,qBAAqB,UAAU;CAC7B,8BAAgB,qBAAqB,OAAO;EAC1C,aAAa,EACX,UAAUA,4CAAY,KAAK,EAC7B;EACA,kBAAkB,EAChB,KAAK,YAAYC,iDAAiB,OAAO,OAAO,EAClD;CACF,CAAC;AACH,EACF"}

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

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.cjs";
+
+//#region src/core/table/coreTablesFeature.d.ts
+/**
+ * Core feature that adds base table instance APIs such as reset and setOptions.
+ */
+declare const coreTablesFeature: TableFeature;
+//#endregion
+export { coreTablesFeature };
+//# sourceMappingURL=coreTablesFeature.d.cts.map

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

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.js";
+
+//#region src/core/table/coreTablesFeature.d.ts
+/**
+ * Core feature that adds base table instance APIs such as reset and setOptions.
+ */
+declare const coreTablesFeature: TableFeature;
+//#endregion
+export { coreTablesFeature };
+//# sourceMappingURL=coreTablesFeature.d.ts.map

package/dist/core/table/coreTablesFeature.js

@@ -0,0 +1,17 @@
+import { assignTableAPIs } from "../../utils.js";
+import { table_reset, table_setOptions } from "./coreTablesFeature.utils.js";
+
+//#region src/core/table/coreTablesFeature.ts
+/**
+* Core feature that adds base table instance APIs such as reset and setOptions.
+*/
+const coreTablesFeature = { constructTableAPIs: (table) => {
+	assignTableAPIs("coreTablesFeature", table, {
+		table_reset: { fn: () => table_reset(table) },
+		table_setOptions: { fn: (updater) => table_setOptions(table, updater) }
+	});
+} };
+
+//#endregion
+export { coreTablesFeature };
+//# sourceMappingURL=coreTablesFeature.js.map

package/dist/core/table/coreTablesFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreTablesFeature.js","names":[],"sources":["../../../src/core/table/coreTablesFeature.ts"],"sourcesContent":["import { assignTableAPIs } from '../../utils'\nimport { table_reset, table_setOptions } from './coreTablesFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Core feature that adds base table instance APIs such as reset and setOptions.\n */\nexport const coreTablesFeature: TableFeature = {\n  constructTableAPIs: (table) => {\n    assignTableAPIs('coreTablesFeature', table, {\n      table_reset: {\n        fn: () => table_reset(table),\n      },\n      table_setOptions: {\n        fn: (updater) => table_setOptions(table, updater),\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAOA,MAAa,oBAAkC,EAC7C,qBAAqB,UAAU;CAC7B,gBAAgB,qBAAqB,OAAO;EAC1C,aAAa,EACX,UAAU,YAAY,KAAK,EAC7B;EACA,kBAAkB,EAChB,KAAK,YAAY,iBAAiB,OAAO,OAAO,EAClD;CACF,CAAC;AACH,EACF"}