@ant-design/pro-components 3.1.12-0 → 3.1.13-0

package/lib/field/components/TreeSelect/FieldTreeSelectEdit.js

@@ -0,0 +1,93 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FieldTreeSelectEdit = FieldTreeSelectEdit;
+var _antd = require("antd");
+var _clsx = require("clsx");
+var _react = _interopRequireDefault(require("react"));
+var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * TreeSelect 编辑分支：仅应在 `mode === 'edit'` 时使用（非 `update`）。
+ */
+function FieldTreeSelectEdit({
+  text,
+  mode,
+  formItemRender,
+  fieldProps,
+  open,
+  setOpen,
+  treeSelectRef,
+  intl,
+  loading,
+  options,
+  fetchData,
+  fetchDataOnSearch,
+  hasRequest,
+  showSearch,
+  showSearchConfig,
+  searchValue,
+  setSearchValue,
+  autoClearSearchValue,
+  onClear,
+  treeSelectOnChange,
+  onBlur,
+  layoutClassName
+}) {
+  let dom = /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Spin, {
+    spinning: loading,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.TreeSelect, {
+      open: open,
+      onOpenChange: isOpen => {
+        fieldProps?.onOpenChange?.(isOpen);
+        setOpen(isOpen);
+      },
+      ref: treeSelectRef,
+      popupMatchSelectWidth: true,
+      placeholder: intl.getMessage('tableForm.selectPlaceholder', '请选择'),
+      ...fieldProps,
+      treeData: options,
+      showSearch: showSearch ? {
+        ...showSearchConfig,
+        searchValue: searchValue,
+        autoClearSearchValue: autoClearSearchValue,
+        onSearch: value => {
+          if (fetchDataOnSearch && hasRequest) {
+            fetchData(value);
+          }
+          setSearchValue(value);
+        }
+      } : showSearch,
+      style: {
+        minWidth: 60,
+        ...fieldProps.style
+      },
+      allowClear: fieldProps.allowClear !== false,
+      onClear: () => {
+        onClear?.();
+        fetchData(undefined);
+        if (showSearch) {
+          setSearchValue(undefined);
+        }
+      },
+      onChange: treeSelectOnChange,
+      onBlur: event => {
+        setSearchValue(undefined);
+        fetchData(undefined);
+        onBlur?.(event);
+      },
+      className: (0, _clsx.clsx)(fieldProps?.className, layoutClassName)
+    })
+  });
+  if (formItemRender) {
+    dom = formItemRender(text, {
+      mode,
+      ...fieldProps,
+      options,
+      loading
+    }, dom);
+  }
+  return dom;
+}

package/lib/field/components/TreeSelect/FieldTreeSelectLightEdit.d.ts

@@ -0,0 +1,35 @@
+import type { GetRef, TreeSelectProps } from 'antd';
+import { TreeSelect } from 'antd';
+import React from 'react';
+import type { IntlType, ProFieldFCRenderProps } from '../../../provider';
+import { FieldLabel } from '../../../utils';
+import type { TreeSelectFieldProps } from './types';
+type TreeSelectShowSearchObject = Exclude<TreeSelectProps['showSearch'], boolean | undefined>;
+export interface FieldTreeSelectLightEditProps {
+    text: string;
+    mode: 'edit';
+    formItemRender?: (text: any, props: ProFieldFCRenderProps, dom: React.JSX.Element) => React.JSX.Element;
+    label?: React.ReactNode;
+    variant?: React.ComponentProps<typeof FieldLabel>['variant'];
+    fieldProps: TreeSelectFieldProps;
+    open: boolean;
+    setOpen: React.Dispatch<React.SetStateAction<boolean>>;
+    treeSelectRef: React.RefObject<GetRef<typeof TreeSelect>>;
+    intl: IntlType;
+    loading: boolean;
+    options: NonNullable<TreeSelectProps['treeData']>;
+    fetchData: (keyWord?: string) => void;
+    fetchDataOnSearch?: boolean;
+    hasRequest: boolean;
+    showSearch: TreeSelectProps['showSearch'];
+    showSearchConfig: TreeSelectShowSearchObject | Record<string, never>;
+    searchValue: string | undefined;
+    setSearchValue: (updater: string | undefined | ((prev: string | undefined) => string | undefined)) => void;
+    autoClearSearchValue: boolean | undefined;
+    onClear?: () => void;
+    treeSelectOnChange: TreeSelectProps<any>['onChange'];
+    onBlur?: TreeSelectProps['onBlur'];
+    layoutClassName: string;
+}
+export declare function FieldTreeSelectLightEdit({ text, mode, formItemRender, label, variant, fieldProps, open, setOpen, treeSelectRef, intl, loading, options, fetchData, fetchDataOnSearch, hasRequest, showSearch, showSearchConfig, searchValue, setSearchValue, autoClearSearchValue, onClear, treeSelectOnChange, onBlur, layoutClassName, }: FieldTreeSelectLightEditProps): React.JSX.Element;
+export {};

