@veltra/sheet 2.3.3 → 2.4.0

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

@@ -3,12 +3,13 @@ import { applyGridColWidths, applySheetColWidths, readGridColWidths } from "./de
 import _sfc_main$2 from "./report-viewer.js";
 import _sfc_main$3 from "./designer-hub.js";
 import { resolveGridDropAddress } from "./designer/cell-coords.js";
-import _sfc_main$4 from "./designer/drop-highlight-overlay.js";
-import _sfc_main$5 from "./designer/float-panel.js";
-import _sfc_main$6 from "./designer/rules-dialog.js";
-import _sfc_main$7 from "./designer/topology-overlay.js";
+import _sfc_main$4 from "./designer/drill-dialog.js";
+import _sfc_main$5 from "./designer/drop-highlight-overlay.js";
+import _sfc_main$6 from "./designer/float-panel.js";
+import _sfc_main$7 from "./designer/rules-dialog.js";
+import _sfc_main$8 from "./designer/topology-overlay.js";
 import { FIELD_DRAG_MIME, parseFieldDragPayload } from "./field-panel-helpers.js";
-import _sfc_main$8 from "./field-panel.js";
+import _sfc_main$9 from "./field-panel.js";
 import { useReportDesigner } from "./use-report-designer.js";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, nextTick, normalizeClass, onScopeDispose, openBlock, ref, renderList, shallowRef, toDisplayString, unref, useTemplateRef, watch, withCtx } from "vue";
 import { UButton, UDrawer } from "@veltra/desktop";
@@ -24,10 +25,13 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		connector: {},
 		connections: { default: () => [] },
 		template: {},
-		workbook: {}
+		workbook: {},
+		drillTemplates: {},
+		resolveTemplate: {}
 	},
 	emits: ["update:connections", "datasets-change"],
 	setup(__props, { expose: __expose, emit: __emit }) {
+		/** 与 `ReportDesignerProps` 交叉显式列出下钻 props，避免 SFC 对跨文件 interface 漏抽 runtime 声明 */
 		const props = __props;
 		const emit = __emit;
 		const cls = bem("report-designer");
@@ -54,6 +58,9 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		});
 		const hubVisible = ref(false);
 		const rulesDialogVisible = ref(false);
+		const drillDialogVisible = ref(false);
+		/** 宿主传入可下钻模板列表时才出现下钻配置入口（不传则无入口，spec 兼容性要求） */
+		const hasDrillTemplates = computed(() => (props.drillTemplates?.length ?? 0) > 0);
 		const pickCandidateCells = computed(() => {
 			if (!parentPick.value) return [];
 			return parentPick.value.mode === "row" ? rowParentCandidates.value : colParentCandidates.value;
@@ -138,6 +145,12 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		function saveConditionalRules(rules) {
 			patchActiveBinding({ conditionalRules: rules });
 		}
+		function saveDrill(drill) {
+			patchActiveBinding({ drill });
+		}
+		function removeDrill() {
+			patchActiveBinding({ drill: void 0 });
+		}
 		function clearDropState() {
 			isFieldDragging.value = false;
 			dropTargetAddr.value = null;
@@ -188,7 +201,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						plain: "",
 						onClick: _cache[0] || (_cache[0] = ($event) => hubVisible.value = true)
 					}, {
-						default: withCtx(() => [..._cache[6] || (_cache[6] = [createTextVNode("数据中枢", -1)])]),
+						default: withCtx(() => [..._cache[8] || (_cache[8] = [createTextVNode("数据中枢", -1)])]),
 						_: 1
 					}),
 					createElementVNode("div", {
@@ -201,7 +214,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						plain: isPreview.value,
 						onClick: _cache[1] || (_cache[1] = ($event) => setViewMode("design"))
 					}, {
-						default: withCtx(() => [..._cache[7] || (_cache[7] = [createTextVNode(" 设计模式 ", -1)])]),
+						default: withCtx(() => [..._cache[9] || (_cache[9] = [createTextVNode(" 设计模式 ", -1)])]),
 						_: 1
 					}, 8, ["type", "plain"]), createVNode(unref(UButton), {
 						size: "small",
@@ -209,7 +222,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						plain: !isPreview.value,
 						onClick: _cache[2] || (_cache[2] = ($event) => setViewMode("preview"))
 					}, {
-						default: withCtx(() => [..._cache[8] || (_cache[8] = [createTextVNode(" 预览模式 ", -1)])]),
+						default: withCtx(() => [..._cache[10] || (_cache[10] = [createTextVNode(" 预览模式 ", -1)])]),
 						_: 1
 					}, 8, ["type", "plain"])], 2),
 					isPreview.value ? (openBlock(), createBlock(unref(UButton), {
@@ -220,7 +233,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						loading: exporting.value,
 						onClick: exportPreviewXlsx
 					}, {
-						default: withCtx(() => [..._cache[9] || (_cache[9] = [createTextVNode(" 导出 XLSX ", -1)])]),
+						default: withCtx(() => [..._cache[11] || (_cache[11] = [createTextVNode(" 导出 XLSX ", -1)])]),
 						_: 1
 					}, 8, ["loading"])) : createCommentVNode("v-if", true),
 					createElementVNode("span", { class: normalizeClass(unref(cls).e("hint")) }, " 在数据中枢配置连接与 SQL 数据集，再将左侧字段点击或拖拽到单元格完成绑定；选中已绑定格可通过悬浮卡片调整预设与条件样式。 ", 2)
