@nocobase/flow-engine 2.0.0-alpha.2 → 2.0.0-alpha.20

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) {
@@ -155,6 +156,7 @@ const _MultiRecordResource = class _MultiRecordResource extends import_baseRecor
       options
     );
     await this.runAction("update", config);
+    this.emit("saved", data);
     await this.refresh();
   }
   async destroySelectedRows() {

package/lib/resources/singleRecordResource.js

@@ -69,6 +69,7 @@ const _SingleRecordResource = class _SingleRecordResource extends import_baseRec
       ...config,
       data
     });
+    this.emit("saved", data);
     if ((options == null ? void 0 : options.refresh) !== false) {
       await this.refresh();
     }

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 {
 }

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

@@ -0,0 +1,78 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var JSColumnRunJSContext_exports = {};
+__export(JSColumnRunJSContext_exports, {
+  JSColumnRunJSContext: () => JSColumnRunJSContext
+});
+module.exports = __toCommonJS(JSColumnRunJSContext_exports);
+var import_flowContext = require("../../flowContext");
+const _JSColumnRunJSContext = class _JSColumnRunJSContext extends import_flowContext.FlowRunJSContext {
+};
+__name(_JSColumnRunJSContext, "JSColumnRunJSContext");
+let JSColumnRunJSContext = _JSColumnRunJSContext;
+JSColumnRunJSContext.define({
+  label: "JSColumn RunJS context",
+  properties: {
+    element: "ElementProxy instance providing a safe DOM container for the current table cell. Supports innerHTML/append and basic DOM APIs.",
+    record: "Current row record object (read-only).",
+    recordIndex: "Index of the current row in the page (0-based).",
+    collection: "Collection definition metadata (read-only).",
+    viewer: "View controller providing dialog/drawer/embed helpers for interactions initiated from the cell (e.g., open details).",
+    React: "React library",
+    antd: "Ant Design library"
+  },
+  methods: {
+    onRefReady: "Wait for cell DOM element to be ready before executing callback. Parameters: (ref, callback, timeout?) => void",
+    requireAsync: "Load external library by URL: `const lib = await ctx.requireAsync(url)`",
+    importAsync: "Dynamically import ESM module by URL: `const mod = await ctx.importAsync(url)`"
+  }
+});
+JSColumnRunJSContext.define(
+  {
+    label: "JS \u5217 RunJS \u4E0A\u4E0B\u6587",
+    properties: {
+      element: "ElementProxy\uFF0C\u8868\u683C\u5355\u5143\u683C\u7684\u5B89\u5168 DOM \u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49",
+      record: "\u5F53\u524D\u884C\u8BB0\u5F55\u5BF9\u8C61\uFF08\u53EA\u8BFB\uFF09",
+      recordIndex: "\u5F53\u524D\u884C\u7D22\u5F15\uFF08\u4ECE 0 \u5F00\u59CB\uFF09",
+      collection: "\u96C6\u5408\u5B9A\u4E49\u5143\u6570\u636E\uFF08\u53EA\u8BFB\uFF09",
+      viewer: "\u89C6\u56FE\u63A7\u5236\u5668\uFF0C\u53EF\u7528\u4E8E\u5728\u5355\u5143\u683C\u4E2D\u89E6\u53D1\u62BD\u5C49/\u5BF9\u8BDD\u6846/\u5185\u5D4C\u7B49\u4EA4\u4E92",
+      React: "React \u5E93",
+      antd: "Ant Design \u5E93"
+    },
+    methods: {
+      onRefReady: "\u7B49\u5F85\u5355\u5143\u683C DOM \u5C31\u7EEA\u540E\u6267\u884C\u56DE\u8C03\u3002\u53C2\u6570\uFF1A(ref, callback, timeout?)",
+      requireAsync: "\u6309 URL \u5F02\u6B65\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 = {
+  JSColumnRunJSContext
+});

package/lib/runjs-context/contexts/JSFieldRunJSContext.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 JSFieldRunJSContext extends FlowRunJSContext {
-    static injectDefaultGlobals(): {
-        window: {};
-        document: {};
-    };
-    constructor(delegate: any);
 }

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

@@ -30,40 +30,44 @@ __export(JSFieldRunJSContext_exports, {
   JSFieldRunJSContext: () => JSFieldRunJSContext
 });
 module.exports = __toCommonJS(JSFieldRunJSContext_exports);
-var import_FlowRunJSContext = require("./FlowRunJSContext");
-var import_utils = require("../../utils");
-const _JSFieldRunJSContext = class _JSFieldRunJSContext 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("value", { get: /* @__PURE__ */ __name(() => this._delegate["value"], "get") });
-    this.defineProperty("record", { get: /* @__PURE__ */ __name(() => this._delegate["record"], "get") });
-    this.defineProperty("collection", { get: /* @__PURE__ */ __name(() => this._delegate["collection"], "get") });
-  }
+var import_flowContext = require("../../flowContext");
+const _JSFieldRunJSContext = class _JSFieldRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSFieldRunJSContext, "JSFieldRunJSContext");
 let JSFieldRunJSContext = _JSFieldRunJSContext;
 JSFieldRunJSContext.define({
   label: "JSField RunJS context",
   properties: {
-    element: "ElementProxy\uFF0C\u5B57\u6BB5\u6E32\u67D3\u5BB9\u5668",
-    value: "\u5B57\u6BB5\u5F53\u524D\u503C\uFF08\u53EA\u8BFB\uFF09",
-    record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09",
-    collection: "\u96C6\u5408\u5B9A\u4E49\uFF08\u53EA\u8BFB\uFF09"
+    element: `ElementProxy instance providing a safe DOM container for field rendering.
+      Supports innerHTML, append, and other DOM manipulation methods.`,
+    value: `Current value of the field (read-only).
+      Contains the data value stored in this field.`,
+    record: `Current record data object (read-only).
+      Contains all field values of the parent record.`,
+    collection: `Collection definition metadata (read-only).
+      Provides schema information about the collection this field belongs to.`
   },
   methods: {
-    onRefReady: "Container ready callback"
-  },
-  snipastes: {
-    "Render value": { $ref: "scene/jsfield/innerHTML-value", prefix: "sn-jsf-value" },
-    "Message success": { $ref: "global/message-success", prefix: "sn-msg-ok" },
-    "Format number": { $ref: "scene/jsfield/format-number", prefix: "sn-jsf-num" },
-    "Color by value": { $ref: "scene/jsfield/color-by-value", prefix: "sn-jsf-color" }
+    onRefReady: `Wait for field 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 = ctx.value })`
   }
 });
