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

package/lib/runjs-context/contributions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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';
+import { RunJSContextRegistry, type RunJSVersion } from './registry';
+export type RunJSContextContributionApi = {
+    version: RunJSVersion;
+    RunJSContextRegistry: typeof RunJSContextRegistry;
+    FlowRunJSContext: typeof FlowRunJSContext;
+};
+export type RunJSContextContribution = (api: RunJSContextContributionApi) => void | Promise<void>;
+/**
+ * Register a RunJS context/doc contribution.
+ *
+ * - If RunJS contexts have already been set up for a version, the contribution is applied immediately once.
+ * - Each contribution is executed at most once per version.
+ */
+export declare function registerRunJSContextContribution(contribution: RunJSContextContribution): void;
+/**
+ * Apply all registered contributions for a given version.
+ * Intended to be called by setupRunJSContexts().
+ */
+export declare function applyRunJSContextContributions(version: RunJSVersion): Promise<void>;
+/**
+ * Mark setupRunJSContexts() as completed for a given version.
+ * Used to support late contributions that should take effect without re-running setup.
+ */
+export declare function markRunJSContextsSetupDone(version: RunJSVersion): void;

package/lib/runjs-context/contributions.js

@@ -0,0 +1,88 @@
+/**
+ * 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 contributions_exports = {};
+__export(contributions_exports, {
+  applyRunJSContextContributions: () => applyRunJSContextContributions,
+  markRunJSContextsSetupDone: () => markRunJSContextsSetupDone,
+  registerRunJSContextContribution: () => registerRunJSContextContribution
+});
+module.exports = __toCommonJS(contributions_exports);
+var import_flowContext = require("../flowContext");
+var import_registry = require("./registry");
+const contributions = /* @__PURE__ */ new Set();
+const appliedByVersion = /* @__PURE__ */ new Map();
+const setupDoneVersions = /* @__PURE__ */ new Set();
+async function applyContributionOnce(version, contribution) {
+  const applied = appliedByVersion.get(version) || /* @__PURE__ */ new Set();
+  appliedByVersion.set(version, applied);
+  if (applied.has(contribution)) return;
+  applied.add(contribution);
+  try {
+    await contribution({
+      version,
+      RunJSContextRegistry: import_registry.RunJSContextRegistry,
+      FlowRunJSContext: import_flowContext.FlowRunJSContext
+    });
+  } catch (error) {
+    applied.delete(contribution);
+    throw error;
+  }
+}
+__name(applyContributionOnce, "applyContributionOnce");
+function registerRunJSContextContribution(contribution) {
+  if (typeof contribution !== "function") {
+    throw new Error("[flow-engine] registerRunJSContextContribution: contribution must be a function");
+  }
+  if (contributions.has(contribution)) return;
+  contributions.add(contribution);
+  for (const version of setupDoneVersions) {
+    void applyContributionOnce(version, contribution).catch((error) => {
+      try {
+        console.error("[flow-engine] RunJS context contribution failed:", error);
+      } catch (_) {
+      }
+    });
+  }
+}
+__name(registerRunJSContextContribution, "registerRunJSContextContribution");
+async function applyRunJSContextContributions(version) {
+  for (const contribution of contributions) {
+    await applyContributionOnce(version, contribution);
+  }
+}
+__name(applyRunJSContextContributions, "applyRunJSContextContributions");
+function markRunJSContextsSetupDone(version) {
+  setupDoneVersions.add(version);
+}
+__name(markRunJSContextsSetupDone, "markRunJSContextsSetupDone");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyRunJSContextContributions,
+  markRunJSContextsSetupDone,
+  registerRunJSContextContribution
+});

package/lib/runjs-context/helpers.d.ts

@@ -9,9 +9,12 @@
 import type { FlowContext } from '../flowContext';
 import { JSRunner } from '../JSRunner';
 import type { JSRunnerOptions } from '../JSRunner';
-import { RunJSVersion } from './contexts/FlowRunJSContext';
+import { type RunJSVersion } from './registry';
 export declare function getRunJSDocFor(ctx: FlowContext, { version }?: {
     version?: RunJSVersion;
 }): any;
 export declare function createJSRunnerWithVersion(this: FlowContext, options?: JSRunnerOptions): JSRunner;
-export declare function registerDefaultMappings(): void;
+export declare function getRunJSScenesForModel(modelClass: string, version?: RunJSVersion): string[];
+export declare function getRunJSScenesForContext(ctx: FlowContext, { version }?: {
+    version?: RunJSVersion;
+}): string[];

