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

package/dist/core/table/constructTable.cjs

@@ -4,6 +4,11 @@ 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;
@@ -11,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 = {
@@ -47,7 +57,8 @@ function constructTable(tableOptions) {
 	} else table.options = mergedOptions;
 	table.initialState = getInitialTableState(table._features, table.options.initialState);
 	const stateKeys = Object.keys(table.initialState);
-	for (const key of stateKeys) {
+	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(() => {
 			var _table$options$atoms;
@@ -59,7 +70,10 @@ function constructTable(tableOptions) {
 	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();
+		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)) {
@@ -74,9 +88,9 @@ function constructTable(tableOptions) {
 
   States:     ${states.join("\n              ")}\n`, { table });
 	}
-	for (const feature of featuresList) {
-		var _feature$constructTab;
-		(_feature$constructTab = feature.constructTableAPIs) === null || _feature$constructTab === void 0 || _feature$constructTab.call(feature, 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;
 }

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 { 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\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    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":";;;;;;AAUA,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,WAAW,EAAE;EACb,OAAO,EAAE;EACV;CAED,MAAM,eAAwC,OAAO,OAAO,MAAM,UAAU;CAM5E,MAAM,gBAAgB;EAAE,GAJD,aAAa,QAAQ,KAAK,YAAY;;AAC3D,UAAO,OAAO,OAAO,8BAAK,QAAQ,oHAAyB,MAAM,CAAC;KACjE,EAAE,CAEoC;EAAE,GAAG;EAAc;AAE5D,KAAI,YAAY,oBAAoB;AAElC,QAAM,eAAe,YAAY,mBAE/B,eAAe,EAAE,WAAW,sBAAsB,CAAC;AACrD,SAAO,eAAe,OAAO,WAAW;GACtC,cAAc;GACd,YAAY;GACZ,MAAM;AACJ,WAAO,MAAM,aAAc,KAAK;;GAElC,IAAI,OAAO;AACT,UAAM,aAAc,UAAU,MAAM;;GAEvC,CAAC;OAEF,OAAM,UAAU;AAGlB,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;;GACJ,MAAM,uCAAe,MAAM,QAAQ,mFAAQ;AAC3C,OAAI,aACF,QAAO,aAAa,KAAK;AAE3B,UAAO,MAAM,UAAU,KAAK,KAAK;KAEnC,EAAE,WAAW,eAAe,OAAO,CACpC;;AAGH,oEAAmC,MAAM;AAEzC,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,CAAC,KAC1C,EAAE,OAAO,CACV;;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 (let i = 0; i < stateKeys.length; i++) {\n    const key = stateKeys[i]!\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 (let i = 0; i < stateKeys.length; i++) {\n          const key = stateKeys[i]!\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 (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.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,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,MAAM,UAAU;EAEtB,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,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;GACzC,MAAM,MAAM,UAAU;GACtB,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,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;;EAC5C,4CAAa,IAAI,iGAAqB,MAAM;;CAG9C,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 };

package/dist/core/table/constructTable.js

@@ -4,6 +4,11 @@ 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;
@@ -11,6 +16,11 @@ function getInitialTableState(features, 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.coreReativityFeature;
 	const table = {
@@ -47,7 +57,8 @@ function constructTable(tableOptions) {
 	} else table.options = mergedOptions;
 	table.initialState = getInitialTableState(table._features, table.options.initialState);
 	const stateKeys = Object.keys(table.initialState);
-	for (const key of stateKeys) {
+	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(() => {
 			var _table$options$atoms;
@@ -59,7 +70,10 @@ function constructTable(tableOptions) {
 	table_syncExternalStateToBaseAtoms(table);
 	table.store = atomToStore(_reactivity.createReadonlyAtom(() => {
 		const snapshot = {};
-		for (const key of stateKeys) snapshot[key] = table.atoms[key].get();
+		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)) {
@@ -74,9 +88,9 @@ function constructTable(tableOptions) {
 
   States:     ${states.join("\n              ")}\n`, { table });
 	}
-	for (const feature of featuresList) {
-		var _feature$constructTab;
-		(_feature$constructTab = feature.constructTableAPIs) === null || _feature$constructTab === void 0 || _feature$constructTab.call(feature, 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;
 }

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

@@ -1 +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 { 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    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":";;;;;;AAUA,SAAgB,qBACd,UACA,eAA2D,EAAE,EACtC;AACvB,QAAO,OAAO,SAAS,CAAC,SAAS,YAAY;;AAC3C,2CAAe,QAAQ,6GAAkB,aAAa,KAAI;GAC1D;AACF,QAAO,WAAW,aAAa;;AAGjC,SAAgB,eAGd,cAAuE;CACvE,MAAM,cAAc,aAAa,UAAU;CAE3C,MAAM,QAAQ;EACZ;EACA,WAAW;GAAE,GAAG;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;;AAC3D,UAAO,OAAO,OAAO,8BAAK,QAAQ,oHAAyB,MAAM,CAAC;KACjE,EAAE,CAEoC;EAAE,GAAG;EAAc;AAE5D,KAAI,YAAY,oBAAoB;AAElC,QAAM,eAAe,YAAY,mBAE/B,eAAe,EAAE,WAAW,sBAAsB,CAAC;AACrD,SAAO,eAAe,OAAO,WAAW;GACtC,cAAc;GACd,YAAY;GACZ,MAAM;AACJ,WAAO,MAAM,aAAc,KAAK;;GAElC,IAAI,OAAO;AACT,UAAM,aAAc,UAAU,MAAM;;GAEvC,CAAC;OAEF,OAAM,UAAU;AAGlB,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;;GACJ,MAAM,uCAAe,MAAM,QAAQ,mFAAQ;AAC3C,OAAI,aACF,QAAO,aAAa,KAAK;AAE3B,UAAO,MAAM,UAAU,KAAK,KAAK;KAEnC,EAAE,WAAW,eAAe,OAAO,CACpC;;AAGH,oCAAmC,MAAM;AAEzC,OAAM,QAAQ,YACZ,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,CAAC,KAC1C,EAAE,OAAO,CACV;;AAGH,MAAK,MAAM,WAAW,cAAc;;AAClC,mCAAQ,wGAAqB,MAAM;;AAGrC,QAAO"}
+{"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 { 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 (let i = 0; i < stateKeys.length; i++) {\n    const key = stateKeys[i]!\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 (let i = 0; i < stateKeys.length; i++) {\n          const key = stateKeys[i]!\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 (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.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,OAAO,WAAW,aAAa;;;;;;;AAQjC,SAAgB,eAGd,cAAuE;CACvE,MAAM,cAAc,aAAa,UAAU;CAE3C,MAAM,QAAQ;EACZ;EACA,WAAW;GAAE,GAAG;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,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,MAAM,UAAU;EAEtB,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,mCAAmC,MAAM;CAEzC,MAAM,QAAQ,YACZ,YAAY,yBACJ;EACJ,MAAM,WAAW,EAAE;EACnB,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;GACzC,MAAM,MAAM,UAAU;GACtB,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,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;;EAC5C,4CAAa,IAAI,iGAAqB,MAAM;;CAG9C,OAAO"}

package/dist/core/table/coreTablesFeature.cjs

@@ -2,6 +2,11 @@ const require_utils = require('../../utils.cjs');
 const require_coreTablesFeature_utils = require('./coreTablesFeature.utils.cjs');
 
 //#region src/core/table/coreTablesFeature.ts
+/**
+* Creates the stock core tables feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
 function constructCoreTablesFeature() {
 	return { constructTableAPIs: (table) => {
 		require_utils.assignTableAPIs("coreTablesFeature", table, {

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

@@ -1 +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 { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type { TableOptions_Table, Table_Table } from './coreTablesFeature.types'\n\nexport interface CoreTablesFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Table: Table_Table<TFeatures, TData>\n  // TableOptions: TableOptions_Table<TFeatures, TData>\n}\n\nexport function constructCoreTablesFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<CoreTablesFeatureConstructors<TFeatures, TData>> {\n  return {\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}\n\n/**\n * The Core Tables feature provides the core table functionality for handling state and options.\n */\nexport const coreTablesFeature = constructCoreTablesFeature()\n"],"mappings":";;;;AAcA,SAAgB,6BAGmD;AACjE,QAAO,EACL,qBAAqB,UAAU;AAC7B,gCAAgB,qBAAqB,OAAO;GAC1C,aAAa,EACX,UAAUA,4CAAY,MAAM,EAC7B;GACD,kBAAkB,EAChB,KAAK,YAAYC,iDAAiB,OAAO,QAAQ,EAClD;GACF,CAAC;IAEL;;;;;AAMH,MAAa,oBAAoB,4BAA4B"}
+{"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 { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type { TableOptions_Table, Table_Table } from './coreTablesFeature.types'\n\nexport interface CoreTablesFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Table: Table_Table<TFeatures, TData>\n  // TableOptions: TableOptions_Table<TFeatures, TData>\n}\n\n/**\n * Creates the stock core tables feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructCoreTablesFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<CoreTablesFeatureConstructors<TFeatures, TData>> {\n  return {\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}\n\n/**\n * The Core Tables feature provides the core table functionality for handling state and options.\n */\nexport const coreTablesFeature = constructCoreTablesFeature()\n"],"mappings":";;;;;;;;;AAmBA,SAAgB,6BAGmD;CACjE,OAAO,EACL,qBAAqB,UAAU;EAC7B,8BAAgB,qBAAqB,OAAO;GAC1C,aAAa,EACX,UAAUA,4CAAY,MAAM,EAC7B;GACD,kBAAkB,EAChB,KAAK,YAAYC,iDAAiB,OAAO,QAAQ,EAClD;GACF,CAAC;IAEL;;;;;AAMH,MAAa,oBAAoB,4BAA4B"}

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

@@ -3,6 +3,11 @@ import { TableFeature, TableFeatures } from "../../types/TableFeatures.cjs";
 
 //#region src/core/table/coreTablesFeature.d.ts
 interface CoreTablesFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock core tables feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 declare function constructCoreTablesFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<CoreTablesFeatureConstructors<TFeatures, TData>>;
 /**
  * The Core Tables feature provides the core table functionality for handling state and options.

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

@@ -3,6 +3,11 @@ import { TableFeature, TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/table/coreTablesFeature.d.ts
 interface CoreTablesFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock core tables feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 declare function constructCoreTablesFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<CoreTablesFeatureConstructors<TFeatures, TData>>;
 /**
  * The Core Tables feature provides the core table functionality for handling state and options.

package/dist/core/table/coreTablesFeature.js

@@ -2,6 +2,11 @@ import { assignTableAPIs } from "../../utils.js";
 import { table_reset, table_setOptions } from "./coreTablesFeature.utils.js";
 
 //#region src/core/table/coreTablesFeature.ts
+/**
+* Creates the stock core tables feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
 function constructCoreTablesFeature() {
 	return { constructTableAPIs: (table) => {
 		assignTableAPIs("coreTablesFeature", table, {

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

@@ -1 +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 { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type { TableOptions_Table, Table_Table } from './coreTablesFeature.types'\n\nexport interface CoreTablesFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Table: Table_Table<TFeatures, TData>\n  // TableOptions: TableOptions_Table<TFeatures, TData>\n}\n\nexport function constructCoreTablesFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<CoreTablesFeatureConstructors<TFeatures, TData>> {\n  return {\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}\n\n/**\n * The Core Tables feature provides the core table functionality for handling state and options.\n */\nexport const coreTablesFeature = constructCoreTablesFeature()\n"],"mappings":";;;;AAcA,SAAgB,6BAGmD;AACjE,QAAO,EACL,qBAAqB,UAAU;AAC7B,kBAAgB,qBAAqB,OAAO;GAC1C,aAAa,EACX,UAAU,YAAY,MAAM,EAC7B;GACD,kBAAkB,EAChB,KAAK,YAAY,iBAAiB,OAAO,QAAQ,EAClD;GACF,CAAC;IAEL;;;;;AAMH,MAAa,oBAAoB,4BAA4B"}
+{"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 { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type { TableOptions_Table, Table_Table } from './coreTablesFeature.types'\n\nexport interface CoreTablesFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Table: Table_Table<TFeatures, TData>\n  // TableOptions: TableOptions_Table<TFeatures, TData>\n}\n\n/**\n * Creates the stock core tables feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructCoreTablesFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<CoreTablesFeatureConstructors<TFeatures, TData>> {\n  return {\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}\n\n/**\n * The Core Tables feature provides the core table functionality for handling state and options.\n */\nexport const coreTablesFeature = constructCoreTablesFeature()\n"],"mappings":";;;;;;;;;AAmBA,SAAgB,6BAGmD;CACjE,OAAO,EACL,qBAAqB,UAAU;EAC7B,gBAAgB,qBAAqB,OAAO;GAC1C,aAAa,EACX,UAAU,YAAY,MAAM,EAC7B;GACD,kBAAkB,EAChB,KAAK,YAAY,iBAAiB,OAAO,QAAQ,EAClD;GACF,CAAC;IAEL;;;;;AAMH,MAAa,oBAAoB,4BAA4B"}

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

@@ -54,9 +54,9 @@ interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowD
   /**
    * Optionally, provide your own external writable atoms for individual state slices.
    * When an atom is provided for a given slice, it takes precedence over `options.state[key]`
-   * and the internal base atom for that slice. Writes originating from the library are
-   * still routed through the internal base atom; consumers are responsible for
-   * mirroring changes back to their external atom via the corresponding `onXChange` callback.
+   * and the internal base atom for that slice. Feature state update APIs write through
+   * the corresponding atom updater, so external atoms are the preferred v9 ownership
+   * model for app-managed table state slices.
    */
   readonly atoms?: ExternalAtoms<TFeatures>;
   /**
@@ -68,8 +68,10 @@ interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowD
    */
   readonly data: ReadonlyArray<TData>;
   /**
-   * Use this option to optionally pass initial state to the table. This state will be used when resetting various table states either automatically by the table (eg. `options.autoResetPageIndex`) or via functions like `table.resetRowSelection()`. Most reset function allow you optionally pass a flag to reset to a blank/default state instead of the initial state.
-   * Table state will not be reset when this object changes, which also means that the initial state object does not need to be stable.
+   * Optionally provide starting values for registered table state slices.
+   * Feature reset APIs use this value by default, and many reset APIs accept
+   * `true` to reset to that feature's blank/default state instead. Changing this
+   * object later does not reset table state, so it does not need to be stable.
    */
   readonly initialState?: Partial<TableState<TFeatures>>;
   /**
@@ -81,7 +83,11 @@ interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowD
    */
   readonly meta?: TableMeta<TFeatures, TData>;
   /**
-   * Pass in individual self-managed state to the table.
+   * Optionally provide externally managed values for individual state slices.
+   *
+   * Pair each slice with its matching `on[State]Change` callback so table state
+   * updates can be persisted outside the table. External atoms take precedence
+   * over this option when both are provided for the same slice.
    */
   readonly state?: Partial<TableState<TFeatures>>;
 }
@@ -138,10 +144,9 @@ interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends Ro
    */
   readonly options: TableOptions<TFeatures, TData>;
   /**
-   * Writable atom for table options. Only created when `createOptionsStore` is true
-   * on `coreReativityFeature` (e.g. Lit, Vue, Solid). React/Preact use `createOptionsStore: false`:
-   * options are held as plain data with a lightweight revision + subscribe source; there is
-   * no writable atom backing the full options object. Use {@link getTableOptionsStore} to subscribe.
+   * Writable atom for table options. Only created when `createOptionsStore` is
+   * true on the active core reactivity bindings. Adapters that opt out keep
+   * options as plain resolved data instead of backing them with an atom.
    */
   readonly optionsStore?: Atom<TableOptions<TFeatures, TData>> | undefined;
   /**
@@ -152,11 +157,16 @@ interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends Ro
 }
 interface Table_Table<TFeatures extends TableFeatures, TData extends RowData> extends Table_CoreProperties<TFeatures, TData> {
   /**
-   * Call this function to reset the table state to the initial state.
+   * Resets the table's internal base atoms to `table.initialState`.
+   *
+   * Prefer feature-specific reset APIs, such as `resetPagination`, when a state
+   * slice may be owned by an external atom or needs that feature's blank/default
+   * reset behavior.
    */
   reset: () => void;
   /**
-   * This function can be used to update the table options.
+   * Updates the table options by applying a value or updater to the current
+   * resolved options and then merging them through `options.mergeOptions`.
    */
   setOptions: (newOptions: Updater<TableOptions<TFeatures, TData>>) => void;
 }

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

@@ -54,9 +54,9 @@ interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowD
   /**
    * Optionally, provide your own external writable atoms for individual state slices.
    * When an atom is provided for a given slice, it takes precedence over `options.state[key]`
-   * and the internal base atom for that slice. Writes originating from the library are
-   * still routed through the internal base atom; consumers are responsible for
-   * mirroring changes back to their external atom via the corresponding `onXChange` callback.
+   * and the internal base atom for that slice. Feature state update APIs write through
+   * the corresponding atom updater, so external atoms are the preferred v9 ownership
+   * model for app-managed table state slices.
    */
   readonly atoms?: ExternalAtoms<TFeatures>;
   /**
@@ -68,8 +68,10 @@ interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowD
    */
   readonly data: ReadonlyArray<TData>;
   /**
-   * Use this option to optionally pass initial state to the table. This state will be used when resetting various table states either automatically by the table (eg. `options.autoResetPageIndex`) or via functions like `table.resetRowSelection()`. Most reset function allow you optionally pass a flag to reset to a blank/default state instead of the initial state.
-   * Table state will not be reset when this object changes, which also means that the initial state object does not need to be stable.
+   * Optionally provide starting values for registered table state slices.
+   * Feature reset APIs use this value by default, and many reset APIs accept
+   * `true` to reset to that feature's blank/default state instead. Changing this
+   * object later does not reset table state, so it does not need to be stable.
    */
   readonly initialState?: Partial<TableState<TFeatures>>;
   /**
@@ -81,7 +83,11 @@ interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowD
    */
   readonly meta?: TableMeta<TFeatures, TData>;
   /**
-   * Pass in individual self-managed state to the table.
+   * Optionally provide externally managed values for individual state slices.
+   *
+   * Pair each slice with its matching `on[State]Change` callback so table state
+   * updates can be persisted outside the table. External atoms take precedence
+   * over this option when both are provided for the same slice.
    */
   readonly state?: Partial<TableState<TFeatures>>;
 }
