@tanstack/table-core 9.0.0-alpha.46 → 9.0.0-alpha.48

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

@@ -38,7 +38,9 @@ function _createFilteredRowModel(table) {
 	const columnFilters = (_table$atoms$columnFi2 = table.atoms.columnFilters) === null || _table$atoms$columnFi2 === void 0 ? void 0 : _table$atoms$columnFi2.get();
 	const globalFilter = (_table$atoms$globalFi2 = table.atoms.globalFilter) === null || _table$atoms$globalFi2 === void 0 ? void 0 : _table$atoms$globalFi2.get();
 	if (!rowModel.rows.length || !(columnFilters === null || columnFilters === void 0 ? void 0 : columnFilters.length) && !globalFilter) {
-		for (const row of rowModel.flatRows) {
+		const flatRows = rowModel.flatRows;
+		for (let i = 0; i < flatRows.length; i++) {
+			const row = flatRows[i];
 			row.columnFilters = {};
 			row.columnFiltersMeta = {};
 		}
@@ -71,16 +73,20 @@ function _createFilteredRowModel(table) {
 			});
 		});
 	}
-	for (const row of rowModel.flatRows) {
+	const flatRows = rowModel.flatRows;
+	for (let i = 0; i < flatRows.length; i++) {
+		const row = flatRows[i];
 		row.columnFilters = {};
-		if (resolvedColumnFilters.length) for (const currentColumnFilter of resolvedColumnFilters) {
+		if (resolvedColumnFilters.length) for (let j = 0; j < resolvedColumnFilters.length; j++) {
+			const currentColumnFilter = resolvedColumnFilters[j];
 			const id = currentColumnFilter.id;
 			row.columnFilters[id] = currentColumnFilter.filterFn(row, id, currentColumnFilter.resolvedValue, (filterMeta) => {
 				!row.columnFiltersMeta ? row.columnFiltersMeta = {} : row.columnFiltersMeta[id] = filterMeta;
 			});
 		}
 		if (resolvedGlobalFilters.length) {
-			for (const currentGlobalFilter of resolvedGlobalFilters) {
+			for (let j = 0; j < resolvedGlobalFilters.length; j++) {
+				const currentGlobalFilter = resolvedGlobalFilters[j];
 				const id = currentGlobalFilter.id;
 				if (currentGlobalFilter.filterFn(row, id, currentGlobalFilter.resolvedValue, (filterMeta) => {
 					!row.columnFiltersMeta ? row.columnFiltersMeta = {} : row.columnFiltersMeta[id] = filterMeta;
@@ -93,7 +99,7 @@ function _createFilteredRowModel(table) {
 		}
 	}
 	const filterRowsImpl = (row) => {
-		for (const columnId of filterableIds) if (row.columnFilters[columnId] === false) return false;
+		for (let i = 0; i < filterableIds.length; i++) if (row.columnFilters[filterableIds[i]] === false) return false;
 		return true;
 	};
 	return filterRows(rowModel.rows, filterRowsImpl, table);

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

@@ -1 +1 @@
-{"version":3,"file":"createFilteredRowModel.js","names":[],"sources":["../../../src/features/column-filtering/createFilteredRowModel.ts"],"sourcesContent":["import { tableMemo } from '../../utils'\nimport { table_getColumn } from '../../core/columns/coreColumnsFeature.utils'\nimport {\n  column_getCanGlobalFilter,\n  table_getGlobalFilterFn,\n} from '../global-filtering/globalFilteringFeature.utils'\nimport { table_autoResetPageIndex } from '../row-pagination/rowPaginationFeature.utils'\nimport { filterRows } from './filterRowsUtils'\nimport { column_getFilterFn } from './columnFilteringFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type {\n  FilterFn,\n  FilterFns,\n  ResolvedColumnFilter,\n  Row_ColumnFiltering,\n} from './columnFilteringFeature.types'\n\n/**\n * Creates a memoized filtered row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createFilteredRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  filterFns: Record<keyof FilterFns, FilterFn<TFeatures, TData>>,\n): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    if (!table._rowModelFns.filterFns) table._rowModelFns.filterFns = filterFns\n    return tableMemo({\n      feature: 'columnFilteringFeature',\n      table,\n      fnName: 'table.getFilteredRowModel',\n      memoDeps: () => [\n        table.getPreFilteredRowModel(),\n        table.atoms.columnFilters?.get(),\n        table.atoms.globalFilter?.get(),\n      ],\n      fn: () => _createFilteredRowModel(table),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createFilteredRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const rowModel = table.getPreFilteredRowModel()\n  const columnFilters = table.atoms.columnFilters?.get()\n  const globalFilter = table.atoms.globalFilter?.get()\n\n  if (!rowModel.rows.length || (!columnFilters?.length && !globalFilter)) {\n    for (const row of rowModel.flatRows as Array<\n      Row<TFeatures, TData> & Partial<Row_ColumnFiltering<TFeatures, TData>>\n    >) {\n      row.columnFilters = {}\n      row.columnFiltersMeta = {}\n    }\n    return rowModel\n  }\n\n  const resolvedColumnFilters: Array<ResolvedColumnFilter<TFeatures, TData>> =\n    []\n  const resolvedGlobalFilters: Array<ResolvedColumnFilter<TFeatures, TData>> =\n    []\n\n  columnFilters?.forEach((columnFilter) => {\n    const column = table_getColumn(table, columnFilter.id)\n\n    if (!column) {\n      return\n    }\n\n    const filterFn = column_getFilterFn(column)!\n\n    resolvedColumnFilters.push({\n      id: columnFilter.id,\n      filterFn,\n      resolvedValue:\n        filterFn.resolveFilterValue?.(columnFilter.value) ?? columnFilter.value,\n    })\n  })\n\n  const filterableIds = columnFilters?.map((d) => d.id) ?? []\n\n  const globalFilterFn = table_getGlobalFilterFn(table)\n\n  const globallyFilterableColumns = table\n    .getAllLeafColumns()\n    .filter((column) => column_getCanGlobalFilter(column))\n\n  if (globalFilter && globalFilterFn && globallyFilterableColumns.length) {\n    filterableIds.push('__global__')\n\n    globallyFilterableColumns.forEach((column) => {\n      resolvedGlobalFilters.push({\n        id: column.id,\n        filterFn: globalFilterFn,\n        resolvedValue:\n          globalFilterFn.resolveFilterValue?.(globalFilter) ?? globalFilter,\n      })\n    })\n  }\n\n  // Flag the pre-filtered row model with each filter state\n  for (const row of rowModel.flatRows as Array<\n    Row<TFeatures, TData> & Partial<Row_ColumnFiltering<TFeatures, TData>>\n  >) {\n    row.columnFilters = {}\n\n    if (resolvedColumnFilters.length) {\n      for (const currentColumnFilter of resolvedColumnFilters) {\n        const id = currentColumnFilter.id\n\n        // Tag the row with the column filter state\n        row.columnFilters[id] = currentColumnFilter.filterFn(\n          row,\n          id,\n          currentColumnFilter.resolvedValue,\n          (filterMeta) => {\n            !row.columnFiltersMeta\n              ? (row.columnFiltersMeta = {})\n              : (row.columnFiltersMeta[id] = filterMeta)\n          },\n        )\n      }\n    }\n\n    if (resolvedGlobalFilters.length) {\n      for (const currentGlobalFilter of resolvedGlobalFilters) {\n        const id = currentGlobalFilter.id\n        // Tag the row with the first truthy global filter state\n        if (\n          currentGlobalFilter.filterFn(\n            row,\n            id,\n            currentGlobalFilter.resolvedValue,\n            (filterMeta) => {\n              !row.columnFiltersMeta\n                ? (row.columnFiltersMeta = {})\n                : (row.columnFiltersMeta[id] = filterMeta)\n            },\n          )\n        ) {\n          row.columnFilters.__global__ = true\n          break\n        }\n      }\n\n      if (row.columnFilters.__global__ !== true) {\n        row.columnFilters.__global__ = false\n      }\n    }\n  }\n\n  const filterRowsImpl = (\n    row: Row<TFeatures, TData> & Row_ColumnFiltering<TFeatures, TData>,\n  ) => {\n    // Horizontally filter rows through each column\n    for (const columnId of filterableIds) {\n      if (row.columnFilters[columnId] === false) {\n        return false\n      }\n    }\n    return true\n  }\n\n  // Filter final rows using all of the active filters\n  return filterRows(rowModel.rows, filterRowsImpl as any, table)\n}\n"],"mappings":";;;;;;;;;;;;;AA0BA,SAAgB,uBAId,WACsE;CACtE,QAAQ,WAAW;EACjB,MAAM,QAA0C;EAChD,IAAI,CAAC,MAAM,aAAa,WAAW,MAAM,aAAa,YAAY;EAClE,OAAO,UAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;;;KACd,MAAM,wBAAwB;8BAC9B,MAAM,MAAM,6FAAe,KAAK;8BAChC,MAAM,MAAM,4FAAc,KAAK;KAChC;;GACD,UAAU,wBAAwB,MAAM;GACxC,qBAAqB,yBAAyB,MAAM;GACrD,CAAC;;;AAIN,SAAS,wBAGP,OAAqE;;CACrE,MAAM,WAAW,MAAM,wBAAwB;CAC/C,MAAM,0CAAgB,MAAM,MAAM,+FAAe,KAAK;CACtD,MAAM,yCAAe,MAAM,MAAM,8FAAc,KAAK;CAEpD,IAAI,CAAC,SAAS,KAAK,UAAW,gEAAC,cAAe,WAAU,CAAC,cAAe;EACtE,KAAK,MAAM,OAAO,SAAS,UAExB;GACD,IAAI,gBAAgB,EAAE;GACtB,IAAI,oBAAoB,EAAE;;EAE5B,OAAO;;CAGT,MAAM,wBACJ,EAAE;CACJ,MAAM,wBACJ,EAAE;CAEJ,oEAAe,SAAS,iBAAiB;;EACvC,MAAM,SAAS,gBAAgB,OAAO,aAAa,GAAG;EAEtD,IAAI,CAAC,QACH;EAGF,MAAM,WAAW,mBAAmB,OAAO;EAE3C,sBAAsB,KAAK;GACzB,IAAI,aAAa;GACjB;GACA,yCACE,SAAS,iHAAqB,aAAa,MAAM,KAAI,aAAa;GACrE,CAAC;GACF;CAEF,MAAM,+EAAgB,cAAe,KAAK,MAAM,EAAE,GAAG,KAAI,EAAE;CAE3D,MAAM,iBAAiB,wBAAwB,MAAM;CAErD,MAAM,4BAA4B,MAC/B,mBAAmB,CACnB,QAAQ,WAAW,0BAA0B,OAAO,CAAC;CAExD,IAAI,gBAAgB,kBAAkB,0BAA0B,QAAQ;EACtE,cAAc,KAAK,aAAa;EAEhC,0BAA0B,SAAS,WAAW;;GAC5C,sBAAsB,KAAK;IACzB,IAAI,OAAO;IACX,UAAU;IACV,yCACE,eAAe,uHAAqB,aAAa,KAAI;IACxD,CAAC;IACF;;CAIJ,KAAK,MAAM,OAAO,SAAS,UAExB;EACD,IAAI,gBAAgB,EAAE;EAEtB,IAAI,sBAAsB,QACxB,KAAK,MAAM,uBAAuB,uBAAuB;GACvD,MAAM,KAAK,oBAAoB;GAG/B,IAAI,cAAc,MAAM,oBAAoB,SAC1C,KACA,IACA,oBAAoB,gBACnB,eAAe;IACd,CAAC,IAAI,oBACA,IAAI,oBAAoB,EAAE,GAC1B,IAAI,kBAAkB,MAAM;KAEpC;;EAIL,IAAI,sBAAsB,QAAQ;GAChC,KAAK,MAAM,uBAAuB,uBAAuB;IACvD,MAAM,KAAK,oBAAoB;IAE/B,IACE,oBAAoB,SAClB,KACA,IACA,oBAAoB,gBACnB,eAAe;KACd,CAAC,IAAI,oBACA,IAAI,oBAAoB,EAAE,GAC1B,IAAI,kBAAkB,MAAM;MAEpC,EACD;KACA,IAAI,cAAc,aAAa;KAC/B;;;GAIJ,IAAI,IAAI,cAAc,eAAe,MACnC,IAAI,cAAc,aAAa;;;CAKrC,MAAM,kBACJ,QACG;EAEH,KAAK,MAAM,YAAY,eACrB,IAAI,IAAI,cAAc,cAAc,OAClC,OAAO;EAGX,OAAO;;CAIT,OAAO,WAAW,SAAS,MAAM,gBAAuB,MAAM"}
+{"version":3,"file":"createFilteredRowModel.js","names":[],"sources":["../../../src/features/column-filtering/createFilteredRowModel.ts"],"sourcesContent":["import { tableMemo } from '../../utils'\nimport { table_getColumn } from '../../core/columns/coreColumnsFeature.utils'\nimport {\n  column_getCanGlobalFilter,\n  table_getGlobalFilterFn,\n} from '../global-filtering/globalFilteringFeature.utils'\nimport { table_autoResetPageIndex } from '../row-pagination/rowPaginationFeature.utils'\nimport { filterRows } from './filterRowsUtils'\nimport { column_getFilterFn } from './columnFilteringFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type {\n  FilterFn,\n  FilterFns,\n  ResolvedColumnFilter,\n  Row_ColumnFiltering,\n} from './columnFilteringFeature.types'\n\n/**\n * Creates a memoized filtered row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createFilteredRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  filterFns: Record<keyof FilterFns, FilterFn<TFeatures, TData>>,\n): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    if (!table._rowModelFns.filterFns) table._rowModelFns.filterFns = filterFns\n    return tableMemo({\n      feature: 'columnFilteringFeature',\n      table,\n      fnName: 'table.getFilteredRowModel',\n      memoDeps: () => [\n        table.getPreFilteredRowModel(),\n        table.atoms.columnFilters?.get(),\n        table.atoms.globalFilter?.get(),\n      ],\n      fn: () => _createFilteredRowModel(table),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createFilteredRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const rowModel = table.getPreFilteredRowModel()\n  const columnFilters = table.atoms.columnFilters?.get()\n  const globalFilter = table.atoms.globalFilter?.get()\n\n  if (!rowModel.rows.length || (!columnFilters?.length && !globalFilter)) {\n    const flatRows = rowModel.flatRows as Array<\n      Row<TFeatures, TData> & Partial<Row_ColumnFiltering<TFeatures, TData>>\n    >\n    for (let i = 0; i < flatRows.length; i++) {\n      const row = flatRows[i]!\n      row.columnFilters = {}\n      row.columnFiltersMeta = {}\n    }\n    return rowModel\n  }\n\n  const resolvedColumnFilters: Array<ResolvedColumnFilter<TFeatures, TData>> =\n    []\n  const resolvedGlobalFilters: Array<ResolvedColumnFilter<TFeatures, TData>> =\n    []\n\n  columnFilters?.forEach((columnFilter) => {\n    const column = table_getColumn(table, columnFilter.id)\n\n    if (!column) {\n      return\n    }\n\n    const filterFn = column_getFilterFn(column)!\n\n    resolvedColumnFilters.push({\n      id: columnFilter.id,\n      filterFn,\n      resolvedValue:\n        filterFn.resolveFilterValue?.(columnFilter.value) ?? columnFilter.value,\n    })\n  })\n\n  const filterableIds = columnFilters?.map((d) => d.id) ?? []\n\n  const globalFilterFn = table_getGlobalFilterFn(table)\n\n  const globallyFilterableColumns = table\n    .getAllLeafColumns()\n    .filter((column) => column_getCanGlobalFilter(column))\n\n  if (globalFilter && globalFilterFn && globallyFilterableColumns.length) {\n    filterableIds.push('__global__')\n\n    globallyFilterableColumns.forEach((column) => {\n      resolvedGlobalFilters.push({\n        id: column.id,\n        filterFn: globalFilterFn,\n        resolvedValue:\n          globalFilterFn.resolveFilterValue?.(globalFilter) ?? globalFilter,\n      })\n    })\n  }\n\n  // Flag the pre-filtered row model with each filter state\n  const flatRows = rowModel.flatRows as Array<\n    Row<TFeatures, TData> & Partial<Row_ColumnFiltering<TFeatures, TData>>\n  >\n  for (let i = 0; i < flatRows.length; i++) {\n    const row = flatRows[i]!\n    row.columnFilters = {}\n\n    if (resolvedColumnFilters.length) {\n      for (let j = 0; j < resolvedColumnFilters.length; j++) {\n        const currentColumnFilter = resolvedColumnFilters[j]!\n        const id = currentColumnFilter.id\n\n        // Tag the row with the column filter state\n        row.columnFilters[id] = currentColumnFilter.filterFn(\n          row,\n          id,\n          currentColumnFilter.resolvedValue,\n          (filterMeta) => {\n            !row.columnFiltersMeta\n              ? (row.columnFiltersMeta = {})\n              : (row.columnFiltersMeta[id] = filterMeta)\n          },\n        )\n      }\n    }\n\n    if (resolvedGlobalFilters.length) {\n      for (let j = 0; j < resolvedGlobalFilters.length; j++) {\n        const currentGlobalFilter = resolvedGlobalFilters[j]!\n        const id = currentGlobalFilter.id\n        // Tag the row with the first truthy global filter state\n        if (\n          currentGlobalFilter.filterFn(\n            row,\n            id,\n            currentGlobalFilter.resolvedValue,\n            (filterMeta) => {\n              !row.columnFiltersMeta\n                ? (row.columnFiltersMeta = {})\n                : (row.columnFiltersMeta[id] = filterMeta)\n            },\n          )\n        ) {\n          row.columnFilters.__global__ = true\n          break\n        }\n      }\n\n      if (row.columnFilters.__global__ !== true) {\n        row.columnFilters.__global__ = false\n      }\n    }\n  }\n\n  const filterRowsImpl = (\n    row: Row<TFeatures, TData> & Row_ColumnFiltering<TFeatures, TData>,\n  ) => {\n    // Horizontally filter rows through each column\n    for (let i = 0; i < filterableIds.length; i++) {\n      if (row.columnFilters[filterableIds[i]!] === false) {\n        return false\n      }\n    }\n    return true\n  }\n\n  // Filter final rows using all of the active filters\n  return filterRows(rowModel.rows, filterRowsImpl as any, table)\n}\n"],"mappings":";;;;;;;;;;;;;AA0BA,SAAgB,uBAId,WACsE;CACtE,QAAQ,WAAW;EACjB,MAAM,QAA0C;EAChD,IAAI,CAAC,MAAM,aAAa,WAAW,MAAM,aAAa,YAAY;EAClE,OAAO,UAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;;;KACd,MAAM,wBAAwB;8BAC9B,MAAM,MAAM,6FAAe,KAAK;8BAChC,MAAM,MAAM,4FAAc,KAAK;KAChC;;GACD,UAAU,wBAAwB,MAAM;GACxC,qBAAqB,yBAAyB,MAAM;GACrD,CAAC;;;AAIN,SAAS,wBAGP,OAAqE;;CACrE,MAAM,WAAW,MAAM,wBAAwB;CAC/C,MAAM,0CAAgB,MAAM,MAAM,+FAAe,KAAK;CACtD,MAAM,yCAAe,MAAM,MAAM,8FAAc,KAAK;CAEpD,IAAI,CAAC,SAAS,KAAK,UAAW,gEAAC,cAAe,WAAU,CAAC,cAAe;EACtE,MAAM,WAAW,SAAS;EAG1B,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;GACxC,MAAM,MAAM,SAAS;GACrB,IAAI,gBAAgB,EAAE;GACtB,IAAI,oBAAoB,EAAE;;EAE5B,OAAO;;CAGT,MAAM,wBACJ,EAAE;CACJ,MAAM,wBACJ,EAAE;CAEJ,oEAAe,SAAS,iBAAiB;;EACvC,MAAM,SAAS,gBAAgB,OAAO,aAAa,GAAG;EAEtD,IAAI,CAAC,QACH;EAGF,MAAM,WAAW,mBAAmB,OAAO;EAE3C,sBAAsB,KAAK;GACzB,IAAI,aAAa;GACjB;GACA,yCACE,SAAS,iHAAqB,aAAa,MAAM,KAAI,aAAa;GACrE,CAAC;GACF;CAEF,MAAM,+EAAgB,cAAe,KAAK,MAAM,EAAE,GAAG,KAAI,EAAE;CAE3D,MAAM,iBAAiB,wBAAwB,MAAM;CAErD,MAAM,4BAA4B,MAC/B,mBAAmB,CACnB,QAAQ,WAAW,0BAA0B,OAAO,CAAC;CAExD,IAAI,gBAAgB,kBAAkB,0BAA0B,QAAQ;EACtE,cAAc,KAAK,aAAa;EAEhC,0BAA0B,SAAS,WAAW;;GAC5C,sBAAsB,KAAK;IACzB,IAAI,OAAO;IACX,UAAU;IACV,yCACE,eAAe,uHAAqB,aAAa,KAAI;IACxD,CAAC;IACF;;CAIJ,MAAM,WAAW,SAAS;CAG1B,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,MAAM,SAAS;EACrB,IAAI,gBAAgB,EAAE;EAEtB,IAAI,sBAAsB,QACxB,KAAK,IAAI,IAAI,GAAG,IAAI,sBAAsB,QAAQ,KAAK;GACrD,MAAM,sBAAsB,sBAAsB;GAClD,MAAM,KAAK,oBAAoB;GAG/B,IAAI,cAAc,MAAM,oBAAoB,SAC1C,KACA,IACA,oBAAoB,gBACnB,eAAe;IACd,CAAC,IAAI,oBACA,IAAI,oBAAoB,EAAE,GAC1B,IAAI,kBAAkB,MAAM;KAEpC;;EAIL,IAAI,sBAAsB,QAAQ;GAChC,KAAK,IAAI,IAAI,GAAG,IAAI,sBAAsB,QAAQ,KAAK;IACrD,MAAM,sBAAsB,sBAAsB;IAClD,MAAM,KAAK,oBAAoB;IAE/B,IACE,oBAAoB,SAClB,KACA,IACA,oBAAoB,gBACnB,eAAe;KACd,CAAC,IAAI,oBACA,IAAI,oBAAoB,EAAE,GAC1B,IAAI,kBAAkB,MAAM;MAEpC,EACD;KACA,IAAI,cAAc,aAAa;KAC/B;;;GAIJ,IAAI,IAAI,cAAc,eAAe,MACnC,IAAI,cAAc,aAAa;;;CAKrC,MAAM,kBACJ,QACG;EAEH,KAAK,IAAI,IAAI,GAAG,IAAI,cAAc,QAAQ,KACxC,IAAI,IAAI,cAAc,cAAc,QAAS,OAC3C,OAAO;EAGX,OAAO;;CAIT,OAAO,WAAW,SAAS,MAAM,gBAAuB,MAAM"}

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

@@ -29,7 +29,9 @@ interface ColumnDef_ColumnGrouping<TFeatures extends TableFeatures, TData extend
    */
   aggregationFn?: AggregationFnOption<TFeatures, TData>;
   /**
-   * Enables/disables grouping for this column.
+   * Allows this column to be added to grouping state.
+   *
+   * Defaults to `true`; table-level `enableGrouping` must also allow grouping.
    */
   enableGrouping?: boolean;
   /**
@@ -47,15 +49,15 @@ interface Column_ColumnGrouping<TFeatures extends TableFeatures, TData extends R
    */
   getAutoAggregationFn: () => AggregationFn<TFeatures, TData> | undefined;
   /**
-   * Returns whether or not the column can be grouped.
+   * Checks whether this column can currently be grouped.
    */
   getCanGroup: () => boolean;
   /**
-   * Returns the index of the column in the grouping state.
+   * Finds this column's position in the ordered grouping state.
    */
   getGroupedIndex: () => number;
   /**
-   * Returns whether or not the column is currently grouped.
+   * Checks whether this column id is present in grouping state.
    */
   getIsGrouped: () => boolean;
   /**
@@ -70,11 +72,11 @@ interface Column_ColumnGrouping<TFeatures extends TableFeatures, TData extends R
 interface Row_ColumnGrouping {
   _groupingValuesCache: Record<string, any>;
   /**
-   * Returns the grouping value for any row and column (including leaf rows).
+   * Reads the value used to group this row for a column id.
    */
   getGroupingValue: (columnId: string) => unknown;
   /**
-   * Returns whether or not the row is currently grouped.
+   * Checks whether this row represents a grouped row.
    */
   getIsGrouped: () => boolean;
   /**
@@ -88,15 +90,15 @@ interface Row_ColumnGrouping {
 }
 interface Cell_ColumnGrouping {
   /**
-   * Returns whether or not the cell is currently aggregated.
+   * Checks whether this cell should render an aggregated value.
    */
   getIsAggregated: () => boolean;
   /**
-   * Returns whether or not the cell is currently grouped.
+   * Checks whether this cell represents the active grouping column.
    */
   getIsGrouped: () => boolean;
   /**
-   * Returns whether or not the cell is currently a placeholder cell.
+   * Checks whether this cell is hidden as a grouping placeholder.
    */
   getIsPlaceholder: () => boolean;
 }
@@ -106,7 +108,7 @@ interface ColumnDefaultOptions {
 }
 interface TableOptions_ColumnGrouping {
   /**
-   * Enables/disables grouping for the table.
+   * Allows columns to be grouped for this table.
    */
   enableGrouping?: boolean;
   /**
@@ -127,21 +129,23 @@ interface TableOptions_ColumnGrouping {
 type GroupingColumnMode = false | 'reorder' | 'remove';
 interface Table_ColumnGrouping<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Resets the **grouping** state to `initialState.grouping`, or `true` can be passed to force a default blank state reset to `[]`.
+   * Resets `grouping` to `initialState.grouping`.
+   *
+   * Pass `true` to ignore initial state and reset to `[]`.
    */
   resetGrouping: (defaultState?: boolean) => void;
   /**
-   * Sets grouping state using a value or updater.
+   * Updates grouping state with a next ordered id array or updater function.
    */
   setGrouping: (updater: Updater<GroupingState>) => void;
 }
 interface Table_RowModels_Grouped<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Returns the row model for the table after grouping has been applied.
+   * Resolves the row model after grouping and aggregation have been applied.
    */
   getGroupedRowModel: () => RowModel<TFeatures, TData>;
   /**
-   * Returns the row model for the table before any grouping has been applied.
+   * Reads the row model immediately before grouping.
    */
   getPreGroupedRowModel: () => RowModel<TFeatures, TData>;
 }

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

@@ -29,7 +29,9 @@ interface ColumnDef_ColumnGrouping<TFeatures extends TableFeatures, TData extend
    */
   aggregationFn?: AggregationFnOption<TFeatures, TData>;
   /**
-   * Enables/disables grouping for this column.
+   * Allows this column to be added to grouping state.
+   *
+   * Defaults to `true`; table-level `enableGrouping` must also allow grouping.
    */
   enableGrouping?: boolean;
   /**
@@ -47,15 +49,15 @@ interface Column_ColumnGrouping<TFeatures extends TableFeatures, TData extends R
    */
   getAutoAggregationFn: () => AggregationFn<TFeatures, TData> | undefined;
   /**
-   * Returns whether or not the column can be grouped.
+   * Checks whether this column can currently be grouped.
    */
   getCanGroup: () => boolean;
   /**
-   * Returns the index of the column in the grouping state.
+   * Finds this column's position in the ordered grouping state.
    */
   getGroupedIndex: () => number;
   /**
-   * Returns whether or not the column is currently grouped.
+   * Checks whether this column id is present in grouping state.
    */
   getIsGrouped: () => boolean;
   /**
@@ -70,11 +72,11 @@ interface Column_ColumnGrouping<TFeatures extends TableFeatures, TData extends R
 interface Row_ColumnGrouping {
   _groupingValuesCache: Record<string, any>;
   /**
-   * Returns the grouping value for any row and column (including leaf rows).
+   * Reads the value used to group this row for a column id.
    */
   getGroupingValue: (columnId: string) => unknown;
   /**
-   * Returns whether or not the row is currently grouped.
+   * Checks whether this row represents a grouped row.
    */
   getIsGrouped: () => boolean;
   /**
@@ -88,15 +90,15 @@ interface Row_ColumnGrouping {
 }
 interface Cell_ColumnGrouping {
   /**
-   * Returns whether or not the cell is currently aggregated.
+   * Checks whether this cell should render an aggregated value.
    */
   getIsAggregated: () => boolean;
   /**
-   * Returns whether or not the cell is currently grouped.
+   * Checks whether this cell represents the active grouping column.
    */
   getIsGrouped: () => boolean;
   /**
-   * Returns whether or not the cell is currently a placeholder cell.
+   * Checks whether this cell is hidden as a grouping placeholder.
    */
   getIsPlaceholder: () => boolean;
 }
@@ -106,7 +108,7 @@ interface ColumnDefaultOptions {
 }
 interface TableOptions_ColumnGrouping {
   /**
-   * Enables/disables grouping for the table.
+   * Allows columns to be grouped for this table.
    */
   enableGrouping?: boolean;
   /**
@@ -127,21 +129,23 @@ interface TableOptions_ColumnGrouping {
 type GroupingColumnMode = false | 'reorder' | 'remove';
 interface Table_ColumnGrouping<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Resets the **grouping** state to `initialState.grouping`, or `true` can be passed to force a default blank state reset to `[]`.
+   * Resets `grouping` to `initialState.grouping`.
+   *
+   * Pass `true` to ignore initial state and reset to `[]`.
    */
   resetGrouping: (defaultState?: boolean) => void;
   /**
-   * Sets grouping state using a value or updater.
+   * Updates grouping state with a next ordered id array or updater function.
    */
   setGrouping: (updater: Updater<GroupingState>) => void;
 }
 interface Table_RowModels_Grouped<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Returns the row model for the table after grouping has been applied.
+   * Resolves the row model after grouping and aggregation have been applied.
    */
   getGroupedRowModel: () => RowModel<TFeatures, TData>;
   /**
-   * Returns the row model for the table before any grouping has been applied.
+   * Reads the row model immediately before grouping.
    */
   getPreGroupedRowModel: () => RowModel<TFeatures, TData>;
 }

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

@@ -3,22 +3,24 @@ const require_coreColumnsFeature_utils = require('../../core/columns/coreColumns
 
 //#region src/features/column-grouping/columnGroupingFeature.utils.ts
 /**
-* Returns the default grouping state.
+* Creates the default grouping state.
 *
-* Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+* The feature default is an empty array, meaning no columns are grouped. Reset
+* APIs use this value when `defaultState` is `true`.
 *
 * @example
 * ```ts
-* const initialValue = getDefaultGroupingState()
+* const grouping = getDefaultGroupingState()
 * ```
 */
 function getDefaultGroupingState() {
 	return [];
 }
 /**
-* Toggles grouping for a column.
+* Adds or removes this column id from the grouping state.
 *
-* The update is applied through the owning table state slice and respects the feature options for that column.
+* Existing grouped columns keep their order. A column already present in
+* `state.grouping` is removed; otherwise it is appended.
 *
 * @example
 * ```ts
@@ -32,26 +34,28 @@ function column_toggleGrouping(column) {
 	});
 }
 /**
-* Returns whether a column can use group.
+* Checks whether this column can be used for grouping.
 *
-* This combines column options, table options, and any required accessor or feature state for the capability.
+* Grouping must be enabled at the column and table level, and the column must
+* either have an accessor or provide `getGroupingValue`.
 *
 * @example
 * ```ts
-* const value = column_getCanGroup(column)
+* const canGroup = 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.
+* Checks whether this column id is present in `state.grouping`.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* The result only reflects grouping state, not whether the grouped row model has
+* been calculated yet.
 *
 * @example
 * ```ts
-* const value = column_getIsGrouped(column)
+* const isGrouped = column_getIsGrouped(column)
 * ```
 */
 function column_getIsGrouped(column) {
@@ -59,13 +63,13 @@ function column_getIsGrouped(column) {
 	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.
+* Finds this column's position in the ordered grouping state.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* The result is `-1` when the column is not grouped.
 *
 * @example
 * ```ts
-* const value = column_getGroupedIndex(column)
+* const index = column_getGroupedIndex(column)
 * ```
 */
 function column_getGroupedIndex(column) {
@@ -73,13 +77,13 @@ function column_getGroupedIndex(column) {
 	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.
+* Creates a header/control handler that toggles grouping for this column.
 *
-* The handler is intended for direct use in column header controls such as buttons or checkboxes.
+* The handler is a no-op when `column_getCanGroup(column)` is false.
 *
 * @example
 * ```ts
-* const value = column_getToggleGroupingHandler(column)
+* const onClick = column_getToggleGroupingHandler(column)
 * ```
 */
 function column_getToggleGroupingHandler(column) {
@@ -90,13 +94,14 @@ function column_getToggleGroupingHandler(column) {
 	};
 }
 /**
-* Infers aggregation fn for a column.
+* Chooses a built-in aggregation function from the first core row value.
 *
-* The inference uses the column definition, table options, and sampled row values when needed.
+* Numeric columns default to `sum`, date-like values default to `extent`, and
+* other value types leave aggregation unspecified.
 *
 * @example
 * ```ts
-* const value = column_getAutoAggregationFn(column)
+* const aggregationFn = column_getAutoAggregationFn(column)
 * ```
 */
 function column_getAutoAggregationFn(column) {
@@ -107,13 +112,15 @@ function column_getAutoAggregationFn(column) {
 	if (Object.prototype.toString.call(value) === "[object Date]") return aggregationFns === null || aggregationFns === void 0 ? void 0 : aggregationFns.extent;
 }
 /**
-* Returns aggregation fn for a column.
+* Resolves the aggregation function configured for a column.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* Function-valued `columnDef.aggregationFn` is returned directly, `'auto'`
+* delegates to `column_getAutoAggregationFn`, and string values are looked up in
+* the table's aggregation function registry.
 *
 * @example
 * ```ts
-* const value = column_getAggregationFn(column)
+* const aggregationFn = column_getAggregationFn(column)
 * ```
 */
 function column_getAggregationFn(column) {
@@ -121,13 +128,14 @@ function column_getAggregationFn(column) {
 	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.
+* Routes a grouping updater through the table's grouping change handler.
 *
-* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+* The updater may be a next `GroupingState` array or a function of the previous
+* grouping state, matching the instance `table.setGrouping` behavior.
 *
 * @example
 * ```ts
-* table_setGrouping(table, (old) => old)
+* table_setGrouping(table, (old) => [...old, 'status'])
 * ```
 */
 function table_setGrouping(table, updater) {
@@ -135,9 +143,10 @@ function table_setGrouping(table, updater) {
 	(_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.
+* Resets `grouping` to the configured initial state or feature default.
 *
-* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+* With no argument, the reset clones `table.initialState.grouping` when it
+* exists. Passing `true` ignores initial state and resets to `[]`.
 *
 * @example
 * ```ts
@@ -149,26 +158,27 @@ function table_resetGrouping(table, defaultState) {
 	table_setGrouping(table, defaultState ? [] : require_utils.cloneState(table.initialState.grouping ?? []));
 }
 /**
-* Returns is grouped for a row.
+* Checks whether this row was created as a grouped row.
 *
-* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+* Grouped rows carry a `groupingColumnId`; ordinary leaf rows do not.
 *
 * @example
 * ```ts
-* const value = row_getIsGrouped(row)
+* const isGrouped = row_getIsGrouped(row)
 * ```
 */
 function row_getIsGrouped(row) {
 	return !!row.groupingColumnId;
 }
 /**
-* Returns grouping value for a row.
+* Reads and caches this row's grouping value for a column.
 *
-* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+* `columnDef.getGroupingValue` wins when provided; otherwise the normal row
+* accessor value is used.
 *
 * @example
 * ```ts
-* const value = row_getGroupingValue(row)
+* const groupValue = row_getGroupingValue(row, 'status')
 * ```
 */
 function row_getGroupingValue(row, columnId) {
@@ -180,13 +190,13 @@ function row_getGroupingValue(row, columnId) {
 	return (_row$_groupingValuesC2 = row._groupingValuesCache) === null || _row$_groupingValuesC2 === void 0 ? void 0 : _row$_groupingValuesC2[columnId];
 }
 /**
-* Returns is grouped for a cell.
+* Checks whether this cell represents the grouped column for a grouped row.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* This is the cell that usually renders the grouped value and expansion control.
 *
 * @example
 * ```ts
-* const value = cell_getIsGrouped(cell)
+* const isGroupedCell = cell_getIsGrouped(cell)
 * ```
 */
 function cell_getIsGrouped(cell) {
@@ -194,26 +204,28 @@ function cell_getIsGrouped(cell) {
 	return column_getIsGrouped(cell.column) && cell.column.id === row.groupingColumnId;
 }
 /**
-* Returns is placeholder for a cell.
+* Checks whether this cell is a placeholder hidden by grouping.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* Placeholder cells belong to grouped columns other than the row's active
+* grouping column.
 *
 * @example
 * ```ts
-* const value = cell_getIsPlaceholder(cell)
+* const isPlaceholder = cell_getIsPlaceholder(cell)
 * ```
 */
 function cell_getIsPlaceholder(cell) {
 	return !cell_getIsGrouped(cell) && column_getIsGrouped(cell.column);
 }
 /**
-* Returns is aggregated for a cell.
+* Checks whether this cell should render an aggregated value.
 *
-* This is the static implementation behind the matching cell instance API and uses the owning row and column context.
+* Aggregated cells are non-placeholder, non-grouped cells on rows that have
+* subRows.
 *
 * @example
 * ```ts
-* const value = cell_getIsAggregated(cell)
+* const isAggregated = cell_getIsAggregated(cell)
 * ```
 */
 function cell_getIsAggregated(cell) {

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\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"}
+{"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 * Creates the default grouping state.\n *\n * The feature default is an empty array, meaning no columns are grouped. Reset\n * APIs use this value when `defaultState` is `true`.\n *\n * @example\n * ```ts\n * const grouping = getDefaultGroupingState()\n * ```\n */\nexport function getDefaultGroupingState(): GroupingState {\n  return []\n}\n\n/**\n * Adds or removes this column id from the grouping state.\n *\n * Existing grouped columns keep their order. A column already present in\n * `state.grouping` is removed; otherwise it is appended.\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 * Checks whether this column can be used for grouping.\n *\n * Grouping must be enabled at the column and table level, and the column must\n * either have an accessor or provide `getGroupingValue`.\n *\n * @example\n * ```ts\n * const canGroup = 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 * Checks whether this column id is present in `state.grouping`.\n *\n * The result only reflects grouping state, not whether the grouped row model has\n * been calculated yet.\n *\n * @example\n * ```ts\n * const isGrouped = 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 * Finds this column's position in the ordered grouping state.\n *\n * The result is `-1` when the column is not grouped.\n *\n * @example\n * ```ts\n * const index = 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 * Creates a header/control handler that toggles grouping for this column.\n *\n * The handler is a no-op when `column_getCanGroup(column)` is false.\n *\n * @example\n * ```ts\n * const onClick = 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 * Chooses a built-in aggregation function from the first core row value.\n *\n * Numeric columns default to `sum`, date-like values default to `extent`, and\n * other value types leave aggregation unspecified.\n *\n * @example\n * ```ts\n * const aggregationFn = 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 * Resolves the aggregation function configured for a column.\n *\n * Function-valued `columnDef.aggregationFn` is returned directly, `'auto'`\n * delegates to `column_getAutoAggregationFn`, and string values are looked up in\n * the table's aggregation function registry.\n *\n * @example\n * ```ts\n * const aggregationFn = 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 * Routes a grouping updater through the table's grouping change handler.\n *\n * The updater may be a next `GroupingState` array or a function of the previous\n * grouping state, matching the instance `table.setGrouping` behavior.\n *\n * @example\n * ```ts\n * table_setGrouping(table, (old) => [...old, 'status'])\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 `grouping` to the configured initial state or feature default.\n *\n * With no argument, the reset clones `table.initialState.grouping` when it\n * exists. Passing `true` ignores initial state and resets to `[]`.\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 * Checks whether this row was created as a grouped row.\n *\n * Grouped rows carry a `groupingColumnId`; ordinary leaf rows do not.\n *\n * @example\n * ```ts\n * const isGrouped = 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 * Reads and caches this row's grouping value for a column.\n *\n * `columnDef.getGroupingValue` wins when provided; otherwise the normal row\n * accessor value is used.\n *\n * @example\n * ```ts\n * const groupValue = row_getGroupingValue(row, 'status')\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 * Checks whether this cell represents the grouped column for a grouped row.\n *\n * This is the cell that usually renders the grouped value and expansion control.\n *\n * @example\n * ```ts\n * const isGroupedCell = 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 * Checks whether this cell is a placeholder hidden by grouping.\n *\n * Placeholder cells belong to grouped columns other than the row's active\n * grouping column.\n *\n * @example\n * ```ts\n * const isPlaceholder = 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 * Checks whether this cell should render an aggregated value.\n *\n * Aggregated cells are non-placeholder, non-grouped cells on rows that have\n * subRows.\n *\n * @example\n * ```ts\n * const isAggregated = 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":";;;;;;;;;;;;;;;AAyBA,SAAgB,0BAAyC;CACvD,OAAO,EAAE;;;;;;;;;;;;;AAcX,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;;;;;;;;;;;;;AAcJ,SAAgB,mBAId,QAAmD;CACnD,QACG,OAAO,UAAU,kBAAkB,UACnC,OAAO,MAAM,QAAQ,kBAAkB,UACvC,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,OAAO,UAAU;;;;;;;;;;;;;AAe/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;;;;;;;;;;;;;;AAejC,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;;;;;;;;;;;;;;AAgB3B,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;;;;;;;;;;;;;AAc1C,SAAgB,kBAGd,OAAyC,SAAiC;;CAC1E,iDAAM,SAAQ,6GAAmB,QAAQ;;;;;;;;;;;;;;AAe3C,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;;;;;;;;;;;;;AAcf,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;;;;;;;;;;;;;AAe/D,SAAgB,sBAId,MAAsC;CACtC,OAAO,CAAC,kBAAkB,KAAK,IAAI,oBAAoB,KAAK,OAAO;;;;;;;;;;;;;AAcrE,SAAgB,qBAId,MAAsC;CACtC,OACE,CAAC,kBAAkB,KAAK,IACxB,CAAC,sBAAsB,KAAK,IAC5B,CAAC,CAAC,KAAK,IAAI,QAAQ"}