package/lib/runjs-context/helpers.js

@@ -29,51 +29,60 @@ var helpers_exports = {};
 __export(helpers_exports, {
   createJSRunnerWithVersion: () => createJSRunnerWithVersion,
   getRunJSDocFor: () => getRunJSDocFor,
-  registerDefaultMappings: () => registerDefaultMappings
+  getRunJSScenesForContext: () => getRunJSScenesForContext,
+  getRunJSScenesForModel: () => getRunJSScenesForModel
 });
 module.exports = __toCommonJS(helpers_exports);
 var import_JSRunner = require("../JSRunner");
-var import_FlowRunJSContext = require("./contexts/FlowRunJSContext");
 var import_registry = require("./registry");
-var import_JSBlockRunJSContext = require("./contexts/JSBlockRunJSContext");
-var import_JSFieldRunJSContext = require("./contexts/JSFieldRunJSContext");
-var import_JSItemRunJSContext = require("./contexts/JSItemRunJSContext");
-var import_FormJSFieldItemRunJSContext = require("./contexts/FormJSFieldItemRunJSContext");
-var import_JSRecordActionRunJSContext = require("./contexts/JSRecordActionRunJSContext");
-var import_JSCollectionActionRunJSContext = require("./contexts/JSCollectionActionRunJSContext");
+function getLocale(ctx) {
+  var _a, _b, _c;
+  return ((_b = (_a = ctx == null ? void 0 : ctx.api) == null ? void 0 : _a.auth) == null ? void 0 : _b.locale) || ((_c = ctx == null ? void 0 : ctx.i18n) == null ? void 0 : _c.language) || (ctx == null ? void 0 : ctx.locale);
+}
+__name(getLocale, "getLocale");
 function getRunJSDocFor(ctx, { version = "v1" } = {}) {
-  var _a;
+  var _a, _b;
   const modelClass = (0, import_registry.getModelClassName)(ctx);
-  const ctor = import_registry.RunJSContextRegistry.resolve(version, modelClass) || import_registry.RunJSContextRegistry.resolve("latest", modelClass) || import_FlowRunJSContext.FlowRunJSContext;
-  return ((_a = ctor.getDoc) == null ? void 0 : _a.call(ctor)) || {};
+  const ctor = import_registry.RunJSContextRegistry.resolve(version, modelClass) || import_registry.RunJSContextRegistry.resolve(version, "*");
+  const locale = getLocale(ctx);
+  if ((_a = ctor == null ? void 0 : ctor.getDoc) == null ? void 0 : _a.length) {
+    return ctor.getDoc(locale) || {};
+  }
+  return ((_b = ctor == null ? void 0 : ctor.getDoc) == null ? void 0 : _b.call(ctor)) || {};
 }
 __name(getRunJSDocFor, "getRunJSDocFor");
 function createJSRunnerWithVersion(options) {
-  var _a;
   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("latest", modelClass) || import_FlowRunJSContext.FlowRunJSContext;
-  const runCtx = new Ctor(this.createProxy ? this.createProxy() : this);
-  const def = ((_a = Ctor.injectDefaultGlobals) == null ? void 0 : _a.call(Ctor)) || {};
-  const globals = { ctx: runCtx, ...def, ...(options == null ? void 0 : options.globals) || {} };
+  const ensureFlowContext = /* @__PURE__ */ __name((obj) => obj, "ensureFlowContext");
+  const Ctor = import_registry.RunJSContextRegistry.resolve(version, modelClass) || import_registry.RunJSContextRegistry.resolve(version, "*");
+  if (!Ctor) {
+    throw new Error("[RunJS] No RunJSContext registered for version/model.");
+  }
+  const runCtx = new Ctor(ensureFlowContext(this));
+  const globals = { ctx: runCtx, ...(options == null ? void 0 : options.globals) || {} };
+  if (modelClass === "JSFieldModel" || modelClass === "JSBlockModel") {
+    if (typeof window !== "undefined") globals.window = window;
+    if (typeof document !== "undefined") globals.document = document;
+  }
   const { timeoutMs } = options || {};
   return new import_JSRunner.JSRunner({ globals, timeoutMs });
 }
 __name(createJSRunnerWithVersion, "createJSRunnerWithVersion");
