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

package/dist/core/coreFeatures.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreFeatures.cjs","names":[],"sources":["../../src/core/coreFeatures.ts"],"sourcesContent":["import { coreCellsFeature } from './cells/coreCellsFeature'\nimport { coreColumnsFeature } from './columns/coreColumnsFeature'\nimport { coreHeadersFeature } from './headers/coreHeadersFeature'\nimport { coreRowModelsFeature } from './row-models/coreRowModelsFeature'\nimport { coreRowsFeature } from './rows/coreRowsFeature'\nimport { coreTablesFeature } from './table/coreTablesFeature'\nimport type { TableReactivityBindings } from '../reactivity'\n\nexport interface CoreFeatures {\n  coreReactivityFeature?: TableReactivityBindings\n  coreCellsFeature: typeof coreCellsFeature\n  coreColumnsFeature: typeof coreColumnsFeature\n  coreHeadersFeature: typeof coreHeadersFeature\n  coreRowModelsFeature: typeof coreRowModelsFeature\n  coreRowsFeature: typeof coreRowsFeature\n  coreTablesFeature: typeof coreTablesFeature\n}\n\n/**\n * The built-in core feature set required by every table.\n *\n * These features provide table, column, row, header, cell, and core row-model behavior before optional feature plugins are added.\n */\nexport const coreFeatures: CoreFeatures = {\n  coreCellsFeature,\n  coreColumnsFeature,\n  coreHeadersFeature,\n  coreRowModelsFeature,\n  coreRowsFeature,\n  coreTablesFeature,\n}\n"],"mappings":";;;;;;;;;;;;;AAuBA,MAAa,eAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;AACF"}

package/dist/core/coreFeatures.d.cts

@@ -0,0 +1,26 @@
+import { coreCellsFeature } from "./cells/coreCellsFeature.cjs";
+import { coreColumnsFeature } from "./columns/coreColumnsFeature.cjs";
+import { coreHeadersFeature } from "./headers/coreHeadersFeature.cjs";
+import { coreRowModelsFeature } from "./row-models/coreRowModelsFeature.cjs";
+import { coreRowsFeature } from "./rows/coreRowsFeature.cjs";
+import { coreTablesFeature } from "./table/coreTablesFeature.cjs";
+import { TableReactivityBindings } from "./reactivity/coreReactivityFeature.types.cjs";
+//#region src/core/coreFeatures.d.ts
+interface CoreFeatures {
+  coreReactivityFeature?: TableReactivityBindings;
+  coreCellsFeature: typeof coreCellsFeature;
+  coreColumnsFeature: typeof coreColumnsFeature;
+  coreHeadersFeature: typeof coreHeadersFeature;
+  coreRowModelsFeature: typeof coreRowModelsFeature;
+  coreRowsFeature: typeof coreRowsFeature;
+  coreTablesFeature: typeof coreTablesFeature;
+}
+/**
+ * The built-in core feature set required by every table.
+ *
+ * These features provide table, column, row, header, cell, and core row-model behavior before optional feature plugins are added.
+ */
+declare const coreFeatures: CoreFeatures;
+//#endregion
+export { CoreFeatures, coreFeatures };
+//# sourceMappingURL=coreFeatures.d.cts.map

package/dist/core/coreFeatures.d.ts

@@ -0,0 +1,26 @@
+import { coreCellsFeature } from "./cells/coreCellsFeature.js";
+import { coreColumnsFeature } from "./columns/coreColumnsFeature.js";
+import { coreHeadersFeature } from "./headers/coreHeadersFeature.js";
+import { coreRowModelsFeature } from "./row-models/coreRowModelsFeature.js";
+import { coreRowsFeature } from "./rows/coreRowsFeature.js";
+import { coreTablesFeature } from "./table/coreTablesFeature.js";
+import { TableReactivityBindings } from "./reactivity/coreReactivityFeature.types.js";
+//#region src/core/coreFeatures.d.ts
+interface CoreFeatures {
+  coreReactivityFeature?: TableReactivityBindings;
+  coreCellsFeature: typeof coreCellsFeature;
+  coreColumnsFeature: typeof coreColumnsFeature;
+  coreHeadersFeature: typeof coreHeadersFeature;
+  coreRowModelsFeature: typeof coreRowModelsFeature;
+  coreRowsFeature: typeof coreRowsFeature;
+  coreTablesFeature: typeof coreTablesFeature;
+}
+/**
+ * The built-in core feature set required by every table.
+ *
+ * These features provide table, column, row, header, cell, and core row-model behavior before optional feature plugins are added.
+ */
+declare const coreFeatures: CoreFeatures;
+//#endregion
+export { CoreFeatures, coreFeatures };
+//# sourceMappingURL=coreFeatures.d.ts.map

package/dist/core/coreFeatures.js

@@ -0,0 +1,25 @@
+import { coreCellsFeature } from "./cells/coreCellsFeature.js";
+import { coreColumnsFeature } from "./columns/coreColumnsFeature.js";
+import { coreHeadersFeature } from "./headers/coreHeadersFeature.js";
+import { coreRowModelsFeature } from "./row-models/coreRowModelsFeature.js";
+import { coreRowsFeature } from "./rows/coreRowsFeature.js";
+import { coreTablesFeature } from "./table/coreTablesFeature.js";
+
+//#region src/core/coreFeatures.ts
+/**
+* The built-in core feature set required by every table.
+*
+* These features provide table, column, row, header, cell, and core row-model behavior before optional feature plugins are added.
+*/
+const coreFeatures = {
+	coreCellsFeature,
+	coreColumnsFeature,
+	coreHeadersFeature,
+	coreRowModelsFeature,
+	coreRowsFeature,
+	coreTablesFeature
+};
+
+//#endregion
+export { coreFeatures };
+//# sourceMappingURL=coreFeatures.js.map

