@veltra/sheet 2.1.1 → 2.3.0

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

@@ -0,0 +1,253 @@
+import { RULE_SCOPE_OPTIONS, coerceValueForOperator, isNumericFieldType, operatorsForFieldType, readBetweenValue, resolveEvalFieldType, ruleEvalFieldOptions, writeBetweenValue } from "./conditional-rules/helpers.js";
+import _sfc_main$1 from "./rule-preview.js";
+import { Fragment, computed, createBlock, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, normalizeClass, openBlock, renderList, toDisplayString, unref, withCtx } from "vue";
+import { UButton, UButtonGroup, UInput, UNumberInput, UPalette, USelect } from "@veltra/desktop";
+import { bem } from "@veltra/utils";
+//#region src/components/report/designer/rule-row.vue
+const _hoisted_1 = { title: "背景" };
+const _hoisted_2 = { title: "文字" };
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	name: "UReportRuleRow",
+	__name: "rule-row",
+	props: {
+		rule: {},
+		bindingField: {},
+		datasetFields: {}
+	},
+	emits: ["update:rule", "remove"],
+	setup(__props, { emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const cls = bem("report-rule-row");
+		const evalFieldType = computed(() => resolveEvalFieldType(props.rule, props.bindingField, props.datasetFields));
+		const operatorOptions = computed(() => operatorsForFieldType(evalFieldType.value));
+		const numericField = computed(() => isNumericFieldType(evalFieldType.value));
+		const fieldOptions = computed(() => ruleEvalFieldOptions(props.bindingField, props.datasetFields));
+		const betweenStart = computed(() => readBetweenValue(props.rule.value, 0, evalFieldType.value));
+		const betweenEnd = computed(() => readBetweenValue(props.rule.value, 1, evalFieldType.value));
+		const scalarNumber = computed(() => {
+			const raw = props.rule.value;
+			if (typeof raw === "number" && Number.isFinite(raw)) return raw;
+			const parsed = Number(raw);
+			return Number.isFinite(parsed) ? parsed : 0;
+		});
+		function patchRule(patch) {
+			emit("update:rule", {
+				...props.rule,
+				...patch
+			});
+		}
+		function onEvalField(field) {
+			const next = {};
+			if (!field) next.field = void 0;
+			else next.field = field;
+			const nextType = resolveEvalFieldType({
+				...props.rule,
+				...next
+			}, props.bindingField, props.datasetFields);
+			const operator = operatorsForFieldType(nextType)[0]?.value ?? props.rule.operator;
+			next.operator = operator;
+			next.value = coerceValueForOperator(operator, nextType, props.rule.value);
+			patchRule(next);
+		}
+		function onScope(scope) {
+			patchRule({ scope: scope === "cell" ? void 0 : scope });
+		}
+		function onOperator(operator) {
+			patchRule({
+				operator,
+				value: coerceValueForOperator(operator, evalFieldType.value, props.rule.value)
+			});
+		}
+		function patchValue(value) {
+			patchRule({ value });
+		}
+		function patchBetween(index, next) {
+			patchRule({ value: writeBetweenValue(props.rule.value, index, next, evalFieldType.value) });
+		}
+		function patchFillColor(color) {
+			patchRule({ style: {
+				...props.rule.style,
+				fill: color ? { color } : void 0
+			} });
+		}
+		function patchFontColor(color) {
+			patchRule({ style: {
+				...props.rule.style,
+				font: {
+					...props.rule.style.font,
+					color: color || void 0
+				}
+			} });
+		}
+		function toggleBold() {
+			const bold = !props.rule.style.font?.bold;
+			patchRule({ style: {
+				...props.rule.style,
+				font: {
+					...props.rule.style.font,
+					bold: bold || void 0
+				}
+			} });
+		}
+		function toggleItalic() {
+			const italic = !props.rule.style.font?.italic;
+			patchRule({ style: {
+				...props.rule.style,
+				font: {
+					...props.rule.style.font,
+					italic: italic || void 0
+				}
+			} });
+		}
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", { class: normalizeClass(unref(cls).b) }, [
+				createElementVNode("span", {
+					class: normalizeClass(unref(cls).e("handle")),
+					title: "拖拽排序"
+				}, "⋮⋮", 2),
+				createElementVNode("div", { class: normalizeClass(unref(cls).e("main")) }, [createElementVNode("div", { class: normalizeClass(unref(cls).e("when")) }, [
+					createElementVNode("span", { class: normalizeClass(unref(cls).e("lead")) }, "当", 2),
+					createVNode(unref(USelect), {
+						size: "small",
+						class: normalizeClass(unref(cls).e("field-select")),
+						"model-value": __props.rule.field ?? unref(""),
+						options: fieldOptions.value,
+						"onUpdate:modelValue": onEvalField
+					}, null, 8, [
+						"class",
+						"model-value",
+						"options"
+					]),
+					createVNode(unref(USelect), {
+						size: "small",
+						class: normalizeClass(unref(cls).e("operator")),
+						"model-value": __props.rule.operator,
+						options: operatorOptions.value,
+						"onUpdate:modelValue": onOperator
+					}, null, 8, [
+						"class",
+						"model-value",
+						"options"
+					]),
+					createElementVNode("div", { class: normalizeClass(unref(cls).e("value")) }, [__props.rule.operator === "between" ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [
+						numericField.value ? (openBlock(), createBlock(unref(UNumberInput), {
+							key: 0,
+							size: "small",
+							class: normalizeClass(unref(cls).e("between-input")),
+							"model-value": betweenStart.value,
+							"onUpdate:modelValue": _cache[0] || (_cache[0] = (v) => patchBetween(0, v ?? 0))
+						}, null, 8, ["class", "model-value"])) : (openBlock(), createBlock(unref(UInput), {
+							key: 1,
+							size: "small",
+							class: normalizeClass(unref(cls).e("between-input")),
+							"model-value": String(betweenStart.value),
+							"onUpdate:modelValue": _cache[1] || (_cache[1] = (v) => patchBetween(0, String(v ?? "")))
+						}, null, 8, ["class", "model-value"])),
+						createElementVNode("span", { class: normalizeClass(unref(cls).e("between-sep")) }, "至", 2),
+						numericField.value ? (openBlock(), createBlock(unref(UNumberInput), {
+							key: 2,
+							size: "small",
+							class: normalizeClass(unref(cls).e("between-input")),
+							"model-value": betweenEnd.value,
+							"onUpdate:modelValue": _cache[2] || (_cache[2] = (v) => patchBetween(1, v ?? 0))
+						}, null, 8, ["class", "model-value"])) : (openBlock(), createBlock(unref(UInput), {
+							key: 3,
+							size: "small",
+							class: normalizeClass(unref(cls).e("between-input")),
+							"model-value": String(betweenEnd.value),
+							"onUpdate:modelValue": _cache[3] || (_cache[3] = (v) => patchBetween(1, String(v ?? "")))
+						}, null, 8, ["class", "model-value"]))
+					], 64)) : __props.rule.operator === "contains" || !numericField.value && __props.rule.operator === "eq" ? (openBlock(), createBlock(unref(UInput), {
+						key: 1,
+						size: "small",
+						class: normalizeClass(unref(cls).e("scalar-input")),
+						"model-value": String(__props.rule.value ?? ""),
+						placeholder: "比较值",
+						"onUpdate:modelValue": _cache[4] || (_cache[4] = (v) => patchValue(String(v ?? "")))
+					}, null, 8, ["class", "model-value"])) : (openBlock(), createBlock(unref(UNumberInput), {
+						key: 2,
+						size: "small",
+						class: normalizeClass(unref(cls).e("scalar-input")),
+						"model-value": scalarNumber.value,
+						"onUpdate:modelValue": _cache[5] || (_cache[5] = (v) => patchValue(v ?? 0))
+					}, null, 8, ["class", "model-value"]))], 2),
+					createElementVNode("span", { class: normalizeClass(unref(cls).e("lead")) }, "时", 2)
+				], 2), createElementVNode("div", { class: normalizeClass(unref(cls).e("then")) }, [
+					createElementVNode("span", { class: normalizeClass(unref(cls).e("lead")) }, "样式", 2),
+					createElementVNode("span", _hoisted_1, [createVNode(unref(UPalette), {
+						size: "small",
+						"model-value": __props.rule.style.fill?.color ?? "",
+						"onUpdate:modelValue": patchFillColor
+					}, null, 8, ["model-value"])]),
+					createElementVNode("span", _hoisted_2, [createVNode(unref(UPalette), {
+						size: "small",
+						"model-value": __props.rule.style.font?.color ?? "",
+						"onUpdate:modelValue": patchFontColor
+					}, null, 8, ["model-value"])]),
+					createVNode(unref(UButtonGroup), null, {
+						default: withCtx(() => [createVNode(unref(UButton), {
+							size: "small",
+							class: normalizeClass(unref(cls).e("toggle")),
+							type: __props.rule.style.font?.bold ? "primary" : void 0,
+							plain: "",
+							title: "加粗",
+							onClick: toggleBold
+						}, {
+							default: withCtx(() => [..._cache[7] || (_cache[7] = [createTextVNode(" B ", -1)])]),
+							_: 1
+						}, 8, ["class", "type"]), createVNode(unref(UButton), {
+							size: "small",
+							class: normalizeClass(unref(cls).e("toggle")),
+							type: __props.rule.style.font?.italic ? "primary" : void 0,
+							plain: "",
+							title: "斜体",
+							onClick: toggleItalic
+						}, {
+							default: withCtx(() => [..._cache[8] || (_cache[8] = [createTextVNode(" I ", -1)])]),
+							_: 1
+						}, 8, ["class", "type"])]),
+						_: 1
+					}),
+					createVNode(_sfc_main$1, {
+						class: normalizeClass(unref(cls).e("preview")),
+						rule: __props.rule
+					}, null, 8, ["class", "rule"]),
+					createElementVNode("span", { class: normalizeClass(unref(cls).e("lead")) }, "应用到", 2),
+					createVNode(unref(UButtonGroup), null, {
+						default: withCtx(() => [(openBlock(true), createElementBlock(Fragment, null, renderList(unref(RULE_SCOPE_OPTIONS), (option) => {
+							return openBlock(), createBlock(unref(UButton), {
+								key: option.value,
+								size: "small",
+								plain: "",
+								type: (__props.rule.scope ?? "cell") === option.value ? "primary" : void 0,
+								title: option.value === "row" ? "染满物理输出行（交叉表会盖住同行所有列）" : "只改本格",
+								onClick: ($event) => onScope(option.value)
+							}, {
+								default: withCtx(() => [createTextVNode(toDisplayString(option.label), 1)]),
+								_: 2
+							}, 1032, [
+								"type",
+								"title",
+								"onClick"
+							]);
+						}), 128))]),
+						_: 1
+					})
+				], 2)], 2),
+				createVNode(unref(UButton), {
+					size: "small",
+					text: "",
+					type: "danger",
+					class: normalizeClass(unref(cls).e("remove")),
+					onClick: _cache[6] || (_cache[6] = ($event) => emit("remove"))
+				}, {
+					default: withCtx(() => [..._cache[9] || (_cache[9] = [createTextVNode(" 删除 ", -1)])]),
+					_: 1
+				}, 8, ["class"])
+			], 2);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };

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