package/lib/field/components/TreeSelect/FieldTreeSelectLightEdit.js

@@ -0,0 +1,126 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FieldTreeSelectLightEdit = FieldTreeSelectLightEdit;
+var _antd = require("antd");
+var _clsx = require("clsx");
+var _react = _interopRequireDefault(require("react"));
+var _utils = require("../../../utils");
+var _jsxRuntime = require("react/jsx-runtime");
+function FieldTreeSelectLightEdit({
+  text,
+  mode,
+  formItemRender,
+  label,
+  variant,
+  fieldProps,
+  open,
+  setOpen,
+  treeSelectRef,
+  intl,
+  loading,
+  options,
+  fetchData,
+  fetchDataOnSearch,
+  hasRequest,
+  showSearch,
+  showSearchConfig,
+  searchValue,
+  setSearchValue,
+  autoClearSearchValue,
+  onClear,
+  treeSelectOnChange,
+  onBlur,
+  layoutClassName
+}) {
+  const valuesLength = Array.isArray(fieldProps?.value) ? fieldProps?.value?.length : 0;
+  const handleOpenChange = isOpen => {
+    setOpen(isOpen);
+    fieldProps?.onOpenChange?.(isOpen);
+  };
+  let dom = /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Spin, {
+    spinning: loading,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.TreeSelect, {
+      ...fieldProps,
+      open: open,
+      onOpenChange: handleOpenChange,
+      ref: treeSelectRef,
+      popupMatchSelectWidth: false,
+      placeholder: intl.getMessage('tableForm.selectPlaceholder', '请选择'),
+      tagRender: item => {
+        if (valuesLength < 2) return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+          children: item.label
+        });
+        const itemIndex = fieldProps?.value?.findIndex(v => v === item.value || v.value === item.value);
+        return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+          children: [item.label, " ", itemIndex < valuesLength - 1 ? ',' : '']
+        });
+      },
+      treeData: options,
+      showSearch: showSearch ? {
+        ...showSearchConfig,
+        searchValue: searchValue,
+        autoClearSearchValue: autoClearSearchValue,
+        onSearch: value => {
+          if (fetchDataOnSearch && hasRequest) {
+            fetchData(value);
+          }
+          setSearchValue(value);
+        }
+      } : showSearch,
+      style: {
+        minWidth: 60,
+        ...fieldProps.style
+      },
+      allowClear: fieldProps.allowClear !== false,
+      onClear: () => {
+        onClear?.();
+        fetchData(undefined);
+        if (showSearch) {
+          setSearchValue(undefined);
+        }
+      },
+      onChange: treeSelectOnChange,
+      onBlur: event => {
+        setSearchValue(undefined);
+        fetchData(undefined);
+        onBlur?.(event);
+      },
+      className: (0, _clsx.clsx)(fieldProps?.className, layoutClassName)
+    })
+  });
+  if (formItemRender) {
+    dom = formItemRender(text, {
+      mode,
+      ...fieldProps,
+      options,
+      loading
+    }, dom);
+  }
+  const {
+    disabled,
+    placeholder
+  } = fieldProps;
+  const notEmpty = !!fieldProps.value && fieldProps.value?.length !== 0;
+  const handleLabelClick = () => {
+    if (disabled) return;
+    setOpen(true);
+    fieldProps?.onOpenChange?.(true);
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_utils.FieldLabel, {
+    label: label,
+    disabled: disabled,
+    placeholder: placeholder,
+    onClick: handleLabelClick,
+    variant: variant,
+    value: notEmpty || open ? dom : null,
+    style: notEmpty ? {
+      paddingInlineEnd: 0
+    } : undefined,
+    allowClear: false,
+    downIcon: false
+  });
+}

