@nocobase/flow-engine 2.0.0-alpha.49 → 2.0.0-alpha.50

package/src/locale/tr-TR.json

@@ -0,0 +1,63 @@
+{
+  "Add": "Add",
+  "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.",
+  "Array index out of bounds": "Array index {{index}} out of bounds for '{{subKey}}'",
+  "Cancel": "Cancel",
+  "Common actions": "Common actions",
+  "Complete configuration": "Complete configuration",
+  "Configuration": "Configuration",
+  "Configuration popup cancelled or error": "Configuration popup cancelled or error",
+  "Configuration saved": "Configuration saved",
+  "Confirm delete": "Confirm delete",
+  "Copy UID": "Copy UID",
+  "Copy error info": "Copy error info",
+  "Copy failed": "Copy failed",
+  "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.",
+  "Copy failed, please copy [{{uid}}] manually.": "Copy failed, please copy [{{uid}}] manually.",
+  "Copy popup UID": "Copy popup UID",
+  "Data blocks": "Data blocks",
+  "Delete": "Delete",
+  "Delete failed": "Delete failed",
+  "Delete operation failed": "Delete operation failed",
+  "Delete operation failed, please check the console for details.": "Delete operation failed, please check the console for details.",
+  "Download logs": "Download logs",
+  "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider": "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider",
+  "Error saving configuration": "Error saving configuration",
+  "Error saving configuration, please check console": "Error saving configuration, please check console",
+  "Error submitting form": "Error submitting form",
+  "Expected array for subModel": "Expected array for '{{subKey}}', got {{type}}",
+  "Expected object for subModel": "Expected object for '{{subKey}}', got array",
+  "Failed to add sub model": "Failed to add sub model",
+  "Failed to destroy model after creation error": "Failed to destroy model after creation error",
+  "Failed to get action {{action}}": "Failed to get action {{action}}",
+  "Failed to get configurable flows for model {{model}}": "Failed to get configurable flows for model {{model}}",
+  "Failed to import FormDialog": "Failed to import FormDialog",
+  "Failed to import FormDialog or FormStep": "Failed to import FormDialog or FormStep",
+  "Failed to import Formily components": "Failed to import Formily components",
+  "Feedback": "Feedback",
+  "Filter blocks": "Filter blocks",
+  "Flow with key {{flowKey}} not found": "Flow with key {{flowKey}} not found",
+  "Form validation failed": "Form validation failed",
+  "Invalid input parameters": "Invalid input parameters",
+  "Invalid model provided": "Invalid model provided",
+  "Invalid subModelKey format": "Invalid subModelKey format: {{subModelKey}}",
+  "Model with ID {{uid}} not found": "Model with ID {{uid}} not found",
+  "Name": "Name",
+  "Next step": "Next step",
+  "No createModelOptions found for item": "No createModelOptions found for item",
+  "OK": "OK",
+  "Other blocks": "Other blocks",
+  "Previous step": "Previous step",
+  "Render failed": "Render failed",
+  "Step configuration": "Step configuration",
+  "Step parameter configuration": "Step parameter configuration",
+  "Step with key {{stepKey}} not found": "Step with key {{stepKey}} not found",
+  "Submodel not found": "Submodel '{{subKey}}' not found",
+  "This is likely a NocoBase internals bug. Please open an issue at": "This is likely a NocoBase internals bug. Please open an issue at",
+  "This step has no configurable parameters": "This step has no configurable parameters",
+  "This variable is not available": "This variable is not available",
+  "Try again": "Try again",
+  "UID copied to clipboard": "UID copied to clipboard",
+  "createModelOptions must specify use property": "createModelOptions must specify \"use\" property",
+  "here": "here"
+}

package/src/locale/uk-UA.json

