@nocobase/flow-engine 2.0.0-alpha.7 → 2.0.0-alpha.71

package/lib/flowContext.js

@@ -51,7 +51,7 @@ __export(flowContext_exports, {
   FlowEngineContext: () => FlowEngineContext,
   FlowForkModelContext: () => FlowForkModelContext,
   FlowModelContext: () => FlowModelContext,
-  FlowRunjsContext: () => FlowRunjsContext,
+  FlowRunJSContext: () => FlowRunJSContext,
   FlowRuntimeContext: () => FlowRuntimeContext
 });
 module.exports = __toCommonJS(flowContext_exports);
@@ -60,18 +60,25 @@ var antd = __toESM(require("antd"));
 var import_lodash = __toESM(require("lodash"));
 var import_qs = __toESM(require("qs"));
 var import_react = __toESM(require("react"));
+var ReactDOMClient = __toESM(require("react-dom/client"));
+var import_ElementProxy = require("./ElementProxy");
 var import_Acl = require("./acl/Acl");
 var import_ContextPathProxy = require("./ContextPathProxy");
 var import_data_source = require("./data-source");
 var import_flowEngine = require("./flowEngine");
 var import_flowI18n = require("./flowI18n");
 var import_JSRunner = require("./JSRunner");
-var import_models = require("./models");
 var import_resources = require("./resources");
 var import_utils = require("./utils");
 var import_exceptions = require("./utils/exceptions");
 var import_params_resolvers = require("./utils/params-resolvers");
 var import_serverContextParams = require("./utils/serverContextParams");