package/lib/field/components/TreeSelect/FieldTreeSelectRead.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+import type { ProFieldFC } from '../../types';
+import type { FieldSelectProps } from '../Select';
+export declare function FieldTreeSelectRead(props: Parameters<ProFieldFC<{} & FieldSelectProps>>[0] & {
+    optionsValueEnum: Map<any, any> | undefined;
+    options: any[];
+}): import("react").JSX.Element;

package/lib/field/components/TreeSelect/FieldTreeSelectRead.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FieldTreeSelectRead = FieldTreeSelectRead;
+var _utils = require("../../../utils");
+var _jsxRuntime = require("react/jsx-runtime");
+function FieldTreeSelectRead(props) {
+  const {
+    mode,
+    render,
+    fieldProps,
+    optionsValueEnum,
+    options,
+    ...rest
+  } = props;
+  const dom = /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+    children: (0, _utils.proFieldParsingText)(rest.text, (0, _utils.objectToMap)(rest.valueEnum || optionsValueEnum))
+  });
+  if (render) {
+    return render(rest.text, {
+      mode,
+      ...fieldProps,
+      treeData: options
+    }, dom) ?? null;
+  }
+  return dom;
+}

package/lib/field/components/TreeSelect/index.d.ts

@@ -1,22 +1,15 @@
-import type { TreeSelectProps } from 'antd';
 import React from 'react';
-export type TreeSelectFieldProps = TreeSelectProps & {
-    /**
-     * 当搜索关键词发生变化时是否请求远程数据
-     *
-     * @default true
-     */
-    fetchDataOnSearch?: boolean;
-};
+import type { TreeSelectFieldProps } from './types';
+export type { TreeSelectFieldProps };
 declare const _default: React.ForwardRefExoticComponent<import("../../../provider").BaseProFieldFC & import("../../../provider").ProRenderFieldPropsType & {
     text: string;
-    valueEnum?: import("src/utils/typing").ProFieldValueEnumType | undefined;
+    valueEnum?: import("src/utils").ProFieldValueEnumType | undefined;
     debounceTime?: number | undefined;
-    request?: import("src/utils/typing").ProFieldRequestData | undefined;
+    request?: import("src/utils").ProFieldRequestData | undefined;
     params?: any;
     fieldProps?: any;
-    variant?: "outlined" | "filled" | "borderless" | undefined;
+    variant?: "outlined" | "borderless" | "filled" | undefined;
     id?: string | undefined;
     defaultKeyWords?: string | undefined;
-} & import("../../PureProField").ProFieldLightProps & React.RefAttributes<any>>;
+} & import("../../types").ProFieldLightProps & React.RefAttributes<any>>;
 export default _default;

package/lib/field/components/TreeSelect/index.js

@@ -7,11 +7,13 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _util = require("@rc-component/util");
 var _antd = require("antd");
-var _clsx = require("clsx");
 var _react = _interopRequireWildcard(require("react"));
 var _provider = require("../../../provider");
-var _utils = require("../../../utils");
+var _fieldMode = require("../../internal/fieldMode");
 var _Select = require("../Select");