+JSFieldRunJSContext.define(
+  {
+    label: "JS \u5B57\u6BB5 RunJS \u4E0A\u4E0B\u6587",
+    properties: {
+      element: "ElementProxy\uFF0C\u5B57\u6BB5\u6E32\u67D3\u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49 DOM \u64CD\u4F5C",
+      value: "\u5B57\u6BB5\u5F53\u524D\u503C\uFF08\u53EA\u8BFB\uFF09",
+      record: "\u5F53\u524D\u8BB0\u5F55\u5BF9\u8C61\uFF08\u53EA\u8BFB\uFF0C\u5305\u542B\u7236\u8BB0\u5F55\u5168\u90E8\u5B57\u6BB5\u503C\uFF09",
+      collection: "\u96C6\u5408\u5B9A\u4E49\u5143\u6570\u636E\uFF08\u53EA\u8BFB\uFF0C\u63CF\u8FF0\u5B57\u6BB5\u6240\u5C5E\u96C6\u5408\u7684 Schema\uFF09"
+    },
+    methods: {
+      onRefReady: "\u5728\u5B57\u6BB5\u5BB9\u5668 DOM \u5C31\u7EEA\u540E\u6267\u884C\u56DE\u8C03\u3002\u53C2\u6570\uFF1A(ref, callback, timeout?)\uFF1B\u793A\u4F8B\uFF1Actx.onRefReady(ctx.ref, el => { el.innerHTML = ctx.value })"
+    }
+  },
+  { locale: "zh-CN" }
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   JSFieldRunJSContext

package/lib/runjs-context/contexts/JSItemRunJSContext.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 JSItemRunJSContext extends FlowRunJSContext {
-    static injectDefaultGlobals(): {
-        window: {};
-        document: {};
-    };
-    constructor(delegate: any);
 }

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

@@ -30,36 +30,40 @@ __export(JSItemRunJSContext_exports, {
   JSItemRunJSContext: () => JSItemRunJSContext
 });
 module.exports = __toCommonJS(JSItemRunJSContext_exports);
-var import_FlowRunJSContext = require("./FlowRunJSContext");
-var import_utils = require("../../utils");
-const _JSItemRunJSContext = class _JSItemRunJSContext 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("resource", { get: /* @__PURE__ */ __name(() => this._delegate["resource"], "get") });
-  }
+var import_flowContext = require("../../flowContext");
+const _JSItemRunJSContext = class _JSItemRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSItemRunJSContext, "JSItemRunJSContext");
 let JSItemRunJSContext = _JSItemRunJSContext;
 JSItemRunJSContext.define({
   label: "JSItem RunJS context",
   properties: {
-    element: "ElementProxy\uFF0C\u8868\u5355\u9879\u6E32\u67D3\u5BB9\u5668",
-    resource: "\u5F53\u524D\u8D44\u6E90\uFF08\u53EA\u8BFB\uFF09",
-    record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09"
+    element: `ElementProxy instance providing a safe DOM container for form item rendering.
+      Supports innerHTML, append, and other DOM manipulation methods.`,
+    resource: `Current resource instance (read-only).
+      Provides access to the data resource associated with the current form context.`,
+    record: `Current record data object (read-only).
+      Contains all field values of the parent record.`
   },
   methods: {
-    onRefReady: "Container ready callback",
-    requireAsync: "Load external library"
-  },
-  snipastes: {
-    "Render form item": { $ref: "scene/jsitem/render-basic", prefix: "sn-jsitem-basic" }
+    onRefReady: `Wait for form item container DOM element to be ready before executing callback.
+      Parameters: (ref: React.RefObject, callback: (element: HTMLElement) => void, timeout?: number) => void`
   }
 });
