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

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

@@ -8,19 +8,21 @@ import { Table } from "../../types/Table.cjs";
 //#region src/core/headers/coreHeadersFeature.types.d.ts
 interface Table_Headers<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Returns all header groups for the table.
+   * Builds the visible header groups for the current column tree, visibility,
+   * and pinning state.
    */
   getHeaderGroups: () => Array<HeaderGroup<TFeatures, TData>>;
   /**
-   * Returns the footer groups for the table.
+   * Builds footer groups by reversing the current header group order.
    */
   getFooterGroups: () => Array<HeaderGroup<TFeatures, TData>>;
   /**
-   * Returns headers for all columns in the table, including parent headers.
+   * Flattens every header from every header group, including parent and
+   * placeholder headers.
    */
   getFlatHeaders: () => Array<Header<TFeatures, TData, unknown>>;
   /**
-   * Returns headers for all leaf columns in the table, (not including parent headers).
+   * Collects only leaf headers, excluding parent/group headers.
    */
   getLeafHeaders: () => Array<Header<TFeatures, TData, unknown>>;
 }

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

@@ -8,19 +8,21 @@ import { Table } from "../../types/Table.js";
 //#region src/core/headers/coreHeadersFeature.types.d.ts
 interface Table_Headers<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Returns all header groups for the table.
+   * Builds the visible header groups for the current column tree, visibility,
+   * and pinning state.
    */
   getHeaderGroups: () => Array<HeaderGroup<TFeatures, TData>>;
   /**
-   * Returns the footer groups for the table.
+   * Builds footer groups by reversing the current header group order.
    */
   getFooterGroups: () => Array<HeaderGroup<TFeatures, TData>>;
   /**
-   * Returns headers for all columns in the table, including parent headers.
+   * Flattens every header from every header group, including parent and
+   * placeholder headers.
    */
   getFlatHeaders: () => Array<Header<TFeatures, TData, unknown>>;
   /**
-   * Returns headers for all leaf columns in the table, (not including parent headers).
+   * Collects only leaf headers, excluding parent/group headers.
    */
   getLeafHeaders: () => Array<Header<TFeatures, TData, unknown>>;
 }

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