+var _FieldTreeSelectEdit = require("./FieldTreeSelectEdit");
+var _FieldTreeSelectLightEdit = require("./FieldTreeSelectLightEdit");
+var _FieldTreeSelectRead = require("./FieldTreeSelectRead");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Tree select
@@ -77,7 +79,7 @@ const FieldTreeSelect = ({
     fetchData: keyWord => fetchData(keyWord)
   }));
   const optionsValueEnum = (0, _react.useMemo)(() => {
-    if (mode !== 'read') return;
+    if (!(0, _fieldMode.isProFieldReadMode)(mode)) return;
     /**
      * Support TreeSelect fieldNames
      * @see https://ant.design/components/tree-select-cn
@@ -111,111 +113,55 @@ const FieldTreeSelect = ({
     }
     propsOnChange?.(value, optionList, extra);
   };
-  if (mode === 'read') {
-    const dom = /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
-      children: (0, _utils.proFieldParsingText)(rest.text, (0, _utils.objectToMap)(rest.valueEnum || optionsValueEnum))
+  if ((0, _fieldMode.isProFieldReadMode)(mode)) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldTreeSelectRead.FieldTreeSelectRead, {
+      formItemRender: formItemRender,
+      mode: mode,
+      light: light,
+      label: label,
+      render: render,
+      variant: propsVariant,
+      optionsValueEnum: optionsValueEnum,
+      options: options,
+      ...rest
     });
-    if (render) {
-      return render(rest.text, {
-        mode,
-        ...fieldProps,
-        treeData: options
-      }, dom) ?? null;
-    }
-    return dom;
   }
-  if (mode === 'edit') {
-    const valuesLength = Array.isArray(fieldProps?.value) ? fieldProps?.value?.length : 0;
-    let dom = /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Spin, {
-      spinning: loading,
-      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.TreeSelect, {
-        open: open,
-        onOpenChange: isOpen => {
-          fieldProps?.onOpenChange?.(isOpen);
-          setOpen(isOpen);
-        },
-        ref: treeSelectRef,
-        popupMatchSelectWidth: !light,
-        placeholder: intl.getMessage('tableForm.selectPlaceholder', '请选择'),
-        tagRender: light ? item => {
-          if (valuesLength < 2) return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
-            children: item.label
-          });
-          /**
-           * 性能不好，等我给 antd 提个issue
-           */
-          const itemIndex = fieldProps?.value?.findIndex(v => v === item.value || v.value === item.value);
-          return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
-            children: [item.label, " ", itemIndex < valuesLength - 1 ? ',' : '']
-          });
-        } : undefined,
-        ...fieldProps,
-        treeData: options,
-        showSearch: showSearch ? {
-          ...showSearchConfig,
-          searchValue: searchValue,
-          autoClearSearchValue: autoClearSearchValue,
-          onSearch: value => {
-            // fix 不支持请求的情况下不刷新options
-            if (fetchDataOnSearch && rest?.request) {
-              fetchData(value);
-            }
-            setSearchValue(value);
-          }
-        } : showSearch,
-        style: {
-          minWidth: 60,
-          ...fieldProps.style
-        },
-        allowClear: fieldProps.allowClear !== false,
-        onClear: () => {
-          onClear?.();
-          fetchData(undefined);
-          if (showSearch) {
-            setSearchValue(undefined);
-          }
-        },
-        onChange: onChange,
-        onBlur: event => {
-          setSearchValue(undefined);
-          fetchData(undefined);
-          onBlur?.(event);
-        },
-        className: (0, _clsx.clsx)(fieldProps?.className, layoutClassName)
-      })
-    });
-    if (formItemRender) {
-      dom = formItemRender(rest.text, {
-        mode,
-        ...fieldProps,
-        options,
-        loading
-      }, dom) ?? null;
-    }
+  if ((0, _fieldMode.isProFieldEditOnlyMode)(mode)) {
+    const editProps = {
+      ...rest,
+      text: rest.text,
+      mode: 'edit',
+      formItemRender,
+      label,
+      variant,
+      fieldProps,
+      open,
+      setOpen,
+      treeSelectRef,
+      intl,
+      loading,
+      options: options,
+      fetchData,
+      fetchDataOnSearch,
+      hasRequest: !!rest.request,
+      showSearch,
+      showSearchConfig,
+      searchValue,
+      setSearchValue,
+      autoClearSearchValue,
+      onClear,
+      treeSelectOnChange: onChange,
+      onBlur,
+      layoutClassName
+    };
     if (light) {
-      const {
-        disabled,
-        placeholder
-      } = fieldProps;
-      const notEmpty = !!fieldProps.value && fieldProps.value?.length !== 0;
-      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_utils.FieldLabel, {
-        label: label,
-        disabled: disabled,
-        placeholder: placeholder,
-        onClick: () => {
-          setOpen(true);
-          fieldProps?.onOpenChange?.(true);
-        },
-        variant: variant,
-        value: notEmpty || open ? dom : null,
-        style: notEmpty ? {
-          paddingInlineEnd: 0
-        } : undefined,
-        allowClear: false,
-        downIcon: false
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldTreeSelectLightEdit.FieldTreeSelectLightEdit, {
+        ...editProps
       });
     }
-    return dom;
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldTreeSelectEdit.FieldTreeSelectEdit, {
+      ...editProps
+    });
   }
   return null;
 };

