@tanstack/table-core 9.0.0-alpha.8 → 9.0.0-beta.10

package/dist/core/headers/coreHeadersFeature.js

@@ -0,0 +1,55 @@
+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
+/**
+* Core feature that builds header groups and exposes header context APIs.
+*/
+const coreHeadersFeature = {
+	assignHeaderPrototype: (prototype, table) => {
+		assignPrototypeAPIs("coreHeadersFeature", prototype, table, {
+			header_getLeafHeaders: {
+				fn: (header) => header_getLeafHeaders(header),
+				memoDeps: (header) => [header.column.table.options.columns]
+			},
+			header_getContext: {
+				fn: (header) => header_getContext(header),
+				memoDeps: (header) => [header.column.table.options.columns]
+			}
+		});
+	},
+	constructTableAPIs: (table) => {
+		assignTableAPIs("coreHeadersFeature", table, {
+			table_getHeaderGroups: {
+				fn: () => table_getHeaderGroups(table),
+				memoDeps: () => {
+					var _table$atoms$columnOr, _table$atoms$grouping, _table$atoms$columnPi, _table$atoms$columnVi;
+					return [
+						table.options.columns,
+						(_table$atoms$columnOr = table.atoms.columnOrder) === null || _table$atoms$columnOr === void 0 ? void 0 : _table$atoms$columnOr.get(),
+						(_table$atoms$grouping = table.atoms.grouping) === null || _table$atoms$grouping === void 0 ? void 0 : _table$atoms$grouping.get(),
+						(_table$atoms$columnPi = table.atoms.columnPinning) === null || _table$atoms$columnPi === void 0 ? void 0 : _table$atoms$columnPi.get(),
+						(_table$atoms$columnVi = table.atoms.columnVisibility) === null || _table$atoms$columnVi === void 0 ? void 0 : _table$atoms$columnVi.get(),
+						table.options.groupedColumnMode
+					];
+				}
+			},
+			table_getFooterGroups: {
+				fn: () => table_getFooterGroups(table),
+				memoDeps: () => [table.getHeaderGroups()]
+			},
+			table_getFlatHeaders: {
+				fn: () => table_getFlatHeaders(table),
+				memoDeps: () => [table.getHeaderGroups()]
+			},
+			table_getLeafHeaders: {
+				fn: () => table_getLeafHeaders(table),
+				memoDeps: () => [table.getHeaderGroups()]
+			}
+		});
+	}
+};
+
+//#endregion
+export { coreHeadersFeature };
+//# sourceMappingURL=coreHeadersFeature.js.map

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

@@ -0,0 +1 @@
+{"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 { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Core feature that builds header groups and exposes header context APIs.\n */\nexport const coreHeadersFeature: TableFeature = {\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"],"mappings":";;;;;;;AAcA,MAAa,qBAAmC;CAC9C,wBAAwB,WAAW,UAAU;EAC3C,oBAAoB,sBAAsB,WAAW,OAAO;GAC1D,uBAAuB;IACrB,KAAK,WAAW,sBAAsB,MAAM;IAC5C,WAAW,WAAW,CAAC,OAAO,OAAO,MAAM,QAAQ,OAAO;GAC5D;GACA,mBAAmB;IACjB,KAAK,WAAW,kBAAkB,MAAM;IACxC,WAAW,WAAW,CAAC,OAAO,OAAO,MAAM,QAAQ,OAAO;GAC5D;EACF,CAAC;CACH;CAEA,qBAAqB,UAAU;EAC7B,gBAAgB,sBAAsB,OAAO;GAC3C,uBAAuB;IACrB,UAAU,sBAAsB,KAAK;IACrC,gBAAgB;;;MACd,MAAM,QAAQ;+BACd,MAAM,MAAM,2FAAa,IAAI;+BAC7B,MAAM,MAAM,wFAAU,IAAI;+BAC1B,MAAM,MAAM,6FAAe,IAAI;+BAC/B,MAAM,MAAM,gGAAkB,IAAI;MAClC,MAAM,QAAQ;KAChB;;GACF;GACA,uBAAuB;IACrB,UAAU,sBAAsB,KAAK;IACrC,gBAAgB,CAAC,MAAM,gBAAgB,CAAC;GAC1C;GACA,sBAAsB;IACpB,UAAU,qBAAqB,KAAK;IACpC,gBAAgB,CAAC,MAAM,gBAAgB,CAAC;GAC1C;GACA,sBAAsB;IACpB,UAAU,qBAAqB,KAAK;IACpC,gBAAgB,CAAC,MAAM,gBAAgB,CAAC;GAC1C;EACF,CAAC;CACH;AACF"}

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

