@nocobase/flow-engine 2.0.0-beta.21 → 2.0.0-beta.23

package/lib/FlowDefinition.d.ts

@@ -419,6 +419,8 @@ export declare class FlowStep {
         scene?: import("./types").ActionScene | import("./types").ActionScene[];
         paramsRequired?: boolean;
         hideInSettings?: boolean | ((ctx: import("./flowContext").FlowRuntimeContext<import(".").FlowModel<import("./types").DefaultStructure>, any>) => boolean | Promise<boolean>);
+        disabledInSettings?: boolean | ((ctx: import("./flowContext").FlowRuntimeContext<import(".").FlowModel<import("./types").DefaultStructure>, any>) => boolean | Promise<boolean>);
+        disabledReasonInSettings?: string | ((ctx: import("./flowContext").FlowRuntimeContext<import(".").FlowModel<import("./types").DefaultStructure>, any>) => string | Promise<string>);
         defineProperties?: Record<string, import("./flowContext").PropertyOptions> | ((ctx: import("./flowContext").FlowRuntimeContext<import(".").FlowModel<import("./types").DefaultStructure>, any>) => Record<string, import("./flowContext").PropertyOptions> | Promise<Record<string, import("./flowContext").PropertyOptions>>);
         defineMethods?: Record<string, (this: import("./flowContext").FlowRuntimeContext<import(".").FlowModel<import("./types").DefaultStructure>, any>, ...args: any[]) => any> | ((ctx: import("./flowContext").FlowRuntimeContext<import(".").FlowModel<import("./types").DefaultStructure>, any>) => Record<string, (this: import("./flowContext").FlowRuntimeContext<import(".").FlowModel<import("./types").DefaultStructure>, any>, ...args: any[]) => any> | Promise<Record<string, (this: import("./flowContext").FlowRuntimeContext<import(".").FlowModel<import("./types").DefaultStructure>, any>, ...args: any[]) => any>>);
     };

package/lib/JSRunner.js

