@nocobase/flow-engine 2.1.0-beta.41 → 2.1.0-beta.43

package/lib/components/subModel/LazyDropdown.js

@@ -332,7 +332,7 @@ const getLabelSearchText = /* @__PURE__ */ __name((label) => {
   }
   return "";
 }, "getLabelSearchText");
-const createSearchItem = /* @__PURE__ */ __name((item, searchKey, currentSearchValue, menuVisible, t, searchHandlers, activateSearchSubmenu, deactivateSearchSubmenu) => ({
+const createSearchItem = /* @__PURE__ */ __name((item, searchKey, currentSearchValue, menuVisible, t, searchHandlers, activateSearchSubmenu, deactivateSearchSubmenu, shouldActivateSearchSubmenu) => ({
   key: `${searchKey}-search`,
   type: "group",
   label: /* @__PURE__ */ import_react.default.createElement("div", { onMouseDown: (e) => e.stopPropagation(), onClick: (e) => e.stopPropagation() }, /* @__PURE__ */ import_react.default.createElement(
@@ -350,28 +350,34 @@ const createSearchItem = /* @__PURE__ */ __name((item, searchKey, currentSearchV
         var _a;
         e.stopPropagation();
         const value = e.target.value;
-        activateSearchSubmenu(searchKey);
+        if (shouldActivateSearchSubmenu) {
+          activateSearchSubmenu(searchKey);
+        }
         if (((_a = e.nativeEvent) == null ? void 0 : _a.isComposing) || searchHandlers.isComposing(searchKey)) {
           searchHandlers.updateInputValue(searchKey, value);
           return;
         }
-        if (!value) {
+        if (!value && shouldActivateSearchSubmenu) {
           deactivateSearchSubmenu(searchKey);
         }
         searchHandlers.updateSearchValue(searchKey, value);
       },
       onCompositionStart: (e) => {
         e.stopPropagation();
-        activateSearchSubmenu(searchKey);
+        if (shouldActivateSearchSubmenu) {
+          activateSearchSubmenu(searchKey);
+        }
         searchHandlers.startComposition(searchKey);
       },
       onCompositionEnd: (e) => {
         e.stopPropagation();
         const value = e.currentTarget.value;
-        if (value) {
-          activateSearchSubmenu(searchKey);
-        } else {
-          deactivateSearchSubmenu(searchKey);
+        if (shouldActivateSearchSubmenu) {
+          if (value) {
+            activateSearchSubmenu(searchKey);
+          } else {
+            deactivateSearchSubmenu(searchKey);
+          }
         }
         searchHandlers.endComposition(searchKey, value);
       },
@@ -557,6 +563,7 @@ const LazyDropdown = /* @__PURE__ */ __name(({ menu, ...props }) => {
     const searchKey = keyPath;
     const currentSearchValue = searchValues[searchKey] || "";
     const currentInputValue = inputValues[searchKey] ?? currentSearchValue;
+    const shouldActivateSearchSubmenu = !(item.type === "group" && path.length === 0);
     const filteredChildren = currentSearchValue ? (/* @__PURE__ */ __name(function deepFilter(items2) {
       const searchText = currentSearchValue.toLowerCase();
       return items2.map((child) => {
@@ -581,7 +588,8 @@ const LazyDropdown = /* @__PURE__ */ __name(({ menu, ...props }) => {
       t,
       searchHandlers,
       activateSearchSubmenu,
-      deactivateSearchSubmenu
+      deactivateSearchSubmenu,
+      shouldActivateSearchSubmenu
     );
     const dividerItem = { key: `${keyPath}-search-divider`, type: "divider" };
     if (currentSearchValue && resolvedFiltered.length === 0) {

package/lib/flowContext.d.ts

@@ -222,6 +222,10 @@ export type FlowContextGetApiInfosOptions = {
      * RunJS 文档版本（默认 v1）。
      */
     version?: RunJSVersion;
+    /**
+     * Include editor completion metadata. Defaults to false so API-doc callers keep the compact public shape.
+     */
+    includeCompletion?: boolean;
 };
 export type FlowContextGetVarInfosOptions = {
     /**
@@ -293,7 +297,7 @@ export declare class FlowContext {
      * - 输出仅来自 RunJS doc 与 defineProperty/defineMethod 的 info
      * - 不读取/展开 PropertyMeta（变量结构）
      * - 不自动展开深层 properties
-     * - 不返回自动补全字段（例如 completion）
+     * - 默认不返回自动补全字段（例如 completion），传入 includeCompletion=true 时返回
      */
     getApiInfos(options?: FlowContextGetApiInfosOptions): Promise<Record<string, FlowContextApiInfo>>;
     /**
@@ -423,6 +427,7 @@ export declare class FlowRuntimeContext<TModel extends FlowModel = FlowModel, TM
 export type FlowSettingsContext<TModel extends FlowModel = FlowModel> = FlowRuntimeContext<TModel, 'settings'>;
 export type RunJSDocCompletionDoc = {
     insertText?: string;
+    requires?: Array<'element'>;
 };
 export type RunJSDocHiddenDoc = boolean | ((ctx: any) => boolean | Promise<boolean>);
 export type RunJSDocHiddenOrPathsDoc = boolean | string[] | ((ctx: any) => boolean | string[] | Promise<boolean | string[]>);

package/lib/flowContext.js

@@ -399,10 +399,11 @@ const _FlowContext = class _FlowContext {
    * - 输出仅来自 RunJS doc 与 defineProperty/defineMethod 的 info
    * - 不读取/展开 PropertyMeta（变量结构）
    * - 不自动展开深层 properties
-   * - 不返回自动补全字段（例如 completion）
+   * - 默认不返回自动补全字段（例如 completion），传入 includeCompletion=true 时返回
    */
   async getApiInfos(options = {}) {
     const version = options.version || "v1";
+    const includeCompletion = !!options.includeCompletion;
     const evalCtx = this.createProxy();
     const isPrivateKey = /* @__PURE__ */ __name((key) => typeof key === "string" && key.startsWith("_"), "isPrivateKey");
     const isVarRootKey = /* @__PURE__ */ __name((key) => key === "record" || key === "formValues" || key === "popup", "isVarRootKey");
@@ -439,7 +440,14 @@ const _FlowContext = class _FlowContext {
       const src = toDocObject(obj);
       if (!src) return {};
       const out2 = {};
-      for (const k of ["description", "examples", "ref", "params", "returns"]) {
+      for (const k of [
+        "description",
+        "examples",
+        ...includeCompletion ? ["completion"] : [],
+        "ref",
+        "params",
+        "returns"
+      ]) {
         const v = src[k];
         if (typeof v !== "undefined") out2[k] = v;
       }
@@ -452,7 +460,17 @@ const _FlowContext = class _FlowContext {
       const src = toDocObject(obj);
       if (!src) return {};
       const out2 = {};
-      for (const k of ["title", "type", "interface", "description", "examples", "ref", "params", "returns"]) {
+      for (const k of [
+        "title",
+        "type",
+        "interface",
+        "description",
+        "examples",
+        ...includeCompletion ? ["completion"] : [],
+        "ref",
+        "params",
+        "returns"
+      ]) {
         const v = src[k];
         if (typeof v !== "undefined") out2[k] = v;
       }
@@ -539,7 +557,7 @@ const _FlowContext = class _FlowContext {
       node = { ...node, ...pickPropertyInfo(docObj) };
       node = { ...node, ...pickPropertyInfo(infoObj) };
       delete node.properties;
-      delete node.completion;
+      if (!includeCompletion) delete node.completion;
       if (!Object.keys(node).length) continue;
       const outKey = mapDocKeyToApiKey(key, docNode);
       out[outKey] = out[outKey] ? { ...out[outKey] || {}, ...node || {} } : node;
@@ -554,7 +572,7 @@ const _FlowContext = class _FlowContext {
       node = { ...node, ...pickMethodInfo(docObj) };
       node = { ...node, ...pickMethodInfo(info) };
       delete node.properties;
-      delete node.completion;
+      if (!includeCompletion) delete node.completion;
       if (!Object.keys(node).length) continue;
       node.type = "function";
       if (!out[key]) out[key] = node;
@@ -571,7 +589,7 @@ const _FlowContext = class _FlowContext {
         let node = {};
         node = { ...node, ...pickPropertyInfo(childObj) };
         delete node.properties;
-        delete node.completion;
+        if (!includeCompletion) delete node.completion;
         if (!node.description || !String(node.description).trim()) continue;
         out[outKey] = node;
       }
@@ -2255,6 +2273,17 @@ const _BaseFlowEngineContext = class _BaseFlowEngineContext extends FlowContext
         });
         const jsCode = await (0, import_utils.prepareRunJsCode)(String(code ?? ""), { preprocessTemplates: shouldPreprocessTemplates });
         return runner.run(jsCode);
+      },
+      {
+        description: "Execute a RunJS code string in the current Flow context.",
+        detail: "(code: string, variables?: Record<string, any>, options?: JSRunnerOptions) => Promise<RunJSResult>",
+        params: [
+          { name: "code", type: "string", description: "RunJS code to execute." },
+          { name: "variables", type: "Record<string, any>", optional: true, description: "Additional globals." },
+          { name: "options", type: "JSRunnerOptions", optional: true, description: "Runner options." }
+        ],
+        returns: { type: "Promise<{ success: boolean; value?: any; error?: any; timeout?: boolean }>" },
+        completion: { insertText: `await ctx.runjs('return 1')` }
       }
     );
   }

package/lib/flowEngine.d.ts

@@ -93,6 +93,7 @@ export declare class FlowEngine {
      * @private
      */
     private _savingModels;
+    private _loadedPageCache;
     /**
      * Flow engine context object.
      * @private

package/lib/flowEngine.js

@@ -61,6 +61,7 @@ var import_ReactView = require("./ReactView");
 var import_resources = require("./resources");
 var import_emitter = require("./emitter");
 var import_ModelOperationScheduler = __toESM(require("./scheduler/ModelOperationScheduler"));
+var import_loadedPageCache = require("./utils/loadedPageCache");
 var import_utils = require("./utils");
 var _FlowEngine_instances, registerModel_fn;
 const getFlowEngineLoggerLevel = /* @__PURE__ */ __name(() => process.env.NODE_ENV === "production" ? "warn" : "trace", "getFlowEngineLoggerLevel");
@@ -130,6 +131,7 @@ const _FlowEngine = class _FlowEngine {
      * @private
      */
     __publicField(this, "_savingModels", /* @__PURE__ */ new Map());
+    __publicField(this, "_loadedPageCache", (0, import_loadedPageCache.createLoadedPageCache)());
     /**
      * Flow engine context object.
      * @private
@@ -1138,10 +1140,11 @@ const _FlowEngine = class _FlowEngine {
   async loadModel(options) {
     if (!this.ensureModelRepository()) return;
     const refresh = !!(options == null ? void 0 : options.refresh);
-    if (!refresh) {
-      const model = this.findModelByParentId(options.parentId, options.subKey);
-      if (model) {
-        return model;
+    const bypassLoadedPageCache = this._loadedPageCache.shouldBypass(options, () => this.context.flowSettingsEnabled);
+    if (!refresh && !bypassLoadedPageCache) {
+      const model2 = this.findModelByParentId(options.parentId, options.subKey);
+      if (model2) {
+        return model2;
       }
       const hydrated = await this.hydrateModelFromPreviousEngines(options);
       if (hydrated) {
@@ -1149,15 +1152,24 @@ const _FlowEngine = class _FlowEngine {
       }
     }
     const data = await this._modelRepository.findOne(options);
-    if (!(data == null ? void 0 : data.uid)) return null;
-    await this.resolveModelTree(data);
-    if (refresh) {
+    if (!(data == null ? void 0 : data.uid)) {
+      if (bypassLoadedPageCache) {
+        this._loadedPageCache.clear(options);
+      }
+      return null;
+    }
+    if (refresh || bypassLoadedPageCache) {
       const existing = this.getModel(data.uid);
       if (existing) {
         this.removeModelWithSubModels(existing.uid);
       }
     }
-    return this.createModelAsync(data);
+    const model = await this.createModelAsync(data);
+    if (bypassLoadedPageCache) {
+      this._loadedPageCache.mountModelToParent(model, true);
+      this._loadedPageCache.clear(options);
+    }
+    return model;
   }
   /**
    * Find a sub-model by parent model ID and subKey.
@@ -1188,20 +1200,29 @@ const _FlowEngine = class _FlowEngine {
   async loadOrCreateModel(options, extra) {
     if (!this.ensureModelRepository()) return;
     const { uid, parentId, subKey } = options;
-    if (uid && this._modelInstances.has(uid)) {
+    const bypassLoadedPageCache = this._loadedPageCache.shouldBypass(options, () => this.context.flowSettingsEnabled);
+    if (uid && !bypassLoadedPageCache && this._modelInstances.has(uid)) {
       return this._modelInstances.get(uid);
     }
-    const m = this.findModelByParentId(parentId, subKey);
-    if (m) {
-      return m;
-    }
-    const hydrated = await this.hydrateModelFromPreviousEngines(options, extra);
-    if (hydrated) {
-      return hydrated;
+    if (!bypassLoadedPageCache) {
+      const m = this.findModelByParentId(parentId, subKey);
+      if (m) {
+        return m;
+      }
+      const hydrated = await this.hydrateModelFromPreviousEngines(options, extra);
+      if (hydrated) {
+        return hydrated;
+      }
     }
     const data = await this._modelRepository.findOne(options);
     let model = null;
     if (data == null ? void 0 : data.uid) {
+      if (bypassLoadedPageCache) {
+        const existing = this.getModel(data.uid);
+        if (existing) {
+          this.removeModelWithSubModels(existing.uid);
+        }
+      }
       model = await this.createModelAsync(data, extra);
     } else {
       model = await this.createModelAsync(options, extra);
@@ -1209,18 +1230,9 @@ const _FlowEngine = class _FlowEngine {
         await model.save();
       }
     }
-    if (model.parent) {
-      const subModel = model.parent.findSubModel(model.subKey, (m2) => {
-        return m2.uid === model.uid;
-      });
-      if (subModel) {
-        return model;
-      }
-      if (model.subType === "array") {
-        model.parent.addSubModel(model.subKey, model);
-      } else {
-        model.parent.setSubModel(model.subKey, model);
-      }
+    this._loadedPageCache.mountModelToParent(model, bypassLoadedPageCache);
+    if (bypassLoadedPageCache) {
+      this._loadedPageCache.clear(options);
     }
     return model;
   }
@@ -1238,6 +1250,9 @@ const _FlowEngine = class _FlowEngine {
   async saveModel(model, options) {
     if (!this.ensureModelRepository()) return;
     const modelUid = model.uid;
+    const dirtyLoadedPageKey = this._loadedPageCache.getDirtyKeyForModel(model, {
+      force: !!(options == null ? void 0 : options.onlyStepParams)
+    });
     if (this._savingModels.has(modelUid)) {
       this.logger.debug(`Model ${modelUid} is already being saved, waiting for existing save operation`);
       return await this._savingModels.get(modelUid);
@@ -1246,6 +1261,7 @@ const _FlowEngine = class _FlowEngine {
     this._savingModels.set(modelUid, savePromise);
     try {
       const result = await savePromise;
+      this._loadedPageCache.markDirty(dirtyLoadedPageKey);
       return result;
     } finally {
       this._savingModels.delete(modelUid);
@@ -1276,10 +1292,15 @@ const _FlowEngine = class _FlowEngine {
    * @returns {Promise<boolean>} Whether destroyed successfully
    */
   async destroyModel(uid) {
-    if (this.ensureModelRepository()) {
+    const modelInstance = this._modelInstances.get(uid);
+    const dirtyLoadedPageKey = this._loadedPageCache.getDirtyKeyForModel(modelInstance);
+    const hasModelRepository = this.ensureModelRepository();
+    if (hasModelRepository) {
       await this._modelRepository.destroy(uid);
     }
-    const modelInstance = this._modelInstances.get(uid);
+    if (hasModelRepository) {
+      this._loadedPageCache.markDirty(dirtyLoadedPageKey);
+    }
     const parent = modelInstance == null ? void 0 : modelInstance.parent;
     const result = this.removeModel(uid);
     parent && parent.emitter.emit("onSubModelDestroyed", modelInstance);
@@ -1367,6 +1388,7 @@ const _FlowEngine = class _FlowEngine {
       console.warn(`FlowEngine: Cannot move model. Source or target model not found.`);
       return;
     }
+    const dirtyLoadedPageKey = this._loadedPageCache.getDirtyKeyForModel(sourceModel);
     const move = /* @__PURE__ */ __name((sourceModel2, targetModel2) => {
       if (!sourceModel2.parent || !targetModel2.parent || sourceModel2.parent !== targetModel2.parent) {
         console.error("FlowModel.moveTo: Both models must have the same parent to perform move operation.");
@@ -1401,6 +1423,7 @@ const _FlowEngine = class _FlowEngine {
     if ((options == null ? void 0 : options.persist) !== false && this.ensureModelRepository()) {
       const position = sourceModel.sortIndex - targetModel.sortIndex > 0 ? "after" : "before";
       await this._modelRepository.move(sourceId, targetId, position);
+      this._loadedPageCache.markDirty(dirtyLoadedPageKey);
     }
     sourceModel.parent.emitter.emit("onSubModelMoved", { source: sourceModel, target: targetModel });
     (_b = this.emitter) == null ? void 0 : _b.emit("model:subModel:moved", {

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

@@ -31,6 +31,7 @@ __export(FormJSFieldItemRunJSContext_exports, {
 });
 module.exports = __toCommonJS(FormJSFieldItemRunJSContext_exports);
 var import_flowContext = require("../../flowContext");
+var import_elementDoc = require("./elementDoc");
 const _FormJSFieldItemRunJSContext = class _FormJSFieldItemRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_FormJSFieldItemRunJSContext, "FormJSFieldItemRunJSContext");
@@ -38,8 +39,8 @@ let FormJSFieldItemRunJSContext = _FormJSFieldItemRunJSContext;
 FormJSFieldItemRunJSContext.define({
   label: "FormJSFieldItem RunJS context",
   properties: {
-    element: `ElementProxy instance providing a safe DOM container for form field rendering.
-      Supports innerHTML, append, and other DOM manipulation methods.`,
+    element: (0, import_elementDoc.createElementPropertyDoc)(`ElementProxy instance providing a safe DOM container for form field rendering.
+      Supports innerHTML, append, and other DOM manipulation methods.`),
     value: `Current field value (read-only in display mode; in controlled scenarios, use setProps to modify).`,
     record: `Current record data object (read-only).
       Contains all field values of the parent record.`,
@@ -61,7 +62,7 @@ FormJSFieldItemRunJSContext.define(
   {
     label: "\u8868\u5355 JS \u5B57\u6BB5\u9879 RunJS \u4E0A\u4E0B\u6587",
     properties: {
-      element: "ElementProxy\uFF0C\u8868\u5355\u5B57\u6BB5\u5BB9\u5668",
+      element: (0, import_elementDoc.createZhCNElementPropertyDoc)("ElementProxy\uFF0C\u8868\u5355\u5B57\u6BB5\u5BB9\u5668"),
       value: "\u5B57\u6BB5\u503C\uFF08\u5C55\u793A\u6A21\u5F0F\u4E3A\u53EA\u8BFB\uFF1B\u53D7\u63A7\u573A\u666F\u7528 setProps \u4FEE\u6539\uFF09",
       record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF09",
       formValues: {

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

@@ -31,6 +31,7 @@ __export(JSBlockRunJSContext_exports, {
 });
 module.exports = __toCommonJS(JSBlockRunJSContext_exports);
 var import_flowContext = require("../../flowContext");
+var import_elementDoc = require("./elementDoc");
 const _JSBlockRunJSContext = class _JSBlockRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSBlockRunJSContext, "JSBlockRunJSContext");
@@ -38,15 +39,9 @@ let JSBlockRunJSContext = _JSBlockRunJSContext;
 JSBlockRunJSContext.define({
   label: "RunJS context",
   properties: {
-    element: {
-      description: `ElementProxy instance providing a safe DOM container.
+    element: (0, import_elementDoc.createElementPropertyDoc)(`ElementProxy instance providing a safe DOM container.
       Supports innerHTML, append, and other DOM manipulation methods.
-      Use this to render content in the JS block.`,
-      detail: "ElementProxy",
-      properties: {
-        innerHTML: "Set or read the HTML content of the container element."
-      }
-    },
+      Use this to render content in the JS block.`),
     record: `Current record data object (read-only).
       Available when the JS block is within a data block or detail view context.`,
     value: "Current value of the field or component, if available in the current context.",
@@ -65,13 +60,7 @@ JSBlockRunJSContext.define(
   {
     label: "RunJS \u4E0A\u4E0B\u6587",
     properties: {
-      element: {
-        description: "ElementProxy\uFF0C\u5B89\u5168\u7684 DOM \u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49",
-        detail: "ElementProxy",
-        properties: {
-          innerHTML: "\u8BFB\u53D6\u6216\u8BBE\u7F6E\u5BB9\u5668\u7684 HTML \u5185\u5BB9"
-        }
-      },
+      element: (0, import_elementDoc.createZhCNElementPropertyDoc)("ElementProxy\uFF0C\u5B89\u5168\u7684 DOM \u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49"),
       record: "\u5F53\u524D\u8BB0\u5F55\uFF08\u53EA\u8BFB\uFF0C\u7528\u4E8E\u6570\u636E\u533A\u5757/\u8BE6\u60C5\u7B49\u573A\u666F\uFF09",
       value: "\u5F53\u524D\u503C\uFF08\u82E5\u5B58\u5728\uFF09",
       React: "React \u5E93",

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

@@ -31,6 +31,7 @@ __export(JSColumnRunJSContext_exports, {
 });
 module.exports = __toCommonJS(JSColumnRunJSContext_exports);
 var import_flowContext = require("../../flowContext");
+var import_elementDoc = require("./elementDoc");
 const _JSColumnRunJSContext = class _JSColumnRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSColumnRunJSContext, "JSColumnRunJSContext");
@@ -38,7 +39,9 @@ let JSColumnRunJSContext = _JSColumnRunJSContext;
 JSColumnRunJSContext.define({
   label: "JSColumn RunJS context",
   properties: {
-    element: "ElementProxy instance providing a safe DOM container for the current table cell. Supports innerHTML/append and basic DOM APIs.",
+    element: (0, import_elementDoc.createElementPropertyDoc)(
+      "ElementProxy instance providing a safe DOM container for the current table cell. Supports innerHTML/append and basic DOM APIs."
+    ),
     record: "Current row record object (read-only).",
     recordIndex: "Index of the current row in the page (0-based).",
     collection: "Collection definition metadata (read-only).",
@@ -56,7 +59,7 @@ JSColumnRunJSContext.define(
   {
     label: "JS \u5217 RunJS \u4E0A\u4E0B\u6587",
     properties: {
-      element: "ElementProxy\uFF0C\u8868\u683C\u5355\u5143\u683C\u7684\u5B89\u5168 DOM \u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49",
+      element: (0, import_elementDoc.createZhCNElementPropertyDoc)("ElementProxy\uFF0C\u8868\u683C\u5355\u5143\u683C\u7684\u5B89\u5168 DOM \u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49"),
       record: "\u5F53\u524D\u884C\u8BB0\u5F55\u5BF9\u8C61\uFF08\u53EA\u8BFB\uFF09",
       recordIndex: "\u5F53\u524D\u884C\u7D22\u5F15\uFF08\u4ECE 0 \u5F00\u59CB\uFF09",
       collection: "\u96C6\u5408\u5B9A\u4E49\u5143\u6570\u636E\uFF08\u53EA\u8BFB\uFF09",

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

@@ -31,6 +31,7 @@ __export(JSEditableFieldRunJSContext_exports, {
 });
 module.exports = __toCommonJS(JSEditableFieldRunJSContext_exports);
 var import_flowContext = require("../../flowContext");
+var import_elementDoc = require("./elementDoc");
 const _JSEditableFieldRunJSContext = class _JSEditableFieldRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSEditableFieldRunJSContext, "JSEditableFieldRunJSContext");
@@ -38,10 +39,9 @@ let JSEditableFieldRunJSContext = _JSEditableFieldRunJSContext;
 JSEditableFieldRunJSContext.define({
   label: "JSEditableField RunJS context",
   properties: {
-    element: {
-      description: "ElementProxy instance providing a safe DOM container for field rendering. In editable mode this container is typically a <span> element.",
-      detail: "ElementProxy"
-    },
+    element: (0, import_elementDoc.createElementPropertyDoc)(
+      "ElementProxy instance providing a safe DOM container for field rendering. In editable mode this container is typically a <span> element."
+    ),
     value: {
       description: "Current field value (read-only snapshot). In editable scenarios, prefer ctx.getValue()/ctx.setValue(v) for two-way binding.",
       detail: "any",
@@ -84,10 +84,7 @@ JSEditableFieldRunJSContext.define(
   {
     label: "JS \u53EF\u7F16\u8F91\u5B57\u6BB5 RunJS \u4E0A\u4E0B\u6587",
     properties: {
-      element: {
-        description: "ElementProxy\uFF0C\u5B57\u6BB5\u6E32\u67D3\u7684\u5B89\u5168\u5BB9\u5668\uFF08\u901A\u5E38\u4E3A <span> \u5BB9\u5668\uFF09\u3002",
-        detail: "ElementProxy"
-      },
+      element: (0, import_elementDoc.createZhCNElementPropertyDoc)("ElementProxy\uFF0C\u5B57\u6BB5\u6E32\u67D3\u7684\u5B89\u5168\u5BB9\u5668\uFF08\u901A\u5E38\u4E3A <span> \u5BB9\u5668\uFF09\u3002"),
       value: {
         description: "\u5B57\u6BB5\u5F53\u524D\u503C\uFF08\u53EA\u8BFB\u5FEB\u7167\uFF09\u3002\u53EF\u7F16\u8F91\u573A\u666F\u5EFA\u8BAE\u4F7F\u7528 ctx.getValue()/ctx.setValue(v) \u505A\u53CC\u5411\u7ED1\u5B9A\u3002",
         detail: "any",

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

@@ -31,6 +31,7 @@ __export(JSFieldRunJSContext_exports, {
 });
 module.exports = __toCommonJS(JSFieldRunJSContext_exports);
 var import_flowContext = require("../../flowContext");
+var import_elementDoc = require("./elementDoc");
 const _JSFieldRunJSContext = class _JSFieldRunJSContext extends import_flowContext.FlowRunJSContext {
 };
 __name(_JSFieldRunJSContext, "JSFieldRunJSContext");
@@ -38,8 +39,8 @@ let JSFieldRunJSContext = _JSFieldRunJSContext;
 JSFieldRunJSContext.define({
   label: "JSField RunJS context",
   properties: {
-    element: `ElementProxy instance providing a safe DOM container for field rendering.
-      Supports innerHTML, append, and other DOM manipulation methods.`,
+    element: (0, import_elementDoc.createElementPropertyDoc)(`ElementProxy instance providing a safe DOM container for field rendering.
+      Supports innerHTML, append, and other DOM manipulation methods.`),
     value: `Current value of the field (read-only).
       Contains the data value stored in this field.`,
     record: `Current record data object (read-only).
@@ -57,7 +58,7 @@ JSFieldRunJSContext.define(
   {
     label: "JS \u5B57\u6BB5 RunJS \u4E0A\u4E0B\u6587",
     properties: {
-      element: "ElementProxy\uFF0C\u5B57\u6BB5\u6E32\u67D3\u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49 DOM \u64CD\u4F5C",
+      element: (0, import_elementDoc.createZhCNElementPropertyDoc)("ElementProxy\uFF0C\u5B57\u6BB5\u6E32\u67D3\u5BB9\u5668\uFF0C\u652F\u6301 innerHTML/append \u7B49 DOM \u64CD\u4F5C"),
       value: "\u5B57\u6BB5\u5F53\u524D\u503C\uFF08\u53EA\u8BFB\uFF09",
       record: "\u5F53\u524D\u8BB0\u5F55\u5BF9\u8C61\uFF08\u53EA\u8BFB\uFF0C\u5305\u542B\u7236\u8BB0\u5F55\u5168\u90E8\u5B57\u6BB5\u503C\uFF09",
       collection: "\u96C6\u5408\u5B9A\u4E49\u5143\u6570\u636E\uFF08\u53EA\u8BFB\uFF0C\u63CF\u8FF0\u5B57\u6BB5\u6240\u5C5E\u96C6\u5408\u7684 Schema\uFF09"

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