@@ -5,13 +5,14 @@ const require_columnPinningFeature_utils = require('../../features/column-pinnin
 
 //#region src/core/headers/coreHeadersFeature.utils.ts
 /**
-* Returns leaf headers for a header.
+* Walks a header tree and collects all descendant leaf headers.
 *
-* This is the static implementation behind the matching header instance API and can account for nested header groups.
+* The header itself is included after its descendants, matching the recursive
+* shape used by nested header groups.
 *
 * @example
 * ```ts
-* const value = header_getLeafHeaders(header)
+* const leafHeaders = header_getLeafHeaders(header)
 * ```
 */
 function header_getLeafHeaders(header) {
@@ -24,13 +25,13 @@ function header_getLeafHeaders(header) {
 	return leafHeaders;
 }
 /**
-* Returns context for a header.
+* Builds the render context passed to a column's `header` or `footer` template.
 *
-* This is the static implementation behind the matching header instance API and can account for nested header groups.
+* The context contains the header, its column, and the owning table instance.
 *
 * @example
 * ```ts
-* const value = header_getContext(header)
+* const context = header_getContext(header)
 * ```
 */
 function header_getContext(header) {
@@ -41,13 +42,14 @@ function header_getContext(header) {
 	};
 }
 /**
-* Returns header groups for the table.
+* Builds visible header groups for the current column tree.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Column visibility and pinning are applied before groups are built. When no
+* columns are pinned, the fast path skips pin partitioning.
 *
 * @example
 * ```ts
-* const value = table_getHeaderGroups(table)
+* const headerGroups = table_getHeaderGroups(table)
 * ```
 */
 function table_getHeaderGroups(table) {
@@ -55,15 +57,16 @@ function table_getHeaderGroups(table) {
 	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);
+	if (!left.length && !right.length) return require_buildHeaderGroups.buildHeaderGroups(allColumns, leafColumns, table);
 	const leafColumnsById = table.getAllLeafColumnsById();
 	const leftColumns = [];
-	for (const columnId of left) {
-		const column = leafColumnsById[columnId];
+	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 (const columnId of right) {
-		const column = leafColumnsById[columnId];
+	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));
@@ -74,55 +77,59 @@ function table_getHeaderGroups(table) {
 	], table);
 }
 /**
-* Returns footer groups for the table.
+* Builds footer groups by reversing the current header groups.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Footer rendering uses the same header objects and grouping structure, but
+* renders them from leaf level back toward the root.
 *
 * @example
 * ```ts
-* const value = table_getFooterGroups(table)
+* const footerGroups = table_getFooterGroups(table)
 * ```
 */
 function table_getFooterGroups(table) {
 	return [...table.getHeaderGroups()].reverse();
 }
 /**
-* Returns flat headers for the table.
+* Flattens every header from every header group into one array.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* The result includes parent headers and placeholder headers, in header-group
+* order from top to bottom.
 *
 * @example
 * ```ts
-* const value = table_getFlatHeaders(table)
+* const flatHeaders = 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.
+* Collects only the leaf headers from the current header tree.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Parent/group headers are skipped, making the result suitable for rendering
+* one header per visible leaf column.
 *
 * @example
 * ```ts
-* const value = table_getLeafHeaders(table)
+* const leafHeaders = 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","column_getIsVisible","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 {\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  const leafColumnsById = table.getAllLeafColumnsById()\n\n  const leftColumns: typeof leafColumns = []\n  for (const columnId of left) {\n    const column = leafColumnsById[columnId]\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 (const columnId of right) {\n    const column = leafColumnsById[columnId]\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  const headerGroups = buildHeaderGroups(\n    allColumns,\n    [...leftColumns, ...centerColumns, ...rightColumns],\n    table,\n  )\n\n  return headerGroups\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  return headerGroups\n    .map((headerGroup) => {\n      return headerGroup.headers\n    })\n    .flat()\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 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":";;;;;;;;;;;;;;;;AA6BA,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;CACD,MAAM,kBAAkB,MAAM,uBAAuB;CAErD,MAAM,cAAkC,EAAE;CAC1C,KAAK,MAAM,YAAY,MAAM;EAC3B,MAAM,SAAS,gBAAgB;EAC/B,IACE,UACAD,iCAAmB,QAAQ,gBAAgBE,0DAAoB,EAE/D,YAAY,KAAK,OAAO;;CAI5B,MAAM,eAAmC,EAAE;CAC3C,KAAK,MAAM,YAAY,OAAO;EAC5B,MAAM,SAAS,gBAAgB;EAC/B,IACE,UACAF,iCAAmB,QAAQ,gBAAgBE,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;CAQD,OANqBC,4CACnB,YACA;EAAC,GAAG;EAAa,GAAG;EAAe,GAAG;EAAa,EACnD,MAGiB;;;;;;;;;;;;AAarB,SAAgB,sBAGd,OAAyC;CAEzC,OAAO,CAAC,GADa,MAAM,iBACJ,CAAC,CAAC,SAAS;;;;;;;;;;;;AAapC,SAAgB,qBAGd,OAAyC;CAEzC,OADqB,MAAM,iBACR,CAChB,KAAK,gBAAgB;EACpB,OAAO,YAAY;GACnB,CACD,MAAM;;;;;;;;;;;;AAaX,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,OAAOH,iCACX,OACA,uBACAI,6DACD;CACD,MAAM,SAASJ,iCACb,OACA,yBACAK,+DACD;CACD,MAAM,QAAQL,iCACZ,OACA,wBACAM,8DACD;CAED,OAAO;EACL,cAAI,KAAK,oDAAI,YAAW,EAAE;EAC1B,gBAAI,OAAO,wDAAI,YAAW,EAAE;EAC5B,eAAI,MAAM,sDAAI,YAAW,EAAE;EAC5B,CACE,KAAK,WAAW;EACf,OAAO,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 * Walks a header tree and collects all descendant leaf headers.\n *\n * The header itself is included after its descendants, matching the recursive\n * shape used by nested header groups.\n *\n * @example\n * ```ts\n * const leafHeaders = 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 * Builds the render context passed to a column's `header` or `footer` template.\n *\n * The context contains the header, its column, and the owning table instance.\n *\n * @example\n * ```ts\n * const context = 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 * Builds visible header groups for the current column tree.\n *\n * Column visibility and pinning are applied before groups are built. When no\n * columns are pinned, the fast path skips pin partitioning.\n *\n * @example\n * ```ts\n * const headerGroups = 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 * Builds footer groups by reversing the current header groups.\n *\n * Footer rendering uses the same header objects and grouping structure, but\n * renders them from leaf level back toward the root.\n *\n * @example\n * ```ts\n * const footerGroups = 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 * Flattens every header from every header group into one array.\n *\n * The result includes parent headers and placeholder headers, in header-group\n * order from top to bottom.\n *\n * @example\n * ```ts\n * const flatHeaders = 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 * Collects only the leaf headers from the current header tree.\n *\n * Parent/group headers are skipped, making the result suitable for rendering\n * one header per visible leaf column.\n *\n * @example\n * ```ts\n * const leafHeaders = 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":";;;;;;;;;;;;;;;;;AAyBA,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;;;;;;;;;;;;;AAcH,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;;;;;;;;;;;;;AAcH,SAAgB,sBAGd,OAAyC;CAEzC,OAAO,CAAC,GADa,MAAM,iBACJ,CAAC,CAAC,SAAS;;;;;;;;;;;;;AAcpC,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;;;;;;;;;;;;;AAcT,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

@@ -6,24 +6,25 @@ 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.
+ * Walks a header tree and collects all descendant leaf headers.
  *
- * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ * The header itself is included after its descendants, matching the recursive
+ * shape used by nested header groups.
  *
  * @example
  * ```ts
- * const value = header_getLeafHeaders(header)
+ * const leafHeaders = 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.
+ * Builds the render context passed to a column's `header` or `footer` template.
  *
- * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ * The context contains the header, its column, and the owning table instance.
  *
  * @example
  * ```ts
- * const value = header_getContext(header)
+ * const context = header_getContext(header)
  * ```
  */
 declare function header_getContext<TFeatures extends TableFeatures, TData extends RowData, TValue>(header: Header<TFeatures, TData, TValue>): {
@@ -32,49 +33,53 @@ declare function header_getContext<TFeatures extends TableFeatures, TData extend
   table: Table_Internal<TFeatures, TData>;
 };
 /**
- * Returns header groups for the table.
+ * Builds visible header groups for the current column tree.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Column visibility and pinning are applied before groups are built. When no
+ * columns are pinned, the fast path skips pin partitioning.
  *
  * @example
  * ```ts
- * const value = table_getHeaderGroups(table)
+ * const headerGroups = 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.
+ * Builds footer groups by reversing the current header groups.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Footer rendering uses the same header objects and grouping structure, but
+ * renders them from leaf level back toward the root.
  *
  * @example
  * ```ts
- * const value = table_getFooterGroups(table)
+ * const footerGroups = 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.
+ * Flattens every header from every header group into one array.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * The result includes parent headers and placeholder headers, in header-group
+ * order from top to bottom.
  *
  * @example
  * ```ts
- * const value = table_getFlatHeaders(table)
+ * const flatHeaders = table_getFlatHeaders(table)
  * ```
  */
 declare function table_getFlatHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Header<TFeatures, TData, unknown>[];
 /**
- * Returns leaf headers for the table.
+ * Collects only the leaf headers from the current header tree.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Parent/group headers are skipped, making the result suitable for rendering
+ * one header per visible leaf column.
  *
  * @example
  * ```ts
- * const value = table_getLeafHeaders(table)
+ * const leafHeaders = table_getLeafHeaders(table)
  * ```
  */
-declare function table_getLeafHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): any[];
+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

