@nocobase/flow-engine 2.0.0-alpha.4 → 2.0.0-alpha.40

package/lib/flowContext.js

@@ -51,7 +51,7 @@ __export(flowContext_exports, {
   FlowEngineContext: () => FlowEngineContext,
   FlowForkModelContext: () => FlowForkModelContext,
   FlowModelContext: () => FlowModelContext,
-  FlowRunjsContext: () => FlowRunjsContext,
+  FlowRunJSContext: () => FlowRunJSContext,
   FlowRuntimeContext: () => FlowRuntimeContext
 });
 module.exports = __toCommonJS(flowContext_exports);
@@ -60,18 +60,22 @@ var antd = __toESM(require("antd"));
 var import_lodash = __toESM(require("lodash"));
 var import_qs = __toESM(require("qs"));
 var import_react = __toESM(require("react"));
+var ReactDOMClient = __toESM(require("react-dom/client"));
+var import_ElementProxy = require("./ElementProxy");
 var import_Acl = require("./acl/Acl");
 var import_ContextPathProxy = require("./ContextPathProxy");
 var import_data_source = require("./data-source");
 var import_flowEngine = require("./flowEngine");
 var import_flowI18n = require("./flowI18n");
 var import_JSRunner = require("./JSRunner");
-var import_models = require("./models");
 var import_resources = require("./resources");
 var import_utils = require("./utils");
 var import_exceptions = require("./utils/exceptions");
 var import_params_resolvers = require("./utils/params-resolvers");
 var import_serverContextParams = require("./utils/serverContextParams");