package/dist/core/coreFeatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreFeatures.js","names":[],"sources":["../../src/core/coreFeatures.ts"],"sourcesContent":["import { coreCellsFeature } from './cells/coreCellsFeature'\nimport { coreColumnsFeature } from './columns/coreColumnsFeature'\nimport { coreHeadersFeature } from './headers/coreHeadersFeature'\nimport { coreRowModelsFeature } from './row-models/coreRowModelsFeature'\nimport { coreRowsFeature } from './rows/coreRowsFeature'\nimport { coreTablesFeature } from './table/coreTablesFeature'\nimport type { TableReactivityBindings } from '../reactivity'\n\nexport interface CoreFeatures {\n  coreReactivityFeature?: TableReactivityBindings\n  coreCellsFeature: typeof coreCellsFeature\n  coreColumnsFeature: typeof coreColumnsFeature\n  coreHeadersFeature: typeof coreHeadersFeature\n  coreRowModelsFeature: typeof coreRowModelsFeature\n  coreRowsFeature: typeof coreRowsFeature\n  coreTablesFeature: typeof coreTablesFeature\n}\n\n/**\n * The built-in core feature set required by every table.\n *\n * These features provide table, column, row, header, cell, and core row-model behavior before optional feature plugins are added.\n */\nexport const coreFeatures: CoreFeatures = {\n  coreCellsFeature,\n  coreColumnsFeature,\n  coreHeadersFeature,\n  coreRowModelsFeature,\n  coreRowsFeature,\n  coreTablesFeature,\n}\n"],"mappings":";;;;;;;;;;;;;AAuBA,MAAa,eAA6B;CACxC;CACA;CACA;CACA;CACA;CACA;AACF"}

package/dist/core/headers/buildHeaderGroups.cjs

@@ -0,0 +1,103 @@
+const require_utils = require('../../utils.cjs');
+const require_columnVisibilityFeature_utils = require('../../features/column-visibility/columnVisibilityFeature.utils.cjs');
+const require_constructHeader = require('./constructHeader.cjs');
+
+//#region src/core/headers/buildHeaderGroups.ts
+/**
+* Builds the nested header group structure for a table.
+*
+* The result accounts for visible leaf columns, pinned column groups, and placeholder headers needed to render multi-level headers.
+*/
+function buildHeaderGroups(allColumns, columnsToGroup, table, headerFamily) {
+	var _headerGroups$;
+	let maxDepth = 0;
+	const findMaxDepth = (columns, depth = 1) => {
+		maxDepth = Math.max(maxDepth, depth);
+		for (let i = 0; i < columns.length; i++) {
+			const column = columns[i];
+			if (require_utils.callMemoOrStaticFn(column, "getIsVisible", require_columnVisibilityFeature_utils.column_getIsVisible)) {
+				if (column.columns.length) findMaxDepth(column.columns, depth + 1);
+			}
+		}
+	};
+	findMaxDepth(allColumns);
+	const headerGroups = [];
+	const constructHeaderGroup = (headersToGroup, depth) => {
+		const headerGroup = {
+			depth,
+			id: [headerFamily, `${depth}`].filter(Boolean).join("_"),
+			headers: []
+		};
+		const pendingParentHeaders = [];
+		headersToGroup.forEach((headerToGroup) => {
+			const latestPendingParentHeader = pendingParentHeaders[pendingParentHeaders.length - 1];
+			const isLeafHeader = headerToGroup.column.depth === headerGroup.depth;
+			let column;
+			let isPlaceholder = false;
+			if (isLeafHeader && headerToGroup.column.parent) column = headerToGroup.column.parent;
+			else {
+				column = headerToGroup.column;
+				isPlaceholder = true;
+			}
+			if (latestPendingParentHeader && latestPendingParentHeader.column === column) latestPendingParentHeader.subHeaders.push(headerToGroup);
+			else {
+				const header = require_constructHeader.constructHeader(table, column, {
+					id: [
+						headerFamily,
+						depth,
+						column.id,
+						headerToGroup.id
+					].filter(Boolean).join("_"),
+					isPlaceholder,
+					placeholderId: isPlaceholder ? `${pendingParentHeaders.filter((d) => d.column === column).length}` : void 0,
+					depth,
+					index: pendingParentHeaders.length
+				});
+				header.subHeaders.push(headerToGroup);
+				pendingParentHeaders.push(header);
+			}
+			headerGroup.headers.push(headerToGroup);
+			headerToGroup.headerGroup = headerGroup;
+		});
+		headerGroups.push(headerGroup);
+		if (depth > 0) constructHeaderGroup(pendingParentHeaders, depth - 1);
+	};
+	constructHeaderGroup(columnsToGroup.map((column, index) => require_constructHeader.constructHeader(table, column, {
+		depth: maxDepth,
+		index
+	})), maxDepth - 1);
+	headerGroups.reverse();
+	const recurseHeadersForSpans = (headers) => {
+		const results = [];
+		for (let i = 0; i < headers.length; i++) {
+			const header = headers[i];
+			if (!require_utils.callMemoOrStaticFn(header.column, "getIsVisible", require_columnVisibilityFeature_utils.column_getIsVisible)) continue;
+			let colSpan = 0;
+			let minChildRowSpan = Infinity;
+			if (header.subHeaders.length) {
+				const childSpans = recurseHeadersForSpans(header.subHeaders);
+				for (let j = 0; j < childSpans.length; j++) {
+					const child = childSpans[j];
+					colSpan += child.colSpan;
+					if (child.rowSpan < minChildRowSpan) minChildRowSpan = child.rowSpan;
+				}
+			} else {
+				colSpan = 1;
+				minChildRowSpan = 0;
+			}
+			header.colSpan = colSpan;
+			header.rowSpan = minChildRowSpan;
+			results.push({
+				colSpan,
+				rowSpan: header.rowSpan
+			});
+		}
+		return results;
+	};
+	recurseHeadersForSpans(((_headerGroups$ = headerGroups[0]) === null || _headerGroups$ === void 0 ? void 0 : _headerGroups$.headers) ?? []);
+	return headerGroups;
+}
+
+//#endregion
+exports.buildHeaderGroups = buildHeaderGroups;
+//# sourceMappingURL=buildHeaderGroups.cjs.map

