@nocobase/flow-engine 2.0.0-beta.20 → 2.0.0-beta.22

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

@@ -36,13 +36,214 @@ function defineBaseContextMeta() {
     label: "RunJS base",
     properties: {
       logger: 'Pino logger instance for structured logging. Example: `ctx.logger.info({ foo: 1 }, "message")`',
-      message: 'Ant Design global message API for displaying temporary messages. Example: `ctx.message.success("Operation completed")`',
-      notification: 'Ant Design notification API for displaying notification boxes. Example: `ctx.notification.open({ message: "Title", description: "Content" })`',
-      resource: "Data resource accessible based on current user permissions",
+      message: {
+        description: "Ant Design global message API for displaying temporary messages.",
+        detail: "MessageInstance",
+        hidden: /* @__PURE__ */ __name((ctx) => !(ctx == null ? void 0 : ctx.message), "hidden"),
+        examples: ['ctx.message.success("Operation completed")'],
+        properties: {
+          info: {
+            type: "function",
+            description: "Show an info message.",
+            detail: "(content: any, duration?: number) => void",
+            completion: { insertText: `ctx.message.info('Info')` }
+          },
+          success: {
+            type: "function",
+            description: "Show a success message.",
+            detail: "(content: any, duration?: number) => void",
+            completion: { insertText: `ctx.message.success('Success')` }
+          },
+          error: {
+            type: "function",
+            description: "Show an error message.",
+            detail: "(content: any, duration?: number) => void",
+            completion: { insertText: `ctx.message.error('Error')` }
+          },
+          warning: {
+            type: "function",
+            description: "Show a warning message.",
+            detail: "(content: any, duration?: number) => void",
+            completion: { insertText: `ctx.message.warning('Warning')` }
+          },
+          loading: {
+            type: "function",
+            description: "Show a loading message.",
+            detail: "(content: any, duration?: number) => void",
+            completion: { insertText: `ctx.message.loading('Loading...')` }
+          },
+          open: {
+            type: "function",
+            description: "Open a message with custom config.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.message.open({ type: 'info', content: 'Hello' })` }
+          },
+          destroy: {
+            type: "function",
+            description: "Destroy all messages.",
+            detail: "() => void",
+            completion: { insertText: `ctx.message.destroy()` }
+          }
+        }
+      },
+      notification: {
+        description: "Ant Design notification API for displaying notification boxes.",
+        detail: "NotificationInstance",
+        hidden: /* @__PURE__ */ __name((ctx) => !(ctx == null ? void 0 : ctx.notification), "hidden"),
+        examples: ['ctx.notification.open({ message: "Title", description: "Content" })'],
+        properties: {
+          open: {
+            type: "function",
+            description: "Open a notification with config.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.notification.open({ message: 'Title', description: 'Content' })` }
+          },
+          success: {
+            type: "function",
+            description: "Open a success notification.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.notification.success({ message: 'Success' })` }
+          },
+          info: {
+            type: "function",
+            description: "Open an info notification.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.notification.info({ message: 'Info' })` }
+          },
+          warning: {
+            type: "function",
+            description: "Open a warning notification.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.notification.warning({ message: 'Warning' })` }
+          },
+          error: {
+            type: "function",
+            description: "Open an error notification.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.notification.error({ message: 'Error' })` }
+          },
+          destroy: {
+            type: "function",
+            description: "Destroy all notifications.",
+            detail: "(key?: string) => void",
+            completion: { insertText: `ctx.notification.destroy()` }
+          }
+        }
+      },
+      modal: {
+        description: "Ant Design modal API (HookAPI) for opening modal dialogs.",
+        detail: "HookAPI",
+        hidden: /* @__PURE__ */ __name((ctx) => !(ctx == null ? void 0 : ctx.modal), "hidden"),
+        examples: [`ctx.modal.confirm({ title: 'Confirm', content: 'Are you sure?' })`],
+        properties: {
+          info: {
+            type: "function",
+            description: "Open an info modal.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.modal.info({ title: 'Info', content: '...' })` }
+          },
+          success: {
+            type: "function",
+            description: "Open a success modal.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.modal.success({ title: 'Success', content: '...' })` }
+          },
+          error: {
+            type: "function",
+            description: "Open an error modal.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.modal.error({ title: 'Error', content: '...' })` }
+          },
+          warning: {
+            type: "function",
+            description: "Open a warning modal.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.modal.warning({ title: 'Warning', content: '...' })` }
+          },
+          confirm: {
+            type: "function",
+            description: "Open a confirm modal.",
+            detail: "(config: any) => void",
+            completion: { insertText: `ctx.modal.confirm({ title: 'Confirm', content: '...' })` }
+          }
+        }
+      },
+      // TODO: context meta
+      resource: {
+        description: "FlowResource instance for accessing and manipulating data.",
+        detail: "FlowResource",
+        examples: [
+          "ctx.useResource('MultiRecordResource');",
+          "ctx.resource.setResourceName('users');",
+          "await ctx.resource.refresh();",
+          "const rows = ctx.resource.getData();"
+        ],
+        properties: {
+          // FlowResource
+          getData: {
+            description: "Get current resource data.",
+            detail: "() => any",
+            completion: { insertText: "ctx.resource.getData()" }
+          },
+          setData: {
+            description: "Set current resource data (client-side only).",
+            detail: "(value: any) => this",
+            completion: { insertText: "ctx.resource.setData(value)" }
+          },
+          refresh: {
+            description: "Refresh data from server (available on API-backed resources).",
+            detail: "() => Promise<any>",
+            completion: { insertText: "await ctx.resource.refresh()" }
+          },
+          on: {
+            description: "Subscribe resource events (e.g., refresh).",
+            detail: "(event: string, callback: (...args) => void) => void",
+            completion: { insertText: "ctx.resource.on('refresh', () => {})" }
+          },
+          off: {
+            description: "Unsubscribe resource events.",
+            detail: "(event: string, callback: (...args) => void) => void",
+            completion: { insertText: "ctx.resource.off('refresh', handler)" }
+          },
+          // BaseRecordResource / SingleRecordResource / MultiRecordResource helpers (common)
+          setResourceName: {
+            description: 'Set resource name (e.g., "users" or "users.profile").',
+            detail: "(resourceName: string) => this",
+            completion: { insertText: "ctx.resource.setResourceName('users')" }
+          },
+          setFilterByTk: {
+            description: "Set primary key or filterByTk for record resources.",
+            detail: "(filterByTk: any) => this",
+            completion: { insertText: "ctx.resource.setFilterByTk(filterByTk)" }
+          },
+          runAction: {
+            description: "Run a resource action (create/update/destroy/custom actions).",
+            detail: "(action: string, options: any) => Promise<any>",
+            completion: { insertText: "await ctx.resource.runAction('create', { data: {} })" }
+          },
+          selectedRows: {
+            description: "Selected rows in table resources (typically for collection/table actions). Availability depends on resource type.",
+            detail: "any[]"
+          },
+          pagination: {
+            description: "Pagination info in list resources. Availability depends on resource type (e.g., MultiRecordResource).",
+            detail: "Record<string, any>"
+          }
+        }
+      },
       urlSearchParams: "URLSearchParams object containing query parameters from the current URL",
       token: "API authentication token for the current session",
       role: "Current user role information",
-      auth: "Authentication context containing locale, role, user, and token information",
+      auth: {
+        description: "Authentication context containing locale, role, user, and token information.",
+        detail: "AuthContext",
+        properties: {
+          locale: 'Current locale code (e.g., "en-US", "zh-CN").',
+          roleName: "Current role name.",
+          token: "Current API token.",
+          user: "Current user info object (if available)."
+        }
+      },
       api: {
         description: "APIClient instance for making HTTP requests.",
         detail: "APIClient",
@@ -53,9 +254,82 @@ function defineBaseContextMeta() {
             completion: {
               insertText: `await ctx.api.request({ url: '', method: 'get', params: {} })`
             }
+          },
+          auth: {
+            description: "Authentication info bound to the API client (token/role/locale).",
+            detail: "APIClient.auth",
+            properties: {
+              token: "Current API token.",
+              role: "Current role name.",
+              locale: "Current locale code."
+            }
+          }
+        }
+      },
+      viewer: {
+        description: "FlowViewer instance providing view helpers (drawer/dialog/popover/embed). ",
+        detail: "FlowViewer",
+        examples: [
+          "await ctx.viewer.drawer({ width: '56%', content: <div>Hello</div> });",
+          "await ctx.viewer.dialog({ content: <div>Confirm</div> });"
+        ],
+        properties: {
+          drawer: {
+            description: "Open a drawer view. Parameters: (props: ViewProps) => any",
+            detail: "(props) => any",
+            completion: { insertText: "await ctx.viewer.drawer({ width: '56%', content: <div /> })" }
+          },
+          dialog: {
+            description: "Open a dialog/modal view. Parameters: (props: ViewProps) => any",
+            detail: "(props) => any",
+            completion: { insertText: "await ctx.viewer.dialog({ content: <div /> })" }
+          },
+          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 /> })" }
+          },
+          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 /> })" }
           }
         }
       },
