@ant-design/pro-components 3.1.4-0 → 3.1.6-0

package/guidelines/components/pro-card.md

@@ -19,6 +19,7 @@
 - `tabs`: Configure tabs inside the card.
 - `collapsible`: Whether the card can be collapsed.
 - `ghost`: Transparent background.
+- `variant`: `'outlined'` | `'borderless'`. Card border style.
 
 **Usage Pattern**:
 
@@ -31,7 +32,7 @@ export default () => {
       title="Card Title"
       extra="More"
       split="vertical"
-      bordered
+      variant="outlined"
       headerBordered
     >
       <ProCard title="Left Details" colSpan="50%">
@@ -49,13 +50,13 @@ export default () => {
 
 ```tsx
 <ProCard gutter={16} ghost>
-  <ProCard colSpan={12} layout="center" bordered>
+  <ProCard colSpan={12} layout="center" variant="outlined">
     Col 12
   </ProCard>
-  <ProCard colSpan={6} layout="center" bordered>
+  <ProCard colSpan={6} layout="center" variant="outlined">
     Col 6
   </ProCard>
-  <ProCard colSpan={6} layout="center" bordered>
+  <ProCard colSpan={6} layout="center" variant="outlined">
     Col 6
   </ProCard>
 </ProCard>

package/lib/card/ProCard.js

@@ -8,14 +8,22 @@ exports.default = void 0;
 var _Card = _interopRequireDefault(require("./components/Card"));
 var _Divider = _interopRequireDefault(require("./components/Divider"));
 var _jsxRuntime = require("react/jsx-runtime");
-const Group = props => /*#__PURE__*/(0, _jsxRuntime.jsx)(_Card.default, {
-  styles: {
-    body: {
-      padding: 0
+const Group = props => {
+  const {
+    styles,
+    ...rest
+  } = props;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Card.default, {
+    ...rest,
+    styles: {
+      ...styles,
+      body: {
+        ...styles?.body,
+        padding: 0
+      }
     }
-  },
-  ...props
-});
+  });
+};
 
 // 当前不对底层 Card 做封装，仅挂载子组件，直接导出
 const ProCard = _Card.default;

package/lib/card/components/Card/index.js

@@ -22,6 +22,7 @@ const {
 const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
   const {
     className,
+    rootClassName,
     style,
     styles,
     title,
@@ -34,7 +35,9 @@ const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
     tooltip,
     split,
     headerBordered = false,
-    variant = 'outlined',
+    variant: customVariant,
+    cover,
+    classNames,
     boxShadow = false,
     children,
     size,
@@ -54,6 +57,16 @@ const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
     type,
     ...rest
   } = props;
+  const variant = customVariant ?? 'outlined';
+  const mergedStyles = {
+    header: styles?.header,
+    body: styles?.body,
+    root: styles?.root,
+    extra: styles?.extra,
+    title: styles?.title,
+    actions: styles?.actions,
+    cover: styles?.cover
+  };
   const {
     getPrefixCls
   } = (0, _react.useContext)(_antd.ConfigProvider.ConfigContext);
@@ -199,7 +212,7 @@ const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
     }
     return element;
   });
-  const cardCls = (0, _clsx.clsx)(`${prefixCls}`, className, hashId, {
+  const cardCls = (0, _clsx.clsx)(`${prefixCls}`, className, rootClassName, hashId, classNames?.root, {
     [`${prefixCls}-border`]: variant === 'outlined',
     [`${prefixCls}-box-shadow`]: boxShadow,
     [`${prefixCls}-contain-card`]: containProCard,
@@ -212,12 +225,12 @@ const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
     [`${prefixCls}-collapse`]: collapsed,
     [`${prefixCls}-checked`]: checked
   });
-  const bodyCls = (0, _clsx.clsx)(`${prefixCls}-body`, hashId, {
+  const bodyCls = (0, _clsx.clsx)(`${prefixCls}-body`, hashId, classNames?.body, {
     [`${prefixCls}-body-center`]: layout === 'center',
     [`${prefixCls}-body-direction-column`]: split === 'horizontal' || direction === 'column',
     [`${prefixCls}-body-wrap`]: wrap && containProCard
   });
-  const bodyStylePadding = styles?.body?.padding;
+  const bodyStylePadding = mergedStyles.body?.padding;
   const loadingDOM = /*#__PURE__*/_react.default.isValidElement(loading) ? loading : /*#__PURE__*/(0, _jsxRuntime.jsx)(_Loading.default, {
     prefix: prefixCls,
     style: bodyStylePadding === 0 || bodyStylePadding === '0px' ? {
@@ -227,12 +240,10 @@ const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
   const handleCollapsibleIconClick = (0, _react.useCallback)(() => {
     if (collapsible === 'icon') setCollapsed(prev => !prev);
   }, [collapsible, setCollapsed]);
-
-  // 非受控情况下展示
-  const collapsibleButton = collapsible && controlCollapsed === undefined && (collapsibleIconRender ? /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+  const collapsibleButton = collapsible && (collapsibleIconRender ? /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
     role: "button",
     tabIndex: collapsible === 'icon' ? 0 : undefined,
-    className: `${prefixCls}-collapsible-icon ${hashId}`.trim(),
+    className: (0, _clsx.clsx)(`${prefixCls}-collapsible-icon`, hashId),
     onClick: collapsible === 'icon' ? handleCollapsibleIconClick : undefined,
     onKeyDown: collapsible === 'icon' ? e => {
       if (e.key === 'Enter' || e.key === ' ') {
@@ -246,11 +257,21 @@ const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
   }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.RightOutlined, {
     onClick: handleCollapsibleIconClick,
     rotate: !collapsed ? 90 : undefined,
-    className: `${prefixCls}-collapsible-icon ${hashId}`.trim()
+    className: (0, _clsx.clsx)(`${prefixCls}-collapsible-icon`, hashId)
   }));
+  const headerCls = (0, _clsx.clsx)(`${prefixCls}-header`, hashId, classNames?.header, {
+    [`${prefixCls}-header-border`]: headerBordered || type === 'inner',
+    [`${prefixCls}-header-collapsible`]: collapsibleButton
+  });
+  const titleCls = (0, _clsx.clsx)(`${prefixCls}-title`, hashId, classNames?.title);
+  const extraCls = (0, _clsx.clsx)(`${prefixCls}-extra`, hashId, classNames?.extra);
+  const rootStyle = {
+    ...mergedStyles.root,
+    ...style
+  };
   return wrapSSR( /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
     className: cardCls,
-    style: style,
+    style: rootStyle,
     ref: ref,
     onClick: e => {
       onChecked?.(e);
@@ -258,28 +279,31 @@ const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
     },
     ...(0, _util.omit)(rest, ['prefixCls', 'colSpan']),
     children: [(title || extra || collapsibleButton) && /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
-      className: (0, _clsx.clsx)(`${prefixCls}-header`, hashId, {
-        [`${prefixCls}-header-border`]: headerBordered || type === 'inner',
-        [`${prefixCls}-header-collapsible`]: collapsibleButton
-      }),
-      style: styles?.header,
+      className: headerCls,
+      style: mergedStyles.header,
       onClick: () => {
         if (collapsible === 'header' || collapsible === true) setCollapsed(!collapsed);
       },
       children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
-        className: `${prefixCls}-title ${hashId}`.trim(),
+        className: titleCls,
+        style: mergedStyles.title,
         children: [collapsibleButton, /*#__PURE__*/(0, _jsxRuntime.jsx)(_utils.LabelIconTip, {
           label: title,
           tooltip: tooltip,
           subTitle: subTitle
         })]
       }), extra && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
-        className: `${prefixCls}-extra ${hashId}`.trim(),
+        className: extraCls,
+        style: mergedStyles.extra,
         onClick: e => e.stopPropagation(),
         children: extra
       })]
+    }), cover && !collapsed && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      className: (0, _clsx.clsx)(`${prefixCls}-cover`, hashId, classNames?.cover),
+      style: mergedStyles.cover,
+      children: cover
     }), tabs ? /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
-      className: `${prefixCls}-tabs ${hashId}`.trim(),
+      className: (0, _clsx.clsx)(`${prefixCls}-tabs`, hashId),
       children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Tabs, {
         onChange: tabs.onChange,
         ...(0, _util.omit)(tabs, ['cardProps']),
@@ -288,7 +312,7 @@ const Card = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
       })
     }) : /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
       className: bodyCls,
-      style: styles?.body,
+      style: mergedStyles.body,
       children: loading ? loadingDOM : childrenModified
     }), actions ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Actions.default, {
       actions: actions,

package/lib/card/components/Card/style.js

@@ -153,7 +153,7 @@ const genProCardStyle = token => {
       },
       [`${componentCls}-title`]: {
         color: token.colorText,
-        fontWeight: 500,
+        fontWeight: token.fontWeightStrong,
         fontSize: token.fontSizeLG,
         lineHeight: token.lineHeight
       },
@@ -175,6 +175,17 @@ const genProCardStyle = token => {
           transition: `transform ${token.motionDurationMid}`
         }
       },
+      [`${componentCls}-cover`]: {
+        overflow: 'hidden',
+        borderRadius: `${token.borderRadius}px ${token.borderRadius}px 0 0`,
+        '& > *': {
+          width: '100%',
+          display: 'block'
+        },
+        '& img': {
+          verticalAlign: 'middle'
+        }
+      },
       [`${componentCls}-body`]: {
         display: 'block',
         boxSizing: 'border-box',

package/lib/card/components/Statistic/index.js

@@ -46,7 +46,7 @@ const Statistic = props => {
   const tipDom = tip && /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Tooltip, {
     title: tip,
     children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.QuestionCircleOutlined, {
-      className: `${prefixCls}-tip ${hashId}`.trim()
+      className: (0, _clsx.clsx)(`${prefixCls}-tip`, hashId)
     })
   });
   const trendIconClassName = (0, _clsx.clsx)(`${prefixCls}-trend-icon`, hashId, {
@@ -83,7 +83,7 @@ const Statistic = props => {
           className: statisticClassName,
           ...others
         }), description && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
-          className: `${prefixCls}-description ${hashId}`.trim(),
+          className: (0, _clsx.clsx)(`${prefixCls}-description`, hashId),
           children: description
         })]
       })]

package/lib/card/components/StatisticCard/index.js

@@ -61,7 +61,7 @@ const StatisticCard = props => {
     children: [statisticDom, chartDom]
   }));
   const footerDom = footer && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
-    className: `${prefixCls}-footer ${hashId}`.trim(),
+    className: (0, _clsx.clsx)(`${prefixCls}-footer`, hashId),
     children: footer
   });
   return wrapSSR( /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Card.default, {

package/lib/card/typing.d.ts

@@ -1,4 +1,4 @@
-import type { TabPaneProps, TabsProps } from 'antd';
+import type { CardProps as AntdCardProps, TabPaneProps, TabsProps } from 'antd';
 import type { ReactNode } from 'react';
 import type { LabelTooltipType } from '../utils';
 export type { LabelTooltipType };
@@ -6,12 +6,31 @@ export type Breakpoint = 'xxl' | 'xl' | 'lg' | 'md' | 'sm' | 'xs';
 export type Gutter = number | Partial<Record<Breakpoint, number>>;
 export type ColSpanType = number | string;
 type CollapsibleType = 'icon' | 'header' | boolean;
-type CardPropsBase = {
-    /** 样式配置 */
-    styles?: {
-        header?: React.CSSProperties;
-        body?: React.CSSProperties;
-    };
+/** 与 antd Card 一致的 styles 结构 */
+export interface ProCardStyles {
+    root?: React.CSSProperties;
+    header?: React.CSSProperties;
+    body?: React.CSSProperties;
+    extra?: React.CSSProperties;
+    title?: React.CSSProperties;
+    actions?: React.CSSProperties;
+    cover?: React.CSSProperties;
+}
+/** 与 antd Card 一致的 classNames 结构 */
+export interface ProCardClassNames {
+    root?: string;
+    header?: string;
+    body?: string;
+    extra?: string;
+    title?: string;
+    actions?: string;
+    cover?: string;
+}
+type CardPropsBase = Pick<AntdCardProps, 'rootClassName' | 'cover'> & {
+    /** 样式配置，与 antd Card styles 结构一致 */
+    styles?: ProCardStyles;
+    /** 语义化 classNames，与 antd Card classNames 结构一致 */
+    classNames?: ProCardClassNames;
     /** 页头是否有分割线 */
     headerBordered?: boolean;
     /** 卡片标题 */
@@ -43,7 +62,7 @@ type CardPropsBase = {
     actions?: React.ReactNode[] | React.ReactNode;
     /** 拆分卡片方式 */
     split?: 'vertical' | 'horizontal';
-    /** Card variants */
+    /** 卡片变体，与 antd Card variant 一致 */
     variant?: 'outlined' | 'borderless';
     /**
      * 鼠标移过时可浮起

package/lib/field/AllProField.d.ts

@@ -27,6 +27,8 @@ type RenderProps = Omit<ProFieldFCRenderProps, 'text' | 'placeholder'> & ProRend
  *
  * @param dataValue
  * @param valueType
+ * @param props
+ * @param valueTypeMap
  */
 export declare const defaultRenderText: (dataValue: ProFieldTextType, valueType: ProFieldValueType | ProFieldValueObjectType, props: RenderProps, valueTypeMap: Record<string, ProRenderFieldPropsType>) => React.ReactNode;
 export declare const ProField: React.ForwardRefRenderFunction<any, ProFieldPropsType>;

package/lib/field/AllProField.js

@@ -62,6 +62,7 @@ _dayjs.default.extend(_weekday.default);
  *
  * @param text String | number
  * @param valueType ProColumnsValueObjectType
+ * @param props
  */
 const defaultRenderTextByObject = (text, valueType, props) => {
   const pickFormItemProps = (0, _utils.pickProProps)(props.fieldProps);
@@ -109,6 +110,8 @@ const defaultRenderTextByObject = (text, valueType, props) => {
  *
  * @param dataValue
  * @param valueType
+ * @param props
+ * @param valueTypeMap
  */
 const defaultRenderText = (dataValue, valueType, props, valueTypeMap) => {
   const {

package/lib/field/PureProField.d.ts

@@ -29,6 +29,8 @@ type RenderProps = Omit<ProFieldFCRenderProps, 'text' | 'placeholder'> & ProRend
  *
  * @param dataValue
  * @param valueType
+ * @param props
+ * @param valueTypeMap
  */
 export declare const pureRenderText: (dataValue: ProFieldTextType, valueType: ProFieldValueType | ProFieldValueObjectType, props: RenderProps, valueTypeMap: Record<string, ProRenderFieldPropsType>) => React.ReactNode;
 /** ProField 的类型 */

package/lib/field/PureProField.js

@@ -34,6 +34,8 @@ _dayjs.default.extend(_weekday.default);
  *
  * @param dataValue
  * @param valueType
+ * @param props
+ * @param valueTypeMap
  */
 const pureRenderText = (dataValue, valueType, props, valueTypeMap) => {
   const {

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

@@ -16,7 +16,14 @@ var _jsxRuntime = require("react/jsx-runtime");
 /**
  * 级联选择组件
  *
- * @param param0
+ * @param placeholder
+ * @param formItemRender
+ * @param mode
+ * @param render
+ * @param label
+ * @param light
+ * @param variant
+ * @param rest
  * @param ref
  */
 const FieldCascader = ({

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

@@ -14,7 +14,11 @@ var _jsxRuntime = require("react/jsx-runtime");
 /**
  * 多选组件
  *
- * @param param0
+ * @param layout
+ * @param formItemRender
+ * @param mode
+ * @param render
+ * @param rest
  * @param ref
  */
 const FieldCheckbox = ({

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

@@ -3,5 +3,5 @@ import React from 'react';
 declare const _default: React.ForwardRefExoticComponent<import("src/provider").BaseProFieldFC & import("src/provider").ProRenderFieldPropsType & {
     text: string;
     mode?: "update" | "read" | "edit" | undefined;
-} & Partial<Omit<ColorPickerProps, "mode" | "value">> & React.RefAttributes<any>>;
+} & Partial<Omit<ColorPickerProps, "value" | "mode">> & React.RefAttributes<any>>;
 export default _default;

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

@@ -5,6 +5,6 @@ declare const _default: React.ForwardRefExoticComponent<import("../../../provide
     format?: string | undefined;
     showTime?: boolean | undefined;
     variant?: "outlined" | "filled" | "borderless" | "underlined" | undefined;
-    picker?: "time" | "date" | "month" | "week" | "quarter" | "year" | undefined;
+    picker?: "time" | "date" | "month" | "week" | "year" | "quarter" | undefined;
 } & ProFieldLightProps & React.RefAttributes<any>>;
 export default _default;

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

@@ -26,7 +26,19 @@ const formatDate = (text, format) => {
 /**
  * 日期选择组件
  *
- * @param
+ * @param text
+ * @param mode
+ * @param format
+ * @param label
+ * @param light
+ * @param render
+ * @param formItemRender
+ * @param showTime
+ * @param fieldProps
+ * @param picker
+ * @param lightLabel
+ * @param variant
+ * @param ref
  */
 const FieldDatePicker = ({
   text,

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

@@ -11,12 +11,25 @@ var _react = _interopRequireWildcard(require("react"));
 var _provider = require("../../../provider");
 var _utils = require("../../../utils");
 var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * 判断字符串是否为空或仅包含空白字符
+ * @param {string} str - 要检查的字符串
+ * @returns {boolean} - 如果为空或仅包含空白字符返回 true，否则返回 false
+ */
+function isEmptyOrWhitespace(str) {
+  return (0, _utils.isNil)(str) || str === '' || str?.trim() === '';
+}
+
 /**
  * 数字组件
  *
- * @param FieldDigitProps {
- *     text: number;
- *     moneySymbol?: string; }
+ * @param text
+ * @param type
+ * @param render
+ * @param placeholder
+ * @param formItemRender
+ * @param fieldProps
+ * @param ref
  */
 const FieldDigit = ({
   text,
@@ -87,6 +100,10 @@ const FieldDigit = ({
       onChange: e => fieldProps?.onChange?.(proxyChange(e)),
       onBlur: e => {
         const value = e.target.value;
+        if (isEmptyOrWhitespace(value)) {
+          fieldProps?.onBlur?.(e);
+          return;
+        }
         const processedValue = proxyChange(value);
         // 更新输入框的值
         if (e.target && typeof processedValue === 'number') {

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

@@ -123,16 +123,53 @@ const InputNumberPopover = /*#__PURE__*/_react.default.forwardRef(({
   numberFormatOptions,
   numberPopoverRender,
   open,
+  onOpenChange,
   ...rest
 }, ref) => {
   const [value, setValueInner] = (0, _util.useControlledState)(() => rest.defaultValue, rest.value);
+
+  // 使用本地状态管理 Popover 显示，同时支持受控模式
+  const [localOpen, setLocalOpen] = (0, _react.useState)(open ?? false);
+
+  // 跟踪组件挂载状态，防止在卸载后执行状态更新
+  const mountedRef = (0, _react.useRef)(true);
+  (0, _react.useEffect)(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+
+  // 同步外部 open 属性到本地状态，支持受控模式
+  (0, _react.useEffect)(() => {
+    if (open !== undefined) {
+      setLocalOpen(open);
+    }
+  }, [open]);
   const onChange = (0, _react.useCallback)(updater => {
     setValueInner(prev => {
       const next = typeof updater === 'function' ? updater(prev) : updater;
       rest.onChange?.(next);
       return next;
     });
-  }, [rest.onChange]);
+  }, [rest.onChange, setValueInner]);
+
+  // 优化的 onOpenChange 处理器
+  const handleOpenChange = (0, _react.useCallback)(visible => {
+    // 通知父组件状态变化
+    onOpenChange?.(visible);
+
+    // 如果是受控模式（传入了 open prop），不更新本地状态
+    if (open === undefined) {
+      // 使用 queueMicrotask 延迟状态更新，避免在渲染期间触发 flushSync
+      queueMicrotask(() => {
+        // 检查组件是否仍然挂载，避免在卸载后更新状态
+        if (mountedRef.current) {
+          setLocalOpen(visible);
+        }
+      });
+    }
+  }, [open, onOpenChange]);
 
   /**
    * 如果content 存在要根据 content 渲染一下
@@ -141,9 +178,20 @@ const InputNumberPopover = /*#__PURE__*/_react.default.forwardRef(({
     ...rest,
     value
   });
+
+  // 没有 dom 时不显示 Popover
+  if (!dom) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.InputNumber, {
+      ref: ref,
+      ...rest,
+      value: value,
+      onChange: onChange
+    });
+  }
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Popover, {
     placement: "topLeft",
-    open: dom ? open : false,
+    open: localOpen,
+    onOpenChange: handleOpenChange,
     trigger: ['focus', 'click'],
     content: dom,
     getPopupContainer: triggerNode => {

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

@@ -14,18 +14,19 @@ var _jsxRuntime = require("react/jsx-runtime");
 /**
  * 最基本的组件，就是个普通的 Input.Password
  *
- * @param
+ * @param props
+ * @param ref
  */
-const FieldPassword = ({
-  text,
-  mode,
-  render,
-  formItemRender,
-  fieldProps,
-  proFieldKey,
-  ...rest
-}, ref) => {
+const FieldPassword = (props, ref) => {
   const intl = (0, _provider.useIntl)();
+  const {
+    text,
+    mode,
+    render,
+    formItemRender,
+    fieldProps,
+    ...rest
+  } = (0, _util.omit)(props, ['proFieldKey']);
   const [open, setOpenInner] = (0, _util.useControlledState)(() => rest.open || false, rest.open);
   const setOpen = (0, _react.useCallback)(updater => {
     setOpenInner(prev => {

package/lib/field/components/Percent/util.d.ts

@@ -1,7 +1,7 @@
 /** 获取展示符号 */
 export declare function getSymbolByRealValue(realValue: number): "-" | "+" | null;
 /** 获取颜色 */
-export declare function getColorByRealValue(realValue: number /** ,color: string */): "#595959" | "#ff4d4f" | "#52c41a";
+export declare function getColorByRealValue(realValue: number /** ,color: string */): "#52c41a" | "#595959" | "#ff4d4f";
 /** 获取到最后展示的数字 */
 export declare function getRealTextWithPrecision(realValue: number, precision?: number): string | number;
 /**

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

@@ -14,7 +14,11 @@ var _jsxRuntime = require("react/jsx-runtime");
 /**
  * 单选组件
  *
- * @param param0
+ * @param radioType
+ * @param formItemRender
+ * @param mode
+ * @param render
+ * @param rest
  * @param ref
  */
 const FieldRadio = ({

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

@@ -5,6 +5,6 @@ declare const _default: React.ForwardRefExoticComponent<import("../../../provide
     format?: string | undefined;
     variant?: "outlined" | "filled" | "borderless" | "underlined" | undefined;
     showTime?: boolean | undefined;
-    picker?: "time" | "date" | "month" | "week" | "quarter" | "year" | undefined;
+    picker?: "time" | "date" | "month" | "week" | "year" | "quarter" | undefined;
 } & ProFieldLightProps & React.RefAttributes<any>>;
 export default _default;

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

@@ -14,7 +14,8 @@ var _jsxRuntime = require("react/jsx-runtime");
 /**
  * Segmented https://ant.design/components/segmented-cn/
  *
- * @param
+ * @param props
+ * @param ref
  */const FieldSegmented = (props, ref) => {
   const {
     mode,

package/lib/field/components/Select/SearchSelect/index.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
+var _util = require("@rc-component/util");
 var _antd = require("antd");
 var _clsx = require("clsx");
 var _react = _interopRequireWildcard(require("react"));
@@ -48,7 +49,7 @@ const SearchSelect = (props, ref) => {
     value: valuePropsName = 'value',
     options: optionsPropsName = 'options'
   } = fieldNames || {};
-  const [searchValue, setSearchValue] = (0, _react.useState)(propsSearchValue ?? defaultSearchValue);
+  const [searchValue, setSearchValue] = (0, _util.useControlledState)(defaultSearchValue, propsSearchValue);
   const selectRef = (0, _react.useRef)();
   (0, _react.useImperativeHandle)(ref, () => selectRef.current);
   (0, _react.useEffect)(() => {
@@ -56,9 +57,6 @@ const SearchSelect = (props, ref) => {
       selectRef?.current?.focus();
     }
   }, [restProps.autoFocus]);
-  (0, _react.useEffect)(() => {
-    setSearchValue(propsSearchValue);
-  }, [propsSearchValue]);
   const {
     getPrefixCls
   } = (0, _react.useContext)(_antd.ConfigProvider.ConfigContext);

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

@@ -23,7 +23,7 @@ export type FieldSelectProps<FieldProps = any> = {
 /**
  * 把 value 的枚举转化为数组
  *
- * @param valueEnum
+ * @param valueEnumParams
  */
 export declare const proFieldParsingValueEnumToArray: (valueEnumParams: ProFieldValueEnumType) => SelectOptionType;
 export declare const useFieldFetchData: (props: FieldSelectProps & {