@@ -0,0 +1,63 @@
+{
+  "Add": "Add",
+  "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.",
+  "Array index out of bounds": "Array index {{index}} out of bounds for '{{subKey}}'",
+  "Cancel": "Cancel",
+  "Common actions": "Common actions",
+  "Complete configuration": "Complete configuration",
+  "Configuration": "Configuration",
+  "Configuration popup cancelled or error": "Configuration popup cancelled or error",
+  "Configuration saved": "Configuration saved",
+  "Confirm delete": "Confirm delete",
+  "Copy UID": "Copy UID",
+  "Copy error info": "Copy error info",
+  "Copy failed": "Copy failed",
+  "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.",
+  "Copy failed, please copy [{{uid}}] manually.": "Copy failed, please copy [{{uid}}] manually.",
+  "Copy popup UID": "Copy popup UID",
+  "Data blocks": "Data blocks",
+  "Delete": "Delete",
+  "Delete failed": "Delete failed",
+  "Delete operation failed": "Delete operation failed",
+  "Delete operation failed, please check the console for details.": "Delete operation failed, please check the console for details.",
+  "Download logs": "Download logs",
+  "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider": "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider",
+  "Error saving configuration": "Error saving configuration",
+  "Error saving configuration, please check console": "Error saving configuration, please check console",
+  "Error submitting form": "Error submitting form",
+  "Expected array for subModel": "Expected array for '{{subKey}}', got {{type}}",
+  "Expected object for subModel": "Expected object for '{{subKey}}', got array",
+  "Failed to add sub model": "Failed to add sub model",
+  "Failed to destroy model after creation error": "Failed to destroy model after creation error",
+  "Failed to get action {{action}}": "Failed to get action {{action}}",
+  "Failed to get configurable flows for model {{model}}": "Failed to get configurable flows for model {{model}}",
+  "Failed to import FormDialog": "Failed to import FormDialog",
+  "Failed to import FormDialog or FormStep": "Failed to import FormDialog or FormStep",
+  "Failed to import Formily components": "Failed to import Formily components",
+  "Feedback": "Feedback",
+  "Filter blocks": "Filter blocks",
+  "Flow with key {{flowKey}} not found": "Flow with key {{flowKey}} not found",
+  "Form validation failed": "Form validation failed",
+  "Invalid input parameters": "Invalid input parameters",
+  "Invalid model provided": "Invalid model provided",
+  "Invalid subModelKey format": "Invalid subModelKey format: {{subModelKey}}",
+  "Model with ID {{uid}} not found": "Model with ID {{uid}} not found",
+  "Name": "Name",
+  "Next step": "Next step",
+  "No createModelOptions found for item": "No createModelOptions found for item",
+  "OK": "OK",
+  "Other blocks": "Other blocks",
+  "Previous step": "Previous step",
+  "Render failed": "Render failed",
+  "Step configuration": "Step configuration",
+  "Step parameter configuration": "Step parameter configuration",
+  "Step with key {{stepKey}} not found": "Step with key {{stepKey}} not found",
+  "Submodel not found": "Submodel '{{subKey}}' not found",
+  "This is likely a NocoBase internals bug. Please open an issue at": "This is likely a NocoBase internals bug. Please open an issue at",
+  "This step has no configurable parameters": "This step has no configurable parameters",
+  "This variable is not available": "This variable is not available",
+  "Try again": "Try again",
+  "UID copied to clipboard": "UID copied to clipboard",
+  "createModelOptions must specify use property": "createModelOptions must specify \"use\" property",
+  "here": "here"
+}

package/src/locale/vi-VN.json