@@ -0,0 +1,106 @@
+import { CellData, RowData } from "../../types/type-utils.cjs";
+import { HeaderGroup } from "../../types/HeaderGroup.cjs";
+import { Header } from "../../types/Header.cjs";
+import { Column } from "../../types/Column.cjs";
+import { Table } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/core/headers/coreHeadersFeature.types.d.ts
+interface Table_Headers<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Builds the visible header groups for the current column tree, visibility,
+   * and pinning state.
+   */
+  getHeaderGroups: () => Array<HeaderGroup<TFeatures, TData>>;
+  /**
+   * Builds footer groups by reversing the current header group order.
+   */
+  getFooterGroups: () => Array<HeaderGroup<TFeatures, TData>>;
+  /**
+   * Flattens every header from every header group, including parent and
+   * placeholder headers.
+   */
+  getFlatHeaders: () => Array<Header<TFeatures, TData, unknown>>;
+  /**
+   * Collects only leaf headers, excluding parent/group headers.
+   */
+  getLeafHeaders: () => Array<Header<TFeatures, TData, unknown>>;
+}
+interface HeaderContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  /**
+   * An instance of a column.
+   */
+  column: Column<TFeatures, TData, TValue>;
+  /**
+   * An instance of a header.
+   */
+  header: Header<TFeatures, TData, TValue>;
+  /**
+   * The table instance.
+   */
+  table: Table<TFeatures, TData>;
+}
+interface Header_CoreProperties<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  /**
+   * The col-span for the header.
+   */
+  colSpan: number;
+  /**
+   * The header's associated column object.
+   */
+  column: Column<TFeatures, TData, TValue>;
+  /**
+   * The depth of the header, zero-indexed based.
+   */
+  depth: number;
+  /**
+   * The header's associated header group object.
+   */
+  headerGroup: HeaderGroup<TFeatures, TData> | null;
+  /**
+   * The unique identifier for the header.
+   */
+  id: string;
+  /**
+   * The index for the header within the header group.
+   */
+  index: number;
+  /**
+   * A boolean denoting if the header is a placeholder header.
+   */
+  isPlaceholder: boolean;
+  /**
+   * If the header is a placeholder header, this will be a unique header ID that does not conflict with any other headers across the table.
+   */
+  placeholderId?: string;
+  /**
+   * The row-span for the header.
+   */
+  rowSpan: number;
+  /**
+   * The header's hierarchical sub/child headers. Will be empty if the header's associated column is a leaf-column.
+   */
+  subHeaders: Array<Header<TFeatures, TData, TValue>>;
+  /**
+   * Reference to the parent table instance.
+   */
+  table: Table<TFeatures, TData>;
+}
+interface Header_Header<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> extends Header_CoreProperties<TFeatures, TData, TValue> {
+  /**
+   * Returns the rendering context (or props) for column-based components like headers, footers and filters.
+   */
+  getContext: () => HeaderContext<TFeatures, TData, TValue>;
+  /**
+   * Returns the leaf headers hierarchically nested under this header.
+   */
+  getLeafHeaders: () => Array<Header<TFeatures, TData, TValue>>;
+}
+interface HeaderGroup_Header<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  depth: number;
+  headers: Array<Header<TFeatures, TData, TValue>>;
+  id: string;
+}
+//#endregion
+export { HeaderContext, HeaderGroup_Header, Header_CoreProperties, Header_Header, Table_Headers };
+//# sourceMappingURL=coreHeadersFeature.types.d.cts.map

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

