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

package/dist/esm/core/columns/coreColumnsFeature.types.d.ts

@@ -50,7 +50,7 @@ export interface TableOptions_Columns<TFeatures extends TableFeatures, TData ext
     /**
      * The array of column defs to use for the table.
      */
-    columns: Array<ColumnDef<TFeatures, TData, TValue>>;
+    columns: ReadonlyArray<ColumnDef<TFeatures, TData, TValue>>;
     /**
      * Default column options to use for all column defs supplied to the table.
      */

package/dist/esm/core/columns/coreColumnsFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreColumnsFeature.utils.js","sources":["../../../../src/core/columns/coreColumnsFeature.utils.ts"],"sourcesContent":["import { callMemoOrStaticFn } from '../../utils'\nimport { table_getOrderColumnsFn } from '../../features/column-ordering/columnOrderingFeature.utils'\nimport { constructColumn } from './constructColumn'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  ColumnDef,\n  ColumnDefResolved,\n  GroupColumnDef,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\n\nexport function column_getFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  return [column, ...column.columns.flatMap((col) => col.getFlatColumns())]\n}\n\nexport function column_getLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  if (column.columns.length) {\n    const leafColumns = column.columns.flatMap(\n      (col) => col.getLeafColumns(), // recursive\n    )\n\n    return callMemoOrStaticFn(\n      column.table,\n      'getOrderColumns',\n      table_getOrderColumnsFn,\n    )(leafColumns as any) as any\n  }\n\n  return [column]\n}\n\nexport function table_getDefaultColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Partial<ColumnDef<TFeatures, TData, unknown>> {\n  return {\n    header: (props) => {\n      const resolvedColumnDef = props.header.column\n        .columnDef as ColumnDefResolved<{}, TData>\n\n      if (resolvedColumnDef.accessorKey) {\n        return resolvedColumnDef.accessorKey\n      }\n\n      if (resolvedColumnDef.accessorFn) {\n        return resolvedColumnDef.id\n      }\n\n      return null\n    },\n    cell: (props) => props.renderValue<any>()?.toString?.() ?? null,\n    ...Object.values(table._features).reduce((obj, feature) => {\n      return Object.assign(obj, feature.getDefaultColumnDef?.())\n    }, {}),\n    ...table.options.defaultColumn,\n  } as Partial<ColumnDef<TFeatures, TData, unknown>>\n}\n\nexport function table_getAllColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const recurseColumns = (\n    colDefs: Array<ColumnDef<TFeatures, TData, unknown>>,\n    parent?: Column<TFeatures, TData, unknown>,\n    depth = 0,\n  ): Array<Column<TFeatures, TData, unknown>> => {\n    return colDefs.map((columnDef) => {\n      const column = constructColumn(table, columnDef, depth, parent)\n\n      const groupingColumnDef = columnDef as GroupColumnDef<\n        TFeatures,\n        TData,\n        unknown\n      >\n\n      column.columns = groupingColumnDef.columns\n        ? recurseColumns(groupingColumnDef.columns, column, depth + 1)\n        : []\n\n      return column\n    })\n  }\n\n  return recurseColumns(table.options.columns as any)\n}\n\nexport function table_getAllFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  return table.getAllColumns().flatMap((column) => column.getFlatColumns())\n}\n\nexport function table_getAllFlatColumnsById<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Record<string, Column<TFeatures, TData, unknown>> {\n  return table.getAllFlatColumns().reduce(\n    (acc, column) => {\n      acc[column.id] = column\n      return acc\n    },\n    {} as Record<string, Column<TFeatures, TData, unknown>>,\n  )\n}\n\nexport function table_getAllLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const leafColumns = table.getAllColumns().flatMap(\n    (c) => c.getLeafColumns(), // recursive\n  )\n  return callMemoOrStaticFn(\n    table,\n    'getOrderColumns',\n    table_getOrderColumnsFn,\n  )(leafColumns as any) as any\n}\n\nexport function table_getColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnId: string,\n): Column<TFeatures, TData, unknown> | undefined {\n  const column = table.getAllFlatColumnsById()[columnId]\n\n  if (process.env.NODE_ENV === 'development' && !column) {\n    console.warn(`[Table] Column with id '${columnId}' does not exist.`)\n  }\n\n  return column\n}\n"],"names":[],"mappings":";;;AAaO,SAAS,sBAKd,QACyC;AACzC,SAAO,CAAC,QAAQ,GAAG,OAAO,QAAQ,QAAQ,CAAC,QAAQ,IAAI,eAAA,CAAgB,CAAC;AAC1E;AAEO,SAAS,sBAKd,QACyC;AACzC,MAAI,OAAO,QAAQ,QAAQ;AACzB,UAAM,cAAc,OAAO,QAAQ;AAAA,MACjC,CAAC,QAAQ,IAAI,eAAA;AAAA;AAAA,IAAe;AAG9B,WAAO;AAAA,MACL,OAAO;AAAA,MACP;AAAA,MACA;AAAA,IAAA,EACA,WAAkB;AAAA,EACtB;AAEA,SAAO,CAAC,MAAM;AAChB;AAEO,SAAS,0BAId,OAC+C;AAC/C,SAAO;AAAA,IACL,QAAQ,CAAC,UAAU;AACjB,YAAM,oBAAoB,MAAM,OAAO,OACpC;AAEH,UAAI,kBAAkB,aAAa;AACjC,eAAO,kBAAkB;AAAA,MAC3B;AAEA,UAAI,kBAAkB,YAAY;AAChC,eAAO,kBAAkB;AAAA,MAC3B;AAEA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,CAAC,UAAU,MAAM,YAAA,GAAoB,gBAAgB;AAAA,IAC3D,GAAG,OAAO,OAAO,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,YAAY;AACzD,aAAO,OAAO,OAAO,KAAK,QAAQ,uBAAuB;AAAA,IAC3D,GAAG,CAAA,CAAE;AAAA,IACL,GAAG,MAAM,QAAQ;AAAA,EAAA;AAErB;AAEO,SAAS,oBAId,OAC0C;AAC1C,QAAM,iBAAiB,CACrB,SACA,QACA,QAAQ,MACqC;AAC7C,WAAO,QAAQ,IAAI,CAAC,cAAc;AAChC,YAAM,SAAS,gBAAgB,OAAO,WAAW,OAAO,MAAM;AAE9D,YAAM,oBAAoB;AAM1B,aAAO,UAAU,kBAAkB,UAC/B,eAAe,kBAAkB,SAAS,QAAQ,QAAQ,CAAC,IAC3D,CAAA;AAEJ,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,SAAO,eAAe,MAAM,QAAQ,OAAc;AACpD;AAEO,SAAS,wBAId,OAC0C;AAC1C,SAAO,MAAM,gBAAgB,QAAQ,CAAC,WAAW,OAAO,gBAAgB;AAC1E;AAEO,SAAS,4BAId,OACmD;AACnD,SAAO,MAAM,oBAAoB;AAAA,IAC/B,CAAC,KAAK,WAAW;AACf,UAAI,OAAO,EAAE,IAAI;AACjB,aAAO;AAAA,IACT;AAAA,IACA,CAAA;AAAA,EAAC;AAEL;AAEO,SAAS,wBAId,OAC0C;AAC1C,QAAM,cAAc,MAAM,cAAA,EAAgB;AAAA,IACxC,CAAC,MAAM,EAAE,eAAA;AAAA;AAAA,EAAe;AAE1B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EAAA,EACA,WAAkB;AACtB;AAEO,SAAS,gBAId,OACA,UAC+C;AAC/C,QAAM,SAAS,MAAM,sBAAA,EAAwB,QAAQ;AAErD,MAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,QAAQ;AACrD,YAAQ,KAAK,2BAA2B,QAAQ,mBAAmB;AAAA,EACrE;AAEA,SAAO;AACT;"}
+{"version":3,"file":"coreColumnsFeature.utils.js","sources":["../../../../src/core/columns/coreColumnsFeature.utils.ts"],"sourcesContent":["import { callMemoOrStaticFn } from '../../utils'\nimport { table_getOrderColumnsFn } from '../../features/column-ordering/columnOrderingFeature.utils'\nimport { constructColumn } from './constructColumn'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  ColumnDef,\n  ColumnDefResolved,\n  GroupColumnDef,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\n\nexport function column_getFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  return [column, ...column.columns.flatMap((col) => col.getFlatColumns())]\n}\n\nexport function column_getLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  if (column.columns.length) {\n    const leafColumns = column.columns.flatMap(\n      (col) => col.getLeafColumns(), // recursive\n    )\n\n    return callMemoOrStaticFn(\n      column.table,\n      'getOrderColumns',\n      table_getOrderColumnsFn,\n    )(leafColumns as any) as any\n  }\n\n  return [column]\n}\n\nexport function table_getDefaultColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Partial<ColumnDef<TFeatures, TData, unknown>> {\n  return {\n    header: (props) => {\n      const resolvedColumnDef = props.header.column\n        .columnDef as ColumnDefResolved<{}, TData>\n\n      if (resolvedColumnDef.accessorKey) {\n        return resolvedColumnDef.accessorKey\n      }\n\n      if (resolvedColumnDef.accessorFn) {\n        return resolvedColumnDef.id\n      }\n\n      return null\n    },\n    cell: (props) => props.renderValue<any>()?.toString?.() ?? null,\n    ...Object.values(table._features).reduce((obj, feature) => {\n      return Object.assign(obj, feature.getDefaultColumnDef?.())\n    }, {}),\n    ...table.options.defaultColumn,\n  } as Partial<ColumnDef<TFeatures, TData, unknown>>\n}\n\nexport function table_getAllColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const recurseColumns = (\n    colDefs: ReadonlyArray<ColumnDef<TFeatures, TData, unknown>>,\n    parent?: Column<TFeatures, TData, unknown>,\n    depth = 0,\n  ): Array<Column<TFeatures, TData, unknown>> => {\n    return colDefs.map((columnDef) => {\n      const column = constructColumn(table, columnDef, depth, parent)\n\n      const groupingColumnDef = columnDef as GroupColumnDef<\n        TFeatures,\n        TData,\n        unknown\n      >\n\n      column.columns = groupingColumnDef.columns\n        ? recurseColumns(groupingColumnDef.columns, column, depth + 1)\n        : []\n\n      return column\n    })\n  }\n\n  return recurseColumns(table.options.columns as any)\n}\n\nexport function table_getAllFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  return table.getAllColumns().flatMap((column) => column.getFlatColumns())\n}\n\nexport function table_getAllFlatColumnsById<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Record<string, Column<TFeatures, TData, unknown>> {\n  return table.getAllFlatColumns().reduce(\n    (acc, column) => {\n      acc[column.id] = column\n      return acc\n    },\n    {} as Record<string, Column<TFeatures, TData, unknown>>,\n  )\n}\n\nexport function table_getAllLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const leafColumns = table.getAllColumns().flatMap(\n    (c) => c.getLeafColumns(), // recursive\n  )\n  return callMemoOrStaticFn(\n    table,\n    'getOrderColumns',\n    table_getOrderColumnsFn,\n  )(leafColumns as any) as any\n}\n\nexport function table_getColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnId: string,\n): Column<TFeatures, TData, unknown> | undefined {\n  const column = table.getAllFlatColumnsById()[columnId]\n\n  if (process.env.NODE_ENV === 'development' && !column) {\n    console.warn(`[Table] Column with id '${columnId}' does not exist.`)\n  }\n\n  return column\n}\n"],"names":[],"mappings":";;;AAaO,SAAS,sBAKd,QACyC;AACzC,SAAO,CAAC,QAAQ,GAAG,OAAO,QAAQ,QAAQ,CAAC,QAAQ,IAAI,eAAA,CAAgB,CAAC;AAC1E;AAEO,SAAS,sBAKd,QACyC;AACzC,MAAI,OAAO,QAAQ,QAAQ;AACzB,UAAM,cAAc,OAAO,QAAQ;AAAA,MACjC,CAAC,QAAQ,IAAI,eAAA;AAAA;AAAA,IAAe;AAG9B,WAAO;AAAA,MACL,OAAO;AAAA,MACP;AAAA,MACA;AAAA,IAAA,EACA,WAAkB;AAAA,EACtB;AAEA,SAAO,CAAC,MAAM;AAChB;AAEO,SAAS,0BAId,OAC+C;AAC/C,SAAO;AAAA,IACL,QAAQ,CAAC,UAAU;AACjB,YAAM,oBAAoB,MAAM,OAAO,OACpC;AAEH,UAAI,kBAAkB,aAAa;AACjC,eAAO,kBAAkB;AAAA,MAC3B;AAEA,UAAI,kBAAkB,YAAY;AAChC,eAAO,kBAAkB;AAAA,MAC3B;AAEA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,CAAC,UAAU,MAAM,YAAA,GAAoB,gBAAgB;AAAA,IAC3D,GAAG,OAAO,OAAO,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,YAAY;AACzD,aAAO,OAAO,OAAO,KAAK,QAAQ,uBAAuB;AAAA,IAC3D,GAAG,CAAA,CAAE;AAAA,IACL,GAAG,MAAM,QAAQ;AAAA,EAAA;AAErB;AAEO,SAAS,oBAId,OAC0C;AAC1C,QAAM,iBAAiB,CACrB,SACA,QACA,QAAQ,MACqC;AAC7C,WAAO,QAAQ,IAAI,CAAC,cAAc;AAChC,YAAM,SAAS,gBAAgB,OAAO,WAAW,OAAO,MAAM;AAE9D,YAAM,oBAAoB;AAM1B,aAAO,UAAU,kBAAkB,UAC/B,eAAe,kBAAkB,SAAS,QAAQ,QAAQ,CAAC,IAC3D,CAAA;AAEJ,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,SAAO,eAAe,MAAM,QAAQ,OAAc;AACpD;AAEO,SAAS,wBAId,OAC0C;AAC1C,SAAO,MAAM,gBAAgB,QAAQ,CAAC,WAAW,OAAO,gBAAgB;AAC1E;AAEO,SAAS,4BAId,OACmD;AACnD,SAAO,MAAM,oBAAoB;AAAA,IAC/B,CAAC,KAAK,WAAW;AACf,UAAI,OAAO,EAAE,IAAI;AACjB,aAAO;AAAA,IACT;AAAA,IACA,CAAA;AAAA,EAAC;AAEL;AAEO,SAAS,wBAId,OAC0C;AAC1C,QAAM,cAAc,MAAM,cAAA,EAAgB;AAAA,IACxC,CAAC,MAAM,EAAE,eAAA;AAAA;AAAA,EAAe;AAE1B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EAAA,EACA,WAAkB;AACtB;AAEO,SAAS,gBAId,OACA,UAC+C;AAC/C,QAAM,SAAS,MAAM,sBAAA,EAAwB,QAAQ;AAErD,MAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,QAAQ;AACrD,YAAQ,KAAK,2BAA2B,QAAQ,mBAAmB;AAAA,EACrE;AAEA,SAAO;AACT;"}

package/dist/esm/core/row-models/createCoreRowModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCoreRowModel.js","sources":["../../../../src/core/row-models/createCoreRowModel.ts"],"sourcesContent":["import { constructRow } from '../rows/constructRow'\nimport { tableMemo } from '../../utils'\nimport { table_autoResetPageIndex } from '../../features/row-pagination/rowPaginationFeature.utils'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { RowModel } from './coreRowModelsFeature.types'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\nexport function createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table = _table as Table_Internal<TFeatures, TData>\n    return tableMemo({\n      feature: 'coreRowModelsFeature',\n      table,\n      fnName: 'table.getCoreRowModel',\n      memoDeps: () => [table.options.data],\n      fn: () => _createCoreRowModel(table, table.options.data),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  data: Array<TData>,\n): {\n  rows: Array<Row<TFeatures, TData>>\n  flatRows: Array<Row<TFeatures, TData>>\n  rowsById: Record<string, Row<TFeatures, TData>>\n} {\n  const rowModel: RowModel<TFeatures, TData> = {\n    rows: [],\n    flatRows: [],\n    rowsById: {},\n  }\n\n  const accessRows = (\n    originalRows: Array<TData>,\n    depth = 0,\n    parentRow?: Row<TFeatures, TData>,\n  ): Array<Row<TFeatures, TData>> => {\n    const rows = [] as Array<Row<TFeatures, TData>>\n\n    for (let i = 0; i < originalRows.length; i++) {\n      const originalRow = originalRows[i]!\n      // Make the row\n      const row = constructRow(\n        table,\n        table.getRowId(originalRow, i, parentRow),\n        originalRow,\n        i,\n        depth,\n        undefined,\n        parentRow?.id,\n      )\n\n      // Keep track of every row in a flat array\n      rowModel.flatRows.push(row)\n      // Also keep track of every row by its ID\n      rowModel.rowsById[row.id] = row\n      // Push table row into parent\n      rows.push(row)\n\n      // Get the original subrows\n      if (table.options.getSubRows) {\n        row.originalSubRows = table.options.getSubRows(originalRow, i)\n\n        // Then recursively access them\n        if (row.originalSubRows?.length) {\n          row.subRows = accessRows(row.originalSubRows, depth + 1, row)\n        }\n      }\n    }\n\n    return rows\n  }\n\n  rowModel.rows = accessRows(data)\n\n  return rowModel\n}\n"],"names":[],"mappings":";;;AASO,SAAS,qBAG0D;AACxE,SAAO,CAAC,WAAW;AACjB,UAAM,QAAQ;AACd,WAAO,UAAU;AAAA,MACf,SAAS;AAAA,MACT;AAAA,MACA,QAAQ;AAAA,MACR,UAAU,MAAM,CAAC,MAAM,QAAQ,IAAI;AAAA,MACnC,IAAI,MAAM,oBAAoB,OAAO,MAAM,QAAQ,IAAI;AAAA,MACvD,eAAe,MAAM,yBAAyB,KAAK;AAAA,IAAA,CACpD;AAAA,EACH;AACF;AAEA,SAAS,oBAIP,OACA,MAKA;AACA,QAAM,WAAuC;AAAA,IAC3C,MAAM,CAAA;AAAA,IACN,UAAU,CAAA;AAAA,IACV,UAAU,CAAA;AAAA,EAAC;AAGb,QAAM,aAAa,CACjB,cACA,QAAQ,GACR,cACiC;AACjC,UAAM,OAAO,CAAA;AAEb,aAAS,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;AAC5C,YAAM,cAAc,aAAa,CAAC;AAElC,YAAM,MAAM;AAAA,QACV;AAAA,QACA,MAAM,SAAS,aAAa,GAAG,SAAS;AAAA,QACxC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,WAAW;AAAA,MAAA;AAIb,eAAS,SAAS,KAAK,GAAG;AAE1B,eAAS,SAAS,IAAI,EAAE,IAAI;AAE5B,WAAK,KAAK,GAAG;AAGb,UAAI,MAAM,QAAQ,YAAY;AAC5B,YAAI,kBAAkB,MAAM,QAAQ,WAAW,aAAa,CAAC;AAG7D,YAAI,IAAI,iBAAiB,QAAQ;AAC/B,cAAI,UAAU,WAAW,IAAI,iBAAiB,QAAQ,GAAG,GAAG;AAAA,QAC9D;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEA,WAAS,OAAO,WAAW,IAAI;AAE/B,SAAO;AACT;"}
+{"version":3,"file":"createCoreRowModel.js","sources":["../../../../src/core/row-models/createCoreRowModel.ts"],"sourcesContent":["import { constructRow } from '../rows/constructRow'\nimport { tableMemo } from '../../utils'\nimport { table_autoResetPageIndex } from '../../features/row-pagination/rowPaginationFeature.utils'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { RowModel } from './coreRowModelsFeature.types'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\nexport function createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table = _table as Table_Internal<TFeatures, TData>\n    return tableMemo({\n      feature: 'coreRowModelsFeature',\n      table,\n      fnName: 'table.getCoreRowModel',\n      memoDeps: () => [table.options.data],\n      fn: () => _createCoreRowModel(table, table.options.data),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  data: ReadonlyArray<TData>,\n): {\n  rows: Array<Row<TFeatures, TData>>\n  flatRows: Array<Row<TFeatures, TData>>\n  rowsById: Record<string, Row<TFeatures, TData>>\n} {\n  const rowModel: RowModel<TFeatures, TData> = {\n    rows: [],\n    flatRows: [],\n    rowsById: {},\n  }\n\n  const accessRows = (\n    originalRows: ReadonlyArray<TData>,\n    depth = 0,\n    parentRow?: Row<TFeatures, TData>,\n  ): Array<Row<TFeatures, TData>> => {\n    const rows = [] as Array<Row<TFeatures, TData>>\n\n    for (let i = 0; i < originalRows.length; i++) {\n      const originalRow = originalRows[i]!\n      // Make the row\n      const row = constructRow(\n        table,\n        table.getRowId(originalRow, i, parentRow),\n        originalRow,\n        i,\n        depth,\n        undefined,\n        parentRow?.id,\n      )\n\n      // Keep track of every row in a flat array\n      rowModel.flatRows.push(row)\n      // Also keep track of every row by its ID\n      rowModel.rowsById[row.id] = row\n      // Push table row into parent\n      rows.push(row)\n\n      // Get the original subrows\n      if (table.options.getSubRows) {\n        row.originalSubRows = table.options.getSubRows(originalRow, i)\n\n        // Then recursively access them\n        if (row.originalSubRows?.length) {\n          row.subRows = accessRows(row.originalSubRows, depth + 1, row)\n        }\n      }\n    }\n\n    return rows\n  }\n\n  rowModel.rows = accessRows(data)\n\n  return rowModel\n}\n"],"names":[],"mappings":";;;AASO,SAAS,qBAG0D;AACxE,SAAO,CAAC,WAAW;AACjB,UAAM,QAAQ;AACd,WAAO,UAAU;AAAA,MACf,SAAS;AAAA,MACT;AAAA,MACA,QAAQ;AAAA,MACR,UAAU,MAAM,CAAC,MAAM,QAAQ,IAAI;AAAA,MACnC,IAAI,MAAM,oBAAoB,OAAO,MAAM,QAAQ,IAAI;AAAA,MACvD,eAAe,MAAM,yBAAyB,KAAK;AAAA,IAAA,CACpD;AAAA,EACH;AACF;AAEA,SAAS,oBAIP,OACA,MAKA;AACA,QAAM,WAAuC;AAAA,IAC3C,MAAM,CAAA;AAAA,IACN,UAAU,CAAA;AAAA,IACV,UAAU,CAAA;AAAA,EAAC;AAGb,QAAM,aAAa,CACjB,cACA,QAAQ,GACR,cACiC;AACjC,UAAM,OAAO,CAAA;AAEb,aAAS,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;AAC5C,YAAM,cAAc,aAAa,CAAC;AAElC,YAAM,MAAM;AAAA,QACV;AAAA,QACA,MAAM,SAAS,aAAa,GAAG,SAAS;AAAA,QACxC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,WAAW;AAAA,MAAA;AAIb,eAAS,SAAS,KAAK,GAAG;AAE1B,eAAS,SAAS,IAAI,EAAE,IAAI;AAE5B,WAAK,KAAK,GAAG;AAGb,UAAI,MAAM,QAAQ,YAAY;AAC5B,YAAI,kBAAkB,MAAM,QAAQ,WAAW,aAAa,CAAC;AAG7D,YAAI,IAAI,iBAAiB,QAAQ;AAC/B,cAAI,UAAU,WAAW,IAAI,iBAAiB,QAAQ,GAAG,GAAG;AAAA,QAC9D;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEA,WAAS,OAAO,WAAW,IAAI;AAE/B,SAAO;AACT;"}

package/dist/esm/core/rows/coreRowsFeature.types.d.ts

@@ -25,7 +25,7 @@ export interface Row_CoreProperties<TFeatures extends TableFeatures, TData exten
     /**
      * An array of the original subRows as returned by the `options.getSubRows` option.
      */
-    originalSubRows?: Array<TData>;
+    originalSubRows?: ReadonlyArray<TData>;
     /**
      * If nested, this row's parent row id.
      */
@@ -80,7 +80,7 @@ export interface TableOptions_Rows<TFeatures extends TableFeatures, TData extend
      * This optional function is used to access the sub rows for any given row. If you are using nested rows, you will need to use this function to return the sub rows object (or undefined) from the row.
      * @example getSubRows: row => row.subRows
      */
-    getSubRows?: (originalRow: TData, index: number) => undefined | Array<TData>;
+    getSubRows?: (originalRow: TData, index: number) => undefined | ReadonlyArray<TData>;
 }
 export interface Table_Rows<TFeatures extends TableFeatures, TData extends RowData> {
     getRowId: (_: TData, index: number, parent?: Row<TFeatures, TData>) => string;

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

@@ -24,7 +24,7 @@ export interface TableOptions_Table<TFeatures extends TableFeatures, TData exten
     /**
      * The data for the table to display. When the `data` option changes reference, the table will reprocess the data.
      */
-    data: Array<TData>;
+    data: ReadonlyArray<TData>;
     /**
      * Use this option to optionally pass initial state to the table. This state will be used when resetting various table states either automatically by the table (eg. `options.autoResetPageIndex`) or via functions like `table.resetRowSelection()`. Most reset function allow you optionally pass a flag to reset to a blank/default state instead of the initial state.
      * Table state will not be reset when this object changes, which also means that the initial state object does not need to be stable.
@@ -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/types/ColumnDef.d.ts

@@ -44,7 +44,7 @@ export type IdentifiedColumnDef<TFeatures extends TableFeatures, TData extends R
 };
 export type DisplayColumnDef<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = ColumnDefBase<TFeatures, TData, TValue> & ColumnIdentifiers<TFeatures, TData, TValue>;
 type GroupColumnDefBase<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = ColumnDefBase<TFeatures, TData, TValue> & {
-    columns?: Array<ColumnDef<TFeatures, TData, unknown>>;
+    columns?: ReadonlyArray<ColumnDef<TFeatures, TData, unknown>>;
 };
 export type GroupColumnDef<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = GroupColumnDefBase<TFeatures, TData, TValue> & ColumnIdentifiers<TFeatures, TData, TValue>;
 export type AccessorFnColumnDefBase<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = ColumnDefBase<TFeatures, TData, TValue> & {

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.12",
+  "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/columns/coreColumnsFeature.types.ts

@@ -65,7 +65,7 @@ export interface TableOptions_Columns<
   /**
    * The array of column defs to use for the table.
    */
-  columns: Array<ColumnDef<TFeatures, TData, TValue>>
+  columns: ReadonlyArray<ColumnDef<TFeatures, TData, TValue>>
   /**
    * Default column options to use for all column defs supplied to the table.
    */

package/src/core/columns/coreColumnsFeature.utils.ts

@@ -79,7 +79,7 @@ export function table_getAllColumns<
   table: Table_Internal<TFeatures, TData>,
 ): Array<Column<TFeatures, TData, unknown>> {
   const recurseColumns = (
-    colDefs: Array<ColumnDef<TFeatures, TData, unknown>>,
+    colDefs: ReadonlyArray<ColumnDef<TFeatures, TData, unknown>>,
     parent?: Column<TFeatures, TData, unknown>,
     depth = 0,
   ): Array<Column<TFeatures, TData, unknown>> => {

package/src/core/row-models/createCoreRowModel.ts

@@ -29,7 +29,7 @@ function _createCoreRowModel<
   TData extends RowData,
 >(
   table: Table_Internal<TFeatures, TData>,
-  data: Array<TData>,
+  data: ReadonlyArray<TData>,
 ): {
   rows: Array<Row<TFeatures, TData>>
   flatRows: Array<Row<TFeatures, TData>>
@@ -42,7 +42,7 @@ function _createCoreRowModel<
   }
 
   const accessRows = (
-    originalRows: Array<TData>,
+    originalRows: ReadonlyArray<TData>,
     depth = 0,
     parentRow?: Row<TFeatures, TData>,
   ): Array<Row<TFeatures, TData>> => {

package/src/core/rows/coreRowsFeature.types.ts

@@ -29,7 +29,7 @@ export interface Row_CoreProperties<
   /**
    * An array of the original subRows as returned by the `options.getSubRows` option.
    */
-  originalSubRows?: Array<TData>
+  originalSubRows?: ReadonlyArray<TData>
   /**
    * If nested, this row's parent row id.
    */
@@ -96,7 +96,10 @@ export interface TableOptions_Rows<
    * This optional function is used to access the sub rows for any given row. If you are using nested rows, you will need to use this function to return the sub rows object (or undefined) from the row.
    * @example getSubRows: row => row.subRows
    */
-  getSubRows?: (originalRow: TData, index: number) => undefined | Array<TData>
+  getSubRows?: (
+    originalRow: TData,
+    index: number,
+  ) => undefined | ReadonlyArray<TData>
 }
 
 export interface Table_Rows<

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

@@ -31,7 +31,7 @@ export interface TableOptions_Table<
   /**
    * The data for the table to display. When the `data` option changes reference, the table will reprocess the data.
    */
-  data: Array<TData>
+  data: ReadonlyArray<TData>
   /**
    * Use this option to optionally pass initial state to the table. This state will be used when resetting various table states either automatically by the table (eg. `options.autoResetPageIndex`) or via functions like `table.resetRowSelection()`. Most reset function allow you optionally pass a flag to reset to a blank/default state instead of the initial state.
    * Table state will not be reset when this object changes, which also means that the initial state object does not need to be stable.
@@ -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/types/ColumnDef.ts

@@ -150,7 +150,7 @@ type GroupColumnDefBase<
   TData extends RowData,
   TValue extends CellData = CellData,
 > = ColumnDefBase<TFeatures, TData, TValue> & {
-  columns?: Array<ColumnDef<TFeatures, TData, unknown>>
+  columns?: ReadonlyArray<ColumnDef<TFeatures, TData, unknown>>
 }
 
 export type GroupColumnDef<

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,