package/lib/field/components/TreeSelect/types.d.ts

@@ -0,0 +1,9 @@
+import type { TreeSelectProps } from 'antd';
+export type TreeSelectFieldProps = TreeSelectProps & {
+    /**
+     * 当搜索关键词发生变化时是否请求远程数据
+     *
+     * @default true
+     */
+    fetchDataOnSearch?: boolean;
+};

package/lib/field/components/TreeSelect/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/field/initDayjs.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/field/initDayjs.js

@@ -0,0 +1,16 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _advancedFormat = _interopRequireDefault(require("dayjs/plugin/advancedFormat"));
+var _isoWeek = _interopRequireDefault(require("dayjs/plugin/isoWeek"));
+var _localeData = _interopRequireDefault(require("dayjs/plugin/localeData"));
+var _weekday = _interopRequireDefault(require("dayjs/plugin/weekday"));
+var _weekOfYear = _interopRequireDefault(require("dayjs/plugin/weekOfYear"));
+var _weekYear = _interopRequireDefault(require("dayjs/plugin/weekYear"));
+_dayjs.default.extend(_localeData.default);
+_dayjs.default.extend(_advancedFormat.default);
+_dayjs.default.extend(_isoWeek.default);
+_dayjs.default.extend(_weekOfYear.default);
+_dayjs.default.extend(_weekYear.default);
+_dayjs.default.extend(_weekday.default);

package/lib/field/internal/ProFieldLightWrapper.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { ProFieldLightProps } from '../types';
+/**
+ * Light 筛选专用：区分 label 点击与 clear，向子组件注入 `labelTrigger` / `lightLabel`。
+ * 与只读（read）/ 编辑（edit）无关；read/edit 分支请用 `fieldMode.ts` 中的工具函数。
+ */
+declare function ProFieldLightWrapper<T extends ProFieldLightProps>(props: T & {
+    children: React.ReactNode;
+    isLight?: boolean;
+}): React.JSX.Element;
+/**
+ * 非 light 时直接返回子元素；light 时包一层 {@link ProFieldLightWrapper}。
+ * 用于在需要处包一层 light 行为，避免重复的 JSX 包装。
+ */
+export declare function wrapProFieldLight(isLight: boolean | undefined, child: React.ReactElement): React.ReactNode;
+export default ProFieldLightWrapper;

package/lib/field/{FieldHOC/index.js → internal/ProFieldLightWrapper.js}

@@ -5,15 +5,17 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
+exports.wrapProFieldLight = wrapProFieldLight;
 var _react = _interopRequireWildcard(require("react"));
 var _jsxRuntime = require("react/jsx-runtime");