@@ -35,6 +35,7 @@ const _JSRunner = class _JSRunner {
   globals;
   timeoutMs;
   constructor(options = {}) {
+    var _a, _b;
     const bindWindowFn = /* @__PURE__ */ __name((key) => {
       if (typeof window !== "undefined" && typeof window[key] === "function") {
         return window[key].bind(window);
@@ -42,13 +43,34 @@ const _JSRunner = class _JSRunner {
       const fn = globalThis[key];
       return typeof fn === "function" ? fn.bind(globalThis) : fn;
     }, "bindWindowFn");
+    const providedGlobals = options.globals || {};
+    const liftedGlobals = {};
+    if (!Object.prototype.hasOwnProperty.call(providedGlobals, "Blob")) {
+      try {
+        const blobCtor = (_a = providedGlobals.window) == null ? void 0 : _a.Blob;
+        if (typeof blobCtor !== "undefined") {
+          liftedGlobals.Blob = blobCtor;
+        }
+      } catch {
+      }
+    }
+    if (!Object.prototype.hasOwnProperty.call(providedGlobals, "URL")) {
+      try {
+        const urlCtor = (_b = providedGlobals.window) == null ? void 0 : _b.URL;
+        if (typeof urlCtor !== "undefined") {
+          liftedGlobals.URL = urlCtor;
+        }
+      } catch {
+      }
+    }
     this.globals = {
       console,
       setTimeout: bindWindowFn("setTimeout"),
       clearTimeout: bindWindowFn("clearTimeout"),
       setInterval: bindWindowFn("setInterval"),
       clearInterval: bindWindowFn("clearInterval"),
-      ...options.globals || {}
+      ...liftedGlobals,
+      ...providedGlobals
     };
     this.timeoutMs = options.timeoutMs ?? 5e3;
   }

package/lib/components/settings/wrappers/contextual/DefaultSettingsIcon.js

@@ -135,10 +135,19 @@ const componentMap = {
 const MenuLabelItem = /* @__PURE__ */ __name(({ title, uiMode, itemProps }) => {
   const type = (uiMode == null ? void 0 : uiMode.type) || uiMode;
   const Component = type ? componentMap[type] : null;
-  if (!Component) {
-    return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, title);
+  const disabled = !!(itemProps == null ? void 0 : itemProps.disabled);
+  const disabledReason = itemProps == null ? void 0 : itemProps.disabledReason;
+  const disabledIconColor = itemProps == null ? void 0 : itemProps.disabledIconColor;
+  const content = (() => {
+    if (!Component) {
+      return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, title);
+    }
+    return /* @__PURE__ */ import_react.default.createElement(Component, { title, ...itemProps });
+  })();
+  if (!disabled) {
+    return content;
   }
-  return /* @__PURE__ */ import_react.default.createElement(Component, { title, ...itemProps });
+  return /* @__PURE__ */ import_react.default.createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: 6 } }, content, /* @__PURE__ */ import_react.default.createElement(import_antd.Tooltip, { title: disabledReason, placement: "right", destroyTooltipOnHide: true }, /* @__PURE__ */ import_react.default.createElement(import_icons.QuestionCircleOutlined, { style: { color: disabledIconColor } })));
 }, "MenuLabelItem");
 const DefaultSettingsIcon = /* @__PURE__ */ __name(({
   model,
@@ -150,9 +159,13 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
 }) => {
   const { message } = import_antd.App.useApp();
   const t = (0, import_react.useMemo)(() => (0, import_utils.getT)(model), [model]);
+  const { token } = import_antd.theme.useToken();
+  const disabledIconColor = (token == null ? void 0 : token.colorTextTertiary) || (token == null ? void 0 : token.colorTextDescription) || (token == null ? void 0 : token.colorTextSecondary);
   const [visible, setVisible] = (0, import_react.useState)(false);
   const [refreshTick, setRefreshTick] = (0, import_react.useState)(0);
   const [extraMenuItems, setExtraMenuItems] = (0, import_react.useState)([]);
+  const [configurableFlowsAndSteps, setConfigurableFlowsAndSteps] = (0, import_react.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react.useState)(true);
   const closeDropdown = (0, import_react.useCallback)(() => {
     setVisible(false);
   }, []);
@@ -203,7 +216,7 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
     return () => {
       mounted = false;
     };
-  }, [model, menuLevels, t, refreshTick, visible, message]);
+  }, [model, menuLevels, t, refreshTick, visible]);
   const copyUidToClipboard = (0, import_react.useCallback)(
     async (uid) => {
       var _a;
@@ -309,6 +322,28 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
     },
     [closeDropdown, model, t]
   );
+  const isStepMenuItemDisabled = (0, import_react.useCallback)(
+    (key) => {
+      const cleanKey = key.includes("-") && /^(.+)-\d+$/.test(key) ? key.replace(/-\d+$/, "") : key;
+      const keys = cleanKey.split(":");
+      let modelKey;
+      let flowKey;
+      let stepKey;
+      if (keys.length === 3) {
+        [modelKey, flowKey, stepKey] = keys;
+      } else if (keys.length === 2) {
+        [flowKey, stepKey] = keys;
+      } else {
+        return false;
+      }
+      return configurableFlowsAndSteps.some(({ flow, steps, modelKey: flowModelKey }) => {
+        const sameModel = (flowModelKey || void 0) === modelKey;
+        if (!sameModel || flow.key !== flowKey) return false;
+        return steps.some((stepInfo) => stepInfo.stepKey === stepKey && !!stepInfo.disabled);
+      });
+    },
+    [configurableFlowsAndSteps]
+  );
   const handleMenuClick = (0, import_react.useCallback)(
     ({ key }) => {
       const originalKey = key;
@@ -324,6 +359,9 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
         extra.onClick();
         return;
       }
+      if (isStepMenuItemDisabled(cleanKey)) {
+        return;
+      }
       switch (cleanKey) {
         case "copy-uid":
           closeDropdown();
@@ -337,7 +375,15 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
           break;
       }
     },
