@nocobase/flow-engine 2.0.0-alpha.2

package/lib/components/variables/VariableTag.js

@@ -0,0 +1,148 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var VariableTag_exports = {};
+__export(VariableTag_exports, {
+  VariableTag: () => VariableTag
+});
+module.exports = __toCommonJS(VariableTag_exports);
+var import_react = __toESM(require("react"));
+var import_antd = require("antd");
+var import_css = require("@emotion/css");
+var import_utils = require("./utils");
+var import_useResolvedMetaTree = require("./useResolvedMetaTree");
+var import_ahooks = require("ahooks");
+var import_FlowContextProvider = require("../../FlowContextProvider");
+const VariableTagComponent = /* @__PURE__ */ __name(({
+  value,
+  onClear,
+  className,
+  style,
+  metaTreeNode,
+  metaTree
+}) => {
+  const { resolvedMetaTree } = (0, import_useResolvedMetaTree.useResolvedMetaTree)(metaTree);
+  const ctx = (0, import_FlowContextProvider.useFlowContext)();
+  const { data: displayedValue } = (0, import_ahooks.useRequest)(
+    async () => {
+      if (metaTreeNode) {
+        return metaTreeNode.parentTitles ? [...metaTreeNode.parentTitles, metaTreeNode.title].map(ctx.t).join("/") : ctx.t(metaTreeNode.title) || "";
+      }
+      if (!value) return String(value);
+      const path = (0, import_utils.parseValueToPath)(value);
+      return path ? path.join("/") : String(value);
+    },
+    { refreshDeps: [resolvedMetaTree, value, metaTreeNode] }
+  );
+  const { token } = import_antd.theme.useToken();
+  const shrinkableOverflowItem = import_css.css`
+    /* 选择器容器允许收缩并隐藏超出 */
+    & .ant-select-selector {
+      min-width: 0;
+      overflow: hidden;
+    }
+    /* rc-overflow 只展示单行，避免换行导致容器增高 */
+    & .rc-overflow {
+      flex-wrap: nowrap;
+    }
+  `;
+  const customTagRender = /* @__PURE__ */ __name((props) => {
+    const { label } = props;
+    const fullText = typeof label === "string" ? label : String(label);
+    return /* @__PURE__ */ import_react.default.createElement(import_antd.Tooltip, { title: fullText, placement: "top", getPopupContainer: () => document.body }, /* @__PURE__ */ import_react.default.createElement(
+      import_antd.Tag,
+      {
+        color: "blue",
+        style: {
+          margin: `0 ${token.marginXXS || token.marginXS}px`,
+          borderRadius: token.borderRadiusSM,
+          fontSize: token.fontSizeSM,
+          display: "inline-flex",
+          alignItems: "center",
+          padding: `0 ${token.paddingXXS}px`,
+          minWidth: 0,
+          maxWidth: "100%",
+          overflow: "hidden",
+          width: "100%"
+        }
+      },
+      /* @__PURE__ */ import_react.default.createElement(
+        "span",
+        {
+          style: {
+            minWidth: 0,
+            width: "100%",
+            overflow: "hidden",
+            whiteSpace: "nowrap",
+            display: "inline-block"
+          }
+        },
+        fullText
+      )
+    ));
+  }, "customTagRender");
+  return /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Select,
+    {
+      className: (0, import_css.cx)("variable", shrinkableOverflowItem, className),
+      style: {
+        // Fill the available width of the surrounding layout.
+        // A fixed maxWidth here caused the input to shrink when a variable is selected.
+        width: "100%",
+        minWidth: 0,
+        flex: "1 1 auto",
+        ...style
+      },
+      value: displayedValue ? [displayedValue] : [],
+      mode: "tags",
+      open: false,
+      allowClear: !!onClear,
+      onClear,
+      disabled: !onClear,
+      variant: "outlined",
+      suffixIcon: null,
+      tagRender: customTagRender,
+      onClick: (e) => e.preventDefault(),
+      removeIcon: null
+    }
+  );
+}, "VariableTagComponent");
+const VariableTag = import_react.default.memo(VariableTagComponent);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VariableTag
+});

