@nocobase/flow-engine 2.0.0-alpha.3 → 2.0.0-alpha.30

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;

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 [];
@@ -238,5 +277,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,7 +18,7 @@ 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';
 export declare enum ModelRenderMode {
     ReactElement = "reactElement",
@@ -42,6 +42,7 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
     private _options;
     protected _title: string;
     isNew: boolean;
+    skeleton: any;
     /**
      * 所有 fork 实例的引用集合。
      * 使用 Set 便于在销毁时主动遍历并调用 dispose，避免悬挂引用。
@@ -53,7 +54,7 @@ export declare class FlowModel<Structure extends DefaultStructure = DefaultStruc
      */
     private forkCache;
     /**
-     * 上一次 applyAutoFlows 的执行参数
+     * 上一次 beforeRender 的执行参数
      */
     private _lastAutoRunParams;
     protected observerDispose: () => void;
@@ -117,7 +118,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 +192,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 +257,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 +269,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