@veltra/sheet 2.1.1 → 2.3.0

package/dist/components/report/binding-badge.js

@@ -0,0 +1,100 @@
+import { formatBindingPlaceholderParts, inferReportPreset } from "../../report/binding.js";
+import { CustomLayout } from "@veltra/sheet-core";
+//#region src/components/report/binding-badge.ts
+const REPORT_PRESET_BADGE_COLORS = {
+	groupHeader: {
+		cell: "#eef4ff",
+		fg: "#2f54eb"
+	},
+	detail: {
+		cell: "#effaf3",
+		fg: "#1f9254"
+	},
+	subtotal: {
+		cell: "#fff7e6",
+		fg: "#d46b08"
+	},
+	grandTotal: {
+		cell: "#fff1f0",
+		fg: "#cf1322"
+	},
+	cross: {
+		cell: "#f8f5ff",
+		fg: "#5f3dc4"
+	}
+};
+const CUSTOM_PRESET_BADGE_COLOR = {
+	cell: "#f7f8fa",
+	fg: "#495057"
+};
+/** 徽章字段标签文字色（中性深灰，与强调色形成层次） */
+const BADGE_LABEL_COLOR = "#343a40";
+function resolveBadgeColor(binding) {
+	const preset = inferReportPreset(binding);
+	return preset ? REPORT_PRESET_BADGE_COLORS[preset] : CUSTOM_PRESET_BADGE_COLOR;
+}
+/** 绑定格角色底色（走 resolveCellStyle，保留 VTable 默认边框绘制） */
+function createBindingBadgeStyleResolver(getBindingAt) {
+	return (addr, base) => {
+		const binding = getBindingAt(addr);
+		if (!binding) return base;
+		const { cell } = resolveBadgeColor(binding);
+		return {
+			...base,
+			fill: { color: cell }
+		};
+	};
+}
+/**
+* 绑定格富渲染徽章（ADR-0004 `resolveCellRenderer` 首个消费者）：
+* 绑定单元格渲染为左对齐徽章（强调色聚合标签 + 中性色字段标签），
+* 未绑定格返回 `undefined` 回落默认渲染。
+*/
+function createBindingBadgeRenderer(getBindingAt, resolveLabel) {
+	return (addr) => {
+		const binding = getBindingAt(addr);
+		if (!binding) return void 0;
+		const { fg } = resolveBadgeColor(binding);
+		const { tag, label } = formatBindingPlaceholderParts(binding, resolveLabel);
+		const rootContainer = new CustomLayout.Container({
+			display: "flex",
+			flexDirection: "row",
+			justifyContent: "flex-start",
+			alignItems: "center"
+		});
+		const tagEl = new CustomLayout.Tag({
+			text: tag,
+			textStyle: {
+				fontSize: 10,
+				fontWeight: 600,
+				fill: "#ffffff"
+			},
+			panel: {
+				visible: true,
+				fill: fg,
+				cornerRadius: 3
+			},
+			padding: [
+				1,
+				4,
+				1,
+				4
+			],
+			marginLeft: 6,
+			marginRight: 5
+		});
+		rootContainer.add(tagEl);
+		rootContainer.add(new CustomLayout.Text({
+			text: label,
+			fontSize: 11,
+			fontWeight: 500,
+			fill: BADGE_LABEL_COLOR
+		}));
+		return {
+			rootContainer,
+			renderDefault: false
+		};
+	};
+}
+//#endregion
+export { REPORT_PRESET_BADGE_COLORS, createBindingBadgeRenderer, createBindingBadgeStyleResolver };

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

@@ -0,0 +1,46 @@
+function resolveGridOverlayLayout(host) {
+	const gridEl = host.querySelector(".u-sheet__grid-instance");
+	if (!gridEl) return null;
+	const hostBox = host.getBoundingClientRect();
+	const gridBox = gridEl.getBoundingClientRect();
+	return {
+		gridEl,
+		layout: {
+			offsetX: gridBox.left - hostBox.left,
+			offsetY: gridBox.top - hostBox.top,
+			viewW: gridEl.clientWidth,
+			viewH: gridEl.clientHeight
+		}
+	};
+}
+/** 将屏幕坐标换算为网格落点地址（用于字段拖拽 bind） */
+function resolveGridDropAddress(grid, gridEl, clientX, clientY) {
+	const rect = gridEl.getBoundingClientRect();
+	return grid.hitTestSheetAddr(clientX - rect.left, clientY - rect.top) ?? null;
+}
+function getCellOverlayRect(grid, cell, layout) {
+	const table = grid.getTable();
+	let cellRect;
+	try {
+		cellRect = table.getCellRelativeRect(cell.col + 1, cell.row + 1);
+	} catch {
+		return null;
+	}
+	const left = layout.offsetX + cellRect.left;
+	const top = layout.offsetY + cellRect.top;
+	const right = layout.offsetX + cellRect.right;
+	const bottom = layout.offsetY + cellRect.bottom;
+	if (cellRect.bottom < 0 || cellRect.right < 0 || cellRect.top > layout.viewH || cellRect.left > layout.viewW) return null;
+	return {
+		left,
+		top,
+		right,
+		bottom,
+		width: right - left,
+		height: bottom - top,
+		centerX: (left + right) / 2,
+		centerY: (top + bottom) / 2
+	};
+}
+//#endregion
+export { getCellOverlayRect, resolveGridDropAddress, resolveGridOverlayLayout };

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

