@nocobase/flow-engine 2.0.0-alpha.9 → 2.0.0-beta.2

package/lib/models/flowModel.d.ts

@@ -11,15 +11,37 @@ import { Emitter } from '../emitter';
 import { InstanceFlowRegistry } from '../flow-registry/InstanceFlowRegistry';
 import { FlowContext, FlowModelContext, FlowRuntimeContext } from '../flowContext';
 import { FlowEngine } from '../flowEngine';
-import type { ActionDefinition, ArrayElementType, CreateModelOptions, CreateSubModelOptions, DefaultStructure, FlowDefinitionOptions, FlowModelMeta, FlowModelOptions, ModelConstructor, ParamObject, ParentFlowModel, PersistOptions, StepParams } from '../types';
+import type { ActionDefinition, ArrayElementType, CreateModelOptions, CreateSubModelOptions, DefaultStructure, FlowDefinitionOptions, FlowModelMeta, FlowModelOptions, ModelConstructor, ParamObject, ParentFlowModel, PersistOptions, ResolveUseResult, StepParams } from '../types';
 import { IModelComponentProps, ReadonlyModelProps } from '../types';
 import { ModelActionRegistry } from '../action-registry/ModelActionRegistry';
 import { ModelEventRegistry } from '../event-registry/ModelEventRegistry';
 import { GlobalFlowRegistry } from '../flow-registry/GlobalFlowRegistry';
 import { FlowDefinition } from '../FlowDefinition';
 import { FlowSettingsOpenOptions } from '../flowSettings';
-import type { EventDefinition, DispatchEventOptions } from '../types';
+import type { ScheduleOptions } from '../scheduler/ModelOperationScheduler';
+import type { DispatchEventOptions, EventDefinition } from '../types';
 import { ForkFlowModel } from './forkFlowModel';
+import type { MenuProps } from 'antd';
+type BaseMenuItem = NonNullable<MenuProps['items']>[number];
+type MenuLeafItem = Exclude<BaseMenuItem, {
+    children: MenuProps['items'];
+}>;
+export type FlowModelExtraMenuItem = Omit<MenuLeafItem, 'key'> & {
+    key: React.Key;
+    group?: string;
+    sort?: number;
+    onClick?: () => void;
+};
+type FlowModelExtraMenuItemInput = Omit<FlowModelExtraMenuItem, 'key'> & {
+    key?: React.Key;
+};
+type ExtraMenuItemEntry = {
+    group?: string;
+    sort?: number;
+    matcher?: (model: FlowModel) => boolean;
+    keyPrefix?: string;
+    items: FlowModelExtraMenuItemInput[] | ((model: FlowModel, t: (k: string, opt?: any) => string) => FlowModelExtraMenuItemInput[] | Promise<FlowModelExtraMenuItemInput[]>);
+};
 export declare enum ModelRenderMode {
     ReactElement = "reactElement",
     RenderFunction = "renderFunction"
@@ -27,7 +49,7 @@ export declare enum ModelRenderMode {
 export declare class FlowModel<Structure extends DefaultStructure = DefaultStructure> {
     #private;
     /**
-     * 当 flowSettings.enabled 且 model.hidden 为 true 时用于渲染设置态组件（实例方法，子类可覆盖）。
+     * 当 flowSettingsEnabled 且 model.hidden 为 true 时用于渲染设置态组件（实例方法，子类可覆盖）。
      * 基类默认仅返回一个透明度降低的占位元素
      */
     protected renderHiddenInConfig(): React.ReactNode | undefined;
@@ -41,7 +63,10 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
     subModels: Structure['subModels'];
     private _options;
     protected _title: string;
+    protected _extraTitle: string;
     isNew: boolean;
+    skeleton: any;
+    forbidden: any;
     /**
      * 所有 fork 实例的引用集合。
      * 使用 Set 便于在销毁时主动遍历并调用 dispose，避免悬挂引用。
@@ -61,6 +86,7 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
      * 原始 render 方法的引用
      */
     private _originalRender;
+    protected renderOriginal(): React.ReactNode;
     /**
      * 缓存的响应式包装器组件（每个实例一个）
      */
@@ -90,10 +116,16 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
     get subType(): "object" | "array";
     get reactView(): import("../ReactView").ReactView;
     get parentId(): string;
+    scheduleModelOperation(toUid: string, fn: (model: FlowModel) => Promise<void> | void, options?: ScheduleOptions): import("../scheduler/ModelOperationScheduler").ScheduledCancel;
     static get meta(): FlowModelMeta;
     static get globalFlowRegistry(): GlobalFlowRegistry;
     protected static get actionRegistry(): ModelActionRegistry;
     protected static get eventRegistry(): ModelEventRegistry;
+    /**
+     * 动态解析实际要实例化的模型类；可在子类中覆盖。
+     * 返回注册名或构造器，支持在 FlowEngine 中继续沿链解析。
+     */
+    static resolveUse?(options: CreateModelOptions, engine: FlowEngine, parent?: FlowModel): ResolveUseResult | void;
     /**
      * 注册仅当前 FlowModel 类及其子类可用的 Action。
      * 该注册是类级别的，不会影响全局（FlowEngine）的 Action 注册。
@@ -112,9 +144,11 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
      * 批量注册仅当前 FlowModel 类及其子类可用的 Events。
      */
     static registerEvents<TModel extends FlowModel = FlowModel>(events: Record<string, EventDefinition<TModel>>): void;
-    static buildChildrenFromModels(ctx: any, Models: Array<any>): import("..").SubModelItem[];
+    static buildChildrenFromModels(ctx: any, Models: Array<any>): Promise<import("..").SubModelItem[]>;
     get title(): any;
+    get extraTitle(): any;
     setTitle(value: string): void;
+    setExtraTitle(value: string): void;
     setHidden(value: boolean): void;
     _createSubModels(subModels: Record<string, CreateSubModelOptions | CreateSubModelOptions[]>): void;
     /**
@@ -333,6 +367,10 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
      * @returns A promise that resolves when the flow settings dialog is opened
      */
     openFlowSettings(options?: Omit<FlowSettingsOpenOptions, 'model'>): Promise<boolean>;
+    /** 注册设置菜单的额外项（静态，按类缓存，可继承合并） */
+    static registerExtraMenuItems(opts: ExtraMenuItemEntry | ((model: FlowModel, t: (k: string, opt?: any) => string) => FlowModelExtraMenuItemInput[] | Promise<FlowModelExtraMenuItemInput[]>)): () => void;
+    static getExtraMenuItems(model: FlowModel, t: (k: string, opt?: any) => string): Promise<FlowModelExtraMenuItem[]>;
+    refresh(): Promise<void>;
 }
 export declare class ErrorFlowModel extends FlowModel {
     errorMessage: string;
@@ -340,3 +378,4 @@ export declare class ErrorFlowModel extends FlowModel {
     render(): React.JSX.Element;
 }
 export declare function defineFlow<TModel extends FlowModel = FlowModel>(definition: FlowDefinitionOptions): FlowDefinitionOptions<TModel>;
+export {};

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");
@@ -69,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";
@@ -91,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，避免悬挂引用。
@@ -120,10 +124,11 @@ const _FlowModel = class _FlowModel {
     __publicField(this, "flowRegistry");
     __publicField(this, "_cleanRun");
     __publicField(this, "_dispatchEventWithDebounce", import_lodash.default.debounce(
-      async (eventName, inputArgs, options) => {
+      async function(eventName, inputArgs, options) {
         return this._dispatchEvent(eventName, inputArgs, options);
       },
-      100
+      500,
+      { leading: true }
     ));
     /**
      * 重新执行上一次的 beforeRender，保持参数一致
@@ -158,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,
@@ -193,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();
+  }
   /**
    * 对外暴露的上下文：
    */
@@ -237,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);
   }
@@ -311,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;
   }
@@ -527,14 +549,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") {
@@ -567,6 +590,7 @@ const _FlowModel = class _FlowModel {
         }
       }
     }
+    this.emitter.emit("onStepParamsChanged");
   }
   getStepParams(flowKey, stepKey) {
     var _a;
@@ -606,7 +630,7 @@ const _FlowModel = class _FlowModel {
   }
   async dispatchEvent(eventName, inputArgs, options) {
     const isBeforeRender = eventName === "beforeRender";
-    const defaults = isBeforeRender ? { sequential: true, useCache: true } : {};
+    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
@@ -692,11 +716,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;
@@ -708,8 +732,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;
@@ -718,21 +742,31 @@ 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);
@@ -812,7 +846,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) {
@@ -839,10 +873,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) {
@@ -863,6 +903,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) {
@@ -934,7 +980,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);
@@ -1053,7 +1099,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) {
@@ -1068,8 +1115,7 @@ 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;
   }
@@ -1084,6 +1130,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

package/lib/models/forkFlowModel.d.ts

@@ -31,7 +31,7 @@ export declare class ForkFlowModel<TMaster extends FlowModel = FlowModel> {
     /** 是否已被释放 */
     private disposed;
     /** fork 在 master.forks 中的索引 */
-    readonly forkId: number;
+    readonly forkId: string;
     /** 需要与 master 共享的属性列表 */
     private static readonly SHARED_PROPERTIES;
     /**
@@ -48,7 +48,7 @@ export declare class ForkFlowModel<TMaster extends FlowModel = FlowModel> {
      * 注意：此属性通过 Proxy 在 get/set 陷阱中被动态访问，IDE 可能无法检测到使用, 切勿删除！
      */
     private localProperties;
-    constructor(master: TMaster, initialProps?: IModelComponentProps, forkId?: number);
+    constructor(master: TMaster, initialProps?: IModelComponentProps, forkId?: string);
     get context(): FlowModelContext;
     /**
      * 获取对象及其原型链上的属性描述符
@@ -58,6 +58,10 @@ export declare class ForkFlowModel<TMaster extends FlowModel = FlowModel> {
      * 修改局部 props，仅影响当前 fork
      */
     setProps(key: string | IModelComponentProps, value?: any): void;
+    /**
+     * 清理局部 props，仅影响当前 fork
+     */
+    clearProps(): {};
     /**
      * render 依旧使用 master 的方法，但合并后的 props 需要透传
      */

package/lib/models/forkFlowModel.js

@@ -38,9 +38,10 @@ __export(forkFlowModel_exports, {
 module.exports = __toCommonJS(forkFlowModel_exports);
 var import_reactive = require("@formily/reactive");
 var import_flowContext = require("../flowContext");
+var import_secure = require("uid/secure");
 var _flowContext;
 const _ForkFlowModel = class _ForkFlowModel {
-  constructor(master, initialProps = {}, forkId = 0) {
+  constructor(master, initialProps = {}, forkId) {
     /** 与 master 相同的 UID，用于日志调试 */
     __publicField(this, "uid");
     /** 调试标识，便于在日志或断言中快速识别 */
@@ -64,7 +65,7 @@ const _ForkFlowModel = class _ForkFlowModel {
     this.master = master;
     this.uid = master.uid;
     this.localProps = { ...initialProps };
-    this.forkId = forkId;
+    this.forkId = forkId || (0, import_secure.uid)();
     this.hidden = this.master.hidden;
     (0, import_reactive.define)(this, {
       localProps: import_reactive.observable,
@@ -178,6 +179,12 @@ const _ForkFlowModel = class _ForkFlowModel {
       this.localProps = { ...this.localProps, ...key };
     }
   }
+  /**
+   * 清理局部 props，仅影响当前 fork
+   */
+  clearProps() {
+    return this.localProps = {};
+  }
   /**
    * render 依旧使用 master 的方法，但合并后的 props 需要透传
    */

package/lib/provider.d.ts

@@ -17,6 +17,8 @@ export declare const FlowEngineProvider: React.FC<FlowEngineProviderProps>;
 export declare const FlowEngineGlobalsContextProvider: React.FC<{
     children: React.ReactNode;
 }>;
-export declare const useFlowEngine: () => FlowEngine;
+export declare const useFlowEngine: ({ throwError }?: {
+    throwError?: boolean;
+}) => FlowEngine;
 export declare const useFlowEngineContext: () => FlowEngineContext;
 export {};

package/lib/provider.js

@@ -58,6 +58,7 @@ const FlowEngineProvider = import_react.default.memo((props) => {
 });
 FlowEngineProvider.displayName = "FlowEngineProvider";
 const FlowEngineGlobalsContextProvider = /* @__PURE__ */ __name(({ children }) => {
+  var _a;
   const { modal, message, notification } = import_antd.App.useApp();
   const [drawer, contextHolder] = (0, import_views.useDrawer)();
   const [embed, pageContextHolder] = (0, import_views.usePage)();
@@ -91,11 +92,11 @@ const FlowEngineGlobalsContextProvider = /* @__PURE__ */ __name(({ children }) =
     }
     engine.reactView.refresh();
   }, [engine, drawer, modal, message, notification, config, popover, token, dialog, embed]);
-  return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, children, contextHolder, popoverContextHolder, pageContextHolder, dialogContextHolder);
+  return /* @__PURE__ */ import_react.default.createElement(import_antd.ConfigProvider, { ...config, locale: (_a = engine.context.locales) == null ? void 0 : _a.antd, popupMatchSelectWidth: false }, children, contextHolder, popoverContextHolder, pageContextHolder, dialogContextHolder);
 }, "FlowEngineGlobalsContextProvider");
-const useFlowEngine = /* @__PURE__ */ __name(() => {
+const useFlowEngine = /* @__PURE__ */ __name(({ throwError = true } = {}) => {
   const context = (0, import_react.useContext)(FlowEngineReactContext);
-  if (!context) {
+  if (!context && throwError) {
     throw new Error(
       "useFlowEngine must be used within a FlowEngineProvider, and FlowEngineProvider must be supplied with an engine."
     );

package/lib/reactive/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+export * from '@formily/reactive';
+export { observer, getPageActive } from './observer';

package/lib/reactive/index.js

@@ -0,0 +1,41 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var reactive_exports = {};
+__export(reactive_exports, {
+  getPageActive: () => import_observer.getPageActive,
+  observer: () => import_observer.observer
+});
+module.exports = __toCommonJS(reactive_exports);
+__reExport(reactive_exports, require("@formily/reactive"), module.exports);
+var import_observer = require("./observer");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getPageActive,
+  observer,
+  ...require("@formily/reactive")
+});

package/lib/reactive/observer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { IObserverOptions, ReactFC } from '@formily/reactive-react';
+import React from 'react';
+import { FlowEngineContext } from '..';
+type ObserverComponentProps<P, Options extends IObserverOptions> = Options extends {
+    forwardRef: true;
+} ? P & {
+    ref?: 'ref' extends keyof P ? P['ref'] : React.RefAttributes<any>;
+} : React.PropsWithoutRef<P>;
+export declare const observer: <P, Options extends IObserverOptions = IObserverOptions>(Component: ReactFC<P>, options?: Options) => React.MemoExoticComponent<ReactFC<ObserverComponentProps<P, Options>>>;
+export declare function getPageActive(context: FlowEngineContext): boolean | undefined;
+export {};