@@ -0,0 +1,106 @@
+import { CellData, RowData } from "../../types/type-utils.js";
+import { HeaderGroup } from "../../types/HeaderGroup.js";
+import { Header } from "../../types/Header.js";
+import { Column } from "../../types/Column.js";
+import { Table } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/core/headers/coreHeadersFeature.types.d.ts
+interface Table_Headers<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Builds the visible header groups for the current column tree, visibility,
+   * and pinning state.
+   */
+  getHeaderGroups: () => Array<HeaderGroup<TFeatures, TData>>;
+  /**
+   * Builds footer groups by reversing the current header group order.
+   */
+  getFooterGroups: () => Array<HeaderGroup<TFeatures, TData>>;
+  /**
+   * Flattens every header from every header group, including parent and
+   * placeholder headers.
+   */
+  getFlatHeaders: () => Array<Header<TFeatures, TData, unknown>>;
+  /**
+   * Collects only leaf headers, excluding parent/group headers.
+   */
+  getLeafHeaders: () => Array<Header<TFeatures, TData, unknown>>;
+}
+interface HeaderContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  /**
+   * An instance of a column.
+   */
+  column: Column<TFeatures, TData, TValue>;
+  /**
+   * An instance of a header.
+   */
+  header: Header<TFeatures, TData, TValue>;
+  /**
+   * The table instance.
+   */
+  table: Table<TFeatures, TData>;
+}
+interface Header_CoreProperties<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  /**
+   * The col-span for the header.
+   */
+  colSpan: number;
+  /**
+   * The header's associated column object.
+   */
+  column: Column<TFeatures, TData, TValue>;
+  /**
+   * The depth of the header, zero-indexed based.
+   */
+  depth: number;
+  /**
+   * The header's associated header group object.
+   */
+  headerGroup: HeaderGroup<TFeatures, TData> | null;
+  /**
+   * The unique identifier for the header.
+   */
+  id: string;
+  /**
+   * The index for the header within the header group.
+   */
+  index: number;
+  /**
+   * A boolean denoting if the header is a placeholder header.
+   */
+  isPlaceholder: boolean;
+  /**
+   * If the header is a placeholder header, this will be a unique header ID that does not conflict with any other headers across the table.
+   */
+  placeholderId?: string;
+  /**
+   * The row-span for the header.
+   */
+  rowSpan: number;
+  /**
+   * The header's hierarchical sub/child headers. Will be empty if the header's associated column is a leaf-column.
+   */
+  subHeaders: Array<Header<TFeatures, TData, TValue>>;
+  /**
+   * Reference to the parent table instance.
+   */
+  table: Table<TFeatures, TData>;
+}
+interface Header_Header<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> extends Header_CoreProperties<TFeatures, TData, TValue> {
+  /**
+   * Returns the rendering context (or props) for column-based components like headers, footers and filters.
+   */
+  getContext: () => HeaderContext<TFeatures, TData, TValue>;
+  /**
+   * Returns the leaf headers hierarchically nested under this header.
+   */
+  getLeafHeaders: () => Array<Header<TFeatures, TData, TValue>>;
+}
+interface HeaderGroup_Header<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  depth: number;
+  headers: Array<Header<TFeatures, TData, TValue>>;
+  id: string;
+}
+//#endregion
+export { HeaderContext, HeaderGroup_Header, Header_CoreProperties, Header_Header, Table_Headers };
+//# sourceMappingURL=coreHeadersFeature.types.d.ts.map

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