@@ -0,0 +1,63 @@
+{
+  "Add": "Add",
+  "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.",
+  "Array index out of bounds": "Array index {{index}} out of bounds for '{{subKey}}'",
+  "Cancel": "Cancel",
+  "Common actions": "Common actions",
+  "Complete configuration": "Complete configuration",
+  "Configuration": "Configuration",
+  "Configuration popup cancelled or error": "Configuration popup cancelled or error",
+  "Configuration saved": "Configuration saved",
+  "Confirm delete": "Confirm delete",
+  "Copy UID": "Copy UID",
+  "Copy error info": "Copy error info",
+  "Copy failed": "Copy failed",
+  "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.",
+  "Copy failed, please copy [{{uid}}] manually.": "Copy failed, please copy [{{uid}}] manually.",
+  "Copy popup UID": "Copy popup UID",
+  "Data blocks": "Data blocks",
+  "Delete": "Delete",
+  "Delete failed": "Delete failed",
+  "Delete operation failed": "Delete operation failed",
+  "Delete operation failed, please check the console for details.": "Delete operation failed, please check the console for details.",
+  "Download logs": "Download logs",
+  "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider": "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider",
+  "Error saving configuration": "Error saving configuration",
+  "Error saving configuration, please check console": "Error saving configuration, please check console",
+  "Error submitting form": "Error submitting form",
+  "Expected array for subModel": "Expected array for '{{subKey}}', got {{type}}",
+  "Expected object for subModel": "Expected object for '{{subKey}}', got array",
+  "Failed to add sub model": "Failed to add sub model",
+  "Failed to destroy model after creation error": "Failed to destroy model after creation error",
+  "Failed to get action {{action}}": "Failed to get action {{action}}",
+  "Failed to get configurable flows for model {{model}}": "Failed to get configurable flows for model {{model}}",
+  "Failed to import FormDialog": "Failed to import FormDialog",
+  "Failed to import FormDialog or FormStep": "Failed to import FormDialog or FormStep",
+  "Failed to import Formily components": "Failed to import Formily components",
+  "Feedback": "Feedback",
+  "Filter blocks": "Filter blocks",
+  "Flow with key {{flowKey}} not found": "Flow with key {{flowKey}} not found",
+  "Form validation failed": "Form validation failed",
+  "Invalid input parameters": "Invalid input parameters",
+  "Invalid model provided": "Invalid model provided",
+  "Invalid subModelKey format": "Invalid subModelKey format: {{subModelKey}}",
+  "Model with ID {{uid}} not found": "Model with ID {{uid}} not found",
+  "Name": "Name",
+  "Next step": "Next step",
+  "No createModelOptions found for item": "No createModelOptions found for item",
+  "OK": "OK",
+  "Other blocks": "Other blocks",
+  "Previous step": "Previous step",
+  "Render failed": "Render failed",
+  "Step configuration": "Step configuration",
+  "Step parameter configuration": "Step parameter configuration",
+  "Step with key {{stepKey}} not found": "Step with key {{stepKey}} not found",
+  "Submodel not found": "Submodel '{{subKey}}' not found",
+  "This is likely a NocoBase internals bug. Please open an issue at": "This is likely a NocoBase internals bug. Please open an issue at",
+  "This step has no configurable parameters": "This step has no configurable parameters",
+  "This variable is not available": "This variable is not available",
+  "Try again": "Try again",
+  "UID copied to clipboard": "UID copied to clipboard",
+  "createModelOptions must specify use property": "createModelOptions must specify \"use\" property",
+  "here": "here"
+}

package/src/locale/zh-CN.json

