@tmagic/editor 1.8.0-beta.7 → 1.8.0-manmanyu.10

package/types/index.d.ts

@@ -4,8 +4,8 @@ import StageCore, { CanDropIn, ContainerHighlightType, CustomizeMoveableOptions,
 import designPlugin, { ButtonProps, DesignPluginOptions } from "@tmagic/design";
 import Gesto, { OnDrag, OnDrag as OnDrag$1 } from "gesto";
 import { CodeBlockContent, CodeBlockDSL, DataSchema, DataSourceFieldType, DataSourceSchema, DepData, DepExtendedData, DepTargetType, DepTargetType as DepTargetType$1, DisplayCond, EventOption, Id, MApp, MContainer, MNode, MPage, MPageFragment, NodeType, Target, TargetOptions } from "@tmagic/core";
-import { App, Component, ComputedRef, Ref, ShallowRef } from "vue";
-import EventEmitter, { EventEmitter as EventEmitter$1 } from "events";
+import { App, AppContext, Component, ComputedRef, Ref, ShallowRef } from "vue";
+import EventEmitter$1, { EventEmitter } from "events";
 import * as Monaco from "monaco-editor";
 import Sortable, { Options, SortableEvent } from "sortablejs";
 import { PascalCasedProperties, Writable } from "type-fest";
@@ -47,7 +47,7 @@ export * from "@tmagic/utils";
  * 调用时的参数会透传到before方法的参数中, 然后before的return 会作为原方法的参数和after的参数，after第一个参数则是原方法的return值;
  * 如需终止后续方法调用可以return new Error();
  */
-declare class BaseService extends EventEmitter$1 {
+declare class BaseService extends EventEmitter {
   private pluginOptionsList;
   private taskList;
   private doingTask;
@@ -62,11 +62,11 @@ declare class BaseService extends EventEmitter$1 {
 }
 //#endregion
 //#region temp/packages/editor/src/services/codeBlock.d.ts
-declare const canUsePluginMethods$7: {
+declare const canUsePluginMethods$8: {
   async: readonly ["setCodeDslById", "setEditStatus", "setCombineIds", "setUndeleteableList", "deleteCodeDslByIds"];
   sync: string[];
 };
-type AsyncMethodName$4 = Writable<(typeof canUsePluginMethods$7)['async']>;
+type AsyncMethodName$4 = Writable<(typeof canUsePluginMethods$8)['async']>;
 declare class CodeBlock extends BaseService {
   private state;
   /**
@@ -329,11 +329,11 @@ interface State$2 {
   methods: Record<string, EventOption[]>;
 }
 type StateKey$1 = keyof State$2;
-declare const canUsePluginMethods$6: {
+declare const canUsePluginMethods$7: {
   async: never[];
   sync: readonly ["getFormConfig", "setFormConfig", "getFormValue", "setFormValue", "getFormEvent", "setFormEvent", "getFormMethod", "setFormMethod", "add", "update", "remove", "createId"];
 };
-type SyncMethodName$4 = Writable<(typeof canUsePluginMethods$6)['sync']>;
+type SyncMethodName$5 = Writable<(typeof canUsePluginMethods$7)['sync']>;
 declare class DataSource extends BaseService {
   private state;
   /**
@@ -466,7 +466,7 @@ declare class DataSource extends BaseService {
   getDataSourceById(id: string): DataSourceSchema | undefined;
   resetState(): void;
   destroy(): void;
-  usePlugin(options: SyncHookPlugin<SyncMethodName$4, DataSource>): void;
+  usePlugin(options: SyncHookPlugin<SyncMethodName$5, DataSource>): void;
   /**
    * 复制时会带上组件关联的数据源
    * @param config 组件节点配置
@@ -919,12 +919,12 @@ type EditorService = Editor;
 declare const _default$42: Editor;
 //#endregion
 //#region temp/packages/editor/src/services/events.d.ts
-declare const canUsePluginMethods$5: {
+declare const canUsePluginMethods$6: {
   async: readonly [];
   sync: readonly ["setEvent", "getEvent", "setMethod", "getMethod"];
 };
-type AsyncMethodName$3 = Writable<(typeof canUsePluginMethods$5)['async']>;
-type SyncMethodName$3 = Writable<(typeof canUsePluginMethods$5)['sync']>;
+type AsyncMethodName$3 = Writable<(typeof canUsePluginMethods$6)['async']>;
+type SyncMethodName$4 = Writable<(typeof canUsePluginMethods$6)['sync']>;
 declare class Events extends BaseService {
   constructor();
   setEvents(events: Record<string, EventOption[]>): void;
@@ -935,7 +935,7 @@ declare class Events extends BaseService {
   getMethod(type: string, _targetId: Id): EventOption[];
   resetState(): void;
   destroy(): void;
-  usePlugin(options: AsyncHookPlugin<AsyncMethodName$3, Events> & SyncHookPlugin<SyncMethodName$3, Events>): void;
+  usePlugin(options: AsyncHookPlugin<AsyncMethodName$3, Events> & SyncHookPlugin<SyncMethodName$4, Events>): void;
 }
 type EventsService = Events;
 declare const _default$43: Events;
@@ -1010,133 +1010,153 @@ declare class UndoRedo<T = any> {
 }
 //#endregion
 //#region temp/packages/editor/src/services/history.d.ts
+declare const canUsePluginMethods$5: {
+  sync: readonly ["push", "undo", "redo"];
+};
+type SyncMethodName$3 = Writable<(typeof canUsePluginMethods$5)['sync']>;
 declare class History extends BaseService {
   state: {
-    pageId?: Id | undefined;
-    pageSteps: Record<Id, UndoRedo<StepValue>>;
-    canRedo: boolean;
-    canUndo: boolean;
-    codeBlockState: Record<Id, UndoRedo<CodeBlockStepValue>>;
-    dataSourceState: Record<Id, UndoRedo<DataSourceStepValue>>;
+    steps: {
+      [x: string]: Record<Id, UndoRedo<any>>;
+      page: Record<Id, UndoRedo<StepValue>>;
+      codeBlock: Record<Id, UndoRedo<CodeBlockStepValue>>;
+      dataSource: Record<Id, UndoRedo<DataSourceStepValue>>;
+    };
+    stepNames: Record<string, string>;
   };
   constructor();
+  /**
+   * 注册一个扩展历史类型，使其可与内置 `page` / `codeBlock` / `dataSource` 一样走统一的
+   * {@link push} / {@link undo} / {@link redo}（按 id 分栈、独立 undo/redo）。
+   *
+   * @param stepType 自定义历史类型标识（勿与内置类型重名）
+   * @param options.event push/undo/redo 后派发的事件名，缺省为 `${stepType}-history-change`
+   * @param options.name 历史面板中的展示名称（tab / 分组标题等），缺省回退到 stepType 本身
+   */
+  registerStepType(stepType: string, options?: {
+    event?: string;
+    name?: string;
+  }): void;
+  /**
+   * 读取指定历史类型的展示名称（用于历史面板 tab / 分组标题等）。
+   * 未登记名称时回退到 stepType 本身。
+   */
+  getStepName(stepType: HistoryStepType): string;
+  /**
+   * 设置指定历史类型的展示名称（用于历史面板 tab / 分组标题等）。
+   * 内置 `page` / `codeBlock` / `dataSource` 也可在此覆盖默认中文名。
+   */
+  setStepName(stepType: HistoryStepType, name: string): void;
   reset(): void;
-  resetPage(): void;
-  changePage(page: MPage | MPageFragment): void;
   resetState(): void;
   /**
-   * 为指定页面 / 页面片种入一条「初始基线」记录（如加载 DSL 时的「初始 / 加载」基线）。
+   * 为指定历史栈（默认 `page`，也适用于 codeBlock / dataSource / 扩展类型）种入一条「初始基线」记录。
    *
-   * 该记录是一条 `opType: 'initial'` 的 {@link StepValue}，作为页面历史栈 **index 0 的固定底线**：
+   * 该记录是一条 `opType: 'initial'` 的 step，作为对应栈 **index 0 的固定底线**：
    * - 它是一条真实入栈的 step（随栈一起持久化），但被钉为撤销/回滚的下限——cursor 永不低于它，
-   *   因此不会被 undo / goto / revert 触达（详见 {@link undo} / {@link setCanUndoRedo}）；
-   * - 历史面板把它过滤出分组列表（见 {@link getPageHistoryGroups}），改由底部「初始」行展示。
+   *   因此不会被 undo / goto / revert 触达（详见 {@link undo} / {@link undoFloor}）；
+   * - 历史面板把它过滤出分组列表（见 {@link getHistoryGroups}），改由底部「初始」行展示。
    *
-   * 仅当目标页面栈为空时种入（保证 initial 一定位于 index 0）；已存在 initial 底线时默认不重复种入，
-   * 传 `force=true` 且栈为空时按新基线种入。
+   * 仅当目标栈为空时种入（保证 initial 一定位于 index 0）；已存在 initial 底线时不重复种入。
+   *
+   * @param stepType 历史类型
+   * @param id       目标栈 id（page 为 pageId，其余类型为对应资源 id）
+   * @param options  基线展示信息（名称 / 描述 / 来源）
    */
-  setPageMarker(pageId: Id, options?: {
+  setMarker(stepType: HistoryStepType, id: Id, options?: {
     name?: string;
     description?: string;
     source?: HistoryOpSource;
+    extra?: Record<string, any>;
   }): StepValue | null;
   /**
-   * 读取指定页面（缺省当前活动页）的初始基线 step（页面栈 index 0 且 `opType: 'initial'`）；
-   * 不存在时返回 undefined。
+   * 读取指定历史栈的初始基线 step（栈 index 0 且 `opType: 'initial'`）；
+   * 不存在或 id 缺省时返回 undefined。
    */
-  getPageMarker(pageId?: Id): StepValue | undefined;
+  getMarker(stepType: HistoryStepType, id?: Id): StepValue | undefined;
   /**
-   * 把一条步骤推入指定页面的栈；不指定 pageId 时落到当前活动页。
+   * 把一条步骤推入指定历史栈。统一入口，所有类型（page / codeBlock / dataSource / 扩展）行为完全一致：
+   * 按 `stepType` 选择目标栈类型，按 `id`（必填）选择具体栈，按需建栈后入栈，并派发对应的历史变更事件
+   * （`page` 为 `change`，其余见 {@link registerStepType}），回调签名统一为 `(id, step)`。
    *
-   * 跨页操作（例如 `moveToContainer` 把节点搬到其它页）必须显式传入 `pageId`，
-   * 否则会把记录错误地落到操作发起页 / 当前激活页，破坏目标页 / 源页的撤销栈语义。
-   */
-  push(state: StepValue, pageId?: Id): StepValue | null;
-  /** 读取指定页面（缺省当前活动页）历史栈当前游标所在的 step（cursor - 1）；无则返回 null。 */
-  getCurrentPageStep(pageId?: Id): StepValue | null;
-  /**
-   * 用 `state` 替换指定页面栈当前游标所在的 step（并丢弃其后的重做尾部），游标不变。
-   * 用于「连续 set root 记录合并」等就地替换最新一条的场景；替换成功后按需刷新 / 通知。
+   * 跨页 / 跨资源操作（如 `moveToContainer` 把节点搬到其它页）必须显式传入目标 id，
+   * 否则无法落到正确的栈。step 可由 `createStackStep` 等构造后传入。
+   *
+   * @param stepType 历史类型
+   * @param step     已构造好的历史记录（缺省自动补全 uuid / timestamp）
+   * @param id       目标栈 id（page 为 pageId，其余类型为对应资源 id），必填
+   */
+  push(stepType: 'page', step: StepValue, id: Id): StepValue | null;
+  push(stepType: 'codeBlock', step: CodeBlockStepValue, id: Id): CodeBlockStepValue | null;
+  push(stepType: 'dataSource', step: DataSourceStepValue, id: Id): DataSourceStepValue | null;
+  push<T extends BaseStepValue>(stepType: string, step: T, id: Id): T | null;
+  /**
+   * 撤销指定历史栈的最近一次变更。统一入口，所有类型行为一致：
+   * 按 `id`（必填）+ `stepType` 定位栈，不会越过 index 0 的 initial 基线（所有类型同等适用），
+   * 仅在确有可撤销 step 时派发对应的历史变更事件（`page` 为 `change`，回调签名 `(id, step)`）。
+   *
+   * @param stepType 历史类型
+   * @param id       目标栈 id（page 为 pageId，其余类型为对应资源 id），必填
    */
-  replaceCurrentPageStep(state: StepValue, pageId?: Id): StepValue | null;
+  undo(stepType: 'page', id: Id): StepValue | null;
+  undo(stepType: 'codeBlock', id: Id): CodeBlockStepValue | null;
+  undo(stepType: 'dataSource', id: Id): DataSourceStepValue | null;
+  undo<T extends BaseStepValue>(stepType: string, id: Id): T | null;
   /**
-   * 推入一条代码块变更记录（与页面/节点完全无关），按 `codeBlockId` 维度独立一份 UndoRedo 栈。
+   * 重做指定历史栈的下一次变更。语义与 {@link undo} 对称，详见其说明。
    *
-   * - 新增：oldContent = null，newContent = 新内容
-   * - 更新：oldContent / newContent 都为对应内容
-   * - 删除：newContent = null，oldContent = 删除前内容
-   * - `changeRecords` 来自 form 端，撤销/重做时若有则按 propPath 局部覆盖；缺省才退化为整内容替换。
-   * - 不直接驱动 codeBlockService，调用方负责实际写回。
-   */
-  pushCodeBlock(codeBlockId: Id, payload: {
-    oldContent: CodeBlockContent | null;
-    newContent: CodeBlockContent | null;
-    changeRecords?: ChangeRecord[]; /** 可选的人类可读描述（如「修改按钮颜色」），仅用于历史面板展示。 */
-    historyDescription?: string; /** 可选的操作途径（配置面板 / 菜单 / 接口等），仅用于历史面板展示与埋点。 */
-    source?: HistoryOpSource;
-  }): CodeBlockStepValue | null;
-  /**
-   * 推入一条数据源变更记录（与页面/节点完全无关），按 `dataSourceId` 维度独立一份 UndoRedo 栈。
-   * 行为同 pushCodeBlock（新增 oldSchema=null；删除 newSchema=null）。
+   * @param stepType 历史类型
+   * @param id       目标栈 id（page 为 pageId，其余类型为对应资源 id），必填
    */
-  pushDataSource(dataSourceId: Id, payload: {
-    oldSchema: DataSourceSchema | null;
-    newSchema: DataSourceSchema | null;
-    changeRecords?: ChangeRecord[]; /** 可选的人类可读描述，仅用于历史面板展示。 */
-    historyDescription?: string; /** 可选的操作途径（配置面板 / 菜单 / 接口等），仅用于历史面板展示与埋点。 */
-    source?: HistoryOpSource;
-  }): DataSourceStepValue | null;
-  /** 撤销指定代码块的最近一次变更。 */
-  undoCodeBlock(codeBlockId: Id): CodeBlockStepValue | null;
-  /** 重做指定代码块的下一次变更。 */
-  redoCodeBlock(codeBlockId: Id): CodeBlockStepValue | null;
-  /** 是否可对指定代码块撤销。 */
-  canUndoCodeBlock(codeBlockId: Id): boolean;
-  /** 是否可对指定代码块重做。 */
-  canRedoCodeBlock(codeBlockId: Id): boolean;
-  /** 撤销指定数据源的最近一次变更。 */
-  undoDataSource(dataSourceId: Id): DataSourceStepValue | null;
-  /** 重做指定数据源的下一次变更。 */
-  redoDataSource(dataSourceId: Id): DataSourceStepValue | null;
-  /** 是否可对指定数据源撤销。 */
-  canUndoDataSource(dataSourceId: Id): boolean;
-  /** 是否可对指定数据源重做。 */
-  canRedoDataSource(dataSourceId: Id): boolean;
-  undo(): StepValue | null;
-  redo(): StepValue | null;
-  destroy(): void;
+  redo(stepType: 'page', id: Id): StepValue | null;
+  redo(stepType: 'codeBlock', id: Id): CodeBlockStepValue | null;
+  redo(stepType: 'dataSource', id: Id): DataSourceStepValue | null;
+  redo<T extends BaseStepValue>(stepType: string, id: Id): T | null;
   /**
-   * 清空指定页面（缺省当前活动页）的历史记录栈。
-   * 仅删除撤销/重做记录，不会改动当前 DSL；清空后该页将无法再撤销/重做之前的操作。
+   * 是否可对指定历史栈撤销（cursor 高于 initial 基线底线）。
+   * @param stepType 历史类型
+   * @param id       目标栈 id；缺省 / 无效时返回 false
    */
-  clearPage(pageId?: Id): void;
+  canUndo(stepType: HistoryStepType, id?: Id): boolean;
   /**
-   * 清空数据源历史记录栈：传入 `dataSourceId` 仅清空该数据源，缺省清空全部数据源。
-   * 仅删除撤销/重做记录，不会改动数据源本身。
+   * 是否可对指定历史栈重做。
+   * @param stepType 历史类型
+   * @param id       目标栈 id；缺省 / 无效时返回 false
    */
-  clearDataSource(dataSourceId?: Id): void;
+  canRedo(stepType: HistoryStepType, id?: Id): boolean;
+  /** 读取指定页面历史栈当前游标所在的 step（cursor - 1）；无则返回 null。 */
+  getCurrentPageStep(pageId: Id): StepValue | null;
   /**
-   * 清空代码块历史记录栈：传入 `codeBlockId` 仅清空该代码块，缺省清空全部代码块。
-   * 仅删除撤销/重做记录，不会改动代码块本身。
+   * 用 `state` 替换指定页面栈当前游标所在的 step（并丢弃其后的重做尾部），游标不变。
+   * 用于「连续 set root 记录合并」等就地替换最新一条的场景；替换成功后派发 `change`。
    */
-  clearCodeBlock(codeBlockId?: Id): void;
+  replaceCurrentStep(stepType: HistoryStepType, state: StepValue, id: Id): StepValue | null;
+  destroy(): void;
   /**
-   * 标记「整份 DSL 已保存」：把页面 / 代码块 / 数据源所有栈当前游标所在的记录都标为 `saved`。
-   * 适用于「整体落库」场景；若只保存了其中一类，请改用更细粒度的
-   * {@link markPageSaved} / {@link markCodeBlockSaved} / {@link markDataSourceSaved}。
+   * 清空历史记录栈。统一入口，所有类型（page / codeBlock / dataSource / 扩展）行为一致：
+   * - 传入 `id`：仅清空 `stepType` 下该 id 对应的栈；
+   * - 缺省 `id`：清空 `stepType` 下的全部栈。
+   *
+   * 仅删除撤销/重做记录，不会改动 DSL / 代码块 / 数据源本身。清空时会**保留各栈原有的
+   * initial 基线**（文案 / 来源），无基线时清空成空栈。清空后派发 `clear`（签名 `(id, stepType)`）。
+   *
+   * @param stepType 历史类型
+   * @param id       目标栈 id；缺省表示清空该类型下全部栈
    */
-  markSaved(): void;
+  clear(stepType: HistoryStepType, id?: Id): void;
   /**
-   * 标记指定页面（缺省为当前活动页）的历史栈当前记录为已保存。
-   * 仅影响该页面自己的栈，不波及代码块 / 数据源 / 其它页面。
+   * 标记历史记录为「已保存」（把对应栈当前游标所在的记录标为 `saved`）。统一入口：
+   * - 缺省 `id`：标记**全部类型、全部栈**（整份 DSL 落库场景），派发 `mark-saved` 且 `kind: 'all'`；
+   * - 传入 `id`：仅标记 `stepType` 下该 id 对应的栈，派发 `mark-saved` 且 `kind` 为 `stepType`。
+   *
+   * 同一栈内任意时刻最多只有一条记录为 `saved`；从 IndexedDB 恢复时游标会被定位到最近一条已保存记录之后。
+   *
+   * @param stepType 历史类型
+   * @param id       目标栈 id；缺省表示标记全部类型 / 全部栈
    */
-  markPageSaved(pageId?: Id): void;
-  /** 标记指定代码块的历史栈当前记录为已保存，仅影响该代码块自己的栈。 */
-  markCodeBlockSaved(codeBlockId: Id): void;
-  /** 标记指定数据源的历史栈当前记录为已保存，仅影响该数据源自己的栈。 */
-  markDataSourceSaved(dataSourceId: Id): void;
+  markSaved(stepType: HistoryStepType, id?: Id): void;
   /**
-   * 把当前内存中的全部历史栈（页面 / 代码块 / 数据源）序列化后写入本地 IndexedDB。
+   * 把当前内存中的全部历史栈（页面 / 代码块 / 数据源 / 扩展类型）序列化后写入本地 IndexedDB。
    *
    * - 每个 UndoRedo 栈连同其游标、容量一并保存，恢复后可继续 undo/redo；
    * - `key` 用于区分不同活动页 / 项目（同一 store 下可保存多份快照），缺省为 `default`；
@@ -1148,92 +1168,90 @@ declare class History extends BaseService {
    * 从本地 IndexedDB 读取此前保存的历史快照并重建全部撤销/重做栈。
    *
    * - 读取到的每个栈都会经 {@link UndoRedo.fromSerialized} 还原（含游标），随后可直接 undo/redo；
-   * - 会整体覆盖当前内存中的历史状态，并把活动页恢复为快照中的 pageId；
+   * - 会整体覆盖当前内存中的历史状态（活动页由 editorService 维护，不在此恢复）；
    * - 找不到对应记录时返回 null，且不改动当前状态；
    * - 不支持 IndexedDB 的环境（如 SSR）会 reject。
    */
   restoreFromIndexedDB(options?: HistoryPersistOptions): Promise<PersistedHistoryState | null>;
   /**
-   * 取出当前活动页的历史步骤平铺列表（包含已应用 + 已撤销）。
-   * 列表按时间正序，最早一步在最前面。
-   * 通常 UI 应使用 `getPageHistoryGroups` 取已合并分组的版本；本方法仅为兼容/调试保留。
-   */
-  getPageStepList(pageId?: Id): PageHistoryStepEntry[];
-  /**
-   * 取出当前活动页的历史栈，按"目标节点"做相邻合并：
-   * - 连续修改同一节点（单节点 update）的多步合并为一个 group，组内可展开查看每步；
-   * - add / remove / 多节点 update 始终独立成组。
-   * 用于历史面板的"页面"tab 展示。
-   */
-  getPageHistoryGroups(pageId?: Id): PageHistoryGroup[];
-  /**
-   * 取出全部代码块的历史栈，按 codeBlockId 分桶展示。
-   * 同一栈内每条操作记录独立成组，不做相邻 update 合并。
-   */
-  getCodeBlockHistoryGroups(): StackHistoryGroup<CodeBlockStepValue, 'code-block'>[];
-  /**
-   * 读取指定页面历史栈的当前游标（已应用步骤数量）。不传则取当前活动页。
-   * 没有对应栈时返回 0。
+   * 取出指定历史类型（页面 / 代码块 / 数据源 / 扩展类型）某个栈的平铺步骤列表（含 applied 标记）。
+   * 统一入口，替代旧的 `getPageStepList` / `getCodeBlockStepList` / `getDataSourceStepList`。
+   *
+   * 列表按时间正序，最早一步在最前面；`applied` 表示该步骤处于栈游标之前（已应用）。
+   * 供 revert / goto 等按 index 索引步骤的场景使用。通常 UI 应使用
+   * {@link getHistoryGroups} 取已合并分组的版本；本方法仅为兼容/调试保留。
+   *
+   * @param stepType 历史类型
+   * @param id       目标栈 id（page 为 pageId，其余类型为对应资源 id）；缺省 / 无效时返回空数组
    */
-  getPageCursor(pageId?: Id): number;
-  /** 读取指定代码块历史栈的当前游标。 */
-  getCodeBlockCursor(codeBlockId: Id): number;
-  /** 读取指定数据源历史栈的当前游标。 */
-  getDataSourceCursor(dataSourceId: Id): number;
+  getStepList(stepType: 'page', id?: Id): HistoryStepEntry<StepValue>[];
+  getStepList(stepType: 'codeBlock', id: Id): HistoryStepEntry<CodeBlockStepValue>[];
+  getStepList(stepType: 'dataSource', id: Id): HistoryStepEntry<DataSourceStepValue>[];
+  getStepList<T extends BaseStepValue>(stepType: HistoryStepType, id?: Id): HistoryStepEntry<T>[];
   /**
-   * 取出指定代码块历史栈的平铺步骤列表（含 applied 标记）。供 revert 等按 index 索引步骤使用。
-   */
-  getCodeBlockStepList(codeBlockId: Id): {
-    step: CodeBlockStepValue;
-    index: number;
-    applied: boolean;
-  }[];
-  /**
-   * 取出指定数据源历史栈的平铺步骤列表（含 applied 标记）。供 revert 等按 index 索引步骤使用。
+   * 取出指定历史类型的历史分组（页面 / 代码块 / 数据源 / 扩展类型统一入口）。
+   *
+   * 把目标栈的步骤列表按"目标"做相邻合并（连续修改同一目标的 update 合并为一组，组内可展开查看每步；
+   * add / remove / 多实体 update 始终独立成组），并过滤掉 index 0 的 initial 基线（底部「初始」行由
+   * {@link getMarker} 驱动）。各类型行为完全一致，仅 `kind` 与 step 快照类型不同。
+   *
+   * 作用域：
+   * - 传入 `id`：仅取该 id 对应的单个栈（页面历史按活动页查看，传入 pageId）；
+   * - 缺省 `id`：遍历该类型下全部栈并汇总（代码块 / 数据源按全部资源分桶展示）。
+   *
+   * @param stepType 历史类型，缺省 `page`
+   * @param id       目标栈 id；缺省表示遍历该类型下全部栈
    */
-  getDataSourceStepList(dataSourceId: Id): {
-    step: DataSourceStepValue;
-    index: number;
-    applied: boolean;
-  }[];
+  getHistoryGroups(stepType: 'page', id?: Id): HistoryGroup<StepValue>[];
+  getHistoryGroups(stepType: 'codeBlock', id?: Id): HistoryGroup<CodeBlockStepValue>[];
+  getHistoryGroups(stepType: 'dataSource', id?: Id): HistoryGroup<DataSourceStepValue>[];
+  getHistoryGroups<T extends BaseStepValue>(stepType: HistoryStepType, id?: Id): HistoryGroup<T>[];
   /**
-   * 按历史记录 uuid 在指定页面（默认当前活动页）的栈中查找其索引。
-   * 找不到时返回 -1。供「按 uuid 回滚」等需要把 uuid 映射回 index 的场景使用。
+   * 读取指定历史栈的当前游标（已应用步骤数量）。统一入口，替代旧的
+   * `getPageCursor` / `getCodeBlockCursor` / `getDataSourceCursor`。
+   * - `id` 缺省或非法、或对应栈不存在时返回 0；
+   * - `stepType` 支持 `page` / `codeBlock` / `dataSource` / 扩展类型。
    */
-  getPageStepIndexByUuid(uuid: string, pageId?: Id): number;
+  getCursor(stepType: HistoryStepType, id?: Id): number;
   /**
-   * 按历史记录 uuid 在全部代码块栈中查找其所属 codeBlockId 与索引。
-   * 找不到时返回 null。
-   */
-  findCodeBlockStepLocationByUuid(uuid: string): {
-    id: Id;
-    index: number;
-  } | null;
-  /**
-   * 按历史记录 uuid 在全部数据源栈中查找其所属 dataSourceId 与索引。
-   * 找不到时返回 null。
+   * 按历史记录 uuid 在指定历史类型的栈中查找其所属 id 与索引，统一入口，替代旧的
+   * `getPageStepIndexByUuid` / `findCodeBlockStepLocationByUuid` / `findDataSourceStepLocationByUuid`。
+   *
+   * - 传入 `id`：仅在该 id 对应的单个栈中查找（如页面历史按活动页查看，传入 pageId）；
+   * - 缺省 `id`：遍历该类型下全部栈查找（代码块 / 数据源等按全部资源分桶的场景）。
+   *
+   * 找不到时返回 null。供「按 uuid 回滚」等需要把 uuid 映射回 (id, index) 的场景使用。
+   *
+   * @param stepType 历史类型
+   * @param uuid     目标历史记录的 uuid
+   * @param id       目标栈 id；缺省表示遍历该类型下全部栈
    */
-  findDataSourceStepLocationByUuid(uuid: string): {
+  findStepLocationByUuid(stepType: HistoryStepType, uuid: string, id?: Id): {
     id: Id;
     index: number;
   } | null;
+  usePlugin(options: SyncHookPlugin<SyncMethodName$3, History>): void;
+  emit<Name extends keyof HistoryEvents, Param extends HistoryEvents[Name]>(eventName: Name, ...args: Param): boolean;
   /**
-   * 取出全部数据源的历史栈，按 dataSourceId 分桶展示。同上，每条操作独立成组。
+   * 取出指定历史类型的栈桶（`Record<id, UndoRedo>`）；不存在时按需创建空桶，
+   * 从而支持通过 {@link registerStepType} 或首次 push 动态扩展历史类型。
    */
-  getDataSourceHistoryGroups(): StackHistoryGroup<DataSourceStepValue, 'data-source'>[];
+  private getStepBucket;
   /**
-   * 取出指定页面的栈；不传 pageId 时按当前活动页取。
-   *
-   * 跨页 push 时如果目标页的栈尚不存在（用户从未进入过该页），会按需创建一条空栈，
-   * 这样切到目标页时 Ctrl+Z 也能撤回该步骤。
+   * 清空单个历史栈并按需重建其 initial 基线（保留原基线的文案 / 来源）。
    */
-  private getUndoRedo;
+  private clearStack;
+  /** 入栈前补全 step 的 uuid / timestamp（调用方未指定时）。 */
+  private fillStepMeta;
+  /** 校验「按 id 分栈」类型（codeBlock / dataSource / 扩展）的 id 是否有效。 */
+  private isValidStackId;
+  /** 清空全部历史栈内容（保留已注册的类型键，使扩展类型在 reset 后仍可用）。 */
+  private clearAllSteps;
   /**
    * 把基础 dbName 与当前 DSL（root app）的 id 拼成最终库名，实现不同应用历史隔离。
    * 取不到 app id（如尚未加载 DSL）时退回基础 dbName。
    */
   private resolveDbName;
-  private setCanUndoRedo;
 }
 type HistoryService = History;
 declare const _default$44: History;
@@ -2080,13 +2098,21 @@ interface StepDiffItem<T = unknown> {
  *
  * 泛型 `T` 为 `diff` 中变化内容的快照类型（页面节点 `MNode` / 代码块 `CodeBlockContent` / 数据源 `DataSourceSchema`）。
  */
-interface BaseStepValue<T = unknown> {
+interface BaseStepValue<T = unknown, U extends Record<string, any> = {}> {
   /**
    * 历史记录唯一标识（uuid）。入栈时自动写入（若调用方未指定），
    * 用于精确定位 / 引用某一条历史记录（如 revert、埋点、跨端同步等）。
-   * 注意与各自的 `id`（关联的页面 / 代码块 / 数据源 id）区分。
+   * 注意与 `data.id`（关联的页面 / 代码块 / 数据源 id）区分。
    */
   uuid: string;
+  /**
+   * 关联目标信息：`id` 为关联的页面 / 代码块 / 数据源等资源 id（也是历史栈的分组 key），
+   * `name` 为展示名。所有历史类型统一携带。
+   */
+  data: {
+    name: string;
+    id: Id;
+  };
   /** 操作类型：新增 / 删除 / 更新（三类历史记录统一携带）。 */
   opType: HistoryOpType;
   /**
@@ -2120,56 +2146,78 @@ interface BaseStepValue<T = unknown> {
    * 避免源码反复保存 / 外部重设 DSL 时堆积多条 root 记录。
    */
   rootStep?: boolean;
-}
-interface StepValue extends BaseStepValue<MNode> {
-  /** 页面信息 */
-  data: {
-    name: string;
-    id: Id;
-  };
-  /** 操作前选中的节点 ID，用于撤销后恢复选择状态 */
-  selectedBefore: Id[];
-  /** 操作后选中的节点 ID，用于重做后恢复选择状态 */
-  selectedAfter: Id[];
-  modifiedNodeIds: Map<Id, Id>;
+  /** 操作人 */
+  operator?: string;
+  /** 扩展信息 */
+  extra?: U;
 }
 /**
- * 代码块历史记录条目。按 codeBlock.id 分组保存到 historyState.codeBlockState。
- * 变更内容统一由 `diff`（单项）表达，每项见 {@link StepDiffItem}：
- * - 新增（opType 'add'）：仅 `newSchema`（新内容）；
- * - 更新（opType 'update'）：`oldSchema` + `newSchema`，并可带 `changeRecords` 做局部更新；
- * - 删除（opType 'remove'）：仅 `oldSchema`（删除前内容）。
+ * 历史记录的扩展上下文（{@link BaseStepValue.extra}）。
+ * 内置字段供 `page` 类型在撤销 / 重做时恢复选区与受影响节点；扩展类型可自由附加其它键。
  */
-interface CodeBlockStepValue extends BaseStepValue<CodeBlockContent> {
-  /** 关联的代码块 id */
-  id: Id;
+interface StepExtra {
+  /** 操作前选中的节点 ID，用于撤销后恢复选择状态（page 类型） */
+  selectedBefore?: Id[];
+  /** 操作后选中的节点 ID，用于重做后恢复选择状态（page 类型） */
+  selectedAfter?: Id[];
+  /** 本次操作涉及的节点 id 集合（page 类型） */
+  modifiedNodeIds?: Map<Id, Id>;
+  [key: string]: any;
 }
 /**
- * 数据源历史记录条目。按 dataSource.id 分组保存到 historyState.dataSourceState。
- * 变更内容统一由 `diff`（单项）表达，每项见 {@link StepDiffItem}：
- * - 新增（opType 'add'）：仅 `newSchema`（新 schema）；
- * - 更新（opType 'update'）：`oldSchema` + `newSchema`，并可带 `changeRecords` 做局部更新；
- * - 删除（opType 'remove'）：仅 `oldSchema`（删除前 schema）。
+ * 页面节点历史记录条目（`diff` 内容为 {@link MNode}）。结构已与代码块 / 数据源统一收敛到
+ * {@link BaseStepValue}：关联 id 见 `data.id`，选区等上下文见 `extra`。
  */
-interface DataSourceStepValue extends BaseStepValue<DataSourceSchema> {
-  /** 关联的数据源 id */
-  id: Id;
+type StepValue = BaseStepValue<MNode, StepExtra>;
+/**
+ * 代码块历史记录条目（`diff` 内容为 {@link CodeBlockContent}），按 `data.id`（codeBlock.id）
+ * 分组保存到 historyState.steps.codeBlock。结构与 {@link StepValue} / {@link DataSourceStepValue}
+ * 一致，仅 `diff` 快照类型不同。
+ */
+type CodeBlockStepValue = BaseStepValue<CodeBlockContent>;
+/**
+ * 数据源历史记录条目（`diff` 内容为 {@link DataSourceSchema}），按 `data.id`（dataSource.id）
+ * 分组保存到 historyState.steps.dataSource。结构与 {@link StepValue} / {@link CodeBlockStepValue}
+ * 一致，仅 `diff` 快照类型不同。
+ */
+type DataSourceStepValue = BaseStepValue<DataSourceSchema>;
+/**
+ * 历史记录类型标识：内置 `page` / `codeBlock` / `dataSource`，并允许业务扩展自定义类型。
+ * `(string & {})` 保留对内置字面量的智能提示，同时不限制扩展取值。
+ */
+type HistoryStepType = 'page' | 'codeBlock' | 'dataSource' | (string & {});
+/**
+ * 全部历史栈的统一容器，按「类型 -> id -> UndoRedo 栈」两级分组。
+ *
+ * - `page`：页面历史栈，按 page.id 分组（每页一份 UndoRedo）；
+ * - `codeBlock`：代码块历史栈，按 codeBlock.id 分组；
+ * - `dataSource`：数据源历史栈，按 dataSource.id 分组；
+ * - 其余键：业务通过 {@link HistoryService.registerStepType} 注册的自定义历史类型。
+ *
+ * 所有类型（含扩展类型）一视同仁：均按 id 独立分栈、独立 undo/redo，且都可通过
+ * {@link HistoryService.setMarker} 在 index 0 种入 `initial` 基线（撤销 / 回滚不会越过该基线）。
+ */
+interface HistorySteps {
+  page: Record<Id, UndoRedo<StepValue>>;
+  codeBlock: Record<Id, UndoRedo<CodeBlockStepValue>>;
+  dataSource: Record<Id, UndoRedo<DataSourceStepValue>>;
+  /** 扩展历史类型：按 id 分组的 UndoRedo 栈。 */
+  [stepType: string]: Record<Id, UndoRedo<any>>;
 }
 interface HistoryState {
-  pageId?: Id;
-  pageSteps: Record<Id, UndoRedo<StepValue>>;
-  canRedo: boolean;
-  canUndo: boolean;
   /**
-   * 代码块历史栈，按 codeBlock.id 分组（每个代码块独立一份 UndoRedo）。
-   * 与页面/节点无关，支持独立 undo/redo。
+   * 全部历史栈的统一容器（页面 / 代码块 / 数据源 / 扩展类型），见 {@link HistorySteps}。
+   * 各类型互不影响，支持按 id 独立 undo/redo；是否可撤销 / 重做改用 {@link HistoryService.canUndo} /
+   * {@link HistoryService.canRedo}（按 stepType + id 查询）替代旧的全局 canUndo / canRedo 字段。
    */
-  codeBlockState: Record<Id, UndoRedo<CodeBlockStepValue>>;
+  steps: HistorySteps;
   /**
-   * 数据源历史栈，按 dataSource.id 分组（每个数据源独立一份 UndoRedo）。
-   * 与页面/节点无关，支持独立 undo/redo。
+   * 各历史类型的展示名称，用于历史面板（{@link HistorySteps} 的 tab / 分组标题等）。
+   * 内置 `page` / `codeBlock` / `dataSource` 有默认中文名（页面 / 代码块 / 数据源），
+   * 扩展类型可通过 {@link HistoryService.registerStepType} 的 `name` 选项或
+   * {@link HistoryService.setStepName} 登记；读取请用 {@link HistoryService.getStepName}。
    */
-  dataSourceState: Record<Id, UndoRedo<DataSourceStepValue>>;
+  stepNames: Record<string, string>;
 }
 /**
  * 历史记录的可持久化快照。由 historyService.saveToIndexedDB 写入 IndexedDB，
@@ -2178,14 +2226,16 @@ interface HistoryState {
 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>>;
+  /**
+   * 全部历史栈的序列化快照，按「类型 -> id」两级分组，与 {@link HistorySteps} 对应。
+   * 内置 `page` / `codeBlock` / `dataSource`，并包含业务注册的扩展类型。
+   */
+  steps: {
+    page: Record<Id, SerializedUndoRedo<StepValue>>;
+    codeBlock: Record<Id, SerializedUndoRedo<CodeBlockStepValue>>;
+    dataSource: Record<Id, SerializedUndoRedo<DataSourceStepValue>>;
+    [stepType: string]: Record<Id, SerializedUndoRedo<any>>;
+  };
   /** 保存时间戳（毫秒）。 */
   savedAt: number;
 }
@@ -2207,9 +2257,9 @@ interface HistoryPersistOptions {
 /**
  * 历史面板用：当前页面的一条历史步骤（包含位置和是否已应用）。
  */
-interface PageHistoryStepEntry {
+interface HistoryStepEntry<T> {
   /** 步骤内容 */
-  step: StepValue;
+  step: T;
   /** 在所属栈中的索引（0 为最早） */
   index: number;
   /** 是否处于"已应用"段（即位于栈游标之前）。撤销后变为 false。 */
@@ -2218,56 +2268,42 @@ interface PageHistoryStepEntry {
   isCurrent?: boolean;
 }
 /**
- * 页面历史面板分组。
- * - 连续修改同一目标节点（updatedItems[0].oldNode.id 一致）的 'update' 步骤合并成一组；
- * - 多节点更新 / add / remove 始终独立成组（无法明确归属单一目标）。
- * - targetId 为 undefined 表示"无明确目标"（如 add/remove/多节点 update），不参与合并。
+ * 历史面板分组（页面 / 数据源 / 代码块 / 扩展类型统一结构）。
+ *
+ * 把指定历史栈的步骤列表按"目标"做相邻合并：
+ * - 连续修改同一目标（单实体 update，targetId 一致）的多步合并成一组，组内可展开查看每步；
+ * - add / remove / 多实体 update 始终独立成组（无法明确归属单一目标）；
+ * - targetId 为 undefined 表示"无明确目标"，不参与合并。
+ *
+ * 各类型仅 `kind` 与 step 快照类型不同，统一由泛型描述：
+ * - 页面：`HistoryGroup<StepValue>`，`kind: 'page'`，`id` 为 pageId，`targetId` 为被改节点 id；
+ * - 数据源：`HistoryGroup<DataSourceStepValue>`，`kind: 'data-source'`，`id` 为 dataSource.id；
+ * - 代码块：`HistoryGroup<CodeBlockStepValue>`，`kind: 'code-block'`，`id` 为 codeBlock.id。
  */
-interface PageHistoryGroup {
-  kind: 'page';
-  /** 所属页面 id */
-  pageId: Id;
-  /** 该分组的操作类型 */
+interface HistoryGroup<T extends BaseStepValue = BaseStepValue> {
+  /** 历史类型标识：page / code-block / data-source（扩展类型同理）。 */
+  kind: string;
+  /** 所属栈 id（page 为 pageId，代码块 / 数据源为对应资源 id）。 */
+  id: Id;
+  /** 该分组的操作类型。 */
   opType: HistoryOpType;
   /**
-   * 合并的目标节点 id；只有"单节点 update"才有值，并按此 id 与相邻同 id 的 update 合并。
-   * undefined 表示该分组不可被合并（add / remove / 多节点 update）。
+   * 合并的目标 id：仅"单实体 update"有值，并按此与相邻同 id 的 update 合并。
+   * undefined 表示该分组不可被合并（add / remove / 多实体 update）。
    */
   targetId?: Id;
-  /** 目标节点的可读名（取最后一步的 newNode.name/type/id） */
+  /** 目标可读名（取最后一步快照的 name/type/id）。 */
   targetName?: string;
-  /** 组内所有步骤，按时间正序 */
-  steps: PageHistoryStepEntry[];
-  /** 组内最后一步是否已应用 */
-  applied: boolean;
-  /** 是否为当前所在的分组（包含栈中最近一次已应用步骤的那一组）。 */
-  isCurrent?: boolean;
-}
-/**
- * 数据源 / 代码块历史面板分组（按 id 分栈展示）。
- * 二者结构完全一致，仅 `kind` 与 step 类型不同，统一由该泛型描述：
- * - 数据源：`StackHistoryGroup<DataSourceStepValue, 'data-source'>`；
- * - 代码块：`StackHistoryGroup<CodeBlockStepValue, 'code-block'>`。
- *
- * 每条操作记录独立成组，不做相邻合并（与页面历史 {@link PageHistoryGroup} 不同），故 `steps` 恒为单元素。
- */
-interface StackHistoryGroup<T extends BaseStepValue = BaseStepValue, K extends 'code-block' | 'data-source' = 'code-block' | 'data-source'> {
-  /** 区分代码块 / 数据源。 */
-  kind: K;
-  /** 关联的代码块 / 数据源 id。 */
-  id: Id;
-  /** 该分组的操作类型。 */
-  opType: HistoryOpType;
-  /** 组内所有步骤，按时间正序（不做相邻合并，恒为单元素）。 */
+  /** 组内所有步骤，按时间正序。 */
   steps: {
     step: T;
     index: number;
     applied: boolean;
     isCurrent?: boolean;
   }[];
-  /** 组内最后一步是否已应用，用于整组的状态展示。 */
+  /** 组内最后一步是否已应用。 */
   applied: boolean;
-  /** 是否为当前所在的分组（包含该栈最近一次已应用步骤的那一组）。 */
+  /** 是否为当前所在的分组（包含栈中最近一次已应用步骤的那一组）。 */
   isCurrent?: boolean;
 }
 declare enum KeyBindingCommand {
@@ -2389,7 +2425,7 @@ interface EventBusEvent {
   'remove-data-source': [id: string];
   'edit-code': [id: string];
 }
-interface EventBus extends EventEmitter {
+interface EventBus extends EventEmitter$1 {
   on<Name extends keyof EventBusEvent, Param extends EventBusEvent[Name]>(eventName: Name, listener: (...args: Param) => void): this;
   emit<Name extends keyof EventBusEvent, Param extends EventBusEvent[Name]>(eventName: Name, ...args: Param): boolean;
 }
@@ -2427,6 +2463,26 @@ interface EditorEvents {
   }];
   'history-change': [data: MPage | MPageFragment];
 }
+interface HistoryEvents {
+  change: [state: BaseStepValue | StepValue | CodeBlockStepValue | DataSourceStepValue, stepType: HistoryStepType, id: Id];
+  'code-block-history-change': [id: Id, state: CodeBlockStepValue];
+  'data-source-history-change': [id: Id, state: DataSourceStepValue];
+  'restore-from-indexed-db': [snapshot: PersistedHistoryState | null];
+  'save-to-indexed-db': [snapshot: PersistedHistoryState];
+  'mark-saved': [{
+    kind: HistoryStepType;
+    id?: Id;
+  }];
+  clear: [{
+    id: Id;
+    stepType: HistoryStepType;
+  }];
+  'marker-change': [{
+    id: Id;
+    marker: StepValue;
+    stepType: HistoryStepType;
+  }];
+}
 declare const canUsePluginMethods: {
   async: readonly ["getLayout", "highlight", "select", "multiSelect", "doAdd", "add", "doRemove", "remove", "doUpdate", "update", "sort", "copy", "paste", "doPaste", "doAlignCenter", "alignCenter", "moveLayer", "moveToContainer", "dragTo", "undo", "redo", "move"];
   sync: never[];
@@ -2510,6 +2566,49 @@ interface HistoryBucketConfig<T extends BaseStepValue = BaseStepValue> extends H
   /** 是否支持「跳转到该记录」(goto)，默认 true。 */
   gotoEnabled?: boolean;
 }
+interface UseHistoryRevertOptions {
+  /**
+   * 父级应用上下文，用于让动态挂载的「差异确认弹窗」继承全局组件 / 指令 / provide / 插件
+   * （Element Plus、@tmagic/form 字段组件等）。未显式传入时，会自动取调用方所在组件的 appContext
+   * （`getCurrentInstance()?.appContext`）。业务方若在组件 setup 之外调用，需手动传入（如 `editorApp._context`）。
+   */
+  appContext?: AppContext | null;
+  /**
+   * 透传给差异确认弹窗的 `extendState`（即 Editor 的 `extendFormState`），
+   * 使对比表单中依赖业务上下文的 `display` / `disabled` 等 filterFunction 正常工作。
+   */
+  extendState?: (_state: FormState) => Record<string, any> | Promise<Record<string, any>>;
+}
+/**
+ * 业务自有历史（如管理台「模块」）做差异对比时所需的额外渲染入参。
+ * 内置的页面 / 数据源 / 代码块按 `category` 自动取表单配置，无需传这些；
+ * 业务自有类别可通过 `loadConfig` 注入自定义表单配置加载逻辑。
+ */
+interface CustomDiffFormOptions {
+  /**
+   * 自定义差异表单配置加载逻辑（如「模块」按 c_type 重建表单配置），
+   * 透传给弹窗内部的 CompareForm；缺省时按 `category` 走内置加载。
+   */
+  loadConfig?: CompareFormLoadConfig;
+  /** 需要走 self diff 的字段类型（如模块的 mod-cond）。 */
+  selfDiffFieldTypes?: string[];
+}
+/**
+ * 业务自有历史复用「单步回滚」交互（{@link useHistoryRevert} 的 `confirmAndRevert`）的入参。
+ * 与内置页面 / 数据源 / 代码块回滚共用「目标校验 → 差异/二次确认弹窗 → 反向回滚」流程，
+ * 业务方只需提供：差异弹窗入参（可选）、表单配置加载（可选）、实际回滚执行函数。
+ */
+interface ConfirmAndRevertOptions<T = unknown> extends CustomDiffFormOptions {
+  /**
+   * 差异确认弹窗入参；可对比的步骤（单实体 update）传入后弹差异确认弹窗，
+   * 传 null / 省略则退化为普通二次确认框（add / remove / 不可对比）。
+   */
+  diffPayload?: DiffDialogPayload | null;
+  /** 回滚前置校验：返回 true 表示目标数据已删除等不可回滚，给出统一提示并中止。 */
+  isTargetMissing?: () => boolean;
+  /** 用户确认后执行的实际回滚逻辑。 */
+  revert: () => T | Promise<T>;
+}
 //#endregion
 //#region temp/packages/editor/src/hooks/use-code-block-edit.d.ts
 declare const useCodeBlockEdit: (codeBlockService: Services["codeBlockService"]) => {
@@ -2916,7 +3015,7 @@ interface IdleTaskEvents {
     hightLevelLength: number;
   }];
 }
-declare class IdleTask<T = any> extends EventEmitter$1 {
+declare class IdleTask<T = any> extends EventEmitter {
   private taskList;
   private hightLevelTaskList;
   private taskHandle;
@@ -2939,7 +3038,7 @@ interface ScrollViewerOptions {
     height: number;
   };
 }
-declare class ScrollViewer extends EventEmitter$1 {
+declare class ScrollViewer extends EventEmitter {
   private container;
   private target;
   private zoom;
@@ -3019,43 +3118,36 @@ declare const detectStackOpType: (oldVal: unknown, newVal: unknown) => "add" | "
  *
  * - `add`：oldValue = null；`remove`：newValue = null；`update`：两者都有，可带 changeRecords 做局部更新。
  * - 内容会做 cloneDeep 防止后续被外部引用篡改；opType 依据 old/new 是否为 null 推断。
- * - 仅负责构造 step 并返回，入栈与事件 emit 由各公共方法（pushCodeBlock / pushDataSource）自行处理。
+ * - 仅负责构造 step 并返回，入栈与事件 emit 由统一的 history.push(stepType, step, id) 处理。
  * - 不直接驱动业务 service，调用方负责实际写回。
  */
-declare const createStackStep: <T, S extends BaseStepValue<T> & {
-  id: Id;
-}>(id: Id, payload: {
+declare const createStackStep: <T, S extends BaseStepValue<T>>(id: Id, payload: Omit<BaseStepValue<T>, "uuid" | "data" | "opType" | "diff" | "timestamp" | "saved"> & {
   oldValue: T | null;
   newValue: T | null;
-  changeRecords?: ChangeRecord[];
-  historyDescription?: string;
-  source?: HistoryOpSource;
+  changeRecords?: ChangeRecord[]; /** 展示名（缺省时从快照 name / title 推断）。 */
+  name?: string;
 }) => S | null;
 declare const markStackSaved: <S extends {
   saved?: boolean;
 }>(undoRedo?: UndoRedo<S>) => void;
 /**
- * 把单个「按 id 分栈」的历史栈（代码块 / 数据源）拆成若干 group：
- * 每条操作记录独立成组，不做相邻 update 合并（与页面历史的合并策略不同）。
+ * 把单个历史栈（页面 / 代码块 / 数据源 / 扩展类型）的步骤列表按"目标"做相邻合并：
+ * - 单实体的 'update' 按 targetId 与相邻同 targetId 的 update 合并到一个 group，组内可展开查看每步；
+ * - 'add' / 'remove' 始终独立成组（语义上是结构变更，不应被收纳进单实体修改组）；
+ * - 多实体 'update'（如页面批量改属性）也独立成组（无明确单一目标，避免误合并）。
  *
- * 代码块与数据源除 `kind` 外结构完全一致，统一由本方法处理；`kind` 决定返回的具体分组类型。
+ * 各类型行为完全一致，仅 `kind` 与 step 快照类型不同，统一由本方法处理。
  */
-declare const mergeStackSteps: <S extends BaseStepValue, K extends "code-block" | "data-source">(kind: K, id: Id, list: S[], cursor: number) => StackHistoryGroup<S, K>[];
+declare const mergeSteps: <T extends BaseStepValue>(kind: string, id: Id, list: T[], cursor: number) => HistoryGroup<T>[];
 /**
- * 把页面栈拆成若干 group：
- * - 单节点的 'update' 按 targetId 与相邻同 targetId 的 update 合并到一个 group；
- * - 'add' / 'remove' 始终独立成组（语义上是结构变更，不应被收纳进单节点修改组）；
- * - 多节点 'update'（如批量改属性）也独立成组（无明确单一目标，避免误合并）。
+ * 解析 step 中的"目标 id"用于合并：
+ * - 单实体 update：取唯一一项 diff 的快照 id；快照无 id 时（如 CodeBlockContent）回退到 `step.data.id`
+ *   （即资源 id），使代码块 / 数据源同样能按资源合并相邻 update；
+ * - 其它情形（多实体 update / add / remove）：返回 undefined，表示不参与合并。
  */
-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;
+declare const detectTargetId: (step: BaseStepValue) => Id | undefined;
+/** 解析 step 中的目标可读名（用于 UI 展示）。 */
+declare const detectTargetName: (step: BaseStepValue) => string | undefined;
 /**
  * 把 `Record<Id, UndoRedo>` 整体序列化为 `Record<Id, SerializedUndoRedo>`。
  *
@@ -3082,10 +3174,11 @@ declare const deserializeStacks: <T extends {
  */
 declare const getOrCreateStack: <T>(stacks: Record<Id, UndoRedo<T>>, id: Id) => UndoRedo<T>;
 /**
- * 撤销下限：当页面栈 index 0 是 `opType: 'initial'` 的基线 step 时为 1（基线不可被撤销），否则为 0。
- * 用于把 cursor 钉在基线之上，保证 undo / canUndo / goto 都不会越过初始基线。
+ * 撤销下限：当栈 index 0 是 `opType: 'initial'` 的基线 step 时为 1（基线不可被撤销），否则为 0。
+ * 适用于所有历史类型（page / codeBlock / dataSource / 扩展），把 cursor 钉在基线之上，
+ * 保证 undo / canUndo / goto 都不会越过初始基线。
  */
-declare const undoFloor: (undoRedo: UndoRedo<StepValue>) => number;
+declare const undoFloor: (undoRedo: UndoRedo<any>) => number;
 /** 将单次 push 产生的 history uuid（或 null）转为 *AndGetHistoryId 返回用的 uuid 列表。 */
 declare const getLastPushedHistoryIds: (historyId: string | null) => string[];
 //#endregion
@@ -3097,7 +3190,7 @@ declare const RIGHT_COLUMN_WIDTH_STORAGE_KEY = "$MagicEditorRightColumnWidthData
 declare const PROPS_PANEL_WIDTH_STORAGE_KEY = "$MagicEditorPropsPanelWidthData";
 declare const DEFAULT_LEFT_COLUMN_WIDTH = 310;
 declare const DEFAULT_RIGHT_COLUMN_WIDTH = 480;
-declare const MIN_LEFT_COLUMN_WIDTH = 200;
+declare const MIN_LEFT_COLUMN_WIDTH = 238;
 declare const MIN_CENTER_COLUMN_WIDTH = 400;
 declare const MIN_RIGHT_COLUMN_WIDTH = 300;
 declare const H_GUIDE_LINE_STORAGE_KEY = "$MagicStageHorizontalGuidelinesData";
@@ -3135,6 +3228,15 @@ interface FormSlots {
 //#endregion
 //#region temp/packages/editor/src/editorProps.d.ts
 interface EditorProps {
+  /**
+   * 主题名称：对应 `packages/editor/src/theme/themes/<theme>/index.scss` 的目录名。
+   *
+   * 设置后会在编辑器根元素上追加 `m-editor--<theme>` 修饰类，配合按需引入
+   * `@tmagic/editor/dist/themes/<theme>.css` 即可启用主题样式。
+   *
+   * 例如：`<MEditor theme="magic-admin" />` + `import '@tmagic/editor/dist/themes/magic-admin.css'`。
+   */
+  theme?: string;
   /** 页面初始值 */
   modelValue?: MApp;
   /** 左侧面板中的组件类型列表 */
@@ -3327,6 +3429,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
             config: any;
           }) => boolean) | undefined;
           readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+          readonly theme?: string | undefined;
           readonly onError?: ((...args: any[]) => any) | undefined;
           readonly onChange?: ((...args: any[]) => any) | undefined;
           readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -3368,6 +3471,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
             config: any;
           }) => boolean;
           selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+          theme?: string;
         }> & Readonly<{
           onError?: ((...args: any[]) => any) | undefined;
           onChange?: ((...args: any[]) => any) | undefined;
@@ -3459,6 +3563,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
           config: any;
         }) => boolean;
         selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+        theme?: string;
       }> & Readonly<{
         onError?: ((...args: any[]) => any) | undefined;
         onChange?: ((...args: any[]) => any) | undefined;
@@ -3546,6 +3651,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
           config: any;
         }) => boolean) | undefined;
         readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+        readonly theme?: string | undefined;
         readonly onError?: ((...args: any[]) => any) | undefined;
         readonly onChange?: ((...args: any[]) => any) | undefined;
         readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -3587,6 +3693,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
           config: any;
         }) => boolean;
         selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+        theme?: string;
       }> & Readonly<{
         onError?: ((...args: any[]) => any) | undefined;
         onChange?: ((...args: any[]) => any) | undefined;
@@ -3678,6 +3785,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -3779,6 +3887,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
             config: any;
           }) => boolean) | undefined;
           readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+          readonly theme?: string | undefined;
           readonly onError?: ((...args: any[]) => any) | undefined;
           readonly onChange?: ((...args: any[]) => any) | undefined;
           readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -3820,6 +3929,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
             config: any;
           }) => boolean;
           selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+          theme?: string;
         }> & Readonly<{
           onError?: ((...args: any[]) => any) | undefined;
           onChange?: ((...args: any[]) => any) | undefined;
@@ -3911,6 +4021,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
           config: any;
         }) => boolean;
         selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+        theme?: string;
       }> & Readonly<{
         onError?: ((...args: any[]) => any) | undefined;
         onChange?: ((...args: any[]) => any) | undefined;
@@ -3998,6 +4109,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
           config: any;
         }) => boolean) | undefined;
         readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+        readonly theme?: string | undefined;
         readonly onError?: ((...args: any[]) => any) | undefined;
         readonly onChange?: ((...args: any[]) => any) | undefined;
         readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -4039,6 +4151,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
           config: any;
         }) => boolean;
         selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+        theme?: string;
       }> & Readonly<{
         onError?: ((...args: any[]) => any) | undefined;
         onChange?: ((...args: any[]) => any) | undefined;
@@ -4130,6 +4243,7 @@ declare const __VLS_base$12: import("@vue/runtime-core").DefineComponent<EditorP
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -4604,6 +4718,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
             config: any;
           }) => boolean) | undefined;
           readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+          readonly theme?: string | undefined;
           readonly onError?: ((...args: any[]) => any) | undefined;
           readonly onChange?: ((...args: any[]) => any) | undefined;
           readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -4645,6 +4760,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
             config: any;
           }) => boolean;
           selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+          theme?: string;
         }> & Readonly<{
           onError?: ((...args: any[]) => any) | undefined;
           onChange?: ((...args: any[]) => any) | undefined;
@@ -4736,6 +4852,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
           config: any;
         }) => boolean;
         selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+        theme?: string;
       }> & Readonly<{
         onError?: ((...args: any[]) => any) | undefined;
         onChange?: ((...args: any[]) => any) | undefined;
@@ -4823,6 +4940,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
           config: any;
         }) => boolean) | undefined;
         readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+        readonly theme?: string | undefined;
         readonly onError?: ((...args: any[]) => any) | undefined;
         readonly onChange?: ((...args: any[]) => any) | undefined;
         readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -4864,6 +4982,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
           config: any;
         }) => boolean;
         selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+        theme?: string;
       }> & Readonly<{
         onError?: ((...args: any[]) => any) | undefined;
         onChange?: ((...args: any[]) => any) | undefined;
@@ -4955,6 +5074,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -5054,6 +5174,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
             config: any;
           }) => boolean) | undefined;
           readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+          readonly theme?: string | undefined;
           readonly onError?: ((...args: any[]) => any) | undefined;
           readonly onChange?: ((...args: any[]) => any) | undefined;
           readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -5095,6 +5216,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
             config: any;
           }) => boolean;
           selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+          theme?: string;
         }> & Readonly<{
           onError?: ((...args: any[]) => any) | undefined;
           onChange?: ((...args: any[]) => any) | undefined;
@@ -5186,6 +5308,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
           config: any;
         }) => boolean;
         selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+        theme?: string;
       }> & Readonly<{
         onError?: ((...args: any[]) => any) | undefined;
         onChange?: ((...args: any[]) => any) | undefined;
@@ -5273,6 +5396,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
           config: any;
         }) => boolean) | undefined;
         readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+        readonly theme?: string | undefined;
         readonly onError?: ((...args: any[]) => any) | undefined;
         readonly onChange?: ((...args: any[]) => any) | undefined;
         readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -5314,6 +5438,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
           config: any;
         }) => boolean;
         selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+        theme?: string;
       }> & Readonly<{
         onError?: ((...args: any[]) => any) | undefined;
         onChange?: ((...args: any[]) => any) | undefined;
@@ -5405,6 +5530,7 @@ declare const __VLS_base$7: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -5482,6 +5608,7 @@ declare const __VLS_base$6: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -5523,6 +5650,7 @@ declare const __VLS_base$6: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -5614,6 +5742,7 @@ declare const __VLS_base$6: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
@@ -5853,7 +5982,8 @@ type __VLS_Props$8 = {
    * 取配置逻辑，调用方可根据业务自行返回（或异步返回）表单配置。可通过
    * `ctx.defaultLoadConfig()` 复用默认结果再做二次加工。返回的 config 直接用于对比展示。
    */
-  loadConfig?: CompareFormLoadConfig;
+  loadConfig?: CompareFormLoadConfig; /** 编辑器服务集合，由调用方传入（不再通过 inject('services') 获取）。 */
+  services: Services;
 };
 declare const __VLS_export$10: import("@vue/runtime-core").DefineComponent<__VLS_Props$8, {
   form: ShallowRef<InstanceType<typeof MForm> | null>;
@@ -5861,6 +5991,7 @@ declare const __VLS_export$10: import("@vue/runtime-core").DefineComponent<__VLS
   reload: () => Promise<void>;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {}, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$8> & Readonly<{}>, {
   labelWidth: string;
+  services: Services;
   category: CompareCategory;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$5: typeof __VLS_export$10;
@@ -5885,6 +6016,11 @@ interface HistoryBucketGroup<T extends BaseStepValue = BaseStepValue> {
     step: T;
   }[];
 }
+/**
+ * 通用二次确认弹窗：清空历史 / 无法差异对比的回滚等会改变状态的操作，先弹出确认框，
+ * 用户点击「确定」返回 true，取消（confirm reject）时返回 false 并静默忽略。
+ */
+declare const confirmHistoryAction: (message: string) => Promise<boolean>;
 //#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<{
@@ -5973,6 +6109,7 @@ type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K i
 //#endregion
 //#region temp/packages/editor/src/layouts/history-list/HistoryDiffDialog.vue.d.ts
 type __VLS_Props$7 = {
+  /** 编辑器服务集合，由调用方传入（不再通过 inject('services') 获取）。 */services: Services;
   /**
    * 来自 Editor 顶层的 `extendFormState`，用于扩展 MForm.formState。
    * 透传给 CompareForm，从而让差异对比时表单 item 中依赖业务上下文的
@@ -5999,9 +6136,56 @@ declare const __VLS_export$7: import("@vue/runtime-core").DefineComponent<__VLS_
   onClose?: ((...args: any[]) => any) | undefined;
 }>, {
   width: string;
+  services: Services;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$21: typeof __VLS_export$7;
 //#endregion
+//#region temp/packages/editor/src/layouts/history-list/useHistoryRevert.d.ts
+/**
+ * 历史记录「单步回滚」与「查看差异」的完整交互流程，供历史面板与业务方共用。
+ *
+ * 单步回滚（类 git revert）：
+ * 1. 前置校验：目标数据已被删除（update 写回目标 / 页面 remove 的原父容器缺失）时给出「回滚失败」提示并中止；
+ * 2. 二次确认：可差异对比的步骤（单实体 update）弹出差异确认弹窗，其余步骤弹普通二次确认框；
+ * 3. 用户确认后执行对应 service 的 revert（页面 / 数据源 / 代码块）。
+ *
+ * 查看差异：可差异对比的步骤动态挂载只读 HistoryDiffDialog 展示前后值差异。
+ *
+ * 上述弹窗均按需动态挂载 HistoryDiffDialog 实现，业务方无需自行挂载任何弹窗。
+ *
+ * 返回的能力分三组：
+ * - 内置三类（页面 / 数据源 / 代码块）：`onPageRevert` / `onDataSourceRevert` / `onCodeBlockRevert` 单步回滚，
+ *   `onPageDiff` / `onDataSourceDiff` / `onCodeBlockDiff` 查看差异，及配套的 `buildXxxDiffPayload` / `isXxxRevertTargetMissing`；
+ * - 业务自有历史（如管理台「模块」）：`confirmAndRevert` / `viewDiff` 复用同一套交互流程，由业务方自行构造差异入参；
+ *   即上述内置三类本质上是它们各自预置好 payload 构造与 service.revert 的特例。
+ *
+ * 业务方可在拿到 Editor 实例暴露的 `services` 后直接 import 调用：
+ *
+ * ```ts
+ * import { useHistoryRevert } from '@tmagic/editor';
+ *
+ * const { onPageRevert, onPageDiff } = useHistoryRevert(editorRef.value); // editorRef.value 即 Editor 暴露的 services
+ * await onPageRevert(index); // 弹出差异 / 二次确认弹窗后回滚
+ * onPageDiff(index); // 弹出只读差异弹窗查看前后值差异
+ * ```
+ */
+declare const useHistoryRevert: (services: Pick<Services, "editorService" | "dataSourceService" | "codeBlockService" | "historyService">, options?: UseHistoryRevertOptions) => {
+  onPageRevert: (index: number) => Promise<StepValue | null>;
+  onDataSourceRevert: (id: string | number, index: number) => Promise<DataSourceStepValue | null>;
+  onCodeBlockRevert: (id: string | number, index: number) => Promise<CodeBlockStepValue | null>;
+  onPageDiff: (index: number) => Promise<void> | void;
+  onDataSourceDiff: (id: string | number, index: number) => Promise<void> | void;
+  onCodeBlockDiff: (id: string | number, index: number) => Promise<void> | void;
+  buildPageDiffPayload: (index: number) => DiffDialogPayload | null;
+  buildDataSourceDiffPayload: (id: string | number, index: number) => DiffDialogPayload | null;
+  buildCodeBlockDiffPayload: (id: string | number, index: number) => DiffDialogPayload | null;
+  isPageRevertTargetMissing: (index: number) => boolean;
+  isDataSourceRevertTargetMissing: (id: string | number, index: number) => boolean;
+  isCodeBlockRevertTargetMissing: (id: string | number, index: number) => boolean;
+  confirmAndRevert: <T = unknown>(revertOptions: ConfirmAndRevertOptions<T>) => Promise<T | null>;
+  viewDiff: (payload: DiffDialogPayload | null, extra?: CustomDiffFormOptions) => Promise<void> | void;
+};
+//#endregion
 //#region temp/packages/editor/src/components/FloatingBox.vue.d.ts
 interface Position {
   left: number;
@@ -6196,4 +6380,4 @@ declare const _default$40: {
   install: (app: App, opt?: Partial<EditorInstallOptions | DesignPluginOptions | FormInstallOptions>) => void;
 };
 //#endregion
-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, _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, _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, DslOpWithHistoryIdsResult, 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, StackHistoryGroup, 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, getLastPushedHistoryIds, 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 };
+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, _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, ConfirmAndRevertOptions, _default$8 as ContentMenu, CustomContentMenuFunction, CustomDiffFormOptions, DEFAULT_LEFT_COLUMN_WIDTH, DEFAULT_RIGHT_COLUMN_WIDTH, _default$9 as DataSourceAddButton, _default$10 as DataSourceConfigPanel, _default$11 as DataSourceFieldSelect, _default$12 as DataSourceFields, _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, DslOpWithHistoryIdsResult, 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, HistoryEvents, HistoryGroup, _default$22 as HistoryListBucket, _default$23 as HistoryListBucketTab, HistoryListExtraTab, HistoryOpOptions, HistoryOpOptionsWithChangeRecords, HistoryOpSource, HistoryOpType, HistoryPersistOptions, HistoryRowDescriptor, HistoryState, HistoryStepEntry, HistoryStepType, HistorySteps, _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, 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, StepExtra, 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, UseHistoryRevertOptions, V_GUIDE_LINE_STORAGE_KEY, WorkspaceSlots, advancedTabConfig, arrayOptions, beforePaste, buildChangeRecords, calcAlignCenterStyle, calcLayerTargetIndex, calcMoveStyle, canUsePluginMethods, change2Fixed, classifyDragSources, _default$38 as codeBlockService, collectRelatedNodes, confirmHistoryAction, createStackStep, _default$39 as dataSourceService, debug, _default$40 as default, defaultIsExpandable, _default$41 as depService, describeRevertStep, describeStepForRevert, deserializeStacks, designPlugin, detectStackOpType, detectTargetId, detectTargetName, 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, getLastPushedHistoryIds, getNodeIndex, getOrCreateStack, getPageFragmentList, getPageList, getPageNameList, getPositionInContainer, getRelativeStyle, _default$44 as historyService, idbDelete, idbGet, idbSet, info, isIncludeDataSource, isIndexedDBSupported, _default$45 as loadMonaco, log, markStackSaved, mergeSteps, 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, useHistoryRevert, useNextFloatBoxPosition, useNodeStatus, useServices, useStage, useWindowRect, warn };