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

package/dist/core/table/constructTable.js

@@ -0,0 +1,78 @@
+import { cloneState } from "../../utils.js";
+import { coreFeatures } from "../coreFeatures.js";
+import { createAtom, createStore } from "@tanstack/store";
+
+//#region src/core/table/constructTable.ts
+function getInitialTableState(features, initialState = {}) {
+	Object.values(features).forEach((feature) => {
+		var _feature$getInitialSt;
+		initialState = ((_feature$getInitialSt = feature.getInitialState) === null || _feature$getInitialSt === void 0 ? void 0 : _feature$getInitialSt.call(feature, initialState)) ?? initialState;
+	});
+	return cloneState(initialState);
+}
+function constructTable(tableOptions) {
+	const table = {
+		_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({
+		...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
+	});
+	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];
+			if (externalAtom) return externalAtom.get();
+			return table.baseAtoms[key].get();
+		});
+	}
+	table.store = createStore(() => {
+		const snapshot = {};
+		for (const key of stateKeys) snapshot[key] = table.atoms[key].get();
+		return snapshot;
+	});
+	if (process.env.NODE_ENV === "development" && (tableOptions.debugAll || tableOptions.debugTable)) {
+		const features = Object.keys(table._features);
+		const rowModels = Object.keys(table.options._rowModels || {});
+		const states = Object.keys(table.initialState);
+		console.log(`Constructing Table Instance
+
+  Features:   ${features.join("\n              ")}
+
+  Row Models: ${rowModels.length ? rowModels.join("\n              ") : "(none)"}
+
+  States:     ${states.join("\n              ")}`);
+	}
+	for (const feature of featuresList) {
+		var _feature$constructTab;
+		(_feature$constructTab = feature.constructTableAPIs) === null || _feature$constructTab === void 0 || _feature$constructTab.call(feature, table);
+	}
+	return table;
+}
+
+//#endregion
+export { constructTable, getInitialTableState };
+//# sourceMappingURL=constructTable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constructTable.js","names":[],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { 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"}

package/dist/core/table/coreTablesFeature.cjs

@@ -0,0 +1,21 @@
+const require_utils = require('../../utils.cjs');
+const require_coreTablesFeature_utils = require('./coreTablesFeature.utils.cjs');
+
+//#region src/core/table/coreTablesFeature.ts
+function constructCoreTablesFeature() {
+	return { constructTableAPIs: (table) => {
+		require_utils.assignTableAPIs("coreTablesFeature", table, {
+			table_reset: { fn: () => require_coreTablesFeature_utils.table_reset(table) },
+			table_setOptions: { fn: (updater) => require_coreTablesFeature_utils.table_setOptions(table, updater) }
+		});
+	} };
+}
+/**
+* The Core Tables feature provides the core table functionality for handling state and options.
+*/
+const coreTablesFeature = constructCoreTablesFeature();
+
+//#endregion
+exports.constructCoreTablesFeature = constructCoreTablesFeature;
+exports.coreTablesFeature = coreTablesFeature;
+//# sourceMappingURL=coreTablesFeature.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreTablesFeature.cjs","names":["table_reset","table_setOptions"],"sources":["../../../src/core/table/coreTablesFeature.ts"],"sourcesContent":["import { assignTableAPIs } from '../../utils'\nimport { table_reset, table_setOptions } from './coreTablesFeature.utils'\nimport type { 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"}

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

@@ -0,0 +1,13 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/core/table/coreTablesFeature.d.ts
+interface CoreTablesFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+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.
+ */
+declare const coreTablesFeature: TableFeature<CoreTablesFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { CoreTablesFeatureConstructors, constructCoreTablesFeature, coreTablesFeature };
+//# sourceMappingURL=coreTablesFeature.d.cts.map

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

@@ -0,0 +1,13 @@
+import { RowData } from "../../types/type-utils.js";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/core/table/coreTablesFeature.d.ts
+interface CoreTablesFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+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.
+ */
+declare const coreTablesFeature: TableFeature<CoreTablesFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { CoreTablesFeatureConstructors, constructCoreTablesFeature, coreTablesFeature };
+//# sourceMappingURL=coreTablesFeature.d.ts.map

