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

package/dist/cjs/aggregationFns.cjs

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("./utils.cjs");
+const sum = (columnId, _leafRows, childRows) => {
+  return childRows.reduce((sum2, next) => {
+    const nextValue = next.getValue(columnId);
+    return sum2 + (typeof nextValue === "number" ? nextValue : 0);
+  }, 0);
+};
+const min = (columnId, _leafRows, childRows) => {
+  let min2;
+  childRows.forEach((row) => {
+    const value = row.getValue(columnId);
+    if (value != null && (min2 > value || min2 === void 0 && value >= value)) {
+      min2 = value;
+    }
+  });
+  return min2;
+};
+const max = (columnId, _leafRows, childRows) => {
+  let max2;
+  childRows.forEach((row) => {
+    const value = row.getValue(columnId);
+    if (value != null && (max2 < value || max2 === void 0 && value >= value)) {
+      max2 = value;
+    }
+  });
+  return max2;
+};
+const extent = (columnId, _leafRows, childRows) => {
+  let min2;
+  let max2;
+  childRows.forEach((row) => {
+    const value = row.getValue(columnId);
+    if (value != null) {
+      if (min2 === void 0) {
+        if (value >= value)
+          min2 = max2 = value;
+      } else {
+        if (min2 > value)
+          min2 = value;
+        if (max2 < value)
+          max2 = value;
+      }
+    }
+  });
+  return [min2, max2];
+};
+const mean = (columnId, leafRows) => {
+  let count2 = 0;
+  let sum2 = 0;
+  leafRows.forEach((row) => {
+    let value = row.getValue(columnId);
+    if (value != null && (value = +value) >= value) {
+      ++count2, sum2 += value;
+    }
+  });
+  if (count2)
+    return sum2 / count2;
+  return;
+};
+const median = (columnId, leafRows) => {
+  if (!leafRows.length) {
+    return;
+  }
+  const values = leafRows.map((row) => row.getValue(columnId));
+  if (!utils.isNumberArray(values)) {
+    return;
+  }
+  if (values.length === 1) {
+    return values[0];
+  }
+  const mid = Math.floor(values.length / 2);
+  const nums = values.sort((a, b) => a - b);
+  return values.length % 2 !== 0 ? nums[mid] : (nums[mid - 1] + nums[mid]) / 2;
+};
+const unique = (columnId, leafRows) => {
+  return Array.from(new Set(leafRows.map((d) => d.getValue(columnId))).values());
+};
+const uniqueCount = (columnId, leafRows) => {
+  return new Set(leafRows.map((d) => d.getValue(columnId))).size;
+};
+const count = (_columnId, leafRows) => {
+  return leafRows.length;
+};
+const aggregationFns = {
+  sum,
+  min,
+  max,
+  extent,
+  mean,
+  median,
+  unique,
+  uniqueCount,
+  count
+};
+exports.aggregationFns = aggregationFns;
+//# sourceMappingURL=aggregationFns.cjs.map