@@ -1,63 +1,63 @@
 {
-  "Invalid model provided": "提供的模型无效",
-  "Flow with key {{flowKey}} not found": "未找到key为 {{flowKey}} 的流程",
-  "Step with key {{stepKey}} not found": "未找到key为 {{stepKey}} 的步骤",
-  "Configuration": "配置",
-  "Step configuration": "步骤配置",
-  "This step has no configurable parameters": "此步骤没有可配置的参数",
-  "Failed to import Formily components": "导入 Formily 组件失败",
-  "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider": "抽屉 API 不可用，请确保在 FlowEngineGlobalsContextProvider 中使用",
-  "Configuration saved": "配置已保存",
-  "Error saving configuration": "保存配置时出错",
-  "Error saving configuration, please check console": "保存配置时出错，请检查控制台",
-  "Failed to import FormDialog": "导入 FormDialog 失败",
-  "OK": "确定",
+  "Add": "添加",
+  "Are you sure you want to delete this item? This action cannot be undone.": "确定要删除此项吗？此操作不可撤销。",
+  "Array index out of bounds": "数组索引 {{index}} 超出 '{{subKey}}' 的边界",
   "Cancel": "取消",
-  "Step parameter configuration": "步骤参数配置",
-  "Error submitting form": "提交表单时出错",
+  "Common actions": "通用操作",
   "Complete configuration": "完成配置",
-  "Previous step": "上一步",
-  "Form validation failed": "表单验证失败",
-  "Next step": "下一步",
-  "Failed to import FormDialog or FormStep": "导入 FormDialog 或 FormStep 失败",
-  "UID copied to clipboard": "UID 已复制到剪贴板",
+  "Configuration": "配置",
+  "Configuration popup cancelled or error": "配置弹窗已取消或出错",
+  "Configuration saved": "配置已保存",
+  "Confirm delete": "确认删除",
+  "Copy UID": "复制 UID",
+  "Copy error info": "复制错误信息",
   "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": "删除操作失败",
+  "Copy failed, please copy [{{uid}}] manually.": "复制失败，请手动复制 [{{uid}}]。",
+  "Copy popup UID": "复制弹窗 UID",
+  "Data blocks": "数据区块",
+  "Delete": "删除",
   "Delete failed": "删除失败",
+  "Delete operation failed": "删除操作失败",
   "Delete operation failed, please check the console for details.": "删除操作失败，请检查控制台获取详细信息。",
-  "Configuration popup cancelled or error": "配置弹窗已取消或出错",
+  "Download logs": "下载日志",
+  "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider": "抽屉 API 不可用，请确保在 FlowEngineGlobalsContextProvider 中使用",
+  "Error saving configuration": "保存配置时出错",
+  "Error saving configuration, please check console": "保存配置时出错，请检查控制台",
+  "Error submitting form": "提交表单时出错",
+  "Expected array for subModel": "期望 '{{subKey}}' 为数组，实际为 {{type}}",
+  "Expected object for subModel": "期望 '{{subKey}}' 为对象，实际为数组",
+  "Failed to add sub model": "添加子模型失败",
+  "Failed to destroy model after creation error": "创建错误后销毁模型失败",
   "Failed to get action {{action}}": "获取 action '{{action}}' 失败",
   "Failed to get configurable flows for model {{model}}": "获取模型 '{{model}}' 的可配置 flows 失败",
-  "Copy UID": "复制 UID",
-  "Delete": "删除",
-  "This is likely a NocoBase internals bug. Please open an issue at": "这可能是 NocoBase 内部错误。请在以下地址提交问题",
-  "here": "这里",
-  "Render failed": "渲染失败",
+  "Failed to import FormDialog": "导入 FormDialog 失败",
+  "Failed to import FormDialog or FormStep": "导入 FormDialog 或 FormStep 失败",
+  "Failed to import Formily components": "导入 Formily 组件失败",
   "Feedback": "反馈",
-  "Download logs": "下载日志",
-  "Copy error info": "复制错误信息",
-  "Try again": "重试",
-  "Data blocks": "数据区块",
   "Filter blocks": "筛选区块",
-  "Other blocks": "其他区块",
+  "Flow with key {{flowKey}} not found": "未找到key为 {{flowKey}} 的流程",
+  "Form validation failed": "表单验证失败",
   "Invalid input parameters": "输入参数无效",
+  "Invalid model provided": "提供的模型无效",
   "Invalid subModelKey format": "无效的 subModelKey 格式: {{subModelKey}}",
-  "Submodel not found": "未找到 Submodel '{{subKey}}'",
-  "Expected array for subModel": "期望 '{{subKey}}' 为数组，实际为 {{type}}",
-  "Array index out of bounds": "数组索引 {{index}} 超出 '{{subKey}}' 的边界",
-  "Expected object for subModel": "期望 '{{subKey}}' 为对象，实际为数组",
-  "No createModelOptions found for item": "未找到该项的 createModelOptions",
-  "createModelOptions must specify use property": "createModelOptions 必须指定 \"use\" 属性",
-  "Failed to add sub model": "添加子模型失败",
-  "Failed to destroy model after creation error": "创建错误后销毁模型失败",
-  "Add": "添加",
-  "Name": "名称",
   "Model with ID {{uid}} not found": "未找到 ID 为 {{uid}} 的模型",
-  "Common actions": "通用操作",
+  "Name": "名称",
+  "Next step": "下一步",
+  "No createModelOptions found for item": "未找到该项的 createModelOptions",
+  "OK": "确定",
+  "Other blocks": "其他区块",
+  "Previous step": "上一步",
+  "Render failed": "渲染失败",
+  "Step configuration": "步骤配置",
+  "Step parameter configuration": "步骤参数配置",
+  "Step with key {{stepKey}} not found": "未找到key为 {{stepKey}} 的步骤",
+  "Submodel not found": "未找到 Submodel '{{subKey}}'",
+  "This is likely a NocoBase internals bug. Please open an issue at": "这可能是 NocoBase 内部错误。请在以下地址提交问题",
+  "This step has no configurable parameters": "此步骤没有可配置的参数",
   "This variable is not available": "此变量不可用",
-  "Copy popup UID": "复制弹窗 UID"
-}
+  "Try again": "重试",
+  "UID copied to clipboard": "UID 已复制到剪贴板",
+  "createModelOptions must specify use property": "createModelOptions 必须指定 \"use\" 属性",
+  "here": "这里"
+}

