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

package/types/index.d.ts

@@ -4,7 +4,7 @@ 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 { App, AppContext, Component, ComputedRef, Ref, ShallowRef } from "vue";
 import EventEmitter, { EventEmitter as EventEmitter$1 } from "events";
 import * as Monaco from "monaco-editor";
 import Sortable, { Options, SortableEvent } from "sortablejs";
@@ -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,6 +1010,10 @@ declare class UndoRedo<T = any> {
 }
 //#endregion
 //#region temp/packages/editor/src/services/history.d.ts
+declare const canUsePluginMethods$5: {
+  sync: readonly ["push", "pushCodeBlock", "pushDataSource", "undoCodeBlock", "redoCodeBlock", "undoDataSource", "redoDataSource", "undo", "redo"];
+};
+type SyncMethodName$3 = Writable<(typeof canUsePluginMethods$5)['sync']>;
 declare class History extends BaseService {
   state: {
     pageId?: Id | undefined;
@@ -1221,6 +1225,7 @@ declare class History extends BaseService {
    * 取出全部数据源的历史栈，按 dataSourceId 分桶展示。同上，每条操作独立成组。
    */
   getDataSourceHistoryGroups(): StackHistoryGroup<DataSourceStepValue, 'data-source'>[];
+  usePlugin(options: SyncHookPlugin<SyncMethodName$3, History>): void;
   /**
    * 取出指定页面的栈；不传 pageId 时按当前活动页取。
    *
@@ -2120,6 +2125,10 @@ interface BaseStepValue<T = unknown> {
    * 避免源码反复保存 / 外部重设 DSL 时堆积多条 root 记录。
    */
   rootStep?: boolean;
+  /** 操作人 */
+  operator?: string;
+  /** 扩展信息 */
+  extra?: Record<string, any>;
 }
 interface StepValue extends BaseStepValue<MNode> {
   /** 页面信息 */
@@ -2510,6 +2519,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"]) => {
@@ -3097,7 +3149,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 +3187,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 +3388,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 +3430,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 +3522,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 +3610,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 +3652,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 +3744,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 +3846,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 +3888,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 +3980,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 +4068,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 +4110,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 +4202,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 +4677,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 +4719,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 +4811,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 +4899,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 +4941,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 +5033,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 +5133,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 +5175,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 +5267,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 +5355,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 +5397,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 +5489,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 +5567,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 +5609,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 +5701,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 +5941,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 +5950,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 +5975,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 +6068,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 +6095,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 +6339,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, _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, 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, 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, useHistoryRevert, useNextFloatBoxPosition, useNodeStatus, useServices, useStage, useWindowRect, warn };