@@ -0,0 +1,29 @@
+//#region src/components/report/designer/col-widths.ts
+/** 行号列数（隐藏行头时为 0；与 GridCoords 探测一致） */
+function seriesNumberColCount(table) {
+	const rowOffset = table.columnHeaderLevelCount;
+	let col = 0;
+	while (col < table.colCount && table.isSeriesNumber(col, rowOffset)) col++;
+	return col;
+}
+/** 将模型列宽写入 VTable（模型 → grid 同步辅助） */
+function applyGridColWidths(grid, widths) {
+	if (!grid) return;
+	const table = grid.getTable();
+	const colOffset = seriesNumberColCount(table);
+	for (const [sheetCol, width] of widths) table.setColWidth(sheetCol + colOffset, width);
+}
+/** 把列宽条目写入 Sheet 模型（不进 undo，对称 setColWidth） */
+function applySheetColWidths(sheet, widths) {
+	if (!sheet) return;
+	for (const [col, width] of widths) sheet.setColWidth(col, width);
+}
+/** 从当前网格读取指定模型列宽度；网格未就绪时返回 null */
+function readGridColWidths(grid, cols) {
+	if (!grid) return null;
+	const table = grid.getTable();
+	const colOffset = seriesNumberColCount(table);
+	return cols.map((sheetCol) => [sheetCol, table.getColWidth(sheetCol + colOffset)]);
+}
+//#endregion
+export { applyGridColWidths, applySheetColWidths, readGridColWidths };

package/dist/components/report/designer/conditional-rules/helpers.js

@@ -0,0 +1,139 @@
+//#region src/components/report/designer/conditional-rules/helpers.ts
+const OPERATOR_LABELS = {
+	gt: "大于",
+	gte: "大于等于",
+	lt: "小于",
+	lte: "小于等于",
+	eq: "等于",
+	between: "介于",
+	contains: "包含"
+};
+const RULE_SCOPE_OPTIONS = [{
+	value: "cell",
+	label: "本格"
+}, {
+	value: "row",
+	label: "整行"
+}];
+/** 求值字段下拉：缺省项表示本格绑定字段 */
+function ruleEvalFieldOptions(bindingField, datasetFields) {
+	return [{
+		value: "",
+		label: "本格字段"
+	}, ...datasetFields.filter((field) => field.name !== bindingField).map((field) => ({
+		value: field.name,
+		label: field.label || field.name
+	}))];
+}
+/** 按规则所选求值字段解析字段类型（运算符映射用） */
+function resolveEvalFieldType(rule, bindingField, datasetFields) {
+	const fieldName = rule.field ?? bindingField;
+	return datasetFields.find((field) => field.name === fieldName)?.type ?? "number";
+}
+const NUMERIC_OPERATORS = [
+	"gt",
+	"gte",
+	"lt",
+	"lte",
+	"eq",
+	"between"
+];
+const STRING_OPERATORS = ["eq", "contains"];
+let draftIdSeq = 0;
+function nextDraftId() {
+	draftIdSeq += 1;
+	return `rule-${draftIdSeq}`;
+}
+/** 按字段类型返回可用运算符 */
+function operatorsForFieldType(fieldType) {
+	return (fieldType === "string" ? STRING_OPERATORS : NUMERIC_OPERATORS).map((value) => ({
+		value,
+		label: OPERATOR_LABELS[value]
+	}));
+}
+function isNumericFieldType(fieldType) {
+	return fieldType === "number" || fieldType === "date";
+}
+function defaultRuleValue(operator, fieldType) {
+	if (operator === "between") return isNumericFieldType(fieldType) ? [0, 100] : ["", ""];
+	if (operator === "contains" || operator === "eq" && fieldType === "string") return "";
+	return 0;
+}
+function defaultRuleStyle() {
+	return {
+		fill: { color: "#FEF3C7" },
+		font: { color: "#B45309" }
+	};
+}
+function createDraftItem(rule, fieldType = "number", _bindingField) {
+	if (rule) return {
+		id: nextDraftId(),
+		rule: cloneRule(rule)
+	};
+	const operator = operatorsForFieldType(fieldType)[0]?.value ?? "eq";
+	return {
+		id: nextDraftId(),
+		rule: {
+			operator,
+			value: defaultRuleValue(operator, fieldType),
+			style: defaultRuleStyle()
+		}
+	};
+}
+function initDraftFromRules(rules, fieldType, bindingField) {
+	if (rules.length === 0) return [];
+	return rules.map((rule) => createDraftItem(rule, fieldType, bindingField));
+}
+function cloneRule(rule) {
+	return {
+		operator: rule.operator,
+		value: cloneRuleValue(rule.value),
+		field: rule.field,
+		scope: rule.scope,
+		style: {
+			...rule.style,
+			fill: rule.style.fill ? { ...rule.style.fill } : void 0,
+			font: rule.style.font ? { ...rule.style.font } : void 0
+		}
+	};
+}
+function cloneRuleValue(value) {
+	if (Array.isArray(value)) return [...value];
+	return value;
+}
+function cloneRulesFromDraft(items) {
+	return items.map((item) => cloneRule(item.rule));
+}
+/** 运算符切换时重置比较值为合理缺省 */
+function coerceValueForOperator(operator, fieldType, current) {
+	if (operator === "between") {
+		if (Array.isArray(current) && current.length === 2) return [...current];
+		return defaultRuleValue("between", fieldType);
+	}
+	if (operator === "contains") return typeof current === "string" ? current : "";
+	if (isNumericFieldType(fieldType)) {
+		const n = typeof current === "number" && Number.isFinite(current) ? current : Number(current);
+		return Number.isFinite(n) ? n : 0;
+	}
+	return typeof current === "string" ? current : "";
+}
+function toDisplayString(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return String(value);
+	return "";
+}
+function readBetweenValue(value, index, fieldType) {
+	const raw = (Array.isArray(value) && value.length === 2 ? value : defaultRuleValue("between", fieldType))[index];
+	if (isNumericFieldType(fieldType)) {
+		const n = typeof raw === "number" ? raw : Number(raw);
+		return Number.isFinite(n) ? n : 0;
+	}
+	return typeof raw === "string" ? raw : toDisplayString(raw);
+}
+function writeBetweenValue(value, index, next, fieldType) {
+	const pair = [readBetweenValue(value, 0, fieldType), readBetweenValue(value, 1, fieldType)];
+	pair[index] = next;
+	return pair;
+}
+//#endregion
+export { OPERATOR_LABELS, RULE_SCOPE_OPTIONS, cloneRule, cloneRulesFromDraft, coerceValueForOperator, createDraftItem, defaultRuleStyle, defaultRuleValue, initDraftFromRules, isNumericFieldType, operatorsForFieldType, readBetweenValue, resolveEvalFieldType, ruleEvalFieldOptions, writeBetweenValue };