@@ -228,7 +241,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 				!isPreview.value ? (openBlock(), createElementBlock("div", {
 					key: 0,
 					class: normalizeClass(unref(cls).e("body"))
-				}, [createVNode(_sfc_main$8, {
+				}, [createVNode(_sfc_main$9, {
 					class: normalizeClass(unref(cls).e("field-panel")),
 					datasets: unref(catalog),
 					"selection-label": unref(selectionLabel),
@@ -266,7 +279,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						"resolve-cell-style",
 						"resolve-cell-renderer"
 					]),
-					createVNode(_sfc_main$7, {
+					createVNode(_sfc_main$8, {
 						cell: unref(activeCell),
 						binding: unref(activeBinding) ?? null,
 						entries: unref(bindingEntries),
@@ -282,7 +295,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						"host-el",
 						"get-binding-at"
 					]),
-					createVNode(_sfc_main$4, {
+					createVNode(_sfc_main$5, {
 						cell: dropTargetAddr.value,
 						"host-el": gridHostEl.value,
 						"get-grid": getDesignGrid,
@@ -295,7 +308,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						"fallback-label"
 					]),
 					(openBlock(true), createElementBlock(Fragment, null, renderList(pickCandidateCells.value, (addr) => {
-						return openBlock(), createBlock(_sfc_main$4, {
+						return openBlock(), createBlock(_sfc_main$5, {
 							key: `pick-${addr.row}-${addr.col}`,
 							cell: addr,
 							"host-el": gridHostEl.value,
@@ -309,7 +322,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						class: normalizeClass(unref(cls).e("pick-hint")),
 						role: "status"
 					}, toDisplayString(unref(parentPick).mode === "row" ? "点击分组头作为行方向父格" : "点击分组头作为列方向父格"), 3)) : createCommentVNode("v-if", true),
-					createVNode(_sfc_main$5, {
+					createVNode(_sfc_main$6, {
 						cell: unref(activeCell),
 						binding: unref(activeBinding) ?? null,
 						"resolved-row-parent-label": unref(resolvedRowParentLabel),
@@ -317,6 +330,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						"parent-pick-mode": unref(parentPick)?.mode ?? null,
 						"row-parent-candidates": unref(rowParentCandidates),
 						"col-parent-candidates": unref(colParentCandidates),
+						"show-drill": hasDrillTemplates.value,
 						"resolve-field-label": unref(resolveFieldLabel),
 						"get-binding-at": unref(getBindingAt),
 						"host-el": gridHostEl.value,
@@ -324,6 +338,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						onPatch: unref(patchActiveBinding),
 						onRemove: unref(removeActiveBinding),
 						onOpenRules: _cache[3] || (_cache[3] = ($event) => rulesDialogVisible.value = true),
+						onOpenDrill: _cache[4] || (_cache[4] = ($event) => drillDialogVisible.value = true),
 						onStartParentPick: unref(startParentPick),
 						onCancelParentPick: unref(cancelParentPick),
 						onClearParent: unref(clearParent)
@@ -335,6 +350,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						"parent-pick-mode",
 						"row-parent-candidates",
 						"col-parent-candidates",
+						"show-drill",
 						"resolve-field-label",
 						"get-binding-at",
 						"host-el",
@@ -352,15 +368,17 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 					ref: previewViewerRef,
 					connector: props.connector,
 					template: previewTemplate.value,
-					workbook: unref(previewWorkbook)
+					workbook: unref(previewWorkbook),
+					"resolve-template": props.resolveTemplate
 				}, null, 8, [
 					"connector",
 					"template",
-					"workbook"
+					"workbook",
+					"resolve-template"
 				])], 2)) : createCommentVNode("v-if", true),
 				createVNode(unref(UDrawer), {
 					modelValue: hubVisible.value,
-					"onUpdate:modelValue": _cache[4] || (_cache[4] = ($event) => hubVisible.value = $event),
+					"onUpdate:modelValue": _cache[5] || (_cache[5] = ($event) => hubVisible.value = $event),
 					class: normalizeClass(unref(cls).e("hub-drawer")),
 					"show-close": ""
 				}, {
@@ -370,9 +388,9 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 					}, null, 8, ["hub"])]),
 					_: 1
 				}, 8, ["modelValue", "class"]),
-				createVNode(_sfc_main$6, {
+				createVNode(_sfc_main$7, {
 					modelValue: rulesDialogVisible.value,
-					"onUpdate:modelValue": _cache[5] || (_cache[5] = ($event) => rulesDialogVisible.value = $event),
+					"onUpdate:modelValue": _cache[6] || (_cache[6] = ($event) => rulesDialogVisible.value = $event),
 					rules: unref(activeBinding)?.conditionalRules ?? EMPTY_CONDITIONAL_RULES,
 					"binding-field": unref(activeBinding)?.field ?? "",
 					"dataset-fields": unref(activeDatasetFields),
@@ -384,7 +402,24 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 					"binding-field",
 					"dataset-fields",
 					"field-type"
-				])
+				]),
+				hasDrillTemplates.value ? (openBlock(), createBlock(_sfc_main$4, {
+					key: 2,
+					modelValue: drillDialogVisible.value,
+					"onUpdate:modelValue": _cache[7] || (_cache[7] = ($event) => drillDialogVisible.value = $event),
+					templates: props.drillTemplates ?? [],
+					fields: unref(activeDatasetFields),
+					drill: unref(activeBinding)?.drill,
+					"resolve-template": props.resolveTemplate,
+					onSave: saveDrill,
+					onRemove: removeDrill
+				}, null, 8, [
+					"modelValue",
+					"templates",
+					"fields",
+					"drill",
+					"resolve-template"
+				])) : createCommentVNode("v-if", true)
 			], 2);
 		};
 	}

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);
@@ -295,7 +296,7 @@ function useReportDesigner(options) {
 		return props.connector.query(connection, dataset.sql, values);
 	}
 	const resolveCellStyle = createBindingBadgeStyleResolver(getBindingAt);
-	const resolveCellRenderer = createBindingBadgeRenderer(getBindingAt, resolveFieldLabel);
+	const resolveCellRenderer = createBindingBadgeRenderer(getBindingAt, resolveFieldLabel, (addr) => workbook.value.activeSheet.getEffectiveStyle(addr)?.align);
 	function getTemplate() {
 		const resolved = datasets.value.flatMap((dataset) => {
 			const connection = resolveDatasetConnection(dataset);