-    [closeDropdown, handleCopyUid, handleDelete, handleStepConfiguration, handleCopyPopupUid, extraMenuItems]
+    [
+      closeDropdown,
+      handleCopyUid,
+      handleDelete,
+      handleStepConfiguration,
+      handleCopyPopupUid,
+      extraMenuItems,
+      isStepMenuItemDisabled
+    ]
   );
   const getModelConfigurableFlowsAndSteps = (0, import_react.useCallback)(
     async (targetModel, modelKey) => {
@@ -355,6 +401,7 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
                 if (await (0, import_utils.shouldHideStepInSettings)(targetModel, flow, actionStep)) {
                   return null;
                 }
+                const disabledState = await (0, import_utils.resolveStepDisabledInSettings)(targetModel, flow, actionStep);
                 let uiMode = await (0, import_utils.resolveUiMode)(actionStep.uiMode, targetModel.context);
                 const hasStepUiSchema = actionStep.uiSchema != null;
                 let hasActionUiSchema = false;
@@ -392,7 +439,9 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
                   title: t(stepTitle) || stepKey,
                   modelKey,
                   // 添加模型标识
-                  uiMode
+                  uiMode,
+                  disabled: disabledState.disabled,
+                  disabledReason: disabledState.reason
                 };
               })
             ).then((steps) => steps.filter(Boolean));
@@ -423,8 +472,6 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
     }
     return result;
   }, [model, menuLevels, getModelConfigurableFlowsAndSteps]);
-  const [configurableFlowsAndSteps, setConfigurableFlowsAndSteps] = (0, import_react.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react.useState)(true);
   (0, import_react.useEffect)(() => {
     const triggerRebuild = /* @__PURE__ */ __name(() => {
       setRefreshTick((v) => v + 1);
@@ -517,11 +564,15 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
                 }
               }, "onChange"),
               ...(uiMode == null ? void 0 : uiMode.props) || {},
-              itemKey: uiMode == null ? void 0 : uiMode.key
+              itemKey: uiMode == null ? void 0 : uiMode.key,
+              disabled: !!stepInfo.disabled,
+              disabledReason: stepInfo.disabledReason,
+              disabledIconColor
             };
             items.push({
               key: uniqueKey,
-              label: /* @__PURE__ */ import_react.default.createElement(MenuLabelItem, { title: t(stepInfo.title), uiMode, itemProps })
+              label: /* @__PURE__ */ import_react.default.createElement(MenuLabelItem, { title: stepInfo.title, uiMode, itemProps }),
+              disabled: !!stepInfo.disabled
             });
           });
           if (flow.options.divider === "bottom") {
@@ -555,7 +606,8 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
                 const uniqueKey = generateUniqueKey(`${flow.key}:${stepInfo.stepKey}`);
                 items.push({
                   key: uniqueKey,
-                  label: t(stepInfo.title)
+                  label: stepInfo.disabled ? /* @__PURE__ */ import_react.default.createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: 6 } }, stepInfo.title, /* @__PURE__ */ import_react.default.createElement(import_antd.Tooltip, { title: stepInfo.disabledReason, placement: "right", destroyTooltipOnHide: true }, /* @__PURE__ */ import_react.default.createElement(import_icons.QuestionCircleOutlined, { style: { color: disabledIconColor } }))) : stepInfo.title,
+                  disabled: !!stepInfo.disabled
                 });
               });
             });
@@ -567,7 +619,8 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
                 const uniqueKey = generateUniqueKey(`${modelKey}:${flow.key}:${stepInfo.stepKey}`);
                 subMenuChildren.push({
                   key: uniqueKey,
-                  label: t(stepInfo.title)
+                  label: stepInfo.disabled ? /* @__PURE__ */ import_react.default.createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: 6 } }, stepInfo.title, /* @__PURE__ */ import_react.default.createElement(import_antd.Tooltip, { title: stepInfo.disabledReason, placement: "right", destroyTooltipOnHide: true }, /* @__PURE__ */ import_react.default.createElement(import_icons.QuestionCircleOutlined, { style: { color: disabledIconColor } }))) : stepInfo.title,
+                  disabled: !!stepInfo.disabled
                 });
               });
             });
@@ -581,7 +634,7 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
       }
     }
     return items;
