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

package/dist/core/coreFeatures.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"coreFeatures.cjs","names":[],"sources":["../../src/core/coreFeatures.ts"],"sourcesContent":["import { coreCellsFeature } from './cells/coreCellsFeature'\nimport { coreColumnsFeature } from './columns/coreColumnsFeature'\nimport { coreHeadersFeature } from './headers/coreHeadersFeature'\nimport { coreRowModelsFeature } from './row-models/coreRowModelsFeature'\nimport { coreRowsFeature } from './rows/coreRowsFeature'\nimport { coreTablesFeature } from './table/coreTablesFeature'\n\nexport interface CoreFeatures {\n  coreCellsFeature: typeof coreCellsFeature\n  coreColumnsFeature: typeof coreColumnsFeature\n  coreHeadersFeature: typeof coreHeadersFeature\n  coreRowModelsFeature: typeof coreRowModelsFeature\n  coreRowsFeature: typeof coreRowsFeature\n  coreTablesFeature: typeof coreTablesFeature\n}\n\nexport const coreFeatures: CoreFeatures = {\n  coreCellsFeature,\n  coreColumnsFeature,\n  coreHeadersFeature,\n  coreRowModelsFeature,\n  coreRowsFeature,\n  coreTablesFeature,\n}\n"],"mappings":";;;;;;;;AAgBA,MAAa,eAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"coreFeatures.cjs","names":[],"sources":["../../src/core/coreFeatures.ts"],"sourcesContent":["import { coreCellsFeature } from './cells/coreCellsFeature'\nimport { coreColumnsFeature } from './columns/coreColumnsFeature'\nimport { coreHeadersFeature } from './headers/coreHeadersFeature'\nimport { coreRowModelsFeature } from './row-models/coreRowModelsFeature'\nimport { coreRowsFeature } from './rows/coreRowsFeature'\nimport { coreTablesFeature } from './table/coreTablesFeature'\nimport type { TableReactivityBindings } from '../reactivity'\n\nexport interface CoreFeatures {\n  coreReativityFeature?: TableReactivityBindings\n  coreCellsFeature: typeof coreCellsFeature\n  coreColumnsFeature: typeof coreColumnsFeature\n  coreHeadersFeature: typeof coreHeadersFeature\n  coreRowModelsFeature: typeof coreRowModelsFeature\n  coreRowsFeature: typeof coreRowsFeature\n  coreTablesFeature: typeof coreTablesFeature\n}\n\nexport const coreFeatures: CoreFeatures = {\n  coreCellsFeature,\n  coreColumnsFeature,\n  coreHeadersFeature,\n  coreRowModelsFeature,\n  coreRowsFeature,\n  coreTablesFeature,\n}\n"],"mappings":";;;;;;;;AAkBA,MAAa,eAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/core/coreFeatures.d.cts

@@ -4,9 +4,10 @@ import { coreHeadersFeature } from "./headers/coreHeadersFeature.cjs";
 import { coreRowModelsFeature } from "./row-models/coreRowModelsFeature.cjs";
 import { coreRowsFeature } from "./rows/coreRowsFeature.cjs";
 import { coreTablesFeature } from "./table/coreTablesFeature.cjs";
