@veltra/sheet 2.0.1 → 2.2.0

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

@@ -0,0 +1,343 @@
+import _sfc_main$1 from "../sheet/sheet.js";
+import { resolveGridDropAddress } from "./designer/cell-coords.js";
+import { applyGridColWidths, readGridColWidths } from "./designer/col-widths.js";
+import _sfc_main$2 from "./report-viewer.js";
+import _sfc_main$3 from "./designer-hub.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 { FIELD_DRAG_MIME, parseFieldDragPayload } from "./field-panel-helpers.js";
+import _sfc_main$8 from "./field-panel.js";
+import { useReportDesigner } from "./use-report-designer.js";
+import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, nextTick, normalizeClass, openBlock, ref, shallowRef, unref, useTemplateRef, watch, withCtx } from "vue";
+import { UButton, UDrawer } from "@veltra/desktop";
+import { bem } from "@veltra/utils";
+import { Workbook } from "@veltra/sheet-core";
+//#region src/components/report/report-designer.vue
+const DESIGN_ROWS = 24;
+const DESIGN_COLS = 10;
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	name: "UReportDesigner",
+	__name: "report-designer",
+	props: {
+		connector: {},
+		connections: { default: () => [] },
+		template: {},
+		workbook: {}
+	},
+	emits: ["update:connections"],
+	setup(__props, { expose: __expose, emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const cls = bem("report-designer");
+		/** 设计态网格尺寸（列宽捕获范围与之一致） */
+		const EMPTY_CONDITIONAL_RULES = [];
+		/** `v-model:connections` 可写代理（连接为纯序列化对象，仅驻留内存） */
+		const connections = computed({
+			get: () => props.connections,
+			set: (value) => emit("update:connections", value)
+		});
+		const designer = useReportDesigner({
+			props,
+			connections
+		});
+		const { workbook, catalog, boundKeys, activeCell, selectionLabel, activeBinding, activeFieldType, activeDatasetFields, resolvedRowParentLabel, resolvedColParentLabel, parentPick, rowParentCandidates, colParentCandidates, bindingEntries, metaTick, getBindingAt, resolveFieldLabel, bindField, patchActiveBinding, startParentPick, cancelParentPick, pickParentAt, clearParent, removeActiveBinding, resolveCellStyle, resolveCellRenderer, getTemplate } = designer;
+		const hubVisible = ref(false);
+		const rulesDialogVisible = ref(false);
+		const sheetRef = useTemplateRef("sheetRef");
+		const previewViewerRef = useTemplateRef("previewViewerRef");
+		const gridHostRef = useTemplateRef("gridHostRef");
+		const gridHostEl = computed(() => gridHostRef.value ?? null);
+		/** 字段拖拽落点高亮（dragover 时更新；落空时 overlay 提示回退当前选区） */
+		const isFieldDragging = ref(false);
+		const dropTargetAddr = ref(null);
+		function getDesignGrid() {
+			return sheetRef.value?.getGrid();
+		}
+		const viewMode = ref("design");
+		const isPreview = computed(() => viewMode.value === "preview");
+		/** 进入预览时的模板快照（getTemplate 吐出，设计态工作簿不受预览取数影响，切回绑定不丢） */
+		const previewTemplate = shallowRef(null);
+		/** 预览工作簿自持（XLSX 导出需要拿到填充后的 sheet，05 票 workbook? prop 先例） */
+		const previewWorkbook = new Workbook();
+		/** 当前设计态列宽（sheet-core 列宽未进快照，经 VTable 运行时捕获；导出随快照写宽） */
+		const designColWidths = ref([]);
+		const exporting = ref(false);
+		/** 从当前设计网格捕获列宽（网格未就绪则保留旧值） */
+		function captureDesignColWidths() {
+			const widths = readGridColWidths(getDesignGrid(), Array.from({ length: DESIGN_COLS }, (_, col) => col));
+			if (widths) designColWidths.value = widths;
+		}
+		/** 设计网格重建后补刷新与列宽（restore 不发 content-reset 的场景由 grid 自行订阅，这里只管列宽） */
+		function syncDesignGridView() {
+			const grid = getDesignGrid();
+			grid?.flushPending();
+			grid?.refresh();
+			applyGridColWidths(grid, designColWidths.value);
+		}
+		function setViewMode(mode) {
+			if (viewMode.value === mode) return;
+			if (mode === "preview") {
+				captureDesignColWidths();
+				previewTemplate.value = getTemplate();
+			}
+			viewMode.value = mode;
+			if (mode === "design") nextTick(syncDesignGridView);
+		}
+		watch(() => props.template, () => {
+			viewMode.value = "design";
+		});
+		watch(activeCell, (cell) => {
+			if (cell && parentPick.value) pickParentAt(cell);
+		});
+		watch(catalog, () => {
+			nextTick(() => getDesignGrid()?.refresh());
+		});
+		async function exportPreviewXlsx() {
+			if (!isPreview.value || exporting.value) return;
+			const viewer = previewViewerRef.value;
+			if (!viewer) throw new Error("预览查看器尚未就绪，请稍后再导出");
+			exporting.value = true;
+			try {
+				await viewer.exportXlsx();
+			} finally {
+				exporting.value = false;
+			}
+		}
+		function saveConditionalRules(rules) {
+			patchActiveBinding({ conditionalRules: rules });
+		}
+		function clearDropState() {
+			isFieldDragging.value = false;
+			dropTargetAddr.value = null;
+		}
+		function resolveDropAddress(event) {
+			const grid = getDesignGrid();
+			const gridEl = gridHostRef.value?.querySelector(".u-sheet__grid-instance");
+			if (!grid || !gridEl) return null;
+			return resolveGridDropAddress(grid, gridEl, event.clientX, event.clientY);
+		}
+		function onGridDragOver(event) {
+			if (!event.dataTransfer?.types.includes("application/x-sheet-report-field")) return;
+			event.preventDefault();
+			event.dataTransfer.dropEffect = "copy";
+			isFieldDragging.value = true;
+			dropTargetAddr.value = resolveDropAddress(event);
+		}
+		function onGridDragLeave(event) {
+			const host = gridHostRef.value;
+			const related = event.relatedTarget;
+			if (host && related instanceof Node && host.contains(related)) return;
+			clearDropState();
+		}
+		function onGridDrop(event) {
+			event.preventDefault();
+			clearDropState();
+			const raw = event.dataTransfer?.getData(FIELD_DRAG_MIME);
+			const payload = raw ? parseFieldDragPayload(raw) : null;
+			if (!payload) return;
+			const grid = getDesignGrid();
+			const gridEl = gridHostRef.value?.querySelector(".u-sheet__grid-instance");
+			if (!grid || !gridEl) return;
+			const dropAddr = resolveDropAddress(event);
+			if (dropAddr) {
+				bindField(payload.datasetId, payload.fieldName, dropAddr);
+				sheetRef.value?.getContext().selectCell(dropAddr);
+			} else bindField(payload.datasetId, payload.fieldName);
+		}
+		__expose({ getTemplate });
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", { class: normalizeClass(unref(cls).b) }, [
+				createElementVNode("div", { class: normalizeClass(unref(cls).e("toolbar")) }, [
+					createVNode(unref(UButton), {
+						size: "small",
+						plain: "",
+						onClick: _cache[0] || (_cache[0] = ($event) => hubVisible.value = true)
+					}, {
+						default: withCtx(() => [..._cache[7] || (_cache[7] = [createTextVNode("数据中枢", -1)])]),
+						_: 1
+					}),
+					createElementVNode("div", {
+						class: normalizeClass(unref(cls).e("mode-toggle")),
+						role: "group",
+						"aria-label": "视图模式"
+					}, [createVNode(unref(UButton), {
+						size: "small",
+						type: !isPreview.value ? "primary" : void 0,
+						plain: isPreview.value,
+						onClick: _cache[1] || (_cache[1] = ($event) => setViewMode("design"))
+					}, {
+						default: withCtx(() => [..._cache[8] || (_cache[8] = [createTextVNode(" 设计模式 ", -1)])]),
+						_: 1
+					}, 8, ["type", "plain"]), createVNode(unref(UButton), {
+						size: "small",
+						type: isPreview.value ? "primary" : void 0,
+						plain: !isPreview.value,
+						onClick: _cache[2] || (_cache[2] = ($event) => setViewMode("preview"))
+					}, {
+						default: withCtx(() => [..._cache[9] || (_cache[9] = [createTextVNode(" 预览模式 ", -1)])]),
+						_: 1
+					}, 8, ["type", "plain"])], 2),
+					isPreview.value ? (openBlock(), createBlock(unref(UButton), {
+						key: 0,
+						size: "small",
+						type: "primary",
+						plain: "",
+						loading: exporting.value,
+						onClick: exportPreviewXlsx
+					}, {
+						default: withCtx(() => [..._cache[10] || (_cache[10] = [createTextVNode(" 导出 XLSX ", -1)])]),
+						_: 1
+					}, 8, ["loading"])) : createCommentVNode("v-if", true),
+					createElementVNode("span", { class: normalizeClass(unref(cls).e("hint")) }, " 在数据中枢配置连接与 SQL 数据集，再将左侧字段点击或拖拽到单元格完成绑定；选中已绑定格可通过悬浮卡片调整角色、聚合与条件样式。 ", 2)
+				], 2),
+				!isPreview.value ? (openBlock(), createElementBlock("div", {
+					key: 0,
+					class: normalizeClass(unref(cls).e("body"))
+				}, [createVNode(_sfc_main$8, {
+					class: normalizeClass(unref(cls).e("field-panel")),
+					datasets: unref(catalog),
+					"selection-label": unref(selectionLabel),
+					"bound-keys": unref(boundKeys),
+					onBind: unref(bindField)
+				}, null, 8, [
+					"class",
+					"datasets",
+					"selection-label",
+					"bound-keys",
+					"onBind"
+				]), createElementVNode("div", {
+					ref_key: "gridHostRef",
+					ref: gridHostRef,
+					class: normalizeClass(unref(cls).e("grid")),
+					onDragover: onGridDragOver,
+					onDragleave: onGridDragLeave,
+					onDrop: onGridDrop
+				}, [
+					createVNode(unref(_sfc_main$1), {
+						ref_key: "sheetRef",
+						ref: sheetRef,
+						class: normalizeClass(unref(cls).e("sheet")),
+						workbook: unref(workbook),
+						rows: DESIGN_ROWS,
+						cols: DESIGN_COLS,
+						"show-tabs": false,
+						"resolve-cell-style": unref(resolveCellStyle),
+						"resolve-cell-renderer": unref(resolveCellRenderer)
+					}, null, 8, [
+						"class",
+						"workbook",
+						"resolve-cell-style",
+						"resolve-cell-renderer"
+					]),
+					createVNode(_sfc_main$7, {
+						cell: unref(activeCell),
+						binding: unref(activeBinding) ?? null,
+						entries: unref(bindingEntries),
+						"meta-tick": unref(metaTick),
+						"host-el": gridHostEl.value,
+						"get-grid": getDesignGrid,
+						"get-binding-at": unref(getBindingAt)
+					}, null, 8, [
+						"cell",
+						"binding",
+						"entries",
+						"meta-tick",
+						"host-el",
+						"get-binding-at"
+					]),
+					createVNode(_sfc_main$4, {
+						cell: dropTargetAddr.value,
+						"host-el": gridHostEl.value,
+						"get-grid": getDesignGrid,
+						dragging: isFieldDragging.value,
+						"fallback-label": unref(selectionLabel)
+					}, null, 8, [
+						"cell",
+						"host-el",
+						"dragging",
+						"fallback-label"
+					]),
+					createVNode(_sfc_main$5, {
+						cell: unref(activeCell),
+						binding: unref(activeBinding) ?? null,
+						"resolved-row-parent-label": unref(resolvedRowParentLabel),
+						"resolved-col-parent-label": unref(resolvedColParentLabel),
+						"parent-pick-mode": unref(parentPick)?.mode ?? null,
+						"row-parent-candidates": unref(rowParentCandidates),
+						"col-parent-candidates": unref(colParentCandidates),
+						"resolve-field-label": unref(resolveFieldLabel),
+						"host-el": gridHostEl.value,
+						"get-grid": getDesignGrid,
+						onPatch: unref(patchActiveBinding),
+						onRemove: unref(removeActiveBinding),
+						onOpenRules: _cache[3] || (_cache[3] = ($event) => rulesDialogVisible.value = true),
+						onStartParentPick: unref(startParentPick),
+						onCancelParentPick: unref(cancelParentPick),
+						onClearParent: unref(clearParent)
+					}, null, 8, [
+						"cell",
+						"binding",
+						"resolved-row-parent-label",
+						"resolved-col-parent-label",
+						"parent-pick-mode",
+						"row-parent-candidates",
+						"col-parent-candidates",
+						"resolve-field-label",
+						"host-el",
+						"onPatch",
+						"onRemove",
+						"onStartParentPick",
+						"onCancelParentPick",
+						"onClearParent"
+					])
+				], 34)], 2)) : previewTemplate.value ? (openBlock(), createElementBlock("div", {
+					key: 1,
+					class: normalizeClass(unref(cls).e("preview"))
+				}, [createVNode(_sfc_main$2, {
+					ref_key: "previewViewerRef",
+					ref: previewViewerRef,
+					connector: props.connector,
+					template: previewTemplate.value,
+					workbook: unref(previewWorkbook),
+					"col-widths": designColWidths.value
+				}, null, 8, [
+					"connector",
+					"template",
+					"workbook",
+					"col-widths"
+				])], 2)) : createCommentVNode("v-if", true),
+				createVNode(unref(UDrawer), {
+					modelValue: hubVisible.value,
+					"onUpdate:modelValue": _cache[5] || (_cache[5] = ($event) => hubVisible.value = $event),
+					class: normalizeClass(unref(cls).e("hub-drawer")),
+					"show-close": ""
+				}, {
+					default: withCtx(() => [createVNode(_sfc_main$3, {
+						hub: unref(designer),
+						onClose: _cache[4] || (_cache[4] = ($event) => hubVisible.value = false)
+					}, null, 8, ["hub"])]),
+					_: 1
+				}, 8, ["modelValue", "class"]),
+				createVNode(_sfc_main$6, {
+					modelValue: rulesDialogVisible.value,
+					"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),
+					"field-type": unref(activeFieldType),
+					onSave: saveConditionalRules
+				}, null, 8, [
+					"modelValue",
+					"rules",
+					"binding-field",
+					"dataset-fields",
+					"field-type"
+				])
+			], 2);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };

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