-  }, [configurableFlowsAndSteps, flattenSubMenus, t]);
+  }, [configurableFlowsAndSteps, disabledIconColor, flattenSubMenus, t]);
   const finalMenuItems = (0, import_react.useMemo)(() => {
     const items = [...menuItems];
     const commonExtras = extraMenuItems.filter((it) => it.group === "common-actions").sort((a, b) => (a.sort ?? 0) - (b.sort ?? 0));

package/lib/components/settings/wrappers/contextual/FlowsContextMenu.js

@@ -61,6 +61,20 @@ const FlowsContextMenu = /* @__PURE__ */ __name((props) => {
 const FlowsContextMenuWithModel = (0, import_reactive.observer)(
   ({ model, children, enabled = true, position = "right", showDeleteButton = true }) => {
     const t = (0, import_utils.getT)(model);
+    const { token } = import_antd.theme.useToken();
+    const disabledIconColor = (token == null ? void 0 : token.colorTextTertiary) || (token == null ? void 0 : token.colorTextDescription) || (token == null ? void 0 : token.colorTextSecondary);
+    const [configurableFlowsAndSteps, setConfigurableFlowsAndSteps] = (0, import_react.useState)([]);
+    const isStepMenuItemDisabled = (0, import_react.useCallback)(
+      (key) => {
+        const [flowKey, stepKey] = key.split(":");
+        if (!flowKey || !stepKey) return false;
+        return configurableFlowsAndSteps.some(({ flow, steps }) => {
+          if (flow.key !== flowKey) return false;
+          return steps.some((stepInfo) => stepInfo.stepKey === stepKey && !!stepInfo.disabled);
+        });
+      },
+      [configurableFlowsAndSteps]
+    );
     const handleMenuClick = (0, import_react.useCallback)(
       ({ key }) => {
         var _a;
@@ -86,6 +100,9 @@ const FlowsContextMenuWithModel = (0, import_reactive.observer)(
             }
           });
         } else {
+          if (isStepMenuItemDisabled(key)) {
+            return;
+          }
           const [flowKey, stepKey] = key.split(":");
           try {
             const flow = model.getFlow(flowKey);
@@ -108,7 +125,7 @@ const FlowsContextMenuWithModel = (0, import_reactive.observer)(
           }
         }
       },
-      [model]
+      [isStepMenuItemDisabled, model]
     );
     if (!model) {
       return /* @__PURE__ */ import_react.default.createElement(import_antd.Alert, { message: "\u63D0\u4F9B\u7684\u6A21\u578B\u65E0\u6548", type: "error" });
@@ -129,6 +146,7 @@ const FlowsContextMenuWithModel = (0, import_reactive.observer)(
                 if (await (0, import_utils.shouldHideStepInSettings)(model, flow, actionStep)) {
                   return null;
                 }
+                const disabledState = await (0, import_utils.resolveStepDisabledInSettings)(model, flow, actionStep);
                 const stepUiSchema = actionStep.uiSchema || {};
                 let actionUiSchema = {};
                 if (actionStep.use) {
@@ -152,7 +170,9 @@ const FlowsContextMenuWithModel = (0, import_reactive.observer)(
                   stepKey,
                   step: actionStep,
                   uiSchema: mergedUiSchema,
-                  title: actionStep.title || stepKey
+                  title: actionStep.title || stepKey,
+                  disabled: disabledState.disabled,
+                  disabledReason: disabledState.reason
                 };
               })
             ).then((steps) => steps.filter(Boolean));
@@ -165,7 +185,6 @@ const FlowsContextMenuWithModel = (0, import_reactive.observer)(
         return [];
       }
     }, [model]);
-    const [configurableFlowsAndSteps, setConfigurableFlowsAndSteps] = (0, import_react.useState)([]);
     (0, import_react.useEffect)(() => {
       let mounted = true;
       (async () => {
@@ -193,7 +212,8 @@ const FlowsContextMenuWithModel = (0, import_reactive.observer)(
           menuItems.push({
             key: `${flow.key}:${stepInfo.stepKey}`,
             icon: /* @__PURE__ */ import_react.default.createElement(import_icons.SettingOutlined, null),
-            label: stepInfo.title
+            label: stepInfo.disabled ? /* @__PURE__ */ import_react.default.createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: 6 } }, stepInfo.title, /* @__PURE__ */ import_react.default.createElement(import_antd.Tooltip, { title: stepInfo.disabledReason, placement: "right", destroyTooltipOnHide: true }, /* @__PURE__ */ import_react.default.createElement(import_icons.QuestionCircleOutlined, { style: { color: disabledIconColor } }))) : stepInfo.title,
+            disabled: !!stepInfo.disabled
           });
         });
       });

