@nocobase/flow-engine 2.0.0-alpha.7 → 2.0.0-alpha.71

package/lib/models/flowModel.js

@@ -53,7 +53,6 @@ __export(flowModel_exports, {
 });
 module.exports = __toCommonJS(flowModel_exports);
 var import_reactive = require("@formily/reactive");
-var import_reactive_react = require("@formily/reactive-react");
 var import_lodash = __toESM(require("lodash"));
 var import_react = __toESM(require("react"));
 var import_secure = require("uid/secure");
@@ -62,7 +61,6 @@ var import_StepSettingsDialog = require("../components/settings/wrappers/context
 var import_emitter = require("../emitter");
 var import_InstanceFlowRegistry = require("../flow-registry/InstanceFlowRegistry");
 var import_flowContext = require("../flowContext");
-var import_flowEngine = require("../flowEngine");
 var import_utils = require("../utils");
 var import_lib = require("antd/lib");
 var import_ModelActionRegistry = require("../action-registry/ModelActionRegistry");
@@ -70,11 +68,13 @@ var import_utils2 = require("../components/subModel/utils");
 var import_ModelEventRegistry = require("../event-registry/ModelEventRegistry");
 var import_GlobalFlowRegistry = require("../flow-registry/GlobalFlowRegistry");
 var import_forkFlowModel = require("./forkFlowModel");
+var import__ = require("..");
 var _flowContext;
 const classActionRegistries = /* @__PURE__ */ new WeakMap();
 const classEventRegistries = /* @__PURE__ */ new WeakMap();
 const modelMetas = /* @__PURE__ */ new WeakMap();
 const modelGlobalRegistries = /* @__PURE__ */ new WeakMap();
+const classMenuExtensions = /* @__PURE__ */ new WeakMap();
 var ModelRenderMode = /* @__PURE__ */ ((ModelRenderMode2) => {
   ModelRenderMode2["ReactElement"] = "reactElement";
   ModelRenderMode2["RenderFunction"] = "renderFunction";
@@ -92,8 +92,11 @@ const _FlowModel = class _FlowModel {
     __publicField(this, "subModels");
     __publicField(this, "_options");
     __publicField(this, "_title");
+    __publicField(this, "_extraTitle");
     __publicField(this, "isNew", false);
     // 标记是否为新建状态
+    __publicField(this, "skeleton", null);
+    __publicField(this, "forbidden", null);
     /**
      * 所有 fork 实例的引用集合。
      * 使用 Set 便于在销毁时主动遍历并调用 dispose，避免悬挂引用。
@@ -105,7 +108,7 @@ const _FlowModel = class _FlowModel {
      */
     __publicField(this, "forkCache", /* @__PURE__ */ new Map());
     /**
-     * 上一次 applyAutoFlows 的执行参数
+     * 上一次 beforeRender 的执行参数
      */
     __publicField(this, "_lastAutoRunParams", null);
     __publicField(this, "observerDispose");
@@ -120,18 +123,23 @@ const _FlowModel = class _FlowModel {
     __publicField(this, "_reactiveWrapperCache");
     __publicField(this, "flowRegistry");
     __publicField(this, "_cleanRun");
-    __publicField(this, "_dispatchEventWithDebounce", import_lodash.default.debounce(async (eventName, inputArgs) => {
-      return this._dispatchEvent(eventName, inputArgs);
-    }, 100));
+    __publicField(this, "_dispatchEventWithDebounce", import_lodash.default.debounce(
+      async function(eventName, inputArgs, options) {
+        return this._dispatchEvent(eventName, inputArgs, options);
+      },
+      500,
+      { leading: true }
+    ));
     /**
-     * 重新执行上一次的 applyAutoFlows，保持参数一致
+     * 重新执行上一次的 beforeRender，保持参数一致
      * 如果之前没有执行过，则直接跳过
      * 使用 lodash debounce 避免频繁调用
      */
     __publicField(this, "_rerunLastAutoRun", import_lodash.default.debounce(async () => {
       if (this._lastAutoRunParams) {
         try {
-          await this.applyAutoFlows(...this._lastAutoRunParams);
+          const [inputArgs] = this._lastAutoRunParams;
+          await this.dispatchEvent("beforeRender", inputArgs);
         } catch (error) {
           console.error("FlowModel._rerunLastAutoRun: Error during rerun:", error);
         }
@@ -155,11 +163,15 @@ const _FlowModel = class _FlowModel {
     this.subModels = {};
     this.sortIndex = options.sortIndex || 0;
     this._options = options;
+    this._title = "";
+    this._extraTitle = "";
     (0, import_reactive.define)(this, {
       hidden: import_reactive.observable,
       props: import_reactive.observable,
       subModels: import_reactive.observable.shallow,
       stepParams: import_reactive.observable,
+      _title: import_reactive.observable,
+      _extraTitle: import_reactive.observable,
       // setProps: action,
       setProps: import_reactive.batch,
       // setStepParams: action,
@@ -172,7 +184,7 @@ const _FlowModel = class _FlowModel {
         return;
       }
       if (this.flowEngine) {
-        this.invalidateAutoFlowCache();
+        this.invalidateFlowCache("beforeRender");
       }
       this._rerunLastAutoRun();
       this.forks.forEach((fork) => {
@@ -190,13 +202,16 @@ const _FlowModel = class _FlowModel {
     this._cleanRun = !!options["cleanRun"];
   }
   /**
-   * 当 flowSettings.enabled 且 model.hidden 为 true 时用于渲染设置态组件（实例方法，子类可覆盖）。
+   * 当 flowSettingsEnabled 且 model.hidden 为 true 时用于渲染设置态组件（实例方法，子类可覆盖）。
    * 基类默认仅返回一个透明度降低的占位元素
    */
   renderHiddenInConfig() {
     var _a;
     return /* @__PURE__ */ import_react.default.createElement("span", { style: { opacity: 0.5 } }, ((_a = this.translate) == null ? void 0 : _a.call(this, "Hidden")) || "Hidden");
   }
+  renderOriginal() {
+    return this._originalRender();
+  }
   /**
    * 对外暴露的上下文：
    */
@@ -234,6 +249,10 @@ const _FlowModel = class _FlowModel {
   get parentId() {
     return this._options.parentId;
   }
+  scheduleModelOperation(toUid, fn, options) {
+    var _a;
+    return (_a = this.flowEngine) == null ? void 0 : _a.scheduleModelOperation(this, toUid, fn, options);
+  }
   static get meta() {
     return modelMetas.get(this);
   }
@@ -308,16 +327,22 @@ const _FlowModel = class _FlowModel {
   static registerEvents(events) {
     this.eventRegistry.registerEvents(events);
   }
-  static buildChildrenFromModels(ctx, Models) {
-    return Models.map((M) => (0, import_utils2.buildSubModelItem)(M, ctx, true));
+  static async buildChildrenFromModels(ctx, Models) {
+    return Promise.all(Models.map((M) => (0, import_utils2.buildSubModelItem)(M, ctx, true)));
   }
   get title() {
     var _a;
     return this.translate(this._title) || this.translate((_a = this.constructor["meta"]) == null ? void 0 : _a.label);
   }
+  get extraTitle() {
+    return this._extraTitle ? this.translate(this._extraTitle) : "";
+  }
   setTitle(value) {
     this._title = value;
   }
+  setExtraTitle(value) {
+    this._extraTitle = value || "";
+  }
   setHidden(value) {
     this.hidden = !!value;
   }
@@ -328,7 +353,18 @@ const _FlowModel = class _FlowModel {
       const meta = Cls.meta;
       const metaCreate = meta == null ? void 0 : meta.createModelOptions;
       if (metaCreate && typeof metaCreate === "object" && metaCreate.subModels) {
-        mergedSubModels = import_lodash.default.merge({}, import_lodash.default.cloneDeep(metaCreate.subModels || {}), import_lodash.default.cloneDeep(subModels || {}));
+        const replaceArrays = /* @__PURE__ */ __name((objValue, srcValue) => {
+          if (Array.isArray(objValue) && Array.isArray(srcValue)) {
+            return srcValue;
+          }
+          return void 0;
+        }, "replaceArrays");
+        mergedSubModels = import_lodash.default.mergeWith(
+          {},
+          import_lodash.default.cloneDeep(metaCreate.subModels || {}),
+          import_lodash.default.cloneDeep(subModels || {}),
+          replaceArrays
+        );
       }
     } catch (e) {
     }
@@ -342,13 +378,57 @@ const _FlowModel = class _FlowModel {
       }
     });
   }
-  invalidateAutoFlowCache(deep = false) {
+  /**
+   * 失效指定事件的流程缓存；未指定 eventName 时，失效当前模型全部事件缓存。
+   * - 默认 beforeRender 与其它事件共享同一缓存体系：prefix=`event:${scope}`，flowKey=`eventName`，uid=`model.uid`
+   */
+  invalidateFlowCache(eventName, deep = false) {
     if (this.flowEngine) {
-      const cacheKey = import_flowEngine.FlowEngine.generateApplyFlowCacheKey("autoFlow", "all", this.uid);
-      this.flowEngine.applyFlowCache.delete(cacheKey);
+      const scope = `event:${this.getFlowCacheScope(eventName || "beforeRender")}`;
+      const cache = this.flowEngine.applyFlowCache;
+      if (eventName) {
+        const altScope = scope.replace(/:/g, "-");
+        const uidSuffixes = [`:${this.uid}`, `-${this.uid}`];
+        const eventSegments = [`:${eventName}:`, `-${eventName}-`];
+        for (const key of cache.keys()) {
+          const startMatches = key.startsWith(scope) || key.startsWith(altScope);
+          const endMatches = uidSuffixes.some((s) => key.endsWith(s));
+          const eventMatches = eventSegments.some((seg) => key.includes(seg));
+          if (startMatches && endMatches && eventMatches) {
+            cache.delete(key);
+          }
+        }
+      } else {
+        const altScope = `${scope}:`.replace(/:/g, "-");
+        const prefixes = [`${scope}:`, altScope];
+        const uidSuffixes = [`:${this.uid}`, `-${this.uid}`];
+        for (const key of cache.keys()) {
+          const startMatches = prefixes.some((p) => key.startsWith(p));
+          const endMatches = uidSuffixes.some((s) => key.endsWith(s));
+          if (startMatches && endMatches) cache.delete(key);
+        }
+      }
       this.forks.forEach((fork) => {
-        const forkCacheKey = import_flowEngine.FlowEngine.generateApplyFlowCacheKey(`${fork["forkId"]}`, "all", this.uid);
-        this.flowEngine.applyFlowCache.delete(forkCacheKey);
+        var _a;
+        const forkScope = `event:${((_a = fork.getFlowCacheScope) == null ? void 0 : _a.call(fork, eventName || "beforeRender")) ?? String(fork["forkId"])}`;
+        const altForkScope = forkScope.replace(/:/g, "-");
+        const uidSuffixes = [`:${this.uid}`, `-${this.uid}`];
+        if (eventName) {
+          const eventSegments = [`:${eventName}:`, `-${eventName}-`];
+          for (const key of this.flowEngine.applyFlowCache.keys()) {
+            const startMatches = key.startsWith(forkScope) || key.startsWith(altForkScope);
+            const endMatches = uidSuffixes.some((s) => key.endsWith(s));
+            const eventMatches = eventSegments.some((seg) => key.includes(seg));
+            if (startMatches && endMatches && eventMatches) this.flowEngine.applyFlowCache.delete(key);
+          }
+        } else {
+          const prefixes = [`${forkScope}:`, `${altForkScope}-`];
+          for (const key of this.flowEngine.applyFlowCache.keys()) {
+            const startMatches = prefixes.some((p) => key.startsWith(p));
+            const endMatches = uidSuffixes.some((s) => key.endsWith(s));
+            if (startMatches && endMatches) this.flowEngine.applyFlowCache.delete(key);
+          }
+        }
       });
     }
     if (deep) {
@@ -357,10 +437,10 @@ const _FlowModel = class _FlowModel {
         const subModelValue = this.subModels[subModelKey];
         if (Array.isArray(subModelValue)) {
           for (const subModel of subModelValue) {
-            subModel.invalidateAutoFlowCache(deep);
+            subModel.invalidateFlowCache(eventName, deep);
           }
         } else if (subModelValue instanceof _FlowModel) {
-          subModelValue.invalidateAutoFlowCache(deep);
+          subModelValue.invalidateFlowCache(eventName, deep);
         }
       }
     }
@@ -480,14 +560,15 @@ const _FlowModel = class _FlowModel {
     const instanceKeys = new Set(instanceFlows.keys());
     const staticEntries = Array.from(staticFlows.entries()).filter(([key]) => !instanceKeys.has(key));
     const instanceEntries = Array.from(instanceFlows.entries());
-    const allEntries = [...staticEntries, ...instanceEntries];
-    allEntries.sort(([, a], [, b]) => {
-      const sa = a.sort ?? 0;
-      const sb = b.sort ?? 0;
+    const instanceEntriesWithIndex = instanceEntries.map((e, i) => ({ e, i }));
+    instanceEntriesWithIndex.sort((a, b) => {
+      const sa = a.e[1].sort ?? 0;
+      const sb = b.e[1].sort ?? 0;
       if (sa !== sb) return sa - sb;
-      return 0;
+      return a.i - b.i;
     });
-    return new Map(allEntries);
+    const merged = [...instanceEntriesWithIndex.map(({ e }) => e), ...staticEntries];
+    return new Map(merged);
   }
   setProps(props, value) {
     if (typeof props === "string") {
@@ -520,6 +601,7 @@ const _FlowModel = class _FlowModel {
         }
       }
     }
+    this.emitter.emit("onStepParamsChanged");
   }
   getStepParams(flowKey, stepKey) {
     var _a;
@@ -544,7 +626,7 @@ const _FlowModel = class _FlowModel {
     );
     return currentFlowEngine.executor.runFlow(target, flowKey, inputArgs, runId);
   }
-  async _dispatchEvent(eventName, inputArgs) {
+  async _dispatchEvent(eventName, inputArgs, options) {
     const currentFlowEngine = this.flowEngine;
     if (!currentFlowEngine) {
       console.warn("FlowEngine not available on this model for dispatchEvent. Please set flowEngine on the model.");
@@ -555,93 +637,63 @@ const _FlowModel = class _FlowModel {
     console.log(
       `[FlowModel] dispatchEvent: uid=${this.uid}, event=${eventName}, isFork=${isFork}, cleanRun=${this.cleanRun}, targetIsFork=${(target == null ? void 0 : target.isFork) === true}`
     );
-    await currentFlowEngine.executor.dispatchEvent(target, eventName, inputArgs);
+    return await currentFlowEngine.executor.dispatchEvent(target, eventName, inputArgs, options);
   }
   async dispatchEvent(eventName, inputArgs, options) {
+    const isBeforeRender = eventName === "beforeRender";
+    const defaults = isBeforeRender ? { sequential: true, useCache: true } : { sequential: true };
+    const execOptions = {
+      sequential: (options == null ? void 0 : options.sequential) ?? defaults.sequential,
+      useCache: (options == null ? void 0 : options.useCache) ?? defaults.useCache
+    };
+    if (isBeforeRender) {
+      this._lastAutoRunParams = [inputArgs, execOptions.useCache];
+    }
     if (options == null ? void 0 : options.debounce) {
-      return this._dispatchEventWithDebounce(eventName, inputArgs);
+      return this._dispatchEventWithDebounce(eventName, inputArgs, execOptions);
     }
-    return this._dispatchEvent(eventName, inputArgs);
+    return this._dispatchEvent(eventName, inputArgs, execOptions);
   }
   /**
-   * 获取所有自动应用流程定义（保持 getFlows 的顺序，即按 sort 排序）
-   * @returns {FlowDefinition[]} 自动应用流程定义数组（已按 sort 排序）
+   * 按事件名获取对应的流程集合（保持 getFlows 的顺序，即按 sort 排序）。
+   * - beforeRender 兼容：除显式 on: 'beforeRender' 外，包含未声明 on 且 manual !== true 的流程。
    */
-  getAutoFlows() {
+  getEventFlows(eventName) {
     const allFlows = this.getFlows();
-    const autoFlows = Array.from(allFlows.values()).filter((flow) => {
-      if (flow.on) {
-        return false;
-      }
-      if (flow.manual === true) {
-        return false;
+    const beforeRender = eventName === "beforeRender";
+    const isMatch = /* @__PURE__ */ __name((flow) => {
+      var _a;
+      if (beforeRender) {
+        if (flow.manual === true) return false;
+        if (!flow.on) return true;
+        return typeof flow.on === "string" ? flow.on === "beforeRender" : ((_a = flow.on) == null ? void 0 : _a.eventName) === "beforeRender";
       }
-      return true;
-    });
-    return autoFlows;
+      const on = flow.on;
+      if (!on) return false;
+      return typeof on === "string" ? on === eventName : (on == null ? void 0 : on.eventName) === eventName;
+    }, "isMatch");
+    return Array.from(allFlows.values()).filter(isMatch);
   }
   /**
-   * 自动流程执行前钩子。
-   * 子类可覆盖；可抛出 FlowExitException 提前终止。
+   * 通用事件分发钩子：开始
+   * 子类可覆盖；beforeRender 事件可通过抛出 FlowExitException 提前终止。
    */
-  async onBeforeAutoFlows(inputArgs) {
+  async onDispatchEventStart(eventName, options, inputArgs) {
   }
   /**
-   * 自动流程执行后钩子。
+   * 通用事件分发钩子：结束
    * 子类可覆盖。
    */
-  async onAfterAutoFlows(results, inputArgs) {
+  async onDispatchEventEnd(eventName, options, inputArgs, results) {
   }
   /**
-   * 自动流程错误钩子。
+   * 通用事件分发钩子：错误
    * 子类可覆盖。
    */
-  async onAutoFlowsError(error, inputArgs) {
+  async onDispatchEventError(eventName, options, inputArgs, error) {
   }
   useHooksBeforeRender() {
   }
-  async applyAutoFlows(...args) {
-    var _a, _b;
-    const [inputArgs, useCache = true] = args;
-    const cacheKey = useCache ? import_flowEngine.FlowEngine.generateApplyFlowCacheKey(this["forkId"] ?? "autoFlow", "all", this.uid) : null;
-    if (!import_lodash.default.isEqual(inputArgs, (_a = this._lastAutoRunParams) == null ? void 0 : _a[0]) && cacheKey) {
-      this.flowEngine.applyFlowCache.delete(cacheKey);
-    }
-    this._lastAutoRunParams = args;
-    try {
-      await this.onBeforeAutoFlows(inputArgs);
-    } catch (error) {
-      if (error instanceof import_utils.FlowExitException) {
-        (_b = this.context.logger) == null ? void 0 : _b.debug(`[FlowModel.applyAutoFlows] ${error.message}`);
-        return [];
-      }
-      try {
-        await this.onAutoFlowsError(error, inputArgs);
-      } catch (_2) {
-      }
-      throw error;
-    }
-    let results = [];
-    try {
-      results = await this.flowEngine.executor.runAutoFlows(this, inputArgs, useCache);
-    } catch (error) {
-      try {
-        await this.onAutoFlowsError(error, inputArgs);
-      } catch (_2) {
-      }
-      throw error;
-    }
-    try {
-      await this.onAfterAutoFlows(results, inputArgs);
-    } catch (error) {
-      try {
-        await this.onAutoFlowsError(error, inputArgs);
-      } catch (_2) {
-      }
-      throw error;
-    }
-    return results;
-  }
   /**
    * 智能检测是否应该跳过响应式包装
    * 说明：
@@ -675,11 +727,11 @@ const _FlowModel = class _FlowModel {
       }
       if (this.shouldSkipReactiveWrapping()) {
         const wrappedNonReactive = /* @__PURE__ */ __name(function() {
-          var _a, _b, _c;
-          const isConfigMode = !!((_b = (_a = this == null ? void 0 : this.flowEngine) == null ? void 0 : _a.flowSettings) == null ? void 0 : _b.enabled);
+          var _a, _b;
+          const isConfigMode = !!((_a = this == null ? void 0 : this.context) == null ? void 0 : _a.flowSettingsEnabled);
           if (this.hidden) {
             if (!isConfigMode) return null;
-            const rendered = (_c = this.renderHiddenInConfig) == null ? void 0 : _c.call(this);
+            const rendered = (_b = this.renderHiddenInConfig) == null ? void 0 : _b.call(this);
             const Cls = this.constructor;
             const returnsFunction = Cls.renderMode === "renderFunction" /* RenderFunction */;
             return returnsFunction ? typeof rendered === "function" ? rendered : () => rendered : rendered;
@@ -691,8 +743,8 @@ const _FlowModel = class _FlowModel {
         return;
       }
       const createReactiveWrapper = /* @__PURE__ */ __name((modelInstance) => {
-        const ReactiveWrapper = (0, import_reactive_react.observer)(() => {
-          var _a, _b, _c;
+        const ReactiveWrapper = (0, import__.observer)(() => {
+          var _a, _b;
           const renderTarget = modelInstance;
           if (renderTarget !== modelInstance && (renderTarget == null ? void 0 : renderTarget.localProps) !== void 0) {
             renderTarget.localProps;
@@ -701,22 +753,33 @@ const _FlowModel = class _FlowModel {
             modelInstance.props;
           }
           import_react.default.useEffect(() => {
+            var _a2, _b2;
             if (typeof renderTarget.onMount === "function") {
               renderTarget.onMount();
             }
+            void ((_b2 = (_a2 = renderTarget.flowEngine) == null ? void 0 : _a2.emitter) == null ? void 0 : _b2.emitAsync("model:mounted", {
+              uid: renderTarget.uid,
+              model: renderTarget
+            }));
             return () => {
+              var _a3, _b3;
               if (typeof renderTarget.onUnmount === "function") {
                 renderTarget.onUnmount();
               }
+              void ((_b3 = (_a3 = renderTarget.flowEngine) == null ? void 0 : _a3.emitter) == null ? void 0 : _b3.emitAsync("model:unmounted", {
+                uid: renderTarget.uid,
+                model: renderTarget
+              }));
             };
           }, [renderTarget]);
-          const isConfigMode = !!((_b = (_a = modelInstance == null ? void 0 : modelInstance.flowEngine) == null ? void 0 : _a.flowSettings) == null ? void 0 : _b.enabled);
+          const isConfigMode = !!((_a = modelInstance == null ? void 0 : modelInstance.context) == null ? void 0 : _a.flowSettingsEnabled);
           if (modelInstance.hidden) {
             if (!isConfigMode) {
               return null;
             }
-            return (_c = modelInstance.renderHiddenInConfig) == null ? void 0 : _c.call(modelInstance);
+            return (_b = modelInstance.renderHiddenInConfig) == null ? void 0 : _b.call(modelInstance);
           }
+          modelInstance.stepParams;
           return originalRender.call(renderTarget);
         });
         ReactiveWrapper.displayName = `ReactiveWrapper(${modelInstance.constructor.name})`;
@@ -768,13 +831,13 @@ const _FlowModel = class _FlowModel {
   }
   async rerender() {
     var _a;
-    await this.applyAutoFlows((_a = this._lastAutoRunParams) == null ? void 0 : _a[0], false);
+    await this.dispatchEvent("beforeRender", (_a = this._lastAutoRunParams) == null ? void 0 : _a[0], { useCache: false });
   }
   /**
-   * 自动流程缓存的作用域标识；fork 实例可覆盖以区分缓存。
+   * 事件缓存的作用域标识；可按事件区分（默认与事件无关的 scope 返回 'default'）。
    */
-  getAutoFlowCacheScope() {
-    return "autoFlow";
+  getFlowCacheScope(eventName) {
+    return String(eventName);
   }
   setParent(parent) {
     const isValidParent = parent && (parent.constructor === _FlowModel || (0, import_utils.isInheritedFrom)(parent.constructor, _FlowModel));
@@ -794,7 +857,7 @@ const _FlowModel = class _FlowModel {
     this.context.removeDelegate(this.parent.context);
   }
   addSubModel(subKey, options) {
-    var _a;
+    var _a, _b, _c;
     const actualParent = this["master"] || this;
     let model;
     if (options instanceof _FlowModel) {
@@ -821,10 +884,16 @@ const _FlowModel = class _FlowModel {
     model.sortIndex = maxSortIndex + 1;
     subModels[subKey].push(model);
     actualParent.emitter.emit("onSubModelAdded", model);
+    (_c = (_b = actualParent.flowEngine) == null ? void 0 : _b.emitter) == null ? void 0 : _c.emit("model:subModel:added", {
+      parentUid: actualParent.uid,
+      parent: actualParent,
+      subKey,
+      model
+    });
     return model;
   }
   setSubModel(subKey, options) {
-    var _a;
+    var _a, _b, _c;
     const actualParent = this["master"] || this;
     let model;
     if (options instanceof _FlowModel) {
@@ -845,6 +914,12 @@ const _FlowModel = class _FlowModel {
     model.setParent(actualParent);
     actualParent.subModels[subKey] = model;
     actualParent.emitter.emit("onSubModelAdded", model);
+    (_c = (_b = actualParent.flowEngine) == null ? void 0 : _b.emitter) == null ? void 0 : _c.emit("model:subModel:added", {
+      parentUid: actualParent.uid,
+      parent: actualParent,
+      subKey,
+      model
+    });
     return model;
   }
   filterSubModels(subKey, callback) {
@@ -892,10 +967,13 @@ const _FlowModel = class _FlowModel {
   createRootModel(options) {
     return this.flowEngine.createModel(options);
   }
-  async applySubModelsAutoFlows(subKey, inputArgs, shared) {
+  /**
+   * 对指定子模型派发 beforeRender 事件（顺序执行并使用缓存）。
+   */
+  async applySubModelsBeforeRenderFlows(subKey, inputArgs, shared) {
     await Promise.all(
       this.mapSubModels(subKey, async (sub) => {
-        await sub.applyAutoFlows(inputArgs);
+        await sub.dispatchEvent("beforeRender", inputArgs);
       })
     );
   }
@@ -913,7 +991,7 @@ const _FlowModel = class _FlowModel {
         return cachedFork;
       }
     }
-    const forkId = this.forks.size;
+    const forkId = (0, import_secure.uid)();
     const fork = new import_forkFlowModel.ForkFlowModel(this, localProps, forkId);
     if ((options == null ? void 0 : options.register) !== false) {
       this.forks.add(fork);
@@ -952,7 +1030,7 @@ const _FlowModel = class _FlowModel {
       throw new Error("FlowEngine is not set on this model. Please set flowEngine before saving.");
     }
     this.observerDispose();
-    this.invalidateAutoFlowCache(true);
+    this.invalidateFlowCache("beforeRender", true);
     return this.flowEngine.removeModel(this.uid);
   }
   async save() {
@@ -969,7 +1047,7 @@ const _FlowModel = class _FlowModel {
       throw new Error("FlowEngine is not set on this model. Please set flowEngine before deleting.");
     }
     this.observerDispose();
-    this.invalidateAutoFlowCache(true);
+    this.invalidateFlowCache("beforeRender", true);
     return this.flowEngine.destroyModel(this.uid);
   }
   /**
@@ -1032,7 +1110,8 @@ const _FlowModel = class _FlowModel {
       uid: this.uid,
       ...import_lodash.default.omit(this._options, ["flowEngine"]),
       stepParams: this.stepParams,
-      sortIndex: this.sortIndex
+      sortIndex: this.sortIndex,
+      flowRegistry: {}
     };
     const subModels = this.subModels;
     for (const subModelKey in subModels) {
@@ -1047,11 +1126,64 @@ const _FlowModel = class _FlowModel {
       }
     }
     for (const [key, flow] of this.flowRegistry.getFlows()) {
-      data["flowRegistry"] = data["flowRegistry"] || {};
-      data["flowRegistry"][key] = flow.toData();
+      data.flowRegistry[key] = flow.toData();
     }
     return data;
   }
+  /**
+   * 复制当前模型实例为一个新的实例。
+   * 新实例及其所有子模型都会有新的 uid，且不保留 root model 的 parent 关系。
+   * 内部所有引用旧 uid 的地方（如 parentId, parentUid 等）都会被替换为对应的新 uid。
+   * @returns {FlowModel} 复制后的新模型实例
+   */
+  clone() {
+    if (!this.flowEngine) {
+      throw new Error("FlowEngine is not set on this model. Please set flowEngine before cloning.");
+    }
+    const serialized = this.serialize();
+    const uidMap = /* @__PURE__ */ new Map();
+    const collectUids = /* @__PURE__ */ __name((data) => {
+      if (data.uid && typeof data.uid === "string") {
+        uidMap.set(data.uid, (0, import_secure.uid)());
+      }
+      if (data.subModels) {
+        for (const key in data.subModels) {
+          const subModel = data.subModels[key];
+          if (Array.isArray(subModel)) {
+            subModel.forEach((item) => collectUids(item));
+          } else if (subModel && typeof subModel === "object") {
+            collectUids(subModel);
+          }
+        }
+      }
+    }, "collectUids");
+    collectUids(serialized);
+    const replaceUidReferences = /* @__PURE__ */ __name((data, isRoot = false) => {
+      if (data === null || data === void 0) {
+        return data;
+      }
+      if (typeof data === "string") {
+        return uidMap.get(data) ?? data;
+      }
+      if (Array.isArray(data)) {
+        return data.map((item) => replaceUidReferences(item, false));
+      }
+      if (typeof data === "object") {
+        const result = {};
+        for (const key in data) {
+          if (!Object.prototype.hasOwnProperty.call(data, key)) continue;
+          if (isRoot && key === "parentId") {
+            continue;
+          }
+          result[key] = replaceUidReferences(data[key], false);
+        }
+        return result;
+      }
+      return data;
+    }, "replaceUidReferences");
+    const clonedData = replaceUidReferences(serialized, true);
+    return this.flowEngine.createModel(clonedData);
+  }
   /**
    * Opens the flow settings dialog for this flow model.
    * @param options - Configuration options for opening flow settings, excluding the model property
@@ -1063,6 +1195,62 @@ const _FlowModel = class _FlowModel {
       ...options
     });
   }
+  /** 注册设置菜单的额外项（静态，按类缓存，可继承合并） */
+  static registerExtraMenuItems(opts) {
+    const ModelClass = this;
+    const registry = classMenuExtensions.get(ModelClass) || /* @__PURE__ */ new Set();
+    let entry;
+    if (typeof opts === "function") {
+      entry = { items: opts };
+    } else {
+      entry = opts;
+    }
+    registry.add(entry);
+    classMenuExtensions.set(ModelClass, registry);
+    return () => {
+      const reg = classMenuExtensions.get(ModelClass);
+      reg == null ? void 0 : reg.delete(entry);
+    };
+  }
+  static async getExtraMenuItems(model, t) {
+    const ModelClass = this;
+    const collected = [];
+    const seen = /* @__PURE__ */ new Set();
+    const walk = /* @__PURE__ */ __name(async (Cls) => {
+      if (!Cls || seen.has(Cls)) return;
+      seen.add(Cls);
+      const reg = classMenuExtensions.get(Cls);
+      if (reg) {
+        for (const entry of reg) {
+          if (entry.matcher && !entry.matcher(model)) continue;
+          const items = typeof entry.items === "function" ? await entry.items(model, t) : await Promise.resolve(entry.items || []);
+          const group = entry.group || "common-actions";
+          const sort = entry.sort ?? 0;
+          const prefix = entry.keyPrefix || Cls.name || "extra";
+          (items || []).forEach((it, idx) => {
+            if (!it) return;
+            const key = it.key ?? `${prefix}-${group}-${idx}-${Math.random().toString(36).slice(2, 6)}`;
+            collected.push({
+              ...it,
+              key,
+              group: it.group || group,
+              sort: typeof it.sort === "number" ? it.sort : sort
+            });
+          });
+        }
+      }
+      const ParentClass = Object.getPrototypeOf(Cls);
+      const isFlowModelCtor = ParentClass === _FlowModel || (ParentClass == null ? void 0 : ParentClass.prototype) instanceof _FlowModel;
+      if (isFlowModelCtor) {
+        await walk(ParentClass);
+      }
+    }, "walk");
+    await walk(ModelClass);
+    return collected;
+  }
+  refresh() {
+    return this.rerender();
+  }
   // =============================
   // Dynamic flows (disabled)
   // The following APIs are kept as comments to preserve context