@@ -6,24 +6,25 @@ 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.
+ * Walks a header tree and collects all descendant leaf headers.
  *
- * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ * The header itself is included after its descendants, matching the recursive
+ * shape used by nested header groups.
  *
  * @example
  * ```ts
- * const value = header_getLeafHeaders(header)
+ * const leafHeaders = 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.
+ * Builds the render context passed to a column's `header` or `footer` template.
  *
- * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ * The context contains the header, its column, and the owning table instance.
  *
  * @example
  * ```ts
- * const value = header_getContext(header)
+ * const context = header_getContext(header)
  * ```
  */
 declare function header_getContext<TFeatures extends TableFeatures, TData extends RowData, TValue>(header: Header<TFeatures, TData, TValue>): {
@@ -32,49 +33,53 @@ declare function header_getContext<TFeatures extends TableFeatures, TData extend
   table: Table_Internal<TFeatures, TData>;
 };
 /**
- * Returns header groups for the table.
+ * Builds visible header groups for the current column tree.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Column visibility and pinning are applied before groups are built. When no
+ * columns are pinned, the fast path skips pin partitioning.
  *
  * @example
  * ```ts
- * const value = table_getHeaderGroups(table)
+ * const headerGroups = 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.
+ * Builds footer groups by reversing the current header groups.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Footer rendering uses the same header objects and grouping structure, but
+ * renders them from leaf level back toward the root.
  *
  * @example
  * ```ts
- * const value = table_getFooterGroups(table)
+ * const footerGroups = 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.
+ * Flattens every header from every header group into one array.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * The result includes parent headers and placeholder headers, in header-group
+ * order from top to bottom.
  *
  * @example
  * ```ts
