@tanstack/table-core 9.0.0-alpha.43 → 9.0.0-alpha.47

package/dist/features/column-filtering/filterRowsUtils.js

@@ -1,6 +1,11 @@
 import { constructRow } from "../../core/rows/constructRow.js";
 
 //#region src/features/column-filtering/filterRowsUtils.ts
+/**
+* Filters a row model with the supplied row predicate.
+*
+* The helper supports both filtering from leaf rows upward and filtering parents before descendants, depending on table options.
+*/
 function filterRows(rows, filterRowImpl, table) {
 	if (table.options.filterFromLeafRows) return filterRowModelFromLeafs(rows, filterRowImpl, table);
 	return filterRowModelFromRoot(rows, filterRowImpl, table);

package/dist/features/column-filtering/filterRowsUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"filterRowsUtils.js","names":[],"sources":["../../../src/features/column-filtering/filterRowsUtils.ts"],"sourcesContent":["import { constructRow } from '../../core/rows/constructRow'\nimport type { Row_ColumnFiltering } from './columnFilteringFeature.types'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Row } from '../../types/Row'\nimport type { Table_Internal } from '../../types/Table'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\n\nexport function filterRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rows: Array<Row<TFeatures, TData>>,\n  filterRowImpl: (row: Row<TFeatures, TData>) => any,\n  table: Table_Internal<TFeatures, TData>,\n) {\n  if (table.options.filterFromLeafRows) {\n    return filterRowModelFromLeafs(rows, filterRowImpl, table)\n  }\n\n  return filterRowModelFromRoot(rows, filterRowImpl, table)\n}\n\nfunction filterRowModelFromLeafs<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowsToFilter: Array<Row<TFeatures, TData>>,\n  filterRow: (\n    row: Row<TFeatures, TData>,\n  ) => Array<Row<TFeatures, TData>> | undefined,\n  table: Table_Internal<TFeatures, TData>,\n): RowModel<TFeatures, TData> {\n  const newFilteredFlatRows: Array<Row<TFeatures, TData>> = []\n  const newFilteredRowsById: Record<string, Row<TFeatures, TData>> = {}\n  const maxDepth = table.options.maxLeafRowFilterDepth ?? 100\n\n  const recurseFilterRows = (\n    rowsToFilter: Array<\n      Row<TFeatures, TData> & Partial<Row_ColumnFiltering<TFeatures, TData>>\n    >,\n    depth = 0,\n  ) => {\n    const filteredRows: Array<Row<TFeatures, TData>> &\n      Partial<Row_ColumnFiltering<TFeatures, TData>> = []\n\n    // Filter from children up first\n    for (let row of rowsToFilter) {\n      const newRow = constructRow(\n        table,\n        row.id,\n        row.original,\n        row.index,\n        row.depth,\n        undefined,\n        row.parentId,\n      ) as Row<TFeatures, TData> &\n        Partial<Row_ColumnFiltering<TFeatures, TData>>\n      newRow.columnFilters = row.columnFilters\n\n      if (row.subRows.length && depth < maxDepth) {\n        newRow.subRows = recurseFilterRows(row.subRows, depth + 1)\n        row = newRow\n\n        if (filterRow(row) && !newRow.subRows.length) {\n          filteredRows.push(row)\n          newFilteredRowsById[row.id] = row\n          newFilteredFlatRows.push(row)\n          continue\n        }\n\n        if (filterRow(row) || newRow.subRows.length) {\n          filteredRows.push(row)\n          newFilteredRowsById[row.id] = row\n          newFilteredFlatRows.push(row)\n          continue\n        }\n      } else {\n        row = newRow\n        if (filterRow(row)) {\n          filteredRows.push(row)\n          newFilteredRowsById[row.id] = row\n          newFilteredFlatRows.push(row)\n        }\n      }\n    }\n\n    return filteredRows\n  }\n\n  return {\n    rows: recurseFilterRows(rowsToFilter),\n    flatRows: newFilteredFlatRows,\n    rowsById: newFilteredRowsById,\n  }\n}\n\nfunction filterRowModelFromRoot<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowsToFilter: Array<Row<TFeatures, TData>>,\n  filterRow: (row: Row<TFeatures, TData>) => any,\n  table: Table_Internal<TFeatures, TData>,\n): RowModel<TFeatures, TData> {\n  const newFilteredFlatRows: Array<Row<TFeatures, TData>> = []\n  const newFilteredRowsById: Record<string, Row<TFeatures, TData>> = {}\n  const maxDepth = table.options.maxLeafRowFilterDepth ?? 100\n\n  // Filters top level and nested rows\n  const recurseFilterRows = (\n    rowsToFilter: Array<Row<TFeatures, TData>>,\n    depth = 0,\n  ) => {\n    // Filter from parents downward first\n\n    const filteredRows: Array<Row<TFeatures, TData>> = []\n\n    // Apply the filter to any subRows\n    for (let row of rowsToFilter) {\n      const pass = filterRow(row)\n\n      if (pass) {\n        if (row.subRows.length && depth < maxDepth) {\n          const newRow = constructRow(\n            table,\n            row.id,\n            row.original,\n            row.index,\n            row.depth,\n            undefined,\n            row.parentId,\n          )\n          newRow.subRows = recurseFilterRows(row.subRows, depth + 1)\n          row = newRow\n        }\n\n        filteredRows.push(row)\n        newFilteredFlatRows.push(row)\n        newFilteredRowsById[row.id] = row\n      }\n    }\n\n    return filteredRows\n  }\n\n  return {\n    rows: recurseFilterRows(rowsToFilter),\n    flatRows: newFilteredFlatRows,\n    rowsById: newFilteredRowsById,\n  }\n}\n"],"mappings":";;;AAQA,SAAgB,WAId,MACA,eACA,OACA;AACA,KAAI,MAAM,QAAQ,mBAChB,QAAO,wBAAwB,MAAM,eAAe,MAAM;AAG5D,QAAO,uBAAuB,MAAM,eAAe,MAAM;;AAG3D,SAAS,wBAIP,cACA,WAGA,OAC4B;CAC5B,MAAM,sBAAoD,EAAE;CAC5D,MAAM,sBAA6D,EAAE;CACrE,MAAM,WAAW,MAAM,QAAQ,yBAAyB;CAExD,MAAM,qBACJ,cAGA,QAAQ,MACL;EACH,MAAM,eAC6C,EAAE;AAGrD,OAAK,IAAI,OAAO,cAAc;GAC5B,MAAM,SAAS,aACb,OACA,IAAI,IACJ,IAAI,UACJ,IAAI,OACJ,IAAI,OACJ,QACA,IAAI,SACL;AAED,UAAO,gBAAgB,IAAI;AAE3B,OAAI,IAAI,QAAQ,UAAU,QAAQ,UAAU;AAC1C,WAAO,UAAU,kBAAkB,IAAI,SAAS,QAAQ,EAAE;AAC1D,UAAM;AAEN,QAAI,UAAU,IAAI,IAAI,CAAC,OAAO,QAAQ,QAAQ;AAC5C,kBAAa,KAAK,IAAI;AACtB,yBAAoB,IAAI,MAAM;AAC9B,yBAAoB,KAAK,IAAI;AAC7B;;AAGF,QAAI,UAAU,IAAI,IAAI,OAAO,QAAQ,QAAQ;AAC3C,kBAAa,KAAK,IAAI;AACtB,yBAAoB,IAAI,MAAM;AAC9B,yBAAoB,KAAK,IAAI;AAC7B;;UAEG;AACL,UAAM;AACN,QAAI,UAAU,IAAI,EAAE;AAClB,kBAAa,KAAK,IAAI;AACtB,yBAAoB,IAAI,MAAM;AAC9B,yBAAoB,KAAK,IAAI;;;;AAKnC,SAAO;;AAGT,QAAO;EACL,MAAM,kBAAkB,aAAa;EACrC,UAAU;EACV,UAAU;EACX;;AAGH,SAAS,uBAIP,cACA,WACA,OAC4B;CAC5B,MAAM,sBAAoD,EAAE;CAC5D,MAAM,sBAA6D,EAAE;CACrE,MAAM,WAAW,MAAM,QAAQ,yBAAyB;CAGxD,MAAM,qBACJ,cACA,QAAQ,MACL;EAGH,MAAM,eAA6C,EAAE;AAGrD,OAAK,IAAI,OAAO,aAGd,KAFa,UAAU,IAEf,EAAE;AACR,OAAI,IAAI,QAAQ,UAAU,QAAQ,UAAU;IAC1C,MAAM,SAAS,aACb,OACA,IAAI,IACJ,IAAI,UACJ,IAAI,OACJ,IAAI,OACJ,QACA,IAAI,SACL;AACD,WAAO,UAAU,kBAAkB,IAAI,SAAS,QAAQ,EAAE;AAC1D,UAAM;;AAGR,gBAAa,KAAK,IAAI;AACtB,uBAAoB,KAAK,IAAI;AAC7B,uBAAoB,IAAI,MAAM;;AAIlC,SAAO;;AAGT,QAAO;EACL,MAAM,kBAAkB,aAAa;EACrC,UAAU;EACV,UAAU;EACX"}
+{"version":3,"file":"filterRowsUtils.js","names":[],"sources":["../../../src/features/column-filtering/filterRowsUtils.ts"],"sourcesContent":["import { constructRow } from '../../core/rows/constructRow'\nimport type { Row_ColumnFiltering } from './columnFilteringFeature.types'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Row } from '../../types/Row'\nimport type { Table_Internal } from '../../types/Table'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Filters a row model with the supplied row predicate.\n *\n * The helper supports both filtering from leaf rows upward and filtering parents before descendants, depending on table options.\n */\nexport function filterRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rows: Array<Row<TFeatures, TData>>,\n  filterRowImpl: (row: Row<TFeatures, TData>) => any,\n  table: Table_Internal<TFeatures, TData>,\n) {\n  if (table.options.filterFromLeafRows) {\n    return filterRowModelFromLeafs(rows, filterRowImpl, table)\n  }\n\n  return filterRowModelFromRoot(rows, filterRowImpl, table)\n}\n\nfunction filterRowModelFromLeafs<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowsToFilter: Array<Row<TFeatures, TData>>,\n  filterRow: (\n    row: Row<TFeatures, TData>,\n  ) => Array<Row<TFeatures, TData>> | undefined,\n  table: Table_Internal<TFeatures, TData>,\n): RowModel<TFeatures, TData> {\n  const newFilteredFlatRows: Array<Row<TFeatures, TData>> = []\n  const newFilteredRowsById: Record<string, Row<TFeatures, TData>> = {}\n  const maxDepth = table.options.maxLeafRowFilterDepth ?? 100\n\n  const recurseFilterRows = (\n    rowsToFilter: Array<\n      Row<TFeatures, TData> & Partial<Row_ColumnFiltering<TFeatures, TData>>\n    >,\n    depth = 0,\n  ) => {\n    const filteredRows: Array<Row<TFeatures, TData>> &\n      Partial<Row_ColumnFiltering<TFeatures, TData>> = []\n\n    // Filter from children up first\n    for (let row of rowsToFilter) {\n      const newRow = constructRow(\n        table,\n        row.id,\n        row.original,\n        row.index,\n        row.depth,\n        undefined,\n        row.parentId,\n      ) as Row<TFeatures, TData> &\n        Partial<Row_ColumnFiltering<TFeatures, TData>>\n      newRow.columnFilters = row.columnFilters\n\n      if (row.subRows.length && depth < maxDepth) {\n        newRow.subRows = recurseFilterRows(row.subRows, depth + 1)\n        row = newRow\n\n        if (filterRow(row) && !newRow.subRows.length) {\n          filteredRows.push(row)\n          newFilteredRowsById[row.id] = row\n          newFilteredFlatRows.push(row)\n          continue\n        }\n\n        if (filterRow(row) || newRow.subRows.length) {\n          filteredRows.push(row)\n          newFilteredRowsById[row.id] = row\n          newFilteredFlatRows.push(row)\n          continue\n        }\n      } else {\n        row = newRow\n        if (filterRow(row)) {\n          filteredRows.push(row)\n          newFilteredRowsById[row.id] = row\n          newFilteredFlatRows.push(row)\n        }\n      }\n    }\n\n    return filteredRows\n  }\n\n  return {\n    rows: recurseFilterRows(rowsToFilter),\n    flatRows: newFilteredFlatRows,\n    rowsById: newFilteredRowsById,\n  }\n}\n\nfunction filterRowModelFromRoot<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowsToFilter: Array<Row<TFeatures, TData>>,\n  filterRow: (row: Row<TFeatures, TData>) => any,\n  table: Table_Internal<TFeatures, TData>,\n): RowModel<TFeatures, TData> {\n  const newFilteredFlatRows: Array<Row<TFeatures, TData>> = []\n  const newFilteredRowsById: Record<string, Row<TFeatures, TData>> = {}\n  const maxDepth = table.options.maxLeafRowFilterDepth ?? 100\n\n  // Filters top level and nested rows\n  const recurseFilterRows = (\n    rowsToFilter: Array<Row<TFeatures, TData>>,\n    depth = 0,\n  ) => {\n    // Filter from parents downward first\n\n    const filteredRows: Array<Row<TFeatures, TData>> = []\n\n    // Apply the filter to any subRows\n    for (let row of rowsToFilter) {\n      const pass = filterRow(row)\n\n      if (pass) {\n        if (row.subRows.length && depth < maxDepth) {\n          const newRow = constructRow(\n            table,\n            row.id,\n            row.original,\n            row.index,\n            row.depth,\n            undefined,\n            row.parentId,\n          )\n          newRow.subRows = recurseFilterRows(row.subRows, depth + 1)\n          row = newRow\n        }\n\n        filteredRows.push(row)\n        newFilteredFlatRows.push(row)\n        newFilteredRowsById[row.id] = row\n      }\n    }\n\n    return filteredRows\n  }\n\n  return {\n    rows: recurseFilterRows(rowsToFilter),\n    flatRows: newFilteredFlatRows,\n    rowsById: newFilteredRowsById,\n  }\n}\n"],"mappings":";;;;;;;;AAaA,SAAgB,WAId,MACA,eACA,OACA;CACA,IAAI,MAAM,QAAQ,oBAChB,OAAO,wBAAwB,MAAM,eAAe,MAAM;CAG5D,OAAO,uBAAuB,MAAM,eAAe,MAAM;;AAG3D,SAAS,wBAIP,cACA,WAGA,OAC4B;CAC5B,MAAM,sBAAoD,EAAE;CAC5D,MAAM,sBAA6D,EAAE;CACrE,MAAM,WAAW,MAAM,QAAQ,yBAAyB;CAExD,MAAM,qBACJ,cAGA,QAAQ,MACL;EACH,MAAM,eAC6C,EAAE;EAGrD,KAAK,IAAI,OAAO,cAAc;GAC5B,MAAM,SAAS,aACb,OACA,IAAI,IACJ,IAAI,UACJ,IAAI,OACJ,IAAI,OACJ,QACA,IAAI,SACL;GAED,OAAO,gBAAgB,IAAI;GAE3B,IAAI,IAAI,QAAQ,UAAU,QAAQ,UAAU;IAC1C,OAAO,UAAU,kBAAkB,IAAI,SAAS,QAAQ,EAAE;IAC1D,MAAM;IAEN,IAAI,UAAU,IAAI,IAAI,CAAC,OAAO,QAAQ,QAAQ;KAC5C,aAAa,KAAK,IAAI;KACtB,oBAAoB,IAAI,MAAM;KAC9B,oBAAoB,KAAK,IAAI;KAC7B;;IAGF,IAAI,UAAU,IAAI,IAAI,OAAO,QAAQ,QAAQ;KAC3C,aAAa,KAAK,IAAI;KACtB,oBAAoB,IAAI,MAAM;KAC9B,oBAAoB,KAAK,IAAI;KAC7B;;UAEG;IACL,MAAM;IACN,IAAI,UAAU,IAAI,EAAE;KAClB,aAAa,KAAK,IAAI;KACtB,oBAAoB,IAAI,MAAM;KAC9B,oBAAoB,KAAK,IAAI;;;;EAKnC,OAAO;;CAGT,OAAO;EACL,MAAM,kBAAkB,aAAa;EACrC,UAAU;EACV,UAAU;EACX;;AAGH,SAAS,uBAIP,cACA,WACA,OAC4B;CAC5B,MAAM,sBAAoD,EAAE;CAC5D,MAAM,sBAA6D,EAAE;CACrE,MAAM,WAAW,MAAM,QAAQ,yBAAyB;CAGxD,MAAM,qBACJ,cACA,QAAQ,MACL;EAGH,MAAM,eAA6C,EAAE;EAGrD,KAAK,IAAI,OAAO,cAGd,IAFa,UAAU,IAEf,EAAE;GACR,IAAI,IAAI,QAAQ,UAAU,QAAQ,UAAU;IAC1C,MAAM,SAAS,aACb,OACA,IAAI,IACJ,IAAI,UACJ,IAAI,OACJ,IAAI,OACJ,QACA,IAAI,SACL;IACD,OAAO,UAAU,kBAAkB,IAAI,SAAS,QAAQ,EAAE;IAC1D,MAAM;;GAGR,aAAa,KAAK,IAAI;GACtB,oBAAoB,KAAK,IAAI;GAC7B,oBAAoB,IAAI,MAAM;;EAIlC,OAAO;;CAGT,OAAO;EACL,MAAM,kBAAkB,aAAa;EACrC,UAAU;EACV,UAAU;EACX"}

