@tanstack/table-core 9.0.0-alpha.0 → 9.0.0-alpha.11

package/dist/esm/utils.js

@@ -5,12 +5,14 @@ function noop() {
 }
 function makeStateUpdater(key, instance) {
   return (updater) => {
-    instance.setState((old) => {
-      return {
-        ...old,
-        [key]: functionalUpdate(updater, old[key])
-      };
-    });
+    instance.baseStore.setState(
+      (old) => {
+        return {
+          ...old,
+          [key]: functionalUpdate(updater, old[key])
+        };
+      }
+    );
   };
 }
 function isFunction(d) {
@@ -25,7 +27,7 @@ function flattenBy(arr, getChildren) {
     subArr.forEach((item) => {
       flat.push(item);
       const children = getChildren(item);
-      if (children == null ? void 0 : children.length) {
+      if (children.length) {
         recurse(children);
       }
     });
@@ -33,68 +35,197 @@ function flattenBy(arr, getChildren) {
   recurse(arr);
   return flat;
 }
-function memo(getDeps, fn, opts) {
+const $internalMemoFnMeta = /* @__PURE__ */ Symbol("memoFnMeta");
+function setMemoFnMeta(fn, meta) {
+  Object.defineProperty(fn, $internalMemoFnMeta, { value: meta });
+}
+function getMemoFnMeta(fn) {
+  return (typeof fn === "function" && fn[$internalMemoFnMeta]) ?? null;
+}
+const memo = ({
+  fn,
+  memoDeps,
+  onAfterCompare,
+  onAfterUpdate,
+  onBeforeCompare,
+  onBeforeUpdate
+}) => {
   let deps = [];
   let result;
-  return (depArgs) => {
-    var _a;
-    let depTime;
-    if (opts.key && opts.debug)
-      depTime = Date.now();
-    const newDeps = getDeps(depArgs);
-    const depsChanged = newDeps.length !== deps.length || newDeps.some((dep, index) => deps[index] !== dep);
+  const memoizedFn = (depArgs) => {
+    onBeforeCompare?.();
+    const newDeps = memoDeps?.(depArgs);
+    const depsChanged = !newDeps || newDeps.length !== deps?.length || newDeps.some((dep, index) => deps?.[index] !== dep);
+    onAfterCompare?.(depsChanged);
     if (!depsChanged) {
       return result;
     }
     deps = newDeps;
-    let resultTime;
-    if (opts.key && opts.debug)
-      resultTime = Date.now();
-    result = fn(...newDeps);
-    (_a = opts == null ? void 0 : opts.onChange) == null ? void 0 : _a.call(opts, result);
-    if (opts.key && opts.debug) {
-      if (opts == null ? void 0 : opts.debug()) {
-        const depEndTime = Math.round((Date.now() - depTime) * 100) / 100;
-        const resultEndTime = Math.round((Date.now() - resultTime) * 100) / 100;
-        const resultFpsPercentage = resultEndTime / 16;
-        const pad = (str, num) => {
-          str = String(str);
-          while (str.length < num) {
-            str = " " + str;
-          }
-          return str;
-        };
-        console.info(
-          `%c⏱ ${pad(resultEndTime, 5)} /${pad(depEndTime, 5)} ms`,
-          `
-            font-size: .6rem;
-            font-weight: bold;
-            color: hsl(${Math.max(
-            0,
-            Math.min(120 - 120 * resultFpsPercentage, 120)
-          )}deg 100% 31%);`,
-          opts == null ? void 0 : opts.key
-        );
+    onBeforeUpdate?.();
+    result = fn(...newDeps ?? []);
+    onAfterUpdate?.(result);
+    return result;
+  };
+  setMemoFnMeta(memoizedFn, { originalArgsLength: fn.length });
+  return memoizedFn;
+};
+const pad = (str, num) => {
+  str = String(str);
+  while (str.length < num) {
+    str = " " + str;
+  }
+  return str;
+};
+function tableMemo({
+  feature,
+  fnName,
+  objectId,
+  onAfterUpdate,
+  table,
+  ...memoOptions
+}) {
+  let beforeCompareTime;
+  let afterCompareTime;
+  let startCalcTime;
+  let endCalcTime;
+  let runCount = 0;
+  let debug;
+  let debugCache;
+  if (process.env.NODE_ENV === "development") {
+    const { debugCache: _debugCache, debugAll } = table.options;
+    debugCache = _debugCache;
+    const { parentName } = getFunctionNameInfo(fnName, ".");
+    const debugByParent = (
+      // @ts-expect-error
+      table.options[`debug${(parentName != "table" ? parentName + "s" : parentName).replace(
+        parentName,
+        parentName.charAt(0).toUpperCase() + parentName.slice(1)
+      )}`]
+    );
+    const debugByFeature = feature ? (
+      // @ts-expect-error
+      table.options[`debug${feature.charAt(0).toUpperCase() + feature.slice(1)}`]
+    ) : false;
+    debug = debugAll || debugByParent || debugByFeature;
+  }
+  function logTime(time, depsChanged) {
+    const runType = runCount === 0 ? "(1st run)" : depsChanged ? "(rerun #" + runCount + ")" : "(cache)";
+    runCount++;
+    console.groupCollapsed(
+      `%c⏱ ${pad(`${time.toFixed(1)} ms`, 12)} %c${runType}%c ${fnName}%c ${objectId ? `(${fnName.split(".")[0]}Id: ${objectId})` : ""}`,
+      `font-size: .6rem; font-weight: bold; ${depsChanged ? `color: hsl(
+        ${Math.max(0, Math.min(120 - Math.log10(time) * 60, 120))}deg 100% 31%);` : ""} `,
+      `color: ${runCount < 2 ? "#FF00FF" : "#FF1493"}`,
+      "color: #666",
+      "color: #87CEEB"
+    );
+    console.info({
+      feature,
+      state: table.store.state,
+      deps: memoOptions.memoDeps?.toString()
+    });
+    console.trace();
+    console.groupEnd();
+  }
+  const debugOptions = process.env.NODE_ENV === "development" ? {
+    onBeforeCompare: () => {
+      if (debugCache) {
+        beforeCompareTime = performance.now();
       }
+    },
+    onAfterCompare: (depsChanged) => {
+      if (debugCache) {
+        afterCompareTime = performance.now();
+        const compareTime = Math.round((afterCompareTime - beforeCompareTime) * 100) / 100;
+        if (!depsChanged) {
+          logTime(compareTime, depsChanged);
+        }
+      }
+    },
+    onBeforeUpdate: () => {
+      if (debug) {
+        startCalcTime = performance.now();
+      }
+    },
+    onAfterUpdate: () => {
+      if (debug) {
+        endCalcTime = performance.now();
+        const executionTime = Math.round((endCalcTime - startCalcTime) * 100) / 100;
+        logTime(executionTime, true);
+      }
+      queueMicrotask(() => onAfterUpdate?.());
+    }
+  } : {
+    onAfterUpdate: () => {
+      queueMicrotask(() => onAfterUpdate?.());
     }
-    return result;
   };
+  return memo({
+    ...memoOptions,
+    ...debugOptions
+  });
 }
-function getMemoOptions(tableOptions, debugLevel, key, onChange) {
-  return {
-    debug: () => (tableOptions == null ? void 0 : tableOptions.debugAll) ?? tableOptions[debugLevel],
-    key: process.env.NODE_ENV === "development" && key,
-    onChange
-  };
+function getFunctionNameInfo(staticFnName, splitBy = "_") {
+  const [parentName, fnKey] = staticFnName.split(splitBy);
+  const fnName = `${parentName}.${fnKey}`;
+  return { fnKey, fnName, parentName };
+}
+function assignTableAPIs(feature, table, apis) {
+  for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {
+    const { fnKey, fnName } = getFunctionNameInfo(staticFnName);
+    table[fnKey] = memoDeps ? tableMemo({
+      memoDeps,
+      fn,
+      fnName,
+      table,
+      feature
+    }) : fn;
+  }
+}
+function assignPrototypeAPIs(feature, prototype, table, apis) {
+  for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {
+    const { fnKey, fnName } = getFunctionNameInfo(staticFnName);
+    if (memoDeps) {
+      const memoKey = `_memo_${fnKey}`;
+      prototype[fnKey] = function(...args) {
+        if (!this[memoKey]) {
+          const self = this;
+          this[memoKey] = tableMemo({
+            memoDeps: () => memoDeps(self),
+            fn: (...deps) => fn(self, ...deps),
+            fnName,
+            objectId: self.id,
+            table,
+            feature
+          });
+        }
+        return this[memoKey](...args);
+      };
+    } else {
+      prototype[fnKey] = function(...args) {
+        return fn(this, ...args);
+      };
+    }
+    setMemoFnMeta(prototype[fnKey], { originalArgsLength: fn.length });
+  }
+}
+function callMemoOrStaticFn(obj, fnKey, staticFn, ...args) {
+  return obj[fnKey]?.(...args) ?? staticFn(obj, ...args);
 }
 export {
+  $internalMemoFnMeta,
+  assignPrototypeAPIs,
+  assignTableAPIs,
+  callMemoOrStaticFn,
   flattenBy,
   functionalUpdate,
-  getMemoOptions,
+  getFunctionNameInfo,
+  getMemoFnMeta,
   isFunction,
   isNumberArray,
   makeStateUpdater,
   memo,
-  noop
+  noop,
+  tableMemo
 };
 //# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../src/utils.ts"],"sourcesContent":["import { TableOptionsResolved, TableState, Updater } from './types'\n\nexport type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>\nexport type RequiredKeys<T, K extends keyof T> = Omit<T, K> &\n  Required<Pick<T, K>>\nexport type Overwrite<T, U extends { [TKey in keyof T]?: any }> = Omit<\n  T,\n  keyof U\n> &\n  U\n\nexport type UnionToIntersection<T> = (\n  T extends any ? (x: T) => any : never\n) extends (x: infer R) => any\n  ? R\n  : never\n\nexport type IsAny<T, Y, N> = 1 extends 0 & T ? Y : N\nexport type IsKnown<T, Y, N> = unknown extends T ? N : Y\n\ntype ComputeRange<\n  N extends number,\n  Result extends Array<unknown> = [],\n> = Result['length'] extends N\n  ? Result\n  : ComputeRange<N, [...Result, Result['length']]>\ntype Index40 = ComputeRange<40>[number]\n\n// Is this type a tuple?\ntype IsTuple<T> = T extends readonly any[] & { length: infer Length }\n  ? Length extends Index40\n    ? T\n    : never\n  : never\n\n// If this type is a tuple, what indices are allowed?\ntype AllowedIndexes<\n  Tuple extends ReadonlyArray<any>,\n  Keys extends number = never,\n> = Tuple extends readonly []\n  ? Keys\n  : Tuple extends readonly [infer _, ...infer Tail]\n    ? AllowedIndexes<Tail, Keys | Tail['length']>\n    : Keys\n\nexport type DeepKeys<T, TDepth extends any[] = []> = TDepth['length'] extends 5\n  ? never\n  : unknown extends T\n    ? string\n    : T extends readonly any[] & IsTuple<T>\n      ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth>\n      : T extends any[]\n        ? DeepKeys<T[number], [...TDepth, any]>\n        : T extends Date\n          ? never\n          : T extends object\n            ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth>\n            : never\n\ntype DeepKeysPrefix<\n  T,\n  TPrefix,\n  TDepth extends any[],\n> = TPrefix extends keyof T & (number | string)\n  ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}`\n  : never\n\nexport type DeepValue<T, TProp> = T extends Record<string | number, any>\n  ? TProp extends `${infer TBranch}.${infer TDeepProp}`\n    ? DeepValue<T[TBranch], TDeepProp>\n    : T[TProp & string]\n  : never\n\nexport type NoInfer<T> = [T][T extends any ? 0 : never]\n\nexport type Getter<TValue> = <TTValue = TValue>() => NoInfer<TTValue>\n\n///\n\nexport function functionalUpdate<T>(updater: Updater<T>, input: T): T {\n  return typeof updater === 'function'\n    ? (updater as (input: T) => T)(input)\n    : updater\n}\n\nexport function noop() {\n  //\n}\n\nexport function makeStateUpdater<K extends keyof TableState>(\n  key: K,\n  instance: unknown\n) {\n  return (updater: Updater<TableState[K]>) => {\n    ;(instance as any).setState(<TTableState>(old: TTableState) => {\n      return {\n        ...old,\n        [key]: functionalUpdate(updater, (old as any)[key]),\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 number[] {\n  return Array.isArray(d) && d.every(val => typeof val === 'number')\n}\n\nexport function flattenBy<TNode>(\n  arr: TNode[],\n  getChildren: (item: TNode) => TNode[]\n) {\n  const flat: TNode[] = []\n\n  const recurse = (subArr: 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 function memo<TDeps extends readonly any[], TDepArgs, TResult>(\n  getDeps: (depArgs?: TDepArgs) => [...TDeps],\n  fn: (...args: NoInfer<[...TDeps]>) => TResult,\n  opts: {\n    key: any\n    debug?: () => any\n    onChange?: (result: TResult) => void\n  }\n): (depArgs?: TDepArgs) => TResult {\n  let deps: any[] = []\n  let result: TResult | undefined\n\n  return depArgs => {\n    let depTime: number\n    if (opts.key && opts.debug) depTime = Date.now()\n\n    const newDeps = getDeps(depArgs)\n\n    const depsChanged =\n      newDeps.length !== deps.length ||\n      newDeps.some((dep: any, index: number) => deps[index] !== dep)\n\n    if (!depsChanged) {\n      return result!\n    }\n\n    deps = newDeps\n\n    let resultTime: number\n    if (opts.key && opts.debug) resultTime = Date.now()\n\n    result = fn(...newDeps)\n    opts?.onChange?.(result)\n\n    if (opts.key && opts.debug) {\n      if (opts?.debug()) {\n        const depEndTime = Math.round((Date.now() - depTime!) * 100) / 100\n        const resultEndTime = Math.round((Date.now() - resultTime!) * 100) / 100\n        const resultFpsPercentage = resultEndTime / 16\n\n        const pad = (str: number | string, num: number) => {\n          str = String(str)\n          while (str.length < num) {\n            str = ' ' + str\n          }\n          return str\n        }\n\n        console.info(\n          `%c⏱ ${pad(resultEndTime, 5)} /${pad(depEndTime, 5)} ms`,\n          `\n            font-size: .6rem;\n            font-weight: bold;\n            color: hsl(${Math.max(\n              0,\n              Math.min(120 - 120 * resultFpsPercentage, 120)\n            )}deg 100% 31%);`,\n          opts?.key\n        )\n      }\n    }\n\n    return result!\n  }\n}\n\nexport function getMemoOptions(\n  tableOptions: Partial<TableOptionsResolved<any>>,\n  debugLevel:\n    | 'debugAll'\n    | 'debugCells'\n    | 'debugTable'\n    | 'debugColumns'\n    | 'debugRows'\n    | 'debugHeaders',\n  key: string,\n  onChange?: (result: any) => void\n) {\n  return {\n    debug: () => tableOptions?.debugAll ?? tableOptions[debugLevel],\n    key: process.env.NODE_ENV === 'development' && key,\n    onChange,\n  }\n}\n"],"names":[],"mappings":"AA+EgB,SAAA,iBAAoB,SAAqB,OAAa;AACpE,SAAO,OAAO,YAAY,aACrB,QAA4B,KAAK,IAClC;AACN;AAEO,SAAS,OAAO;AAEvB;AAEgB,SAAA,iBACd,KACA,UACA;AACA,SAAO,CAAC,YAAoC;AACxC,aAAiB,SAAS,CAAc,QAAqB;AACtD,aAAA;AAAA,QACL,GAAG;AAAA,QACH,CAAC,GAAG,GAAG,iBAAiB,SAAU,IAAY,GAAG,CAAC;AAAA,MAAA;AAAA,IACpD,CACD;AAAA,EAAA;AAEL;AAIO,SAAS,WAAkC,GAAgB;AAChE,SAAO,aAAa;AACtB;AAEO,SAAS,cAAc,GAAuB;AAC5C,SAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA,QAAO,OAAO,QAAQ,QAAQ;AACnE;AAEgB,SAAA,UACd,KACA,aACA;AACA,QAAM,OAAgB,CAAA;AAEhB,QAAA,UAAU,CAAC,WAAoB;AACnC,WAAO,QAAQ,CAAQ,SAAA;AACrB,WAAK,KAAK,IAAI;AACR,YAAA,WAAW,YAAY,IAAI;AACjC,UAAI,qCAAU,QAAQ;AACpB,gBAAQ,QAAQ;AAAA,MAClB;AAAA,IAAA,CACD;AAAA,EAAA;AAGH,UAAQ,GAAG;AAEJ,SAAA;AACT;AAEgB,SAAA,KACd,SACA,IACA,MAKiC;AACjC,MAAI,OAAc,CAAA;AACd,MAAA;AAEJ,SAAO,CAAW,YAAA;AAnEJ;AAoER,QAAA;AACA,QAAA,KAAK,OAAO,KAAK;AAAO,gBAAU,KAAK;AAErC,UAAA,UAAU,QAAQ,OAAO;AAE/B,UAAM,cACJ,QAAQ,WAAW,KAAK,UACxB,QAAQ,KAAK,CAAC,KAAU,UAAkB,KAAK,KAAK,MAAM,GAAG;AAE/D,QAAI,CAAC,aAAa;AACT,aAAA;AAAA,IACT;AAEO,WAAA;AAEH,QAAA;AACA,QAAA,KAAK,OAAO,KAAK;AAAO,mBAAa,KAAK;AAErC,aAAA,GAAG,GAAG,OAAO;AACtB,uCAAM,aAAN,8BAAiB;AAEb,QAAA,KAAK,OAAO,KAAK,OAAO;AACtB,UAAA,6BAAM,SAAS;AACX,cAAA,aAAa,KAAK,OAAO,KAAK,QAAQ,WAAY,GAAG,IAAI;AACzD,cAAA,gBAAgB,KAAK,OAAO,KAAK,QAAQ,cAAe,GAAG,IAAI;AACrE,cAAM,sBAAsB,gBAAgB;AAEtC,cAAA,MAAM,CAAC,KAAsB,QAAgB;AACjD,gBAAM,OAAO,GAAG;AACT,iBAAA,IAAI,SAAS,KAAK;AACvB,kBAAM,MAAM;AAAA,UACd;AACO,iBAAA;AAAA,QAAA;AAGD,gBAAA;AAAA,UACN,OAAO,IAAI,eAAe,CAAC,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;AAAA,UACnD;AAAA;AAAA;AAAA,yBAGe,KAAK;AAAA,YAChB;AAAA,YACA,KAAK,IAAI,MAAM,MAAM,qBAAqB,GAAG;AAAA,UAC9C,CAAA;AAAA,UACH,6BAAM;AAAA,QAAA;AAAA,MAEV;AAAA,IACF;AAEO,WAAA;AAAA,EAAA;AAEX;AAEO,SAAS,eACd,cACA,YAOA,KACA,UACA;AACO,SAAA;AAAA,IACL,OAAO,OAAM,6CAAc,aAAY,aAAa,UAAU;AAAA,IAC9D,KAAK,QAAQ,IAAI,aAAa,iBAAiB;AAAA,IAC/C;AAAA,EAAA;AAEJ;"}
+{"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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/table-core",
-  "version": "9.0.0-alpha.0",
+  "version": "9.0.0-alpha.11",
   "description": "Headless UI for building powerful tables & datagrids for TS/JS.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -18,34 +18,43 @@
     "react",
     "vue",
     "solid",
+    "svelte",
+    "lit",
+    "angular",
     "table",
     "table-core",
     "datagrid"
   ],
   "type": "module",
   "types": "dist/esm/index.d.ts",
-  "main": "dist/cjs/index.cjs",
+  "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/esm/index.d.ts",
-        "default": "./dist/esm/index.js"
-      },
-      "require": {
-        "types": "./dist/cjs/index.d.cts",
-        "default": "./dist/cjs/index.cjs"
-      }
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
     },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
   "engines": {
-    "node": ">=12"
+    "node": ">=16"
   },
   "files": [
     "dist/",
     "src"
   ],
-  "scripts": {}
+  "dependencies": {
+    "@tanstack/store": "^0.8.0"
+  },
+  "scripts": {
+    "clean": "rimraf ./build && rimraf ./dist",
+    "lint:fix": "eslint ./src --fix",
+    "test:eslint": "eslint ./src",
+    "test:lib": "vitest",
+    "test:lib:dev": "pnpm test:lib --watch",
+    "test:types": "tsc",
+    "test:build": "publint --strict",
+    "build": "vite build"
+  }
 }

package/src/core/cells/constructCell.ts

@@ -0,0 +1,49 @@
+import type { Table_Internal } from '../../types/Table'
+import type { CellData, RowData } from '../../types/type-utils'
+import type { TableFeatures } from '../../types/TableFeatures'
+import type { Row } from '../../types/Row'
+import type { Cell } from '../../types/Cell'
+import type { Column } from '../../types/Column'
+import type { Cell_CoreProperties } from './coreCellsFeature.types'
+
+/**
+ * Creates or retrieves the cell prototype for a table.
+ * The prototype is cached on the table and shared by all cell instances.
+ */
+function getCellPrototype<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+>(table: Table_Internal<TFeatures, TData>): object {
+  if (!table._cellPrototype) {
+    table._cellPrototype = { table }
+    for (const feature of Object.values(table._features)) {
+      feature.assignCellPrototype?.(table._cellPrototype, table)
+    }
+  }
+  return table._cellPrototype
+}
+
+export function constructCell<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+>(
+  column: Column<TFeatures, TData, TValue>,
+  row: Row<TFeatures, TData>,
+  table: Table_Internal<TFeatures, TData>,
+): Cell<TFeatures, TData, TValue> {
+  // Create cell with shared prototype for memory efficiency
+  const cellPrototype = getCellPrototype(table)
+  const cell = Object.create(cellPrototype) as Cell_CoreProperties<
+    TFeatures,
+    TData,
+    TValue
+  >
+
+  // Only assign instance-specific properties
+  cell.column = column
+  cell.id = `${row.id}_${column.id}`
+  cell.row = row
+
+  return cell as Cell<TFeatures, TData, TValue>
+}

package/src/core/cells/coreCellsFeature.ts

@@ -0,0 +1,44 @@
+import { assignPrototypeAPIs } from '../../utils'
+import {
+  cell_getContext,
+  cell_getValue,
+  cell_renderValue,
+} from './coreCellsFeature.utils'
+import type { RowData } from '../../types/type-utils'
+import type { TableFeature, TableFeatures } from '../../types/TableFeatures'
+// import type { Cell_Cell, TableOptions_Cell } from './coreCellsFeature.types'
+
+interface CoreCellsFeatureConstructors<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+> {
+  // Cell: Cell_Cell<TableFeatures, RowData>
+  // TableOptions: TableOptions_Cell
+}
+
+export function constructCoreCellsFeature<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+>(): TableFeature<CoreCellsFeatureConstructors<TFeatures, TData>> {
+  return {
+    assignCellPrototype: (prototype, table) => {
+      assignPrototypeAPIs('coreCellsFeature', prototype, table, {
+        cell_getValue: {
+          fn: (cell) => cell_getValue(cell),
+        },
+        cell_renderValue: {
+          fn: (cell) => cell_renderValue(cell),
+        },
+        cell_getContext: {
+          fn: (cell) => cell_getContext(cell),
+          memoDeps: (cell) => [cell],
+        },
+      })
+    },
+  }
+}
+
+/**
+ * The Core Cells feature provides the core cell functionality.
+ */
+export const coreCellsFeature = constructCoreCellsFeature()

package/src/core/cells/coreCellsFeature.types.ts

@@ -0,0 +1,68 @@
+import type { CellData, Getter, RowData } from '../../types/type-utils'
+import type { TableFeatures } from '../../types/TableFeatures'
+import type { Table, Table_Internal } from '../../types/Table'
+import type { Row } from '../../types/Row'
+import type { Cell } from '../../types/Cell'
+import type { Column } from '../../types/Column'
+
+export interface CellContext<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+> {
+  cell: Cell<TFeatures, TData, TValue>
+  column: Column<TFeatures, TData, TValue>
+  getValue: Getter<TValue>
+  renderValue: Getter<TValue | null>
+  row: Row<TFeatures, TData>
+  table: Table<TFeatures, TData>
+}
+
+export interface Cell_CoreProperties<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+> {
+  /**
+   * The associated Column object for the cell.
+   */
+  column: Column<TFeatures, TData, TValue>
+  /**
+   * The unique ID for the cell across the entire table.
+   */
+  id: string
+  /**
+   * The associated Row object for the cell.
+   */
+  row: Row<TFeatures, TData>
+  /**
+   * Reference to the parent table instance.
+   */
+  table: Table_Internal<TFeatures, TData>
+}
+
+export interface Cell_Cell<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+> extends Cell_CoreProperties<TFeatures, TData, TValue> {
+  /**
+   * Returns the rendering context (or props) for cell-based components like cells and aggregated cells. Use these props with your framework's `flexRender` utility to render these using the template of your choice:
+   */
+  getContext: () => CellContext<TFeatures, TData, TValue>
+  /**
+   * Returns the value for the cell, accessed via the associated column's accessor key or accessor function.
+   */
+  getValue: CellContext<TFeatures, TData, TValue>['getValue']
+  /**
+   * Renders the value for a cell the same as `getValue`, but will return the `renderFallbackValue` if no value is found.
+   */
+  renderValue: CellContext<TFeatures, TData, TValue>['renderValue']
+}
+
+export interface TableOptions_Cell {
+  /**
+   * Value used when the desired value is not found in the data.
+   */
+  renderFallbackValue?: any
+}

package/src/core/cells/coreCellsFeature.utils.ts

@@ -0,0 +1,35 @@
+import type { CellData, RowData } from '../../types/type-utils'
+import type { TableFeatures } from '../../types/TableFeatures'
+import type { Cell } from '../../types/Cell'
+
+export function cell_getValue<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+>(cell: Cell<TFeatures, TData, TValue>): TValue {
+  return cell.row.getValue(cell.column.id)
+}
+
+export function cell_renderValue<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+>(cell: Cell<TFeatures, TData, TValue>) {
+  return cell.getValue() ?? cell.table.options.renderFallbackValue
+}
+
+export function cell_getContext<
+  TFeatures extends TableFeatures,
+  TData extends RowData,
+  TValue extends CellData = CellData,
+>(cell: Cell<TFeatures, TData, TValue>) {
+  return {
+    table: cell.table,
+    column: cell.column,
+    row: cell.row,
+    cell: cell,
+    // Wrap in arrow functions to preserve `this` binding (methods are on prototype)
+    getValue: () => cell.getValue(),
+    renderValue: () => cell.renderValue(),
+  }
+}