@veltra/sheet 2.4.0 → 2.5.1

package/dist/report/export-xlsx.d.ts

@@ -1,13 +0,0 @@
-import { Sheet } from "@veltra/sheet-core";
-//#region src/report/export-xlsx.d.ts
-/** 列宽条目：模型列索引 → 像素宽（与 SheetSnapshot.colWidths 同构） */
-type ReportColWidthEntry = readonly [number, number];
-/**
- * 将已填充的 Sheet（Filled Report）导出为保真 XLSX（合并 / 样式 / 行高 / 列宽 / 浮动图）。
- * 组装与序列化委托 sheet-core `exportSheetXlsx`（与 `exportWorkbookXlsx` 同一套单表逻辑）；
- * 条件样式颜色已在 renderReport 展开阶段打平进 StylePool（ADR-0001 决策 2）。
- * 列宽取自 sheet 模型（`getColWidths`）。
- */
-declare function exportFilledReportXlsx(sheet: Sheet): Promise<Uint8Array>;
-//#endregion
-export { ReportColWidthEntry, exportFilledReportXlsx };

package/dist/report/export-xlsx.js

@@ -1,13 +0,0 @@
-import { exportSheetXlsx } from "@veltra/sheet-core/core/io/export";
-//#region src/report/export-xlsx.ts
-/**
-* 将已填充的 Sheet（Filled Report）导出为保真 XLSX（合并 / 样式 / 行高 / 列宽 / 浮动图）。
-* 组装与序列化委托 sheet-core `exportSheetXlsx`（与 `exportWorkbookXlsx` 同一套单表逻辑）；
-* 条件样式颜色已在 renderReport 展开阶段打平进 StylePool（ADR-0001 决策 2）。
-* 列宽取自 sheet 模型（`getColWidths`）。
-*/
-function exportFilledReportXlsx(sheet) {
-	return exportSheetXlsx(sheet, { fallbackName: "报表" });
-}
-//#endregion
-export { exportFilledReportXlsx };

package/dist/report/filter-bar.d.ts

@@ -1,10 +0,0 @@
-import { ParamValues } from "./types.js";
-//#region src/report/filter-bar.d.ts
-/** 将运行时 date-range 参数值规范为 [from, to] 字符串元组 */
-declare function parseDateRangeValue(raw: unknown): [string, string];
-/** 将运行时 number 参数值规范为 UNumberInput 可接受的 number | undefined */
-declare function resolveNumberParamValue(raw: unknown): number | undefined;
-/** 合并单参数变更，保持其余参数值不变 */
-declare function patchParamValues(values: ParamValues, id: string, value: unknown): ParamValues;
-//#endregion
-export { parseDateRangeValue, patchParamValues, resolveNumberParamValue };

package/dist/report/filter-bar.js

@@ -1,31 +0,0 @@
-//#region src/report/filter-bar.ts
-function toParamString(value) {
-	if (value == null || value === "") return "";
-	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return String(value);
-	return "";
-}
-/** 将运行时 date-range 参数值规范为 [from, to] 字符串元组 */
-function parseDateRangeValue(raw) {
-	if (Array.isArray(raw)) return [toParamString(raw[0]), toParamString(raw[1])];
-	if (raw && typeof raw === "object") {
-		const obj = raw;
-		return [toParamString(obj.from ?? obj.start), toParamString(obj.to ?? obj.end)];
-	}
-	return ["", ""];
-}
-/** 将运行时 number 参数值规范为 UNumberInput 可接受的 number | undefined */
-function resolveNumberParamValue(raw) {
-	if (raw === "" || raw == null) return void 0;
-	if (typeof raw === "number" && Number.isFinite(raw)) return raw;
-	const parsed = Number(raw);
-	return Number.isFinite(parsed) ? parsed : void 0;
-}
-/** 合并单参数变更，保持其余参数值不变 */
-function patchParamValues(values, id, value) {
-	return {
-		...values,
-		[id]: value
-	};
-}
-//#endregion
-export { parseDateRangeValue, patchParamValues, resolveNumberParamValue };

package/dist/report/index.d.ts

