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

package/lib/flowSettings.js

@@ -152,7 +152,7 @@ const _FlowSettings = class _FlowSettings {
         TreeSelect,
         Upload
       } = await import("@formily/antd-v5");
-      const { Button: Button2 } = await import("antd");
+      const { Button: Button2, Alert } = await import("antd");
       this.components.Form = Form;
       this.components.FormDialog = FormDialog;
       this.components.FormDrawer = FormDrawer;
@@ -186,6 +186,7 @@ const _FlowSettings = class _FlowSettings {
       this.components.Space = Space2;
       this.components.Editable = Editable;
       this.components.PreviewText = PreviewText;
+      this.components.Alert = Alert;
       this.components.Button = Button2;
       this.components.Submit = Submit;
       this.components.Reset = Reset;
@@ -376,7 +377,8 @@ const _FlowSettings = class _FlowSettings {
     initialValues,
     flowEngine,
     form,
-    onFormValuesChange: onFormValuesChange2
+    onFormValuesChange: onFormValuesChange2,
+    key
   }) {
     var _a, _b;
     const scopes = {
@@ -399,7 +401,7 @@ const _FlowSettings = class _FlowSettings {
     const SchemaField = (0, import_react.createSchemaField)();
     return import_react2.default.createElement(
       FormProviderWithForm,
-      { form, initialValues, onFormValuesChange: onFormValuesChange2 },
+      { form, initialValues, onFormValuesChange: onFormValuesChange2, key },
       import_react2.default.createElement(SchemaField, {
         schema: compiledSchema,
         components: ((_b = flowEngine == null ? void 0 : flowEngine.flowSettings) == null ? void 0 : _b.components) || {},
@@ -436,7 +438,7 @@ const _FlowSettings = class _FlowSettings {
    * @returns {Promise<boolean>} 是否成功打开弹窗
    */
   async open(options) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e;
     __privateGet(this, _emitter).emit("beforeOpen", options);
     const { model, flowKey, flowKeys, stepKey, uiMode = "dialog", preset, onCancel, onSaved } = options;
     if (!model) {
@@ -471,7 +473,7 @@ const _FlowSettings = class _FlowSettings {
         let actionDefaultParams = {};
         let uiMode2;
         if (step.use) {
-          const action = (_c = (_b = model.flowEngine) == null ? void 0 : _b.getAction) == null ? void 0 : _c.call(_b, step.use);
+          const action = (_b = model.getAction) == null ? void 0 : _b.call(model, step.use);
           if (action) {
             actionDefaultParams = action.defaultParams || {};
             stepTitle = stepTitle || action.title;
@@ -509,7 +511,7 @@ const _FlowSettings = class _FlowSettings {
     }
     if (entries.length === 0) {
       if (!preset) {
-        (_d = message == null ? void 0 : message.info) == null ? void 0 : _d.call(message, t("This model has no configurable flow settings"));
+        (_c = message == null ? void 0 : message.info) == null ? void 0 : _c.call(message, t("This model has no configurable flow settings"));
       }
       return false;
     }
@@ -521,7 +523,7 @@ const _FlowSettings = class _FlowSettings {
     const scopes = {
       // 为 schema 表达式提供上下文能力（可在表达式中使用 useFlowSettingsContext 等）
       useFlowSettingsContext: import_useFlowSettingsContext.useFlowSettingsContext,
-      ...((_e = flowEngine == null ? void 0 : flowEngine.flowSettings) == null ? void 0 : _e.scopes) || {}
+      ...((_d = flowEngine == null ? void 0 : flowEngine.flowSettings) == null ? void 0 : _d.scopes) || {}
     };
     let modeProps = typeof resolvedUiMode === "object" && resolvedUiMode ? resolvedUiMode.props || {} : {};
     if (modeType === "embed") {
@@ -535,7 +537,7 @@ const _FlowSettings = class _FlowSettings {
         target,
         styles: {
           body: {
-            padding: (_f = flowEngine.context.themeToken) == null ? void 0 : _f.padding
+            padding: (_e = flowEngine.context.themeToken) == null ? void 0 : _e.padding
           }
         },
         ...modeProps,
@@ -602,6 +604,8 @@ const _FlowSettings = class _FlowSettings {
       zIndex: 5e3,
       // 允许透传其它 props（如 maskClosable、footer 等），但确保 content 由我们接管
       ...modeProps,
+      // 统一构造 settings 弹窗的 inputArgs（集合/记录/父导航/关联）
+      inputArgs: (0, import_utils.buildSettingsViewInputArgs)(model, modeProps == null ? void 0 : modeProps.inputArgs),
       content: /* @__PURE__ */ __name((currentView, viewCtx) => {
         viewCtx == null ? void 0 : viewCtx.defineMethod("getStepFormValues", (flowKey2, stepKey2) => {
           var _a2;

package/lib/hooks/useApplyAutoFlows.js

@@ -44,7 +44,8 @@ function useApplyAutoFlows(modelOrUid, inputArgs, options) {
   model == null ? void 0 : model.useHooksBeforeRender();
   const { loading, error } = (0, import_ahooks.useRequest)(
     async () => {
-      await model.applyAutoFlows(inputArgs);
+      if (!model) return;
+      await model.dispatchEvent("beforeRender", inputArgs);
     },
     {
       refreshDeps: [model, inputArgs]

package/lib/index.d.ts

@@ -8,6 +8,7 @@
  */
 export * from './types';
 export * from './utils';
+export { compileRunJs } from './utils/jsxTransform';
 export * from './resources';
 export * from './flowEngine';
 export * from './hooks';
@@ -22,6 +23,11 @@ export * from './ElementProxy';
 export * from './flowContext';
 export * from './FlowContextProvider';
 export * from './JSRunner';
-export * from './runjs-context';
+export { getRunJSDocFor, createJSRunnerWithVersion, getRunJSScenesForModel, getRunJSScenesForContext, } from './runjs-context/helpers';
+export { RunJSContextRegistry, getModelClassName } from './runjs-context/registry';
+export { setupRunJSContexts } from './runjs-context/setup';
+export { getSnippetBody, listSnippetsForContext } from './runjs-context/snippets';
 export * from './views';
 export * from './FlowDefinition';
+export { createViewScopedEngine } from './ViewScopedFlowEngine';
+export { createBlockScopedEngine } from './BlockScopedFlowEngine';

package/lib/index.js

@@ -27,11 +27,24 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var src_exports = {};
 __export(src_exports, {
-  observer: () => import_reactive_react.observer
+  RunJSContextRegistry: () => import_registry.RunJSContextRegistry,
+  compileRunJs: () => import_jsxTransform.compileRunJs,
+  createBlockScopedEngine: () => import_BlockScopedFlowEngine.createBlockScopedEngine,
+  createJSRunnerWithVersion: () => import_helpers.createJSRunnerWithVersion,
+  createViewScopedEngine: () => import_ViewScopedFlowEngine.createViewScopedEngine,
+  getModelClassName: () => import_registry.getModelClassName,
+  getRunJSDocFor: () => import_helpers.getRunJSDocFor,
+  getRunJSScenesForContext: () => import_helpers.getRunJSScenesForContext,
+  getRunJSScenesForModel: () => import_helpers.getRunJSScenesForModel,
+  getSnippetBody: () => import_snippets.getSnippetBody,
+  listSnippetsForContext: () => import_snippets.listSnippetsForContext,
+  observer: () => import_reactive_react.observer,
+  setupRunJSContexts: () => import_setup.setupRunJSContexts
 });
 module.exports = __toCommonJS(src_exports);
 __reExport(src_exports, require("./types"), module.exports);
 __reExport(src_exports, require("./utils"), module.exports);
+var import_jsxTransform = require("./utils/jsxTransform");
 __reExport(src_exports, require("./resources"), module.exports);
 __reExport(src_exports, require("./flowEngine"), module.exports);
 __reExport(src_exports, require("./hooks"), module.exports);
@@ -46,12 +59,29 @@ __reExport(src_exports, require("./ElementProxy"), module.exports);
 __reExport(src_exports, require("./flowContext"), module.exports);
 __reExport(src_exports, require("./FlowContextProvider"), module.exports);
 __reExport(src_exports, require("./JSRunner"), module.exports);
-__reExport(src_exports, require("./runjs-context"), module.exports);
+var import_helpers = require("./runjs-context/helpers");
+var import_registry = require("./runjs-context/registry");
+var import_setup = require("./runjs-context/setup");
+var import_snippets = require("./runjs-context/snippets");
 __reExport(src_exports, require("./views"), module.exports);
 __reExport(src_exports, require("./FlowDefinition"), module.exports);
+var import_ViewScopedFlowEngine = require("./ViewScopedFlowEngine");
+var import_BlockScopedFlowEngine = require("./BlockScopedFlowEngine");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  RunJSContextRegistry,
+  compileRunJs,
+  createBlockScopedEngine,
+  createJSRunnerWithVersion,
+  createViewScopedEngine,
+  getModelClassName,
+  getRunJSDocFor,
+  getRunJSScenesForContext,
+  getRunJSScenesForModel,
+  getSnippetBody,
+  listSnippetsForContext,
   observer,
+  setupRunJSContexts,
   ...require("./types"),
   ...require("./utils"),
   ...require("./resources"),
@@ -67,7 +97,6 @@ __reExport(src_exports, require("./FlowDefinition"), module.exports);
   ...require("./flowContext"),
   ...require("./FlowContextProvider"),
   ...require("./JSRunner"),
-  ...require("./runjs-context"),
   ...require("./views"),
   ...require("./FlowDefinition")
 });

package/lib/locale/en-US.json

@@ -23,6 +23,7 @@
   "UID copied to clipboard": "UID copied to clipboard",
   "Copy failed": "Copy failed",
   "Copy failed, please copy [{{uid}}] manually.": "Copy failed, please copy [{{uid}}] manually.",
+  "Copy failed under HTTP. Clipboard API is unavailable on non-HTTPS pages. Please copy [{{uid}}] manually.": "Copy failed under HTTP. Clipboard API is unavailable on non-HTTPS pages. Please copy [{{uid}}] manually.",
   "Confirm delete": "Confirm delete",
   "Are you sure you want to delete this item? This action cannot be undone.": "Are you sure you want to delete this item? This action cannot be undone.",
   "Delete operation failed": "Delete operation failed",
@@ -57,5 +58,6 @@
   "Name": "Name",
   "Model with ID {{uid}} not found": "Model with ID {{uid}} not found",
   "Common actions": "Common actions",
-  "This variable is not available": "This variable is not available"
-}
+  "This variable is not available": "This variable is not available",
+  "Copy popup UID": "Copy popup UID"
+}

package/lib/locale/index.d.ts

@@ -32,6 +32,7 @@ export declare const locales: {
         "UID copied to clipboard": string;
         "Copy failed": string;
         "Copy failed, please copy [{{uid}}] manually.": string;
+        "Copy failed under HTTP. Clipboard API is unavailable on non-HTTPS pages. Please copy [{{uid}}] manually.": string;
         "Confirm delete": string;
         "Are you sure you want to delete this item? This action cannot be undone.": string;
         "Delete operation failed": string;
@@ -67,6 +68,7 @@ export declare const locales: {
         "Model with ID {{uid}} not found": string;
         "Common actions": string;
         "This variable is not available": string;
+        "Copy popup UID": string;
     };
     'zh-CN': {
         "Invalid model provided": string;
@@ -93,6 +95,7 @@ export declare const locales: {
         "UID copied to clipboard": string;
         "Copy failed": string;
         "Copy failed, please copy [{{uid}}] manually.": string;
+        "Copy failed under HTTP. Clipboard API is unavailable on non-HTTPS pages. Please copy [{{uid}}] manually.": string;
         "Confirm delete": string;
         "Are you sure you want to delete this item? This action cannot be undone.": string;
         "Delete operation failed": string;
@@ -128,6 +131,7 @@ export declare const locales: {
         "Model with ID {{uid}} not found": string;
         "Common actions": string;
         "This variable is not available": string;
+        "Copy popup UID": string;
     };
 };
 /**

package/lib/locale/zh-CN.json

@@ -23,6 +23,7 @@
   "UID copied to clipboard": "UID 已复制到剪贴板",
   "Copy failed": "复制失败",
   "Copy failed, please copy [{{uid}}] manually.": "复制失败，请手动复制 [{{uid}}]。",
+  "Copy failed under HTTP. Clipboard API is unavailable on non-HTTPS pages. Please copy [{{uid}}] manually.": "HTTP 环境下复制失败。非 HTTPS 页面不支持剪贴板 API，请手动复制 [{{uid}}]。",
   "Confirm delete": "确认删除",
   "Are you sure you want to delete this item? This action cannot be undone.": "确定要删除此项吗？此操作不可撤销。",
   "Delete operation failed": "删除操作失败",
@@ -57,5 +58,6 @@
   "Name": "名称",
   "Model with ID {{uid}} not found": "未找到 ID 为 {{uid}} 的模型",
   "Common actions": "通用操作",
-  "This variable is not available": "此变量不可用"
-}
+  "This variable is not available": "此变量不可用",
+  "Copy popup UID": "复制弹窗 UID"
+}

package/lib/models/CollectionFieldModel.d.ts

@@ -12,6 +12,7 @@ import { FlowEngineContext } from '../flowContext';
 import { DefaultStructure } from '../types';
 import { FlowModel } from './flowModel';
 export declare function FieldPlaceholder(): React.JSX.Element;
+export declare function FieldDeletePlaceholder(): React.JSX.Element;
 export interface FieldSettingsInitParams {
     dataSourceKey: string;
     collectionName: string;
@@ -26,6 +27,7 @@ export interface BindingOptions {
 }
 export declare class CollectionFieldModel<T extends DefaultStructure = DefaultStructure> extends FlowModel<T> {
     private static _bindings;
+    fieldDeleted: boolean;
     renderHiddenInConfig(): React.ReactNode | undefined;
     get title(): any;
     onInit(options: any): void;
@@ -38,6 +40,7 @@ export declare class CollectionFieldModel<T extends DefaultStructure = DefaultSt
     static getDefaultBindingByField(ctx: FlowEngineContext, collectionField: CollectionField, options?: {
         useStrict?: boolean;
         fallbackToTargetTitleField?: boolean;
+        targetCollectionTitleField?: CollectionField;
     }): BindingOptions | null;
     static bindModelToInterface(modelName: string, interfaceName: string | string[], options?: {
         isDefault?: boolean;

package/lib/models/CollectionFieldModel.js

@@ -40,11 +40,14 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 var CollectionFieldModel_exports = {};
 __export(CollectionFieldModel_exports, {
   CollectionFieldModel: () => CollectionFieldModel,
+  FieldDeletePlaceholder: () => FieldDeletePlaceholder,
   FieldPlaceholder: () => FieldPlaceholder
 });
 module.exports = __toCommonJS(CollectionFieldModel_exports);
 var import_antd = require("antd");
 var import_react = __toESM(require("react"));
+var import_react_i18next = require("react-i18next");
+var import_hooks = require("../hooks");
 var import_utils = require("../utils");
 var import_flowModel = require("./flowModel");
 function FieldPlaceholder() {
@@ -62,9 +65,40 @@ function FieldPlaceholder() {
   ));
 }
 __name(FieldPlaceholder, "FieldPlaceholder");
+function FieldDeletePlaceholder() {
+  const { t } = (0, import_react_i18next.useTranslation)();
+  const model = (0, import_hooks.useFlowModel)();
+  const blockModel = model.context.blockModel;
+  const dataSource = blockModel.collection.dataSource;
+  const collection = blockModel.collection;
+  const name = model.fieldPath;
+  const nameValue = (0, import_react.useMemo)(() => {
+    const dataSourcePrefix = `${t(dataSource.displayName || dataSource.key)} > `;
+    const collectionPrefix = collection ? `${t(collection.title) || collection.name || collection.tableName} > ` : "";
+    return `${dataSourcePrefix}${collectionPrefix}${name}`;
+  }, []);
+  return /* @__PURE__ */ import_react.default.createElement(import_antd.Form.Item, null, /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      style: {
+        color: "rgba(0,0,0,0.45)"
+      }
+    },
+    t(`The {{type}} "{{name}}" may have been deleted. Please remove this {{blockType}}.`, {
+      type: t("Field"),
+      name: nameValue,
+      blockType: t("Field")
+    }).replaceAll(">", ">")
+  ));
+}
+__name(FieldDeletePlaceholder, "FieldDeletePlaceholder");
 const defaultWhen = /* @__PURE__ */ __name(() => true, "defaultWhen");
 const _CollectionFieldModel = class _CollectionFieldModel extends import_flowModel.FlowModel {
+  fieldDeleted = false;
   renderHiddenInConfig() {
+    if (this.fieldDeleted) {
+      return /* @__PURE__ */ import_react.default.createElement(FieldDeletePlaceholder, null);
+    }
     return /* @__PURE__ */ import_react.default.createElement(FieldPlaceholder, null);
   }
   get title() {
@@ -86,11 +120,13 @@ const _CollectionFieldModel = class _CollectionFieldModel extends import_flowMod
         return this.fieldPath;
       }, "get")
     });
-    this.context.blockModel.addAppends(this.fieldPath);
-    this.context.blockModel.addAppends(this.associationPathName);
+    if (this.context.blockModel) {
+      this.context.blockModel.addAppends(this.fieldPath);
+      this.context.blockModel.addAppends(this.associationPathName);
+    }
   }
   getFieldSettingsInitParams() {
-    return this.getStepParams("fieldSettings", "init");
+    return this.getStepParams("fieldSettings", "init") || {};
   }
   get fieldPath() {
     return this.getFieldSettingsInitParams().fieldPath;
@@ -107,6 +143,9 @@ const _CollectionFieldModel = class _CollectionFieldModel extends import_flowMod
     }
   }
   static getBindingsByField(ctx, collectionField) {
+    if (!collectionField) {
+      return;
+    }
     const interfaceName = collectionField.interface;
     if (!this.bindings.has(interfaceName)) {
       return [];
@@ -120,8 +159,11 @@ const _CollectionFieldModel = class _CollectionFieldModel extends import_flowMod
     if (options.fallbackToTargetTitleField) {
       const binding = this.getDefaultBindingByField(ctx, collectionField, { useStrict: true });
       if (!binding) {
-        if (collectionField.isAssociationField() && collectionField.targetCollectionTitleField) {
-          return this.getDefaultBindingByField(ctx, collectionField.targetCollectionTitleField);
+        if (collectionField.isAssociationField() && (options == null ? void 0 : options.targetCollectionTitleField) || collectionField.targetCollectionTitleField) {
+          return this.getDefaultBindingByField(
+            ctx,
+            (options == null ? void 0 : options.targetCollectionTitleField) || collectionField.targetCollectionTitleField
+          );
         }
       }
       return binding;
@@ -238,5 +280,6 @@ CollectionFieldModel.registerFlow({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CollectionFieldModel,
+  FieldDeletePlaceholder,
   FieldPlaceholder
 });

package/lib/models/flowModel.d.ts

@@ -18,8 +18,9 @@ import { ModelEventRegistry } from '../event-registry/ModelEventRegistry';
 import { GlobalFlowRegistry } from '../flow-registry/GlobalFlowRegistry';
 import { FlowDefinition } from '../FlowDefinition';
 import { FlowSettingsOpenOptions } from '../flowSettings';
-import type { EventDefinition } from '../types';
+import type { EventDefinition, DispatchEventOptions } from '../types';
 import { ForkFlowModel } from './forkFlowModel';
+import type { ScheduleOptions } from '../scheduler/ModelOperationScheduler';
 export declare enum ModelRenderMode {
     ReactElement = "reactElement",
     RenderFunction = "renderFunction"
@@ -42,6 +43,7 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
     private _options;
     protected _title: string;
     isNew: boolean;
+    skeleton: any;
     /**
      * 所有 fork 实例的引用集合。
      * 使用 Set 便于在销毁时主动遍历并调用 dispose，避免悬挂引用。
@@ -53,7 +55,7 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
      */
     private forkCache;
     /**
-     * 上一次 applyAutoFlows 的执行参数
+     * 上一次 beforeRender 的执行参数
      */
     private _lastAutoRunParams;
     protected observerDispose: () => void;
@@ -90,6 +92,7 @@ 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;
@@ -117,7 +120,11 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
     setTitle(value: string): void;
     setHidden(value: boolean): void;
     _createSubModels(subModels: Record<string, CreateSubModelOptions | CreateSubModelOptions[]>): void;
-    invalidateAutoFlowCache(deep?: boolean): void;
+    /**
+     * 失效指定事件的流程缓存；未指定 eventName 时，失效当前模型全部事件缓存。
+     * - 默认 beforeRender 与其它事件共享同一缓存体系：prefix=`event:${scope}`，flowKey=`eventName`，uid=`model.uid`
+     */
+    invalidateFlowCache(eventName?: string, deep?: boolean): void;
     /**
      * 设置FlowEngine实例
      * @param {FlowEngine} flowEngine FlowEngine实例
@@ -187,45 +194,36 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
     private _dispatchEvent;
     private _dispatchEventWithDebounce;
     dispatchEvent(eventName: string, inputArgs?: Record<string, any>, options?: {
-        /**
-         * 是否要开启防抖功能
-         */
-        debounce: boolean;
-    }): Promise<void>;
+        /** 是否要开启防抖功能 */
+        debounce?: boolean;
+    } & DispatchEventOptions): Promise<any[]>;
     /**
-     * 获取所有自动应用流程定义（保持 getFlows 的顺序，即按 sort 排序）
-     * @returns {FlowDefinition[]} 自动应用流程定义数组（已按 sort 排序）
+     * 按事件名获取对应的流程集合（保持 getFlows 的顺序，即按 sort 排序）。
+     * - beforeRender 兼容：除显式 on: 'beforeRender' 外，包含未声明 on 且 manual !== true 的流程。
      */
-    getAutoFlows(): FlowDefinition[];
+    getEventFlows(eventName: string): FlowDefinition[];
     /**
-     * 重新执行上一次的 applyAutoFlows，保持参数一致
+     * 重新执行上一次的 beforeRender，保持参数一致
      * 如果之前没有执行过，则直接跳过
      * 使用 lodash debounce 避免频繁调用
      */
     private _rerunLastAutoRun;
     /**
-     * 自动流程执行前钩子。
-     * 子类可覆盖；可抛出 FlowExitException 提前终止。
+     * 通用事件分发钩子：开始
+     * 子类可覆盖；beforeRender 事件可通过抛出 FlowExitException 提前终止。
      */
-    onBeforeAutoFlows(inputArgs?: Record<string, any>): Promise<void>;
+    onDispatchEventStart(eventName: string, options?: DispatchEventOptions, inputArgs?: Record<string, any>): Promise<void>;
     /**
-     * 自动流程执行后钩子。
+     * 通用事件分发钩子：结束
      * 子类可覆盖。
      */
-    onAfterAutoFlows(results: any[], inputArgs?: Record<string, any>): Promise<void>;
+    onDispatchEventEnd(eventName: string, options?: DispatchEventOptions, inputArgs?: Record<string, any>, results?: any[]): Promise<void>;
     /**
-     * 自动流程错误钩子。
+     * 通用事件分发钩子：错误
      * 子类可覆盖。
      */
-    onAutoFlowsError(error: Error, inputArgs?: Record<string, any>): Promise<void>;
+    onDispatchEventError(eventName: string, options?: DispatchEventOptions, inputArgs?: Record<string, any>, error?: Error): Promise<void>;
     useHooksBeforeRender(): void;
-    /**
-     * 执行所有自动应用流程
-     * @param {Record<string, any>} [inputArgs] 可选的运行时参数
-     * @param {boolean} [useCache=true] 是否使用缓存机制，默认为 true
-     * @returns {Promise<any[]>} 所有自动应用流程的执行结果数组
-     */
-    applyAutoFlows(inputArgs?: Record<string, any>, useCache?: boolean): Promise<any[]>;
     /**
      * 智能检测是否应该跳过响应式包装
      * 说明：
@@ -261,9 +259,9 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
     render(): any;
     rerender(): Promise<void>;
     /**
-     * 自动流程缓存的作用域标识；fork 实例可覆盖以区分缓存。
+     * 事件缓存的作用域标识；可按事件区分（默认与事件无关的 scope 返回 'default'）。
      */
-    getAutoFlowCacheScope(): string;
+    getFlowCacheScope(eventName: string): string;
     setParent(parent: FlowModel): void;
     removeParentDelegate(): void;
     addSubModel<T extends FlowModel>(subKey: string, options: CreateModelOptions | T): T;
@@ -273,7 +271,10 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
     hasSubModel<K extends keyof Structure['subModels']>(subKey: K): boolean;
     findSubModel<K extends keyof Structure['subModels'], R>(subKey: K, callback: (model: ArrayElementType<Structure['subModels'][K]>) => R): ArrayElementType<Structure['subModels'][K]> | null;
     createRootModel(options: any): FlowModel<DefaultStructure>;
-    applySubModelsAutoFlows<K extends keyof Structure['subModels']>(subKey: K, inputArgs?: Record<string, any>, shared?: Record<string, any>): Promise<void>;
+    /**
+     * 对指定子模型派发 beforeRender 事件（顺序执行并使用缓存）。
+     */
+    applySubModelsBeforeRenderFlows<K extends keyof Structure['subModels']>(subKey: K, inputArgs?: Record<string, any>, shared?: Record<string, any>): Promise<void>;
     /**
      * 创建一个 fork 实例，实现"一份数据（master）多视图（fork）"的能力。
      * @param {IModelComponentProps} [localProps={}] fork 专属的局部 props，优先级高于 master.props