+JSItemRunJSContext.define(
+  {
+    label: "JS \u8868\u5355\u9879 RunJS \u4E0A\u4E0B\u6587",
+    properties: {
+      element: "ElementProxy\uFF0C\u8868\u5355\u9879\u6E32\u67D3\u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49 DOM \u64CD\u4F5C",
+      resource: "\u5F53\u524D\u8D44\u6E90\uFF08\u53EA\u8BFB\uFF09",
+      record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09"
+    },
+    methods: {
+      onRefReady: "\u5BB9\u5668\u5C31\u7EEA\u540E\u6267\u884C\u56DE\u8C03\u3002\u53C2\u6570\uFF1A(ref, callback, timeout?)"
+    }
+  },
+  { locale: "zh-CN" }
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   JSItemRunJSContext

package/lib/runjs-context/contexts/JSRecordActionRunJSContext.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 JSRecordActionRunJSContext extends FlowRunJSContext {
-    constructor(delegate: any);
 }

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

@@ -30,31 +30,30 @@ __export(JSRecordActionRunJSContext_exports, {
   JSRecordActionRunJSContext: () => JSRecordActionRunJSContext
 });
 module.exports = __toCommonJS(JSRecordActionRunJSContext_exports);
-var import_FlowRunJSContext = require("./FlowRunJSContext");
-const _JSRecordActionRunJSContext = class _JSRecordActionRunJSContext extends import_FlowRunJSContext.FlowRunJSContext {
-  constructor(delegate) {
-    super(delegate);
-    this.defineProperty("record", { get: /* @__PURE__ */ __name(() => this._delegate["record"], "get") });
-    this.defineProperty("filterByTk", { get: /* @__PURE__ */ __name(() => this._delegate["filterByTk"], "get") });
-  }
+var import_flowContext = require("../../flowContext");
+const _JSRecordActionRunJSContext = class _JSRecordActionRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSRecordActionRunJSContext, "JSRecordActionRunJSContext");
 let JSRecordActionRunJSContext = _JSRecordActionRunJSContext;
 JSRecordActionRunJSContext.define({
   label: "JSRecordAction RunJS context",
   properties: {
-    record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09",
-    filterByTk: "\u4E3B\u952E/\u8FC7\u6EE4\u952E\uFF08\u53EA\u8BFB\uFF09"
-  },
-  methods: {
-    runAction: "Run action: `await ctx.runAction(name, params)`",
-    message: "Message API"
-  },
-  snipastes: {
-    "Show record id": { $ref: "scene/actions/record-id-message", prefix: "sn-act-record-id" },
-    "Run action": { $ref: "scene/actions/run-action-basic", prefix: "sn-act-run" }
+    record: `Current record data object (read-only).
+      Contains all field values of the record associated with this action.`,
+    filterByTk: `Primary key or filter key of the current record (read-only).
+      Used to identify the specific record in database operations.`
   }
 });
+JSRecordActionRunJSContext.define(
+  {
+    label: "JS \u8BB0\u5F55\u52A8\u4F5C RunJS \u4E0A\u4E0B\u6587",
+    properties: {
+      record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09",
+      filterByTk: "\u4E3B\u952E/\u8FC7\u6EE4\u952E\uFF08\u53EA\u8BFB\uFF09"
+    }
+  },
+  { locale: "zh-CN" }
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   JSRecordActionRunJSContext

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

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ */
+export declare function defineBaseContextMeta(): void;