package/lib/components/variables/VariableTrigger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import React from 'react';
+import { RenderElementProps } from 'slate-react';
+import type { VariableTriggerElement } from './types';
+import type { MetaTreeNode } from '../../flowContext';
+interface VariableTriggerProps extends RenderElementProps {
+    element: VariableTriggerElement;
+    metaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>);
+    onVariableSelect?: (triggerId: string, value: string, item: MetaTreeNode) => void;
+    onTriggerClose?: (triggerId: string) => void;
+}
+export declare const VariableTrigger: React.FC<VariableTriggerProps>;
+export {};

package/lib/components/variables/VariableTrigger.js

@@ -0,0 +1,136 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var VariableTrigger_exports = {};
+__export(VariableTrigger_exports, {
+  VariableTrigger: () => VariableTrigger
+});
+module.exports = __toCommonJS(VariableTrigger_exports);
+var import_react = __toESM(require("react"));
+var import_antd = require("antd");
+var import_FlowContextSelector = require("../FlowContextSelector");
+const VariableTrigger = /* @__PURE__ */ __name(({
+  attributes,
+  children,
+  element,
+  metaTree,
+  onVariableSelect,
+  onTriggerClose
+}) => {
+  const [open, setOpen] = (0, import_react.useState)(true);
+  const handleVariableSelect = /* @__PURE__ */ __name((value, item) => {
+    if (item) {
+      setOpen(false);
+      onVariableSelect == null ? void 0 : onVariableSelect(element.triggerId, value, item);
+    }
+  }, "handleVariableSelect");
+  const handleOpenChange = /* @__PURE__ */ __name((visible) => {
+    if (!visible) {
+      setOpen(false);
+      onTriggerClose == null ? void 0 : onTriggerClose(element.triggerId);
+    }
+  }, "handleOpenChange");
+  return /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Popover,
+    {
+      content: /* @__PURE__ */ import_react.default.createElement("div", { style: { width: "fit-content" } }, /* @__PURE__ */ import_react.default.createElement("style", null, `
+              .variable-trigger-popover {
+                width: fit-content !important;
+              }
+              .variable-trigger-popover .ant-popover-content,
+              .variable-trigger-popover .ant-popover-inner {
+                background: transparent !important;
+                box-shadow: none !important;
+                border: none !important;
+                padding: 0 !important;
+                width: fit-content !important;
+              }
+              .variable-trigger-popover .ant-popover-arrow { display: none !important; }
+              .variable-trigger-popover .ant-cascader-menu { 
+                max-height: 50vh !important; 
+                overflow-y: auto !important; 
+                width: auto !important; 
+                min-width: auto !important; 
+              }
+              .variable-trigger-popover .ant-cascader-menus { width: fit-content !important; }
+            `), /* @__PURE__ */ import_react.default.createElement(
+        import_FlowContextSelector.FlowContextSelector,
+        {
+          metaTree,
+          onChange: handleVariableSelect,
+          open: true,
+          showSearch: false,
+          dropdownStyle: { boxShadow: "none", border: "none" },
+          style: { display: "none" }
+        },
+        /* @__PURE__ */ import_react.default.createElement("div", null)
+      )),
+      open,
+      trigger: "click",
+      placement: "bottomLeft",
+      onOpenChange: handleOpenChange,
+      overlayClassName: "variable-trigger-popover",
+      destroyTooltipOnHide: true
+    },
+    /* @__PURE__ */ import_react.default.createElement(
+      "span",
+      {
+        ...attributes,
+        contentEditable: false,
+        style: {
+          backgroundColor: "#e6f7ff",
+          border: "1px dashed #1890ff",
+          borderRadius: 4,
+          padding: "1px 4px",
+          margin: "0 1px",
+          cursor: "pointer",
+          display: "inline-block",
+          fontSize: "12px",
+          color: "#1890ff",
+          userSelect: "none"
+        },
+        "data-slate-void": true
+      },
+      "{{}}",
+      /* @__PURE__ */ import_react.default.createElement("span", { style: { display: "none" } }, children)
+    )
+  );
+}, "VariableTrigger");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VariableTrigger
+});

package/lib/components/variables/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+export { VariableInput } from './VariableInput';
+export { SlateVariableEditor } from './SlateVariableEditor';
+export { VariableTag } from './VariableTag';
+export { InlineVariableTag } from './InlineVariableTag';
+export { useResolvedMetaTree } from './useResolvedMetaTree';
+export * from './types';
+export * from './utils';

package/lib/components/variables/index.js

@@ -0,0 +1,53 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var variables_exports = {};
+__export(variables_exports, {
+  InlineVariableTag: () => import_InlineVariableTag.InlineVariableTag,
+  SlateVariableEditor: () => import_SlateVariableEditor.SlateVariableEditor,
+  VariableInput: () => import_VariableInput.VariableInput,
+  VariableTag: () => import_VariableTag.VariableTag,
+  useResolvedMetaTree: () => import_useResolvedMetaTree.useResolvedMetaTree
+});
+module.exports = __toCommonJS(variables_exports);
+var import_VariableInput = require("./VariableInput");
+var import_SlateVariableEditor = require("./SlateVariableEditor");
+var import_VariableTag = require("./VariableTag");
+var import_InlineVariableTag = require("./InlineVariableTag");
+var import_useResolvedMetaTree = require("./useResolvedMetaTree");
+__reExport(variables_exports, require("./types"), module.exports);
+__reExport(variables_exports, require("./utils"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InlineVariableTag,
+  SlateVariableEditor,
+  VariableInput,
+  VariableTag,
+  useResolvedMetaTree,
+  ...require("./types"),
+  ...require("./utils")
+});

package/lib/components/variables/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import React from 'react';
+import { CascaderProps } from 'antd';
+import type { MetaTreeNode } from '../../flowContext';
+export interface FlowContextSelectorProps extends Omit<CascaderProps<ContextSelectorItem>, 'value' | 'onChange' | 'options' | 'children' | 'multiple'> {
+    value?: string;
+    onChange?: (value: string, metaTreeNode?: MetaTreeNode) => void;
+    children?: CascaderProps<ContextSelectorItem>['children'];
+    metaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>);
+    parseValueToPath?: (value: string) => string[] | undefined;
+    formatPathToValue?: (item: MetaTreeNode) => string;
+    open?: boolean;
+    onlyLeafSelectable?: boolean;
+}
+export interface ContextSelectorItem {
+    label: React.ReactNode;
+    value: string;
+    isLeaf?: boolean;
+    children?: ContextSelectorItem[];
+    loading?: boolean;
+    meta?: MetaTreeNode;
+    paths: string[];
+    disabled?: boolean;
+}
+export interface Converters {
+    /**
+     * 根据选中的上下文选择器项目，返回一个用于渲染该值的 React 组件类型。
+     * 如果返回 null 或 undefined，则会使用默认的渲染组件。
+     * @param metaTreeNode 选中的 MetaTreeNode 对象，或者在未选择任何变量时为 null。
+     * @returns React.ComponentType<{ value: any; onChange: (value: any) => void; }> | null
+     */
+    renderInputComponent?: (metaTreeNode: MetaTreeNode | null) => React.ComponentType<any> | null;
+    /**
+     * 将一个外部 value 转换成 FlowContextSelector 需要的路径数组。
+     * @param value 外部传入的值。
+     * @returns string[] | undefined
+     */
+    resolvePathFromValue?: (value: any) => string[] | undefined;
+    /**
+     * 当一个上下文节点被选中后，将其信息转换成最终的外部 value。
+     * @param metaTreeNode 选中的 MetaTreeNode 对象。
+     * @returns any
+     */
+    resolveValueFromPath?: (metaTreeNode: MetaTreeNode) => any;
+}
+export interface VariableInputProps {
+    value?: any;
+    onChange?: (value: any, contextMeta?: MetaTreeNode) => void;
+    converters?: Converters;
+    showValueComponent?: boolean;
+    metaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>);
+    onlyLeafSelectable?: boolean;
+    /**
+     * 清空（点击 Tag 的 clear、或 Input 的 allowClear）时要设置的值。
+     * 默认行为为 null；可设置为 '' 等，以便清空后默认切换为“常量-空字符串”。
+     */
+    clearValue?: any;
+    [key: string]: any;
+}
+export interface VariableTagProps {
+    value?: string;
+    onClear?: () => void;
+    className?: string;
+    style?: React.CSSProperties;
+    metaTreeNode?: MetaTreeNode | null;
+    metaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>);
+}
+export interface VariableTriggerElement {
+    type: 'variable-trigger';
+    triggerId: string;
+    children: [{
+        text: '';
+    }];
+}
+export interface VariableElement {
+    type: 'variable';
+    value: string;
+    meta?: MetaTreeNode;
+    children: [{
+        text: '';
+    }];
+}
+export interface ParagraphElement {
+    type: 'paragraph';
+    children: any[];
+}

package/lib/components/variables/types.js

@@ -0,0 +1,24 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/lib/components/variables/useResolvedMetaTree.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { MetaTreeNode } from '../../flowContext';
+export interface UseResolvedMetaTreeResult {
+    resolvedMetaTree: MetaTreeNode[] | undefined;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * 通用 hook 用于处理异步/同步 metaTree
+ * 统一处理 metaTree 为函数（同步/异步）或数组的情况
+ */
+export declare const useResolvedMetaTree: (metaTree?: MetaTreeNode[] | (() => MetaTreeNode[] | Promise<MetaTreeNode[]>)) => UseResolvedMetaTreeResult;

package/lib/components/variables/useResolvedMetaTree.js

@@ -0,0 +1,91 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useResolvedMetaTree_exports = {};
+__export(useResolvedMetaTree_exports, {
+  useResolvedMetaTree: () => useResolvedMetaTree
+});
+module.exports = __toCommonJS(useResolvedMetaTree_exports);
+var import_react = __toESM(require("react"));
+const useResolvedMetaTree = /* @__PURE__ */ __name((metaTree) => {
+  const [resolvedMetaTree, setResolvedMetaTree] = import_react.default.useState();
+  const [loading, setLoading] = import_react.default.useState(false);
+  const [error, setError] = import_react.default.useState(null);
+  import_react.default.useEffect(() => {
+    const resolveMetaTree = /* @__PURE__ */ __name(async () => {
+      if (!metaTree) {
+        setResolvedMetaTree(void 0);
+        setLoading(false);
+        setError(null);
+        return;
+      }
+      if (Array.isArray(metaTree)) {
+        setResolvedMetaTree(metaTree);
+        setLoading(false);
+        setError(null);
+        return;
+      }
+      if (typeof metaTree === "function") {
+        setLoading(true);
+        setError(null);
+        try {
+          let result = await metaTree();
+          if (typeof result === "function") {
+            result = await result();
+          }
+          setResolvedMetaTree(result);
+        } catch (err) {
+          console.warn("Failed to resolve metaTree function:", err);
+          setError(err instanceof Error ? err : new Error(String(err)));
+          setResolvedMetaTree(void 0);
+        } finally {
+          setLoading(false);
+        }
+      }
+    }, "resolveMetaTree");
+    resolveMetaTree();
+  }, [metaTree]);
+  return {
+    resolvedMetaTree,
+    loading,
+    error
+  };
+}, "useResolvedMetaTree");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useResolvedMetaTree
+});

package/lib/components/variables/utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { MetaTreeNode } from '../../flowContext';
+import type { ContextSelectorItem, Converters } from './types';
+export declare const parseValueToPath: (value: string) => string[] | undefined;
+export declare const formatPathToValue: (item: MetaTreeNode) => string;
+export declare const loadMetaTreeChildren: (metaNode: MetaTreeNode) => Promise<MetaTreeNode[]>;
+export declare const searchInLoadedNodes: (options: ContextSelectorItem[], searchText: string, parentPaths?: string[]) => ContextSelectorItem[];
+export declare const buildContextSelectorItems: (metaTree: MetaTreeNode[]) => ContextSelectorItem[];
+/**
+ * 预加载：根据路径逐级加载 ContextSelectorItem 的 children，保证打开时已展开对应层级。
+ */
+export declare const preloadContextSelectorPath: (options: ContextSelectorItem[] | undefined, pathSegments: (string | number)[], triggerUpdate?: () => void) => Promise<void>;
+export declare const isVariableValue: (value: any) => boolean;
+export declare const createDefaultConverters: () => Converters;
+export declare const createFinalConverters: (propConverters?: Converters) => Converters;