-function registerDefaultMappings() {
-  const v = "v1";
-  import_registry.RunJSContextRegistry.register(v, "JSBlockModel", import_JSBlockRunJSContext.JSBlockRunJSContext);
-  import_registry.RunJSContextRegistry.register(v, "JSFieldModel", import_JSFieldRunJSContext.JSFieldRunJSContext);
-  import_registry.RunJSContextRegistry.register(v, "JSItemModel", import_JSItemRunJSContext.JSItemRunJSContext);
-  import_registry.RunJSContextRegistry.register(v, "FormJSFieldItemModel", import_FormJSFieldItemRunJSContext.FormJSFieldItemRunJSContext);
-  import_registry.RunJSContextRegistry.register(v, "JSRecordActionModel", import_JSRecordActionRunJSContext.JSRecordActionRunJSContext);
-  import_registry.RunJSContextRegistry.register(v, "JSCollectionActionModel", import_JSCollectionActionRunJSContext.JSCollectionActionRunJSContext);
-  import_registry.RunJSContextRegistry.register(v, "*", import_FlowRunJSContext.FlowRunJSContext);
+function getRunJSScenesForModel(modelClass, version = "v1") {
+  const meta = import_registry.RunJSContextRegistry.getMeta(version, modelClass);
+  return Array.isArray(meta == null ? void 0 : meta.scenes) ? [...meta.scenes] : [];
+}
+__name(getRunJSScenesForModel, "getRunJSScenesForModel");
+function getRunJSScenesForContext(ctx, { version = "v1" } = {}) {
+  const modelClass = (0, import_registry.getModelClassName)(ctx);
+  return getRunJSScenesForModel(modelClass, version);
 }
-__name(registerDefaultMappings, "registerDefaultMappings");
+__name(getRunJSScenesForContext, "getRunJSScenesForContext");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createJSRunnerWithVersion,
   getRunJSDocFor,
-  registerDefaultMappings
+  getRunJSScenesForContext,
+  getRunJSScenesForModel
 });

package/lib/runjs-context/registry.d.ts

@@ -6,12 +6,15 @@
  * 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 type { RunJSVersion, RunJSContextCtor } from './contexts/FlowRunJSContext';
+export type RunJSVersion = 'v1' | (string & {});
+export type RunJSContextCtor = new (delegate: any) => any;
+export type RunJSContextMeta = {
+    scenes?: string[];
+};
 export declare class RunJSContextRegistry {
     private static map;
-    private static defaultsRegistered;
-    private static ensureDefaults;
-    static register(version: RunJSVersion, modelClass: string, ctor: RunJSContextCtor): void;
+    static register(version: RunJSVersion, modelClass: string, ctor: RunJSContextCtor, meta?: RunJSContextMeta): void;
     static resolve(version: RunJSVersion, modelClass: string): RunJSContextCtor;
+    static getMeta(version: RunJSVersion, modelClass: string): RunJSContextMeta | undefined;
 }
 export declare function getModelClassName(ctx: any): string;

package/lib/runjs-context/registry.js

@@ -33,57 +33,25 @@ __export(registry_exports, {
   getModelClassName: () => getModelClassName
 });
 module.exports = __toCommonJS(registry_exports);
