@tmagic/editor 1.7.14-beta.2 → 1.7.14-beta.3

package/dist/es/services/editor.js

@@ -12,6 +12,23 @@ import { NodeType } from "@tmagic/core";
 import { reactive, toRaw } from "vue";
 import { cloneDeep, isObject, mergeWith, uniq } from "lodash-es";
 //#region packages/editor/src/services/editor.ts
+/**
+* 经过 BaseService 的插件 / 中间件包装后，源方法的最后一个形参可能被注入为 dispatch 函数
+* 当 options 形参位置被注入为函数（或为 null）时，将其归一为空对象，避免后续逻辑误读
+*/
+var safeOptions = (options) => {
+	const empty = {};
+	if (!options || typeof options === "function") return empty;
+	return options;
+};
+/**
+* 经过 BaseService 的插件 / 中间件包装后，源方法的形参可能被注入为 dispatch 函数
+* 当 parent 形参位置被注入为函数（或为空值）时，归一为 null，由调用方继续走默认 parent 逻辑
+*/
+var safeParent = (parent) => {
+	if (!parent || typeof parent === "function") return null;
+	return parent;
+};
 var Editor = class extends BaseService_default {
 	state = reactive({
 		root: null,
@@ -222,9 +239,13 @@ var Editor = class extends BaseService_default {
 	* 向指点容器添加组件节点
 	* @param addConfig 将要添加的组件节点配置
 	* @param parent 要添加到的容器组件节点配置，如果不设置，默认为当前选中的组件的父节点
+	* @param options 可选配置
+	* @param options.doNotSelect 添加后是否不更新当前选中节点（默认 false，添加后会选中新增的节点）
 	* @returns 添加后的节点
 	*/
-	async add(addNode, parent) {
+	async add(addNode, parent, options) {
+		const safeParentNode = safeParent(parent);
+		const { doNotSelect = false } = safeOptions(options);
 		this.captureSelectionBeforeOp();
 		const stage = this.get("stage");
 		const addNodes = [];
@@ -236,19 +257,21 @@ var Editor = class extends BaseService_default {
 		const newNodes = await Promise.all(addNodes.map((node) => {
 			const root = this.get("root");
 			if ((isPage(node) || isPageFragment(node)) && root) return this.doAdd(node, root);
-			const parentNode = parent && typeof parent !== "function" ? parent : getAddParent(node);
+			const parentNode = safeParentNode ?? getAddParent(node);
 			if (!parentNode) throw new Error("未找到父元素");
 			return this.doAdd(node, parentNode);
 		}));
 		if (newNodes.length > 1) {
-			const newNodeIds = newNodes.map((node) => node.id);
-			stage?.multiSelect(newNodeIds);
-			await this.multiSelect(newNodeIds);
+			if (!doNotSelect) {
+				const newNodeIds = newNodes.map((node) => node.id);
+				stage?.multiSelect(newNodeIds);
+				await this.multiSelect(newNodeIds);
+			}
 		} else {
-			await this.select(newNodes[0]);
+			if (!doNotSelect) await this.select(newNodes[0]);
 			if (isPage(newNodes[0])) this.state.pageLength += 1;
 			else if (isPageFragment(newNodes[0])) this.state.pageFragmentLength += 1;
-			else stage?.select(newNodes[0].id);
+			else if (!doNotSelect) stage?.select(newNodes[0].id);
 		}
 		if (!(isPage(newNodes[0]) || isPageFragment(newNodes[0]))) {
 			const pageForOp = this.getNodeInfo(newNodes[0].id, false).page;
@@ -267,7 +290,8 @@ var Editor = class extends BaseService_default {
 		this.emit("add", newNodes);
 		return Array.isArray(addNode) ? newNodes : newNodes[0];
 	}
-	async doRemove(node) {
+	async doRemove(node, options) {
+		const { doNotSelect = false } = safeOptions(options);
 		const root = this.get("root");
 		if (!root) throw new Error("root不能为空");
 		const { parent, node: curNode } = this.getNodeInfo(node.id, false);
@@ -281,6 +305,19 @@ var Editor = class extends BaseService_default {
 			parentId: parent.id,
 			root: cloneDeep(root)
 		});
+		if (doNotSelect) {
+			const selectedNodes = this.get("nodes");
+			const removedSelectedIndex = selectedNodes.findIndex((n) => `${n.id}` === `${node.id}`);
+			if (removedSelectedIndex !== -1) {
+				const nextSelected = [...selectedNodes];
+				nextSelected.splice(removedSelectedIndex, 1);
+				this.set("nodes", nextSelected);
+			}
+			if (isPage(node) || isPageFragment(node)) {
+				const currentPage = this.get("page");
+				if (currentPage && `${currentPage.id}` === `${node.id}`) this.set("page", null);
+			}
+		}
 		const selectDefault = async (pages) => {
 			if (pages[0]) {
 				await this.select(pages[0]);
@@ -293,13 +330,15 @@ var Editor = class extends BaseService_default {
 		const rootItems = root.items || [];
 		if (isPage(node)) {
 			this.state.pageLength -= 1;
-			await selectDefault(rootItems);
+			if (!doNotSelect) await selectDefault(rootItems);
 		} else if (isPageFragment(node)) {
 			this.state.pageFragmentLength -= 1;
-			await selectDefault(rootItems);
+			if (!doNotSelect) await selectDefault(rootItems);
 		} else {
-			await this.select(parent);
-			stage?.select(parent.id);
+			if (!doNotSelect) {
+				await this.select(parent);
+				stage?.select(parent.id);
+			}
 			this.addModifiedNodeId(parent.id);
 		}
 		if (!rootItems.length) {
@@ -309,9 +348,12 @@ var Editor = class extends BaseService_default {
 	}
 	/**
 	* 删除组件
-	* @param {Object} node
+	* @param {Object} node 要删除的节点或节点集合
+	* @param options 可选配置
+	* @param options.doNotSelect 删除后是否不更新当前选中节点（默认 false，删除后会选中父节点或首个页面）
 	*/
-	async remove(nodeOrNodeList) {
+	async remove(nodeOrNodeList, options) {
+		const { doNotSelect = false } = safeOptions(options);
 		this.captureSelectionBeforeOp();
 		const nodes = Array.isArray(nodeOrNodeList) ? nodeOrNodeList : [nodeOrNodeList];
 		const removedItems = [];
@@ -331,11 +373,11 @@ var Editor = class extends BaseService_default {
 				});
 			}
 		}
-		await Promise.all(nodes.map((node) => this.doRemove(node)));
+		await Promise.all(nodes.map((node) => this.doRemove(node, { doNotSelect })));
 		if (removedItems.length > 0 && pageForOp) this.pushOpHistory("remove", { removedItems }, pageForOp);
 		this.emit("remove", nodes);
 	}
-	async doUpdate(config, { changeRecords = [], selectedAfterUpdate = true } = {}) {
+	async doUpdate(config, { changeRecords = [] } = {}) {
 		const root = this.get("root");
 		if (!root) throw new Error("root为空");
 		if (!config?.id) throw new Error("没有配置或者配置缺少id值");
@@ -362,11 +404,11 @@ var Editor = class extends BaseService_default {
 		const layout = await this.getLayout(node);
 		if (Array.isArray(newConfig.items) && newLayout !== layout) newConfig = setChildrenLayout(newConfig, newLayout);
 		parentNodeItems[index] = newConfig;
-		if (selectedAfterUpdate) {
-			const nodes = this.get("nodes");
-			const targetIndex = nodes.findIndex((nodeItem) => `${nodeItem.id}` === `${newConfig.id}`);
-			nodes.splice(targetIndex, 1, newConfig);
-			this.set("nodes", [...nodes]);
+		const selectedNodes = this.get("nodes");
+		const targetIndex = selectedNodes.findIndex((nodeItem) => `${nodeItem.id}` === `${newConfig.id}`);
+		if (targetIndex !== -1) {
+			selectedNodes.splice(targetIndex, 1, newConfig);
+			this.set("nodes", [...selectedNodes]);
 		}
 		if (isPage(newConfig) || isPageFragment(newConfig)) this.set("page", newConfig);
 		this.addModifiedNodeId(newConfig.id);
@@ -407,9 +449,12 @@ var Editor = class extends BaseService_default {
 	* 将id为id1的组件移动到id为id2的组件位置上，例如：[1,2,3,4] -> sort(1,3) -> [2,1,3,4]
 	* @param id1 组件ID
 	* @param id2 组件ID
+	* @param options 可选配置
+	* @param options.doNotSelect 排序后是否不更新当前选中节点（默认 false）
 	* @returns void
 	*/
-	async sort(id1, id2) {
+	async sort(id1, id2, options) {
+		const { doNotSelect = false } = safeOptions(options);
 		this.captureSelectionBeforeOp();
 		const root = this.get("root");
 		if (!root) throw new Error("root为空");
@@ -422,7 +467,7 @@ var Editor = class extends BaseService_default {
 		const index1 = parent.items.findIndex((node) => `${node.id}` === `${id1}`);
 		parent.items.splice(index2, 0, ...parent.items.splice(index1, 1));
 		await this.update(parent);
-		await this.select(node);
+		if (!doNotSelect) await this.select(node);
 		this.get("stage")?.update({
 			config: cloneDeep(node),
 			parentId: parent.id,
@@ -450,9 +495,13 @@ var Editor = class extends BaseService_default {
 	/**
 	* 从localStorage中获取节点，然后添加到当前容器中
 	* @param position 粘贴的坐标
+	* @param collectorOptions 可选的依赖收集器配置
+	* @param options 可选配置
+	* @param options.doNotSelect 粘贴后是否不更新当前选中节点（默认 false）
 	* @returns 添加后的组件节点配置
 	*/
-	async paste(position = {}, collectorOptions) {
+	async paste(position = {}, collectorOptions, options) {
+		const { doNotSelect = false } = safeOptions(options);
 		const config = storage_default.getItem(COPY_STORAGE_KEY);
 		if (!Array.isArray(config)) return;
 		const node = this.get("node");
@@ -463,7 +512,7 @@ var Editor = class extends BaseService_default {
 		}
 		const pasteConfigs = await this.doPaste(config, position);
 		if (collectorOptions && typeof collectorOptions.isTarget === "function") props_default.replaceRelateId(config, pasteConfigs, collectorOptions);
-		return this.add(pasteConfigs, parent);
+		return this.add(pasteConfigs, parent, { doNotSelect });
 	}
 	async doPaste(config, position = {}) {
 		props_default.clearRelateId();
@@ -484,14 +533,17 @@ var Editor = class extends BaseService_default {
 	/**
 	* 将指点节点设置居中
 	* @param config 组件节点配置
+	* @param options 可选配置
+	* @param options.doNotSelect 居中后是否不更新当前选中节点（默认 false）
 	* @returns 当前组件节点配置
 	*/
-	async alignCenter(config) {
+	async alignCenter(config, options) {
+		const { doNotSelect = false } = safeOptions(options);
 		const nodes = Array.isArray(config) ? config : [config];
 		const stage = this.get("stage");
 		const newNodes = await Promise.all(nodes.map((node) => this.doAlignCenter(node)));
 		const newNode = await this.update(newNodes);
-		if (newNodes.length > 1) await stage?.multiSelect(newNodes.map((node) => node.id));
+		if (!doNotSelect) if (newNodes.length > 1) await stage?.multiSelect(newNodes.map((node) => node.id));
 		else await stage?.select(newNodes[0].id);
 		return newNode;
 	}
@@ -536,8 +588,11 @@ var Editor = class extends BaseService_default {
 	* 移动到指定容器中
 	* @param config 需要移动的节点
 	* @param targetId 容器ID
+	* @param options 可选配置
+	* @param options.doNotSelect 移动后是否不更新当前选中节点（默认 false）
 	*/
-	async moveToContainer(config, targetId) {
+	async moveToContainer(config, targetId, options) {
+		const { doNotSelect = false } = safeOptions(options);
 		this.captureSelectionBeforeOp();
 		const root = this.get("root");
 		const { node, parent, page: pageForOp } = this.getNodeInfo(config.id, false);
@@ -559,15 +614,17 @@ var Editor = class extends BaseService_default {
 			});
 			newConfig.style = getInitPositionStyle(newConfig.style, layout);
 			target.items.push(newConfig);
-			await stage.select(targetId);
+			if (!doNotSelect) await stage.select(targetId);
 			const targetParent = this.getParentById(target.id);
 			await stage.update({
 				config: cloneDeep(target),
 				parentId: targetParent?.id,
 				root: cloneDeep(root)
 			});
-			await this.select(newConfig);
-			stage.select(newConfig.id);
+			if (!doNotSelect) {
+				await this.select(newConfig);
+				stage.select(newConfig.id);
+			}
 			this.addModifiedNodeId(target.id);
 			this.addModifiedNodeId(parent.id);
 			this.pushOpHistory("update", { updatedItems: [{

package/dist/tmagic-editor.umd.cjs

@@ -5793,6 +5793,23 @@
 	};
 	//#endregion
 	//#region packages/editor/src/services/editor.ts
+	/**
+	* 经过 BaseService 的插件 / 中间件包装后，源方法的最后一个形参可能被注入为 dispatch 函数
+	* 当 options 形参位置被注入为函数（或为 null）时，将其归一为空对象，避免后续逻辑误读
+	*/
+	var safeOptions = (options) => {
+		const empty = {};
+		if (!options || typeof options === "function") return empty;
+		return options;
+	};
+	/**
+	* 经过 BaseService 的插件 / 中间件包装后，源方法的形参可能被注入为 dispatch 函数
+	* 当 parent 形参位置被注入为函数（或为空值）时，归一为 null，由调用方继续走默认 parent 逻辑
+	*/
+	var safeParent = (parent) => {
+		if (!parent || typeof parent === "function") return null;
+		return parent;
+	};
 	var Editor = class extends BaseService_default {
 		state = (0, vue.reactive)({
 			root: null,
@@ -6003,9 +6020,13 @@
 		* 向指点容器添加组件节点
 		* @param addConfig 将要添加的组件节点配置
 		* @param parent 要添加到的容器组件节点配置，如果不设置，默认为当前选中的组件的父节点
+		* @param options 可选配置
+		* @param options.doNotSelect 添加后是否不更新当前选中节点（默认 false，添加后会选中新增的节点）
 		* @returns 添加后的节点
 		*/
-		async add(addNode, parent) {
+		async add(addNode, parent, options) {
+			const safeParentNode = safeParent(parent);
+			const { doNotSelect = false } = safeOptions(options);
 			this.captureSelectionBeforeOp();
 			const stage = this.get("stage");
 			const addNodes = [];
@@ -6017,19 +6038,21 @@
 			const newNodes = await Promise.all(addNodes.map((node) => {
 				const root = this.get("root");
 				if (((0, _tmagic_utils.isPage)(node) || (0, _tmagic_utils.isPageFragment)(node)) && root) return this.doAdd(node, root);
-				const parentNode = parent && typeof parent !== "function" ? parent : getAddParent(node);
+				const parentNode = safeParentNode ?? getAddParent(node);
 				if (!parentNode) throw new Error("未找到父元素");
 				return this.doAdd(node, parentNode);
 			}));
 			if (newNodes.length > 1) {
-				const newNodeIds = newNodes.map((node) => node.id);
-				stage?.multiSelect(newNodeIds);
-				await this.multiSelect(newNodeIds);
+				if (!doNotSelect) {
+					const newNodeIds = newNodes.map((node) => node.id);
+					stage?.multiSelect(newNodeIds);
+					await this.multiSelect(newNodeIds);
+				}
 			} else {
-				await this.select(newNodes[0]);
+				if (!doNotSelect) await this.select(newNodes[0]);
 				if ((0, _tmagic_utils.isPage)(newNodes[0])) this.state.pageLength += 1;
 				else if ((0, _tmagic_utils.isPageFragment)(newNodes[0])) this.state.pageFragmentLength += 1;
-				else stage?.select(newNodes[0].id);
+				else if (!doNotSelect) stage?.select(newNodes[0].id);
 			}
 			if (!((0, _tmagic_utils.isPage)(newNodes[0]) || (0, _tmagic_utils.isPageFragment)(newNodes[0]))) {
 				const pageForOp = this.getNodeInfo(newNodes[0].id, false).page;
@@ -6048,7 +6071,8 @@
 			this.emit("add", newNodes);
 			return Array.isArray(addNode) ? newNodes : newNodes[0];
 		}
-		async doRemove(node) {
+		async doRemove(node, options) {
+			const { doNotSelect = false } = safeOptions(options);
 			const root = this.get("root");
 			if (!root) throw new Error("root不能为空");
 			const { parent, node: curNode } = this.getNodeInfo(node.id, false);
@@ -6062,6 +6086,19 @@
 				parentId: parent.id,
 				root: cloneDeep(root)
 			});
+			if (doNotSelect) {
+				const selectedNodes = this.get("nodes");
+				const removedSelectedIndex = selectedNodes.findIndex((n) => `${n.id}` === `${node.id}`);
+				if (removedSelectedIndex !== -1) {
+					const nextSelected = [...selectedNodes];
+					nextSelected.splice(removedSelectedIndex, 1);
+					this.set("nodes", nextSelected);
+				}
+				if ((0, _tmagic_utils.isPage)(node) || (0, _tmagic_utils.isPageFragment)(node)) {
+					const currentPage = this.get("page");
+					if (currentPage && `${currentPage.id}` === `${node.id}`) this.set("page", null);
+				}
+			}
 			const selectDefault = async (pages) => {
 				if (pages[0]) {
 					await this.select(pages[0]);
@@ -6074,13 +6111,15 @@
 			const rootItems = root.items || [];
 			if ((0, _tmagic_utils.isPage)(node)) {
 				this.state.pageLength -= 1;
-				await selectDefault(rootItems);
+				if (!doNotSelect) await selectDefault(rootItems);
 			} else if ((0, _tmagic_utils.isPageFragment)(node)) {
 				this.state.pageFragmentLength -= 1;
-				await selectDefault(rootItems);
+				if (!doNotSelect) await selectDefault(rootItems);
 			} else {
-				await this.select(parent);
-				stage?.select(parent.id);
+				if (!doNotSelect) {
+					await this.select(parent);
+					stage?.select(parent.id);
+				}
 				this.addModifiedNodeId(parent.id);
 			}
 			if (!rootItems.length) {
@@ -6090,9 +6129,12 @@
 		}
 		/**
 		* 删除组件
-		* @param {Object} node
+		* @param {Object} node 要删除的节点或节点集合
+		* @param options 可选配置
+		* @param options.doNotSelect 删除后是否不更新当前选中节点（默认 false，删除后会选中父节点或首个页面）
 		*/
-		async remove(nodeOrNodeList) {
+		async remove(nodeOrNodeList, options) {
+			const { doNotSelect = false } = safeOptions(options);
 			this.captureSelectionBeforeOp();
 			const nodes = Array.isArray(nodeOrNodeList) ? nodeOrNodeList : [nodeOrNodeList];
 			const removedItems = [];
@@ -6112,11 +6154,11 @@
 					});
 				}
 			}
-			await Promise.all(nodes.map((node) => this.doRemove(node)));
+			await Promise.all(nodes.map((node) => this.doRemove(node, { doNotSelect })));
 			if (removedItems.length > 0 && pageForOp) this.pushOpHistory("remove", { removedItems }, pageForOp);
 			this.emit("remove", nodes);
 		}
-		async doUpdate(config, { changeRecords = [], selectedAfterUpdate = true } = {}) {
+		async doUpdate(config, { changeRecords = [] } = {}) {
 			const root = this.get("root");
 			if (!root) throw new Error("root为空");
 			if (!config?.id) throw new Error("没有配置或者配置缺少id值");
@@ -6143,11 +6185,11 @@
 			const layout = await this.getLayout(node);
 			if (Array.isArray(newConfig.items) && newLayout !== layout) newConfig = setChildrenLayout(newConfig, newLayout);
 			parentNodeItems[index] = newConfig;
-			if (selectedAfterUpdate) {
-				const nodes = this.get("nodes");
-				const targetIndex = nodes.findIndex((nodeItem) => `${nodeItem.id}` === `${newConfig.id}`);
-				nodes.splice(targetIndex, 1, newConfig);
-				this.set("nodes", [...nodes]);
+			const selectedNodes = this.get("nodes");
+			const targetIndex = selectedNodes.findIndex((nodeItem) => `${nodeItem.id}` === `${newConfig.id}`);
+			if (targetIndex !== -1) {
+				selectedNodes.splice(targetIndex, 1, newConfig);
+				this.set("nodes", [...selectedNodes]);
 			}
 			if ((0, _tmagic_utils.isPage)(newConfig) || (0, _tmagic_utils.isPageFragment)(newConfig)) this.set("page", newConfig);
 			this.addModifiedNodeId(newConfig.id);
@@ -6188,9 +6230,12 @@
 		* 将id为id1的组件移动到id为id2的组件位置上，例如：[1,2,3,4] -> sort(1,3) -> [2,1,3,4]
 		* @param id1 组件ID
 		* @param id2 组件ID
+		* @param options 可选配置
+		* @param options.doNotSelect 排序后是否不更新当前选中节点（默认 false）
 		* @returns void
 		*/
-		async sort(id1, id2) {
+		async sort(id1, id2, options) {
+			const { doNotSelect = false } = safeOptions(options);
 			this.captureSelectionBeforeOp();
 			const root = this.get("root");
 			if (!root) throw new Error("root为空");
@@ -6203,7 +6248,7 @@
 			const index1 = parent.items.findIndex((node) => `${node.id}` === `${id1}`);
 			parent.items.splice(index2, 0, ...parent.items.splice(index1, 1));
 			await this.update(parent);
-			await this.select(node);
+			if (!doNotSelect) await this.select(node);
 			this.get("stage")?.update({
 				config: cloneDeep(node),
 				parentId: parent.id,
@@ -6231,9 +6276,13 @@
 		/**
 		* 从localStorage中获取节点，然后添加到当前容器中
 		* @param position 粘贴的坐标
+		* @param collectorOptions 可选的依赖收集器配置
+		* @param options 可选配置
+		* @param options.doNotSelect 粘贴后是否不更新当前选中节点（默认 false）
 		* @returns 添加后的组件节点配置
 		*/
-		async paste(position = {}, collectorOptions) {
+		async paste(position = {}, collectorOptions, options) {
+			const { doNotSelect = false } = safeOptions(options);
 			const config = storage_default.getItem(COPY_STORAGE_KEY);
 			if (!Array.isArray(config)) return;
 			const node = this.get("node");
@@ -6244,7 +6293,7 @@
 			}
 			const pasteConfigs = await this.doPaste(config, position);
 			if (collectorOptions && typeof collectorOptions.isTarget === "function") props_default.replaceRelateId(config, pasteConfigs, collectorOptions);
-			return this.add(pasteConfigs, parent);
+			return this.add(pasteConfigs, parent, { doNotSelect });
 		}
 		async doPaste(config, position = {}) {
 			props_default.clearRelateId();
@@ -6265,14 +6314,17 @@
 		/**
 		* 将指点节点设置居中
 		* @param config 组件节点配置
+		* @param options 可选配置
+		* @param options.doNotSelect 居中后是否不更新当前选中节点（默认 false）
 		* @returns 当前组件节点配置
 		*/
-		async alignCenter(config) {
+		async alignCenter(config, options) {
+			const { doNotSelect = false } = safeOptions(options);
 			const nodes = Array.isArray(config) ? config : [config];
 			const stage = this.get("stage");
 			const newNodes = await Promise.all(nodes.map((node) => this.doAlignCenter(node)));
 			const newNode = await this.update(newNodes);
-			if (newNodes.length > 1) await stage?.multiSelect(newNodes.map((node) => node.id));
+			if (!doNotSelect) if (newNodes.length > 1) await stage?.multiSelect(newNodes.map((node) => node.id));
 			else await stage?.select(newNodes[0].id);
 			return newNode;
 		}
@@ -6317,8 +6369,11 @@
 		* 移动到指定容器中
 		* @param config 需要移动的节点
 		* @param targetId 容器ID
+		* @param options 可选配置
+		* @param options.doNotSelect 移动后是否不更新当前选中节点（默认 false）
 		*/
-		async moveToContainer(config, targetId) {
+		async moveToContainer(config, targetId, options) {
+			const { doNotSelect = false } = safeOptions(options);
 			this.captureSelectionBeforeOp();
 			const root = this.get("root");
 			const { node, parent, page: pageForOp } = this.getNodeInfo(config.id, false);
@@ -6340,15 +6395,17 @@
 				});
 				newConfig.style = getInitPositionStyle(newConfig.style, layout);
 				target.items.push(newConfig);
-				await stage.select(targetId);
+				if (!doNotSelect) await stage.select(targetId);
 				const targetParent = this.getParentById(target.id);
 				await stage.update({
 					config: cloneDeep(target),
 					parentId: targetParent?.id,
 					root: cloneDeep(root)
 				});
-				await this.select(newConfig);
-				stage.select(newConfig.id);
+				if (!doNotSelect) {
+					await this.select(newConfig);
+					stage.select(newConfig.id);
+				}
 				this.addModifiedNodeId(target.id);
 				this.addModifiedNodeId(parent.id);
 				this.pushOpHistory("update", { updatedItems: [{

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.7.14-beta.2",
+  "version": "1.7.14-beta.3",
   "name": "@tmagic/editor",
   "type": "module",
   "sideEffects": [
@@ -58,11 +58,11 @@
     "moveable": "^0.53.0",
     "serialize-javascript": "^7.0.0",
     "sortablejs": "^1.15.6",
-    "@tmagic/design": "1.7.14-beta.2",
-    "@tmagic/form": "1.7.14-beta.2",
-    "@tmagic/stage": "1.7.14-beta.2",
-    "@tmagic/table": "1.7.14-beta.2",
-    "@tmagic/utils": "1.7.14-beta.2"
+    "@tmagic/design": "1.7.14-beta.3",
+    "@tmagic/form": "1.7.14-beta.3",
+    "@tmagic/stage": "1.7.14-beta.3",
+    "@tmagic/table": "1.7.14-beta.3",
+    "@tmagic/utils": "1.7.14-beta.3"
   },
   "devDependencies": {
     "@types/events": "^3.0.3",
@@ -76,7 +76,7 @@
     "type-fest": "^5.2.0",
     "typescript": "^6.0.3",
     "vue": "^3.5.34",
-    "@tmagic/core": "1.7.14-beta.2"
+    "@tmagic/core": "1.7.14-beta.3"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/src/services/editor.ts

@@ -65,6 +65,25 @@ import type { HistoryOpContext } from '@editor/utils/editor-history';
 import { applyHistoryAddOp, applyHistoryRemoveOp, applyHistoryUpdateOp } from '@editor/utils/editor-history';
 import { beforePaste, getAddParent } from '@editor/utils/operator';
 
+/**
+ * 经过 BaseService 的插件 / 中间件包装后，源方法的最后一个形参可能被注入为 dispatch 函数
+ * 当 options 形参位置被注入为函数（或为 null）时，将其归一为空对象，避免后续逻辑误读
+ */
+const safeOptions = <T extends object>(options: unknown): T => {
+  const empty = {};
+  if (!options || typeof options === 'function') return empty as T;
+  return options as T;
+};
+
+/**
+ * 经过 BaseService 的插件 / 中间件包装后，源方法的形参可能被注入为 dispatch 函数
+ * 当 parent 形参位置被注入为函数（或为空值）时，归一为 null，由调用方继续走默认 parent 逻辑
+ */
+const safeParent = (parent: unknown): MContainer | null => {
+  if (!parent || typeof parent === 'function') return null;
+  return parent as MContainer;
+};
+
 class Editor extends BaseService {
   public state: StoreState = reactive({
     root: null,
@@ -349,9 +368,18 @@ class Editor extends BaseService {
    * 向指点容器添加组件节点
    * @param addConfig 将要添加的组件节点配置
    * @param parent 要添加到的容器组件节点配置，如果不设置，默认为当前选中的组件的父节点
+   * @param options 可选配置
+   * @param options.doNotSelect 添加后是否不更新当前选中节点（默认 false，添加后会选中新增的节点）
    * @returns 添加后的节点
    */
-  public async add(addNode: AddMNode | MNode[], parent?: MContainer | null): Promise<MNode | MNode[]> {
+  public async add(
+    addNode: AddMNode | MNode[],
+    parent?: MContainer | null,
+    options?: { doNotSelect?: boolean },
+  ): Promise<MNode | MNode[]> {
+    const safeParentNode = safeParent(parent);
+    const { doNotSelect = false } = safeOptions<{ doNotSelect?: boolean }>(options);
+
     this.captureSelectionBeforeOp();
 
     const stage = this.get('stage');
@@ -374,25 +402,29 @@ class Editor extends BaseService {
         if ((isPage(node) || isPageFragment(node)) && root) {
           return this.doAdd(node, root);
         }
-        const parentNode = parent && typeof parent !== 'function' ? parent : getAddParent(node);
+        const parentNode = safeParentNode ?? getAddParent(node);
         if (!parentNode) throw new Error('未找到父元素');
         return this.doAdd(node, parentNode);
       }),
     );
 
     if (newNodes.length > 1) {
-      const newNodeIds = newNodes.map((node) => node.id);
-      // 触发选中样式
-      stage?.multiSelect(newNodeIds);
-      await this.multiSelect(newNodeIds);
+      if (!doNotSelect) {
+        const newNodeIds = newNodes.map((node) => node.id);
+        // 触发选中样式
+        stage?.multiSelect(newNodeIds);
+        await this.multiSelect(newNodeIds);
+      }
     } else {
-      await this.select(newNodes[0]);
+      if (!doNotSelect) {
+        await this.select(newNodes[0]);
+      }
 
       if (isPage(newNodes[0])) {
         this.state.pageLength += 1;
       } else if (isPageFragment(newNodes[0])) {
         this.state.pageFragmentLength += 1;
-      } else {
+      } else if (!doNotSelect) {
         // 新增页面，这个时候页面还有渲染出来，此时select会出错，在runtime-ready的时候回去select
         stage?.select(newNodes[0].id);
       }
@@ -421,7 +453,9 @@ class Editor extends BaseService {
     return Array.isArray(addNode) ? newNodes : newNodes[0];
   }
 
-  public async doRemove(node: MNode): Promise<void> {
+  public async doRemove(node: MNode, options?: { doNotSelect?: boolean }): Promise<void> {
+    const { doNotSelect = false } = safeOptions<{ doNotSelect?: boolean }>(options);
+
     const root = this.get('root');
     if (!root) throw new Error('root不能为空');
 
@@ -437,6 +471,24 @@ class Editor extends BaseService {
     const stage = this.get('stage');
     stage?.remove({ id: node.id, parentId: parent.id, root: cloneDeep(root) });
 
+    if (doNotSelect) {
+      // 当被删除节点正好在当前选中列表中时，必须从 state 中移除引用，避免 state 持有已删除节点（与 doNotSelect 无关）
+      const selectedNodes = this.get('nodes');
+      const removedSelectedIndex = selectedNodes.findIndex((n: MNode) => `${n.id}` === `${node.id}`);
+      if (removedSelectedIndex !== -1) {
+        const nextSelected = [...selectedNodes];
+        nextSelected.splice(removedSelectedIndex, 1);
+        this.set('nodes', nextSelected);
+      }
+      // 同理，如果被删除的是当前 page，也清空 state.page，避免持有已删除页面
+      if (isPage(node) || isPageFragment(node)) {
+        const currentPage = this.get('page');
+        if (currentPage && `${currentPage.id}` === `${node.id}`) {
+          this.set('page', null);
+        }
+      }
+    }
+
     const selectDefault = async (pages: MNode[]) => {
       if (pages[0]) {
         await this.select(pages[0]);
@@ -453,14 +505,20 @@ class Editor extends BaseService {
     if (isPage(node)) {
       this.state.pageLength -= 1;
 
-      await selectDefault(rootItems);
+      if (!doNotSelect) {
+        await selectDefault(rootItems);
+      }
     } else if (isPageFragment(node)) {
       this.state.pageFragmentLength -= 1;
 
-      await selectDefault(rootItems);
+      if (!doNotSelect) {
+        await selectDefault(rootItems);
+      }
     } else {
-      await this.select(parent);
-      stage?.select(parent.id);
+      if (!doNotSelect) {
+        await this.select(parent);
+        stage?.select(parent.id);
+      }
 
       this.addModifiedNodeId(parent.id);
     }
@@ -473,9 +531,13 @@ class Editor extends BaseService {
 
   /**
    * 删除组件
-   * @param {Object} node
+   * @param {Object} node 要删除的节点或节点集合
+   * @param options 可选配置
+   * @param options.doNotSelect 删除后是否不更新当前选中节点（默认 false，删除后会选中父节点或首个页面）
    */
-  public async remove(nodeOrNodeList: MNode | MNode[]): Promise<void> {
+  public async remove(nodeOrNodeList: MNode | MNode[], options?: { doNotSelect?: boolean }): Promise<void> {
+    const { doNotSelect = false } = safeOptions<{ doNotSelect?: boolean }>(options);
+
     this.captureSelectionBeforeOp();
 
     const nodes = Array.isArray(nodeOrNodeList) ? nodeOrNodeList : [nodeOrNodeList];
@@ -499,7 +561,7 @@ class Editor extends BaseService {
       }
     }
 
-    await Promise.all(nodes.map((node) => this.doRemove(node)));
+    await Promise.all(nodes.map((node) => this.doRemove(node, { doNotSelect })));
 
     if (removedItems.length > 0 && pageForOp) {
       this.pushOpHistory('remove', { removedItems }, pageForOp);
@@ -510,10 +572,7 @@ class Editor extends BaseService {
 
   public async doUpdate(
     config: MNode,
-    {
-      changeRecords = [],
-      selectedAfterUpdate = true,
-    }: { changeRecords?: ChangeRecord[]; selectedAfterUpdate?: boolean } = {},
+    { changeRecords = [] }: { changeRecords?: ChangeRecord[] } = {},
   ): Promise<{ newNode: MNode; oldNode: MNode; changeRecords?: ChangeRecord[] }> {
     const root = this.get('root');
     if (!root) throw new Error('root为空');
@@ -557,12 +616,12 @@ class Editor extends BaseService {
 
     parentNodeItems[index] = newConfig;
 
-    // 将update后的配置更新到nodes中
-    if (selectedAfterUpdate) {
-      const nodes = this.get('nodes');
-      const targetIndex = nodes.findIndex((nodeItem: MNode) => `${nodeItem.id}` === `${newConfig.id}`);
-      nodes.splice(targetIndex, 1, newConfig);
-      this.set('nodes', [...nodes]);
+    // 当被更新节点正好在当前选中列表中时，必须同步引用，否则 state 会持有已被替换的旧节点
+    const selectedNodes = this.get('nodes');
+    const targetIndex = selectedNodes.findIndex((nodeItem: MNode) => `${nodeItem.id}` === `${newConfig.id}`);
+    if (targetIndex !== -1) {
+      selectedNodes.splice(targetIndex, 1, newConfig);
+      this.set('nodes', [...selectedNodes]);
     }
 
     if (isPage(newConfig) || isPageFragment(newConfig)) {
@@ -586,7 +645,7 @@ class Editor extends BaseService {
    */
   public async update(
     config: MNode | MNode[],
-    data: { changeRecords?: ChangeRecord[]; selectedAfterUpdate?: boolean } = {},
+    data: { changeRecords?: ChangeRecord[] } = {},
   ): Promise<MNode | MNode[]> {
     this.captureSelectionBeforeOp();
 
@@ -620,9 +679,13 @@ class Editor extends BaseService {
    * 将id为id1的组件移动到id为id2的组件位置上，例如：[1,2,3,4] -> sort(1,3) -> [2,1,3,4]
    * @param id1 组件ID
    * @param id2 组件ID
+   * @param options 可选配置
+   * @param options.doNotSelect 排序后是否不更新当前选中节点（默认 false）
    * @returns void
    */
-  public async sort(id1: Id, id2: Id): Promise<void> {
+  public async sort(id1: Id, id2: Id, options?: { doNotSelect?: boolean }): Promise<void> {
+    const { doNotSelect = false } = safeOptions<{ doNotSelect?: boolean }>(options);
+
     this.captureSelectionBeforeOp();
 
     const root = this.get('root');
@@ -642,7 +705,9 @@ class Editor extends BaseService {
     parent.items.splice(index2, 0, ...parent.items.splice(index1, 1));
 
     await this.update(parent);
-    await this.select(node);
+    if (!doNotSelect) {
+      await this.select(node);
+    }
 
     this.get('stage')?.update({
       config: cloneDeep(node),
@@ -682,9 +747,18 @@ class Editor extends BaseService {
   /**
    * 从localStorage中获取节点，然后添加到当前容器中
    * @param position 粘贴的坐标
+   * @param collectorOptions 可选的依赖收集器配置
+   * @param options 可选配置
+   * @param options.doNotSelect 粘贴后是否不更新当前选中节点（默认 false）
    * @returns 添加后的组件节点配置
    */
-  public async paste(position: PastePosition = {}, collectorOptions?: TargetOptions): Promise<MNode | MNode[] | void> {
+  public async paste(
+    position: PastePosition = {},
+    collectorOptions?: TargetOptions,
+    options?: { doNotSelect?: boolean },
+  ): Promise<MNode | MNode[] | void> {
+    const { doNotSelect = false } = safeOptions<{ doNotSelect?: boolean }>(options);
+
     const config: MNode[] = storageService.getItem(COPY_STORAGE_KEY);
     if (!Array.isArray(config)) return;
 
@@ -704,7 +778,7 @@ class Editor extends BaseService {
       propsService.replaceRelateId(config, pasteConfigs, collectorOptions);
     }
 
-    return this.add(pasteConfigs, parent);
+    return this.add(pasteConfigs, parent, { doNotSelect });
   }
 
   public async doPaste(config: MNode[], position: PastePosition = {}): Promise<MNode[]> {
@@ -732,9 +806,13 @@ class Editor extends BaseService {
   /**
    * 将指点节点设置居中
    * @param config 组件节点配置
+   * @param options 可选配置
+   * @param options.doNotSelect 居中后是否不更新当前选中节点（默认 false）
    * @returns 当前组件节点配置
    */
-  public async alignCenter(config: MNode | MNode[]): Promise<MNode | MNode[]> {
+  public async alignCenter(config: MNode | MNode[], options?: { doNotSelect?: boolean }): Promise<MNode | MNode[]> {
+    const { doNotSelect = false } = safeOptions<{ doNotSelect?: boolean }>(options);
+
     const nodes = Array.isArray(config) ? config : [config];
     const stage = this.get('stage');
 
@@ -742,10 +820,12 @@ class Editor extends BaseService {
 
     const newNode = await this.update(newNodes);
 
-    if (newNodes.length > 1) {
-      await stage?.multiSelect(newNodes.map((node) => node.id));
-    } else {
-      await stage?.select(newNodes[0].id);
+    if (!doNotSelect) {
+      if (newNodes.length > 1) {
+        await stage?.multiSelect(newNodes.map((node) => node.id));
+      } else {
+        await stage?.select(newNodes[0].id);
+      }
     }
 
     return newNode;
@@ -808,8 +888,16 @@ class Editor extends BaseService {
    * 移动到指定容器中
    * @param config 需要移动的节点
    * @param targetId 容器ID
+   * @param options 可选配置
+   * @param options.doNotSelect 移动后是否不更新当前选中节点（默认 false）
    */
-  public async moveToContainer(config: MNode, targetId: Id): Promise<MNode | undefined> {
+  public async moveToContainer(
+    config: MNode,
+    targetId: Id,
+    options?: { doNotSelect?: boolean },
+  ): Promise<MNode | undefined> {
+    const { doNotSelect = false } = safeOptions<{ doNotSelect?: boolean }>(options);
+
     this.captureSelectionBeforeOp();
 
     const root = this.get('root');
@@ -837,7 +925,9 @@ class Editor extends BaseService {
 
       target.items.push(newConfig);
 
-      await stage.select(targetId);
+      if (!doNotSelect) {
+        await stage.select(targetId);
+      }
 
       const targetParent = this.getParentById(target.id);
       await stage.update({
@@ -846,8 +936,10 @@ class Editor extends BaseService {
         root: cloneDeep(root),
       });
 
-      await this.select(newConfig);
-      stage.select(newConfig.id);
+      if (!doNotSelect) {
+        await this.select(newConfig);
+        stage.select(newConfig.id);
+      }
 
       this.addModifiedNodeId(target.id);
       this.addModifiedNodeId(parent.id);

package/types/index.d.ts

@@ -405,21 +405,29 @@ declare class Editor extends export_default {
    * 向指点容器添加组件节点
    * @param addConfig 将要添加的组件节点配置
    * @param parent 要添加到的容器组件节点配置，如果不设置，默认为当前选中的组件的父节点
+   * @param options 可选配置
+   * @param options.doNotSelect 添加后是否不更新当前选中节点（默认 false，添加后会选中新增的节点）
    * @returns 添加后的节点
    */
-  add(addNode: AddMNode | MNode[], parent?: MContainer | null): Promise<MNode | MNode[]>;
-  doRemove(node: MNode): Promise<void>;
+  add(addNode: AddMNode | MNode[], parent?: MContainer | null, options?: {
+    doNotSelect?: boolean;
+  }): Promise<MNode | MNode[]>;
+  doRemove(node: MNode, options?: {
+    doNotSelect?: boolean;
+  }): Promise<void>;
   /**
    * 删除组件
-   * @param {Object} node
+   * @param {Object} node 要删除的节点或节点集合
+   * @param options 可选配置
+   * @param options.doNotSelect 删除后是否不更新当前选中节点（默认 false，删除后会选中父节点或首个页面）
    */
-  remove(nodeOrNodeList: MNode | MNode[]): Promise<void>;
+  remove(nodeOrNodeList: MNode | MNode[], options?: {
+    doNotSelect?: boolean;
+  }): Promise<void>;
   doUpdate(config: MNode, {
-    changeRecords,
-    selectedAfterUpdate
+    changeRecords
   }?: {
     changeRecords?: ChangeRecord[];
-    selectedAfterUpdate?: boolean;
   }): Promise<{
     newNode: MNode;
     oldNode: MNode;
@@ -433,15 +441,18 @@ declare class Editor extends export_default {
    */
   update(config: MNode | MNode[], data?: {
     changeRecords?: ChangeRecord[];
-    selectedAfterUpdate?: boolean;
   }): Promise<MNode | MNode[]>;
   /**
    * 将id为id1的组件移动到id为id2的组件位置上，例如：[1,2,3,4] -> sort(1,3) -> [2,1,3,4]
    * @param id1 组件ID
    * @param id2 组件ID
+   * @param options 可选配置
+   * @param options.doNotSelect 排序后是否不更新当前选中节点（默认 false）
    * @returns void
    */
-  sort(id1: Id, id2: Id): Promise<void>;
+  sort(id1: Id, id2: Id, options?: {
+    doNotSelect?: boolean;
+  }): Promise<void>;
   /**
    * 将组件节点配置存储到localStorage中
    * @param config 组件节点配置
@@ -457,17 +468,26 @@ declare class Editor extends export_default {
   /**
    * 从localStorage中获取节点，然后添加到当前容器中
    * @param position 粘贴的坐标
+   * @param collectorOptions 可选的依赖收集器配置
+   * @param options 可选配置
+   * @param options.doNotSelect 粘贴后是否不更新当前选中节点（默认 false）
    * @returns 添加后的组件节点配置
    */
-  paste(position?: PastePosition, collectorOptions?: TargetOptions): Promise<MNode | MNode[] | void>;
+  paste(position?: PastePosition, collectorOptions?: TargetOptions, options?: {
+    doNotSelect?: boolean;
+  }): Promise<MNode | MNode[] | void>;
   doPaste(config: MNode[], position?: PastePosition): Promise<MNode[]>;
   doAlignCenter(config: MNode): Promise<MNode>;
   /**
    * 将指点节点设置居中
    * @param config 组件节点配置
+   * @param options 可选配置
+   * @param options.doNotSelect 居中后是否不更新当前选中节点（默认 false）
    * @returns 当前组件节点配置
    */
-  alignCenter(config: MNode | MNode[]): Promise<MNode | MNode[]>;
+  alignCenter(config: MNode | MNode[], options?: {
+    doNotSelect?: boolean;
+  }): Promise<MNode | MNode[]>;
   /**
    * 移动当前选中节点位置
    * @param offset 偏移量
@@ -477,8 +497,12 @@ declare class Editor extends export_default {
    * 移动到指定容器中
    * @param config 需要移动的节点
    * @param targetId 容器ID
+   * @param options 可选配置
+   * @param options.doNotSelect 移动后是否不更新当前选中节点（默认 false）
    */
-  moveToContainer(config: MNode, targetId: Id): Promise<MNode | undefined>;
+  moveToContainer(config: MNode, targetId: Id, options?: {
+    doNotSelect?: boolean;
+  }): Promise<MNode | undefined>;
   dragTo(config: MNode | MNode[], targetParent: MContainer, targetIndex: number): Promise<void>;
   /**
    * 撤销当前操作