@nocobase/flow-engine 2.1.0-beta.8 → 2.2.0-alpha.1

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

@@ -31,6 +31,7 @@ __export(JSItemRunJSContext_exports, {
 });
 module.exports = __toCommonJS(JSItemRunJSContext_exports);
 var import_flowContext = require("../../flowContext");
+var import_elementDoc = require("./elementDoc");
 const _JSItemRunJSContext = class _JSItemRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSItemRunJSContext, "JSItemRunJSContext");
@@ -38,8 +39,8 @@ let JSItemRunJSContext = _JSItemRunJSContext;
 JSItemRunJSContext.define({
   label: "JSItem RunJS context",
   properties: {
-    element: `ElementProxy instance providing a safe DOM container for form item rendering.
-      Supports innerHTML, append, and other DOM manipulation methods.`,
+    element: (0, import_elementDoc.createElementPropertyDoc)(`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).
@@ -59,7 +60,7 @@ 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",
+      element: (0, import_elementDoc.createZhCNElementPropertyDoc)("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",
       formValues: {

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

@@ -35,7 +35,42 @@ function defineBaseContextMeta() {
   import_flowContext.FlowRunJSContext.define({
     label: "RunJS base",
     properties: {
-      logger: 'Pino logger instance for structured logging. Example: `ctx.logger.info({ foo: 1 }, "message")`',
+      logger: {
+        description: 'Pino logger instance for structured logging. Example: `ctx.logger.info({ foo: 1 }, "message")`',
+        detail: "Logger",
+        properties: {
+          info: {
+            type: "function",
+            description: "Write an info-level log.",
+            detail: "(...args: any[]) => void",
+            completion: { insertText: `ctx.logger.info({ foo: 1 }, 'message')` }
+          },
+          warn: {
+            type: "function",
+            description: "Write a warn-level log.",
+            detail: "(...args: any[]) => void",
+            completion: { insertText: `ctx.logger.warn({ foo: 1 }, 'message')` }
+          },
+          error: {
+            type: "function",
+            description: "Write an error-level log.",
+            detail: "(...args: any[]) => void",
+            completion: { insertText: `ctx.logger.error({ err }, 'message')` }
+          },
+          debug: {
+            type: "function",
+            description: "Write a debug-level log.",
+            detail: "(...args: any[]) => void",
+            completion: { insertText: `ctx.logger.debug({ foo: 1 }, 'message')` }
+          },
+          child: {
+            type: "function",
+            description: "Create a child logger with bindings.",
+            detail: "(bindings: object) => Logger",
+            completion: { insertText: `ctx.logger.child({ module: 'runjs' })` }
+          }
+        }
+      },
       message: {
         description: "Ant Design global message API for displaying temporary messages.",
         detail: "MessageInstance",
@@ -260,12 +295,18 @@ function defineBaseContextMeta() {
           popover: {
             description: "Open a popover view. Parameters: (props: PopoverProps) => any",
             detail: "(props) => any",
-            completion: { insertText: "await ctx.viewer.popover({ target: ctx.element?.__el, content: <div /> })" }
+            completion: {
+              insertText: "await ctx.viewer.popover({ target: ctx.element?.__el, content: <div /> })",
+              requires: ["element"]
+            }
           },
           embed: {
             description: "Open an embed view. Parameters: (props: ViewProps & TargetProps) => any",
             detail: "(props) => any",
-            completion: { insertText: "await ctx.viewer.embed({ target: document.body, content: <div /> })" }
+            completion: {
+              insertText: "await ctx.viewer.embed({ target: ctx.element?.__el, content: <div /> })",
+              requires: ["element"]
+            }
           }
         }
       },
@@ -310,16 +351,165 @@ function defineBaseContextMeta() {
           language: "Current active language code."
         }
       },
+      sql: {
+        description: "SQL helper (FlowSQLRepository).",
+        detail: "FlowSQLRepository",
+        properties: {
+          run: {
+            type: "function",
+            description: "Run ad-hoc SQL with optional bind/result options.",
+            detail: "(sql: string, options?: SQLRunOptions) => Promise<any>",
+            completion: { insertText: `await ctx.sql.run('SELECT 1', { type: 'selectRows' })` }
+          },
+          save: {
+            type: "function",
+            description: "Save a SQL template.",
+            detail: "(data: { uid: string; sql: string; dataSourceKey?: string }) => Promise<void>",
+            completion: { insertText: `await ctx.sql.save({ uid: 'sql-uid', sql: 'SELECT 1' })` }
+          },
+          runById: {
+            type: "function",
+            description: "Run a saved SQL template by uid.",
+            detail: "(uid: string, options?: SQLRunOptions) => Promise<any>",
+            completion: { insertText: `await ctx.sql.runById('sql-uid', { type: 'selectRows' })` }
+          },
+          destroy: {
+            type: "function",
+            description: "Delete a saved SQL template by uid.",
+            detail: "(uid: string) => Promise<void>",
+            completion: { insertText: `await ctx.sql.destroy('sql-uid')` }
+          }
+        }
+      },
       libs: {
         properties: {
-          React: "React namespace (same as ctx.React).",
-          ReactDOM: "ReactDOM client API (same as ctx.ReactDOM).",
-          antd: "Ant Design component library (same as ctx.antd).",
-          dayjs: "dayjs date-time utility library.",
+          React: {
+            description: "React namespace (same as ctx.React).",
+            properties: {
+              createElement: {
+                type: "function",
+                description: "Create a React element.",
+                detail: "React.createElement",
+                completion: { insertText: `ctx.libs.React.createElement('div', null, 'Hello')` }
+              },
+              useState: {
+                type: "function",
+                description: "React state hook.",
+                detail: "React.useState",
+                completion: { insertText: "ctx.libs.React.useState(initialValue)" }
+              },
+              useEffect: {
+                type: "function",
+                description: "React effect hook.",
+                detail: "React.useEffect",
+                completion: { insertText: "ctx.libs.React.useEffect(() => {}, [])" }
+              },
+              useMemo: {
+                type: "function",
+                description: "React memo hook.",
+                detail: "React.useMemo",
+                completion: { insertText: "ctx.libs.React.useMemo(() => value, [])" }
+              },
+              useCallback: {
+                type: "function",
+                description: "React callback hook.",
+                detail: "React.useCallback",
+                completion: { insertText: "ctx.libs.React.useCallback(() => {}, [])" }
+              }
+            }
+          },
+          ReactDOM: {
+            description: "ReactDOM client API (same as ctx.ReactDOM).",
+            properties: {
+              createRoot: {
+                type: "function",
+                description: "Create a React root.",
+                detail: "ReactDOM.createRoot",
+                completion: { insertText: "ctx.libs.ReactDOM.createRoot(ctx.element.__el)", requires: ["element"] }
+              }
+            }
+          },
+          antd: {
+            description: "Ant Design component library (same as ctx.antd).",
+            properties: {
+              Button: "Ant Design Button component.",
+              Table: "Ant Design Table component.",
+              Form: "Ant Design Form component.",
+              Input: "Ant Design Input component.",
+              Select: "Ant Design Select component.",
+              Modal: "Ant Design Modal API/component."
+            }
+          },
+          dayjs: {
+            type: "function",
+            description: "dayjs date-time utility library.",
+            detail: "dayjs",
+            completion: { insertText: "ctx.libs.dayjs()" }
+          },
           antdIcons: "Ant Design icons library. Example: `ctx.libs.antdIcons.PlusOutlined`.",
-          lodash: 'Lodash utility library. Example: `ctx.libs.lodash.get(obj, "a.b")`.',
-          formula: "Formula.js library (spreadsheet-like functions). Example: `ctx.libs.formula.SUM(1, 2, 3)`.",
-          math: 'mathjs library. Example: `ctx.libs.math.evaluate("2 + 3")`.'
+          lodash: {
+            description: 'Lodash utility library. Example: `ctx.libs.lodash.get(obj, "a.b")`.',
+            properties: {
+              get: {
+                type: "function",
+                description: "Read a nested value by path.",
+                detail: "lodash.get",
+                completion: { insertText: `ctx.libs.lodash.get(obj, 'a.b')` }
+              },
+              set: {
+                type: "function",
+                description: "Set a nested value by path.",
+                detail: "lodash.set",
+                completion: { insertText: `ctx.libs.lodash.set(obj, 'a.b', value)` }
+              },
+              debounce: {
+                type: "function",
+                description: "Create a debounced function.",
+                detail: "lodash.debounce",
+                completion: { insertText: "ctx.libs.lodash.debounce(() => {}, 300)" }
+              },
+              cloneDeep: {
+                type: "function",
+                description: "Deep clone a value.",
+                detail: "lodash.cloneDeep",
+                completion: { insertText: "ctx.libs.lodash.cloneDeep(value)" }
+              }
+            }
+          },
+          formula: {
+            description: "Formula.js library (spreadsheet-like functions). Example: `ctx.libs.formula.SUM(1, 2, 3)`.",
+            properties: {
+              SUM: {
+                type: "function",
+                description: "Sum values.",
+                detail: "formula.SUM",
+                completion: { insertText: "ctx.libs.formula.SUM(1, 2, 3)" }
+              },
+              AVERAGE: {
+                type: "function",
+                description: "Average values.",
+                detail: "formula.AVERAGE",
+                completion: { insertText: "ctx.libs.formula.AVERAGE(1, 2, 3)" }
+              }
+            }
+          },
+          math: {
+            description: 'mathjs library. Example: `ctx.libs.math.evaluate("2 + 3")`.',
+            properties: {
+              evaluate: {
+                type: "function",
+                description: "Evaluate a math expression.",
+                detail: "math.evaluate",
+                completion: { insertText: `ctx.libs.math.evaluate('2 + 3')` }
+              },
+              round: {
+                type: "function",
+                description: "Round a number.",
+                detail: "math.round",
+                completion: { insertText: "ctx.libs.math.round(value, 2)" }
+              }
+            }
+          }
         }
       }
     },
@@ -348,7 +538,12 @@ function defineBaseContextMeta() {
         returns: { type: "FlowModel | undefined" },
         examples: ["const model = ctx.getModel('block-uid-xxx');"]
       },
-      t: 'Internationalization function for translating text. Parameters: (key: string, variables?: object) => string. Example: `ctx.t("Hello {{name}}", { name: "World" })`',
+      t: {
+        description: "Internationalization function for translating text. Parameters: (key: string, variables?: object) => string.",
+        detail: "(key: string, variables?: object) => string",
+        completion: { insertText: `ctx.t('Hello')` },
+        examples: [`ctx.t("Hello {{name}}", { name: "World" })`]
+      },
       initResource: {
         description: 'Initialize ctx.resource as a FlowResource instance by class name. Common values: "MultiRecordResource", "SingleRecordResource", "SQLResource".',
         detail: "(resourceType: ResourceType) => void",
@@ -365,11 +560,34 @@ function defineBaseContextMeta() {
         description: 'Render into container. Accepts ReactElement, DOM Node/Fragment, or HTML string. Parameters: (vnode: ReactElement | Node | DocumentFragment | string, container?: HTMLElement|ElementProxy) => Root|null. Example: `ctx.render(<div>Hello</div>)` or `ctx.render("<b>hi</b>")`',
         detail: "ReactDOM Root",
         completion: {
-          insertText: `ctx.render(<div />)`
+          insertText: `ctx.render(<div />)`,
+          requires: ["element"]
         }
       },
-      requireAsync: 'Load UMD/AMD/global scripts or CSS asynchronously from URL. Accepts shorthand like "echarts@5/dist/echarts.min.js" (resolved via ESM CDN with ?raw) or full URLs, and returns a Promise of the loaded library.',
-      importAsync: 'Dynamically import ESM modules or CSS by URL. Accepts shorthand like "vue@3.4.0" or "dayjs@1/plugin/relativeTime.js" (resolved via configured ESM CDN) or full URLs, and returns a Promise of the module namespace.',
+      requireAsync: {
+        description: 'Load UMD/AMD/global scripts or CSS asynchronously from URL. Accepts shorthand like "echarts@5/dist/echarts.min.js" (resolved via ESM CDN with ?raw) or full URLs, and returns a Promise of the loaded library.',
+        detail: "(url: string) => Promise<any>",
+        completion: { insertText: `const lib = await ctx.requireAsync('https://cdn.example.com/lib.umd.js')` }
+      },
+      importAsync: {
+        description: 'Dynamically import ESM modules or CSS by URL. Accepts shorthand like "vue@3.4.0" or "dayjs@1/plugin/relativeTime.js" (resolved via configured ESM CDN) or full URLs, and returns a Promise of the module namespace.',
+        detail: "(url: string) => Promise<any>",
+        completion: { insertText: `const mod = await ctx.importAsync('lodash-es')` }
+      },
+      resolveJsonTemplate: {
+        description: "Resolve a JSON template containing {{ }} variable expressions.",
+        detail: "(template: any) => Promise<any>",
+        params: [
+          {
+            name: "template",
+            type: "any",
+            description: "JSON-compatible value containing {{ ctx.* }} expressions."
+          }
+        ],
+        returns: { type: "Promise<any>" },
+        completion: { insertText: `await ctx.resolveJsonTemplate({ value: '{{ctx.record.id}}' })` },
+        examples: ["const data = await ctx.resolveJsonTemplate({ id: '{{ctx.record.id}}' });"]
+      },
       getVar: {
         description: 'Resolve a ctx expression value by path string (expression starts with "ctx.").',
         detail: "(path: string) => Promise<any>",
@@ -455,7 +673,42 @@ function defineBaseContextMeta() {
     {
       label: "RunJS \u57FA\u7840",
       properties: {
-        logger: 'Pino \u65E5\u5FD7\u5B9E\u4F8B\uFF08\u7ED3\u6784\u5316\u65E5\u5FD7\uFF09\u3002\u793A\u4F8B\uFF1A`ctx.logger.info({ foo: 1 }, "message")`',
+        logger: {
+          description: 'Pino \u65E5\u5FD7\u5B9E\u4F8B\uFF08\u7ED3\u6784\u5316\u65E5\u5FD7\uFF09\u3002\u793A\u4F8B\uFF1A`ctx.logger.info({ foo: 1 }, "message")`',
+          detail: "Logger",
+          properties: {
+            info: {
+              type: "function",
+              description: "\u5199\u5165 info \u7EA7\u522B\u65E5\u5FD7\u3002",
+              detail: "(...args: any[]) => void",
+              completion: { insertText: `ctx.logger.info({ foo: 1 }, 'message')` }
+            },
+            warn: {
+              type: "function",
+              description: "\u5199\u5165 warn \u7EA7\u522B\u65E5\u5FD7\u3002",
+              detail: "(...args: any[]) => void",
+              completion: { insertText: `ctx.logger.warn({ foo: 1 }, 'message')` }
+            },
+            error: {
+              type: "function",
+              description: "\u5199\u5165 error \u7EA7\u522B\u65E5\u5FD7\u3002",
+              detail: "(...args: any[]) => void",
+              completion: { insertText: `ctx.logger.error({ err }, 'message')` }
+            },
+            debug: {
+              type: "function",
+              description: "\u5199\u5165 debug \u7EA7\u522B\u65E5\u5FD7\u3002",
+              detail: "(...args: any[]) => void",
+              completion: { insertText: `ctx.logger.debug({ foo: 1 }, 'message')` }
+            },
+            child: {
+              type: "function",
+              description: "\u521B\u5EFA\u5E26\u7ED1\u5B9A\u5B57\u6BB5\u7684\u5B50 logger\u3002",
+              detail: "(bindings: object) => Logger",
+              completion: { insertText: `ctx.logger.child({ module: 'runjs' })` }
+            }
+          }
+        },
         message: {
           description: "Ant Design \u5168\u5C40\u6D88\u606F API\uFF0C\u7528\u4E8E\u663E\u793A\u4E34\u65F6\u63D0\u793A\u3002",
           detail: "MessageInstance",
@@ -677,12 +930,18 @@ function defineBaseContextMeta() {
             popover: {
               description: "\u6253\u5F00\u6C14\u6CE1\u5361\u7247\u89C6\u56FE\u3002\u53C2\u6570\uFF1A(props: PopoverProps) => any",
               detail: "(props) => any",
-              completion: { insertText: "await ctx.viewer.popover({ target: ctx.element?.__el, content: <div /> })" }
+              completion: {
+                insertText: "await ctx.viewer.popover({ target: ctx.element?.__el, content: <div /> })",
+                requires: ["element"]
+              }
             },
             embed: {
               description: "\u6253\u5F00\u5185\u5D4C\u89C6\u56FE\u3002\u53C2\u6570\uFF1A(props: ViewProps & TargetProps) => any",
               detail: "(props) => any",
-              completion: { insertText: "await ctx.viewer.embed({ target: document.body, content: <div /> })" }
+              completion: {
+                insertText: "await ctx.viewer.embed({ target: ctx.element?.__el, content: <div /> })",
+                requires: ["element"]
+              }
             }
           }
         },
@@ -719,6 +978,36 @@ function defineBaseContextMeta() {
             language: "\u5F53\u524D\u6FC0\u6D3B\u7684\u8BED\u8A00\u4EE3\u7801"
           }
         },
+        sql: {
+          description: "SQL \u6267\u884C\u52A9\u624B\uFF08FlowSQLRepository\uFF09\u3002",
+          detail: "FlowSQLRepository",
+          properties: {
+            run: {
+              type: "function",
+              description: "\u6267\u884C\u4E34\u65F6 SQL\uFF0C\u53EF\u4F20\u7ED1\u5B9A\u53C2\u6570\u4E0E\u7ED3\u679C\u7C7B\u578B\u3002",
+              detail: "(sql: string, options?: SQLRunOptions) => Promise<any>",
+              completion: { insertText: `await ctx.sql.run('SELECT 1', { type: 'selectRows' })` }
+            },
+            save: {
+              type: "function",
+              description: "\u4FDD\u5B58 SQL \u6A21\u677F\u3002",
+              detail: "(data: { uid: string; sql: string; dataSourceKey?: string }) => Promise<void>",
+              completion: { insertText: `await ctx.sql.save({ uid: 'sql-uid', sql: 'SELECT 1' })` }
+            },
+            runById: {
+              type: "function",
+              description: "\u6309 uid \u6267\u884C\u5DF2\u4FDD\u5B58 SQL \u6A21\u677F\u3002",
+              detail: "(uid: string, options?: SQLRunOptions) => Promise<any>",
+              completion: { insertText: `await ctx.sql.runById('sql-uid', { type: 'selectRows' })` }
+            },
+            destroy: {
+              type: "function",
+              description: "\u6309 uid \u5220\u9664\u5DF2\u4FDD\u5B58 SQL \u6A21\u677F\u3002",
+              detail: "(uid: string) => Promise<void>",
+              completion: { insertText: `await ctx.sql.destroy('sql-uid')` }
+            }
+          }
+        },
         dayjs: {
           type: "function",
           description: "dayjs \u65E5\u671F\u65F6\u95F4\u5DE5\u5177\u5E93\uFF08\u53EF\u8C03\u7528\uFF09\u3002",
@@ -733,14 +1022,133 @@ function defineBaseContextMeta() {
           description: "\u7B2C\u4E09\u65B9/\u901A\u7528\u5E93\u7684\u7EDF\u4E00\u547D\u540D\u7A7A\u95F4\uFF0C\u5305\u542B React\u3001ReactDOM\u3001Ant Design\u3001dayjs\u3001icons \u7B49\uFF0C\u5E76\u53EF\u6269\u5C55\u66F4\u591A\u5DE5\u5177\u5E93\uFF08\u5982 lodash\u3001formula\u3001math\uFF09\u3002\u540E\u7EED\u65B0\u589E\u5E93\u4F1A\u4F18\u5148\u6302\u5728\u6B64\u5904\u3002",
           detail: "\u901A\u7528\u5E93\u547D\u540D\u7A7A\u95F4",
           properties: {
-            React: "React \u547D\u540D\u7A7A\u95F4\uFF08\u7B49\u4EF7\u4E8E ctx.React\uFF09\u3002",
-            ReactDOM: "ReactDOM \u5BA2\u6237\u7AEF API\uFF08\u7B49\u4EF7\u4E8E ctx.ReactDOM\uFF09\u3002",
-            antd: "Ant Design \u7EC4\u4EF6\u5E93\uFF08\u7B49\u4EF7\u4E8E ctx.antd\uFF09\u3002",
-            dayjs: "dayjs \u65E5\u671F\u65F6\u95F4\u5DE5\u5177\u5E93\u3002",
+            React: {
+              description: "React \u547D\u540D\u7A7A\u95F4\uFF08\u7B49\u4EF7\u4E8E ctx.React\uFF09\u3002",
+              properties: {
+                createElement: {
+                  type: "function",
+                  description: "\u521B\u5EFA React \u5143\u7D20\u3002",
+                  detail: "React.createElement",
+                  completion: { insertText: `ctx.libs.React.createElement('div', null, 'Hello')` }
+                },
+                useState: {
+                  type: "function",
+                  description: "React state hook\u3002",
+                  detail: "React.useState",
+                  completion: { insertText: "ctx.libs.React.useState(initialValue)" }
+                },
+                useEffect: {
+                  type: "function",
+                  description: "React effect hook\u3002",
+                  detail: "React.useEffect",
+                  completion: { insertText: "ctx.libs.React.useEffect(() => {}, [])" }
+                },
+                useMemo: {
+                  type: "function",
+                  description: "React memo hook\u3002",
+                  detail: "React.useMemo",
+                  completion: { insertText: "ctx.libs.React.useMemo(() => value, [])" }
+                },
+                useCallback: {
+                  type: "function",
+                  description: "React callback hook\u3002",
+                  detail: "React.useCallback",
+                  completion: { insertText: "ctx.libs.React.useCallback(() => {}, [])" }
+                }
+              }
+            },
+            ReactDOM: {
+              description: "ReactDOM \u5BA2\u6237\u7AEF API\uFF08\u7B49\u4EF7\u4E8E ctx.ReactDOM\uFF09\u3002",
+              properties: {
+                createRoot: {
+                  type: "function",
+                  description: "\u521B\u5EFA React \u6839\u3002",
+                  detail: "ReactDOM.createRoot",
+                  completion: { insertText: "ctx.libs.ReactDOM.createRoot(ctx.element.__el)", requires: ["element"] }
+                }
+              }
+            },
+            antd: {
+              description: "Ant Design \u7EC4\u4EF6\u5E93\uFF08\u7B49\u4EF7\u4E8E ctx.antd\uFF09\u3002",
+              properties: {
+                Button: "Ant Design Button \u7EC4\u4EF6\u3002",
+                Table: "Ant Design Table \u7EC4\u4EF6\u3002",
+                Form: "Ant Design Form \u7EC4\u4EF6\u3002",
+                Input: "Ant Design Input \u7EC4\u4EF6\u3002",
+                Select: "Ant Design Select \u7EC4\u4EF6\u3002",
+                Modal: "Ant Design Modal API/\u7EC4\u4EF6\u3002"
+              }
+            },
+            dayjs: {
+              type: "function",
+              description: "dayjs \u65E5\u671F\u65F6\u95F4\u5DE5\u5177\u5E93\u3002",
+              detail: "dayjs",
+              completion: { insertText: "ctx.libs.dayjs()" }
+            },
             antdIcons: "Ant Design \u56FE\u6807\u5E93\u3002 \u4F8B\u5982\uFF1A`ctx.libs.antdIcons.PlusOutlined`\u3002",
-            lodash: 'Lodash \u5DE5\u5177\u5E93\u3002\u793A\u4F8B\uFF1A`ctx.libs.lodash.get(obj, "a.b")`\u3002',
-            formula: "Formula.js \u516C\u5F0F\u5E93\uFF08\u7C7B\u8868\u683C\u51FD\u6570\uFF09\u3002\u793A\u4F8B\uFF1A`ctx.libs.formula.SUM(1, 2, 3)`\u3002",
-            math: 'mathjs \u6570\u5B66\u5E93\u3002\u793A\u4F8B\uFF1A`ctx.libs.math.evaluate("2 + 3")`\u3002'
+            lodash: {
+              description: 'Lodash \u5DE5\u5177\u5E93\u3002\u793A\u4F8B\uFF1A`ctx.libs.lodash.get(obj, "a.b")`\u3002',
+              properties: {
+                get: {
+                  type: "function",
+                  description: "\u6309\u8DEF\u5F84\u8BFB\u53D6\u5D4C\u5957\u503C\u3002",
+                  detail: "lodash.get",
+                  completion: { insertText: `ctx.libs.lodash.get(obj, 'a.b')` }
+                },
+                set: {
+                  type: "function",
+                  description: "\u6309\u8DEF\u5F84\u8BBE\u7F6E\u5D4C\u5957\u503C\u3002",
+                  detail: "lodash.set",
+                  completion: { insertText: `ctx.libs.lodash.set(obj, 'a.b', value)` }
+                },
+                debounce: {
+                  type: "function",
+                  description: "\u521B\u5EFA\u9632\u6296\u51FD\u6570\u3002",
+                  detail: "lodash.debounce",
+                  completion: { insertText: "ctx.libs.lodash.debounce(() => {}, 300)" }
+                },
+                cloneDeep: {
+                  type: "function",
+                  description: "\u6DF1\u62F7\u8D1D\u503C\u3002",
+                  detail: "lodash.cloneDeep",
+                  completion: { insertText: "ctx.libs.lodash.cloneDeep(value)" }
+                }
+              }
+            },
+            formula: {
+              description: "Formula.js \u516C\u5F0F\u5E93\uFF08\u7C7B\u8868\u683C\u51FD\u6570\uFF09\u3002\u793A\u4F8B\uFF1A`ctx.libs.formula.SUM(1, 2, 3)`\u3002",
+              properties: {
+                SUM: {
+                  type: "function",
+                  description: "\u6C42\u548C\u3002",
+                  detail: "formula.SUM",
+                  completion: { insertText: "ctx.libs.formula.SUM(1, 2, 3)" }
+                },
+                AVERAGE: {
+                  type: "function",
+                  description: "\u6C42\u5E73\u5747\u503C\u3002",
+                  detail: "formula.AVERAGE",
+                  completion: { insertText: "ctx.libs.formula.AVERAGE(1, 2, 3)" }
+                }
+              }
+            },
+            math: {
+              description: 'mathjs \u6570\u5B66\u5E93\u3002\u793A\u4F8B\uFF1A`ctx.libs.math.evaluate("2 + 3")`\u3002',
+              properties: {
+                evaluate: {
+                  type: "function",
+                  description: "\u8BA1\u7B97\u6570\u5B66\u8868\u8FBE\u5F0F\u3002",
+                  detail: "math.evaluate",
+                  completion: { insertText: `ctx.libs.math.evaluate('2 + 3')` }
+                },
+                round: {
+                  type: "function",
+                  description: "\u56DB\u820D\u4E94\u5165\u3002",
+                  detail: "math.round",
+                  completion: { insertText: "ctx.libs.math.round(value, 2)" }
+                }
+              }
+            }
           }
         }
       },
@@ -770,7 +1178,12 @@ function defineBaseContextMeta() {
           returns: { type: "FlowModel | undefined" },
           examples: ["const model = ctx.getModel('block-uid-xxx');"]
         },
-        t: '\u56FD\u9645\u5316\u51FD\u6570\uFF0C\u7528\u4E8E\u7FFB\u8BD1\u6587\u6848\u3002\u53C2\u6570\uFF1A(key: string, variables?: object) => string\u3002\u793A\u4F8B\uFF1A`ctx.t("\u4F60\u597D {{name}}", { name: "\u4E16\u754C" })`',
+        t: {
+          description: "\u56FD\u9645\u5316\u51FD\u6570\uFF0C\u7528\u4E8E\u7FFB\u8BD1\u6587\u6848\u3002\u53C2\u6570\uFF1A(key: string, variables?: object) => string\u3002",
+          detail: "(key: string, variables?: object) => string",
+          completion: { insertText: `ctx.t('\u4F60\u597D')` },
+          examples: [`ctx.t("\u4F60\u597D {{name}}", { name: "\u4E16\u754C" })`]
+        },
         initResource: {
           description: '\u521D\u59CB\u5316\u5F53\u524D\u4E0A\u4E0B\u6587\u7684\u8D44\u6E90\uFF1A\u82E5\u5C1A\u672A\u5B58\u5728 ctx.resource\uFF0C\u5219\u6309\u8D44\u6E90\u7C7B\u540D\u521B\u5EFA\u5E76\u7ED1\u5B9A\uFF1B\u82E5\u5DF2\u5B58\u5728\u5219\u76F4\u63A5\u590D\u7528\u3002\u5E38\u7528\u503C\uFF1A"MultiRecordResource"\u3001"SingleRecordResource"\u3001"SQLResource"\u3002',
           detail: "(resourceType: ResourceType) => void",
@@ -787,11 +1200,20 @@ function defineBaseContextMeta() {
           description: '\u6E32\u67D3\u5230\u5BB9\u5668\u3002vnode \u652F\u6301 ReactElement\u3001DOM \u8282\u70B9/\u7247\u6BB5\u3001\u6216 HTML \u5B57\u7B26\u4E32\u3002\u53C2\u6570\uFF1A(vnode: ReactElement | Node | DocumentFragment | string, container?: HTMLElement|ElementProxy) => Root|null\u3002\u793A\u4F8B\uFF1A`ctx.render(<div />)` \u6216 `ctx.render("<b>hi</b>")`',
           detail: "ReactDOM Root",
           completion: {
-            insertText: `ctx.render(<div />)`
+            insertText: `ctx.render(<div />)`,
+            requires: ["element"]
           }
         },
-        requireAsync: '\u6309 URL \u5F02\u6B65\u52A0\u8F7D UMD/AMD \u6216\u6302\u5230\u5168\u5C40\u7684\u811A\u672C\uFF0C\u4E5F\u53EF\u52A0\u8F7D CSS\u3002\u652F\u6301\u7B80\u5199\u8DEF\u5F84\uFF08\u5982 "echarts@5/dist/echarts.min.js"\uFF0C\u4F1A\u7ECF\u7531 ESM CDN \u52A0 ?raw \u83B7\u53D6\u539F\u59CB\u6587\u4EF6\uFF09\u548C\u5B8C\u6574 URL\uFF0C\u8FD4\u56DE\u52A0\u8F7D\u540E\u7684\u5E93\u5BF9\u8C61\u6216\u6837\u5F0F\u6CE8\u5165\u7ED3\u679C\u3002',
-        importAsync: '\u6309 URL \u52A8\u6001\u52A0\u8F7D ESM \u6A21\u5757\u6216 CSS\u3002\u652F\u6301\u7B80\u5199\uFF08\u5982 "vue@3.4.0"\u3001"dayjs@1/plugin/relativeTime.js"\uFF0C\u4F1A\u6309\u914D\u7F6E\u62FC\u63A5 ESM CDN \u524D\u7F00\uFF09\u548C\u5B8C\u6574 URL\uFF0C\u8FD4\u56DE\u6A21\u5757\u547D\u540D\u7A7A\u95F4\u6216\u6837\u5F0F\u6CE8\u5165\u7ED3\u679C\u3002',
+        requireAsync: {
+          description: '\u6309 URL \u5F02\u6B65\u52A0\u8F7D UMD/AMD \u6216\u6302\u5230\u5168\u5C40\u7684\u811A\u672C\uFF0C\u4E5F\u53EF\u52A0\u8F7D CSS\u3002\u652F\u6301\u7B80\u5199\u8DEF\u5F84\uFF08\u5982 "echarts@5/dist/echarts.min.js"\uFF0C\u4F1A\u7ECF\u7531 ESM CDN \u52A0 ?raw \u83B7\u53D6\u539F\u59CB\u6587\u4EF6\uFF09\u548C\u5B8C\u6574 URL\uFF0C\u8FD4\u56DE\u52A0\u8F7D\u540E\u7684\u5E93\u5BF9\u8C61\u6216\u6837\u5F0F\u6CE8\u5165\u7ED3\u679C\u3002',
+          detail: "(url: string) => Promise<any>",
+          completion: { insertText: `const lib = await ctx.requireAsync('https://cdn.example.com/lib.umd.js')` }
+        },
+        importAsync: {
+          description: '\u6309 URL \u52A8\u6001\u52A0\u8F7D ESM \u6A21\u5757\u6216 CSS\u3002\u652F\u6301\u7B80\u5199\uFF08\u5982 "vue@3.4.0"\u3001"dayjs@1/plugin/relativeTime.js"\uFF0C\u4F1A\u6309\u914D\u7F6E\u62FC\u63A5 ESM CDN \u524D\u7F00\uFF09\u548C\u5B8C\u6574 URL\uFF0C\u8FD4\u56DE\u6A21\u5757\u547D\u540D\u7A7A\u95F4\u6216\u6837\u5F0F\u6CE8\u5165\u7ED3\u679C\u3002',
+          detail: "(url: string) => Promise<any>",
+          completion: { insertText: `const mod = await ctx.importAsync('lodash-es')` }
+        },
         getVar: {
           description: '\u901A\u8FC7\u8868\u8FBE\u5F0F\u8DEF\u5F84\u5B57\u7B26\u4E32\u83B7\u53D6 ctx \u7684\u8FD0\u884C\u65F6\u503C\uFF08\u4EE5 "ctx." \u5F00\u5934\uFF09\u3002',
           detail: "(path: string) => Promise<any>",
@@ -843,7 +1265,20 @@ function defineBaseContextMeta() {
           returns: { type: "Promise<Record<string, any>>" },
           examples: ["const envs = await ctx.getEnvInfos();"]
         },
-        resolveJsonTemplate: "\u89E3\u6790\u542B {{ }} \u53D8\u91CF\u8868\u8FBE\u5F0F\u7684 JSON \u6A21\u677F\u3002\u53C2\u6570\uFF1A(template: any, context?: object) => any",
+        resolveJsonTemplate: {
+          description: "\u89E3\u6790\u542B {{ }} \u53D8\u91CF\u8868\u8FBE\u5F0F\u7684 JSON \u6A21\u677F\u3002",
+          detail: "(template: any) => Promise<any>",
+          params: [
+            {
+              name: "template",
+              type: "any",
+              description: "\u5305\u542B {{ ctx.* }} \u8868\u8FBE\u5F0F\u7684 JSON \u517C\u5BB9\u503C\u3002"
+            }
+          ],
+          returns: { type: "Promise<any>" },
+          completion: { insertText: `await ctx.resolveJsonTemplate({ value: '{{ctx.record.id}}' })` },
+          examples: ["const data = await ctx.resolveJsonTemplate({ id: '{{ctx.record.id}}' });"]
+        },
         runAction: {
           description: '\u5BF9\u5F53\u524D\u8D44\u6E90\u6267\u884C\u6570\u636E\u52A8\u4F5C\u3002\u53C2\u6570\uFF1A(actionName: string, params: object) => Promise<any>\u3002\u793A\u4F8B\uFF1A`await ctx.runAction("create", { values: { name: "test" } })`',
           detail: "Promise<any>",

package/lib/runjs-context/contexts/elementDoc.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 type { RunJSDocPropertyDoc } from '../../flowContext';
+export declare function createElementPropertyDoc(description?: string): RunJSDocPropertyDoc;
+export declare function createZhCNElementPropertyDoc(description?: string): RunJSDocPropertyDoc;