@tmagic/editor 1.8.0-beta.4 → 1.8.0-beta.6

package/dist/es/style.css

@@ -617,6 +617,23 @@ fieldset.m-fieldset .m-form-tip {
   padding: 0;
   list-style: none;
 }
+.m-editor-history-list-popover .m-editor-history-list-toolbar {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  padding: 0 4px 4px;
+}
+.m-editor-history-list-popover .m-editor-history-list-clear {
+  padding: 2px 8px;
+  border-radius: 4px;
+  font-size: 12px;
+  color: #f56c6c;
+  cursor: pointer;
+  user-select: none;
+}
+.m-editor-history-list-popover .m-editor-history-list-clear:hover {
+  background-color: rgba(245, 108, 108, 0.12);
+}
 .m-editor-history-list-popover .m-editor-history-list-item {
   display: flex;
   align-items: center;
@@ -750,12 +767,18 @@ fieldset.m-fieldset .m-form-tip {
 }
 .m-editor-history-list-popover .m-editor-history-list-item-index {
   flex: 0 0 auto;
+  min-width: 30px;
+  text-align: right;
   color: #909399;
   font-family: Menlo, Monaco, Consolas, "Courier New", monospace;
   font-size: 11px;
   font-weight: 400;
   white-space: nowrap;
 }
+.m-editor-history-list-popover .m-editor-history-list-group.is-merged > .m-editor-history-list-group-head > .m-editor-history-list-item-index {
+  min-width: 0;
+  text-align: left;
+}
 .m-editor-history-list-popover .m-editor-history-list-item-time {
   flex: 0 0 auto;
   color: #a8abb2;
@@ -816,6 +839,18 @@ fieldset.m-fieldset .m-form-tip {
   white-space: nowrap;
   font-weight: 400;
 }
+.m-editor-history-list-popover .m-editor-history-list-item-saved {
+  flex: 0 0 auto;
+  padding: 0 6px;
+  border-radius: 8px;
+  font-size: 10px;
+  line-height: 16px;
+  color: #fff;
+  background-color: #67c23a;
+  white-space: nowrap;
+  font-weight: 500;
+  letter-spacing: 0.2px;
+}
 .m-editor-history-list-popover .m-editor-history-list-item-merge {
   flex: 0 0 auto;
   padding: 0 8px;
@@ -827,6 +862,17 @@ fieldset.m-fieldset .m-form-tip {
   font-weight: 500;
   letter-spacing: 0.2px;
 }
+.m-editor-history-list-popover .m-editor-history-list-item-actions {
+  display: none;
+  flex: 0 0 auto;
+  align-items: center;
+  gap: 6px;
+}
+.m-editor-history-list-popover .m-editor-history-list-group-head:hover > .m-editor-history-list-item-actions,
+.m-editor-history-list-popover .m-editor-history-list-substeps > li:hover > .m-editor-history-list-item-actions,
+.m-editor-history-list-popover .m-editor-history-list-initial:hover > .m-editor-history-list-item-actions {
+  display: flex;
+}
 .m-editor-history-list-popover .m-editor-history-list-item-diff {
   flex: 0 0 auto;
   padding: 0 6px;
@@ -847,13 +893,13 @@ fieldset.m-fieldset .m-form-tip {
   border-radius: 2px;
   font-size: 10px;
   line-height: 16px;
-  color: #606266;
-  background-color: rgba(96, 98, 102, 0.1);
+  color: #529b2e;
+  background-color: rgba(103, 194, 58, 0.12);
   cursor: pointer;
   user-select: none;
 }
 .m-editor-history-list-popover .m-editor-history-list-item-goto:hover {
-  background-color: rgba(96, 98, 102, 0.18);
+  background-color: rgba(103, 194, 58, 0.24);
 }
 .m-editor-history-list-popover .m-editor-history-list-item-revert {
   flex: 0 0 auto;
@@ -1396,9 +1442,6 @@ fieldset.m-fieldset .m-form-tip {
   transition: all 0.2s ease 0s;
   padding: 5px 14px;
 }
-.page-bar-popover .menu-item .tmagic-design-button {
-  color: #313a40;
-}
 .page-bar-popover .menu-item:hover {
   background-color: #f3f5f9;
 }
@@ -2050,9 +2093,12 @@ fieldset.m-fieldset .m-form-tip {
 .border-box-container .border-icon-container .border-icon + .border-icon {
   margin-left: 8px;
 }
+.border-box-container .border-icon-container .border-icon.configured {
+  border-color: var(--el-color-success, var(--td-success-color, #2ba471));
+}
 .border-box-container .border-icon-container .border-icon.active {
   border-width: 1px;
-  border-color: var(--el-color-primary);
+  border-color: var(--el-color-primary, var(--td-brand-color, #0052d9));
 }
 .border-box-container .border-icon-container .border-icon.border-icon-top {
   border-top-width: 2px;

package/dist/es/utils/data-source/index.js

@@ -7,6 +7,7 @@ var dataSourceFormConfig = {
 	items: [
 		{
 			title: "数据定义",
+			status: "fields",
 			items: [{
 				name: "fields",
 				type: "data-source-fields",
@@ -15,6 +16,7 @@ var dataSourceFormConfig = {
 		},
 		{
 			title: "方法定义",
+			status: "methods",
 			items: [{
 				name: "methods",
 				type: "data-source-methods",

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 ("left" in baseStyle && !("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/history.js

@@ -0,0 +1,232 @@
+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 由各公共方法（pushCodeBlock / pushDataSource）自行处理。
+* - 不直接驱动业务 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);
+	return {
+		uuid: guid(),
+		id,
+		opType,
+		diff: [{
+			...newSchema !== null ? { newSchema } : {},
+			...oldSchema !== null ? { oldSchema } : {},
+			...opType === "update" && changeRecords ? { changeRecords } : {}
+		}],
+		historyDescription: payload.historyDescription,
+		source: payload.source,
+		timestamp: Date.now()
+	};
+};
+var markStackSaved = (undoRedo) => {
+	if (!undoRedo) return;
+	undoRedo.updateElements((element) => {
+		element.saved = false;
+	});
+	undoRedo.updateCurrentElement((element) => {
+		element.saved = true;
+	});
+};
+/**
+* 把单个「按 id 分栈」的历史栈（代码块 / 数据源）拆成若干 group：
+* 每条操作记录独立成组，不做相邻 update 合并（与页面历史的合并策略不同）。
+*
+* 代码块与数据源除 `kind` 外结构完全一致，统一由本方法处理；`kind` 决定返回的具体分组类型。
+*/
+var mergeStackSteps = (kind, id, list, cursor) => {
+	const currentIndex = cursor - 1;
+	return list.map((step, index) => {
+		const applied = index < cursor;
+		const isCurrent = index === currentIndex;
+		return {
+			kind,
+			id,
+			opType: step.opType,
+			steps: [{
+				step,
+				index,
+				applied,
+				isCurrent
+			}],
+			applied,
+			isCurrent
+		};
+	});
+};
+/**
+* 把页面栈拆成若干 group：
+* - 单节点的 'update' 按 targetId 与相邻同 targetId 的 update 合并到一个 group；
+* - 'add' / 'remove' 始终独立成组（语义上是结构变更，不应被收纳进单节点修改组）；
+* - 多节点 'update'（如批量改属性）也独立成组（无明确单一目标，避免误合并）。
+*/
+var mergePageSteps = (pageId, 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 = detectPageTargetId(step);
+		const targetName = detectPageTargetName(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: "page",
+				pageId,
+				opType: step.opType,
+				targetId: mergeable ? targetId : void 0,
+				targetName,
+				steps: [entry],
+				applied,
+				isCurrent
+			};
+			groups.push(current);
+		}
+	});
+	return groups;
+};
+/**
+* 解析 StepValue 中的"目标节点 id"用于合并：
+* - 单节点 update：取唯一一项 updatedItems 的节点 id；
+* - 其它情形（多节点 update / add / remove）：返回 undefined，表示不参与合并。
+*/
+var detectPageTargetId = (step) => {
+	if (step.opType !== "update") return void 0;
+	const items = step.diff;
+	if (items?.length !== 1) return void 0;
+	return items[0].newSchema?.id ?? items[0].oldSchema?.id;
+};
+/** 解析 StepValue 中的目标节点可读名（用于 UI 展示）。 */
+var detectPageTargetName = (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。
+* 用于把 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, detectPageTargetId, detectPageTargetName, detectStackOpType, getLastPushedHistoryIds, getOrCreateStack, markStackSaved, mergePageSteps, mergeStackSteps, 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 };