+var import_registry = require("./runjs-context/registry");
+var import_createEphemeralContext = require("./utils/createEphemeralContext");
+var import_dayjs = __toESM(require("dayjs"));
 var _proxy, _FlowContext_instances, createChildNodes_fn, findMetaByPath_fn, findMetaInDelegatesDeep_fn, findMetaInProperty_fn, resolvePathInMeta_fn, resolvePathInMetaAsync_fn, buildParentTitles_fn, toTreeNode_fn;
 function isRecordRefLike(val) {
   return !!(val && typeof val === "object" && "collection" in val && "filterByTk" in val);
@@ -657,34 +661,6 @@ toTreeNode_fn = /* @__PURE__ */ __name(function(name, metaOrFactory, paths = [na
 }, "#toTreeNode");
 __name(_FlowContext, "FlowContext");
 let FlowContext = _FlowContext;
-const _FlowRunjsContext = class _FlowRunjsContext extends FlowContext {
-  constructor(delegate) {
-    super();
-    this.addDelegate(delegate);
-    this.defineProperty("React", { value: import_react.default });
-    this.defineProperty("antd", { value: antd });
-    this.defineMethod(
-      "dispatchModelEvent",
-      async (modelOrUid, eventName, inputArgs) => {
-        var _a, _b;
-        let model = null;
-        if (typeof modelOrUid === "string") {
-          model = await this.engine.loadModel({ uid: modelOrUid });
-        } else if (modelOrUid instanceof import_models.FlowModel) {
-          model = modelOrUid;
-        }
-        if (model) {
-          model.context.addDelegate(this);
-          model.dispatchEvent(eventName, { navigation: false, ...(_b = (_a = this.model) == null ? void 0 : _a["getInputArgs"]) == null ? void 0 : _b.call(_a), ...inputArgs });
-        } else {
-          this.message.error(this.t("Model with ID {{uid}} not found", { uid: modelOrUid }));
-        }
-      }
-    );
-  }
-};
-__name(_FlowRunjsContext, "FlowRunjsContext");
-let FlowRunjsContext = _FlowRunjsContext;
 const _BaseFlowEngineContext = class _BaseFlowEngineContext extends FlowContext {
 };
 __name(_BaseFlowEngineContext, "BaseFlowEngineContext");
@@ -724,7 +700,7 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
     });
     this.defineMethod("runjs", async (code, variables, options) => {
       const mergedGlobals = { ...(options == null ? void 0 : options.globals) || {}, ...variables || {} };
-      const runner = this.createJSRunner({
+      const runner = await this.createJSRunner({
         ...options || {},
         globals: mergedGlobals
       });
@@ -797,6 +773,16 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
         const inputFromMeta = await collectFromMeta();
         const autoInput = { ...inputFromMeta };
         const autoContextParams = Object.keys(autoInput).length ? (0, import_serverContextParams.buildServerContextParams)(this, autoInput) : void 0;
+        if (!autoContextParams) {
+          const keys = Object.keys(serverVarPaths);
+          const allOptional = keys.length > 0 && keys.every((k) => {
+            var _a2;
+            return (_a2 = this.getPropertyOptions(k)) == null ? void 0 : _a2.serverOnlyWhenContextParams;
+          });
+          if (allOptional) {
+            return (0, import_utils.resolveExpressions)(template, this);
+          }
+        }
         if (this.api) {
           try {
             serverResolved = await (0, import_params_resolvers.enqueueVariablesResolve)(this, {
@@ -930,45 +916,54 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
         );
       });
     });
-    this.defineMethod("createJSRunner", function(options) {
-      const runCtx = new FlowRunjsContext(this.createProxy());
-      return new import_JSRunner.JSRunner({
-        ...options,
-        globals: {
-          ctx: runCtx,
-          window: (0, import_utils.createSafeWindow)(),
-          document: (0, import_utils.createSafeDocument)(),
-          ...options == null ? void 0 : options.globals
-        }
-      });
-    });
-    this.defineMethod("copyToClipboard", async (text) => {
-      const content = String(text ?? "");
-      try {
-        if (typeof navigator !== "undefined" && navigator.clipboard && navigator.clipboard.writeText) {
-          await navigator.clipboard.writeText(content);
-          return;
-        }
-      } catch (e) {
+    this.defineMethod("importAsync", async (url) => {
+      if (!url || typeof url !== "string") {
+        throw new Error("invalid url");
       }
-      return new Promise((resolve, reject) => {
+      const u = url.trim();
+      const g = globalThis;
+      g.__nocobaseImportAsyncCache = g.__nocobaseImportAsyncCache || /* @__PURE__ */ new Map();
+      const cache = g.__nocobaseImportAsyncCache;
+      if (cache.has(u)) return cache.get(u);
+      const nativeImport = /* @__PURE__ */ __name(() => import(
+        /* @vite-ignore */
+        /* webpackIgnore: true */
+        u
+      ), "nativeImport");
+      const evalImport = /* @__PURE__ */ __name(() => {
+        const importer = (0, eval)("u => import(u)");
+        return importer(u);
+      }, "evalImport");
+      const p = (async () => {
         try {
-          const ta = document.createElement("textarea");
-          ta.value = content;
-          ta.setAttribute("readonly", "");
-          ta.style.position = "fixed";
-          ta.style.top = "-9999px";
-          document.body.appendChild(ta);
-          ta.focus();
-          ta.select();
-          const ok = document.execCommand("copy");
-          document.body.removeChild(ta);
-          if (ok) resolve();
-          else reject(new Error("execCommand copy failed"));
+          return await nativeImport();
         } catch (err) {
-          reject(err);
+          try {
+            return await evalImport();
+          } catch (err2) {
+            throw err2 || err;
+          }
         }
-      });
+      })();
+      cache.set(u, p);
+      return p;
+    });
+    this.defineMethod("createJSRunner", async function(options) {
+      try {
+        const mod = await import("./runjs-context/setup");
+        if (typeof (mod == null ? void 0 : mod.setupRunJSContexts) === "function") await mod.setupRunJSContexts();
+      } catch (_2) {
+      }
+      const version = (options == null ? void 0 : options.version) || "v1";
+      const modelClass = (0, import_registry.getModelClassName)(this);
+      const Ctor = import_registry.RunJSContextRegistry.resolve(version, modelClass) || import_registry.RunJSContextRegistry.resolve(version, "*") || FlowRunJSContext;
+      let runCtx;
+      if (Ctor) {
+        runCtx = new Ctor(this);
+      }
+      const globals = { ctx: runCtx, ...(options == null ? void 0 : options.globals) || {} };
+      const { timeoutMs } = options || {};
+      return new import_JSRunner.JSRunner({ globals, timeoutMs });
     });
     this.defineMethod("buildServerContextParams", function(input) {
       return (0, import_serverContextParams.buildServerContextParams)(this, input);
@@ -986,7 +981,7 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
       "runAction",
       async function(actionName, params) {
         const def = this.engine.getAction(actionName);
-        const ctx = this.createProxy();
+        const ctx = await (0, import_createEphemeralContext.createEphemeralContext)(this, def);
         if (!def) {
           throw new Error(`Action '${actionName}' not found.`);
         }
@@ -1019,13 +1014,22 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
         context: this.createProxy()
       });
     });
+    this.defineMethod(
+      "useResource",
+      function(className) {
+        if (this.has("resource")) return;
+        this.defineProperty("resource", {
+          get: /* @__PURE__ */ __name(() => this.createResource(className), "get")
+        });
+      }
+    );
   }
 };
 __name(_FlowEngineContext, "FlowEngineContext");
 let FlowEngineContext = _FlowEngineContext;
 const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
   constructor(model) {
-    if (!(model instanceof import_models.FlowModel)) {
+    if (!model || typeof model !== "object") {
       throw new Error("Invalid FlowModel instance");
     }
     super();
@@ -1034,7 +1038,7 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
       this.engine.reactView.onRefReady(ref, cb, timeout);
     });
     this.defineMethod("runjs", async (code, variables, options) => {
-      const runner = this.createJSRunner({
+      const runner = await this.createJSRunner({
         globals: variables,
         version: options == null ? void 0 : options.version
       });
@@ -1051,7 +1055,7 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
       }, "get")
     });
     this.defineMethod("openView", async function(uid, options) {
-      var _a, _b, _c, _d, _e, _f, _g;
+      var _a, _b, _c, _d, _e, _f;
       const opts = { ...options };
       if (opts.defineProperties || opts.defineMethod) {
         opts.navigation = false;
@@ -1069,28 +1073,29 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
           stepParams: {
             popupSettings: {
               openView: {
-                ...import_lodash.default.pick(opts, ["dataSourceKey", "collectionName", "associationName"])
+                // 持久化首次传入的关键展示/数据参数，供后续路由与再次打开复用
+                ...import_lodash.default.pick(opts, ["dataSourceKey", "collectionName", "associationName", "mode", "size"])
               }
             }
           }
         });
         await model2.save();
       }
-      if ((_b = (_a = model2.getStepParams("popupSettings")) == null ? void 0 : _a.openView) == null ? void 0 : _b.dataSourceKey) {
-        model2.setStepParams("popupSettings", {
-          openView: {
-            ...(_c = model2.getStepParams("popupSettings")) == null ? void 0 : _c.openView,
-            ...import_lodash.default.pick(opts, ["dataSourceKey", "collectionName", "associationName"])
-          }
-        });
-        await model2.save();
+      if ((_a = model2.getStepParams("popupSettings")) == null ? void 0 : _a.openView) {
+        const prevOpenView = ((_b = model2.getStepParams("popupSettings")) == null ? void 0 : _b.openView) || {};
+        const incoming = import_lodash.default.pick(opts, ["dataSourceKey", "collectionName", "associationName", "mode", "size"]);
+        const nextOpenView = { ...prevOpenView, ...incoming };
+        if (!import_lodash.default.isEqual(prevOpenView, nextOpenView)) {
+          model2.setStepParams("popupSettings", { openView: nextOpenView });
+          await model2.save();
+        }
       }
-      const viewUid = (opts == null ? void 0 : opts.routeViewUid) ?? (opts == null ? void 0 : opts.viewUid) ?? (((_e = (_d = model2.stepParams) == null ? void 0 : _d.popupSettings) == null ? void 0 : _e.openView) ? model2.uid : this.model.uid);
+      const viewUid = (opts == null ? void 0 : opts.routeViewUid) ?? (opts == null ? void 0 : opts.viewUid) ?? (((_d = (_c = model2.stepParams) == null ? void 0 : _c.popupSettings) == null ? void 0 : _d.openView) ? model2.uid : this.model.uid);
       const parentView = this.view;
       const pendingType = (opts == null ? void 0 : opts.isMobileLayout) ? "embed" : (opts == null ? void 0 : opts.mode) || "drawer";
       const pendingInputArgs = { ...opts, viewUid, navigation: opts.navigation };
-      pendingInputArgs.filterByTk = pendingInputArgs.filterByTk || ((_f = this.inputArgs) == null ? void 0 : _f.filterByTk);
-      pendingInputArgs.sourceId = pendingInputArgs.sourceId || ((_g = this.inputArgs) == null ? void 0 : _g.sourceId);
+      pendingInputArgs.filterByTk = pendingInputArgs.filterByTk || ((_e = this.inputArgs) == null ? void 0 : _e.filterByTk);
+      pendingInputArgs.sourceId = pendingInputArgs.sourceId || ((_f = this.inputArgs) == null ? void 0 : _f.sourceId);
       const pendingView = {
         type: pendingType,
         inputArgs: pendingInputArgs,
@@ -1119,7 +1124,7 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
       "runAction",
       async function(actionName, params) {
         const def = this.model.getAction(actionName);
-        const ctx = this.createProxy();
+        const ctx = await (0, import_createEphemeralContext.createEphemeralContext)(this, def);
         if (!def) {
           throw new Error(`Action '${actionName}' not found.`);
         }
@@ -1144,7 +1149,7 @@ __name(_FlowModelContext, "FlowModelContext");
 let FlowModelContext = _FlowModelContext;
 const _FlowForkModelContext = class _FlowForkModelContext extends BaseFlowModelContext {
   constructor(master, fork) {
-    if (!(master instanceof import_models.FlowModel)) {
+    if (!master || typeof master !== "object") {
       throw new Error("Invalid FlowModel instance");
     }
     super();
@@ -1165,7 +1170,7 @@ const _FlowForkModelContext = class _FlowForkModelContext extends BaseFlowModelC
       }, "get")
     });
     this.defineMethod("runjs", async (code, variables, options) => {
-      const runner = this.createJSRunner({
+      const runner = await this.createJSRunner({
         globals: variables,
         version: options == null ? void 0 : options.version
       });
@@ -1216,7 +1221,7 @@ const _FlowRuntimeContext = class _FlowRuntimeContext extends BaseFlowModelConte
       this.engine.reactView.onRefReady(ref, cb, timeout);
     });
     this.defineMethod("runjs", async (code, variables, options) => {
-      const runner = this.createJSRunner({
+      const runner = await this.createJSRunner({
         globals: variables,
         version: options == null ? void 0 : options.version
       });
@@ -1257,12 +1262,135 @@ const _FlowRuntimeContext = class _FlowRuntimeContext extends BaseFlowModelConte
 };
 __name(_FlowRuntimeContext, "FlowRuntimeContext");
 let FlowRuntimeContext = _FlowRuntimeContext;
+const __runjsClassDefaultMeta = /* @__PURE__ */ new WeakMap();
+const __runjsClassLocaleMeta = /* @__PURE__ */ new WeakMap();
+const __runjsDocCache = /* @__PURE__ */ new WeakMap();
+function __runjsDeepMerge(base, patch) {
+  if (patch === null) return void 0;
+  if (Array.isArray(base) || Array.isArray(patch) || typeof base !== "object" || typeof patch !== "object") {
+    return patch ?? base;
+  }
+  const out = { ...base };
+  for (const k of Object.keys(patch)) {
+    const v = __runjsDeepMerge(base == null ? void 0 : base[k], patch[k]);
+    if (typeof v === "undefined") delete out[k];
+    else out[k] = v;
+  }
+  return out;
+}
+__name(__runjsDeepMerge, "__runjsDeepMerge");
+const _FlowRunJSContext = class _FlowRunJSContext extends FlowContext {
+  constructor(delegate) {
+    super();
+    this.addDelegate(delegate);
+    this.defineProperty("React", { value: import_react.default });
+    this.defineProperty("antd", { value: antd });
+    this.defineProperty("dayjs", { value: import_dayjs.default });
+    const ReactDOMShim = {
+      ...ReactDOMClient,
+      createRoot: /* @__PURE__ */ __name((container, options) => {
+        const realContainer = (container == null ? void 0 : container.__el) || container;
+        return this.engine.reactView.createRoot(realContainer, options);
+      }, "createRoot")
+    };
+    this.defineProperty("ReactDOM", { value: ReactDOMShim });
+    this.defineMethod(
+      "render",
+      function(vnode, container) {
+        const el = container || this.element;
+        if (!el) throw new Error("ctx.render: container not provided and ctx.element is not available");
+        const containerEl = (el == null ? void 0 : el.__el) || el;
+        const globalRef = globalThis;
+        globalRef.__nbRunjsRoots = globalRef.__nbRunjsRoots || /* @__PURE__ */ new WeakMap();
+        const rootMap = globalRef.__nbRunjsRoots;
+        if (typeof vnode === "string") {
+          const existingRoot = rootMap.get(containerEl);
+          if (existingRoot && typeof existingRoot.unmount === "function") {
+            try {
+              existingRoot.unmount();
+            } finally {
+              rootMap.delete(containerEl);
+            }
+          }
+          const proxy = new import_ElementProxy.ElementProxy(containerEl);
+          proxy.innerHTML = String(vnode ?? "");
+          return null;
+        }
+        if (vnode && vnode.nodeType && (vnode.nodeType === 1 || vnode.nodeType === 3 || vnode.nodeType === 11)) {
+          const existingRoot = rootMap.get(containerEl);
+          if (existingRoot && typeof existingRoot.unmount === "function") {
+            try {
+              existingRoot.unmount();
+            } finally {
+              rootMap.delete(containerEl);
+            }
+          }
+          while (containerEl.firstChild) containerEl.removeChild(containerEl.firstChild);
+          containerEl.appendChild(vnode);
+          return null;
+        }
+        let root = rootMap.get(containerEl);
+        if (!root) {
+          root = this.ReactDOM.createRoot(containerEl);
+          rootMap.set(containerEl, root);
+        }
+        root.render(vnode);
+        return root;
+      }
+    );
+  }
+  static define(meta, options) {
+    const locale = options == null ? void 0 : options.locale;
+    if (locale) {
+      const map = __runjsClassLocaleMeta.get(this) || /* @__PURE__ */ new Map();
+      const prev = map.get(locale) || {};
+      map.set(locale, __runjsDeepMerge(prev, meta));
+      __runjsClassLocaleMeta.set(this, map);
+    } else {
+      const prev = __runjsClassDefaultMeta.get(this) || {};
+      __runjsClassDefaultMeta.set(this, __runjsDeepMerge(prev, meta));
+    }
+    __runjsDocCache.delete(this);
+  }
+  static getDoc(locale) {
+    const self = this;
+    let cacheForClass = __runjsDocCache.get(self);
+    const cacheKey = String(locale || "default");
+    if (cacheForClass && cacheForClass.has(cacheKey)) return cacheForClass.get(cacheKey);
+    const chain = [];
+    let cur = self;
+    while (cur && cur.prototype) {
+      chain.unshift(cur);
+      cur = Object.getPrototypeOf(cur);
+    }
+    let merged = {};
+    for (const cls of chain) {
+      merged = __runjsDeepMerge(merged, __runjsClassDefaultMeta.get(cls) || {});
+    }
+    if (locale) {
+      for (const cls of chain) {
+        const lmap = __runjsClassLocaleMeta.get(cls);
+        if (lmap && lmap.has(locale)) {
+          merged = __runjsDeepMerge(merged, lmap.get(locale));
+        }
+      }
+    }
+    if (!cacheForClass) {
+      cacheForClass = /* @__PURE__ */ new Map();
+      __runjsDocCache.set(self, cacheForClass);
+    }
+    cacheForClass.set(cacheKey, merged);
+    return merged;
+  }
+};
+__name(_FlowRunJSContext, "FlowRunJSContext");
+let FlowRunJSContext = _FlowRunJSContext;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   FlowContext,
   FlowEngineContext,
   FlowForkModelContext,
   FlowModelContext,
-  FlowRunjsContext,
+  FlowRunJSContext,
   FlowRuntimeContext
 });

package/lib/flowEngine.d.ts

@@ -5,6 +5,9 @@ import { FlowSettings } from './flowSettings';
 import { FlowModel } from './models';
 import { ReactView } from './ReactView';
 import { FlowResource } from './resources';
+import { Emitter } from './emitter';
+import ModelOperationScheduler from './scheduler/ModelOperationScheduler';
+import type { ScheduleOptions, ScheduledCancel } from './scheduler/ModelOperationScheduler';
 import type { ActionDefinition, ApplyFlowCacheEntry, CreateModelOptions, EventDefinition, FlowModelOptions, IFlowModelRepository, ModelConstructor, PersistOptions, ResourceType } from './types';
 /**
  * FlowEngine is the core class of the flow engine, responsible for managing flow models, actions, model repository, and more.
@@ -81,6 +84,13 @@ export declare class FlowEngine {
     private _previousEngine?;
     private _nextEngine?;
     private _resources;
+    /**
+     * 引擎事件总线（目前用于模型生命周期等事件）。
+     * ViewScopedFlowEngine 持有自己的实例，实现作用域隔离。
+     */
+    emitter: Emitter;
+    /** 调度器：仅在 View 作用域引擎本地启用；根/Block 作用域默认不持有 */
+    private _modelOperationScheduler?;
     logger: pino.Logger;
     /**
      * Flow settings, including components and form scopes.
@@ -95,13 +105,19 @@ export declare class FlowEngine {
      */
     reactView: ReactView;
     /**
-     * Flow executor that runs flows and auto-flows.
+     * Flow executor that runs event flows.
      */
     executor: FlowExecutor;
     /**
      * Constructor. Initializes React view, registers default model and form scopes.
      */
     constructor();
+    /** 获取/创建当前引擎的调度器（仅在本地作用域） */
+    getScheduler(): ModelOperationScheduler;
+    /** 释放并清理当前引擎本地调度器（若存在） */
+    disposeScheduler(): void;
+    /** 在目标模型生命周期达成时执行操作（仅在 View 引擎本地存储计划） */
+    scheduleModelOperation(fromModelOrUid: FlowModel | string, toUid: string, fn: (model: FlowModel) => Promise<void> | void, options?: ScheduleOptions): ScheduledCancel;
     /** 上一个引擎（根引擎为 undefined） */
     get previousEngine(): FlowEngine | undefined;
     /** 下一个引擎（若存在） */
@@ -304,6 +320,13 @@ export declare class FlowEngine {
      * @returns {Promise<boolean>} Whether destroyed successfully
      */
     destroyModel(uid: string): Promise<boolean>;
+    /**
+     * Duplicate a model tree via repository API.
+     * Returns the duplicated model JSON (root with subModels) or null if not available.
+     * @param {string} uid UID of the model to duplicate
+     * @returns {Promise<any | null>} Duplicated model JSON or null
+     */
+    duplicateModel(uid: string): Promise<Record<string, any>>;
     /**
      * Replace a model instance with a new instance of a class.
      * @template T New model type

package/lib/flowEngine.js

@@ -59,6 +59,8 @@ var import_flowSettings = require("./flowSettings");
 var import_models = require("./models");
 var import_ReactView = require("./ReactView");
 var import_resources = require("./resources");
+var import_emitter = require("./emitter");
+var import_ModelOperationScheduler = __toESM(require("./scheduler/ModelOperationScheduler"));
 var import_utils = require("./utils");
 var _FlowEngine_instances, registerModel_fn;
 const _FlowEngine = class _FlowEngine {
@@ -118,6 +120,13 @@ const _FlowEngine = class _FlowEngine {
     __publicField(this, "_previousEngine");
     __publicField(this, "_nextEngine");
     __publicField(this, "_resources", /* @__PURE__ */ new Map());
+    /**
+     * 引擎事件总线（目前用于模型生命周期等事件）。
+     * ViewScopedFlowEngine 持有自己的实例，实现作用域隔离。
+     */
+    __publicField(this, "emitter", new import_emitter.Emitter());
+    /** 调度器：仅在 View 作用域引擎本地启用；根/Block 作用域默认不持有 */
+    __publicField(this, "_modelOperationScheduler");
     __publicField(this, "logger");
     /**
      * Flow settings, including components and form scopes.
@@ -132,7 +141,7 @@ const _FlowEngine = class _FlowEngine {
      */
     __publicField(this, "reactView");
     /**
-     * Flow executor that runs flows and auto-flows.
+     * Flow executor that runs event flows.
      */
     __publicField(this, "executor");
     this.reactView = new import_ReactView.ReactView(this);
@@ -161,6 +170,27 @@ const _FlowEngine = class _FlowEngine {
     });
     this.executor = new import_FlowExecutor.FlowExecutor(this);
   }
+  /** 获取/创建当前引擎的调度器（仅在本地作用域） */
+  getScheduler() {
+    if (!this._modelOperationScheduler) {
+      this._modelOperationScheduler = new import_ModelOperationScheduler.default(this);
+    }
+    return this._modelOperationScheduler;
+  }
+  /** 释放并清理当前引擎本地调度器（若存在） */
+  disposeScheduler() {
+    if (this._modelOperationScheduler) {
+      try {
+        this._modelOperationScheduler.dispose();
+      } finally {
+        this._modelOperationScheduler = void 0;
+      }
+    }
+  }
+  /** 在目标模型生命周期达成时执行操作（仅在 View 引擎本地存储计划） */
+  scheduleModelOperation(fromModelOrUid, toUid, fn, options) {
+    return this.getScheduler().schedule(fromModelOrUid, toUid, fn, options);
+  }
   /** 上一个引擎（根引擎为 undefined） */
   get previousEngine() {
     return this._previousEngine;
@@ -384,6 +414,10 @@ const _FlowEngine = class _FlowEngine {
     }
     this._modelInstances.set(modelInstance.uid, modelInstance);
     modelInstance.onInit(options);
+    void this.emitter.emitAsync("model:created", {
+      uid: modelInstance.uid,
+      model: modelInstance
+    });
     this._applyFlowDefinitionDefaultParams(modelInstance).catch((err) => {
       console.warn("FlowEngine: apply flow defaultParams failed:", err);
     });
@@ -485,6 +519,10 @@ const _FlowEngine = class _FlowEngine {
       }
     }
     this._modelInstances.delete(uid);
+    void this.emitter.emitAsync("model:destroyed", {
+      uid,
+      model: modelInstance
+    });
     return true;
   }
   /**
@@ -629,6 +667,16 @@ const _FlowEngine = class _FlowEngine {
     }
     return this.removeModel(uid);
   }
+  /**
+   * Duplicate a model tree via repository API.
+   * Returns the duplicated model JSON (root with subModels) or null if not available.
+   * @param {string} uid UID of the model to duplicate
+   * @returns {Promise<any | null>} Duplicated model JSON or null
+   */
+  async duplicateModel(uid) {
+    if (!this.ensureModelRepository()) return null;
+    return this._modelRepository.duplicate(uid);
+  }
   /**
    * Replace a model instance with a new instance of a class.
    * @template T New model type
@@ -674,7 +722,7 @@ const _FlowEngine = class _FlowEngine {
     }
     if (currentParent) {
       currentParent.emitter.setPaused(false);
-      currentParent.parent.invalidateAutoFlowCache(true);
+      currentParent.parent.invalidateFlowCache("beforeRender", true);
       (_a = currentParent.parent) == null ? void 0 : _a.rerender();
       currentParent.emitter.emit("onSubModelReplaced", { oldModel, newModel });
     }
@@ -704,7 +752,8 @@ const _FlowEngine = class _FlowEngine {
         console.error("FlowModel.moveTo: Parent subModels must be an array to perform move operation.");
         return false;
       }
-      const findIndex = /* @__PURE__ */ __name((model) => subModels.findIndex((item) => item.uid === model.uid), "findIndex");
+      const subModelsCopy = [...subModels];
+      const findIndex = /* @__PURE__ */ __name((model) => subModelsCopy.findIndex((item) => item.uid === model.uid), "findIndex");
       const currentIndex = findIndex(sourceModel2);
       const targetIndex = findIndex(targetModel2);
       if (currentIndex === -1 || targetIndex === -1) {
@@ -715,11 +764,12 @@ const _FlowEngine = class _FlowEngine {
         console.warn("FlowModel.moveTo: Current model is already at the target position. No action taken.");
         return false;
       }
-      const [movedModel] = subModels.splice(currentIndex, 1);
-      subModels.splice(targetIndex, 0, movedModel);
-      subModels.forEach((model, index) => {
+      const [movedModel] = subModelsCopy.splice(currentIndex, 1);
+      subModelsCopy.splice(targetIndex, 0, movedModel);
+      subModelsCopy.forEach((model, index) => {
         model.sortIndex = index;
       });
+      sourceModel2.parent.subModels[sourceModel2.subKey] = subModelsCopy;
       return true;
     }, "move");
     move(sourceModel, targetModel);

package/lib/flowSettings.d.ts

@@ -227,12 +227,13 @@ export declare class FlowSettings {
      * @param {any} form 表单实例（从外部传入以便统一管理）
      * @returns {React.ReactElement} 渲染的表单元素
      */
-    renderStepForm({ uiSchema, initialValues, flowEngine, form, onFormValuesChange, }: {
+    renderStepForm({ uiSchema, initialValues, flowEngine, form, onFormValuesChange, key, }: {
         uiSchema: any;
         initialValues: any;
         flowEngine: any;
         form?: any;
         onFormValuesChange?: (form: any) => void;
+        key?: string;
     }): React.ReactElement;
     /**
      * 打开流程设置入口（聚合渲染多个 flow 的可配置步骤）