package/dist/features/column-grouping/columnGroupingFeature.cjs

@@ -2,6 +2,11 @@ const require_utils = require('../../utils.cjs');
 const require_columnGroupingFeature_utils = require('./columnGroupingFeature.utils.cjs');
 
 //#region src/features/column-grouping/columnGroupingFeature.ts
+/**
+* Creates the stock column grouping feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
 function constructColumnGroupingFeature() {
 	return {
 		getInitialState: (initialState) => {
@@ -61,7 +66,10 @@ function constructColumnGroupingFeature() {
 	};
 }
 /**
-* The (Column) Grouping feature adds column grouping state and APIs to the table, row, column, and cell objects.
+* The stock column grouping feature.
+*
+* Register this feature to add grouping state, aggregation defaults, grouped
+* row-model support, and table/row/column/cell grouping APIs.
 */
 const columnGroupingFeature = constructColumnGroupingFeature();
 

package/dist/features/column-grouping/columnGroupingFeature.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"columnGroupingFeature.cjs","names":["getDefaultGroupingState","makeStateUpdater","cell_getIsGrouped","cell_getIsPlaceholder","cell_getIsAggregated","column_toggleGrouping","column_getCanGroup","column_getIsGrouped","column_getGroupedIndex","column_getToggleGroupingHandler","column_getAutoAggregationFn","column_getAggregationFn","row_getIsGrouped","row_getGroupingValue","table_setGrouping","table_resetGrouping"],"sources":["../../../src/features/column-grouping/columnGroupingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  cell_getIsAggregated,\n  cell_getIsGrouped,\n  cell_getIsPlaceholder,\n  column_getAggregationFn,\n  column_getAutoAggregationFn,\n  column_getCanGroup,\n  column_getGroupedIndex,\n  column_getIsGrouped,\n  column_getToggleGroupingHandler,\n  column_toggleGrouping,\n  getDefaultGroupingState,\n  row_getGroupingValue,\n  row_getIsGrouped,\n  table_resetGrouping,\n  table_setGrouping,\n} from './columnGroupingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   CachedRowModel_Grouped,\n//   Cell_ColumnGrouping,\n//   ColumnDef_ColumnGrouping,\n//   Column_ColumnGrouping,\n//   CreateRowModel_Grouped,\n//   RowModelFns_ColumnGrouping,\n//   Row_ColumnGrouping,\n//   TableOptions_ColumnGrouping,\n//   TableState_ColumnGrouping,\n//   Table_ColumnGrouping,\n// } from './columnGroupingFeature.types'\n\nexport interface ColumnGroupingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Grouped<TFeatures, TData>\n  // Cell: Cell_ColumnGrouping\n  // Column: Column_ColumnGrouping<TFeatures, TData>\n  // ColumnDef: ColumnDef_ColumnGrouping<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Grouped<TFeatures, TData>\n  // Row: Row_ColumnGrouping\n  // RowModelFns: RowModelFns_ColumnGrouping<TFeatures, TData>\n  // Table: Table_ColumnGrouping<TFeatures, TData>\n  // TableOptions: TableOptions_ColumnGrouping\n  // TableState: TableState_ColumnGrouping\n}\n\nexport function constructColumnGroupingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<ColumnGroupingFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        grouping: getDefaultGroupingState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultColumnDef: () => {\n      return {\n        aggregatedCell: ({ getValue }: any) => getValue()?.toString?.() ?? null,\n        aggregationFn: 'auto',\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onGroupingChange: makeStateUpdater('grouping', table),\n        groupedColumnMode: 'reorder',\n      }\n    },\n\n    assignCellPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        cell_getIsGrouped: {\n          fn: (cell) => cell_getIsGrouped(cell),\n        },\n        cell_getIsPlaceholder: {\n          fn: (cell) => cell_getIsPlaceholder(cell),\n        },\n        cell_getIsAggregated: {\n          fn: (cell) => cell_getIsAggregated(cell),\n        },\n      })\n    },\n\n    assignColumnPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        column_toggleGrouping: {\n          fn: (column) => column_toggleGrouping(column),\n        },\n        column_getCanGroup: {\n          fn: (column) => column_getCanGroup(column),\n        },\n        column_getIsGrouped: {\n          fn: (column) => column_getIsGrouped(column),\n        },\n        column_getGroupedIndex: {\n          fn: (column) => column_getGroupedIndex(column),\n        },\n        column_getToggleGroupingHandler: {\n          fn: (column) => column_getToggleGroupingHandler(column),\n        },\n        column_getAutoAggregationFn: {\n          fn: (column) => column_getAutoAggregationFn(column),\n        },\n        column_getAggregationFn: {\n          fn: (column) => column_getAggregationFn(column),\n        },\n      })\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        row_getIsGrouped: {\n          fn: (row) => row_getIsGrouped(row),\n        },\n        row_getGroupingValue: {\n          fn: (row, columnId) => row_getGroupingValue(row, columnId),\n        },\n      })\n    },\n\n    initRowInstanceData: (row) => {\n      ;(row as any)._groupingValuesCache = {}\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('columnGroupingFeature', table, {\n        table_setGrouping: {\n          fn: (updater) => table_setGrouping(table, updater),\n        },\n        table_resetGrouping: {\n          fn: (defaultState) => table_resetGrouping(table, defaultState),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The (Column) Grouping feature adds column grouping state and APIs to the table, row, column, and cell objects.\n */\nexport const columnGroupingFeature = constructColumnGroupingFeature()\n"],"mappings":";;;;AAqDA,SAAgB,iCAGuD;AACrE,QAAO;EACL,kBAAkB,iBAAiB;AACjC,UAAO;IACL,UAAUA,6DAAyB;IACnC,GAAG;IACJ;;EAGH,2BAA2B;AACzB,UAAO;IACL,iBAAiB,EAAE,eAAoB;;oCAAU,sEAAE,iGAAY,KAAI;;IACnE,eAAe;IAChB;;EAGH,yBAAyB,UAAU;AACjC,UAAO;IACL,kBAAkBC,+BAAiB,YAAY,MAAM;IACrD,mBAAmB;IACpB;;EAGH,sBAAsB,WAAW,UAAU;AACzC,qCAAoB,yBAAyB,WAAW,OAAO;IAC7D,mBAAmB,EACjB,KAAK,SAASC,sDAAkB,KAAK,EACtC;IACD,uBAAuB,EACrB,KAAK,SAASC,0DAAsB,KAAK,EAC1C;IACD,sBAAsB,EACpB,KAAK,SAASC,yDAAqB,KAAK,EACzC;IACF,CAAC;;EAGJ,wBAAwB,WAAW,UAAU;AAC3C,qCAAoB,yBAAyB,WAAW,OAAO;IAC7D,uBAAuB,EACrB,KAAK,WAAWC,0DAAsB,OAAO,EAC9C;IACD,oBAAoB,EAClB,KAAK,WAAWC,uDAAmB,OAAO,EAC3C;IACD,qBAAqB,EACnB,KAAK,WAAWC,wDAAoB,OAAO,EAC5C;IACD,wBAAwB,EACtB,KAAK,WAAWC,2DAAuB,OAAO,EAC/C;IACD,iCAAiC,EAC/B,KAAK,WAAWC,oEAAgC,OAAO,EACxD;IACD,6BAA6B,EAC3B,KAAK,WAAWC,gEAA4B,OAAO,EACpD;IACD,yBAAyB,EACvB,KAAK,WAAWC,4DAAwB,OAAO,EAChD;IACF,CAAC;;EAGJ,qBAAqB,WAAW,UAAU;AACxC,qCAAoB,yBAAyB,WAAW,OAAO;IAC7D,kBAAkB,EAChB,KAAK,QAAQC,qDAAiB,IAAI,EACnC;IACD,sBAAsB,EACpB,KAAK,KAAK,aAAaC,yDAAqB,KAAK,SAAS,EAC3D;IACF,CAAC;;EAGJ,sBAAsB,QAAQ;AAC3B,GAAC,IAAY,uBAAuB,EAAE;;EAGzC,qBAAqB,UAAU;AAC7B,iCAAgB,yBAAyB,OAAO;IAC9C,mBAAmB,EACjB,KAAK,YAAYC,sDAAkB,OAAO,QAAQ,EACnD;IACD,qBAAqB,EACnB,KAAK,iBAAiBC,wDAAoB,OAAO,aAAa,EAC/D;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,wBAAwB,gCAAgC"}
+{"version":3,"file":"columnGroupingFeature.cjs","names":["getDefaultGroupingState","makeStateUpdater","cell_getIsGrouped","cell_getIsPlaceholder","cell_getIsAggregated","column_toggleGrouping","column_getCanGroup","column_getIsGrouped","column_getGroupedIndex","column_getToggleGroupingHandler","column_getAutoAggregationFn","column_getAggregationFn","row_getIsGrouped","row_getGroupingValue","table_setGrouping","table_resetGrouping"],"sources":["../../../src/features/column-grouping/columnGroupingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  cell_getIsAggregated,\n  cell_getIsGrouped,\n  cell_getIsPlaceholder,\n  column_getAggregationFn,\n  column_getAutoAggregationFn,\n  column_getCanGroup,\n  column_getGroupedIndex,\n  column_getIsGrouped,\n  column_getToggleGroupingHandler,\n  column_toggleGrouping,\n  getDefaultGroupingState,\n  row_getGroupingValue,\n  row_getIsGrouped,\n  table_resetGrouping,\n  table_setGrouping,\n} from './columnGroupingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   CachedRowModel_Grouped,\n//   Cell_ColumnGrouping,\n//   ColumnDef_ColumnGrouping,\n//   Column_ColumnGrouping,\n//   CreateRowModel_Grouped,\n//   RowModelFns_ColumnGrouping,\n//   Row_ColumnGrouping,\n//   TableOptions_ColumnGrouping,\n//   TableState_ColumnGrouping,\n//   Table_ColumnGrouping,\n// } from './columnGroupingFeature.types'\n\nexport interface ColumnGroupingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Grouped<TFeatures, TData>\n  // Cell: Cell_ColumnGrouping\n  // Column: Column_ColumnGrouping<TFeatures, TData>\n  // ColumnDef: ColumnDef_ColumnGrouping<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Grouped<TFeatures, TData>\n  // Row: Row_ColumnGrouping\n  // RowModelFns: RowModelFns_ColumnGrouping<TFeatures, TData>\n  // Table: Table_ColumnGrouping<TFeatures, TData>\n  // TableOptions: TableOptions_ColumnGrouping\n  // TableState: TableState_ColumnGrouping\n}\n\n/**\n * Creates the stock column grouping feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructColumnGroupingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<ColumnGroupingFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        grouping: getDefaultGroupingState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultColumnDef: () => {\n      return {\n        aggregatedCell: ({ getValue }: any) => getValue()?.toString?.() ?? null,\n        aggregationFn: 'auto',\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onGroupingChange: makeStateUpdater('grouping', table),\n        groupedColumnMode: 'reorder',\n      }\n    },\n\n    assignCellPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        cell_getIsGrouped: {\n          fn: (cell) => cell_getIsGrouped(cell),\n        },\n        cell_getIsPlaceholder: {\n          fn: (cell) => cell_getIsPlaceholder(cell),\n        },\n        cell_getIsAggregated: {\n          fn: (cell) => cell_getIsAggregated(cell),\n        },\n      })\n    },\n\n    assignColumnPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        column_toggleGrouping: {\n          fn: (column) => column_toggleGrouping(column),\n        },\n        column_getCanGroup: {\n          fn: (column) => column_getCanGroup(column),\n        },\n        column_getIsGrouped: {\n          fn: (column) => column_getIsGrouped(column),\n        },\n        column_getGroupedIndex: {\n          fn: (column) => column_getGroupedIndex(column),\n        },\n        column_getToggleGroupingHandler: {\n          fn: (column) => column_getToggleGroupingHandler(column),\n        },\n        column_getAutoAggregationFn: {\n          fn: (column) => column_getAutoAggregationFn(column),\n        },\n        column_getAggregationFn: {\n          fn: (column) => column_getAggregationFn(column),\n        },\n      })\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        row_getIsGrouped: {\n          fn: (row) => row_getIsGrouped(row),\n        },\n        row_getGroupingValue: {\n          fn: (row, columnId) => row_getGroupingValue(row, columnId),\n        },\n      })\n    },\n\n    initRowInstanceData: (row) => {\n      ;(row as any)._groupingValuesCache = {}\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('columnGroupingFeature', table, {\n        table_setGrouping: {\n          fn: (updater) => table_setGrouping(table, updater),\n        },\n        table_resetGrouping: {\n          fn: (defaultState) => table_resetGrouping(table, defaultState),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The stock column grouping feature.\n *\n * Register this feature to add grouping state, aggregation defaults, grouped\n * row-model support, and table/row/column/cell grouping APIs.\n */\nexport const columnGroupingFeature = constructColumnGroupingFeature()\n"],"mappings":";;;;;;;;;AA0DA,SAAgB,iCAGuD;CACrE,OAAO;EACL,kBAAkB,iBAAiB;GACjC,OAAO;IACL,UAAUA,6DAAyB;IACnC,GAAG;IACJ;;EAGH,2BAA2B;GACzB,OAAO;IACL,iBAAiB,EAAE,eAAoB;;oCAAU,sEAAE,iGAAY,KAAI;;IACnE,eAAe;IAChB;;EAGH,yBAAyB,UAAU;GACjC,OAAO;IACL,kBAAkBC,+BAAiB,YAAY,MAAM;IACrD,mBAAmB;IACpB;;EAGH,sBAAsB,WAAW,UAAU;GACzC,kCAAoB,yBAAyB,WAAW,OAAO;IAC7D,mBAAmB,EACjB,KAAK,SAASC,sDAAkB,KAAK,EACtC;IACD,uBAAuB,EACrB,KAAK,SAASC,0DAAsB,KAAK,EAC1C;IACD,sBAAsB,EACpB,KAAK,SAASC,yDAAqB,KAAK,EACzC;IACF,CAAC;;EAGJ,wBAAwB,WAAW,UAAU;GAC3C,kCAAoB,yBAAyB,WAAW,OAAO;IAC7D,uBAAuB,EACrB,KAAK,WAAWC,0DAAsB,OAAO,EAC9C;IACD,oBAAoB,EAClB,KAAK,WAAWC,uDAAmB,OAAO,EAC3C;IACD,qBAAqB,EACnB,KAAK,WAAWC,wDAAoB,OAAO,EAC5C;IACD,wBAAwB,EACtB,KAAK,WAAWC,2DAAuB,OAAO,EAC/C;IACD,iCAAiC,EAC/B,KAAK,WAAWC,oEAAgC,OAAO,EACxD;IACD,6BAA6B,EAC3B,KAAK,WAAWC,gEAA4B,OAAO,EACpD;IACD,yBAAyB,EACvB,KAAK,WAAWC,4DAAwB,OAAO,EAChD;IACF,CAAC;;EAGJ,qBAAqB,WAAW,UAAU;GACxC,kCAAoB,yBAAyB,WAAW,OAAO;IAC7D,kBAAkB,EAChB,KAAK,QAAQC,qDAAiB,IAAI,EACnC;IACD,sBAAsB,EACpB,KAAK,KAAK,aAAaC,yDAAqB,KAAK,SAAS,EAC3D;IACF,CAAC;;EAGJ,sBAAsB,QAAQ;GAC3B,AAAC,IAAY,uBAAuB,EAAE;;EAGzC,qBAAqB,UAAU;GAC7B,8BAAgB,yBAAyB,OAAO;IAC9C,mBAAmB,EACjB,KAAK,YAAYC,sDAAkB,OAAO,QAAQ,EACnD;IACD,qBAAqB,EACnB,KAAK,iBAAiBC,wDAAoB,OAAO,aAAa,EAC/D;IACF,CAAC;;EAEL;;;;;;;;AASH,MAAa,wBAAwB,gCAAgC"}