@@ -1,14 +0,0 @@
-import { ConditionalOperator, ConditionalRule, DatasetCatalogItem, DatasetField, DatasetRecords, ParamValues, QueryParamDef, QueryParamOption, QueryParamType, ReportAggregate, ReportBinding, ReportDrillConfig, ReportExpand, ReportPreset, ReportSort, ReportTemplateListItem } from "./types.js";
-import { InferParentOptions, ListParentCandidateOptions, REPORT_META_NAMESPACE, applyReportPreset, createReportBinding, formatBindingPlaceholder, formatBindingPlaceholderParts, formatCellAddress, formatParentCandidateLabel, inferColParentCandidate, inferDropPreset, inferParentsForPreset, inferReportPreset, inferRowParentCandidate, isColGroupBinding, isExpansionBandCol, isExpansionBandRow, isHorizontalExpandBinding, isReductionAggregate, isRowGroupBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, parseCellAddress, prefersGroupParent, presetBindingPatch, presetStillApplies, setBindingCatalog } from "./binding.js";
-import { ConditionalEvalContext, evaluateCondition, evaluateConditionalStyle, resolveRuleCompareValue, toComparableNumber } from "./rules/evaluate.js";
-import "./rules/index.js";
-import { buildParamDefs, extractParamIds, resolveBoundDatasetParams } from "./params.js";
-import { ReportColWidthEntry, exportFilledReportXlsx } from "./export-xlsx.js";
-import { mapFilledColWidths } from "./render/builder.js";
-import { renderReport, resolveFilledColWidths } from "./render/index.js";
-import { ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, QueryResult, Result, createHttpConnector, resolvePortOnTypeChange } from "./connector.js";
-import { IncompatibleTemplateVersionError, REPORT_TEMPLATE_VERSION, ReportDatasetDef, ReportTemplate, assertCompatibleTemplateVersion, createReportTemplate, fetchTemplateRecords, getBoundDatasetIds, getTemplateDatasets, resolveParamDefaults, resolveTemplateParams } from "./template.js";
-import { parseDateRangeValue, patchParamValues, resolveNumberParamValue } from "./filter-bar.js";
-import { DrillHit, DrillStack, DrillStackLayer, ResolveReportTemplate, buildDrillHitMap, createDrillStack, currentDrillLayer, popDrillLayer, pushDrillLayer, resolveDrillParams } from "./drill.js";
-import { ReportPrintOptions, buildFilledReportPrintHtml } from "./print.js";
-export { type ConditionalEvalContext, ConditionalOperator, ConditionalRule, ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, DatasetCatalogItem, DatasetField, DatasetRecords, DrillHit, DrillStack, DrillStackLayer, IncompatibleTemplateVersionError, InferParentOptions, ListParentCandidateOptions, ParamValues, QueryParamDef, QueryParamOption, QueryParamType, QueryResult, REPORT_META_NAMESPACE, REPORT_TEMPLATE_VERSION, ReportAggregate, ReportBinding, ReportColWidthEntry, ReportDatasetDef, ReportDrillConfig, ReportExpand, ReportPreset, ReportPrintOptions, ReportSort, ReportTemplate, ReportTemplateListItem, ResolveReportTemplate, Result, applyReportPreset, assertCompatibleTemplateVersion, buildDrillHitMap, buildFilledReportPrintHtml, buildParamDefs, createDrillStack, createHttpConnector, createReportBinding, createReportTemplate, currentDrillLayer, evaluateCondition, evaluateConditionalStyle, exportFilledReportXlsx, extractParamIds, fetchTemplateRecords, formatBindingPlaceholder, formatBindingPlaceholderParts, formatCellAddress, formatParentCandidateLabel, getBoundDatasetIds, getTemplateDatasets, inferColParentCandidate, inferDropPreset, inferParentsForPreset, inferReportPreset, inferRowParentCandidate, isColGroupBinding, isExpansionBandCol, isExpansionBandRow, isHorizontalExpandBinding, isReductionAggregate, isRowGroupBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, mapFilledColWidths, parseCellAddress, parseDateRangeValue, patchParamValues, popDrillLayer, prefersGroupParent, presetBindingPatch, presetStillApplies, pushDrillLayer, renderReport, resolveBoundDatasetParams, resolveDrillParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber };

package/dist/report/params.d.ts

