@nocobase/flow-engine 2.0.0-alpha.10

package/lib/resources/sqlResource.js

@@ -0,0 +1,294 @@
+/**
+ * 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 __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sqlResource_exports = {};
+__export(sqlResource_exports, {
+  FlowSQLRepository: () => FlowSQLRepository,
+  SQLResource: () => SQLResource
+});
+module.exports = __toCommonJS(sqlResource_exports);
+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");
+const _FlowSQLRepository = class _FlowSQLRepository {
+  ctx;
+  constructor(ctx) {
+    this.ctx = new import_flowContext.FlowContext();
+    this.ctx.addDelegate(ctx);
+    this.ctx.defineProperty("offset", {
+      get: /* @__PURE__ */ __name(() => 0, "get"),
+      cache: false
+    });
+    this.ctx.defineProperty("limit", {
+      get: /* @__PURE__ */ __name(() => 20, "get"),
+      cache: false
+    });
+  }
+  async run(sql, options = {}) {
+    const result = transformSQL(sql);
+    const bind = await this.ctx.resolveJsonTemplate(result.bind);
+    const { data } = await this.ctx.api.request({
+      method: "POST",
+      url: "flowSql:run",
+      data: {
+        sql: result.sql,
+        ...options,
+        bind: {
+          ...bind,
+          ...options.bind
+        }
+      }
+    });
+    return data == null ? void 0 : data.data;
+  }
+  async save(data) {
+    await this.ctx.api.request({
+      method: "POST",
+      url: "flowSql:save",
+      data: {
+        ...data
+      }
+    });
+  }
+  async runById(uid, options) {
+    const response = await this.ctx.api.request({
+      method: "GET",
+      url: "flowSql:getBind",
+      params: {
+        uid
+      }
+    });
+    const bind = await this.ctx.resolveJsonTemplate(response.data.data || {});
+    const { data } = await this.ctx.api.request({
+      method: "POST",
+      url: "flowSql:runById",
+      data: {
+        uid,
+        ...options,
+        bind: {
+          ...bind,
+          ...options.bind
+        }
+      }
+    });
+    return data == null ? void 0 : data.data;
+  }
+  async destroy(uid) {
+    await this.ctx.api.request({
+      url: "flowSql:destroy",
+      params: {
+        filterByTk: uid
+      }
+    });
+  }
+};
+__name(_FlowSQLRepository, "FlowSQLRepository");
+let FlowSQLRepository = _FlowSQLRepository;
+const _SQLResource = class _SQLResource extends import_baseRecordResource.BaseRecordResource {
+  _data = import_reactive.observable.ref(null);
+  _meta = import_reactive.observable.ref({});
+  refreshTimer = null;
+  _debugEnabled = false;
+  _sql;
+  // 请求配置 - 与 APIClient 接口保持一致
+  request = {
+    // url: null as string | null,
+    method: "post",
+    params: {},
+    data: {},
+    headers: {}
+  };
+  get refreshActionName() {
+    return this._debugEnabled ? "run" : "runById";
+  }
+  get supportsFilter() {
+    return true;
+  }
+  constructor(context) {
+    super(context);
+    context.defineProperty("limit", {
+      get: /* @__PURE__ */ __name(() => this.getPageSize(), "get"),
+      cache: false
+    });
+    context.defineProperty("offset", {
+      get: /* @__PURE__ */ __name(() => {
+        const page = this.getPage();
+        const pageSize = this.getPageSize();
+        return (page - 1) * pageSize;
+      }, "get"),
+      cache: false
+    });
+  }
+  buildURL(action) {
+    return `flowSql:${action || this.refreshActionName}`;
+  }
+  setPage(page) {
+    this.addRequestParameter("page", page);
+    return this.setMeta({ page });
+  }
+  getPage() {
+    return this.getMeta("page") || 1;
+  }
+  setPageSize(pageSize) {
+    this.addRequestParameter("pageSize", pageSize);
+    return this.setMeta({ pageSize });
+  }
+  setDebug(enabled) {
+    this._debugEnabled = enabled;
+    return this;
+  }
+  getPageSize() {
+    return this.getMeta("pageSize") || 20;
+  }
+  async next() {
+    this.setPage(this.getPage() + 1);
+    await this.refresh();
+  }
+  async previous() {
+    if (this.getPage() > 1) {
+      this.setPage(this.getPage() - 1);
+      await this.refresh();
+    }
+  }
+  async goto(page) {
+    if (page > 0) {
+      this.request.params.page = page;
+      await this.refresh();
+    }
+  }
+  setDataSourceKey(dataSourceKey) {
+    this.request.data.dataSourceKey = dataSourceKey;
+    return this;
+  }
+  setSQLType(type) {
+    this.request.data.type = type;
+    return this;
+  }
+  setSQL(sql) {
+    this._sql = sql;
+    return this;
+  }
+  setFilterByTk(filterByTk) {
+    this.request.data.uid = filterByTk;
+    return this;
+  }
+  setFilter(filter) {
+    this.request.data.filter = filter;
+    return this;
+  }
+  setBind(bind) {
+    this.request.data.bind = bind;
+    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 options = import_lodash.default.cloneDeep({
+      method: "post",
+      ...this.getRefreshRequestOptions()
+    });
+    options.data.bind = bind;
+    options.data.sql = result.sql;
+    return await this.runAction("run", options);
+  }
+  async runById() {
+    const { data } = await this.runAction("getBind", {
+      method: "get",
+      params: {
+        uid: this.request.data.uid
+      }
+    });
+    const bind = await this.context.resolveJsonTemplate(data);
+    this.setBind(bind);
+    return await this.runAction("runById", {
+      method: "post",
+      ...this.getRefreshRequestOptions()
+    });
+  }
+  /**
+   * 在同一个事件循环内多次调用 refresh 方法时，只有最后一次调用会生效。避免触发多次相同的接口请求。
+   * @returns
+   */
+  async refresh() {
+    if (this.refreshTimer) {
+      clearTimeout(this.refreshTimer);
+    }
+    return new Promise((resolve, reject) => {
+      this.refreshTimer = setTimeout(async () => {
+        try {
+          this.clearError();
+          this.loading = true;
+          const { data, meta } = await this.run();
+          this.setData(data).setMeta(meta);
+          this.emit("refresh");
+          this.loading = false;
+          resolve();
+        } catch (error) {
+          this.setError(error);
+          reject(error instanceof Error ? error : new Error(String(error)));
+        } finally {
+          this.refreshTimer = null;
+          this.loading = false;
+        }
+      });
+    });
+  }
+};
+__name(_SQLResource, "SQLResource");
+let SQLResource = _SQLResource;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FlowSQLRepository,
+  SQLResource
+});

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