package/dist/core/table/coreTablesFeature.js

@@ -0,0 +1,20 @@
+import { assignTableAPIs } from "../../utils.js";
+import { table_reset, table_setOptions } from "./coreTablesFeature.utils.js";
+
+//#region src/core/table/coreTablesFeature.ts
+function constructCoreTablesFeature() {
+	return { constructTableAPIs: (table) => {
+		assignTableAPIs("coreTablesFeature", table, {
+			table_reset: { fn: () => table_reset(table) },
+			table_setOptions: { fn: (updater) => table_setOptions(table, updater) }
+		});
+	} };
+}
+/**
+* The Core Tables feature provides the core table functionality for handling state and options.
+*/
+const coreTablesFeature = constructCoreTablesFeature();
+
+//#endregion
+export { constructCoreTablesFeature, coreTablesFeature };
+//# sourceMappingURL=coreTablesFeature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreTablesFeature.js","names":[],"sources":["../../../src/core/table/coreTablesFeature.ts"],"sourcesContent":["import { assignTableAPIs } from '../../utils'\nimport { table_reset, table_setOptions } from './coreTablesFeature.utils'\nimport type { 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"}

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

@@ -0,0 +1,157 @@
+import { RowData, Updater } from "../../types/type-utils.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";
+
+//#region src/core/table/coreTablesFeature.types.d.ts
+interface TableMeta<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * A map of writable atoms, one per `TableState` slice. These are the internal
+ * writable atoms that the library always writes to via `makeStateUpdater`.
+ */
+type BaseAtoms<TFeatures extends TableFeatures> = { [K in keyof TableState<TFeatures>]-?: Atom<TableState<TFeatures>[K]> };
+/**
+ * A map of readonly derived atoms, one per `TableState` slice. Each derives
+ * from its corresponding `baseAtom` plus, optionally, a per-slice external
+ * atom or external state value.
+ *
+ * Precedence: `options.atoms[key]` > `options.state[key]` > `baseAtoms[key]`.
+ */
+type Atoms<TFeatures extends TableFeatures> = { [K in keyof TableState<TFeatures>]-?: ReadonlyAtom<TableState<TFeatures>[K]> };
+/**
+ * A map of optional external atoms, one per `TableState` slice. Consumers can
+ * provide their own writable atom for any state slice to take over ownership
+ * of that slice.
+ */
+type ExternalAtoms<TFeatures extends TableFeatures> = Partial<{ [K in keyof TableState<TFeatures>]: Atom<TableState<TFeatures>[K]> }>;
+/**
+ * Internal "all features" flat variants of the atom types. `Table_Internal`
+ * uses these so feature code (written generically over `TFeatures`) can access
+ * any slice atom (e.g. `table.atoms.columnPinning`) without TypeScript
+ * narrowing away slices that aren't in the current `TFeatures` union.
+ *
+ * Keys are optional: feature code can read atoms from slices it doesn't own,
+ * but those slices may not be registered on the current table. Consumers must
+ * use optional chaining (`table.atoms.columnPinning?.get() ?? default`).
+ */
+type BaseAtoms_All = { [K in keyof TableState_All]?: Atom<TableState_All[K]> };
+type Atoms_All = { [K in keyof TableState_All]?: ReadonlyAtom<TableState_All[K]> };
+type ExternalAtoms_All = Partial<{ [K in keyof TableState_All]: Atom<TableState_All[K]> }>;
+interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * The features that you want to enable for the table.
+   */
+  _features: TFeatures;
+  /**
+   * The row model options that you want to enable for the table.
+   */
+  _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]`
+   * 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.
+   */
+  atoms?: ExternalAtoms<TFeatures>;
+  /**
+   * Set this option to override any of the `autoReset...` feature options.
+   */
+  autoResetAll?: boolean;
+  /**
+   * The data for the table to display. When the `data` option changes reference, the table will reprocess the data.
+   */
+  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>>;
+  /**
+   * 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>;
+  /**
+   * You can pass any object to `options.meta` and access it anywhere the `table` is available via `table.options.meta`.
+   */
+  meta?: TableMeta<TFeatures, TData>;
+  /**
+   * Pass in individual self-managed state to the table.
+   */
+  state?: Partial<TableState<TFeatures>>;
+}
+interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * The features that are enabled for the table.
+   */
+  _features: Partial<CoreFeatures> & TFeatures;
+  /**
+   * Prototype cache for Cell objects - shared by all cells in this table
+   */
+  _cellPrototype?: object;
+  /**
+   * Prototype cache for Column objects - shared by all columns in this table
+   */
+  _columnPrototype?: object;
+  /**
+   * Prototype cache for Header objects - shared by all headers in this table
+   */
+  _headerPrototype?: object;
+  /**
+   * The row model processing functions that are used to process the data by features.
+   */
+  _rowModelFns: RowModelFns<TFeatures, TData>;
+  /**
+   * The row models that are enabled for the table.
+   */
+  _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>;
+  /**
+   * The base store for the table options.
+   */
+  optionsStore: Store<TableOptions<TFeatures, TData>>;
+  /**
+   * This is the resolved initial state of the table.
+   */
+  initialState: TableState<TFeatures>;
+  /**
+   * A read-only reference to the table's current options.
+   */
+  readonly options: TableOptions<TFeatures, TData>;
+  /**
+   * The readonly flat store for the table state. Derives from `table.atoms`
+   * only; never reads external state directly.
+   */
+  store: ReadonlyStore<TableState<TFeatures>>;
+}
+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.
+   */
+  reset: () => void;
+  /**
+   * This function can be used to update the table options.
+   */
+  setOptions: (newOptions: Updater<TableOptions<TFeatures, TData>>) => void;
+}
+//#endregion
+export { Atoms, Atoms_All, BaseAtoms, BaseAtoms_All, ExternalAtoms, ExternalAtoms_All, TableMeta, TableOptions_Table, Table_CoreProperties, Table_Table };
+//# sourceMappingURL=coreTablesFeature.types.d.cts.map

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

@@ -0,0 +1,157 @@
+import { RowData, Updater } from "../../types/type-utils.js";
+import { CoreFeatures } from "../coreFeatures.js";
+import { RowModelFns } from "../../types/RowModelFns.js";
+import { CachedRowModels, CreateRowModels_All } from "../../types/RowModel.js";
+import { TableState, TableState_All } from "../../types/TableState.js";
+import { TableOptions } from "../../types/TableOptions.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Atom, ReadonlyAtom, ReadonlyStore, Store } from "@tanstack/store";
+
+//#region src/core/table/coreTablesFeature.types.d.ts
+interface TableMeta<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * A map of writable atoms, one per `TableState` slice. These are the internal
+ * writable atoms that the library always writes to via `makeStateUpdater`.
+ */
+type BaseAtoms<TFeatures extends TableFeatures> = { [K in keyof TableState<TFeatures>]-?: Atom<TableState<TFeatures>[K]> };
+/**
+ * A map of readonly derived atoms, one per `TableState` slice. Each derives
+ * from its corresponding `baseAtom` plus, optionally, a per-slice external
+ * atom or external state value.
+ *
+ * Precedence: `options.atoms[key]` > `options.state[key]` > `baseAtoms[key]`.
+ */
+type Atoms<TFeatures extends TableFeatures> = { [K in keyof TableState<TFeatures>]-?: ReadonlyAtom<TableState<TFeatures>[K]> };
+/**
+ * A map of optional external atoms, one per `TableState` slice. Consumers can
+ * provide their own writable atom for any state slice to take over ownership
+ * of that slice.
+ */
+type ExternalAtoms<TFeatures extends TableFeatures> = Partial<{ [K in keyof TableState<TFeatures>]: Atom<TableState<TFeatures>[K]> }>;
+/**
+ * Internal "all features" flat variants of the atom types. `Table_Internal`
+ * uses these so feature code (written generically over `TFeatures`) can access
+ * any slice atom (e.g. `table.atoms.columnPinning`) without TypeScript
+ * narrowing away slices that aren't in the current `TFeatures` union.
+ *
+ * Keys are optional: feature code can read atoms from slices it doesn't own,
+ * but those slices may not be registered on the current table. Consumers must
+ * use optional chaining (`table.atoms.columnPinning?.get() ?? default`).
+ */
+type BaseAtoms_All = { [K in keyof TableState_All]?: Atom<TableState_All[K]> };
+type Atoms_All = { [K in keyof TableState_All]?: ReadonlyAtom<TableState_All[K]> };
+type ExternalAtoms_All = Partial<{ [K in keyof TableState_All]: Atom<TableState_All[K]> }>;
+interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * The features that you want to enable for the table.
+   */
+  _features: TFeatures;
+  /**
+   * The row model options that you want to enable for the table.
+   */
+  _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]`
+   * 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.
+   */
+  atoms?: ExternalAtoms<TFeatures>;
+  /**
+   * Set this option to override any of the `autoReset...` feature options.
+   */
+  autoResetAll?: boolean;
+  /**
+   * The data for the table to display. When the `data` option changes reference, the table will reprocess the data.
+   */
+  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>>;
+  /**
+   * 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>;
+  /**
+   * You can pass any object to `options.meta` and access it anywhere the `table` is available via `table.options.meta`.
+   */
+  meta?: TableMeta<TFeatures, TData>;
+  /**
+   * Pass in individual self-managed state to the table.
+   */
+  state?: Partial<TableState<TFeatures>>;
+}
+interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * The features that are enabled for the table.
+   */
+  _features: Partial<CoreFeatures> & TFeatures;
+  /**
+   * Prototype cache for Cell objects - shared by all cells in this table
+   */
+  _cellPrototype?: object;
+  /**
+   * Prototype cache for Column objects - shared by all columns in this table
+   */
+  _columnPrototype?: object;
+  /**
+   * Prototype cache for Header objects - shared by all headers in this table
+   */
+  _headerPrototype?: object;
+  /**
+   * The row model processing functions that are used to process the data by features.
+   */
+  _rowModelFns: RowModelFns<TFeatures, TData>;
+  /**
+   * The row models that are enabled for the table.
+   */
+  _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>;
+  /**
+   * The base store for the table options.
+   */
+  optionsStore: Store<TableOptions<TFeatures, TData>>;
+  /**
+   * This is the resolved initial state of the table.
+   */
+  initialState: TableState<TFeatures>;
+  /**
+   * A read-only reference to the table's current options.
+   */
+  readonly options: TableOptions<TFeatures, TData>;
+  /**
+   * The readonly flat store for the table state. Derives from `table.atoms`
+   * only; never reads external state directly.
+   */
+  store: ReadonlyStore<TableState<TFeatures>>;
+}
+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.
+   */
+  reset: () => void;
+  /**
+   * This function can be used to update the table options.
+   */
+  setOptions: (newOptions: Updater<TableOptions<TFeatures, TData>>) => void;
+}
+//#endregion
+export { Atoms, Atoms_All, BaseAtoms, BaseAtoms_All, ExternalAtoms, ExternalAtoms_All, TableMeta, TableOptions_Table, Table_CoreProperties, Table_Table };
+//# sourceMappingURL=coreTablesFeature.types.d.ts.map

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