@@ -0,0 +1,111 @@
+import _sfc_main$1 from "../sheet/sheet.js";
+import { exportFilledReportXlsx } from "../../report/export-xlsx.js";
+import { applyGridColWidths, readGridColWidths } from "./designer/col-widths.js";
+import _sfc_main$2 from "./filter-bar.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 { bem } from "@veltra/utils";
+import { saveBlob } from "@cat-kit/fe";
+import { Workbook } from "@veltra/sheet-core";
+//#region src/components/report/report-viewer.vue
+const MIN_RENDER_ROWS = 50;
+const MIN_RENDER_COLS = 10;
+/** 取数未完成时拒绝导出的可读错误 */
+const EXPORT_NOT_READY_MESSAGE = "报表数据尚未就绪，请等待取数完成后再导出";
+const EXPORT_LOADING_MESSAGE = "报表数据加载中，请稍后再导出";
+/** 查看器工作簿：宿主可注入（同 USheet `workbook?` 先例），缺省内部自建；模板 / 填充结果都 restore 进活动 sheet 只读展示 */
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	name: "UReportViewer",
+	__name: "report-viewer",
+	props: {
+		connector: {},
+		template: {},
+		workbook: {},
+		colWidths: {}
+	},
+	setup(__props, { expose: __expose }) {
+		const props = __props;
+		const cls = bem("report-viewer");
+		/** 网格最小渲染尺寸（与 playground 预览态一致）；Filled Report 超出时按快照尺寸放大 */
+		const internalWorkbook = new Workbook();
+		const workbook = computed(() => props.workbook ?? internalWorkbook);
+		const sheetRef = useTemplateRef("sheetRef");
+		const { params, values, loading, error, filledSnapshot, refresh, setValues } = useReportViewer(props);
+		const renderRows = computed(() => Math.max(MIN_RENDER_ROWS, filledSnapshot.value?.rows ?? 0, props.template.rows));
+		const renderCols = computed(() => Math.max(MIN_RENDER_COLS, filledSnapshot.value?.cols ?? 0, props.template.cols));
+		function exportColIndexes() {
+			return Array.from({ length: renderCols.value }, (_, col) => col);
+		}
+		/** 将宿主传入的列宽写入 VTable 运行时（sheet-core 列宽未进快照） */
+		function applyRuntimeColWidths() {
+			if (!props.colWidths?.length) return;
+			applyGridColWidths(sheetRef.value?.getGrid(), props.colWidths);
+		}
+		/**
+		* restore 负责尺寸/冻结/行高/选区（静默），restoreContent 发 content-reset
+		* 触发网格全量刷新（grid 层订阅直刷，无需手动 flush）；history.clear 使填充不进 undo
+		*/
+		function applySnapshot(snapshot) {
+			const sheet = workbook.value.activeSheet;
+			sheet.restore(snapshot);
+			sheet.restoreContent(snapshot);
+			sheet.history.clear();
+			nextTick(applyRuntimeColWidths);
+		}
+		watch(() => props.template, applySnapshot, { immediate: true });
+		watch(filledSnapshot, (filled) => {
+			if (filled) applySnapshot(filled);
+		});
+		watch(() => props.colWidths, applyRuntimeColWidths);
+		async function exportXlsx() {
+			if (loading.value) throw new Error(EXPORT_LOADING_MESSAGE);
+			if (!filledSnapshot.value) throw new Error(EXPORT_NOT_READY_MESSAGE);
+			const sheet = workbook.value.activeSheet;
+			const colWidths = readGridColWidths(sheetRef.value?.getGrid(), exportColIndexes()) ?? [];
+			const buffer = await exportFilledReportXlsx(sheet, colWidths);
+			saveBlob(new Blob([buffer], { type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" }), `${sheet.name || "报表"}.xlsx`);
+		}
+		__expose({
+			refresh,
+			exportXlsx
+		});
+		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: renderRows.value,
+				cols: renderCols.value,
+				"show-toolbar": false,
+				"show-formula-bar": false,
+				"show-tabs": false,
+				readonly: ""
+			}, null, 8, [
+				"class",
+				"workbook",
+				"rows",
+				"cols"
+			])], 2)], 2);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };

package/dist/components/report/style.d.ts

@@ -0,0 +1,17 @@
+import "../sheet/style.js";
+import "@veltra/desktop/components/number-input/style";
+import "@veltra/desktop/components/palette/style";
+import "@veltra/desktop/components/input/style";
+import "@veltra/desktop/components/select/style";
+import "@veltra/desktop/components/date-picker/style";
+import "@veltra/desktop/components/date-range-picker/style";
+import "@veltra/desktop/components/button/style";
+import "@veltra/desktop/components/drawer/style";
+import "@veltra/desktop/components/dialog/style";
+import "@veltra/desktop/components/radio-group/style";
+import "@veltra/desktop/components/switch/style";
+import "@veltra/desktop/components/table/style";
+import "@veltra/desktop/components/tabs/style";
+import "@veltra/desktop/components/tag/style";
+import "@veltra/desktop/components/pop-confirm/style";
+import "@veltra/desktop/components/code-editor/style";

package/dist/components/report/style.js

@@ -0,0 +1,18 @@
+import "../sheet/style.js";
+import "./style2.css";
+import "@veltra/desktop/components/number-input/style";
+import "@veltra/desktop/components/palette/style";
+import "@veltra/desktop/components/input/style";
+import "@veltra/desktop/components/select/style";
+import "@veltra/desktop/components/date-picker/style";
+import "@veltra/desktop/components/date-range-picker/style";
+import "@veltra/desktop/components/button/style";
+import "@veltra/desktop/components/drawer/style";
+import "@veltra/desktop/components/dialog/style";
+import "@veltra/desktop/components/radio-group/style";
+import "@veltra/desktop/components/switch/style";
+import "@veltra/desktop/components/table/style";
+import "@veltra/desktop/components/tabs/style";
+import "@veltra/desktop/components/tag/style";
+import "@veltra/desktop/components/pop-confirm/style";
+import "@veltra/desktop/components/code-editor/style";