package/dist/cjs/aggregationFns.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregationFns.cjs","sources":["../../src/aggregationFns.ts"],"sourcesContent":["import { AggregationFn } from './features/ColumnGrouping'\nimport { isNumberArray } from './utils'\n\nconst sum: AggregationFn<any> = (columnId, _leafRows, childRows) => {\n  // It's faster to just add the aggregations together instead of\n  // process leaf nodes individually\n  return childRows.reduce((sum, next) => {\n    const nextValue = next.getValue(columnId)\n    return sum + (typeof nextValue === 'number' ? nextValue : 0)\n  }, 0)\n}\n\nconst min: AggregationFn<any> = (columnId, _leafRows, childRows) => {\n  let min: number | undefined\n\n  childRows.forEach(row => {\n    const value = row.getValue<number>(columnId)\n\n    if (\n      value != null &&\n      (min! > value || (min === undefined && value >= value))\n    ) {\n      min = value\n    }\n  })\n\n  return min\n}\n\nconst max: AggregationFn<any> = (columnId, _leafRows, childRows) => {\n  let max: number | undefined\n\n  childRows.forEach(row => {\n    const value = row.getValue<number>(columnId)\n    if (\n      value != null &&\n      (max! < value || (max === undefined && value >= value))\n    ) {\n      max = value\n    }\n  })\n\n  return max\n}\n\nconst extent: AggregationFn<any> = (columnId, _leafRows, childRows) => {\n  let min: number | undefined\n  let max: number | undefined\n\n  childRows.forEach(row => {\n    const value = row.getValue<number>(columnId)\n    if (value != null) {\n      if (min === undefined) {\n        if (value >= value) min = max = value\n      } else {\n        if (min > value) min = value\n        if (max! < value) max = value\n      }\n    }\n  })\n\n  return [min, max]\n}\n\nconst mean: AggregationFn<any> = (columnId, leafRows) => {\n  let count = 0\n  let sum = 0\n\n  leafRows.forEach(row => {\n    let value = row.getValue<number>(columnId)\n    if (value != null && (value = +value) >= value) {\n      ++count, (sum += value)\n    }\n  })\n\n  if (count) return sum / count\n\n  return\n}\n\nconst median: AggregationFn<any> = (columnId, leafRows) => {\n  if (!leafRows.length) {\n    return\n  }\n\n  const values = leafRows.map(row => row.getValue(columnId))\n  if (!isNumberArray(values)) {\n    return\n  }\n  if (values.length === 1) {\n    return values[0]\n  }\n\n  const mid = Math.floor(values.length / 2)\n  const nums = values.sort((a, b) => a - b)\n  return values.length % 2 !== 0 ? nums[mid] : (nums[mid - 1]! + nums[mid]!) / 2\n}\n\nconst unique: AggregationFn<any> = (columnId, leafRows) => {\n  return Array.from(new Set(leafRows.map(d => d.getValue(columnId))).values())\n}\n\nconst uniqueCount: AggregationFn<any> = (columnId, leafRows) => {\n  return new Set(leafRows.map(d => d.getValue(columnId))).size\n}\n\nconst count: AggregationFn<any> = (_columnId, leafRows) => {\n  return leafRows.length\n}\n\nexport const aggregationFns = {\n  sum,\n  min,\n  max,\n  extent,\n  mean,\n  median,\n  unique,\n  uniqueCount,\n  count,\n}\n\nexport type BuiltInAggregationFn = keyof typeof aggregationFns\n"],"names":["sum","min","max","count","isNumberArray"],"mappings":";;;AAGA,MAAM,MAA0B,CAAC,UAAU,WAAW,cAAc;AAGlE,SAAO,UAAU,OAAO,CAACA,MAAK,SAAS;AAC/B,UAAA,YAAY,KAAK,SAAS,QAAQ;AACxC,WAAOA,QAAO,OAAO,cAAc,WAAW,YAAY;AAAA,KACzD,CAAC;AACN;AAEA,MAAM,MAA0B,CAAC,UAAU,WAAW,cAAc;AAC9DC,MAAAA;AAEJ,YAAU,QAAQ,CAAO,QAAA;AACjB,UAAA,QAAQ,IAAI,SAAiB,QAAQ;AAE3C,QACE,SAAS,SACRA,OAAO,SAAUA,SAAQ,UAAa,SAAS,QAChD;AACAA,aAAM;AAAA,IACR;AAAA,EAAA,CACD;AAEMA,SAAAA;AACT;AAEA,MAAM,MAA0B,CAAC,UAAU,WAAW,cAAc;AAC9DC,MAAAA;AAEJ,YAAU,QAAQ,CAAO,QAAA;AACjB,UAAA,QAAQ,IAAI,SAAiB,QAAQ;AAC3C,QACE,SAAS,SACRA,OAAO,SAAUA,SAAQ,UAAa,SAAS,QAChD;AACAA,aAAM;AAAA,IACR;AAAA,EAAA,CACD;AAEMA,SAAAA;AACT;AAEA,MAAM,SAA6B,CAAC,UAAU,WAAW,cAAc;AACjED,MAAAA;AACAC,MAAAA;AAEJ,YAAU,QAAQ,CAAO,QAAA;AACjB,UAAA,QAAQ,IAAI,SAAiB,QAAQ;AAC3C,QAAI,SAAS,MAAM;AACjB,UAAID,SAAQ,QAAW;AACrB,YAAI,SAAS;AAAOA,iBAAMC,OAAM;AAAA,MAAA,OAC3B;AACL,YAAID,OAAM;AAAOA,iBAAM;AACvB,YAAIC,OAAO;AAAOA,iBAAM;AAAA,MAC1B;AAAA,IACF;AAAA,EAAA,CACD;AAEM,SAAA,CAACD,MAAKC,IAAG;AAClB;AAEA,MAAM,OAA2B,CAAC,UAAU,aAAa;AACvD,MAAIC,SAAQ;AACZ,MAAIH,OAAM;AAEV,WAAS,QAAQ,CAAO,QAAA;AAClB,QAAA,QAAQ,IAAI,SAAiB,QAAQ;AACzC,QAAI,SAAS,SAAS,QAAQ,CAAC,UAAU,OAAO;AAC9C,QAAEG,QAAQH,QAAO;AAAA,IACnB;AAAA,EAAA,CACD;AAEGG,MAAAA;AAAO,WAAOH,OAAMG;AAExB;AACF;AAEA,MAAM,SAA6B,CAAC,UAAU,aAAa;AACrD,MAAA,CAAC,SAAS,QAAQ;AACpB;AAAA,EACF;AAEA,QAAM,SAAS,SAAS,IAAI,SAAO,IAAI,SAAS,QAAQ,CAAC;AACrD,MAAA,CAACC,MAAAA,cAAc,MAAM,GAAG;AAC1B;AAAA,EACF;AACI,MAAA,OAAO,WAAW,GAAG;AACvB,WAAO,OAAO,CAAC;AAAA,EACjB;AAEA,QAAM,MAAM,KAAK,MAAM,OAAO,SAAS,CAAC;AACxC,QAAM,OAAO,OAAO,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AACxC,SAAO,OAAO,SAAS,MAAM,IAAI,KAAK,GAAG,KAAK,KAAK,MAAM,CAAC,IAAK,KAAK,GAAG,KAAM;AAC/E;AAEA,MAAM,SAA6B,CAAC,UAAU,aAAa;AACzD,SAAO,MAAM,KAAK,IAAI,IAAI,SAAS,IAAI,CAAA,MAAK,EAAE,SAAS,QAAQ,CAAC,CAAC,EAAE,OAAQ,CAAA;AAC7E;AAEA,MAAM,cAAkC,CAAC,UAAU,aAAa;AACvD,SAAA,IAAI,IAAI,SAAS,IAAI,CAAA,MAAK,EAAE,SAAS,QAAQ,CAAC,CAAC,EAAE;AAC1D;AAEA,MAAM,QAA4B,CAAC,WAAW,aAAa;AACzD,SAAO,SAAS;AAClB;AAEO,MAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;"}

package/dist/cjs/aggregationFns.d.cts

@@ -0,0 +1,14 @@
+import { AggregationFn } from './features/ColumnGrouping.cjs';
+
+export declare const aggregationFns: {
+    sum: AggregationFn<any>;
+    min: AggregationFn<any>;
+    max: AggregationFn<any>;
+    extent: AggregationFn<any>;
+    mean: AggregationFn<any>;
+    median: AggregationFn<any>;
+    unique: AggregationFn<any>;
+    uniqueCount: AggregationFn<any>;
+    count: AggregationFn<any>;
+};
+export type BuiltInAggregationFn = keyof typeof aggregationFns;

package/dist/cjs/columnHelper.cjs

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function createColumnHelper() {
+  return {
+    accessor: (accessor, column) => {
+      return typeof accessor === "function" ? {
+        ...column,
+        accessorFn: accessor
+      } : {
+        ...column,
+        accessorKey: accessor
+      };
+    },
+    display: (column) => column,
+    group: (column) => column
+  };
+}
+exports.createColumnHelper = createColumnHelper;
+//# sourceMappingURL=columnHelper.cjs.map

package/dist/cjs/columnHelper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnHelper.cjs","sources":["../../src/columnHelper.ts"],"sourcesContent":["import {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  DisplayColumnDef,\n  GroupColumnDef,\n  IdentifiedColumnDef,\n  RowData,\n} from './types'\nimport { DeepKeys, DeepValue } from './utils'\n\n// type Person = {\n//   firstName: string\n//   lastName: string\n//   age: number\n//   visits: number\n//   status: string\n//   progress: number\n//   createdAt: Date\n//   nested: {\n//     foo: [\n//       {\n//         bar: 'bar'\n//       }\n//     ]\n//     bar: { subBar: boolean }[]\n//     baz: {\n//       foo: 'foo'\n//       bar: {\n//         baz: 'baz'\n//       }\n//     }\n//   }\n// }\n\n// const test: DeepKeys<Person> = 'nested.foo.0.bar'\n// const test2: DeepKeys<Person> = 'nested.bar'\n\n// const helper = createColumnHelper<Person>()\n\n// helper.accessor('nested.foo', {\n//   cell: info => info.getValue(),\n// })\n\n// helper.accessor('nested.foo.0.bar', {\n//   cell: info => info.getValue(),\n// })\n\n// helper.accessor('nested.bar', {\n//   cell: info => info.getValue(),\n// })\n\nexport type ColumnHelper<TData extends RowData> = {\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? DisplayColumnDef<TData, TValue>\n      : IdentifiedColumnDef<TData, TValue>\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TData, TValue>\n    : AccessorKeyColumnDef<TData, TValue>\n  display: (column: DisplayColumnDef<TData>) => DisplayColumnDef<TData, unknown>\n  group: (column: GroupColumnDef<TData>) => GroupColumnDef<TData, unknown>\n}\n\nexport function createColumnHelper<\n  TData extends RowData,\n>(): ColumnHelper<TData> {\n  return {\n    accessor: (accessor, column) => {\n      return typeof accessor === 'function'\n        ? ({\n            ...column,\n            accessorFn: accessor,\n          } as any)\n        : {\n            ...column,\n            accessorKey: accessor,\n          }\n    },\n    display: column => column,\n    group: column => column,\n  }\n}\n"],"names":[],"mappings":";;AAwEO,SAAS,qBAES;AAChB,SAAA;AAAA,IACL,UAAU,CAAC,UAAU,WAAW;AACvB,aAAA,OAAO,aAAa,aACtB;AAAA,QACC,GAAG;AAAA,QACH,YAAY;AAAA,MAAA,IAEd;AAAA,QACE,GAAG;AAAA,QACH,aAAa;AAAA,MAAA;AAAA,IAErB;AAAA,IACA,SAAS,CAAU,WAAA;AAAA,IACnB,OAAO,CAAU,WAAA;AAAA,EAAA;AAErB;;"}

package/dist/cjs/columnHelper.d.cts

@@ -0,0 +1,9 @@
+import { AccessorFn, AccessorFnColumnDef, AccessorKeyColumnDef, DisplayColumnDef, GroupColumnDef, IdentifiedColumnDef, RowData } from './types.cjs';
+import { DeepKeys, DeepValue } from './utils.cjs';
+
+export type ColumnHelper<TData extends RowData> = {
+    accessor: <TAccessor extends AccessorFn<TData> | DeepKeys<TData>, TValue extends TAccessor extends AccessorFn<TData, infer TReturn> ? TReturn : TAccessor extends DeepKeys<TData> ? DeepValue<TData, TAccessor> : never>(accessor: TAccessor, column: TAccessor extends AccessorFn<TData> ? DisplayColumnDef<TData, TValue> : IdentifiedColumnDef<TData, TValue>) => TAccessor extends AccessorFn<TData> ? AccessorFnColumnDef<TData, TValue> : AccessorKeyColumnDef<TData, TValue>;
+    display: (column: DisplayColumnDef<TData>) => DisplayColumnDef<TData, unknown>;
+    group: (column: GroupColumnDef<TData>) => GroupColumnDef<TData, unknown>;
+};
+export declare function createColumnHelper<TData extends RowData>(): ColumnHelper<TData>;

package/dist/cjs/core/cell.cjs

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("../utils.cjs");
+function createCell(table, row, column, columnId) {
+  const getRenderValue = () => cell.getValue() ?? table.options.renderFallbackValue;
+  const cell = {
+    id: `${row.id}_${column.id}`,
+    row,
+    column,
+    getValue: () => row.getValue(columnId),
+    renderValue: getRenderValue,
+    getContext: utils.memo(
+      () => [table, column, row, cell],
+      (table2, column2, row2, cell2) => ({
+        table: table2,
+        column: column2,
+        row: row2,
+        cell: cell2,
+        getValue: cell2.getValue,
+        renderValue: cell2.renderValue
+      }),
+      utils.getMemoOptions(table.options, "debugCells", "cell.getContext")
+    )
+  };
+  table._features.forEach((feature) => {
+    var _a;
+    (_a = feature.createCell) == null ? void 0 : _a.call(
+      feature,
+      cell,
+      column,
+      row,
+      table
+    );
+  }, {});
+  return cell;
+}
+exports.createCell = createCell;
+//# sourceMappingURL=cell.cjs.map

package/dist/cjs/core/cell.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell.cjs","sources":["../../../src/core/cell.ts"],"sourcesContent":["import { RowData, Cell, Column, Row, Table } from '../types'\nimport { Getter, getMemoOptions, memo } from '../utils'\n\nexport interface CellContext<TData extends RowData, TValue> {\n  cell: Cell<TData, TValue>\n  column: Column<TData, TValue>\n  getValue: Getter<TValue>\n  renderValue: Getter<TValue | null>\n  row: Row<TData>\n  table: Table<TData>\n}\n\nexport interface CoreCell<TData extends RowData, TValue> {\n  /**\n   * The associated Column object for the cell.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#column)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)\n   */\n  column: Column<TData, TValue>\n  /**\n   * 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:\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#getcontext)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)\n   */\n  getContext: () => CellContext<TData, TValue>\n  /**\n   * Returns the value for the cell, accessed via the associated column's accessor key or accessor function.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#getvalue)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)\n   */\n  getValue: CellContext<TData, TValue>['getValue']\n  /**\n   * The unique ID for the cell across the entire table.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#id)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)\n   */\n  id: string\n  /**\n   * Renders the value for a cell the same as `getValue`, but will return the `renderFallbackValue` if no value is found.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#rendervalue)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)\n   */\n  renderValue: CellContext<TData, TValue>['renderValue']\n  /**\n   * The associated Row object for the cell.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#row)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)\n   */\n  row: Row<TData>\n}\n\nexport function createCell<TData extends RowData, TValue>(\n  table: Table<TData>,\n  row: Row<TData>,\n  column: Column<TData, TValue>,\n  columnId: string\n): Cell<TData, TValue> {\n  const getRenderValue = () =>\n    cell.getValue() ?? table.options.renderFallbackValue\n\n  const cell: CoreCell<TData, TValue> = {\n    id: `${row.id}_${column.id}`,\n    row,\n    column,\n    getValue: () => row.getValue(columnId),\n    renderValue: getRenderValue,\n    getContext: memo(\n      () => [table, column, row, cell],\n      (table, column, row, cell) => ({\n        table,\n        column,\n        row,\n        cell: cell as Cell<TData, TValue>,\n        getValue: cell.getValue,\n        renderValue: cell.renderValue,\n      }),\n      getMemoOptions(table.options, 'debugCells', 'cell.getContext')\n    ),\n  }\n\n  table._features.forEach(feature => {\n    feature.createCell?.(\n      cell as Cell<TData, TValue>,\n      column,\n      row as Row<TData>,\n      table\n    )\n  }, {})\n\n  return cell as Cell<TData, TValue>\n}\n"],"names":["memo","table","column","row","cell","getMemoOptions"],"mappings":";;;AAmDO,SAAS,WACd,OACA,KACA,QACA,UACqB;AACrB,QAAM,iBAAiB,MACrB,KAAK,SAAS,KAAK,MAAM,QAAQ;AAEnC,QAAM,OAAgC;AAAA,IACpC,IAAI,GAAG,IAAI,EAAE,IAAI,OAAO,EAAE;AAAA,IAC1B;AAAA,IACA;AAAA,IACA,UAAU,MAAM,IAAI,SAAS,QAAQ;AAAA,IACrC,aAAa;AAAA,IACb,YAAYA,MAAA;AAAA,MACV,MAAM,CAAC,OAAO,QAAQ,KAAK,IAAI;AAAA,MAC/B,CAACC,QAAOC,SAAQC,MAAKC,WAAU;AAAA,QAC7B,OAAAH;AAAAA,QACA,QAAAC;AAAAA,QACA,KAAAC;AAAAA,QACA,MAAMC;AAAAA,QACN,UAAUA,MAAK;AAAA,QACf,aAAaA,MAAK;AAAA,MAAA;AAAA,MAEpBC,MAAAA,eAAe,MAAM,SAAS,cAAc,iBAAiB;AAAA,IAC/D;AAAA,EAAA;AAGI,QAAA,UAAU,QAAQ,CAAW,YAAA;;AACzB,kBAAA,eAAA;AAAA;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EAEJ,GAAG,CAAE,CAAA;AAEE,SAAA;AACT;;"}

package/dist/cjs/core/cell.d.cts

@@ -0,0 +1,50 @@
+import { RowData, Cell, Column, Row, Table } from '../types';
+import { Getter } from '../utils';
+
+export interface CellContext<TData extends RowData, TValue> {
+    cell: Cell<TData, TValue>;
+    column: Column<TData, TValue>;
+    getValue: Getter<TValue>;
+    renderValue: Getter<TValue | null>;
+    row: Row<TData>;
+    table: Table<TData>;
+}
+export interface CoreCell<TData extends RowData, TValue> {
+    /**
+     * The associated Column object for the cell.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#column)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)
+     */
+    column: Column<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:
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#getcontext)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)
+     */
+    getContext: () => CellContext<TData, TValue>;
+    /**
+     * Returns the value for the cell, accessed via the associated column's accessor key or accessor function.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#getvalue)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)
+     */
+    getValue: CellContext<TData, TValue>['getValue'];
+    /**
+     * The unique ID for the cell across the entire table.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#id)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)
+     */
+    id: string;
+    /**
+     * Renders the value for a cell the same as `getValue`, but will return the `renderFallbackValue` if no value is found.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#rendervalue)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)
+     */
+    renderValue: CellContext<TData, TValue>['renderValue'];
+    /**
+     * The associated Row object for the cell.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/cell#row)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/cells)
+     */
+    row: Row<TData>;
+}
+export declare function createCell<TData extends RowData, TValue>(table: Table<TData>, row: Row<TData>, column: Column<TData, TValue>, columnId: string): Cell<TData, TValue>;

package/dist/cjs/core/column.cjs

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("../utils.cjs");
+function createColumn(table, columnDef, depth, parent) {
+  var _a;
+  const defaultColumn = table._getDefaultColumnDef();
+  const resolvedColumnDef = {
+    ...defaultColumn,
+    ...columnDef
+  };
+  const accessorKey = resolvedColumnDef.accessorKey;
+  let id = resolvedColumnDef.id ?? (accessorKey ? accessorKey.replace(".", "_") : void 0) ?? (typeof resolvedColumnDef.header === "string" ? resolvedColumnDef.header : void 0);
+  let accessorFn;
+  if (resolvedColumnDef.accessorFn) {
+    accessorFn = resolvedColumnDef.accessorFn;
+  } else if (accessorKey) {
+    if (accessorKey.includes(".")) {
+      accessorFn = (originalRow) => {
+        let result = originalRow;
+        for (const key of accessorKey.split(".")) {
+          result = result == null ? void 0 : result[key];
+          if (process.env.NODE_ENV !== "production" && result === void 0) {
+            console.warn(
+              `"${key}" in deeply nested key "${accessorKey}" returned undefined.`
+            );
+          }
+        }
+        return result;
+      };
+    } else {
+      accessorFn = (originalRow) => originalRow[resolvedColumnDef.accessorKey];
+    }
+  }
+  if (!id) {
+    if (process.env.NODE_ENV !== "production") {
+      throw new Error(
+        resolvedColumnDef.accessorFn ? `Columns require an id when using an accessorFn` : `Columns require an id when using a non-string header`
+      );
+    }
+    throw new Error();
+  }
+  let column = {
+    id: `${String(id)}`,
+    accessorFn,
+    parent,
+    depth,
+    columnDef: resolvedColumnDef,
+    columns: [],
+    getFlatColumns: utils.memo(
+      () => [true],
+      () => {
+        var _a2;
+        return [
+          column,
+          ...(_a2 = column.columns) == null ? void 0 : _a2.flatMap((d) => d.getFlatColumns())
+        ];
+      },
+      utils.getMemoOptions(table.options, "debugColumns", "column.getFlatColumns")
+    ),
+    getLeafColumns: utils.memo(
+      () => [table._getOrderColumnsFn()],
+      (orderColumns) => {
+        var _a2;
+        if ((_a2 = column.columns) == null ? void 0 : _a2.length) {
+          let leafColumns = column.columns.flatMap(
+            (column2) => column2.getLeafColumns()
+          );
+          return orderColumns(leafColumns);
+        }
+        return [column];
+      },
+      utils.getMemoOptions(table.options, "debugColumns", "column.getLeafColumns")
+    )
+  };
+  for (const feature of table._features) {
+    (_a = feature.createColumn) == null ? void 0 : _a.call(feature, column, table);
+  }
+  return column;
+}
+exports.createColumn = createColumn;
+//# sourceMappingURL=column.cjs.map

package/dist/cjs/core/column.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.cjs","sources":["../../../src/core/column.ts"],"sourcesContent":["import {\n  Column,\n  Table,\n  AccessorFn,\n  ColumnDef,\n  RowData,\n  ColumnDefResolved,\n} from '../types'\nimport { getMemoOptions, memo } from '../utils'\n\nexport interface CoreColumn<TData extends RowData, TValue> {\n  /**\n   * The resolved accessor function to use when extracting the value for the column from each row. Will only be defined if the column def has a valid accessor key or function defined.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#accessorfn)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)\n   */\n  accessorFn?: AccessorFn<TData, TValue>\n  /**\n   * The original column def used to create the column.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#columndef)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)\n   */\n  columnDef: ColumnDef<TData, TValue>\n  /**\n   * The child column (if the column is a group column). Will be an empty array if the column is not a group column.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#columns)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)\n   */\n  columns: Column<TData, TValue>[]\n  /**\n   * The depth of the column (if grouped) relative to the root column def array.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#depth)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)\n   */\n  depth: number\n  /**\n   * Returns the flattened array of this column and all child/grand-child columns for this column.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#getflatcolumns)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)\n   */\n  getFlatColumns: () => Column<TData, TValue>[]\n  /**\n   * Returns an array of all leaf-node columns for this column. If a column has no children, it is considered the only leaf-node column.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#getleafcolumns)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)\n   */\n  getLeafColumns: () => Column<TData, TValue>[]\n  /**\n   * The resolved unique identifier for the column resolved in this priority:\n      - A manual `id` property from the column def\n      - The accessor key from the column def\n      - The header string from the column def\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#id)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)\n   */\n  id: string\n  /**\n   * The parent column for this column. Will be undefined if this is a root column.\n   * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#parent)\n   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)\n   */\n  parent?: Column<TData, TValue>\n}\n\nexport function createColumn<TData extends RowData, TValue>(\n  table: Table<TData>,\n  columnDef: ColumnDef<TData, TValue>,\n  depth: number,\n  parent?: Column<TData, TValue>\n): Column<TData, TValue> {\n  const defaultColumn = table._getDefaultColumnDef()\n\n  const resolvedColumnDef = {\n    ...defaultColumn,\n    ...columnDef,\n  } as ColumnDefResolved<TData>\n\n  const accessorKey = resolvedColumnDef.accessorKey\n\n  let id =\n    resolvedColumnDef.id ??\n    (accessorKey ? accessorKey.replace('.', '_') : undefined) ??\n    (typeof resolvedColumnDef.header === 'string'\n      ? resolvedColumnDef.header\n      : undefined)\n\n  let accessorFn: AccessorFn<TData> | undefined\n\n  if (resolvedColumnDef.accessorFn) {\n    accessorFn = resolvedColumnDef.accessorFn\n  } else if (accessorKey) {\n    // Support deep accessor keys\n    if (accessorKey.includes('.')) {\n      accessorFn = (originalRow: TData) => {\n        let result = originalRow as Record<string, any>\n\n        for (const key of accessorKey.split('.')) {\n          result = result?.[key]\n          if (process.env.NODE_ENV !== 'production' && result === undefined) {\n            console.warn(\n              `\"${key}\" in deeply nested key \"${accessorKey}\" returned undefined.`\n            )\n          }\n        }\n\n        return result\n      }\n    } else {\n      accessorFn = (originalRow: TData) =>\n        (originalRow as any)[resolvedColumnDef.accessorKey]\n    }\n  }\n\n  if (!id) {\n    if (process.env.NODE_ENV !== 'production') {\n      throw new Error(\n        resolvedColumnDef.accessorFn\n          ? `Columns require an id when using an accessorFn`\n          : `Columns require an id when using a non-string header`\n      )\n    }\n    throw new Error()\n  }\n\n  let column: CoreColumn<TData, any> = {\n    id: `${String(id)}`,\n    accessorFn,\n    parent: parent as any,\n    depth,\n    columnDef: resolvedColumnDef as ColumnDef<TData, any>,\n    columns: [],\n    getFlatColumns: memo(\n      () => [true],\n      () => {\n        return [\n          column as Column<TData, TValue>,\n          ...column.columns?.flatMap(d => d.getFlatColumns()),\n        ]\n      },\n      getMemoOptions(table.options, 'debugColumns', 'column.getFlatColumns')\n    ),\n    getLeafColumns: memo(\n      () => [table._getOrderColumnsFn()],\n      orderColumns => {\n        if (column.columns?.length) {\n          let leafColumns = column.columns.flatMap(column =>\n            column.getLeafColumns()\n          )\n\n          return orderColumns(leafColumns)\n        }\n\n        return [column as Column<TData, TValue>]\n      },\n      getMemoOptions(table.options, 'debugColumns', 'column.getLeafColumns')\n    ),\n  }\n\n  for (const feature of table._features) {\n    feature.createColumn?.(column as Column<TData, TValue>, table)\n  }\n\n  // Yes, we have to convert table to unknown, because we know more than the compiler here.\n  return column as Column<TData, TValue>\n}\n"],"names":["memo","_a","getMemoOptions","column"],"mappings":";;;AAgEO,SAAS,aACd,OACA,WACA,OACA,QACuB;;AACjB,QAAA,gBAAgB,MAAM;AAE5B,QAAM,oBAAoB;AAAA,IACxB,GAAG;AAAA,IACH,GAAG;AAAA,EAAA;AAGL,QAAM,cAAc,kBAAkB;AAEtC,MAAI,KACF,kBAAkB,OACjB,cAAc,YAAY,QAAQ,KAAK,GAAG,IAAI,YAC9C,OAAO,kBAAkB,WAAW,WACjC,kBAAkB,SAClB;AAEF,MAAA;AAEJ,MAAI,kBAAkB,YAAY;AAChC,iBAAa,kBAAkB;AAAA,aACtB,aAAa;AAElB,QAAA,YAAY,SAAS,GAAG,GAAG;AAC7B,mBAAa,CAAC,gBAAuB;AACnC,YAAI,SAAS;AAEb,mBAAW,OAAO,YAAY,MAAM,GAAG,GAAG;AACxC,mBAAS,iCAAS;AAClB,cAAI,QAAQ,IAAI,aAAa,gBAAgB,WAAW,QAAW;AACzD,oBAAA;AAAA,cACN,IAAI,GAAG,2BAA2B,WAAW;AAAA,YAAA;AAAA,UAEjD;AAAA,QACF;AAEO,eAAA;AAAA,MAAA;AAAA,IACT,OACK;AACL,mBAAa,CAAC,gBACX,YAAoB,kBAAkB,WAAW;AAAA,IACtD;AAAA,EACF;AAEA,MAAI,CAAC,IAAI;AACH,QAAA,QAAQ,IAAI,aAAa,cAAc;AACzC,YAAM,IAAI;AAAA,QACR,kBAAkB,aACd,mDACA;AAAA,MAAA;AAAA,IAER;AACA,UAAM,IAAI,MAAM;AAAA,EAClB;AAEA,MAAI,SAAiC;AAAA,IACnC,IAAI,GAAG,OAAO,EAAE,CAAC;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,SAAS,CAAC;AAAA,IACV,gBAAgBA,MAAA;AAAA,MACd,MAAM,CAAC,IAAI;AAAA,MACX,MAAM;;AACG,eAAA;AAAA,UACL;AAAA,UACA,IAAGC,MAAA,OAAO,YAAP,gBAAAA,IAAgB,QAAQ,CAAK,MAAA,EAAE;QAAgB;AAAA,MAEtD;AAAA,MACAC,MAAAA,eAAe,MAAM,SAAS,gBAAgB,uBAAuB;AAAA,IACvE;AAAA,IACA,gBAAgBF,MAAA;AAAA,MACd,MAAM,CAAC,MAAM,oBAAoB;AAAA,MACjC,CAAgB,iBAAA;;AACV,aAAAC,MAAA,OAAO,YAAP,gBAAAA,IAAgB,QAAQ;AACtB,cAAA,cAAc,OAAO,QAAQ;AAAA,YAAQ,CAAAE,YACvCA,QAAO,eAAe;AAAA,UAAA;AAGxB,iBAAO,aAAa,WAAW;AAAA,QACjC;AAEA,eAAO,CAAC,MAA+B;AAAA,MACzC;AAAA,MACAD,MAAAA,eAAe,MAAM,SAAS,gBAAgB,uBAAuB;AAAA,IACvE;AAAA,EAAA;AAGS,aAAA,WAAW,MAAM,WAAW;AAC7B,kBAAA,iBAAA,iCAAe,QAAiC;AAAA,EAC1D;AAGO,SAAA;AACT;;"}

package/dist/cjs/core/column.d.cts

@@ -0,0 +1,56 @@
+import { Column, Table, AccessorFn, ColumnDef, RowData } from '../types';
+
+export interface CoreColumn<TData extends RowData, TValue> {
+    /**
+     * The resolved accessor function to use when extracting the value for the column from each row. Will only be defined if the column def has a valid accessor key or function defined.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#accessorfn)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)
+     */
+    accessorFn?: AccessorFn<TData, TValue>;
+    /**
+     * The original column def used to create the column.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#columndef)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)
+     */
+    columnDef: ColumnDef<TData, TValue>;
+    /**
+     * The child column (if the column is a group column). Will be an empty array if the column is not a group column.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#columns)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)
+     */
+    columns: Column<TData, TValue>[];
+    /**
+     * The depth of the column (if grouped) relative to the root column def array.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#depth)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)
+     */
+    depth: number;
+    /**
+     * Returns the flattened array of this column and all child/grand-child columns for this column.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#getflatcolumns)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)
+     */
+    getFlatColumns: () => Column<TData, TValue>[];
+    /**
+     * Returns an array of all leaf-node columns for this column. If a column has no children, it is considered the only leaf-node column.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#getleafcolumns)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)
+     */
+    getLeafColumns: () => Column<TData, TValue>[];
+    /**
+     * The resolved unique identifier for the column resolved in this priority:
+        - A manual `id` property from the column def
+        - The accessor key from the column def
+        - The header string from the column def
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#id)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)
+     */
+    id: string;
+    /**
+     * The parent column for this column. Will be undefined if this is a root column.
+     * @link [API Docs](https://tanstack.com/table/v8/docs/api/core/column#parent)
+     * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-defs)
+     */
+    parent?: Column<TData, TValue>;
+}
+export declare function createColumn<TData extends RowData, TValue>(table: Table<TData>, columnDef: ColumnDef<TData, TValue>, depth: number, parent?: Column<TData, TValue>): Column<TData, TValue>;