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

package/dist/es/layouts/history-list/composables.js

@@ -1,53 +1,22 @@
-import { useServices } from "../../hooks/use-services.js";
-import { computed, reactive } from "vue";
+import { datetimeFormatter } from "@tmagic/form";
+import { tMagicMessageBox } from "@tmagic/design";
 //#region packages/editor/src/layouts/history-list/composables.ts
+/** 合并组默认展开；仅当 expanded[key] === false 时为收起。 */
+var isHistoryGroupExpanded = (expanded, key) => expanded[key] !== false;
 /**
-* 历史记录面板共享逻辑：
-* - 暴露三类历史的聚合数据（页面 / 数据源 / 代码块）；
-* - 提供折叠状态管理；
-* - 提供操作描述文案生成器。
-*
-* 所有数据基于 historyService 的 reactive state 派生，自动跟随历史变化刷新。
+* 历史面板的时间展示：
+* - 当天的记录只显示 `HH:mm:ss`；
+* - 跨天的记录显示 `MM-DD HH:mm:ss`。
+* 无时间戳（旧数据 / 未写入）时返回空串，UI 据此不渲染时间。
 */
-var useHistoryList = () => {
-	const { historyService } = useServices();
-	/** 折叠状态：key 形如 `pg-${groupIdx}` / `ds-${id}-${groupIdx}` / `cb-${id}-${groupIdx}`。 */
-	const expanded = reactive({});
-	const toggleGroup = (key) => {
-		expanded[key] = !expanded[key];
-	};
-	const pageGroups = computed(() => historyService.getPageHistoryGroups());
-	const dataSourceGroups = computed(() => historyService.getDataSourceHistoryGroups());
-	const codeBlockGroups = computed(() => historyService.getCodeBlockHistoryGroups());
-	/** 页面 tab 倒序展示（最新一组在最上面）。 */
-	const pageGroupsDisplay = computed(() => pageGroups.value.slice().reverse());
-	/**
-	* 把按时间正序的 group 列表，再按 id 聚拢成 bucket（同 id 的所有分组放一起）。
-	* 每个 bucket 内部仍然按时间倒序展示（最近的操作最先看到）。
-	*/
-	const groupByTarget = (groups) => {
-		const map = /* @__PURE__ */ new Map();
-		groups.forEach((g) => {
-			const list = map.get(g.id) ?? [];
-			list.push(g);
-			map.set(g.id, list);
-		});
-		return Array.from(map.entries()).map(([id, gs]) => ({
-			id,
-			groups: gs.slice().reverse()
-		}));
-	};
-	return {
-		expanded,
-		toggleGroup,
-		pageGroups,
-		dataSourceGroups,
-		codeBlockGroups,
-		pageGroupsDisplay,
-		dataSourceGroupsByTarget: computed(() => groupByTarget(dataSourceGroups.value)),
-		codeBlockGroupsByTarget: computed(() => groupByTarget(codeBlockGroups.value))
-	};
+var formatHistoryTime = (timestamp) => {
+	if (!timestamp) return "";
+	return `${datetimeFormatter(new Date(timestamp), "", "YYYY-MM-DD") === datetimeFormatter(/* @__PURE__ */ new Date(), "", "YYYY-MM-DD") ? datetimeFormatter(new Date(timestamp), "", "HH:mm:ss") : datetimeFormatter(new Date(timestamp), "", "MM-DD HH:mm:ss")}`;
 };
+/** 完整时间（含年份与秒），用于 title 悬浮提示。无时间戳时返回空串。 */
+var formatHistoryFullTime = (timestamp) => timestamp ? `${datetimeFormatter(new Date(timestamp), "", "YYYY-MM-DD HH:mm:ss")}` : "";
+/** 取一组历史步骤里最后一步（最近一次）的时间戳，用于组头部展示。 */
+var groupTimestamp = (group) => group.steps[group.steps.length - 1]?.step.timestamp;
 var opLabel = (op) => {
 	switch (op) {
 		case "add": return "新增";
@@ -55,6 +24,67 @@ var opLabel = (op) => {
 		default: return "修改";
 	}
 };
+/** 内置操作途径的中文文案；自定义来源直接回显原值，未知 / 缺省返回空串（UI 据此不渲染）。 */
+var HISTORY_SOURCE_LABELS = {
+	stage: "画布",
+	tree: "树面板",
+	"component-panel": "组件面板",
+	props: "配置面板",
+	code: "源码",
+	"root-code": "DSL源码",
+	"stage-contextmenu": "画布菜单",
+	"tree-contextmenu": "树菜单",
+	toolbar: "工具栏",
+	shortcut: "快捷键",
+	rollback: "回滚",
+	api: "接口",
+	ai: "AI",
+	initial: "初始值",
+	sync: "同步",
+	unknown: "未知"
+};
+/** 操作途径文案：用于历史面板展示「画布 / 树面板 / 配置面板…」标签。 */
+var sourceLabel = (source = "unknown") => {
+	return HISTORY_SOURCE_LABELS[source] ?? `${source}`;
+};
+/** 取一组历史步骤里最后一步（最近一次）的操作途径，用于组头部展示。 */
+var groupSource = (group) => group.steps[group.steps.length - 1]?.step.source;
+/** 取一组历史步骤里最后一步（最近一次）的操作人，用于组头部展示。 */
+var groupOperator = (group) => group.steps[group.steps.length - 1]?.step.operator;
+/**
+* 把一个历史分组（页面 / bucket）派生为 GroupRow 直接消费的视图模型 {@link HistoryRowGroup}。
+* 统一了原先 PageTab / Bucket 各自内联的 sub-steps 映射逻辑：描述、可差异、可回滚、时间、途径
+* 全部在此一次性算好，组件层只负责渲染。
+*/
+var toRowGroup = (group, key, descriptor) => {
+	const { describeGroup, describeStep, isStepDiffable, isStepRevertable } = descriptor;
+	const timestamp = groupTimestamp(group);
+	const lastStep = group.steps[group.steps.length - 1]?.step;
+	return {
+		key,
+		applied: group.applied,
+		isCurrent: Boolean(group.isCurrent),
+		opType: group.opType,
+		desc: describeGroup ? describeGroup(group) : describeStep(lastStep),
+		source: groupSource(group),
+		operator: groupOperator(group),
+		time: formatHistoryTime(timestamp),
+		timeTitle: formatHistoryFullTime(timestamp),
+		subSteps: group.steps.map((s) => ({
+			index: s.index,
+			applied: s.applied,
+			isCurrent: Boolean(s.isCurrent),
+			saved: s.step.saved,
+			desc: describeStep(s.step),
+			diffable: isStepDiffable ? isStepDiffable(s.step) : false,
+			revertable: s.applied && (isStepRevertable ? isStepRevertable(s.step) : true),
+			source: s.step.source,
+			operator: s.step.operator,
+			time: formatHistoryTime(s.step.timestamp),
+			timeTitle: formatHistoryFullTime(s.step.timestamp)
+		}))
+	};
+};
 var nameOf = (node) => node?.name || node?.type || `${node?.id ?? ""}`;
 /**
 * 默认描述里展示「名称 (id: xxx)」，便于区分同名实体。
@@ -70,28 +100,36 @@ var labelWithId = (label, id) => {
 var pickLastDescription = (descs) => {
 	for (let i = descs.length - 1; i >= 0; i--) if (descs[i]) return descs[i];
 };
-var describePageStep = (step) => {
+/**
+* 页面 / 数据源 / 代码块三类历史共用的单步描述核心。
+* 各类型只在「取展示名」与「实体单位名」上有差异，通过参数注入，文案模板完全一致：
+* - 新增 / 删除：单实体展示「label」，多实体（仅页面可能出现）退化为「N 个X」；
+* - 修改：展示「label · propPath」，无 diff 时兜底「X」，多实体退化为「N 个X」。
+* 操作类型（新增 / 删除 / 修改）已由列表行的 op 徽标单独展示，故描述文案不再重复动词。
+* 展示 id 统一取 schema.id；调用方显式传入的 historyDescription 永远优先。
+*/
+var describeStep = (step, getLabel, unit) => {
 	if (step.historyDescription) return step.historyDescription;
-	const { opType } = step;
-	if (opType === "add") {
-		const count = step.nodes?.length ?? 0;
-		const node = step.nodes?.[0];
-		return `新增 ${count} 个节点${count === 1 && node ? `（${labelWithId(nameOf(node), node.id)}）` : ""}`;
+	const items = step.diff ?? [];
+	const label = (schema) => labelWithId(getLabel(schema), schema?.id);
+	if (step.opType === "add") {
+		const node = items[0]?.newSchema;
+		return items.length === 1 && node ? label(node) : `${items.length} 个${unit}`;
 	}
-	if (opType === "remove") {
-		const count = step.removedItems?.length ?? 0;
-		const node = step.removedItems?.[0]?.node;
-		return `删除 ${count} 个节点${count === 1 && node ? `（${labelWithId(nameOf(node), node.id)}）` : ""}`;
+	if (step.opType === "remove") {
+		const node = items[0]?.oldSchema;
+		return items.length === 1 && node ? label(node) : `${items.length} 个${unit}`;
 	}
-	const updated = step.updatedItems ?? [];
-	if (!updated.length) return "修改节点";
-	if (updated.length === 1) {
-		const { newNode, changeRecords } = updated[0];
-		const propPath = changeRecords?.[0]?.propPath;
-		return `修改 ${labelWithId(nameOf(newNode), newNode?.id)}${propPath ? ` · ${propPath}` : ""}`;
+	if (!items.length) return unit;
+	if (items.length === 1) {
+		const { newSchema, oldSchema, changeRecords } = items[0];
+		const propPath = changeRecords?.map((changeRecord) => changeRecord.propPath).join(",");
+		const target = label(newSchema ?? oldSchema);
+		return propPath ? `${target} · ${propPath}` : target;
 	}
-	return `修改 ${updated.length} 个节点`;
+	return `${items.length} 个${unit}`;
 };
+var describePageStep = (step) => describeStep(step, (node) => nameOf(node), "节点");
 /**
 * 合并组的展示文案：
 * - 若组内任一步显式提供了 historyDescription：取最后一条非空 historyDescription（最近一次的描述更准确）；
@@ -102,53 +140,45 @@ var describePageGroup = (group) => {
 	const lastDesc = pickLastDescription(group.steps.map((s) => s.step.historyDescription));
 	if (lastDesc) return lastDesc;
 	if (group.steps.length === 1) return describePageStep(group.steps[0].step);
-	const paths = /* @__PURE__ */ new Set();
-	group.steps.forEach((s) => {
-		s.step.updatedItems?.[0]?.changeRecords?.forEach((r) => r.propPath && paths.add(r.propPath));
-	});
-	const pathList = Array.from(paths).slice(0, 3).join(", ");
-	const target = labelWithId(group.targetName ?? (group.targetId !== void 0 ? `${group.targetId}` : "节点"), group.targetId);
-	return pathList ? `修改 ${target} · ${pathList}${paths.size > 3 ? "…" : ""}` : `修改 ${target}`;
+	return labelWithId(group.targetName ?? (group.targetId !== void 0 ? `${group.targetId}` : "节点"), group.targetId);
 };
-var describeDataSourceStep = (step) => {
-	if (step.historyDescription) return step.historyDescription;
-	if (step.oldSchema === null && step.newSchema) return `创建 ${labelWithId(step.newSchema.title, step.newSchema.id ?? step.id)}`;
-	if (step.newSchema === null && step.oldSchema) return `删除 ${labelWithId(step.oldSchema.title, step.oldSchema.id ?? step.id)}`;
-	const propPath = step.changeRecords?.[0]?.propPath;
-	const title = labelWithId(step.newSchema?.title || step.oldSchema?.title, step.id);
-	return propPath ? `修改 ${title} · ${propPath}` : `修改 ${title}`;
-};
-var describeDataSourceGroup = (group) => {
-	const lastDesc = pickLastDescription(group.steps.map((s) => s.step.historyDescription));
-	if (lastDesc) return lastDesc;
-	if (group.steps.length === 1) return describeDataSourceStep(group.steps[0].step);
-	const paths = /* @__PURE__ */ new Set();
-	group.steps.forEach((s) => {
-		s.step.changeRecords?.forEach((r) => r.propPath && paths.add(r.propPath));
-	});
-	const pathList = Array.from(paths).slice(0, 3).join(", ");
-	const target = labelWithId(group.steps[group.steps.length - 1].step.newSchema?.title || group.steps[0].step.oldSchema?.title, group.id);
-	return pathList ? `修改 ${target} · ${pathList}${paths.size > 3 ? "…" : ""}` : `修改 ${target}`;
+/**
+* 页面 step 是否支持「回滚」（类 git revert）：
+* - 新增 / 删除：不依赖 changeRecords，反向应用即删除 / 加回，始终可回滚；
+* - 更新：必须每个被更新节点都带有 changeRecords，才支持按 propPath 局部反向 patch。
+*   缺失 changeRecords 的更新只能整节点替换，会冲掉该节点后续的无关变更，因此不支持回滚。
+*/
+var isPageStepRevertable = (step) => {
+	if (step.opType !== "update") return true;
+	const items = step.diff ?? [];
+	if (!items.length) return false;
+	return items.every((item) => Boolean(item.changeRecords?.length));
 };
-var describeCodeBlockStep = (step) => {
-	if (step.historyDescription) return step.historyDescription;
-	if (step.oldContent === null && step.newContent) return `创建 ${labelWithId(step.newContent.name, step.newContent.id ?? step.id)}`;
-	if (step.newContent === null && step.oldContent) return `删除 ${labelWithId(step.oldContent.name, step.oldContent.id ?? step.id)}`;
-	const propPath = step.changeRecords?.[0]?.propPath;
-	const title = labelWithId(step.newContent?.name || step.oldContent?.name, step.id);
-	return propPath ? `修改 ${title} · ${propPath}` : `修改 ${title}`;
+/**
+* 单 diff 项历史（数据源 / 代码块）是否支持「回滚」：
+* - 新增（无 oldSchema）/ 删除（无 newSchema）：不依赖 changeRecords，始终可回滚；
+* - 更新（前后内容都存在）：必须有 changeRecords 才支持局部反向 patch，否则不支持回滚。
+*/
+var isSingleDiffStepRevertable = (step) => {
+	const item = step.diff?.[0];
+	if (!item?.oldSchema || !item?.newSchema) return true;
+	return Boolean(item.changeRecords?.length);
 };
-var describeCodeBlockGroup = (group) => {
-	const lastDesc = pickLastDescription(group.steps.map((s) => s.step.historyDescription));
-	if (lastDesc) return lastDesc;
-	if (group.steps.length === 1) return describeCodeBlockStep(group.steps[0].step);
-	const paths = /* @__PURE__ */ new Set();
-	group.steps.forEach((s) => {
-		s.step.changeRecords?.forEach((r) => r.propPath && paths.add(r.propPath));
-	});
-	const pathList = Array.from(paths).slice(0, 3).join(", ");
-	const target = labelWithId(group.steps[group.steps.length - 1].step.newContent?.name || group.steps[0].step.oldContent?.name, group.id);
-	return pathList ? `修改 ${target} · ${pathList}${paths.size > 3 ? "…" : ""}` : `修改 ${target}`;
+/**
+* 通用二次确认弹窗：清空历史 / 无法差异对比的回滚等会改变状态的操作，先弹出确认框，
+* 用户点击「确定」返回 true，取消（confirm reject）时返回 false 并静默忽略。
+*/
+var confirmHistoryAction = async (message) => {
+	try {
+		await tMagicMessageBox.confirm(message, "提示", {
+			confirmButtonText: "确定",
+			cancelButtonText: "取消",
+			type: "warning"
+		});
+		return true;
+	} catch {
+		return false;
+	}
 };
 //#endregion
-export { describeCodeBlockGroup, describeCodeBlockStep, describeDataSourceGroup, describeDataSourceStep, describePageGroup, describePageStep, opLabel, useHistoryList };
+export { confirmHistoryAction, describePageGroup, describePageStep, describeStep, formatHistoryFullTime, formatHistoryTime, groupOperator, groupSource, groupTimestamp, isHistoryGroupExpanded, isPageStepRevertable, isSingleDiffStepRevertable, opLabel, sourceLabel, toRowGroup };

package/dist/es/layouts/history-list/useHistoryList.js

@@ -0,0 +1,56 @@
+import { useServices } from "../../hooks/use-services.js";
+import { computed, reactive } from "vue";
+//#region packages/editor/src/layouts/history-list/useHistoryList.ts
+/**
+* 历史记录面板共享逻辑：
+* - 暴露三类历史的聚合数据（页面 / 数据源 / 代码块）；
+* - 提供折叠状态管理；
+* - 提供操作描述文案生成器。
+*
+* 所有数据基于 historyService 的 reactive state 派生，自动跟随历史变化刷新。
+*/
+var useHistoryList = () => {
+	const { editorService, historyService } = useServices();
+	/**
+	* 折叠状态：key 形如 `pg-${组内首步 index}` / `ds-${id}-${组内首步 index}` / `cb-${id}-${组内首步 index}`。
+	* 用组内首步的稳定 index（而非展示位置）作为 key，确保历史数据更新后已展开的分组状态保持不变。
+	* 合并组默认展开；仅当值为 `false` 时表示收起。
+	*/
+	const expanded = reactive({});
+	const toggleGroup = (key) => {
+		expanded[key] = expanded[key] === false;
+	};
+	const pageGroups = computed(() => historyService.getHistoryGroups("page", editorService.get("page")?.id));
+	const dataSourceGroups = computed(() => historyService.getHistoryGroups("dataSource"));
+	const codeBlockGroups = computed(() => historyService.getHistoryGroups("codeBlock"));
+	/** 页面 tab 倒序展示（最新一组在最上面）。 */
+	const pageGroupsDisplay = computed(() => pageGroups.value.slice().reverse());
+	/**
+	* 把按时间正序的 group 列表，再按 id 聚拢成 bucket（同 id 的所有分组放一起）。
+	* 每个 bucket 内部仍然按时间倒序展示（最近的操作最先看到）。
+	*/
+	const groupByTarget = (groups) => {
+		const map = /* @__PURE__ */ new Map();
+		groups.forEach((g) => {
+			const list = map.get(g.id) ?? [];
+			list.push(g);
+			map.set(g.id, list);
+		});
+		return Array.from(map.entries()).map(([id, gs]) => ({
+			id,
+			groups: gs.slice().reverse()
+		}));
+	};
+	return {
+		expanded,
+		toggleGroup,
+		pageGroups,
+		dataSourceGroups,
+		codeBlockGroups,
+		pageGroupsDisplay,
+		dataSourceGroupsByTarget: computed(() => groupByTarget(dataSourceGroups.value)),
+		codeBlockGroupsByTarget: computed(() => groupByTarget(codeBlockGroups.value))
+	};
+};
+//#endregion
+export { useHistoryList };

package/dist/es/layouts/history-list/useHistoryRevert.js

@@ -0,0 +1,317 @@
+import { confirmHistoryAction } from "./composables.js";
+import { tMagicMessage } from "@tmagic/design";
+import { createApp, getCurrentInstance } from "vue";
+//#region packages/editor/src/layouts/history-list/useHistoryRevert.ts
+/**
+* 构造差异弹窗入参：仅 update（前后值都存在）可对比。
+* - 页面（无 id）：在全部分组中按 index 定位 step，目标 id 取自快照；
+* - 数据源 / 代码块（带 id）：先匹配分组 id 再按 index 定位。
+* 无可对比内容（多节点 / add / remove）或定位不到时返回 null。
+*/
+var buildDiffPayload = (source, index, id) => {
+	for (const group of source.groups()) {
+		if (id !== void 0 && group.id !== id) continue;
+		const step = group.steps.find((s) => s.index === index)?.step;
+		if (!step) continue;
+		const oldSchema = step.diff?.[0]?.oldSchema;
+		const newSchema = step.diff?.[0]?.newSchema;
+		if (!oldSchema || !newSchema) return null;
+		const targetId = id ?? newSchema.id ?? oldSchema.id;
+		const type = source.resolveType?.(newSchema, oldSchema);
+		return {
+			category: source.category,
+			...type !== void 0 ? { type } : {},
+			lastValue: oldSchema,
+			value: newSchema,
+			currentValue: (targetId !== void 0 ? source.getCurrent(targetId) : null) || null,
+			targetLabel: source.resolveLabel(newSchema, oldSchema, targetId),
+			id: targetId
+		};
+	}
+	return null;
+};
+/**
+* 按需动态 import 并挂载一个游离的 HistoryDiffDialog，返回其实例与清理函数。
+* 通过继承 appContext 复用全局组件 / 指令 / provide / 插件（Element Plus、@tmagic/form 字段组件等），
+* 弹窗组件动态 import，避免拖累其它消费者。供「确认回滚」与「查看差异」两种交互共用。
+*/
+var mountHistoryDiffDialog = async (options) => {
+	const { default: historyDiffDialog } = await import("./HistoryDiffDialog.js");
+	const container = document.createElement("div");
+	container.style.display = "none";
+	document.body.appendChild(container);
+	const app = createApp(historyDiffDialog, {
+		services: options.services,
+		isConfirm: options.isConfirm,
+		extendState: options.extendState,
+		loadConfig: options.loadConfig,
+		selfDiffFieldTypes: options.selfDiffFieldTypes,
+		compareFormState: options.compareFormState,
+		width: options.width,
+		size: options.size ?? options.services?.uiService?.get("propsPanelSize"),
+		onClose: options.onClose
+	});
+	if (options.appContext) Object.assign(app._context, options.appContext);
+	const instance = app.mount(container);
+	const destroy = () => {
+		setTimeout(() => {
+			try {
+				app.unmount();
+			} catch {}
+			container.parentNode?.removeChild(container);
+		}, 300);
+	};
+	return {
+		app,
+		instance,
+		destroy
+	};
+};
+/**
+* 动态挂载一个「确认回滚」模式的 HistoryDiffDialog，等待用户确认：
+* - 用户点「确定回滚」resolve(true)，取消 / 关闭 resolve(false)；
+* - 确认流程结束后自动卸载。
+*/
+var confirmRevertWithDiffDialog = async (payload, options) => {
+	const { instance, destroy } = await mountHistoryDiffDialog({
+		...options,
+		isConfirm: true
+	});
+	try {
+		return await instance.confirm(payload);
+	} finally {
+		destroy();
+	}
+};
+/**
+* 动态挂载一个「查看差异」模式（只读）的 HistoryDiffDialog 并打开：
+* 弹窗保持打开直到用户关闭，关闭（close 事件）后自动卸载并清理容器。
+*/
+var viewHistoryDiffDialog = async (payload, options) => {
+	const handle = {};
+	const { instance, destroy } = await mountHistoryDiffDialog({
+		...options,
+		isConfirm: false,
+		onClose: () => handle.destroy?.()
+	});
+	handle.destroy = destroy;
+	instance.open(payload);
+};
+/**
+* 历史记录「单步回滚」与「查看差异」的完整交互流程，供历史面板与业务方共用。
+*
+* 单步回滚（类 git revert）：
+* 1. 前置校验：目标数据已被删除（update 写回目标 / 页面 remove 的原父容器缺失）时给出「回滚失败」提示并中止；
+* 2. 二次确认：可差异对比的步骤（单实体 update）弹出差异确认弹窗，其余步骤弹普通二次确认框；
+* 3. 用户确认后执行对应 service 的 revert（页面 / 数据源 / 代码块）。
+*
+* 查看差异：可差异对比的步骤动态挂载只读 HistoryDiffDialog 展示前后值差异。
+*
+* 上述弹窗均按需动态挂载 HistoryDiffDialog 实现，业务方无需自行挂载任何弹窗。
+*
+* 返回的能力分三组：
+* - 内置三类（页面 / 数据源 / 代码块）：`onPageRevert` / `onDataSourceRevert` / `onCodeBlockRevert` 单步回滚，
+*   `onPageDiff` / `onDataSourceDiff` / `onCodeBlockDiff` 查看差异，及配套的 `buildXxxDiffPayload` / `isXxxRevertTargetMissing`；
+* - 业务自有历史（如管理台「模块」）：`confirmAndRevert` / `viewDiff` 复用同一套交互流程，由业务方自行构造差异入参；
+*   即上述内置三类本质上是它们各自预置好 payload 构造与 service.revert 的特例。
+*
+* 业务方可在拿到 Editor 实例暴露的 `services` 后直接 import 调用：
+*
+* ```ts
+* import { useHistoryRevert } from '@tmagic/editor';
+*
+* const { onPageRevert, onPageDiff } = useHistoryRevert({}, editorRef.value); // editorRef.value 即 Editor 暴露的 services
+* await onPageRevert(index); // 弹出差异 / 二次确认弹窗后回滚
+* onPageDiff(index); // 弹出只读差异弹窗查看前后值差异
+* ```
+*/
+var useHistoryRevert = (options = {}, services) => {
+	const appContext = options.appContext ?? getCurrentInstance()?.appContext ?? null;
+	const { extendState, getPropsPanelFormState, dialogWidth } = options;
+	/** 目标数据已被删除、无法回滚时的统一提示。 */
+	const showRevertTargetMissing = () => {
+		tMagicMessage.error("回滚失败：该记录对应的数据已被删除");
+	};
+	/**
+	* 「回滚」二次确认：新增 / 删除 / 多节点更新等无法做差异对比的步骤，
+	* 不弹差异弹窗，改用一个普通确认框替代「确定回滚」按钮，避免点击后无任何提示直接执行。
+	* 用户取消时返回 false，调用方据此中止回滚。
+	*/
+	const confirmRevert = () => confirmHistoryAction("确定回滚该步骤吗？回滚会将该操作作为一条新记录反向应用（新增将被删除、删除将被还原），不影响后续历史记录。");
+	/**
+	* 「回滚」统一确认入口：可差异对比的步骤动态挂载 HistoryDiffDialog 走差异确认弹窗，
+	* 无法对比的步骤（add / remove / 多节点更新）回退到普通二次确认框。
+	* `extra` 供业务自有历史（如模块）透传自定义表单配置加载等渲染入参。
+	*/
+	const runRevert = (payload, extra) => {
+		if (payload) return confirmRevertWithDiffDialog(payload, {
+			appContext,
+			extendState,
+			services,
+			...extra,
+			width: extra?.width ?? dialogWidth,
+			size: extra?.size
+		});
+		return confirmRevert();
+	};
+	const buildPageDiffPayload = (index) => buildDiffPayload({
+		category: "node",
+		groups: () => services?.historyService.getHistoryGroups("page", services?.editorService.get("page")?.id) ?? [],
+		getCurrent: (id) => services?.editorService.getNodeById(id),
+		resolveType: (n, o) => n.type || o.type || "",
+		resolveLabel: (n, o) => n.name || o.name || n.type || o.type || ""
+	}, index);
+	const buildDataSourceDiffPayload = (id, index) => buildDiffPayload({
+		category: "data-source",
+		groups: () => services?.historyService.getHistoryGroups("dataSource") ?? [],
+		getCurrent: (id) => services?.dataSourceService.getDataSourceById(`${id}`),
+		resolveType: (n, o) => n.type || o.type || "base",
+		resolveLabel: (n, o, id) => n.title || o.title || `${id}`
+	}, index, id);
+	const buildCodeBlockDiffPayload = (id, index) => buildDiffPayload({
+		category: "code-block",
+		groups: () => services?.historyService.getHistoryGroups("codeBlock") ?? [],
+		getCurrent: (id) => services?.codeBlockService.getCodeContentById(id),
+		resolveLabel: (n, o, id) => n.name || o.name || `${id}`
+	}, index, id);
+	/**
+	* 回滚前置校验：若该历史步骤回滚所依赖的目标数据已被删除，则无法回滚。
+	* - update（把旧值写回）：被修改的目标必须仍存在；
+	* - 页面 remove（还原被删节点）：被删节点的原父容器必须仍存在，否则无处插回；
+	* add（回滚即删除）即使目标已不在，也已达成「删除」目的，不视为失败。
+	*/
+	const isPageRevertTargetMissing = (index) => {
+		const step = services?.historyService.getStepList("page", services?.editorService.get("page")?.id)[index]?.step;
+		if (!step) return false;
+		if (step.opType === "update") return (step.diff ?? []).some((item) => {
+			const id = item.newSchema?.id ?? item.oldSchema?.id;
+			return id !== void 0 && !services?.editorService.getNodeById(id, false);
+		});
+		if (step.opType === "remove") return (step.diff ?? []).some((item) => item.parentId !== void 0 && !services?.editorService.getNodeById(item.parentId, false));
+		return false;
+	};
+	/** 数据源 update 步骤回滚时，对应数据源必须仍存在（已删除则无处写回旧值）。 */
+	const isDataSourceRevertTargetMissing = (id, index) => {
+		const step = services?.historyService.getStepList("dataSource", id)[index]?.step;
+		return Boolean(step?.opType === "update" && !services?.dataSourceService.getDataSourceById(`${id}`));
+	};
+	/** 代码块 update 步骤回滚时，对应代码块必须仍存在（已删除则无处写回旧值）。 */
+	const isCodeBlockRevertTargetMissing = (id, index) => {
+		const step = services?.historyService.getStepList("codeBlock", id)[index]?.step;
+		return Boolean(step?.opType === "update" && !services?.codeBlockService.getCodeContentById(id));
+	};
+	const onPageRevert = (index) => {
+		if (isPageRevertTargetMissing(index)) {
+			showRevertTargetMissing();
+			return Promise.resolve(null);
+		}
+		return runRevert(buildPageDiffPayload(index), { compareFormState: getPropsPanelFormState?.() }).then((result) => result ? services?.editorService.revertPageStep(index) : null);
+	};
+	const onDataSourceRevert = (id, index) => {
+		if (isDataSourceRevertTargetMissing(id, index)) {
+			showRevertTargetMissing();
+			return Promise.resolve(null);
+		}
+		return runRevert(buildDataSourceDiffPayload(id, index)).then((result) => result ? services?.dataSourceService.revert(id, index) : null);
+	};
+	const onCodeBlockRevert = (id, index) => {
+		if (isCodeBlockRevertTargetMissing(id, index)) {
+			showRevertTargetMissing();
+			return Promise.resolve(null);
+		}
+		return runRevert(buildCodeBlockDiffPayload(id, index)).then((result) => result ? services?.codeBlockService.revert(id, index) : null);
+	};
+	/**
+	* 「查看差异」：可差异对比的步骤（单实体 update）动态挂载只读 HistoryDiffDialog 展示前后值差异，
+	* 无可对比内容（add / remove / 多节点更新）时不弹窗、静默返回。
+	*/
+	const onPageDiff = (index) => {
+		const payload = buildPageDiffPayload(index);
+		if (payload) return viewHistoryDiffDialog(payload, {
+			appContext,
+			extendState,
+			services,
+			width: dialogWidth,
+			compareFormState: getPropsPanelFormState?.()
+		});
+	};
+	const onDataSourceDiff = (id, index) => {
+		const payload = buildDataSourceDiffPayload(id, index);
+		if (payload) return viewHistoryDiffDialog(payload, {
+			appContext,
+			extendState,
+			services,
+			width: dialogWidth
+		});
+	};
+	const onCodeBlockDiff = (id, index) => {
+		const payload = buildCodeBlockDiffPayload(id, index);
+		if (payload) return viewHistoryDiffDialog(payload, {
+			appContext,
+			extendState,
+			services,
+			width: dialogWidth
+		});
+	};
+	/**
+	* 业务自有历史（如管理台「模块」）的「单步回滚」统一入口：
+	* 复用与页面/数据源/代码块一致的「目标校验 → 差异/二次确认弹窗 → 反向回滚」流程，
+	* 内置三类只是它的特例（各自预置了 buildXxxDiffPayload + service.revert）。
+	*
+	* 用户取消或前置校验未过时返回 null，确认并执行回滚后返回 `revert()` 的结果。
+	*
+	* ```ts
+	* await confirmAndRevert({
+	*   diffPayload: oldSchema && newSchema ? { category: 'module', lastValue: oldSchema, value: newSchema, ... } : null,
+	*   loadConfig: (ctx) => loadModFormConfig(modTypeId, values),
+	*   selfDiffFieldTypes: ['mod-cond'],
+	*   revert: () => moduleHistoryStore.revert(id, index),
+	* });
+	* ```
+	*/
+	const confirmAndRevert = async (revertOptions) => {
+		if (revertOptions.isTargetMissing?.()) {
+			showRevertTargetMissing();
+			return null;
+		}
+		if (!await runRevert(revertOptions.diffPayload ?? null, {
+			loadConfig: revertOptions.loadConfig,
+			selfDiffFieldTypes: revertOptions.selfDiffFieldTypes,
+			width: revertOptions.width,
+			size: revertOptions.size
+		})) return null;
+		return await revertOptions.revert();
+	};
+	/**
+	* 业务自有历史的「查看差异」统一入口：传入自行构造的差异入参即弹出只读差异弹窗，
+	* 可透传 `loadConfig` / `selfDiffFieldTypes`。payload 为 null（不可对比）时静默返回。
+	*/
+	const viewDiff = (payload, extra) => {
+		if (payload) return viewHistoryDiffDialog(payload, {
+			appContext,
+			extendState,
+			services,
+			...extra,
+			width: extra?.width ?? dialogWidth,
+			size: extra?.size
+		});
+	};
+	return {
+		onPageRevert,
+		onDataSourceRevert,
+		onCodeBlockRevert,
+		onPageDiff,
+		onDataSourceDiff,
+		onCodeBlockDiff,
+		buildPageDiffPayload,
+		buildDataSourceDiffPayload,
+		buildCodeBlockDiffPayload,
+		isPageRevertTargetMissing,
+		isDataSourceRevertTargetMissing,
+		isCodeBlockRevertTargetMissing,
+		confirmAndRevert,
+		viewDiff
+	};
+};
+//#endregion
+export { useHistoryRevert };

package/dist/es/layouts/page-bar/AddButton.vue_vue_type_script_setup_true_lang.js

@@ -16,7 +16,7 @@ var _hoisted_2 = {
 	key: 1,
 	style: { "width": "21px" }
 };
-var AddButton_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+var AddButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
 	name: "MEditorPageBarAddButton",
 	__name: "AddButton",
 	setup(__props) {