@@ -0,0 +1,142 @@
+const require_utils = require('../../utils.cjs');
+const require_columnVisibilityFeature_utils = require('../../features/column-visibility/columnVisibilityFeature.utils.cjs');
+const require_buildHeaderGroups = require('./buildHeaderGroups.cjs');
+const require_columnPinningFeature_utils = require('../../features/column-pinning/columnPinningFeature.utils.cjs');
+
+//#region src/core/headers/coreHeadersFeature.utils.ts
+/**
+* Walks a header tree and collects all descendant leaf headers.
+*
+* The header itself is included after its descendants, matching the recursive
+* shape used by nested header groups.
+*
+* @example
+* ```ts
+* const leafHeaders = header_getLeafHeaders(header)
+* ```
+*/
+function header_getLeafHeaders(header) {
+	const leafHeaders = [];
+	const recurseHeader = (h) => {
+		if (h.subHeaders.length) h.subHeaders.map(recurseHeader);
+		leafHeaders.push(h);
+	};
+	recurseHeader(header);
+	return leafHeaders;
+}
+/**
+* Builds the render context passed to a column's `header` or `footer` template.
+*
+* The context contains the header, its column, and the owning table instance.
+*
+* @example
+* ```ts
+* const context = header_getContext(header)
+* ```
+*/
+function header_getContext(header) {
+	return {
+		column: header.column,
+		header,
+		table: header.column.table
+	};
+}
+/**
+* Builds visible header groups for the current column tree.
+*
+* Column visibility and pinning are applied before groups are built. When no
+* columns are pinned, the fast path skips pin partitioning.
+*
+* @example
+* ```ts
+* const headerGroups = 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);
+	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,
+		...centerColumns,
+		...rightColumns
+	], table);
+}
+/**
+* Builds footer groups by reversing the current header groups.
+*
+* Footer rendering uses the same header objects and grouping structure, but
+* renders them from leaf level back toward the root.
+*
+* @example
+* ```ts
+* const footerGroups = table_getFooterGroups(table)
+* ```
+*/
+function table_getFooterGroups(table) {
+	return [...table.getHeaderGroups()].reverse();
+}
+/**
+* Flattens every header from every header group into one array.
+*
+* The result includes parent headers and placeholder headers, in header-group
+* order from top to bottom.
+*
+* @example
+* ```ts
+* const flatHeaders = table_getFlatHeaders(table)
+* ```
+*/
+function table_getFlatHeaders(table) {
+	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;
+}
+/**
+* Collects only the leaf headers from the current header tree.
+*
+* Parent/group headers are skipped, making the result suitable for rendering
+* one header per visible leaf column.
+*
+* @example
+* ```ts
+* const leafHeaders = table_getLeafHeaders(table)
+* ```
+*/
+function table_getLeafHeaders(table) {
+	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
+exports.header_getContext = header_getContext;
+exports.header_getLeafHeaders = header_getLeafHeaders;
+exports.table_getFlatHeaders = table_getFlatHeaders;
+exports.table_getFooterGroups = table_getFooterGroups;
+exports.table_getHeaderGroups = table_getHeaderGroups;
+exports.table_getLeafHeaders = table_getLeafHeaders;
+//# sourceMappingURL=coreHeadersFeature.utils.cjs.map

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

@@ -0,0 +1 @@
+{"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  )\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,CAAC;CAE9D,MAAM,iBAAiB,MAA+C;EACpE,IAAI,EAAE,WAAW,QACf,EAAE,WAAW,IAAI,aAAa;EAEhC,YAAY,KAAK,CAAqC;CACxD;CAEA,cAAc,MAAM;CAEpB,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,kBAId,QAA0C;CAC1C,OAAO;EACL,QAAQ,OAAO;EACf;EACA,OAAO,OAAO,OAAO;CACvB;AACF;;;;;;;;;;;;AAaA,SAAgB,sBAGd,OAAyC;;CACzC,MAAM,EAAE,MAAM,oCACZ,MAAM,MAAM,6FAAe,IAAI,MAAKA,gEAA6B;CACnE,MAAM,aAAa,MAAM,cAAc;CACvC,MAAM,cAAcC,iCAClB,OACA,yBACAC,iEACF;CAGA,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,QACzB,OAAOC,4CAAkB,YAAY,aAAa,KAAK;CAGzD,MAAM,kBAAkB,MAAM,sBAAsB;CAEpD,MAAM,cAAkC,CAAC;CACzC,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,SAAS,gBAAgB,KAAK;EACpC,IACE,UACAF,iCAAmB,QAAQ,gBAAgBG,yDAAmB,GAE9D,YAAY,KAAK,MAAM;CAE3B;CAEA,MAAM,eAAmC,CAAC;CAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,SAAS,gBAAgB,MAAM;EACrC,IACE,UACAH,iCAAmB,QAAQ,gBAAgBG,yDAAmB,GAE9D,aAAa,KAAK,MAAM;CAE5B;CAEA,MAAM,gBAAgB,YAAY,QAC/B,WAAW,CAAC,KAAK,SAAS,OAAO,EAAE,KAAK,CAAC,MAAM,SAAS,OAAO,EAAE,CACpE;CAEA,OAAOD,4CACL,YACA;EAAC,GAAG;EAAa,GAAG;EAAe,GAAG;CAAY,GAClD,KACF;AACF;;;;;;;;;;;;AAaA,SAAgB,sBAGd,OAAyC;CAEzC,OAAO,CAAC,GADa,MAAM,gBACL,CAAC,CAAC,CAAC,QAAQ;AACnC;;;;;;;;;;;;AAaA,SAAgB,qBAGd,OAAyC;CACzC,MAAM,eAAe,MAAM,gBAAgB;CAC3C,MAAM,SAAmD,CAAC;CAC1D,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;EAC5C,MAAM,UAAU,aAAa,EAAE,CAAE;EACjC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,OAAO,KAAK,QAAQ,EAAG;CAE3B;CACA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,uCAAa,MAAM,gBAAgB,CAAC,CAAC,kFAAI,YAAW,CAAC;CAC3D,MAAM,SAAmD,CAAC;CAC1D,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;EAC1C,MAAM,cAAc,WAAW,EAAE,CAAE,eAAe;EAClD,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KACtC,OAAO,KAAK,YAAY,EAAG;CAE/B;CACA,OAAO;AACT"}

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

@@ -0,0 +1,85 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { HeaderGroup } from "../../types/HeaderGroup.cjs";
+import { Header } from "../../types/Header.cjs";
+import { Column } from "../../types/Column.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+//#region src/core/headers/coreHeadersFeature.utils.d.ts
+/**
+ * Walks a header tree and collects all descendant leaf headers.
+ *
+ * The header itself is included after its descendants, matching the recursive
+ * shape used by nested header groups.
+ *
+ * @example
+ * ```ts
+ * 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>[];
+/**
+ * Builds the render context passed to a column's `header` or `footer` template.
+ *
+ * The context contains the header, its column, and the owning table instance.
+ *
+ * @example
+ * ```ts
+ * const context = 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>;
+};
+/**
+ * Builds visible header groups for the current column tree.
+ *
+ * Column visibility and pinning are applied before groups are built. When no
+ * columns are pinned, the fast path skips pin partitioning.
+ *
+ * @example
+ * ```ts
+ * const headerGroups = table_getHeaderGroups(table)
+ * ```
+ */
+declare function table_getHeaderGroups<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): HeaderGroup<TFeatures, TData>[];
+/**
+ * Builds footer groups by reversing the current header groups.
+ *
+ * Footer rendering uses the same header objects and grouping structure, but
+ * renders them from leaf level back toward the root.
+ *
+ * @example
+ * ```ts
+ * const footerGroups = table_getFooterGroups(table)
+ * ```
+ */
+declare function table_getFooterGroups<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): HeaderGroup<TFeatures, TData>[];
+/**
+ * Flattens every header from every header group into one array.
+ *
+ * The result includes parent headers and placeholder headers, in header-group
+ * order from top to bottom.
+ *
+ * @example
+ * ```ts
+ * const flatHeaders = table_getFlatHeaders(table)
+ * ```
+ */
+declare function table_getFlatHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Header<TFeatures, TData, unknown>[];
+/**
+ * Collects only the leaf headers from the current header tree.
+ *
+ * Parent/group headers are skipped, making the result suitable for rendering
+ * one header per visible leaf column.
+ *
+ * @example
+ * ```ts
+ * const leafHeaders = 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

@@ -0,0 +1,85 @@
+import { RowData } from "../../types/type-utils.js";
+import { HeaderGroup } from "../../types/HeaderGroup.js";
+import { Header } from "../../types/Header.js";
+import { Column } from "../../types/Column.js";
+import { Table_Internal } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+//#region src/core/headers/coreHeadersFeature.utils.d.ts
+/**
+ * Walks a header tree and collects all descendant leaf headers.
+ *
+ * The header itself is included after its descendants, matching the recursive
+ * shape used by nested header groups.
+ *
+ * @example
+ * ```ts
+ * 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>[];
+/**
+ * Builds the render context passed to a column's `header` or `footer` template.
+ *
+ * The context contains the header, its column, and the owning table instance.
+ *
+ * @example
+ * ```ts
+ * const context = 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>;
+};
+/**
+ * Builds visible header groups for the current column tree.
+ *
+ * Column visibility and pinning are applied before groups are built. When no
+ * columns are pinned, the fast path skips pin partitioning.
+ *
+ * @example
+ * ```ts
+ * const headerGroups = table_getHeaderGroups(table)
+ * ```
+ */
+declare function table_getHeaderGroups<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): HeaderGroup<TFeatures, TData>[];
+/**
+ * Builds footer groups by reversing the current header groups.
+ *
+ * Footer rendering uses the same header objects and grouping structure, but
+ * renders them from leaf level back toward the root.
+ *
+ * @example
+ * ```ts
+ * const footerGroups = table_getFooterGroups(table)
+ * ```
+ */
+declare function table_getFooterGroups<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): HeaderGroup<TFeatures, TData>[];
+/**
+ * Flattens every header from every header group into one array.
+ *
+ * The result includes parent headers and placeholder headers, in header-group
+ * order from top to bottom.
+ *
+ * @example
+ * ```ts
+ * const flatHeaders = table_getFlatHeaders(table)
+ * ```
+ */
+declare function table_getFlatHeaders<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Header<TFeatures, TData, unknown>[];
+/**
+ * Collects only the leaf headers from the current header tree.
+ *
+ * Parent/group headers are skipped, making the result suitable for rendering
+ * one header per visible leaf column.
+ *
+ * @example
+ * ```ts
+ * const leafHeaders = 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