@tmagic/editor 1.8.0-beta.3 → 1.8.0-beta.4

package/src/type.ts

@@ -510,7 +510,7 @@ export interface HistoryListExtraTab {
  * - data-source: 数据源，按 `type`(base/http/...) 从 dataSourceService 获取数据源表单配置
  * - code-block: 数据源代码块，使用内置的代码块表单配置
  */
-export type CompareCategory = 'node' | 'data-source' | 'code-block';
+export type CompareCategory = 'node' | 'data-source' | 'code-block' | string;
 
 /**
  * 自定义 `loadConfig` 时回传的上下文，聚合了组件当前的对比入参，
@@ -683,6 +683,44 @@ export interface CodeParamStatement {
 export type HistoryOpType = 'add' | 'remove' | 'update';
 // #endregion HistoryOpType
 
+// #region HistoryOpSource
+/**
+ * 历史记录的「操作途径」——标记本次变更由哪条交互入口触发，仅用于历史面板展示 / 业务埋点，
+ * 不影响 undo/redo 行为。缺省（未传）时 UI 视为「未知」。
+ *
+ * - `stage`：画布（拖拽 / 缩放 / 排序等舞台直接操作）
+ * - `tree`：树形面板（图层 / 数据源 / 代码块等树形结构里的拖拽 / 菜单操作）
+ * - `component-panel`：组件面板（左侧组件列表点击 / 拖拽新增组件）
+ * - `props`：配置面板表单（属性表单字段编辑）
+ * - `code`：源码编辑器（配置面板「源码」面板里直接编辑 JSON/代码后保存）
+ * - `stage-contextmenu`：画布右键菜单（舞台上节点的右键上下文菜单）
+ * - `tree-contextmenu`：树面板右键菜单（图层 / 数据源 / 代码块等树形列表上的右键上下文菜单）
+ * - `toolbar`：工具栏菜单（顶部导航工具栏按钮）
+ * - `shortcut`：键盘快捷键
+ * - `rollback`：历史回滚（历史面板里对某条历史「回滚」，反向应用为一条新记录，类 git revert）
+ * - `api`：代码 / 接口调用（程序化触发）
+ * - `ai`：AI 生成 / 智能助手触发的变更
+ * - `unknown`：未知来源
+ *
+ * 通过 `(string & {})` 允许业务侧扩展自定义途径字符串，同时保留内置值的自动补全。
+ */
+export type HistoryOpSource =
+  | 'stage'
+  | 'tree'
+  | 'component-panel'
+  | 'props'
+  | 'code'
+  | 'stage-contextmenu'
+  | 'tree-contextmenu'
+  | 'toolbar'
+  | 'shortcut'
+  | 'rollback'
+  | 'api'
+  | 'ai'
+  | 'unknown'
+  | (string & {});
+// #endregion HistoryOpSource
+
 // #region StepValue
 export interface StepValue {
   /** 页面信息 */
@@ -713,6 +751,12 @@ export interface StepValue {
    * 不影响 undo/redo 行为；缺省时面板会根据节点 / propPath 自动生成描述。
    */
   historyDescription?: string;
+  /**
+   * 操作途径：标记本次变更由哪条交互入口触发，取值见 {@link HistoryOpSource}
+   * （画布 / 树面板 / 组件面板 / 配置面板 / 源码编辑器 / 右键菜单 / 工具栏 / 快捷键 / 回滚 / 接口 等）。
+   * 仅用于历史面板展示与业务埋点，不影响 undo/redo 行为；缺省时面板视为「未知」。
+   */
+  source?: HistoryOpSource;
   /**
    * 入栈时间戳（毫秒）。在 historyService.push 时自动写入（若调用方未指定），仅用于历史面板展示。
    */
@@ -741,6 +785,8 @@ export interface CodeBlockStepValue {
   changeRecords?: ChangeRecord[];
   /** 调用方可选传入的人类可读描述，用于历史面板展示；不影响 undo/redo 行为。 */
   historyDescription?: string;
+  /** 操作途径：标记本次变更由哪条交互入口触发，取值见 {@link HistoryOpSource}；仅用于历史面板展示与埋点，不影响 undo/redo 行为。 */
+  source?: HistoryOpSource;
   /** 入栈时间戳（毫秒），入栈时自动写入，仅用于历史面板展示。 */
   timestamp?: number;
 }
@@ -767,6 +813,8 @@ export interface DataSourceStepValue {
   changeRecords?: ChangeRecord[];
   /** 调用方可选传入的人类可读描述，用于历史面板展示；不影响 undo/redo 行为。 */
   historyDescription?: string;
+  /** 操作途径：标记本次变更由哪条交互入口触发，取值见 {@link HistoryOpSource}；仅用于历史面板展示与埋点，不影响 undo/redo 行为。 */
+  source?: HistoryOpSource;
   /** 入栈时间戳（毫秒），入栈时自动写入，仅用于历史面板展示。 */
   timestamp?: number;
 }
@@ -1099,16 +1147,21 @@ export const canUsePluginMethods = {
 
 export type AsyncMethodName = Writable<(typeof canUsePluginMethods)['async']>;
 
+// #region HistoryOpOptions
 /**
  * 历史记录写入相关的通用配置（codeBlock / dataSource / editor 共用）
  * - doNotPushHistory: 操作完成后是否不要将本次操作压入历史栈（撤销/重做记录），默认 false
  * - historyDescription: 入栈时附带的人类可读描述，用于历史面板展示；不影响 undo/redo 行为，缺省时面板会自动生成描述
+ * - historySource: 操作途径，取值见 {@link HistoryOpSource}（画布 / 树面板 / 组件面板 / 配置面板 / 源码编辑器 / 右键菜单 / 工具栏 / 快捷键 / 回滚 / 接口 等），用于历史面板展示与埋点；不影响 undo/redo 行为
  */
 export interface HistoryOpOptions {
   doNotPushHistory?: boolean;
   historyDescription?: string;
+  historySource?: HistoryOpSource;
 }
+// #endregion HistoryOpOptions
 
+// #region HistoryOpOptionsWithChangeRecords
 /**
  * 在 HistoryOpOptions 基础上携带 form 端 propPath/value 变更记录，
  * 用于历史记录的精细化撤销/重做（按 propPath 局部 patch）。
@@ -1116,7 +1169,9 @@ export interface HistoryOpOptions {
 export interface HistoryOpOptionsWithChangeRecords extends HistoryOpOptions {
   changeRecords?: ChangeRecord[];
 }
+// #endregion HistoryOpOptionsWithChangeRecords
 
+// #region DslOpOptions
 /**
  * DSL 修改类操作的通用配置
  * - doNotSelect: 操作后是否不要自动触发选中（不调用 this.select / this.multiSelect / stage.select / stage.multiSelect）
@@ -1126,11 +1181,12 @@ export interface DslOpOptions extends HistoryOpOptions {
   doNotSelect?: boolean;
   doNotSwitchPage?: boolean;
 }
+// #endregion DslOpOptions
 
 /** 差异对话框的入参 */
 export interface DiffDialogPayload {
   /** 表单类别 */
-  category: CompareCategory;
+  category?: CompareCategory;
   /** 节点类型 / 数据源类型 */
   type?: string;
   /** 代码块场景下的数据源类型 */

package/src/utils/content-menu.ts

@@ -5,11 +5,16 @@ import { cloneDeep, Id, MContainer, NodeType } from '@tmagic/core';
 import { calcValueByFontsize, isPage, isPageFragment } from '@tmagic/utils';
 
 import ContentMenu from '@editor/components/ContentMenu.vue';
-import type { MenuButton, Services } from '@editor/type';
+import type { HistoryOpSource, MenuButton, Services } from '@editor/type';
 
 import { COPY_STORAGE_KEY } from './editor';
 
-export const useDeleteMenu = (): MenuButton => ({
+/**
+ * 共享的右键菜单项构造器（画布 ViewerMenu 与图层树 LayerMenu 共用）。
+ * `historySource` 用于标记本次操作的途径，调用方按所在面板传入：
+ * 画布传 `'stage-contextmenu'`，树形面板传 `'tree-contextmenu'`。
+ */
+export const useDeleteMenu = (historySource?: HistoryOpSource): MenuButton => ({
   type: 'button',
   text: '删除',
   icon: Delete,
@@ -19,7 +24,7 @@ export const useDeleteMenu = (): MenuButton => ({
   },
   handler: ({ editorService }) => {
     const nodes = editorService.get('nodes');
-    nodes && editorService.remove(nodes);
+    nodes && editorService.remove(nodes, { historySource });
   },
 });
 
@@ -33,7 +38,10 @@ export const useCopyMenu = (): MenuButton => ({
   },
 });
 
-export const usePasteMenu = (menu?: ShallowRef<InstanceType<typeof ContentMenu> | null>): MenuButton => ({
+export const usePasteMenu = (
+  historySource?: HistoryOpSource,
+  menu?: ShallowRef<InstanceType<typeof ContentMenu> | null>,
+): MenuButton => ({
   type: 'button',
   text: '粘贴',
   icon: markRaw(DocumentCopy),
@@ -52,14 +60,14 @@ export const usePasteMenu = (menu?: ShallowRef<InstanceType<typeof ContentMenu>
       const initialTop =
         calcValueByFontsize(stage?.renderer?.getDocument(), (rect.top || 0) - (parentRect?.top || 0)) /
         uiService.get('zoom');
-      editorService.paste({ left: initialLeft, top: initialTop });
+      editorService.paste({ left: initialLeft, top: initialTop }, undefined, { historySource });
     } else {
-      editorService.paste();
+      editorService.paste(undefined, undefined, { historySource });
     }
   },
 });
 
-const moveTo = async (id: Id, { editorService }: Services) => {
+const moveTo = async (id: Id, { editorService }: Services, historySource?: HistoryOpSource) => {
   const nodes = editorService.get('nodes') || [];
   const parent = editorService.getNodeById(id) as MContainer;
 
@@ -69,10 +77,11 @@ const moveTo = async (id: Id, { editorService }: Services) => {
   // 不要再走 remove + add 两步，否则会被切成两条历史（且语义也不正确）。
   await editorService.moveToContainer(cloneDeep(nodes), parent.id, {
     doNotSwitchPage: true,
+    historySource,
   });
 };
 
-export const useMoveToMenu = ({ editorService }: Services): MenuButton => {
+export const useMoveToMenu = ({ editorService }: Services, historySource?: HistoryOpSource): MenuButton => {
   const root = computed(() => editorService.get('root'));
 
   return {
@@ -89,7 +98,7 @@ export const useMoveToMenu = ({ editorService }: Services): MenuButton => {
         text: `${page.name}(${page.id})`,
         type: 'button',
         handler: (services: Services) => {
-          moveTo(page.id, services);
+          moveTo(page.id, services, historySource);
         },
       })),
   };

package/types/index.d.ts

@@ -100,7 +100,9 @@ declare class CodeBlock extends BaseService {
    */
   setCodeDslById(id: Id, codeConfig: Partial<CodeBlockContent>, {
     changeRecords,
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: HistoryOpOptionsWithChangeRecords): Promise<void>;
   /**
    * 为了兼容历史原因
@@ -117,7 +119,8 @@ declare class CodeBlock extends BaseService {
   setCodeDslByIdSync(id: Id, codeConfig: Partial<CodeBlockContent>, force?: boolean, {
     changeRecords,
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptionsWithChangeRecords): void;
   /**
    * 根据代码块id数组获取代码dsl
@@ -178,7 +181,8 @@ declare class CodeBlock extends BaseService {
    */
   deleteCodeDslByIds(codeIds: Id[], {
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptions): Promise<void>;
   setParamsColConfig(config: TableColumnConfig): void;
   getParamsColConfig(): TableColumnConfig | undefined;
@@ -318,7 +322,8 @@ declare class DataSource extends BaseService {
    */
   add(config: DataSourceSchema, {
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptions): {
     id: string;
     type: string;
@@ -341,7 +346,8 @@ declare class DataSource extends BaseService {
   update(config: DataSourceSchema, {
     changeRecords,
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptionsWithChangeRecords): DataSourceSchema;
   /**
    * 删除数据源
@@ -352,7 +358,8 @@ declare class DataSource extends BaseService {
    */
   remove(id: string, {
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptions): void;
   /**
    * 撤销指定数据源的最近一次变更。
@@ -571,7 +578,8 @@ declare class Editor extends BaseService {
     doNotSelect,
     doNotSwitchPage,
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<MNode | MNode[]>;
   doRemove(node: MNode, {
     doNotSelect,
@@ -589,7 +597,8 @@ declare class Editor extends BaseService {
     doNotSelect,
     doNotSwitchPage,
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<void>;
   doUpdate(config: MNode, {
     changeRecords
@@ -616,6 +625,7 @@ declare class Editor extends BaseService {
     changeRecordList?: ChangeRecord[][];
     doNotPushHistory?: boolean;
     historyDescription?: string;
+    historySource?: HistoryOpSource;
   }): Promise<MNode | MNode[]>;
   /**
    * 将id为id1的组件移动到id为id2的组件位置上，例如：[1,2,3,4] -> sort(1,3) -> [2,1,3,4]
@@ -629,7 +639,8 @@ declare class Editor extends BaseService {
    */
   sort(id1: Id, id2: Id, {
     doNotSelect,
-    doNotPushHistory
+    doNotPushHistory,
+    historySource
   }?: DslOpOptions): Promise<void>;
   /**
    * 将组件节点配置存储到localStorage中
@@ -656,7 +667,9 @@ declare class Editor extends BaseService {
   paste(position?: PastePosition, collectorOptions?: TargetOptions, {
     doNotSelect,
     doNotSwitchPage,
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<MNode | MNode[] | void>;
   doPaste(config: MNode[], position?: PastePosition): Promise<MNode[]>;
   doAlignCenter(config: MNode): Promise<MNode>;
@@ -671,7 +684,9 @@ declare class Editor extends BaseService {
    */
   alignCenter(config: MNode | MNode[], {
     doNotSelect,
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<MNode | MNode[]>;
   /**
    * 移动当前选中节点位置
@@ -680,7 +695,9 @@ declare class Editor extends BaseService {
    * @param options.doNotPushHistory 是否不写入历史记录（默认 false）
    */
   moveLayer(offset: number | LayerOffset, {
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<void>;
   /**
    * 移动一个或多个节点到指定容器中。
@@ -699,10 +716,14 @@ declare class Editor extends BaseService {
   moveToContainer(config: MNode | MNode[], targetId: Id, {
     doNotSelect,
     doNotSwitchPage,
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<MNode | MNode[]>;
   dragTo(config: MNode | MNode[], targetParent: MContainer, targetIndex: number, {
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<void>;
   /**
    * 撤销当前操作
@@ -742,7 +763,9 @@ declare class Editor extends BaseService {
    */
   gotoPageStep(targetCursor: number): Promise<number>;
   move(left: number, top: number, {
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<void>;
   resetState(): void;
   destroy(): void;
@@ -885,7 +908,8 @@ declare class History extends BaseService {
     oldContent: CodeBlockContent | null;
     newContent: CodeBlockContent | null;
     changeRecords?: ChangeRecord[]; /** 可选的人类可读描述（如「修改按钮颜色」），仅用于历史面板展示。 */
-    historyDescription?: string;
+    historyDescription?: string; /** 可选的操作途径（配置面板 / 菜单 / 接口等），仅用于历史面板展示与埋点。 */
+    source?: HistoryOpSource;
   }): CodeBlockStepValue | null;
   /**
    * 推入一条数据源变更记录（与页面/节点完全无关），按 `dataSourceId` 维度独立一份 UndoRedo 栈。
@@ -895,7 +919,8 @@ declare class History extends BaseService {
     oldSchema: DataSourceSchema | null;
     newSchema: DataSourceSchema | null;
     changeRecords?: ChangeRecord[]; /** 可选的人类可读描述，仅用于历史面板展示。 */
-    historyDescription?: string;
+    historyDescription?: string; /** 可选的操作途径（配置面板 / 菜单 / 接口等），仅用于历史面板展示与埋点。 */
+    source?: HistoryOpSource;
   }): DataSourceStepValue | null;
   /** 撤销指定代码块的最近一次变更。 */
   undoCodeBlock(codeBlockId: Id): CodeBlockStepValue | null;
@@ -1628,7 +1653,7 @@ interface HistoryListExtraTab {
  * - data-source: 数据源，按 `type`(base/http/...) 从 dataSourceService 获取数据源表单配置
  * - code-block: 数据源代码块，使用内置的代码块表单配置
  */
-type CompareCategory = 'node' | 'data-source' | 'code-block';
+type CompareCategory = 'node' | 'data-source' | 'code-block' | string;
 /**
  * 自定义 `loadConfig` 时回传的上下文，聚合了组件当前的对比入参，
  * 方便调用方在外部按需拼装 FormConfig。
@@ -1759,6 +1784,27 @@ interface CodeParamStatement {
   [key: string]: any;
 }
 type HistoryOpType = 'add' | 'remove' | 'update';
+/**
+ * 历史记录的「操作途径」——标记本次变更由哪条交互入口触发，仅用于历史面板展示 / 业务埋点，
+ * 不影响 undo/redo 行为。缺省（未传）时 UI 视为「未知」。
+ *
+ * - `stage`：画布（拖拽 / 缩放 / 排序等舞台直接操作）
+ * - `tree`：树形面板（图层 / 数据源 / 代码块等树形结构里的拖拽 / 菜单操作）
+ * - `component-panel`：组件面板（左侧组件列表点击 / 拖拽新增组件）
+ * - `props`：配置面板表单（属性表单字段编辑）
+ * - `code`：源码编辑器（配置面板「源码」面板里直接编辑 JSON/代码后保存）
+ * - `stage-contextmenu`：画布右键菜单（舞台上节点的右键上下文菜单）
+ * - `tree-contextmenu`：树面板右键菜单（图层 / 数据源 / 代码块等树形列表上的右键上下文菜单）
+ * - `toolbar`：工具栏菜单（顶部导航工具栏按钮）
+ * - `shortcut`：键盘快捷键
+ * - `rollback`：历史回滚（历史面板里对某条历史「回滚」，反向应用为一条新记录，类 git revert）
+ * - `api`：代码 / 接口调用（程序化触发）
+ * - `ai`：AI 生成 / 智能助手触发的变更
+ * - `unknown`：未知来源
+ *
+ * 通过 `(string & {})` 允许业务侧扩展自定义途径字符串，同时保留内置值的自动补全。
+ */
+type HistoryOpSource = 'stage' | 'tree' | 'component-panel' | 'props' | 'code' | 'stage-contextmenu' | 'tree-contextmenu' | 'toolbar' | 'shortcut' | 'rollback' | 'api' | 'ai' | 'unknown' | (string & {});
 interface StepValue {
   /** 页面信息 */
   data: {
@@ -1799,6 +1845,12 @@ interface StepValue {
    * 不影响 undo/redo 行为；缺省时面板会根据节点 / propPath 自动生成描述。
    */
   historyDescription?: string;
+  /**
+   * 操作途径：标记本次变更由哪条交互入口触发，取值见 {@link HistoryOpSource}
+   * （画布 / 树面板 / 组件面板 / 配置面板 / 源码编辑器 / 右键菜单 / 工具栏 / 快捷键 / 回滚 / 接口 等）。
+   * 仅用于历史面板展示与业务埋点，不影响 undo/redo 行为；缺省时面板视为「未知」。
+   */
+  source?: HistoryOpSource;
   /**
    * 入栈时间戳（毫秒）。在 historyService.push 时自动写入（若调用方未指定），仅用于历史面板展示。
    */
@@ -1824,6 +1876,8 @@ interface CodeBlockStepValue {
   changeRecords?: ChangeRecord[];
   /** 调用方可选传入的人类可读描述，用于历史面板展示；不影响 undo/redo 行为。 */
   historyDescription?: string;
+  /** 操作途径：标记本次变更由哪条交互入口触发，取值见 {@link HistoryOpSource}；仅用于历史面板展示与埋点，不影响 undo/redo 行为。 */
+  source?: HistoryOpSource;
   /** 入栈时间戳（毫秒），入栈时自动写入，仅用于历史面板展示。 */
   timestamp?: number;
 }
@@ -1847,6 +1901,8 @@ interface DataSourceStepValue {
   changeRecords?: ChangeRecord[];
   /** 调用方可选传入的人类可读描述，用于历史面板展示；不影响 undo/redo 行为。 */
   historyDescription?: string;
+  /** 操作途径：标记本次变更由哪条交互入口触发，取值见 {@link HistoryOpSource}；仅用于历史面板展示与埋点，不影响 undo/redo 行为。 */
+  source?: HistoryOpSource;
   /** 入栈时间戳（毫秒），入栈时自动写入，仅用于历史面板展示。 */
   timestamp?: number;
 }
@@ -2107,10 +2163,12 @@ type AsyncMethodName = Writable<(typeof canUsePluginMethods)['async']>;
  * 历史记录写入相关的通用配置（codeBlock / dataSource / editor 共用）
  * - doNotPushHistory: 操作完成后是否不要将本次操作压入历史栈（撤销/重做记录），默认 false
  * - historyDescription: 入栈时附带的人类可读描述，用于历史面板展示；不影响 undo/redo 行为，缺省时面板会自动生成描述
+ * - historySource: 操作途径，取值见 {@link HistoryOpSource}（画布 / 树面板 / 组件面板 / 配置面板 / 源码编辑器 / 右键菜单 / 工具栏 / 快捷键 / 回滚 / 接口 等），用于历史面板展示与埋点；不影响 undo/redo 行为
  */
 interface HistoryOpOptions {
   doNotPushHistory?: boolean;
   historyDescription?: string;
+  historySource?: HistoryOpSource;
 }
 /**
  * 在 HistoryOpOptions 基础上携带 form 端 propPath/value 变更记录，
@@ -2131,7 +2189,7 @@ interface DslOpOptions extends HistoryOpOptions {
 /** 差异对话框的入参 */
 interface DiffDialogPayload {
   /** 表单类别 */
-  category: CompareCategory;
+  category?: CompareCategory;
   /** 节点类型 / 数据源类型 */
   type?: string;
   /** 代码块场景下的数据源类型 */
@@ -2210,7 +2268,11 @@ declare const useCodeBlockEdit: (codeBlockService: Services["codeBlockService"])
   }, {}, {}, {}, {}> | null>>;
   createCodeBlock: () => Promise<void>;
   editCode: (id: string) => Promise<void>;
-  deleteCode: (key: string) => Promise<void>;
+  deleteCode: (key: string, {
+    historySource
+  }?: {
+    historySource?: HistoryOpSource;
+  }) => Promise<void>;
   submitCodeBlockHandler: (values: CodeBlockContent, eventData?: ContainerChangeEventData) => Promise<void>;
 };
 //#endregion
@@ -3947,13 +4009,21 @@ declare const __VLS_base$9: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     draggable: boolean;
   }> & Omit<Map<Id, LayerNodeStatus>, keyof Map<any, any>>)>;
   filter: (text: string | string[]) => void;
-  deleteCode: (id: string) => Promise<void>;
+  deleteCode: (id: string, {
+    historySource
+  }?: {
+    historySource?: HistoryOpSource;
+  }) => Promise<void>;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
-  remove: (id: string) => any;
+  remove: (id: string, args_1: {
+    historySource?: HistoryOpSource;
+  }) => any;
   edit: (id: string) => any;
   "node-contextmenu": (event: MouseEvent, data: TreeNodeData) => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$20> & Readonly<{
-  onRemove?: ((id: string) => any) | undefined;
+  onRemove?: ((id: string, args_1: {
+    historySource?: HistoryOpSource;
+  }) => any) | undefined;
   onEdit?: ((id: string) => any) | undefined;
   "onNode-contextmenu"?: ((event: MouseEvent, data: TreeNodeData) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
@@ -5391,7 +5461,8 @@ type __VLS_Props$8 = {
   }[]; /** 组级描述文案生成器，接收一个 group，返回展示文本。由父组件按业务类型注入。 */
   describeGroup: (_group: any) => string; /** 单步描述文案生成器，接收一个 step，返回展示文本。用于合并组展开后的子步列表。 */
   describeStep: (_step: any) => string; /** 判断某个 step 是否可查看差异（前后值都存在）。由父组件按业务类型注入；不传则一律不展示差异入口。 */
-  isStepDiffable?: (_step: any) => boolean; /** 共享的折叠状态表（key -> 是否展开），由顶层 panel 统一维护以便跨 tab 复用。 */
+  isStepDiffable?: (_step: any) => boolean; /** 判断某个 step 是否支持回滚（如更新需带 changeRecords）。由父组件按业务类型注入；不传则已应用即可回滚。 */
+  isStepRevertable?: (_step: any) => boolean; /** 共享的折叠状态表（key -> 是否展开），由顶层 panel 统一维护以便跨 tab 复用。 */
   expanded: Record<string, boolean>; /** 是否支持「跳转到该记录」(goto)。默认 true。 */
   gotoEnabled?: boolean;
 };
@@ -5636,4 +5707,4 @@ declare const _default$39: {
   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, CodeBlockHistoryGroup, _default$1 as CodeBlockList, _default$2 as CodeBlockListPanel, CodeBlockListPanelSlots, CodeBlockListSlots, CodeBlockStepValue, CodeDeleteErrorType, CodeDslItem, CodeParamStatement, CodeRelation, _default$3 as CodeSelect, _default$4 as CodeSelectCol, CodeState, ColumnLayout, CombineInfo, CompareCategory, _default$5 as CompareForm, CompareFormLoadConfig, CompareFormLoadConfigContext, ComponentGroup, ComponentGroupState, ComponentItem, _default$6 as ComponentListPanel, ComponentListPanelSlots, _default$7 as CondOpSelect, _default$8 as ContentMenu, CustomContentMenuFunction, DEFAULT_LEFT_COLUMN_WIDTH, DEFAULT_RIGHT_COLUMN_WIDTH, _default$9 as DataSourceAddButton, _default$10 as DataSourceConfigPanel, _default$11 as DataSourceFieldSelect, _default$12 as DataSourceFields, DataSourceHistoryGroup, _default$13 as DataSourceInput, DataSourceListSlots, _default$14 as DataSourceMethodSelect, _default$15 as DataSourceMethods, _default$16 as DataSourceMocks, _default$17 as DataSourceSelect, DataSourceStepValue, DatasourceTypeOption, DepTargetType, DiffDialogPayload, _default$18 as DisplayConds, DragClassification, DragType, DslOpOptions, EditorEvents, EditorInstallOptions, EditorNodeInfo, EditorSlots, EventBus, EventBusEvent, _default$19 as EventSelect, Fixed2Other, _default$20 as FloatingBox, FrameworkSlots, GetCodeBlockFormConfigOptions, GetColumnWidth, GetConfig, H_GUIDE_LINE_STORAGE_KEY, _default$21 as HistoryDiffDialog, _default$22 as HistoryListBucket, HistoryListExtraTab, HistoryOpOptions, HistoryOpOptionsWithChangeRecords, HistoryOpType, HistoryState, _default$23 as Icon, IdleTask, IdleTaskEvents, IsExpandableFunction, KeyBindingCacheItem, KeyBindingCommand, KeyBindingItem, _default$24 as KeyValue, Keys, LEFT_COLUMN_WIDTH_STORAGE_KEY, LayerNodeSlots, LayerNodeStatus, LayerOffset, _default$25 as LayerPanel, LayerPanelSlots, Layout, _default$26 as LayoutContainer, _default$26 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$27 as PageFragmentSelect, PageHistoryGroup, PageHistoryStepEntry, PartSortableOptions, PastePosition, PropsFormConfigFunction, _default$28 as PropsFormPanel, PropsFormValueFunction, _default$29 as PropsPanel, PropsPanelSlots, PropsState, RIGHT_COLUMN_WIDTH_STORAGE_KEY, _default$30 as Resizer, ScrollViewer, ScrollViewerEvent, ScrollViewerSlots, Services, SetColumnWidth, SideBarData, SideComponent, SideItem, SideItemKey, SidebarSlots, StageCore, StageOptions, StageOverlayState, StageRect, StageSlots, StepValue, StoreState, StoreStateKey, _default$31 as StyleSetter, SyncAfterHook, SyncBeforeHook, SyncHookPlugin, _default$32 as TMagicCodeEditor, _default$33 as TMagicEditor, _default$34 as ToolButton, _default$35 as Tree, _default$36 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$37 as codeBlockService, collectRelatedNodes, _default$38 as dataSourceService, debug, _default$39 as default, defaultIsExpandable, _default$40 as depService, designPlugin, displayTabConfig, editorNodeMergeCustomizer, _default$41 as editorService, eqOptions, error, eventTabConfig, _default$42 as eventsService, fillConfig, fixNodeLeft, fixNodePosition, formPlugin, generatePageName, generatePageNameByApp, getAddParent, getCascaderOptionsFromFields, getCodeBlockFormConfig, getDefaultConfig, getDisplayField, getEditorConfig, getFieldType, getFormConfig, getFormValue, getGuideLineFromCache, getInitPositionStyle, getNodeIndex, getPageFragmentList, getPageList, getPageNameList, getPositionInContainer, getRelativeStyle, _default$43 as historyService, info, isIncludeDataSource, _default$44 as loadMonaco, log, moveItemsInContainer, numberOptions, _default$45 as propsService, resolveSelectedNode, serializeConfig, setChildrenLayout, setEditorConfig, setLayout, _default$46 as stageOverlayService, _default$47 as storageService, styleTabConfig, tablePlugin, toggleFixedPosition, _default$48 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, CodeBlockHistoryGroup, _default$1 as CodeBlockList, _default$2 as CodeBlockListPanel, CodeBlockListPanelSlots, CodeBlockListSlots, CodeBlockStepValue, CodeDeleteErrorType, CodeDslItem, CodeParamStatement, CodeRelation, _default$3 as CodeSelect, _default$4 as CodeSelectCol, CodeState, ColumnLayout, CombineInfo, CompareCategory, _default$5 as CompareForm, CompareFormLoadConfig, CompareFormLoadConfigContext, ComponentGroup, ComponentGroupState, ComponentItem, _default$6 as ComponentListPanel, ComponentListPanelSlots, _default$7 as CondOpSelect, _default$8 as ContentMenu, CustomContentMenuFunction, DEFAULT_LEFT_COLUMN_WIDTH, DEFAULT_RIGHT_COLUMN_WIDTH, _default$9 as DataSourceAddButton, _default$10 as DataSourceConfigPanel, _default$11 as DataSourceFieldSelect, _default$12 as DataSourceFields, DataSourceHistoryGroup, _default$13 as DataSourceInput, DataSourceListSlots, _default$14 as DataSourceMethodSelect, _default$15 as DataSourceMethods, _default$16 as DataSourceMocks, _default$17 as DataSourceSelect, DataSourceStepValue, DatasourceTypeOption, DepTargetType, DiffDialogPayload, _default$18 as DisplayConds, DragClassification, DragType, DslOpOptions, EditorEvents, EditorInstallOptions, EditorNodeInfo, EditorSlots, EventBus, EventBusEvent, _default$19 as EventSelect, Fixed2Other, _default$20 as FloatingBox, FrameworkSlots, GetCodeBlockFormConfigOptions, GetColumnWidth, GetConfig, H_GUIDE_LINE_STORAGE_KEY, _default$21 as HistoryDiffDialog, _default$22 as HistoryListBucket, HistoryListExtraTab, HistoryOpOptions, HistoryOpOptionsWithChangeRecords, HistoryOpSource, HistoryOpType, HistoryState, _default$23 as Icon, IdleTask, IdleTaskEvents, IsExpandableFunction, KeyBindingCacheItem, KeyBindingCommand, KeyBindingItem, _default$24 as KeyValue, Keys, LEFT_COLUMN_WIDTH_STORAGE_KEY, LayerNodeSlots, LayerNodeStatus, LayerOffset, _default$25 as LayerPanel, LayerPanelSlots, Layout, _default$26 as LayoutContainer, _default$26 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$27 as PageFragmentSelect, PageHistoryGroup, PageHistoryStepEntry, PartSortableOptions, PastePosition, PropsFormConfigFunction, _default$28 as PropsFormPanel, PropsFormValueFunction, _default$29 as PropsPanel, PropsPanelSlots, PropsState, RIGHT_COLUMN_WIDTH_STORAGE_KEY, _default$30 as Resizer, ScrollViewer, ScrollViewerEvent, ScrollViewerSlots, Services, SetColumnWidth, SideBarData, SideComponent, SideItem, SideItemKey, SidebarSlots, StageCore, StageOptions, StageOverlayState, StageRect, StageSlots, StepValue, StoreState, StoreStateKey, _default$31 as StyleSetter, SyncAfterHook, SyncBeforeHook, SyncHookPlugin, _default$32 as TMagicCodeEditor, _default$33 as TMagicEditor, _default$34 as ToolButton, _default$35 as Tree, _default$36 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$37 as codeBlockService, collectRelatedNodes, _default$38 as dataSourceService, debug, _default$39 as default, defaultIsExpandable, _default$40 as depService, designPlugin, displayTabConfig, editorNodeMergeCustomizer, _default$41 as editorService, eqOptions, error, eventTabConfig, _default$42 as eventsService, fillConfig, fixNodeLeft, fixNodePosition, formPlugin, generatePageName, generatePageNameByApp, getAddParent, getCascaderOptionsFromFields, getCodeBlockFormConfig, getDefaultConfig, getDisplayField, getEditorConfig, getFieldType, getFormConfig, getFormValue, getGuideLineFromCache, getInitPositionStyle, getNodeIndex, getPageFragmentList, getPageList, getPageNameList, getPositionInContainer, getRelativeStyle, _default$43 as historyService, info, isIncludeDataSource, _default$44 as loadMonaco, log, moveItemsInContainer, numberOptions, _default$45 as propsService, resolveSelectedNode, serializeConfig, setChildrenLayout, setEditorConfig, setLayout, _default$46 as stageOverlayService, _default$47 as storageService, styleTabConfig, tablePlugin, toggleFixedPosition, _default$48 as uiService, updateStatus, useCodeBlockEdit, useEditorContentHeight, useFilter, useFloatBox, useGetSo, useNextFloatBoxPosition, useNodeStatus, useServices, useStage, useWindowRect, warn };