package/dist/core/headers/buildHeaderGroups.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildHeaderGroups.cjs","names":["callMemoOrStaticFn","column_getIsVisible","constructHeader"],"sources":["../../../src/core/headers/buildHeaderGroups.ts"],"sourcesContent":["import { callMemoOrStaticFn } from '../../utils'\nimport { column_getIsVisible } from '../../features/column-visibility/columnVisibilityFeature.utils'\nimport { constructHeader } from './constructHeader'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header } from '../../types/Header'\nimport type { HeaderGroup } from '../../types/HeaderGroup'\nimport type { Column } from '../../types/Column'\n\n/**\n * Builds the nested header group structure for a table.\n *\n * The result accounts for visible leaf columns, pinned column groups, and placeholder headers needed to render multi-level headers.\n */\nexport function buildHeaderGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  allColumns: Array<Column<TFeatures, TData, TValue>>,\n  columnsToGroup: Array<Column<TFeatures, TData, TValue>>,\n  table: Table_Internal<TFeatures, TData>,\n  headerFamily?: 'center' | 'left' | 'right',\n) {\n  // Find the max depth of the columns:\n  // build the leaf column row\n  // build each buffer row going up\n  //    placeholder for non-existent level\n  //    real column for existing level\n\n  let maxDepth = 0\n\n  const findMaxDepth = (\n    columns: Array<Column<TFeatures, TData, TValue>>,\n    depth = 1,\n  ) => {\n    maxDepth = Math.max(maxDepth, depth)\n\n    for (let i = 0; i < columns.length; i++) {\n      const column = columns[i]!\n      if (callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)) {\n        if (column.columns.length) {\n          findMaxDepth(column.columns, depth + 1)\n        }\n      }\n    }\n  }\n\n  findMaxDepth(allColumns)\n\n  const headerGroups: Array<HeaderGroup<TFeatures, TData>> = []\n\n  const constructHeaderGroup = (\n    headersToGroup: Array<Header<TFeatures, TData, TValue>>,\n    depth: number,\n  ) => {\n    // The header group we are creating\n    const headerGroup: HeaderGroup<TFeatures, TData> = {\n      depth,\n      id: [headerFamily, `${depth}`].filter(Boolean).join('_'),\n      headers: [],\n    }\n\n    // The parent columns we're going to scan next\n    const pendingParentHeaders: Array<Header<TFeatures, TData, TValue>> = []\n\n    // Scan each column for parents\n    headersToGroup.forEach((headerToGroup) => {\n      // What is the latest (last) parent column?\n\n      const latestPendingParentHeader =\n        pendingParentHeaders[pendingParentHeaders.length - 1]\n\n      const isLeafHeader = headerToGroup.column.depth === headerGroup.depth\n\n      let column: Column<TFeatures, TData, TValue>\n      let isPlaceholder = false\n\n      if (isLeafHeader && headerToGroup.column.parent) {\n        // The parent header is new\n        column = headerToGroup.column.parent\n      } else {\n        // The parent header is repeated\n        column = headerToGroup.column\n        isPlaceholder = true\n      }\n\n      if (\n        latestPendingParentHeader &&\n        latestPendingParentHeader.column === column\n      ) {\n        // This column is repeated. Add it as a sub header to the next batch\n        latestPendingParentHeader.subHeaders.push(headerToGroup)\n      } else {\n        // This is a new header. Let's create it\n        const header = constructHeader(table, column, {\n          id: [headerFamily, depth, column.id, headerToGroup.id]\n            .filter(Boolean)\n            .join('_'),\n          isPlaceholder,\n          placeholderId: isPlaceholder\n            ? `${pendingParentHeaders.filter((d) => d.column === column).length}`\n            : undefined,\n          depth,\n          index: pendingParentHeaders.length,\n        })\n\n        // Add the headerToGroup as a subHeader of the new header\n        header.subHeaders.push(headerToGroup)\n        // Add the new header to the pendingParentHeaders to get grouped\n        // in the next batch\n        pendingParentHeaders.push(header)\n      }\n\n      headerGroup.headers.push(headerToGroup)\n      headerToGroup.headerGroup = headerGroup\n    })\n\n    headerGroups.push(headerGroup)\n\n    if (depth > 0) {\n      constructHeaderGroup(pendingParentHeaders, depth - 1)\n    }\n  }\n\n  const bottomHeaders = columnsToGroup.map((column, index) =>\n    constructHeader(table, column, {\n      depth: maxDepth,\n      index,\n    }),\n  )\n\n  constructHeaderGroup(bottomHeaders, maxDepth - 1)\n\n  headerGroups.reverse()\n\n  const recurseHeadersForSpans = (\n    headers: Array<Header<TFeatures, TData, TValue>>,\n  ): Array<{ colSpan: number; rowSpan: number }> => {\n    const results: Array<{ colSpan: number; rowSpan: number }> = []\n\n    for (let i = 0; i < headers.length; i++) {\n      const header = headers[i]!\n      if (\n        !callMemoOrStaticFn(header.column, 'getIsVisible', column_getIsVisible)\n      ) {\n        continue\n      }\n\n      let colSpan = 0\n      let minChildRowSpan = Infinity\n\n      if (header.subHeaders.length) {\n        const childSpans = recurseHeadersForSpans(header.subHeaders)\n        for (let j = 0; j < childSpans.length; j++) {\n          const child = childSpans[j]!\n          colSpan += child.colSpan\n          if (child.rowSpan < minChildRowSpan) {\n            minChildRowSpan = child.rowSpan\n          }\n        }\n      } else {\n        colSpan = 1\n        minChildRowSpan = 0\n      }\n\n      header.colSpan = colSpan\n      header.rowSpan = minChildRowSpan\n\n      results.push({ colSpan, rowSpan: header.rowSpan })\n    }\n\n    return results\n  }\n\n  recurseHeadersForSpans(\n    (headerGroups[0]?.headers ?? []) as Array<Header<TFeatures, TData, TValue>>,\n  )\n\n  return headerGroups\n}\n"],"mappings":";;;;;;;;;;AAeA,SAAgB,kBAKd,YACA,gBACA,OACA,cACA;;CAOA,IAAI,WAAW;CAEf,MAAM,gBACJ,SACA,QAAQ,MACL;EACH,WAAW,KAAK,IAAI,UAAU,KAAK;EAEnC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;GACvC,MAAM,SAAS,QAAQ;GACvB,IAAIA,iCAAmB,QAAQ,gBAAgBC,yDAAmB,GAChE;QAAI,OAAO,QAAQ,QACjB,aAAa,OAAO,SAAS,QAAQ,CAAC;GACxC;EAEJ;CACF;CAEA,aAAa,UAAU;CAEvB,MAAM,eAAqD,CAAC;CAE5D,MAAM,wBACJ,gBACA,UACG;EAEH,MAAM,cAA6C;GACjD;GACA,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;GACvD,SAAS,CAAC;EACZ;EAGA,MAAM,uBAAgE,CAAC;EAGvE,eAAe,SAAS,kBAAkB;GAGxC,MAAM,4BACJ,qBAAqB,qBAAqB,SAAS;GAErD,MAAM,eAAe,cAAc,OAAO,UAAU,YAAY;GAEhE,IAAI;GACJ,IAAI,gBAAgB;GAEpB,IAAI,gBAAgB,cAAc,OAAO,QAEvC,SAAS,cAAc,OAAO;QACzB;IAEL,SAAS,cAAc;IACvB,gBAAgB;GAClB;GAEA,IACE,6BACA,0BAA0B,WAAW,QAGrC,0BAA0B,WAAW,KAAK,aAAa;QAClD;IAEL,MAAM,SAASC,wCAAgB,OAAO,QAAQ;KAC5C,IAAI;MAAC;MAAc;MAAO,OAAO;MAAI,cAAc;KAAE,CAAC,CACnD,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;KACX;KACA,eAAe,gBACX,GAAG,qBAAqB,QAAQ,MAAM,EAAE,WAAW,MAAM,CAAC,CAAC,WAC3D;KACJ;KACA,OAAO,qBAAqB;IAC9B,CAAC;IAGD,OAAO,WAAW,KAAK,aAAa;IAGpC,qBAAqB,KAAK,MAAM;GAClC;GAEA,YAAY,QAAQ,KAAK,aAAa;GACtC,cAAc,cAAc;EAC9B,CAAC;EAED,aAAa,KAAK,WAAW;EAE7B,IAAI,QAAQ,GACV,qBAAqB,sBAAsB,QAAQ,CAAC;CAExD;CASA,qBAPsB,eAAe,KAAK,QAAQ,UAChDA,wCAAgB,OAAO,QAAQ;EAC7B,OAAO;EACP;CACF,CAAC,CAG8B,GAAG,WAAW,CAAC;CAEhD,aAAa,QAAQ;CAErB,MAAM,0BACJ,YACgD;EAChD,MAAM,UAAuD,CAAC;EAE9D,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;GACvC,MAAM,SAAS,QAAQ;GACvB,IACE,CAACF,iCAAmB,OAAO,QAAQ,gBAAgBC,yDAAmB,GAEtE;GAGF,IAAI,UAAU;GACd,IAAI,kBAAkB;GAEtB,IAAI,OAAO,WAAW,QAAQ;IAC5B,MAAM,aAAa,uBAAuB,OAAO,UAAU;IAC3D,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;KAC1C,MAAM,QAAQ,WAAW;KACzB,WAAW,MAAM;KACjB,IAAI,MAAM,UAAU,iBAClB,kBAAkB,MAAM;IAE5B;GACF,OAAO;IACL,UAAU;IACV,kBAAkB;GACpB;GAEA,OAAO,UAAU;GACjB,OAAO,UAAU;GAEjB,QAAQ,KAAK;IAAE;IAAS,SAAS,OAAO;GAAQ,CAAC;EACnD;EAEA,OAAO;CACT;CAEA,0CACG,aAAa,oEAAI,YAAW,CAAC,CAChC;CAEA,OAAO;AACT"}

package/dist/core/headers/buildHeaderGroups.d.cts

@@ -0,0 +1,16 @@
+import { CellData, RowData } from "../../types/type-utils.cjs";
+import { HeaderGroup } from "../../types/HeaderGroup.cjs";
+import { Column } from "../../types/Column.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/core/headers/buildHeaderGroups.d.ts
+/**
+ * Builds the nested header group structure for a table.
+ *
+ * The result accounts for visible leaf columns, pinned column groups, and placeholder headers needed to render multi-level headers.
+ */
+declare function buildHeaderGroups<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(allColumns: Array<Column<TFeatures, TData, TValue>>, columnsToGroup: Array<Column<TFeatures, TData, TValue>>, table: Table_Internal<TFeatures, TData>, headerFamily?: 'center' | 'left' | 'right'): HeaderGroup<TFeatures, TData>[];
+//#endregion
+export { buildHeaderGroups };
+//# sourceMappingURL=buildHeaderGroups.d.cts.map

package/dist/core/headers/buildHeaderGroups.d.ts

@@ -0,0 +1,16 @@
+import { CellData, RowData } from "../../types/type-utils.js";
+import { HeaderGroup } from "../../types/HeaderGroup.js";
+import { Column } from "../../types/Column.js";
+import { Table_Internal } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/core/headers/buildHeaderGroups.d.ts
+/**
+ * Builds the nested header group structure for a table.
+ *
+ * The result accounts for visible leaf columns, pinned column groups, and placeholder headers needed to render multi-level headers.
+ */
+declare function buildHeaderGroups<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(allColumns: Array<Column<TFeatures, TData, TValue>>, columnsToGroup: Array<Column<TFeatures, TData, TValue>>, table: Table_Internal<TFeatures, TData>, headerFamily?: 'center' | 'left' | 'right'): HeaderGroup<TFeatures, TData>[];
+//#endregion
+export { buildHeaderGroups };
+//# sourceMappingURL=buildHeaderGroups.d.ts.map

package/dist/core/headers/buildHeaderGroups.js

@@ -0,0 +1,103 @@
+import { callMemoOrStaticFn } from "../../utils.js";
+import { column_getIsVisible } from "../../features/column-visibility/columnVisibilityFeature.utils.js";
+import { constructHeader } from "./constructHeader.js";
+
+//#region src/core/headers/buildHeaderGroups.ts
+/**
+* Builds the nested header group structure for a table.
+*
+* The result accounts for visible leaf columns, pinned column groups, and placeholder headers needed to render multi-level headers.
+*/
+function buildHeaderGroups(allColumns, columnsToGroup, table, headerFamily) {
+	var _headerGroups$;
+	let maxDepth = 0;
+	const findMaxDepth = (columns, depth = 1) => {
+		maxDepth = Math.max(maxDepth, depth);
+		for (let i = 0; i < columns.length; i++) {
+			const column = columns[i];
+			if (callMemoOrStaticFn(column, "getIsVisible", column_getIsVisible)) {
+				if (column.columns.length) findMaxDepth(column.columns, depth + 1);
+			}
+		}
+	};
+	findMaxDepth(allColumns);
+	const headerGroups = [];
+	const constructHeaderGroup = (headersToGroup, depth) => {
+		const headerGroup = {
+			depth,
+			id: [headerFamily, `${depth}`].filter(Boolean).join("_"),
+			headers: []
+		};
+		const pendingParentHeaders = [];
+		headersToGroup.forEach((headerToGroup) => {
+			const latestPendingParentHeader = pendingParentHeaders[pendingParentHeaders.length - 1];
+			const isLeafHeader = headerToGroup.column.depth === headerGroup.depth;
+			let column;
+			let isPlaceholder = false;
+			if (isLeafHeader && headerToGroup.column.parent) column = headerToGroup.column.parent;
+			else {
+				column = headerToGroup.column;
+				isPlaceholder = true;
+			}
+			if (latestPendingParentHeader && latestPendingParentHeader.column === column) latestPendingParentHeader.subHeaders.push(headerToGroup);
+			else {
+				const header = constructHeader(table, column, {
+					id: [
+						headerFamily,
+						depth,
+						column.id,
+						headerToGroup.id
+					].filter(Boolean).join("_"),
+					isPlaceholder,
+					placeholderId: isPlaceholder ? `${pendingParentHeaders.filter((d) => d.column === column).length}` : void 0,
+					depth,
+					index: pendingParentHeaders.length
+				});
+				header.subHeaders.push(headerToGroup);
+				pendingParentHeaders.push(header);
+			}
+			headerGroup.headers.push(headerToGroup);
+			headerToGroup.headerGroup = headerGroup;
+		});
+		headerGroups.push(headerGroup);
+		if (depth > 0) constructHeaderGroup(pendingParentHeaders, depth - 1);
+	};
+	constructHeaderGroup(columnsToGroup.map((column, index) => constructHeader(table, column, {
+		depth: maxDepth,
+		index
+	})), maxDepth - 1);
+	headerGroups.reverse();
+	const recurseHeadersForSpans = (headers) => {
+		const results = [];
+		for (let i = 0; i < headers.length; i++) {
+			const header = headers[i];
+			if (!callMemoOrStaticFn(header.column, "getIsVisible", column_getIsVisible)) continue;
+			let colSpan = 0;
+			let minChildRowSpan = Infinity;
+			if (header.subHeaders.length) {
+				const childSpans = recurseHeadersForSpans(header.subHeaders);
+				for (let j = 0; j < childSpans.length; j++) {
+					const child = childSpans[j];
+					colSpan += child.colSpan;
+					if (child.rowSpan < minChildRowSpan) minChildRowSpan = child.rowSpan;
+				}
+			} else {
+				colSpan = 1;
+				minChildRowSpan = 0;
+			}
+			header.colSpan = colSpan;
+			header.rowSpan = minChildRowSpan;
+			results.push({
+				colSpan,
+				rowSpan: header.rowSpan
+			});
+		}
+		return results;
+	};
+	recurseHeadersForSpans(((_headerGroups$ = headerGroups[0]) === null || _headerGroups$ === void 0 ? void 0 : _headerGroups$.headers) ?? []);
+	return headerGroups;
+}
+
+//#endregion
+export { buildHeaderGroups };
+//# sourceMappingURL=buildHeaderGroups.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildHeaderGroups.js","names":[],"sources":["../../../src/core/headers/buildHeaderGroups.ts"],"sourcesContent":["import { callMemoOrStaticFn } from '../../utils'\nimport { column_getIsVisible } from '../../features/column-visibility/columnVisibilityFeature.utils'\nimport { constructHeader } from './constructHeader'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header } from '../../types/Header'\nimport type { HeaderGroup } from '../../types/HeaderGroup'\nimport type { Column } from '../../types/Column'\n\n/**\n * Builds the nested header group structure for a table.\n *\n * The result accounts for visible leaf columns, pinned column groups, and placeholder headers needed to render multi-level headers.\n */\nexport function buildHeaderGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  allColumns: Array<Column<TFeatures, TData, TValue>>,\n  columnsToGroup: Array<Column<TFeatures, TData, TValue>>,\n  table: Table_Internal<TFeatures, TData>,\n  headerFamily?: 'center' | 'left' | 'right',\n) {\n  // Find the max depth of the columns:\n  // build the leaf column row\n  // build each buffer row going up\n  //    placeholder for non-existent level\n  //    real column for existing level\n\n  let maxDepth = 0\n\n  const findMaxDepth = (\n    columns: Array<Column<TFeatures, TData, TValue>>,\n    depth = 1,\n  ) => {\n    maxDepth = Math.max(maxDepth, depth)\n\n    for (let i = 0; i < columns.length; i++) {\n      const column = columns[i]!\n      if (callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)) {\n        if (column.columns.length) {\n          findMaxDepth(column.columns, depth + 1)\n        }\n      }\n    }\n  }\n\n  findMaxDepth(allColumns)\n\n  const headerGroups: Array<HeaderGroup<TFeatures, TData>> = []\n\n  const constructHeaderGroup = (\n    headersToGroup: Array<Header<TFeatures, TData, TValue>>,\n    depth: number,\n  ) => {\n    // The header group we are creating\n    const headerGroup: HeaderGroup<TFeatures, TData> = {\n      depth,\n      id: [headerFamily, `${depth}`].filter(Boolean).join('_'),\n      headers: [],\n    }\n\n    // The parent columns we're going to scan next\n    const pendingParentHeaders: Array<Header<TFeatures, TData, TValue>> = []\n\n    // Scan each column for parents\n    headersToGroup.forEach((headerToGroup) => {\n      // What is the latest (last) parent column?\n\n      const latestPendingParentHeader =\n        pendingParentHeaders[pendingParentHeaders.length - 1]\n\n      const isLeafHeader = headerToGroup.column.depth === headerGroup.depth\n\n      let column: Column<TFeatures, TData, TValue>\n      let isPlaceholder = false\n\n      if (isLeafHeader && headerToGroup.column.parent) {\n        // The parent header is new\n        column = headerToGroup.column.parent\n      } else {\n        // The parent header is repeated\n        column = headerToGroup.column\n        isPlaceholder = true\n      }\n\n      if (\n        latestPendingParentHeader &&\n        latestPendingParentHeader.column === column\n      ) {\n        // This column is repeated. Add it as a sub header to the next batch\n        latestPendingParentHeader.subHeaders.push(headerToGroup)\n      } else {\n        // This is a new header. Let's create it\n        const header = constructHeader(table, column, {\n          id: [headerFamily, depth, column.id, headerToGroup.id]\n            .filter(Boolean)\n            .join('_'),\n          isPlaceholder,\n          placeholderId: isPlaceholder\n            ? `${pendingParentHeaders.filter((d) => d.column === column).length}`\n            : undefined,\n          depth,\n          index: pendingParentHeaders.length,\n        })\n\n        // Add the headerToGroup as a subHeader of the new header\n        header.subHeaders.push(headerToGroup)\n        // Add the new header to the pendingParentHeaders to get grouped\n        // in the next batch\n        pendingParentHeaders.push(header)\n      }\n\n      headerGroup.headers.push(headerToGroup)\n      headerToGroup.headerGroup = headerGroup\n    })\n\n    headerGroups.push(headerGroup)\n\n    if (depth > 0) {\n      constructHeaderGroup(pendingParentHeaders, depth - 1)\n    }\n  }\n\n  const bottomHeaders = columnsToGroup.map((column, index) =>\n    constructHeader(table, column, {\n      depth: maxDepth,\n      index,\n    }),\n  )\n\n  constructHeaderGroup(bottomHeaders, maxDepth - 1)\n\n  headerGroups.reverse()\n\n  const recurseHeadersForSpans = (\n    headers: Array<Header<TFeatures, TData, TValue>>,\n  ): Array<{ colSpan: number; rowSpan: number }> => {\n    const results: Array<{ colSpan: number; rowSpan: number }> = []\n\n    for (let i = 0; i < headers.length; i++) {\n      const header = headers[i]!\n      if (\n        !callMemoOrStaticFn(header.column, 'getIsVisible', column_getIsVisible)\n      ) {\n        continue\n      }\n\n      let colSpan = 0\n      let minChildRowSpan = Infinity\n\n      if (header.subHeaders.length) {\n        const childSpans = recurseHeadersForSpans(header.subHeaders)\n        for (let j = 0; j < childSpans.length; j++) {\n          const child = childSpans[j]!\n          colSpan += child.colSpan\n          if (child.rowSpan < minChildRowSpan) {\n            minChildRowSpan = child.rowSpan\n          }\n        }\n      } else {\n        colSpan = 1\n        minChildRowSpan = 0\n      }\n\n      header.colSpan = colSpan\n      header.rowSpan = minChildRowSpan\n\n      results.push({ colSpan, rowSpan: header.rowSpan })\n    }\n\n    return results\n  }\n\n  recurseHeadersForSpans(\n    (headerGroups[0]?.headers ?? []) as Array<Header<TFeatures, TData, TValue>>,\n  )\n\n  return headerGroups\n}\n"],"mappings":";;;;;;;;;;AAeA,SAAgB,kBAKd,YACA,gBACA,OACA,cACA;;CAOA,IAAI,WAAW;CAEf,MAAM,gBACJ,SACA,QAAQ,MACL;EACH,WAAW,KAAK,IAAI,UAAU,KAAK;EAEnC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;GACvC,MAAM,SAAS,QAAQ;GACvB,IAAI,mBAAmB,QAAQ,gBAAgB,mBAAmB,GAChE;QAAI,OAAO,QAAQ,QACjB,aAAa,OAAO,SAAS,QAAQ,CAAC;GACxC;EAEJ;CACF;CAEA,aAAa,UAAU;CAEvB,MAAM,eAAqD,CAAC;CAE5D,MAAM,wBACJ,gBACA,UACG;EAEH,MAAM,cAA6C;GACjD;GACA,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;GACvD,SAAS,CAAC;EACZ;EAGA,MAAM,uBAAgE,CAAC;EAGvE,eAAe,SAAS,kBAAkB;GAGxC,MAAM,4BACJ,qBAAqB,qBAAqB,SAAS;GAErD,MAAM,eAAe,cAAc,OAAO,UAAU,YAAY;GAEhE,IAAI;GACJ,IAAI,gBAAgB;GAEpB,IAAI,gBAAgB,cAAc,OAAO,QAEvC,SAAS,cAAc,OAAO;QACzB;IAEL,SAAS,cAAc;IACvB,gBAAgB;GAClB;GAEA,IACE,6BACA,0BAA0B,WAAW,QAGrC,0BAA0B,WAAW,KAAK,aAAa;QAClD;IAEL,MAAM,SAAS,gBAAgB,OAAO,QAAQ;KAC5C,IAAI;MAAC;MAAc;MAAO,OAAO;MAAI,cAAc;KAAE,CAAC,CACnD,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;KACX;KACA,eAAe,gBACX,GAAG,qBAAqB,QAAQ,MAAM,EAAE,WAAW,MAAM,CAAC,CAAC,WAC3D;KACJ;KACA,OAAO,qBAAqB;IAC9B,CAAC;IAGD,OAAO,WAAW,KAAK,aAAa;IAGpC,qBAAqB,KAAK,MAAM;GAClC;GAEA,YAAY,QAAQ,KAAK,aAAa;GACtC,cAAc,cAAc;EAC9B,CAAC;EAED,aAAa,KAAK,WAAW;EAE7B,IAAI,QAAQ,GACV,qBAAqB,sBAAsB,QAAQ,CAAC;CAExD;CASA,qBAPsB,eAAe,KAAK,QAAQ,UAChD,gBAAgB,OAAO,QAAQ;EAC7B,OAAO;EACP;CACF,CAAC,CAG8B,GAAG,WAAW,CAAC;CAEhD,aAAa,QAAQ;CAErB,MAAM,0BACJ,YACgD;EAChD,MAAM,UAAuD,CAAC;EAE9D,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;GACvC,MAAM,SAAS,QAAQ;GACvB,IACE,CAAC,mBAAmB,OAAO,QAAQ,gBAAgB,mBAAmB,GAEtE;GAGF,IAAI,UAAU;GACd,IAAI,kBAAkB;GAEtB,IAAI,OAAO,WAAW,QAAQ;IAC5B,MAAM,aAAa,uBAAuB,OAAO,UAAU;IAC3D,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;KAC1C,MAAM,QAAQ,WAAW;KACzB,WAAW,MAAM;KACjB,IAAI,MAAM,UAAU,iBAClB,kBAAkB,MAAM;IAE5B;GACF,OAAO;IACL,UAAU;IACV,kBAAkB;GACpB;GAEA,OAAO,UAAU;GACjB,OAAO,UAAU;GAEjB,QAAQ,KAAK;IAAE;IAAS,SAAS,OAAO;GAAQ,CAAC;EACnD;EAEA,OAAO;CACT;CAEA,0CACG,aAAa,oEAAI,YAAW,CAAC,CAChC;CAEA,OAAO;AACT"}

package/dist/core/headers/constructHeader.cjs

@@ -0,0 +1,41 @@
+
+//#region src/core/headers/constructHeader.ts
+/**
+* Creates or retrieves the header prototype for a table.
+* The prototype is cached on the table and shared by all header instances.
+*/
+function getHeaderPrototype(table) {
+	if (!table._headerPrototype) {
+		table._headerPrototype = { table };
+		const features = Object.values(table._features);
+		for (let i = 0; i < features.length; i++) {
+			var _assignHeaderPrototyp, _ref;
+			(_assignHeaderPrototyp = (_ref = features[i]).assignHeaderPrototype) === null || _assignHeaderPrototyp === void 0 || _assignHeaderPrototyp.call(_ref, table._headerPrototype, table);
+		}
+	}
+	return table._headerPrototype;
+}
+/**
+* Constructs a header instance from normalized table internals.
+*
+* This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+*/
+function constructHeader(table, column, options) {
+	const headerPrototype = getHeaderPrototype(table);
+	const header = Object.create(headerPrototype);
+	header.colSpan = 0;
+	header.column = column;
+	header.depth = options.depth;
+	header.headerGroup = null;
+	header.id = options.id ?? column.id;
+	header.index = options.index;
+	header.isPlaceholder = !!options.isPlaceholder;
+	header.placeholderId = options.placeholderId;
+	header.rowSpan = 0;
+	header.subHeaders = [];
+	return header;
+}
+
+//#endregion
+exports.constructHeader = constructHeader;
+//# sourceMappingURL=constructHeader.cjs.map

package/dist/core/headers/constructHeader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructHeader.cjs","names":[],"sources":["../../../src/core/headers/constructHeader.ts"],"sourcesContent":["import type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header } from '../../types/Header'\nimport type { Column } from '../../types/Column'\nimport type { Header_CoreProperties } from './coreHeadersFeature.types'\n\n/**\n * Creates or retrieves the header prototype for a table.\n * The prototype is cached on the table and shared by all header instances.\n */\nfunction getHeaderPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._headerPrototype) {\n    table._headerPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignHeaderPrototype?.(table._headerPrototype, table)\n    }\n  }\n  return table._headerPrototype\n}\n\n/**\n * Constructs a header instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructHeader<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  column: Column<TFeatures, TData, TValue>,\n  options: {\n    id?: string\n    isPlaceholder?: boolean\n    placeholderId?: string\n    index: number\n    depth: number\n  },\n): Header<TFeatures, TData, TValue> {\n  // Create header with shared prototype for memory efficiency\n  const headerPrototype = getHeaderPrototype(table)\n  const header = Object.create(headerPrototype) as Header_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  header.colSpan = 0\n  header.column = column\n  header.depth = options.depth\n  header.headerGroup = null\n  header.id = options.id ?? column.id\n  header.index = options.index\n  header.isPlaceholder = !!options.isPlaceholder\n  header.placeholderId = options.placeholderId\n  header.rowSpan = 0\n  header.subHeaders = []\n\n  return header as Header<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;;AAWA,SAAS,mBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,kBAAkB;EAC3B,MAAM,mBAAmB,EAAE,MAAM;EACjC,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;EAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,0CAAS,IAAI,wGAAwB,MAAM,kBAAkB,KAAK;EACpE;CACF;CACA,OAAO,MAAM;AACf;;;;;;AAOA,SAAgB,gBAKd,OACA,QACA,SAOkC;CAElC,MAAM,kBAAkB,mBAAmB,KAAK;CAChD,MAAM,SAAS,OAAO,OAAO,eAAe;CAO5C,OAAO,UAAU;CACjB,OAAO,SAAS;CAChB,OAAO,QAAQ,QAAQ;CACvB,OAAO,cAAc;CACrB,OAAO,KAAK,QAAQ,MAAM,OAAO;CACjC,OAAO,QAAQ,QAAQ;CACvB,OAAO,gBAAgB,CAAC,CAAC,QAAQ;CACjC,OAAO,gBAAgB,QAAQ;CAC/B,OAAO,UAAU;CACjB,OAAO,aAAa,CAAC;CAErB,OAAO;AACT"}

package/dist/core/headers/constructHeader.d.cts

@@ -0,0 +1,22 @@
+import { CellData, RowData } from "../../types/type-utils.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/constructHeader.d.ts
+/**
+ * Constructs a header instance from normalized table internals.
+ *
+ * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+ */
+declare function constructHeader<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(table: Table_Internal<TFeatures, TData>, column: Column<TFeatures, TData, TValue>, options: {
+  id?: string;
+  isPlaceholder?: boolean;
+  placeholderId?: string;
+  index: number;
+  depth: number;
+}): Header<TFeatures, TData, TValue>;
+//#endregion
+export { constructHeader };
+//# sourceMappingURL=constructHeader.d.cts.map

package/dist/core/headers/constructHeader.d.ts

@@ -0,0 +1,22 @@
+import { CellData, RowData } from "../../types/type-utils.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/constructHeader.d.ts
+/**
+ * Constructs a header instance from normalized table internals.
+ *
+ * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+ */
+declare function constructHeader<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(table: Table_Internal<TFeatures, TData>, column: Column<TFeatures, TData, TValue>, options: {
+  id?: string;
+  isPlaceholder?: boolean;
+  placeholderId?: string;
+  index: number;
+  depth: number;
+}): Header<TFeatures, TData, TValue>;
+//#endregion
+export { constructHeader };
+//# sourceMappingURL=constructHeader.d.ts.map

package/dist/core/headers/constructHeader.js

@@ -0,0 +1,40 @@
+//#region src/core/headers/constructHeader.ts
+/**
+* Creates or retrieves the header prototype for a table.
+* The prototype is cached on the table and shared by all header instances.
+*/
+function getHeaderPrototype(table) {
+	if (!table._headerPrototype) {
+		table._headerPrototype = { table };
+		const features = Object.values(table._features);
+		for (let i = 0; i < features.length; i++) {
+			var _assignHeaderPrototyp, _ref;
+			(_assignHeaderPrototyp = (_ref = features[i]).assignHeaderPrototype) === null || _assignHeaderPrototyp === void 0 || _assignHeaderPrototyp.call(_ref, table._headerPrototype, table);
+		}
+	}
+	return table._headerPrototype;
+}
+/**
+* Constructs a header instance from normalized table internals.
+*
+* This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
+*/
+function constructHeader(table, column, options) {
+	const headerPrototype = getHeaderPrototype(table);
+	const header = Object.create(headerPrototype);
+	header.colSpan = 0;
+	header.column = column;
+	header.depth = options.depth;
+	header.headerGroup = null;
+	header.id = options.id ?? column.id;
+	header.index = options.index;
+	header.isPlaceholder = !!options.isPlaceholder;
+	header.placeholderId = options.placeholderId;
+	header.rowSpan = 0;
+	header.subHeaders = [];
+	return header;
+}
+
+//#endregion
+export { constructHeader };
+//# sourceMappingURL=constructHeader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constructHeader.js","names":[],"sources":["../../../src/core/headers/constructHeader.ts"],"sourcesContent":["import type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header } from '../../types/Header'\nimport type { Column } from '../../types/Column'\nimport type { Header_CoreProperties } from './coreHeadersFeature.types'\n\n/**\n * Creates or retrieves the header prototype for a table.\n * The prototype is cached on the table and shared by all header instances.\n */\nfunction getHeaderPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._headerPrototype) {\n    table._headerPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignHeaderPrototype?.(table._headerPrototype, table)\n    }\n  }\n  return table._headerPrototype\n}\n\n/**\n * Constructs a header instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructHeader<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  column: Column<TFeatures, TData, TValue>,\n  options: {\n    id?: string\n    isPlaceholder?: boolean\n    placeholderId?: string\n    index: number\n    depth: number\n  },\n): Header<TFeatures, TData, TValue> {\n  // Create header with shared prototype for memory efficiency\n  const headerPrototype = getHeaderPrototype(table)\n  const header = Object.create(headerPrototype) as Header_CoreProperties<\n    TFeatures,\n    TData,\n    TValue\n  >\n\n  // Only assign instance-specific properties\n  header.colSpan = 0\n  header.column = column\n  header.depth = options.depth\n  header.headerGroup = null\n  header.id = options.id ?? column.id\n  header.index = options.index\n  header.isPlaceholder = !!options.isPlaceholder\n  header.placeholderId = options.placeholderId\n  header.rowSpan = 0\n  header.subHeaders = []\n\n  return header as Header<TFeatures, TData, TValue>\n}\n"],"mappings":";;;;;AAWA,SAAS,mBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,kBAAkB;EAC3B,MAAM,mBAAmB,EAAE,MAAM;EACjC,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;EAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,0CAAS,IAAI,wGAAwB,MAAM,kBAAkB,KAAK;EACpE;CACF;CACA,OAAO,MAAM;AACf;;;;;;AAOA,SAAgB,gBAKd,OACA,QACA,SAOkC;CAElC,MAAM,kBAAkB,mBAAmB,KAAK;CAChD,MAAM,SAAS,OAAO,OAAO,eAAe;CAO5C,OAAO,UAAU;CACjB,OAAO,SAAS;CAChB,OAAO,QAAQ,QAAQ;CACvB,OAAO,cAAc;CACrB,OAAO,KAAK,QAAQ,MAAM,OAAO;CACjC,OAAO,QAAQ,QAAQ;CACvB,OAAO,gBAAgB,CAAC,CAAC,QAAQ;CACjC,OAAO,gBAAgB,QAAQ;CAC/B,OAAO,UAAU;CACjB,OAAO,aAAa,CAAC;CAErB,OAAO;AACT"}