@@ -0,0 +1,27 @@
+const require_utils = require('../../utils.cjs');
+let _tanstack_store = require("@tanstack/store");
+
+//#region src/core/table/coreTablesFeature.utils.ts
+function table_reset(table) {
+	const snap = require_utils.cloneState(table.initialState);
+	(0, _tanstack_store.batch)(() => {
+		for (const key of Object.keys(snap)) table.baseAtoms[key].set(snap[key]);
+	});
+}
+function table_mergeOptions(table, newOptions) {
+	if (table.options.mergeOptions) return table.options.mergeOptions(table.options, newOptions);
+	return {
+		...table.options,
+		...newOptions
+	};
+}
+function table_setOptions(table, updater) {
+	const mergedOptions = table_mergeOptions(table, require_utils.functionalUpdate(updater, table.options));
+	table.optionsStore.setState(() => mergedOptions);
+}
+
+//#endregion
+exports.table_mergeOptions = table_mergeOptions;
+exports.table_reset = table_reset;
+exports.table_setOptions = table_setOptions;
+//# sourceMappingURL=coreTablesFeature.utils.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreTablesFeature.utils.cjs","names":["cloneState","functionalUpdate"],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { batch } from '@tanstack/store'\nimport { 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_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const snap = cloneState(table.initialState)\n  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  table.optionsStore.setState(() => mergedOptions)\n}\n"],"mappings":";;;;AAOA,SAAgB,YAGd,OAA+C;CAC/C,MAAM,OAAOA,yBAAW,MAAM,aAAa;AAC3C,kCAAY;AACV,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,OAAM,aAAa,eAAe,cAAc"}

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