+      popup: {
+        description: 'Popup context when current view is opened as a popup/drawer. Recommended: `const popup = await ctx.getVar("ctx.popup")`.',
+        detail: "Promise<PopupContext | undefined>",
+        hidden: /* @__PURE__ */ __name(async (ctx) => {
+          try {
+            const popup = await (ctx == null ? void 0 : ctx.popup);
+            return !(popup == null ? void 0 : popup.uid);
+          } catch (_) {
+            return false;
+          }
+        }, "hidden"),
+        examples: [
+          'const popup = await ctx.getVar("ctx.popup");',
+          "const id = popup?.record?.id;",
+          "const parentId = popup?.parent?.record?.id;"
+        ],
+        properties: {
+          uid: "Popup view uid (string).",
+          record: "Current popup record (object).",
+          sourceRecord: "Parent/source record inferred from sourceId/associationName (object).",
+          resource: {
+            description: "Data source info of the popup record.",
+            detail: "PopupResourceInfo",
+            properties: {
+              dataSourceKey: 'Data source key (e.g., "main").',
+              collectionName: "Collection name.",
+              associationName: "Association resource name (optional).",
+              filterByTk: "Record primary key / filterByTk.",
+              sourceId: "Source id (optional)."
+            }
+          },
+          parent: "Parent popup info (object). You can access parent.parent... at runtime if available."
+        }
+      },
       i18n: {
         description: "An instance of i18next for managing internationalization.",
         detail: "i18next",
@@ -63,26 +337,27 @@ function defineBaseContextMeta() {
           language: "Current active language code."
         }
       },