@@ -1,13 +0,0 @@
-import { QueryParamDef } from "./types.js";
-//#region src/report/params.d.ts
-/** 从 SQL 提取 `${param}` 占位符 id（ADR-0002 决策 2：前端纯函数） */
-declare function extractParamIds(sql: string): string[];
-/**
- * 从 SQL 构建查询参数定义：提取 `${param}` 占位符 + 上下文类型推断，
- * 再叠加数据集编辑器的元数据覆盖（label / 类型 / 默认值 / 选项）。
- */
-declare function buildParamDefs(sql: string, overrides?: Record<string, Partial<Omit<QueryParamDef, 'id'>>>): QueryParamDef[];
-/** 按绑定的数据集 id 合并查询参数（同名参数先见为准） */
-declare function resolveBoundDatasetParams(queryParams: QueryParamDef[], boundDatasetIds: readonly string[], getDatasetParams: (datasetId: string) => QueryParamDef[]): QueryParamDef[];
-//#endregion
-export { buildParamDefs, extractParamIds, resolveBoundDatasetParams };

package/dist/report/params.js

@@ -1,61 +0,0 @@
-//#region src/report/params.ts
-/** 从 SQL 提取 `${param}` 占位符 id（ADR-0002 决策 2：前端纯函数） */
-function extractParamIds(sql) {
-	const ids = [];
-	const re = /\$\{([^}]+)\}/g;
-	let match;
-	while ((match = re.exec(sql)) !== null) {
-		const id = match[1].trim();
-		if (id && !ids.includes(id)) ids.push(id);
-	}
-	return ids;
-}
-function escapeRegExp(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-/** 从 SQL 上下文推断参数控件类型（BETWEEN/LIKE/数值比较） */
-function inferParamTypeFromSql(sql, paramId) {
-	if (new RegExp(`\\bBETWEEN\\s+\\$\\{${escapeRegExp(paramId)}\\}(?!\\s+AND)`, "i").test(sql)) return "date-range";
-	const pairMatch = new RegExp(`\\bBETWEEN\\s+\\$\\{${escapeRegExp(paramId)}\\}\\s+AND\\s+\\$\\{([^}]+)\\}`, "i").exec(sql);
-	if (pairMatch && pairMatch[1].trim() !== paramId) return "date";
-	if (new RegExp(`\\bLIKE\\s+\\$\\{${escapeRegExp(paramId)}\\}`, "i").test(sql)) return "text";
-	if (new RegExp(`[<>=]+\\s+\\$\\{${escapeRegExp(paramId)}\\}|\\$\\{${escapeRegExp(paramId)}\\}\\s*[<>=]+`, "i").test(sql)) return "number";
-	return "text";
-}
-function defaultValueForType(type) {
-	switch (type) {
-		case "number": return 0;
-		case "date-range": return ["", ""];
-		case "select": return "";
-		default: return "";
-	}
-}
-/**
-* 从 SQL 构建查询参数定义：提取 `${param}` 占位符 + 上下文类型推断，
-* 再叠加数据集编辑器的元数据覆盖（label / 类型 / 默认值 / 选项）。
-*/
-function buildParamDefs(sql, overrides) {
-	return extractParamIds(sql).map((id) => {
-		const inferred = inferParamTypeFromSql(sql, id);
-		const override = overrides?.[id];
-		return {
-			id,
-			label: override?.label ?? id,
-			type: override?.type ?? inferred,
-			defaultValue: override?.defaultValue ?? defaultValueForType(override?.type ?? inferred),
-			options: override?.options
-		};
-	});
-}
-/** 按绑定的数据集 id 合并查询参数（同名参数先见为准） */
-function resolveBoundDatasetParams(queryParams, boundDatasetIds, getDatasetParams) {
-	const map = /* @__PURE__ */ new Map();
-	for (const datasetId of boundDatasetIds) {
-		const params = getDatasetParams(datasetId);
-		for (const param of params) if (!map.has(param.id)) map.set(param.id, param);
-	}
-	if (map.size > 0) return Array.from(map.values());
-	return queryParams;
-}
-//#endregion
-export { buildParamDefs, extractParamIds, resolveBoundDatasetParams };

package/dist/report/print.d.ts

@@ -1,23 +0,0 @@
-import { Sheet } from "@veltra/sheet-core";
-//#region src/report/print.d.ts
-/** 报表打印选项 */
-interface ReportPrintOptions {
-  /** 打印文档标题（打印对话框标题 / 另存 PDF 文件名）；缺省取 sheet 名，再回落「报表」 */
-  title?: string;
-  /** 纸张方向（@page size），默认 portrait */
-  orientation?: 'portrait' | 'landscape';
-}
-/**
- * 将已填充的 Sheet（Filled Report）构建为打印专用 HTML 文档（纯 TS、headless、无 DOM）。
- *
- * 路线说明：网格渲染层是 canvas + 虚拟滚动（视口外不绘制），无法直接 window.print；
- * 这里从模型单一事实源（与 exportFilledReportXlsx 同一读取路径）重建 `<table>`——
- * 矢量文字清晰、浏览器原生分页、合并格天然映射 rowspan/colspan。
- *
- * 保真范围：值 / 合并 / 有效样式（fill + border + font + align/wrap，条件样式已在
- * 展开阶段打平进 StylePool）/ 行高 / 列宽 / 浮动图（data URL 内嵌，跨页被裁剪属预期）。
- * 与 Excel 默认一致：不打印屏幕网格线（仅模型显式边框）。
- */
-declare function buildFilledReportPrintHtml(sheet: Sheet, options?: ReportPrintOptions): string;
-//#endregion
-export { ReportPrintOptions, buildFilledReportPrintHtml };

package/dist/report/print.js

@@ -1,197 +0,0 @@
-import { BORDER_SIDES } from "@veltra/sheet-core";
-//#region src/report/print.ts
-/**
-* 默认列宽 / 行高（px）：与 grid 层 vtable-theme 的
-* SHEET_DEFAULT_COL_WIDTH / SHEET_DEFAULT_ROW_HEIGHT 对齐；
-* report 内核保持 headless，不引 grid 入口。
-*/
-const PRINT_DEFAULT_COL_WIDTH = 80;
-const PRINT_DEFAULT_ROW_HEIGHT = 28;
-const IMAGE_MIME = {
-	png: "image/png",
-	jpeg: "image/jpeg",
-	gif: "image/gif",
-	svg: "image/svg+xml",
-	webp: "image/webp"
-};
-/** 模型边框线型 → CSS 线型（thin/medium/thick 为实线粗细分级，宽度由 edge.width 表达） */
-const BORDER_CSS_LINE = {
-	thin: "solid",
-	medium: "solid",
-	thick: "solid",
-	dashed: "dashed",
-	dotted: "dotted"
-};
-function escapeHtml(text) {
-	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function escapeAttr(text) {
-	return escapeHtml(text).replace(/"/g, "&quot;");
-}
-/** Uint8Array → base64（分块避免栈溢出；btoa 在浏览器 / Node >=16 / Bun / happy-dom 均可用） */
-function bytesToBase64(data) {
-	let binary = "";
-	const CHUNK = 32768;
-	for (let i = 0; i < data.length; i += CHUNK) binary += String.fromCharCode(...data.subarray(i, i + CHUNK));
-	return btoa(binary);
-}
-/** 模型有效样式 → td 内联 CSS（字号 pt 直出，与屏幕 px ×4/3 物理尺寸一致） */
-function styleToCss(style) {
-	const decls = [];
-	if (style.fill?.color) decls.push(`background-color:${style.fill.color}`);
-	for (const side of BORDER_SIDES) {
-		const edge = style.border?.[side];
-		if (edge) decls.push(`border-${side}:${edge.width}px ${BORDER_CSS_LINE[edge.style]} ${edge.color}`);
-	}
-	const font = style.font;
-	if (font) {
-		if (font.color) decls.push(`color:${font.color}`);
-		if (font.bold) decls.push("font-weight:bold");
-		if (font.italic) decls.push("font-style:italic");
-		const decoration = [font.underline ? "underline" : "", font.strikethrough ? "line-through" : ""].filter(Boolean).join(" ");
-		if (decoration) decls.push(`text-decoration:${decoration}`);
-		if (typeof font.size === "number") decls.push(`font-size:${font.size}pt`);
-	}
-	const align = style.align;
-	if (align) {
-		if (align.horizontal) decls.push(`text-align:${align.horizontal}`);
-		if (align.vertical) decls.push(`vertical-align:${align.vertical}`);
-		if (align.wrap) decls.push("white-space:normal;word-break:break-all");
-	}
-	return decls.join(";");
-}
-/**
-* 浮动图打印定位（镜像 grid image-layer `computeImageRect`）：
-* left/top = from 格左上 + 格内像素偏移；宽高优先 image.width/height（两者都有才用），
-* 缺失且有 to 时按 from→to 跨度兜底，都缺失则省略尺寸（浏览器取自然尺寸）。
-*/
-function computePrintImageRect(image, colWidths, rowHeights) {
-	const { from, to } = image.anchor;
-	let left = from.offsetX ?? 0;
-	for (let c = 0; c < from.col; c++) left += colWidths[c] ?? PRINT_DEFAULT_COL_WIDTH;
-	let top = from.offsetY ?? 0;
-	for (let r = 0; r < from.row; r++) top += rowHeights[r] ?? PRINT_DEFAULT_ROW_HEIGHT;
-	if (image.width != null && image.height != null) return {
-		left,
-		top,
-		width: image.width,
-		height: image.height
-	};
-	if (to) {
-		let width = 0;
-		for (let c = from.col; c <= to.col; c++) width += colWidths[c] ?? PRINT_DEFAULT_COL_WIDTH;
-		let height = 0;
-		for (let r = from.row; r <= to.row; r++) height += rowHeights[r] ?? PRINT_DEFAULT_ROW_HEIGHT;
-		return {
-			left,
-			top,
-			width,
-			height
-		};
-	}
-	return {
-		left,
-		top
-	};
-}
-/**
-* 将已填充的 Sheet（Filled Report）构建为打印专用 HTML 文档（纯 TS、headless、无 DOM）。
-*
-* 路线说明：网格渲染层是 canvas + 虚拟滚动（视口外不绘制），无法直接 window.print；
-* 这里从模型单一事实源（与 exportFilledReportXlsx 同一读取路径）重建 `<table>`——
-* 矢量文字清晰、浏览器原生分页、合并格天然映射 rowspan/colspan。
-*
-* 保真范围：值 / 合并 / 有效样式（fill + border + font + align/wrap，条件样式已在
-* 展开阶段打平进 StylePool）/ 行高 / 列宽 / 浮动图（data URL 内嵌，跨页被裁剪属预期）。
-* 与 Excel 默认一致：不打印屏幕网格线（仅模型显式边框）。
-*/
-function buildFilledReportPrintHtml(sheet, options) {
-	const title = options?.title ?? sheet.name ?? "";
-	const orientation = options?.orientation ?? "portrait";
-	let maxRow = -1;
-	let maxCol = -1;
-	const grow = (row, col) => {
-		if (row > maxRow) maxRow = row;
-		if (col > maxCol) maxCol = col;
-	};
-	for (const [addr] of sheet.store.peekEntries()) grow(addr.row, addr.col);
-	for (const [row] of sheet.getRowHeights()) grow(row, 0);
-	for (const [col] of sheet.getColWidths()) grow(0, col);
-	const merges = sheet.merges.getMerges();
-	for (const range of merges) grow(range.end.row, range.end.col);
-	const images = sheet.getImages();
-	for (const image of images) {
-		grow(image.anchor.from.row, image.anchor.from.col);
-		if (image.anchor.to) grow(image.anchor.to.row, image.anchor.to.col);
-	}
-	const colWidths = [];
-	for (let c = 0; c <= maxCol; c++) colWidths.push(sheet.getColWidth(c) ?? PRINT_DEFAULT_COL_WIDTH);
-	const rowHeights = [];
-	for (let r = 0; r <= maxRow; r++) rowHeights.push(sheet.getRowHeight(r) ?? PRINT_DEFAULT_ROW_HEIGHT);
-	const spanByAnchor = /* @__PURE__ */ new Map();
-	const covered = /* @__PURE__ */ new Set();
-	for (const range of merges) {
-		const rowSpan = range.end.row - range.start.row + 1;
-		const colSpan = range.end.col - range.start.col + 1;
-		spanByAnchor.set(`${range.start.row},${range.start.col}`, {
-			rowSpan,
-			colSpan
-		});
-		for (let r = range.start.row; r <= range.end.row; r++) for (let c = range.start.col; c <= range.end.col; c++) if (r !== range.start.row || c !== range.start.col) covered.add(`${r},${c}`);
-	}
-	const css = [
-		`@page { size: A4 ${orientation}; margin: 12mm; }`,
-		"html, body { margin: 0; padding: 0; }",
-		"body { font-family: Arial, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif; font-size: 12px; color: #1f2329; -webkit-print-color-adjust: exact; print-color-adjust: exact; }",
-		".sheet-print-root { position: relative; }",
-		"table { border-collapse: collapse; table-layout: fixed; }",
-		"tr { break-inside: avoid; }",
-		"td { box-sizing: border-box; padding: 2px 6px; overflow: hidden; white-space: nowrap; vertical-align: middle; text-align: left; }",
-		".sheet-print-root img { position: absolute; }"
-	].join("\n");
-	const parts = [];
-	parts.push("<!doctype html><html><head><meta charset=\"utf-8\">");
-	parts.push(`<title>${escapeHtml(title || "报表")}</title>`);
-	parts.push(`<style>\n${css}\n</style></head><body>`);
-	parts.push("<div class=\"sheet-print-root\">");
-	parts.push("<table>");
-	if (colWidths.length > 0) {
-		parts.push("<colgroup>");
-		for (const width of colWidths) parts.push(`<col style="width:${width}px">`);
-		parts.push("</colgroup>");
-	}
-	for (let r = 0; r <= maxRow; r++) {
-		parts.push(`<tr style="height:${rowHeights[r]}px">`);
-		for (let c = 0; c <= maxCol; c++) {
-			if (covered.has(`${r},${c}`)) continue;
-			const attrs = [];
-			const span = spanByAnchor.get(`${r},${c}`);
-			if (span && span.colSpan > 1) attrs.push(`colspan="${span.colSpan}"`);
-			if (span && span.rowSpan > 1) attrs.push(`rowspan="${span.rowSpan}"`);
-			const style = sheet.getEffectiveStyle({
-				row: r,
-				col: c
-			});
-			const cellCss = style ? styleToCss(style) : "";
-			if (cellCss) attrs.push(`style="${escapeAttr(cellCss)}"`);
-			const value = sheet.getDisplayValue({
-				row: r,
-				col: c
-			});
-			const text = value == null ? "" : escapeHtml(String(value));
-			parts.push(`<td${attrs.length > 0 ? ` ${attrs.join(" ")}` : ""}>${text}</td>`);
-		}
-		parts.push("</tr>");
-	}
-	parts.push("</table>");
-	for (const image of images) {
-		const rect = computePrintImageRect(image, colWidths, rowHeights);
-		const size = rect.width != null && rect.height != null ? `width:${rect.width}px;height:${rect.height}px;` : "";
-		const src = `data:${IMAGE_MIME[image.type]};base64,${bytesToBase64(image.data)}`;
-		parts.push(`<img src="${src}" style="left:${rect.left}px;top:${rect.top}px;${size}" alt="${escapeAttr(image.altText ?? "")}">`);
-	}
-	parts.push("</div></body></html>");
-	return parts.join("");
-}
-//#endregion
-export { buildFilledReportPrintHtml };

package/dist/report/render/aggregate.js

@@ -1,193 +0,0 @@
-import { enumerateExpansionInstances } from "./coordinate.js";
-//#region src/report/render/aggregate.ts
-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));
-}
-/** 对数值集求聚合；`avg` 空集返回 `undefined`，`sum` 空集仍为 `0` */
-function aggregateField(rows, field, aggregate) {
-	if (aggregate === "count") return rows.length;
-	if (aggregate === "list" || aggregate === "group") return rows[0]?.[field];
-	const numbers = rows.map((row) => row[field]).map((value) => typeof value === "number" ? value : Number(value)).filter((value) => Number.isFinite(value));
-	if (numbers.length === 0) {
-		if (aggregate === "avg") return void 0;
-		return 0;
-	}
-	const sum = numbers.reduce((acc, value) => acc + value, 0);
-	if (aggregate === "avg") return sum / numbers.length;
-	if (aggregate === "max") return Math.max(...numbers);
-	if (aggregate === "min") return Math.min(...numbers);
-	return sum;
-}
-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 isReductionAggregate(aggregate) {
-	return aggregate === "sum" || aggregate === "avg" || aggregate === "count" || aggregate === "max" || aggregate === "min";
-}
-function rowExpandingAncestors(binding, index, groupsOnly) {
-	const chain = [];
-	let current = binding.rowParent;
-	while (current) {
-		const parentBinding = index.bindingAt(current);
-		if (parentBinding) chain.unshift({
-			addr: current,
-			binding: parentBinding
-		});
-		current = parentBinding?.rowParent;
-	}
-	return chain.filter((item) => {
-		if (!isRowExpanding(item.binding)) return false;
-		if (groupsOnly && item.binding.aggregate !== "group") return false;
-		return true;
-	});
-}
-function colExpandingAncestors(binding, index, groupsOnly) {
-	const chain = [];
-	let current = binding.colParent;
-	while (current) {
-		const parentBinding = index.bindingAt(current);
-		if (parentBinding) chain.unshift({
-			addr: current,
-			binding: parentBinding
-		});
-		current = parentBinding?.colParent;
-	}
-	return chain.filter((item) => {
-		if (!isColExpanding(item.binding)) return false;
-		if (groupsOnly && item.binding.aggregate !== "group") return false;
-		return true;
-	});
-}
-function mergeFilters(rowFilter, colFilter) {
-	return {
-		...rowFilter,
-		...colFilter
-	};
-}
-function resolveAncestorFilters(binding, placement, index, data) {
-	const rowFilter = {};
-	const colFilter = {};
-	let parentFilter = {};
-	const groupsOnly = isReductionAggregate(binding.aggregate);
-	const rowAncestors = rowExpandingAncestors(binding, index, groupsOnly);
-	for (let i = 0; i < rowAncestors.length; i++) {
-		const ancestor = rowAncestors[i];
-		if (ancestor.binding.dataset !== binding.dataset) continue;
-		const instances = enumerateExpansionInstances(ancestor.binding, data, parentFilter);
-		const pathIndex = placement.rowPath[i];
-		if (pathIndex === void 0) continue;
-		const instance = instances[pathIndex];
-		if (!instance) continue;
-		Object.assign(rowFilter, instance.filter);
-		parentFilter = instance.filter;
-	}
-	parentFilter = {};
-	const colAncestors = colExpandingAncestors(binding, index, groupsOnly);
-	for (let i = 0; i < colAncestors.length; i++) {
-		const ancestor = colAncestors[i];
-		if (ancestor.binding.dataset !== binding.dataset) continue;
-		const instances = enumerateExpansionInstances(ancestor.binding, data, parentFilter);
-		const pathIndex = placement.colPath[i];
-		if (pathIndex === void 0) continue;
-		const instance = instances[pathIndex];
-		if (!instance) continue;
-		Object.assign(colFilter, instance.filter);
-		parentFilter = instance.filter;
-	}
-	return mergeFilters(rowFilter, colFilter);
-}
-function resolveOwnGroupValue(binding, placement, index, data) {
-	const rowAncestors = rowExpandingAncestors(binding, index, false);
-	const colAncestors = colExpandingAncestors(binding, index, false);
-	let parentFilter = {};
-	for (let i = 0; i < rowAncestors.length; i++) {
-		const ancestor = rowAncestors[i];
-		if (ancestor.binding.dataset !== binding.dataset) continue;
-		const instances = enumerateExpansionInstances(ancestor.binding, data, parentFilter);
-		const pathIndex = placement.rowPath[i];
-		if (pathIndex === void 0) continue;
-		const instance = instances[pathIndex];
-		if (instance) parentFilter = instance.filter;
-	}
-	for (let i = 0; i < colAncestors.length; i++) {
-		const ancestor = colAncestors[i];
-		if (ancestor.binding.dataset !== binding.dataset) continue;
-		const instances = enumerateExpansionInstances(ancestor.binding, data, parentFilter);
-		const pathIndex = placement.colPath[i];
-		if (pathIndex === void 0) continue;
-		const instance = instances[pathIndex];
-		if (instance) parentFilter = instance.filter;
-	}
-	const instances = enumerateExpansionInstances(binding, data, parentFilter);
-	const pathIndex = isRowExpanding(binding) ? placement.rowPath.at(-1) : placement.colPath.at(-1);
-	if (pathIndex === void 0) return void 0;
-	return instances[pathIndex]?.value;
-}
-/** 按分组字段建索引，避免交叉展开重复 filterRows */
-var AggregateIndex = class {
-	datasets = /* @__PURE__ */ new Map();
-	filterCache = /* @__PURE__ */ new Map();
-	constructor(data) {
-		for (const [datasetId, rows] of Object.entries(data)) this.datasets.set(datasetId, rows);
-	}
-	rowsFor(dataset, filter) {
-		const cacheKey = `${dataset}:${JSON.stringify(filter)}`;
-		const cached = this.filterCache.get(cacheKey);
-		if (cached) return cached;
-		const rows = filterRows(this.datasets.get(dataset) ?? [], filter);
-		this.filterCache.set(cacheKey, rows);
-		return rows;
-	}
-	aggregate(dataset, filter, field, aggregate) {
-		const rows = this.rowsFor(dataset, filter);
-		if (aggregate === "list") return rows[0]?.[field];
-		return aggregateField(rows, field, aggregate);
-	}
-};
-/** 解析单个物理落点的绑定取值 */
-function resolvePlacementValue(placement, index, data, aggregateIndex) {
-	const binding = placement.binding;
-	if (!binding) return void 0;
-	const filter = resolveAncestorFilters(binding, placement, index, data);
-	const rows = aggregateIndex.rowsFor(binding.dataset, filter);
-	if (binding.aggregate === "group") return filter[binding.field] ?? resolveOwnGroupValue(binding, placement, index, data);
-	if (binding.aggregate === "list") return rows[placement.listIndex]?.[binding.field];
-	return aggregateField(rows, binding.field, binding.aggregate);
-}
-/** 解析 `list` 明细落点对应的源数据行；非 list 绑定无单条记录上下文 */
-function resolvePlacementRecord(placement, index, data, aggregateIndex) {
-	const binding = placement.binding;
-	if (!binding || binding.aggregate !== "list") return void 0;
-	const filter = resolveAncestorFilters(binding, placement, index, data);
-	return aggregateIndex.rowsFor(binding.dataset, filter)[placement.listIndex];
-}
-/**
-* 解析落点的上下文记录（下钻字段映射用）：
-* `list` 明细取源数据行；分组/汇总格取祖先分组过滤值合成的上下文
-* （分组格含自身分组值，如地区分组格 → `{ region: '华东' }`；
-* 汇总聚合格如 sum/avg/count/max/min 也将本格聚合计算值并入上下文，如 `{ region: '华东', total: 300 }`）。
-*/
-function resolvePlacementContext(placement, index, data, aggregateIndex) {
-	const binding = placement.binding;
-	if (!binding) return void 0;
-	if (binding.aggregate === "list") return resolvePlacementRecord(placement, index, data, aggregateIndex);
-	const filter = resolveAncestorFilters(binding, placement, index, data);
-	if (binding.aggregate === "group") {
-		const value = filter[binding.field] ?? resolveOwnGroupValue(binding, placement, index, data);
-		return value === void 0 ? filter : {
-			...filter,
-			[binding.field]: value
-		};
-	}
-	const value = resolvePlacementValue(placement, index, data, aggregateIndex);
-	return value === void 0 ? filter : {
-		...filter,
-		[binding.field]: value
-	};
-}
-//#endregion
-export { AggregateIndex, aggregateField, resolvePlacementContext, resolvePlacementRecord, resolvePlacementValue };

package/dist/report/render/builder.d.ts

@@ -1,12 +0,0 @@
-import "../types.js";
-import { ReportColWidthEntry } from "../export-xlsx.js";
-import { TemplateIndex } from "./template-index.js";
-import { ExpansionLayout } from "./coordinate.js";
-import { SheetSnapshot } from "@veltra/sheet-core";
-//#region src/report/render/builder.d.ts
-/**
- * 将模板列宽映射到填充报表物理列：横向展开列继承列方向父格所在模板列宽。
- */
-declare function mapFilledColWidths(templateColWidths: ReadonlyArray<ReportColWidthEntry>, layout: ExpansionLayout, _index: TemplateIndex): ReportColWidthEntry[];
-//#endregion
-export { mapFilledColWidths };