@veltra/sheet 2.3.4 → 2.4.0

package/dist/components/report/report-viewer.js

@@ -1,16 +1,22 @@
 import _sfc_main$1 from "../sheet/sheet.js";
 import { exportFilledReportXlsx } from "../../report/export-xlsx.js";
+import { buildFilledReportPrintHtml } from "../../report/print.js";
 import { applyGridColWidths, applySheetColWidths } from "./designer/col-widths.js";
 import _sfc_main$2 from "./filter-bar.js";
 import { previewGridSize } from "./preview-grid-size.js";
+import { printHtmlDocument } from "./print.js";
 import { useReportViewer } from "./use-report-viewer.js";
-import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, nextTick, normalizeClass, openBlock, toDisplayString, unref, useTemplateRef, watch } from "vue";
+import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, nextTick, normalizeClass, openBlock, ref, resolveComponent, shallowRef, toDisplayString, unref, useTemplateRef, watch, withCtx } from "vue";
+import { UButton, UDialog } from "@veltra/desktop";
 import { bem } from "@veltra/utils";
 import { saveBlob } from "@cat-kit/fe";
 import { Workbook } from "@veltra/sheet-core";
 //#region src/components/report/report-viewer.vue
 const EXPORT_NOT_READY_MESSAGE = "报表数据尚未就绪，请等待取数完成后再导出";
 const EXPORT_LOADING_MESSAGE = "报表数据加载中，请稍后再导出";