@@ -0,0 +1,12 @@
+import { RowData, Updater } from "../../types/type-utils.cjs";
+import { TableOptions } from "../../types/TableOptions.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+
+//#region src/core/table/coreTablesFeature.utils.d.ts
+declare function table_reset<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): void;
+declare function table_mergeOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, newOptions: TableOptions<TFeatures, TData>): TableOptions<TFeatures, TData>;
+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 };
+//# sourceMappingURL=coreTablesFeature.utils.d.cts.map

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

@@ -0,0 +1,12 @@
+import { RowData, Updater } from "../../types/type-utils.js";
+import { TableOptions } from "../../types/TableOptions.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Table_Internal } from "../../types/Table.js";
+
+//#region src/core/table/coreTablesFeature.utils.d.ts
+declare function table_reset<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): void;
+declare function table_mergeOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, newOptions: TableOptions<TFeatures, TData>): TableOptions<TFeatures, TData>;
+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 };
+//# sourceMappingURL=coreTablesFeature.utils.d.ts.map

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

@@ -0,0 +1,25 @@
+import { cloneState, functionalUpdate } from "../../utils.js";
+import { batch } from "@tanstack/store";
+
+//#region src/core/table/coreTablesFeature.utils.ts
+function table_reset(table) {
+	const snap = cloneState(table.initialState);
+	batch(() => {
+		for (const key of Object.keys(snap)) table.baseAtoms[key].set(snap[key]);
+	});
+}
+function table_mergeOptions(table, newOptions) {
+	if (table.options.mergeOptions) return table.options.mergeOptions(table.options, newOptions);
+	return {
+		...table.options,
+		...newOptions
+	};
+}
+function table_setOptions(table, updater) {
+	const mergedOptions = table_mergeOptions(table, functionalUpdate(updater, table.options));
+	table.optionsStore.setState(() => mergedOptions);
+}
+
+//#endregion
+export { table_mergeOptions, table_reset, table_setOptions };
+//# sourceMappingURL=coreTablesFeature.utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreTablesFeature.utils.js","names":[],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { batch } from '@tanstack/store'\nimport { 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_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const snap = cloneState(table.initialState)\n  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  table.optionsStore.setState(() => mergedOptions)\n}\n"],"mappings":";;;;AAOA,SAAgB,YAGd,OAA+C;CAC/C,MAAM,OAAO,WAAW,MAAM,aAAa;AAC3C,aAAY;AACV,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,OADtB,iBAAiB,SAAS,MAAM,QACO,CAAC;AAC3D,OAAM,aAAa,eAAe,cAAc"}

