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

package/dist/core/headers/coreHeadersFeature.js

@@ -1,8 +1,12 @@
-import { assignPrototypeAPIs, assignTableAPIs, callMemoOrStaticFn } from "../../utils.js";
-import { table_getCenterHeaderGroups, table_getLeftHeaderGroups, table_getRightHeaderGroups } from "../../features/column-pinning/columnPinningFeature.utils.js";
+import { assignPrototypeAPIs, assignTableAPIs } from "../../utils.js";
 import { header_getContext, header_getLeafHeaders, table_getFlatHeaders, table_getFooterGroups, table_getHeaderGroups, table_getLeafHeaders } from "./coreHeadersFeature.utils.js";
 
 //#region src/core/headers/coreHeadersFeature.ts
+/**
+* Creates the stock core headers feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
 function constructCoreHeadersFeature() {
 	return {
 		assignHeaderPrototype: (prototype, table) => {
@@ -43,11 +47,7 @@ function constructCoreHeadersFeature() {
 				},
 				table_getLeafHeaders: {
 					fn: () => table_getLeafHeaders(table),
-					memoDeps: () => [
-						callMemoOrStaticFn(table, "getLeftHeaderGroups", table_getLeftHeaderGroups),
-						callMemoOrStaticFn(table, "getCenterHeaderGroups", table_getCenterHeaderGroups),
-						callMemoOrStaticFn(table, "getRightHeaderGroups", table_getRightHeaderGroups)
-					]
+					memoDeps: () => [table.getHeaderGroups()]
 				}
 			});
 		}

package/dist/core/headers/coreHeadersFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreHeadersFeature.js","names":[],"sources":["../../../src/core/headers/coreHeadersFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  callMemoOrStaticFn,\n} from '../../utils'\nimport {\n  table_getCenterHeaderGroups,\n  table_getLeftHeaderGroups,\n  table_getRightHeaderGroups,\n} from '../../features/column-pinning/columnPinningFeature.utils'\nimport {\n  header_getContext,\n  header_getLeafHeaders,\n  table_getFlatHeaders,\n  table_getFooterGroups,\n  table_getHeaderGroups,\n  table_getLeafHeaders,\n} from './coreHeadersFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type { Header_Header, Table_Headers } from './coreHeadersFeature.types'\n\nexport interface CoreHeadersFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Header: Header_Header<TFeatures, TData>\n  // Table: Table_Headers<TFeatures, TData>\n}\n\nexport function constructCoreHeadersFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<CoreHeadersFeatureConstructors<TFeatures, TData>> {\n  return {\n    assignHeaderPrototype: (prototype, table) => {\n      assignPrototypeAPIs('coreHeadersFeature', prototype, table, {\n        header_getLeafHeaders: {\n          fn: (header) => header_getLeafHeaders(header),\n          memoDeps: (header) => [header.column.table.options.columns],\n        },\n        header_getContext: {\n          fn: (header) => header_getContext(header),\n          memoDeps: (header) => [header.column.table.options.columns],\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('coreHeadersFeature', table, {\n        table_getHeaderGroups: {\n          fn: () => table_getHeaderGroups(table),\n          memoDeps: () => [\n            table.options.columns,\n            table.atoms.columnOrder?.get(),\n            table.atoms.grouping?.get(),\n            table.atoms.columnPinning?.get(),\n            table.atoms.columnVisibility?.get(),\n            table.options.groupedColumnMode,\n          ],\n        },\n        table_getFooterGroups: {\n          fn: () => table_getFooterGroups(table),\n          memoDeps: () => [table.getHeaderGroups()],\n        },\n        table_getFlatHeaders: {\n          fn: () => table_getFlatHeaders(table),\n          memoDeps: () => [table.getHeaderGroups()],\n        },\n        table_getLeafHeaders: {\n          fn: () => table_getLeafHeaders(table),\n          memoDeps: () => [\n            callMemoOrStaticFn(\n              table,\n              'getLeftHeaderGroups',\n              table_getLeftHeaderGroups,\n            ),\n            callMemoOrStaticFn(\n              table,\n              'getCenterHeaderGroups',\n              table_getCenterHeaderGroups,\n            ),\n            callMemoOrStaticFn(\n              table,\n              'getRightHeaderGroups',\n              table_getRightHeaderGroups,\n            ),\n          ],\n        },\n      })\n    },\n  }\n}\n\n/**\n * The Core Headers feature provides the core header functionality.\n */\nexport const coreHeadersFeature = constructCoreHeadersFeature()\n"],"mappings":";;;;;AA8BA,SAAgB,8BAGoD;AAClE,QAAO;EACL,wBAAwB,WAAW,UAAU;AAC3C,uBAAoB,sBAAsB,WAAW,OAAO;IAC1D,uBAAuB;KACrB,KAAK,WAAW,sBAAsB,OAAO;KAC7C,WAAW,WAAW,CAAC,OAAO,OAAO,MAAM,QAAQ,QAAQ;KAC5D;IACD,mBAAmB;KACjB,KAAK,WAAW,kBAAkB,OAAO;KACzC,WAAW,WAAW,CAAC,OAAO,OAAO,MAAM,QAAQ,QAAQ;KAC5D;IACF,CAAC;;EAGJ,qBAAqB,UAAU;AAC7B,mBAAgB,sBAAsB,OAAO;IAC3C,uBAAuB;KACrB,UAAU,sBAAsB,MAAM;KACtC,gBAAgB;;;OACd,MAAM,QAAQ;gCACd,MAAM,MAAM,2FAAa,KAAK;gCAC9B,MAAM,MAAM,wFAAU,KAAK;gCAC3B,MAAM,MAAM,6FAAe,KAAK;gCAChC,MAAM,MAAM,gGAAkB,KAAK;OACnC,MAAM,QAAQ;OACf;;KACF;IACD,uBAAuB;KACrB,UAAU,sBAAsB,MAAM;KACtC,gBAAgB,CAAC,MAAM,iBAAiB,CAAC;KAC1C;IACD,sBAAsB;KACpB,UAAU,qBAAqB,MAAM;KACrC,gBAAgB,CAAC,MAAM,iBAAiB,CAAC;KAC1C;IACD,sBAAsB;KACpB,UAAU,qBAAqB,MAAM;KACrC,gBAAgB;MACd,mBACE,OACA,uBACA,0BACD;MACD,mBACE,OACA,yBACA,4BACD;MACD,mBACE,OACA,wBACA,2BACD;MACF;KACF;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,qBAAqB,6BAA6B"}
+{"version":3,"file":"coreHeadersFeature.js","names":[],"sources":["../../../src/core/headers/coreHeadersFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs, assignTableAPIs } from '../../utils'\nimport {\n  header_getContext,\n  header_getLeafHeaders,\n  table_getFlatHeaders,\n  table_getFooterGroups,\n  table_getHeaderGroups,\n  table_getLeafHeaders,\n} from './coreHeadersFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type { Header_Header, Table_Headers } from './coreHeadersFeature.types'\n\nexport interface CoreHeadersFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Header: Header_Header<TFeatures, TData>\n  // Table: Table_Headers<TFeatures, TData>\n}\n\n/**\n * Creates the stock core headers 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 constructCoreHeadersFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<CoreHeadersFeatureConstructors<TFeatures, TData>> {\n  return {\n    assignHeaderPrototype: (prototype, table) => {\n      assignPrototypeAPIs('coreHeadersFeature', prototype, table, {\n        header_getLeafHeaders: {\n          fn: (header) => header_getLeafHeaders(header),\n          memoDeps: (header) => [header.column.table.options.columns],\n        },\n        header_getContext: {\n          fn: (header) => header_getContext(header),\n          memoDeps: (header) => [header.column.table.options.columns],\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('coreHeadersFeature', table, {\n        table_getHeaderGroups: {\n          fn: () => table_getHeaderGroups(table),\n          memoDeps: () => [\n            table.options.columns,\n            table.atoms.columnOrder?.get(),\n            table.atoms.grouping?.get(),\n            table.atoms.columnPinning?.get(),\n            table.atoms.columnVisibility?.get(),\n            table.options.groupedColumnMode,\n          ],\n        },\n        table_getFooterGroups: {\n          fn: () => table_getFooterGroups(table),\n          memoDeps: () => [table.getHeaderGroups()],\n        },\n        table_getFlatHeaders: {\n          fn: () => table_getFlatHeaders(table),\n          memoDeps: () => [table.getHeaderGroups()],\n        },\n        table_getLeafHeaders: {\n          fn: () => table_getLeafHeaders(table),\n          memoDeps: () => [table.getHeaderGroups()],\n        },\n      })\n    },\n  }\n}\n\n/**\n * The Core Headers feature provides the core header functionality.\n */\nexport const coreHeadersFeature = constructCoreHeadersFeature()\n"],"mappings":";;;;;;;;;AA0BA,SAAgB,8BAGoD;CAClE,OAAO;EACL,wBAAwB,WAAW,UAAU;GAC3C,oBAAoB,sBAAsB,WAAW,OAAO;IAC1D,uBAAuB;KACrB,KAAK,WAAW,sBAAsB,OAAO;KAC7C,WAAW,WAAW,CAAC,OAAO,OAAO,MAAM,QAAQ,QAAQ;KAC5D;IACD,mBAAmB;KACjB,KAAK,WAAW,kBAAkB,OAAO;KACzC,WAAW,WAAW,CAAC,OAAO,OAAO,MAAM,QAAQ,QAAQ;KAC5D;IACF,CAAC;;EAGJ,qBAAqB,UAAU;GAC7B,gBAAgB,sBAAsB,OAAO;IAC3C,uBAAuB;KACrB,UAAU,sBAAsB,MAAM;KACtC,gBAAgB;;;OACd,MAAM,QAAQ;gCACd,MAAM,MAAM,2FAAa,KAAK;gCAC9B,MAAM,MAAM,wFAAU,KAAK;gCAC3B,MAAM,MAAM,6FAAe,KAAK;gCAChC,MAAM,MAAM,gGAAkB,KAAK;OACnC,MAAM,QAAQ;OACf;;KACF;IACD,uBAAuB;KACrB,UAAU,sBAAsB,MAAM;KACtC,gBAAgB,CAAC,MAAM,iBAAiB,CAAC;KAC1C;IACD,sBAAsB;KACpB,UAAU,qBAAqB,MAAM;KACrC,gBAAgB,CAAC,MAAM,iBAAiB,CAAC;KAC1C;IACD,sBAAsB;KACpB,UAAU,qBAAqB,MAAM;KACrC,gBAAgB,CAAC,MAAM,iBAAiB,CAAC;KAC1C;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,qBAAqB,6BAA6B"}

package/dist/core/headers/coreHeadersFeature.utils.cjs

@@ -4,6 +4,16 @@ const require_buildHeaderGroups = require('./buildHeaderGroups.cjs');
 const require_columnPinningFeature_utils = require('../../features/column-pinning/columnPinningFeature.utils.cjs');
 
 //#region src/core/headers/coreHeadersFeature.utils.ts
+/**
+* Returns leaf headers for a header.
+*
+* This is the static implementation behind the matching header instance API and can account for nested header groups.
+*
+* @example
+* ```ts
+* const value = header_getLeafHeaders(header)
+* ```
+*/
 function header_getLeafHeaders(header) {
 	const leafHeaders = [];
 	const recurseHeader = (h) => {
@@ -13,6 +23,16 @@ function header_getLeafHeaders(header) {
 	recurseHeader(header);
 	return leafHeaders;
 }
+/**
+* Returns context for a header.
+*
+* This is the static implementation behind the matching header instance API and can account for nested header groups.
+*
+* @example
+* ```ts
+* const value = header_getContext(header)
+* ```
+*/
 function header_getContext(header) {
 	return {
 		column: header.column,
@@ -20,13 +40,33 @@ function header_getContext(header) {
 		table: header.column.table
 	};
 }
+/**
+* Returns header groups for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getHeaderGroups(table)
+* ```
+*/
 function table_getHeaderGroups(table) {
 	var _table$atoms$columnPi;
 	const { left, right } = ((_table$atoms$columnPi = table.atoms.columnPinning) === null || _table$atoms$columnPi === void 0 ? void 0 : _table$atoms$columnPi.get()) ?? require_columnPinningFeature_utils.getDefaultColumnPinningState();
 	const allColumns = table.getAllColumns();
 	const leafColumns = require_utils.callMemoOrStaticFn(table, "getVisibleLeafColumns", require_columnVisibilityFeature_utils.table_getVisibleLeafColumns);
-	const leftColumns = left.map((columnId) => leafColumns.find((d) => d.id === columnId)).filter(Boolean);
-	const rightColumns = right.map((columnId) => leafColumns.find((d) => d.id === columnId)).filter(Boolean);
+	if (!left.length && !right.length) return require_buildHeaderGroups.buildHeaderGroups(allColumns, leafColumns, table);
+	const leafColumnsById = table.getAllLeafColumnsById();
+	const leftColumns = [];
+	for (let i = 0; i < left.length; i++) {
+		const column = leafColumnsById[left[i]];
+		if (column && require_utils.callMemoOrStaticFn(column, "getIsVisible", require_columnVisibilityFeature_utils.column_getIsVisible)) leftColumns.push(column);
+	}
+	const rightColumns = [];
+	for (let i = 0; i < right.length; i++) {
+		const column = leafColumnsById[right[i]];
+		if (column && require_utils.callMemoOrStaticFn(column, "getIsVisible", require_columnVisibilityFeature_utils.column_getIsVisible)) rightColumns.push(column);
+	}
 	const centerColumns = leafColumns.filter((column) => !left.includes(column.id) && !right.includes(column.id));
 	return require_buildHeaderGroups.buildHeaderGroups(allColumns, [
 		...leftColumns,
@@ -34,26 +74,57 @@ function table_getHeaderGroups(table) {
 		...rightColumns
 	], table);
 }
+/**
+* Returns footer groups for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getFooterGroups(table)
+* ```
+*/
 function table_getFooterGroups(table) {
 	return [...table.getHeaderGroups()].reverse();
 }
+/**
+* Returns flat headers for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getFlatHeaders(table)
+* ```
+*/
 function table_getFlatHeaders(table) {
-	return table.getHeaderGroups().map((headerGroup) => {
-		return headerGroup.headers;
-	}).flat();
+	const headerGroups = table.getHeaderGroups();
+	const result = [];
+	for (let i = 0; i < headerGroups.length; i++) {
+		const headers = headerGroups[i].headers;
+		for (let j = 0; j < headers.length; j++) result.push(headers[j]);
+	}
+	return result;
 }
+/**
+* Returns leaf headers for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getLeafHeaders(table)
+* ```
+*/
 function table_getLeafHeaders(table) {
-	var _left$, _center$, _right$;
-	const left = require_utils.callMemoOrStaticFn(table, "getLeftHeaderGroups", require_columnPinningFeature_utils.table_getLeftHeaderGroups);
-	const center = require_utils.callMemoOrStaticFn(table, "getCenterHeaderGroups", require_columnPinningFeature_utils.table_getCenterHeaderGroups);
-	const right = require_utils.callMemoOrStaticFn(table, "getRightHeaderGroups", require_columnPinningFeature_utils.table_getRightHeaderGroups);
-	return [
-		...((_left$ = left[0]) === null || _left$ === void 0 ? void 0 : _left$.headers) ?? [],
-		...((_center$ = center[0]) === null || _center$ === void 0 ? void 0 : _center$.headers) ?? [],
-		...((_right$ = right[0]) === null || _right$ === void 0 ? void 0 : _right$.headers) ?? []
-	].map((header) => {
-		return header.getLeafHeaders();
-	}).flat();
+	var _table$getHeaderGroup;
+	const topHeaders = ((_table$getHeaderGroup = table.getHeaderGroups()[0]) === null || _table$getHeaderGroup === void 0 ? void 0 : _table$getHeaderGroup.headers) ?? [];
+	const result = [];
+	for (let i = 0; i < topHeaders.length; i++) {
+		const leafHeaders = topHeaders[i].getLeafHeaders();
+		for (let j = 0; j < leafHeaders.length; j++) result.push(leafHeaders[j]);
+	}
+	return result;
 }
 
 //#endregion

package/dist/core/headers/coreHeadersFeature.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"coreHeadersFeature.utils.cjs","names":["getDefaultColumnPinningState","callMemoOrStaticFn","table_getVisibleLeafColumns","buildHeaderGroups","table_getLeftHeaderGroups","table_getCenterHeaderGroups","table_getRightHeaderGroups"],"sources":["../../../src/core/headers/coreHeadersFeature.utils.ts"],"sourcesContent":["import {\n  getDefaultColumnPinningState,\n  table_getCenterHeaderGroups,\n  table_getLeftHeaderGroups,\n  table_getRightHeaderGroups,\n} from '../../features/column-pinning/columnPinningFeature.utils'\nimport { table_getVisibleLeafColumns } from '../../features/column-visibility/columnVisibilityFeature.utils'\nimport { callMemoOrStaticFn } from '../../utils'\nimport { buildHeaderGroups } from './buildHeaderGroups'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Header } from '../../types/Header'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header_Header } from './coreHeadersFeature.types'\nimport type { Column } from '../../types/Column'\n\nexport function header_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  const leafHeaders: Array<Header<TFeatures, TData, TValue>> = []\n\n  const recurseHeader = (h: Header_Header<TFeatures, TData, TValue>) => {\n    if (h.subHeaders.length) {\n      h.subHeaders.map(recurseHeader)\n    }\n    leafHeaders.push(h as Header<TFeatures, TData, TValue>)\n  }\n\n  recurseHeader(header)\n\n  return leafHeaders\n}\n\nexport function header_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  return {\n    column: header.column,\n    header,\n    table: header.column.table,\n  }\n}\n\nexport function table_getHeaderGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const { left, right } =\n    table.atoms.columnPinning?.get() ?? getDefaultColumnPinningState()\n  const allColumns = table.getAllColumns()\n  const leafColumns = callMemoOrStaticFn(\n    table,\n    'getVisibleLeafColumns',\n    table_getVisibleLeafColumns,\n  ) as unknown as Array<Column<TFeatures, TData, unknown>>\n\n  const leftColumns = left\n    .map((columnId) => leafColumns.find((d) => d.id === columnId)!)\n    .filter(Boolean)\n\n  const rightColumns = right\n    .map((columnId) => leafColumns.find((d) => d.id === columnId)!)\n    .filter(Boolean)\n\n  const centerColumns = leafColumns.filter(\n    (column) => !left.includes(column.id) && !right.includes(column.id),\n  )\n\n  const headerGroups = buildHeaderGroups(\n    allColumns,\n    [...leftColumns, ...centerColumns, ...rightColumns],\n    table,\n  )\n\n  return headerGroups\n}\n\nexport function table_getFooterGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return [...headerGroups].reverse()\n}\n\nexport function table_getFlatHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return headerGroups\n    .map((headerGroup) => {\n      return headerGroup.headers\n    })\n    .flat()\n}\n\nexport function table_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const left = callMemoOrStaticFn(\n    table,\n    'getLeftHeaderGroups',\n    table_getLeftHeaderGroups,\n  )\n  const center = callMemoOrStaticFn(\n    table,\n    'getCenterHeaderGroups',\n    table_getCenterHeaderGroups,\n  )\n  const right = callMemoOrStaticFn(\n    table,\n    'getRightHeaderGroups',\n    table_getRightHeaderGroups,\n  )\n\n  return [\n    ...(left[0]?.headers ?? []),\n    ...(center[0]?.headers ?? []),\n    ...(right[0]?.headers ?? []),\n  ]\n    .map((header) => {\n      return header.getLeafHeaders()\n    })\n    .flat()\n}\n"],"mappings":";;;;;;AAgBA,SAAgB,sBAId,QAA0C;CAC1C,MAAM,cAAuD,EAAE;CAE/D,MAAM,iBAAiB,MAA+C;AACpE,MAAI,EAAE,WAAW,OACf,GAAE,WAAW,IAAI,cAAc;AAEjC,cAAY,KAAK,EAAsC;;AAGzD,eAAc,OAAO;AAErB,QAAO;;AAGT,SAAgB,kBAId,QAA0C;AAC1C,QAAO;EACL,QAAQ,OAAO;EACf;EACA,OAAO,OAAO,OAAO;EACtB;;AAGH,SAAgB,sBAGd,OAAyC;;CACzC,MAAM,EAAE,MAAM,oCACZ,MAAM,MAAM,6FAAe,KAAK,KAAIA,iEAA8B;CACpE,MAAM,aAAa,MAAM,eAAe;CACxC,MAAM,cAAcC,iCAClB,OACA,yBACAC,kEACD;CAED,MAAM,cAAc,KACjB,KAAK,aAAa,YAAY,MAAM,MAAM,EAAE,OAAO,SAAS,CAAE,CAC9D,OAAO,QAAQ;CAElB,MAAM,eAAe,MAClB,KAAK,aAAa,YAAY,MAAM,MAAM,EAAE,OAAO,SAAS,CAAE,CAC9D,OAAO,QAAQ;CAElB,MAAM,gBAAgB,YAAY,QAC/B,WAAW,CAAC,KAAK,SAAS,OAAO,GAAG,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG,CACpE;AAQD,QANqBC,4CACnB,YACA;EAAC,GAAG;EAAa,GAAG;EAAe,GAAG;EAAa,EACnD,MAGiB;;AAGrB,SAAgB,sBAGd,OAAyC;AAEzC,QAAO,CAAC,GADa,MAAM,iBACJ,CAAC,CAAC,SAAS;;AAGpC,SAAgB,qBAGd,OAAyC;AAEzC,QADqB,MAAM,iBACR,CAChB,KAAK,gBAAgB;AACpB,SAAO,YAAY;GACnB,CACD,MAAM;;AAGX,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,OAAOF,iCACX,OACA,uBACAG,6DACD;CACD,MAAM,SAASH,iCACb,OACA,yBACAI,+DACD;CACD,MAAM,QAAQJ,iCACZ,OACA,wBACAK,8DACD;AAED,QAAO;EACL,cAAI,KAAK,oDAAI,YAAW,EAAE;EAC1B,gBAAI,OAAO,wDAAI,YAAW,EAAE;EAC5B,eAAI,MAAM,sDAAI,YAAW,EAAE;EAC5B,CACE,KAAK,WAAW;AACf,SAAO,OAAO,gBAAgB;GAC9B,CACD,MAAM"}
+{"version":3,"file":"coreHeadersFeature.utils.cjs","names":["getDefaultColumnPinningState","callMemoOrStaticFn","table_getVisibleLeafColumns","buildHeaderGroups","column_getIsVisible"],"sources":["../../../src/core/headers/coreHeadersFeature.utils.ts"],"sourcesContent":["import { getDefaultColumnPinningState } from '../../features/column-pinning/columnPinningFeature.utils'\nimport {\n  column_getIsVisible,\n  table_getVisibleLeafColumns,\n} from '../../features/column-visibility/columnVisibilityFeature.utils'\nimport { callMemoOrStaticFn } from '../../utils'\nimport { buildHeaderGroups } from './buildHeaderGroups'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Header } from '../../types/Header'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header_Header } from './coreHeadersFeature.types'\nimport type { Column } from '../../types/Column'\n\n/**\n * Returns leaf headers for a header.\n *\n * This is the static implementation behind the matching header instance API and can account for nested header groups.\n *\n * @example\n * ```ts\n * const value = header_getLeafHeaders(header)\n * ```\n */\nexport function header_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  const leafHeaders: Array<Header<TFeatures, TData, TValue>> = []\n\n  const recurseHeader = (h: Header_Header<TFeatures, TData, TValue>) => {\n    if (h.subHeaders.length) {\n      h.subHeaders.map(recurseHeader)\n    }\n    leafHeaders.push(h as Header<TFeatures, TData, TValue>)\n  }\n\n  recurseHeader(header)\n\n  return leafHeaders\n}\n\n/**\n * Returns context for a header.\n *\n * This is the static implementation behind the matching header instance API and can account for nested header groups.\n *\n * @example\n * ```ts\n * const value = header_getContext(header)\n * ```\n */\nexport function header_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  return {\n    column: header.column,\n    header,\n    table: header.column.table,\n  }\n}\n\n/**\n * Returns header groups for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getHeaderGroups(table)\n * ```\n */\nexport function table_getHeaderGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const { left, right } =\n    table.atoms.columnPinning?.get() ?? getDefaultColumnPinningState()\n  const allColumns = table.getAllColumns()\n  const leafColumns = callMemoOrStaticFn(\n    table,\n    'getVisibleLeafColumns',\n    table_getVisibleLeafColumns,\n  ) as Array<Column<TFeatures, TData, unknown>>\n\n  // Fast path: no columns are pinned — skip per-side lookups, partition, and spread.\n  if (!left.length && !right.length) {\n    return buildHeaderGroups(allColumns, leafColumns, table)\n  }\n\n  const leafColumnsById = table.getAllLeafColumnsById()\n\n  const leftColumns: typeof leafColumns = []\n  for (let i = 0; i < left.length; i++) {\n    const column = leafColumnsById[left[i]!]\n    if (\n      column &&\n      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)\n    ) {\n      leftColumns.push(column)\n    }\n  }\n\n  const rightColumns: typeof leafColumns = []\n  for (let i = 0; i < right.length; i++) {\n    const column = leafColumnsById[right[i]!]\n    if (\n      column &&\n      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)\n    ) {\n      rightColumns.push(column)\n    }\n  }\n\n  const centerColumns = leafColumns.filter(\n    (column) => !left.includes(column.id) && !right.includes(column.id),\n  )\n\n  return buildHeaderGroups(\n    allColumns,\n    [...leftColumns, ...centerColumns, ...rightColumns],\n    table,\n  )\n}\n\n/**\n * Returns footer groups for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getFooterGroups(table)\n * ```\n */\nexport function table_getFooterGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return [...headerGroups].reverse()\n}\n\n/**\n * Returns flat headers for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getFlatHeaders(table)\n * ```\n */\nexport function table_getFlatHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  const result: Array<Header<TFeatures, TData, unknown>> = []\n  for (let i = 0; i < headerGroups.length; i++) {\n    const headers = headerGroups[i]!.headers\n    for (let j = 0; j < headers.length; j++) {\n      result.push(headers[j]!)\n    }\n  }\n  return result\n}\n\n/**\n * Returns leaf headers for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getLeafHeaders(table)\n * ```\n */\nexport function table_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const topHeaders = table.getHeaderGroups()[0]?.headers ?? []\n  const result: Array<Header<TFeatures, TData, unknown>> = []\n  for (let i = 0; i < topHeaders.length; i++) {\n    const leafHeaders = topHeaders[i]!.getLeafHeaders()\n    for (let j = 0; j < leafHeaders.length; j++) {\n      result.push(leafHeaders[j]!)\n    }\n  }\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAwBA,SAAgB,sBAId,QAA0C;CAC1C,MAAM,cAAuD,EAAE;CAE/D,MAAM,iBAAiB,MAA+C;EACpE,IAAI,EAAE,WAAW,QACf,EAAE,WAAW,IAAI,cAAc;EAEjC,YAAY,KAAK,EAAsC;;CAGzD,cAAc,OAAO;CAErB,OAAO;;;;;;;;;;;;AAaT,SAAgB,kBAId,QAA0C;CAC1C,OAAO;EACL,QAAQ,OAAO;EACf;EACA,OAAO,OAAO,OAAO;EACtB;;;;;;;;;;;;AAaH,SAAgB,sBAGd,OAAyC;;CACzC,MAAM,EAAE,MAAM,oCACZ,MAAM,MAAM,6FAAe,KAAK,KAAIA,iEAA8B;CACpE,MAAM,aAAa,MAAM,eAAe;CACxC,MAAM,cAAcC,iCAClB,OACA,yBACAC,kEACD;CAGD,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,QACzB,OAAOC,4CAAkB,YAAY,aAAa,MAAM;CAG1D,MAAM,kBAAkB,MAAM,uBAAuB;CAErD,MAAM,cAAkC,EAAE;CAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,SAAS,gBAAgB,KAAK;EACpC,IACE,UACAF,iCAAmB,QAAQ,gBAAgBG,0DAAoB,EAE/D,YAAY,KAAK,OAAO;;CAI5B,MAAM,eAAmC,EAAE;CAC3C,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,SAAS,gBAAgB,MAAM;EACrC,IACE,UACAH,iCAAmB,QAAQ,gBAAgBG,0DAAoB,EAE/D,aAAa,KAAK,OAAO;;CAI7B,MAAM,gBAAgB,YAAY,QAC/B,WAAW,CAAC,KAAK,SAAS,OAAO,GAAG,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG,CACpE;CAED,OAAOD,4CACL,YACA;EAAC,GAAG;EAAa,GAAG;EAAe,GAAG;EAAa,EACnD,MACD;;;;;;;;;;;;AAaH,SAAgB,sBAGd,OAAyC;CAEzC,OAAO,CAAC,GADa,MAAM,iBACJ,CAAC,CAAC,SAAS;;;;;;;;;;;;AAapC,SAAgB,qBAGd,OAAyC;CACzC,MAAM,eAAe,MAAM,iBAAiB;CAC5C,MAAM,SAAmD,EAAE;CAC3D,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;EAC5C,MAAM,UAAU,aAAa,GAAI;EACjC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,OAAO,KAAK,QAAQ,GAAI;;CAG5B,OAAO;;;;;;;;;;;;AAaT,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,uCAAa,MAAM,iBAAiB,CAAC,kFAAI,YAAW,EAAE;CAC5D,MAAM,SAAmD,EAAE;CAC3D,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;EAC1C,MAAM,cAAc,WAAW,GAAI,gBAAgB;EACnD,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KACtC,OAAO,KAAK,YAAY,GAAI;;CAGhC,OAAO"}

package/dist/core/headers/coreHeadersFeature.utils.d.cts

@@ -5,16 +5,76 @@ import { Column } from "../../types/Column.cjs";
 import { TableFeatures } from "../../types/TableFeatures.cjs";
 import { Table_Internal } from "../../types/Table.cjs";
 //#region src/core/headers/coreHeadersFeature.utils.d.ts
+/**
+ * Returns leaf headers for a header.
+ *
+ * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ *
+ * @example
+ * ```ts
+ * const value = header_getLeafHeaders(header)
+ * ```
+ */
 declare function header_getLeafHeaders<TFeatures extends TableFeatures, TData extends RowData, TValue>(header: Header<TFeatures, TData, TValue>): Header<TFeatures, TData, TValue>[];
+/**
+ * Returns context for a header.
+ *
+ * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ *
+ * @example
+ * ```ts
+ * const value = header_getContext(header)
+ * ```
+ */
 declare function header_getContext<TFeatures extends TableFeatures, TData extends RowData, TValue>(header: Header<TFeatures, TData, TValue>): {
   column: Column<TFeatures, TData, TValue>;
   header: Header<TFeatures, TData, TValue>;
   table: Table_Internal<TFeatures, TData>;
 };
+/**
+ * Returns header groups for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getHeaderGroups(table)
+ * ```
+ */
 declare function table_getHeaderGroups<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): HeaderGroup<TFeatures, TData>[];
+/**
+ * Returns footer groups for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getFooterGroups(table)
+ * ```
+ */
 declare function table_getFooterGroups<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): HeaderGroup<TFeatures, TData>[];
+/**
+ * Returns flat headers for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getFlatHeaders(table)
+ * ```
+ */
 declare function table_getFlatHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Header<TFeatures, TData, unknown>[];
-declare function table_getLeafHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): any[];
+/**
+ * Returns leaf headers for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getLeafHeaders(table)
+ * ```
+ */
+declare function table_getLeafHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Header<TFeatures, TData, unknown>[];
 //#endregion
 export { header_getContext, header_getLeafHeaders, table_getFlatHeaders, table_getFooterGroups, table_getHeaderGroups, table_getLeafHeaders };
 //# sourceMappingURL=coreHeadersFeature.utils.d.cts.map

package/dist/core/headers/coreHeadersFeature.utils.d.ts

@@ -5,16 +5,76 @@ import { Column } from "../../types/Column.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 import { Table_Internal } from "../../types/Table.js";
 //#region src/core/headers/coreHeadersFeature.utils.d.ts
+/**
+ * Returns leaf headers for a header.
+ *
+ * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ *
+ * @example
+ * ```ts
+ * const value = header_getLeafHeaders(header)
+ * ```
+ */
 declare function header_getLeafHeaders<TFeatures extends TableFeatures, TData extends RowData, TValue>(header: Header<TFeatures, TData, TValue>): Header<TFeatures, TData, TValue>[];
+/**
+ * Returns context for a header.
+ *
+ * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ *
+ * @example
+ * ```ts
+ * const value = header_getContext(header)
+ * ```
+ */
 declare function header_getContext<TFeatures extends TableFeatures, TData extends RowData, TValue>(header: Header<TFeatures, TData, TValue>): {
   column: Column<TFeatures, TData, TValue>;
   header: Header<TFeatures, TData, TValue>;
   table: Table_Internal<TFeatures, TData>;
 };
+/**
+ * Returns header groups for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getHeaderGroups(table)
+ * ```
+ */
 declare function table_getHeaderGroups<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): HeaderGroup<TFeatures, TData>[];
+/**
+ * Returns footer groups for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getFooterGroups(table)
+ * ```
+ */
 declare function table_getFooterGroups<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): HeaderGroup<TFeatures, TData>[];
+/**
+ * Returns flat headers for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getFlatHeaders(table)
+ * ```
+ */
 declare function table_getFlatHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Header<TFeatures, TData, unknown>[];
-declare function table_getLeafHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): any[];
+/**
+ * Returns leaf headers for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getLeafHeaders(table)
+ * ```
+ */
+declare function table_getLeafHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Header<TFeatures, TData, unknown>[];
 //#endregion
 export { header_getContext, header_getLeafHeaders, table_getFlatHeaders, table_getFooterGroups, table_getHeaderGroups, table_getLeafHeaders };
 //# sourceMappingURL=coreHeadersFeature.utils.d.ts.map

package/dist/core/headers/coreHeadersFeature.utils.js

@@ -1,9 +1,19 @@
 import { callMemoOrStaticFn } from "../../utils.js";
-import { table_getVisibleLeafColumns } from "../../features/column-visibility/columnVisibilityFeature.utils.js";
+import { column_getIsVisible, table_getVisibleLeafColumns } from "../../features/column-visibility/columnVisibilityFeature.utils.js";
 import { buildHeaderGroups } from "./buildHeaderGroups.js";
-import { getDefaultColumnPinningState, table_getCenterHeaderGroups, table_getLeftHeaderGroups, table_getRightHeaderGroups } from "../../features/column-pinning/columnPinningFeature.utils.js";
+import { getDefaultColumnPinningState } from "../../features/column-pinning/columnPinningFeature.utils.js";
 
 //#region src/core/headers/coreHeadersFeature.utils.ts
+/**
+* Returns leaf headers for a header.
+*
+* This is the static implementation behind the matching header instance API and can account for nested header groups.
+*
+* @example
+* ```ts
+* const value = header_getLeafHeaders(header)
+* ```
+*/
 function header_getLeafHeaders(header) {
 	const leafHeaders = [];
 	const recurseHeader = (h) => {
@@ -13,6 +23,16 @@ function header_getLeafHeaders(header) {
 	recurseHeader(header);
 	return leafHeaders;
 }
+/**
+* Returns context for a header.
+*
+* This is the static implementation behind the matching header instance API and can account for nested header groups.
+*
+* @example
+* ```ts
+* const value = header_getContext(header)
+* ```
+*/
 function header_getContext(header) {
 	return {
 		column: header.column,
@@ -20,13 +40,33 @@ function header_getContext(header) {
 		table: header.column.table
 	};
 }
+/**
+* Returns header groups for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getHeaderGroups(table)
+* ```
+*/
 function table_getHeaderGroups(table) {
 	var _table$atoms$columnPi;
 	const { left, right } = ((_table$atoms$columnPi = table.atoms.columnPinning) === null || _table$atoms$columnPi === void 0 ? void 0 : _table$atoms$columnPi.get()) ?? getDefaultColumnPinningState();
 	const allColumns = table.getAllColumns();
 	const leafColumns = callMemoOrStaticFn(table, "getVisibleLeafColumns", table_getVisibleLeafColumns);
-	const leftColumns = left.map((columnId) => leafColumns.find((d) => d.id === columnId)).filter(Boolean);
-	const rightColumns = right.map((columnId) => leafColumns.find((d) => d.id === columnId)).filter(Boolean);
+	if (!left.length && !right.length) return buildHeaderGroups(allColumns, leafColumns, table);
+	const leafColumnsById = table.getAllLeafColumnsById();
+	const leftColumns = [];
+	for (let i = 0; i < left.length; i++) {
+		const column = leafColumnsById[left[i]];
+		if (column && callMemoOrStaticFn(column, "getIsVisible", column_getIsVisible)) leftColumns.push(column);
+	}
+	const rightColumns = [];
+	for (let i = 0; i < right.length; i++) {
+		const column = leafColumnsById[right[i]];
+		if (column && callMemoOrStaticFn(column, "getIsVisible", column_getIsVisible)) rightColumns.push(column);
+	}
 	const centerColumns = leafColumns.filter((column) => !left.includes(column.id) && !right.includes(column.id));
 	return buildHeaderGroups(allColumns, [
 		...leftColumns,
@@ -34,26 +74,57 @@ function table_getHeaderGroups(table) {
 		...rightColumns
 	], table);
 }
+/**
+* Returns footer groups for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getFooterGroups(table)
+* ```
+*/
 function table_getFooterGroups(table) {
 	return [...table.getHeaderGroups()].reverse();
 }
+/**
+* Returns flat headers for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getFlatHeaders(table)
+* ```
+*/
 function table_getFlatHeaders(table) {
-	return table.getHeaderGroups().map((headerGroup) => {
-		return headerGroup.headers;
-	}).flat();
+	const headerGroups = table.getHeaderGroups();
+	const result = [];
+	for (let i = 0; i < headerGroups.length; i++) {
+		const headers = headerGroups[i].headers;
+		for (let j = 0; j < headers.length; j++) result.push(headers[j]);
+	}
+	return result;
 }
+/**
+* Returns leaf headers for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getLeafHeaders(table)
+* ```
+*/
 function table_getLeafHeaders(table) {
-	var _left$, _center$, _right$;
-	const left = callMemoOrStaticFn(table, "getLeftHeaderGroups", table_getLeftHeaderGroups);
-	const center = callMemoOrStaticFn(table, "getCenterHeaderGroups", table_getCenterHeaderGroups);
-	const right = callMemoOrStaticFn(table, "getRightHeaderGroups", table_getRightHeaderGroups);
-	return [
-		...((_left$ = left[0]) === null || _left$ === void 0 ? void 0 : _left$.headers) ?? [],
-		...((_center$ = center[0]) === null || _center$ === void 0 ? void 0 : _center$.headers) ?? [],
-		...((_right$ = right[0]) === null || _right$ === void 0 ? void 0 : _right$.headers) ?? []
-	].map((header) => {
-		return header.getLeafHeaders();
-	}).flat();
+	var _table$getHeaderGroup;
+	const topHeaders = ((_table$getHeaderGroup = table.getHeaderGroups()[0]) === null || _table$getHeaderGroup === void 0 ? void 0 : _table$getHeaderGroup.headers) ?? [];
+	const result = [];
+	for (let i = 0; i < topHeaders.length; i++) {
+		const leafHeaders = topHeaders[i].getLeafHeaders();
+		for (let j = 0; j < leafHeaders.length; j++) result.push(leafHeaders[j]);
+	}
+	return result;
 }
 
 //#endregion

package/dist/core/headers/coreHeadersFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreHeadersFeature.utils.js","names":[],"sources":["../../../src/core/headers/coreHeadersFeature.utils.ts"],"sourcesContent":["import {\n  getDefaultColumnPinningState,\n  table_getCenterHeaderGroups,\n  table_getLeftHeaderGroups,\n  table_getRightHeaderGroups,\n} from '../../features/column-pinning/columnPinningFeature.utils'\nimport { table_getVisibleLeafColumns } from '../../features/column-visibility/columnVisibilityFeature.utils'\nimport { callMemoOrStaticFn } from '../../utils'\nimport { buildHeaderGroups } from './buildHeaderGroups'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Header } from '../../types/Header'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header_Header } from './coreHeadersFeature.types'\nimport type { Column } from '../../types/Column'\n\nexport function header_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  const leafHeaders: Array<Header<TFeatures, TData, TValue>> = []\n\n  const recurseHeader = (h: Header_Header<TFeatures, TData, TValue>) => {\n    if (h.subHeaders.length) {\n      h.subHeaders.map(recurseHeader)\n    }\n    leafHeaders.push(h as Header<TFeatures, TData, TValue>)\n  }\n\n  recurseHeader(header)\n\n  return leafHeaders\n}\n\nexport function header_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  return {\n    column: header.column,\n    header,\n    table: header.column.table,\n  }\n}\n\nexport function table_getHeaderGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const { left, right } =\n    table.atoms.columnPinning?.get() ?? getDefaultColumnPinningState()\n  const allColumns = table.getAllColumns()\n  const leafColumns = callMemoOrStaticFn(\n    table,\n    'getVisibleLeafColumns',\n    table_getVisibleLeafColumns,\n  ) as unknown as Array<Column<TFeatures, TData, unknown>>\n\n  const leftColumns = left\n    .map((columnId) => leafColumns.find((d) => d.id === columnId)!)\n    .filter(Boolean)\n\n  const rightColumns = right\n    .map((columnId) => leafColumns.find((d) => d.id === columnId)!)\n    .filter(Boolean)\n\n  const centerColumns = leafColumns.filter(\n    (column) => !left.includes(column.id) && !right.includes(column.id),\n  )\n\n  const headerGroups = buildHeaderGroups(\n    allColumns,\n    [...leftColumns, ...centerColumns, ...rightColumns],\n    table,\n  )\n\n  return headerGroups\n}\n\nexport function table_getFooterGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return [...headerGroups].reverse()\n}\n\nexport function table_getFlatHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return headerGroups\n    .map((headerGroup) => {\n      return headerGroup.headers\n    })\n    .flat()\n}\n\nexport function table_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const left = callMemoOrStaticFn(\n    table,\n    'getLeftHeaderGroups',\n    table_getLeftHeaderGroups,\n  )\n  const center = callMemoOrStaticFn(\n    table,\n    'getCenterHeaderGroups',\n    table_getCenterHeaderGroups,\n  )\n  const right = callMemoOrStaticFn(\n    table,\n    'getRightHeaderGroups',\n    table_getRightHeaderGroups,\n  )\n\n  return [\n    ...(left[0]?.headers ?? []),\n    ...(center[0]?.headers ?? []),\n    ...(right[0]?.headers ?? []),\n  ]\n    .map((header) => {\n      return header.getLeafHeaders()\n    })\n    .flat()\n}\n"],"mappings":";;;;;;AAgBA,SAAgB,sBAId,QAA0C;CAC1C,MAAM,cAAuD,EAAE;CAE/D,MAAM,iBAAiB,MAA+C;AACpE,MAAI,EAAE,WAAW,OACf,GAAE,WAAW,IAAI,cAAc;AAEjC,cAAY,KAAK,EAAsC;;AAGzD,eAAc,OAAO;AAErB,QAAO;;AAGT,SAAgB,kBAId,QAA0C;AAC1C,QAAO;EACL,QAAQ,OAAO;EACf;EACA,OAAO,OAAO,OAAO;EACtB;;AAGH,SAAgB,sBAGd,OAAyC;;CACzC,MAAM,EAAE,MAAM,oCACZ,MAAM,MAAM,6FAAe,KAAK,KAAI,8BAA8B;CACpE,MAAM,aAAa,MAAM,eAAe;CACxC,MAAM,cAAc,mBAClB,OACA,yBACA,4BACD;CAED,MAAM,cAAc,KACjB,KAAK,aAAa,YAAY,MAAM,MAAM,EAAE,OAAO,SAAS,CAAE,CAC9D,OAAO,QAAQ;CAElB,MAAM,eAAe,MAClB,KAAK,aAAa,YAAY,MAAM,MAAM,EAAE,OAAO,SAAS,CAAE,CAC9D,OAAO,QAAQ;CAElB,MAAM,gBAAgB,YAAY,QAC/B,WAAW,CAAC,KAAK,SAAS,OAAO,GAAG,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG,CACpE;AAQD,QANqB,kBACnB,YACA;EAAC,GAAG;EAAa,GAAG;EAAe,GAAG;EAAa,EACnD,MAGiB;;AAGrB,SAAgB,sBAGd,OAAyC;AAEzC,QAAO,CAAC,GADa,MAAM,iBACJ,CAAC,CAAC,SAAS;;AAGpC,SAAgB,qBAGd,OAAyC;AAEzC,QADqB,MAAM,iBACR,CAChB,KAAK,gBAAgB;AACpB,SAAO,YAAY;GACnB,CACD,MAAM;;AAGX,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,OAAO,mBACX,OACA,uBACA,0BACD;CACD,MAAM,SAAS,mBACb,OACA,yBACA,4BACD;CACD,MAAM,QAAQ,mBACZ,OACA,wBACA,2BACD;AAED,QAAO;EACL,cAAI,KAAK,oDAAI,YAAW,EAAE;EAC1B,gBAAI,OAAO,wDAAI,YAAW,EAAE;EAC5B,eAAI,MAAM,sDAAI,YAAW,EAAE;EAC5B,CACE,KAAK,WAAW;AACf,SAAO,OAAO,gBAAgB;GAC9B,CACD,MAAM"}
+{"version":3,"file":"coreHeadersFeature.utils.js","names":[],"sources":["../../../src/core/headers/coreHeadersFeature.utils.ts"],"sourcesContent":["import { getDefaultColumnPinningState } from '../../features/column-pinning/columnPinningFeature.utils'\nimport {\n  column_getIsVisible,\n  table_getVisibleLeafColumns,\n} from '../../features/column-visibility/columnVisibilityFeature.utils'\nimport { callMemoOrStaticFn } from '../../utils'\nimport { buildHeaderGroups } from './buildHeaderGroups'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Header } from '../../types/Header'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header_Header } from './coreHeadersFeature.types'\nimport type { Column } from '../../types/Column'\n\n/**\n * Returns leaf headers for a header.\n *\n * This is the static implementation behind the matching header instance API and can account for nested header groups.\n *\n * @example\n * ```ts\n * const value = header_getLeafHeaders(header)\n * ```\n */\nexport function header_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  const leafHeaders: Array<Header<TFeatures, TData, TValue>> = []\n\n  const recurseHeader = (h: Header_Header<TFeatures, TData, TValue>) => {\n    if (h.subHeaders.length) {\n      h.subHeaders.map(recurseHeader)\n    }\n    leafHeaders.push(h as Header<TFeatures, TData, TValue>)\n  }\n\n  recurseHeader(header)\n\n  return leafHeaders\n}\n\n/**\n * Returns context for a header.\n *\n * This is the static implementation behind the matching header instance API and can account for nested header groups.\n *\n * @example\n * ```ts\n * const value = header_getContext(header)\n * ```\n */\nexport function header_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  return {\n    column: header.column,\n    header,\n    table: header.column.table,\n  }\n}\n\n/**\n * Returns header groups for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getHeaderGroups(table)\n * ```\n */\nexport function table_getHeaderGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const { left, right } =\n    table.atoms.columnPinning?.get() ?? getDefaultColumnPinningState()\n  const allColumns = table.getAllColumns()\n  const leafColumns = callMemoOrStaticFn(\n    table,\n    'getVisibleLeafColumns',\n    table_getVisibleLeafColumns,\n  ) as Array<Column<TFeatures, TData, unknown>>\n\n  // Fast path: no columns are pinned — skip per-side lookups, partition, and spread.\n  if (!left.length && !right.length) {\n    return buildHeaderGroups(allColumns, leafColumns, table)\n  }\n\n  const leafColumnsById = table.getAllLeafColumnsById()\n\n  const leftColumns: typeof leafColumns = []\n  for (let i = 0; i < left.length; i++) {\n    const column = leafColumnsById[left[i]!]\n    if (\n      column &&\n      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)\n    ) {\n      leftColumns.push(column)\n    }\n  }\n\n  const rightColumns: typeof leafColumns = []\n  for (let i = 0; i < right.length; i++) {\n    const column = leafColumnsById[right[i]!]\n    if (\n      column &&\n      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)\n    ) {\n      rightColumns.push(column)\n    }\n  }\n\n  const centerColumns = leafColumns.filter(\n    (column) => !left.includes(column.id) && !right.includes(column.id),\n  )\n\n  return buildHeaderGroups(\n    allColumns,\n    [...leftColumns, ...centerColumns, ...rightColumns],\n    table,\n  )\n}\n\n/**\n * Returns footer groups for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getFooterGroups(table)\n * ```\n */\nexport function table_getFooterGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return [...headerGroups].reverse()\n}\n\n/**\n * Returns flat headers for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getFlatHeaders(table)\n * ```\n */\nexport function table_getFlatHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  const result: Array<Header<TFeatures, TData, unknown>> = []\n  for (let i = 0; i < headerGroups.length; i++) {\n    const headers = headerGroups[i]!.headers\n    for (let j = 0; j < headers.length; j++) {\n      result.push(headers[j]!)\n    }\n  }\n  return result\n}\n\n/**\n * Returns leaf headers for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getLeafHeaders(table)\n * ```\n */\nexport function table_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const topHeaders = table.getHeaderGroups()[0]?.headers ?? []\n  const result: Array<Header<TFeatures, TData, unknown>> = []\n  for (let i = 0; i < topHeaders.length; i++) {\n    const leafHeaders = topHeaders[i]!.getLeafHeaders()\n    for (let j = 0; j < leafHeaders.length; j++) {\n      result.push(leafHeaders[j]!)\n    }\n  }\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAwBA,SAAgB,sBAId,QAA0C;CAC1C,MAAM,cAAuD,EAAE;CAE/D,MAAM,iBAAiB,MAA+C;EACpE,IAAI,EAAE,WAAW,QACf,EAAE,WAAW,IAAI,cAAc;EAEjC,YAAY,KAAK,EAAsC;;CAGzD,cAAc,OAAO;CAErB,OAAO;;;;;;;;;;;;AAaT,SAAgB,kBAId,QAA0C;CAC1C,OAAO;EACL,QAAQ,OAAO;EACf;EACA,OAAO,OAAO,OAAO;EACtB;;;;;;;;;;;;AAaH,SAAgB,sBAGd,OAAyC;;CACzC,MAAM,EAAE,MAAM,oCACZ,MAAM,MAAM,6FAAe,KAAK,KAAI,8BAA8B;CACpE,MAAM,aAAa,MAAM,eAAe;CACxC,MAAM,cAAc,mBAClB,OACA,yBACA,4BACD;CAGD,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,QACzB,OAAO,kBAAkB,YAAY,aAAa,MAAM;CAG1D,MAAM,kBAAkB,MAAM,uBAAuB;CAErD,MAAM,cAAkC,EAAE;CAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,SAAS,gBAAgB,KAAK;EACpC,IACE,UACA,mBAAmB,QAAQ,gBAAgB,oBAAoB,EAE/D,YAAY,KAAK,OAAO;;CAI5B,MAAM,eAAmC,EAAE;CAC3C,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,SAAS,gBAAgB,MAAM;EACrC,IACE,UACA,mBAAmB,QAAQ,gBAAgB,oBAAoB,EAE/D,aAAa,KAAK,OAAO;;CAI7B,MAAM,gBAAgB,YAAY,QAC/B,WAAW,CAAC,KAAK,SAAS,OAAO,GAAG,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG,CACpE;CAED,OAAO,kBACL,YACA;EAAC,GAAG;EAAa,GAAG;EAAe,GAAG;EAAa,EACnD,MACD;;;;;;;;;;;;AAaH,SAAgB,sBAGd,OAAyC;CAEzC,OAAO,CAAC,GADa,MAAM,iBACJ,CAAC,CAAC,SAAS;;;;;;;;;;;;AAapC,SAAgB,qBAGd,OAAyC;CACzC,MAAM,eAAe,MAAM,iBAAiB;CAC5C,MAAM,SAAmD,EAAE;CAC3D,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;EAC5C,MAAM,UAAU,aAAa,GAAI;EACjC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,OAAO,KAAK,QAAQ,GAAI;;CAG5B,OAAO;;;;;;;;;;;;AAaT,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,uCAAa,MAAM,iBAAiB,CAAC,kFAAI,YAAW,EAAE;CAC5D,MAAM,SAAmD,EAAE;CAC3D,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;EAC1C,MAAM,cAAc,WAAW,GAAI,gBAAgB;EACnD,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KACtC,OAAO,KAAK,YAAY,GAAI;;CAGhC,OAAO"}

package/dist/core/reactivity/coreReactivityFeature.types.d.cts

@@ -32,6 +32,10 @@ interface TableReactivityBindings {
    * Batches reactive updates to avoid intermediate recomputation.
    */
   batch: (fn: () => void) => void;
+  /**
+   * Schedules a function to run. This is used to defer updates after the current call stack (render, etc.) has finished
+   */
+  schedule: (fn: () => void) => void;
 }
 //#endregion
 export { TableAtomOptions, TableReactivityBindings };

package/dist/core/reactivity/coreReactivityFeature.types.d.ts

@@ -32,6 +32,10 @@ interface TableReactivityBindings {
    * Batches reactive updates to avoid intermediate recomputation.
    */
   batch: (fn: () => void) => void;
+  /**
+   * Schedules a function to run. This is used to defer updates after the current call stack (render, etc.) has finished
+   */
+  schedule: (fn: () => void) => void;
 }
 //#endregion
 export { TableAtomOptions, TableReactivityBindings };

package/dist/core/reactivity/coreReactivityFeature.utils.cjs

@@ -4,6 +4,11 @@
 * Bridges atom instances to the `Store`/`ReadonlyStore` API by exposing
 * a `state` getter backed by `atom.get()`, and wiring `setState` for
 * writable atoms.
+*
+* @example
+* ```ts
+* const store = atomToStore(atom)
+* ```
 */
 function atomToStore(atom) {
 	const store = atom;

package/dist/core/reactivity/coreReactivityFeature.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"coreReactivityFeature.utils.cjs","names":[],"sources":["../../../src/core/reactivity/coreReactivityFeature.utils.ts"],"sourcesContent":["import type { Atom, ReadonlyAtom, ReadonlyStore, Store } from '@tanstack/store'\n\n/**\n * Converts a writable atom to the store-compatible shape expected by core.\n */\nexport function atomToStore<T>(atom: Atom<T>): Store<T>\n/**\n * Converts a readonly atom to a readonly store-compatible shape.\n */\nexport function atomToStore<T>(atom: ReadonlyAtom<T>): ReadonlyStore<T>\n/**\n * Bridges atom instances to the `Store`/`ReadonlyStore` API by exposing\n * a `state` getter backed by `atom.get()`, and wiring `setState` for\n * writable atoms.\n */\nexport function atomToStore<T>(\n  atom: Atom<T> | ReadonlyAtom<T>,\n): Store<T> | ReadonlyStore<T> {\n  const store: Store<T> = atom as Store<T>\n  Object.defineProperty(atom, 'state', {\n    get() {\n      return atom.get()\n    },\n  })\n  if ('set' in atom) {\n    store.setState = atom.set.bind(atom)\n  }\n  return store\n}\n"],"mappings":";;;;;;;AAeA,SAAgB,YACd,MAC6B;CAC7B,MAAM,QAAkB;AACxB,QAAO,eAAe,MAAM,SAAS,EACnC,MAAM;AACJ,SAAO,KAAK,KAAK;IAEpB,CAAC;AACF,KAAI,SAAS,KACX,OAAM,WAAW,KAAK,IAAI,KAAK,KAAK;AAEtC,QAAO"}
+{"version":3,"file":"coreReactivityFeature.utils.cjs","names":[],"sources":["../../../src/core/reactivity/coreReactivityFeature.utils.ts"],"sourcesContent":["import type { Atom, ReadonlyAtom, ReadonlyStore, Store } from '@tanstack/store'\n\n/**\n * Converts a writable atom to the store-compatible shape expected by core.\n *\n * @example\n * ```ts\n * const store = atomToStore(atom)\n * ```\n */\nexport function atomToStore<T>(atom: Atom<T>): Store<T>\n/**\n * Converts a readonly atom to a readonly store-compatible shape.\n *\n * @example\n * ```ts\n * const store = atomToStore(atom)\n * ```\n */\nexport function atomToStore<T>(atom: ReadonlyAtom<T>): ReadonlyStore<T>\n/**\n * Bridges atom instances to the `Store`/`ReadonlyStore` API by exposing\n * a `state` getter backed by `atom.get()`, and wiring `setState` for\n * writable atoms.\n *\n * @example\n * ```ts\n * const store = atomToStore(atom)\n * ```\n */\nexport function atomToStore<T>(\n  atom: Atom<T> | ReadonlyAtom<T>,\n): Store<T> | ReadonlyStore<T> {\n  const store: Store<T> = atom as Store<T>\n  Object.defineProperty(atom, 'state', {\n    get() {\n      return atom.get()\n    },\n  })\n  if ('set' in atom) {\n    store.setState = atom.set.bind(atom)\n  }\n  return store\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,SAAgB,YACd,MAC6B;CAC7B,MAAM,QAAkB;CACxB,OAAO,eAAe,MAAM,SAAS,EACnC,MAAM;EACJ,OAAO,KAAK,KAAK;IAEpB,CAAC;CACF,IAAI,SAAS,MACX,MAAM,WAAW,KAAK,IAAI,KAAK,KAAK;CAEtC,OAAO"}

package/dist/core/reactivity/coreReactivityFeature.utils.d.cts

@@ -3,10 +3,20 @@ import { Atom, ReadonlyAtom, ReadonlyStore, Store } from "@tanstack/store";
 //#region src/core/reactivity/coreReactivityFeature.utils.d.ts
 /**
  * Converts a writable atom to the store-compatible shape expected by core.
+ *
+ * @example
+ * ```ts
+ * const store = atomToStore(atom)
+ * ```
  */
 declare function atomToStore<T>(atom: Atom<T>): Store<T>;
 /**
  * Converts a readonly atom to a readonly store-compatible shape.
+ *
+ * @example
+ * ```ts
+ * const store = atomToStore(atom)
+ * ```
  */
 declare function atomToStore<T>(atom: ReadonlyAtom<T>): ReadonlyStore<T>;
 //#endregion