@tanstack/table-core 9.0.0-alpha.13 → 9.0.0-alpha.16

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

@@ -13,16 +13,22 @@ function constructTable(tableOptions) {
   const table = {
     _features: { ...coreFeatures, ...tableOptions._features },
     _rowModels: {},
-    _rowModelFns: {}
+    _rowModelFns: {},
+    get options() {
+      return this.optionsStore.state;
+    },
+    set options(value) {
+      this.optionsStore.setState(() => value);
+    }
   };
   const featuresList = Object.values(table._features);
   const defaultOptions = featuresList.reduce((obj, feature) => {
     return Object.assign(obj, feature.getDefaultTableOptions?.(table));
   }, {});
-  table.options = {
+  table.optionsStore = createStore({
     ...defaultOptions,
     ...tableOptions
-  };
+  });
   table.initialState = getInitialTableState(
     table._features,
     table.options.initialState
@@ -32,7 +38,7 @@ function constructTable(tableOptions) {
     const state = table.baseStore.state;
     return {
       ...state,
-      ...table.options.state ?? {}
+      ...table.optionsStore.state.state ?? {}
     };
   });
   if (process.env.NODE_ENV === "development" && (tableOptions.debugAll || tableOptions.debugTable)) {

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

@@ -1 +1 @@
-{"version":3,"file":"constructTable.js","sources":["../../../../src/core/table/constructTable.ts"],"sourcesContent":["import { createStore } from '@tanstack/store'\nimport { coreFeatures } from '../coreFeatures'\nimport type { Store } from '@tanstack/store'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState } 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 =\n      feature.getInitialState?.(initialState as TableState<TFeatures>) ??\n      initialState\n  })\n  return structuredClone(initialState) as TableState<TFeatures>\n}\n\nexport function createTableStore<TFeatures extends TableFeatures>(\n  features: TFeatures,\n  initialState: Partial<TableState<TFeatures>> | undefined = {},\n): Store<TableState<TFeatures>> {\n  return createStore(getInitialTableState(features, initialState))\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  } 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.options = {\n    ...defaultOptions,\n    ...tableOptions,\n  }\n\n  table.initialState = getInitialTableState(\n    table._features,\n    table.options.initialState,\n  )\n\n  table.baseStore = table.options.store ?? createStore(table.initialState)\n\n  table.store = createStore(() => {\n    const state = table.baseStore.state\n    return {\n      ...state,\n      ...(table.options.state ?? {}),\n    }\n  })\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.keys(table.options._rowModels || {})\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}`,\n    )\n  }\n\n  for (const feature of featuresList) {\n    feature.constructTableAPIs?.(table)\n  }\n\n  return table\n}\n"],"names":[],"mappings":";;AASO,SAAS,qBACd,UACA,eAA2D,IACpC;AACvB,SAAO,OAAO,QAAQ,EAAE,QAAQ,CAAC,YAAY;AAC3C,mBACE,QAAQ,kBAAkB,YAAqC,KAC/D;AAAA,EACJ,CAAC;AACD,SAAO,gBAAgB,YAAY;AACrC;AAEO,SAAS,iBACd,UACA,eAA2D,IAC7B;AAC9B,SAAO,YAAY,qBAAqB,UAAU,YAAY,CAAC;AACjE;AAEO,SAAS,eAGd,cAAuE;AACvE,QAAM,QAAQ;AAAA,IACZ,WAAW,EAAE,GAAG,cAAc,GAAG,aAAa,UAAA;AAAA,IAC9C,YAAY,CAAA;AAAA,IACZ,cAAc,CAAA;AAAA,EAAC;AAGjB,QAAM,eAAwC,OAAO,OAAO,MAAM,SAAS;AAE3E,QAAM,iBAAiB,aAAa,OAAO,CAAC,KAAK,YAAY;AAC3D,WAAO,OAAO,OAAO,KAAK,QAAQ,yBAAyB,KAAK,CAAC;AAAA,EACnE,GAAG,CAAA,CAAE;AAEL,QAAM,UAAU;AAAA,IACd,GAAG;AAAA,IACH,GAAG;AAAA,EAAA;AAGL,QAAM,eAAe;AAAA,IACnB,MAAM;AAAA,IACN,MAAM,QAAQ;AAAA,EAAA;AAGhB,QAAM,YAAY,MAAM,QAAQ,SAAS,YAAY,MAAM,YAAY;AAEvE,QAAM,QAAQ,YAAY,MAAM;AAC9B,UAAM,QAAQ,MAAM,UAAU;AAC9B,WAAO;AAAA,MACL,GAAG;AAAA,MACH,GAAI,MAAM,QAAQ,SAAS,CAAA;AAAA,IAAC;AAAA,EAEhC,CAAC;AAED,MACE,QAAQ,IAAI,aAAa,kBACxB,aAAa,YAAY,aAAa,aACvC;AACA,UAAM,WAAW,OAAO,KAAK,MAAM,SAAS;AAC5C,UAAM,YAAY,OAAO,KAAK,MAAM,QAAQ,cAAc,EAAE;AAC5D,UAAM,SAAS,OAAO,KAAK,MAAM,YAAY;AAE7C,YAAQ;AAAA,MACN;AAAA;AAAA,gBAEU,SAAS,KAAK,kBAAkB,CAAC;AAAA;AAAA,gBAEjC,UAAU,SAAS,UAAU,KAAK,kBAAkB,IAAI,QAAQ;AAAA;AAAA,gBAEhE,OAAO,KAAK,kBAAkB,CAAC;AAAA,IAAA;AAAA,EAE7C;AAEA,aAAW,WAAW,cAAc;AAClC,YAAQ,qBAAqB,KAAK;AAAA,EACpC;AAEA,SAAO;AACT;"}
+{"version":3,"file":"constructTable.js","sources":["../../../../src/core/table/constructTable.ts"],"sourcesContent":["import { createStore } from '@tanstack/store'\nimport { coreFeatures } from '../coreFeatures'\nimport type { Store } from '@tanstack/store'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState } 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 =\n      feature.getInitialState?.(initialState as TableState<TFeatures>) ??\n      initialState\n  })\n  return structuredClone(initialState) as TableState<TFeatures>\n}\n\nexport function createTableStore<TFeatures extends TableFeatures>(\n  features: TFeatures,\n  initialState: Partial<TableState<TFeatures>> | undefined = {},\n): Store<TableState<TFeatures>> {\n  return createStore(getInitialTableState(features, initialState))\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  } 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  table.baseStore = table.options.store ?? createStore(table.initialState)\n\n  table.store = createStore(() => {\n    const state = table.baseStore.state\n    return {\n      ...state,\n      ...(table.optionsStore.state.state ?? {}),\n    }\n  })\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.keys(table.options._rowModels || {})\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}`,\n    )\n  }\n\n  for (const feature of featuresList) {\n    feature.constructTableAPIs?.(table)\n  }\n\n  return table\n}\n"],"names":[],"mappings":";;AASO,SAAS,qBACd,UACA,eAA2D,IACpC;AACvB,SAAO,OAAO,QAAQ,EAAE,QAAQ,CAAC,YAAY;AAC3C,mBACE,QAAQ,kBAAkB,YAAqC,KAC/D;AAAA,EACJ,CAAC;AACD,SAAO,gBAAgB,YAAY;AACrC;AAEO,SAAS,iBACd,UACA,eAA2D,IAC7B;AAC9B,SAAO,YAAY,qBAAqB,UAAU,YAAY,CAAC;AACjE;AAEO,SAAS,eAGd,cAAuE;AACvE,QAAM,QAAQ;AAAA,IACZ,WAAW,EAAE,GAAG,cAAc,GAAG,aAAa,UAAA;AAAA,IAC9C,YAAY,CAAA;AAAA,IACZ,cAAc,CAAA;AAAA,IACd,IAAI,UAAU;AACZ,aAAO,KAAK,aAAa;AAAA,IAC3B;AAAA,IACA,IAAI,QAAQ,OAAO;AACjB,WAAK,aAAa,SAAS,MAAM,KAAK;AAAA,IACxC;AAAA,EAAA;AAGF,QAAM,eAAwC,OAAO,OAAO,MAAM,SAAS;AAE3E,QAAM,iBAAiB,aAAa,OAAO,CAAC,KAAK,YAAY;AAC3D,WAAO,OAAO,OAAO,KAAK,QAAQ,yBAAyB,KAAK,CAAC;AAAA,EACnE,GAAG,CAAA,CAAE;AAEL,QAAM,eAAe,YAAY;AAAA,IAC/B,GAAG;AAAA,IACH,GAAG;AAAA,EAAA,CACJ;AAED,QAAM,eAAe;AAAA,IACnB,MAAM;AAAA,IACN,MAAM,QAAQ;AAAA,EAAA;AAGhB,QAAM,YAAY,MAAM,QAAQ,SAAS,YAAY,MAAM,YAAY;AAEvE,QAAM,QAAQ,YAAY,MAAM;AAC9B,UAAM,QAAQ,MAAM,UAAU;AAC9B,WAAO;AAAA,MACL,GAAG;AAAA,MACH,GAAI,MAAM,aAAa,MAAM,SAAS,CAAA;AAAA,IAAC;AAAA,EAE3C,CAAC;AAED,MACE,QAAQ,IAAI,aAAa,kBACxB,aAAa,YAAY,aAAa,aACvC;AACA,UAAM,WAAW,OAAO,KAAK,MAAM,SAAS;AAC5C,UAAM,YAAY,OAAO,KAAK,MAAM,QAAQ,cAAc,EAAE;AAC5D,UAAM,SAAS,OAAO,KAAK,MAAM,YAAY;AAE7C,YAAQ;AAAA,MACN;AAAA;AAAA,gBAEU,SAAS,KAAK,kBAAkB,CAAC;AAAA;AAAA,gBAEjC,UAAU,SAAS,UAAU,KAAK,kBAAkB,IAAI,QAAQ;AAAA;AAAA,gBAEhE,OAAO,KAAK,kBAAkB,CAAC;AAAA,IAAA;AAAA,EAE7C;AAEA,aAAW,WAAW,cAAc;AAClC,YAAQ,qBAAqB,KAAK;AAAA,EACpC;AAEA,SAAO;AACT;"}

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

@@ -80,6 +80,10 @@ export interface Table_CoreProperties<TFeatures extends TableFeatures, TData ext
      * The base store for the table. This can be used to write to the table state.
      */
     baseStore: Store<TableState<TFeatures>>;
+    /**
+     * The base store for the table options.
+     */
+    optionsStore: Store<TableOptions<TFeatures, TData>>;
     /**
      * This is the resolved initial state of the table.
      */
@@ -87,7 +91,7 @@ export interface Table_CoreProperties<TFeatures extends TableFeatures, TData ext
     /**
      * A read-only reference to the table's current options.
      */
-    options: TableOptions<TFeatures, TData>;
+    readonly options: TableOptions<TFeatures, TData>;
     /**
      * Where the table state is stored.
      */

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

@@ -13,7 +13,8 @@ function table_mergeOptions(table, newOptions) {
 }
 function table_setOptions(table, updater) {
   const newOptions = functionalUpdate(updater, table.options);
-  table.options = table_mergeOptions(table, newOptions);
+  const mergedOptions = table_mergeOptions(table, newOptions);
+  table.optionsStore.setState(() => mergedOptions);
 }
 export {
   table_mergeOptions,

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

@@ -1 +1 @@
-{"version":3,"file":"coreTablesFeature.utils.js","sources":["../../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { 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  table.baseStore.setState(() => structuredClone(table.initialState))\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  table.options = table_mergeOptions(table, newOptions)\n}\n"],"names":[],"mappings":";AAMO,SAAS,YAGd,OAA+C;AAC/C,QAAM,UAAU,SAAS,MAAM,gBAAgB,MAAM,YAAY,CAAC;AACpE;AAEO,SAAS,mBAId,OACA,YACA;AACA,MAAI,MAAM,QAAQ,cAAc;AAC9B,WAAO,MAAM,QAAQ,aAAa,MAAM,SAAS,UAAU;AAAA,EAC7D;AAEA,SAAO;AAAA,IACL,GAAG,MAAM;AAAA,IACT,GAAG;AAAA,EAAA;AAEP;AAEO,SAAS,iBAId,OACA,SACM;AACN,QAAM,aAAa,iBAAiB,SAAS,MAAM,OAAO;AAC1D,QAAM,UAAU,mBAAmB,OAAO,UAAU;AACtD;"}
+{"version":3,"file":"coreTablesFeature.utils.js","sources":["../../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { 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  table.baseStore.setState(() => structuredClone(table.initialState))\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"],"names":[],"mappings":";AAMO,SAAS,YAGd,OAA+C;AAC/C,QAAM,UAAU,SAAS,MAAM,gBAAgB,MAAM,YAAY,CAAC;AACpE;AAEO,SAAS,mBAId,OACA,YACA;AACA,MAAI,MAAM,QAAQ,cAAc;AAC9B,WAAO,MAAM,QAAQ,aAAa,MAAM,SAAS,UAAU;AAAA,EAC7D;AAEA,SAAO;AAAA,IACL,GAAG,MAAM;AAAA,IACT,GAAG;AAAA,EAAA;AAEP;AAEO,SAAS,iBAId,OACA,SACM;AACN,QAAM,aAAa,iBAAiB,SAAS,MAAM,OAAO;AAC1D,QAAM,gBAAgB,mBAAmB,OAAO,UAAU;AAC1D,QAAM,aAAa,SAAS,MAAM,aAAa;AACjD;"}

package/dist/esm/features/table-reactivity/tableReactivityFeature.d.ts

@@ -0,0 +1,9 @@
+import { TableFeature, TableFeatures } from '../../types/TableFeatures.js';
+import { RowData } from '../../types/type-utils.js';
+interface TableReactivityFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {
+}
+export declare function constructReactivityFeature<TFeatures extends TableFeatures, TData extends RowData>(bindings: {
+    stateNotifier?: () => unknown;
+    optionsNotifier?: () => unknown;
+}): TableFeature<TableReactivityFeatureConstructors<TFeatures, TData>>;
+export {};

package/dist/esm/features/table-reactivity/tableReactivityFeature.js

@@ -0,0 +1,30 @@
+function constructReactivityFeature(bindings) {
+  return {
+    constructTableAPIs: (table) => {
+      table.store = bindStore(table.store, bindings.stateNotifier);
+      table.optionsStore = bindStore(
+        table.optionsStore,
+        bindings.optionsNotifier
+      );
+    }
+  };
+}
+const bindStore = (store, notifier) => {
+  const stateDescriptor = Object.getOwnPropertyDescriptor(
+    Object.getPrototypeOf(store),
+    "state"
+  );
+  Object.defineProperty(store, "state", {
+    configurable: true,
+    enumerable: true,
+    get() {
+      notifier?.();
+      return stateDescriptor.get.call(store);
+    }
+  });
+  return store;
+};
+export {
+  constructReactivityFeature
+};
+//# sourceMappingURL=tableReactivityFeature.js.map

package/dist/esm/features/table-reactivity/tableReactivityFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableReactivityFeature.js","sources":["../../../../src/features/table-reactivity/tableReactivityFeature.ts"],"sourcesContent":["import type { ReadonlyStore, Store } from '@tanstack/store'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\n\ninterface TableReactivityFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {}\n\nexport function constructReactivityFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(bindings: {\n  stateNotifier?: () => unknown\n  optionsNotifier?: () => unknown\n}): TableFeature<TableReactivityFeatureConstructors<TFeatures, TData>> {\n  return {\n    constructTableAPIs: (table) => {\n      table.store = bindStore(table.store, bindings.stateNotifier)\n      table.optionsStore = bindStore(\n        table.optionsStore,\n        bindings.optionsNotifier,\n      )\n    },\n  }\n}\n\nconst bindStore = <T extends Store<any> | ReadonlyStore<any>>(\n  store: T,\n  notifier?: () => unknown,\n): T => {\n  const stateDescriptor = Object.getOwnPropertyDescriptor(\n    Object.getPrototypeOf(store),\n    'state',\n  )!\n\n  Object.defineProperty(store, 'state', {\n    configurable: true,\n    enumerable: true,\n    get() {\n      notifier?.()\n      return stateDescriptor.get!.call(store)\n    },\n  })\n\n  return store\n}\n"],"names":[],"mappings":"AASO,SAAS,2BAGd,UAGqE;AACrE,SAAO;AAAA,IACL,oBAAoB,CAAC,UAAU;AAC7B,YAAM,QAAQ,UAAU,MAAM,OAAO,SAAS,aAAa;AAC3D,YAAM,eAAe;AAAA,QACnB,MAAM;AAAA,QACN,SAAS;AAAA,MAAA;AAAA,IAEb;AAAA,EAAA;AAEJ;AAEA,MAAM,YAAY,CAChB,OACA,aACM;AACN,QAAM,kBAAkB,OAAO;AAAA,IAC7B,OAAO,eAAe,KAAK;AAAA,IAC3B;AAAA,EAAA;AAGF,SAAO,eAAe,OAAO,SAAS;AAAA,IACpC,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,MAAM;AACJ,iBAAA;AACA,aAAO,gBAAgB,IAAK,KAAK,KAAK;AAAA,IACxC;AAAA,EAAA,CACD;AAED,SAAO;AACT;"}

package/dist/esm/index.d.ts

@@ -58,6 +58,7 @@ export * from './fns/sortFns.js';
  * Features
  */
 export * from './features/stockFeatures.js';
+export * from './features/table-reactivity/tableReactivityFeature.js';
 export * from './features/column-faceting/columnFacetingFeature.js';
 export * from './features/column-faceting/columnFacetingFeature.types';
 export * from './features/column-faceting/columnFacetingFeature.utils';

package/dist/esm/index.js

@@ -27,6 +27,7 @@ import { aggregationFn_count, aggregationFn_extent, aggregationFn_max, aggregati
 import { filterFn_arrHas, filterFn_arrIncludes, filterFn_arrIncludesAll, filterFn_arrIncludesSome, filterFn_equals, filterFn_equalsString, filterFn_equalsStringSensitive, filterFn_greaterThan, filterFn_greaterThanOrEqualTo, filterFn_inNumberRange, filterFn_includesString, filterFn_includesStringSensitive, filterFn_lessThan, filterFn_lessThanOrEqualTo, filterFn_weakEquals, filterFns } from "./fns/filterFns.js";
 import { reSplitAlphaNumeric, sortFn_alphanumeric, sortFn_alphanumericCaseSensitive, sortFn_basic, sortFn_datetime, sortFn_text, sortFn_textCaseSensitive, sortFns } from "./fns/sortFns.js";
 import { stockFeatures } from "./features/stockFeatures.js";
+import { constructReactivityFeature } from "./features/table-reactivity/tableReactivityFeature.js";
 import { columnFacetingFeature, constructColumnFacetingFeature } from "./features/column-faceting/columnFacetingFeature.js";
 import { column_getFacetedMinMaxValues, column_getFacetedRowModel, column_getFacetedUniqueValues, table_getGlobalFacetedMinMaxValues, table_getGlobalFacetedRowModel, table_getGlobalFacetedUniqueValues } from "./features/column-faceting/columnFacetingFeature.utils.js";
 import { createFacetedMinMaxValues } from "./features/column-faceting/createFacetedMinMaxValues.js";
@@ -160,6 +161,7 @@ export {
   constructCoreTablesFeature,
   constructGlobalFilteringFeature,
   constructHeader,
+  constructReactivityFeature,
   constructRow,
   constructRowExpandingFeature,
   constructRowPaginationFeature,

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../src/utils.ts"],"sourcesContent":["import type { Table, Table_Internal } from './types/Table'\nimport type { NoInfer, RowData, Updater } from './types/type-utils'\nimport type { TableFeatures } from './types/TableFeatures'\nimport type { TableState, TableState_All } from './types/TableState'\n\nexport function functionalUpdate<T>(updater: Updater<T>, input: T): T {\n  return typeof updater === 'function'\n    ? (updater as (i: T) => T)(input)\n    : updater\n}\n\nexport function noop() {}\n\nexport function makeStateUpdater<\n  TFeatures extends TableFeatures,\n  K extends (string & {}) | keyof TableState_All | keyof TableState<TFeatures>,\n>(key: K, instance: Table<TFeatures, any>) {\n  return (updater: Updater<TableState<any>[K & keyof TableState<any>]>) => {\n    ;(instance as Table_Internal<any, any>).baseStore.setState(\n      <TTableState extends TableState_All>(old: TTableState) => {\n        return {\n          ...old,\n          [key]: functionalUpdate(updater, (old as any)[key]),\n        }\n      },\n    )\n  }\n}\n\ntype AnyFunction = (...args: any) => any\n\nexport function isFunction<T extends AnyFunction>(d: any): d is T {\n  return d instanceof Function\n}\n\nexport function isNumberArray(d: any): d is Array<number> {\n  return Array.isArray(d) && d.every((val) => typeof val === 'number')\n}\n\nexport function flattenBy<TNode>(\n  arr: Array<TNode>,\n  getChildren: (item: TNode) => Array<TNode>,\n) {\n  const flat: Array<TNode> = []\n\n  const recurse = (subArr: Array<TNode>) => {\n    subArr.forEach((item) => {\n      flat.push(item)\n      const children = getChildren(item)\n      if (children.length) {\n        recurse(children)\n      }\n    })\n  }\n\n  recurse(arr)\n\n  return flat\n}\n\nexport const $internalMemoFnMeta = Symbol('memoFnMeta')\nexport type MemoFnMeta = { originalArgsLength?: number }\n\n/**\n * @internal\n */\nfunction setMemoFnMeta(fn: Function, meta: MemoFnMeta) {\n  Object.defineProperty(fn, $internalMemoFnMeta, { value: meta })\n}\n\n/**\n * @internal\n */\nexport function getMemoFnMeta(fn: any): MemoFnMeta | null {\n  return (typeof fn === 'function' && fn[$internalMemoFnMeta]) ?? null\n}\n\ninterface MemoOptions<TDeps extends ReadonlyArray<any>, TDepArgs, TResult> {\n  fn: (...args: NoInfer<TDeps>) => TResult\n  memoDeps?: (depArgs?: TDepArgs) => [...TDeps] | undefined\n  onAfterCompare?: (depsChanged: boolean) => void\n  onAfterUpdate?: (result: TResult) => void\n  onBeforeCompare?: () => void\n  onBeforeUpdate?: () => void\n}\n\nexport const memo = <TDeps extends ReadonlyArray<any>, TDepArgs, TResult>({\n  fn,\n  memoDeps,\n  onAfterCompare,\n  onAfterUpdate,\n  onBeforeCompare,\n  onBeforeUpdate,\n}: MemoOptions<TDeps, TDepArgs, TResult>): ((\n  depArgs?: TDepArgs,\n) => TResult) => {\n  let deps: Array<any> | undefined = []\n  let result: TResult | undefined\n\n  const memoizedFn = (depArgs?: TDepArgs): TResult => {\n    onBeforeCompare?.()\n    const newDeps = memoDeps?.(depArgs)\n    const depsChanged =\n      !newDeps ||\n      newDeps.length !== deps?.length ||\n      newDeps.some((dep: any, index: number) => deps?.[index] !== dep)\n    onAfterCompare?.(depsChanged)\n\n    if (!depsChanged) {\n      return result!\n    }\n\n    deps = newDeps\n\n    onBeforeUpdate?.()\n    result = fn(...(newDeps ?? ([] as any)))\n    onAfterUpdate?.(result)\n\n    return result\n  }\n\n  setMemoFnMeta(memoizedFn, { originalArgsLength: fn.length })\n\n  return memoizedFn\n}\n\ninterface TableMemoOptions<\n  TFeatures extends TableFeatures,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n  TResult,\n> extends MemoOptions<TDeps, TDepArgs, TResult> {\n  feature?: keyof TFeatures & string\n  fnName: string\n  objectId?: string\n  onAfterUpdate?: () => void\n  table: Table_Internal<TFeatures, any>\n}\n\nconst pad = (str: number | string, num: number) => {\n  str = String(str)\n  while (str.length < num) {\n    str = ' ' + str\n  }\n  return str\n}\n\nexport function tableMemo<\n  TFeatures extends TableFeatures,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n  TResult,\n>({\n  feature,\n  fnName,\n  objectId,\n  onAfterUpdate,\n  table,\n  ...memoOptions\n}: TableMemoOptions<TFeatures, TDeps, TDepArgs, TResult>) {\n  let beforeCompareTime: number\n  let afterCompareTime: number\n  let startCalcTime: number\n  let endCalcTime: number\n  let runCount = 0\n  let debug: boolean | undefined\n  let debugCache: boolean | undefined\n\n  if (process.env.NODE_ENV === 'development') {\n    const { debugCache: _debugCache, debugAll } = table.options\n    debugCache = _debugCache\n    const { parentName } = getFunctionNameInfo(fnName, '.')\n\n    const debugByParent =\n      // @ts-expect-error\n      table.options[\n        `debug${(parentName != 'table' ? parentName + 's' : parentName).replace(\n          parentName,\n          parentName.charAt(0).toUpperCase() + parentName.slice(1),\n        )}`\n      ]\n    const debugByFeature = feature\n      ? // @ts-expect-error\n        table.options[\n          `debug${feature.charAt(0).toUpperCase() + feature.slice(1)}`\n        ]\n      : false\n\n    debug = debugAll || debugByParent || debugByFeature\n  }\n\n  function logTime(time: number, depsChanged: boolean) {\n    const runType =\n      runCount === 0\n        ? '(1st run)'\n        : depsChanged\n          ? '(rerun #' + runCount + ')'\n          : '(cache)'\n    runCount++\n\n    console.groupCollapsed(\n      `%c⏱ ${pad(`${time.toFixed(1)} ms`, 12)} %c${runType}%c ${fnName}%c ${objectId ? `(${fnName.split('.')[0]}Id: ${objectId})` : ''}`,\n      `font-size: .6rem; font-weight: bold; ${\n        depsChanged\n          ? `color: hsl(\n        ${Math.max(0, Math.min(120 - Math.log10(time) * 60, 120))}deg 100% 31%);`\n          : ''\n      } `,\n      `color: ${runCount < 2 ? '#FF00FF' : '#FF1493'}`,\n      'color: #666',\n      'color: #87CEEB',\n    )\n    console.info({\n      feature,\n      state: table.store.state,\n      deps: memoOptions.memoDeps?.toString(),\n    })\n    console.trace()\n    console.groupEnd()\n  }\n\n  const debugOptions =\n    process.env.NODE_ENV === 'development'\n      ? {\n          onBeforeCompare: () => {\n            if (debugCache) {\n              beforeCompareTime = performance.now()\n            }\n          },\n          onAfterCompare: (depsChanged: boolean) => {\n            if (debugCache) {\n              afterCompareTime = performance.now()\n              const compareTime =\n                Math.round((afterCompareTime - beforeCompareTime) * 100) / 100\n              if (!depsChanged) {\n                logTime(compareTime, depsChanged)\n              }\n            }\n          },\n          onBeforeUpdate: () => {\n            if (debug) {\n              startCalcTime = performance.now()\n            }\n          },\n          onAfterUpdate: () => {\n            if (debug) {\n              endCalcTime = performance.now()\n              const executionTime =\n                Math.round((endCalcTime - startCalcTime) * 100) / 100\n              logTime(executionTime, true)\n            }\n            queueMicrotask(() => onAfterUpdate?.())\n          },\n        }\n      : {\n          onAfterUpdate: () => {\n            queueMicrotask(() => onAfterUpdate?.())\n          },\n        }\n\n  return memo({\n    ...memoOptions,\n    ...debugOptions,\n  })\n}\n\nexport interface API<TDeps extends ReadonlyArray<any>, TDepArgs> {\n  fn: (...args: any) => any\n  memoDeps?: (depArgs?: any) => [...any] | undefined\n}\n\nexport type APIObject<TDeps extends ReadonlyArray<any>, TDepArgs> = Record<\n  string,\n  API<TDeps, TDepArgs>\n>\n\n/**\n * Assumes that a function name is in the format of `parentName_fnKey` and returns the `fnKey` and `fnName` in the format of `parentName.fnKey`.\n */\nexport function getFunctionNameInfo(\n  staticFnName: string,\n  splitBy: '_' | '.' = '_',\n) {\n  const [parentName, fnKey] = staticFnName.split(splitBy)\n  const fnName = `${parentName}.${fnKey}`\n  return { fnKey, fnName, parentName } as {\n    fnKey: string\n    fnName: string\n    parentName: string\n  }\n}\n\n/**\n * Assigns Table API methods directly to the table instance.\n * Unlike row/cell/column/header, the table is a singleton so methods are assigned directly.\n */\nexport function assignTableAPIs<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n>(\n  feature: keyof TFeatures & string,\n  table: Table_Internal<TFeatures, TData>,\n  apis: APIObject<TDeps, NoInfer<TDepArgs>>,\n): void {\n  for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {\n    const { fnKey, fnName } = getFunctionNameInfo(staticFnName)\n\n    ;(table as Record<string, any>)[fnKey] = memoDeps\n      ? tableMemo({\n          memoDeps,\n          fn,\n          fnName,\n          table,\n          feature,\n        })\n      : fn\n  }\n}\n\nexport interface PrototypeAPI<TDeps extends ReadonlyArray<any>, TDepArgs> {\n  fn: (self: any, ...args: any) => any\n  memoDeps?: (self: any, depArgs?: any) => [...any] | undefined\n}\n\nexport type PrototypeAPIObject<\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n> = Record<string, PrototypeAPI<TDeps, TDepArgs>>\n\n/**\n * Assigns API methods to a prototype object for memory-efficient method sharing.\n * All instances created with this prototype will share the same method references.\n *\n * For memoized methods, the memo state is lazily created and stored on each instance.\n * This provides the best of both worlds: shared method code + per-instance caching.\n */\nexport function assignPrototypeAPIs<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n>(\n  feature: keyof TFeatures & string,\n  prototype: Record<string, any>,\n  table: Table_Internal<TFeatures, TData>,\n  apis: PrototypeAPIObject<TDeps, NoInfer<TDepArgs>>,\n): void {\n  for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {\n    const { fnKey, fnName } = getFunctionNameInfo(staticFnName)\n\n    if (memoDeps) {\n      // For memoized methods, create a function that lazily initializes\n      // the memo on first access and stores it on the instance\n      const memoKey = `_memo_${fnKey}`\n\n      prototype[fnKey] = function (this: any, ...args: Array<any>) {\n        // Lazily create memo on first access for this instance\n        if (!this[memoKey]) {\n          const self = this\n          this[memoKey] = tableMemo({\n            memoDeps: () => memoDeps(self),\n            fn: (...deps) => fn(self, ...deps),\n            fnName,\n            objectId: self.id,\n            table,\n            feature,\n          })\n        }\n        return this[memoKey](...args)\n      }\n    } else {\n      // Non-memoized methods just call the static function with `this`\n      prototype[fnKey] = function (this: any, ...args: Array<any>) {\n        return fn(this, ...args)\n      }\n    }\n\n    setMemoFnMeta(prototype[fnKey], { originalArgsLength: fn.length })\n  }\n}\n\n/**\n * Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fallback to the static method passed in.\n */\nexport function callMemoOrStaticFn<\n  TObject extends Record<string, any>,\n  TStaticFn extends AnyFunction,\n>(\n  obj: TObject,\n  fnKey: string,\n  staticFn: TStaticFn,\n  ...args: Parameters<TStaticFn> extends [any, ...infer Rest] ? Rest : never\n): ReturnType<TStaticFn> {\n  return (\n    (obj[fnKey] as Function | undefined)?.(...args) ?? staticFn(obj, ...args)\n  )\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sources":["../../src/utils.ts"],"sourcesContent":["import type { Table, Table_Internal } from './types/Table'\nimport type { NoInfer, RowData, Updater } from './types/type-utils'\nimport type { TableFeatures } from './types/TableFeatures'\nimport type { TableState, TableState_All } from './types/TableState'\n\nexport function functionalUpdate<T>(updater: Updater<T>, input: T): T {\n  return typeof updater === 'function'\n    ? (updater as (i: T) => T)(input)\n    : updater\n}\n\nexport function noop() {}\n\nexport function makeStateUpdater<\n  TFeatures extends TableFeatures,\n  K extends (string & {}) | keyof TableState_All | keyof TableState<TFeatures>,\n>(key: K, instance: Table<TFeatures, any>) {\n  return (updater: Updater<TableState<any>[K & keyof TableState<any>]>) => {\n    instance.baseStore.setState(\n      <TTableState extends TableState_All>(old: TTableState) => {\n        return {\n          ...old,\n          [key]: functionalUpdate(updater, (old as any)[key]),\n        }\n      },\n    )\n  }\n}\n\ntype AnyFunction = (...args: any) => any\n\nexport function isFunction<T extends AnyFunction>(d: any): d is T {\n  return d instanceof Function\n}\n\nexport function isNumberArray(d: any): d is Array<number> {\n  return Array.isArray(d) && d.every((val) => typeof val === 'number')\n}\n\nexport function flattenBy<TNode>(\n  arr: Array<TNode>,\n  getChildren: (item: TNode) => Array<TNode>,\n) {\n  const flat: Array<TNode> = []\n\n  const recurse = (subArr: Array<TNode>) => {\n    subArr.forEach((item) => {\n      flat.push(item)\n      const children = getChildren(item)\n      if (children.length) {\n        recurse(children)\n      }\n    })\n  }\n\n  recurse(arr)\n\n  return flat\n}\n\nexport const $internalMemoFnMeta = Symbol('memoFnMeta')\nexport type MemoFnMeta = { originalArgsLength?: number }\n\n/**\n * @internal\n */\nfunction setMemoFnMeta(fn: Function, meta: MemoFnMeta) {\n  Object.defineProperty(fn, $internalMemoFnMeta, { value: meta })\n}\n\n/**\n * @internal\n */\nexport function getMemoFnMeta(fn: any): MemoFnMeta | null {\n  return (typeof fn === 'function' && fn[$internalMemoFnMeta]) ?? null\n}\n\ninterface MemoOptions<TDeps extends ReadonlyArray<any>, TDepArgs, TResult> {\n  fn: (...args: NoInfer<TDeps>) => TResult\n  memoDeps?: (depArgs?: TDepArgs) => [...TDeps] | undefined\n  onAfterCompare?: (depsChanged: boolean) => void\n  onAfterUpdate?: (result: TResult) => void\n  onBeforeCompare?: () => void\n  onBeforeUpdate?: () => void\n}\n\nexport const memo = <TDeps extends ReadonlyArray<any>, TDepArgs, TResult>({\n  fn,\n  memoDeps,\n  onAfterCompare,\n  onAfterUpdate,\n  onBeforeCompare,\n  onBeforeUpdate,\n}: MemoOptions<TDeps, TDepArgs, TResult>): ((\n  depArgs?: TDepArgs,\n) => TResult) => {\n  let deps: Array<any> | undefined = []\n  let result: TResult | undefined\n\n  const memoizedFn = (depArgs?: TDepArgs): TResult => {\n    onBeforeCompare?.()\n    const newDeps = memoDeps?.(depArgs)\n    const depsChanged =\n      !newDeps ||\n      newDeps.length !== deps?.length ||\n      newDeps.some((dep: any, index: number) => deps?.[index] !== dep)\n    onAfterCompare?.(depsChanged)\n\n    if (!depsChanged) {\n      return result!\n    }\n\n    deps = newDeps\n\n    onBeforeUpdate?.()\n    result = fn(...(newDeps ?? ([] as any)))\n    onAfterUpdate?.(result)\n\n    return result\n  }\n\n  setMemoFnMeta(memoizedFn, { originalArgsLength: fn.length })\n\n  return memoizedFn\n}\n\ninterface TableMemoOptions<\n  TFeatures extends TableFeatures,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n  TResult,\n> extends MemoOptions<TDeps, TDepArgs, TResult> {\n  feature?: keyof TFeatures & string\n  fnName: string\n  objectId?: string\n  onAfterUpdate?: () => void\n  table: Table_Internal<TFeatures, any>\n}\n\nconst pad = (str: number | string, num: number) => {\n  str = String(str)\n  while (str.length < num) {\n    str = ' ' + str\n  }\n  return str\n}\n\nexport function tableMemo<\n  TFeatures extends TableFeatures,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n  TResult,\n>({\n  feature,\n  fnName,\n  objectId,\n  onAfterUpdate,\n  table,\n  ...memoOptions\n}: TableMemoOptions<TFeatures, TDeps, TDepArgs, TResult>) {\n  let beforeCompareTime: number\n  let afterCompareTime: number\n  let startCalcTime: number\n  let endCalcTime: number\n  let runCount = 0\n  let debug: boolean | undefined\n  let debugCache: boolean | undefined\n\n  if (process.env.NODE_ENV === 'development') {\n    const { debugCache: _debugCache, debugAll } = table.options\n    debugCache = _debugCache\n    const { parentName } = getFunctionNameInfo(fnName, '.')\n\n    const debugByParent =\n      // @ts-expect-error\n      table.options[\n        `debug${(parentName != 'table' ? parentName + 's' : parentName).replace(\n          parentName,\n          parentName.charAt(0).toUpperCase() + parentName.slice(1),\n        )}`\n      ]\n    const debugByFeature = feature\n      ? // @ts-expect-error\n        table.options[\n          `debug${feature.charAt(0).toUpperCase() + feature.slice(1)}`\n        ]\n      : false\n\n    debug = debugAll || debugByParent || debugByFeature\n  }\n\n  function logTime(time: number, depsChanged: boolean) {\n    const runType =\n      runCount === 0\n        ? '(1st run)'\n        : depsChanged\n          ? '(rerun #' + runCount + ')'\n          : '(cache)'\n    runCount++\n\n    console.groupCollapsed(\n      `%c⏱ ${pad(`${time.toFixed(1)} ms`, 12)} %c${runType}%c ${fnName}%c ${objectId ? `(${fnName.split('.')[0]}Id: ${objectId})` : ''}`,\n      `font-size: .6rem; font-weight: bold; ${\n        depsChanged\n          ? `color: hsl(\n        ${Math.max(0, Math.min(120 - Math.log10(time) * 60, 120))}deg 100% 31%);`\n          : ''\n      } `,\n      `color: ${runCount < 2 ? '#FF00FF' : '#FF1493'}`,\n      'color: #666',\n      'color: #87CEEB',\n    )\n    console.info({\n      feature,\n      state: table.store.state,\n      deps: memoOptions.memoDeps?.toString(),\n    })\n    console.trace()\n    console.groupEnd()\n  }\n\n  const debugOptions =\n    process.env.NODE_ENV === 'development'\n      ? {\n          onBeforeCompare: () => {\n            if (debugCache) {\n              beforeCompareTime = performance.now()\n            }\n          },\n          onAfterCompare: (depsChanged: boolean) => {\n            if (debugCache) {\n              afterCompareTime = performance.now()\n              const compareTime =\n                Math.round((afterCompareTime - beforeCompareTime) * 100) / 100\n              if (!depsChanged) {\n                logTime(compareTime, depsChanged)\n              }\n            }\n          },\n          onBeforeUpdate: () => {\n            if (debug) {\n              startCalcTime = performance.now()\n            }\n          },\n          onAfterUpdate: () => {\n            if (debug) {\n              endCalcTime = performance.now()\n              const executionTime =\n                Math.round((endCalcTime - startCalcTime) * 100) / 100\n              logTime(executionTime, true)\n            }\n            queueMicrotask(() => onAfterUpdate?.())\n          },\n        }\n      : {\n          onAfterUpdate: () => {\n            queueMicrotask(() => onAfterUpdate?.())\n          },\n        }\n\n  return memo({\n    ...memoOptions,\n    ...debugOptions,\n  })\n}\n\nexport interface API<TDeps extends ReadonlyArray<any>, TDepArgs> {\n  fn: (...args: any) => any\n  memoDeps?: (depArgs?: any) => [...any] | undefined\n}\n\nexport type APIObject<TDeps extends ReadonlyArray<any>, TDepArgs> = Record<\n  string,\n  API<TDeps, TDepArgs>\n>\n\n/**\n * Assumes that a function name is in the format of `parentName_fnKey` and returns the `fnKey` and `fnName` in the format of `parentName.fnKey`.\n */\nexport function getFunctionNameInfo(\n  staticFnName: string,\n  splitBy: '_' | '.' = '_',\n) {\n  const [parentName, fnKey] = staticFnName.split(splitBy)\n  const fnName = `${parentName}.${fnKey}`\n  return { fnKey, fnName, parentName } as {\n    fnKey: string\n    fnName: string\n    parentName: string\n  }\n}\n\n/**\n * Assigns Table API methods directly to the table instance.\n * Unlike row/cell/column/header, the table is a singleton so methods are assigned directly.\n */\nexport function assignTableAPIs<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n>(\n  feature: keyof TFeatures & string,\n  table: Table_Internal<TFeatures, TData>,\n  apis: APIObject<TDeps, NoInfer<TDepArgs>>,\n): void {\n  for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {\n    const { fnKey, fnName } = getFunctionNameInfo(staticFnName)\n\n    ;(table as Record<string, any>)[fnKey] = memoDeps\n      ? tableMemo({\n          memoDeps,\n          fn,\n          fnName,\n          table,\n          feature,\n        })\n      : fn\n  }\n}\n\nexport interface PrototypeAPI<TDeps extends ReadonlyArray<any>, TDepArgs> {\n  fn: (self: any, ...args: any) => any\n  memoDeps?: (self: any, depArgs?: any) => [...any] | undefined\n}\n\nexport type PrototypeAPIObject<\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n> = Record<string, PrototypeAPI<TDeps, TDepArgs>>\n\n/**\n * Assigns API methods to a prototype object for memory-efficient method sharing.\n * All instances created with this prototype will share the same method references.\n *\n * For memoized methods, the memo state is lazily created and stored on each instance.\n * This provides the best of both worlds: shared method code + per-instance caching.\n */\nexport function assignPrototypeAPIs<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n>(\n  feature: keyof TFeatures & string,\n  prototype: Record<string, any>,\n  table: Table_Internal<TFeatures, TData>,\n  apis: PrototypeAPIObject<TDeps, NoInfer<TDepArgs>>,\n): void {\n  for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {\n    const { fnKey, fnName } = getFunctionNameInfo(staticFnName)\n\n    if (memoDeps) {\n      // For memoized methods, create a function that lazily initializes\n      // the memo on first access and stores it on the instance\n      const memoKey = `_memo_${fnKey}`\n\n      prototype[fnKey] = function (this: any, ...args: Array<any>) {\n        // Lazily create memo on first access for this instance\n        if (!this[memoKey]) {\n          const self = this\n          this[memoKey] = tableMemo({\n            memoDeps: () => memoDeps(self),\n            fn: (...deps) => fn(self, ...deps),\n            fnName,\n            objectId: self.id,\n            table,\n            feature,\n          })\n        }\n        return this[memoKey](...args)\n      }\n    } else {\n      // Non-memoized methods just call the static function with `this`\n      prototype[fnKey] = function (this: any, ...args: Array<any>) {\n        return fn(this, ...args)\n      }\n    }\n\n    setMemoFnMeta(prototype[fnKey], { originalArgsLength: fn.length })\n  }\n}\n\n/**\n * Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fallback to the static method passed in.\n */\nexport function callMemoOrStaticFn<\n  TObject extends Record<string, any>,\n  TStaticFn extends AnyFunction,\n>(\n  obj: TObject,\n  fnKey: string,\n  staticFn: TStaticFn,\n  ...args: Parameters<TStaticFn> extends [any, ...infer Rest] ? Rest : never\n): ReturnType<TStaticFn> {\n  return (\n    (obj[fnKey] as Function | undefined)?.(...args) ?? staticFn(obj, ...args)\n  )\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/table-core",
-  "version": "9.0.0-alpha.13",
+  "version": "9.0.0-alpha.16",
   "description": "Headless UI for building powerful tables & datagrids for TS/JS.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -45,7 +45,7 @@
     "src"
   ],
   "dependencies": {
-    "@tanstack/store": "^0.9.1"
+    "@tanstack/store": "^0.9.2"
   },
   "scripts": {
     "clean": "rimraf ./build && rimraf ./dist",

package/src/core/table/constructTable.ts

@@ -34,6 +34,12 @@ export function constructTable<
     _features: { ...coreFeatures, ...tableOptions._features },
     _rowModels: {},
     _rowModelFns: {},
+    get options() {
+      return this.optionsStore.state
+    },
+    set options(value) {
+      this.optionsStore.setState(() => value)
+    },
   } as Table_Internal<TFeatures, TData>
 
   const featuresList: Array<TableFeature<{}>> = Object.values(table._features)
@@ -42,10 +48,10 @@ export function constructTable<
     return Object.assign(obj, feature.getDefaultTableOptions?.(table))
   }, {}) as TableOptions<TFeatures, TData>
 
-  table.options = {
+  table.optionsStore = createStore({
     ...defaultOptions,
     ...tableOptions,
-  }
+  })
 
   table.initialState = getInitialTableState(
     table._features,
@@ -58,7 +64,7 @@ export function constructTable<
     const state = table.baseStore.state
     return {
       ...state,
-      ...(table.options.state ?? {}),
+      ...(table.optionsStore.state.state ?? {}),
     }
   })
 

package/src/core/table/coreTablesFeature.types.ts

@@ -94,6 +94,10 @@ export interface Table_CoreProperties<
    * The base store for the table. This can be used to write to the table state.
    */
   baseStore: Store<TableState<TFeatures>>
+  /**
+   * The base store for the table options.
+   */
+  optionsStore: Store<TableOptions<TFeatures, TData>>
   /**
    * This is the resolved initial state of the table.
    */
@@ -101,7 +105,7 @@ export interface Table_CoreProperties<
   /**
    * A read-only reference to the table's current options.
    */
-  options: TableOptions<TFeatures, TData>
+  readonly options: TableOptions<TFeatures, TData>
   /**
    * Where the table state is stored.
    */

package/src/core/table/coreTablesFeature.utils.ts

@@ -36,5 +36,6 @@ export function table_setOptions<
   updater: Updater<TableOptions<TFeatures, TData>>,
 ): void {
   const newOptions = functionalUpdate(updater, table.options)
-  table.options = table_mergeOptions(table, newOptions)
+  const mergedOptions = table_mergeOptions(table, newOptions)
+  table.optionsStore.setState(() => mergedOptions)
 }

package/src/features/table-reactivity/tableReactivityFeature.ts

@@ -0,0 +1,47 @@
+import type { ReadonlyStore, Store } from '@tanstack/store'
+import type { TableFeature, TableFeatures } from '../../types/TableFeatures'
+import type { RowData } from '../../types/type-utils'
+
+interface TableReactivityFeatureConstructors<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> {}
+
+export function constructReactivityFeature<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+>(bindings: {
+  stateNotifier?: () => unknown
+  optionsNotifier?: () => unknown
+}): TableFeature<TableReactivityFeatureConstructors<TFeatures, TData>> {
+  return {
+    constructTableAPIs: (table) => {
+      table.store = bindStore(table.store, bindings.stateNotifier)
+      table.optionsStore = bindStore(
+        table.optionsStore,
+        bindings.optionsNotifier,
+      )
+    },
+  }
+}
+
+const bindStore = <T extends Store<any> | ReadonlyStore<any>>(
+  store: T,
+  notifier?: () => unknown,
+): T => {
+  const stateDescriptor = Object.getOwnPropertyDescriptor(
+    Object.getPrototypeOf(store),
+    'state',
+  )!
+
+  Object.defineProperty(store, 'state', {
+    configurable: true,
+    enumerable: true,
+    get() {
+      notifier?.()
+      return stateDescriptor.get!.call(store)
+    },
+  })
+
+  return store
+}

package/src/index.ts

@@ -78,6 +78,9 @@ export * from './fns/sortFns'
 
 export * from './features/stockFeatures'
 
+// tableReactivityFeature
+export * from './features/table-reactivity/tableReactivityFeature'
+
 // columnFacetingFeature
 export * from './features/column-faceting/columnFacetingFeature'
 export * from './features/column-faceting/columnFacetingFeature.types'

package/src/utils.ts

@@ -16,7 +16,7 @@ export function makeStateUpdater<
   K extends (string & {}) | keyof TableState_All | keyof TableState<TFeatures>,
 >(key: K, instance: Table<TFeatures, any>) {
   return (updater: Updater<TableState<any>[K & keyof TableState<any>]>) => {
-    ;(instance as Table_Internal<any, any>).baseStore.setState(
+    instance.baseStore.setState(
       <TTableState extends TableState_All>(old: TTableState) => {
         return {
           ...old,