package/dist/features/column-faceting/columnFacetingFeature.cjs

@@ -0,0 +1,65 @@
+const require_utils = require('../../utils.cjs');
+const require_columnFacetingFeature_utils = require('./columnFacetingFeature.utils.cjs');
+
+//#region src/features/column-faceting/columnFacetingFeature.ts
+function constructColumnFacetingFeature() {
+	return {
+		assignColumnPrototype: (prototype, table) => {
+			require_utils.assignPrototypeAPIs("columnFacetingFeature", prototype, table, {
+				column_getFacetedRowModel: {
+					memoDeps: () => {
+						var _table$atoms$columnFi, _table$atoms$globalFi;
+						return [
+							table.getPreFilteredRowModel().rows,
+							(_table$atoms$columnFi = table.atoms.columnFilters) === null || _table$atoms$columnFi === void 0 ? void 0 : _table$atoms$columnFi.get(),
+							(_table$atoms$globalFi = table.atoms.globalFilter) === null || _table$atoms$globalFi === void 0 ? void 0 : _table$atoms$globalFi.get(),
+							table.getFilteredRowModel().rows
+						];
+					},
+					fn: (column) => require_columnFacetingFeature_utils.column_getFacetedRowModel(column, column.table)
+				},
+				column_getFacetedMinMaxValues: {
+					memoDeps: (column) => [require_utils.callMemoOrStaticFn(column, "getFacetedRowModel", require_columnFacetingFeature_utils.column_getFacetedRowModel, column.table).flatRows],
+					fn: (column) => require_columnFacetingFeature_utils.column_getFacetedMinMaxValues(column, column.table)
+				},
+				column_getFacetedUniqueValues: {
+					memoDeps: (column) => [require_utils.callMemoOrStaticFn(column, "getFacetedRowModel", require_columnFacetingFeature_utils.column_getFacetedRowModel, column.table).flatRows],
+					fn: (column) => require_columnFacetingFeature_utils.column_getFacetedUniqueValues(column, column.table)
+				}
+			});
+		},
+		constructTableAPIs: (table) => {
+			require_utils.assignTableAPIs("columnFacetingFeature", table, {
+				table_getGlobalFacetedRowModel: {
+					memoDeps: () => {
+						var _table$atoms$columnFi2, _table$atoms$globalFi2;
+						return [
+							table.getPreFilteredRowModel().rows,
+							(_table$atoms$columnFi2 = table.atoms.columnFilters) === null || _table$atoms$columnFi2 === void 0 ? void 0 : _table$atoms$columnFi2.get(),
+							(_table$atoms$globalFi2 = table.atoms.globalFilter) === null || _table$atoms$globalFi2 === void 0 ? void 0 : _table$atoms$globalFi2.get(),
+							table.getFilteredRowModel().rows
+						];
+					},
+					fn: () => require_columnFacetingFeature_utils.table_getGlobalFacetedRowModel(table)
+				},
+				table_getGlobalFacetedMinMaxValues: {
+					memoDeps: () => [require_utils.callMemoOrStaticFn(table, "getGlobalFacetedRowModel", require_columnFacetingFeature_utils.table_getGlobalFacetedRowModel).flatRows],
+					fn: () => require_columnFacetingFeature_utils.table_getGlobalFacetedMinMaxValues(table)
+				},
+				table_getGlobalFacetedUniqueValues: {
+					memoDeps: () => [require_utils.callMemoOrStaticFn(table, "getGlobalFacetedRowModel", require_columnFacetingFeature_utils.table_getGlobalFacetedRowModel).flatRows],
+					fn: () => require_columnFacetingFeature_utils.table_getGlobalFacetedUniqueValues(table)
+				}
+			});
+		}
+	};
+}
+/**
+* The Column Faceting feature adds column faceting APIs to the column objects.
+*/
+const columnFacetingFeature = constructColumnFacetingFeature();
+
+//#endregion
+exports.columnFacetingFeature = columnFacetingFeature;
+exports.constructColumnFacetingFeature = constructColumnFacetingFeature;
+//# sourceMappingURL=columnFacetingFeature.cjs.map