-
+import { TableReactivityBindings } from "./reactivity/coreReactivityFeature.types.cjs";
 //#region src/core/coreFeatures.d.ts
 interface CoreFeatures {
+  coreReativityFeature?: TableReactivityBindings;
   coreCellsFeature: typeof coreCellsFeature;
   coreColumnsFeature: typeof coreColumnsFeature;
   coreHeadersFeature: typeof coreHeadersFeature;

package/dist/core/coreFeatures.d.ts

@@ -4,9 +4,10 @@ import { coreHeadersFeature } from "./headers/coreHeadersFeature.js";
 import { coreRowModelsFeature } from "./row-models/coreRowModelsFeature.js";
 import { coreRowsFeature } from "./rows/coreRowsFeature.js";
 import { coreTablesFeature } from "./table/coreTablesFeature.js";
-
+import { TableReactivityBindings } from "./reactivity/coreReactivityFeature.types.js";
 //#region src/core/coreFeatures.d.ts
 interface CoreFeatures {
+  coreReativityFeature?: TableReactivityBindings;
   coreCellsFeature: typeof coreCellsFeature;
   coreColumnsFeature: typeof coreColumnsFeature;
   coreHeadersFeature: typeof coreHeadersFeature;

package/dist/core/coreFeatures.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreFeatures.js","names":[],"sources":["../../src/core/coreFeatures.ts"],"sourcesContent":["import { coreCellsFeature } from './cells/coreCellsFeature'\nimport { coreColumnsFeature } from './columns/coreColumnsFeature'\nimport { coreHeadersFeature } from './headers/coreHeadersFeature'\nimport { coreRowModelsFeature } from './row-models/coreRowModelsFeature'\nimport { coreRowsFeature } from './rows/coreRowsFeature'\nimport { coreTablesFeature } from './table/coreTablesFeature'\n\nexport interface CoreFeatures {\n  coreCellsFeature: typeof coreCellsFeature\n  coreColumnsFeature: typeof coreColumnsFeature\n  coreHeadersFeature: typeof coreHeadersFeature\n  coreRowModelsFeature: typeof coreRowModelsFeature\n  coreRowsFeature: typeof coreRowsFeature\n  coreTablesFeature: typeof coreTablesFeature\n}\n\nexport const coreFeatures: CoreFeatures = {\n  coreCellsFeature,\n  coreColumnsFeature,\n  coreHeadersFeature,\n  coreRowModelsFeature,\n  coreRowsFeature,\n  coreTablesFeature,\n}\n"],"mappings":";;;;;;;;AAgBA,MAAa,eAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"coreFeatures.js","names":[],"sources":["../../src/core/coreFeatures.ts"],"sourcesContent":["import { coreCellsFeature } from './cells/coreCellsFeature'\nimport { coreColumnsFeature } from './columns/coreColumnsFeature'\nimport { coreHeadersFeature } from './headers/coreHeadersFeature'\nimport { coreRowModelsFeature } from './row-models/coreRowModelsFeature'\nimport { coreRowsFeature } from './rows/coreRowsFeature'\nimport { coreTablesFeature } from './table/coreTablesFeature'\nimport type { TableReactivityBindings } from '../reactivity'\n\nexport interface CoreFeatures {\n  coreReativityFeature?: TableReactivityBindings\n  coreCellsFeature: typeof coreCellsFeature\n  coreColumnsFeature: typeof coreColumnsFeature\n  coreHeadersFeature: typeof coreHeadersFeature\n  coreRowModelsFeature: typeof coreRowModelsFeature\n  coreRowsFeature: typeof coreRowsFeature\n  coreTablesFeature: typeof coreTablesFeature\n}\n\nexport const coreFeatures: CoreFeatures = {\n  coreCellsFeature,\n  coreColumnsFeature,\n  coreHeadersFeature,\n  coreRowModelsFeature,\n  coreRowsFeature,\n  coreTablesFeature,\n}\n"],"mappings":";;;;;;;;AAkBA,MAAa,eAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/core/reactivity/coreReactivityFeature.types.d.cts

@@ -0,0 +1,38 @@
+import { Atom, AtomOptions, ReadonlyAtom } from "@tanstack/store";
+
+//#region src/core/reactivity/coreReactivityFeature.types.d.ts
+interface TableAtomOptions<T> extends AtomOptions<T> {
+  /**
+   * A debug name for the atom, useful for debugging.
+   */
+  debugName: string;
+}
+/**
+ * Framework reactivity bindings used by table-core.
+ *
+ * Adapters (React, Solid, Vue, etc.) provide concrete implementations so
+ * core features can create derived/writable atoms and integrate with their
+ * scheduling primitives.
+ */
+interface TableReactivityBindings {
+  createOptionsStore: boolean;
+  /**
+   * Creates a writable atom with an initial value.
+   */
+  createWritableAtom: <T>(initialValue: T, options?: TableAtomOptions<T>) => Atom<T>;
+  /**
+   * Creates a readonly/derived atom from a compute function.
+   */
+  createReadonlyAtom: <T>(fn: () => T, options?: TableAtomOptions<T>) => ReadonlyAtom<T>;
+  /**
+   * Evaluates a function without tracking reactive dependencies.
+   */
+  untrack: <T>(fn: () => T) => T;
+  /**
+   * Batches reactive updates to avoid intermediate recomputation.
+   */
+  batch: (fn: () => void) => void;
+}
+//#endregion
+export { TableAtomOptions, TableReactivityBindings };
+//# sourceMappingURL=coreReactivityFeature.types.d.cts.map

package/dist/core/reactivity/coreReactivityFeature.types.d.ts

@@ -0,0 +1,38 @@
+import { Atom, AtomOptions, ReadonlyAtom } from "@tanstack/store";
+
+//#region src/core/reactivity/coreReactivityFeature.types.d.ts
+interface TableAtomOptions<T> extends AtomOptions<T> {
+  /**
+   * A debug name for the atom, useful for debugging.
+   */
+  debugName: string;
+}
+/**
+ * Framework reactivity bindings used by table-core.
+ *
+ * Adapters (React, Solid, Vue, etc.) provide concrete implementations so
+ * core features can create derived/writable atoms and integrate with their
+ * scheduling primitives.
+ */
+interface TableReactivityBindings {
+  createOptionsStore: boolean;
+  /**
+   * Creates a writable atom with an initial value.
+   */
+  createWritableAtom: <T>(initialValue: T, options?: TableAtomOptions<T>) => Atom<T>;
+  /**
+   * Creates a readonly/derived atom from a compute function.
+   */
+  createReadonlyAtom: <T>(fn: () => T, options?: TableAtomOptions<T>) => ReadonlyAtom<T>;
+  /**
+   * Evaluates a function without tracking reactive dependencies.
+   */
+  untrack: <T>(fn: () => T) => T;
+  /**
+   * Batches reactive updates to avoid intermediate recomputation.
+   */
+  batch: (fn: () => void) => void;
+}
+//#endregion
+export { TableAtomOptions, TableReactivityBindings };
+//# sourceMappingURL=coreReactivityFeature.types.d.ts.map

package/dist/core/reactivity/coreReactivityFeature.utils.cjs

@@ -0,0 +1,19 @@
+
+//#region src/core/reactivity/coreReactivityFeature.utils.ts
+/**
+* Bridges atom instances to the `Store`/`ReadonlyStore` API by exposing
+* a `state` getter backed by `atom.get()`, and wiring `setState` for
+* writable atoms.
+*/
+function atomToStore(atom) {
+	const store = atom;
+	Object.defineProperty(atom, "state", { get() {
+		return atom.get();
+	} });
+	if ("set" in atom) store.setState = atom.set.bind(atom);
+	return store;
+}
+
+//#endregion
+exports.atomToStore = atomToStore;
+//# sourceMappingURL=coreReactivityFeature.utils.cjs.map

package/dist/core/reactivity/coreReactivityFeature.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreReactivityFeature.utils.cjs","names":[],"sources":["../../../src/core/reactivity/coreReactivityFeature.utils.ts"],"sourcesContent":["import type { Atom, ReadonlyAtom, ReadonlyStore, Store } from '@tanstack/store'\n\n/**\n * Converts a writable atom to the store-compatible shape expected by core.\n */\nexport function atomToStore<T>(atom: Atom<T>): Store<T>\n/**\n * Converts a readonly atom to a readonly store-compatible shape.\n */\nexport function atomToStore<T>(atom: ReadonlyAtom<T>): ReadonlyStore<T>\n/**\n * Bridges atom instances to the `Store`/`ReadonlyStore` API by exposing\n * a `state` getter backed by `atom.get()`, and wiring `setState` for\n * writable atoms.\n */\nexport function atomToStore<T>(\n  atom: Atom<T> | ReadonlyAtom<T>,\n): Store<T> | ReadonlyStore<T> {\n  const store: Store<T> = atom as Store<T>\n  Object.defineProperty(atom, 'state', {\n    get() {\n      return atom.get()\n    },\n  })\n  if ('set' in atom) {\n    store.setState = atom.set.bind(atom)\n  }\n  return store\n}\n"],"mappings":";;;;;;;AAeA,SAAgB,YACd,MAC6B;CAC7B,MAAM,QAAkB;AACxB,QAAO,eAAe,MAAM,SAAS,EACnC,MAAM;AACJ,SAAO,KAAK,KAAK;IAEpB,CAAC;AACF,KAAI,SAAS,KACX,OAAM,WAAW,KAAK,IAAI,KAAK,KAAK;AAEtC,QAAO"}

package/dist/core/reactivity/coreReactivityFeature.utils.d.cts

@@ -0,0 +1,14 @@
+import { Atom, ReadonlyAtom, ReadonlyStore, Store } from "@tanstack/store";
+
+//#region src/core/reactivity/coreReactivityFeature.utils.d.ts
+/**
+ * Converts a writable atom to the store-compatible shape expected by core.
+ */
+declare function atomToStore<T>(atom: Atom<T>): Store<T>;
+/**
+ * Converts a readonly atom to a readonly store-compatible shape.
+ */
+declare function atomToStore<T>(atom: ReadonlyAtom<T>): ReadonlyStore<T>;
+//#endregion
+export { atomToStore };
+//# sourceMappingURL=coreReactivityFeature.utils.d.cts.map

package/dist/core/reactivity/coreReactivityFeature.utils.d.ts

@@ -0,0 +1,14 @@
+import { Atom, ReadonlyAtom, ReadonlyStore, Store } from "@tanstack/store";
+
+//#region src/core/reactivity/coreReactivityFeature.utils.d.ts
+/**
+ * Converts a writable atom to the store-compatible shape expected by core.
+ */
+declare function atomToStore<T>(atom: Atom<T>): Store<T>;
+/**
+ * Converts a readonly atom to a readonly store-compatible shape.
+ */
+declare function atomToStore<T>(atom: ReadonlyAtom<T>): ReadonlyStore<T>;
+//#endregion
+export { atomToStore };
+//# sourceMappingURL=coreReactivityFeature.utils.d.ts.map

package/dist/core/reactivity/coreReactivityFeature.utils.js

@@ -0,0 +1,18 @@
+//#region src/core/reactivity/coreReactivityFeature.utils.ts
+/**
+* Bridges atom instances to the `Store`/`ReadonlyStore` API by exposing
+* a `state` getter backed by `atom.get()`, and wiring `setState` for
+* writable atoms.
+*/
+function atomToStore(atom) {
+	const store = atom;
+	Object.defineProperty(atom, "state", { get() {
+		return atom.get();
+	} });
+	if ("set" in atom) store.setState = atom.set.bind(atom);
+	return store;
+}
+
+//#endregion
+export { atomToStore };
+//# sourceMappingURL=coreReactivityFeature.utils.js.map

package/dist/core/reactivity/coreReactivityFeature.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreReactivityFeature.utils.js","names":[],"sources":["../../../src/core/reactivity/coreReactivityFeature.utils.ts"],"sourcesContent":["import type { Atom, ReadonlyAtom, ReadonlyStore, Store } from '@tanstack/store'\n\n/**\n * Converts a writable atom to the store-compatible shape expected by core.\n */\nexport function atomToStore<T>(atom: Atom<T>): Store<T>\n/**\n * Converts a readonly atom to a readonly store-compatible shape.\n */\nexport function atomToStore<T>(atom: ReadonlyAtom<T>): ReadonlyStore<T>\n/**\n * Bridges atom instances to the `Store`/`ReadonlyStore` API by exposing\n * a `state` getter backed by `atom.get()`, and wiring `setState` for\n * writable atoms.\n */\nexport function atomToStore<T>(\n  atom: Atom<T> | ReadonlyAtom<T>,\n): Store<T> | ReadonlyStore<T> {\n  const store: Store<T> = atom as Store<T>\n  Object.defineProperty(atom, 'state', {\n    get() {\n      return atom.get()\n    },\n  })\n  if ('set' in atom) {\n    store.setState = atom.set.bind(atom)\n  }\n  return store\n}\n"],"mappings":";;;;;;AAeA,SAAgB,YACd,MAC6B;CAC7B,MAAM,QAAkB;AACxB,QAAO,eAAe,MAAM,SAAS,EACnC,MAAM;AACJ,SAAO,KAAK,KAAK;IAEpB,CAAC;AACF,KAAI,SAAS,KACX,OAAM,WAAW,KAAK,IAAI,KAAK,KAAK;AAEtC,QAAO"}

package/dist/core/table/constructTable.cjs

@@ -1,6 +1,7 @@
 const require_utils = require('../../utils.cjs');
+const require_coreTablesFeature_utils = require('./coreTablesFeature.utils.cjs');
 const require_coreFeatures = require('../coreFeatures.cjs');
-let _tanstack_store = require("@tanstack/store");
+const require_coreReactivityFeature_utils = require('../reactivity/coreReactivityFeature.utils.cjs');
 
 //#region src/core/table/constructTable.ts
 function getInitialTableState(features, initialState = {}) {
@@ -11,49 +12,56 @@ function getInitialTableState(features, initialState = {}) {
 	return require_utils.cloneState(initialState);
 }
 function constructTable(tableOptions) {
+	const _reactivity = tableOptions._features.coreReativityFeature;
 	const table = {
+		_reactivity,
 		_features: {
 			...require_coreFeatures.coreFeatures,
 			...tableOptions._features
 		},
 		_rowModels: {},
 		_rowModelFns: {},
-		get options() {
-			return this.optionsStore.state;
-		},
-		set options(value) {
-			this.optionsStore.setState(() => value);
-		},
 		baseAtoms: {},
 		atoms: {}
 	};
 	const featuresList = Object.values(table._features);
-	table.optionsStore = (0, _tanstack_store.createStore)({
+	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.createOptionsStore) {
+		table.optionsStore = _reactivity.createWritableAtom(mergedOptions, { debugName: "table/optionsStore" });
+		Object.defineProperty(table, "options", {
+			configurable: true,
+			enumerable: true,
+			get() {
+				return table.optionsStore.get();
+			},
+			set(value) {
+				table.optionsStore.set(() => value);
+			}
+		});
+	} else table.options = mergedOptions;
 	table.initialState = getInitialTableState(table._features, table.options.initialState);
 	const stateKeys = Object.keys(table.initialState);
 	for (const key of stateKeys) {
-		table.baseAtoms[key] = (0, _tanstack_store.createAtom)(table.initialState[key]);
-		table.atoms[key] = (0, _tanstack_store.createAtom)(() => {
-			var _opts$atoms;
-			const opts = table.optionsStore.state;
-			const state = opts.state;
-			if (key in (state ?? {})) return state[key];
-			const externalAtom = (_opts$atoms = opts.atoms) === null || _opts$atoms === void 0 ? void 0 : _opts$atoms[key];
+		table.baseAtoms[key] = _reactivity.createWritableAtom(table.initialState[key], { debugName: `table/baseAtoms/${key}` });
+		table.atoms[key] = _reactivity.createReadonlyAtom(() => {
+			var _table$options$atoms;
+			const externalAtom = (_table$options$atoms = table.options.atoms) === null || _table$options$atoms === void 0 ? void 0 : _table$options$atoms[key];
 			if (externalAtom) return externalAtom.get();
 			return table.baseAtoms[key].get();
-		});
+		}, { debugName: `table/atoms/${key}` });
 	}
-	table.store = (0, _tanstack_store.createStore)(() => {
+	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();
 		return snapshot;
-	});
+	}, { debugName: "table/store" }));
 	if (process.env.NODE_ENV === "development" && (tableOptions.debugAll || tableOptions.debugTable)) {
 		const features = Object.keys(table._features);
 		const rowModels = Object.keys(table.options._rowModels || {});
@@ -64,7 +72,7 @@ function constructTable(tableOptions) {
 
   Row Models: ${rowModels.length ? rowModels.join("\n              ") : "(none)"}
 
-  States:     ${states.join("\n              ")}`);
+  States:     ${states.join("\n              ")}\n`, { table });
 	}
 	for (const feature of featuresList) {
 		var _feature$constructTab;

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

@@ -1 +1 @@
-{"version":3,"file":"constructTable.cjs","names":["cloneState","coreFeatures"],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { createAtom, createStore } from '@tanstack/store'\nimport { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../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 table = {\n    _features: { ...coreFeatures, ...tableOptions._features },\n    _rowModels: {},\n    _rowModelFns: {},\n    get options() {\n      return this.optionsStore.state\n    },\n    set options(value) {\n      this.optionsStore.setState(() => value)\n    },\n    baseAtoms: {},\n    atoms: {},\n  } as Table_Internal<TFeatures, TData>\n\n  const featuresList: Array<TableFeature<{}>> = Object.values(table._features)\n\n  const defaultOptions = featuresList.reduce((obj, feature) => {\n    return Object.assign(obj, feature.getDefaultTableOptions?.(table))\n  }, {}) as TableOptions<TFeatures, TData>\n\n  table.optionsStore = createStore({\n    ...defaultOptions,\n    ...tableOptions,\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] = createAtom(table.initialState[key]) as any\n\n    // create readonly derived atom: on each get(), read current options (state, then external atom, then base)\n    ;(table.atoms as any)[key] = createAtom(() => {\n      // Reading optionsStore.state keeps this reactive to setOptions\n      const opts = table.optionsStore.state\n      const state = opts.state\n      if (key in (state ?? {})) {\n        return state![key]\n      }\n      const externalAtom = opts.atoms?.[key]\n      if (externalAtom) {\n        return externalAtom.get()\n      }\n      return table.baseAtoms[key].get()\n    })\n  }\n\n  table.store = createStore(() => {\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\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.keys(table.options._rowModels || {})\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}`,\n    )\n  }\n\n  for (const feature of featuresList) {\n    feature.constructTableAPIs?.(table)\n  }\n\n  return table\n}\n"],"mappings":";;;;;AASA,SAAgB,qBACd,UACA,eAA2D,EAAE,EACtC;AACvB,QAAO,OAAO,SAAS,CAAC,SAAS,YAAY;;AAC3C,2CAAe,QAAQ,6GAAkB,aAAa,KAAI;GAC1D;AACF,QAAOA,yBAAW,aAAa;;AAGjC,SAAgB,eAGd,cAAuE;CACvE,MAAM,QAAQ;EACZ,WAAW;GAAE,GAAGC;GAAc,GAAG,aAAa;GAAW;EACzD,YAAY,EAAE;EACd,cAAc,EAAE;EAChB,IAAI,UAAU;AACZ,UAAO,KAAK,aAAa;;EAE3B,IAAI,QAAQ,OAAO;AACjB,QAAK,aAAa,eAAe,MAAM;;EAEzC,WAAW,EAAE;EACb,OAAO,EAAE;EACV;CAED,MAAM,eAAwC,OAAO,OAAO,MAAM,UAAU;AAM5E,OAAM,gDAA2B;EAC/B,GALqB,aAAa,QAAQ,KAAK,YAAY;;AAC3D,UAAO,OAAO,OAAO,8BAAK,QAAQ,oHAAyB,MAAM,CAAC;KACjE,EAAE,CAGc;EACjB,GAAG;EACJ,CAAC;AAEF,OAAM,eAAe,qBACnB,MAAM,WACN,MAAM,QAAQ,aACf;CAED,MAAM,YAAY,OAAO,KAAK,MAAM,aAAa;AAIjD,MAAK,MAAM,OAAO,WAAW;AAE3B,QAAM,UAAU,uCAAkB,MAAM,aAAa,KAAK;AAGzD,EAAC,MAAM,MAAc,6CAAwB;;GAE5C,MAAM,OAAO,MAAM,aAAa;GAChC,MAAM,QAAQ,KAAK;AACnB,OAAI,QAAQ,SAAS,EAAE,EACrB,QAAO,MAAO;GAEhB,MAAM,8BAAe,KAAK,iEAAQ;AAClC,OAAI,aACF,QAAO,aAAa,KAAK;AAE3B,UAAO,MAAM,UAAU,KAAK,KAAK;IACjC;;AAGJ,OAAM,+CAA0B;EAC9B,MAAM,WAAW,EAAE;AACnB,OAAK,MAAM,OAAO,UAChB,UAAS,OAAO,MAAM,MAAM,KAAK,KAAK;AAExC,SAAO;GACP;AAEF,KACE,QAAQ,IAAI,aAAa,kBACxB,aAAa,YAAY,aAAa,aACvC;EACA,MAAM,WAAW,OAAO,KAAK,MAAM,UAAU;EAC7C,MAAM,YAAY,OAAO,KAAK,MAAM,QAAQ,cAAc,EAAE,CAAC;EAC7D,MAAM,SAAS,OAAO,KAAK,MAAM,aAAa;AAE9C,UAAQ,IACN;;gBAEU,SAAS,KAAK,mBAAmB,CAAC;;gBAElC,UAAU,SAAS,UAAU,KAAK,mBAAmB,GAAG,SAAS;;gBAEjE,OAAO,KAAK,mBAAmB,GAC1C;;AAGH,MAAK,MAAM,WAAW,cAAc;;AAClC,mCAAQ,wGAAqB,MAAM;;AAGrC,QAAO"}
+{"version":3,"file":"constructTable.cjs","names":["cloneState","coreFeatures","atomToStore"],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../utils'\nimport { atomToStore } from '../reactivity/coreReactivityFeature.utils'\nimport { table_syncExternalStateToBaseAtoms } from './coreTablesFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState } from '../../types/TableState'\n\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"}

package/dist/core/table/constructTable.js

@@ -1,6 +1,7 @@
 import { cloneState } from "../../utils.js";
+import { table_syncExternalStateToBaseAtoms } from "./coreTablesFeature.utils.js";
 import { coreFeatures } from "../coreFeatures.js";
-import { createAtom, createStore } from "@tanstack/store";
+import { atomToStore } from "../reactivity/coreReactivityFeature.utils.js";
 
 //#region src/core/table/constructTable.ts
 function getInitialTableState(features, initialState = {}) {
@@ -11,49 +12,56 @@ function getInitialTableState(features, initialState = {}) {
 	return cloneState(initialState);
 }
 function constructTable(tableOptions) {
+	const _reactivity = tableOptions._features.coreReativityFeature;
 	const table = {
+		_reactivity,
 		_features: {
 			...coreFeatures,
 			...tableOptions._features
 		},
 		_rowModels: {},
 		_rowModelFns: {},
-		get options() {
-			return this.optionsStore.state;
-		},
-		set options(value) {
-			this.optionsStore.setState(() => value);
-		},
 		baseAtoms: {},
 		atoms: {}
 	};
 	const featuresList = Object.values(table._features);
-	table.optionsStore = createStore({
+	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.createOptionsStore) {
+		table.optionsStore = _reactivity.createWritableAtom(mergedOptions, { debugName: "table/optionsStore" });
+		Object.defineProperty(table, "options", {
+			configurable: true,
+			enumerable: true,
+			get() {
+				return table.optionsStore.get();
+			},
+			set(value) {
+				table.optionsStore.set(() => value);
+			}
+		});
+	} else table.options = mergedOptions;
 	table.initialState = getInitialTableState(table._features, table.options.initialState);
 	const stateKeys = Object.keys(table.initialState);
 	for (const key of stateKeys) {
-		table.baseAtoms[key] = createAtom(table.initialState[key]);
-		table.atoms[key] = createAtom(() => {
-			var _opts$atoms;
-			const opts = table.optionsStore.state;
-			const state = opts.state;
-			if (key in (state ?? {})) return state[key];
-			const externalAtom = (_opts$atoms = opts.atoms) === null || _opts$atoms === void 0 ? void 0 : _opts$atoms[key];
+		table.baseAtoms[key] = _reactivity.createWritableAtom(table.initialState[key], { debugName: `table/baseAtoms/${key}` });
+		table.atoms[key] = _reactivity.createReadonlyAtom(() => {
+			var _table$options$atoms;
+			const externalAtom = (_table$options$atoms = table.options.atoms) === null || _table$options$atoms === void 0 ? void 0 : _table$options$atoms[key];
 			if (externalAtom) return externalAtom.get();
 			return table.baseAtoms[key].get();
-		});
+		}, { debugName: `table/atoms/${key}` });
 	}
-	table.store = createStore(() => {
+	table_syncExternalStateToBaseAtoms(table);
+	table.store = atomToStore(_reactivity.createReadonlyAtom(() => {
 		const snapshot = {};
 		for (const key of stateKeys) 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.keys(table.options._rowModels || {});
@@ -64,7 +72,7 @@ function constructTable(tableOptions) {
 
   Row Models: ${rowModels.length ? rowModels.join("\n              ") : "(none)"}
 
-  States:     ${states.join("\n              ")}`);
+  States:     ${states.join("\n              ")}\n`, { table });
 	}
 	for (const feature of featuresList) {
 		var _feature$constructTab;

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

@@ -1 +1 @@
-{"version":3,"file":"constructTable.js","names":[],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { createAtom, createStore } from '@tanstack/store'\nimport { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../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 table = {\n    _features: { ...coreFeatures, ...tableOptions._features },\n    _rowModels: {},\n    _rowModelFns: {},\n    get options() {\n      return this.optionsStore.state\n    },\n    set options(value) {\n      this.optionsStore.setState(() => value)\n    },\n    baseAtoms: {},\n    atoms: {},\n  } as Table_Internal<TFeatures, TData>\n\n  const featuresList: Array<TableFeature<{}>> = Object.values(table._features)\n\n  const defaultOptions = featuresList.reduce((obj, feature) => {\n    return Object.assign(obj, feature.getDefaultTableOptions?.(table))\n  }, {}) as TableOptions<TFeatures, TData>\n\n  table.optionsStore = createStore({\n    ...defaultOptions,\n    ...tableOptions,\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] = createAtom(table.initialState[key]) as any\n\n    // create readonly derived atom: on each get(), read current options (state, then external atom, then base)\n    ;(table.atoms as any)[key] = createAtom(() => {\n      // Reading optionsStore.state keeps this reactive to setOptions\n      const opts = table.optionsStore.state\n      const state = opts.state\n      if (key in (state ?? {})) {\n        return state![key]\n      }\n      const externalAtom = opts.atoms?.[key]\n      if (externalAtom) {\n        return externalAtom.get()\n      }\n      return table.baseAtoms[key].get()\n    })\n  }\n\n  table.store = createStore(() => {\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\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.keys(table.options._rowModels || {})\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}`,\n    )\n  }\n\n  for (const feature of featuresList) {\n    feature.constructTableAPIs?.(table)\n  }\n\n  return table\n}\n"],"mappings":";;;;;AASA,SAAgB,qBACd,UACA,eAA2D,EAAE,EACtC;AACvB,QAAO,OAAO,SAAS,CAAC,SAAS,YAAY;;AAC3C,2CAAe,QAAQ,6GAAkB,aAAa,KAAI;GAC1D;AACF,QAAO,WAAW,aAAa;;AAGjC,SAAgB,eAGd,cAAuE;CACvE,MAAM,QAAQ;EACZ,WAAW;GAAE,GAAG;GAAc,GAAG,aAAa;GAAW;EACzD,YAAY,EAAE;EACd,cAAc,EAAE;EAChB,IAAI,UAAU;AACZ,UAAO,KAAK,aAAa;;EAE3B,IAAI,QAAQ,OAAO;AACjB,QAAK,aAAa,eAAe,MAAM;;EAEzC,WAAW,EAAE;EACb,OAAO,EAAE;EACV;CAED,MAAM,eAAwC,OAAO,OAAO,MAAM,UAAU;AAM5E,OAAM,eAAe,YAAY;EAC/B,GALqB,aAAa,QAAQ,KAAK,YAAY;;AAC3D,UAAO,OAAO,OAAO,8BAAK,QAAQ,oHAAyB,MAAM,CAAC;KACjE,EAAE,CAGc;EACjB,GAAG;EACJ,CAAC;AAEF,OAAM,eAAe,qBACnB,MAAM,WACN,MAAM,QAAQ,aACf;CAED,MAAM,YAAY,OAAO,KAAK,MAAM,aAAa;AAIjD,MAAK,MAAM,OAAO,WAAW;AAE3B,QAAM,UAAU,OAAO,WAAW,MAAM,aAAa,KAAK;AAGzD,EAAC,MAAM,MAAc,OAAO,iBAAiB;;GAE5C,MAAM,OAAO,MAAM,aAAa;GAChC,MAAM,QAAQ,KAAK;AACnB,OAAI,QAAQ,SAAS,EAAE,EACrB,QAAO,MAAO;GAEhB,MAAM,8BAAe,KAAK,iEAAQ;AAClC,OAAI,aACF,QAAO,aAAa,KAAK;AAE3B,UAAO,MAAM,UAAU,KAAK,KAAK;IACjC;;AAGJ,OAAM,QAAQ,kBAAkB;EAC9B,MAAM,WAAW,EAAE;AACnB,OAAK,MAAM,OAAO,UAChB,UAAS,OAAO,MAAM,MAAM,KAAK,KAAK;AAExC,SAAO;GACP;AAEF,KACE,QAAQ,IAAI,aAAa,kBACxB,aAAa,YAAY,aAAa,aACvC;EACA,MAAM,WAAW,OAAO,KAAK,MAAM,UAAU;EAC7C,MAAM,YAAY,OAAO,KAAK,MAAM,QAAQ,cAAc,EAAE,CAAC;EAC7D,MAAM,SAAS,OAAO,KAAK,MAAM,aAAa;AAE9C,UAAQ,IACN;;gBAEU,SAAS,KAAK,mBAAmB,CAAC;;gBAElC,UAAU,SAAS,UAAU,KAAK,mBAAmB,GAAG,SAAS;;gBAEjE,OAAO,KAAK,mBAAmB,GAC1C;;AAGH,MAAK,MAAM,WAAW,cAAc;;AAClC,mCAAQ,wGAAqB,MAAM;;AAGrC,QAAO"}
+{"version":3,"file":"constructTable.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"}

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

@@ -1,11 +1,12 @@
 import { RowData, Updater } from "../../types/type-utils.cjs";
+import { TableReactivityBindings } from "../reactivity/coreReactivityFeature.types.cjs";
 import { CoreFeatures } from "../coreFeatures.cjs";
 import { RowModelFns } from "../../types/RowModelFns.cjs";
 import { CachedRowModels, CreateRowModels_All } from "../../types/RowModel.cjs";
 import { TableState, TableState_All } from "../../types/TableState.cjs";
 import { TableOptions } from "../../types/TableOptions.cjs";
 import { TableFeatures } from "../../types/TableFeatures.cjs";
-import { Atom, ReadonlyAtom, ReadonlyStore, Store } from "@tanstack/store";
+import { Atom, ReadonlyAtom, ReadonlyStore } from "@tanstack/store";
 
 //#region src/core/table/coreTablesFeature.types.d.ts
 interface TableMeta<TFeatures extends TableFeatures, TData extends RowData> {}
@@ -45,11 +46,11 @@ interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowD
   /**
    * The features that you want to enable for the table.
    */
-  _features: TFeatures;
+  readonly _features: TFeatures;
   /**
    * The row model options that you want to enable for the table.
    */
-  _rowModels?: CreateRowModels_All<TFeatures, TData>;
+  readonly _rowModels?: CreateRowModels_All<TFeatures, TData>;
   /**
    * 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]`
@@ -57,38 +58,38 @@ interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowD
    * still routed through the internal base atom; consumers are responsible for
    * mirroring changes back to their external atom via the corresponding `onXChange` callback.
    */
-  atoms?: ExternalAtoms<TFeatures>;
+  readonly atoms?: ExternalAtoms<TFeatures>;
   /**
    * Set this option to override any of the `autoReset...` feature options.
    */
-  autoResetAll?: boolean;
+  readonly autoResetAll?: boolean;
   /**
    * The data for the table to display. When the `data` option changes reference, the table will reprocess the data.
    */
-  data: ReadonlyArray<TData>;
+  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.
    */
-  initialState?: Partial<TableState<TFeatures>>;
+  readonly initialState?: Partial<TableState<TFeatures>>;
   /**
    * This option is used to optionally implement the merging of table options.
    */
-  mergeOptions?: (defaultOptions: TableOptions<TFeatures, TData>, options: Partial<TableOptions<TFeatures, TData>>) => TableOptions<TFeatures, TData>;
+  readonly mergeOptions?: (defaultOptions: TableOptions<TFeatures, TData>, options: Partial<TableOptions<TFeatures, TData>>) => TableOptions<TFeatures, TData>;
   /**
    * You can pass any object to `options.meta` and access it anywhere the `table` is available via `table.options.meta`.
    */
-  meta?: TableMeta<TFeatures, TData>;
+  readonly meta?: TableMeta<TFeatures, TData>;
   /**
    * Pass in individual self-managed state to the table.
    */
-  state?: Partial<TableState<TFeatures>>;
+  readonly state?: Partial<TableState<TFeatures>>;
 }
 interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * The features that are enabled for the table.
+   * Table reactivity bindings for interacting with TanStack Store.
    */
-  _features: Partial<CoreFeatures> & TFeatures;
+  readonly _reactivity: TableReactivityBindings;
   /**
    * Prototype cache for Cell objects - shared by all cells in this table
    */
@@ -97,6 +98,10 @@ interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends Ro
    * Prototype cache for Column objects - shared by all columns in this table
    */
   _columnPrototype?: object;
+  /**
+   * The features that are enabled for the table.
+   */
+  readonly _features: Partial<CoreFeatures> & TFeatures;
   /**
    * Prototype cache for Header objects - shared by all headers in this table
    */
@@ -104,43 +109,46 @@ interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends Ro
   /**
    * The row model processing functions that are used to process the data by features.
    */
-  _rowModelFns: RowModelFns<TFeatures, TData>;
+  readonly _rowModelFns: RowModelFns<TFeatures, TData>;
   /**
    * The row models that are enabled for the table.
    */
-  _rowModels: CachedRowModels<TFeatures, TData>;
+  readonly _rowModels: CachedRowModels<TFeatures, TData>;
   /**
    * Prototype cache for Row objects - shared by all rows in this table
    */
   _rowPrototype?: object;
-  /**
-   * The internal writable atoms for each `TableState` slice. This is the library's
-   * single write surface — all state mutations from features land here.
-   */
-  baseAtoms: BaseAtoms<TFeatures>;
   /**
    * The readonly derived atoms for each `TableState` slice. Each derives from
    * its corresponding `baseAtom` plus, optionally, a per-slice external atom or
    * external state value (precedence: external atom > external state > base atom).
    */
-  atoms: Atoms<TFeatures>;
+  readonly atoms: Atoms<TFeatures>;
   /**
-   * The base store for the table options.
+   * The internal writable atoms for each `TableState` slice. This is the library's
+   * single write surface — all state mutations from features land here.
    */
-  optionsStore: Store<TableOptions<TFeatures, TData>>;
+  readonly baseAtoms: BaseAtoms<TFeatures>;
   /**
    * This is the resolved initial state of the table.
    */
-  initialState: TableState<TFeatures>;
+  readonly initialState: TableState<TFeatures>;
   /**
    * A read-only reference to the table's current options.
    */
   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.
+   */
+  readonly optionsStore?: Atom<TableOptions<TFeatures, TData>> | undefined;
   /**
    * The readonly flat store for the table state. Derives from `table.atoms`
    * only; never reads external state directly.
    */
-  store: ReadonlyStore<TableState<TFeatures>>;
+  readonly store: ReadonlyStore<TableState<TFeatures>>;
 }
 interface Table_Table<TFeatures extends TableFeatures, TData extends RowData> extends Table_CoreProperties<TFeatures, TData> {
   /**