package/dist/core/headers/coreHeadersFeature.cjs

@@ -0,0 +1,55 @@
+const require_utils = require('../../utils.cjs');
+const require_coreHeadersFeature_utils = require('./coreHeadersFeature.utils.cjs');
+
+//#region src/core/headers/coreHeadersFeature.ts
+/**
+* Core feature that builds header groups and exposes header context APIs.
+*/
+const coreHeadersFeature = {
+	assignHeaderPrototype: (prototype, table) => {
+		require_utils.assignPrototypeAPIs("coreHeadersFeature", prototype, table, {
+			header_getLeafHeaders: {
+				fn: (header) => require_coreHeadersFeature_utils.header_getLeafHeaders(header),
+				memoDeps: (header) => [header.column.table.options.columns]
+			},
+			header_getContext: {
+				fn: (header) => require_coreHeadersFeature_utils.header_getContext(header),
+				memoDeps: (header) => [header.column.table.options.columns]
+			}
+		});
+	},
+	constructTableAPIs: (table) => {
+		require_utils.assignTableAPIs("coreHeadersFeature", table, {
+			table_getHeaderGroups: {
+				fn: () => require_coreHeadersFeature_utils.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: () => require_coreHeadersFeature_utils.table_getFooterGroups(table),
+				memoDeps: () => [table.getHeaderGroups()]
+			},
+			table_getFlatHeaders: {
+				fn: () => require_coreHeadersFeature_utils.table_getFlatHeaders(table),
+				memoDeps: () => [table.getHeaderGroups()]
+			},
+			table_getLeafHeaders: {
+				fn: () => require_coreHeadersFeature_utils.table_getLeafHeaders(table),
+				memoDeps: () => [table.getHeaderGroups()]
+			}
+		});
+	}
+};
+
+//#endregion
+exports.coreHeadersFeature = coreHeadersFeature;
+//# sourceMappingURL=coreHeadersFeature.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreHeadersFeature.cjs","names":["header_getLeafHeaders","header_getContext","table_getHeaderGroups","table_getFooterGroups","table_getFlatHeaders","table_getLeafHeaders"],"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,kCAAoB,sBAAsB,WAAW,OAAO;GAC1D,uBAAuB;IACrB,KAAK,WAAWA,uDAAsB,MAAM;IAC5C,WAAW,WAAW,CAAC,OAAO,OAAO,MAAM,QAAQ,OAAO;GAC5D;GACA,mBAAmB;IACjB,KAAK,WAAWC,mDAAkB,MAAM;IACxC,WAAW,WAAW,CAAC,OAAO,OAAO,MAAM,QAAQ,OAAO;GAC5D;EACF,CAAC;CACH;CAEA,qBAAqB,UAAU;EAC7B,8BAAgB,sBAAsB,OAAO;GAC3C,uBAAuB;IACrB,UAAUC,uDAAsB,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,UAAUC,uDAAsB,KAAK;IACrC,gBAAgB,CAAC,MAAM,gBAAgB,CAAC;GAC1C;GACA,sBAAsB;IACpB,UAAUC,sDAAqB,KAAK;IACpC,gBAAgB,CAAC,MAAM,gBAAgB,CAAC;GAC1C;GACA,sBAAsB;IACpB,UAAUC,sDAAqB,KAAK;IACpC,gBAAgB,CAAC,MAAM,gBAAgB,CAAC;GAC1C;EACF,CAAC;CACH;AACF"}

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

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.cjs";
+
+//#region src/core/headers/coreHeadersFeature.d.ts
+/**
+ * Core feature that builds header groups and exposes header context APIs.
+ */
+declare const coreHeadersFeature: TableFeature;
+//#endregion
+export { coreHeadersFeature };
+//# sourceMappingURL=coreHeadersFeature.d.cts.map

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

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.js";
+
+//#region src/core/headers/coreHeadersFeature.d.ts
+/**
+ * Core feature that builds header groups and exposes header context APIs.
+ */
+declare const coreHeadersFeature: TableFeature;
+//#endregion
+export { coreHeadersFeature };
+//# sourceMappingURL=coreHeadersFeature.d.ts.map