package/dist/features/column-grouping/columnGroupingFeature.d.cts

@@ -3,9 +3,17 @@ import { TableFeature, TableFeatures } from "../../types/TableFeatures.cjs";
 
 //#region src/features/column-grouping/columnGroupingFeature.d.ts
 interface ColumnGroupingFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock column grouping feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 declare function constructColumnGroupingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<ColumnGroupingFeatureConstructors<TFeatures, TData>>;
 /**
- * The (Column) Grouping feature adds column grouping state and APIs to the table, row, column, and cell objects.
+ * The stock column grouping feature.
+ *
+ * Register this feature to add grouping state, aggregation defaults, grouped
+ * row-model support, and table/row/column/cell grouping APIs.
  */
 declare const columnGroupingFeature: TableFeature<ColumnGroupingFeatureConstructors<TableFeatures, RowData>>;
 //#endregion

package/dist/features/column-grouping/columnGroupingFeature.d.ts

@@ -3,9 +3,17 @@ import { TableFeature, TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/features/column-grouping/columnGroupingFeature.d.ts
 interface ColumnGroupingFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock column grouping feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 declare function constructColumnGroupingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<ColumnGroupingFeatureConstructors<TFeatures, TData>>;
 /**
- * The (Column) Grouping feature adds column grouping state and APIs to the table, row, column, and cell objects.
+ * The stock column grouping feature.
+ *
+ * Register this feature to add grouping state, aggregation defaults, grouped
+ * row-model support, and table/row/column/cell grouping APIs.
  */
 declare const columnGroupingFeature: TableFeature<ColumnGroupingFeatureConstructors<TableFeatures, RowData>>;
 //#endregion

package/dist/features/column-grouping/columnGroupingFeature.js

@@ -2,6 +2,11 @@ import { assignPrototypeAPIs, assignTableAPIs, makeStateUpdater } from "../../ut
 import { cell_getIsAggregated, cell_getIsGrouped, cell_getIsPlaceholder, column_getAggregationFn, column_getAutoAggregationFn, column_getCanGroup, column_getGroupedIndex, column_getIsGrouped, column_getToggleGroupingHandler, column_toggleGrouping, getDefaultGroupingState, row_getGroupingValue, row_getIsGrouped, table_resetGrouping, table_setGrouping } from "./columnGroupingFeature.utils.js";
 
 //#region src/features/column-grouping/columnGroupingFeature.ts
+/**
+* Creates the stock column grouping feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
 function constructColumnGroupingFeature() {
 	return {
 		getInitialState: (initialState) => {
@@ -61,7 +66,10 @@ function constructColumnGroupingFeature() {
 	};
 }
 /**
-* The (Column) Grouping feature adds column grouping state and APIs to the table, row, column, and cell objects.
+* The stock column grouping feature.
+*
+* Register this feature to add grouping state, aggregation defaults, grouped
+* row-model support, and table/row/column/cell grouping APIs.
 */
 const columnGroupingFeature = constructColumnGroupingFeature();
 

package/dist/features/column-grouping/columnGroupingFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"columnGroupingFeature.js","names":[],"sources":["../../../src/features/column-grouping/columnGroupingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  cell_getIsAggregated,\n  cell_getIsGrouped,\n  cell_getIsPlaceholder,\n  column_getAggregationFn,\n  column_getAutoAggregationFn,\n  column_getCanGroup,\n  column_getGroupedIndex,\n  column_getIsGrouped,\n  column_getToggleGroupingHandler,\n  column_toggleGrouping,\n  getDefaultGroupingState,\n  row_getGroupingValue,\n  row_getIsGrouped,\n  table_resetGrouping,\n  table_setGrouping,\n} from './columnGroupingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   CachedRowModel_Grouped,\n//   Cell_ColumnGrouping,\n//   ColumnDef_ColumnGrouping,\n//   Column_ColumnGrouping,\n//   CreateRowModel_Grouped,\n//   RowModelFns_ColumnGrouping,\n//   Row_ColumnGrouping,\n//   TableOptions_ColumnGrouping,\n//   TableState_ColumnGrouping,\n//   Table_ColumnGrouping,\n// } from './columnGroupingFeature.types'\n\nexport interface ColumnGroupingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Grouped<TFeatures, TData>\n  // Cell: Cell_ColumnGrouping\n  // Column: Column_ColumnGrouping<TFeatures, TData>\n  // ColumnDef: ColumnDef_ColumnGrouping<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Grouped<TFeatures, TData>\n  // Row: Row_ColumnGrouping\n  // RowModelFns: RowModelFns_ColumnGrouping<TFeatures, TData>\n  // Table: Table_ColumnGrouping<TFeatures, TData>\n  // TableOptions: TableOptions_ColumnGrouping\n  // TableState: TableState_ColumnGrouping\n}\n\nexport function constructColumnGroupingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<ColumnGroupingFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        grouping: getDefaultGroupingState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultColumnDef: () => {\n      return {\n        aggregatedCell: ({ getValue }: any) => getValue()?.toString?.() ?? null,\n        aggregationFn: 'auto',\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onGroupingChange: makeStateUpdater('grouping', table),\n        groupedColumnMode: 'reorder',\n      }\n    },\n\n    assignCellPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        cell_getIsGrouped: {\n          fn: (cell) => cell_getIsGrouped(cell),\n        },\n        cell_getIsPlaceholder: {\n          fn: (cell) => cell_getIsPlaceholder(cell),\n        },\n        cell_getIsAggregated: {\n          fn: (cell) => cell_getIsAggregated(cell),\n        },\n      })\n    },\n\n    assignColumnPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        column_toggleGrouping: {\n          fn: (column) => column_toggleGrouping(column),\n        },\n        column_getCanGroup: {\n          fn: (column) => column_getCanGroup(column),\n        },\n        column_getIsGrouped: {\n          fn: (column) => column_getIsGrouped(column),\n        },\n        column_getGroupedIndex: {\n          fn: (column) => column_getGroupedIndex(column),\n        },\n        column_getToggleGroupingHandler: {\n          fn: (column) => column_getToggleGroupingHandler(column),\n        },\n        column_getAutoAggregationFn: {\n          fn: (column) => column_getAutoAggregationFn(column),\n        },\n        column_getAggregationFn: {\n          fn: (column) => column_getAggregationFn(column),\n        },\n      })\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        row_getIsGrouped: {\n          fn: (row) => row_getIsGrouped(row),\n        },\n        row_getGroupingValue: {\n          fn: (row, columnId) => row_getGroupingValue(row, columnId),\n        },\n      })\n    },\n\n    initRowInstanceData: (row) => {\n      ;(row as any)._groupingValuesCache = {}\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('columnGroupingFeature', table, {\n        table_setGrouping: {\n          fn: (updater) => table_setGrouping(table, updater),\n        },\n        table_resetGrouping: {\n          fn: (defaultState) => table_resetGrouping(table, defaultState),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The (Column) Grouping feature adds column grouping state and APIs to the table, row, column, and cell objects.\n */\nexport const columnGroupingFeature = constructColumnGroupingFeature()\n"],"mappings":";;;;AAqDA,SAAgB,iCAGuD;AACrE,QAAO;EACL,kBAAkB,iBAAiB;AACjC,UAAO;IACL,UAAU,yBAAyB;IACnC,GAAG;IACJ;;EAGH,2BAA2B;AACzB,UAAO;IACL,iBAAiB,EAAE,eAAoB;;oCAAU,sEAAE,iGAAY,KAAI;;IACnE,eAAe;IAChB;;EAGH,yBAAyB,UAAU;AACjC,UAAO;IACL,kBAAkB,iBAAiB,YAAY,MAAM;IACrD,mBAAmB;IACpB;;EAGH,sBAAsB,WAAW,UAAU;AACzC,uBAAoB,yBAAyB,WAAW,OAAO;IAC7D,mBAAmB,EACjB,KAAK,SAAS,kBAAkB,KAAK,EACtC;IACD,uBAAuB,EACrB,KAAK,SAAS,sBAAsB,KAAK,EAC1C;IACD,sBAAsB,EACpB,KAAK,SAAS,qBAAqB,KAAK,EACzC;IACF,CAAC;;EAGJ,wBAAwB,WAAW,UAAU;AAC3C,uBAAoB,yBAAyB,WAAW,OAAO;IAC7D,uBAAuB,EACrB,KAAK,WAAW,sBAAsB,OAAO,EAC9C;IACD,oBAAoB,EAClB,KAAK,WAAW,mBAAmB,OAAO,EAC3C;IACD,qBAAqB,EACnB,KAAK,WAAW,oBAAoB,OAAO,EAC5C;IACD,wBAAwB,EACtB,KAAK,WAAW,uBAAuB,OAAO,EAC/C;IACD,iCAAiC,EAC/B,KAAK,WAAW,gCAAgC,OAAO,EACxD;IACD,6BAA6B,EAC3B,KAAK,WAAW,4BAA4B,OAAO,EACpD;IACD,yBAAyB,EACvB,KAAK,WAAW,wBAAwB,OAAO,EAChD;IACF,CAAC;;EAGJ,qBAAqB,WAAW,UAAU;AACxC,uBAAoB,yBAAyB,WAAW,OAAO;IAC7D,kBAAkB,EAChB,KAAK,QAAQ,iBAAiB,IAAI,EACnC;IACD,sBAAsB,EACpB,KAAK,KAAK,aAAa,qBAAqB,KAAK,SAAS,EAC3D;IACF,CAAC;;EAGJ,sBAAsB,QAAQ;AAC3B,GAAC,IAAY,uBAAuB,EAAE;;EAGzC,qBAAqB,UAAU;AAC7B,mBAAgB,yBAAyB,OAAO;IAC9C,mBAAmB,EACjB,KAAK,YAAY,kBAAkB,OAAO,QAAQ,EACnD;IACD,qBAAqB,EACnB,KAAK,iBAAiB,oBAAoB,OAAO,aAAa,EAC/D;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,wBAAwB,gCAAgC"}
+{"version":3,"file":"columnGroupingFeature.js","names":[],"sources":["../../../src/features/column-grouping/columnGroupingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  cell_getIsAggregated,\n  cell_getIsGrouped,\n  cell_getIsPlaceholder,\n  column_getAggregationFn,\n  column_getAutoAggregationFn,\n  column_getCanGroup,\n  column_getGroupedIndex,\n  column_getIsGrouped,\n  column_getToggleGroupingHandler,\n  column_toggleGrouping,\n  getDefaultGroupingState,\n  row_getGroupingValue,\n  row_getIsGrouped,\n  table_resetGrouping,\n  table_setGrouping,\n} from './columnGroupingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   CachedRowModel_Grouped,\n//   Cell_ColumnGrouping,\n//   ColumnDef_ColumnGrouping,\n//   Column_ColumnGrouping,\n//   CreateRowModel_Grouped,\n//   RowModelFns_ColumnGrouping,\n//   Row_ColumnGrouping,\n//   TableOptions_ColumnGrouping,\n//   TableState_ColumnGrouping,\n//   Table_ColumnGrouping,\n// } from './columnGroupingFeature.types'\n\nexport interface ColumnGroupingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Grouped<TFeatures, TData>\n  // Cell: Cell_ColumnGrouping\n  // Column: Column_ColumnGrouping<TFeatures, TData>\n  // ColumnDef: ColumnDef_ColumnGrouping<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Grouped<TFeatures, TData>\n  // Row: Row_ColumnGrouping\n  // RowModelFns: RowModelFns_ColumnGrouping<TFeatures, TData>\n  // Table: Table_ColumnGrouping<TFeatures, TData>\n  // TableOptions: TableOptions_ColumnGrouping\n  // TableState: TableState_ColumnGrouping\n}\n\n/**\n * Creates the stock column grouping feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructColumnGroupingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<ColumnGroupingFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        grouping: getDefaultGroupingState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultColumnDef: () => {\n      return {\n        aggregatedCell: ({ getValue }: any) => getValue()?.toString?.() ?? null,\n        aggregationFn: 'auto',\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onGroupingChange: makeStateUpdater('grouping', table),\n        groupedColumnMode: 'reorder',\n      }\n    },\n\n    assignCellPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        cell_getIsGrouped: {\n          fn: (cell) => cell_getIsGrouped(cell),\n        },\n        cell_getIsPlaceholder: {\n          fn: (cell) => cell_getIsPlaceholder(cell),\n        },\n        cell_getIsAggregated: {\n          fn: (cell) => cell_getIsAggregated(cell),\n        },\n      })\n    },\n\n    assignColumnPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        column_toggleGrouping: {\n          fn: (column) => column_toggleGrouping(column),\n        },\n        column_getCanGroup: {\n          fn: (column) => column_getCanGroup(column),\n        },\n        column_getIsGrouped: {\n          fn: (column) => column_getIsGrouped(column),\n        },\n        column_getGroupedIndex: {\n          fn: (column) => column_getGroupedIndex(column),\n        },\n        column_getToggleGroupingHandler: {\n          fn: (column) => column_getToggleGroupingHandler(column),\n        },\n        column_getAutoAggregationFn: {\n          fn: (column) => column_getAutoAggregationFn(column),\n        },\n        column_getAggregationFn: {\n          fn: (column) => column_getAggregationFn(column),\n        },\n      })\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnGroupingFeature', prototype, table, {\n        row_getIsGrouped: {\n          fn: (row) => row_getIsGrouped(row),\n        },\n        row_getGroupingValue: {\n          fn: (row, columnId) => row_getGroupingValue(row, columnId),\n        },\n      })\n    },\n\n    initRowInstanceData: (row) => {\n      ;(row as any)._groupingValuesCache = {}\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('columnGroupingFeature', table, {\n        table_setGrouping: {\n          fn: (updater) => table_setGrouping(table, updater),\n        },\n        table_resetGrouping: {\n          fn: (defaultState) => table_resetGrouping(table, defaultState),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The stock column grouping feature.\n *\n * Register this feature to add grouping state, aggregation defaults, grouped\n * row-model support, and table/row/column/cell grouping APIs.\n */\nexport const columnGroupingFeature = constructColumnGroupingFeature()\n"],"mappings":";;;;;;;;;AA0DA,SAAgB,iCAGuD;CACrE,OAAO;EACL,kBAAkB,iBAAiB;GACjC,OAAO;IACL,UAAU,yBAAyB;IACnC,GAAG;IACJ;;EAGH,2BAA2B;GACzB,OAAO;IACL,iBAAiB,EAAE,eAAoB;;oCAAU,sEAAE,iGAAY,KAAI;;IACnE,eAAe;IAChB;;EAGH,yBAAyB,UAAU;GACjC,OAAO;IACL,kBAAkB,iBAAiB,YAAY,MAAM;IACrD,mBAAmB;IACpB;;EAGH,sBAAsB,WAAW,UAAU;GACzC,oBAAoB,yBAAyB,WAAW,OAAO;IAC7D,mBAAmB,EACjB,KAAK,SAAS,kBAAkB,KAAK,EACtC;IACD,uBAAuB,EACrB,KAAK,SAAS,sBAAsB,KAAK,EAC1C;IACD,sBAAsB,EACpB,KAAK,SAAS,qBAAqB,KAAK,EACzC;IACF,CAAC;;EAGJ,wBAAwB,WAAW,UAAU;GAC3C,oBAAoB,yBAAyB,WAAW,OAAO;IAC7D,uBAAuB,EACrB,KAAK,WAAW,sBAAsB,OAAO,EAC9C;IACD,oBAAoB,EAClB,KAAK,WAAW,mBAAmB,OAAO,EAC3C;IACD,qBAAqB,EACnB,KAAK,WAAW,oBAAoB,OAAO,EAC5C;IACD,wBAAwB,EACtB,KAAK,WAAW,uBAAuB,OAAO,EAC/C;IACD,iCAAiC,EAC/B,KAAK,WAAW,gCAAgC,OAAO,EACxD;IACD,6BAA6B,EAC3B,KAAK,WAAW,4BAA4B,OAAO,EACpD;IACD,yBAAyB,EACvB,KAAK,WAAW,wBAAwB,OAAO,EAChD;IACF,CAAC;;EAGJ,qBAAqB,WAAW,UAAU;GACxC,oBAAoB,yBAAyB,WAAW,OAAO;IAC7D,kBAAkB,EAChB,KAAK,QAAQ,iBAAiB,IAAI,EACnC;IACD,sBAAsB,EACpB,KAAK,KAAK,aAAa,qBAAqB,KAAK,SAAS,EAC3D;IACF,CAAC;;EAGJ,sBAAsB,QAAQ;GAC3B,AAAC,IAAY,uBAAuB,EAAE;;EAGzC,qBAAqB,UAAU;GAC7B,gBAAgB,yBAAyB,OAAO;IAC9C,mBAAmB,EACjB,KAAK,YAAY,kBAAkB,OAAO,QAAQ,EACnD;IACD,qBAAqB,EACnB,KAAK,iBAAiB,oBAAoB,OAAO,aAAa,EAC/D;IACF,CAAC;;EAEL;;;;;;;;AASH,MAAa,wBAAwB,gCAAgC"}

