@veltra/sheet 2.4.0 → 2.5.0

package/dist/report/render/coordinate.js

@@ -1,733 +0,0 @@
-import { sameAddress } from "./template-index.js";
-import { cellKey, createRange } from "@veltra/sheet-core";
-//#region src/report/render/coordinate.ts
-function isRowExpanding(binding) {
-	return binding.expand === "down" && (binding.aggregate === "group" || binding.aggregate === "list");
-}
-function isColExpanding(binding) {
-	return binding.expand === "right" && (binding.aggregate === "group" || binding.aggregate === "list");
-}
-function mergeSpanEnabled(binding) {
-	return binding?.mergeSpan !== false;
-}
-function filterRows(rows, filter) {
-	if (Object.keys(filter).length === 0) return rows;
-	return rows.filter((row) => Object.entries(filter).every(([field, value]) => row[field] === value));
-}
-function distinctFieldValues(rows, field) {
-	const seen = /* @__PURE__ */ new Set();
-	const values = [];
-	for (const row of rows) {
-		const key = JSON.stringify(row[field]);
-		if (seen.has(key)) continue;
-		seen.add(key);
-		values.push(row[field]);
-	}
-	return values;
-}
-function sortValues(values, sort) {
-	if (sort === "asc") return [...values].sort((a, b) => String(a).localeCompare(String(b), "zh-CN"));
-	if (sort === "desc") return [...values].sort((a, b) => String(b).localeCompare(String(a), "zh-CN"));
-	return values;
-}
-function singleCellRange(row, col) {
-	return {
-		start: {
-			row,
-			col
-		},
-		end: {
-			row,
-			col
-		}
-	};
-}
-function rangeRows(range) {
-	return range.end.row - range.start.row + 1;
-}
-function rangeCols(range) {
-	return range.end.col - range.start.col + 1;
-}
-function mergeFilters(rowFilter, colFilter) {
-	return {
-		...rowFilter,
-		...colFilter
-	};
-}
-function parentFilterForBinding(binding, index, rowFilter, colFilter) {
-	const filter = {};
-	if (binding.rowParent) {
-		const parent = index.bindingAt(binding.rowParent);
-		if (parent && parent.dataset === binding.dataset) Object.assign(filter, rowFilter);
-	}
-	if (binding.colParent) {
-		const parent = index.bindingAt(binding.colParent);
-		if (parent && parent.dataset === binding.dataset) Object.assign(filter, colFilter);
-	}
-	return filter;
-}
-/** 枚举扩展格实例 */
-function enumerateExpansionInstances(binding, data, filter) {
-	const rows = filterRows(data[binding.dataset] ?? [], filter);
-	if (!isRowExpanding(binding) && !isColExpanding(binding)) return [{
-		index: 0,
-		filter
-	}];
-	if (binding.aggregate === "group") return sortValues(distinctFieldValues(rows, binding.field), binding.sort).map((value, index) => ({
-		index,
-		value,
-		filter: {
-			...filter,
-			[binding.field]: value
-		}
-	}));
-	if (binding.aggregate === "list") return rows.map((_, index) => ({
-		index,
-		filter
-	}));
-	return [{
-		index: 0,
-		filter
-	}];
-}
-function isRowSubtreeRoot(binding, index) {
-	if (!isRowExpanding(binding)) return false;
-	if (!binding.rowParent) return true;
-	const parent = index.bindingAt(binding.rowParent);
-	return !parent || !isRowExpanding(parent);
-}
-function isColSubtreeRoot(binding, index) {
-	if (!isColExpanding(binding)) return false;
-	if (!binding.colParent) return true;
-	const parent = index.bindingAt(binding.colParent);
-	return !parent || !isColExpanding(parent);
-}
-function isNestedRowExpander(binding, index) {
-	return isRowExpanding(binding) && binding.aggregate === "group" && !!binding.rowParent && !isRowSubtreeRoot(binding, index);
-}
-function isNestedColExpander(binding, index) {
-	return isColExpanding(binding) && binding.aggregate === "group" && !!binding.colParent && !isColSubtreeRoot(binding, index);
-}
-function rowSubtreeRows(rootAddr, index) {
-	let maxRow = rootAddr.row;
-	const walk = (addr) => {
-		maxRow = Math.max(maxRow, addr.row);
-		for (const child of index.rowChildren.get(cellKey(addr)) ?? []) walk(child);
-	};
-	walk(rootAddr);
-	return index.logicalRows.filter((row) => row >= rootAddr.row && row <= maxRow);
-}
-function colSubtreeCols(rootAddr, index) {
-	let maxCol = rootAddr.col;
-	const walk = (addr) => {
-		maxCol = Math.max(maxCol, addr.col);
-		for (const child of index.colChildren.get(cellKey(addr)) ?? []) walk(child);
-	};
-	walk(rootAddr);
-	return index.logicalCols.filter((col) => col >= rootAddr.col && col <= maxCol);
-}
-function columnsOnRow(index, row) {
-	const cols = /* @__PURE__ */ new Set();
-	for (const entry of index.bindingsOnRow(row)) cols.add(entry.addr.col);
-	for (const cell of index.staticCells.values()) if (cell.row === row) cols.add(cell.col);
-	return [...cols].sort((a, b) => a - b);
-}
-function findRowSubtreeRootOnRow(index, row) {
-	for (const entry of index.bindingsOnRow(row)) if (isRowSubtreeRoot(entry.binding, index)) return entry.addr;
-	return null;
-}
-/** 扩展带终止行：新的纵向子树根，或无父格的汇总行（如总计） */
-function isExpansionBandTerminatorRow(index, row, rootRow) {
-	if (row <= rootRow) return false;
-	const rowRoot = findRowSubtreeRootOnRow(index, row);
-	if (rowRoot && rowRoot.row !== rootRow) return true;
-	return !isCompanionRow(index, row);
-}
-/** 扩展带内随行：全部绑定均带 rowParent（纯静态行不算带内行） */
-function isCompanionRow(index, row) {
-	const bindings = index.bindingsOnRow(row);
-	if (bindings.length === 0) return false;
-	return bindings.every(({ binding }) => binding.rowParent !== void 0);
-}
-/** 纵向扩展带覆盖的模板行：子树行 + 紧随其后的带内汇总行 */
-function expansionBandRows(rootAddr, index) {
-	const subtreeRows = rowSubtreeRows(rootAddr, index);
-	const maxSubtreeRow = Math.max(...subtreeRows);
-	const rows = new Set(subtreeRows);
-	for (const row of index.logicalRows) {
-		if (row <= maxSubtreeRow) continue;
-		if (isExpansionBandTerminatorRow(index, row, rootAddr.row)) break;
-		if (!isCompanionRow(index, row)) break;
-		rows.add(row);
-	}
-	return index.logicalRows.filter((row) => rows.has(row));
-}
-function findNestedColChild(rootAddr, index) {
-	for (const child of index.colChildren.get(cellKey(rootAddr)) ?? []) {
-		const binding = index.bindingAt(child);
-		if (binding && isColExpanding(binding) && child.row > rootAddr.row) return child;
-	}
-	return null;
-}
-var CoordinateEngine = class {
-	index;
-	data;
-	constructor(index, data) {
-		this.index = index;
-		this.data = data;
-	}
-	compute() {
-		const placements = [];
-		const consumedRows = /* @__PURE__ */ new Set();
-		let physRow = 0;
-		let maxCol = 0;
-		for (const logicalRow of this.index.logicalRows) {
-			if (consumedRows.has(logicalRow)) continue;
-			const rowRoot = findRowSubtreeRootOnRow(this.index, logicalRow);
-			if (rowRoot) {
-				const result = this.layoutRowSubtree(rowRoot, emptyCtx(), physRow, 0);
-				placements.push(...result.placements);
-				physRow += result.rowSpan;
-				maxCol = Math.max(maxCol, result.colSpan);
-				for (const row of expansionBandRows(rowRoot, this.index)) consumedRows.add(row);
-				continue;
-			}
-			const result = this.layoutStandaloneRow(logicalRow, emptyCtx(), physRow, 0);
-			placements.push(...result.placements);
-			physRow += result.rowSpan;
-			maxCol = Math.max(maxCol, result.colSpan);
-		}
-		return {
-			rowCount: physRow,
-			colCount: Math.max(maxCol, this.baseColCount()),
-			placements,
-			mappedMerges: mapTemplateMerges(this.index, placements)
-		};
-	}
-	baseColCount() {
-		if (this.index.logicalCols.length === 0) return 0;
-		return Math.max(...this.index.logicalCols) + 1;
-	}
-	layoutRowSubtree(rootAddr, ctx, physRowStart, physColStart) {
-		const rootBinding = this.index.bindingAt(rootAddr);
-		const parentFilter = parentFilterForBinding(rootBinding, this.index, ctx.rowFilter, ctx.colFilter);
-		const instances = enumerateExpansionInstances(rootBinding, this.data, mergeFilters(parentFilter, ctx.rowFilter));
-		const bandRows = expansionBandRows(rootAddr, this.index);
-		if (instances.length === 0) return {
-			rowSpan: 0,
-			colSpan: 0,
-			placements: []
-		};
-		if (rootBinding.aggregate === "list") {
-			const listCtx = {
-				rowFilter: mergeFilters(parentFilter, ctx.rowFilter),
-				colFilter: ctx.colFilter,
-				rowPath: ctx.rowPath,
-				colPath: ctx.colPath
-			};
-			const rowResult = this.layoutTemplateRow(rootAddr.row, listCtx, physRowStart, physColStart, rootAddr, instances.length);
-			const placements = [...rowResult.placements];
-			let totalRowSpan = instances.length;
-			for (const templateRow of bandRows) {
-				if (templateRow === rootAddr.row) continue;
-				const companionResult = this.layoutTemplateRow(templateRow, listCtx, physRowStart + totalRowSpan, physColStart, null, 1);
-				placements.push(...companionResult.placements);
-				totalRowSpan += companionResult.rowSpan;
-			}
-			return {
-				rowSpan: totalRowSpan,
-				colSpan: rowResult.colSpan,
-				placements
-			};
-		}
-		const placements = [];
-		let totalRowSpan = 0;
-		let maxColSpan = 0;
-		for (const instance of instances) {
-			const instanceCtx = {
-				rowFilter: instance.filter,
-				colFilter: ctx.colFilter,
-				rowPath: [...ctx.rowPath, instance.index],
-				colPath: ctx.colPath
-			};
-			const instanceHeight = this.measureSubtreeInstanceHeight(bandRows, rootAddr, instanceCtx);
-			const groupMergeHeight = this.measureTemplateRowHeight(rootAddr.row, instanceCtx, null);
-			if (this.bandHasMultiRowList(bandRows, instanceCtx)) {
-				const bandResult = this.layoutMultiRowListBand(bandRows, rootAddr, instanceCtx, physRowStart + totalRowSpan, physColStart, groupMergeHeight);
-				placements.push(...bandResult.placements);
-				maxColSpan = Math.max(maxColSpan, bandResult.colSpan);
-				totalRowSpan += instanceHeight;
-				continue;
-			}
-			let rowOffset = 0;
-			for (const templateRow of bandRows) {
-				const rowHeight = this.measureTemplateRowHeight(templateRow, instanceCtx, rootAddr);
-				const mergeHeight = templateRow === rootAddr.row ? groupMergeHeight : instanceHeight - rowOffset;
-				const rowResult = this.layoutTemplateRow(templateRow, instanceCtx, physRowStart + totalRowSpan + rowOffset, physColStart, rootAddr, mergeHeight);
-				placements.push(...rowResult.placements);
-				rowOffset += rowHeight;
-				maxColSpan = Math.max(maxColSpan, rowResult.colSpan);
-			}
-			totalRowSpan += instanceHeight;
-		}
-		return {
-			rowSpan: totalRowSpan,
-			colSpan: maxColSpan,
-			placements
-		};
-	}
-	measureSubtreeInstanceHeight(bandRows, rootAddr, ctx) {
-		let listDrivenHeight = 0;
-		let companionHeight = 0;
-		for (const row of bandRows) {
-			const listCount = this.listInstanceCountOnRow(row, ctx);
-			if (listCount > 0) {
-				listDrivenHeight = Math.max(listDrivenHeight, listCount);
-				continue;
-			}
-			if (row === rootAddr.row) continue;
-			companionHeight += this.measureTemplateRowHeight(row, ctx, rootAddr);
-		}
-		if (listDrivenHeight === 0) return this.measureTemplateRowHeight(rootAddr.row, ctx, null);
-		return listDrivenHeight + companionHeight;
-	}
-	bandHasMultiRowList(bandRows, ctx) {
-		let count = 0;
-		for (const row of bandRows) {
-			if (this.listInstanceCountOnRow(row, ctx) > 0) count++;
-			if (count > 1) return true;
-		}
-		return false;
-	}
-	layoutMultiRowListBand(bandRows, rootAddr, ctx, physRowStart, physColStart, groupMergeHeight) {
-		const listRows = bandRows.filter((row) => this.listInstanceCountOnRow(row, ctx) > 0);
-		const companionRows = bandRows.filter((row) => !listRows.includes(row));
-		const listCount = Math.max(...listRows.map((row) => this.listInstanceCountOnRow(row, ctx)), 1);
-		const placements = [];
-		let maxColSpan = 0;
-		for (let listIndex = 0; listIndex < listCount; listIndex++) for (const templateRow of listRows) {
-			const rowResult = this.layoutTemplateRow(templateRow, ctx, physRowStart + listIndex, physColStart, templateRow === rootAddr.row ? rootAddr : null, groupMergeHeight, false, listIndex, listCount);
-			placements.push(...rowResult.placements);
-			maxColSpan = Math.max(maxColSpan, rowResult.colSpan);
-		}
-		let rowOffset = listCount;
-		for (const templateRow of companionRows) {
-			const rowResult = this.layoutTemplateRow(templateRow, ctx, physRowStart + rowOffset, physColStart, null, 1);
-			placements.push(...rowResult.placements);
-			maxColSpan = Math.max(maxColSpan, rowResult.colSpan);
-			rowOffset += rowResult.rowSpan;
-		}
-		return {
-			rowSpan: rowOffset,
-			colSpan: maxColSpan,
-			placements
-		};
-	}
-	measureTemplateRowHeight(templateRow, ctx, rootAddr) {
-		for (const entry of this.index.bindingsOnRow(templateRow)) if (isNestedRowExpander(entry.binding, this.index)) return this.measureNestedRowBandHeight(entry.addr, entry.binding, templateRow, ctx);
-		const listCount = this.listInstanceCountOnRow(templateRow, ctx);
-		if (listCount > 0) return listCount;
-		if (rootAddr && templateRow === rootAddr.row) return 0;
-		return 1;
-	}
-	measureNestedRowBandHeight(groupAddr, groupBinding, templateRow, ctx) {
-		const parentFilter = parentFilterForBinding(groupBinding, this.index, ctx.rowFilter, ctx.colFilter);
-		const instances = enumerateExpansionInstances(groupBinding, this.data, mergeFilters(parentFilter, ctx.rowFilter));
-		if (instances.length === 0) return 0;
-		let total = 0;
-		for (const instance of instances) {
-			const instanceCtx = {
-				...ctx,
-				rowFilter: instance.filter,
-				rowPath: [...ctx.rowPath, instance.index]
-			};
-			total += this.listInstanceCountOnRow(templateRow, instanceCtx) || 1;
-		}
-		return total;
-	}
-	layoutStandaloneRow(templateRow, ctx, physRowStart, physColStart) {
-		return this.layoutTemplateRow(templateRow, ctx, physRowStart, physColStart, null, 1, !this.rowUsesPackedColumns(templateRow));
-	}
-	rowUsesPackedColumns(templateRow) {
-		for (const entry of this.index.bindingsOnRow(templateRow)) {
-			if (isColSubtreeRoot(entry.binding, this.index)) return true;
-			if (isNestedColExpander(entry.binding, this.index)) return true;
-			if (entry.binding.colParent) {
-				const parent = this.index.bindingAt(entry.binding.colParent);
-				if (parent && isColExpanding(parent)) return true;
-			}
-		}
-		return false;
-	}
-	layoutTemplateRow(templateRow, ctx, physRowStart, physColStart, rowSubtreeRoot, groupMergeHeight, preserveLogicalCols = false, fixedListIndex, mergeListCount) {
-		for (const entry of this.index.bindingsOnRow(templateRow)) if (isNestedRowExpander(entry.binding, this.index)) return this.layoutNestedRowBand(templateRow, entry.addr, entry.binding, ctx, physRowStart, physColStart);
-		const cols = columnsOnRow(this.index, templateRow);
-		const placements = [];
-		let physCol = physColStart;
-		const packedCols = !preserveLogicalCols && this.rowUsesPackedColumns(templateRow);
-		const listCount = this.listInstanceCountOnRow(templateRow, ctx);
-		const rowSpan = fixedListIndex !== void 0 ? 1 : Math.max(listCount, 1);
-		const leadingGap = cols.length > 0 && cols[0] > physColStart;
-		for (const col of cols) {
-			const addr = {
-				row: templateRow,
-				col
-			};
-			const binding = this.index.bindingAt(addr);
-			const targetCol = packedCols && !leadingGap ? physCol : col;
-			if (binding && isColSubtreeRoot(binding, this.index)) {
-				const colResult = this.layoutColSubtree(addr, ctx, physRowStart, targetCol);
-				placements.push(...colResult.placements);
-				if (packedCols) physCol = leadingGap ? targetCol + colResult.colSpan : physCol + colResult.colSpan;
-				continue;
-			}
-			if (binding && isNestedColExpander(binding, this.index)) {
-				const colResult = this.layoutNestedColBand(addr, binding, ctx, physRowStart, targetCol);
-				placements.push(...colResult.placements);
-				if (packedCols) physCol = leadingGap ? targetCol + colResult.colSpan : physCol + colResult.colSpan;
-				continue;
-			}
-			if (binding && this.isInlineColChild(templateRow, col)) continue;
-			if (binding && binding.colParent && !isColExpanding(binding)) {
-				const colResult = this.layoutColParentAlignedCell(addr, binding, ctx, physRowStart, targetCol, rowSpan);
-				placements.push(...colResult.placements);
-				if (packedCols) physCol = leadingGap ? targetCol + colResult.colSpan : physCol + colResult.colSpan;
-				continue;
-			}
-			if (binding) {
-				const cellResult = this.layoutBindingCell(addr, binding, ctx, physRowStart, targetCol, rowSpan, rowSubtreeRoot, groupMergeHeight, fixedListIndex, mergeListCount);
-				placements.push(...cellResult.placements);
-				if (packedCols) physCol = leadingGap ? targetCol + cellResult.colSpan : physCol + cellResult.colSpan;
-				continue;
-			}
-			if (this.index.cellAt(addr)) {
-				if (rowSpan > 1) for (let i = 0; i < rowSpan; i++) placements.push(this.makePlacement(addr, singleCellRange(physRowStart + i, targetCol), ctx, void 0, i, false));
-				else placements.push(this.makePlacement(addr, singleCellRange(physRowStart, targetCol), ctx, void 0, 0, false));
-				if (packedCols) physCol = leadingGap ? targetCol + 1 : physCol + 1;
-			}
-		}
-		const effectiveColSpan = packedCols ? leadingGap && cols.length > 0 ? Math.max(...cols) + 1 - physColStart : physCol - physColStart : cols.length > 0 ? Math.max(...cols) + 1 - physColStart : 0;
-		return {
-			rowSpan: rowSubtreeRoot && templateRow === rowSubtreeRoot.row && listCount === 0 ? 0 : rowSpan,
-			colSpan: effectiveColSpan,
-			placements
-		};
-	}
-	layoutNestedRowBand(templateRow, groupAddr, groupBinding, ctx, physRowStart, physColStart) {
-		const parentFilter = parentFilterForBinding(groupBinding, this.index, ctx.rowFilter, ctx.colFilter);
-		const instances = enumerateExpansionInstances(groupBinding, this.data, mergeFilters(parentFilter, ctx.rowFilter));
-		if (instances.length === 0) return {
-			rowSpan: 0,
-			colSpan: 0,
-			placements: []
-		};
-		const placements = [];
-		let rowOffset = 0;
-		let maxColSpan = 0;
-		const colOffsets = this.rowLogicalColOffsets(templateRow, physColStart);
-		for (const instance of instances) {
-			const instanceCtx = {
-				...ctx,
-				rowFilter: instance.filter,
-				rowPath: [...ctx.rowPath, instance.index]
-			};
-			const detailCount = this.listInstanceCountOnRow(templateRow, instanceCtx) || 1;
-			if (mergeSpanEnabled(groupBinding)) placements.push(this.makePlacement(groupAddr, createRange({
-				row: physRowStart + rowOffset,
-				col: physColStart
-			}, {
-				row: physRowStart + rowOffset + detailCount - 1,
-				col: physColStart
-			}), instanceCtx, groupBinding, 0, true));
-			else for (let i = 0; i < detailCount; i++) placements.push(this.makePlacement(groupAddr, singleCellRange(physRowStart + rowOffset + i, physColStart), instanceCtx, groupBinding, i, false));
-			for (const entry of this.index.bindingsOnRow(templateRow)) {
-				if (sameAddress(entry.addr, groupAddr)) continue;
-				if (!isRowExpanding(entry.binding) || entry.binding.aggregate !== "list") continue;
-				for (let i = 0; i < detailCount; i++) placements.push(this.makePlacement(entry.addr, singleCellRange(physRowStart + rowOffset + i, colOffsets.get(entry.addr.col)), instanceCtx, entry.binding, i, false));
-			}
-			for (const col of columnsOnRow(this.index, templateRow)) {
-				if (this.index.bindingAt({
-					row: templateRow,
-					col
-				})) continue;
-				if (!this.index.cellAt({
-					row: templateRow,
-					col
-				})) continue;
-				for (let i = 0; i < detailCount; i++) placements.push(this.makePlacement({
-					row: templateRow,
-					col
-				}, singleCellRange(physRowStart + rowOffset + i, colOffsets.get(col)), instanceCtx, void 0, i, false));
-			}
-			maxColSpan = Math.max(maxColSpan, colOffsets.size);
-			rowOffset += detailCount;
-		}
-		return {
-			rowSpan: rowOffset,
-			colSpan: maxColSpan,
-			placements
-		};
-	}
-	layoutBindingCell(addr, binding, ctx, physRowStart, physColStart, rowSpan, rowSubtreeRoot, groupMergeHeight, fixedListIndex, mergeListCount) {
-		if (rowSubtreeRoot && isRowExpanding(binding) && binding.aggregate === "group" && sameAddress(addr, rowSubtreeRoot)) {
-			if (fixedListIndex !== void 0 && fixedListIndex > 0) return {
-				rowSpan: 0,
-				colSpan: 1,
-				placements: []
-			};
-			const mergeRows = Math.max(fixedListIndex !== void 0 ? mergeListCount ?? groupMergeHeight : groupMergeHeight, 1);
-			if (!mergeSpanEnabled(binding)) return {
-				rowSpan: 0,
-				colSpan: 1,
-				placements: Array.from({ length: mergeRows }, (_, listIndex) => this.makePlacement(addr, singleCellRange(physRowStart + listIndex, physColStart), ctx, binding, listIndex, false))
-			};
-			const range = createRange({
-				row: physRowStart,
-				col: physColStart
-			}, {
-				row: physRowStart + mergeRows - 1,
-				col: physColStart
-			});
-			return {
-				rowSpan: 0,
-				colSpan: 1,
-				placements: [this.makePlacement(addr, range, ctx, binding, 0, true)]
-			};
-		}
-		if (isRowExpanding(binding) && binding.aggregate === "list") {
-			if (fixedListIndex !== void 0) return {
-				rowSpan: 0,
-				colSpan: 1,
-				placements: [this.makePlacement(addr, singleCellRange(physRowStart, physColStart), ctx, binding, fixedListIndex, false)]
-			};
-			return {
-				rowSpan: 0,
-				colSpan: 1,
-				placements: Array.from({ length: rowSpan }, (_, listIndex) => this.makePlacement(addr, singleCellRange(physRowStart + listIndex, physColStart), ctx, binding, listIndex, false))
-			};
-		}
-		return {
-			rowSpan: 0,
-			colSpan: 1,
-			placements: [this.makePlacement(addr, expandRows(singleCellRange(physRowStart, physColStart), rowSpan), ctx, binding, 0, mergeSpanEnabled(binding) && rowSpan > 1)]
-		};
-	}
-	layoutColSubtree(rootAddr, ctx, physRowStart, physColStart) {
-		const rootBinding = this.index.bindingAt(rootAddr);
-		const parentFilter = parentFilterForBinding(rootBinding, this.index, ctx.rowFilter, ctx.colFilter);
-		const instances = enumerateExpansionInstances(rootBinding, this.data, mergeFilters(parentFilter, ctx.colFilter));
-		if (instances.length === 0) return {
-			rowSpan: 0,
-			colSpan: 0,
-			placements: []
-		};
-		const placements = [];
-		let totalColSpan = 0;
-		for (const instance of instances) {
-			const instanceCtx = {
-				rowFilter: ctx.rowFilter,
-				colFilter: instance.filter,
-				rowPath: ctx.rowPath,
-				colPath: [...ctx.colPath, instance.index]
-			};
-			const width = this.colInstanceWidth(rootAddr, instanceCtx);
-			const range = createRange({
-				row: physRowStart,
-				col: physColStart + totalColSpan
-			}, {
-				row: physRowStart,
-				col: physColStart + totalColSpan + width - 1
-			});
-			placements.push(this.makePlacement(rootAddr, range, instanceCtx, rootBinding, rootBinding.aggregate === "list" ? instance.index : 0, mergeSpanEnabled(rootBinding)));
-			totalColSpan += width;
-		}
-		return {
-			rowSpan: 1,
-			colSpan: totalColSpan,
-			placements
-		};
-	}
-	layoutNestedColBand(addr, binding, ctx, physRowStart, physColStart) {
-		const parentAddr = binding.colParent;
-		const parentBinding = this.index.bindingAt(parentAddr);
-		const parentFilter = parentFilterForBinding(parentBinding, this.index, ctx.rowFilter, ctx.colFilter);
-		const parentInstances = enumerateExpansionInstances(parentBinding, this.data, mergeFilters(parentFilter, ctx.colFilter));
-		const placements = [];
-		let colOffset = 0;
-		for (const parentInstance of parentInstances) {
-			const bandCtx = {
-				...ctx,
-				colFilter: parentInstance.filter,
-				colPath: [...ctx.colPath, parentInstance.index]
-			};
-			const childFilter = parentFilterForBinding(binding, this.index, bandCtx.rowFilter, bandCtx.colFilter);
-			const childInstances = enumerateExpansionInstances(binding, this.data, mergeFilters(childFilter, bandCtx.colFilter));
-			for (const childInstance of childInstances) {
-				const childCtx = {
-					...bandCtx,
-					colFilter: childInstance.filter,
-					colPath: [...bandCtx.colPath, childInstance.index]
-				};
-				placements.push(this.makePlacement(addr, singleCellRange(physRowStart, physColStart + colOffset), childCtx, binding, 0, false));
-				colOffset++;
-			}
-		}
-		return {
-			rowSpan: 1,
-			colSpan: colOffset,
-			placements
-		};
-	}
-	colInstanceWidth(rootAddr, ctx) {
-		const nestedChild = findNestedColChild(rootAddr, this.index);
-		if (nestedChild) {
-			const binding = this.index.bindingAt(nestedChild);
-			const parentFilter = parentFilterForBinding(binding, this.index, ctx.rowFilter, ctx.colFilter);
-			const instances = enumerateExpansionInstances(binding, this.data, mergeFilters(parentFilter, ctx.colFilter));
-			return Math.max(instances.length, 1);
-		}
-		if (!mergeSpanEnabled(this.index.bindingAt(rootAddr))) return 1;
-		let width = 0;
-		for (const col of colSubtreeCols(rootAddr, this.index)) {
-			if (col <= rootAddr.col) continue;
-			if (this.index.bindingAt({
-				row: rootAddr.row,
-				col
-			}) || this.index.cellAt({
-				row: rootAddr.row,
-				col
-			})) width++;
-		}
-		return Math.max(width, 1);
-	}
-	layoutColParentAlignedCell(addr, binding, ctx, physRowStart, physColStart, rowSpan) {
-		const colParent = binding.colParent;
-		const parentBinding = this.index.bindingAt(colParent);
-		const parentFilter = parentFilterForBinding(parentBinding, this.index, ctx.rowFilter, ctx.colFilter);
-		const instances = enumerateExpansionInstances(parentBinding, this.data, mergeFilters(parentFilter, ctx.colFilter));
-		if (instances.length === 0) return {
-			rowSpan: 0,
-			colSpan: 0,
-			placements: []
-		};
-		const placements = [];
-		let colOffset = 0;
-		for (const instance of instances) {
-			const instanceCtx = {
-				rowFilter: ctx.rowFilter,
-				colFilter: instance.filter,
-				rowPath: ctx.rowPath,
-				colPath: [...ctx.colPath, instance.index]
-			};
-			const width = this.colInstanceWidth(colParent, instanceCtx);
-			placements.push(this.makePlacement(addr, expandRows(singleCellRange(physRowStart, physColStart + colOffset), rowSpan), instanceCtx, binding, 0, mergeSpanEnabled(binding) && rowSpan > 1));
-			colOffset += width;
-		}
-		return {
-			rowSpan: 0,
-			colSpan: colOffset,
-			placements
-		};
-	}
-	isInlineColChild(row, col) {
-		const binding = this.index.bindingAt({
-			row,
-			col
-		});
-		if (!binding?.colParent) return false;
-		const parent = this.index.bindingAt(binding.colParent);
-		if (!parent || !isColExpanding(parent)) return false;
-		return binding.colParent.row === row;
-	}
-	listInstanceCountOnRow(templateRow, ctx) {
-		let count = 0;
-		for (const entry of this.index.bindingsOnRow(templateRow)) {
-			if (!isRowExpanding(entry.binding) || entry.binding.aggregate !== "list") continue;
-			const parentFilter = parentFilterForBinding(entry.binding, this.index, ctx.rowFilter, ctx.colFilter);
-			const instances = enumerateExpansionInstances(entry.binding, this.data, mergeFilters(parentFilter, ctx.rowFilter));
-			count = Math.max(count, instances.length);
-		}
-		return count;
-	}
-	rowLogicalColOffsets(templateRow, physColStart) {
-		const offsets = /* @__PURE__ */ new Map();
-		let physCol = physColStart;
-		for (const col of columnsOnRow(this.index, templateRow)) {
-			offsets.set(col, physCol);
-			physCol++;
-		}
-		return offsets;
-	}
-	makePlacement(logical, physical, ctx, binding, listIndex, mergeSpan) {
-		return {
-			logical,
-			physical,
-			rowPath: ctx.rowPath,
-			colPath: ctx.colPath,
-			mergeSpan,
-			binding,
-			listIndex
-		};
-	}
-};
-function emptyCtx() {
-	return {
-		rowFilter: {},
-		colFilter: {},
-		rowPath: [],
-		colPath: []
-	};
-}
-function expandRows(range, rowSpan) {
-	if (rowSpan <= 1) return range;
-	return createRange(range.start, {
-		row: range.start.row + rowSpan - 1,
-		col: range.end.col
-	});
-}
-/** 将模板合并区域映射到物理网格（基于锚点格的物理落点） */
-function mapTemplateMerges(index, placements) {
-	const layout = {
-		rowCount: 0,
-		colCount: 0,
-		placements,
-		mappedMerges: []
-	};
-	const mapped = [];
-	for (const merge of index.merges) {
-		const mappedRange = mapLogicalMerge(merge, layout);
-		if (mappedRange) mapped.push(mappedRange);
-	}
-	return mapped;
-}
-function mapLogicalMerge(merge, layout) {
-	const startHits = placementsAt(layout, merge.start);
-	if (startHits.length === 0) return null;
-	const startPlacement = startHits[0];
-	const endHits = placementsAt(layout, merge.end);
-	if (endHits.length > 0) return createRange(startPlacement.physical.start, endHits[endHits.length - 1].physical.end);
-	const logicalRowSpan = merge.end.row - merge.start.row;
-	const logicalColSpan = merge.end.col - merge.start.col;
-	return createRange(startPlacement.physical.start, {
-		row: startPlacement.physical.start.row + logicalRowSpan,
-		col: startPlacement.physical.start.col + logicalColSpan
-	});
-}
-/** 计算扩展坐标系：逻辑格 → 物理区间映射（纯计算、无快照输出） */
-function computeExpansionLayout(index, data) {
-	return new CoordinateEngine(index, data).compute();
-}
-/** 按逻辑地址查找全部物理落点 */
-function placementsAt(layout, addr) {
-	return layout.placements.filter((p) => sameAddress(p.logical, addr));
-}
-/** 物理区间行高（含合并） */
-function physicalRowSpan(placement) {
-	return rangeRows(placement.physical);
-}
-/** 物理区间列宽（含合并） */
-function physicalColSpan(placement) {
-	return rangeCols(placement.physical);
-}
-//#endregion
-export { computeExpansionLayout, enumerateExpansionInstances, mapTemplateMerges, physicalColSpan, physicalRowSpan, placementsAt };