@tmagic/editor 1.8.0-beta.1 → 1.8.0-beta.11

package/dist/es/services/dataSource.js

@@ -1,12 +1,14 @@
-import BaseService_default from "./BaseService.js";
+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";
 import editor_default from "./editor.js";
 import { getFormConfig, getFormValue } from "../utils/data-source/index.js";
-import { guid, toLine } from "@tmagic/utils";
+import { getValueByKeyPath, guid, setValueByKeyPath, toLine } from "@tmagic/utils";
 import { Target, Watcher } from "@tmagic/core";
 import { reactive } from "vue";
-import { cloneDeep, get } from "lodash-es";
+import { cloneDeep as cloneDeep$1, get } from "lodash-es";
 //#region packages/editor/src/services/dataSource.ts
 var canUsePluginMethods = {
 	async: [],
@@ -25,7 +27,7 @@ var canUsePluginMethods = {
 		"createId"
 	]
 };
-var DataSource = class extends BaseService_default {
+var DataSource = class extends BaseService {
 	state = reactive({
 		datasourceTypeList: [],
 		dataSources: [],
@@ -35,6 +37,12 @@ var DataSource = class extends BaseService_default {
 		events: {},
 		methods: {}
 	});
+	/**
+	* 最近一次写入历史栈的数据源历史记录 uuid。
+	* 供 *AndGetHistoryId 系列方法在调用 add / update / remove 后取回本次产生的历史记录 id；
+	* 普通方法不读取它，调用前由 *AndGetHistoryId 重置为 null。
+	*/
+	lastPushedHistoryId = null;
 	constructor() {
 		super(canUsePluginMethods.sync.map((methodName) => ({
 			name: methodName,
@@ -71,32 +79,205 @@ var DataSource = class extends BaseService_default {
 	setFormMethod(type, value = []) {
 		this.get("methods")[toLine(type)] = value;
 	}
-	add(config) {
+	/**
+	* 新增数据源
+	* @param config 数据源配置
+	* @param options 可选配置
+	* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
+	* @param options.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) {
+			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;
 	}
-	update(config, { changeRecords = [] } = {}) {
+	/**
+	* 更新数据源
+	* @param config 数据源配置
+	* @param data 额外数据
+	* @param data.changeRecords form 端变更记录
+	* @param data.doNotPushHistory 是否不写入历史记录（默认 false）
+	* @param data.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(config);
+		const newConfig = cloneDeep$1(config);
 		dataSources[index] = newConfig;
+		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;
 	}
-	remove(id) {
+	/**
+	* 删除数据源
+	* @param id 数据源 id
+	* @param options 可选配置
+	* @param options.doNotPushHistory 是否不写入历史记录（默认 false）
+	* @param options.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) {
+			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)
+		};
+	}
+	/**
+	* 撤销指定数据源的最近一次变更。
+	*
+	* 内部走 add / update / remove，因此会自动触发 dataSourceService 的事件，
+	* 由 initService 中的对应 handler 重新收集 dep（DATA_SOURCE / DATA_SOURCE_COND / DATA_SOURCE_METHOD）。
+	* 所有写回都带 `doNotPushHistory: true`，避免在历史栈里产生新的记录。
+	*
+	* @param id 数据源 id
+	* @returns 撤销的 step；栈不存在或已无可撤销时返回 null
+	*/
+	undo(id) {
+		const step = history_default.undo("dataSource", id);
+		if (!step) return null;
+		this.applyHistoryStep(step, true);
+		return step;
+	}
+	/**
+	* 重做指定数据源的下一次变更。
+	* @param id 数据源 id
+	* @returns 重做的 step；栈不存在或已无可重做时返回 null
+	*/
+	redo(id) {
+		const step = history_default.redo("dataSource", id);
+		if (!step) return null;
+		this.applyHistoryStep(step, false);
+		return step;
+	}
+	/** 是否可对指定数据源撤销。 */
+	canUndo(id) {
+		return history_default.canUndo("dataSource", id);
+	}
+	/** 是否可对指定数据源重做。 */
+	canRedo(id) {
+		return history_default.canRedo("dataSource", id);
+	}
+	/**
+	* 跳转指定数据源的历史栈到目标游标。语义同 editor.gotoPageStep。
+	*
+	* @param id          数据源 id
+	* @param targetCursor 目标游标位置（已应用步骤数量）
+	* @returns 实际移动到的最终游标位置
+	*/
+	goto(id, targetCursor) {
+		let cursor = history_default.getCursor("dataSource", id);
+		const target = Math.max(0, targetCursor);
+		while (cursor > target) {
+			if (!this.undo(id)) break;
+			cursor -= 1;
+		}
+		while (cursor < target) {
+			if (!this.redo(id)) break;
+			cursor += 1;
+		}
+		return cursor;
+	}
+	/**
+	* 「回滚」指定数据源历史步骤（类 git revert 语义）：
+	* - 不动原始栈结构（不移动 cursor、不丢弃任何步骤）；
+	* - 把目标 step 的修改**反向应用**一次，并作为**新步骤**追加到栈顶；
+	* - 仅对已应用的步骤生效——未应用步骤本身就不存在于当前 schema 中，反向无意义。
+	*
+	* @param id    数据源 id
+	* @param index 目标 step 在该栈中的索引（0 为最早），通常由历史面板传入
+	* @returns 反向后产生的新 step；目标不存在 / 未应用时返回 null
+	*/
+	revert(id, index) {
+		const entry = history_default.getStepList("dataSource", id)[index];
+		if (!entry?.applied) return null;
+		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()}`;
@@ -151,6 +332,104 @@ var DataSource = class extends BaseService_default {
 			if (!this.getDataSourceById(item.id)) this.add(item);
 		});
 	}
+	/**
+	* 反向应用一个 step 并以新 step 入栈（不带 doNotPushHistory）。逻辑与 applyHistoryStep(reverse=true)
+	* 同构，差异仅在于走对应的公共 add / update / remove 而不是带 doNotPushHistory 的版本。
+	*/
+	applyRevertStep(step, historyDescription) {
+		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) {
+			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) {
+			const current = this.getDataSourceById(`${id}`);
+			if (!current) return null;
+			const patched = cloneDeep$1(current);
+			let fallbackToFullReplace = false;
+			for (const record of changeRecords) {
+				if (!record.propPath) {
+					fallbackToFullReplace = true;
+					break;
+				}
+				const value = cloneDeep$1(getValueByKeyPath(record.propPath, oldSchema));
+				setValueByKeyPath(record.propPath, value, patched);
+			}
+			this.update(fallbackToFullReplace ? cloneDeep$1(oldSchema) : patched, {
+				changeRecords,
+				historyDescription,
+				historySource: "rollback"
+			});
+			return history_default.getStepList("dataSource", 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 应用到当前数据源服务上。
+	*
+	* 复用现有的 add / update / remove，目的是借助它们发出的事件触发 initService 中
+	* 的依赖收集逻辑（DATA_SOURCE / DATA_SOURCE_COND / DATA_SOURCE_METHOD）。
+	* 所有写回都带 `doNotPushHistory: true`，确保不会在历史栈里产生新的记录。
+	*
+	* - oldSchema=null, newSchema≠null：原始为新增 → undo 删除；redo 再次 add
+	* - oldSchema≠null, newSchema=null：原始为删除 → undo 还原 add；redo 再次删除
+	* - 两侧都有：原始为更新 → 按 changeRecords 局部 patch；缺省退化为整 schema 替换
+	*
+	* @param step 历史 step
+	* @param reverse true=撤销，false=重做
+	*/
+	applyHistoryStep(step, reverse) {
+		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) {
+			if (reverse) this.add(cloneDeep$1(oldSchema), { doNotPushHistory: true });
+			else this.remove(`${id}`, { doNotPushHistory: true });
+			return;
+		}
+		if (!oldSchema || !newSchema) return;
+		const sourceForValues = reverse ? oldSchema : newSchema;
+		if (changeRecords?.length) {
+			const current = this.getDataSourceById(`${id}`);
+			if (!current) return;
+			const patched = cloneDeep$1(current);
+			let fallbackToFullReplace = false;
+			for (const record of changeRecords) {
+				if (!record.propPath) {
+					fallbackToFullReplace = true;
+					break;
+				}
+				const value = cloneDeep$1(getValueByKeyPath(record.propPath, sourceForValues));
+				setValueByKeyPath(record.propPath, value, patched);
+			}
+			this.update(fallbackToFullReplace ? cloneDeep$1(sourceForValues) : patched, {
+				changeRecords,
+				doNotPushHistory: true
+			});
+			return;
+		}
+		this.update(cloneDeep$1(sourceForValues), { doNotPushHistory: true });
+	}
 };
 var dataSource_default = new DataSource();
 //#endregion

package/dist/es/services/dep.js

@@ -1,4 +1,4 @@
-import BaseService_default from "./BaseService.js";
+import BaseService from "./BaseService.js";
 import { IdleTask } from "../utils/dep/idle-task.js";
 import WorkerWrapper from "../utils/dep/worker.js";
 import { isPage } from "@tmagic/utils";
@@ -7,7 +7,7 @@ import { reactive, shallowReactive } from "vue";
 import { throttle } from "lodash-es";
 import serialize from "serialize-javascript";
 //#region packages/editor/src/services/dep.ts
-var Dep = class extends BaseService_default {
+var Dep = class extends BaseService {
 	state = shallowReactive({
 		collecting: false,
 		taskLength: 0
@@ -52,9 +52,12 @@ var Dep = class extends BaseService_default {
 	}
 	collect(nodes, depExtendedData = {}, deep = false, type) {
 		this.set("collecting", true);
-		this.watcher.collectByCallback(nodes, type, ({ node, target }) => {
-			this.collectNode(node, target, depExtendedData, deep);
-		});
+		const targets = this.watcher.getCollectableTargets(type);
+		if (targets.length) for (const node of nodes) {
+			if (isPage(node)) for (const target of targets) this.removePageDep(target, depExtendedData);
+			else this.watcher.removeTargetsDep(targets, node);
+			this.watcher.collectItems(node, targets, depExtendedData, deep);
+		}
 		this.set("collecting", false);
 		this.emit("collected", nodes, deep);
 		this.emit("ds-collected", nodes, deep);
@@ -103,7 +106,7 @@ var Dep = class extends BaseService_default {
 					target.deps = reactive(depsData[target.type][target.id]);
 					if (target.type === DepTargetType.DATA_SOURCE && dsl.dataSourceDeps) dsl.dataSourceDeps[target.id] = target.deps;
 					else if (target.type === DepTargetType.DATA_SOURCE_COND && dsl.dataSourceCondDeps) dsl.dataSourceCondDeps[target.id] = target.deps;
-					else if (target.type === DepTargetType.DATA_SOURCE_METHOD) dsl.dataSourceMethodDeps[target.id] = target.deps;
+					else if (target.type === DepTargetType.DATA_SOURCE_METHOD && dsl.dataSourceMethodDeps) dsl.dataSourceMethodDeps[target.id] = target.deps;
 				}
 			});
 			this.set("collecting", false);
@@ -114,9 +117,8 @@ var Dep = class extends BaseService_default {
 		});
 	}
 	collectNode(node, target, depExtendedData = {}, deep = false) {
-		if (isPage(node)) {
-			for (const [depKey, dep] of Object.entries(target.deps)) if (dep.data?.pageId && dep.data.pageId === depExtendedData.pageId) delete target.deps[depKey];
-		} else this.watcher.removeTargetDep(target, node);
+		if (isPage(node)) this.removePageDep(target, depExtendedData);
+		else this.watcher.removeTargetDep(target, node);
 		this.watcher.collectItem(node, target, depExtendedData, deep);
 	}
 	clear(nodes) {
@@ -155,6 +157,16 @@ var Dep = class extends BaseService_default {
 	emit(eventName, ...args) {
 		return super.emit(eventName, ...args);
 	}
+	/**
+	* 删除指定 page 在该 target 下的旧依赖：
+	* 按 pageId 匹配，可清掉页面内已被删除节点的残留依赖
+	*/
+	removePageDep(target, depExtendedData = {}) {
+		for (const depKey of Object.keys(target.deps)) {
+			const dep = target.deps[depKey];
+			if (dep.data?.pageId && dep.data.pageId === depExtendedData.pageId) delete target.deps[depKey];
+		}
+	}
 	enqueueTask(node, target, depExtendedData, deep) {
 		this.idleTask.enqueueTask(({ node, deep, target }) => {
 			this.collectNode(node, target, depExtendedData, deep);