-var import_FlowRunJSContext = require("./contexts/FlowRunJSContext");
-var import_JSBlockRunJSContext = require("./contexts/JSBlockRunJSContext");
-var import_JSFieldRunJSContext = require("./contexts/JSFieldRunJSContext");
-var import_JSItemRunJSContext = require("./contexts/JSItemRunJSContext");
-var import_FormJSFieldItemRunJSContext = require("./contexts/FormJSFieldItemRunJSContext");
-var import_JSRecordActionRunJSContext = require("./contexts/JSRecordActionRunJSContext");
-var import_JSCollectionActionRunJSContext = require("./contexts/JSCollectionActionRunJSContext");
 const _RunJSContextRegistry = class _RunJSContextRegistry {
-  static ensureDefaults() {
-    if (this.defaultsRegistered) return;
-    const v = "v1";
-    try {
-      const ensure = /* @__PURE__ */ __name((model, ctor) => {
-        const key = `${v}:${model}`;
-        if (!this.map.has(key)) this.map.set(key, ctor);
-      }, "ensure");
-      ensure("JSBlockModel", import_JSBlockRunJSContext.JSBlockRunJSContext);
-      ensure("JSFieldModel", import_JSFieldRunJSContext.JSFieldRunJSContext);
-      ensure("JSItemModel", import_JSItemRunJSContext.JSItemRunJSContext);
-      ensure("FormJSFieldItemModel", import_FormJSFieldItemRunJSContext.FormJSFieldItemRunJSContext);
-      ensure("JSRecordActionModel", import_JSRecordActionRunJSContext.JSRecordActionRunJSContext);
-      ensure("JSCollectionActionModel", import_JSCollectionActionRunJSContext.JSCollectionActionRunJSContext);
-      ensure("*", import_FlowRunJSContext.FlowRunJSContext);
-    } finally {
-      this.defaultsRegistered = true;
-    }
-  }
-  static register(version, modelClass, ctor) {
-    this.map.set(`${version}:${modelClass}`, ctor);
+  static register(version, modelClass, ctor, meta) {
+    this.map.set(`${version}:${modelClass}`, { ctor, meta });
   }
   static resolve(version, modelClass) {
-    this.ensureDefaults();
-    return this.map.get(`${version}:${modelClass}`) || this.map.get(`${version}:*`);
+    var _a, _b;
+    return ((_a = this.map.get(`${version}:${modelClass}`)) == null ? void 0 : _a.ctor) || ((_b = this.map.get(`${version}:*`)) == null ? void 0 : _b.ctor);
+  }
+  static getMeta(version, modelClass) {
+    var _a, _b;
+    return ((_a = this.map.get(`${version}:${modelClass}`)) == null ? void 0 : _a.meta) || ((_b = this.map.get(`${version}:*`)) == null ? void 0 : _b.meta);
   }
 };
 __name(_RunJSContextRegistry, "RunJSContextRegistry");
 __publicField(_RunJSContextRegistry, "map", /* @__PURE__ */ new Map());
-__publicField(_RunJSContextRegistry, "defaultsRegistered", false);
 let RunJSContextRegistry = _RunJSContextRegistry;
 function getModelClassName(ctx) {
-  var _a, _b, _c;
-  const model = ctx == null ? void 0 : ctx.model;
-  if (!model) return "*";
-  try {
-    const Ctor = model.constructor;
-    const use = (_b = (_a = Ctor == null ? void 0 : Ctor.meta) == null ? void 0 : _a.createModelOptions) == null ? void 0 : _b.use;
-    if (typeof use === "string" && use) return use;
-  } catch (_) {
-  }
-  const byName = (_c = model == null ? void 0 : model.constructor) == null ? void 0 : _c.name;
-  return byName || "*";
+  var _a, _b;
+  return ((_b = (_a = ctx == null ? void 0 : ctx.model) == null ? void 0 : _a.constructor) == null ? void 0 : _b.name) || "*";
 }
 __name(getModelClassName, "getModelClassName");
 // Annotate the CommonJS export names for ESM import in node:

package/lib/runjs-context/setup.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 setupRunJSContexts(): Promise<void>;

package/lib/runjs-context/setup.js

@@ -0,0 +1,88 @@
+/**
+ * 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 setup_exports = {};
+__export(setup_exports, {
+  setupRunJSContexts: () => setupRunJSContexts
+});
+module.exports = __toCommonJS(setup_exports);
+var import_registry = require("./registry");
+var import_flowContext = require("../flowContext");
+var import_base = require("./contexts/base");
+var import_contributions = require("./contributions");
+let done = false;
+async function setupRunJSContexts() {
+  if (done) return;
+  (0, import_base.defineBaseContextMeta)();
+  const [
+    { JSBlockRunJSContext },
+    { JSFieldRunJSContext },
+    { JSEditableFieldRunJSContext },
+    { JSItemRunJSContext },
+    { JSColumnRunJSContext },
+    { FormJSFieldItemRunJSContext },
+    { JSRecordActionRunJSContext },
+    { JSCollectionActionRunJSContext }
+  ] = await Promise.all([
+    import("./contexts/JSBlockRunJSContext"),
+    import("./contexts/JSFieldRunJSContext"),
+    import("./contexts/JSEditableFieldRunJSContext"),
+    import("./contexts/JSItemRunJSContext"),
+    import("./contexts/JSColumnRunJSContext"),
+    import("./contexts/FormJSFieldItemRunJSContext"),
+    import("./contexts/JSRecordActionRunJSContext"),
+    import("./contexts/JSCollectionActionRunJSContext")
+  ]);
+  const v1 = "v1";
+  import_registry.RunJSContextRegistry.register(v1, "*", import_flowContext.FlowRunJSContext);
+  import_registry.RunJSContextRegistry.register(v1, "JSBlockModel", JSBlockRunJSContext, { scenes: ["block"] });
+  import_registry.RunJSContextRegistry.register(v1, "JSFieldModel", JSFieldRunJSContext, { scenes: ["detail"] });
+  import_registry.RunJSContextRegistry.register(v1, "JSEditableFieldModel", JSEditableFieldRunJSContext, { scenes: ["form"] });
+  import_registry.RunJSContextRegistry.register(v1, "JSItemModel", JSItemRunJSContext, { scenes: ["form"] });
+  import_registry.RunJSContextRegistry.register(v1, "JSColumnModel", JSColumnRunJSContext, { scenes: ["table"] });
+  import_registry.RunJSContextRegistry.register(v1, "FormJSFieldItemModel", FormJSFieldItemRunJSContext, { scenes: ["form"] });
+  import_registry.RunJSContextRegistry.register(v1, "JSRecordActionModel", JSRecordActionRunJSContext, { scenes: ["table"] });
+  import_registry.RunJSContextRegistry.register(v1, "JSCollectionActionModel", JSCollectionActionRunJSContext, { scenes: ["table"] });
+  await (0, import_contributions.applyRunJSContextContributions)(v1);
+  done = true;
+  (0, import_contributions.markRunJSContextsSetupDone)(v1);
+}
+__name(setupRunJSContexts, "setupRunJSContexts");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  setupRunJSContexts
+});

package/lib/runjs-context/snippets/global/{copy-record-json.snippet.js → api-request.snippet.js}

@@ -24,19 +24,34 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var copy_record_json_snippet_exports = {};
-__export(copy_record_json_snippet_exports, {
-  default: () => copy_record_json_snippet_default
+var api_request_snippet_exports = {};
+__export(api_request_snippet_exports, {
+  default: () => api_request_snippet_default
 });
-module.exports = __toCommonJS(copy_record_json_snippet_exports);
+module.exports = __toCommonJS(api_request_snippet_exports);
 const snippet = {
   contexts: ["*"],
-  prefix: "sn-copy-record",
-  label: "Copy record JSON",
-  description: "Copy current ctx.record JSON to clipboard",
+  prefix: "sn-api-request",
+  label: "API request template",
+  description: "Basic template to send HTTP requests via ctx.api.request",
+  locales: {
+    "zh-CN": {
+      label: "API \u8BF7\u6C42\u6A21\u677F",
+      description: "\u4F7F\u7528 ctx.api.request \u53D1\u9001 HTTP \u8BF7\u6C42\u7684\u57FA\u7840\u6A21\u677F"
+    }
+  },
   content: `
-await ctx.copyToClipboard(JSON.stringify(ctx.record ?? {}, null, 2));
-ctx.message.success(ctx.t('Record JSON copied to clipboard'));
+// Replace url/method/params/data as needed
+const response = await ctx.api.request({
+  url: 'users:list',
+  method: 'get',
+  params: {
+    pageSize: 10,
+  },
+});
+
+ctx.message.success(ctx.t('Request finished'));
+console.log(ctx.t('Response data:'), response?.data);
 `
 };
-var copy_record_json_snippet_default = snippet;
+var api_request_snippet_default = snippet;

package/lib/runjs-context/snippets/global/clipboard-copy-text.snippet.js

@@ -0,0 +1,61 @@
+/**
+ * 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 __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 clipboard_copy_text_snippet_exports = {};
+__export(clipboard_copy_text_snippet_exports, {
+  default: () => clipboard_copy_text_snippet_default
+});
+module.exports = __toCommonJS(clipboard_copy_text_snippet_exports);
+const snippet = {
+  contexts: ["*"],
+  prefix: "sn-clipboard-copy",
+  label: "Copy text to clipboard (function)",
+  description: "A reusable function that copies a given string to the clipboard.",
+  locales: {
+    "zh-CN": {
+      label: "\u590D\u5236\u6587\u672C\u5230\u526A\u8D34\u677F\uFF08\u51FD\u6570\uFF09",
+      description: "\u901A\u7528\u51FD\u6570\uFF1A\u63A5\u53D7\u4E00\u4E2A\u5B57\u7B26\u4E32\u53C2\u6570\u5E76\u590D\u5236\u5230\u526A\u8D34\u677F\u3002"
+    }
+  },
+  content: `
+// A general utility function that copies text to clipboard.
+// Usage:
+//   const ok = await copyTextToClipboard('Hello');
+//   if (ok) { /* success */ } else { /* handle failure */ }
+async function copyTextToClipboard(text) {
+  const s = String(text ?? '');
+  try {
+    if (navigator?.clipboard?.writeText) {
+      await navigator.clipboard.writeText(s);
+      return true;
+    }
+  } catch (_) {
+    // Fallback below
+  }
+}
+`
+};
+var clipboard_copy_text_snippet_default = snippet;

package/lib/runjs-context/snippets/global/{view-navigation-push.snippet.js → import-esm.snippet.js}

@@ -24,21 +24,35 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var view_navigation_push_snippet_exports = {};
-__export(view_navigation_push_snippet_exports, {
-  default: () => view_navigation_push_snippet_default
+var import_esm_snippet_exports = {};
+__export(import_esm_snippet_exports, {
+  default: () => import_esm_snippet_default
 });
-module.exports = __toCommonJS(view_navigation_push_snippet_exports);
+module.exports = __toCommonJS(import_esm_snippet_exports);
 const snippet = {
   contexts: ["*"],
-  versions: ["*"],
-  prefix: "sn-nav-push",
-  label: "View navigation: push",
-  description: "Navigate within current view (if supported)",
+  prefix: "sn-import",
+  label: "Import ESM module",
+  description: "Dynamically import an ESM module by URL",
+  locales: {
+    "zh-CN": {
+      label: "\u5BFC\u5165 ESM \u6A21\u5757",
+      description: "\u6309 URL \u52A8\u6001\u5BFC\u5165 ESM \u6A21\u5757"
+    }
+  },
   content: `