-function FieldHOC(props) {
+/**
+ * Light 筛选专用：区分 label 点击与 clear，向子组件注入 `labelTrigger` / `lightLabel`。
+ * 与只读（read）/ 编辑（edit）无关；read/edit 分支请用 `fieldMode.ts` 中的工具函数。
+ */
+function ProFieldLightWrapper(props) {
   const [labelTrigger, setLabelTrigger] = (0, _react.useState)(false);
   const lightLabel = (0, _react.useRef)(null);
-
-  // 是label且不是label里面的clear图标触发事件
   const isTriggeredByLabel = (0, _react.useCallback)(e => {
-    // 两条语句结果分别命名，可读性好点
     const isLabelMouseDown = lightLabel.current?.labelRef?.current?.contains(e.target);
     const isClearMouseDown = lightLabel.current?.clearRef?.current?.contains(e.target);
     return isLabelMouseDown && !isClearMouseDown;
@@ -40,4 +42,18 @@ function FieldHOC(props) {
     children: props.children
   });
 }
-var _default = exports.default = FieldHOC;
+
+/**
+ * 非 light 时直接返回子元素；light 时包一层 {@link ProFieldLightWrapper}。
+ * 用于在需要处包一层 light 行为，避免重复的 JSX 包装。
+ */
+function wrapProFieldLight(isLight, child) {
+  if (!isLight) {
+    return child;
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(ProFieldLightWrapper, {
+    isLight: true,
+    children: child
+  });
+}
+var _default = exports.default = ProFieldLightWrapper;

package/lib/field/internal/fieldMode.d.ts

@@ -0,0 +1,14 @@
+import type { ProFieldFCMode } from '../../provider';
+/**
+ * Shared mode checks for Field* components (read vs edit branches).
+ * Keep semantics aligned with existing code: some components only treat `edit`
+ * as interactive (not `update`); do not collapse those into edit-or-update.
+ *
+ * Light-filter UI (`light` / `isLight`) is separate: use `wrapProFieldLight` in
+ * `./ProFieldLightWrapper`, not these helpers.
+ */
+export declare function isProFieldReadMode(mode: ProFieldFCMode | undefined): boolean;
+/** `edit` or `update` — most Field* interactive branches. */
+export declare function isProFieldEditOrUpdateMode(mode: ProFieldFCMode | undefined): boolean;
+/** Strict `edit` only — used where `update` previously fell through (e.g. Radio). */
+export declare function isProFieldEditOnlyMode(mode: ProFieldFCMode | undefined): boolean;

package/lib/field/internal/fieldMode.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isProFieldEditOnlyMode = isProFieldEditOnlyMode;
+exports.isProFieldEditOrUpdateMode = isProFieldEditOrUpdateMode;
+exports.isProFieldReadMode = isProFieldReadMode;
+/**
+ * Shared mode checks for Field* components (read vs edit branches).
+ * Keep semantics aligned with existing code: some components only treat `edit`
+ * as interactive (not `update`); do not collapse those into edit-or-update.
+ *
+ * Light-filter UI (`light` / `isLight`) is separate: use `wrapProFieldLight` in
+ * `./ProFieldLightWrapper`, not these helpers.
+ */
+function isProFieldReadMode(mode) {
+  return mode === 'read';
+}
+
+/** `edit` or `update` — most Field* interactive branches. */
+function isProFieldEditOrUpdateMode(mode) {
+  return mode === 'edit' || mode === 'update';
+}
+
+/** Strict `edit` only — used where `update` previously fell through (e.g. Radio). */
+function isProFieldEditOnlyMode(mode) {
+  return mode === 'edit';
+}

package/lib/field/types.d.ts

@@ -0,0 +1,30 @@
+import type React from 'react';
+import type { BaseProFieldFC, ProFieldFCRenderProps, ProRenderFieldPropsType } from '../provider';
+import type { ProFieldRequestData, ProFieldTextType, ProFieldValueTypeInput } from '../utils';
+export type ProFieldEmptyText = string | false;
+/** 默认的 Field 需要实现的功能 */
+export type ProFieldFC<T = {}> = React.ForwardRefRenderFunction<any, BaseProFieldFC & ProRenderFieldPropsType & T>;
+/** 轻量筛选的 field 属性 */
+export type ProFieldLightProps = {
+    lightLabel?: React.RefObject<{
+        labelRef: React.RefObject<HTMLElement>;
+        clearRef: React.RefObject<HTMLElement>;
+    }>;
+    labelTrigger?: boolean;
+};
+/** Value type by function */
+export type ProFieldValueTypeFunction<T> = (item: T) => ProFieldValueTypeInput;
+/** 传给各模式渲染函数（defaultRenderRead/Edit、pureRenderRead/Edit 等）的合并 props */
+export type ProFieldRenderProps = Omit<ProFieldFCRenderProps, 'text' | 'placeholder'> & ProRenderFieldPropsType & {
+    /** 从服务器读取选项 */
+    request?: ProFieldRequestData;
+    emptyText?: React.ReactNode;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    [key: string]: any;
+};
+/** ProField / PureProField 对外 props */
+export type ProFieldPropsType = {
+    text?: ProFieldTextType;
+    valueType?: ProFieldValueTypeInput;
+} & ProFieldRenderProps;