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

package/dist/es/services/codeBlock.js

@@ -1,7 +1,8 @@
 import { CODE_DRAFT_STORAGE_KEY } from "../type.js";
+import { getEditorConfig } from "../utils/config.js";
 import BaseService from "./BaseService.js";
+import { createStackStep, describeRevertStep, getLastPushedHistoryIds } from "../utils/history.js";
 import history_default from "./history.js";
-import { getEditorConfig } from "../utils/config.js";
 import storage_default, { Protocol } from "./storage.js";
 import { COPY_CODE_STORAGE_KEY } from "../utils/editor.js";
 import editor_default from "./editor.js";
@@ -20,17 +21,6 @@ var canUsePluginMethods = {
 	],
 	sync: ["setCodeDslByIdSync"]
 };
-/**
-* 「回滚」生成的新 step 简短描述。仅 service 层使用。
-*/
-var describeRevertCodeBlockStep = (step) => {
-	const { oldContent, newContent, changeRecords, id } = step;
-	if (oldContent === null && newContent) return `撤回新增 ${newContent.name || newContent.id || id}`;
-	if (oldContent && newContent === null) return `还原已删除的 ${oldContent.name || oldContent.id || id}`;
-	const name = newContent?.name || oldContent?.name || `${id}`;
-	const propPath = changeRecords?.[0]?.propPath;
-	return propPath ? `还原 ${name} · ${propPath}` : `还原 ${name}`;
-};
 var CodeBlock = class extends BaseService {
 	state = reactive({
 		codeDsl: null,
@@ -39,6 +29,16 @@ var CodeBlock = class extends BaseService {
 		undeletableList: [],
 		paramsColConfig: void 0
 	});
+	/**
+	* 最近一次写入历史栈的代码块历史记录 uuid（单条写入场景：新增 / 更新）。
+	* 供 setCodeDslById(Sync)AndGetHistoryId 取回，普通方法不读取它。
+	*/
+	lastPushedHistoryId = null;
+	/**
+	* deleteCodeDslByIds 一次删除多个代码块时，按写入顺序收集的历史记录 uuid 列表。
+	* 在 deleteCodeDslByIds 入口处重置，供 deleteCodeDslByIdsAndGetHistoryId 取回。
+	*/
+	lastDeletedHistoryIds = [];
 	constructor() {
 		super([...canUsePluginMethods.async.map((methodName) => ({
 			name: methodName,
@@ -56,6 +56,7 @@ var CodeBlock = class extends BaseService {
 	async setCodeDsl(codeDsl) {
 		this.state.codeDsl = codeDsl;
 		this.emit("code-dsl-change", this.state.codeDsl);
+		this.emit("change", this.state.codeDsl);
 	}
 	/**
 	* 获取活动的代码块dsl数据源（默认从dsl中的codeBlocks字段读取）
@@ -86,10 +87,12 @@ var CodeBlock = class extends BaseService {
 	* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 	* @returns {void}
 	*/
-	async setCodeDslById(id, codeConfig, { changeRecords, doNotPushHistory = false } = {}) {
+	async setCodeDslById(id, codeConfig, { changeRecords, doNotPushHistory = false, historyDescription, historySource } = {}) {
 		this.setCodeDslByIdSync(id, codeConfig, true, {
 			changeRecords,
-			doNotPushHistory
+			doNotPushHistory,
+			historyDescription,
+			historySource
 		});
 	}
 	/**
@@ -104,7 +107,7 @@ var CodeBlock = class extends BaseService {
 	* @param options.historyDescription 入栈时附带的人类可读描述，用于历史面板展示
 	* @returns {void}
 	*/
-	setCodeDslByIdSync(id, codeConfig, force = true, { changeRecords, doNotPushHistory = false, historyDescription } = {}) {
+	setCodeDslByIdSync(id, codeConfig, force = true, { changeRecords, doNotPushHistory = false, historyDescription, historySource } = {}) {
 		const codeDsl = this.getCodeDsl();
 		if (!codeDsl) throw new Error("dsl中没有codeBlocks");
 		if (codeDsl[id] && !force) return;
@@ -119,13 +122,18 @@ var CodeBlock = class extends BaseService {
 			...codeConfigProcessed
 		};
 		const newContent = cloneDeep$1(codeDsl[id]);
-		if (!doNotPushHistory) history_default.pushCodeBlock(id, {
-			oldContent,
-			newContent,
-			changeRecords,
-			historyDescription
-		});
+		if (!doNotPushHistory) {
+			const step = createStackStep(id, {
+				oldValue: oldContent,
+				newValue: newContent,
+				changeRecords,
+				historyDescription,
+				source: historySource
+			});
+			this.lastPushedHistoryId = (step ? history_default.push("codeBlock", step, id) : null)?.uuid ?? null;
+		}
 		this.emit("addOrUpdate", id, codeDsl[id]);
+		this.emit("change", this.getCodeDsl());
 	}
 	/**
 	* 根据代码块id数组获取代码dsl
@@ -204,19 +212,63 @@ var CodeBlock = class extends BaseService {
 	* @param options 可选配置
 	* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 	*/
-	async deleteCodeDslByIds(codeIds, { doNotPushHistory = false, historyDescription } = {}) {
+	async deleteCodeDslByIds(codeIds, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 		const currentDsl = await this.getCodeDsl();
 		if (!currentDsl) return;
+		this.lastDeletedHistoryIds = [];
 		codeIds.forEach((id) => {
-			const oldContent = currentDsl[id] ? cloneDeep$1(currentDsl[id]) : null;
+			const oldValue = currentDsl[id] ? cloneDeep$1(currentDsl[id]) : null;
 			delete currentDsl[id];
-			if (oldContent && !doNotPushHistory) history_default.pushCodeBlock(id, {
-				oldContent,
-				newContent: null,
-				historyDescription
-			});
+			if (oldValue && !doNotPushHistory) {
+				const step = createStackStep(id, {
+					oldValue,
+					newValue: null,
+					historyDescription,
+					source: historySource
+				});
+				const uuid = step ? history_default.push("codeBlock", step, id)?.uuid : void 0;
+				if (uuid) this.lastDeletedHistoryIds.push(uuid);
+			}
 			this.emit("remove", id);
 		});
+		this.emit("change", this.getCodeDsl());
+	}
+	/**
+	* 下列 *AndGetHistoryId 方法与对应的写入方法行为完全一致，
+	* 返回值在 {@link DslOpWithHistoryIdsResult} 中同时包含原操作结果与本次写入的历史 uuid 列表，
+	* 可用于精确引用 / 定位该条历史记录（埋点、revert、跨端同步等）。
+	*
+	* 当本次操作未写入历史（doNotPushHistory 为 true、或无对应记录）时 historyIds 为 `[]`。
+	*/
+	/** 等价于 {@link setCodeDslById}，并额外返回本次写入历史记录的 uuid 列表（未入栈时 historyIds 为 `[]`）。 */
+	async setCodeDslByIdAndGetHistoryId(id, codeConfig, options = {}) {
+		this.lastPushedHistoryId = null;
+		await this.setCodeDslById(id, codeConfig, options);
+		return {
+			result: void 0,
+			historyIds: getLastPushedHistoryIds(this.lastPushedHistoryId)
+		};
+	}
+	/** 等价于 {@link setCodeDslByIdSync}，并额外返回本次写入历史记录的 uuid 列表（未入栈时 historyIds 为 `[]`）。 */
+	setCodeDslByIdSyncAndGetHistoryId(id, codeConfig, force = true, options = {}) {
+		this.lastPushedHistoryId = null;
+		this.setCodeDslByIdSync(id, codeConfig, force, options);
+		return {
+			result: void 0,
+			historyIds: getLastPushedHistoryIds(this.lastPushedHistoryId)
+		};
+	}
+	/**
+	* 等价于 {@link deleteCodeDslByIds}，并额外返回本次写入的全部历史记录 uuid（按删除顺序）。
+	* 一次删除多个代码块会产生多条历史记录；未写入任何历史时 historyIds 为 `[]`。
+	*/
+	async deleteCodeDslByIdsAndGetHistoryId(codeIds, options = {}) {
+		this.lastDeletedHistoryIds = [];
+		await this.deleteCodeDslByIds(codeIds, options);
+		return {
+			result: void 0,
+			historyIds: [...this.lastDeletedHistoryIds]
+		};
 	}
 	setParamsColConfig(config) {
 		this.state.paramsColConfig = config;
@@ -236,7 +288,7 @@ var CodeBlock = class extends BaseService {
 	* @returns 撤销的 step；栈不存在或已无可撤销时返回 null
 	*/
 	async undo(id) {
-		const step = history_default.undoCodeBlock(id);
+		const step = history_default.undo("codeBlock", id);
 		if (!step) return null;
 		await this.applyHistoryStep(step, true);
 		return step;
@@ -247,18 +299,18 @@ var CodeBlock = class extends BaseService {
 	* @returns 重做的 step；栈不存在或已无可重做时返回 null
 	*/
 	async redo(id) {
-		const step = history_default.redoCodeBlock(id);
+		const step = history_default.redo("codeBlock", id);
 		if (!step) return null;
 		await this.applyHistoryStep(step, false);
 		return step;
 	}
 	/** 是否可对指定代码块撤销。 */
 	canUndo(id) {
-		return history_default.canUndoCodeBlock(id);
+		return history_default.canUndo("codeBlock", id);
 	}
 	/** 是否可对指定代码块重做。 */
 	canRedo(id) {
-		return history_default.canRedoCodeBlock(id);
+		return history_default.canRedo("codeBlock", id);
 	}
 	/**
 	* 跳转指定代码块的历史栈到目标游标。语义同 editor.gotoPageStep。
@@ -268,7 +320,7 @@ var CodeBlock = class extends BaseService {
 	* @returns 实际移动到的最终游标位置
 	*/
 	async goto(id, targetCursor) {
-		let cursor = history_default.getCodeBlockCursor(id);
+		let cursor = history_default.getCursor("codeBlock", id);
 		const target = Math.max(0, targetCursor);
 		while (cursor > target) {
 			if (!await this.undo(id)) break;
@@ -291,12 +343,29 @@ var CodeBlock = class extends BaseService {
 	* @returns 反向后产生的新 step；目标不存在 / 未应用时返回 null
 	*/
 	async revert(id, index) {
-		const entry = history_default.getCodeBlockStepList(id)[index];
+		const entry = history_default.getStepList("codeBlock", id)[index];
 		if (!entry?.applied) return null;
-		const description = `回滚 #${index + 1}: ${describeRevertCodeBlockStep(entry.step)}`;
+		const { oldSchema, newSchema, changeRecords } = entry.step.diff?.[0] ?? {};
+		if (oldSchema && newSchema && !changeRecords?.length) return null;
+		const description = `回滚 #${index + 1}: ${describeRevertStep(entry.step.data.id, entry.step.diff?.[0], (s) => s.name)}`;
 		return await this.applyRevertStep(entry.step, description);
 	}
 	/**
+	* 通过历史记录 uuid 回滚代码块历史步骤，语义同 {@link revert}，
+	* 仅无需调用方再传 codeBlockId 与 index：内部会按 uuid 在全部代码块栈中定位对应步骤后再回滚。
+	* 按数组顺序依次回滚，返回与入参同序的结果列表（某项失败时为 `null`）。
+	*
+	* @param uuids 目标历史记录的 uuid 列表，通常由 {@link setCodeDslByIdAndGetHistoryId} 等方法返回的 `historyIds`
+	*/
+	async revertById(uuids) {
+		const results = [];
+		for (const uuid of uuids) {
+			const location = history_default.findStepLocationByUuid("codeBlock", uuid);
+			results.push(location ? await this.revert(location.id, location.index) : null);
+		}
+		return results;
+	}
+	/**
 	* 生成代码块唯一id
 	* @returns {Id} 代码块唯一id
 	*/
@@ -361,16 +430,23 @@ var CodeBlock = class extends BaseService {
 	* 差异仅在于通过公开的 setCodeDslByIdSync / deleteCodeDslByIds 触发 push。
 	*/
 	async applyRevertStep(step, historyDescription) {
-		const { id, oldContent, newContent, changeRecords } = step;
-		if (oldContent === null && newContent) {
-			await this.deleteCodeDslByIds([id], { historyDescription });
-			return history_default.getCodeBlockStepList(id).slice(-1)[0]?.step ?? null;
+		const { id } = step.data;
+		const { oldSchema, newSchema, changeRecords } = step.diff?.[0] ?? {};
+		if (!oldSchema && newSchema) {
+			await this.deleteCodeDslByIds([id], {
+				historyDescription,
+				historySource: "rollback"
+			});
+			return history_default.getStepList("codeBlock", id).slice(-1)[0]?.step ?? null;
 		}
-		if (oldContent && newContent === null) {
-			this.setCodeDslByIdSync(id, cloneDeep$1(oldContent), true, { historyDescription });
-			return history_default.getCodeBlockStepList(id).slice(-1)[0]?.step ?? null;
+		if (oldSchema && !newSchema) {
+			this.setCodeDslByIdSync(id, cloneDeep$1(oldSchema), true, {
+				historyDescription,
+				historySource: "rollback"
+			});
+			return history_default.getStepList("codeBlock", id).slice(-1)[0]?.step ?? null;
 		}
-		if (!oldContent || !newContent) return null;
+		if (!oldSchema || !newSchema) return null;
 		if (changeRecords?.length) {
 			const current = this.getCodeContentById(id);
 			if (!current) return null;
@@ -381,17 +457,21 @@ var CodeBlock = class extends BaseService {
 					fallbackToFullReplace = true;
 					break;
 				}
-				const value = cloneDeep$1(getValueByKeyPath(record.propPath, oldContent));
+				const value = cloneDeep$1(getValueByKeyPath(record.propPath, oldSchema));
 				setValueByKeyPath(record.propPath, value, patched);
 			}
-			this.setCodeDslByIdSync(id, fallbackToFullReplace ? cloneDeep$1(oldContent) : patched, true, {
+			this.setCodeDslByIdSync(id, fallbackToFullReplace ? cloneDeep$1(oldSchema) : patched, true, {
 				changeRecords,
-				historyDescription
+				historyDescription,
+				historySource: "rollback"
 			});
-			return history_default.getCodeBlockStepList(id).slice(-1)[0]?.step ?? null;
+			return history_default.getStepList("codeBlock", id).slice(-1)[0]?.step ?? null;
 		}
-		this.setCodeDslByIdSync(id, cloneDeep$1(oldContent), true, { historyDescription });
-		return history_default.getCodeBlockStepList(id).slice(-1)[0]?.step ?? null;
+		this.setCodeDslByIdSync(id, cloneDeep$1(oldSchema), true, {
+			historyDescription,
+			historySource: "rollback"
+		});
+		return history_default.getStepList("codeBlock", id).slice(-1)[0]?.step ?? null;
 	}
 	/**
 	* 把一条历史 step 应用到当前代码块服务上。
@@ -408,19 +488,20 @@ var CodeBlock = class extends BaseService {
 	* @param reverse true=撤销，false=重做
 	*/
 	async applyHistoryStep(step, reverse) {
-		const { id, oldContent, newContent, changeRecords } = step;
-		if (oldContent === null && newContent) {
+		const { id } = step.data;
+		const { oldSchema, newSchema, changeRecords } = step.diff?.[0] ?? {};
+		if (!oldSchema && newSchema) {
 			if (reverse) await this.deleteCodeDslByIds([id], { doNotPushHistory: true });
-			else this.setCodeDslByIdSync(id, cloneDeep$1(newContent), true, { doNotPushHistory: true });
+			else this.setCodeDslByIdSync(id, cloneDeep$1(newSchema), true, { doNotPushHistory: true });
 			return;
 		}
-		if (oldContent && newContent === null) {
-			if (reverse) this.setCodeDslByIdSync(id, cloneDeep$1(oldContent), true, { doNotPushHistory: true });
+		if (oldSchema && !newSchema) {
+			if (reverse) this.setCodeDslByIdSync(id, cloneDeep$1(oldSchema), true, { doNotPushHistory: true });
 			else await this.deleteCodeDslByIds([id], { doNotPushHistory: true });
 			return;
 		}
-		if (!oldContent || !newContent) return;
-		const sourceForValues = reverse ? oldContent : newContent;
+		if (!oldSchema || !newSchema) return;
+		const sourceForValues = reverse ? oldSchema : newSchema;
 		if (changeRecords?.length) {
 			const current = this.getCodeContentById(id);
 			if (!current) return;

package/dist/es/services/dataSource.js

@@ -1,4 +1,5 @@
 import BaseService from "./BaseService.js";
+import { createStackStep, describeRevertStep, getLastPushedHistoryIds } from "../utils/history.js";
 import history_default from "./history.js";
 import storage_default, { Protocol } from "./storage.js";
 import { COPY_DS_STORAGE_KEY } from "../utils/editor.js";
@@ -26,18 +27,6 @@ var canUsePluginMethods = {
 		"createId"
 	]
 };
-/**
-* 「回滚」生成的新 step 简短描述。
-* 仅在 service 层使用，避免依赖 UI 层 composables。
-*/
-var describeRevertDataSourceStep = (step) => {
-	const { oldSchema, newSchema, changeRecords, id } = step;
-	if (oldSchema === null && newSchema) return `撤回新增 ${newSchema.title || newSchema.id || id}`;
-	if (oldSchema && newSchema === null) return `还原已删除的 ${oldSchema.title || oldSchema.id || id}`;
-	const title = newSchema?.title || oldSchema?.title || `${id}`;
-	const propPath = changeRecords?.[0]?.propPath;
-	return propPath ? `还原 ${title} · ${propPath}` : `还原 ${title}`;
-};
 var DataSource = class extends BaseService {
 	state = reactive({
 		datasourceTypeList: [],
@@ -48,6 +37,12 @@ var DataSource = class extends BaseService {
 		events: {},
 		methods: {}
 	});
+	/**
+	* 最近一次写入历史栈的数据源历史记录 uuid。
+	* 供 *AndGetHistoryId 系列方法在调用 add / update / remove 后取回本次产生的历史记录 id；
+	* 普通方法不读取它，调用前由 *AndGetHistoryId 重置为 null。
+	*/
+	lastPushedHistoryId = null;
 	constructor() {
 		super(canUsePluginMethods.sync.map((methodName) => ({
 			name: methodName,
@@ -91,18 +86,23 @@ var DataSource = class extends BaseService {
 	* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 	* @param options.historyDescription 入栈时附带的人类可读描述，用于历史面板展示
 	*/
-	add(config, { doNotPushHistory = false, historyDescription } = {}) {
+	add(config, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 		const newConfig = {
 			...config,
 			id: config.id && !this.getDataSourceById(config.id) ? config.id : this.createId()
 		};
 		this.get("dataSources").push(newConfig);
-		if (!doNotPushHistory) history_default.pushDataSource(newConfig.id, {
-			oldSchema: null,
-			newSchema: newConfig,
-			historyDescription
-		});
+		if (!doNotPushHistory) {
+			const step = createStackStep(newConfig.id, {
+				oldValue: null,
+				newValue: newConfig,
+				historyDescription,
+				source: historySource
+			});
+			this.lastPushedHistoryId = (step ? history_default.push("dataSource", step, newConfig.id) : null)?.uuid ?? null;
+		}
 		this.emit("add", newConfig);
+		this.emit("change", this.get("dataSources"));
 		return newConfig;
 	}
 	/**
@@ -113,22 +113,27 @@ var DataSource = class extends BaseService {
 	* @param data.doNotPushHistory 是否不写入历史记录（默认 false）
 	* @param data.historyDescription 入栈时附带的人类可读描述，用于历史面板展示
 	*/
-	update(config, { changeRecords = [], doNotPushHistory = false, historyDescription } = {}) {
+	update(config, { changeRecords = [], doNotPushHistory = false, historyDescription, historySource } = {}) {
 		const dataSources = this.get("dataSources");
 		const index = dataSources.findIndex((ds) => ds.id === config.id);
 		const oldConfig = dataSources[index];
 		const newConfig = cloneDeep$1(config);
 		dataSources[index] = newConfig;
-		if (!doNotPushHistory) history_default.pushDataSource(newConfig.id, {
-			oldSchema: oldConfig ? cloneDeep$1(oldConfig) : null,
-			newSchema: newConfig,
-			changeRecords,
-			historyDescription
-		});
+		if (!doNotPushHistory) {
+			const step = createStackStep(newConfig.id, {
+				oldValue: oldConfig ? cloneDeep$1(oldConfig) : null,
+				newValue: newConfig,
+				changeRecords,
+				historyDescription,
+				source: historySource
+			});
+			this.lastPushedHistoryId = (step ? history_default.push("dataSource", step, newConfig.id) : null)?.uuid ?? null;
+		}
 		this.emit("update", newConfig, {
 			oldConfig,
 			changeRecords
 		});
+		this.emit("change", this.get("dataSources"));
 		return newConfig;
 	}
 	/**
@@ -138,17 +143,54 @@ var DataSource = class extends BaseService {
 	* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
 	* @param options.historyDescription 入栈时附带的人类可读描述，用于历史面板展示
 	*/
-	remove(id, { doNotPushHistory = false, historyDescription } = {}) {
+	remove(id, { doNotPushHistory = false, historyDescription, historySource } = {}) {
 		const dataSources = this.get("dataSources");
 		const index = dataSources.findIndex((ds) => ds.id === id);
 		const oldConfig = index !== -1 ? dataSources[index] : null;
 		dataSources.splice(index, 1);
-		if (oldConfig && !doNotPushHistory) history_default.pushDataSource(id, {
-			oldSchema: cloneDeep$1(oldConfig),
-			newSchema: null,
-			historyDescription
-		});
+		if (oldConfig && !doNotPushHistory) {
+			const step = createStackStep(id, {
+				oldValue: cloneDeep$1(oldConfig),
+				newValue: null,
+				historyDescription,
+				source: historySource
+			});
+			this.lastPushedHistoryId = (step ? history_default.push("dataSource", step, id) : null)?.uuid ?? null;
+		}
 		this.emit("remove", id);
+		this.emit("change", this.get("dataSources"));
+	}
+	/**
+	* 下列 *AndGetHistoryId 方法与对应的 add / update / remove 行为完全一致，
+	* 返回值在 {@link DslOpWithHistoryIdsResult} 中同时包含原操作结果与本次写入历史栈的 uuid 列表（{@link DataSourceStepValue.uuid}），
+	* 可用于精确引用 / 定位该条历史记录（埋点、revert、跨端同步等）。
+	*
+	* 当本次操作未写入历史（doNotPushHistory 为 true、或无对应记录）时 historyIds 为 `[]`。
+	*/
+	/** 等价于 {@link add}，并额外返回本次写入历史记录的 uuid 列表（未入栈时 historyIds 为 `[]`）。 */
+	addAndGetHistoryId(config, options = {}) {
+		this.lastPushedHistoryId = null;
+		return {
+			result: this.add(config, options),
+			historyIds: getLastPushedHistoryIds(this.lastPushedHistoryId)
+		};
+	}
+	/** 等价于 {@link update}，并额外返回本次写入历史记录的 uuid 列表（未入栈时 historyIds 为 `[]`）。 */
+	updateAndGetHistoryId(config, options = {}) {
+		this.lastPushedHistoryId = null;
+		return {
+			result: this.update(config, options),
+			historyIds: getLastPushedHistoryIds(this.lastPushedHistoryId)
+		};
+	}
+	/** 等价于 {@link remove}，并额外返回本次写入历史记录的 uuid 列表（未入栈时 historyIds 为 `[]`）。 */
+	removeAndGetHistoryId(id, options = {}) {
+		this.lastPushedHistoryId = null;
+		this.remove(id, options);
+		return {
+			result: void 0,
+			historyIds: getLastPushedHistoryIds(this.lastPushedHistoryId)
+		};
 	}
 	/**
 	* 撤销指定数据源的最近一次变更。
@@ -161,7 +203,7 @@ var DataSource = class extends BaseService {
 	* @returns 撤销的 step；栈不存在或已无可撤销时返回 null
 	*/
 	undo(id) {
-		const step = history_default.undoDataSource(id);
+		const step = history_default.undo("dataSource", id);
 		if (!step) return null;
 		this.applyHistoryStep(step, true);
 		return step;
@@ -172,18 +214,18 @@ var DataSource = class extends BaseService {
 	* @returns 重做的 step；栈不存在或已无可重做时返回 null
 	*/
 	redo(id) {
-		const step = history_default.redoDataSource(id);
+		const step = history_default.redo("dataSource", id);
 		if (!step) return null;
 		this.applyHistoryStep(step, false);
 		return step;
 	}
 	/** 是否可对指定数据源撤销。 */
 	canUndo(id) {
-		return history_default.canUndoDataSource(id);
+		return history_default.canUndo("dataSource", id);
 	}
 	/** 是否可对指定数据源重做。 */
 	canRedo(id) {
-		return history_default.canRedoDataSource(id);
+		return history_default.canRedo("dataSource", id);
 	}
 	/**
 	* 跳转指定数据源的历史栈到目标游标。语义同 editor.gotoPageStep。
@@ -193,7 +235,7 @@ var DataSource = class extends BaseService {
 	* @returns 实际移动到的最终游标位置
 	*/
 	goto(id, targetCursor) {
-		let cursor = history_default.getDataSourceCursor(id);
+		let cursor = history_default.getCursor("dataSource", id);
 		const target = Math.max(0, targetCursor);
 		while (cursor > target) {
 			if (!this.undo(id)) break;
@@ -216,11 +258,27 @@ var DataSource = class extends BaseService {
 	* @returns 反向后产生的新 step；目标不存在 / 未应用时返回 null
 	*/
 	revert(id, index) {
-		const entry = history_default.getDataSourceStepList(id)[index];
+		const entry = history_default.getStepList("dataSource", id)[index];
 		if (!entry?.applied) return null;
-		const description = `回滚 #${index + 1}: ${describeRevertDataSourceStep(entry.step)}`;
+		const { oldSchema, newSchema, changeRecords } = entry.step.diff?.[0] ?? {};
+		if (oldSchema && newSchema && !changeRecords?.length) return null;
+		const description = `回滚 #${index + 1}: ${describeRevertStep(entry.step.data.id, entry.step.diff?.[0], (s) => s.title)}`;
 		return this.applyRevertStep(entry.step, description);
 	}
+	/**
+	* 通过历史记录 uuid 回滚数据源历史步骤，语义同 {@link revert}，
+	* 仅无需调用方再传 dataSourceId 与 index：内部会按 uuid 在全部数据源栈中定位对应步骤后再回滚。
+	* 按数组顺序依次回滚，返回与入参同序的结果列表（某项失败时为 `null`）。
+	*
+	* @param uuids 目标历史记录的 uuid 列表，通常由 {@link addAndGetHistoryId} 等方法返回的 `historyIds`
+	*/
+	revertById(uuids) {
+		return uuids.map((uuid) => {
+			const location = history_default.findStepLocationByUuid("dataSource", uuid);
+			if (!location) return null;
+			return this.revert(location.id, location.index);
+		});
+	}
 	createId() {
 		return `ds_${guid()}`;
 	}
@@ -279,14 +337,21 @@ var DataSource = class extends BaseService {
 	* 同构，差异仅在于走对应的公共 add / update / remove 而不是带 doNotPushHistory 的版本。
 	*/
 	applyRevertStep(step, historyDescription) {
-		const { id, oldSchema, newSchema, changeRecords } = step;
-		if (oldSchema === null && newSchema) {
-			this.remove(`${id}`, { historyDescription });
-			return history_default.getDataSourceStepList(id).slice(-1)[0]?.step ?? null;
+		const { id } = step.data;
+		const { oldSchema, newSchema, changeRecords } = step.diff?.[0] ?? {};
+		if (!oldSchema && newSchema) {
+			this.remove(`${id}`, {
+				historyDescription,
+				historySource: "rollback"
+			});
+			return history_default.getStepList("dataSource", id).slice(-1)[0]?.step ?? null;
 		}
-		if (oldSchema && newSchema === null) {
-			this.add(cloneDeep$1(oldSchema), { historyDescription });
-			return history_default.getDataSourceStepList(id).slice(-1)[0]?.step ?? null;
+		if (oldSchema && !newSchema) {
+			this.add(cloneDeep$1(oldSchema), {
+				historyDescription,
+				historySource: "rollback"
+			});
+			return history_default.getStepList("dataSource", id).slice(-1)[0]?.step ?? null;
 		}
 		if (!oldSchema || !newSchema) return null;
 		if (changeRecords?.length) {
@@ -304,12 +369,16 @@ var DataSource = class extends BaseService {
 			}
 			this.update(fallbackToFullReplace ? cloneDeep$1(oldSchema) : patched, {
 				changeRecords,
-				historyDescription
+				historyDescription,
+				historySource: "rollback"
 			});
-			return history_default.getDataSourceStepList(id).slice(-1)[0]?.step ?? null;
+			return history_default.getStepList("dataSource", id).slice(-1)[0]?.step ?? null;
 		}
-		this.update(cloneDeep$1(oldSchema), { historyDescription });
-		return history_default.getDataSourceStepList(id).slice(-1)[0]?.step ?? null;
+		this.update(cloneDeep$1(oldSchema), {
+			historyDescription,
+			historySource: "rollback"
+		});
+		return history_default.getStepList("dataSource", id).slice(-1)[0]?.step ?? null;
 	}
 	/**
 	* 把一条历史 step 应用到当前数据源服务上。
@@ -326,13 +395,14 @@ var DataSource = class extends BaseService {
 	* @param reverse true=撤销，false=重做
 	*/
 	applyHistoryStep(step, reverse) {
-		const { id, oldSchema, newSchema, changeRecords } = step;
-		if (oldSchema === null && newSchema) {
+		const { id } = step.data;
+		const { oldSchema, newSchema, changeRecords } = step.diff?.[0] ?? {};
+		if (!oldSchema && newSchema) {
 			if (reverse) this.remove(`${id}`, { doNotPushHistory: true });
 			else this.add(cloneDeep$1(newSchema), { doNotPushHistory: true });
 			return;
 		}
-		if (oldSchema && newSchema === null) {
+		if (oldSchema && !newSchema) {
 			if (reverse) this.add(cloneDeep$1(oldSchema), { doNotPushHistory: true });
 			else this.remove(`${id}`, { doNotPushHistory: true });
 			return;