+/** 取数未完成时拒绝打印的可读错误 */
+const PRINT_NOT_READY_MESSAGE = "报表数据尚未就绪，请等待取数完成后再打印";
+const PRINT_LOADING_MESSAGE = "报表数据加载中，请稍后再打印";
 /** 查看器工作簿：宿主可注入（同 USheet `workbook?` 先例），缺省内部自建；模板 / 填充结果都 restore 进活动 sheet 只读展示 */
 const _sfc_main = /*@__PURE__*/ defineComponent({
 	name: "UReportViewer",
@@ -19,26 +25,45 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		connector: {},
 		template: {},
 		workbook: {},
-		colWidths: {}
+		colWidths: {},
+		resolveTemplate: { type: Function },
+		initialValues: {}
 	},
 	setup(__props, { expose: __expose }) {
+		/** 与 `ReportViewerProps` 交叉显式列出下钻 props，避免 SFC 对跨文件 interface 漏抽 runtime 声明 */
 		const props = __props;
 		const cls = bem("report-viewer");
 		/** 取数未完成时拒绝导出的可读错误 */
 		const internalWorkbook = new Workbook();
 		const workbook = computed(() => props.workbook ?? internalWorkbook);
 		const sheetRef = useTemplateRef("sheetRef");
-		const { params, values, loading, error, filledSnapshot, filledColWidths, refresh, setValues } = useReportViewer(props);
+		const { params, values, loading, error, filledSnapshot, filledColWidths, currentTemplate, canDrillBack, resolveDrillHit, resolveDrillTarget, drillInto, drillBack, refresh, setValues } = useReportViewer(props);
+		/** 配了下钻的单元格在查看态展示可点击链接样式（蓝字 + 下划线），便于用户直观感知 */
+		const resolveViewerCellStyle = (addr, base) => {
+			if (!props.resolveTemplate) return base;
+			if (!resolveDrillHit(addr)) return base;
+			return {
+				...base,
+				font: {
+					...base?.font,
+					color: base?.font?.color ?? "#2f54eb",
+					underline: base?.font?.underline ?? true
+				}
+			};
+		};
+		/** 弹框下钻：先挂 UDialog 再打开，避免 modelValue 初始为 true 时 overlay 不进入 */
+		const drillDialogVisible = ref(false);
+		const drillDialog = shallowRef(null);
 		const renderSize = computed(() => {
 			const filled = filledSnapshot.value;
 			if (filled) return previewGridSize(filled, "filled");
-			return previewGridSize(props.template, "template");
+			return previewGridSize(currentTemplate.value, "template");
 		});
-		/** 宿主显式传入优先；否则取数完成后用展开映射列宽；再回落模板设计态列宽 */
+		/** 宿主显式传入优先；否则取数完成后用展开映射列宽；再回落当前层模板设计态列宽 */
 		const effectiveColWidths = computed(() => {
 			if (props.colWidths?.length) return props.colWidths;
 			if (filledColWidths.value?.length) return filledColWidths.value;
-			return props.template.colWidths;
+			return currentTemplate.value.colWidths;
 		});
 		/** 将运行时列宽写入模型与 VTable（模型为单一事实源；grid 构造/content-reset 也会回放） */
 		function applyRuntimeColWidths() {
@@ -64,11 +89,65 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 			sheet.history.clear();
 			nextTick(applyRuntimeColWidths);
 		}
-		watch(() => props.template, (template) => applySnapshot(template, "template"), { immediate: true });
+		watch(currentTemplate, (template) => applySnapshot(template, "template"), { immediate: true });
 		watch(filledSnapshot, (filled) => {
 			if (filled) applySnapshot(filled, "filled");
 		});
 		watch(effectiveColWidths, applyRuntimeColWidths);
+		/** 悬停命中下钻格时给网格加 cursor 提示 */
+		const drillHover = ref(false);
+		let pointerStart = null;
+		watch(drillDialogVisible, (visible) => {
+			if (!visible) drillDialog.value = null;
+		});
+		async function openDrillDialog(config, record) {
+			const next = await resolveDrillTarget(config, record);
+			if (!next) return;
+			drillDialog.value = next;
+			await nextTick();
+			drillDialogVisible.value = true;
+		}
+		/** 事件坐标 → 模型地址（经当前 SheetGrid 命中测试；网格随内容尺寸重建，实例按事件时刻取） */
+		function resolveEventAddr(event) {
+			const gridEl = event.currentTarget.querySelector(".u-sheet__grid-instance");
+			const grid = sheetRef.value?.getGrid();
+			if (!gridEl || !grid) return null;
+			const rect = gridEl.getBoundingClientRect();
+			return grid.hitTestSheetAddr(event.clientX - rect.left, event.clientY - rect.top);
+		}
+		function handleGridPointerDown(event) {
+			pointerStart = {
+				x: event.clientX,
+				y: event.clientY
+			};
+		}
+		function handleGridClick(event) {
+			if (!props.resolveTemplate) return;
+			const start = pointerStart;
+			pointerStart = null;
+			if (start) {
+				const dx = event.clientX - start.x;
+				const dy = event.clientY - start.y;
+				if (dx * dx + dy * dy > 16) return;
+			}
+			const addr = resolveEventAddr(event);
+			if (!addr) return;
+			const hit = resolveDrillHit(addr);
+			if (!hit) return;
+			if (hit.config.openMode === "dialog") {
+				openDrillDialog(hit.config, hit.record);
+				return;
+			}
+			drillInto(hit.config, hit.record);
+		}
+		function handleGridPointerMove(event) {
+			const addr = props.resolveTemplate ? resolveEventAddr(event) : null;
+			const next = !!(addr ? resolveDrillHit(addr) : null);
+			if (next !== drillHover.value) drillHover.value = next;
+		}
+		function handleGridPointerLeave() {
+			drillHover.value = false;
+		}
 		async function exportXlsx() {
 			if (loading.value) throw new Error(EXPORT_LOADING_MESSAGE);
 			if (!filledSnapshot.value) throw new Error(EXPORT_NOT_READY_MESSAGE);
@@ -76,47 +155,97 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 			const buffer = await exportFilledReportXlsx(sheet);
 			saveBlob(new Blob([buffer], { type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" }), `${sheet.name || "报表"}.xlsx`);
 		}
+		/**
+		* 打印填充报表（纯前端）：填充 sheet 模型 → 打印专用 HTML（buildFilledReportPrintHtml）
+		* → 隐藏 iframe 调起浏览器打印。守卫语义与 exportXlsx 一致（取数完成前拒绝）。
+		*/
+		function print(options) {
+			if (loading.value) throw new Error(PRINT_LOADING_MESSAGE);
+			if (!filledSnapshot.value) throw new Error(PRINT_NOT_READY_MESSAGE);
+			printHtmlDocument(buildFilledReportPrintHtml(workbook.value.activeSheet, options));
+		}
 		__expose({
 			refresh,
-			exportXlsx
+			exportXlsx,
+			print
 		});
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("div", { class: normalizeClass(unref(cls).b) }, [unref(params).length ? (openBlock(), createBlock(_sfc_main$2, {
-				key: 0,
-				"query-params": unref(params),
-				values: unref(values),
-				"onUpdate:values": unref(setValues)
-			}, null, 8, [
-				"query-params",
-				"values",
-				"onUpdate:values"
-			])) : createCommentVNode("v-if", true), createElementVNode("div", { class: normalizeClass(unref(cls).e("body")) }, [unref(loading) ? (openBlock(), createElementBlock("div", {
-				key: 0,
-				class: normalizeClass(unref(cls).e("loading")),
-				"aria-live": "polite"
-			}, [createElementVNode("div", { class: normalizeClass(unref(cls).e("loading-spinner")) }, null, 2), _cache[0] || (_cache[0] = createElementVNode("span", null, "正在加载报表数据…", -1))], 2)) : unref(error) ? (openBlock(), createElementBlock("div", {
-				key: 1,
-				class: normalizeClass(unref(cls).e("error")),
-				role: "alert"
-			}, toDisplayString(unref(error).message), 3)) : createCommentVNode("v-if", true), createVNode(unref(_sfc_main$1), {
-				ref_key: "sheetRef",
-				ref: sheetRef,
-				class: normalizeClass(unref(cls).e("sheet")),
-				workbook: workbook.value,
-				rows: renderSize.value.rows,
-				cols: renderSize.value.cols,
-				"show-toolbar": false,
-				"show-formula-bar": false,
-				"show-tabs": false,
-				"show-row-header": false,
-				"show-col-header": false,
-				readonly: ""
-			}, null, 8, [
-				"class",
-				"workbook",
-				"rows",
-				"cols"
-			])], 2)], 2);
+			const _component_u_report_viewer = resolveComponent("u-report-viewer");
+			return openBlock(), createElementBlock("div", { class: normalizeClass(unref(cls).b) }, [
+				unref(params).length ? (openBlock(), createBlock(_sfc_main$2, {
+					key: 0,
+					"query-params": unref(params),
+					values: unref(values),
+					"onUpdate:values": unref(setValues)
+				}, null, 8, [
+					"query-params",
+					"values",
+					"onUpdate:values"
+				])) : createCommentVNode("v-if", true),
+				unref(canDrillBack) ? (openBlock(), createElementBlock("div", {
+					key: 1,
+					class: normalizeClass(unref(cls).e("drill-bar"))
+				}, [createVNode(unref(UButton), {
+					size: "small",
+					plain: "",
+					onClick: unref(drillBack)
+				}, {
+					default: withCtx(() => [..._cache[1] || (_cache[1] = [createTextVNode("返回上一层", -1)])]),
+					_: 1
+				}, 8, ["onClick"])], 2)) : createCommentVNode("v-if", true),
+				createElementVNode("div", { class: normalizeClass(unref(cls).e("body")) }, [unref(loading) ? (openBlock(), createElementBlock("div", {
+					key: 0,
+					class: normalizeClass(unref(cls).e("loading")),
+					"aria-live": "polite"
+				}, [createElementVNode("div", { class: normalizeClass(unref(cls).e("loading-spinner")) }, null, 2), _cache[2] || (_cache[2] = createElementVNode("span", null, "正在加载报表数据…", -1))], 2)) : unref(error) ? (openBlock(), createElementBlock("div", {
+					key: 1,
+					class: normalizeClass(unref(cls).e("error")),
+					role: "alert"
+				}, toDisplayString(unref(error).message), 3)) : createCommentVNode("v-if", true), createVNode(unref(_sfc_main$1), {
+					ref_key: "sheetRef",
+					ref: sheetRef,
+					class: normalizeClass([unref(cls).e("sheet"), drillHover.value ? unref(cls).em("sheet", "drill-hover") : ""]),
+					workbook: workbook.value,
+					rows: renderSize.value.rows,
+					cols: renderSize.value.cols,
+					"show-toolbar": false,
+					"show-formula-bar": false,
+					"show-tabs": false,
+					"show-row-header": false,
+					"show-col-header": false,
+					"resolve-cell-style": resolveViewerCellStyle,
+					readonly: "",
+					onPointerdown: handleGridPointerDown,
+					onPointermove: handleGridPointerMove,
+					onPointerleave: handleGridPointerLeave,
+					onClick: handleGridClick
+				}, null, 8, [
+					"class",
+					"workbook",
+					"rows",
+					"cols"
+				])], 2),
+				drillDialog.value ? (openBlock(), createBlock(unref(UDialog), {
+					key: 2,
+					modelValue: drillDialogVisible.value,
+					"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => drillDialogVisible.value = $event),
+					title: "详情报表",
+					class: normalizeClass(unref(cls).e("drill-dialog"))
+				}, {
+					default: withCtx(() => [createVNode(_component_u_report_viewer, {
+						connector: __props.connector,
+						template: drillDialog.value.template,
+						"initial-values": drillDialog.value.params,
+						"resolve-template": __props.resolveTemplate
+					}, null, 8, [
+						"connector",
+						"template",
+						"initial-values",
+						"resolve-template"
+					])]),
+					_: 1
+				}, 8, ["modelValue", "class"])) : createCommentVNode("v-if", true)
+			], 2);
 		};
 	}
 });

package/dist/components/report/style2.css

@@ -37,6 +37,40 @@
   flex: 1;
   min-height: 0;
   min-width: 0;
+  /* 下钻格可点提示：VTable pointermove 会把容器内联 cursor 重置为 default，需 !important 覆盖 */
+}
+.u-report-viewer__sheet--drill-hover,
+.u-report-viewer__sheet--drill-hover .u-sheet__grid-instance,
+.u-report-viewer__sheet--drill-hover .u-sheet__grid-instance canvas,
+.u-report-viewer__sheet--drill-hover .u-sheet__grid-instance * {
+  cursor: pointer !important;
+}
+.u-report-viewer__drill-bar {
+  display: flex;
+  align-items: center;
+  gap: var(--u-gap-small);
+}
+.u-report-viewer {
+  /* 下钻弹框挂在 UDialog 根（Teleport 到 body），给内嵌查看器明确高度 */
+}
+.u-report-viewer__drill-dialog {
+  width: min(960px, 92vw);
+  height: min(80vh, 720px);
+}
+.u-report-viewer__drill-dialog .u-dialog__body {
+  flex: 1;
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+}
+.u-report-viewer__drill-dialog .u-scroll__container,
+.u-report-viewer__drill-dialog .u-scroll__content {
+  height: 100%;
+  min-height: 0;
+}
+.u-report-viewer__drill-dialog .u-report-viewer {
+  height: 100%;
+  min-height: 0;
 }
 .u-report-viewer__loading {
   position: absolute;
@@ -368,6 +402,63 @@
   color: var(--u-text-color-second);
 }
 