package/src/locale/zh-TW.json

@@ -0,0 +1,63 @@
+{
+  "Add": "Add",
+  "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.",
+  "Array index out of bounds": "Array index {{index}} out of bounds for '{{subKey}}'",
+  "Cancel": "Cancel",
+  "Common actions": "Common actions",
+  "Complete configuration": "Complete configuration",
+  "Configuration": "Configuration",
+  "Configuration popup cancelled or error": "Configuration popup cancelled or error",
+  "Configuration saved": "Configuration saved",
+  "Confirm delete": "Confirm delete",
+  "Copy UID": "Copy UID",
+  "Copy error info": "Copy error info",
+  "Copy failed": "Copy failed",
+  "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.",
+  "Copy failed, please copy [{{uid}}] manually.": "Copy failed, please copy [{{uid}}] manually.",
+  "Copy popup UID": "Copy popup UID",
+  "Data blocks": "Data blocks",
+  "Delete": "Delete",
+  "Delete failed": "Delete failed",
+  "Delete operation failed": "Delete operation failed",
+  "Delete operation failed, please check the console for details.": "Delete operation failed, please check the console for details.",
+  "Download logs": "Download logs",
+  "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider": "Drawer API is not available, please ensure it is used within FlowEngineGlobalsContextProvider",
+  "Error saving configuration": "Error saving configuration",
+  "Error saving configuration, please check console": "Error saving configuration, please check console",
+  "Error submitting form": "Error submitting form",
+  "Expected array for subModel": "Expected array for '{{subKey}}', got {{type}}",
+  "Expected object for subModel": "Expected object for '{{subKey}}', got array",
+  "Failed to add sub model": "Failed to add sub model",
+  "Failed to destroy model after creation error": "Failed to destroy model after creation error",
+  "Failed to get action {{action}}": "Failed to get action {{action}}",
+  "Failed to get configurable flows for model {{model}}": "Failed to get configurable flows for model {{model}}",
+  "Failed to import FormDialog": "Failed to import FormDialog",
+  "Failed to import FormDialog or FormStep": "Failed to import FormDialog or FormStep",
+  "Failed to import Formily components": "Failed to import Formily components",
+  "Feedback": "Feedback",
+  "Filter blocks": "Filter blocks",
+  "Flow with key {{flowKey}} not found": "Flow with key {{flowKey}} not found",
+  "Form validation failed": "Form validation failed",
+  "Invalid input parameters": "Invalid input parameters",
+  "Invalid model provided": "Invalid model provided",
+  "Invalid subModelKey format": "Invalid subModelKey format: {{subModelKey}}",
+  "Model with ID {{uid}} not found": "Model with ID {{uid}} not found",
+  "Name": "Name",
+  "Next step": "Next step",
+  "No createModelOptions found for item": "No createModelOptions found for item",
+  "OK": "OK",
+  "Other blocks": "Other blocks",
+  "Previous step": "Previous step",
+  "Render failed": "Render failed",
+  "Step configuration": "Step configuration",
+  "Step parameter configuration": "Step parameter configuration",
+  "Step with key {{stepKey}} not found": "Step with key {{stepKey}} not found",
+  "Submodel not found": "Submodel '{{subKey}}' not found",
+  "This is likely a NocoBase internals bug. Please open an issue at": "This is likely a NocoBase internals bug. Please open an issue at",
+  "This step has no configurable parameters": "This step has no configurable parameters",
+  "This variable is not available": "This variable is not available",
+  "Try again": "Try again",
+  "UID copied to clipboard": "UID copied to clipboard",
+  "createModelOptions must specify use property": "createModelOptions must specify \"use\" property",
+  "here": "here"
+}

package/src/models/__tests__/flowEngine.resolveUse.test.ts

@@ -109,4 +109,62 @@ describe('FlowEngine.createModel resolveUse hook', () => {
     expect(model).toBeInstanceOf(DynamicTarget);
     expect(serialized.use).toBe('DynamicEntry');
   });