package/dist/features/column-grouping/columnGroupingFeature.types.d.cts

@@ -118,7 +118,9 @@ interface TableOptions_ColumnGrouping {
    */
   manualGrouping?: boolean;
   /**
-   * If this function is provided, it will be called when the grouping state changes and you will be expected to manage the state yourself. You can pass the managed state back to the table via the `tableOptions.state.grouping` option.
+   * Called with an updater when grouping state changes. Pair this with
+   * `state.grouping` when using external state; external atoms can own the
+   * slice without this callback.
    */
   onGroupingChange?: OnChangeFn<GroupingState>;
 }
@@ -129,7 +131,7 @@ interface Table_ColumnGrouping<TFeatures extends TableFeatures, TData extends Ro
    */
   resetGrouping: (defaultState?: boolean) => void;
   /**
-   * Updates the grouping state of the table via an update function or value.
+   * Sets grouping state using a value or updater.
    */
   setGrouping: (updater: Updater<GroupingState>) => void;
 }
@@ -145,7 +147,9 @@ interface Table_RowModels_Grouped<TFeatures extends TableFeatures, TData extends
 }
 interface CreateRowModel_Grouped<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Returns the row model after grouping has taken place, but no further.
+   * Factory used to retrieve the grouped row model. If using server-side
+   * grouping, this is not required. To use client-side grouping, pass
+   * `createGroupedRowModel()` or implement your own factory.
    */
   groupedRowModel?: (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
 }