package/lib/components/variables/VariableInput.js

@@ -198,8 +198,7 @@ const VariableInputComponent = /* @__PURE__ */ __name(({
   (0, import_react.useEffect)(() => {
     if (!resolvedMetaTreeNode) return;
     if (!Array.isArray(resolvedMetaTree) || innerValue == null) return;
-    const finalValue = (resolveValueFromPath == null ? void 0 : resolveValueFromPath(resolvedMetaTreeNode)) || innerValue;
-    emitChange(finalValue, resolvedMetaTreeNode);
+    emitChange(innerValue, resolvedMetaTreeNode);
     setCurrentMetaTreeNode(resolvedMetaTreeNode);
   }, [resolvedMetaTreeNode]);
   const composingRef = (0, import_react.useRef)(false);

package/lib/components/variables/VariableTag.js

@@ -59,53 +59,60 @@ const VariableTagComponent = /* @__PURE__ */ __name(({
   const ctx = (0, import_FlowContextProvider.useFlowContext)();
   const { data: displayedValue } = (0, import_ahooks.useRequest)(
     async () => {
-      if (metaTreeNode) {
-        return metaTreeNode.parentTitles ? [...metaTreeNode.parentTitles, metaTreeNode.title].map(ctx.t).join("/") : ctx.t(metaTreeNode.title) || "";
-      }
-      if (!value) return String(value);
-      const rawPath = (0, import_utils.parseValueToPath)(value);
-      if (!rawPath || !Array.isArray(resolvedMetaTree)) {
-        return Array.isArray(rawPath) ? rawPath.join("/") : String(value);
-      }
-      const topNames = new Set((resolvedMetaTree || []).map((n) => String(n == null ? void 0 : n.name)));
-      const path = !topNames.has(String(rawPath[0])) ? rawPath.slice(1) : rawPath;
-      if (!path.length) return "";
-      let nodes = resolvedMetaTree;
-      let deepest = null;
-      let matchedCount = 0;
-      for (let i = 0; i < path.length; i++) {
-        if (!nodes) break;
-        const seg = String(path[i]);
-        const node = nodes.find((n) => String(n == null ? void 0 : n.name) === seg);
-        if (!node) break;
-        deepest = node;
-        matchedCount = i + 1;
-        if (i < path.length - 1) {
-          if (Array.isArray(node.children)) {
-            nodes = node.children;
-          } else if (typeof node.children === "function") {
-            try {
-              const childNodes = await node.children();
-              node.children = childNodes;
-              nodes = childNodes;
-            } catch {
+      const resolveLabelFromPath = /* @__PURE__ */ __name(async (rawPath2) => {
+        if (!rawPath2) return null;
+        if (!Array.isArray(rawPath2)) return null;
+        if (!Array.isArray(resolvedMetaTree)) return null;
+        const topNames = new Set((resolvedMetaTree || []).map((n) => String(n == null ? void 0 : n.name)));
+        const path = !topNames.has(String(rawPath2[0])) ? rawPath2.slice(1) : rawPath2;
+        if (!path.length) return "";
+        let nodes = resolvedMetaTree;
+        const titleChain = [];
+        let matchedCount = 0;
+        for (let i = 0; i < path.length; i++) {
+          if (!nodes) break;
+          const seg = String(path[i]);
+          const node = nodes.find((n) => String(n == null ? void 0 : n.name) === seg);
+          if (!node) break;
+          titleChain.push(String(node.title ?? node.name ?? seg));
+          matchedCount = i + 1;
+          if (i < path.length - 1) {
+            if (Array.isArray(node.children)) {
+              nodes = node.children;
+            } else if (typeof node.children === "function") {
+              try {
+                const childNodes = await node.children();
+                node.children = childNodes;
+                nodes = childNodes;
+              } catch {
+                nodes = void 0;
+              }
+            } else {
               nodes = void 0;
             }
-          } else {
-            nodes = void 0;
           }
         }
-      }
-      if (deepest) {
-        const titles = deepest.parentTitles ? [...deepest.parentTitles, deepest.title] : [deepest.title];
-        let label = titles.map(ctx.t).join("/");
+        if (matchedCount === 0) return null;
+        let label2 = titleChain.map(ctx.t).join("/");
         if (matchedCount < path.length) {
           const tail = path.slice(matchedCount).join("/");
-          label = tail ? `${label}/${tail}` : label;
+          label2 = tail ? `${label2}/${tail}` : label2;
         }
-        return label;
+        return label2;
+      }, "resolveLabelFromPath");
+      if (metaTreeNode == null ? void 0 : metaTreeNode.parentTitles) {
+        return [...metaTreeNode.parentTitles, metaTreeNode.title].map(ctx.t).join("/");
+      }
+      if (metaTreeNode) {
+        const rawPath2 = (0, import_utils.parseValueToPath)(value) || metaTreeNode.paths;
+        const label2 = await resolveLabelFromPath(rawPath2);
+        return label2 ?? ctx.t(metaTreeNode.title) ?? "";
       }
-      return path.join("/");
+      if (!value) return String(value);
+      const rawPath = (0, import_utils.parseValueToPath)(value);
+      const label = await resolveLabelFromPath(rawPath);
+      if (label != null) return label;
+      return Array.isArray(rawPath) ? rawPath.join("/") : String(value);
     },
     { refreshDeps: [resolvedMetaTree, value, metaTreeNode] }
   );

package/lib/data-source/index.js

@@ -118,7 +118,7 @@ const _DataSource = class _DataSource {
     return this.dataSourceManager.flowEngine;
   }
   get displayName() {
-    return this.options.displayName ? this.flowEngine.translate(this.options.displayName) : this.key;
+    return this.flowEngine.translate(this.options.displayName, { ns: "lm-collections" }) || this.key;
   }
   get key() {
     return this.options.key;
@@ -457,7 +457,7 @@ const _Collection = class _Collection {
     return this.options.storage || "local";
   }
   get title() {
-    return this.options.title ? this.flowEngine.translate(this.options.title) : this.name;
+    return this.flowEngine.translate(this.options.title, { ns: "lm-collections" }) || this.name;
   }
   get titleCollectionField() {
     const titleFieldName = this.options.titleField || this.filterTargetKey;
@@ -692,8 +692,8 @@ const _CollectionField = class _CollectionField {
   }
   get title() {
     var _a, _b, _c;
-    const titleValue = ((_b = (_a = this.options) == null ? void 0 : _a.uiSchema) == null ? void 0 : _b.title) || ((_c = this.options) == null ? void 0 : _c.title) || this.options.name;
-    return this.flowEngine.translate(titleValue);
+    const titleValue = ((_b = (_a = this.options) == null ? void 0 : _a.uiSchema) == null ? void 0 : _b.title) || ((_c = this.options) == null ? void 0 : _c.title);
+    return this.flowEngine.translate(titleValue, { ns: "lm-collections" }) || this.options.name;
   }
   set title(value) {
     this.options.title = value;
@@ -711,11 +711,17 @@ const _CollectionField = class _CollectionField {
         }
         return {
           ...v,
+          label: v.label ? this.flowEngine.translate(v.label, { ns: "lm-collections" }) : v.label,
           value: Number(v.value)
         };
       });
     }
-    return options;
+    return options.map((v) => {
+      return {
+        ...v,
+        label: this.flowEngine.translate(v.label, { ns: "lm-collections" })
+      };
+    });
   }
   get defaultValue() {
     return this.options.defaultValue == null ? void 0 : this.options.defaultValue;

package/lib/flowContext.js

@@ -830,7 +830,8 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
       value: this.engine
     });
     this.defineProperty("sql", {
-      get: /* @__PURE__ */ __name(() => new import_resources.FlowSQLRepository(this), "get")
+      get: /* @__PURE__ */ __name((ctx) => new import_resources.FlowSQLRepository(ctx), "get"),
+      cache: false
     });
     this.defineProperty("dataSourceManager", {
       value: dataSourceManager
@@ -1120,6 +1121,9 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
       const modelClass = (0, import_registry.getModelClassName)(this);
       const Ctor = import_registry.RunJSContextRegistry.resolve(version, modelClass) || FlowRunJSContext;
       const runCtx = new Ctor(this);
+      runCtx.defineMethod("t", (key, options2) => {
+        return this.t(key, { ns: "runjs", ...options2 });
+      });
       const globals = { ctx: runCtx, ...(options == null ? void 0 : options.globals) || {} };
       const { timeoutMs } = options || {};
       return new import_JSRunner.JSRunner({ globals, timeoutMs });

package/lib/flowI18n.js

@@ -56,11 +56,13 @@ const _FlowI18n = class _FlowI18n {
     if (!keyOrTemplate || typeof keyOrTemplate !== "string") {
       return keyOrTemplate;
     }
-    let result = this.translateKey(keyOrTemplate, options);
-    if (this.isTemplate(result)) {
-      result = this.compileTemplate(result);
+    if ((options == null ? void 0 : options.compareWith) && keyOrTemplate === options.compareWith) {
+      return keyOrTemplate;
+    }
+    if (this.isTemplate(keyOrTemplate)) {
+      return this.compileTemplate(keyOrTemplate);
     }
-    return result;
+    return this.translateKey(keyOrTemplate, options);
   }
   /**
    * 内部翻译方法

package/lib/locale/en-US.json

@@ -62,6 +62,7 @@
   "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",
+  "Use return to output value": "Use return to output value",
   "Try again": "Try again",
   "Template created": "Template created",
   "Template description": "Template description",
@@ -70,4 +71,4 @@
   "UID copied to clipboard": "UID copied to clipboard",
   "createModelOptions must specify use property": "createModelOptions must specify \"use\" property",
   "here": "here"
-}
+}

package/lib/locale/index.d.ts

@@ -71,6 +71,7 @@ export declare const locales: {
         "This is likely a NocoBase internals bug. Please open an issue at": string;
         "This step has no configurable parameters": string;
         "This variable is not available": string;
+        "Use return to output value": string;
         "Try again": string;
         "Template created": string;
         "Template description": string;
@@ -148,6 +149,7 @@ export declare const locales: {
         "This is likely a NocoBase internals bug. Please open an issue at": string;
         "This step has no configurable parameters": string;
         "This variable is not available": string;
+        "Use return to output value": string;
         "Try again": string;
         "UID copied to clipboard": string;
         "createModelOptions must specify use property": string;

package/lib/locale/zh-CN.json

@@ -66,6 +66,7 @@
   "This is likely a NocoBase internals bug. Please open an issue at": "这可能是 NocoBase 内部错误。请在以下地址提交问题",
   "This step has no configurable parameters": "此步骤没有可配置的参数",
   "This variable is not available": "此变量不可用",
+  "Use return to output value": "使用 return 返回最终值",
   "Try again": "重试",
   "UID copied to clipboard": "UID 已复制到剪贴板",
   "createModelOptions must specify use property": "createModelOptions 必须指定 \"use\" 属性",

package/lib/resources/sqlResource.d.ts

@@ -6,7 +6,7 @@
  * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
-import { FlowEngineContext } from '../flowContext';
+import { FlowContext, FlowEngineContext } from '../flowContext';
 import { BaseRecordResource } from './baseRecordResource';
 type SQLRunOptions = {
     bind?: Record<string, any>;
@@ -20,8 +20,8 @@ type SQLSaveOptions = {
     dataSourceKey?: string;
 };
 export declare class FlowSQLRepository {
-    protected ctx: FlowEngineContext;
-    constructor(ctx: FlowEngineContext);
+    protected ctx: FlowContext;
+    constructor(ctx: FlowContext);
     run(sql: string, options?: SQLRunOptions): Promise<any>;
     save(data: SQLSaveOptions): Promise<void>;
     runById(uid: string, options?: SQLRunOptions): Promise<any>;

package/lib/types.d.ts

@@ -147,6 +147,18 @@ export interface ActionDefinition<TModel extends FlowModel = FlowModel, TCtx ext
      * - StepDefinition.hideInSettings can override the ActionDefinition value.
      */
     hideInSettings?: boolean | ((ctx: TCtx) => boolean | Promise<boolean>);
+    /**
+     * Whether to disable this step/action in settings menus.
+     * - Supports static boolean and dynamic decision based on runtime context.
+     * - StepDefinition.disabledInSettings can override the ActionDefinition value.
+     */
+    disabledInSettings?: boolean | ((ctx: TCtx) => boolean | Promise<boolean>);
+    /**
+     * Optional reason shown when this step/action is disabled in settings menus.
+     * - Supports static string and dynamic resolver based on runtime context.
+     * - StepDefinition.disabledReasonInSettings can override the ActionDefinition value.
+     */
+    disabledReasonInSettings?: string | ((ctx: TCtx) => string | Promise<string>);
     /**
      * 在执行 Action 前为 ctx 定义临时属性。
      * - 仅支持 PropertyOptions 形态（例如：{ foo: { value: 5 } }）；

package/lib/utils/associationObjectVariable.d.ts

@@ -9,7 +9,7 @@
 import type { Collection } from '../data-source';
 import type { FlowContext, PropertyMetaFactory } from '../flowContext';
 /**
- * 创建一个用于“对象类变量”（如 formValues / currentObject）的 `resolveOnServer` 判定函数。
+ * 创建一个用于“对象类变量”（如 formValues / item）的 `resolveOnServer` 判定函数。
  * 仅当访问路径以“关联字段名”开头（且继续访问其子属性）时，返回 true 交由服务端解析；
  * 否则在前端解析即可。
  *
@@ -26,7 +26,7 @@ export declare function createAssociationSubpathResolver(collectionAccessor: ()
  *
  * @param collectionAccessor 获取集合对象，用于字段/元信息来源
  * @param title 变量组标题（用于 UI 展示）
- * @param valueAccessor 获取当前对象值（如 ctx.form.getFieldsValue() / ctx.currentObject）
+ * @param valueAccessor 获取当前对象值（如 ctx.form.getFieldsValue() / ctx.item）
  * @returns PropertyMetaFactory
  */
 export declare function createAssociationAwareObjectMetaFactory(collectionAccessor: () => Collection | null, title: string, valueAccessor: (ctx: FlowContext) => any): PropertyMetaFactory;

package/lib/utils/index.d.ts

@@ -12,7 +12,7 @@ export { FlowExitException } from './exceptions';
 export { defineAction } from './flow-definitions';
 export { isInheritedFrom } from './inheritance';
 export { resolveCreateModelOptions, resolveDefaultParams, resolveExpressions } from './params-resolvers';
-export { compileUiSchema, resolveStepUiSchema, resolveUiMode, shouldHideStepInSettings } from './schema-utils';
+export { compileUiSchema, resolveStepUiSchema, resolveStepDisabledInSettings, resolveUiMode, shouldHideStepInSettings, } from './schema-utils';
 export { setupRuntimeContextSteps } from './setupRuntimeContextSteps';
 export { createCollectionContextMeta } from './createCollectionContextMeta';
 export { createAssociationAwareObjectMetaFactory, createAssociationSubpathResolver } from './associationObjectVariable';
@@ -20,7 +20,9 @@ export { buildRecordMeta, collectContextParamsForTemplate, createCurrentRecordMe
 export { extractPropertyPath, formatPathToVariable, isVariableExpression } from './context';
 export { clearAutoFlowError, getAutoFlowError, setAutoFlowError, type AutoFlowError } from './autoFlowError';
 export { parsePathnameToViewParams, type ViewParam } from './parsePathnameToViewParams';
-export { createSafeDocument, createSafeWindow, createSafeNavigator } from './safeGlobals';
+export { createSafeDocument, createSafeWindow, createSafeNavigator, createSafeRunJSGlobals, runjsWithSafeGlobals, } from './safeGlobals';
+export { isRunJSValue, normalizeRunJSValue, extractUsedVariablePathsFromRunJS, type RunJSValue } from './runjsValue';
+export { resolveRunJSObjectValues } from './resolveRunJSObjectValues';
 export { prepareRunJsCode, preprocessRunJsTemplates } from './runjsTemplateCompat';
 export { createEphemeralContext } from './createEphemeralContext';
 export { pruneFilter } from './pruneFilter';