@@ -0,0 +1,118 @@
+import { cloneRulesFromDraft, createDraftItem, initDraftFromRules } from "./conditional-rules/helpers.js";
+import _sfc_main$1 from "./rule-row.js";
+import { Fragment, computed, createBlock, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, normalizeClass, openBlock, ref, renderList, unref, watch, withCtx } from "vue";
+import { UButton, UDialog } from "@veltra/desktop";
+import { bem } from "@veltra/utils";
+import { animations, useDnD } from "@veltra/compositions";
+//#region src/components/report/designer/rules-dialog.vue
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	name: "UReportRulesDialog",
+	__name: "rules-dialog",
+	props: {
+		modelValue: { type: Boolean },
+		rules: {},
+		bindingField: {},
+		datasetFields: { default: () => [] },
+		fieldType: { default: "number" }
+	},
+	emits: ["update:modelValue", "save"],
+	setup(__props, { emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const cls = bem("report-rules-dialog");
+		const draftItems = ref([]);
+		const { parentRef } = useDnD({
+			values: draftItems,
+			dragHandle: ".u-report-rule-row__handle",
+			plugins: [animations()]
+		});
+		const visible = computed({
+			get: () => props.modelValue,
+			set: (value) => emit("update:modelValue", value)
+		});
+		watch(() => props.modelValue, (open) => {
+			if (!open) return;
+			draftItems.value = initDraftFromRules(props.rules, props.fieldType, props.bindingField);
+		});
+		function addRule() {
+			draftItems.value = [...draftItems.value, createDraftItem(void 0, props.fieldType, props.bindingField)];
+		}
+		function removeRule(index) {
+			draftItems.value = draftItems.value.filter((_, i) => i !== index);
+		}
+		function confirm() {
+			emit("save", cloneRulesFromDraft(draftItems.value));
+			visible.value = false;
+		}
+		function onClose() {
+			visible.value = false;
+		}
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(UDialog), {
+				modelValue: visible.value,
+				"onUpdate:modelValue": _cache[1] || (_cache[1] = ($event) => visible.value = $event),
+				title: "条件样式",
+				style: {
+					"width": "min(600px, 92vw)",
+					"max-height": "85vh"
+				},
+				onClose
+			}, {
+				footer: withCtx(() => [createVNode(unref(UButton), {
+					size: "small",
+					onClick: _cache[0] || (_cache[0] = ($event) => visible.value = false)
+				}, {
+					default: withCtx(() => [..._cache[3] || (_cache[3] = [createTextVNode("取消", -1)])]),
+					_: 1
+				}), createVNode(unref(UButton), {
+					size: "small",
+					type: "primary",
+					onClick: confirm
+				}, {
+					default: withCtx(() => [..._cache[4] || (_cache[4] = [createTextVNode("确定", -1)])]),
+					_: 1
+				})]),
+				default: withCtx(() => [createElementVNode("div", { class: normalizeClass(unref(cls).b) }, [
+					createElementVNode("p", { class: normalizeClass(unref(cls).e("hint")) }, "规则按顺序叠加。整行高亮适合明细表，交叉表会染满整行。", 2),
+					draftItems.value.length ? (openBlock(), createElementBlock("ul", {
+						key: 0,
+						ref_key: "parentRef",
+						ref: parentRef,
+						class: normalizeClass(unref(cls).e("list"))
+					}, [(openBlock(true), createElementBlock(Fragment, null, renderList(draftItems.value, (item, index) => {
+						return openBlock(), createElementBlock("li", {
+							key: item.id,
+							class: normalizeClass(unref(cls).e("item"))
+						}, [createVNode(_sfc_main$1, {
+							rule: item.rule,
+							"binding-field": __props.bindingField,
+							"dataset-fields": __props.datasetFields,
+							"onUpdate:rule": ($event) => item.rule = $event,
+							onRemove: ($event) => removeRule(index)
+						}, null, 8, [
+							"rule",
+							"binding-field",
+							"dataset-fields",
+							"onUpdate:rule",
+							"onRemove"
+						])], 2);
+					}), 128))], 2)) : (openBlock(), createElementBlock("p", {
+						key: 1,
+						class: normalizeClass(unref(cls).e("empty"))
+					}, "还没有规则。", 2)),
+					createVNode(unref(UButton), {
+						size: "small",
+						plain: "",
+						onClick: addRule
+					}, {
+						default: withCtx(() => [..._cache[2] || (_cache[2] = [createTextVNode("添加规则", -1)])]),
+						_: 1
+					})
+				], 2)]),
+				_: 1
+			}, 8, ["modelValue"]);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };

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