- * const value = table_getFlatHeaders(table)
+ * const flatHeaders = table_getFlatHeaders(table)
  * ```
  */
 declare function table_getFlatHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Header<TFeatures, TData, unknown>[];
 /**
- * Returns leaf headers for the table.
+ * Collects only the leaf headers from the current header tree.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Parent/group headers are skipped, making the result suitable for rendering
+ * one header per visible leaf column.
  *
  * @example
  * ```ts
- * const value = table_getLeafHeaders(table)
+ * const leafHeaders = table_getLeafHeaders(table)
  * ```
  */
-declare function table_getLeafHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): any[];
+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,17 +1,18 @@
 import { callMemoOrStaticFn } from "../../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.
+* Walks a header tree and collects all descendant leaf headers.
 *
-* This is the static implementation behind the matching header instance API and can account for nested header groups.
+* The header itself is included after its descendants, matching the recursive
+* shape used by nested header groups.
 *
 * @example
 * ```ts
-* const value = header_getLeafHeaders(header)
+* const leafHeaders = header_getLeafHeaders(header)
 * ```
 */
 function header_getLeafHeaders(header) {
@@ -24,13 +25,13 @@ function header_getLeafHeaders(header) {
 	return leafHeaders;
 }
 /**
-* Returns context for a header.
+* Builds the render context passed to a column's `header` or `footer` template.
 *
-* This is the static implementation behind the matching header instance API and can account for nested header groups.
+* The context contains the header, its column, and the owning table instance.
 *
 * @example
 * ```ts
-* const value = header_getContext(header)
+* const context = header_getContext(header)
 * ```
 */
 function header_getContext(header) {
@@ -41,13 +42,14 @@ function header_getContext(header) {
 	};
 }
 /**
-* Returns header groups for the table.
+* Builds visible header groups for the current column tree.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Column visibility and pinning are applied before groups are built. When no
+* columns are pinned, the fast path skips pin partitioning.
 *
 * @example
 * ```ts
-* const value = table_getHeaderGroups(table)
+* const headerGroups = table_getHeaderGroups(table)
 * ```
 */
 function table_getHeaderGroups(table) {
@@ -55,15 +57,16 @@ function table_getHeaderGroups(table) {
 	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);
+	if (!left.length && !right.length) return buildHeaderGroups(allColumns, leafColumns, table);
 	const leafColumnsById = table.getAllLeafColumnsById();
 	const leftColumns = [];
-	for (const columnId of left) {
-		const column = leafColumnsById[columnId];
+	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 (const columnId of right) {
-		const column = leafColumnsById[columnId];
+	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));
@@ -74,55 +77,59 @@ function table_getHeaderGroups(table) {
 	], table);
 }
 /**
-* Returns footer groups for the table.
+* Builds footer groups by reversing the current header groups.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Footer rendering uses the same header objects and grouping structure, but
+* renders them from leaf level back toward the root.
 *
 * @example
 * ```ts
-* const value = table_getFooterGroups(table)
+* const footerGroups = table_getFooterGroups(table)
 * ```
 */
 function table_getFooterGroups(table) {
 	return [...table.getHeaderGroups()].reverse();
 }
 /**
-* Returns flat headers for the table.
+* Flattens every header from every header group into one array.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* The result includes parent headers and placeholder headers, in header-group
+* order from top to bottom.
 *
 * @example
 * ```ts
-* const value = table_getFlatHeaders(table)
+* const flatHeaders = 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.
+* Collects only the leaf headers from the current header tree.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Parent/group headers are skipped, making the result suitable for rendering
+* one header per visible leaf column.
 *
 * @example
 * ```ts
-* const value = table_getLeafHeaders(table)
+* const leafHeaders = 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