@nocobase/flow-engine 2.0.0-beta.20 → 2.0.0-beta.22

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

@@ -521,7 +521,7 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
             };
             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 })
             });
           });
           if (flow.options.divider === "bottom") {
@@ -555,7 +555,7 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
                 const uniqueKey = generateUniqueKey(`${flow.key}:${stepInfo.stepKey}`);
                 items.push({
                   key: uniqueKey,
-                  label: t(stepInfo.title)
+                  label: stepInfo.title
                 });
               });
             });
@@ -567,7 +567,7 @@ const DefaultSettingsIcon = /* @__PURE__ */ __name(({
                 const uniqueKey = generateUniqueKey(`${modelKey}:${flow.key}:${stepInfo.stepKey}`);
                 subMenuChildren.push({
                   key: uniqueKey,
-                  label: t(stepInfo.title)
+                  label: stepInfo.title
                 });
               });
             });

package/lib/data-source/index.d.ts

@@ -66,6 +66,11 @@ export interface CollectionOptions {
 export declare class CollectionManager {
     dataSource: DataSource;
     collections: Map<string, Collection>;
+    allCollectionsInheritChain: string[];
+    protected childrenCollectionsName: {
+        supportView?: string[];
+        notSupportView?: string[];
+    };
     constructor(dataSource: DataSource);
     get flowEngine(): FlowEngine;
     addCollection(collection: Collection | CollectionOptions): void;
@@ -83,33 +88,8 @@ export declare class CollectionManager {
     clearCollections(): void;
     getAssociation(associationName: string): CollectionField | undefined;
     getChildrenCollections(name: any): any[];
-    getCollectionFieldsOptions(collectionName: string, type?: string | string[], interfaces?: string | string[], opts?: {
-        dataSource?: string;
-        cached?: Record<string, any>;
-        collectionNames?: string[];
-        /**
-         * 为 true 时允许查询所有关联字段
-         * 为 Array<string> 时仅允许查询指定的关联字段
-         */
-        association?: boolean | string[];
-        /**
-         * Max depth of recursion
-         */
-        maxDepth?: number;
-        allowAllTypes?: boolean;
-        /**
-         * 排除这些接口的字段
-         */
-        exceptInterfaces?: string[];
-        /**
-         * field value 的前缀，用 . 连接，比如 a.b.c
-         */
-        prefixFieldValue?: string;
-        /**
-         * 是否使用 prefixFieldValue 作为 field value
-         */
-        usePrefix?: boolean;
-    }): any;
+    getChildrenCollectionsName(name: any, isSupportView?: boolean): string[];
+    getAllCollectionsInheritChain(name: any): string[];
 }
 export declare class Collection {
     fields: Map<string, CollectionField>;

package/lib/data-source/index.js

@@ -188,6 +188,8 @@ const _CollectionManager = class _CollectionManager {
     this.collections = import_reactive.observable.shallow(/* @__PURE__ */ new Map());
   }
   collections;
+  allCollectionsInheritChain;
+  childrenCollectionsName = {};
   get flowEngine() {
     return this.dataSource.flowEngine;
   }
@@ -317,56 +319,75 @@ const _CollectionManager = class _CollectionManager {
     }, "getChildrens");
     return getChildrens(name);
   }
-  getCollectionFieldsOptions(collectionName, type, interfaces, opts) {
-    var _a;
-    const {
-      association = false,
-      cached = {},
-      collectionNames = [collectionName],
-      maxDepth = 1,
-      allowAllTypes = false,
-      exceptInterfaces = [],
-      prefixFieldValue = "",
-      usePrefix = false,
-      dataSource: customDataSourceNameValue
-    } = opts || {};
-    if (collectionNames.length - 1 > maxDepth) {
-      return;
-    }
-    if (cached[collectionName]) {
-      return import_lodash.default.cloneDeep(cached[collectionName]);
+  getChildrenCollectionsName(name, isSupportView = false) {
+    const cacheKey = isSupportView ? "supportView" : "notSupportView";
+    if (this.childrenCollectionsName[cacheKey]) {
+      return this.childrenCollectionsName[cacheKey].slice();
     }
-    const collection = this.getCollection(collectionName);
-    if (!collection) {
-      throw new Error(`Collection ${collectionName} not found`);
-    }
-    const fields = collection.getFields();
-    const options = (_a = fields == null ? void 0 : fields.filter(
-      (field) => field.interface && !exceptInterfaces.includes(field.interface) && (allowAllTypes || type && type.includes(field.type) || interfaces && interfaces.includes(field.interface) || (association && field.target && field.target !== collectionName && Array.isArray(association) ? association.includes(field.interface) : false))
-    )) == null ? void 0 : _a.map((field) => {
-      var _a2, _b;
-      const result = {
-        value: usePrefix && prefixFieldValue ? `${prefixFieldValue}.${field.name}` : field.name,
-        label: ((_a2 = field == null ? void 0 : field.uiSchema) == null ? void 0 : _a2.title) || field.name,
-        ...field
-      };
-      if (association && field.target) {
-        result.children = collectionNames.includes(field.target) ? [] : this.getCollectionFieldsOptions(field.target, type, interfaces, {
-          ...opts,
-          cached,
-          dataSource: customDataSourceNameValue,
-          collectionNames: [...collectionNames, field.target],
-          prefixFieldValue: usePrefix ? prefixFieldValue ? `${prefixFieldValue}.${field.name}` : field.name : "",
-          usePrefix
+    const children = [];
+    const collections = [...this.getCollections()];
+    const getChildrenCollectionsInner = /* @__PURE__ */ __name((collectionName) => {
+      const inheritCollections = collections.filter((v) => {
+        var _a;
+        return (_a = [...v.inherits]) == null ? void 0 : _a.includes(collectionName);
+      });
+      inheritCollections.forEach((v) => {
+        const collectionKey = v.name;
+        children.push(collectionKey);
+        return getChildrenCollectionsInner(collectionKey);
+      });
+      if (isSupportView) {
+        const sourceCollections = collections.filter((v) => {
+          var _a;
+          return ((_a = [...v.sources]) == null ? void 0 : _a.length) === 1 && (v == null ? void 0 : v.sources[0]) === collectionName;
         });
-        if (!((_b = result.children) == null ? void 0 : _b.length)) {
-          return null;
+        sourceCollections.forEach((v) => {
+          const collectionKey = v.name;
+          children.push(v.name);
+          return getChildrenCollectionsInner(collectionKey);
+        });
+      }
+      return import_lodash.default.uniq(children);
+    }, "getChildrenCollectionsInner");
+    this.childrenCollectionsName[cacheKey] = getChildrenCollectionsInner(name);
+    return this.childrenCollectionsName[cacheKey];
+  }
+  getAllCollectionsInheritChain(name) {
+    if (this.allCollectionsInheritChain) {
+      return this.allCollectionsInheritChain.slice();
+    }
+    const collectionsInheritChain = [name];
+    const getInheritChain = /* @__PURE__ */ __name((name2) => {
+      const collection = this.getCollection(name2);
+      if (collection) {
+        const { inherits } = collection;
+        const children = this.getChildrenCollectionsName(name2);
+        if (inherits) {
+          for (let index = 0; index < inherits.length; index++) {
+            const collectionKey = inherits[index];
+            if (collectionsInheritChain.includes(collectionKey)) {
+              continue;
+            }
+            collectionsInheritChain.push(collectionKey);
+            getInheritChain(collectionKey);
+          }
+        }
+        if (children) {
+          for (let index = 0; index < children.length; index++) {
+            const collection2 = this.getCollection(children[index]);
+            const collectionKey = collection2.name;
+            if (collectionsInheritChain.includes(collectionKey)) {
+              continue;
+            }
+            collectionsInheritChain.push(collectionKey);
+            getInheritChain(collectionKey);
+          }
         }
       }
-      return result;
-    }).filter(Boolean);
-    cached[collectionName] = options;
-    return options;
+      return collectionsInheritChain;
+    }, "getInheritChain");
+    this.allCollectionsInheritChain = getInheritChain(name);
+    return this.allCollectionsInheritChain || [];
   }
 };
 __name(_CollectionManager, "CollectionManager");

package/lib/flowContext.d.ts

@@ -143,6 +143,29 @@ export declare class FlowContext {
      * @returns 属性定义选项，或 undefined（未定义）
      */
     getPropertyOptions(key: string): PropertyOptions | undefined;
+    /**
+     * 获取当前上下文可用的顶层 API 信息（主要用于编辑器补全/工具）。
+     *
+     * 注意：
+     * - 目前返回值以“尽量可用”为目标，允许不完整。
+     * - 该方法不会展开变量 meta（变量结构应由 `getPropertyMetaTree()`/VariableInput 等机制负责）。
+     */
+    getApiInfos(options?: {
+        version?: string;
+    }): Promise<Record<string, any>>;
+    /**
+     * 变量结构信息（保留给编辑器/工具使用）。
+     * 当前实现为保底空对象，避免 RunJS doc 中补全到该方法时调用报错。
+     */
+    getVarInfos(_options?: {
+        path?: string | string[];
+        maxDepth?: number;
+    }): Promise<Record<string, any>>;
+    /**
+     * 运行时环境信息（保留给编辑器/工具使用）。
+     * 当前实现为保底空对象，避免 RunJS doc 中补全到该方法时调用报错。
+     */
+    getEnvInfos(): Promise<Record<string, any>>;
 }
 declare class BaseFlowEngineContext extends FlowContext {
     router: Router;
@@ -158,6 +181,7 @@ declare class BaseFlowEngineContext extends FlowContext {
      */
     renderJson: (template: JSONValue) => Promise<any>;
     resolveJsonTemplate: (template: JSONValue) => Promise<any>;
+    getVar: (path: string) => Promise<any>;
     runjs: (code: string, variables?: Record<string, any>, options?: JSRunnerOptions) => Promise<any>;
     getAction: <TModel extends FlowModel = FlowModel, TCtx extends FlowContext = FlowContext>(name: string) => ActionDefinition<TModel, TCtx> | undefined;
     getActions: <TModel extends FlowModel = FlowModel, TCtx extends FlowContext = FlowContext>() => Map<string, ActionDefinition<TModel, TCtx>>;
@@ -219,22 +243,60 @@ export declare class FlowRuntimeContext<TModel extends FlowModel = FlowModel, TM
     get mode(): TMode;
 }
 export type FlowSettingsContext<TModel extends FlowModel = FlowModel> = FlowRuntimeContext<TModel, 'settings'>;
+export type FlowContextDocRef = string | {
+    url: string;
+    title?: string;
+};
+export type FlowDeprecationDoc = boolean | {
+    message?: string;
+    replacedBy?: string | string[];
+    since?: string;
+    removedIn?: string;
+    ref?: FlowContextDocRef;
+};
+export type FlowContextDocParam = {
+    name: string;
+    description?: string;
+    type?: string;
+    optional?: boolean;
+    default?: JSONValue;
+};
+export type FlowContextDocReturn = {
+    description?: string;
+    type?: string;
+};
 export type RunJSDocCompletionDoc = {
     insertText?: string;
 };
+export type RunJSDocHiddenDoc = boolean | ((ctx: any) => boolean | Promise<boolean>);
+export type RunJSDocHiddenOrPathsDoc = boolean | string[] | ((ctx: any) => boolean | string[] | Promise<boolean | string[]>);
 export type RunJSDocPropertyDoc = string | {
     description?: string;
     detail?: string;
     type?: string;
     examples?: string[];
     completion?: RunJSDocCompletionDoc;
+    ref?: FlowContextDocRef;
+    deprecated?: FlowDeprecationDoc;
+    params?: FlowContextDocParam[];
+    returns?: FlowContextDocReturn;
     properties?: Record<string, RunJSDocPropertyDoc>;
+    hidden?: RunJSDocHiddenOrPathsDoc;
+    disabled?: boolean | ((ctx: any) => boolean | Promise<boolean>);
+    disabledReason?: string | ((ctx: any) => string | undefined | Promise<string | undefined>);
 };
 export type RunJSDocMethodDoc = string | {
     description?: string;
     detail?: string;
     examples?: string[];
     completion?: RunJSDocCompletionDoc;
+    ref?: FlowContextDocRef;
+    deprecated?: FlowDeprecationDoc;
+    params?: FlowContextDocParam[];
+    returns?: FlowContextDocReturn;
+    hidden?: RunJSDocHiddenDoc;
+    disabled?: boolean | ((ctx: any) => boolean | Promise<boolean>);
+    disabledReason?: string | ((ctx: any) => string | undefined | Promise<string | undefined>);
 };
 export type RunJSDocMeta = {
     label?: string;

package/lib/flowContext.js

@@ -469,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();
@@ -763,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
@@ -915,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;
@@ -1127,7 +1208,7 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
       }, "get")
     });
     this.defineMethod("openView", async function(uid, options) {
-      var _a, _b, _c, _d;
+      var _a, _b, _c, _d, _e;
       const opts = { ...options };
       if (opts.defineProperties || opts.defineMethods) {
         opts.navigation = false;
@@ -1177,8 +1258,16 @@ const _FlowModelContext = class _FlowModelContext extends BaseFlowModelContext {
         engineCtx: this.engine.context
       };
       model2.context.defineProperty("view", { value: pendingView });
+      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(
-        "click",
+        openEventName,
         {
           // navigation: false, // TODO: 路由模式有bug，不支持多层同样viewId的弹窗，因此这里默认先用false
           // ...this.model?.['getInputArgs']?.(), // 避免部分关系字段信息丢失, 仿照 ClickableCollectionField 做法

package/lib/flowEngine.js

@@ -762,16 +762,26 @@ const _FlowEngine = class _FlowEngine {
    */
   async loadModel(options) {
     if (!this.ensureModelRepository()) return;
-    const model = this.findModelByParentId(options.parentId, options.subKey);
-    if (model) {
-      return model;
-    }
-    const hydrated = this.hydrateModelFromPreviousEngines(options);
-    if (hydrated) {
-      return hydrated;
+    const refresh = !!(options == null ? void 0 : options.refresh);
+    if (!refresh) {
+      const model = this.findModelByParentId(options.parentId, options.subKey);
+      if (model) {
+        return model;
+      }
+      const hydrated = this.hydrateModelFromPreviousEngines(options);
+      if (hydrated) {
+        return hydrated;
+      }
     }
     const data = await this._modelRepository.findOne(options);
-    return (data == null ? void 0 : data.uid) ? this.createModel(data) : null;
+    if (!(data == null ? void 0 : data.uid)) return null;
+    if (refresh) {
+      const existing = this.getModel(data.uid);
+      if (existing) {
+        this.removeModelWithSubModels(existing.uid);
+      }
+    }
+    return this.createModel(data);
   }
   /**
    * Find a sub-model by parent model ID and subKey.

package/lib/index.d.ts

@@ -27,7 +27,10 @@ export * from './JSRunner';
 export { getRunJSDocFor, createJSRunnerWithVersion, getRunJSScenesForModel, getRunJSScenesForContext, } from './runjs-context/helpers';
 export { RunJSContextRegistry, getModelClassName } from './runjs-context/registry';
 export { setupRunJSContexts } from './runjs-context/setup';
-export { getSnippetBody, listSnippetsForContext } from './runjs-context/snippets';
+export type { RunJSContextContribution, RunJSContextContributionApi } from './runjs-context/contributions';
+export { registerRunJSContextContribution } from './runjs-context/contributions';
+export type { RunJSSnippetLoader } from './runjs-context/snippets';
+export { getSnippetBody, listSnippetsForContext, registerRunJSSnippet } from './runjs-context/snippets';
 export * from './views';
 export { DATA_SOURCE_DIRTY_EVENT, ENGINE_SCOPE_KEY, getEmitterViewActivatedVersion, VIEW_ACTIVATED_EVENT, VIEW_ACTIVATED_VERSION, VIEW_ENGINE_SCOPE, } from './views/viewEvents';
 export * from './FlowDefinition';

package/lib/index.js

@@ -44,7 +44,9 @@ __export(src_exports, {
   getRunJSScenesForModel: () => import_helpers.getRunJSScenesForModel,
   getSnippetBody: () => import_snippets.getSnippetBody,
   listSnippetsForContext: () => import_snippets.listSnippetsForContext,
+  registerRunJSContextContribution: () => import_contributions.registerRunJSContextContribution,
   registerRunJSLib: () => import_runjsLibs.registerRunJSLib,
+  registerRunJSSnippet: () => import_snippets.registerRunJSSnippet,
   setupRunJSContexts: () => import_setup.setupRunJSContexts
 });
 module.exports = __toCommonJS(src_exports);
@@ -68,6 +70,7 @@ __reExport(src_exports, require("./JSRunner"), module.exports);
 var import_helpers = require("./runjs-context/helpers");
 var import_registry = require("./runjs-context/registry");
 var import_setup = require("./runjs-context/setup");
+var import_contributions = require("./runjs-context/contributions");
 var import_snippets = require("./runjs-context/snippets");
 __reExport(src_exports, require("./views"), module.exports);
 var import_viewEvents = require("./views/viewEvents");
@@ -93,7 +96,9 @@ var import_BlockScopedFlowEngine = require("./BlockScopedFlowEngine");
   getRunJSScenesForModel,
   getSnippetBody,
   listSnippetsForContext,
+  registerRunJSContextContribution,
   registerRunJSLib,
+  registerRunJSSnippet,
   setupRunJSContexts,
   ...require("./types"),
   ...require("./utils"),

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/runjs-context/contexts/FormJSFieldItemRunJSContext.js

@@ -42,7 +42,12 @@ FormJSFieldItemRunJSContext.define({
       Supports innerHTML, append, and other DOM manipulation methods.`,
     value: `Current field value (read-only in display mode; in controlled scenarios, use setProps to modify).`,
     record: `Current record data object (read-only).
-      Contains all field values of the parent record.`
+      Contains all field values of the parent record.`,
+    formValues: {
+      description: "Snapshot of current form values (object). Available in form contexts (CreateForm/EditForm).",
+      detail: "Record<string, any>",
+      examples: ["const { name, status } = ctx.formValues || {};"]
+    }
   },
   methods: {
     onRefReady: `Wait for form field container DOM element to be ready before executing callback.
@@ -58,7 +63,12 @@ FormJSFieldItemRunJSContext.define(
     properties: {
       element: "ElementProxy\uFF0C\u8868\u5355\u5B57\u6BB5\u5BB9\u5668",
       value: "\u5B57\u6BB5\u503C\uFF08\u5C55\u793A\u6A21\u5F0F\u4E3A\u53EA\u8BFB\uFF1B\u53D7\u63A7\u573A\u666F\u7528 setProps \u4FEE\u6539\uFF09",
-      record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09"
+      record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09",
+      formValues: {
+        description: "\u5F53\u524D\u8868\u5355\u503C\u5FEB\u7167\uFF08\u5BF9\u8C61\uFF09\u3002\u4EC5\u8868\u5355\u76F8\u5173\u4E0A\u4E0B\u6587\u53EF\u7528\uFF08Create/Edit Form\uFF09\u3002",
+        detail: "Record<string, any>",
+        examples: ["const { name, status } = ctx.formValues || {};"]
+      }
     },
     methods: {
       onRefReady: "\u5BB9\u5668\u5C31\u7EEA\u56DE\u8C03",

package/lib/runjs-context/contexts/JSBlockRunJSContext.js

@@ -58,7 +58,7 @@ JSBlockRunJSContext.define({
       Parameters: (ref: React.RefObject, callback: (element: HTMLElement) => void, timeout?: number) => void
       Example: ctx.onRefReady(ctx.ref, (el) => { el.innerHTML = "Ready!" })`,
     requireAsync: "Load external library: `const lib = await ctx.requireAsync(url)`",
-    importAsync: "Dynamically import ESM module: `const mod = await ctx.importAsync(url)`"
+    importAsync: "Dynamically import an ESM module by URL: `const mod = await ctx.importAsync(url)`.\nNote: if the module has only a default export, ctx.importAsync returns that default value directly (no `.default`)."
   }
 });
 JSBlockRunJSContext.define(
@@ -80,7 +80,7 @@ JSBlockRunJSContext.define(
     methods: {
       onRefReady: "\u5BB9\u5668 ref \u5C31\u7EEA\u56DE\u8C03\uFF1A\n```js\nctx.onRefReady(ctx.ref, el => { /* ... */ })\n```",
       requireAsync: "\u52A0\u8F7D\u5916\u90E8\u5E93\uFF1A`const lib = await ctx.requireAsync(url)`",
-      importAsync: "\u6309 URL \u52A8\u6001\u5BFC\u5165 ESM \u6A21\u5757\uFF1A`const mod = await ctx.importAsync(url)`"
+      importAsync: "\u6309 URL \u52A8\u6001\u5BFC\u5165 ESM \u6A21\u5757\uFF1A`const mod = await ctx.importAsync(url)`\u3002\n\u6CE8\u610F\uFF1A\u5F53\u6A21\u5757\u53EA\u6709 default \u4E00\u4E2A\u5BFC\u51FA\u65F6\uFF0Cctx.importAsync \u4F1A\u76F4\u63A5\u8FD4\u56DE default \u503C\uFF08\u65E0\u9700\u518D\u5199 `.default`\uFF09\u3002"
     }
   },
   { locale: "zh-CN" }

package/lib/runjs-context/contexts/JSEditableFieldRunJSContext.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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.
+ */
+import { FlowRunJSContext } from '../../flowContext';
+/**
+ * RunJS context for JSEditableFieldModel (form editable custom field).
+ * NOTE: Some APIs (e.g., getValue/setValue/element) are provided by the model's runtime handler.
+ * This doc is used for editor autocomplete and AI coding assistance.
+ */
+export declare class JSEditableFieldRunJSContext extends FlowRunJSContext {
+}