-// Push a new sub-view (if navigation is available)
-ctx.view?.navigation?.push({ viewUid: 'detail', filterByTk: 1 });
-// To go back: ctx.view?.navigation?.back();
+// Import an ESM module by URL
+// Works in yarn dev and yarn start
+const mod = await ctx.importAsync('https://cdn.jsdelivr.net/npm/lit-html@2/+esm');
+const { html, render } = mod;
+
+ctx.element.innerHTML = '';
+const container = document.createElement('div');
+container.style.padding = '8px';
+container.style.border = '1px dashed #999';
+ctx.element.append(container);
+
+render(html\`<span style="color:#52c41a;">lit-html loaded and rendered</span>\`, container);
 `
 };
-var view_navigation_push_snippet_default = snippet;
+var import_esm_snippet_default = snippet;

package/lib/runjs-context/snippets/global/message-error.snippet.js

@@ -34,6 +34,12 @@ const snippet = {
   prefix: "sn-msg-error",
   label: "Message error",
   description: "Show an error toast message",
+  locales: {
+    "zh-CN": {
+      label: "\u9519\u8BEF\u6D88\u606F\u63D0\u793A",
+      description: "\u663E\u793A\u4E00\u6761\u9519\u8BEF\u63D0\u793A\u6D88\u606F"
+    }
+  },
   content: `
 ctx.message.error(ctx.t('Operation failed'));
 `

package/lib/runjs-context/snippets/global/message-success.snippet.js

@@ -34,6 +34,12 @@ const snippet = {
   prefix: "sn-msg",
   label: "Message success",
   description: "Show a success toast message",
+  locales: {
+    "zh-CN": {
+      label: "\u6210\u529F\u6D88\u606F\u63D0\u793A",
+      description: "\u663E\u793A\u4E00\u6761\u6210\u529F\u63D0\u793A\u6D88\u606F"
+    }
+  },
   content: `
 ctx.message.success(ctx.t('Operation succeeded'));
 `

package/lib/runjs-context/snippets/global/notification-open.snippet.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.
  */
-declare const _default: {
-    contexts: string[];
-    prefix: string;
-    label: string;
-    description: string;
-    content: string;
-};
-export default _default;
+import type { SnippetModule } from '../types';
+declare const snippet: SnippetModule;
+export default snippet;

package/lib/runjs-context/snippets/global/notification-open.snippet.js

@@ -29,11 +29,17 @@ __export(notification_open_snippet_exports, {
   default: () => notification_open_snippet_default
 });
 module.exports = __toCommonJS(notification_open_snippet_exports);
-var notification_open_snippet_default = {
+const snippet = {
   contexts: ["*"],
   prefix: "sn-notify",
   label: "Open notification",
   description: "Open an AntD notification with custom content",
+  locales: {
+    "zh-CN": {
+      label: "\u6253\u5F00\u901A\u77E5",
+      description: "\u5C55\u793A\u4E00\u6761\u81EA\u5B9A\u4E49\u5185\u5BB9\u7684\u901A\u77E5"
+    }
+  },
   content: `
 ctx.notification.open({
   message: ctx.t('Notification title'),
@@ -41,3 +47,4 @@ ctx.notification.open({
 });
 `
 };
+var notification_open_snippet_default = snippet;