+var import_variablesParams = require("./utils/variablesParams");
+var import_registry = require("./runjs-context/registry");
+var import_createEphemeralContext = require("./utils/createEphemeralContext");
+var import_dayjs = __toESM(require("dayjs"));
+var import_runjsLibs = require("./runjsLibs");
+var import_runjsModuleLoader = require("./utils/runjsModuleLoader");
 var _proxy, _FlowContext_instances, createChildNodes_fn, findMetaByPath_fn, findMetaInDelegatesDeep_fn, findMetaInProperty_fn, resolvePathInMeta_fn, resolvePathInMetaAsync_fn, buildParentTitles_fn, toTreeNode_fn;
 function isRecordRefLike(val) {
   return !!(val && typeof val === "object" && "collection" in val && "filterByTk" in val);
@@ -91,6 +98,50 @@ function filterBuilderOutputByPaths(built, neededPaths) {
   return void 0;
 }
 __name(filterBuilderOutputByPaths, "filterBuilderOutputByPaths");
+function topLevelOf(subPath) {
+  if (!subPath) return void 0;
+  const m = String(subPath).match(/^([^.[]+)/);
+  return m == null ? void 0 : m[1];
+}
+__name(topLevelOf, "topLevelOf");
+function inferSelectsFromUsage(paths = []) {
+  if (!Array.isArray(paths) || paths.length === 0) {
+    return { generatedAppends: void 0, generatedFields: void 0 };
+  }
+  const appendSet = /* @__PURE__ */ new Set();
+  const fieldSet = /* @__PURE__ */ new Set();
+  const normalizePath = /* @__PURE__ */ __name((raw) => {
+    if (!raw) return "";
+    let s = String(raw);
+    s = s.replace(/\[(?:\d+)\]/g, "");
+    s = s.replace(/\[(?:"((?:[^"\\]|\\.)*)"|'((?:[^'\\]|\\.)*)')\]/g, (_m, g1, g2) => `.${g1 || g2}`);
+    s = s.replace(/\.\.+/g, ".");
+    s = s.replace(/^\./, "").replace(/\.$/, "");
+    return s;
+  }, "normalizePath");
+  for (let path of paths) {
+    if (!path) continue;
+    while (/^\[(\d+)\](\.|$)/.test(path)) {
+      path = path.replace(/^\[(\d+)\]\.?/, "");
+    }
+    const norm = normalizePath(path);
+    if (!norm) continue;
+    const segments = norm.split(".").filter(Boolean);
+    if (segments.length === 0) continue;
+    if (segments.length === 1) {
+      fieldSet.add(segments[0]);
+      continue;
+    }
+    for (let i = 0; i < segments.length - 1; i++) {
+      appendSet.add(segments.slice(0, i + 1).join("."));
+    }
+    fieldSet.add(segments.join("."));
+  }
+  const generatedAppends = appendSet.size ? Array.from(appendSet) : void 0;
+  const generatedFields = fieldSet.size ? Array.from(fieldSet) : void 0;
+  return { generatedAppends, generatedFields };
+}
+__name(inferSelectsFromUsage, "inferSelectsFromUsage");
 const _FlowContext = class _FlowContext {
   constructor() {
     __privateAdd(this, _FlowContext_instances);
@@ -418,6 +469,73 @@ const _FlowContext = class _FlowContext {
     }
     return this._findPropertyInDelegates(this._delegates, key);
   }
+  /**
+   * 获取当前上下文可用的顶层 API 信息（主要用于编辑器补全/工具）。
+   *
+   * 注意：
+   * - 目前返回值以“尽量可用”为目标，允许不完整。
+   * - 该方法不会展开变量 meta（变量结构应由 `getPropertyMetaTree()`/VariableInput 等机制负责）。
+   */
+  async getApiInfos(options = {}) {
+    var _a, _b, _c, _d, _e;
+    const version = (options == null ? void 0 : options.version) || "v1";
+    const modelClass = (0, import_registry.getModelClassName)(this);
+    const Ctor = import_registry.RunJSContextRegistry.resolve(version, modelClass) || import_registry.RunJSContextRegistry.resolve(version, "*");
+    const locale = ((_b = (_a = this == null ? void 0 : this.api) == null ? void 0 : _a.auth) == null ? void 0 : _b.locale) || ((_c = this == null ? void 0 : this.i18n) == null ? void 0 : _c.language) || (this == null ? void 0 : this.locale);
+    let doc = {};
+    try {
+      if ((_d = Ctor == null ? void 0 : Ctor.getDoc) == null ? void 0 : _d.length) doc = Ctor.getDoc(locale) || {};
+      else doc = ((_e = Ctor == null ? void 0 : Ctor.getDoc) == null ? void 0 : _e.call(Ctor)) || {};
+    } catch (_2) {
+      doc = {};
+    }
+    const isPrivateKey = /* @__PURE__ */ __name((key) => typeof key === "string" && key.startsWith("_"), "isPrivateKey");
+    const out = {};
+    const visited = /* @__PURE__ */ new WeakSet();
+    const walk = /* @__PURE__ */ __name((ctx) => {
+      if (!ctx || visited.has(ctx)) return;
+      visited.add(ctx);
+      try {
+        for (const key of Object.keys(ctx._props || {})) {
+          if (isPrivateKey(key)) continue;
+          if (typeof out[key] === "undefined") out[key] = { type: "property" };
+        }
+      } catch (_2) {
+      }
+      try {
+        for (const key of Object.keys(ctx._methods || {})) {
+          if (isPrivateKey(key)) continue;
+          if (typeof out[key] === "undefined") out[key] = { type: "function" };
+        }
+      } catch (_2) {
+      }
+      try {
+        const delegates = Array.isArray(ctx._delegates) ? ctx._delegates : [];
+        for (const d of delegates) walk(d);
+      } catch (_2) {
+      }
+    }, "walk");
+    walk(this);
+    return {
+      ...out,
+      ...(doc == null ? void 0 : doc.properties) || {},
+      ...(doc == null ? void 0 : doc.methods) || {}
+    };
+  }
+  /**
+   * 变量结构信息（保留给编辑器/工具使用）。
+   * 当前实现为保底空对象，避免 RunJS doc 中补全到该方法时调用报错。
+   */
+  async getVarInfos(_options = {}) {
+    return {};
+  }
+  /**
+   * 运行时环境信息（保留给编辑器/工具使用）。
+   * 当前实现为保底空对象，避免 RunJS doc 中补全到该方法时调用报错。
+   */
+  async getEnvInfos() {
+    return {};
+  }
 };
 _proxy = new WeakMap();
 _FlowContext_instances = new WeakSet();
@@ -585,12 +703,13 @@ toTreeNode_fn = /* @__PURE__ */ __name(function(name, metaOrFactory, paths = [na
     return cached;
   }
   let node;
-  const computeDisabledFromMeta = /* @__PURE__ */ __name((m) => {
-    if (!m) return { disabled: false };
+  const computeStateFromMeta = /* @__PURE__ */ __name((m) => {
+    if (!m) return { disabled: false, hidden: false };
     const disabledVal = typeof m.disabled === "function" ? m.disabled() : m.disabled;
     const reason = typeof m.disabledReason === "function" ? m.disabledReason() : m.disabledReason;
-    return { disabled: !!disabledVal, reason };
-  }, "computeDisabledFromMeta");
+    const hiddenVal = typeof m.hidden === "function" ? m.hidden() : m.hidden;
+    return { disabled: !!disabledVal, reason, hidden: !!hiddenVal };
+  }, "computeStateFromMeta");
   if (typeof metaOrFactory === "function") {
     const initialTitle = name;
     const hasChildrenHint = metaOrFactory.hasChildren;
@@ -601,19 +720,25 @@ toTreeNode_fn = /* @__PURE__ */ __name(function(name, metaOrFactory, paths = [na
       type: "object",
       // 初始类型
       interface: void 0,
+      options: void 0,
       uiSchema: void 0,
       paths,
       parentTitles: parentTitles.length > 0 ? parentTitles : void 0,
       disabled: /* @__PURE__ */ __name(() => {
         const maybe = metaOrFactory();
         if (maybe && typeof maybe["then"] === "function") return false;
-        return computeDisabledFromMeta(maybe).disabled;
+        return computeStateFromMeta(maybe).disabled;
       }, "disabled"),
       disabledReason: /* @__PURE__ */ __name(() => {
         const maybe = metaOrFactory();
         if (maybe && typeof maybe["then"] === "function") return void 0;
-        return computeDisabledFromMeta(maybe).reason;
+        return computeStateFromMeta(maybe).reason;
       }, "disabledReason"),
+      hidden: /* @__PURE__ */ __name(() => {
+        const maybe = metaOrFactory();
+        if (maybe && typeof maybe["then"] === "function") return false;
+        return computeStateFromMeta(maybe).hidden;
+      }, "hidden"),
       // 注意：即便 hasChildren === false，也只是“没有子节点”的 UI 提示；
       // 节点自身依然通过 meta 工厂保持惰性特性（需要时可解析出 title/type 等）。
       // 这里仅在 hasChildren !== false 时，提供子节点的懒加载逻辑。
@@ -624,6 +749,7 @@ toTreeNode_fn = /* @__PURE__ */ __name(function(name, metaOrFactory, paths = [na
           node.title = finalTitle;
           node.type = meta == null ? void 0 : meta.type;
           node.interface = meta == null ? void 0 : meta.interface;
+          node.options = meta == null ? void 0 : meta.options;
           node.uiSchema = meta == null ? void 0 : meta.uiSchema;
           if (!(meta == null ? void 0 : meta.properties)) return [];
           const childNodes = __privateMethod(this, _FlowContext_instances, createChildNodes_fn).call(this, meta.properties, paths, [...parentTitles, finalTitle], meta);
@@ -638,17 +764,19 @@ toTreeNode_fn = /* @__PURE__ */ __name(function(name, metaOrFactory, paths = [na
     };
   } else {
     const nodeTitle = metaOrFactory.title;
-    const { disabled, reason } = computeDisabledFromMeta(metaOrFactory);
+    const { disabled, reason, hidden } = computeStateFromMeta(metaOrFactory);
     node = {
       name,
       title: nodeTitle,
       type: metaOrFactory.type,
       interface: metaOrFactory.interface,
+      options: metaOrFactory.options,
       uiSchema: metaOrFactory.uiSchema,
       paths,
       parentTitles: parentTitles.length > 0 ? parentTitles : void 0,
       disabled,
       disabledReason: reason,
+      hidden,
       children: metaOrFactory.properties ? __privateMethod(this, _FlowContext_instances, createChildNodes_fn).call(this, metaOrFactory.properties, paths, [...parentTitles, nodeTitle], metaOrFactory) : void 0
     };
   }
@@ -657,36 +785,25 @@ toTreeNode_fn = /* @__PURE__ */ __name(function(name, metaOrFactory, paths = [na
 }, "#toTreeNode");
 __name(_FlowContext, "FlowContext");
 let FlowContext = _FlowContext;
-const _FlowRunjsContext = class _FlowRunjsContext extends FlowContext {
-  constructor(delegate) {
+const _BaseFlowEngineContext = class _BaseFlowEngineContext extends FlowContext {
+  constructor() {
     super();
-    this.addDelegate(delegate);
-    this.defineProperty("React", { value: import_react.default });
-    this.defineProperty("antd", { value: antd });
     this.defineMethod(
-      "dispatchModelEvent",
-      async (modelOrUid, eventName, inputArgs) => {
-        var _a, _b;
-        let model = null;
-        if (typeof modelOrUid === "string") {
-          model = await this.engine.loadModel({ uid: modelOrUid });
-        } else if (modelOrUid instanceof import_models.FlowModel) {
-          model = modelOrUid;
-        }
-        if (model) {
-          model.context.addDelegate(this);
-          model.dispatchEvent(eventName, { navigation: false, ...(_b = (_a = this.model) == null ? void 0 : _a["getInputArgs"]) == null ? void 0 : _b.call(_a), ...inputArgs });
-        } else {
-          this.message.error(this.t("Model with ID {{uid}} not found", { uid: modelOrUid }));
-        }
+      "runjs",
+      async function(code, variables, options) {
+        const { preprocessTemplates, ...runnerOptions } = options || {};
+        const mergedGlobals = { ...(runnerOptions == null ? void 0 : runnerOptions.globals) || {}, ...variables || {} };
+        const runner = await this.createJSRunner({
+          ...runnerOptions || {},
+          globals: mergedGlobals
+        });
+        const shouldPreprocessTemplates = preprocessTemplates !== false;
+        const jsCode = await (0, import_utils.prepareRunJsCode)(String(code ?? ""), { preprocessTemplates: shouldPreprocessTemplates });
+        return runner.run(jsCode);
       }
     );
   }
 };
-__name(_FlowRunjsContext, "FlowRunjsContext");
-let FlowRunjsContext = _FlowRunjsContext;
-const _BaseFlowEngineContext = class _BaseFlowEngineContext extends FlowContext {
-};
 __name(_BaseFlowEngineContext, "BaseFlowEngineContext");
 let BaseFlowEngineContext = _BaseFlowEngineContext;
 const _BaseFlowModelContext = class _BaseFlowModelContext extends BaseFlowEngineContext {
@@ -713,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
@@ -722,14 +840,6 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
     this.defineMethod("t", (keyOrTemplate, options) => {
       return i18n.translate(keyOrTemplate, options);
     });
-    this.defineMethod("runjs", async (code, variables, options) => {
-      const mergedGlobals = { ...(options == null ? void 0 : options.globals) || {}, ...variables || {} };
-      const runner = this.createJSRunner({
-        ...options || {},
-        globals: mergedGlobals
-      });
-      return runner.run(code);
-    });
     this.defineMethod("renderJson", function(template) {
       return this.resolveJsonTemplate(template);
     });
@@ -761,6 +871,21 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
       const needServer = Object.keys(serverVarPaths).length > 0;
       let serverResolved = template;
       if (needServer) {
+        const inferRecordRefWithMeta = /* @__PURE__ */ __name((ctx) => {
+          var _a2, _b2, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
+          const ref = (0, import_variablesParams.inferRecordRef)(ctx);
+          if (ref) return ref;
+          try {
+            const tk = (_b2 = (_a2 = ctx == null ? void 0 : ctx.resource) == null ? void 0 : _a2.getMeta) == null ? void 0 : _b2.call(_a2, "currentFilterByTk");
+            if (typeof tk === "undefined" || tk === null) return void 0;
+            const collection = ((_c = ctx == null ? void 0 : ctx.collection) == null ? void 0 : _c.name) || ((_j = (_i = (_h = (_g = (_f = (_e = (_d = ctx == null ? void 0 : ctx.resource) == null ? void 0 : _d.getResourceName) == null ? void 0 : _e.call(_d)) == null ? void 0 : _f.split) == null ? void 0 : _g.call(_f, ".")) == null ? void 0 : _h.slice) == null ? void 0 : _i.call(_h, -1)) == null ? void 0 : _j[0]);
+            if (!collection) return void 0;
+            const dataSourceKey = ((_k = ctx == null ? void 0 : ctx.collection) == null ? void 0 : _k.dataSourceKey) || ((_m = (_l = ctx == null ? void 0 : ctx.resource) == null ? void 0 : _l.getDataSourceKey) == null ? void 0 : _m.call(_l));
+            return { collection, dataSourceKey, filterByTk: tk };
+          } catch (_2) {
+            return void 0;
+          }
+        }, "inferRecordRefWithMeta");
         const collectFromMeta = /* @__PURE__ */ __name(async () => {
           var _a2;
           const out = {};
@@ -796,7 +921,54 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
         }, "collectFromMeta");
         const inputFromMeta = await collectFromMeta();
         const autoInput = { ...inputFromMeta };
+        try {
+          const varName = "formValues";
+          const neededPaths = serverVarPaths[varName] || [];
+          if (neededPaths.length) {
+            const requiredTop = /* @__PURE__ */ new Set();
+            for (const p of neededPaths) {
+              const top = topLevelOf(p);
+              if (top) requiredTop.add(top);
+            }
+            const metaOut = inputFromMeta == null ? void 0 : inputFromMeta[varName];
+            const builtTop = /* @__PURE__ */ new Set();
+            if (metaOut && typeof metaOut === "object" && !Array.isArray(metaOut) && !isRecordRefLike(metaOut)) {
+              Object.keys(metaOut).forEach((k) => builtTop.add(k));
+            }
+            const missing = [...requiredTop].filter((k) => !builtTop.has(k));
+            if (missing.length) {
+              const ref = inferRecordRefWithMeta(this);
+              if (ref) {
+                const { generatedFields, generatedAppends } = inferSelectsFromUsage(neededPaths);
+                const recordRef = {
+                  ...ref,
+                  fields: generatedFields,
+                  appends: generatedAppends
+                };
+                const existing = autoInput[varName];
+                if (existing && typeof existing === "object" && !Array.isArray(existing) && !isRecordRefLike(existing)) {
+                  for (const [k, v] of Object.entries(existing)) {
+                    autoInput[`${varName}.${k}`] = v;
+                  }
+                  delete autoInput[varName];
+                }
+                autoInput[varName] = recordRef;
+              }
+            }
+          }
+        } catch (_2) {
+        }
         const autoContextParams = Object.keys(autoInput).length ? (0, import_serverContextParams.buildServerContextParams)(this, autoInput) : void 0;
+        if (!autoContextParams) {
+          const keys = Object.keys(serverVarPaths);
+          const allOptional = keys.length > 0 && keys.every((k) => {
+            var _a2;
+            return (_a2 = this.getPropertyOptions(k)) == null ? void 0 : _a2.serverOnlyWhenContextParams;
+          });
+          if (allOptional) {
+            return (0, import_utils.resolveExpressions)(template, this);
+          }
+        }
         if (this.api) {
           try {
             serverResolved = await (0, import_params_resolvers.enqueueVariablesResolve)(this, {
@@ -811,6 +983,19 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
       }
       return (0, import_utils.resolveExpressions)(serverResolved, this);
     });
+    this.defineMethod(
+      "getVar",
+      async function(varPath) {
+        const raw = typeof varPath === "string" ? varPath : String(varPath ?? "");
+        const s = raw.trim();
+        if (!s) return void 0;
+        if (s !== "ctx" && !s.startsWith("ctx.")) {
+          throw new Error(`ctx.getVar(path) expects an expression starting with "ctx.", got: "${s}"`);
+        }
+        return this.resolveJsonTemplate(`{{ ${s} }}`);
+      },
+      'Resolve a ctx expression value by path (expression starts with "ctx.").'
+    );
     this.defineProperty("requirejs", {
       get: /* @__PURE__ */ __name(() => {
         var _a, _b;
@@ -900,7 +1085,8 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
         user: this.user
       }), "get")
     });
-    this.defineMethod("loadCSS", async (url) => {
+    this.defineMethod("loadCSS", async (href) => {
+      const url = (0, import_utils.resolveModuleUrl)(href);
       return new Promise((resolve, reject) => {
         const existingLink = document.querySelector(`link[href="${url}"]`);
         if (existingLink) {
@@ -916,59 +1102,28 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
       });
     });
     this.defineMethod("requireAsync", async (url) => {
-      return new Promise((resolve, reject) => {
-        if (!this.requirejs) {
-          reject(new Error("requirejs is not available"));
-          return;
-        }
-        this.requirejs(
-          [url],
-          (...args) => {
-            resolve(args[0]);
-          },
-          reject
-        );
-      });
+      const u = (0, import_utils.resolveModuleUrl)(url, { raw: true });
+      return await (0, import_runjsModuleLoader.runjsRequireAsync)(this.requirejs, u);
     });
-    this.defineMethod("createJSRunner", function(options) {
-      const runCtx = new FlowRunjsContext(this.createProxy());
-      return new import_JSRunner.JSRunner({
-        ...options,
-        globals: {
-          ctx: runCtx,
-          window: (0, import_utils.createSafeWindow)(),
-          document: (0, import_utils.createSafeDocument)(),
-          ...options == null ? void 0 : options.globals
-        }
-      });
+    this.defineMethod("importAsync", async function(url) {
+      if ((0, import_utils.isCssFile)(url)) {
+        return this.loadCSS(url);
+      }
+      return await (0, import_runjsModuleLoader.runjsImportModule)(this, url, { importer: import_runjsModuleLoader.runjsImportAsync });
     });
-    this.defineMethod("copyToClipboard", async (text) => {
-      const content = String(text ?? "");
+    this.defineMethod("createJSRunner", async function(options) {
       try {
-        if (typeof navigator !== "undefined" && navigator.clipboard && navigator.clipboard.writeText) {
-          await navigator.clipboard.writeText(content);
-          return;
-        }
-      } catch (e) {
+        const mod = await import("./runjs-context/setup");
+        if (typeof (mod == null ? void 0 : mod.setupRunJSContexts) === "function") await mod.setupRunJSContexts();
+      } catch (_2) {
       }
-      return new Promise((resolve, reject) => {
-        try {
-          const ta = document.createElement("textarea");
-          ta.value = content;
-          ta.setAttribute("readonly", "");
-          ta.style.position = "fixed";
-          ta.style.top = "-9999px";
-          document.body.appendChild(ta);
-          ta.focus();
-          ta.select();
-          const ok = document.execCommand("copy");
-          document.body.removeChild(ta);
-          if (ok) resolve();
-          else reject(new Error("execCommand copy failed"));
-        } catch (err) {
-          reject(err);
-        }
-      });
+      const version = (options == null ? void 0 : options.version) || "v1";
+      const modelClass = (0, import_registry.getModelClassName)(this);
+      const Ctor = import_registry.RunJSContextRegistry.resolve(version, modelClass) || FlowRunJSContext;
+      const runCtx = new Ctor(this);
+      const globals = { ctx: runCtx, ...(options == null ? void 0 : options.globals) || {} };
+      const { timeoutMs } = options || {};
+      return new import_JSRunner.JSRunner({ globals, timeoutMs });
     });
     this.defineMethod("buildServerContextParams", function(input) {
       return (0, import_serverContextParams.buildServerContextParams)(this, input);
@@ -986,7 +1141,7 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
       "runAction",
       async function(actionName, params) {
         const def = this.engine.getAction(actionName);
-        const ctx = this.createProxy();
+        const ctx = await (0, import_createEphemeralContext.createEphemeralContext)(this, def);
         if (!def) {
           throw new Error(`Action '${actionName}' not found.`);
         }
@@ -1019,13 +1174,22 @@ const _FlowEngineContext = class _FlowEngineContext extends BaseFlowEngineContex
         context: this.createProxy()
       });
     });
+    this.defineMethod(
+      "useResource",
+      function(className) {
+        if (this.has("resource")) return;
+        this.defineProperty("resource", {
+          get: /* @__PURE__ */ __name(() => this.createResource(className), "get")
+        });
+      }
+    );
   }
 };
 __name(_FlowEngineContext, "FlowEngineContext");
 let FlowEngineContext = _FlowEngineContext;
 const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
   constructor(model) {
-    if (!(model instanceof import_models.FlowModel)) {
+    if (!model || typeof model !== "object") {
       throw new Error("Invalid FlowModel instance");
     }
     super();
@@ -1033,13 +1197,6 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
     this.defineMethod("onRefReady", (ref, cb, timeout) => {
       this.engine.reactView.onRefReady(ref, cb, timeout);
     });
-    this.defineMethod("runjs", async (code, variables, options) => {
-      const runner = this.createJSRunner({
-        globals: variables,
-        version: options == null ? void 0 : options.version
-      });
-      return runner.run(code);
-    });
     this.defineProperty("model", {
       value: model
     });
@@ -1051,14 +1208,23 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
       }, "get")
     });
     this.defineMethod("openView", async function(uid, options) {
-      var _a, _b, _c, _d, _e, _f, _g;
+      var _a, _b, _c, _d, _e;
       const opts = { ...options };
-      if (opts.defineProperties || opts.defineMethod) {
+      if (opts.defineProperties || opts.defineMethods) {
         opts.navigation = false;
       }
       let model2 = null;
       model2 = await this.engine.loadModel({ uid });
       if (!model2) {
+        const pickDefined = /* @__PURE__ */ __name((src, keys) => {
+          const res = {};
+          for (const k of keys) {
+            if (typeof (src == null ? void 0 : src[k]) !== "undefined") {
+              res[k] = src[k];
+            }
+          }
+          return res;
+        }, "pickDefined");
         model2 = this.engine.createModel({
           uid,
           // 注意： 新建的 model 应该使用 ${parentModel.uid}-xxx 形式的 uid
@@ -1069,28 +1235,21 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
           stepParams: {
             popupSettings: {
               openView: {
-                ...import_lodash.default.pick(opts, ["dataSourceKey", "collectionName", "associationName"])
+                // 仅在创建时持久化一份默认配置；运行时以本次 opts 为准，避免多个 opener 互相覆盖。
+                ...pickDefined(opts, ["dataSourceKey", "collectionName", "associationName", "mode", "size"])
               }
             }
           }
         });
         await model2.save();
       }
-      if ((_b = (_a = model2.getStepParams("popupSettings")) == null ? void 0 : _a.openView) == null ? void 0 : _b.dataSourceKey) {
-        model2.setStepParams("popupSettings", {
-          openView: {
-            ...(_c = model2.getStepParams("popupSettings")) == null ? void 0 : _c.openView,
-            ...import_lodash.default.pick(opts, ["dataSourceKey", "collectionName", "associationName"])
-          }
-        });
-        await model2.save();
-      }
-      const viewUid = (opts == null ? void 0 : opts.routeViewUid) ?? (opts == null ? void 0 : opts.viewUid) ?? (((_e = (_d = model2.stepParams) == null ? void 0 : _d.popupSettings) == null ? void 0 : _e.openView) ? model2.uid : this.model.uid);
+      model2.setParent(this.model);
+      const viewUid = (opts == null ? void 0 : opts.routeViewUid) ?? (opts == null ? void 0 : opts.viewUid) ?? (((_b = (_a = model2.stepParams) == null ? void 0 : _a.popupSettings) == null ? void 0 : _b.openView) ? model2.uid : this.model.uid);
       const parentView = this.view;
       const pendingType = (opts == null ? void 0 : opts.isMobileLayout) ? "embed" : (opts == null ? void 0 : opts.mode) || "drawer";
       const pendingInputArgs = { ...opts, viewUid, navigation: opts.navigation };
-      pendingInputArgs.filterByTk = pendingInputArgs.filterByTk || ((_f = this.inputArgs) == null ? void 0 : _f.filterByTk);
-      pendingInputArgs.sourceId = pendingInputArgs.sourceId || ((_g = this.inputArgs) == null ? void 0 : _g.sourceId);
+      pendingInputArgs.filterByTk = pendingInputArgs.filterByTk || ((_c = this.inputArgs) == null ? void 0 : _c.filterByTk);
+      pendingInputArgs.sourceId = pendingInputArgs.sourceId || ((_d = this.inputArgs) == null ? void 0 : _d.sourceId);
       const pendingView = {
         type: pendingType,
         inputArgs: pendingInputArgs,
@@ -1099,12 +1258,25 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
         engineCtx: this.engine.context
       };
       model2.context.defineProperty("view", { value: pendingView });
-      await model2.dispatchEvent("click", {
-        // navigation: false, // TODO: 路由模式有bug，不支持多层同样viewId的弹窗，因此这里默认先用false
-        // ...this.model?.['getInputArgs']?.(), // 避免部分关系字段信息丢失, 仿照 ClickableCollectionField 做法
-        ...opts
-      });
-      model2.context.defineProperty("view", { value: void 0 });
+      const popupFlow = (_e = model2.getFlow) == null ? void 0 : _e.call(model2, "popupSettings");
+      const on = popupFlow == null ? void 0 : popupFlow.on;
+      let openEventName = "click";
+      if (typeof on === "string" && on) {
+        openEventName = on;
+      } else if (on && typeof on === "object" && typeof on.eventName === "string" && on.eventName) {
+        openEventName = on.eventName;
+      }
+      await model2.dispatchEvent(
+        openEventName,
+        {
+          // navigation: false, // TODO: 路由模式有bug，不支持多层同样viewId的弹窗，因此这里默认先用false
+          // ...this.model?.['getInputArgs']?.(), // 避免部分关系字段信息丢失, 仿照 ClickableCollectionField 做法
+          ...opts
+        },
+        {
+          debounce: true
+        }
+      );
     });
     this.defineMethod("getEvents", function() {
       return this.model.getEvents();
@@ -1119,7 +1291,7 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
       "runAction",
       async function(actionName, params) {
         const def = this.model.getAction(actionName);
-        const ctx = this.createProxy();
+        const ctx = await (0, import_createEphemeralContext.createEphemeralContext)(this, def);
         if (!def) {
           throw new Error(`Action '${actionName}' not found.`);
         }
@@ -1144,7 +1316,7 @@ __name(_FlowModelContext, "FlowModelContext");
 let FlowModelContext = _FlowModelContext;
 const _FlowForkModelContext = class _FlowForkModelContext extends BaseFlowModelContext {
   constructor(master, fork) {
-    if (!(master instanceof import_models.FlowModel)) {
+    if (!master || typeof master !== "object") {
       throw new Error("Invalid FlowModel instance");
     }
     super();
@@ -1164,13 +1336,6 @@ const _FlowForkModelContext = class _FlowForkModelContext extends BaseFlowModelC
         return stableRef;
       }, "get")
     });
-    this.defineMethod("runjs", async (code, variables, options) => {
-      const runner = this.createJSRunner({
-        globals: variables,
-        version: options == null ? void 0 : options.version
-      });
-      return runner.run(code);
-    });
   }
 };
 __name(_FlowForkModelContext, "FlowForkModelContext");
@@ -1215,13 +1380,6 @@ const _FlowRuntimeContext = class _FlowRuntimeContext extends BaseFlowModelConte
     this.defineMethod("onRefReady", (ref, cb, timeout) => {
       this.engine.reactView.onRefReady(ref, cb, timeout);
     });
-    this.defineMethod("runjs", async (code, variables, options) => {
-      const runner = this.createJSRunner({
-        globals: variables,
-        version: options == null ? void 0 : options.version
-      });
-      return runner.run(code);
-    });
   }
   stepResults = {};
   _getOwnProperty(key) {
@@ -1257,12 +1415,162 @@ const _FlowRuntimeContext = class _FlowRuntimeContext extends BaseFlowModelConte
 };
 __name(_FlowRuntimeContext, "FlowRuntimeContext");
 let FlowRuntimeContext = _FlowRuntimeContext;
+const __runjsClassDefaultMeta = /* @__PURE__ */ new WeakMap();
+const __runjsClassLocaleMeta = /* @__PURE__ */ new WeakMap();
+const __runjsDocCache = /* @__PURE__ */ new WeakMap();
+function __runjsDeepMerge(base, patch) {
+  if (patch === null) return void 0;
+  if (Array.isArray(base) || Array.isArray(patch) || typeof base !== "object" || typeof patch !== "object") {
+    return patch ?? base;
+  }
+  const out = { ...base };
+  for (const k of Object.keys(patch)) {
+    const v = __runjsDeepMerge(base == null ? void 0 : base[k], patch[k]);
+    if (typeof v === "undefined") delete out[k];
+    else out[k] = v;
+  }
+  return out;
+}
+__name(__runjsDeepMerge, "__runjsDeepMerge");
+const _FlowRunJSContext = class _FlowRunJSContext extends FlowContext {
+  constructor(delegate) {
+    super();
+    this.addDelegate(delegate);
+    this.defineProperty("React", { value: import_react.default });
+    this.defineProperty("antd", { value: antd });
+    this.defineProperty("dayjs", { value: import_dayjs.default });
+    const ReactDOMShim = {
+      ...ReactDOMClient,
+      createRoot: /* @__PURE__ */ __name((container, options) => {
+        const realContainer = (container == null ? void 0 : container.__el) || container;
+        return this.engine.reactView.createRoot(realContainer, options);
+      }, "createRoot")
+    };
+    ReactDOMShim.__nbRunjsInternalShim = true;
+    this.defineProperty("ReactDOM", { value: ReactDOMShim });
+    (0, import_runjsLibs.setupRunJSLibs)(this);
+    this.defineMethod(
+      "render",
+      function(vnode, container) {
+        const el = container || this.element;
+        if (!el) throw new Error("ctx.render: container not provided and ctx.element is not available");
+        const containerEl = (el == null ? void 0 : el.__el) || el;
+        const globalRef = globalThis;
+        globalRef.__nbRunjsRoots = globalRef.__nbRunjsRoots || /* @__PURE__ */ new WeakMap();
+        const rootMap = globalRef.__nbRunjsRoots;
+        const disposeEntry = /* @__PURE__ */ __name((entry2) => {
+          if (!entry2) return;
+          if (entry2.disposeTheme && typeof entry2.disposeTheme === "function") {
+            try {
+              entry2.disposeTheme();
+            } catch (_2) {
+            }
+            entry2.disposeTheme = void 0;
+          }
+          const root = entry2.root || entry2;
+          if (root && typeof root.unmount === "function") {
+            try {
+              root.unmount();
+            } catch (_2) {
+            }
+          }
+        }, "disposeEntry");
+        const unmountContainerRoot = /* @__PURE__ */ __name(() => {
+          const existing = rootMap.get(containerEl);
+          if (existing) {
+            disposeEntry(existing);
+            rootMap.delete(containerEl);
+          }
+        }, "unmountContainerRoot");
+        if (typeof vnode === "string") {
+          unmountContainerRoot();
+          const proxy = new import_ElementProxy.ElementProxy(containerEl);
+          proxy.innerHTML = String(vnode ?? "");
+          return null;
+        }
+        if (vnode && vnode.nodeType && (vnode.nodeType === 1 || vnode.nodeType === 3 || vnode.nodeType === 11)) {
+          unmountContainerRoot();
+          while (containerEl.firstChild) containerEl.removeChild(containerEl.firstChild);
+          containerEl.appendChild(vnode);
+          return null;
+        }
+        const rendererKey = this.ReactDOM;
+        const ownerKey = this;
+        let entry = rootMap.get(containerEl);
+        if (!entry || entry.rendererKey !== rendererKey || entry.ownerKey !== ownerKey) {
+          if (entry) {
+            disposeEntry(entry);
+            rootMap.delete(containerEl);
+          }
+          const root = this.ReactDOM.createRoot(containerEl);
+          entry = { rendererKey, ownerKey, root, disposeTheme: void 0, lastVnode: void 0 };
+          rootMap.set(containerEl, entry);
+        }
+        return (0, import_runjsLibs.externalReactRender)({
+          ctx: this,
+          entry,
+          vnode,
+          containerEl,
+          rootMap,
+          unmountContainerRoot,
+          internalReact: import_react.default,
+          internalAntd: antd
+        });
+      }
+    );
+  }
+  static define(meta, options) {
+    const locale = options == null ? void 0 : options.locale;
+    if (locale) {
+      const map = __runjsClassLocaleMeta.get(this) || /* @__PURE__ */ new Map();
+      const prev = map.get(locale) || {};
+      map.set(locale, __runjsDeepMerge(prev, meta));
+      __runjsClassLocaleMeta.set(this, map);
+    } else {
+      const prev = __runjsClassDefaultMeta.get(this) || {};
+      __runjsClassDefaultMeta.set(this, __runjsDeepMerge(prev, meta));
+    }
+    __runjsDocCache.delete(this);
+  }
+  static getDoc(locale) {
+    const self = this;
+    let cacheForClass = __runjsDocCache.get(self);
+    const cacheKey = String(locale || "default");
+    if (cacheForClass && cacheForClass.has(cacheKey)) return cacheForClass.get(cacheKey);
+    const chain = [];
+    let cur = self;
+    while (cur && cur.prototype) {
+      chain.unshift(cur);
+      cur = Object.getPrototypeOf(cur);
+    }
+    let merged = {};
+    for (const cls of chain) {
+      merged = __runjsDeepMerge(merged, __runjsClassDefaultMeta.get(cls) || {});
+    }
+    if (locale) {
+      for (const cls of chain) {
+        const lmap = __runjsClassLocaleMeta.get(cls);
+        if (lmap && lmap.has(locale)) {
+          merged = __runjsDeepMerge(merged, lmap.get(locale));
+        }
+      }
+    }
+    if (!cacheForClass) {
+      cacheForClass = /* @__PURE__ */ new Map();
+      __runjsDocCache.set(self, cacheForClass);
+    }
+    cacheForClass.set(cacheKey, merged);
+    return merged;
+  }
+};
+__name(_FlowRunJSContext, "FlowRunJSContext");
+let FlowRunJSContext = _FlowRunJSContext;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   FlowContext,
   FlowEngineContext,
   FlowForkModelContext,
   FlowModelContext,
-  FlowRunjsContext,
+  FlowRunJSContext,
   FlowRuntimeContext
 });