-      React: "React namespace providing React library functions and hooks (available in RunJS environment). Recommended access path: `ctx.libs.React`.",
-      ReactDOM: "ReactDOM client API including createRoot for rendering React components. Also available via `ctx.libs.ReactDOM`.",
-      antd: "Ant Design component library. Recommended access path: `ctx.libs.antd`.",
       libs: {
-        description: "Namespace for third-party and shared libraries. Includes React, ReactDOM, Ant Design, dayjs, lodash, math.js, and formula.js.",
-        detail: "Libraries namespace",
         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.",
           antdIcons: "Ant Design icons library. Example: `ctx.libs.antdIcons.PlusOutlined`.",
-          lodash: 'Lodash utility library. Example: `ctx.libs.lodash.get(obj, "a.b.c")`.',
-          math: 'Math.js library for mathematical operations. Example: `ctx.libs.math.evaluate("2 + 3 * 4")`.',
-          formula: "Formula.js library for spreadsheet-like formulas. Example: `ctx.libs.formula.SUM([1, 2, 3])`."
+          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")`.'
         }
       }
     },
     methods: {
-      t: 'Internationalization function for translating text. Parameters: (key: string, variables?: object) => string. Example: `ctx.t("Hello {name}", { name: "World" })`',
+      t: 'Internationalization function for translating text. Parameters: (key: string, variables?: object) => string. Example: `ctx.t("Hello {{name}}", { name: "World" })`',
+      useResource: {
+        description: 'Define ctx.resource as a FlowResource instance by class name. Common values: "MultiRecordResource", "SingleRecordResource", "SQLResource".',
+        detail: "(className) => void",
+        completion: { insertText: "ctx.useResource('MultiRecordResource')" },
+        examples: ["ctx.useResource('MultiRecordResource'); ctx.resource.setResourceName('users');"]
+      },
       render: {
         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",
@@ -92,7 +367,65 @@ function defineBaseContextMeta() {
       },
       requireAsync: 'Asynchronously load external libraries from URL. Parameters: (url: string) => Promise<any>. Example: `const lodash = await ctx.requireAsync("https://cdn.jsdelivr.net/npm/lodash")`',
       importAsync: 'Dynamically import ESM module by URL. Parameters: (url: string) => Promise<Module>. Example: `const mod = await ctx.importAsync("https://cdn.jsdelivr.net/npm/lit-html@2/+esm")`',
-      resolveJsonTemplate: "Resolve JSON templates containing variable expressions with {{ }} syntax. Parameters: (template: any, context?: object) => any",
+      loadCSS: {
+        description: "Load a CSS file by URL (browser only).",
+        detail: "(url: string) => Promise<void>",
+        completion: { insertText: "await ctx.loadCSS('https://example.com/style.css')" },
+        params: [{ name: "url", type: "string", description: "CSS URL." }],
+        returns: { type: "Promise<void>" },
+        examples: ["await ctx.loadCSS('https://example.com/style.css');"]
+      },
+      getVar: {
+        description: 'Resolve a ctx expression value by path string (expression starts with "ctx.").',
+        detail: "(path: string) => Promise<any>",
+        completion: { insertText: "await ctx.getVar('ctx.record.id')" },
+        params: [
+          {
+            name: "path",
+            type: "string",
+            description: 'Expression path starts with "ctx." (e.g. "ctx.record.id", "ctx.record.roles[0].id").'
+          }
+        ],
+        returns: { type: "Promise<any>" },
+        examples: ["const id = await ctx.getVar('ctx.record.id');"]
+      },
+      getApiInfos: {
+        description: "All available APIs under context namespace",
+        detail: "(options?: { version?: string }) => Promise<Record<string, any>>",
+        completion: { insertText: "await ctx.getApiInfos()" },
+        params: [
+          {
+            name: "options",
+            type: "{ version?: string }",
+            optional: true,
+            description: "Options (e.g. version)."
+          }
+        ],
+        returns: { type: "Promise<Record<string, any>>" },
+        examples: ["const apis = await ctx.getApiInfos();"]
+      },
+      getVarInfos: {
+        description: "All available variables could be used to get deeper data.",
+        detail: "(options?: { path?: string|string[]; maxDepth?: number }) => Promise<Record<string, any>>",
+        completion: { insertText: "await ctx.getVarInfos({ path: 'record', maxDepth: 3 })" },
+        params: [
+          {
+            name: "options",
+            type: "{ path?: string|string[]; maxDepth?: number }",
+            optional: true,
+            description: "Options for path trimming and maxDepth expansion."
+          }
+        ],
+        returns: { type: "Promise<Record<string, any>>" },
+        examples: ["const vars = await ctx.getVarInfos({ path: 'record', maxDepth: 3 });"]
+      },
+      getEnvInfos: {
+        description: "current runtime environment",
+        detail: "() => Promise<Record<string, any>>",
+        completion: { insertText: "await ctx.getEnvInfos()" },
+        returns: { type: "Promise<Record<string, any>>" },
+        examples: ["const envs = await ctx.getEnvInfos();"]
+      },
       runAction: {
         description: 'Execute a data action on the current resource. Parameters: (actionName: string, params: object) => Promise<any>. Example: `await ctx.runAction("create", { values: { name: "test" } })`',
         detail: "Promise<any>",
@@ -128,13 +461,211 @@ 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")`',
-        message: 'Ant Design \u5168\u5C40\u6D88\u606F API\uFF0C\u7528\u4E8E\u663E\u793A\u4E34\u65F6\u63D0\u793A\u3002\u793A\u4F8B\uFF1A`ctx.message.success("\u64CD\u4F5C\u6210\u529F")`',
-        notification: 'Ant Design \u901A\u77E5 API\uFF0C\u7528\u4E8E\u663E\u793A\u901A\u77E5\u6846\u3002\u793A\u4F8B\uFF1A`ctx.notification.open({ message: "\u6807\u9898", description: "\u5185\u5BB9" })`',
-        resource: "\u57FA\u4E8E\u5F53\u524D\u7528\u6237\u6743\u9650\u53EF\u8BBF\u95EE\u7684\u6570\u636E\u8D44\u6E90",
+        message: {
+          description: "Ant Design \u5168\u5C40\u6D88\u606F API\uFF0C\u7528\u4E8E\u663E\u793A\u4E34\u65F6\u63D0\u793A\u3002",
+          detail: "MessageInstance",
+          hidden: /* @__PURE__ */ __name((ctx) => !(ctx == null ? void 0 : ctx.message), "hidden"),
+          examples: ['ctx.message.success("\u64CD\u4F5C\u6210\u529F")'],
+          properties: {
+            info: {
+              type: "function",
+              description: "\u663E\u793A\u4FE1\u606F\u63D0\u793A\u3002",
+              detail: "(content: any, duration?: number) => void",
+              completion: { insertText: `ctx.message.info('\u63D0\u793A')` }
+            },
+            success: {
+              type: "function",
+              description: "\u663E\u793A\u6210\u529F\u63D0\u793A\u3002",
+              detail: "(content: any, duration?: number) => void",
+              completion: { insertText: `ctx.message.success('\u6210\u529F')` }
+            },
+            error: {
+              type: "function",
+              description: "\u663E\u793A\u9519\u8BEF\u63D0\u793A\u3002",
+              detail: "(content: any, duration?: number) => void",
+              completion: { insertText: `ctx.message.error('\u9519\u8BEF')` }
+            },
+            warning: {
+              type: "function",
+              description: "\u663E\u793A\u8B66\u544A\u63D0\u793A\u3002",
+              detail: "(content: any, duration?: number) => void",
+              completion: { insertText: `ctx.message.warning('\u8B66\u544A')` }
+            },
+            loading: {
+              type: "function",
+              description: "\u663E\u793A\u52A0\u8F7D\u63D0\u793A\u3002",
+              detail: "(content: any, duration?: number) => void",
+              completion: { insertText: `ctx.message.loading('\u52A0\u8F7D\u4E2D...')` }
+            },
+            open: {
+              type: "function",
+              description: "\u4F7F\u7528\u81EA\u5B9A\u4E49\u914D\u7F6E\u6253\u5F00\u6D88\u606F\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.message.open({ type: 'info', content: 'Hello' })` }
+            },
+            destroy: {
+              type: "function",
+              description: "\u9500\u6BC1\u6240\u6709\u6D88\u606F\u3002",
+              detail: "() => void",
+              completion: { insertText: `ctx.message.destroy()` }
+            }
+          }
+        },
+        notification: {
+          description: "Ant Design \u901A\u77E5 API\uFF0C\u7528\u4E8E\u663E\u793A\u901A\u77E5\u6846\u3002",
+          detail: "NotificationInstance",
+          hidden: /* @__PURE__ */ __name((ctx) => !(ctx == null ? void 0 : ctx.notification), "hidden"),
+          examples: ['ctx.notification.open({ message: "\u6807\u9898", description: "\u5185\u5BB9" })'],
+          properties: {
+            open: {
+              type: "function",
+              description: "\u6253\u5F00\u901A\u77E5\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.notification.open({ message: '\u6807\u9898', description: '\u5185\u5BB9' })` }
+            },
+            success: {
+              type: "function",
+              description: "\u6253\u5F00\u6210\u529F\u901A\u77E5\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.notification.success({ message: '\u6210\u529F' })` }
+            },
+            info: {
+              type: "function",
+              description: "\u6253\u5F00\u4FE1\u606F\u901A\u77E5\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.notification.info({ message: '\u63D0\u793A' })` }
+            },
+            warning: {
+              type: "function",
+              description: "\u6253\u5F00\u8B66\u544A\u901A\u77E5\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.notification.warning({ message: '\u8B66\u544A' })` }
+            },
+            error: {
+              type: "function",
+              description: "\u6253\u5F00\u9519\u8BEF\u901A\u77E5\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.notification.error({ message: '\u9519\u8BEF' })` }
+            },
+            destroy: {
+              type: "function",
+              description: "\u9500\u6BC1\u901A\u77E5\u3002",
+              detail: "(key?: string) => void",
+              completion: { insertText: `ctx.notification.destroy()` }
+            }
+          }
+        },
+        modal: {
+          description: "Ant Design modal API\uFF08HookAPI\uFF09\uFF0C\u7528\u4E8E\u6253\u5F00\u5BF9\u8BDD\u6846\u3002",
+          detail: "HookAPI",
+          hidden: /* @__PURE__ */ __name((ctx) => !(ctx == null ? void 0 : ctx.modal), "hidden"),
+          examples: [`ctx.modal.confirm({ title: '\u786E\u8BA4', content: '\u786E\u5B9A\u7EE7\u7EED\uFF1F' })`],
+          properties: {
+            info: {
+              type: "function",
+              description: "\u6253\u5F00\u4FE1\u606F\u5BF9\u8BDD\u6846\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.modal.info({ title: '\u63D0\u793A', content: '...' })` }
+            },
+            success: {
+              type: "function",
+              description: "\u6253\u5F00\u6210\u529F\u5BF9\u8BDD\u6846\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.modal.success({ title: '\u6210\u529F', content: '...' })` }
+            },
+            error: {
+              type: "function",
+              description: "\u6253\u5F00\u9519\u8BEF\u5BF9\u8BDD\u6846\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.modal.error({ title: '\u9519\u8BEF', content: '...' })` }
+            },
+            warning: {
+              type: "function",
+              description: "\u6253\u5F00\u8B66\u544A\u5BF9\u8BDD\u6846\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.modal.warning({ title: '\u8B66\u544A', content: '...' })` }
+            },
+            confirm: {
+              type: "function",
+              description: "\u6253\u5F00\u786E\u8BA4\u5BF9\u8BDD\u6846\u3002",
+              detail: "(config: any) => void",
+              completion: { insertText: `ctx.modal.confirm({ title: '\u786E\u8BA4', content: '...' })` }
+            }
+          }
+        },
+        resource: {
+          description: "\u6570\u636E\u8D44\u6E90\uFF08FlowResource\uFF09\u3002\u591A\u6570\u573A\u666F\u9700\u8981\u5148\u8C03\u7528 ctx.useResource(...) \u521B\u5EFA ctx.resource\u3002",
+          detail: "FlowResource",
+          examples: [
+            "ctx.useResource('MultiRecordResource');",
+            "ctx.resource.setResourceName('users');",
+            "await ctx.resource.refresh();",
+            "const rows = ctx.resource.getData();"
+          ],
+          properties: {
+            getData: {
+              description: "\u83B7\u53D6\u8D44\u6E90\u5F53\u524D\u6570\u636E\u3002",
+              detail: "() => any",
+              completion: { insertText: "ctx.resource.getData()" }
+            },
+            setData: {
+              description: "\u8BBE\u7F6E\u8D44\u6E90\u5F53\u524D\u6570\u636E\uFF08\u4EC5\u524D\u7AEF\uFF09\u3002",
+              detail: "(value: any) => this",
+              completion: { insertText: "ctx.resource.setData(value)" }
+            },
+            refresh: {
+              description: "\u4ECE\u540E\u7AEF\u5237\u65B0\u6570\u636E\uFF08APIResource/RecordResource \u7B49\u53EF\u7528\uFF09\u3002",
+              detail: "() => Promise<any>",
+              completion: { insertText: "await ctx.resource.refresh()" }
+            },
+            on: {
+              description: "\u8BA2\u9605\u8D44\u6E90\u4E8B\u4EF6\uFF08\u4F8B\u5982 refresh\uFF09\u3002",
+              detail: "(event: string, callback: (...args) => void) => void",
+              completion: { insertText: "ctx.resource.on('refresh', () => {})" }
+            },
+            off: {
+              description: "\u53D6\u6D88\u8BA2\u9605\u8D44\u6E90\u4E8B\u4EF6\u3002",
+              detail: "(event: string, callback: (...args) => void) => void",
+              completion: { insertText: "ctx.resource.off('refresh', handler)" }
+            },
+            setResourceName: {
+              description: '\u8BBE\u7F6E\u8D44\u6E90\u540D\u79F0\uFF08\u4F8B\u5982 "users" \u6216 "users.profile"\uFF09\u3002',
+              detail: "(resourceName: string) => this",
+              completion: { insertText: "ctx.resource.setResourceName('users')" }
+            },
+            setFilterByTk: {
+              description: "\u8BBE\u7F6E\u4E3B\u952E/\u8FC7\u6EE4\u952E filterByTk\uFF08\u8BB0\u5F55\u8D44\u6E90\u5E38\u7528\uFF09\u3002",
+              detail: "(filterByTk: any) => this",
+              completion: { insertText: "ctx.resource.setFilterByTk(filterByTk)" }
+            },
+            runAction: {
+              description: "\u6267\u884C\u8D44\u6E90\u52A8\u4F5C\uFF08create/update/destroy/\u81EA\u5B9A\u4E49 action\uFF09\u3002",
+              detail: "(action: string, options: any) => Promise<any>",
+              completion: { insertText: "await ctx.resource.runAction('create', { data: {} })" }
+            },
+            selectedRows: {
+              description: "\u5217\u8868\u8D44\u6E90\u7684\u9009\u4E2D\u884C\uFF08\u901A\u5E38\u7528\u4E8E\u8868\u683C\u52A8\u4F5C\uFF1B\u662F\u5426\u5B58\u5728\u53D6\u51B3\u4E8E\u8D44\u6E90\u7C7B\u578B\uFF09\u3002",
+              detail: "any[]"
+            },
+            pagination: {
+              description: "\u5217\u8868\u8D44\u6E90\u7684\u5206\u9875\u4FE1\u606F\uFF08\u662F\u5426\u5B58\u5728\u53D6\u51B3\u4E8E\u8D44\u6E90\u7C7B\u578B\uFF09\u3002",
+              detail: "Record<string, any>"
+            }
+          }
+        },
         urlSearchParams: "\u5F53\u524D URL \u7684\u67E5\u8BE2\u53C2\u6570\uFF08URLSearchParams \u5BF9\u8C61\uFF09",
         token: "\u5F53\u524D\u4F1A\u8BDD\u7684 API \u8BA4\u8BC1 token",
         role: "\u5F53\u524D\u7528\u6237\u89D2\u8272\u4FE1\u606F",
-        auth: "\u8BA4\u8BC1\u4E0A\u4E0B\u6587\uFF0C\u5305\u542B locale\u3001role\u3001user\u3001token \u7B49\u4FE1\u606F",
+        auth: {
+          description: "\u8BA4\u8BC1\u4E0A\u4E0B\u6587\uFF0C\u5305\u542B locale\u3001role\u3001user\u3001token \u7B49\u4FE1\u606F",
+          detail: "AuthContext",
+          properties: {
+            locale: '\u5F53\u524D locale\uFF08\u4F8B\u5982 "en-US"\u3001"zh-CN"\uFF09\u3002',
+            roleName: "\u5F53\u524D\u89D2\u8272\u540D\u3002",
+            token: "\u5F53\u524D API token\u3002",
+            user: "\u5F53\u524D\u7528\u6237\u4FE1\u606F\u5BF9\u8C61\uFF08\u82E5\u53EF\u7528\uFF09\u3002"
+          }
+        },
         api: {
           description: "\u7528\u4E8E\u53D1\u8D77 HTTP \u8BF7\u6C42\u7684 APIClient \u5B9E\u4F8B",
           detail: "APIClient",
@@ -145,9 +676,74 @@ function defineBaseContextMeta() {
               completion: {
                 insertText: `await ctx.api.request({ url: '', method: 'get', params: {} })`
               }
+            },
+            auth: {
+              description: "APIClient \u4E0A\u7684\u8BA4\u8BC1\u4FE1\u606F\uFF08token/role/locale\uFF09\u3002",
+              detail: "APIClient.auth",
+              properties: {
+                token: "\u5F53\u524D API token\u3002",
+                role: "\u5F53\u524D\u89D2\u8272\u540D\u3002",
+                locale: "\u5F53\u524D locale\u3002"
+              }
+            }
+          }
+        },
+        viewer: {
+          description: "\u89C6\u56FE\u63A7\u5236\u5668\uFF08FlowViewer\uFF09\uFF0C\u63D0\u4F9B drawer/dialog/popover/embed \u7B49\u4EA4\u4E92\u80FD\u529B\u3002",
+          detail: "FlowViewer",
+          examples: [
+            "await ctx.viewer.drawer({ width: '56%', content: <div /> });",
+            "await ctx.viewer.dialog({ content: <div /> });"
+          ],
+          properties: {
+            drawer: {
+              description: "\u6253\u5F00\u62BD\u5C49\u89C6\u56FE\u3002\u53C2\u6570\uFF1A(props: ViewProps) => any",
+              detail: "(props) => any",
+              completion: { insertText: "await ctx.viewer.drawer({ width: '56%', content: <div /> })" }
+            },
+            dialog: {
+              description: "\u6253\u5F00\u5BF9\u8BDD\u6846\u89C6\u56FE\u3002\u53C2\u6570\uFF1A(props: ViewProps) => any",
+              detail: "(props) => any",
+              completion: { insertText: "await ctx.viewer.dialog({ content: <div /> })" }
+            },
+            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 /> })" }
+            },
+            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 /> })" }
             }
           }
         },
+        popup: {
+          description: '\u5F39\u7A97\u4E0A\u4E0B\u6587\uFF08\u5728\u5F53\u524D\u89C6\u56FE\u4EE5\u5F39\u7A97/\u62BD\u5C49\u6253\u5F00\u65F6\u53EF\u7528\uFF09\u3002\u63A8\u8350\uFF1A`const popup = await ctx.getVar("ctx.popup")`\u3002',
+          detail: "Promise<PopupContext | undefined>",
+          examples: [
+            'const popup = await ctx.getVar("ctx.popup");',
+            "const id = popup?.record?.id;",
+            "const parentId = popup?.parent?.record?.id;"
+          ],
+          properties: {
+            uid: "\u5F39\u7A97 view uid\uFF08string\uFF09",
+            record: "\u5F53\u524D\u5F39\u7A97\u8BB0\u5F55\uFF08object\uFF09",
+            sourceRecord: "\u6839\u636E sourceId/associationName \u63A8\u65AD\u7684\u4E0A\u7EA7\u8BB0\u5F55\uFF08object\uFF09",
+            resource: {
+              description: "\u5F39\u7A97\u8BB0\u5F55\u7684\u6570\u636E\u6E90\u4FE1\u606F\u3002",
+              detail: "PopupResourceInfo",
+              properties: {
+                dataSourceKey: '\u6570\u636E\u6E90 key\uFF08\u4F8B\u5982 "main"\uFF09\u3002',
+                collectionName: "\u96C6\u5408\u540D\u79F0\u3002",
+                associationName: "\u5173\u8054\u8D44\u6E90\u540D\uFF08\u53EF\u9009\uFF09\u3002",
+                filterByTk: "\u8BB0\u5F55\u4E3B\u952E/\u8FC7\u6EE4\u952E filterByTk\u3002",
+                sourceId: "sourceId\uFF08\u53EF\u9009\uFF09\u3002"
+              }
+            },
+            parent: "\u4E0A\u7EA7\u5F39\u7A97\u4FE1\u606F\uFF08object\uFF09\u3002\u8FD0\u884C\u65F6\u82E5\u5B58\u5728\u53EF\u8BBF\u95EE parent.parent... \u94FE\u3002"
+          }
+        },
         i18n: {
           description: "i18next \u5B9E\u4F8B\uFF0C\u53EF\u7528\u4E8E\u7BA1\u7406\u56FD\u9645\u5316",
           detail: "i18next",
@@ -155,11 +751,18 @@ function defineBaseContextMeta() {
             language: "\u5F53\u524D\u6FC0\u6D3B\u7684\u8BED\u8A00\u4EE3\u7801"
           }
         },