@@ -138,10 +144,9 @@ interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends Ro
    */
   readonly options: TableOptions<TFeatures, TData>;
   /**
-   * Writable atom for table options. Only created when `createOptionsStore` is true
-   * on `coreReativityFeature` (e.g. Lit, Vue, Solid). React/Preact use `createOptionsStore: false`:
-   * options are held as plain data with a lightweight revision + subscribe source; there is
-   * no writable atom backing the full options object. Use {@link getTableOptionsStore} to subscribe.
+   * Writable atom for table options. Only created when `createOptionsStore` is
+   * true on the active core reactivity bindings. Adapters that opt out keep
+   * options as plain resolved data instead of backing them with an atom.
    */
   readonly optionsStore?: Atom<TableOptions<TFeatures, TData>> | undefined;
   /**
@@ -152,11 +157,16 @@ interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends Ro
 }
 interface Table_Table<TFeatures extends TableFeatures, TData extends RowData> extends Table_CoreProperties<TFeatures, TData> {
   /**
-   * Call this function to reset the table state to the initial state.
+   * Resets the table's internal base atoms to `table.initialState`.
+   *
+   * Prefer feature-specific reset APIs, such as `resetPagination`, when a state
+   * slice may be owned by an external atom or needs that feature's blank/default
+   * reset behavior.
    */
   reset: () => void;
   /**
-   * This function can be used to update the table options.
+   * Updates the table options by applying a value or updater to the current
+   * resolved options and then merging them through `options.mergeOptions`.
    */
   setOptions: (newOptions: Updater<TableOptions<TFeatures, TData>>) => void;
 }

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