+
+  test('should receive parent model in resolveUse for sub-model decision', () => {
+    class ChildA extends FlowModel {}
+    class ChildB extends FlowModel {}
+    class Parent extends FlowModel {}
+    class ChildEntry extends FlowModel {
+      static resolveUse(options, _engine, parent?: FlowModel) {
+        return parent?.props?.variant === 'B' ? 'ChildB' : 'ChildA';
+      }
+    }
+
+    engine.registerModels({ Parent, ChildEntry, ChildA, ChildB });
+
+    const parentA = engine.createModel({ use: 'Parent', uid: 'p-a', flowEngine: engine, props: { variant: 'A' } });
+    const childA = engine.createModel({
+      use: 'ChildEntry',
+      uid: 'c-a',
+      flowEngine: engine,
+      parentId: parentA.uid,
+      subKey: 'child',
+    });
+    expect(childA).toBeInstanceOf(ChildA);
+
+    const parentB = engine.createModel({ use: 'Parent', uid: 'p-b', flowEngine: engine, props: { variant: 'B' } });
+    const childB = engine.createModel({
+      use: 'ChildEntry',
+      uid: 'c-b',
+      flowEngine: engine,
+      parentId: parentB.uid,
+      subKey: 'child',
+    });
+    expect(childB).toBeInstanceOf(ChildB);
+  });
+
+  test('should stop resolveUse chain when stop flag is true', () => {
+    const leafSpy = vi.fn();
+
+    class Leaf extends FlowModel {
+      static resolveUse = leafSpy;
+    }
+    class Mid extends FlowModel {
+      static resolveUse() {
+        return 'Leaf';
+      }
+    }
+    class Entry extends FlowModel {
+      static resolveUse() {
+        return { use: 'Mid', stop: true };
+      }
+    }
+
+    engine.registerModels({ Entry, Mid, Leaf });
+
+    const model = engine.createModel({ use: 'Entry', uid: 'stop-flag', flowEngine: engine });
+
+    expect(model).toBeInstanceOf(Mid);
+    expect(leafSpy).not.toHaveBeenCalled();
+  });
 });

package/src/models/flowModel.tsx

