@tmagic/editor 1.8.0-beta.2 → 1.8.0-beta.21

package/dist/es/utils/editor.js

@@ -74,12 +74,26 @@ var getMiddleTop = (node, parentNode, stage) => {
 	}
 	return (Math.min(parentHeight, wrapperHeightDeal) - height) / 2;
 };
+var removeConflictPosition = (style, primary, secondary) => {
+	const isInvalid = (value) => value === "" || value === 0 || value === void 0 || value === null;
+	if (!(primary in style) || !(secondary in style)) return;
+	const primaryValue = style[primary];
+	const secondaryValue = style[secondary];
+	const primaryInvalid = isInvalid(primaryValue);
+	const secondaryInvalid = isInvalid(secondaryValue);
+	if (primaryInvalid && !secondaryInvalid) delete style[primary];
+	else if (secondaryInvalid && !primaryInvalid) delete style[secondary];
+	else if (primaryInvalid && secondaryInvalid) if (secondaryValue === 0 && primaryValue !== 0) delete style[primary];
+	else delete style[secondary];
+};
 var getInitPositionStyle = (style = {}, layout) => {
 	if (layout === Layout.ABSOLUTE) {
 		const newStyle = {
 			...style,
 			position: "absolute"
 		};
+		removeConflictPosition(newStyle, "left", "right");
+		removeConflictPosition(newStyle, "top", "bottom");
 		if (typeof newStyle.left === "undefined" && typeof newStyle.right === "undefined") newStyle.left = 0;
 		return newStyle;
 	}
@@ -104,58 +118,63 @@ var setLayout = (node, layout) => {
 	}
 	return node;
 };
-var change2Fixed = (node, root) => {
+var hasPositionValue = (style, key) => typeof style?.[key] !== "undefined" && style?.[key] !== "";
+/**
+* 沿节点路径累加（或抵消）某一方向上的定位偏移量
+* 当路径上的祖先使用了反方向定位（例如计算 left 时祖先用了 right）或非数值定位时，
+* 无法简单地通过求和换算坐标，此时返回 0 表示放弃补偿、保持原值
+* @param path 从根到目标节点的路径（含节点自身）
+* @param dir 需要累加的定位方向
+* @param opposite 反方向定位属性
+* @param sign change2Fixed 取 1（累加祖先偏移），Fixed2Other 取 -1（抵消祖先偏移）
+* @param init 偏移量初始值
+*/
+var accumulatePositionOffset = (path, dir, opposite, sign, init = 0) => {
+	let offset = init;
+	for (const value of path) {
+		if (hasPositionValue(value.style, opposite) || !isNumber(value.style?.[dir] || 0)) return 0;
+		offset = offset + sign * Number(value.style?.[dir] || 0);
+	}
+	return offset;
+};
+var change2Fixed = (node, path) => {
 	const style = { ...node.style || {} };
-	const path = getNodePath(node.id, root.items);
-	const offset = {
-		left: 0,
-		top: 0
-	};
-	if (!node.style?.right && isNumber(node.style?.left || 0)) for (const value of path) {
-		if (value.style?.right || !isNumber(value.style?.left || 0)) {
-			offset.left = 0;
-			break;
-		}
-		offset.left = offset.left + Number(value.style?.left || 0);
+	if (!hasPositionValue(node.style, "right") && isNumber(node.style?.left || 0)) {
+		const left = accumulatePositionOffset(path, "left", "right", 1);
+		if (left) style.left = left;
+	} else if (hasPositionValue(node.style, "right") && isNumber(node.style?.right || 0)) {
+		const right = accumulatePositionOffset(path, "right", "left", 1);
+		if (right) style.right = right;
 	}
-	if (!node.style?.bottom && isNumber(node.style?.top || 0)) for (const value of path) {
-		if (value.style?.bottom || !isNumber(value.style?.top || 0)) {
-			offset.top = 0;
-			break;
-		}
-		offset.top = offset.top + Number(value.style?.top || 0);
+	if (!hasPositionValue(node.style, "bottom") && isNumber(node.style?.top || 0)) {
+		const top = accumulatePositionOffset(path, "top", "bottom", 1);
+		if (top) style.top = top;
+	} else if (hasPositionValue(node.style, "bottom") && isNumber(node.style?.bottom || 0)) {
+		const bottom = accumulatePositionOffset(path, "bottom", "top", 1);
+		if (bottom) style.bottom = bottom;
 	}
-	if (offset.left) style.left = offset.left;
-	if (offset.top) style.top = offset.top;
 	return style;
 };
-var Fixed2Other = async (node, root, getLayout) => {
-	const path = getNodePath(node.id, root.items);
+var Fixed2Other = async (node, path, getLayout) => {
 	const cur = path.pop();
 	const offset = {
-		left: cur?.style?.left || 0,
-		top: cur?.style?.top || 0
+		left: 0,
+		top: 0,
+		right: 0,
+		bottom: 0
 	};
-	if (!node.style?.right && isNumber(node.style?.left || 0)) for (const value of path) {
-		if (value.style?.right || !isNumber(value.style?.left || 0)) {
-			offset.left = 0;
-			break;
-		}
-		offset.left = offset.left - Number(value.style?.left || 0);
-	}
-	if (!node.style?.bottom && isNumber(node.style?.top || 0)) for (const value of path) {
-		if (value.style?.bottom || !isNumber(value.style?.top || 0)) {
-			offset.top = 0;
-			break;
-		}
-		offset.top = offset.top - Number(value.style?.top || 0);
-	}
+	if (!hasPositionValue(node.style, "right") && isNumber(node.style?.left || 0)) offset.left = accumulatePositionOffset(path, "left", "right", -1, Number(cur?.style?.left || 0));
+	else if (hasPositionValue(node.style, "right") && isNumber(node.style?.right || 0)) offset.right = accumulatePositionOffset(path, "right", "left", -1, Number(cur?.style?.right || 0));
+	if (!hasPositionValue(node.style, "bottom") && isNumber(node.style?.top || 0)) offset.top = accumulatePositionOffset(path, "top", "bottom", -1, Number(cur?.style?.top || 0));
+	else if (hasPositionValue(node.style, "bottom") && isNumber(node.style?.bottom || 0)) offset.bottom = accumulatePositionOffset(path, "bottom", "top", -1, Number(cur?.style?.bottom || 0));
 	const style = node.style || {};
 	const parent = path.pop();
 	if (!parent) return getRelativeStyle(style);
 	if (await getLayout(parent) !== Layout.RELATIVE) {
 		if (offset.left) style.left = offset.left;
 		if (offset.top) style.top = offset.top;
+		if (offset.right) style.right = offset.right;
+		if (offset.bottom) style.bottom = offset.bottom;
 		return {
 			...style,
 			position: "absolute"
@@ -187,11 +206,11 @@ var fixNodeLeft = (config, parent, doc) => {
 };
 var fixNodePosition = (config, parent, stage) => {
 	if (config.style?.position !== "absolute") return config.style;
-	return {
-		...config.style || {},
-		top: getMiddleTop(config, parent, stage),
-		left: fixNodeLeft(config, parent, stage?.renderer?.contentWindow?.document)
-	};
+	const style = { ...config.style || {} };
+	const baseStyle = config.style || {};
+	if (!("right" in baseStyle)) style.left = fixNodeLeft(config, parent, stage?.renderer?.contentWindow?.document);
+	if (!("top" in baseStyle) && !("bottom" in baseStyle)) style.top = getMiddleTop(config, parent, stage);
+	return style;
 };
 var serializeConfig = (config) => serialize(config, {
 	space: 2,
@@ -268,13 +287,14 @@ var buildChangeRecords = (value, basePath) => {
 var resolveSelectedNode = (config, getNodeInfoFn, rootId) => {
 	const id = typeof config === "string" || typeof config === "number" ? config : config.id;
 	if (!id) throw new Error("没有ID，无法选中");
-	const { node, parent, page } = getNodeInfoFn(id);
+	const { node, parent, page, path } = getNodeInfoFn(id);
 	if (!node) throw new Error("获取不到组件信息");
 	if (node.id === rootId) throw new Error("不能选根节点");
 	return {
 		node,
 		parent,
-		page
+		page,
+		path
 	};
 };
 /**
@@ -286,11 +306,11 @@ var resolveSelectedNode = (config, getNodeInfoFn, rootId) => {
 * @param getLayoutFn 获取父节点布局方式的回调函数
 * @returns 处理后的节点配置（深拷贝）
 */
-var toggleFixedPosition = async (dist, src, root, getLayoutFn) => {
+var toggleFixedPosition = async (dist, src, path, getLayoutFn) => {
 	const newConfig = cloneDeep$1(dist);
 	if (!isPop(src) && newConfig.style?.position) {
-		if (isFixed(newConfig.style) && !isFixed(src.style || {})) newConfig.style = change2Fixed(newConfig, root);
-		else if (!isFixed(newConfig.style) && isFixed(src.style || {})) newConfig.style = await Fixed2Other(newConfig, root, getLayoutFn);
+		if (isFixed(newConfig.style) && !isFixed(src.style || {})) newConfig.style = change2Fixed(newConfig, path);
+		else if (!isFixed(newConfig.style) && isFixed(src.style || {})) newConfig.style = await Fixed2Other(newConfig, path, getLayoutFn);
 	}
 	return newConfig;
 };
@@ -431,5 +451,39 @@ var classifyDragSources = (configs, targetParent, getNodeInfo) => {
 		aborted: false
 	};
 };
+/**
+* 给「回滚」生成的新 step 用的简短描述生成器。
+* 与 UI 层 `describePageStep` 同义，但避免 service 反向依赖 layouts/，故放在此工具函数中。
+*/
+var describeStepForRevert = (step) => {
+	const items = step.diff ?? [];
+	const withId = (node, label) => {
+		const id = node?.id;
+		if (id === void 0 || id === null || `${id}` === "") return label;
+		return label ? `${label}（id: ${id}）` : `id: ${id}`;
+	};
+	switch (step.opType) {
+		case "add": {
+			const count = items.length;
+			const node = items[0]?.newSchema;
+			const label = node?.name || node?.type || "";
+			return `撤回新增 ${count} 个节点${count === 1 ? `（${withId(node, label)}）` : ""}`;
+		}
+		case "remove": {
+			const count = items.length;
+			const node = items[0]?.oldSchema;
+			const label = node?.name || node?.type || "";
+			return `还原已删除的 ${count} 个节点${count === 1 ? `（${withId(node, label)}）` : ""}`;
+		}
+		default:
+			if (items.length === 1) {
+				const { newSchema, oldSchema, changeRecords } = items[0];
+				const target = withId(newSchema || oldSchema, newSchema?.name || newSchema?.type || oldSchema?.name || oldSchema?.type || "");
+				const propPath = changeRecords?.[0]?.propPath;
+				return propPath ? `还原 ${target} · ${propPath}` : `还原 ${target}`;
+			}
+			return `还原 ${items.length} 个节点的修改`;
+	}
+};
 //#endregion
-export { COPY_CODE_STORAGE_KEY, COPY_DS_STORAGE_KEY, COPY_STORAGE_KEY, Fixed2Other, buildChangeRecords, calcAlignCenterStyle, calcLayerTargetIndex, calcMoveStyle, change2Fixed, classifyDragSources, collectRelatedNodes, editorNodeMergeCustomizer, fixNodeLeft, fixNodePosition, generatePageName, generatePageNameByApp, getGuideLineFromCache, getInitPositionStyle, getNodeIndex, getPageFragmentList, getPageList, getPageNameList, getRelativeStyle, isIncludeDataSource, moveItemsInContainer, resolveSelectedNode, serializeConfig, setChildrenLayout, setLayout, toggleFixedPosition };
+export { COPY_CODE_STORAGE_KEY, COPY_DS_STORAGE_KEY, COPY_STORAGE_KEY, Fixed2Other, buildChangeRecords, calcAlignCenterStyle, calcLayerTargetIndex, calcMoveStyle, change2Fixed, classifyDragSources, collectRelatedNodes, describeStepForRevert, editorNodeMergeCustomizer, fixNodeLeft, fixNodePosition, generatePageName, generatePageNameByApp, getGuideLineFromCache, getInitPositionStyle, getNodeIndex, getPageFragmentList, getPageList, getPageNameList, getRelativeStyle, isIncludeDataSource, moveItemsInContainer, resolveSelectedNode, serializeConfig, setChildrenLayout, setLayout, toggleFixedPosition };

package/dist/es/utils/event.js

@@ -0,0 +1,135 @@
+import editor_default from "../services/editor.js";
+import { getCascaderOptionsFromFields } from "./data-source/index.js";
+import dataSource_default from "../services/dataSource.js";
+import events_default from "../services/events.js";
+import { DATA_SOURCE_FIELDS_CHANGE_EVENT_PREFIX, traverseNode } from "@tmagic/utils";
+//#region packages/editor/src/utils/event.ts
+var EVENT_NAME_VALUE_SEPARATOR = ".";
+/** 与 EventSelect 中 checkStrictly 一致：component 为 false，其余为 true */
+var isEventNameCheckStrictly = (src) => src !== "component";
+/** 将动作 method 值规范为与 collectEventNameOptionValues 一致的字符串（cascader 无 valueSeparator 时存数组） */
+var normalizeCompActionValue = (value) => {
+	if (Array.isArray(value)) return value.map((item) => `${item}`).join(".");
+	if (value === null || value === void 0 || value === "") return "";
+	return `${value}`;
+};
+/**
+* 组装事件名称下拉/级联 options，与 EventSelect 默认 eventNameConfig.options 逻辑一致。
+*/
+var getEventNameOptions = (src, formValue = {}) => {
+	if (!formValue.type) return [];
+	if (src === "component") {
+		const sourceNode = editor_default.getNodeById(formValue.id);
+		let events = events_default.getEvent(formValue.type, { node: sourceNode }) || [];
+		if (formValue.type === "page-fragment-container" && formValue.pageFragmentId) {
+			const pageFragment = editor_default.get("root")?.items?.find((page) => page.id === formValue.pageFragmentId);
+			if (!pageFragment) return [];
+			events = [{
+				label: pageFragment.name || "页面片容器",
+				value: pageFragment.id,
+				children: events
+			}];
+			(pageFragment.items || []).forEach((item) => {
+				traverseNode(item, (current) => {
+					if (!current.type) return;
+					const node = editor_default.getNodeById(current.id) || current;
+					const nodeEvents = events_default.getEvent(current.type, { node }) || [];
+					events.push({
+						label: `${current.name}_${current.id}`,
+						value: `${current.id}`,
+						children: nodeEvents
+					});
+				});
+			});
+			return events;
+		}
+		return events.map((option) => ({
+			text: option.label,
+			value: option.value
+		}));
+	}
+	if (src === "datasource") {
+		const events = dataSource_default.getFormEvent(formValue.type) || [];
+		const fields = dataSource_default.getDataSourceById(formValue.id)?.fields || [];
+		if (fields.length > 0) return [...events, {
+			label: "数据变化",
+			value: DATA_SOURCE_FIELDS_CHANGE_EVENT_PREFIX,
+			children: getCascaderOptionsFromFields(fields)
+		}];
+		return events;
+	}
+	return [];
+};
+/** 将 select / cascader options 展平为最终写入 name 的字符串集合（cascader 用 `.` 拼接） */
+var collectEventNameOptionValues = (options, checkStrictly, prefix = [], result = /* @__PURE__ */ new Set()) => {
+	options.forEach((option) => {
+		if (typeof option?.value === "undefined") return;
+		const path = [...prefix, option.value];
+		const joined = path.map((item) => `${item}`).join(".");
+		const children = "children" in option ? option.children : void 0;
+		if (Array.isArray(children) && children.length) {
+			if (checkStrictly) result.add(joined);
+			collectEventNameOptionValues(children, checkStrictly, path, result);
+			return;
+		}
+		result.add(joined);
+	});
+	return result;
+};
+/**
+* 解析 event-select 允许的 name 集合。
+* 自定义 eventNameConfig.options 时返回 null（跳过枚举校验）。
+*/
+var getEventNameAllowedValues = (config = {}, formValue = {}) => {
+	if (typeof config.eventNameConfig?.options !== "undefined") return null;
+	if (config.src !== "component" && config.src !== "datasource") return null;
+	return collectEventNameOptionValues(getEventNameOptions(config.src, formValue), isEventNameCheckStrictly(config.src));
+};
+/**
+* 组装联动组件动作下拉/级联 options，与 EventSelect 默认 compActionConfig.options 逻辑一致。
+*/
+var getCompActionOptions = (toId) => {
+	if (typeof toId === "undefined" || toId === null || toId === "") return [];
+	const node = editor_default.getNodeById(toId);
+	if (!node?.type) return [];
+	let methods = events_default.getMethod(node.type, {
+		targetId: toId,
+		node
+	}) || [];
+	if (node.type === "page-fragment-container" && node.pageFragmentId) {
+		const pageFragment = editor_default.get("root")?.items?.find((page) => page.id === node.pageFragmentId);
+		if (!pageFragment) return [];
+		methods = [];
+		(pageFragment.items || []).forEach((item) => {
+			traverseNode(item, (current) => {
+				const node = editor_default.getNodeById(current.id) || current;
+				if (!current.type) return;
+				const nodeMethods = events_default.getMethod(current.type, {
+					targetId: current.id,
+					node
+				}) || [];
+				if (!nodeMethods.length) return;
+				methods.push({
+					label: `${current.name}_${current.id}`,
+					value: `${current.id}`,
+					children: nodeMethods
+				});
+			});
+		});
+		return methods;
+	}
+	return methods.map((method) => ({
+		text: method.label,
+		value: method.value
+	}));
+};
+/**
+* 解析 event-select 联动组件动作允许的 method 集合。
+* 自定义 compActionConfig.options 时返回 null（跳过枚举校验）。
+*/
+var getCompActionAllowedValues = (config = {}, model = {}) => {
+	if (typeof config.compActionConfig?.options !== "undefined") return null;
+	return collectEventNameOptionValues(getCompActionOptions(model.to), isEventNameCheckStrictly(config.src));
+};
+//#endregion
+export { EVENT_NAME_VALUE_SEPARATOR, collectEventNameOptionValues, getCompActionAllowedValues, getCompActionOptions, getEventNameAllowedValues, getEventNameOptions, isEventNameCheckStrictly, normalizeCompActionValue };

package/dist/es/utils/history.js

@@ -0,0 +1,220 @@
+import { UndoRedo } from "./undo-redo.js";
+import { guid } from "@tmagic/utils";
+import { cloneDeep } from "lodash-es";
+import serialize from "serialize-javascript";
+//#region packages/editor/src/utils/history.ts
+/**
+* 「回滚」生成的新 step 简短描述。代码块 / 数据源共用。
+* 二者逻辑一致，仅展示名取值字段不同（代码块取 `name`，数据源取 `title`），
+* 因此通过 `getLabel` 注入取值方式。
+*
+* @param id 关联的代码块 / 数据源 id
+* @param diff 单条变更 diff（缺省视为空）
+* @param getLabel 从快照取展示名
+*/
+var describeRevertStep = (id, { oldSchema, newSchema, changeRecords } = {}, getLabel) => {
+	const labelOf = (schema) => getLabel(schema) || schema.id;
+	if (!oldSchema && newSchema) return `撤回新增 ${labelOf(newSchema) || id}`;
+	if (oldSchema && !newSchema) return `还原已删除的 ${labelOf(oldSchema) || id}`;
+	const label = newSchema && getLabel(newSchema) || oldSchema && getLabel(oldSchema) || `${id}`;
+	const propPath = changeRecords?.[0]?.propPath;
+	return propPath ? `还原 ${label} · ${propPath}` : `还原 ${label}`;
+};
+/**
+* 根据 old/new 是否为 null 推断 opType（与 push 时的约定一致）。
+*/
+var detectStackOpType = (oldVal, newVal) => {
+	if (oldVal === null && newVal !== null) return "add";
+	if (oldVal !== null && newVal === null) return "remove";
+	return "update";
+};
+/**
+* 构造一条代码块 / 数据源「按 id 分栈」的历史记录：两者除 payload 字段命名外完全一致。
+*
+* - `add`：oldValue = null；`remove`：newValue = null；`update`：两者都有，可带 changeRecords 做局部更新。
+* - 内容会做 cloneDeep 防止后续被外部引用篡改；opType 依据 old/new 是否为 null 推断。
+* - 仅负责构造 step 并返回，入栈与事件 emit 由统一的 history.push(stepType, step, id) 处理。
+* - 不直接驱动业务 service，调用方负责实际写回。
+*/
+var createStackStep = (id, payload) => {
+	if (!id) return null;
+	const oldSchema = payload.oldValue ? cloneDeep(payload.oldValue) : null;
+	const newSchema = payload.newValue ? cloneDeep(payload.newValue) : null;
+	const changeRecords = payload.changeRecords?.length ? cloneDeep(payload.changeRecords) : void 0;
+	const opType = detectStackOpType(payload.oldValue, payload.newValue);
+	const schema = payload.newValue ?? payload.oldValue;
+	const name = payload.name ?? schema?.name ?? schema?.title ?? "";
+	return {
+		uuid: guid(),
+		data: {
+			name,
+			id
+		},
+		opType,
+		diff: [{
+			...newSchema !== null ? { newSchema } : {},
+			...oldSchema !== null ? { oldSchema } : {},
+			...opType === "update" && changeRecords ? { changeRecords } : {}
+		}],
+		historyDescription: payload.historyDescription,
+		source: payload.source,
+		operator: payload.operator,
+		rootStep: payload.rootStep,
+		timestamp: Date.now(),
+		extra: payload.extra
+	};
+};
+var markStackSaved = (undoRedo) => {
+	if (!undoRedo) return;
+	undoRedo.updateElements((element) => {
+		element.saved = false;
+	});
+	undoRedo.updateCurrentElement((element) => {
+		element.saved = true;
+	});
+};
+/**
+* 把单个历史栈（页面 / 代码块 / 数据源 / 扩展类型）的步骤列表按"目标"做相邻合并：
+* - 单实体的 'update' 按 targetId 与相邻同 targetId 的 update 合并到一个 group，组内可展开查看每步；
+* - 'add' / 'remove' 始终独立成组（语义上是结构变更，不应被收纳进单实体修改组）；
+* - 多实体 'update'（如页面批量改属性）也独立成组（无明确单一目标，避免误合并）。
+*
+* 各类型行为完全一致，仅 `kind` 与 step 快照类型不同，统一由本方法处理。
+*/
+var mergeSteps = (kind, id, list, cursor) => {
+	const groups = [];
+	let current = null;
+	const currentIndex = cursor - 1;
+	list.forEach((step, index) => {
+		const applied = index < cursor;
+		const isCurrent = index === currentIndex;
+		const targetId = detectTargetId(step);
+		const targetName = detectTargetName(step);
+		const entry = {
+			step,
+			index,
+			applied,
+			isCurrent
+		};
+		const mergeable = step.opType === "update" && targetId !== void 0;
+		if (mergeable && current?.opType === "update" && current.targetId === targetId) {
+			current.steps.push(entry);
+			current.applied = applied;
+			if (isCurrent) current.isCurrent = true;
+			if (targetName) current.targetName = targetName;
+		} else {
+			current = {
+				kind,
+				id,
+				opType: step.opType,
+				targetId: mergeable ? targetId : void 0,
+				targetName,
+				steps: [entry],
+				applied,
+				isCurrent
+			};
+			groups.push(current);
+		}
+	});
+	return groups;
+};
+/**
+* 解析 step 中的"目标 id"用于合并：
+* - 单实体 update：取唯一一项 diff 的快照 id；快照无 id 时（如 CodeBlockContent）回退到 `step.data.id`
+*   （即资源 id），使代码块 / 数据源同样能按资源合并相邻 update；
+* - 其它情形（多实体 update / add / remove）：返回 undefined，表示不参与合并。
+*/
+var detectTargetId = (step) => {
+	if (step.opType !== "update") return void 0;
+	const items = step.diff;
+	if (items?.length !== 1) return void 0;
+	const newSchema = items[0].newSchema;
+	const oldSchema = items[0].oldSchema;
+	return newSchema?.id ?? oldSchema?.id ?? step.data?.id;
+};
+/** 解析 step 中的目标可读名（用于 UI 展示）。 */
+var detectTargetName = (step) => {
+	const items = step.diff;
+	if (step.opType === "update") {
+		if (items?.length === 1) {
+			const node = items[0].newSchema || items[0].oldSchema;
+			return node?.name || node?.type || (node?.id !== void 0 ? `${node.id}` : void 0);
+		}
+		return items?.length ? `${items.length} 个节点` : void 0;
+	}
+	if (step.opType === "add") {
+		if (items?.length === 1) {
+			const n = items[0].newSchema;
+			return n?.name || n?.type || `${n?.id}`;
+		}
+		return items?.length ? `${items.length} 个节点` : void 0;
+	}
+	if (step.opType === "remove") {
+		if (items?.length === 1) {
+			const n = items[0].oldSchema;
+			return n?.name || n?.type || `${n?.id}`;
+		}
+		return items?.length ? `${items.length} 个节点` : void 0;
+	}
+};
+/**
+* 把 `Record<Id, UndoRedo>` 整体序列化为 `Record<Id, SerializedUndoRedo>`。
+*
+* 序列化（深克隆）的同一趟里，只把每条 step 中可能含函数的 `diff` 用 serialize-javascript 序列化成字符串，
+* 其余字段（uuid / opType / timestamp / `modifiedNodeIds` Map 等）原样保留，交给 IndexedDB 结构化克隆。
+* 这样既能写入函数，又避免序列化整份快照的开销；读取时再由 {@link parseStacksStepDiff} 还原 diff。
+* 不含 `diff` 的元素（如通用栈）原样透传。
+*/
+var serializeStacks = (stacks) => {
+	const result = {};
+	Object.entries(stacks).forEach(([id, undoRedo]) => {
+		if (!undoRedo) return;
+		const serialized = undoRedo.serialize();
+		result[id] = {
+			...serialized,
+			elementList: serialized.elementList.map((step) => step.diff === void 0 ? step : Object.assign({}, step, { diff: serialize(step.diff) }))
+		};
+	});
+	return result;
+};
+/**
+* 把 `Record<Id, SerializedUndoRedo>` 整体还原为 `Record<Id, UndoRedo>`。
+* 还原时把每个栈的游标定位到最近一条已保存（`saved === true`）记录之后。
+*
+* 与 {@link serializeStacks} 相反：当传入 `parse`（parseDSL）时，把每条 step 中以字符串形式存储的 `diff`
+* 解析回真实对象（含函数）；不含 `diff` 的元素（如通用栈）原样透传。
+*/
+var deserializeStacks = (stacks = {}, parse) => {
+	const result = {};
+	Object.entries(stacks).forEach(([id, serialized]) => {
+		if (!serialized) return;
+		const elementList = parse ? serialized.elementList.map((step) => {
+			const { diff } = step;
+			return typeof diff === "string" ? Object.assign({}, step, { diff: parse(`(${diff})`) }) : step;
+		}) : serialized.elementList;
+		result[id] = UndoRedo.fromSerialized({
+			...serialized,
+			elementList
+		}, { isSavedStep: (element) => element.saved === true });
+	});
+	return result;
+};
+/**
+* 按 id 从「按 id 分栈」的记录表（代码块 / 数据源）中获取（或创建）对应的 UndoRedo 栈。
+*/
+var getOrCreateStack = (stacks, id) => {
+	if (!stacks[id]) stacks[id] = new UndoRedo();
+	return stacks[id];
+};
+/**
+* 撤销下限：当栈 index 0 是 `opType: 'initial'` 的基线 step 时为 1（基线不可被撤销），否则为 0。
+* 适用于所有历史类型（page / codeBlock / dataSource / 扩展），把 cursor 钉在基线之上，
+* 保证 undo / canUndo / goto 都不会越过初始基线。
+*/
+var undoFloor = (undoRedo) => {
+	return undoRedo.getElementList()[0]?.opType === "initial" ? 1 : 0;
+};
+/** 将单次 push 产生的 history uuid（或 null）转为 *AndGetHistoryId 返回用的 uuid 列表。 */
+var getLastPushedHistoryIds = (historyId) => historyId ? [historyId] : [];
+//#endregion
+export { createStackStep, describeRevertStep, deserializeStacks, detectStackOpType, detectTargetId, detectTargetName, getLastPushedHistoryIds, getOrCreateStack, markStackSaved, mergeSteps, serializeStacks, undoFloor };

package/dist/es/utils/indexed-db.js

@@ -0,0 +1,86 @@
+//#region packages/editor/src/utils/indexed-db.ts
+/**
+* 一组极简的、基于原生 IndexedDB 的 Promise KV 工具，避免引入额外依赖。
+* 仅用于浏览器环境；在不支持 IndexedDB 的环境（如 SSR / 部分测试环境）下会 reject。
+*/
+/** 是否处于支持 IndexedDB 的环境。 */
+var isIndexedDBSupported = () => typeof indexedDB !== "undefined" && indexedDB !== null;
+/**
+* 打开（必要时升级）数据库，确保目标 objectStore 存在后返回连接。
+*
+* 由于 objectStore 只能在 `onupgradeneeded` 内创建，这里先以当前版本打开，
+* 若发现 store 不存在则关闭连接、以更高版本重开来按需创建，兼容动态 storeName。
+*/
+var openIndexedDB = (dbName, storeName) => new Promise((resolve, reject) => {
+	if (!isIndexedDBSupported()) {
+		reject(/* @__PURE__ */ new Error("当前环境不支持 IndexedDB"));
+		return;
+	}
+	const request = indexedDB.open(dbName);
+	request.onupgradeneeded = () => {
+		const db = request.result;
+		if (!db.objectStoreNames.contains(storeName)) db.createObjectStore(storeName);
+	};
+	request.onerror = () => reject(request.error);
+	request.onsuccess = () => {
+		const db = request.result;
+		if (db.objectStoreNames.contains(storeName)) {
+			resolve(db);
+			return;
+		}
+		const nextVersion = db.version + 1;
+		db.close();
+		const upgradeRequest = indexedDB.open(dbName, nextVersion);
+		upgradeRequest.onupgradeneeded = () => {
+			const upgradeDb = upgradeRequest.result;
+			if (!upgradeDb.objectStoreNames.contains(storeName)) upgradeDb.createObjectStore(storeName);
+		};
+		upgradeRequest.onerror = () => reject(upgradeRequest.error);
+		upgradeRequest.onsuccess = () => resolve(upgradeRequest.result);
+	};
+});
+/** 写入（覆盖）一条记录。value 通过结构化克隆存储，支持 Map / Set 等结构。 */
+var idbSet = async (dbName, storeName, key, value) => {
+	const db = await openIndexedDB(dbName, storeName);
+	try {
+		await new Promise((resolve, reject) => {
+			const tx = db.transaction(storeName, "readwrite");
+			tx.objectStore(storeName).put(value, key);
+			tx.oncomplete = () => resolve();
+			tx.onabort = () => reject(tx.error);
+			tx.onerror = () => reject(tx.error);
+		});
+	} finally {
+		db.close();
+	}
+};
+/** 读取一条记录，不存在时返回 undefined。 */
+var idbGet = async (dbName, storeName, key) => {
+	const db = await openIndexedDB(dbName, storeName);
+	try {
+		return await new Promise((resolve, reject) => {
+			const request = db.transaction(storeName, "readonly").objectStore(storeName).get(key);
+			request.onsuccess = () => resolve(request.result);
+			request.onerror = () => reject(request.error);
+		});
+	} finally {
+		db.close();
+	}
+};
+/** 删除一条记录。 */
+var idbDelete = async (dbName, storeName, key) => {
+	const db = await openIndexedDB(dbName, storeName);
+	try {
+		await new Promise((resolve, reject) => {
+			const tx = db.transaction(storeName, "readwrite");
+			tx.objectStore(storeName).delete(key);
+			tx.oncomplete = () => resolve();
+			tx.onabort = () => reject(tx.error);
+			tx.onerror = () => reject(tx.error);
+		});
+	} finally {
+		db.close();
+	}
+};
+//#endregion
+export { idbDelete, idbGet, idbSet, isIndexedDBSupported, openIndexedDB };