package/dist/components/report/designer/drop-highlight-overlay.js

@@ -0,0 +1,76 @@
+import { readCellOverlayRect, useGridOverlaySync } from "./use-grid-overlay.js";
+import { computed, createCommentVNode, createElementBlock, defineComponent, normalizeClass, normalizeStyle, openBlock, ref, toDisplayString, toRef, unref } from "vue";
+import { bem } from "@veltra/utils";
+//#region src/components/report/designer/drop-highlight-overlay.vue
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	name: "UReportDropHighlightOverlay",
+	__name: "drop-highlight-overlay",
+	props: {
+		cell: {},
+		hostEl: {},
+		getGrid: { type: Function },
+		dragging: { type: Boolean },
+		fallbackLabel: {}
+	},
+	setup(__props) {
+		const props = __props;
+		const cls = bem("report-drop-highlight");
+		const hostEl = toRef(props, "hostEl");
+		const rectLeft = ref(0);
+		const rectTop = ref(0);
+		const rectWidth = ref(0);
+		const rectHeight = ref(0);
+		const inView = ref(false);
+		const visible = computed(() => !!props.cell && inView.value);
+		const showFallback = computed(() => props.dragging && !props.cell);
+		const highlightStyle = computed(() => ({
+			left: `${rectLeft.value}px`,
+			top: `${rectTop.value}px`,
+			width: `${rectWidth.value}px`,
+			height: `${rectHeight.value}px`
+		}));
+		function updateHighlight() {
+			const cell = props.cell;
+			const host = props.hostEl;
+			if (!cell || !host) {
+				inView.value = false;
+				return;
+			}
+			const rect = readCellOverlayRect(cell, host, props.getGrid);
+			if (!rect) {
+				inView.value = false;
+				return;
+			}
+			inView.value = true;
+			rectLeft.value = Math.round(rect.left);
+			rectTop.value = Math.round(rect.top);
+			rectWidth.value = Math.round(rect.width);
+			rectHeight.value = Math.round(rect.height);
+		}
+		useGridOverlaySync({
+			hostEl,
+			getGrid: () => props.getGrid(),
+			watchSources: () => [
+				props.cell?.row,
+				props.cell?.col,
+				props.hostEl,
+				props.dragging
+			],
+			update: updateHighlight
+		});
+		return (_ctx, _cache) => {
+			return __props.cell && visible.value ? (openBlock(), createElementBlock("div", {
+				key: 0,
+				class: normalizeClass(unref(cls).b),
+				style: normalizeStyle(highlightStyle.value),
+				"aria-hidden": "true"
+			}, null, 6)) : showFallback.value ? (openBlock(), createElementBlock("div", {
+				key: 1,
+				class: normalizeClass(unref(cls).e("fallback")),
+				role: "status"
+			}, " 松开将绑定到当前选区 " + toDisplayString(__props.fallbackLabel), 3)) : createCommentVNode("v-if", true);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };