@nocobase/flow-engine 2.1.0-beta.8 → 2.1.0

package/lib/models/flowModel.js

@@ -56,25 +56,80 @@ var import_reactive = require("@formily/reactive");
 var import_lodash = __toESM(require("lodash"));
 var import_react = __toESM(require("react"));
 var import_secure = require("uid/secure");
-var import_StepRequiredSettingsDialog = require("../components/settings/wrappers/contextual/StepRequiredSettingsDialog");
-var import_StepSettingsDialog = require("../components/settings/wrappers/contextual/StepSettingsDialog");
 var import_emitter = require("../emitter");
 var import_InstanceFlowRegistry = require("../flow-registry/InstanceFlowRegistry");
 var import_flowContext = require("../flowContext");
 var import_utils = require("../utils");
-var import_lib = require("antd/lib");
+var import_antd = require("antd");
+var import__ = require("..");
 var import_ModelActionRegistry = require("../action-registry/ModelActionRegistry");
 var import_utils2 = require("../components/subModel/utils");
 var import_ModelEventRegistry = require("../event-registry/ModelEventRegistry");
 var import_GlobalFlowRegistry = require("../flow-registry/GlobalFlowRegistry");
 var import_forkFlowModel = require("./forkFlowModel");
-var import__ = require("..");
 var _flowContext;
 const classActionRegistries = /* @__PURE__ */ new WeakMap();
 const classEventRegistries = /* @__PURE__ */ new WeakMap();
 const modelMetas = /* @__PURE__ */ new WeakMap();
+function getStableSortIndex(item, fallbackIndex) {
+  return typeof (item == null ? void 0 : item.sortIndex) === "number" && Number.isFinite(item.sortIndex) ? item.sortIndex : fallbackIndex + 1;
+}
+__name(getStableSortIndex, "getStableSortIndex");
+function sortByStableSortIndex(items) {
+  return items.map((item, index) => ({
+    item,
+    index,
+    sortIndex: getStableSortIndex(item, index)
+  })).sort((a, b) => a.sortIndex - b.sortIndex || a.index - b.index).map(({ item }) => item);
+}
+__name(sortByStableSortIndex, "sortByStableSortIndex");
 const modelGlobalRegistries = /* @__PURE__ */ new WeakMap();
 const classMenuExtensions = /* @__PURE__ */ new WeakMap();
+const sortExtraMenuItems = /* @__PURE__ */ __name((items) => {
+  return [...items].sort((a, b) => (a.sort ?? 0) - (b.sort ?? 0));
+}, "sortExtraMenuItems");
+const isFlowModelExtraMenuItem = /* @__PURE__ */ __name((item) => {
+  return item !== null;
+}, "isFlowModelExtraMenuItem");
+const normalizeExtraMenuItem = /* @__PURE__ */ __name((item, {
+  group,
+  sort,
+  prefix,
+  path
+}) => {
+  if (!item) {
+    return null;
+  }
+  const normalizedGroup = item.group || group;
+  const normalizedSort = typeof item.sort === "number" ? item.sort : sort;
+  const normalizedChildren = sortExtraMenuItems(
+    (item.children || []).map(
+      (child, index) => normalizeExtraMenuItem(child, {
+        group: normalizedGroup,
+        sort: normalizedSort,
+        prefix,
+        path: `${path}-${index}`
+      })
+    ).filter(isFlowModelExtraMenuItem)
+  );
+  return {
+    ...item,
+    key: item.key ?? `${prefix}-${normalizedGroup}-${path}`,
+    group: normalizedGroup,
+    sort: normalizedSort,
+    children: normalizedChildren.length ? normalizedChildren : void 0
+  };
+}, "normalizeExtraMenuItem");
+async function loadOpenStepSettingsDialog() {
+  const mod = await import("../components/settings/wrappers/contextual/StepSettingsDialog");
+  return mod.openStepSettingsDialog;
+}
+__name(loadOpenStepSettingsDialog, "loadOpenStepSettingsDialog");
+async function loadOpenRequiredParamsStepFormDialog() {
+  const mod = await import("../components/settings/wrappers/contextual/StepRequiredSettingsDialog");
+  return mod.openRequiredParamsStepFormDialog;
+}
+__name(loadOpenRequiredParamsStepFormDialog, "loadOpenRequiredParamsStepFormDialog");
 var ModelRenderMode = /* @__PURE__ */ ((ModelRenderMode2) => {
   ModelRenderMode2["ReactElement"] = "reactElement";
   ModelRenderMode2["RenderFunction"] = "renderFunction";
@@ -161,7 +216,7 @@ const _FlowModel = class _FlowModel {
     };
     this.stepParams = options.stepParams || {};
     this.subModels = {};
-    this.sortIndex = options.sortIndex || 0;
+    this.sortIndex = getStableSortIndex({ sortIndex: options.sortIndex }, -1);
     this._options = options;
     this._title = "";
     this._extraTitle = "";
@@ -183,10 +238,13 @@ const _FlowModel = class _FlowModel {
       if (changed.type === "set" && import_lodash.default.isEqual(changed.value, changed.oldValue)) {
         return;
       }
+      const hasLastAutoRun = !!this._lastAutoRunParams;
       if (this.flowEngine) {
         this.invalidateFlowCache("beforeRender");
       }
-      this._rerunLastAutoRun();
+      if (hasLastAutoRun) {
+        this._rerunLastAutoRun();
+      }
       this.forks.forEach((fork) => {
         fork.rerender();
       });
@@ -370,7 +428,7 @@ const _FlowModel = class _FlowModel {
     }
     Object.entries(mergedSubModels || {}).forEach(([key, value]) => {
       if (Array.isArray(value)) {
-        value.sort((a, b) => (a.sortIndex || 0) - (b.sortIndex || 0)).forEach((item) => {
+        sortByStableSortIndex(value).forEach((item) => {
           this.addSubModel(key, item);
         });
       } else {
@@ -576,31 +634,49 @@ const _FlowModel = class _FlowModel {
     } else {
       this.props = { ...this.props, ...props };
     }
+    this._options.props = { ...this.props };
   }
   getProps() {
     return this.props;
   }
   setStepParams(flowKeyOrAllParams, stepKeyOrStepsParams, params) {
+    var _a;
+    let hasChanged = false;
     if (typeof flowKeyOrAllParams === "string") {
       const flowKey = flowKeyOrAllParams;
       if (typeof stepKeyOrStepsParams === "string" && params !== void 0) {
-        if (!this.stepParams[flowKey]) {
-          this.stepParams[flowKey] = {};
+        const currentStepParams = ((_a = this.stepParams[flowKey]) == null ? void 0 : _a[stepKeyOrStepsParams]) || {};
+        const nextStepParams = { ...currentStepParams, ...params };
+        if (!import_lodash.default.isEqual(currentStepParams, nextStepParams)) {
+          if (!this.stepParams[flowKey]) {
+            this.stepParams[flowKey] = {};
+          }
+          this.stepParams[flowKey][stepKeyOrStepsParams] = nextStepParams;
+          hasChanged = true;
         }
-        this.stepParams[flowKey][stepKeyOrStepsParams] = {
-          ...this.stepParams[flowKey][stepKeyOrStepsParams],
-          ...params
-        };
       } else if (typeof stepKeyOrStepsParams === "object" && stepKeyOrStepsParams !== null) {
-        this.stepParams[flowKey] = { ...this.stepParams[flowKey] || {}, ...stepKeyOrStepsParams };
+        const currentFlowParams = this.stepParams[flowKey] || {};
+        const nextFlowParams = { ...currentFlowParams, ...stepKeyOrStepsParams };
+        if (!import_lodash.default.isEqual(currentFlowParams, nextFlowParams)) {
+          this.stepParams[flowKey] = nextFlowParams;
+          hasChanged = true;
+        }
       }
     } else if (typeof flowKeyOrAllParams === "object" && flowKeyOrAllParams !== null) {
       for (const fk in flowKeyOrAllParams) {
         if (Object.prototype.hasOwnProperty.call(flowKeyOrAllParams, fk)) {
-          this.stepParams[fk] = { ...this.stepParams[fk] || {}, ...flowKeyOrAllParams[fk] };
+          const currentFlowParams = this.stepParams[fk] || {};
+          const nextFlowParams = { ...currentFlowParams, ...flowKeyOrAllParams[fk] };
+          if (!import_lodash.default.isEqual(currentFlowParams, nextFlowParams)) {
+            this.stepParams[fk] = nextFlowParams;
+            hasChanged = true;
+          }
         }
       }
     }
+    if (!hasChanged) {
+      return;
+    }
     this.emitter.emit("onStepParamsChanged");
   }
   getStepParams(flowKey, stepKey) {
@@ -621,7 +697,7 @@ const _FlowModel = class _FlowModel {
     }
     const isFork = this.isFork === true;
     const target = this;
-    console.log(
+    currentFlowEngine.logger.debug(
       `[FlowModel] applyFlow: uid=${this.uid}, flowKey=${flowKey}, isFork=${isFork}, cleanRun=${this.cleanRun}, targetIsFork=${(target == null ? void 0 : target.isFork) === true}`
     );
     return currentFlowEngine.executor.runFlow(target, flowKey, inputArgs, runId);
@@ -634,7 +710,7 @@ const _FlowModel = class _FlowModel {
     }
     const isFork = this.isFork === true;
     const target = this;
-    console.log(
+    currentFlowEngine.logger.debug(
       `[FlowModel] dispatchEvent: uid=${this.uid}, event=${eventName}, isFork=${isFork}, cleanRun=${this.cleanRun}, targetIsFork=${(target == null ? void 0 : target.isFork) === true}`
     );
     return await currentFlowEngine.executor.dispatchEvent(target, eventName, inputArgs, options);
@@ -674,6 +750,11 @@ const _FlowModel = class _FlowModel {
     }, "isMatch");
     return Array.from(allFlows.values()).filter(isMatch);
   }
+  resetAutoRunState() {
+    var _a, _b;
+    (_b = (_a = this._rerunLastAutoRun) == null ? void 0 : _a.cancel) == null ? void 0 : _b.call(_a);
+    this._lastAutoRunParams = null;
+  }
   /**
    * 通用事件分发钩子：开始
    * 子类可覆盖；beforeRender 事件可通过抛出 FlowExitException 提前终止。
@@ -763,6 +844,7 @@ const _FlowModel = class _FlowModel {
             }));
             return () => {
               var _a3, _b3;
+              renderTarget.resetAutoRunState();
               if (typeof renderTarget.onUnmount === "function") {
                 renderTarget.onUnmount();
               }
@@ -880,7 +962,10 @@ const _FlowModel = class _FlowModel {
     if (!Array.isArray(subModels[subKey])) {
       subModels[subKey] = import_reactive.observable.shallow([]);
     }
-    const maxSortIndex = Math.max(...subModels[subKey].map((item) => item.sortIndex || 0), 0);
+    const maxSortIndex = Math.max(
+      ...subModels[subKey].map((item, index) => getStableSortIndex(item, index)),
+      0
+    );
     model.sortIndex = maxSortIndex + 1;
     subModels[subKey].push(model);
     actualParent.emitter.emit("onSubModelAdded", model);
@@ -928,7 +1013,7 @@ const _FlowModel = class _FlowModel {
       return [];
     }
     const results = [];
-    import_lodash.default.castArray(model).sort((a, b) => (a.sortIndex || 0) - (b.sortIndex || 0)).forEach((item, index) => {
+    sortByStableSortIndex(import_lodash.default.castArray(model)).forEach((item, index) => {
       const result = callback(item, index);
       if (result) {
         results.push(item);
@@ -942,7 +1027,7 @@ const _FlowModel = class _FlowModel {
       return [];
     }
     const results = [];
-    import_lodash.default.castArray(model).sort((a, b) => (a.sortIndex || 0) - (b.sortIndex || 0)).forEach((item, index) => {
+    sortByStableSortIndex(import_lodash.default.castArray(model)).forEach((item, index) => {
       const result = callback(item, index);
       results.push(result);
     });
@@ -1003,7 +1088,7 @@ const _FlowModel = class _FlowModel {
   }
   clearForks() {
     var _a;
-    console.log(`FlowModel ${this.uid} clearing all forks.`);
+    this.flowEngine.logger.debug(`FlowModel ${this.uid} clearing all forks.`);
     if ((_a = this.forks) == null ? void 0 : _a.size) {
       this.forks.forEach((fork) => fork.dispose());
       this.forks.clear();
@@ -1058,7 +1143,7 @@ const _FlowModel = class _FlowModel {
    * @param {string} stepKey 步骤的唯一标识符
    * @returns {void}
    */
-  openStepSettingsDialog(flowKey, stepKey) {
+  async openStepSettingsDialog(flowKey, stepKey) {
     var _a;
     const flow = this.getFlow(flowKey);
     const step = (_a = flow == null ? void 0 : flow.steps) == null ? void 0 : _a[stepKey];
@@ -1069,7 +1154,8 @@ const _FlowModel = class _FlowModel {
     const ctx = new import_flowContext.FlowRuntimeContext(this, flowKey, "settings");
     (0, import_utils.setupRuntimeContextSteps)(ctx, flow.steps, this, flowKey);
     ctx.defineProperty("currentStep", { value: step });
-    return (0, import_StepSettingsDialog.openStepSettingsDialog)({
+    const openStepSettingsDialog = await loadOpenStepSettingsDialog();
+    return openStepSettingsDialog({
       model: this,
       flowKey,
       stepKey,
@@ -1084,7 +1170,8 @@ const _FlowModel = class _FlowModel {
    * @returns {Promise<any>} 返回表单提交的值
    */
   async configureRequiredSteps(dialogWidth, dialogTitle) {
-    return (0, import_StepRequiredSettingsDialog.openRequiredParamsStepFormDialog)({
+    const openRequiredParamsStepFormDialog = await loadOpenRequiredParamsStepFormDialog();
+    return openRequiredParamsStepFormDialog({
       model: this,
       dialogWidth,
       dialogTitle
@@ -1109,6 +1196,7 @@ const _FlowModel = class _FlowModel {
     const data = {
       uid: this.uid,
       ...import_lodash.default.omit(this._options, ["flowEngine"]),
+      props: { ...this.props },
       stepParams: this.stepParams,
       sortIndex: this.sortIndex,
       flowRegistry: {}
@@ -1221,22 +1309,26 @@ const _FlowModel = class _FlowModel {
       seen.add(Cls);
       const reg = classMenuExtensions.get(Cls);
       if (reg) {
+        let entryIndex = 0;
         for (const entry of reg) {
           if (entry.matcher && !entry.matcher(model)) continue;
           const items = typeof entry.items === "function" ? await entry.items(model, t) : await Promise.resolve(entry.items || []);
           const group = entry.group || "common-actions";
           const sort = entry.sort ?? 0;
           const prefix = entry.keyPrefix || Cls.name || "extra";
-          (items || []).forEach((it, idx) => {
-            if (!it) return;
-            const key = it.key ?? `${prefix}-${group}-${idx}-${Math.random().toString(36).slice(2, 6)}`;
-            collected.push({
-              ...it,
-              key,
-              group: it.group || group,
-              sort: typeof it.sort === "number" ? it.sort : sort
-            });
+          sortExtraMenuItems(
+            (items || []).map(
+              (it, idx) => normalizeExtraMenuItem(it, {
+                group,
+                sort,
+                prefix,
+                path: `${entryIndex}-${idx}`
+              })
+            ).filter(isFlowModelExtraMenuItem)
+          ).forEach((it) => {
+            collected.push(it);
           });
+          entryIndex += 1;
         }
       }
       const ParentClass = Object.getPrototypeOf(Cls);
@@ -1303,7 +1395,7 @@ const _ErrorFlowModel = class _ErrorFlowModel extends FlowModel {
     this.errorMessage = msg;
   }
   render() {
-    return /* @__PURE__ */ import_react.default.createElement(import_lib.Typography.Text, { type: "danger" }, this.errorMessage);
+    return /* @__PURE__ */ import_react.default.createElement(import_antd.Typography.Text, { type: "danger" }, this.errorMessage);
   }
 };
 __name(_ErrorFlowModel, "ErrorFlowModel");

package/lib/provider.js

@@ -67,31 +67,46 @@ const FlowEngineGlobalsContextProvider = /* @__PURE__ */ __name(({ children }) =
   const engine = useFlowEngine();
   const config = (0, import_react.useContext)(import_antd.ConfigProvider.ConfigContext);
   const { token } = import_antd.theme.useToken();
-  (0, import_react.useEffect)(() => {
-    const context = {
-      antdConfig: config,
-      // themeToken 改为可观察的 getter，在下方单独 define
-      modal,
-      message,
-      notification
-    };
-    engine.context.defineProperty("viewer", {
-      cache: false,
-      get: /* @__PURE__ */ __name((ctx) => new import_FlowView.FlowViewer(ctx, { drawer, embed, popover, dialog }), "get")
-    });
-    for (const item of Object.entries(context)) {
-      const [key, value] = item;
-      if (value) {
-        engine.context.defineProperty(key, { value });
-      }
+  const isDarkTheme = import_react.default.useMemo(() => {
+    var _a2;
+    const algorithm = (_a2 = config == null ? void 0 : config.theme) == null ? void 0 : _a2.algorithm;
+    if (Array.isArray(algorithm)) {
+      return algorithm.includes(import_antd.theme.darkAlgorithm);
+    }
+    return algorithm === import_antd.theme.darkAlgorithm;
+  }, [config]);
+  engine.context.defineProperty("viewer", {
+    cache: false,
+    get: /* @__PURE__ */ __name((ctx) => new import_FlowView.FlowViewer(ctx, { drawer, embed, popover, dialog }), "get")
+  });
+  for (const item of Object.entries({
+    antdConfig: config,
+    modal,
+    message,
+    notification
+  })) {
+    const [key, value] = item;
+    if (value) {
+      engine.context.defineProperty(key, { value });
     }
-    engine.context.defineProperty("themeToken", {
-      get: /* @__PURE__ */ __name(() => token, "get"),
-      observable: true,
-      cache: true
-    });
+  }
+  engine.context.defineProperty("themeToken", {
+    get: /* @__PURE__ */ __name(() => token, "get"),
+    observable: true,
+    cache: true
+  });
+  engine.context.defineProperty("isDarkTheme", {
+    get: /* @__PURE__ */ __name(() => isDarkTheme, "get"),
+    observable: true,
+    cache: true,
+    info: {
+      description: "Whether current theme algorithm is dark mode.",
+      detail: "boolean"
+    }
+  });
+  (0, import_react.useEffect)(() => {
     engine.reactView.refresh();
-  }, [engine, drawer, modal, message, notification, config, popover, token, dialog, embed]);
+  }, [engine, drawer, modal, message, notification, config, popover, token, dialog, embed, isDarkTheme]);
   return /* @__PURE__ */ import_react.default.createElement(import_antd.ConfigProvider, { ...config, locale: (_a = engine.context.locales) == null ? void 0 : _a.antd, popupMatchSelectWidth: false }, children, contextHolder, popoverContextHolder, pageContextHolder, dialogContextHolder);
 }, "FlowEngineGlobalsContextProvider");
 const useFlowEngine = /* @__PURE__ */ __name(({ throwError = true } = {}) => {

package/lib/reactive/observer.js

@@ -51,8 +51,31 @@ const observer = /* @__PURE__ */ __name((Component, options) => {
     const ctxRef = (0, import_react.useRef)(ctx);
     ctxRef.current = ctx;
     const pendingDisposerRef = (0, import_react.useRef)(null);
+    const pendingTimerRef = (0, import_react.useRef)(null);
+    const clearPendingDisposer = /* @__PURE__ */ __name(() => {
+      if (pendingDisposerRef.current) {
+        pendingDisposerRef.current();
+        pendingDisposerRef.current = null;
+      }
+    }, "clearPendingDisposer");
+    const clearPendingTimer = /* @__PURE__ */ __name(() => {
+      if (pendingTimerRef.current) {
+        clearTimeout(pendingTimerRef.current);
+        pendingTimerRef.current = null;
+      }
+    }, "clearPendingTimer");
+    const isContextActive = /* @__PURE__ */ __name(() => {
+      var _a, _b;
+      const pageActive = getPageActive(ctxRef.current);
+      const tabActive = (_b = (_a = ctxRef.current) == null ? void 0 : _a.tabActive) == null ? void 0 : _b.value;
+      return pageActive !== false && tabActive !== false;
+    }, "isContextActive");
     (0, import_react.useEffect)(() => {
       return () => {
+        if (pendingTimerRef.current) {
+          clearTimeout(pendingTimerRef.current);
+          pendingTimerRef.current = null;
+        }
         if (pendingDisposerRef.current) {
           pendingDisposerRef.current();
           pendingDisposerRef.current = null;
@@ -62,30 +85,37 @@ const observer = /* @__PURE__ */ __name((Component, options) => {
     const ObservedComponent = (0, import_react.useMemo)(
       () => (0, import_reactive_react.observer)(Component, {
         scheduler(updater) {
-          var _a, _b;
-          const pageActive = getPageActive(ctxRef.current);
-          const tabActive = (_b = (_a = ctxRef.current) == null ? void 0 : _a.tabActive) == null ? void 0 : _b.value;
-          if (pageActive === false || tabActive === false) {
-            setTimeout(() => {
+          if (!isContextActive()) {
+            if (pendingTimerRef.current || pendingDisposerRef.current) {
+              return;
+            }
+            pendingTimerRef.current = setTimeout(() => {
+              pendingTimerRef.current = null;
               if (pendingDisposerRef.current) {
                 return;
               }
-              const disposer = (0, import_reactive.autorun)(() => {
-                var _a2, _b2, _c, _d, _e, _f;
-                if (((_b2 = (_a2 = ctxRef.current) == null ? void 0 : _a2.pageActive) == null ? void 0 : _b2.value) && (((_d = (_c = ctxRef.current) == null ? void 0 : _c.tabActive) == null ? void 0 : _d.value) === true || ((_f = (_e = ctxRef.current) == null ? void 0 : _e.tabActive) == null ? void 0 : _f.value) === void 0)) {
+              if (isContextActive()) {
+                updater();
+                return;
+              }
+              pendingDisposerRef.current = (0, import_reactive.reaction)(
+                () => isContextActive(),
+                (active) => {
+                  if (!active) {
+                    return;
+                  }
+                  clearPendingDisposer();
                   updater();
-                  disposer == null ? void 0 : disposer();
-                  pendingDisposerRef.current = null;
+                },
+                {
+                  name: "FlowObserverPendingUpdate"
                 }
-              });
-              pendingDisposerRef.current = disposer;
+              );
             });
             return;
           }
-          if (pendingDisposerRef.current) {
-            pendingDisposerRef.current();
-            pendingDisposerRef.current = null;
-          }
+          clearPendingTimer();
+          clearPendingDisposer();
           updater();
         },
         ...options

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"