@@ -31,6 +31,7 @@ import type {
   ParamObject,
   ParentFlowModel,
   PersistOptions,
+  ResolveUseResult,
   RegisteredModelClassName,
   StepDefinition,
   StepParams,
@@ -323,10 +324,7 @@ export class FlowModel<Structure extends DefaultStructure = DefaultStructure> {
    * 动态解析实际要实例化的模型类；可在子类中覆盖。
    * 返回注册名或构造器，支持在 FlowEngine 中继续沿链解析。
    */
-  static resolveUse?(
-    options: CreateModelOptions,
-    engine: FlowEngine,
-  ): RegisteredModelClassName | ModelConstructor | void;
+  static resolveUse?(options: CreateModelOptions, engine: FlowEngine, parent?: FlowModel): ResolveUseResult | void;
 
   /**
    * 注册仅当前 FlowModel 类及其子类可用的 Action。

package/src/resources/multiRecordResource.ts

@@ -133,26 +133,7 @@ export class MultiRecordResource<TDataItem = any> extends BaseRecordResource<TDa
   }
 
   async update(filterByTk: string | number, data: Partial<TDataItem>, options?: AxiosRequestConfig): Promise<void> {
-    const collection = this.context.collection;
-    const filterTargetKey = collection?.filterTargetKey;
-    const tkData = collection?.getFilterByTK(this.context.record);
-    let result = data;
-
-    // 安全处理 filterTargetKey & tkData
-    if (collection && filterTargetKey) {
-      if (Array.isArray(filterTargetKey)) {
-        result = {
-          ...data,
-          ...(tkData || {}),
-        };
-      } else {
-        result = {
-          ...data,
-          [filterTargetKey]: tkData,
-        };
-      }
-    }
-
+    const result = data;
     const config = this.mergeRequestConfig(
       {
         params: {

package/src/resources/singleRecordResource.ts

@@ -33,28 +33,12 @@ export class SingleRecordResource<TData = any> extends BaseRecordResource<TData>
   async save(data: TData, options?: AxiosRequestConfig & { refresh?: boolean }): Promise<void> {
     const config = this.mergeRequestConfig(this.saveActionOptions, _.omit(options, ['refresh']));
     let actionName = 'create';
-    let result = data;
+    const result = data;
     // 如果有 filterByTk，则表示是更新操作
     if (!this.isNewRecord) {
       config.params = config.params || {};
       config.params.filterByTk = this.getFilterByTk();
       actionName = 'update';
-      const collection = this.context.collection;
-      const filterTargetKey = collection?.filterTargetKey;
-      const tkData = collection?.getFilterByTK(this.context.record);
-      if (collection && filterTargetKey) {
-        if (Array.isArray(filterTargetKey)) {
-          result = {
-            ...data,
-            ...(tkData || {}),
-          };
-        } else {
-          result = {
-            ...data,
-            [filterTargetKey]: tkData,
-          };
-        }
-      }
     }
     const res = await this.runAction(actionName, {
       ...config,

package/src/types.ts

@@ -311,6 +311,18 @@ export type ParamObject = {
  */
 export type RegisteredModelClassName = string;
 
+/**
+ * resolveUse 返回类型：可返回目标 use，或 { use, stop } 包含中断标志。
+ */
+export type ResolveUseResult =
+  | RegisteredModelClassName
+  | ModelConstructor
+  | {
+      use: RegisteredModelClassName | ModelConstructor;
+      /** 标记是否终止后续 resolveUse 链；默认 false（继续解析） */
+      stop?: boolean;
+    };
+
 /**
  * Options for creating a model instance
  */

package/src/utils/__tests__/variablesParams.test.ts

@@ -75,6 +75,39 @@ describe('variablesParams helpers', () => {
     expect(res).not.toHaveProperty('user');
   });
 
+  it('collectContextParamsForTemplate keeps associationName/sourceId from RecordRef', async () => {
+    const ctx: any = {
+      getPropertyOptions: (k: string) => ({
+        meta:
+          k === 'popup'
+            ? async () => ({
+                type: 'object',
+                title: 'Popup',
+                buildVariablesParams: () => ({
+                  record: {
+                    collection: 'posts',
+                    dataSourceKey: 'main',
+                    filterByTk: 1,
+                    associationName: 'users.posts',
+                    sourceId: 9,
+                  },
+                }),
+              })
+            : undefined,
+      }),
+    };
+
+    const tpl = { value: '{{ ctx.popup.record.id }}' } as any;
+    const res = await collectContextParamsForTemplate(ctx, tpl);
+    expect(res?.['popup.record']).toMatchObject({
+      collection: 'posts',
+      dataSourceKey: 'main',
+      filterByTk: 1,
+      associationName: 'users.posts',
+      sourceId: 9,
+    });
+  });
+
   it('createRecordResolveOnServerWithLocal: no local record => always use server', () => {
     const resolver = createRecordResolveOnServerWithLocal(
       () => ({ name: 'posts', dataSourceKey: 'main' }) as any,

package/src/utils/serverContextParams.ts

@@ -14,6 +14,7 @@ export type RecordRef = {
   id?: any; // primary key value
   filterByTk?: any; // alias for id
   dataSourceKey?: string;
+  associationName?: string;
   sourceId?: any;
   fields?: string[];
   appends?: string[];
@@ -28,6 +29,8 @@ export type NormalizedRecordParams = {
   collection: string;
   filterByTk: any;
   dataSourceKey?: string;
+  associationName?: string;
+  sourceId?: any;
   fields?: string[];
   appends?: string[];
 };
@@ -64,6 +67,8 @@ function normalizeOne(ctx: FlowContext, ref?: RecordRef): NormalizedRecordParams
     collection,
     filterByTk,
     dataSourceKey,
+    associationName: ref.associationName,
+    sourceId: ref.sourceId,
     fields: ref.fields,
     appends: ref.appends,
   });

package/src/utils/variablesParams.ts

@@ -43,9 +43,10 @@ export function inferViewRecordRef(ctx: FlowContext): RecordRef | undefined {
   const collection = inputArgs?.collectionName || (view as any)?.record?.collection;
   const dataSourceKey = inputArgs?.dataSourceKey || (view as any)?.record?.dataSourceKey || 'main';
   const filterByTk = inputArgs?.filterByTk || (view as any)?.record?.filterByTk;
+  const associationName = inputArgs?.associationName;
   const sourceId = inputArgs?.sourceId;
   if (!collection || typeof filterByTk === 'undefined' || filterByTk === null) return undefined;
-  return { collection, dataSourceKey, filterByTk, sourceId };
+  return { collection, dataSourceKey, filterByTk, sourceId, associationName };
 }
 
 // 统一视图场景中“视图记录”的本地复用逻辑：