@@ -1,6 +1,17 @@
 const require_utils = require('../../utils.cjs');
 
 //#region src/core/table/coreTablesFeature.utils.ts
+/**
+* Synchronizes externally controlled state slices into the table's base atoms.
+*
+* This keeps legacy `options.state` values reflected in the atom graph so
+* derived atoms, stores, and table APIs read a consistent snapshot.
+*
+* @example
+* ```ts
+* const value = table_syncExternalStateToBaseAtoms(table)
+* ```
+*/
 function table_syncExternalStateToBaseAtoms(table) {
 	const state = table.options.state;
 	if (!state) return;
@@ -13,12 +24,38 @@ function table_syncExternalStateToBaseAtoms(table) {
 		}
 	});
 }
+/**
+* Resets all internal table base atoms to `table.initialState`.
+*
+* This resets internally owned state slices in a single reactivity batch. Use
+* feature-specific reset APIs when a slice may be externally owned.
+*
+* @example
+* ```ts
+* table_reset(table)
+* ```
+*/
 function table_reset(table) {
 	const snap = require_utils.cloneState(table.initialState);
 	table._reactivity.batch(() => {
-		for (const key of Object.keys(snap)) table.baseAtoms[key].set(snap[key]);
+		const keys = Object.keys(snap);
+		for (let i = 0; i < keys.length; i++) {
+			const key = keys[i];
+			table.baseAtoms[key].set(snap[key]);
+		}
 	});
 }
