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

package/lib/utils/index.js

@@ -35,10 +35,15 @@ __export(utils_exports, {
   clearAutoFlowError: () => import_autoFlowError.clearAutoFlowError,
   collectContextParamsForTemplate: () => import_variablesParams.collectContextParamsForTemplate,
   compileUiSchema: () => import_schema_utils.compileUiSchema,
+  createAssociationAwareObjectMetaFactory: () => import_associationObjectVariable.createAssociationAwareObjectMetaFactory,
+  createAssociationSubpathResolver: () => import_associationObjectVariable.createAssociationSubpathResolver,
   createCollectionContextMeta: () => import_createCollectionContextMeta.createCollectionContextMeta,
   createCurrentRecordMetaFactory: () => import_variablesParams.createCurrentRecordMetaFactory,
+  createEphemeralContext: () => import_createEphemeralContext.createEphemeralContext,
   createRecordMetaFactory: () => import_variablesParams.createRecordMetaFactory,
+  createRecordResolveOnServerWithLocal: () => import_variablesParams.createRecordResolveOnServerWithLocal,
   createSafeDocument: () => import_safeGlobals.createSafeDocument,
+  createSafeNavigator: () => import_safeGlobals.createSafeNavigator,
   createSafeWindow: () => import_safeGlobals.createSafeWindow,
   defineAction: () => import_flow_definitions.defineAction,
   escapeT: () => import_translation.escapeT,
@@ -49,9 +54,11 @@ __export(utils_exports, {
   getAutoFlowError: () => import_autoFlowError.getAutoFlowError,
   getT: () => import_translation.getT,
   inferRecordRef: () => import_variablesParams.inferRecordRef,
+  isBeforeRenderFlow: () => import_flows.isBeforeRenderFlow,
   isInheritedFrom: () => import_inheritance.isInheritedFrom,
   isVariableExpression: () => import_context.isVariableExpression,
   parsePathnameToViewParams: () => import_parsePathnameToViewParams.parsePathnameToViewParams,
+  pruneFilter: () => import_pruneFilter.pruneFilter,
   resolveCreateModelOptions: () => import_params_resolvers.resolveCreateModelOptions,
   resolveDefaultParams: () => import_params_resolvers.resolveDefaultParams,
   resolveExpressions: () => import_params_resolvers.resolveExpressions,
@@ -59,6 +66,7 @@ __export(utils_exports, {
   resolveUiMode: () => import_schema_utils.resolveUiMode,
   setAutoFlowError: () => import_autoFlowError.setAutoFlowError,
   setupRuntimeContextSteps: () => import_setupRuntimeContextSteps.setupRuntimeContextSteps,
+  shouldHideStepInSettings: () => import_schema_utils.shouldHideStepInSettings,
   tExpr: () => import_translation.tExpr
 });
 module.exports = __toCommonJS(utils_exports);
@@ -71,11 +79,15 @@ var import_params_resolvers = require("./params-resolvers");
 var import_schema_utils = require("./schema-utils");
 var import_setupRuntimeContextSteps = require("./setupRuntimeContextSteps");
 var import_createCollectionContextMeta = require("./createCollectionContextMeta");
+var import_associationObjectVariable = require("./associationObjectVariable");
 var import_variablesParams = require("./variablesParams");
 var import_context = require("./context");
 var import_autoFlowError = require("./autoFlowError");
 var import_parsePathnameToViewParams = require("./parsePathnameToViewParams");
 var import_safeGlobals = require("./safeGlobals");
+var import_createEphemeralContext = require("./createEphemeralContext");
+var import_pruneFilter = require("./pruneFilter");
+var import_flows = require("./flows");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BLOCK_GROUP_CONFIGS,
@@ -87,10 +99,15 @@ var import_safeGlobals = require("./safeGlobals");
   clearAutoFlowError,
   collectContextParamsForTemplate,
   compileUiSchema,
+  createAssociationAwareObjectMetaFactory,
+  createAssociationSubpathResolver,
   createCollectionContextMeta,
   createCurrentRecordMetaFactory,
+  createEphemeralContext,
   createRecordMetaFactory,
+  createRecordResolveOnServerWithLocal,
   createSafeDocument,
+  createSafeNavigator,
   createSafeWindow,
   defineAction,
   escapeT,
@@ -101,9 +118,11 @@ var import_safeGlobals = require("./safeGlobals");
   getAutoFlowError,
   getT,
   inferRecordRef,
+  isBeforeRenderFlow,
   isInheritedFrom,
   isVariableExpression,
   parsePathnameToViewParams,
+  pruneFilter,
   resolveCreateModelOptions,
   resolveDefaultParams,
   resolveExpressions,
@@ -111,5 +130,6 @@ var import_safeGlobals = require("./safeGlobals");
   resolveUiMode,
   setAutoFlowError,
   setupRuntimeContextSteps,
+  shouldHideStepInSettings,
   tExpr
 });

package/lib/utils/jsxTransform.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+/**
+ * Lightweight JSX -> JS compiler for RunJS user code.
+ * - Uses sucrase via dynamic import (lazy; avoids static cycles and cost when not needed)
+ * - Maps JSX to ctx.React.createElement / ctx.React.Fragment so no global React is required
+ * - If sucrase is unavailable or transform throws, returns original code as graceful fallback
+ */
+export declare function compileRunJs(code: string): Promise<string>;

package/lib/utils/jsxTransform.js

@@ -0,0 +1,68 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var jsxTransform_exports = {};
+__export(jsxTransform_exports, {
+  compileRunJs: () => compileRunJs
+});
+module.exports = __toCommonJS(jsxTransform_exports);
+async function compileRunJs(code) {
+  var _a;
+  const maybeJSX = /<[A-Za-z]|<\//.test(code);
+  if (!maybeJSX) return code;
+  try {
+    const mod = await import("sucrase");
+    const transform = (mod == null ? void 0 : mod.transform) || ((_a = mod == null ? void 0 : mod.default) == null ? void 0 : _a.transform);
+    if (typeof transform !== "function") return code;
+    const res = transform(code, {
+      transforms: ["jsx"],
+      jsxPragma: "ctx.React.createElement",
+      jsxFragmentPragma: "ctx.React.Fragment",
+      // Keep ES syntax as-is; JSRunner runs in modern engines
+      disableESTransforms: true,
+      production: true
+    });
+    return (res && (res.code || (res == null ? void 0 : res.output))) ?? code;
+  } catch (_e) {
+    return code;
+  }
+}
+__name(compileRunJs, "compileRunJs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  compileRunJs
+});

package/lib/utils/params-resolvers.js

@@ -44,8 +44,8 @@ __export(params_resolvers_exports, {
   resolveExpressions: () => resolveExpressions
 });
 module.exports = __toCommonJS(params_resolvers_exports);
+var import_shared = require("@nocobase/shared");
 var import_lodash = __toESM(require("lodash"));
-var import_client = require("@nocobase/utils/client");
 async function resolveDefaultParams(defaultParams, ctx) {
   if (!defaultParams) {
     return {};
@@ -275,9 +275,9 @@ async function compileExpression(expression, ctx) {
     if (!first) return void 0;
     const base = await ctx[first];
     if (segs.length === 0) return base;
-    return (0, import_client.getValuesByPath)(base, segs.join("."));
+    return (0, import_shared.getValuesByPath)(base, segs.join("."));
   }, "resolveDotOnlyPath");
-  const singleMatch = expression.match(/^\{\{\s*(.+)\s*\}\}$/);
+  const singleMatch = expression.match(/^\s*\{\{\s*([^{}]+?)\s*\}\}\s*$/);
   if (singleMatch) {
     const inner = singleMatch[1];
     const dotPath = matchDotOnly(inner);

package/lib/utils/parsePathnameToViewParams.d.ts

@@ -12,7 +12,7 @@ export interface ViewParam {
     /** 标签页唯一标识符 */
     tabUid?: string;
     /** 弹窗记录的 id */
-    filterByTk?: string;
+    filterByTk?: string | Record<string, string | number>;
     /** source Id */
     sourceId?: string;
 }

package/lib/utils/parsePathnameToViewParams.js

@@ -54,16 +54,52 @@ const parsePathnameToViewParams = /* @__PURE__ */ __name((pathname) => {
         break;
       }
     } else if (currentView && i + 1 < segments.length) {
-      const value = segments[i + 1];
+      const rawValue = segments[i + 1];
+      let decoded = rawValue;
+      try {
+        decoded = decodeURIComponent(rawValue);
+      } catch (_) {
+      }
       switch (segment) {
         case "tab":
-          currentView.tabUid = value;
+          currentView.tabUid = decoded;
           break;
-        case "filterbytk":
-          currentView.filterByTk = value;
+        case "filterbytk": {
+          const parseKeyValuePairs = /* @__PURE__ */ __name((s) => {
+            const obj = {};
+            s.split("&").forEach((pair) => {
+              const [k, v = ""] = pair.split("=");
+              if (!k) return;
+              try {
+                const key = decodeURIComponent(k);
+                const val = decodeURIComponent(v);
+                obj[key] = val;
+              } catch (_) {
+                obj[k] = v;
+              }
+            });
+            return obj;
+          }, "parseKeyValuePairs");
+          let parsed = decoded;
+          if (decoded && (decoded.startsWith("{") || decoded.startsWith("["))) {
+            try {
+              const maybe = JSON.parse(decoded);
+              if (maybe && typeof maybe === "object" && !Array.isArray(maybe)) {
+                parsed = maybe;
+              } else {
+                parsed = decoded;
+              }
+            } catch (_) {
+              parsed = decoded;
+            }
+          } else if (decoded && decoded.includes("=") && decoded.includes("&")) {
+            parsed = parseKeyValuePairs(decoded);
+          }
+          currentView.filterByTk = parsed;
           break;
+        }
         case "sourceid":
-          currentView.sourceId = value;
+          currentView.sourceId = decoded;
           break;
         default:
           break;

package/lib/utils/pruneFilter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+/**
+ * 递归清理筛选对象中的“空值”。
+ *
+ * 规则：
+ * - 移除：`null`、`undefined`、空字符串 `''`、空数组 `[]`、空对象 `{}`；
+ * - 保留：`false`、`0` 等有意义的“假值”。
+ *
+ * 注意：当清理后整体变为空结构时，返回 `undefined`，用于表示无需下发该条件。
+ *
+ * @param input 任意筛选对象/数组/原始值
+ * @returns 清理后的对象；若为空则返回 `undefined`
+ */
+export declare function pruneFilter<T = any>(input: T): T | undefined;

package/lib/utils/pruneFilter.js

@@ -0,0 +1,52 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pruneFilter_exports = {};
+__export(pruneFilter_exports, {
+  pruneFilter: () => pruneFilter
+});
+module.exports = __toCommonJS(pruneFilter_exports);
+function pruneFilter(input) {
+  if (Array.isArray(input)) {
+    const arr = input.map((v) => pruneFilter(v)).filter((v) => v !== void 0);
+    return arr.length ? arr : void 0;
+  }
+  if (input && typeof input === "object") {
+    const out = {};
+    Object.keys(input).forEach((k) => {
+      const v = pruneFilter(input[k]);
+      if (v !== void 0) out[k] = v;
+    });
+    return Object.keys(out).length ? out : void 0;
+  }
+  return input === null || input === void 0 || typeof input === "string" && input === "" ? void 0 : input;
+}
+__name(pruneFilter, "pruneFilter");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  pruneFilter
+});

package/lib/utils/safeGlobals.d.ts

@@ -7,10 +7,12 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 /**
- * 统一的安全全局对象代理：window/document
- * - 默认仅允许常用的定时器、console、Math、Date、addEventListener（绑定原 window）
- * - document 仅允许 createElement/querySelector/querySelectorAll
+ * 统一的安全全局对象代理：window/document/navigator
+ * - window：仅允许常用的定时器、console、Math、Date、FormData、addEventListener、open（安全包装）、location（安全代理）
+ * - document：仅允许 createElement/querySelector/querySelectorAll
+ * - navigator：仅提供极少量低风险能力（clipboard.writeText、onLine、language、languages）
  * - 不允许随意访问未声明的属性，最小权限原则
  */
 export declare function createSafeWindow(extra?: Record<string, any>): {};
 export declare function createSafeDocument(extra?: Record<string, any>): {};
+export declare function createSafeNavigator(extra?: Record<string, any>): {};

package/lib/utils/safeGlobals.js

@@ -28,6 +28,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var safeGlobals_exports = {};
 __export(safeGlobals_exports, {
   createSafeDocument: () => createSafeDocument,
+  createSafeNavigator: () => createSafeNavigator,
   createSafeWindow: () => createSafeWindow
 });
 module.exports = __toCommonJS(safeGlobals_exports);
@@ -110,7 +111,7 @@ function createSafeWindow(extra) {
           case "replace":
             return (u) => guardedNavigate(u, { replace: true });
           case "reload":
-            throw new Error("Access to location.reload is not allowed.");
+            return window.location.reload.bind(window.location);
           case "href":
             throw new Error("Reading location.href is not allowed.");
           default:
@@ -135,6 +136,7 @@ function createSafeWindow(extra) {
     console,
     Math,
     Date,
+    FormData,
     // 事件侦听仅绑定到真实 window，便于少量需要的全局监听
     addEventListener: addEventListener.bind(window),
     // 安全的 window.open 代理
@@ -172,8 +174,47 @@ function createSafeDocument(extra) {
   );
 }
 __name(createSafeDocument, "createSafeDocument");
+function createSafeNavigator(extra) {
+  var _a;
+  const nav = typeof window !== "undefined" && window.navigator || void 0;
+  const clipboard = {};
+  const writeText = (_a = nav == null ? void 0 : nav.clipboard) == null ? void 0 : _a.writeText;
+  if (typeof writeText === "function") {
+    clipboard.writeText = writeText.bind(nav.clipboard);
+  }
+  const allowed = {
+    clipboard
+  };
+  Object.defineProperty(allowed, "onLine", {
+    get: /* @__PURE__ */ __name(() => !!(nav == null ? void 0 : nav.onLine), "get"),
+    enumerable: true,
+    configurable: false
+  });
+  Object.defineProperty(allowed, "language", {
+    get: /* @__PURE__ */ __name(() => nav == null ? void 0 : nav.language, "get"),
+    enumerable: true,
+    configurable: false
+  });
+  Object.defineProperty(allowed, "languages", {
+    get: /* @__PURE__ */ __name(() => (nav == null ? void 0 : nav.languages) ? [...nav.languages] : void 0, "get"),
+    enumerable: true,
+    configurable: false
+  });
+  Object.assign(allowed, extra || {});
+  return new Proxy(
+    {},
+    {
+      get(_t, prop) {
+        if (prop in allowed) return allowed[prop];
+        throw new Error(`Access to navigator property "${String(prop)}" is not allowed.`);
+      }
+    }
+  );
+}
+__name(createSafeNavigator, "createSafeNavigator");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createSafeDocument,
+  createSafeNavigator,
   createSafeWindow
 });

package/lib/utils/schema-utils.d.ts

@@ -38,3 +38,9 @@ export declare function compileUiSchema(scope: Record<string, any>, uiSchema: an
  * @returns 合并后的uiSchema对象，如果为空则返回null
  */
 export declare function resolveStepUiSchema<TModel extends FlowModel = FlowModel>(model: TModel, flow: any, step: StepDefinition): Promise<Record<string, ISchema> | null>;
+/**
+ * 判断步骤在设置菜单中是否应被隐藏。
+ * - 支持 StepDefinition.hideInSettings 与 ActionDefinition.hideInSettings（step 优先）。
+ * - hideInSettings 可为布尔值或函数（接收 FlowRuntimeContext）。
+ */
+export declare function shouldHideStepInSettings<TModel extends FlowModel = FlowModel>(model: TModel, flow: any, step: StepDefinition): Promise<boolean>;

package/lib/utils/schema-utils.js

@@ -29,7 +29,8 @@ var schema_utils_exports = {};
 __export(schema_utils_exports, {
   compileUiSchema: () => compileUiSchema,
   resolveStepUiSchema: () => resolveStepUiSchema,
-  resolveUiMode: () => resolveUiMode
+  resolveUiMode: () => resolveUiMode,
+  shouldHideStepInSettings: () => shouldHideStepInSettings
 });
 module.exports = __toCommonJS(schema_utils_exports);
 var import_json_schema = require("@formily/json-schema");
@@ -68,6 +69,28 @@ async function resolveUiMode(uiMode, ctx) {
 }
 __name(resolveUiMode, "resolveUiMode");
 const compileCache = {};
+const hasFunctionValue = /* @__PURE__ */ __name((source) => {
+  if (typeof source === "function") return true;
+  if (!source || typeof source !== "object") return false;
+  const seen = /* @__PURE__ */ new WeakSet();
+  const walk = /* @__PURE__ */ __name((val) => {
+    if (typeof val === "function") return true;
+    if (!val || typeof val !== "object") return false;
+    if (seen.has(val)) return false;
+    seen.add(val);
+    if (Array.isArray(val)) {
+      for (const it of val) {
+        if (walk(it)) return true;
+      }
+      return false;
+    }
+    for (const k of Object.keys(val)) {
+      if (walk(val[k])) return true;
+    }
+    return false;
+  }, "walk");
+  return walk(source);
+}, "hasFunctionValue");
 function compileUiSchema(scope, uiSchema, options = {}) {
   const { noCache = false } = options;
   const hasVariable = /* @__PURE__ */ __name((source) => {
@@ -88,8 +111,17 @@ function compileUiSchema(scope, uiSchema, options = {}) {
         console.warn("Failed to stringify:", e);
         return source;
       }
-      if (compileCache[cacheKey]) return compileCache[cacheKey];
       shouldCompile = hasVariable(cacheKey);
+      const hasFn = shouldCompile && !noCache ? hasFunctionValue(source) : false;
+      if (compileCache[cacheKey] && !noCache && !hasFn) return compileCache[cacheKey];
+      if (hasFn) {
+        try {
+          return import_json_schema.Schema.compile(source, scope);
+        } catch (error) {
+          console.warn("Failed to compile with Formily Schema.compile:", error);
+          return source;
+        }
+      }
     }
     if (Array.isArray(source)) {
       try {
@@ -98,8 +130,17 @@ function compileUiSchema(scope, uiSchema, options = {}) {
         console.warn("Failed to stringify:", e);
         return source;
       }
-      if (compileCache[cacheKey]) return compileCache[cacheKey];
       shouldCompile = hasVariable(cacheKey);
+      const hasFn = shouldCompile && !noCache ? hasFunctionValue(source) : false;
+      if (compileCache[cacheKey] && !noCache && !hasFn) return compileCache[cacheKey];
+      if (hasFn) {
+        try {
+          return import_json_schema.Schema.compile(source, scope);
+        } catch (error) {
+          console.warn("Failed to compile with Formily Schema.compile:", error);
+          return source;
+        }
+      }
     }
     if (shouldCompile) {
       if (!cacheKey) {
@@ -131,14 +172,14 @@ function compileUiSchema(scope, uiSchema, options = {}) {
 }
 __name(compileUiSchema, "compileUiSchema");
 async function resolveStepUiSchema(model, flow, step) {
-  var _a, _b;
+  var _a;
   const flowRuntimeContext = new import_flowContext.FlowRuntimeContext(model, flow.key, "settings");
   (0, import_setupRuntimeContextSteps.setupRuntimeContextSteps)(flowRuntimeContext, flow.steps, model, flow.key);
   flowRuntimeContext.defineProperty("currentStep", { value: step });
   let stepUiSchema = step.uiSchema;
   if (step.use) {
     try {
-      const action = (_b = (_a = model.flowEngine) == null ? void 0 : _a.getAction) == null ? void 0 : _b.call(_a, step.use);
+      const action = (_a = model.getAction) == null ? void 0 : _a.call(model, step.use);
       if (action && action.uiSchema) {
         stepUiSchema = stepUiSchema || action.uiSchema;
       }
@@ -153,9 +194,33 @@ async function resolveStepUiSchema(model, flow, step) {
   return resolvedStepUiSchema;
 }
 __name(resolveStepUiSchema, "resolveStepUiSchema");
+async function shouldHideStepInSettings(model, flow, step) {
+  var _a;
+  if (!step) return true;
+  let hideInSettings = step.hideInSettings;
+  if (typeof hideInSettings === "undefined" && step.use) {
+    const action = (_a = model.getAction) == null ? void 0 : _a.call(model, step.use);
+    hideInSettings = action == null ? void 0 : action.hideInSettings;
+  }
+  if (typeof hideInSettings === "function") {
+    try {
+      const ctx = new import_flowContext.FlowRuntimeContext(model, flow.key, "settings");
+      (0, import_setupRuntimeContextSteps.setupRuntimeContextSteps)(ctx, flow.steps, model, flow.key);
+      ctx.defineProperty("currentStep", { value: step });
+      const result = await hideInSettings(ctx);
+      return !!result;
+    } catch (error) {
+      console.warn(`Error evaluating hideInSettings for step '${step.key || ""}' in flow '${flow.key}':`, error);
+      return false;
+    }
+  }
+  return !!hideInSettings;
+}
+__name(shouldHideStepInSettings, "shouldHideStepInSettings");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   compileUiSchema,
   resolveStepUiSchema,
-  resolveUiMode
+  resolveUiMode,
+  shouldHideStepInSettings
 });

package/lib/utils/serverContextParams.d.ts

@@ -12,6 +12,7 @@ export type RecordRef = {
     id?: any;
     filterByTk?: any;
     dataSourceKey?: string;
+    associationName?: string;
     sourceId?: any;
     fields?: string[];
     appends?: string[];
@@ -23,6 +24,8 @@ export type NormalizedRecordParams = {
     collection: string;
     filterByTk: any;
     dataSourceKey?: string;
+    associationName?: string;
+    sourceId?: any;
     fields?: string[];
     appends?: string[];
 };

package/lib/utils/serverContextParams.js

@@ -63,6 +63,8 @@ function normalizeOne(ctx, ref) {
     collection,
     filterByTk,
     dataSourceKey,
+    associationName: ref.associationName,
+    sourceId: ref.sourceId,
     fields: ref.fields,
     appends: ref.appends
   });

package/lib/utils/translation.d.ts

@@ -14,5 +14,8 @@ import type { FlowModel } from '../models';
  * @returns 翻译函数，自动使用 flow-engine 命名空间
  */
 export declare function getT(model: FlowModel): (key: string, options?: any) => string;
+export declare function tExpr(text: TFuncKey | TFuncKey[], options?: TOptions): string;
+/**
+ * @deprecated use tExpr from `@nocobase/flow-engine` instead
+ */
 export declare function escapeT(text: TFuncKey | TFuncKey[], options?: TOptions): string;
-export { escapeT as tExpr };

package/lib/utils/translation.js

@@ -29,7 +29,7 @@ var translation_exports = {};
 __export(translation_exports, {
   escapeT: () => escapeT,
   getT: () => getT,
-  tExpr: () => escapeT
+  tExpr: () => tExpr
 });
 module.exports = __toCommonJS(translation_exports);
 var import_constants = require("./constants");
@@ -43,12 +43,16 @@ function getT(model) {
   return (key) => key;
 }
 __name(getT, "getT");
-function escapeT(text, options) {
+function tExpr(text, options) {
   if (options) {
     return `{{t(${JSON.stringify(text)}, ${JSON.stringify(options)})}}`;
   }
   return `{{t(${JSON.stringify(text)})}}`;
 }
+__name(tExpr, "tExpr");
+function escapeT(text, options) {
+  return tExpr(text, options);
+}
 __name(escapeT, "escapeT");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {