@nocobase/flow-engine 2.0.0-alpha.4 → 2.0.0-alpha.41

package/lib/models/forkFlowModel.js

@@ -38,10 +38,10 @@ __export(forkFlowModel_exports, {
 module.exports = __toCommonJS(forkFlowModel_exports);
 var import_reactive = require("@formily/reactive");
 var import_flowContext = require("../flowContext");
-var import_flowEngine = require("../flowEngine");
+var import_secure = require("uid/secure");
 var _flowContext;
 const _ForkFlowModel = class _ForkFlowModel {
-  constructor(master, initialProps = {}, forkId = 0) {
+  constructor(master, initialProps = {}, forkId) {
     /** 与 master 相同的 UID，用于日志调试 */
     __publicField(this, "uid");
     /** 调试标识，便于在日志或断言中快速识别 */
@@ -65,7 +65,7 @@ const _ForkFlowModel = class _ForkFlowModel {
     this.master = master;
     this.uid = master.uid;
     this.localProps = { ...initialProps };
-    this.forkId = forkId;
+    this.forkId = forkId || (0, import_secure.uid)();
     this.hidden = this.master.hidden;
     (0, import_reactive.define)(this, {
       localProps: import_reactive.observable,
@@ -179,6 +179,12 @@ const _ForkFlowModel = class _ForkFlowModel {
       this.localProps = { ...this.localProps, ...key };
     }
   }
+  /**
+   * 清理局部 props，仅影响当前 fork
+   */
+  clearProps() {
+    return this.localProps = {};
+  }
   /**
    * render 依旧使用 master 的方法，但合并后的 props 需要透传
    */
@@ -194,10 +200,10 @@ const _ForkFlowModel = class _ForkFlowModel {
     }
   }
   /**
-   * 自动流程缓存的作用域标识（fork 专用）。
+   * 事件缓存的作用域标识（fork 专用）。
    */
-  getAutoFlowCacheScope() {
-    return String(this.forkId);
+  getFlowCacheScope(eventName) {
+    return `${String(eventName)}:${String(this.forkId)}`;
   }
   // onUnmount() {
   //   // 不在此处自动 dispose（避免破坏外部 fork 管理），但应透传到 master 的 onUnmount 钩子，
@@ -216,11 +222,35 @@ const _ForkFlowModel = class _ForkFlowModel {
    * 释放 fork：从 master.forks 中移除自身并断开引用
    */
   dispose() {
+    var _a;
     if (this.disposed) return;
     this.disposed = true;
+    try {
+      const cache = (_a = this.flowEngine) == null ? void 0 : _a.applyFlowCache;
+      if (cache && cache.size > 0) {
+        const uidSuffixes = [`:${this.uid}`, `-${this.uid}`];
+        const forkIdColon = `:${this.forkId}:`;
+        const forkIdHyphen = `-${this.forkId}-`;
+        for (const key of cache.keys()) {
+          const isEventCache = key.startsWith("event:") || key.startsWith("event-");
+          if (!isEventCache) continue;
+          const endMatches = uidSuffixes.some((s) => key.endsWith(s));
+          if (!endMatches) continue;
+          let trimmed = key;
+          for (const suf of uidSuffixes) {
+            if (trimmed.endsWith(suf)) {
+              trimmed = trimmed.slice(0, -suf.length);
+              break;
+            }
+          }
+          if (trimmed.includes(forkIdColon) || trimmed.includes(forkIdHyphen)) {
+            cache.delete(key);
+          }
+        }
+      }
+    } catch {
+    }
     if (this.master && this.master.forks) {
-      const forkCacheKey = import_flowEngine.FlowEngine.generateApplyFlowCacheKey(`${this.forkId}`, "all", this.uid);
-      this.flowEngine.applyFlowCache.delete(forkCacheKey);
       this.master.forks.delete(this);
     }
     if (this.master && this.master.forkCache) {

package/lib/provider.d.ts

@@ -17,6 +17,8 @@ export declare const FlowEngineProvider: React.FC<FlowEngineProviderProps>;
 export declare const FlowEngineGlobalsContextProvider: React.FC<{
     children: React.ReactNode;
 }>;
-export declare const useFlowEngine: () => FlowEngine;
+export declare const useFlowEngine: ({ throwError }?: {
+    throwError?: boolean;
+}) => FlowEngine;
 export declare const useFlowEngineContext: () => FlowEngineContext;
 export {};

package/lib/provider.js

@@ -49,14 +49,16 @@ var import_FlowContextProvider = require("./FlowContextProvider");
 var import_views = require("./views");
 var import_FlowView = require("./views/FlowView");
 const FlowEngineReactContext = (0, import_react.createContext)(null);
-const FlowEngineProvider = /* @__PURE__ */ __name((props) => {
+const FlowEngineProvider = import_react.default.memo((props) => {
   const { engine, children } = props;
   if (!engine) {
     throw new Error("FlowEngineProvider must be supplied with an engine.");
   }
   return /* @__PURE__ */ import_react.default.createElement(FlowEngineReactContext.Provider, { value: engine }, /* @__PURE__ */ import_react.default.createElement(import_FlowContextProvider.FlowContextProvider, { context: engine.context }, children));
-}, "FlowEngineProvider");
+});
+FlowEngineProvider.displayName = "FlowEngineProvider";
 const FlowEngineGlobalsContextProvider = /* @__PURE__ */ __name(({ children }) => {
+  var _a;
   const { modal, message, notification } = import_antd.App.useApp();
   const [drawer, contextHolder] = (0, import_views.useDrawer)();
   const [embed, pageContextHolder] = (0, import_views.usePage)();
@@ -90,11 +92,11 @@ const FlowEngineGlobalsContextProvider = /* @__PURE__ */ __name(({ children }) =
     }
     engine.reactView.refresh();
   }, [engine, drawer, modal, message, notification, config, popover, token, dialog, embed]);
-  return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, children, contextHolder, popoverContextHolder, pageContextHolder, dialogContextHolder);
+  return /* @__PURE__ */ import_react.default.createElement(import_antd.ConfigProvider, { ...config, locale: (_a = engine.context.locales) == null ? void 0 : _a.antd, popupMatchSelectWidth: false }, children, contextHolder, popoverContextHolder, pageContextHolder, dialogContextHolder);
 }, "FlowEngineGlobalsContextProvider");
-const useFlowEngine = /* @__PURE__ */ __name(() => {
+const useFlowEngine = /* @__PURE__ */ __name(({ throwError = true } = {}) => {
   const context = (0, import_react.useContext)(FlowEngineReactContext);
-  if (!context) {
+  if (!context && throwError) {
     throw new Error(
       "useFlowEngine must be used within a FlowEngineProvider, and FlowEngineProvider must be supplied with an engine."
     );

package/lib/resources/multiRecordResource.js

@@ -130,6 +130,7 @@ const _MultiRecordResource = class _MultiRecordResource extends import_baseRecor
   async create(data, options) {
     const config = this.mergeRequestConfig({ data }, this.createActionOptions, options);
     await this.runAction("create", config);
+    this.emit("saved", data);
     await this.refresh();
   }
   async get(filterByTk) {
@@ -144,17 +145,35 @@ const _MultiRecordResource = class _MultiRecordResource extends import_baseRecor
     return data;
   }
   async update(filterByTk, data, options) {
+    const collection = this.context.collection;
+    const filterTargetKey = collection == null ? void 0 : collection.filterTargetKey;
+    const tkData = collection == null ? void 0 : collection.getFilterByTK(this.context.record);
+    let result = data;
+    if (collection && filterTargetKey) {
+      if (Array.isArray(filterTargetKey)) {
+        result = {
+          ...data,
+          ...tkData || {}
+        };
+      } else {
+        result = {
+          ...data,
+          [filterTargetKey]: tkData
+        };
+      }
+    }
     const config = this.mergeRequestConfig(
       {
         params: {
           filterByTk
         },
-        data
+        data: result
       },
       this.updateActionOptions,
       options
     );
     await this.runAction("update", config);
+    this.emit("saved", data);
     await this.refresh();
   }
   async destroySelectedRows() {
@@ -176,6 +195,11 @@ const _MultiRecordResource = class _MultiRecordResource extends import_baseRecor
       options
     );
     await this.runAction("destroy", config);
+    const currentPage = this.getPage();
+    const lastPage = Math.ceil((this.getCount() - import_lodash.default.castArray(filterByTk).length) / this.getPageSize());
+    if (currentPage > lastPage) {
+      this.setPage(lastPage);
+    }
     await this.refresh();
   }
   setItem(index, newDataItem) {

package/lib/resources/singleRecordResource.js

@@ -60,15 +60,33 @@ const _SingleRecordResource = class _SingleRecordResource extends import_baseRec
   async save(data, options) {
     const config = this.mergeRequestConfig(this.saveActionOptions, import_lodash.default.omit(options, ["refresh"]));
     let actionName = "create";
+    let result = data;
     if (!this.isNewRecord) {
       config.params = config.params || {};
       config.params.filterByTk = this.getFilterByTk();
       actionName = "update";
+      const collection = this.context.collection;
+      const filterTargetKey = collection == null ? void 0 : collection.filterTargetKey;
+      const tkData = collection == null ? void 0 : collection.getFilterByTK(this.context.record);
+      if (collection && filterTargetKey) {
+        if (Array.isArray(filterTargetKey)) {
+          result = {
+            ...data,
+            ...tkData || {}
+          };
+        } else {
+          result = {
+            ...data,
+            [filterTargetKey]: tkData
+          };
+        }
+      }
     }
     await this.runAction(actionName, {
       ...config,
-      data
+      data: result
     });
+    this.emit("saved", data);
     if ((options == null ? void 0 : options.refresh) !== false) {
       await this.refresh();
     }

package/lib/resources/sqlResource.d.ts

@@ -61,6 +61,7 @@ export declare class SQLResource<TData = any> extends BaseRecordResource<TData>
     setFilterByTk(filterByTk: any): this;
     setFilter(filter: Record<string, any>): this;
     setBind(bind: Record<string, any> | Array<any>): this;
+    setLiquidContext(liquidContext: Record<string, any>): this;
     run(): Promise<any>;
     runBySQL(): Promise<any>;
     runById(): Promise<any>;

package/lib/resources/sqlResource.js

@@ -45,18 +45,7 @@ var import_reactive = require("@formily/reactive");
 var import_lodash = __toESM(require("lodash"));
 var import_flowContext = require("../flowContext");
 var import_baseRecordResource = require("./baseRecordResource");
-function transformSQL(template) {
-  let index = 1;
-  const bind = {};
-  const sql = template.replace(/{{\s*([^}]+)\s*}}/g, (_2, expr) => {
-    const key = `__var${index}`;
-    bind[key] = `{{${expr.trim()}}}`;
-    index++;
-    return `$${key}`;
-  });
-  return { sql, bind };
-}
-__name(transformSQL, "transformSQL");
+var import_client = require("@nocobase/utils/client");
 const _FlowSQLRepository = class _FlowSQLRepository {
   ctx;
   constructor(ctx) {
@@ -72,16 +61,17 @@ const _FlowSQLRepository = class _FlowSQLRepository {
     });
   }
   async run(sql, options = {}) {
-    const result = transformSQL(sql);
-    const bind = await this.ctx.resolveJsonTemplate(result.bind);
+    const { sql: transformedSQL, bind, liquidContext } = await (0, import_client.transformSQL)(sql);
+    const resolved = await this.ctx.resolveJsonTemplate({ bind, liquidContext });
+    const parsedSQL = await (0, import_client.parseLiquidContext)(transformedSQL, resolved.liquidContext);
     const { data } = await this.ctx.api.request({
       method: "POST",
       url: "flowSql:run",
       data: {
-        sql: result.sql,
+        sql: parsedSQL,
         ...options,
         bind: {
-          ...bind,
+          ...resolved.bind,
           ...options.bind
         }
       }
@@ -105,7 +95,7 @@ const _FlowSQLRepository = class _FlowSQLRepository {
         uid
       }
     });
-    const bind = await this.ctx.resolveJsonTemplate(response.data.data || {});
+    const { bind, liquidContext } = await this.ctx.resolveJsonTemplate(response.data.data || {});
     const { data } = await this.ctx.api.request({
       method: "POST",
       url: "flowSql:runById",
@@ -114,8 +104,9 @@ const _FlowSQLRepository = class _FlowSQLRepository {
         ...options,
         bind: {
           ...bind,
-          ...options.bind
-        }
+          ...options == null ? void 0 : options.bind
+        },
+        liquidContext
       }
     });
     return data == null ? void 0 : data.data;
@@ -227,19 +218,23 @@ const _SQLResource = class _SQLResource extends import_baseRecordResource.BaseRe
     this.request.data.bind = bind;
     return this;
   }
+  setLiquidContext(liquidContext) {
+    this.request.data.liquidContext = liquidContext;
+    return this;
+  }
   async run() {
     return this._debugEnabled ? await this.runBySQL() : await this.runById();
   }
   async runBySQL() {
     const sql = this._sql;
-    const result = transformSQL(sql);
-    const bind = await this.context.resolveJsonTemplate(result.bind);
+    const { sql: transformedSQL, bind, liquidContext } = await (0, import_client.transformSQL)(sql);
+    const resolved = await this.context.resolveJsonTemplate({ bind, liquidContext });
     const options = import_lodash.default.cloneDeep({
       method: "post",
       ...this.getRefreshRequestOptions()
     });
-    options.data.bind = bind;
-    options.data.sql = result.sql;
+    options.data.sql = await (0, import_client.parseLiquidContext)(transformedSQL, resolved.liquidContext);
+    options.data.bind = resolved.bind;
     return await this.runAction("run", options);
   }
   async runById() {
@@ -249,8 +244,9 @@ const _SQLResource = class _SQLResource extends import_baseRecordResource.BaseRe
         uid: this.request.data.uid
       }
     });
-    const bind = await this.context.resolveJsonTemplate(data);
+    const { bind, liquidContext } = await this.context.resolveJsonTemplate(data);
     this.setBind(bind);
+    this.setLiquidContext(liquidContext);
     return await this.runAction("runById", {
       method: "post",
       ...this.getRefreshRequestOptions()

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

@@ -6,11 +6,6 @@
  * 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 './FlowRunJSContext';
+import { FlowRunJSContext } from '../../flowContext';
 export declare class FormJSFieldItemRunJSContext extends FlowRunJSContext {
-    static injectDefaultGlobals(): {
-        window: {};
-        document: {};
-    };
-    constructor(delegate: any);
 }

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

@@ -30,36 +30,43 @@ __export(FormJSFieldItemRunJSContext_exports, {
   FormJSFieldItemRunJSContext: () => FormJSFieldItemRunJSContext
 });
 module.exports = __toCommonJS(FormJSFieldItemRunJSContext_exports);
-var import_FlowRunJSContext = require("./FlowRunJSContext");
-var import_utils = require("../../utils");
-const _FormJSFieldItemRunJSContext = class _FormJSFieldItemRunJSContext extends import_FlowRunJSContext.FlowRunJSContext {
-  static injectDefaultGlobals() {
-    return { window: (0, import_utils.createSafeWindow)(), document: (0, import_utils.createSafeDocument)() };
-  }
-  constructor(delegate) {
-    super(delegate);
-    this.defineProperty("element", { get: /* @__PURE__ */ __name(() => this._delegate["element"], "get") });
-    this.defineProperty("record", { get: /* @__PURE__ */ __name(() => this._delegate["record"], "get") });
-    this.defineProperty("value", { get: /* @__PURE__ */ __name(() => this._delegate["value"], "get") });
-  }
+var import_flowContext = require("../../flowContext");
+const _FormJSFieldItemRunJSContext = class _FormJSFieldItemRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_FormJSFieldItemRunJSContext, "FormJSFieldItemRunJSContext");
 let FormJSFieldItemRunJSContext = _FormJSFieldItemRunJSContext;
 FormJSFieldItemRunJSContext.define({
   label: "FormJSFieldItem RunJS context",
   properties: {
-    element: "ElementProxy\uFF0C\u8868\u5355\u5B57\u6BB5\u5BB9\u5668",
-    value: "\u5B57\u6BB5\u503C\uFF08\u8BFB/\u53D7\u63A7\u573A\u666F\u9700\u901A\u8FC7 setProps \u4FEE\u6539\uFF09",
-    record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09"
+    element: `ElementProxy instance providing a safe DOM container for form field rendering.
+      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.`
   },
   methods: {
-    onRefReady: "\u5BB9\u5668\u5C31\u7EEA\u56DE\u8C03",
-    setProps: "\u8BBE\u7F6E\u8868\u5355\u9879\u5C5E\u6027\uFF1A`setProps(fieldModel, { value })`\uFF08\u7531\u8054\u52A8/\u8868\u5355\u4E0A\u4E0B\u6587\u63D0\u4F9B\uFF09"
-  },
-  snipastes: {
-    \u663E\u793A\u5B57\u6BB5\u503C: { $ref: "scene/jsfield/innerHTML-value", prefix: "sn-form-value" }
+    onRefReady: `Wait for form field container DOM element to be ready before executing callback.
+      Parameters: (ref: React.RefObject, callback: (element: HTMLElement) => void, timeout?: number) => void`,
+    setProps: `Set form field properties programmatically.
+      Parameters: (fieldModel: any, props: { value?: any, disabled?: boolean, visible?: boolean }) => void
+      Example: ctx.setProps(fieldModel, { value: "new value" })`
   }
 });
+FormJSFieldItemRunJSContext.define(
+  {
+    label: "\u8868\u5355 JS \u5B57\u6BB5\u9879 RunJS \u4E0A\u4E0B\u6587",
+    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"
+    },
+    methods: {
+      onRefReady: "\u5BB9\u5668\u5C31\u7EEA\u56DE\u8C03",
+      setProps: "\u8BBE\u7F6E\u8868\u5355\u9879\u5C5E\u6027\uFF1A`setProps(fieldModel, { value })`\uFF08\u7531\u8054\u52A8/\u8868\u5355\u4E0A\u4E0B\u6587\u63D0\u4F9B\uFF09"
+    }
+  },
+  { locale: "zh-CN" }
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   FormJSFieldItemRunJSContext

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

@@ -6,11 +6,6 @@
  * 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 './FlowRunJSContext';
+import { FlowRunJSContext } from '../../flowContext';
 export declare class JSBlockRunJSContext extends FlowRunJSContext {
-    static injectDefaultGlobals(): {
-        window: {};
-        document: {};
-    };
-    constructor(delegate: any);
 }

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

@@ -30,48 +30,61 @@ __export(JSBlockRunJSContext_exports, {
   JSBlockRunJSContext: () => JSBlockRunJSContext
 });
 module.exports = __toCommonJS(JSBlockRunJSContext_exports);
-var import_FlowRunJSContext = require("./FlowRunJSContext");
-var import_utils = require("../../utils");
-const _JSBlockRunJSContext = class _JSBlockRunJSContext extends import_FlowRunJSContext.FlowRunJSContext {
-  static injectDefaultGlobals() {
-    return { window: (0, import_utils.createSafeWindow)(), document: (0, import_utils.createSafeDocument)() };
-  }
-  constructor(delegate) {
-    super(delegate);
-    this.defineProperty("element", { get: /* @__PURE__ */ __name(() => this._delegate["element"], "get") });
-    this.defineProperty("record", { get: /* @__PURE__ */ __name(() => this._delegate["record"], "get") });
-    this.defineProperty("value", { get: /* @__PURE__ */ __name(() => this._delegate["value"], "get") });
-  }
+var import_flowContext = require("../../flowContext");
+const _JSBlockRunJSContext = class _JSBlockRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSBlockRunJSContext, "JSBlockRunJSContext");
 let JSBlockRunJSContext = _JSBlockRunJSContext;
 JSBlockRunJSContext.define({
-  label: "JSBlock RunJS context",
+  label: "RunJS context",
   properties: {
-    element: "ElementProxy\uFF0C\u5B89\u5168 DOM \u5BB9\u5668\u3002\u652F\u6301 innerHTML/append \u7B49",
-    record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF0C\u5B58\u5728\u4E8E\u6570\u636E\u5757/\u8BE6\u60C5\u7B49\u573A\u666F\uFF09",
-    value: "\u5F53\u524D\u503C\uFF08\u82E5\u5B58\u5728\uFF09",
-    React: "React\uFF08\u5DF2\u6CE8\u5165\uFF09",
-    antd: "AntD\uFF08\u5DF2\u6CE8\u5165\uFF09"
+    element: {
+      description: `ElementProxy instance providing a safe DOM container.
+      Supports innerHTML, append, and other DOM manipulation methods.
+      Use this to render content in the JS block.`,
+      detail: "ElementProxy",
+      properties: {
+        innerHTML: "Set or read the HTML content of the container element."
+      }
+    },
+    record: `Current record data object (read-only).
+      Available when the JS block is within a data block or detail view context.`,
+    value: "Current value of the field or component, if available in the current context.",
+    React: "React library",
+    antd: "Ant Design library"
   },
   methods: {
-    onRefReady: "Container ref ready callback:\n```js\nctx.onRefReady(ctx.ref, el => { /* ... */ })\n```",
-    requireAsync: "Load external library: `const lib = await ctx.requireAsync(url)`"
-  },
-  snipastes: {
-    "Render HTML": { $ref: "scene/jsblock/render-basic", prefix: "sn-jsb-html" },
-    "Render React": { $ref: "scene/jsblock/render-react", prefix: "sn-jsb-react" },
-    "Init ECharts": { $ref: "libs/echarts-init", prefix: "sn-echarts" },
-    "Render card": { $ref: "scene/jsblock/render-card", prefix: "sn-jsb-card" },
-    "Button handler": { $ref: "scene/jsblock/render-button-handler", prefix: "sn-jsb-button" },
-    "JSX mount": { $ref: "scene/jsblock/jsx-mount", prefix: "sn-jsx-mount" },
-    "JSX unmount": { $ref: "scene/jsblock/jsx-unmount", prefix: "sn-jsx-unmount" },
-    Notification: { $ref: "global/notification-open", prefix: "sn-notify" },
-    "Window open": { $ref: "global/window-open", prefix: "sn-window-open" },
-    "Add click listener": { $ref: "scene/jsblock/add-event-listener", prefix: "sn-jsb-click" },
-    "Append style": { $ref: "scene/jsblock/append-style", prefix: "sn-jsb-style" }
+    onRefReady: `Wait for container DOM element to be ready before executing callback.
+      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)`"
   }
 });
+JSBlockRunJSContext.define(
+  {
+    label: "RunJS \u4E0A\u4E0B\u6587",
+    properties: {
+      element: {
+        description: "ElementProxy\uFF0C\u5B89\u5168\u7684 DOM \u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49",
+        detail: "ElementProxy",
+        properties: {
+          innerHTML: "\u8BFB\u53D6\u6216\u8BBE\u7F6E\u5BB9\u5668\u7684 HTML \u5185\u5BB9"
+        }
+      },
+      record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF0C\u7528\u4E8E\u6570\u636E\u533A\u5757/\u8BE6\u60C5\u7B49\u573A\u666F\uFF09",
+      value: "\u5F53\u524D\u503C\uFF08\u82E5\u5B58\u5728\uFF09",
+      React: "React \u5E93",
+      antd: "Ant Design \u5E93"
+    },
+    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)`"
+    }
+  },
+  { locale: "zh-CN" }
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   JSBlockRunJSContext

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

@@ -6,7 +6,6 @@
  * 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 './FlowRunJSContext';
+import { FlowRunJSContext } from '../../flowContext';
 export declare class JSCollectionActionRunJSContext extends FlowRunJSContext {
-    constructor(delegate: any);
 }

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

@@ -30,29 +30,28 @@ __export(JSCollectionActionRunJSContext_exports, {
   JSCollectionActionRunJSContext: () => JSCollectionActionRunJSContext
 });
 module.exports = __toCommonJS(JSCollectionActionRunJSContext_exports);
-var import_FlowRunJSContext = require("./FlowRunJSContext");
-const _JSCollectionActionRunJSContext = class _JSCollectionActionRunJSContext extends import_FlowRunJSContext.FlowRunJSContext {
-  constructor(delegate) {
-    super(delegate);
-    this.defineProperty("resource", { get: /* @__PURE__ */ __name(() => this._delegate["resource"], "get") });
-  }
+var import_flowContext = require("../../flowContext");
+const _JSCollectionActionRunJSContext = class _JSCollectionActionRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSCollectionActionRunJSContext, "JSCollectionActionRunJSContext");
 let JSCollectionActionRunJSContext = _JSCollectionActionRunJSContext;
 JSCollectionActionRunJSContext.define({
   label: "JSCollectionAction RunJS context",
   properties: {
-    resource: "\u5217\u8868\u8D44\u6E90\uFF08\u9009\u4E2D\u884C/\u5206\u9875\u7B49\uFF09"
-  },
-  methods: {
-    runAction: "Run action",
-    message: "Message API"
-  },
-  snipastes: {
-    "Selected count": { $ref: "scene/actions/collection-selected-count", prefix: "sn-act-selected-count" },
-    "Iterate selected rows": { $ref: "scene/actions/iterate-selected-rows", prefix: "sn-act-iterate" }
+    resource: `Collection resource instance providing access to selected rows, pagination, and data operations.
+      Use ctx.resource.selectedRows to get selected records.
+      Use ctx.resource.pagination for page info.`
   }
 });
+JSCollectionActionRunJSContext.define(
+  {
+    label: "JS \u96C6\u5408\u52A8\u4F5C RunJS \u4E0A\u4E0B\u6587",
+    properties: {
+      resource: "\u5217\u8868\u8D44\u6E90\uFF08\u5305\u542B\u9009\u4E2D\u884C/\u5206\u9875\u4FE1\u606F\u7B49\uFF09"
+    }
+  },
+  { locale: "zh-CN" }
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   JSCollectionActionRunJSContext

package/lib/runjs-context/contexts/{LinkageRunJSContext.d.ts → JSColumnRunJSContext.d.ts}

@@ -6,7 +6,10 @@
  * 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 './FlowRunJSContext';
-export declare class LinkageRunJSContext extends FlowRunJSContext {
-    constructor(delegate: any);
+import { FlowRunJSContext } from '../../flowContext';
+/**
+ * RunJS context for JSColumnModel (table custom column).
+ * Focused on per-row rendering with access to current record and cell element.
+ */
+export declare class JSColumnRunJSContext extends FlowRunJSContext {
 }