+/**
+* Merges new table options with the current resolved options.
+*
+* If `options.mergeOptions` is provided, it owns the merge behavior; otherwise
+* options are shallow-merged.
+*
+* @example
+* ```ts
+* const value = table_mergeOptions(table)
+* ```
+*/
 function table_mergeOptions(table, newOptions) {
 	if (table.options.mergeOptions) return table.options.mergeOptions(table.options, newOptions);
 	return {
@@ -26,6 +63,17 @@ function table_mergeOptions(table, newOptions) {
 		...newOptions
 	};
 }
+/**
+* Updates the table options object.
+*
+* The updater receives the current resolved options and the merged result is
+* immediately assigned to the table instance.
+*
+* @example
+* ```ts
+* table_setOptions(table, (old) => old)
+* ```
+*/
 function table_setOptions(table, updater) {
 	const mergedOptions = table_mergeOptions(table, require_utils.functionalUpdate(updater, table.options));
 	if (table.optionsStore) table.optionsStore.set(() => mergedOptions);

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

@@ -1 +1 @@
-{"version":3,"file":"coreTablesFeature.utils.cjs","names":["cloneState","functionalUpdate"],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { cloneState, functionalUpdate } from '../../utils'\nimport type { RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\n\nexport function table_syncExternalStateToBaseAtoms<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const state = table.options.state\n  if (!state) {\n    return\n  }\n\n  table._reactivity.batch(() => {\n    for (const key in state) {\n      const baseAtom = (table.baseAtoms as Record<string, any>)[key]\n      if (!baseAtom) {\n        continue\n      }\n\n      const externalState = state[key as keyof typeof state]\n      if (externalState !== baseAtom.get()) {\n        baseAtom.set(() => externalState)\n      }\n    }\n  })\n}\n\nexport function table_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const snap = cloneState(table.initialState)\n  table._reactivity.batch(() => {\n    for (const key of Object.keys(snap) as Array<keyof typeof snap>) {\n      ;(table.baseAtoms as any)[key].set(snap[key] as any)\n    }\n  })\n}\n\nexport function table_mergeOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  newOptions: TableOptions<TFeatures, TData>,\n) {\n  if (table.options.mergeOptions) {\n    return table.options.mergeOptions(table.options, newOptions)\n  }\n\n  return {\n    ...table.options,\n    ...newOptions,\n  }\n}\n\nexport function table_setOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<TableOptions<TFeatures, TData>>,\n): void {\n  const newOptions = functionalUpdate(updater, table.options)\n  const mergedOptions = table_mergeOptions(table, newOptions)\n  if (table.optionsStore) {\n    table.optionsStore.set(() => mergedOptions)\n  } else {\n    table.options = mergedOptions\n  }\n  table_syncExternalStateToBaseAtoms(table)\n}\n"],"mappings":";;;AAMA,SAAgB,mCAGd,OAA+C;CAC/C,MAAM,QAAQ,MAAM,QAAQ;AAC5B,KAAI,CAAC,MACH;AAGF,OAAM,YAAY,YAAY;AAC5B,OAAK,MAAM,OAAO,OAAO;GACvB,MAAM,WAAY,MAAM,UAAkC;AAC1D,OAAI,CAAC,SACH;GAGF,MAAM,gBAAgB,MAAM;AAC5B,OAAI,kBAAkB,SAAS,KAAK,CAClC,UAAS,UAAU,cAAc;;GAGrC;;AAGJ,SAAgB,YAGd,OAA+C;CAC/C,MAAM,OAAOA,yBAAW,MAAM,aAAa;AAC3C,OAAM,YAAY,YAAY;AAC5B,OAAK,MAAM,OAAO,OAAO,KAAK,KAAK,CAChC,CAAC,MAAM,UAAkB,KAAK,IAAI,KAAK,KAAY;GAEtD;;AAGJ,SAAgB,mBAId,OACA,YACA;AACA,KAAI,MAAM,QAAQ,aAChB,QAAO,MAAM,QAAQ,aAAa,MAAM,SAAS,WAAW;AAG9D,QAAO;EACL,GAAG,MAAM;EACT,GAAG;EACJ;;AAGH,SAAgB,iBAId,OACA,SACM;CAEN,MAAM,gBAAgB,mBAAmB,OADtBC,+BAAiB,SAAS,MAAM,QACO,CAAC;AAC3D,KAAI,MAAM,aACR,OAAM,aAAa,UAAU,cAAc;KAE3C,OAAM,UAAU;AAElB,oCAAmC,MAAM"}
+{"version":3,"file":"coreTablesFeature.utils.cjs","names":["cloneState","functionalUpdate"],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { cloneState, functionalUpdate } from '../../utils'\nimport type { RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\n\n/**\n * Synchronizes externally controlled state slices into the table's base atoms.\n *\n * This keeps legacy `options.state` values reflected in the atom graph so\n * derived atoms, stores, and table APIs read a consistent snapshot.\n *\n * @example\n * ```ts\n * const value = table_syncExternalStateToBaseAtoms(table)\n * ```\n */\nexport function table_syncExternalStateToBaseAtoms<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const state = table.options.state\n  if (!state) {\n    return\n  }\n\n  table._reactivity.batch(() => {\n    for (const key in state) {\n      const baseAtom = (table.baseAtoms as Record<string, any>)[key]\n      if (!baseAtom) {\n        continue\n      }\n\n      const externalState = state[key as keyof typeof state]\n      if (externalState !== baseAtom.get()) {\n        baseAtom.set(() => externalState)\n      }\n    }\n  })\n}\n\n/**\n * Resets all internal table base atoms to `table.initialState`.\n *\n * This resets internally owned state slices in a single reactivity batch. Use\n * feature-specific reset APIs when a slice may be externally owned.\n *\n * @example\n * ```ts\n * table_reset(table)\n * ```\n */\nexport function table_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const snap = cloneState(table.initialState)\n  table._reactivity.batch(() => {\n    const keys = Object.keys(snap) as Array<keyof typeof snap>\n    for (let i = 0; i < keys.length; i++) {\n      const key = keys[i]!\n      ;(table.baseAtoms as any)[key].set(snap[key] as any)\n    }\n  })\n}\n\n/**\n * Merges new table options with the current resolved options.\n *\n * If `options.mergeOptions` is provided, it owns the merge behavior; otherwise\n * options are shallow-merged.\n *\n * @example\n * ```ts\n * const value = table_mergeOptions(table)\n * ```\n */\nexport function table_mergeOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  newOptions: TableOptions<TFeatures, TData>,\n) {\n  if (table.options.mergeOptions) {\n    return table.options.mergeOptions(table.options, newOptions)\n  }\n\n  return {\n    ...table.options,\n    ...newOptions,\n  }\n}\n\n/**\n * Updates the table options object.\n *\n * The updater receives the current resolved options and the merged result is\n * immediately assigned to the table instance.\n *\n * @example\n * ```ts\n * table_setOptions(table, (old) => old)\n * ```\n */\nexport function table_setOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<TableOptions<TFeatures, TData>>,\n): void {\n  const newOptions = functionalUpdate(updater, table.options)\n  const mergedOptions = table_mergeOptions(table, newOptions)\n  if (table.optionsStore) {\n    table.optionsStore.set(() => mergedOptions)\n  } else {\n    table.options = mergedOptions\n  }\n  table_syncExternalStateToBaseAtoms(table)\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,SAAgB,mCAGd,OAA+C;CAC/C,MAAM,QAAQ,MAAM,QAAQ;CAC5B,IAAI,CAAC,OACH;CAGF,MAAM,YAAY,YAAY;EAC5B,KAAK,MAAM,OAAO,OAAO;GACvB,MAAM,WAAY,MAAM,UAAkC;GAC1D,IAAI,CAAC,UACH;GAGF,MAAM,gBAAgB,MAAM;GAC5B,IAAI,kBAAkB,SAAS,KAAK,EAClC,SAAS,UAAU,cAAc;;GAGrC;;;;;;;;;;;;;AAcJ,SAAgB,YAGd,OAA+C;CAC/C,MAAM,OAAOA,yBAAW,MAAM,aAAa;CAC3C,MAAM,YAAY,YAAY;EAC5B,MAAM,OAAO,OAAO,KAAK,KAAK;EAC9B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;GACpC,MAAM,MAAM,KAAK;GAChB,AAAC,MAAM,UAAkB,KAAK,IAAI,KAAK,KAAY;;GAEtD;;;;;;;;;;;;;AAcJ,SAAgB,mBAId,OACA,YACA;CACA,IAAI,MAAM,QAAQ,cAChB,OAAO,MAAM,QAAQ,aAAa,MAAM,SAAS,WAAW;CAG9D,OAAO;EACL,GAAG,MAAM;EACT,GAAG;EACJ;;;;;;;;;;;;;AAcH,SAAgB,iBAId,OACA,SACM;CAEN,MAAM,gBAAgB,mBAAmB,OADtBC,+BAAiB,SAAS,MAAM,QACO,CAAC;CAC3D,IAAI,MAAM,cACR,MAAM,aAAa,UAAU,cAAc;MAE3C,MAAM,UAAU;CAElB,mCAAmC,MAAM"}

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

@@ -4,9 +4,53 @@ import { TableFeatures } from "../../types/TableFeatures.cjs";
 import { Table_Internal } from "../../types/Table.cjs";
 
 //#region src/core/table/coreTablesFeature.utils.d.ts
+/**
+ * Synchronizes externally controlled state slices into the table's base atoms.
+ *
+ * This keeps legacy `options.state` values reflected in the atom graph so
+ * derived atoms, stores, and table APIs read a consistent snapshot.
+ *
+ * @example
+ * ```ts
+ * const value = table_syncExternalStateToBaseAtoms(table)
+ * ```
+ */
 declare function table_syncExternalStateToBaseAtoms<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): void;
+/**
+ * Resets all internal table base atoms to `table.initialState`.
+ *
+ * This resets internally owned state slices in a single reactivity batch. Use
+ * feature-specific reset APIs when a slice may be externally owned.
+ *
+ * @example
+ * ```ts
+ * table_reset(table)
+ * ```
+ */
 declare function table_reset<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): void;
+/**
+ * Merges new table options with the current resolved options.
+ *
+ * If `options.mergeOptions` is provided, it owns the merge behavior; otherwise
+ * options are shallow-merged.
+ *
+ * @example
+ * ```ts
+ * const value = table_mergeOptions(table)
+ * ```
+ */
 declare function table_mergeOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, newOptions: TableOptions<TFeatures, TData>): TableOptions<TFeatures, TData>;
+/**
+ * Updates the table options object.
+ *
+ * The updater receives the current resolved options and the merged result is
+ * immediately assigned to the table instance.
+ *
+ * @example
+ * ```ts
+ * table_setOptions(table, (old) => old)
+ * ```
+ */
 declare function table_setOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<TableOptions<TFeatures, TData>>): void;
 //#endregion
 export { table_mergeOptions, table_reset, table_setOptions, table_syncExternalStateToBaseAtoms };