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

package/types/index.d.ts

@@ -69,6 +69,16 @@ declare const canUsePluginMethods$7: {
 type AsyncMethodName$4 = Writable<(typeof canUsePluginMethods$7)['async']>;
 declare class CodeBlock extends BaseService {
   private state;
+  /**
+   * 最近一次写入历史栈的代码块历史记录 uuid（单条写入场景：新增 / 更新）。
+   * 供 setCodeDslById(Sync)AndGetHistoryId 取回，普通方法不读取它。
+   */
+  private lastPushedHistoryId;
+  /**
+   * deleteCodeDslByIds 一次删除多个代码块时，按写入顺序收集的历史记录 uuid 列表。
+   * 在 deleteCodeDslByIds 入口处重置，供 deleteCodeDslByIdsAndGetHistoryId 取回。
+   */
+  private lastDeletedHistoryIds;
   constructor();
   /**
    * 设置活动的代码块dsl数据源
@@ -100,7 +110,9 @@ declare class CodeBlock extends BaseService {
    */
   setCodeDslById(id: Id, codeConfig: Partial<CodeBlockContent>, {
     changeRecords,
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: HistoryOpOptionsWithChangeRecords): Promise<void>;
   /**
    * 为了兼容历史原因
@@ -117,7 +129,8 @@ declare class CodeBlock extends BaseService {
   setCodeDslByIdSync(id: Id, codeConfig: Partial<CodeBlockContent>, force?: boolean, {
     changeRecords,
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptionsWithChangeRecords): void;
   /**
    * 根据代码块id数组获取代码dsl
@@ -178,8 +191,25 @@ declare class CodeBlock extends BaseService {
    */
   deleteCodeDslByIds(codeIds: Id[], {
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptions): Promise<void>;
+  /**
+   * 下列 *AndGetHistoryId 方法与对应的写入方法行为完全一致，
+   * 唯一区别是返回值为本次写入历史栈的历史记录 uuid（{@link CodeBlockStepValue.uuid}），
+   * 可用于精确引用 / 定位该条历史记录（埋点、revert、跨端同步等）。
+   *
+   * 当本次操作未写入历史（doNotPushHistory 为 true、或无对应记录）时：单条写入返回 null，批量删除返回空数组。
+   */
+  /** 等价于 {@link setCodeDslById}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  setCodeDslByIdAndGetHistoryId(id: Id, codeConfig: Partial<CodeBlockContent>, options?: HistoryOpOptionsWithChangeRecords): Promise<string | null>;
+  /** 等价于 {@link setCodeDslByIdSync}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  setCodeDslByIdSyncAndGetHistoryId(id: Id, codeConfig: Partial<CodeBlockContent>, force?: boolean, options?: HistoryOpOptionsWithChangeRecords): string | null;
+  /**
+   * 等价于 {@link deleteCodeDslByIds}，但返回本次写入的全部历史记录 uuid（按删除顺序）。
+   * 一次删除多个代码块会产生多条历史记录，因此返回数组；未写入任何历史时返回空数组。
+   */
+  deleteCodeDslByIdsAndGetHistoryId(codeIds: Id[], options?: HistoryOpOptions): Promise<string[]>;
   setParamsColConfig(config: TableColumnConfig): void;
   getParamsColConfig(): TableColumnConfig | undefined;
   /**
@@ -223,6 +253,15 @@ declare class CodeBlock extends BaseService {
    * @returns 反向后产生的新 step；目标不存在 / 未应用时返回 null
    */
   revert(id: Id, index: number): Promise<CodeBlockStepValue | null>;
+  /**
+   * 通过历史记录 uuid 回滚某条代码块历史步骤，语义同 {@link revert}，
+   * 仅无需调用方再传 codeBlockId 与 index：内部会按 uuid（{@link CodeBlockStepValue.uuid}）
+   * 在全部代码块栈中定位对应步骤后再回滚。
+   *
+   * @param uuid 目标历史记录的 uuid，通常由 {@link setCodeDslByIdAndGetHistoryId} 等方法返回
+   * @returns 反向后产生的新 step；找不到对应 uuid / 未应用时返回 null
+   */
+  revertById(uuid: string): Promise<CodeBlockStepValue | null>;
   /**
    * 生成代码块唯一id
    * @returns {Id} 代码块唯一id
@@ -264,7 +303,7 @@ declare class CodeBlock extends BaseService {
   private applyHistoryStep;
 }
 type CodeBlockService = CodeBlock;
-declare const _default$37: CodeBlock;
+declare const _default$38: CodeBlock;
 //#endregion
 //#region temp/packages/editor/src/services/componentList.d.ts
 declare class ComponentList extends BaseService {
@@ -298,6 +337,12 @@ declare const canUsePluginMethods$6: {
 type SyncMethodName$4 = Writable<(typeof canUsePluginMethods$6)['sync']>;
 declare class DataSource extends BaseService {
   private state;
+  /**
+   * 最近一次写入历史栈的数据源历史记录 uuid。
+   * 供 *AndGetHistoryId 系列方法在调用 add / update / remove 后取回本次产生的历史记录 id；
+   * 普通方法不读取它，调用前由 *AndGetHistoryId 重置为 null。
+   */
+  private lastPushedHistoryId;
   constructor();
   set<K extends StateKey$1, T extends State$2[K]>(name: K, value: T): void;
   get<K extends StateKey$1>(name: K): State$2[K];
@@ -318,7 +363,8 @@ declare class DataSource extends BaseService {
    */
   add(config: DataSourceSchema, {
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptions): {
     id: string;
     type: string;
@@ -341,7 +387,8 @@ declare class DataSource extends BaseService {
   update(config: DataSourceSchema, {
     changeRecords,
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptionsWithChangeRecords): DataSourceSchema;
   /**
    * 删除数据源
@@ -352,8 +399,22 @@ declare class DataSource extends BaseService {
    */
   remove(id: string, {
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: HistoryOpOptions): void;
+  /**
+   * 下列 *AndGetHistoryId 方法与对应的 add / update / remove 行为完全一致，
+   * 唯一区别是返回值为本次写入历史栈的历史记录 uuid（{@link DataSourceStepValue.uuid}），
+   * 而非数据源配置。可用于精确引用 / 定位该条历史记录（埋点、revert、跨端同步等）。
+   *
+   * 当本次操作未写入历史（doNotPushHistory 为 true、或无对应记录）时返回 null。
+   */
+  /** 等价于 {@link add}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  addAndGetHistoryId(config: DataSourceSchema, options?: HistoryOpOptions): string | null;
+  /** 等价于 {@link update}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  updateAndGetHistoryId(config: DataSourceSchema, options?: HistoryOpOptionsWithChangeRecords): string | null;
+  /** 等价于 {@link remove}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  removeAndGetHistoryId(id: string, options?: HistoryOpOptions): string | null;
   /**
    * 撤销指定数据源的最近一次变更。
    *
@@ -394,6 +455,15 @@ declare class DataSource extends BaseService {
    * @returns 反向后产生的新 step；目标不存在 / 未应用时返回 null
    */
   revert(id: Id, index: number): DataSourceStepValue | null;
+  /**
+   * 通过历史记录 uuid 回滚某条数据源历史步骤，语义同 {@link revert}，
+   * 仅无需调用方再传 dataSourceId 与 index：内部会按 uuid（{@link DataSourceStepValue.uuid}）
+   * 在全部数据源栈中定位对应步骤后再回滚。
+   *
+   * @param uuid 目标历史记录的 uuid，通常由 {@link addAndGetHistoryId} 等方法返回
+   * @returns 反向后产生的新 step；找不到对应 uuid / 未应用时返回 null
+   */
+  revertById(uuid: string): DataSourceStepValue | null;
   createId(): string;
   getDataSourceById(id: string): DataSourceSchema | undefined;
   resetState(): void;
@@ -432,7 +502,7 @@ declare class DataSource extends BaseService {
   private applyHistoryStep;
 }
 type DataSourceService = DataSource;
-declare const _default$38: DataSource;
+declare const _default$39: DataSource;
 //#endregion
 //#region temp/packages/editor/src/services/dep.d.ts
 interface DepEvents {
@@ -485,19 +555,28 @@ declare class Dep extends BaseService {
   private enqueueTask;
 }
 type DepService = Dep;
-declare const _default$40: Dep;
+declare const _default$41: Dep;
 //#endregion
 //#region temp/packages/editor/src/services/editor.d.ts
 declare class Editor extends BaseService {
   state: StoreState;
   private selectionBeforeOp;
+  /**
+   * 最近一次 pushOpHistory 写入的历史记录 uuid。
+   * 供 *AndGetHistoryId 系列方法在调用普通操作后取回本次产生的历史记录 id；
+   * 普通操作不会读取它，调用前由 *AndGetHistoryId 重置为 null。
+   */
+  private lastPushedHistoryId;
   constructor();
   /**
    * 设置当前指点节点配置
    * @param name 'root' | 'page' | 'parent' | 'node' | 'highlightNode' | 'nodes' | 'stage' | 'modifiedNodeIds' | 'pageLength' | 'pageFragmentLength
    * @param value MNode
+   * @param options.historySource 设置 root 时，本次变更写入历史记录的「操作来源」（仅 name === 'root' 时生效）
    */
-  set<K extends StoreStateKey, T extends StoreState[K]>(name: K, value: T): void;
+  set<K extends StoreStateKey, T extends StoreState[K]>(name: K, value: T, options?: {
+    historySource?: HistoryOpSource;
+  }): void;
   /**
    * 获取当前指点节点配置
    * @param name  'root' | 'page' | 'parent' | 'node' | 'highlightNode' | 'nodes' | 'stage' | 'modifiedNodeIds' | 'pageLength' | 'pageFragmentLength'
@@ -571,7 +650,8 @@ declare class Editor extends BaseService {
     doNotSelect,
     doNotSwitchPage,
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<MNode | MNode[]>;
   doRemove(node: MNode, {
     doNotSelect,
@@ -589,12 +669,15 @@ declare class Editor extends BaseService {
     doNotSelect,
     doNotSwitchPage,
     doNotPushHistory,
-    historyDescription
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<void>;
   doUpdate(config: MNode, {
-    changeRecords
+    changeRecords,
+    historySource
   }?: {
     changeRecords?: ChangeRecord[];
+    historySource?: HistoryOpSource;
   }): Promise<{
     newNode: MNode;
     oldNode: MNode;
@@ -616,6 +699,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 +713,8 @@ declare class Editor extends BaseService {
    */
   sort(id1: Id, id2: Id, {
     doNotSelect,
-    doNotPushHistory
+    doNotPushHistory,
+    historySource
   }?: DslOpOptions): Promise<void>;
   /**
    * 将组件节点配置存储到localStorage中
@@ -656,7 +741,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 +758,9 @@ declare class Editor extends BaseService {
    */
   alignCenter(config: MNode | MNode[], {
     doNotSelect,
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<MNode | MNode[]>;
   /**
    * 移动当前选中节点位置
@@ -680,7 +769,9 @@ declare class Editor extends BaseService {
    * @param options.doNotPushHistory 是否不写入历史记录（默认 false）
    */
   moveLayer(offset: number | LayerOffset, {
-    doNotPushHistory
+    doNotPushHistory,
+    historyDescription,
+    historySource
   }?: DslOpOptions): Promise<void>;
   /**
    * 移动一个或多个节点到指定容器中。
@@ -699,11 +790,40 @@ 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>;
+  /**
+   * 下列 *AndGetHistoryId 方法与对应的普通操作（add / remove / update ...）行为完全一致，
+   * 唯一区别是返回值为本次写入历史栈的历史记录 uuid（{@link StepValue.uuid}），
+   * 而非节点 / 节点数组。可用于精确引用 / 定位该条历史记录（埋点、revert、跨端同步等）。
+   *
+   * 当本次操作未写入历史（doNotPushHistory 为 true、或操作无实际变更 / 提前返回）时返回 null。
+   */
+  /** 等价于 {@link add}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  addAndGetHistoryId(addNode: AddMNode | MNode[], parent?: MContainer | null, options?: DslOpOptions): Promise<string | null>;
+  /** 等价于 {@link remove}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  removeAndGetHistoryId(nodeOrNodeList: MNode | MNode[], options?: DslOpOptions): Promise<string | null>;
+  /** 等价于 {@link update}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  updateAndGetHistoryId(config: MNode | MNode[], data?: {
+    changeRecords?: ChangeRecord[];
+    changeRecordList?: ChangeRecord[][];
+    doNotPushHistory?: boolean;
+    historyDescription?: string;
+    historySource?: HistoryOpSource;
+  }): Promise<string | null>;
+  /** 等价于 {@link moveLayer}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  moveLayerAndGetHistoryId(offset: number | LayerOffset, options?: DslOpOptions): Promise<string | null>;
+  /** 等价于 {@link moveToContainer}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  moveToContainerAndGetHistoryId(config: MNode | MNode[], targetId: Id, options?: DslOpOptions): Promise<string | null>;
+  /** 等价于 {@link dragTo}，但返回本次写入历史记录的 uuid（未入栈时返回 null）。 */
+  dragToAndGetHistoryId(config: MNode | MNode[], targetParent: MContainer, targetIndex: number, options?: DslOpOptions): Promise<string | null>;
   /**
    * 撤销当前操作
    * @returns 被撤销的操作
@@ -731,6 +851,15 @@ declare class Editor extends BaseService {
    * @returns 反向后产生的新 step；目标不存在 / 未应用 / 反向失败时返回 null
    */
   revertPageStep(index: number): Promise<StepValue | null>;
+  /**
+   * 通过历史记录 uuid 回滚当前页面的某条历史步骤，语义与 {@link revertPageStep} 完全一致，
+   * 仅入参从 index 改为 uuid（{@link StepValue.uuid}）。uuid 不随栈内步骤增删而变化，
+   * 更适合业务侧持有引用后再回滚（埋点、跨端同步等场景）。
+   *
+   * @param uuid 目标历史记录的 uuid，通常由 *AndGetHistoryId 方法返回
+   * @returns 反向后产生的新 step；找不到对应 uuid / 未应用 / 反向失败时返回 null
+   */
+  revertPageStepById(uuid: string): Promise<StepValue | null>;
   /**
    * 跳转当前页面历史栈到指定游标位置。
    *
@@ -742,7 +871,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;
@@ -753,6 +884,24 @@ declare class Editor extends BaseService {
   emit<Name extends keyof EditorEvents, Param extends EditorEvents[Name]>(eventName: Name, ...args: Param): boolean;
   private addModifiedNodeId;
   private captureSelectionBeforeOp;
+  /**
+   * 比较「上一次 root」与「新 root」的页面 / 页面片，按页面粒度把整体替换拆成历史记录：
+   * - 新旧都存在且内容变化的页面 → 一条 `update`（整页快照替换，无 changeRecords）；
+   * - 仅新 root 存在的页面 → 一条 `add`；
+   * - 仅旧 root 存在的页面 → 一条 `remove`。
+   *
+   * 每条记录落到对应页面自己的历史栈（与普通节点操作一致），并标记来源 `source`。
+   * 内容未变化的页面不产生记录，避免重复设置相同 DSL 时产生噪声。
+   */
+  private pushRootDiffHistory;
+  /**
+   * 构造一条页面级「set root」历史记录（不携带选区 / modifiedNodeIds 上下文）并落到该页面自己的栈。
+   *
+   * 连续 set root 替换：若该页栈最新一条已是**同来源**的 set root 记录（{@link StepValue.rootStep} 且 `source` 相同），
+   * 则用本次记录**替换**它而非新增，避免源码反复保存 / 外部重设 DSL 时堆积多条 root 记录；
+   * 来源不同则照常新增（initial 基线不是 rootStep，不在此列）。
+   */
+  private pushPageDiffStep;
   private pushOpHistory;
   /**
    * 应用历史操作（撤销 / 重做）
@@ -770,7 +919,7 @@ declare class Editor extends BaseService {
   private selectedConfigExceptionHandler;
 }
 type EditorService = Editor;
-declare const _default$41: Editor;
+declare const _default$42: Editor;
 //#endregion
 //#region temp/packages/editor/src/services/events.d.ts
 declare const canUsePluginMethods$5: {
@@ -792,14 +941,40 @@ declare class Events extends BaseService {
   usePlugin(options: AsyncHookPlugin<AsyncMethodName$3, Events> & SyncHookPlugin<SyncMethodName$3, Events>): void;
 }
 type EventsService = Events;
-declare const _default$42: Events;
+declare const _default$43: Events;
 //#endregion
 //#region temp/packages/editor/src/utils/undo-redo.d.ts
+/**
+ * UndoRedo 栈的可序列化快照，用于持久化（如写入 IndexedDB）后再还原。
+ */
+interface SerializedUndoRedo<T = any> {
+  /** 栈内全部元素（按时间正序，索引 0 为最早一步）。 */
+  elementList: T[];
+  /** 游标位置（已应用步骤数量）。 */
+  listCursor: number;
+  /** 栈容量上限。 */
+  listMaxSize: number;
+}
 declare class UndoRedo<T = any> {
+  /**
+   * 由 {@link UndoRedo.serialize} 产出的快照重建一个 UndoRedo 实例。
+   * 游标会被夹紧到 [0, length] 区间，避免脏数据导致越界。
+   *
+   * @param options.isSavedStep 可选谓词：若提供，则把游标定位到「最近一条满足该谓词的记录」之后
+   *   （即恢复到最近一个已保存点）；找不到匹配记录时退回快照中的原游标。
+   */
+  static fromSerialized<T = any>(data: SerializedUndoRedo<T>, options?: {
+    isSavedStep?: (element: T) => boolean;
+  }): UndoRedo<T>;
   private elementList;
   private listCursor;
   private listMaxSize;
   constructor(listMaxSize?: number);
+  /**
+   * 导出当前栈的可序列化快照（深克隆，避免外部改动污染内部状态）。
+   * 配合 {@link UndoRedo.fromSerialized} 可在持久化后完整还原撤销/重做栈。
+   */
+  serialize(): SerializedUndoRedo<T>;
   pushElement(element: T): void;
   canUndo(): boolean;
   /** 返回被撤销的操作 */
@@ -808,6 +983,19 @@ declare class UndoRedo<T = any> {
   /** 返回被重做的操作 */
   redo(): T | null;
   getCurrentElement(): T | null;
+  /**
+   * 用 `element` 替换当前游标所在元素（cursor - 1），并丢弃其后的重做尾部（与 {@link pushElement} 的丢尾一致），
+   * 游标位置保持不变（元素数量不增）。cursor 为 0（无已应用元素）时不做任何操作并返回 false。
+   * 用于「连续同类记录合并」等就地替换最新一条的场景。
+   */
+  replaceCurrentElement(element: T): boolean;
+  /**
+   * 对当前游标所在元素（cursor - 1）做就地更新；cursor 为 0（全部已撤销）时不做任何操作。
+   * 用于给「当前步骤」打标记（如标记为已保存）等元数据写入场景。
+   */
+  updateCurrentElement(updater: (element: T) => void): void;
+  /** 对栈内全部元素做就地更新。用于批量清理元数据（如清空所有元素的已保存标记）。 */
+  updateElements(updater: (element: T, index: number) => void): void;
   /**
    * 返回栈内全部元素的浅克隆数组（按时间顺序，索引 0 为最早一步）。
    * 仅用于历史面板等只读展示场景，不应直接修改返回值。
@@ -826,32 +1014,6 @@ declare class UndoRedo<T = any> {
 //#endregion
 //#region temp/packages/editor/src/services/history.d.ts
 declare class History extends BaseService {
-  /**
-   * 把单个代码块栈拆成若干 group：
-   * - 把"新增/删除"独立成组（语义上属于一次性事件，不应与 update 合并）；
-   * - 连续 'update' 合并到同一组，组内 steps 顺序就是发生顺序。
-   */
-  private static mergeCodeBlockSteps;
-  private static mergeDataSourceSteps;
-  /**
-   * 根据 old/new 是否为 null 推断 opType（与 push 时的约定一致）。
-   */
-  private static detectOpType;
-  /**
-   * 把页面栈拆成若干 group：
-   * - 单节点的 'update' 按 targetId 与相邻同 targetId 的 update 合并到一个 group；
-   * - 'add' / 'remove' 始终独立成组（语义上是结构变更，不应被收纳进单节点修改组）；
-   * - 多节点 'update'（如批量改属性）也独立成组（无明确单一目标，避免误合并）。
-   */
-  private static mergePageSteps;
-  /**
-   * 解析 StepValue 中的"目标节点 id"用于合并：
-   * - 单节点 update：取唯一一项 updatedItems 的节点 id；
-   * - 其它情形（多节点 update / add / remove）：返回 undefined，表示不参与合并。
-   */
-  private static detectPageTargetId;
-  /** 解析 StepValue 中的目标节点可读名（用于 UI 展示）。 */
-  private static detectPageTargetName;
   state: {
     pageId?: Id | undefined;
     pageSteps: Record<Id, UndoRedo<StepValue>>;
@@ -865,6 +1027,27 @@ declare class History extends BaseService {
   resetPage(): void;
   changePage(page: MPage | MPageFragment): void;
   resetState(): void;
+  /**
+   * 为指定页面 / 页面片种入一条「初始基线」记录（如加载 DSL 时的「初始 / 加载」基线）。
+   *
+   * 该记录是一条 `opType: 'initial'` 的 {@link StepValue}，作为页面历史栈 **index 0 的固定底线**：
+   * - 它是一条真实入栈的 step（随栈一起持久化），但被钉为撤销/回滚的下限——cursor 永不低于它，
+   *   因此不会被 undo / goto / revert 触达（详见 {@link undo} / {@link setCanUndoRedo}）；
+   * - 历史面板把它过滤出分组列表（见 {@link getPageHistoryGroups}），改由底部「初始」行展示。
+   *
+   * 仅当目标页面栈为空时种入（保证 initial 一定位于 index 0）；已存在 initial 底线时默认不重复种入，
+   * 传 `force=true` 且栈为空时按新基线种入。
+   */
+  setPageMarker(pageId: Id, options?: {
+    name?: string;
+    description?: string;
+    source?: HistoryOpSource;
+  }): StepValue | null;
+  /**
+   * 读取指定页面（缺省当前活动页）的初始基线 step（页面栈 index 0 且 `opType: 'initial'`）；
+   * 不存在时返回 undefined。
+   */
+  getPageMarker(pageId?: Id): StepValue | undefined;
   /**
    * 把一条步骤推入指定页面的栈；不指定 pageId 时落到当前活动页。
    *
@@ -872,6 +1055,13 @@ declare class History extends BaseService {
    * 否则会把记录错误地落到操作发起页 / 当前激活页，破坏目标页 / 源页的撤销栈语义。
    */
   push(state: StepValue, pageId?: Id): StepValue | null;
+  /** 读取指定页面（缺省当前活动页）历史栈当前游标所在的 step（cursor - 1）；无则返回 null。 */
+  getCurrentPageStep(pageId?: Id): StepValue | null;
+  /**
+   * 用 `state` 替换指定页面栈当前游标所在的 step（并丢弃其后的重做尾部），游标不变。
+   * 用于「连续 set root 记录合并」等就地替换最新一条的场景；替换成功后按需刷新 / 通知。
+   */
+  replaceCurrentPageStep(state: StepValue, pageId?: Id): StepValue | null;
   /**
    * 推入一条代码块变更记录（与页面/节点完全无关），按 `codeBlockId` 维度独立一份 UndoRedo 栈。
    *
@@ -885,7 +1075,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 +1086,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;
@@ -916,6 +1108,54 @@ declare class History extends BaseService {
   undo(): StepValue | null;
   redo(): StepValue | null;
   destroy(): void;
+  /**
+   * 清空指定页面（缺省当前活动页）的历史记录栈。
+   * 仅删除撤销/重做记录，不会改动当前 DSL；清空后该页将无法再撤销/重做之前的操作。
+   */
+  clearPage(pageId?: Id): void;
+  /**
+   * 清空数据源历史记录栈：传入 `dataSourceId` 仅清空该数据源，缺省清空全部数据源。
+   * 仅删除撤销/重做记录，不会改动数据源本身。
+   */
+  clearDataSource(dataSourceId?: Id): void;
+  /**
+   * 清空代码块历史记录栈：传入 `codeBlockId` 仅清空该代码块，缺省清空全部代码块。
+   * 仅删除撤销/重做记录，不会改动代码块本身。
+   */
+  clearCodeBlock(codeBlockId?: Id): void;
+  /**
+   * 标记「整份 DSL 已保存」：把页面 / 代码块 / 数据源所有栈当前游标所在的记录都标为 `saved`。
+   * 适用于「整体落库」场景；若只保存了其中一类，请改用更细粒度的
+   * {@link markPageSaved} / {@link markCodeBlockSaved} / {@link markDataSourceSaved}。
+   */
+  markSaved(): void;
+  /**
+   * 标记指定页面（缺省为当前活动页）的历史栈当前记录为已保存。
+   * 仅影响该页面自己的栈，不波及代码块 / 数据源 / 其它页面。
+   */
+  markPageSaved(pageId?: Id): void;
+  /** 标记指定代码块的历史栈当前记录为已保存，仅影响该代码块自己的栈。 */
+  markCodeBlockSaved(codeBlockId: Id): void;
+  /** 标记指定数据源的历史栈当前记录为已保存，仅影响该数据源自己的栈。 */
+  markDataSourceSaved(dataSourceId: Id): void;
+  /**
+   * 把当前内存中的全部历史栈（页面 / 代码块 / 数据源）序列化后写入本地 IndexedDB。
+   *
+   * - 每个 UndoRedo 栈连同其游标、容量一并保存，恢复后可继续 undo/redo；
+   * - `key` 用于区分不同活动页 / 项目（同一 store 下可保存多份快照），缺省为 `default`；
+   * - 返回写入成功的快照对象，便于调用方记录 savedAt 等信息；
+   * - 不支持 IndexedDB 的环境（如 SSR）会 reject。
+   */
+  saveToIndexedDB(options?: HistoryPersistOptions): Promise<PersistedHistoryState>;
+  /**
+   * 从本地 IndexedDB 读取此前保存的历史快照并重建全部撤销/重做栈。
+   *
+   * - 读取到的每个栈都会经 {@link UndoRedo.fromSerialized} 还原（含游标），随后可直接 undo/redo；
+   * - 会整体覆盖当前内存中的历史状态，并把活动页恢复为快照中的 pageId；
+   * - 找不到对应记录时返回 null，且不改动当前状态；
+   * - 不支持 IndexedDB 的环境（如 SSR）会 reject。
+   */
+  restoreFromIndexedDB(options?: HistoryPersistOptions): Promise<PersistedHistoryState | null>;
   /**
    * 取出当前活动页的历史步骤平铺列表（包含已应用 + 已撤销）。
    * 列表按时间正序，最早一步在最前面。
@@ -962,6 +1202,27 @@ declare class History extends BaseService {
     index: number;
     applied: boolean;
   }[];
+  /**
+   * 按历史记录 uuid 在指定页面（默认当前活动页）的栈中查找其索引。
+   * 找不到时返回 -1。供「按 uuid 回滚」等需要把 uuid 映射回 index 的场景使用。
+   */
+  getPageStepIndexByUuid(uuid: string, pageId?: Id): number;
+  /**
+   * 按历史记录 uuid 在全部代码块栈中查找其所属 codeBlockId 与索引。
+   * 找不到时返回 null。
+   */
+  findCodeBlockStepLocationByUuid(uuid: string): {
+    id: Id;
+    index: number;
+  } | null;
+  /**
+   * 按历史记录 uuid 在全部数据源栈中查找其所属 dataSourceId 与索引。
+   * 找不到时返回 null。
+   */
+  findDataSourceStepLocationByUuid(uuid: string): {
+    id: Id;
+    index: number;
+  } | null;
   /**
    * 取出全部数据源的历史栈，按 dataSourceId 分组。同上。
    */
@@ -973,18 +1234,15 @@ declare class History extends BaseService {
    * 这样切到目标页时 Ctrl+Z 也能撤回该步骤。
    */
   private getUndoRedo;
-  private setCanUndoRedo;
   /**
-   * 按 id 获取（或创建）指定代码块的 UndoRedo 栈。
+   * 把基础 dbName 与当前 DSL（root app）的 id 拼成最终库名，实现不同应用历史隔离。
+   * 取不到 app id（如尚未加载 DSL）时退回基础 dbName。
    */
-  private getCodeBlockUndoRedo;
-  /**
-   * 按 id 获取（或创建）指定数据源的 UndoRedo 栈。
-   */
-  private getDataSourceUndoRedo;
+  private resolveDbName;
+  private setCanUndoRedo;
 }
 type HistoryService = History;
-declare const _default$43: History;
+declare const _default$44: History;
 //#endregion
 //#region temp/packages/editor/src/services/keybinding.d.ts
 declare class Keybinding extends BaseService {
@@ -1122,7 +1380,7 @@ declare class Props extends BaseService {
   private setRelateId;
 }
 type PropsService = Props;
-declare const _default$45: Props;
+declare const _default$46: Props;
 //#endregion
 //#region temp/packages/editor/src/services/stageOverlay.d.ts
 declare const canUsePluginMethods$3: {
@@ -1149,7 +1407,7 @@ declare class StageOverlay extends BaseService {
   private updateSelectStatus;
 }
 type StageOverlayService = StageOverlay;
-declare const _default$46: StageOverlay;
+declare const _default$47: StageOverlay;
 //#endregion
 //#region temp/packages/editor/src/services/storage.d.ts
 interface Options$1 {
@@ -1212,7 +1470,7 @@ declare class WebStorage extends BaseService {
   private getValueAndProtocol;
 }
 type StorageService = WebStorage;
-declare const _default$47: WebStorage;
+declare const _default$48: WebStorage;
 //#endregion
 //#region temp/packages/editor/src/services/ui.d.ts
 declare const canUsePluginMethods$1: {
@@ -1232,7 +1490,7 @@ declare class Ui extends BaseService {
   private setStageRect;
 }
 type UiService = Ui;
-declare const _default$48: Ui;
+declare const _default$49: Ui;
 //#endregion
 //#region temp/packages/editor/src/type.d.ts
 type EditorSlots = FrameworkSlots & WorkspaceSlots & SidebarSlots & PropsPanelSlots & {
@@ -1477,6 +1735,8 @@ interface UiState {
   hideSlideBar: boolean;
   /** 侧边栏面板配置 */
   sideBarItems: SideComponent[];
+  /** 当前激活的侧边栏面板 */
+  sideBarActiveTabName: string;
   navMenuRect: {
     left: number;
     top: number;
@@ -1544,6 +1804,9 @@ interface MenuButton {
   items?: MenuButton[];
   /** 唯一标识，用于高亮 */
   id?: string | number;
+  buttonProps?: {
+    type?: string;
+  };
 }
 interface MenuComponent {
   type: 'component';
@@ -1628,7 +1891,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。
@@ -1758,97 +2021,139 @@ interface CodeParamStatement {
   type?: string | TypeFunction<string>;
   [key: string]: any;
 }
-type HistoryOpType = 'add' | 'remove' | 'update';
-interface StepValue {
-  /** 页面信息 */
-  data: {
-    name: string;
-    id: Id;
-  };
-  opType: HistoryOpType;
-  /** 操作前选中的节点 ID，用于撤销后恢复选择状态 */
-  selectedBefore: Id[];
-  /** 操作后选中的节点 ID，用于重做后恢复选择状态 */
-  selectedAfter: Id[];
-  modifiedNodeIds: Map<Id, Id>;
-  /** opType 'add': 新增的节点 */
-  nodes?: MNode[];
-  /** opType 'add': 父节点 ID */
+/**
+ * 历史记录操作类型：
+ * - `add` / `remove` / `update`：普通可撤销/重做的节点变更；
+ * - `initial`：页面「未修改的初始状态」基线（设置 root 时生成），作为页面栈 index 0 的固定底线 step。
+ *   该 step 不可被撤销/回滚（cursor 不会低于它），仅用于历史面板底部的初始行展示。
+ */
+type HistoryOpType = 'add' | 'remove' | 'update' | 'initial';
+/**
+ * 历史记录的「操作途径」——标记本次变更由哪条交互入口触发，仅用于历史面板展示 / 业务埋点，
+ * 不影响 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 = 'initial' | 'stage' | 'tree' | 'component-panel' | 'props' | 'code' | 'root-code' | 'stage-contextmenu' | 'tree-contextmenu' | 'toolbar' | 'shortcut' | 'rollback' | 'api' | 'ai' | 'sync' | 'unknown' | (string & {});
+/**
+ * 单条变更的 diff 描述，统一表达「页面节点 / 代码块 / 数据源」的变化内容，
+ * 被 {@link StepValue} / {@link CodeBlockStepValue} / {@link DataSourceStepValue} 的 `diff` 复用。
+ *
+ * 按 `opType` 区分携带的字段：
+ * - `add`：仅 `newSchema`（页面节点还带 `parentId` / `index`）；
+ * - `remove`：仅 `oldSchema`（页面节点还带 `parentId` / `index`）；
+ * - `update`：`oldSchema` + `newSchema`，并可带 `changeRecords` 做局部更新。
+ *
+ * 泛型 `T` 为变化内容的快照类型：页面节点为 `MNode`，代码块为 `CodeBlockContent`，数据源为 `DataSourceSchema`。
+ */
+interface StepDiffItem<T = unknown> {
+  /** 变更后的内容快照。`opType` 为 `add` / `update` 时有，`remove` 时无。 */
+  newSchema?: T;
+  /** 变更前的内容快照。`opType` 为 `remove` / `update` 时有，`add` 时无。 */
+  oldSchema?: T;
+  /** 父节点 id。仅页面节点有（数据源 / 代码块没有父节点）。 */
   parentId?: Id;
-  /** opType 'add': 每个新增节点在父节点 items 中的索引 */
-  indexMap?: Record<string, number>;
-  /** opType 'remove': 被删除的节点及其位置信息 */
-  removedItems?: {
-    node: MNode;
-    parentId: Id;
-    index: number;
-  }[];
+  /** 在父节点 items 数组中的索引。仅页面节点有（数据源 / 代码块无需排序）。 */
+  index?: number;
   /**
-   * opType 'update': 变更前后的节点快照
-   *
-   * `changeRecords` 来自 form 端的 propPath/value 列表，撤销/重做时只对这些 propPath 做局部更新；
-   * 缺省（未传 / 空数组）才退化为整节点替换。
+   * form 端 propPath/value 变更列表，仅 `opType` 为 `update` 时有；
+   * 撤销/重做时若有则按 propPath 局部更新，缺省才退化为整内容替换。
    */
-  updatedItems?: {
-    oldNode: MNode;
-    newNode: MNode;
-    changeRecords?: ChangeRecord[];
-  }[];
+  changeRecords?: ChangeRecord[];
+}
+/**
+ * 历史记录条目公共字段，被 {@link StepValue} / {@link CodeBlockStepValue} / {@link DataSourceStepValue} 复用。
+ *
+ * 泛型 `T` 为 `diff` 中变化内容的快照类型（页面节点 `MNode` / 代码块 `CodeBlockContent` / 数据源 `DataSourceSchema`）。
+ */
+interface BaseStepValue<T = unknown> {
+  /**
+   * 历史记录唯一标识（uuid）。入栈时自动写入（若调用方未指定），
+   * 用于精确定位 / 引用某一条历史记录（如 revert、埋点、跨端同步等）。
+   * 注意与各自的 `id`（关联的页面 / 代码块 / 数据源 id）区分。
+   */
+  uuid: string;
+  /** 操作类型：新增 / 删除 / 更新（三类历史记录统一携带）。 */
+  opType: HistoryOpType;
+  /**
+   * 本次变更的内容（统一 diff 表达），每项见 {@link StepDiffItem}。
+   * 页面节点（add/remove 多节点、update 多节点）会有多项，代码块 / 数据源通常只有一项。
+   */
+  diff: StepDiffItem<T>[];
   /**
    * 调用方可选传入的人类可读描述（如「调整按钮颜色」），用于历史面板展示。
    * 不影响 undo/redo 行为；缺省时面板会根据节点 / propPath 自动生成描述。
    */
   historyDescription?: string;
   /**
-   * 入栈时间戳（毫秒）。在 historyService.push 时自动写入（若调用方未指定），仅用于历史面板展示。
+   * 操作途径：标记本次变更由哪条交互入口触发，取值见 {@link HistoryOpSource}
+   * （画布 / 树面板 / 组件面板 / 配置面板 / 源码编辑器 / 右键菜单 / 工具栏 / 快捷键 / 回滚 / 接口 等）。
+   * 仅用于历史面板展示与业务埋点，不影响 undo/redo 行为；缺省时面板视为「未知」。
+   */
+  source?: HistoryOpSource;
+  /**
+   * 入栈时间戳（毫秒）。入栈时自动写入（若调用方未指定），仅用于历史面板展示。
    */
   timestamp?: number;
+  /**
+   * 是否为「已保存」记录：DSL 落库（如保存到后端 / 本地）时由 historyService.markSaved 标记。
+   * 同一栈内任意时刻最多只有一条记录为 true；从 IndexedDB 恢复时游标会被定位到最近一条已保存记录之后。
+   */
+  saved?: boolean;
+  /**
+   * 是否为「整体设置 root」（set root）产生的记录（由 {@link Editor.pushRootDiffHistory} 写入）。
+   * 用于「连续 set root 合并」：当某页栈最新一条已是 root 记录时，下一条 set root 会替换它而非新增，
+   * 避免源码反复保存 / 外部重设 DSL 时堆积多条 root 记录。
+   */
+  rootStep?: boolean;
+}
+interface StepValue extends BaseStepValue<MNode> {
+  /** 页面信息 */
+  data: {
+    name: string;
+    id: Id;
+  };
+  /** 操作前选中的节点 ID，用于撤销后恢复选择状态 */
+  selectedBefore: Id[];
+  /** 操作后选中的节点 ID，用于重做后恢复选择状态 */
+  selectedAfter: Id[];
+  modifiedNodeIds: Map<Id, Id>;
 }
 /**
  * 代码块历史记录条目。按 codeBlock.id 分组保存到 historyState.codeBlockState。
- * - 新增：oldContent = null，newContent = 新内容
- * - 更新：oldContent / newContent 都为对应内容
- * - 删除：newContent = null，oldContent = 删除前内容
+ * 变更内容统一由 `diff`（单项）表达，每项见 {@link StepDiffItem}：
+ * - 新增（opType 'add'）：仅 `newSchema`（新内容）；
+ * - 更新（opType 'update'）：`oldSchema` + `newSchema`，并可带 `changeRecords` 做局部更新；
+ * - 删除（opType 'remove'）：仅 `oldSchema`（删除前内容）。
  */
-interface CodeBlockStepValue {
+interface CodeBlockStepValue extends BaseStepValue<CodeBlockContent> {
   /** 关联的代码块 id */
   id: Id;
-  /** 变更前的代码块内容，新增时为 null */
-  oldContent: CodeBlockContent | null;
-  /** 变更后的代码块内容，删除时为 null */
-  newContent: CodeBlockContent | null;
-  /**
-   * form 端 propPath/value 列表。撤销/重做时若有则按 propPath 局部更新；
-   * 缺省才退化为整内容替换。新增/删除场景通常无 changeRecords。
-   */
-  changeRecords?: ChangeRecord[];
-  /** 调用方可选传入的人类可读描述，用于历史面板展示；不影响 undo/redo 行为。 */
-  historyDescription?: string;
-  /** 入栈时间戳（毫秒），入栈时自动写入，仅用于历史面板展示。 */
-  timestamp?: number;
 }
 /**
  * 数据源历史记录条目。按 dataSource.id 分组保存到 historyState.dataSourceState。
- * - 新增：oldSchema = null，newSchema = 新 schema
- * - 更新：oldSchema / newSchema 都为对应 schema
- * - 删除：newSchema = null，oldSchema = 删除前 schema
+ * 变更内容统一由 `diff`（单项）表达，每项见 {@link StepDiffItem}：
+ * - 新增（opType 'add'）：仅 `newSchema`（新 schema）；
+ * - 更新（opType 'update'）：`oldSchema` + `newSchema`，并可带 `changeRecords` 做局部更新；
+ * - 删除（opType 'remove'）：仅 `oldSchema`（删除前 schema）。
  */
-interface DataSourceStepValue {
+interface DataSourceStepValue extends BaseStepValue<DataSourceSchema> {
   /** 关联的数据源 id */
   id: Id;
-  /** 变更前的数据源 schema，新增时为 null */
-  oldSchema: DataSourceSchema | null;
-  /** 变更后的数据源 schema，删除时为 null */
-  newSchema: DataSourceSchema | null;
-  /**
-   * form 端 propPath/value 列表。撤销/重做时若有则按 propPath 局部更新；
-   * 缺省才退化为整 schema 替换。新增/删除场景通常无 changeRecords。
-   */
-  changeRecords?: ChangeRecord[];
-  /** 调用方可选传入的人类可读描述，用于历史面板展示；不影响 undo/redo 行为。 */
-  historyDescription?: string;
-  /** 入栈时间戳（毫秒），入栈时自动写入，仅用于历史面板展示。 */
-  timestamp?: number;
 }
 interface HistoryState {
   pageId?: Id;
@@ -1866,6 +2171,39 @@ interface HistoryState {
    */
   dataSourceState: Record<Id, UndoRedo<DataSourceStepValue>>;
 }
+/**
+ * 历史记录的可持久化快照。由 historyService.saveToIndexedDB 写入 IndexedDB，
+ * 再由 historyService.restoreFromIndexedDB 读出并重建各 UndoRedo 栈。
+ */
+interface PersistedHistoryState {
+  /** 快照结构版本号，便于后续兼容升级。 */
+  version: number;
+  /** 保存时的活动页 id。 */
+  pageId?: Id;
+  /** 各页面历史栈的序列化快照，按 pageId 分组。 */
+  pageSteps: Record<Id, SerializedUndoRedo<StepValue>>;
+  /** 各代码块历史栈的序列化快照，按 codeBlockId 分组。 */
+  codeBlockState: Record<Id, SerializedUndoRedo<CodeBlockStepValue>>;
+  /** 各数据源历史栈的序列化快照，按 dataSourceId 分组。 */
+  dataSourceState: Record<Id, SerializedUndoRedo<DataSourceStepValue>>;
+  /** 保存时间戳（毫秒）。 */
+  savedAt: number;
+}
+/** historyService 持久化相关 API 的可选配置。 */
+interface HistoryPersistOptions {
+  /** IndexedDB 数据库名，默认 `tmagic-editor`（最终库名会拼上当前 DSL app id）。 */
+  dbName?: string;
+  /** objectStore 名，默认 `history`。 */
+  storeName?: string;
+  /** 记录 key，用于区分不同活动页 / 项目，默认 `default`。 */
+  key?: IDBValidKey;
+  /**
+   * 显式指定用于库名隔离的 DSL app id。
+   * 缺省时回退到当前 editorService 的 `root.id`；在「先恢复历史再 set root」场景下 root 尚未设置，
+   * 需由调用方（如从待加载 DSL 取 id）显式传入，否则会读 / 写到未按 app 隔离的默认库。
+   */
+  appId?: Id;
+}
 /**
  * 历史面板用：当前页面的一条历史步骤（包含位置和是否已应用）。
  */
@@ -2107,10 +2445,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 +2471,7 @@ interface DslOpOptions extends HistoryOpOptions {
 /** 差异对话框的入参 */
 interface DiffDialogPayload {
   /** 表单类别 */
-  category: CompareCategory;
+  category?: CompareCategory;
   /** 节点类型 / 数据源类型 */
   type?: string;
   /** 代码块场景下的数据源类型 */
@@ -2147,6 +2487,35 @@ interface DiffDialogPayload {
   /** 用于标题展示的目标 id */
   id?: string | number;
 }
+/**
+ * 一组「描述 + 可操作性」的判定函数集合。页面 / 数据源 / 代码块及业务自定义历史
+ * 各自实现一份，作为整体注入，避免把 describe* / isStep* 拆成多个独立 props 反复透传。
+ */
+interface HistoryRowDescriptor<T extends BaseStepValue = BaseStepValue> {
+  /** 组级描述文案生成器，接收一个 group，返回展示文本。 */
+  describeGroup: (_group: any) => string;
+  /** 单步描述文案生成器，接收一个 step，返回展示文本（合并组展开后的子步列表用）。 */
+  describeStep: (_step: T) => string;
+  /** 判断某个 step 是否可查看差异（前后值都存在）。不传则一律不展示差异入口。 */
+  isStepDiffable?: (_step: T) => boolean;
+  /** 判断某个 step 是否支持回滚（如更新需带 changeRecords）。不传则已应用即可回滚。 */
+  isStepRevertable?: (_step: T) => boolean;
+}
+/**
+ * 通用 bucket（数据源 / 代码块 / 业务自定义历史）的整体渲染配置。
+ * 把原先散落在 Bucket / BucketTab 上的 title / prefix / describe* / isStep* / showInitial / gotoEnabled
+ * 收敛成一个对象作为单一 prop 传递，调用方一次配齐、组件内部按需读取。
+ */
+interface HistoryBucketConfig<T extends BaseStepValue = BaseStepValue> extends HistoryRowDescriptor<T> {
+  /** bucket 头部标题，例如 "数据源" / "代码块"。 */
+  title: string;
+  /** 子项 key 的命名空间前缀（`ds` 数据源 / `cb` 代码块 / 业务自定义如 `mod`）。 */
+  prefix: string;
+  /** 是否展示底部「回到初始状态」入口，默认 true。无 undo cursor 语义的自定义历史可传 false。 */
+  showInitial?: boolean;
+  /** 是否支持「跳转到该记录」(goto)，默认 true。 */
+  gotoEnabled?: boolean;
+}
 //#endregion
 //#region temp/packages/editor/src/hooks/use-code-block-edit.d.ts
 declare const useCodeBlockEdit: (codeBlockService: Services["codeBlockService"]) => {
@@ -2170,8 +2539,8 @@ declare const useCodeBlockEdit: (codeBlockService: Services["codeBlockService"])
     onClose?: (() => any) | undefined;
     onSubmit?: ((values: CodeBlockContent, eventData: ContainerChangeEventData) => any) | undefined;
     onOpen?: (() => any) | undefined;
-    "onUpdate:width"?: ((value: number) => any) | undefined;
     "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+    "onUpdate:width"?: ((value: number) => any) | undefined;
   }>, {
     show(): Promise<void>;
     hide(): Promise<void>;
@@ -2179,8 +2548,8 @@ declare const useCodeBlockEdit: (codeBlockService: Services["codeBlockService"])
     close: () => any;
     submit: (values: CodeBlockContent, eventData: ContainerChangeEventData) => any;
     open: () => any;
-    "update:width": (value: number) => any;
     "update:visible": (value: boolean) => any;
+    "update:width": (value: number) => any;
   }, import("@vue/runtime-core").PublicProps, {}, false, {}, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, {}, any, import("@vue/runtime-core").ComponentProvideOptions, {
     P: {};
     B: {};
@@ -2202,15 +2571,19 @@ declare const useCodeBlockEdit: (codeBlockService: Services["codeBlockService"])
     onClose?: (() => any) | undefined;
     onSubmit?: ((values: CodeBlockContent, eventData: ContainerChangeEventData) => any) | undefined;
     onOpen?: (() => any) | undefined;
-    "onUpdate:width"?: ((value: number) => any) | undefined;
     "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+    "onUpdate:width"?: ((value: number) => any) | undefined;
   }>, {
     show(): Promise<void>;
     hide(): Promise<void>;
   }, {}, {}, {}, {}> | 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
@@ -2503,6 +2876,11 @@ interface DragClassification {
  * @returns 分类结果，包含同容器索引列表和跨容器节点列表
  */
 declare const classifyDragSources: (configs: MNode[], targetParent: MContainer, getNodeInfo: (id: Id, raw?: boolean) => EditorNodeInfo) => DragClassification;
+/**
+ * 给「回滚」生成的新 step 用的简短描述生成器。
+ * 与 UI 层 `describePageStep` 同义，但避免 service 反向依赖 layouts/，故放在此工具函数中。
+ */
+declare const describeStepForRevert: (step: StepValue) => string;
 //#endregion
 //#region temp/packages/editor/src/utils/operator.d.ts
 /**
@@ -2602,6 +2980,120 @@ declare const updateStatus: (nodeStatusMap: Map<Id, LayerNodeStatus>, id: Id, st
 /** 默认的组件树节点是否可展开的判断函数：当节点的子项中至少存在一个可见节点时认为可展开 */
 declare const defaultIsExpandable: IsExpandableFunction;
 //#endregion
+//#region temp/packages/editor/src/utils/indexed-db.d.ts
+/**
+ * 一组极简的、基于原生 IndexedDB 的 Promise KV 工具，避免引入额外依赖。
+ * 仅用于浏览器环境；在不支持 IndexedDB 的环境（如 SSR / 部分测试环境）下会 reject。
+ */
+/** 是否处于支持 IndexedDB 的环境。 */
+declare const isIndexedDBSupported: () => boolean;
+/**
+ * 打开（必要时升级）数据库，确保目标 objectStore 存在后返回连接。
+ *
+ * 由于 objectStore 只能在 `onupgradeneeded` 内创建，这里先以当前版本打开，
+ * 若发现 store 不存在则关闭连接、以更高版本重开来按需创建，兼容动态 storeName。
+ */
+declare const openIndexedDB: (dbName: string, storeName: string) => Promise<IDBDatabase>;
+/** 写入（覆盖）一条记录。value 通过结构化克隆存储，支持 Map / Set 等结构。 */
+declare const idbSet: (dbName: string, storeName: string, key: IDBValidKey, value: unknown) => Promise<void>;
+/** 读取一条记录，不存在时返回 undefined。 */
+declare const idbGet: <T = unknown>(dbName: string, storeName: string, key: IDBValidKey) => Promise<T | undefined>;
+/** 删除一条记录。 */
+declare const idbDelete: (dbName: string, storeName: string, key: IDBValidKey) => Promise<void>;
+//#endregion
+//#region temp/packages/editor/src/utils/history.d.ts
+/**
+ * 「回滚」生成的新 step 简短描述。代码块 / 数据源共用。
+ * 二者逻辑一致，仅展示名取值字段不同（代码块取 `name`，数据源取 `title`），
+ * 因此通过 `getLabel` 注入取值方式。
+ *
+ * @param id 关联的代码块 / 数据源 id
+ * @param diff 单条变更 diff（缺省视为空）
+ * @param getLabel 从快照取展示名
+ */
+declare const describeRevertStep: <T extends object>(id: Id, {
+  oldSchema,
+  newSchema,
+  changeRecords
+}: StepDiffItem<T> | undefined, getLabel: (schema: T) => string | undefined) => string;
+/**
+ * 根据 old/new 是否为 null 推断 opType（与 push 时的约定一致）。
+ */
+declare const detectStackOpType: (oldVal: unknown, newVal: unknown) => "add" | "remove" | "update";
+/**
+ * 构造一条代码块 / 数据源「按 id 分栈」的历史记录：两者除 payload 字段命名外完全一致。
+ *
+ * - `add`：oldValue = null；`remove`：newValue = null；`update`：两者都有，可带 changeRecords 做局部更新。
+ * - 内容会做 cloneDeep 防止后续被外部引用篡改；opType 依据 old/new 是否为 null 推断。
+ * - 仅负责构造 step 并返回，入栈与事件 emit 由各公共方法（pushCodeBlock / pushDataSource）自行处理。
+ * - 不直接驱动业务 service，调用方负责实际写回。
+ */
+declare const createStackStep: <T, S extends BaseStepValue<T> & {
+  id: Id;
+}>(id: Id, payload: {
+  oldValue: T | null;
+  newValue: T | null;
+  changeRecords?: ChangeRecord[];
+  historyDescription?: string;
+  source?: HistoryOpSource;
+}) => S | null;
+declare const markStackSaved: <S extends {
+  saved?: boolean;
+}>(undoRedo?: UndoRedo<S>) => void;
+/**
+ * 把单个「按 id 分栈」的历史栈（代码块 / 数据源）拆成若干 group：
+ * - 把"新增/删除"独立成组（语义上属于一次性事件，不应与 update 合并）；
+ * - 连续 'update' 合并到同一组，组内 steps 顺序就是发生顺序。
+ *
+ * 代码块与数据源除 `kind` 外结构完全一致，统一由本方法处理；`kind` 决定返回的具体分组类型。
+ */
+declare const mergeStackSteps: <S extends BaseStepValue, K extends "code-block" | "data-source">(kind: K, id: Id, list: S[], cursor: number) => {
+  kind: K;
+  id: Id;
+  opType: HistoryOpType;
+  steps: {
+    step: S;
+    index: number;
+    applied: boolean;
+    isCurrent?: boolean;
+  }[];
+  applied: boolean;
+  isCurrent?: boolean;
+}[];
+/**
+ * 把页面栈拆成若干 group：
+ * - 单节点的 'update' 按 targetId 与相邻同 targetId 的 update 合并到一个 group；
+ * - 'add' / 'remove' 始终独立成组（语义上是结构变更，不应被收纳进单节点修改组）；
+ * - 多节点 'update'（如批量改属性）也独立成组（无明确单一目标，避免误合并）。
+ */
+declare const mergePageSteps: (pageId: Id, list: StepValue[], cursor: number) => PageHistoryGroup[];
+/**
+ * 解析 StepValue 中的"目标节点 id"用于合并：
+ * - 单节点 update：取唯一一项 updatedItems 的节点 id；
+ * - 其它情形（多节点 update / add / remove）：返回 undefined，表示不参与合并。
+ */
+declare const detectPageTargetId: (step: StepValue) => Id | undefined;
+/** 解析 StepValue 中的目标节点可读名（用于 UI 展示）。 */
+declare const detectPageTargetName: (step: StepValue) => string | undefined;
+/** 把 `Record<Id, UndoRedo>` 整体序列化为 `Record<Id, SerializedUndoRedo>`。 */
+declare const serializeStacks: <T>(stacks: Record<Id, UndoRedo<T>>) => Record<Id, SerializedUndoRedo<T>>;
+/**
+ * 把 `Record<Id, SerializedUndoRedo>` 整体还原为 `Record<Id, UndoRedo>`。
+ * 还原时把每个栈的游标定位到最近一条已保存（`saved === true`）记录之后。
+ */
+declare const deserializeStacks: <T extends {
+  saved?: boolean;
+}>(stacks?: Record<Id, ReturnType<UndoRedo<T>["serialize"]>>) => Record<Id, UndoRedo<T>>;
+/**
+ * 按 id 从「按 id 分栈」的记录表（代码块 / 数据源）中获取（或创建）对应的 UndoRedo 栈。
+ */
+declare const getOrCreateStack: <T>(stacks: Record<Id, UndoRedo<T>>, id: Id) => UndoRedo<T>;
+/**
+ * 撤销下限：当页面栈 index 0 是 `opType: 'initial'` 的基线 step 时为 1（基线不可被撤销），否则为 0。
+ * 用于把 cursor 钉在基线之上，保证 undo / canUndo / goto 都不会越过初始基线。
+ */
+declare const undoFloor: (undoRedo: UndoRedo<StepValue>) => number;
+//#endregion
 //#region temp/packages/editor/src/utils/const.d.ts
 /** 当uiService.get('uiSelectMode')为true,点击组件（包括任何形式，组件树/画布）时触发的事件名 */
 declare const UI_SELECT_MODE_EVENT_NAME = "ui-select";
@@ -2617,7 +3109,7 @@ declare const H_GUIDE_LINE_STORAGE_KEY = "$MagicStageHorizontalGuidelinesData";
 declare const V_GUIDE_LINE_STORAGE_KEY = "$MagicStageVerticalGuidelinesData";
 //#endregion
 //#region temp/packages/editor/src/utils/monaco-editor.d.ts
-declare const _default$44: () => Promise<typeof import("monaco-editor")>;
+declare const _default$45: () => Promise<typeof import("monaco-editor")>;
 //#endregion
 //#region temp/packages/form/src/schema.d.ts
 interface ChangeRecord$1 {
@@ -3681,6 +4173,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
   disabledCodeBlock: boolean;
   disabledMultiSelect: boolean;
   alwaysMultiSelect: boolean;
+  disabledFlashTip: boolean;
   disabledPageFragment: boolean;
   historyListExtraTabs: HistoryListExtraTab[];
   disabledShowSrc: boolean;
@@ -3702,11 +4195,10 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
   datasourceConfigs: Record<string, import("@tmagic/form-schema").FormConfig>;
   containerHighlightDuration: number;
   containerHighlightType: import("@tmagic/stage").ContainerHighlightType;
-  disabledFlashTip: boolean;
   canSelect: (el: HTMLElement) => boolean | Promise<boolean>;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$36: __VLS_WithSlots$12<typeof __VLS_base$12, __VLS_Slots$12>;
-declare const _default$33: typeof __VLS_export$36;
+declare const __VLS_export$37: __VLS_WithSlots$12<typeof __VLS_base$12, __VLS_Slots$12>;
+declare const _default$34: typeof __VLS_export$37;
 type __VLS_WithSlots$12<T, S> = T & {
   new (): {
     $slots: S;
@@ -3714,7 +4206,7 @@ type __VLS_WithSlots$12<T, S> = T & {
 };
 //#endregion
 //#region temp/packages/editor/src/layouts/CodeEditor.vue.d.ts
-type __VLS_Props$33 = {
+type __VLS_Props$32 = {
   initValues?: any;
   modifiedValues?: any;
   type?: 'diff';
@@ -3730,7 +4222,7 @@ type __VLS_Props$33 = {
   };
   editorCustomType?: string;
 };
-declare const __VLS_export$35: import("@vue/runtime-core").DefineComponent<__VLS_Props$33, {
+declare const __VLS_export$36: import("@vue/runtime-core").DefineComponent<__VLS_Props$32, {
   values: import("@vue/reactivity").Ref<string, string>;
   getEditor(): Monaco.editor.IStandaloneCodeEditor | Monaco.editor.IStandaloneDiffEditor | null;
   getVsEditor(): Monaco.editor.IStandaloneCodeEditor | null;
@@ -3741,7 +4233,7 @@ declare const __VLS_export$35: import("@vue/runtime-core").DefineComponent<__VLS
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   save: (...args: any[]) => void;
   initd: (...args: any[]) => void;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$33> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$32> & Readonly<{
   onSave?: ((...args: any[]) => any) | undefined;
   onInitd?: ((...args: any[]) => any) | undefined;
 }>, {
@@ -3752,13 +4244,13 @@ declare const __VLS_export$35: import("@vue/runtime-core").DefineComponent<__VLS
   autoSave: boolean;
   disabledFullScreen: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$32: typeof __VLS_export$35;
+declare const _default$33: typeof __VLS_export$36;
 //#endregion
 //#region temp/packages/editor/src/layouts/sidebar/ComponentListPanel.vue.d.ts
 type __VLS_Slots$11 = ComponentListPanelSlots;
 declare const __VLS_base$11: import("@vue/runtime-core").DefineComponent<{}, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
-declare const __VLS_export$34: __VLS_WithSlots$11<typeof __VLS_base$11, __VLS_Slots$11>;
-declare const _default$6: typeof __VLS_export$34;
+declare const __VLS_export$35: __VLS_WithSlots$11<typeof __VLS_base$11, __VLS_Slots$11>;
+declare const _default$6: typeof __VLS_export$35;
 type __VLS_WithSlots$11<T, S> = T & {
   new (): {
     $slots: S;
@@ -3767,7 +4259,7 @@ type __VLS_WithSlots$11<T, S> = T & {
 //#endregion
 //#region temp/packages/editor/src/layouts/sidebar/layer/LayerPanel.vue.d.ts
 type __VLS_Slots$10 = LayerPanelSlots;
-type __VLS_Props$32 = {
+type __VLS_Props$31 = {
   layerContentMenu: (MenuButton | MenuComponent)[];
   indent?: number;
   nextLevelIndentIncrement?: number;
@@ -3776,13 +4268,13 @@ type __VLS_Props$32 = {
   canDropIn?: CanDropInFunction; /** 组件树节点双击前的钩子函数，返回 false 则阻止默认的双击行为 */
   beforeNodeDblclick?: (_event: MouseEvent, _data: TreeNodeData) => Promise<boolean | void> | boolean | void;
 };
-declare const __VLS_base$10: import("@vue/runtime-core").DefineComponent<__VLS_Props$32, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+declare const __VLS_base$10: import("@vue/runtime-core").DefineComponent<__VLS_Props$31, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   "node-dblclick": (event: MouseEvent, data: TreeNodeData) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$32> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$31> & Readonly<{
   "onNode-dblclick"?: ((event: MouseEvent, data: TreeNodeData) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$33: __VLS_WithSlots$10<typeof __VLS_base$10, __VLS_Slots$10>;
-declare const _default$25: typeof __VLS_export$33;
+declare const __VLS_export$34: __VLS_WithSlots$10<typeof __VLS_base$10, __VLS_Slots$10>;
+declare const _default$26: typeof __VLS_export$34;
 type __VLS_WithSlots$10<T, S> = T & {
   new (): {
     $slots: S;
@@ -3790,151 +4282,151 @@ type __VLS_WithSlots$10<T, S> = T & {
 };
 //#endregion
 //#region temp/packages/editor/src/fields/CodeSelect.vue.d.ts
-type __VLS_Props$31 = FieldProps<CodeSelectConfig>;
-declare const __VLS_export$32: import("@vue/runtime-core").DefineComponent<__VLS_Props$31, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$30 = FieldProps<CodeSelectConfig>;
+declare const __VLS_export$33: import("@vue/runtime-core").DefineComponent<__VLS_Props$30, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (v: any, eventData: ContainerChangeEventData) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$31> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$30> & Readonly<{
   onChange?: ((v: any, eventData: ContainerChangeEventData) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$3: typeof __VLS_export$32;
+declare const _default$3: typeof __VLS_export$33;
 //#endregion
 //#region temp/packages/editor/src/fields/CodeSelectCol.vue.d.ts
-type __VLS_Props$30 = FieldProps<CodeSelectColConfig>;
-declare const __VLS_export$31: import("@vue/runtime-core").DefineComponent<__VLS_Props$30, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$29 = FieldProps<CodeSelectColConfig>;
+declare const __VLS_export$32: import("@vue/runtime-core").DefineComponent<__VLS_Props$29, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (v: any, eventData: ContainerChangeEventData) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$30> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$29> & Readonly<{
   onChange?: ((v: any, eventData: ContainerChangeEventData) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$4: typeof __VLS_export$31;
+declare const _default$4: typeof __VLS_export$32;
 //#endregion
 //#region temp/packages/editor/src/fields/DataSourceFields.vue.d.ts
-type __VLS_Props$29 = FieldProps<DataSourceFieldsConfig>;
+type __VLS_Props$28 = FieldProps<DataSourceFieldsConfig>;
 type __VLS_ModelProps$4 = {
   'width'?: number;
   'visible'?: boolean;
   'visible1'?: boolean;
 };
-type __VLS_PublicProps$4 = __VLS_Props$29 & __VLS_ModelProps$4;
-declare const __VLS_export$30: import("@vue/runtime-core").DefineComponent<__VLS_PublicProps$4, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_PublicProps$4 = __VLS_Props$28 & __VLS_ModelProps$4;
+declare const __VLS_export$31: import("@vue/runtime-core").DefineComponent<__VLS_PublicProps$4, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (v: any, eventData?: ContainerChangeEventData | undefined) => any;
-  "update:width": (value: number) => any;
   "update:visible": (value: boolean) => any;
+  "update:width": (value: number) => any;
   "update:visible1": (value: boolean) => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_PublicProps$4> & Readonly<{
   onChange?: ((v: any, eventData?: ContainerChangeEventData | undefined) => any) | undefined;
-  "onUpdate:width"?: ((value: number) => any) | undefined;
   "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+  "onUpdate:width"?: ((value: number) => any) | undefined;
   "onUpdate:visible1"?: ((value: boolean) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$12: typeof __VLS_export$30;
+declare const _default$12: typeof __VLS_export$31;
 //#endregion
 //#region temp/packages/editor/src/fields/DataSourceMocks.vue.d.ts
-type __VLS_Props$28 = FieldProps<DataSourceMocksConfig>;
+type __VLS_Props$27 = FieldProps<DataSourceMocksConfig>;
 type __VLS_ModelProps$3 = {
   'width'?: number;
   'visible'?: boolean;
 };
-type __VLS_PublicProps$3 = __VLS_Props$28 & __VLS_ModelProps$3;
-declare const __VLS_export$29: import("@vue/runtime-core").DefineComponent<__VLS_PublicProps$3, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_PublicProps$3 = __VLS_Props$27 & __VLS_ModelProps$3;
+declare const __VLS_export$30: import("@vue/runtime-core").DefineComponent<__VLS_PublicProps$3, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
-  "update:width": (value: number) => void;
   "update:visible": (value: boolean) => void;
+  "update:width": (value: number) => void;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_PublicProps$3> & Readonly<{
   onChange?: ((...args: any[]) => any) | undefined;
-  "onUpdate:width"?: ((value: number) => any) | undefined;
   "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+  "onUpdate:width"?: ((value: number) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$16: typeof __VLS_export$29;
+declare const _default$16: typeof __VLS_export$30;
 //#endregion
 //#region temp/packages/editor/src/fields/DataSourceMethods.vue.d.ts
-type __VLS_Props$27 = FieldProps<DataSourceMethodsConfig>;
-declare const __VLS_export$28: import("@vue/runtime-core").DefineComponent<__VLS_Props$27, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$26 = FieldProps<DataSourceMethodsConfig>;
+declare const __VLS_export$29: import("@vue/runtime-core").DefineComponent<__VLS_Props$26, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$27> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$26> & Readonly<{
   onChange?: ((...args: any[]) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$15: typeof __VLS_export$28;
+declare const _default$15: typeof __VLS_export$29;
 //#endregion
 //#region temp/packages/editor/src/fields/DataSourceInput.vue.d.ts
-type __VLS_Props$26 = FieldProps<DataSourceInputConfig>;
-declare const __VLS_export$27: import("@vue/runtime-core").DefineComponent<__VLS_Props$26, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$25 = FieldProps<DataSourceInputConfig>;
+declare const __VLS_export$28: import("@vue/runtime-core").DefineComponent<__VLS_Props$25, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (value: string) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$26> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$25> & Readonly<{
   onChange?: ((value: string) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$13: typeof __VLS_export$27;
+declare const _default$13: typeof __VLS_export$28;
 //#endregion
 //#region temp/packages/editor/src/fields/DataSourceSelect.vue.d.ts
-type __VLS_Props$25 = FieldProps<DataSourceSelect>;
-declare const __VLS_export$26: import("@vue/runtime-core").DefineComponent<__VLS_Props$25, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$24 = FieldProps<DataSourceSelect>;
+declare const __VLS_export$27: import("@vue/runtime-core").DefineComponent<__VLS_Props$24, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$25> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$24> & Readonly<{
   onChange?: ((...args: any[]) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$17: typeof __VLS_export$26;
+declare const _default$17: typeof __VLS_export$27;
 //#endregion
 //#region temp/packages/editor/src/fields/DataSourceMethodSelect.vue.d.ts
-type __VLS_Props$24 = FieldProps<DataSourceMethodSelectConfig>;
-declare const __VLS_export$25: import("@vue/runtime-core").DefineComponent<__VLS_Props$24, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$23 = FieldProps<DataSourceMethodSelectConfig>;
+declare const __VLS_export$26: import("@vue/runtime-core").DefineComponent<__VLS_Props$23, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$24> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$23> & Readonly<{
   onChange?: ((...args: any[]) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$14: typeof __VLS_export$25;
+declare const _default$14: typeof __VLS_export$26;
 //#endregion
 //#region temp/packages/editor/src/fields/DataSourceFieldSelect/Index.vue.d.ts
-type __VLS_Props$23 = FieldProps<DataSourceFieldSelectConfig>;
-declare const __VLS_export$24: import("@vue/runtime-core").DefineComponent<__VLS_Props$23, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$22 = FieldProps<DataSourceFieldSelectConfig>;
+declare const __VLS_export$25: import("@vue/runtime-core").DefineComponent<__VLS_Props$22, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$23> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$22> & Readonly<{
   onChange?: ((...args: any[]) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$11: typeof __VLS_export$24;
+declare const _default$11: typeof __VLS_export$25;
 //#endregion
 //#region temp/packages/editor/src/fields/EventSelect.vue.d.ts
-type __VLS_Props$22 = FieldProps<EventSelectConfig>;
-declare const __VLS_export$23: import("@vue/runtime-core").DefineComponent<__VLS_Props$22, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$21 = FieldProps<EventSelectConfig>;
+declare const __VLS_export$24: import("@vue/runtime-core").DefineComponent<__VLS_Props$21, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (v: any, eventData?: ContainerChangeEventData | undefined) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$22> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$21> & Readonly<{
   onChange?: ((v: any, eventData?: ContainerChangeEventData | undefined) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$19: typeof __VLS_export$23;
+declare const _default$19: typeof __VLS_export$24;
 //#endregion
 //#region temp/packages/editor/src/fields/KeyValue.vue.d.ts
-type __VLS_Props$21 = FieldProps<KeyValueConfig>;
-declare const __VLS_export$22: import("@vue/runtime-core").DefineComponent<__VLS_Props$21, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+type __VLS_Props$20 = FieldProps<KeyValueConfig>;
+declare const __VLS_export$23: import("@vue/runtime-core").DefineComponent<__VLS_Props$20, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (value: Record<string, any>) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$21> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$20> & Readonly<{
   onChange?: ((value: Record<string, any>) => any) | undefined;
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$24: typeof __VLS_export$22;
+declare const _default$25: typeof __VLS_export$23;
 //#endregion
 //#region temp/packages/editor/src/layouts/sidebar/code-block/CodeBlockList.vue.d.ts
 type __VLS_Slots$9 = CodeBlockListSlots;
-type __VLS_Props$20 = {
+type __VLS_Props$19 = {
   indent?: number;
   nextLevelIndentIncrement?: number;
   customError?: (_id: Id, _errorType: CodeDeleteErrorType) => any;
 };
-declare const __VLS_base$9: import("@vue/runtime-core").DefineComponent<__VLS_Props$20, {
+declare const __VLS_base$9: import("@vue/runtime-core").DefineComponent<__VLS_Props$19, {
   nodeStatusMap: import("@vue/reactivity").Ref<Map<Id, {
     visible: boolean;
     expand: boolean;
@@ -3947,18 +4439,26 @@ 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;
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$19> & Readonly<{
+  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>;
-declare const __VLS_export$21: __VLS_WithSlots$9<typeof __VLS_base$9, __VLS_Slots$9>;
-declare const _default$1: typeof __VLS_export$21;
+declare const __VLS_export$22: __VLS_WithSlots$9<typeof __VLS_base$9, __VLS_Slots$9>;
+declare const _default$1: typeof __VLS_export$22;
 type __VLS_WithSlots$9<T, S> = T & {
   new (): {
     $slots: S;
@@ -3967,15 +4467,15 @@ type __VLS_WithSlots$9<T, S> = T & {
 //#endregion
 //#region temp/packages/editor/src/layouts/sidebar/code-block/CodeBlockListPanel.vue.d.ts
 type __VLS_Slots$8 = CodeBlockListPanelSlots;
-type __VLS_Props$19 = {
+type __VLS_Props$18 = {
   indent?: number;
   nextLevelIndentIncrement?: number;
   customError?: (_id: Id, _errorType: CodeDeleteErrorType) => any;
   customContentMenu: CustomContentMenuFunction;
 };
-declare const __VLS_base$8: import("@vue/runtime-core").DefineComponent<__VLS_Props$19, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$19> & Readonly<{}>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$20: __VLS_WithSlots$8<typeof __VLS_base$8, __VLS_Slots$8>;
-declare const _default$2: typeof __VLS_export$20;
+declare const __VLS_base$8: import("@vue/runtime-core").DefineComponent<__VLS_Props$18, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$18> & Readonly<{}>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$21: __VLS_WithSlots$8<typeof __VLS_base$8, __VLS_Slots$8>;
+declare const _default$2: typeof __VLS_export$21;
 type __VLS_WithSlots$8<T, S> = T & {
   new (): {
     $slots: S;
@@ -3983,7 +4483,7 @@ type __VLS_WithSlots$8<T, S> = T & {
 };
 //#endregion
 //#region temp/packages/editor/src/layouts/sidebar/data-source/DataSourceConfigPanel.vue.d.ts
-type __VLS_Props$18 = {
+type __VLS_Props$17 = {
   title?: string;
   values: any;
   disabled: boolean;
@@ -3992,27 +4492,27 @@ type __VLS_ModelProps$2 = {
   'visible'?: boolean;
   'width'?: number;
 };
-type __VLS_PublicProps$2 = __VLS_Props$18 & __VLS_ModelProps$2;
-declare const __VLS_export$19: import("@vue/runtime-core").DefineComponent<__VLS_PublicProps$2, {
+type __VLS_PublicProps$2 = __VLS_Props$17 & __VLS_ModelProps$2;
+declare const __VLS_export$20: import("@vue/runtime-core").DefineComponent<__VLS_PublicProps$2, {
   show(): void;
   hide(): void;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   close: () => any;
   submit: (v: any, eventData: ContainerChangeEventData) => any;
   open: (id: string) => any;
-  "update:width": (value: number) => any;
   "update:visible": (value: boolean) => any;
+  "update:width": (value: number) => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_PublicProps$2> & Readonly<{
   onClose?: (() => any) | undefined;
   onSubmit?: ((v: any, eventData: ContainerChangeEventData) => any) | undefined;
   onOpen?: ((id: string) => any) | undefined;
-  "onUpdate:width"?: ((value: number) => any) | undefined;
   "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+  "onUpdate:width"?: ((value: number) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$10: typeof __VLS_export$19;
+declare const _default$10: typeof __VLS_export$20;
 //#endregion
 //#region temp/packages/editor/src/layouts/sidebar/data-source/DataSourceAddButton.vue.d.ts
-type __VLS_Props$17 = {
+type __VLS_Props$16 = {
   datasourceTypeList: {
     text: string;
     type: string;
@@ -4020,20 +4520,20 @@ type __VLS_Props$17 = {
   addButtonConfig?: ButtonProps;
   addButtonText?: string;
 };
-declare const __VLS_export$18: import("@vue/runtime-core").DefineComponent<__VLS_Props$17, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+declare const __VLS_export$19: import("@vue/runtime-core").DefineComponent<__VLS_Props$16, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   add: (type: string) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$17> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$16> & Readonly<{
   onAdd?: ((type: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$9: typeof __VLS_export$18;
+declare const _default$9: typeof __VLS_export$19;
 //#endregion
 //#region temp/packages/editor/src/layouts/props-panel/PropsPanel.vue.d.ts
 type __VLS_Slots$7 = PropsPanelSlots;
-type __VLS_Props$16 = {
+type __VLS_Props$15 = {
   disabledShowSrc?: boolean;
   extendState?: (_state: FormState) => Record<string, any> | Promise<Record<string, any>>;
 };
-declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Props$16, {
+declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Props$15, {
   getFormState(): FormState | undefined;
   submit: (v: MNode, eventData?: ContainerChangeEventData) => Promise<void>;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
@@ -4486,7 +4986,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   unmounted: () => any;
   "submit-error": (e: any) => any;
   "form-error": (e: any) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$16> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$15> & Readonly<{
   onMounted?: ((internalInstance: {
     $: import("@vue/runtime-core").ComponentInternalInstance;
     $data: {};
@@ -4937,8 +5437,8 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   "onSubmit-error"?: ((e: any) => any) | undefined;
   "onForm-error"?: ((e: any) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$17: __VLS_WithSlots$7<typeof __VLS_base$7, __VLS_Slots$7>;
-declare const _default$29: typeof __VLS_export$17;
+declare const __VLS_export$18: __VLS_WithSlots$7<typeof __VLS_base$7, __VLS_Slots$7>;
+declare const _default$30: typeof __VLS_export$18;
 type __VLS_WithSlots$7<T, S> = T & {
   new (): {
     $slots: S;
@@ -4949,7 +5449,7 @@ type __VLS_WithSlots$7<T, S> = T & {
 type __VLS_Slots$6 = {
   'props-form-panel-header'(_props: {}): any;
 };
-type __VLS_Props$15 = {
+type __VLS_Props$14 = {
   config: FormConfig;
   values: FormValue;
   disabledShowSrc?: boolean;
@@ -4958,7 +5458,7 @@ type __VLS_Props$15 = {
   labelPosition?: string;
   extendState?: (_state: FormState) => Record<string, any> | Promise<Record<string, any>>;
 };
-declare const __VLS_base$6: import("@vue/runtime-core").DefineComponent<__VLS_Props$15, {
+declare const __VLS_base$6: import("@vue/runtime-core").DefineComponent<__VLS_Props$14, {
   configForm: Readonly<import("@vue/reactivity").ShallowRef<({
     $: import("@vue/runtime-core").ComponentInternalInstance;
     $data: {};
@@ -5143,15 +5643,15 @@ declare const __VLS_base$6: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   submit: (values: any, eventData?: ContainerChangeEventData | undefined) => any;
   "submit-error": (e: any) => any;
   "form-error": (e: any) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$15> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$14> & Readonly<{
   onMounted?: ((internalInstance: any) => any) | undefined;
   onUnmounted?: (() => any) | undefined;
   onSubmit?: ((values: any, eventData?: ContainerChangeEventData | undefined) => any) | undefined;
   "onSubmit-error"?: ((e: any) => any) | undefined;
   "onForm-error"?: ((e: any) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$16: __VLS_WithSlots$6<typeof __VLS_base$6, __VLS_Slots$6>;
-declare const _default$28: typeof __VLS_export$16;
+declare const __VLS_export$17: __VLS_WithSlots$6<typeof __VLS_base$6, __VLS_Slots$6>;
+declare const _default$29: typeof __VLS_export$17;
 type __VLS_WithSlots$6<T, S> = T & {
   new (): {
     $slots: S;
@@ -5159,20 +5659,20 @@ type __VLS_WithSlots$6<T, S> = T & {
 };
 //#endregion
 //#region temp/packages/editor/src/components/ToolButton.vue.d.ts
-type __VLS_Props$14 = {
+type __VLS_Props$13 = {
   data?: MenuButton | MenuComponent;
   eventType?: 'mousedown' | 'mouseup' | 'click';
 };
-declare const __VLS_export$15: import("@vue/runtime-core").DefineComponent<__VLS_Props$14, {
+declare const __VLS_export$16: import("@vue/runtime-core").DefineComponent<__VLS_Props$13, {
   getElRef: () => Readonly<import("@vue/reactivity").ShallowRef<HTMLDivElement | null>>;
-}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$14> & Readonly<{}>, {
+}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$13> & Readonly<{}>, {
   data: MenuButton | MenuComponent;
   eventType: "mousedown" | "mouseup" | "click";
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$34: typeof __VLS_export$15;
+declare const _default$35: typeof __VLS_export$16;
 //#endregion
 //#region temp/packages/editor/src/components/ContentMenu.vue.d.ts
-type __VLS_Props$13 = {
+type __VLS_Props$12 = {
   menuData?: (MenuButton | MenuComponent)[];
   isSubMenu?: boolean;
   active?: string | number;
@@ -5182,7 +5682,7 @@ declare var __VLS_7$1: {};
 type __VLS_Slots$5 = {} & {
   title?: (props: typeof __VLS_7$1) => any;
 };
-declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Props$13, {
+declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Props$12, {
   menu: Readonly<import("@vue/reactivity").ShallowRef<HTMLDivElement | null>>;
   menuPosition: Ref<{
     left: number;
@@ -5208,7 +5708,7 @@ declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   mouseenter: () => any;
   show: () => any;
   hide: () => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$13> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$12> & Readonly<{
   onMouseenter?: (() => any) | undefined;
   onShow?: (() => any) | undefined;
   onHide?: (() => any) | undefined;
@@ -5217,8 +5717,8 @@ declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   isSubMenu: boolean;
   autoHide: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$14: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
-declare const _default$8: typeof __VLS_export$14;
+declare const __VLS_export$15: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
+declare const _default$8: typeof __VLS_export$15;
 type __VLS_WithSlots$5<T, S> = T & {
   new (): {
     $slots: S;
@@ -5226,14 +5726,14 @@ type __VLS_WithSlots$5<T, S> = T & {
 };
 //#endregion
 //#region temp/packages/editor/src/components/Icon.vue.d.ts
-type __VLS_Props$12 = {
+type __VLS_Props$11 = {
   icon?: any;
 };
-declare const __VLS_export$13: import("@vue/runtime-core").DefineComponent<__VLS_Props$12, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$12> & Readonly<{}>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$23: typeof __VLS_export$13;
+declare const __VLS_export$14: import("@vue/runtime-core").DefineComponent<__VLS_Props$11, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$11> & Readonly<{}>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
+declare const _default$24: typeof __VLS_export$14;
 //#endregion
 //#region temp/packages/editor/src/components/SplitView.vue.d.ts
-type __VLS_Props$11 = {
+type __VLS_Props$10 = {
   width?: number;
   left?: number;
   right?: number;
@@ -5252,13 +5752,13 @@ type __VLS_Slots$4 = {} & {
 } & {
   right?: (props: typeof __VLS_19) => any;
 };
-declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Props$11, {
+declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Props$10, {
   updateWidth(): void;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
   "update:left": (...args: any[]) => void;
   "update:right": (...args: any[]) => void;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$11> & Readonly<{
+}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$10> & Readonly<{
   onChange?: ((...args: any[]) => any) | undefined;
   "onUpdate:left"?: ((...args: any[]) => any) | undefined;
   "onUpdate:right"?: ((...args: any[]) => any) | undefined;
@@ -5267,8 +5767,8 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   minRight: number;
   minCenter: number;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$12: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
-declare const _default$26: typeof __VLS_export$12;
+declare const __VLS_export$13: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
+declare const _default$27: typeof __VLS_export$13;
 type __VLS_WithSlots$4<T, S> = T & {
   new (): {
     $slots: S;
@@ -5285,8 +5785,8 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<{}, {},
 }, string, import("@vue/runtime-core").PublicProps, Readonly<{}> & Readonly<{
   onChange?: ((e: OnDrag$1<import("gesto").default>) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, true, {}, any>;
-declare const __VLS_export$11: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
-declare const _default$30: typeof __VLS_export$11;
+declare const __VLS_export$12: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
+declare const _default$31: typeof __VLS_export$12;
 type __VLS_WithSlots$3<T, S> = T & {
   new (): {
     $slots: S;
@@ -5294,7 +5794,7 @@ type __VLS_WithSlots$3<T, S> = T & {
 };
 //#endregion
 //#region temp/packages/editor/src/components/CodeBlockEditor.vue.d.ts
-type __VLS_Props$10 = {
+type __VLS_Props$9 = {
   content: Omit<CodeBlockContent, 'content'> & {
     content: string;
   };
@@ -5306,27 +5806,27 @@ type __VLS_ModelProps$1 = {
   'width'?: number;
   'visible'?: boolean;
 };
-type __VLS_PublicProps$1 = __VLS_Props$10 & __VLS_ModelProps$1;
-declare const __VLS_export$10: import("@vue/runtime-core").DefineComponent<__VLS_PublicProps$1, {
+type __VLS_PublicProps$1 = __VLS_Props$9 & __VLS_ModelProps$1;
+declare const __VLS_export$11: import("@vue/runtime-core").DefineComponent<__VLS_PublicProps$1, {
   show(): Promise<void>;
   hide(): Promise<void>;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   close: () => any;
   submit: (values: CodeBlockContent, eventData: ContainerChangeEventData) => any;
   open: () => any;
-  "update:width": (value: number) => any;
   "update:visible": (value: boolean) => any;
+  "update:width": (value: number) => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_PublicProps$1> & Readonly<{
   onClose?: (() => any) | undefined;
   onSubmit?: ((values: CodeBlockContent, eventData: ContainerChangeEventData) => any) | undefined;
   onOpen?: (() => any) | undefined;
-  "onUpdate:width"?: ((value: number) => any) | undefined;
   "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+  "onUpdate:width"?: ((value: number) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default: typeof __VLS_export$10;
+declare const _default: typeof __VLS_export$11;
 //#endregion
 //#region temp/packages/editor/src/components/CompareForm.vue.d.ts
-type __VLS_Props$9 = {
+type __VLS_Props$8 = {
   /** 当前值（修改后的值） */value: Partial<MNode> | Partial<DataSourceSchema> | Partial<CodeBlockContent> | Record<string, any>; /** 用于对比的旧值（修改前的值） */
   lastValue?: Partial<MNode> | Partial<DataSourceSchema> | Partial<CodeBlockContent> | Record<string, any>;
   /**
@@ -5358,60 +5858,121 @@ type __VLS_Props$9 = {
    */
   loadConfig?: CompareFormLoadConfig;
 };
-declare const __VLS_export$9: import("@vue/runtime-core").DefineComponent<__VLS_Props$9, {
+declare const __VLS_export$10: import("@vue/runtime-core").DefineComponent<__VLS_Props$8, {
   form: ShallowRef<InstanceType<typeof MForm> | null>;
   config: Ref<FormConfig>;
   reload: () => Promise<void>;
-}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$9> & Readonly<{}>, {
+}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$8> & Readonly<{}>, {
   labelWidth: string;
   category: CompareCategory;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$5: typeof __VLS_export$9;
+declare const _default$5: typeof __VLS_export$10;
 //#endregion
-//#region temp/packages/editor/src/layouts/history-list/Bucket.vue.d.ts
-type __VLS_Props$8 = {
-  /** Bucket 标题，例如 "数据源" / "代码块"，渲染在 bucket 头部。 */title: string; /** 当前 bucket 对应的目标 id（dataSource.id 或 codeBlock.id），同时用于组装子项的 key。 */
-  bucketId: string | number;
-  /**
-   * 子项 key 的命名空间前缀：内置 `ds` 表示数据源，`cb` 表示代码块；
-   * 业务方复用 Bucket 时可传入自定义前缀（如 `mod`）。与上层折叠状态 key 保持一致。
-   */
-  prefix: string; /** 是否展示底部「回到初始状态」入口，默认 true。无 undo cursor 语义的自定义历史可传 false 关闭。 */
-  showInitial?: boolean; /** 当前 bucket 下的所有历史分组，按时间倒序展示（最近的操作在前）。 */
-  groups: {
+//#region temp/packages/editor/src/layouts/history-list/composables.d.ts
+/**
+ * 通用 bucket 分组（数据源 / 代码块及业务自定义历史）在面板中的展示结构。
+ * 由 Bucket / BucketTab 复用，step 类型通过泛型 T 收窄（约束为 {@link BaseStepValue}）。
+ */
+interface HistoryBucketGroup<T extends BaseStepValue = BaseStepValue> {
+  /** 组内最后一步是否已应用 */
+  applied: boolean;
+  /** 是否为当前所在的分组 */
+  isCurrent?: boolean;
+  /** 该分组的操作类型 */
+  opType: HistoryOpType;
+  /** 组内所有步骤 */
+  steps: {
+    index: number;
     applied: boolean;
     isCurrent?: boolean;
-    opType: HistoryOpType;
-    steps: {
-      index: number;
-      applied: boolean;
-      isCurrent?: boolean;
-      step: any;
+    step: T;
+  }[];
+}
+//#endregion
+//#region temp/packages/editor/src/layouts/history-list/Bucket.vue.d.ts
+declare const __VLS_export$9: <T extends BaseStepValue = BaseStepValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$1<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+  props: import("vue").PublicProps & __VLS_PrettifyLocal$1<{
+    /**
+     * 该类历史的整体渲染配置（title / prefix / describe* / isStep* / showInitial / gotoEnabled）。
+     * 由父组件按业务类型注入，组件内部按需读取，避免逐项透传多个 props。
+     */
+    config: HistoryBucketConfig<T>; /** 当前 bucket 对应的目标 id（dataSource.id 或 codeBlock.id），同时用于组装子项的 key。 */
+    bucketId: string | number; /** 当前 bucket 下的所有历史分组，按时间倒序展示（最近的操作在前）。 */
+    groups: HistoryBucketGroup<T>[]; /** 共享的折叠状态表（key -> 是否展开，缺省或 true 为展开、false 为收起），由顶层 panel 统一维护以便跨 tab 复用。 */
+    expanded: Record<string, boolean>;
+  } & {
+    onToggle?: ((_key: string) => any) | undefined;
+    onGoto?: ((_bucketId: string | number, _index: number) => any) | undefined;
+    "onDiff-step"?: ((_bucketId: string | number, _index: number) => any) | undefined;
+    "onRevert-step"?: ((_bucketId: string | number, _index: number) => any) | undefined;
+    "onGoto-initial"?: ((_bucketId: string | number) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: {}) => void;
+  attrs: any;
+  slots: {};
+  emit: {
+    (_e: "toggle", _key: string): void;
+    (_e: "goto", _bucketId: string | number, _index: number): void;
+    (_e: "goto-initial", _bucketId: string | number): void;
+    (_e: "diff-step", _bucketId: string | number, _index: number): void;
+    (_e: "revert-step", _bucketId: string | number, _index: number): void;
+  };
+}>) => import("vue").VNode & {
+  __ctx?: Awaited<typeof __VLS_setup>;
+};
+declare const _default$22: typeof __VLS_export$9;
+type __VLS_PrettifyLocal$1<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
+//#endregion
+//#region temp/packages/editor/src/layouts/history-list/BucketTab.vue.d.ts
+declare const __VLS_export$8: <T extends BaseStepValue = BaseStepValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+  props: import("vue").PublicProps & __VLS_PrettifyLocal<{
+    /**
+     * 该类历史的整体渲染配置（title / prefix / describe* / isStep* / showInitial / gotoEnabled），
+     * 由父组件按业务类型注入并整体透传给 Bucket，避免逐项透传多个 props。
+     */
+    config: HistoryBucketConfig<T>;
+    /**
+     * 已按目标 id 聚拢成的 bucket 列表，每个 bucket 内部的 groups 已按时间倒序排好。
+     * 空数组时显示空态。
+     */
+    buckets: {
+      id: string | number;
+      groups: HistoryBucketGroup<T>[];
     }[];
-  }[]; /** 组级描述文案生成器，接收一个 group，返回展示文本。由父组件按业务类型注入。 */
-  describeGroup: (_group: any) => string; /** 单步描述文案生成器，接收一个 step，返回展示文本。用于合并组展开后的子步列表。 */
-  describeStep: (_step: any) => string; /** 判断某个 step 是否可查看差异（前后值都存在）。由父组件按业务类型注入；不传则一律不展示差异入口。 */
-  isStepDiffable?: (_step: any) => boolean; /** 共享的折叠状态表（key -> 是否展开），由顶层 panel 统一维护以便跨 tab 复用。 */
-  expanded: Record<string, boolean>; /** 是否支持「跳转到该记录」(goto)。默认 true。 */
-  gotoEnabled?: boolean;
+    /**
+     * 共享的折叠状态表（key -> 是否展开），由顶层 panel 统一维护。
+     * key 形如 `${prefix}-${id}-${组内首步 index}`——以稳定的 step 索引而非展示位置标识分组，
+     * 这样历史数据更新后已展开的分组状态仍能正确保持。
+     */
+    expanded: Record<string, boolean>;
+  } & {
+    onClear?: (() => any) | undefined;
+    onToggle?: ((_key: string) => any) | undefined;
+    onGoto?: ((_targetId: string | number, _index: number) => any) | undefined;
+    "onDiff-step"?: ((_targetId: string | number, _index: number) => any) | undefined;
+    "onRevert-step"?: ((_targetId: string | number, _index: number) => any) | undefined;
+    "onGoto-initial"?: ((_targetId: string | number) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: {}) => void;
+  attrs: any;
+  slots: {};
+  emit: {
+    (_e: "toggle", _key: string): void;
+    (_e: "goto", _targetId: string | number, _index: number): void;
+    (_e: "goto-initial", _targetId: string | number): void;
+    (_e: "diff-step", _targetId: string | number, _index: number): void;
+    (_e: "revert-step", _targetId: string | number, _index: number): void;
+    (_e: "clear"): void;
+  };
+}>) => import("vue").VNode & {
+  __ctx?: Awaited<typeof __VLS_setup>;
 };
-declare const __VLS_export$8: import("@vue/runtime-core").DefineComponent<__VLS_Props$8, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {} & {
-  toggle: (_key: string) => any;
-  goto: (_bucketId: string | number, _index: number) => any;
-  "diff-step": (_bucketId: string | number, _index: number) => any;
-  "revert-step": (_bucketId: string | number, _index: number) => any;
-  "goto-initial": (_bucketId: string | number) => any;
-}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$8> & Readonly<{
-  onToggle?: ((_key: string) => any) | undefined;
-  onGoto?: ((_bucketId: string | number, _index: number) => any) | undefined;
-  "onDiff-step"?: ((_bucketId: string | number, _index: number) => any) | undefined;
-  "onRevert-step"?: ((_bucketId: string | number, _index: number) => any) | undefined;
-  "onGoto-initial"?: ((_bucketId: string | number) => any) | undefined;
-}>, {
-  gotoEnabled: boolean;
-  showInitial: boolean;
-}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$22: typeof __VLS_export$8;
+declare const _default$23: typeof __VLS_export$8;
+type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
 //#endregion
 //#region temp/packages/editor/src/layouts/history-list/HistoryDiffDialog.vue.d.ts
 type __VLS_Props$7 = {
@@ -5427,11 +5988,13 @@ type __VLS_Props$7 = {
    */
   loadConfig?: CompareFormLoadConfig;
   width?: string;
+  isConfirm?: boolean;
   onConfirm?: () => void;
   selfDiffFieldTypes?: string[];
 };
 declare const __VLS_export$7: import("@vue/runtime-core").DefineComponent<__VLS_Props$7, {
   open: (p: DiffDialogPayload) => void;
+  confirm: (p: DiffDialogPayload) => Promise<boolean>;
   close: () => void;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   close: (...args: any[]) => void;
@@ -5469,13 +6032,13 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pu
   target: Readonly<import("@vue/reactivity").ShallowRef<HTMLDivElement | null>>;
   titleEl: Readonly<import("@vue/reactivity").ShallowRef<HTMLDivElement | null>>;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
+  "update:visible": (value: boolean) => any;
   "update:width": (value: number) => any;
   "update:height": (value: number) => any;
-  "update:visible": (value: boolean) => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  "onUpdate:visible"?: ((value: boolean) => any) | undefined;
   "onUpdate:width"?: ((value: number) => any) | undefined;
   "onUpdate:height"?: ((value: number) => any) | undefined;
-  "onUpdate:visible"?: ((value: boolean) => any) | undefined;
 }>, {
   title: string;
   position: Position;
@@ -5531,7 +6094,7 @@ declare const __VLS_base$1: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   indent: number;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$5: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
-declare const _default$35: typeof __VLS_export$5;
+declare const _default$36: typeof __VLS_export$5;
 type __VLS_WithSlots$1<T, S> = T & {
   new (): {
     $slots: S;
@@ -5582,7 +6145,7 @@ declare const __VLS_base: import("@vue/runtime-core").DefineComponent<__VLS_Prop
   isExpandable: IsExpandableFunction;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$4: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default$36: typeof __VLS_export$4;
+declare const _default$37: typeof __VLS_export$4;
 type __VLS_WithSlots<T, S> = T & {
   new (): {
     $slots: S;
@@ -5598,7 +6161,7 @@ declare const __VLS_export$3: import("@vue/runtime-core").DefineComponent<__VLS_
 }>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$27: typeof __VLS_export$3;
+declare const _default$28: typeof __VLS_export$3;
 //#endregion
 //#region temp/packages/editor/src/fields/DisplayConds.vue.d.ts
 type __VLS_Props$2 = FieldProps<DisplayCondsConfig>;
@@ -5629,11 +6192,11 @@ declare const __VLS_export: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   onChange?: ((v: any, eventData: ContainerChangeEventData) => any) | undefined;
   onAddDiffCount?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
-declare const _default$31: typeof __VLS_export;
+declare const _default$32: typeof __VLS_export;
 //#endregion
 //#region temp/packages/editor/src/plugin.d.ts
-declare const _default$39: {
+declare const _default$40: {
   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, BaseStepValue, 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, HistoryBucketConfig, _default$21 as HistoryDiffDialog, _default$22 as HistoryListBucket, _default$23 as HistoryListBucketTab, HistoryListExtraTab, HistoryOpOptions, HistoryOpOptionsWithChangeRecords, HistoryOpSource, HistoryOpType, HistoryPersistOptions, HistoryRowDescriptor, HistoryState, _default$24 as Icon, IdleTask, IdleTaskEvents, IsExpandableFunction, KeyBindingCacheItem, KeyBindingCommand, KeyBindingItem, _default$25 as KeyValue, Keys, LEFT_COLUMN_WIDTH_STORAGE_KEY, LayerNodeSlots, LayerNodeStatus, LayerOffset, _default$26 as LayerPanel, LayerPanelSlots, Layout, _default$27 as LayoutContainer, _default$27 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$28 as PageFragmentSelect, PageHistoryGroup, PageHistoryStepEntry, PartSortableOptions, PastePosition, PersistedHistoryState, PropsFormConfigFunction, _default$29 as PropsFormPanel, PropsFormValueFunction, _default$30 as PropsPanel, PropsPanelSlots, PropsState, RIGHT_COLUMN_WIDTH_STORAGE_KEY, _default$31 as Resizer, ScrollViewer, ScrollViewerEvent, ScrollViewerSlots, SerializedUndoRedo, Services, SetColumnWidth, SideBarData, SideComponent, SideItem, SideItemKey, SidebarSlots, StageCore, StageOptions, StageOverlayState, StageRect, StageSlots, StepDiffItem, StepValue, StoreState, StoreStateKey, _default$32 as StyleSetter, SyncAfterHook, SyncBeforeHook, SyncHookPlugin, _default$33 as TMagicCodeEditor, _default$34 as TMagicEditor, _default$35 as ToolButton, _default$36 as Tree, _default$37 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$38 as codeBlockService, collectRelatedNodes, createStackStep, _default$39 as dataSourceService, debug, _default$40 as default, defaultIsExpandable, _default$41 as depService, describeRevertStep, describeStepForRevert, deserializeStacks, designPlugin, detectPageTargetId, detectPageTargetName, detectStackOpType, displayTabConfig, editorNodeMergeCustomizer, _default$42 as editorService, eqOptions, error, eventTabConfig, _default$43 as eventsService, fillConfig, fixNodeLeft, fixNodePosition, formPlugin, generatePageName, generatePageNameByApp, getAddParent, getCascaderOptionsFromFields, getCodeBlockFormConfig, getDefaultConfig, getDisplayField, getEditorConfig, getFieldType, getFormConfig, getFormValue, getGuideLineFromCache, getInitPositionStyle, getNodeIndex, getOrCreateStack, getPageFragmentList, getPageList, getPageNameList, getPositionInContainer, getRelativeStyle, _default$44 as historyService, idbDelete, idbGet, idbSet, info, isIncludeDataSource, isIndexedDBSupported, _default$45 as loadMonaco, log, markStackSaved, mergePageSteps, mergeStackSteps, moveItemsInContainer, numberOptions, openIndexedDB, _default$46 as propsService, resolveSelectedNode, serializeConfig, serializeStacks, setChildrenLayout, setEditorConfig, setLayout, _default$47 as stageOverlayService, _default$48 as storageService, styleTabConfig, tablePlugin, toggleFixedPosition, _default$49 as uiService, undoFloor, updateStatus, useCodeBlockEdit, useEditorContentHeight, useFilter, useFloatBox, useGetSo, useNextFloatBoxPosition, useNodeStatus, useServices, useStage, useWindowRect, warn };