@@ -0,0 +1,11 @@
+/**
+ * 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';
+export declare class FormJSFieldItemRunJSContext extends FlowRunJSContext {
+}

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

@@ -0,0 +1,73 @@
+/**
+ * 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 FormJSFieldItemRunJSContext_exports = {};
+__export(FormJSFieldItemRunJSContext_exports, {
+  FormJSFieldItemRunJSContext: () => FormJSFieldItemRunJSContext
+});
+module.exports = __toCommonJS(FormJSFieldItemRunJSContext_exports);
+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 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: `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

@@ -0,0 +1,11 @@
+/**
+ * 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';
+export declare class JSBlockRunJSContext extends FlowRunJSContext {
+}

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

@@ -0,0 +1,91 @@
+/**
+ * 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 JSBlockRunJSContext_exports = {};
+__export(JSBlockRunJSContext_exports, {
+  JSBlockRunJSContext: () => JSBlockRunJSContext
+});
+module.exports = __toCommonJS(JSBlockRunJSContext_exports);
+var import_flowContext = require("../../flowContext");
+const _JSBlockRunJSContext = class _JSBlockRunJSContext extends import_flowContext.FlowRunJSContext {
+};
+__name(_JSBlockRunJSContext, "JSBlockRunJSContext");
+let JSBlockRunJSContext = _JSBlockRunJSContext;
+JSBlockRunJSContext.define({
+  label: "RunJS context",
+  properties: {
+    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: `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

@@ -0,0 +1,11 @@
+/**
+ * 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';
+export declare class JSCollectionActionRunJSContext extends FlowRunJSContext {
+}

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

@@ -0,0 +1,58 @@
+/**
+ * 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 JSCollectionActionRunJSContext_exports = {};
+__export(JSCollectionActionRunJSContext_exports, {
+  JSCollectionActionRunJSContext: () => JSCollectionActionRunJSContext
+});
+module.exports = __toCommonJS(JSCollectionActionRunJSContext_exports);
+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: `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/JSColumnRunJSContext.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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 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

@@ -0,0 +1,11 @@
+/**
+ * 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';
+export declare class JSFieldRunJSContext extends FlowRunJSContext {
+}