+/* 下钻配置对话框内容 */
+.u-report-drill-dialog {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.u-report-drill-dialog__section {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.u-report-drill-dialog__label {
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--u-text-color-second);
+}
+.u-report-drill-dialog__hint {
+  margin: 0;
+  font-size: 12px;
+  line-height: 1.5;
+  color: var(--u-text-color-second);
+}
+.u-report-drill-dialog__error {
+  margin: 0;
+  font-size: 12px;
+  line-height: 1.5;
+  color: var(--u-color-danger);
+}
+.u-report-drill-dialog__list {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  max-height: 320px;
+  overflow: auto;
+}
+.u-report-drill-dialog__mapping {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+.u-report-drill-dialog__field {
+  width: 160px;
+  flex: none;
+}
+.u-report-drill-dialog__param {
+  width: 200px;
+  flex: none;
+}
+.u-report-drill-dialog__arrow {
+  flex: none;
+  font-size: 12px;
+  color: var(--u-text-color-second);
+}
+
 .u-report-rule-row {
   display: flex;
   align-items: flex-start;

package/dist/components/report/use-report-designer.js

@@ -152,6 +152,7 @@ function useReportDesigner(options) {
 		};
 		if ("rowParent" in patch && patch.rowParent === void 0) delete next.rowParent;
 		if ("colParent" in patch && patch.colParent === void 0) delete next.colParent;
+		if ("drill" in patch && patch.drill === void 0) delete next.drill;
 		if (("aggregate" in patch || "expand" in patch) && !("preset" in patch) && !presetStillApplies(next)) delete next.preset;
 		if (patch.preset === "subtotal") {
 			const inferred = inferParentsForPreset(cell, "subtotal", getBindingAt);

package/dist/components/report/use-report-viewer.js

@@ -1,22 +1,34 @@
+import { buildDrillHitMap, createDrillStack, currentDrillLayer, popDrillLayer, pushDrillLayer, resolveDrillParams } from "../../report/drill.js";
 import { renderReport, resolveFilledColWidths } from "../../report/render/index.js";
 import { fetchTemplateRecords, resolveParamDefaults, resolveTemplateParams } from "../../report/template.js";
 import { computed, ref, shallowRef, watch } from "vue";
+import { cellKey } from "@veltra/sheet-core";
 //#region src/components/report/use-report-viewer.ts
 /**
 * UReportViewer 的 headless 编排：参数提取 → 取数 → renderReport 展开。
 * 不持有 DOM / 网格引用；填充快照经 `filledSnapshot` 交给组件壳应用。
+* 下钻：openMode 'switch' 栈式切换当前层；'dialog' 由组件壳解析目标后嵌套独立查看器。
+* 导出 / 打印始终作用于当前可见层。
 */
 function useReportViewer(props) {
 	const loading = ref(false);
 	const error = shallowRef(null);
 	const filledSnapshot = shallowRef(null);
 	const filledColWidths = shallowRef(void 0);
-	const params = computed(() => resolveTemplateParams(props.template));
+	const drillStack = shallowRef(null);
+	const drillHits = shallowRef(/* @__PURE__ */ new Map());
+	const currentTemplate = computed(() => {
+		const stack = drillStack.value;
+		return stack ? currentDrillLayer(stack).template : props.template;
+	});
+	const drillDepth = computed(() => (drillStack.value?.length ?? 1) - 1);
+	const canDrillBack = computed(() => drillDepth.value > 0);
+	const params = computed(() => resolveTemplateParams(currentTemplate.value));
 	const values = shallowRef({});
 	let fetchSeq = 0;
 	async function refresh() {
 		const current = ++fetchSeq;
-		const template = props.template;
+		const template = currentTemplate.value;
 		loading.value = true;
 		error.value = null;
 		const result = await fetchTemplateRecords(props.connector, template, values.value);
@@ -29,15 +41,81 @@ function useReportViewer(props) {
 		}
 		filledSnapshot.value = renderReport(template, result.data);
 		filledColWidths.value = template.colWidths?.length ? resolveFilledColWidths(template, result.data, template.colWidths) : void 0;
+		drillHits.value = props.resolveTemplate ? buildDrillHitMap(template, result.data) : /* @__PURE__ */ new Map();
+	}
+	/** 切层共有收尾：清填充结果与命中索引，写入新层参数并重新取数 */
+	function transitionTo(layerParams) {
+		filledSnapshot.value = null;
+		filledColWidths.value = void 0;
+		drillHits.value = /* @__PURE__ */ new Map();
+		values.value = layerParams;
+		return refresh();
+	}
+	async function resolveDrillTarget(config, record) {
+		const resolve = props.resolveTemplate;
+		if (!resolve) return null;
+		let target;
+		try {
+			target = await resolve(config.target);
+		} catch (err) {
+			error.value = {
+				code: "DRILL_RESOLVE_FAILED",
+				message: err instanceof Error ? err.message : String(err)
+			};
+			return null;
+		}
+		if (!target) {
+			error.value = {
+				code: "DRILL_RESOLVE_FAILED",
+				message: `下钻目标模板解析失败：${config.target}`
+			};
+			return null;
+		}
+		error.value = null;
+		return {
+			template: target,
+			params: {
+				...resolveParamDefaults(resolveTemplateParams(target)),
+				...resolveDrillParams(config, record)
+			}
+		};
+	}
+	async function drillInto(config, record) {
+		const next = await resolveDrillTarget(config, record);
+		if (!next) return;
+		const base = drillStack.value ?? createDrillStack({
+			template: props.template,
+			params: values.value
+		});
+		drillStack.value = pushDrillLayer(base, {
+			template: next.template,
+			params: next.params
+		}, values.value);
+		await transitionTo(next.params);
+	}
+	async function drillBack() {
+		const stack = drillStack.value;
+		if (!stack || stack.length <= 1) return;
+		const next = popDrillLayer(stack);
+		drillStack.value = next;
+		await transitionTo({ ...currentDrillLayer(next).params });
+	}
+	function resolveDrillHit(addr) {
+		return drillHits.value.get(cellKey(addr)) ?? null;
 	}
 	function setValues(next) {
 		values.value = next;
 		refresh();
 	}
 	watch(() => props.template, () => {
+		drillStack.value = null;
+		drillHits.value = /* @__PURE__ */ new Map();
 		filledSnapshot.value = null;
 		filledColWidths.value = void 0;
-		values.value = resolveParamDefaults(params.value);
+		values.value = {
+			...resolveParamDefaults(params.value),
+			...props.initialValues
+		};
 		refresh();
 	}, { immediate: true });
 	return {
@@ -47,6 +125,13 @@ function useReportViewer(props) {
 		error,
 		filledSnapshot,
 		filledColWidths,
+		currentTemplate,
+		drillDepth,
+		canDrillBack,
+		resolveDrillHit,
+		resolveDrillTarget,
+		drillInto,
+		drillBack,
 		refresh,
 		setValues
 	};

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import _sfc_main from "./components/report/report-designer.js";
 import { SheetContext, createSheetContext } from "./tools/context.js";
 import { SheetTool, SheetToolGroup, SheetToolPopupType, defaultToolRegistry, registerTool, unregisterTool } from "./tools/registry.js";
 import { SheetEmits, SheetExposed, SheetProps, _SheetExposed } from "./types/sheet.js";
-import { ConditionalOperator, ConditionalRule, DatasetCatalogItem, DatasetField, DatasetRecords, ParamValues, QueryParamDef, QueryParamOption, QueryParamType, ReportAggregate, ReportBinding, ReportExpand, ReportPreset, ReportSort } from "./report/types.js";
+import { ConditionalOperator, ConditionalRule, DatasetCatalogItem, DatasetField, DatasetRecords, ParamValues, QueryParamDef, QueryParamOption, QueryParamType, ReportAggregate, ReportBinding, ReportDrillConfig, ReportExpand, ReportPreset, ReportSort, ReportTemplateListItem } from "./report/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 "./report/binding.js";
 import { ConditionalEvalContext, evaluateCondition, evaluateConditionalStyle, resolveRuleCompareValue, toComparableNumber } from "./report/rules/evaluate.js";
 import { buildParamDefs, extractParamIds, resolveBoundDatasetParams } from "./report/params.js";
@@ -14,8 +14,10 @@ import { renderReport, resolveFilledColWidths } from "./report/render/index.js";
 import { ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, QueryResult, Result, createHttpConnector, resolvePortOnTypeChange } from "./report/connector.js";
 import { IncompatibleTemplateVersionError, REPORT_TEMPLATE_VERSION, ReportDatasetDef, ReportTemplate, assertCompatibleTemplateVersion, createReportTemplate, fetchTemplateRecords, getBoundDatasetIds, getTemplateDatasets, resolveParamDefaults, resolveTemplateParams } from "./report/template.js";
 import { parseDateRangeValue, patchParamValues, resolveNumberParamValue } from "./report/filter-bar.js";
+import { DrillHit, DrillStack, DrillStackLayer, ResolveReportTemplate, buildDrillHitMap, createDrillStack, currentDrillLayer, popDrillLayer, pushDrillLayer, resolveDrillParams } from "./report/drill.js";
+import { ReportPrintOptions, buildFilledReportPrintHtml } from "./report/print.js";
 import "./report/index.js";
 import { ReportViewerExposed, ReportViewerProps, _ReportViewerExposed } from "./types/report-viewer.js";
 import { ReportDesignerEmits, ReportDesignerExposed, ReportDesignerProps, _ReportDesignerExposed } from "./types/report-designer.js";
 import "./types/index.js";
-export { type ConditionalEvalContext, ConditionalOperator, ConditionalRule, ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, DatasetCatalogItem, DatasetField, DatasetRecords, IncompatibleTemplateVersionError, InferParentOptions, ListParentCandidateOptions, ParamValues, QueryParamDef, QueryParamOption, QueryParamType, QueryResult, REPORT_META_NAMESPACE, REPORT_TEMPLATE_VERSION, ReportAggregate, ReportBinding, ReportColWidthEntry, ReportDatasetDef, type ReportDesignerEmits, type ReportDesignerExposed, type ReportDesignerProps, ReportExpand, ReportPreset, ReportSort, ReportTemplate, type ReportViewerExposed, type ReportViewerProps, Result, type SheetContext, type SheetEmits, type SheetExposed, type SheetProps, type SheetTool, type SheetToolGroup, type SheetToolPopupType, _sfc_main as UReportDesigner, _sfc_main$1 as UReportViewer, _sfc_main$2 as USheet, type _ReportDesignerExposed, type _ReportViewerExposed, type _SheetExposed, applyReportPreset, assertCompatibleTemplateVersion, buildParamDefs, createHttpConnector, createReportBinding, createReportTemplate, createSheetContext, defaultToolRegistry, 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, prefersGroupParent, presetBindingPatch, presetStillApplies, registerTool, renderReport, resolveBoundDatasetParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber, unregisterTool };
+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, type ReportDesignerEmits, type ReportDesignerExposed, type ReportDesignerProps, ReportDrillConfig, ReportExpand, ReportPreset, ReportPrintOptions, ReportSort, ReportTemplate, ReportTemplateListItem, type ReportViewerExposed, type ReportViewerProps, ResolveReportTemplate, Result, type SheetContext, type SheetEmits, type SheetExposed, type SheetProps, type SheetTool, type SheetToolGroup, type SheetToolPopupType, _sfc_main as UReportDesigner, _sfc_main$1 as UReportViewer, _sfc_main$2 as USheet, type _ReportDesignerExposed, type _ReportViewerExposed, type _SheetExposed, applyReportPreset, assertCompatibleTemplateVersion, buildDrillHitMap, buildFilledReportPrintHtml, buildParamDefs, createDrillStack, createHttpConnector, createReportBinding, createReportTemplate, createSheetContext, currentDrillLayer, defaultToolRegistry, 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, registerTool, renderReport, resolveBoundDatasetParams, resolveDrillParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber, unregisterTool };

package/dist/index.js

@@ -3,8 +3,10 @@ import "./tools/builtin.js";
 import { createSheetContext } from "./tools/context.js";
 import _sfc_main$2 from "./components/sheet/sheet.js";
 import { exportFilledReportXlsx } from "./report/export-xlsx.js";
+import { buildFilledReportPrintHtml } from "./report/print.js";
 import { parseDateRangeValue, patchParamValues, resolveNumberParamValue } from "./report/filter-bar.js";
 import { 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 "./report/binding.js";
+import { buildDrillHitMap, createDrillStack, currentDrillLayer, popDrillLayer, pushDrillLayer, resolveDrillParams } from "./report/drill.js";
 import { evaluateCondition, evaluateConditionalStyle, resolveRuleCompareValue, toComparableNumber } from "./report/rules/evaluate.js";
 import { mapFilledColWidths } from "./report/render/builder.js";
 import { renderReport, resolveFilledColWidths } from "./report/render/index.js";
@@ -13,4 +15,4 @@ import { IncompatibleTemplateVersionError, REPORT_TEMPLATE_VERSION, assertCompat
 import _sfc_main$1 from "./components/report/report-viewer.js";
 import { DEFAULT_CONNECTION_PORTS, createHttpConnector, resolvePortOnTypeChange } from "./report/connector.js";
 import _sfc_main from "./components/report/report-designer.js";
-export { DEFAULT_CONNECTION_PORTS, IncompatibleTemplateVersionError, REPORT_META_NAMESPACE, REPORT_TEMPLATE_VERSION, _sfc_main as UReportDesigner, _sfc_main$1 as UReportViewer, _sfc_main$2 as USheet, applyReportPreset, assertCompatibleTemplateVersion, buildParamDefs, createHttpConnector, createReportBinding, createReportTemplate, createSheetContext, defaultToolRegistry, 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, prefersGroupParent, presetBindingPatch, presetStillApplies, registerTool, renderReport, resolveBoundDatasetParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber, unregisterTool };
+export { DEFAULT_CONNECTION_PORTS, IncompatibleTemplateVersionError, REPORT_META_NAMESPACE, REPORT_TEMPLATE_VERSION, _sfc_main as UReportDesigner, _sfc_main$1 as UReportViewer, _sfc_main$2 as USheet, applyReportPreset, assertCompatibleTemplateVersion, buildDrillHitMap, buildFilledReportPrintHtml, buildParamDefs, createDrillStack, createHttpConnector, createReportBinding, createReportTemplate, createSheetContext, currentDrillLayer, defaultToolRegistry, 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, registerTool, renderReport, resolveBoundDatasetParams, resolveDrillParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber, unregisterTool };

package/dist/report/drill.d.ts

@@ -0,0 +1,48 @@
+import { DatasetRecords, ParamValues, ReportDrillConfig } from "./types.js";
+import { ReportTemplate } from "./template.js";
+import { SheetSnapshot } from "@veltra/sheet-core";
+//#region src/report/drill.d.ts
+/**
+ * 宿主模板解析契约：按下钻 target 引用取回目标模板（允许同步/异步）。
+ * 失败抛错——查看器提示可读错误并停留当前报；设计器配置对话框据此解析目标模板查询参数。
+ */
+type ResolveReportTemplate = (ref: string) => ReportTemplate | Promise<ReportTemplate>;
+/**
+ * 按下钻映射从该格对应记录取值，生成详情报 Filter Bar 参数值。
+ * 记录缺字段（值为 `undefined`）时跳过对应参数，由详情报回退默认值；空映射返回空参数。
+ */
+declare function resolveDrillParams(config: ReportDrillConfig, record: Record<string, unknown>): ParamValues;
+/** 下钻栈层：一张报表模板 + 当时 Filter Bar 参数值（回退时据此恢复并重新取数） */
+interface DrillStackLayer {
+  template: ReportTemplate;
+  params: ParamValues;
+}
+/**
+ * 下钻栈：自根（初始报表）到顶的层序列，至少一层。
+ * 只经下方纯函数做不可变更新（返回新栈），便于组件层直接挂响应式。
+ */
+type DrillStack = DrillStackLayer[];
+/** 以初始报表为根层创建下钻栈 */
+declare function createDrillStack(root: DrillStackLayer): DrillStack;
+/**
+ * 压入详情报新层并使其成为当前层；`currentParams` 把当前层参数定格为离开时的值
+ * （缺省保留原值）。指向自身或成环不做检测，照常压栈，靠 pop 逐级退出。
+ */
+declare function pushDrillLayer(stack: DrillStack, next: DrillStackLayer, currentParams?: ParamValues): DrillStack;
+/** 弹出当前层返回上一层；仅剩根层时原样返回（查看器始终保留一张报表） */
+declare function popDrillLayer(stack: DrillStack): DrillStack;
+/** 当前层（栈顶） */
+declare function currentDrillLayer(stack: DrillStack): DrillStackLayer;
+/** 下钻命中：物理格对应的下钻配置与该格记录 */
+interface DrillHit {
+  config: ReportDrillConfig;
+  record: Record<string, unknown>;
+}
+/**
+ * 构建填充报表的物理格 → 下钻命中索引（每次成功取数后重建）。
+ * 仅含配了下钻的绑定格落点（含分组/汇总格与展开后的实例格，合并跨度内每格都命中）；
+ * 记录由 `resolvePlacementContext` 解析：list 明细取源数据行，分组/汇总取分组上下文。
+ */
+declare function buildDrillHitMap(template: SheetSnapshot, data: DatasetRecords): Map<number, DrillHit>;
+//#endregion
+export { DrillHit, DrillStack, DrillStackLayer, ResolveReportTemplate, buildDrillHitMap, createDrillStack, currentDrillLayer, popDrillLayer, pushDrillLayer, resolveDrillParams };