@@ -0,0 +1,122 @@
+import { readCellOverlayRect, readGridOverlaySize, useGridOverlaySync } from "./use-grid-overlay.js";
+import { buildTopologyArcPath, collectTopologyLinks } from "./topology.js";
+import { Fragment, computed, createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeClass, openBlock, ref, renderList, toRef, unref } from "vue";
+import { bem } from "@veltra/utils";
+//#region src/components/report/designer/topology-overlay.vue
+const _hoisted_1 = ["width", "height"];
+const _hoisted_2 = ["d", "marker-end"];
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	name: "UReportTopologyOverlay",
+	__name: "topology-overlay",
+	props: {
+		cell: {},
+		binding: {},
+		entries: {},
+		metaTick: {},
+		hostEl: {},
+		getGrid: { type: Function },
+		getBindingAt: { type: Function }
+	},
+	setup(__props) {
+		const props = __props;
+		const cls = bem("report-topology");
+		const instanceId = Math.random().toString(36).slice(2, 8);
+		const rowArrowMarkerId = `u-report-topology-row-arrow-${instanceId}`;
+		const colArrowMarkerId = `u-report-topology-col-arrow-${instanceId}`;
+		const hostEl = toRef(props, "hostEl");
+		const svgWidth = ref(0);
+		const svgHeight = ref(0);
+		const arcPaths = ref([]);
+		const inView = ref(false);
+		const visible = computed(() => !!props.binding && !!props.cell && inView.value && arcPaths.value.length > 0);
+		function updateOverlay() {
+			const cell = props.cell;
+			const binding = props.binding;
+			const host = props.hostEl;
+			if (!cell || !binding || !host) {
+				inView.value = false;
+				arcPaths.value = [];
+				return;
+			}
+			const size = readGridOverlaySize(host);
+			if (!size) {
+				inView.value = false;
+				arcPaths.value = [];
+				return;
+			}
+			svgWidth.value = size.width;
+			svgHeight.value = size.height;
+			const links = collectTopologyLinks(cell, binding, props.entries, props.getBindingAt);
+			const paths = [];
+			for (const link of links) {
+				const fromRect = readCellOverlayRect(link.from, host, props.getGrid);
+				const toRect = readCellOverlayRect(link.to, host, props.getGrid);
+				if (!fromRect || !toRect) continue;
+				paths.push({
+					direction: link.direction,
+					path: buildTopologyArcPath({
+						x: fromRect.centerX,
+						y: fromRect.centerY
+					}, {
+						x: toRect.centerX,
+						y: toRect.centerY
+					})
+				});
+			}
+			arcPaths.value = paths;
+			inView.value = paths.length > 0;
+		}
+		useGridOverlaySync({
+			hostEl,
+			getGrid: () => props.getGrid(),
+			watchSources: () => [
+				props.cell?.row,
+				props.cell?.col,
+				props.binding,
+				props.metaTick,
+				props.hostEl
+			],
+			update: updateOverlay
+		});
+		return (_ctx, _cache) => {
+			return visible.value ? (openBlock(), createElementBlock("svg", {
+				key: 0,
+				class: normalizeClass(unref(cls).b),
+				width: svgWidth.value,
+				height: svgHeight.value,
+				"aria-hidden": "true"
+			}, [createElementVNode("defs", null, [createElementVNode("marker", {
+				id: rowArrowMarkerId,
+				markerWidth: "8",
+				markerHeight: "8",
+				refX: "6",
+				refY: "4",
+				orient: "auto",
+				markerUnits: "strokeWidth"
+			}, [..._cache[0] || (_cache[0] = [createElementVNode("path", {
+				d: "M0,0 L8,4 L0,8 Z",
+				fill: "var(--u-color-primary, #2563eb)"
+			}, null, -1)])]), createElementVNode("marker", {
+				id: colArrowMarkerId,
+				markerWidth: "8",
+				markerHeight: "8",
+				refX: "6",
+				refY: "4",
+				orient: "auto",
+				markerUnits: "strokeWidth"
+			}, [..._cache[1] || (_cache[1] = [createElementVNode("path", {
+				d: "M0,0 L8,4 L0,8 Z",
+				fill: "var(--u-color-warning, #d97706)"
+			}, null, -1)])])]), (openBlock(true), createElementBlock(Fragment, null, renderList(arcPaths.value, (item, index) => {
+				return openBlock(), createElementBlock("path", {
+					key: index,
+					class: normalizeClass([unref(cls).e("arc"), unref(cls).em("arc", item.direction)]),
+					d: item.path,
+					"marker-end": `url(#${item.direction === "row" ? rowArrowMarkerId : colArrowMarkerId})`
+				}, null, 10, _hoisted_2);
+			}), 128))], 10, _hoisted_1)) : createCommentVNode("v-if", true);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };

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

@@ -0,0 +1,64 @@
+//#region src/components/report/designer/topology.ts
+function linkKey(from, to, direction) {
+	return `${direction}:${from.row},${from.col}->${to.row},${to.col}`;
+}
+function sameAddress(a, b) {
+	return a.row === b.row && a.col === b.col;
+}
+function pushLink(links, seen, from, to, direction) {
+	const key = linkKey(from, to, direction);
+	if (seen.has(key)) return;
+	links.push({
+		from,
+		to,
+		direction
+	});
+	seen.add(key);
+}
+/** 查找将指定格作为行方向父格的绑定格 */
+function findCellsWithRowParent(parent, entries) {
+	const children = [];
+	for (const { addr, binding } of entries) if (binding.rowParent && sameAddress(binding.rowParent, parent)) children.push(addr);
+	return children;
+}
+/** 查找将指定格作为列方向父格的绑定格 */
+function findCellsWithColParent(parent, entries) {
+	const children = [];
+	for (const { addr, binding } of entries) if (binding.colParent && sameAddress(binding.colParent, parent)) children.push(addr);
+	return children;
+}
+/** 收集选中格相关的拓扑连线：沿 rowParent / colParent 链上行、下行到直接子绑定 */
+function collectTopologyLinks(cell, binding, entries, getBindingAt) {
+	const links = [];
+	const seen = /* @__PURE__ */ new Set();
+	let rowCursor = cell;
+	let rowBinding = binding;
+	while (rowBinding?.rowParent) {
+		const parent = rowBinding.rowParent;
+		pushLink(links, seen, rowCursor, parent, "row");
+		rowCursor = parent;
+		rowBinding = getBindingAt(parent);
+	}
+	let colCursor = cell;
+	let colBinding = binding;
+	while (colBinding?.colParent) {
+		const parent = colBinding.colParent;
+		pushLink(links, seen, colCursor, parent, "col");
+		colCursor = parent;
+		colBinding = getBindingAt(parent);
+	}
+	for (const child of findCellsWithRowParent(cell, entries)) pushLink(links, seen, child, cell, "row");
+	for (const child of findCellsWithColParent(cell, entries)) pushLink(links, seen, child, cell, "col");
+	return links;
+}
+/** 子格 → 父格的二次贝塞尔弧线路径 */
+function buildTopologyArcPath(from, to) {
+	const dx = to.x - from.x;
+	const dy = to.y - from.y;
+	const lift = Math.min(48, Math.max(16, (Math.hypot(dx, dy) || 1) * .35));
+	const cx = (from.x + to.x) / 2;
+	const cy = (from.y + to.y) / 2 - lift * Math.sign(dy || -1);
+	return `M ${from.x} ${from.y} Q ${cx} ${cy} ${to.x} ${to.y}`;
+}
+//#endregion
+export { buildTopologyArcPath, collectTopologyLinks, findCellsWithColParent, findCellsWithRowParent };

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

@@ -0,0 +1,75 @@
+import { getCellOverlayRect, resolveGridOverlayLayout } from "./cell-coords.js";
+import { onBeforeUnmount, watch } from "vue";
+//#region src/components/report/designer/use-grid-overlay.ts
+/** 网格滚动时重算 overlay 坐标；避免在 props 不稳定时重复绑定监听 */
+function useGridOverlaySync(options) {
+	let offScroll;
+	let rafId = 0;
+	function scheduleUpdate() {
+		cancelAnimationFrame(rafId);
+		rafId = requestAnimationFrame(options.update);
+	}
+	function bindScroll() {
+		offScroll?.();
+		offScroll = void 0;
+		const grid = options.getGrid();
+		if (!grid) return;
+		const table = grid.getTable();
+		const onScroll = () => scheduleUpdate();
+		const scrollEvent = "scroll";
+		table.on(scrollEvent, onScroll);
+		offScroll = () => table.off(scrollEvent, onScroll);
+	}
+	watch(options.watchSources, () => {
+		bindScroll();
+		scheduleUpdate();
+	}, {
+		immediate: true,
+		flush: "post"
+	});
+	onBeforeUnmount(() => {
+		cancelAnimationFrame(rafId);
+		offScroll?.();
+	});
+}
+function readCellOverlayRect(cell, host, getGrid) {
+	const grid = getGrid();
+	if (!grid) return null;
+	const resolved = resolveGridOverlayLayout(host);
+	if (!resolved) return null;
+	return getCellOverlayRect(grid, cell, resolved.layout);
+}
+function readGridOverlaySize(host) {
+	const resolved = resolveGridOverlayLayout(host);
+	if (!resolved) return null;
+	const { layout } = resolved;
+	return {
+		width: layout.viewW + layout.offsetX,
+		height: layout.viewH + layout.offsetY
+	};
+}
+/** 悬浮编辑卡锚点：空间按网格画布（非宿主顶）计算，避免顶行格误判为上方可放 */
+function resolveBindingFloatPanelPosition(rect, layout, panelWidth, panelHeight, hostWidth, options) {
+	const gap = options?.gap ?? 8;
+	const edgePad = options?.edgePad ?? 10;
+	const gridTop = layout.offsetY;
+	const gridBottom = layout.offsetY + layout.viewH;
+	let left = rect.centerX;
+	const halfW = panelWidth / 2;
+	left = Math.max(edgePad + halfW, Math.min(hostWidth - edgePad - halfW, left));
+	const spaceAbove = rect.top - gridTop;
+	const spaceBelow = gridBottom - rect.bottom;
+	const need = panelHeight + gap;
+	let placement = spaceAbove >= need || spaceAbove >= spaceBelow ? "above" : "below";
+	if (placement === "above" && rect.top - gap - panelHeight < gridTop + edgePad) {
+		if (spaceBelow >= need || spaceBelow > spaceAbove) placement = "below";
+	}
+	const top = placement === "above" ? rect.top - gap : rect.bottom + gap;
+	return {
+		placement,
+		left: Math.round(left),
+		top: Math.round(top)
+	};
+}
+//#endregion
+export { readCellOverlayRect, readGridOverlaySize, resolveBindingFloatPanelPosition, useGridOverlaySync };