package/dist/features/column-grouping/columnGroupingFeature.types.d.ts

@@ -118,7 +118,9 @@ interface TableOptions_ColumnGrouping {
    */
   manualGrouping?: boolean;
   /**
-   * If this function is provided, it will be called when the grouping state changes and you will be expected to manage the state yourself. You can pass the managed state back to the table via the `tableOptions.state.grouping` option.
+   * Called with an updater when grouping state changes. Pair this with
+   * `state.grouping` when using external state; external atoms can own the
+   * slice without this callback.
    */
   onGroupingChange?: OnChangeFn<GroupingState>;
 }
@@ -129,7 +131,7 @@ interface Table_ColumnGrouping<TFeatures extends TableFeatures, TData extends Ro
    */
   resetGrouping: (defaultState?: boolean) => void;
   /**
-   * Updates the grouping state of the table via an update function or value.
+   * Sets grouping state using a value or updater.
    */
   setGrouping: (updater: Updater<GroupingState>) => void;
 }
@@ -145,7 +147,9 @@ interface Table_RowModels_Grouped<TFeatures extends TableFeatures, TData extends
 }
 interface CreateRowModel_Grouped<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Returns the row model after grouping has taken place, but no further.
+   * Factory used to retrieve the grouped row model. If using server-side
+   * grouping, this is not required. To use client-side grouping, pass
+   * `createGroupedRowModel()` or implement your own factory.
    */
   groupedRowModel?: (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
 }

package/dist/features/column-grouping/columnGroupingFeature.utils.cjs

@@ -2,26 +2,86 @@ const require_utils = require('../../utils.cjs');
 const require_coreColumnsFeature_utils = require('../../core/columns/coreColumnsFeature.utils.cjs');
 
 //#region src/features/column-grouping/columnGroupingFeature.utils.ts
+/**
+* Returns the default grouping state.
+*
+* Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+*
+* @example
+* ```ts
+* const initialValue = getDefaultGroupingState()
+* ```
+*/
 function getDefaultGroupingState() {
 	return [];
 }
+/**
+* Toggles grouping for a column.
+*
+* The update is applied through the owning table state slice and respects the feature options for that column.
+*
+* @example
+* ```ts
+* column_toggleGrouping(column)
+* ```
+*/
 function column_toggleGrouping(column) {
 	table_setGrouping(column.table, (old) => {
 		if (old.includes(column.id)) return old.filter((d) => d !== column.id);
 		return [...old, column.id];
 	});
 }
+/**
+* Returns whether a column can use group.
+*
+* This combines column options, table options, and any required accessor or feature state for the capability.
+*
+* @example
+* ```ts
+* const value = column_getCanGroup(column)
+* ```
+*/
 function column_getCanGroup(column) {
 	return (column.columnDef.enableGrouping ?? true) && (column.table.options.enableGrouping ?? true) && (!!column.accessorFn || !!column.columnDef.getGroupingValue);
 }
+/**
+* Returns is grouped for a column.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getIsGrouped(column)
+* ```
+*/
 function column_getIsGrouped(column) {
 	var _column$table$atoms$g;
 	return !!((_column$table$atoms$g = column.table.atoms.grouping) === null || _column$table$atoms$g === void 0 || (_column$table$atoms$g = _column$table$atoms$g.get()) === null || _column$table$atoms$g === void 0 ? void 0 : _column$table$atoms$g.includes(column.id));
 }
+/**
+* Returns grouped index for a column.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getGroupedIndex(column)
+* ```
+*/
 function column_getGroupedIndex(column) {
 	var _column$table$atoms$g2;
 	return ((_column$table$atoms$g2 = column.table.atoms.grouping) === null || _column$table$atoms$g2 === void 0 || (_column$table$atoms$g2 = _column$table$atoms$g2.get()) === null || _column$table$atoms$g2 === void 0 ? void 0 : _column$table$atoms$g2.indexOf(column.id)) ?? -1;
 }
+/**
+* Returns an event handler for toggling grouping handler.
+*
+* The handler is intended for direct use in column header controls such as buttons or checkboxes.
+*
+* @example
+* ```ts
+* const value = column_getToggleGroupingHandler(column)
+* ```
+*/
 function column_getToggleGroupingHandler(column) {
 	const canGroup = column_getCanGroup(column);
 	return () => {
@@ -29,6 +89,16 @@ function column_getToggleGroupingHandler(column) {
 		column_toggleGrouping(column);
 	};
 }
+/**
+* Infers aggregation fn for a column.
+*
+* The inference uses the column definition, table options, and sampled row values when needed.
+*
+* @example
+* ```ts
+* const value = column_getAutoAggregationFn(column)
+* ```
+*/
 function column_getAutoAggregationFn(column) {
 	const aggregationFns = column.table._rowModelFns.aggregationFns;
 	const firstRow = column.table.getCoreRowModel().flatRows[0];
@@ -36,20 +106,71 @@ function column_getAutoAggregationFn(column) {
 	if (typeof value === "number") return aggregationFns === null || aggregationFns === void 0 ? void 0 : aggregationFns.sum;
 	if (Object.prototype.toString.call(value) === "[object Date]") return aggregationFns === null || aggregationFns === void 0 ? void 0 : aggregationFns.extent;
 }
+/**
+* Returns aggregation fn for a column.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getAggregationFn(column)
+* ```
+*/
 function column_getAggregationFn(column) {
 	const aggregationFns = column.table._rowModelFns.aggregationFns;
 	return require_utils.isFunction(column.columnDef.aggregationFn) ? column.columnDef.aggregationFn : column.columnDef.aggregationFn === "auto" ? column_getAutoAggregationFn(column) : aggregationFns === null || aggregationFns === void 0 ? void 0 : aggregationFns[column.columnDef.aggregationFn];
 }
+/**
+* Updates the table's grouping state slice.
+*
+* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+*
+* @example
+* ```ts
+* table_setGrouping(table, (old) => old)
+* ```
+*/
 function table_setGrouping(table, updater) {
 	var _table$options$onGrou, _table$options;
 	(_table$options$onGrou = (_table$options = table.options).onGroupingChange) === null || _table$options$onGrou === void 0 || _table$options$onGrou.call(_table$options, updater);
 }
+/**
+* Resets the table's grouping state slice.
+*
+* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+*
+* @example
+* ```ts
+* table_resetGrouping(table)
+* table_resetGrouping(table, true)
+* ```
+*/
 function table_resetGrouping(table, defaultState) {
 	table_setGrouping(table, defaultState ? [] : require_utils.cloneState(table.initialState.grouping ?? []));
 }
+/**
+* Returns is grouped for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getIsGrouped(row)
+* ```
+*/
 function row_getIsGrouped(row) {
 	return !!row.groupingColumnId;
 }
+/**
+* Returns grouping value for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getGroupingValue(row)
+* ```
+*/
 function row_getGroupingValue(row, columnId) {
 	var _row$_groupingValuesC, _row$_groupingValuesC2;
 	if ((_row$_groupingValuesC = row._groupingValuesCache) === null || _row$_groupingValuesC === void 0 ? void 0 : _row$_groupingValuesC.hasOwnProperty(columnId)) return row._groupingValuesCache[columnId];
@@ -58,13 +179,43 @@ function row_getGroupingValue(row, columnId) {
 	if (row._groupingValuesCache) row._groupingValuesCache[columnId] = column.columnDef.getGroupingValue(row.original);
 	return (_row$_groupingValuesC2 = row._groupingValuesCache) === null || _row$_groupingValuesC2 === void 0 ? void 0 : _row$_groupingValuesC2[columnId];
 }
+/**
+* Returns is grouped for a cell.
+*
+* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+*
+* @example
+* ```ts
+* const value = cell_getIsGrouped(cell)
+* ```
+*/
 function cell_getIsGrouped(cell) {
 	const row = cell.row;
 	return column_getIsGrouped(cell.column) && cell.column.id === row.groupingColumnId;
 }
+/**
+* Returns is placeholder for a cell.
+*
+* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+*
+* @example
+* ```ts
+* const value = cell_getIsPlaceholder(cell)
+* ```
+*/
 function cell_getIsPlaceholder(cell) {
 	return !cell_getIsGrouped(cell) && column_getIsGrouped(cell.column);
 }
+/**
+* Returns is aggregated for a cell.
+*
+* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+*
+* @example
+* ```ts
+* const value = cell_getIsAggregated(cell)
+* ```
+*/
 function cell_getIsAggregated(cell) {
 	return !cell_getIsGrouped(cell) && !cell_getIsPlaceholder(cell) && !!cell.row.subRows.length;
 }

package/dist/features/column-grouping/columnGroupingFeature.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"columnGroupingFeature.utils.cjs","names":["isFunction","cloneState","table_getColumn"],"sources":["../../../src/features/column-grouping/columnGroupingFeature.utils.ts"],"sourcesContent":["import { cloneState, isFunction } from '../../utils'\nimport { table_getColumn } from '../../core/columns/coreColumnsFeature.utils'\nimport type { Column_Internal } from '../../types/Column'\nimport type { CellData, RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\nimport type {\n  AggregationFn,\n  GroupingState,\n  Row_ColumnGrouping,\n} from './columnGroupingFeature.types'\n\nexport function getDefaultGroupingState(): GroupingState {\n  return []\n}\n\nexport function column_toggleGrouping<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  table_setGrouping(column.table, (old) => {\n    // Find any existing grouping for this column\n    if (old.includes(column.id)) {\n      return old.filter((d) => d !== column.id)\n    }\n\n    return [...old, column.id]\n  })\n}\n\nexport function column_getCanGroup<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return (\n    (column.columnDef.enableGrouping ?? true) &&\n    (column.table.options.enableGrouping ?? true) &&\n    (!!column.accessorFn || !!column.columnDef.getGroupingValue)\n  )\n}\n\nexport function column_getIsGrouped<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>): boolean {\n  return !!column.table.atoms.grouping?.get()?.includes(column.id)\n}\n\nexport function column_getGroupedIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>): number {\n  return column.table.atoms.grouping?.get()?.indexOf(column.id) ?? -1\n}\n\nexport function column_getToggleGroupingHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const canGroup = column_getCanGroup(column)\n\n  return () => {\n    if (!canGroup) return\n    column_toggleGrouping(column)\n  }\n}\n\nexport function column_getAutoAggregationFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const aggregationFns:\n    | Record<string, AggregationFn<TFeatures, TData>>\n    | undefined = column.table._rowModelFns.aggregationFns\n\n  const firstRow = column.table.getCoreRowModel().flatRows[0]\n\n  const value = firstRow?.getValue(column.id)\n\n  if (typeof value === 'number') {\n    return aggregationFns?.sum\n  }\n\n  if (Object.prototype.toString.call(value) === '[object Date]') {\n    return aggregationFns?.extent\n  }\n}\n\nexport function column_getAggregationFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const aggregationFns:\n    | Record<string, AggregationFn<TFeatures, TData>>\n    | undefined = column.table._rowModelFns.aggregationFns\n\n  return isFunction(column.columnDef.aggregationFn)\n    ? column.columnDef.aggregationFn\n    : column.columnDef.aggregationFn === 'auto'\n      ? column_getAutoAggregationFn(column)\n      : aggregationFns?.[column.columnDef.aggregationFn as string]\n}\n\nexport function table_setGrouping<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<GroupingState>) {\n  table.options.onGroupingChange?.(updater)\n}\n\nexport function table_resetGrouping<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setGrouping(\n    table,\n    defaultState ? [] : cloneState(table.initialState.grouping ?? []),\n  )\n}\n\nexport function row_getIsGrouped<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData> & Partial<Row_ColumnGrouping>) {\n  return !!row.groupingColumnId\n}\n\nexport function row_getGroupingValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData> & Partial<Row_ColumnGrouping>, columnId: string) {\n  if (row._groupingValuesCache?.hasOwnProperty(columnId)) {\n    return row._groupingValuesCache[columnId]\n  }\n\n  const column = table_getColumn(row.table, columnId) as Column_Internal<\n    TFeatures,\n    TData\n  >\n\n  if (!column.columnDef.getGroupingValue) {\n    return row.getValue(columnId)\n  }\n\n  if (row._groupingValuesCache) {\n    row._groupingValuesCache[columnId] = column.columnDef.getGroupingValue(\n      row.original,\n    )\n  }\n\n  return row._groupingValuesCache?.[columnId]\n}\n\nexport function cell_getIsGrouped<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  const row = cell.row as Row<TFeatures, TData> & Partial<Row_ColumnGrouping>\n  return (\n    column_getIsGrouped(cell.column) && cell.column.id === row.groupingColumnId\n  )\n}\n\nexport function cell_getIsPlaceholder<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return !cell_getIsGrouped(cell) && column_getIsGrouped(cell.column)\n}\n\nexport function cell_getIsAggregated<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return (\n    !cell_getIsGrouped(cell) &&\n    !cell_getIsPlaceholder(cell) &&\n    !!cell.row.subRows.length\n  )\n}\n"],"mappings":";;;;AAcA,SAAgB,0BAAyC;AACvD,QAAO,EAAE;;AAGX,SAAgB,sBAId,QAAmD;AACnD,mBAAkB,OAAO,QAAQ,QAAQ;AAEvC,MAAI,IAAI,SAAS,OAAO,GAAG,CACzB,QAAO,IAAI,QAAQ,MAAM,MAAM,OAAO,GAAG;AAG3C,SAAO,CAAC,GAAG,KAAK,OAAO,GAAG;GAC1B;;AAGJ,SAAgB,mBAId,QAAmD;AACnD,SACG,OAAO,UAAU,kBAAkB,UACnC,OAAO,MAAM,QAAQ,kBAAkB,UACvC,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,OAAO,UAAU;;AAI/C,SAAgB,oBAId,QAA4D;;AAC5D,QAAO,CAAC,2BAAC,OAAO,MAAM,MAAM,yGAAU,KAAK,gFAAE,SAAS,OAAO,GAAG;;AAGlE,SAAgB,uBAId,QAA2D;;AAC3D,mCAAO,OAAO,MAAM,MAAM,4GAAU,KAAK,kFAAE,QAAQ,OAAO,GAAG,KAAI;;AAGnE,SAAgB,gCAId,QAAmD;CACnD,MAAM,WAAW,mBAAmB,OAAO;AAE3C,cAAa;AACX,MAAI,CAAC,SAAU;AACf,wBAAsB,OAAO;;;AAIjC,SAAgB,4BAId,QAAmD;CACnD,MAAM,iBAEU,OAAO,MAAM,aAAa;CAE1C,MAAM,WAAW,OAAO,MAAM,iBAAiB,CAAC,SAAS;CAEzD,MAAM,4DAAQ,SAAU,SAAS,OAAO,GAAG;AAE3C,KAAI,OAAO,UAAU,SACnB,wEAAO,eAAgB;AAGzB,KAAI,OAAO,UAAU,SAAS,KAAK,MAAM,KAAK,gBAC5C,wEAAO,eAAgB;;AAI3B,SAAgB,wBAId,QAAmD;CACnD,MAAM,iBAEU,OAAO,MAAM,aAAa;AAE1C,QAAOA,yBAAW,OAAO,UAAU,cAAc,GAC7C,OAAO,UAAU,gBACjB,OAAO,UAAU,kBAAkB,SACjC,4BAA4B,OAAO,mEACnC,eAAiB,OAAO,UAAU;;AAG1C,SAAgB,kBAGd,OAAyC,SAAiC;;AAC1E,kDAAM,SAAQ,6GAAmB,QAAQ;;AAG3C,SAAgB,oBAGd,OAAyC,cAAwB;AACjE,mBACE,OACA,eAAe,EAAE,GAAGC,yBAAW,MAAM,aAAa,YAAY,EAAE,CAAC,CAClE;;AAGH,SAAgB,iBAGd,KAA0D;AAC1D,QAAO,CAAC,CAAC,IAAI;;AAGf,SAAgB,qBAGd,KAA0D,UAAkB;;AAC5E,8BAAI,IAAI,oGAAsB,eAAe,SAAS,CACpD,QAAO,IAAI,qBAAqB;CAGlC,MAAM,SAASC,iDAAgB,IAAI,OAAO,SAAS;AAKnD,KAAI,CAAC,OAAO,UAAU,iBACpB,QAAO,IAAI,SAAS,SAAS;AAG/B,KAAI,IAAI,qBACN,KAAI,qBAAqB,YAAY,OAAO,UAAU,iBACpD,IAAI,SACL;AAGH,kCAAO,IAAI,sGAAuB;;AAGpC,SAAgB,kBAId,MAAsC;CACtC,MAAM,MAAM,KAAK;AACjB,QACE,oBAAoB,KAAK,OAAO,IAAI,KAAK,OAAO,OAAO,IAAI;;AAI/D,SAAgB,sBAId,MAAsC;AACtC,QAAO,CAAC,kBAAkB,KAAK,IAAI,oBAAoB,KAAK,OAAO;;AAGrE,SAAgB,qBAId,MAAsC;AACtC,QACE,CAAC,kBAAkB,KAAK,IACxB,CAAC,sBAAsB,KAAK,IAC5B,CAAC,CAAC,KAAK,IAAI,QAAQ"}
+{"version":3,"file":"columnGroupingFeature.utils.cjs","names":["isFunction","cloneState","table_getColumn"],"sources":["../../../src/features/column-grouping/columnGroupingFeature.utils.ts"],"sourcesContent":["import { cloneState, isFunction } from '../../utils'\nimport { table_getColumn } from '../../core/columns/coreColumnsFeature.utils'\nimport type { Column_Internal } from '../../types/Column'\nimport type { CellData, RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\nimport type {\n  AggregationFn,\n  GroupingState,\n  Row_ColumnGrouping,\n} from './columnGroupingFeature.types'\n\n/**\n * Returns the default grouping state.\n *\n * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.\n *\n * @example\n * ```ts\n * const initialValue = getDefaultGroupingState()\n * ```\n */\nexport function getDefaultGroupingState(): GroupingState {\n  return []\n}\n\n/**\n * Toggles grouping for a column.\n *\n * The update is applied through the owning table state slice and respects the feature options for that column.\n *\n * @example\n * ```ts\n * column_toggleGrouping(column)\n * ```\n */\nexport function column_toggleGrouping<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  table_setGrouping(column.table, (old) => {\n    // Find any existing grouping for this column\n    if (old.includes(column.id)) {\n      return old.filter((d) => d !== column.id)\n    }\n\n    return [...old, column.id]\n  })\n}\n\n/**\n * Returns whether a column can use group.\n *\n * This combines column options, table options, and any required accessor or feature state for the capability.\n *\n * @example\n * ```ts\n * const value = column_getCanGroup(column)\n * ```\n */\nexport function column_getCanGroup<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return (\n    (column.columnDef.enableGrouping ?? true) &&\n    (column.table.options.enableGrouping ?? true) &&\n    (!!column.accessorFn || !!column.columnDef.getGroupingValue)\n  )\n}\n\n/**\n * Returns is grouped for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = column_getIsGrouped(column)\n * ```\n */\nexport function column_getIsGrouped<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>): boolean {\n  return !!column.table.atoms.grouping?.get()?.includes(column.id)\n}\n\n/**\n * Returns grouped index for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = column_getGroupedIndex(column)\n * ```\n */\nexport function column_getGroupedIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>): number {\n  return column.table.atoms.grouping?.get()?.indexOf(column.id) ?? -1\n}\n\n/**\n * Returns an event handler for toggling grouping handler.\n *\n * The handler is intended for direct use in column header controls such as buttons or checkboxes.\n *\n * @example\n * ```ts\n * const value = column_getToggleGroupingHandler(column)\n * ```\n */\nexport function column_getToggleGroupingHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const canGroup = column_getCanGroup(column)\n\n  return () => {\n    if (!canGroup) return\n    column_toggleGrouping(column)\n  }\n}\n\n/**\n * Infers aggregation fn for a column.\n *\n * The inference uses the column definition, table options, and sampled row values when needed.\n *\n * @example\n * ```ts\n * const value = column_getAutoAggregationFn(column)\n * ```\n */\nexport function column_getAutoAggregationFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const aggregationFns:\n    | Record<string, AggregationFn<TFeatures, TData>>\n    | undefined = column.table._rowModelFns.aggregationFns\n\n  const firstRow = column.table.getCoreRowModel().flatRows[0]\n\n  const value = firstRow?.getValue(column.id)\n\n  if (typeof value === 'number') {\n    return aggregationFns?.sum\n  }\n\n  if (Object.prototype.toString.call(value) === '[object Date]') {\n    return aggregationFns?.extent\n  }\n}\n\n/**\n * Returns aggregation fn for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = column_getAggregationFn(column)\n * ```\n */\nexport function column_getAggregationFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const aggregationFns:\n    | Record<string, AggregationFn<TFeatures, TData>>\n    | undefined = column.table._rowModelFns.aggregationFns\n\n  return isFunction(column.columnDef.aggregationFn)\n    ? column.columnDef.aggregationFn\n    : column.columnDef.aggregationFn === 'auto'\n      ? column_getAutoAggregationFn(column)\n      : aggregationFns?.[column.columnDef.aggregationFn as string]\n}\n\n/**\n * Updates the table's grouping state slice.\n *\n * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.\n *\n * @example\n * ```ts\n * table_setGrouping(table, (old) => old)\n * ```\n */\nexport function table_setGrouping<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<GroupingState>) {\n  table.options.onGroupingChange?.(updater)\n}\n\n/**\n * Resets the table's grouping state slice.\n *\n * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.\n *\n * @example\n * ```ts\n * table_resetGrouping(table)\n * table_resetGrouping(table, true)\n * ```\n */\nexport function table_resetGrouping<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setGrouping(\n    table,\n    defaultState ? [] : cloneState(table.initialState.grouping ?? []),\n  )\n}\n\n/**\n * Returns is grouped for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getIsGrouped(row)\n * ```\n */\nexport function row_getIsGrouped<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData> & Partial<Row_ColumnGrouping>) {\n  return !!row.groupingColumnId\n}\n\n/**\n * Returns grouping value for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getGroupingValue(row)\n * ```\n */\nexport function row_getGroupingValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData> & Partial<Row_ColumnGrouping>, columnId: string) {\n  if (row._groupingValuesCache?.hasOwnProperty(columnId)) {\n    return row._groupingValuesCache[columnId]\n  }\n\n  const column = table_getColumn(row.table, columnId) as Column_Internal<\n    TFeatures,\n    TData\n  >\n\n  if (!column.columnDef.getGroupingValue) {\n    return row.getValue(columnId)\n  }\n\n  if (row._groupingValuesCache) {\n    row._groupingValuesCache[columnId] = column.columnDef.getGroupingValue(\n      row.original,\n    )\n  }\n\n  return row._groupingValuesCache?.[columnId]\n}\n\n/**\n * Returns is grouped for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_getIsGrouped(cell)\n * ```\n */\nexport function cell_getIsGrouped<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  const row = cell.row as Row<TFeatures, TData> & Partial<Row_ColumnGrouping>\n  return (\n    column_getIsGrouped(cell.column) && cell.column.id === row.groupingColumnId\n  )\n}\n\n/**\n * Returns is placeholder for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_getIsPlaceholder(cell)\n * ```\n */\nexport function cell_getIsPlaceholder<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return !cell_getIsGrouped(cell) && column_getIsGrouped(cell.column)\n}\n\n/**\n * Returns is aggregated for a cell.\n *\n * This is the static implementation behind the matching cell instance API and uses the owning row and column context.\n *\n * @example\n * ```ts\n * const value = cell_getIsAggregated(cell)\n * ```\n */\nexport function cell_getIsAggregated<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  return (\n    !cell_getIsGrouped(cell) &&\n    !cell_getIsPlaceholder(cell) &&\n    !!cell.row.subRows.length\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;AAwBA,SAAgB,0BAAyC;CACvD,OAAO,EAAE;;;;;;;;;;;;AAaX,SAAgB,sBAId,QAAmD;CACnD,kBAAkB,OAAO,QAAQ,QAAQ;EAEvC,IAAI,IAAI,SAAS,OAAO,GAAG,EACzB,OAAO,IAAI,QAAQ,MAAM,MAAM,OAAO,GAAG;EAG3C,OAAO,CAAC,GAAG,KAAK,OAAO,GAAG;GAC1B;;;;;;;;;;;;AAaJ,SAAgB,mBAId,QAAmD;CACnD,QACG,OAAO,UAAU,kBAAkB,UACnC,OAAO,MAAM,QAAQ,kBAAkB,UACvC,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,OAAO,UAAU;;;;;;;;;;;;AAc/C,SAAgB,oBAId,QAA4D;;CAC5D,OAAO,CAAC,2BAAC,OAAO,MAAM,MAAM,yGAAU,KAAK,gFAAE,SAAS,OAAO,GAAG;;;;;;;;;;;;AAalE,SAAgB,uBAId,QAA2D;;CAC3D,kCAAO,OAAO,MAAM,MAAM,4GAAU,KAAK,kFAAE,QAAQ,OAAO,GAAG,KAAI;;;;;;;;;;;;AAanE,SAAgB,gCAId,QAAmD;CACnD,MAAM,WAAW,mBAAmB,OAAO;CAE3C,aAAa;EACX,IAAI,CAAC,UAAU;EACf,sBAAsB,OAAO;;;;;;;;;;;;;AAcjC,SAAgB,4BAId,QAAmD;CACnD,MAAM,iBAEU,OAAO,MAAM,aAAa;CAE1C,MAAM,WAAW,OAAO,MAAM,iBAAiB,CAAC,SAAS;CAEzD,MAAM,4DAAQ,SAAU,SAAS,OAAO,GAAG;CAE3C,IAAI,OAAO,UAAU,UACnB,uEAAO,eAAgB;CAGzB,IAAI,OAAO,UAAU,SAAS,KAAK,MAAM,KAAK,iBAC5C,uEAAO,eAAgB;;;;;;;;;;;;AAc3B,SAAgB,wBAId,QAAmD;CACnD,MAAM,iBAEU,OAAO,MAAM,aAAa;CAE1C,OAAOA,yBAAW,OAAO,UAAU,cAAc,GAC7C,OAAO,UAAU,gBACjB,OAAO,UAAU,kBAAkB,SACjC,4BAA4B,OAAO,mEACnC,eAAiB,OAAO,UAAU;;;;;;;;;;;;AAa1C,SAAgB,kBAGd,OAAyC,SAAiC;;CAC1E,iDAAM,SAAQ,6GAAmB,QAAQ;;;;;;;;;;;;;AAc3C,SAAgB,oBAGd,OAAyC,cAAwB;CACjE,kBACE,OACA,eAAe,EAAE,GAAGC,yBAAW,MAAM,aAAa,YAAY,EAAE,CAAC,CAClE;;;;;;;;;;;;AAaH,SAAgB,iBAGd,KAA0D;CAC1D,OAAO,CAAC,CAAC,IAAI;;;;;;;;;;;;AAaf,SAAgB,qBAGd,KAA0D,UAAkB;;CAC5E,6BAAI,IAAI,oGAAsB,eAAe,SAAS,EACpD,OAAO,IAAI,qBAAqB;CAGlC,MAAM,SAASC,iDAAgB,IAAI,OAAO,SAAS;CAKnD,IAAI,CAAC,OAAO,UAAU,kBACpB,OAAO,IAAI,SAAS,SAAS;CAG/B,IAAI,IAAI,sBACN,IAAI,qBAAqB,YAAY,OAAO,UAAU,iBACpD,IAAI,SACL;CAGH,iCAAO,IAAI,sGAAuB;;;;;;;;;;;;AAapC,SAAgB,kBAId,MAAsC;CACtC,MAAM,MAAM,KAAK;CACjB,OACE,oBAAoB,KAAK,OAAO,IAAI,KAAK,OAAO,OAAO,IAAI;;;;;;;;;;;;AAc/D,SAAgB,sBAId,MAAsC;CACtC,OAAO,CAAC,kBAAkB,KAAK,IAAI,oBAAoB,KAAK,OAAO;;;;;;;;;;;;AAarE,SAAgB,qBAId,MAAsC;CACtC,OACE,CAAC,kBAAkB,KAAK,IACxB,CAAC,sBAAsB,KAAK,IAC5B,CAAC,CAAC,KAAK,IAAI,QAAQ"}