+        dayjs: {
+          type: "function",
+          description: "dayjs \u65E5\u671F\u65F6\u95F4\u5DE5\u5177\u5E93\uFF08\u53EF\u8C03\u7528\uFF09\u3002",
+          detail: "dayjs",
+          completion: { insertText: "ctx.dayjs()" },
+          examples: ["const now = ctx.dayjs().format('YYYY-MM-DD HH:mm:ss');"]
+        },
         React: "React \u547D\u540D\u7A7A\u95F4\uFF0C\u63D0\u4F9B React \u51FD\u6570\u4E0E hooks\uFF08RunJS \u73AF\u5883\u4E2D\u53EF\u7528\uFF09\u3002\u63A8\u8350\u4F7F\u7528 `ctx.libs.React` \u8BBF\u95EE\u3002",
         ReactDOM: "ReactDOM \u5BA2\u6237\u7AEF API\uFF0C\u542B createRoot \u7B49\u6E32\u67D3\u65B9\u6CD5\u3002\u63A8\u8350\u901A\u8FC7 `ctx.libs.ReactDOM` \u8BBF\u95EE\u3002",
         antd: "Ant Design \u7EC4\u4EF6\u5E93\uFF08RunJS \u73AF\u5883\u4E2D\u53EF\u7528\uFF09\u3002\u63A8\u8350\u4F7F\u7528 `ctx.libs.antd` \u8BBF\u95EE\u3002",
         libs: {
-          description: "\u7B2C\u4E09\u65B9/\u901A\u7528\u5E93\u7684\u7EDF\u4E00\u547D\u540D\u7A7A\u95F4\uFF0C\u5305\u542B React\u3001ReactDOM\u3001Ant Design\u3001dayjs\u3001lodash\u3001math.js\u3001formula.js \u7B49\u3002\u540E\u7EED\u65B0\u589E\u5E93\u4F1A\u4F18\u5148\u6302\u5728\u6B64\u5904\u3002",
+          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",
@@ -167,14 +770,20 @@ function defineBaseContextMeta() {
             antd: "Ant Design \u7EC4\u4EF6\u5E93\uFF08\u7B49\u4EF7\u4E8E ctx.antd\uFF09\u3002",
             dayjs: "dayjs \u65E5\u671F\u65F6\u95F4\u5DE5\u5177\u5E93\u3002",
             antdIcons: "Ant Design \u56FE\u6807\u5E93\u3002 \u4F8B\u5982\uFF1A`ctx.libs.antdIcons.PlusOutlined`\u3002",
-            lodash: 'Lodash \u5DE5\u5177\u5E93\u3002\u4F8B\u5982\uFF1A`ctx.libs.lodash.get(obj, "a.b.c")`\u3002',
-            math: 'Math.js \u6570\u5B66\u8FD0\u7B97\u5E93\u3002\u4F8B\u5982\uFF1A`ctx.libs.math.evaluate("2 + 3 * 4")`\u3002',
-            formula: "Formula.js \u7535\u5B50\u8868\u683C\u516C\u5F0F\u5E93\u3002\u4F8B\u5982\uFF1A`ctx.libs.formula.SUM([1, 2, 3])`\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'
           }
         }
       },
       methods: {
-        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: '\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" })`',
+        useResource: {
+          description: '\u901A\u8FC7\u8D44\u6E90\u7C7B\u540D\u521B\u5EFA ctx.resource\u3002\u5E38\u7528\u503C\uFF1A"MultiRecordResource"\u3001"SingleRecordResource"\u3001"SQLResource"\u3002',
+          detail: "(className) => void",
+          completion: { insertText: "ctx.useResource('MultiRecordResource')" },
+          examples: ["ctx.useResource('MultiRecordResource'); ctx.resource.setResourceName('users');"]
+        },
         render: {
           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",
@@ -184,6 +793,65 @@ function defineBaseContextMeta() {
         },
         requireAsync: '\u6309 URL \u5F02\u6B65\u52A0\u8F7D\u5916\u90E8\u5E93\u3002\u53C2\u6570\uFF1A(url: string) => Promise<any>\u3002\u793A\u4F8B\uFF1A`const lodash = await ctx.requireAsync("https://cdn.jsdelivr.net/npm/lodash")`',
         importAsync: '\u6309 URL \u52A8\u6001\u5BFC\u5165 ESM \u6A21\u5757\uFF08\u5F00\u53D1/\u751F\u4EA7\u5747\u53EF\u7528\uFF09\u3002\u53C2\u6570\uFF1A(url: string) => Promise<Module>\u3002\u793A\u4F8B\uFF1A`const mod = await ctx.importAsync("https://cdn.jsdelivr.net/npm/lit-html@2/+esm")`',
+        loadCSS: {
+          description: "\u6309 URL \u52A0\u8F7D CSS\uFF08\u4EC5\u6D4F\u89C8\u5668\u73AF\u5883\uFF09\u3002",
+          detail: "(url: string) => Promise<void>",
+          completion: { insertText: "await ctx.loadCSS('https://example.com/style.css')" },
+          params: [{ name: "url", type: "string", description: "CSS \u5730\u5740\u3002" }],
+          returns: { type: "Promise<void>" },
+          examples: ["await ctx.loadCSS('https://example.com/style.css');"]
+        },
+        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>",
+          completion: { insertText: "await ctx.getVar('ctx.record.id')" },
+          params: [
+            {
+              name: "path",
+              type: "string",
+              description: '\u4EE5 "ctx." \u5F00\u5934\u7684\u8868\u8FBE\u5F0F\u8DEF\u5F84\uFF08\u4F8B\u5982 "ctx.record.id" / "ctx.record.roles[0].id"\uFF09\u3002'
+            }
+          ],
+          returns: { type: "Promise<any>" },
+          examples: ["const id = await ctx.getVar('ctx.record.id');"]
+        },
+        getApiInfos: {
+          description: "\u4E0A\u4E0B\u6587\u547D\u540D\u7A7A\u95F4\u4E0B\u7684\u6240\u6709\u53EF\u7528 API",
+          detail: "(options?: { version?: string }) => Promise<Record<string, any>>",
+          completion: { insertText: "await ctx.getApiInfos()" },
+          params: [
+            {
+              name: "options",
+              type: "{ version?: string }",
+              optional: true,
+              description: "\u53EF\u9009\u53C2\u6570\uFF08\u4F8B\u5982 version\uFF09\u3002"
+            }
+          ],
+          returns: { type: "Promise<Record<string, any>>" },
+          examples: ["const apis = await ctx.getApiInfos();"]
+        },
+        getVarInfos: {
+          description: "\u6240\u6709\u53EF\u7528\u53D8\u91CF\uFF0C\u53EF\u7528\u4E8E\u83B7\u53D6\u66F4\u6DF1\u5C42\u6570\u636E\u3002",
+          detail: "(options?: { path?: string|string[]; maxDepth?: number }) => Promise<Record<string, any>>",
+          completion: { insertText: "await ctx.getVarInfos({ path: 'record', maxDepth: 3 })" },
+          params: [
+            {
+              name: "options",
+              type: "{ path?: string|string[]; maxDepth?: number }",
+              optional: true,
+              description: "path \u526A\u88C1\u4E0E maxDepth \u5C55\u5F00\u53C2\u6570\u3002"
+            }
+          ],
+          returns: { type: "Promise<Record<string, any>>" },
+          examples: ["const vars = await ctx.getVarInfos({ path: 'record', maxDepth: 3 });"]
+        },
+        getEnvInfos: {
+          description: "\u5F53\u524D\u8FD0\u884C\u65F6\u73AF\u5883",
+          detail: "() => Promise<Record<string, any>>",
+          completion: { insertText: "await ctx.getEnvInfos()" },
+          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",
         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" } })`',