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

package/lib/flowEngine.js

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

package/lib/flowSettings.d.ts

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

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;
@@ -483,6 +485,10 @@ const _FlowSettings = class _FlowSettings {
         const flowRuntimeContext = new import_flowContext.FlowRuntimeContext(model, fk, "settings");
         (0, import_utils.setupRuntimeContextSteps)(flowRuntimeContext, flow.steps, model, fk);
         flowRuntimeContext.defineProperty("currentStep", { value: step });
+        flowRuntimeContext.defineMethod("getStepFormValues", (flowKey2, stepKey2) => {
+          var _a2;
+          return (_a2 = forms.get(keyOf({ flowKey: flowKey2, stepKey: stepKey2 }))) == null ? void 0 : _a2.values;
+        });
         const modelStepParams = model.getStepParams(fk, sk) || {};
         const resolvedDefaultParams = await (0, import_utils.resolveDefaultParams)(step.defaultParams, flowRuntimeContext);
         const resolvedActionDefaults = await (0, import_utils.resolveDefaultParams)(actionDefaultParams, flowRuntimeContext);
@@ -509,7 +515,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 +527,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 +541,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 +608,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,14 +40,18 @@ 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() {
+  const { t } = (0, import_react_i18next.useTranslation)();
   return /* @__PURE__ */ import_react.default.createElement(import_antd.Form.Item, null, /* @__PURE__ */ import_react.default.createElement(
     import_antd.Card,
     {
@@ -58,13 +62,46 @@ function FieldPlaceholder() {
         }
       }
     },
-    "\u8BE5\u5B57\u6BB5\u5DF2\u88AB\u9690\u85CF\uFF0C\u4F60\u65E0\u6CD5\u67E5\u770B\uFF08\u8BE5\u5185\u5BB9\u4EC5\u5728\u6FC0\u6D3B UI Editor \u65F6\u663E\u793A\uFF09\u3002"
+    t(
+      "This field has been hidden and you cannot view it (this content is only visible when the UI Editor is activated)."
+    )
   ));
 }
 __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 +123,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 +146,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 +162,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 +283,6 @@ CollectionFieldModel.registerFlow({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CollectionFieldModel,
+  FieldDeletePlaceholder,
   FieldPlaceholder
 });