@tmagic/editor 1.7.14-beta.2 → 1.8.0-beta.0

package/src/services/editor.ts

@@ -33,6 +33,7 @@ import type {
   AddMNode,
   AsyncHookPlugin,
   AsyncMethodName,
+  DslOpOptions,
   EditorEvents,
   EditorNodeInfo,
   HistoryOpType,
@@ -65,6 +66,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,
@@ -172,6 +192,22 @@ class Editor extends BaseService {
     return parent;
   }
 
+  /**
+   * 判断给定节点是否位于非当前页面（即选中该节点将会引起当前页面切换）
+   * @param node 节点
+   * @returns true 表示该节点位于非当前页面
+   */
+  public isOnDifferentPage(node: MNode): boolean {
+    const currentPageId = this.get('page')?.id;
+    if (currentPageId === undefined || currentPageId === null) return false;
+    if (isPage(node) || isPageFragment(node)) {
+      return `${node.id}` !== `${currentPageId}`;
+    }
+    const nodePage = this.getNodeInfo(node.id, false).page;
+    if (!nodePage) return false;
+    return `${nodePage.id}` !== `${currentPageId}`;
+  }
+
   /**
    * 只有容器拥有布局
    */
@@ -349,9 +385,19 @@ class Editor extends BaseService {
    * 向指点容器添加组件节点
    * @param addConfig 将要添加的组件节点配置
    * @param parent 要添加到的容器组件节点配置，如果不设置，默认为当前选中的组件的父节点
+   * @param options 可选配置
+   * @param options.doNotSelect 添加后是否不更新当前选中节点（默认 false，添加后会选中新增的节点）
+   * @param options.doNotSwitchPage 添加后是否不切换当前页面（默认 false；新增页面 / 跨页新增时为 true 会跳过会引发页面切换的选中操作）
    * @returns 添加后的节点
    */
-  public async add(addNode: AddMNode | MNode[], parent?: MContainer | null): Promise<MNode | MNode[]> {
+  public async add(
+    addNode: AddMNode | MNode[],
+    parent?: MContainer | null,
+    options?: DslOpOptions,
+  ): Promise<MNode | MNode[]> {
+    const safeParentNode = safeParent(parent);
+    const { doNotSelect = false, doNotSwitchPage = false } = safeOptions<DslOpOptions>(options);
+
     this.captureSelectionBeforeOp();
 
     const stage = this.get('stage');
@@ -374,25 +420,34 @@ 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);
+      // 多选时只要任一新增节点位于非当前页面，触发的 multiSelect 就会引起页面切换
+      const wouldSwitchPage = newNodes.some((n) => this.isOnDifferentPage(n));
+      if (!doNotSelect && !(doNotSwitchPage && wouldSwitchPage)) {
+        const newNodeIds = newNodes.map((node) => node.id);
+        // 触发选中样式
+        stage?.multiSelect(newNodeIds);
+        await this.multiSelect(newNodeIds);
+      }
     } else {
-      await this.select(newNodes[0]);
+      const wouldSwitchPage = this.isOnDifferentPage(newNodes[0]);
+      const skipSelect = doNotSelect || (doNotSwitchPage && wouldSwitchPage);
+
+      if (!skipSelect) {
+        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 (!skipSelect) {
         // 新增页面，这个时候页面还有渲染出来，此时select会出错，在runtime-ready的时候回去select
         stage?.select(newNodes[0].id);
       }
@@ -421,7 +476,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?: DslOpOptions): Promise<void> {
+    const { doNotSelect = false, doNotSwitchPage = false } = safeOptions<DslOpOptions>(options);
+
     const root = this.get('root');
     if (!root) throw new Error('root不能为空');
 
@@ -437,6 +494,22 @@ class Editor extends BaseService {
     const stage = this.get('stage');
     stage?.remove({ id: node.id, parentId: parent.id, root: cloneDeep(root) });
 
+    // 始终清理已删除节点在 state 中的残留引用：
+    // - 即使后续会调用 selectDefault / select(parent) 覆盖，跳过这些调用（doNotSelect / doNotSwitchPage）时也不能让 state 持有已删除节点
+    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);
+    }
+    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 +526,21 @@ class Editor extends BaseService {
     if (isPage(node)) {
       this.state.pageLength -= 1;
 
-      await selectDefault(rootItems);
+      // 删除页面后默认会切到首个剩余页面（selectDefault），doNotSwitchPage 时跳过这次自动切换
+      if (!doNotSelect && !doNotSwitchPage) {
+        await selectDefault(rootItems);
+      }
     } else if (isPageFragment(node)) {
       this.state.pageFragmentLength -= 1;
 
-      await selectDefault(rootItems);
+      if (!doNotSelect && !doNotSwitchPage) {
+        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 +553,14 @@ class Editor extends BaseService {
 
   /**
    * 删除组件
-   * @param {Object} node
+   * @param {Object} node 要删除的节点或节点集合
+   * @param options 可选配置
+   * @param options.doNotSelect 删除后是否不更新当前选中节点（默认 false，删除后会选中父节点或首个页面）
+   * @param options.doNotSwitchPage 删除后是否不切换当前页面（默认 false；删除页面 / 页面片段时为 true 会跳过自动切换到首个剩余页面）
    */
-  public async remove(nodeOrNodeList: MNode | MNode[]): Promise<void> {
+  public async remove(nodeOrNodeList: MNode | MNode[], options?: DslOpOptions): Promise<void> {
+    const { doNotSelect = false, doNotSwitchPage = false } = safeOptions<DslOpOptions>(options);
+
     this.captureSelectionBeforeOp();
 
     const nodes = Array.isArray(nodeOrNodeList) ? nodeOrNodeList : [nodeOrNodeList];
@@ -499,7 +584,7 @@ class Editor extends BaseService {
       }
     }
 
-    await Promise.all(nodes.map((node) => this.doRemove(node)));
+    await Promise.all(nodes.map((node) => this.doRemove(node, { doNotSelect, doNotSwitchPage })));
 
     if (removedItems.length > 0 && pageForOp) {
       this.pushOpHistory('remove', { removedItems }, pageForOp);
@@ -510,10 +595,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,16 +639,20 @@ 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]);
     }
 
+    // 只有被更新节点正好是当前选中页面时才同步 state.page，避免「更新非当前页」误将编辑器切到该页
     if (isPage(newConfig) || isPageFragment(newConfig)) {
-      this.set('page', newConfig as MPage | MPageFragment);
+      const currentPage = this.get('page');
+      if (currentPage && `${currentPage.id}` === `${newConfig.id}`) {
+        this.set('page', newConfig as MPage | MPageFragment);
+      }
     }
 
     this.addModifiedNodeId(newConfig.id);
@@ -586,7 +672,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 +706,14 @@ 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）
+   * @param options.doNotSwitchPage 排序后是否不切换当前页面（排序只发生在同一父节点内，方法内为空操作；保留以与其它 DSL 操作 API 一致）
    * @returns void
    */
-  public async sort(id1: Id, id2: Id): Promise<void> {
+  public async sort(id1: Id, id2: Id, options?: DslOpOptions): Promise<void> {
+    const { doNotSelect = false } = safeOptions<DslOpOptions>(options);
+
     this.captureSelectionBeforeOp();
 
     const root = this.get('root');
@@ -642,7 +733,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 +775,19 @@ class Editor extends BaseService {
   /**
    * 从localStorage中获取节点，然后添加到当前容器中
    * @param position 粘贴的坐标
+   * @param collectorOptions 可选的依赖收集器配置
+   * @param options 可选配置
+   * @param options.doNotSelect 粘贴后是否不更新当前选中节点（默认 false）
+   * @param options.doNotSwitchPage 粘贴后是否不切换当前页面（默认 false；跨页粘贴时为 true 会跳过页面切换）
    * @returns 添加后的组件节点配置
    */
-  public async paste(position: PastePosition = {}, collectorOptions?: TargetOptions): Promise<MNode | MNode[] | void> {
+  public async paste(
+    position: PastePosition = {},
+    collectorOptions?: TargetOptions,
+    options?: DslOpOptions,
+  ): Promise<MNode | MNode[] | void> {
+    const { doNotSelect = false, doNotSwitchPage = false } = safeOptions<DslOpOptions>(options);
+
     const config: MNode[] = storageService.getItem(COPY_STORAGE_KEY);
     if (!Array.isArray(config)) return;
 
@@ -704,7 +807,7 @@ class Editor extends BaseService {
       propsService.replaceRelateId(config, pasteConfigs, collectorOptions);
     }
 
-    return this.add(pasteConfigs, parent);
+    return this.add(pasteConfigs, parent, { doNotSelect, doNotSwitchPage });
   }
 
   public async doPaste(config: MNode[], position: PastePosition = {}): Promise<MNode[]> {
@@ -732,9 +835,14 @@ class Editor extends BaseService {
   /**
    * 将指点节点设置居中
    * @param config 组件节点配置
+   * @param options 可选配置
+   * @param options.doNotSelect 居中后是否不更新当前选中节点（默认 false）
+   * @param options.doNotSwitchPage 居中后是否不切换当前页面（居中只更新节点 style，方法内为空操作；保留以与其它 DSL 操作 API 一致）
    * @returns 当前组件节点配置
    */
-  public async alignCenter(config: MNode | MNode[]): Promise<MNode | MNode[]> {
+  public async alignCenter(config: MNode | MNode[], options?: DslOpOptions): Promise<MNode | MNode[]> {
+    const { doNotSelect = false } = safeOptions<DslOpOptions>(options);
+
     const nodes = Array.isArray(config) ? config : [config];
     const stage = this.get('stage');
 
@@ -742,10 +850,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 +918,13 @@ class Editor extends BaseService {
    * 移动到指定容器中
    * @param config 需要移动的节点
    * @param targetId 容器ID
+   * @param options 可选配置
+   * @param options.doNotSelect 移动后是否不更新当前选中节点（默认 false）
+   * @param options.doNotSwitchPage 移动后是否不切换当前页面（默认 false；目标容器位于其它页面时为 true 会跳过自动选中以避免页面切换）
    */
-  public async moveToContainer(config: MNode, targetId: Id): Promise<MNode | undefined> {
+  public async moveToContainer(config: MNode, targetId: Id, options?: DslOpOptions): Promise<MNode | undefined> {
+    const { doNotSelect = false, doNotSwitchPage = false } = safeOptions<DslOpOptions>(options);
+
     this.captureSelectionBeforeOp();
 
     const root = this.get('root');
@@ -837,7 +952,13 @@ class Editor extends BaseService {
 
       target.items.push(newConfig);
 
-      await stage.select(targetId);
+      // 目标容器是否在非当前页面：选中目标会触发当前页面切换
+      const targetWouldSwitchPage = this.isOnDifferentPage(target);
+      const skipSelect = doNotSelect || (doNotSwitchPage && targetWouldSwitchPage);
+
+      if (!skipSelect) {
+        await stage.select(targetId);
+      }
 
       const targetParent = this.getParentById(target.id);
       await stage.update({
@@ -846,8 +967,10 @@ class Editor extends BaseService {
         root: cloneDeep(root),
       });
 
-      await this.select(newConfig);
-      stage.select(newConfig.id);
+      if (!skipSelect) {
+        await this.select(newConfig);
+        stage.select(newConfig.id);
+      }
 
       this.addModifiedNodeId(target.id);
       this.addModifiedNodeId(parent.id);

package/src/theme/props-panel.scss

@@ -25,26 +25,6 @@
         right: calc(15px + var(--props-style-panel-width));
       }
     }
-
-    .tmagic-design-form {
-      padding-right: 10px;
-      padding-left: 10px;
-
-      > .m-container-tab {
-        > .tmagic-design-tabs {
-          > .el-tabs__content {
-            padding-top: 55px;
-          }
-          > .el-tabs__header.is-top {
-            position: absolute;
-            top: 0;
-            width: 100%;
-            background: #fff;
-            z-index: 3;
-          }
-        }
-      }
-    }
   }
 
   .m-editor-props-style-panel {
@@ -142,6 +122,26 @@
   }
 }
 
+.m-editor-props-form-panel-form {
+  padding-right: 10px;
+  padding-left: 10px;
+
+  > .m-container-tab {
+    > .tmagic-design-tabs {
+      > .el-tabs__content {
+        padding-top: 55px;
+      }
+      > .el-tabs__header.is-top {
+        position: absolute;
+        top: 0;
+        width: 100%;
+        background: #fff;
+        z-index: 3;
+      }
+    }
+  }
+}
+
 .m-editor-props-panel-popper {
   &.small {
     span,

package/src/type.ts

@@ -873,3 +873,13 @@ export const canUsePluginMethods = {
 };
 
 export type AsyncMethodName = Writable<(typeof canUsePluginMethods)['async']>;
+
+/**
+ * DSL 修改类操作的通用配置
+ * - doNotSelect: 操作后是否不要自动触发选中（不调用 this.select / this.multiSelect / stage.select / stage.multiSelect）
+ * - doNotSwitchPage: 操作若会引发当前页面切换（如新增 / 删除 / 跨页移动），是否跳过这次切换
+ */
+export type DslOpOptions = {
+  doNotSelect?: boolean;
+  doNotSwitchPage?: boolean;
+};

package/types/index.d.ts

@@ -375,6 +375,12 @@ declare class Editor extends export_default {
    * @returns 指点组件的父节点配置
    */
   getParentById(id: Id, raw?: boolean): MContainer | null;
+  /**
+   * 判断给定节点是否位于非当前页面（即选中该节点将会引起当前页面切换）
+   * @param node 节点
+   * @returns true 表示该节点位于非当前页面
+   */
+  isOnDifferentPage(node: MNode): boolean;
   /**
    * 只有容器拥有布局
    */
@@ -405,21 +411,25 @@ declare class Editor extends export_default {
    * 向指点容器添加组件节点
    * @param addConfig 将要添加的组件节点配置
    * @param parent 要添加到的容器组件节点配置，如果不设置，默认为当前选中的组件的父节点
+   * @param options 可选配置
+   * @param options.doNotSelect 添加后是否不更新当前选中节点（默认 false，添加后会选中新增的节点）
+   * @param options.doNotSwitchPage 添加后是否不切换当前页面（默认 false；新增页面 / 跨页新增时为 true 会跳过会引发页面切换的选中操作）
    * @returns 添加后的节点
    */
-  add(addNode: AddMNode | MNode[], parent?: MContainer | null): Promise<MNode | MNode[]>;
-  doRemove(node: MNode): Promise<void>;
+  add(addNode: AddMNode | MNode[], parent?: MContainer | null, options?: DslOpOptions): Promise<MNode | MNode[]>;
+  doRemove(node: MNode, options?: DslOpOptions): Promise<void>;
   /**
    * 删除组件
-   * @param {Object} node
+   * @param {Object} node 要删除的节点或节点集合
+   * @param options 可选配置
+   * @param options.doNotSelect 删除后是否不更新当前选中节点（默认 false，删除后会选中父节点或首个页面）
+   * @param options.doNotSwitchPage 删除后是否不切换当前页面（默认 false；删除页面 / 页面片段时为 true 会跳过自动切换到首个剩余页面）
    */
-  remove(nodeOrNodeList: MNode | MNode[]): Promise<void>;
+  remove(nodeOrNodeList: MNode | MNode[], options?: DslOpOptions): Promise<void>;
   doUpdate(config: MNode, {
-    changeRecords,
-    selectedAfterUpdate
+    changeRecords
   }?: {
     changeRecords?: ChangeRecord[];
-    selectedAfterUpdate?: boolean;
   }): Promise<{
     newNode: MNode;
     oldNode: MNode;
@@ -433,15 +443,17 @@ 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）
+   * @param options.doNotSwitchPage 排序后是否不切换当前页面（排序只发生在同一父节点内，方法内为空操作；保留以与其它 DSL 操作 API 一致）
    * @returns void
    */
-  sort(id1: Id, id2: Id): Promise<void>;
+  sort(id1: Id, id2: Id, options?: DslOpOptions): Promise<void>;
   /**
    * 将组件节点配置存储到localStorage中
    * @param config 组件节点配置
@@ -457,17 +469,24 @@ declare class Editor extends export_default {
   /**
    * 从localStorage中获取节点，然后添加到当前容器中
    * @param position 粘贴的坐标
+   * @param collectorOptions 可选的依赖收集器配置
+   * @param options 可选配置
+   * @param options.doNotSelect 粘贴后是否不更新当前选中节点（默认 false）
+   * @param options.doNotSwitchPage 粘贴后是否不切换当前页面（默认 false；跨页粘贴时为 true 会跳过页面切换）
    * @returns 添加后的组件节点配置
    */
-  paste(position?: PastePosition, collectorOptions?: TargetOptions): Promise<MNode | MNode[] | void>;
+  paste(position?: PastePosition, collectorOptions?: TargetOptions, options?: DslOpOptions): Promise<MNode | MNode[] | void>;
   doPaste(config: MNode[], position?: PastePosition): Promise<MNode[]>;
   doAlignCenter(config: MNode): Promise<MNode>;
   /**
    * 将指点节点设置居中
    * @param config 组件节点配置
+   * @param options 可选配置
+   * @param options.doNotSelect 居中后是否不更新当前选中节点（默认 false）
+   * @param options.doNotSwitchPage 居中后是否不切换当前页面（居中只更新节点 style，方法内为空操作；保留以与其它 DSL 操作 API 一致）
    * @returns 当前组件节点配置
    */
-  alignCenter(config: MNode | MNode[]): Promise<MNode | MNode[]>;
+  alignCenter(config: MNode | MNode[], options?: DslOpOptions): Promise<MNode | MNode[]>;
   /**
    * 移动当前选中节点位置
    * @param offset 偏移量
@@ -477,8 +496,11 @@ declare class Editor extends export_default {
    * 移动到指定容器中
    * @param config 需要移动的节点
    * @param targetId 容器ID
+   * @param options 可选配置
+   * @param options.doNotSelect 移动后是否不更新当前选中节点（默认 false）
+   * @param options.doNotSwitchPage 移动后是否不切换当前页面（默认 false；目标容器位于其它页面时为 true 会跳过自动选中以避免页面切换）
    */
-  moveToContainer(config: MNode, targetId: Id): Promise<MNode | undefined>;
+  moveToContainer(config: MNode, targetId: Id, options?: DslOpOptions): Promise<MNode | undefined>;
   dragTo(config: MNode | MNode[], targetParent: MContainer, targetIndex: number): Promise<void>;
   /**
    * 撤销当前操作
@@ -1485,6 +1507,15 @@ declare const canUsePluginMethods: {
   sync: never[];
 };
 type AsyncMethodName = Writable<(typeof canUsePluginMethods)['async']>;
+/**
+ * DSL 修改类操作的通用配置
+ * - doNotSelect: 操作后是否不要自动触发选中（不调用 this.select / this.multiSelect / stage.select / stage.multiSelect）
+ * - doNotSwitchPage: 操作若会引发当前页面切换（如新增 / 删除 / 跨页移动），是否跳过这次切换
+ */
+type DslOpOptions = {
+  doNotSelect?: boolean;
+  doNotSwitchPage?: boolean;
+};
 //#endregion
 //#region temp/packages/form/src/schema.d.ts
 interface ChangeRecord$1 {
@@ -4148,4 +4179,4 @@ declare const _default$36: {
   install: (app: App, opt?: Partial<EditorInstallOptions | DesignPluginOptions | FormInstallOptions>) => void;
 };
 //#endregion
-export { AddMNode, AddPrefixToObject, AsyncAfterHook, AsyncBeforeHook, AsyncHookPlugin, AsyncMethodName, BeforeAdd, CODE_DRAFT_STORAGE_KEY, COPY_CODE_STORAGE_KEY, COPY_DS_STORAGE_KEY, COPY_STORAGE_KEY, CanDropInFunction, CanDropInScene, _default as CodeBlockEditor, _default$1 as CodeBlockList, _default$2 as CodeBlockListPanel, CodeBlockListPanelSlots, CodeBlockListSlots, CodeDeleteErrorType, CodeDslItem, CodeParamStatement, CodeRelation, _default$3 as CodeSelect, _default$4 as CodeSelectCol, CodeState, ColumnLayout, CombineInfo, ComponentGroup, ComponentGroupState, ComponentItem, _default$5 as ComponentListPanel, ComponentListPanelSlots, _default$6 as CondOpSelect, _default$7 as ContentMenu, CustomContentMenuFunction, DEFAULT_LEFT_COLUMN_WIDTH, DEFAULT_RIGHT_COLUMN_WIDTH, _default$8 as DataSourceAddButton, _default$9 as DataSourceConfigPanel, _default$10 as DataSourceFieldSelect, _default$11 as DataSourceFields, _default$12 as DataSourceInput, DataSourceListSlots, _default$13 as DataSourceMethodSelect, _default$14 as DataSourceMethods, _default$15 as DataSourceMocks, _default$16 as DataSourceSelect, DatasourceTypeOption, DepTargetType, _default$17 as DisplayConds, DragClassification, DragType, EditorEvents, EditorInstallOptions, EditorNodeInfo, EditorSlots, EventBus, EventBusEvent, _default$18 as EventSelect, Fixed2Other, _default$19 as FloatingBox, FrameworkSlots, GetColumnWidth, GetConfig, H_GUIDE_LINE_STORAGE_KEY, HistoryOpType, HistoryState, _default$20 as Icon, IdleTask, IdleTaskEvents, IsExpandableFunction, KeyBindingCacheItem, KeyBindingCommand, KeyBindingItem, _default$21 as KeyValue, Keys, LEFT_COLUMN_WIDTH_STORAGE_KEY, LayerNodeSlots, LayerNodeStatus, LayerOffset, _default$22 as LayerPanel, LayerPanelSlots, Layout, _default$23 as LayoutContainer, _default$23 as SplitView, ListState, MIN_CENTER_COLUMN_WIDTH, MIN_LEFT_COLUMN_WIDTH, MIN_RIGHT_COLUMN_WIDTH, MenuBarData, MenuButton, MenuComponent, MenuItem, type OnDrag, PROPS_PANEL_WIDTH_STORAGE_KEY, PageBarSortOptions, _default$24 as PageFragmentSelect, PartSortableOptions, PastePosition, PropsFormConfigFunction, _default$25 as PropsFormPanel, PropsFormValueFunction, _default$26 as PropsPanel, PropsPanelSlots, PropsState, RIGHT_COLUMN_WIDTH_STORAGE_KEY, _default$27 as Resizer, ScrollViewer, ScrollViewerEvent, ScrollViewerSlots, Services, SetColumnWidth, SideBarData, SideComponent, SideItem, SideItemKey, SidebarSlots, StageCore, StageOptions, StageOverlayState, StageRect, StageSlots, StepValue, StoreState, StoreStateKey, _default$28 as StyleSetter, SyncAfterHook, SyncBeforeHook, SyncHookPlugin, _default$29 as TMagicCodeEditor, _default$30 as TMagicEditor, _default$31 as ToolButton, _default$32 as Tree, _default$33 as TreeNode, TreeNodeData, UI_SELECT_MODE_EVENT_NAME, UiState, UndoRedo, V_GUIDE_LINE_STORAGE_KEY, WorkspaceSlots, advancedTabConfig, arrayOptions, beforePaste, buildChangeRecords, calcAlignCenterStyle, calcLayerTargetIndex, calcMoveStyle, canUsePluginMethods, change2Fixed, classifyDragSources, _default$34 as codeBlockService, collectRelatedNodes, _default$35 as dataSourceService, debug, _default$36 as default, defaultIsExpandable, _default$37 as depService, designPlugin, displayTabConfig, editorNodeMergeCustomizer, _default$38 as editorService, eqOptions, error, eventTabConfig, _default$39 as eventsService, fillConfig, fixNodeLeft, fixNodePosition, formPlugin, generatePageName, generatePageNameByApp, getAddParent, getCascaderOptionsFromFields, getDefaultConfig, getDisplayField, getEditorConfig, getFieldType, getFormConfig, getFormValue, getGuideLineFromCache, getInitPositionStyle, getNodeIndex, getPageFragmentList, getPageList, getPageNameList, getPositionInContainer, getRelativeStyle, _default$40 as historyService, info, isIncludeDataSource, _default$41 as loadMonaco, log, moveItemsInContainer, numberOptions, _default$42 as propsService, resolveSelectedNode, serializeConfig, setChildrenLayout, setEditorConfig, setLayout, _default$43 as stageOverlayService, _default$44 as storageService, styleTabConfig, tablePlugin, toggleFixedPosition, _default$45 as uiService, updateStatus, useCodeBlockEdit, useEditorContentHeight, useFilter, useFloatBox, useGetSo, useNextFloatBoxPosition, useNodeStatus, useServices, useStage, useWindowRect, warn };
+export { AddMNode, AddPrefixToObject, AsyncAfterHook, AsyncBeforeHook, AsyncHookPlugin, AsyncMethodName, BeforeAdd, CODE_DRAFT_STORAGE_KEY, COPY_CODE_STORAGE_KEY, COPY_DS_STORAGE_KEY, COPY_STORAGE_KEY, CanDropInFunction, CanDropInScene, _default as CodeBlockEditor, _default$1 as CodeBlockList, _default$2 as CodeBlockListPanel, CodeBlockListPanelSlots, CodeBlockListSlots, CodeDeleteErrorType, CodeDslItem, CodeParamStatement, CodeRelation, _default$3 as CodeSelect, _default$4 as CodeSelectCol, CodeState, ColumnLayout, CombineInfo, ComponentGroup, ComponentGroupState, ComponentItem, _default$5 as ComponentListPanel, ComponentListPanelSlots, _default$6 as CondOpSelect, _default$7 as ContentMenu, CustomContentMenuFunction, DEFAULT_LEFT_COLUMN_WIDTH, DEFAULT_RIGHT_COLUMN_WIDTH, _default$8 as DataSourceAddButton, _default$9 as DataSourceConfigPanel, _default$10 as DataSourceFieldSelect, _default$11 as DataSourceFields, _default$12 as DataSourceInput, DataSourceListSlots, _default$13 as DataSourceMethodSelect, _default$14 as DataSourceMethods, _default$15 as DataSourceMocks, _default$16 as DataSourceSelect, DatasourceTypeOption, DepTargetType, _default$17 as DisplayConds, DragClassification, DragType, DslOpOptions, EditorEvents, EditorInstallOptions, EditorNodeInfo, EditorSlots, EventBus, EventBusEvent, _default$18 as EventSelect, Fixed2Other, _default$19 as FloatingBox, FrameworkSlots, GetColumnWidth, GetConfig, H_GUIDE_LINE_STORAGE_KEY, HistoryOpType, HistoryState, _default$20 as Icon, IdleTask, IdleTaskEvents, IsExpandableFunction, KeyBindingCacheItem, KeyBindingCommand, KeyBindingItem, _default$21 as KeyValue, Keys, LEFT_COLUMN_WIDTH_STORAGE_KEY, LayerNodeSlots, LayerNodeStatus, LayerOffset, _default$22 as LayerPanel, LayerPanelSlots, Layout, _default$23 as LayoutContainer, _default$23 as SplitView, ListState, MIN_CENTER_COLUMN_WIDTH, MIN_LEFT_COLUMN_WIDTH, MIN_RIGHT_COLUMN_WIDTH, MenuBarData, MenuButton, MenuComponent, MenuItem, type OnDrag, PROPS_PANEL_WIDTH_STORAGE_KEY, PageBarSortOptions, _default$24 as PageFragmentSelect, PartSortableOptions, PastePosition, PropsFormConfigFunction, _default$25 as PropsFormPanel, PropsFormValueFunction, _default$26 as PropsPanel, PropsPanelSlots, PropsState, RIGHT_COLUMN_WIDTH_STORAGE_KEY, _default$27 as Resizer, ScrollViewer, ScrollViewerEvent, ScrollViewerSlots, Services, SetColumnWidth, SideBarData, SideComponent, SideItem, SideItemKey, SidebarSlots, StageCore, StageOptions, StageOverlayState, StageRect, StageSlots, StepValue, StoreState, StoreStateKey, _default$28 as StyleSetter, SyncAfterHook, SyncBeforeHook, SyncHookPlugin, _default$29 as TMagicCodeEditor, _default$30 as TMagicEditor, _default$31 as ToolButton, _default$32 as Tree, _default$33 as TreeNode, TreeNodeData, UI_SELECT_MODE_EVENT_NAME, UiState, UndoRedo, V_GUIDE_LINE_STORAGE_KEY, WorkspaceSlots, advancedTabConfig, arrayOptions, beforePaste, buildChangeRecords, calcAlignCenterStyle, calcLayerTargetIndex, calcMoveStyle, canUsePluginMethods, change2Fixed, classifyDragSources, _default$34 as codeBlockService, collectRelatedNodes, _default$35 as dataSourceService, debug, _default$36 as default, defaultIsExpandable, _default$37 as depService, designPlugin, displayTabConfig, editorNodeMergeCustomizer, _default$38 as editorService, eqOptions, error, eventTabConfig, _default$39 as eventsService, fillConfig, fixNodeLeft, fixNodePosition, formPlugin, generatePageName, generatePageNameByApp, getAddParent, getCascaderOptionsFromFields, getDefaultConfig, getDisplayField, getEditorConfig, getFieldType, getFormConfig, getFormValue, getGuideLineFromCache, getInitPositionStyle, getNodeIndex, getPageFragmentList, getPageList, getPageNameList, getPositionInContainer, getRelativeStyle, _default$40 as historyService, info, isIncludeDataSource, _default$41 as loadMonaco, log, moveItemsInContainer, numberOptions, _default$42 as propsService, resolveSelectedNode, serializeConfig, setChildrenLayout, setEditorConfig, setLayout, _default$43 as stageOverlayService, _default$44 as storageService, styleTabConfig, tablePlugin, toggleFixedPosition, _default$45 as uiService, updateStatus, useCodeBlockEdit, useEditorContentHeight, useFilter, useFloatBox, useGetSo, useNextFloatBoxPosition, useNodeStatus, useServices, useStage, useWindowRect, warn };