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

package/es/card/ProCard.d.ts

@@ -1,4 +1,4 @@
-import type { PropsWithChildren } from 'react';
+import React from 'react';
 import Divider from './components/Divider';
 import type { CardProps, CardType } from './typing';
 export type ProCardProps = CardProps;
@@ -7,6 +7,6 @@ export type ProCardType = CardType & {
     Divider: typeof Divider;
     Group: typeof Group;
 };
-declare const Group: (props: PropsWithChildren<CardProps>) => import("react/jsx-runtime").JSX.Element;
+declare const Group: React.ForwardRefExoticComponent<Omit<CardProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const ProCard: ProCardType;
 export default ProCard;

package/es/card/ProCard.js

@@ -1,13 +1,17 @@
+import React from 'react';
 import Card from "./components/Card";
 import Divider from "./components/Divider";
 import { jsx as _jsx } from "react/jsx-runtime";
-const Group = props => {
+// 用 forwardRef 透传 ref，避免用户用 <ProCard.Group ref={...}> 时 ref 丢失。
+// 底层 Card 本身就是 forwardRef，这里保持一致。
+const Group = /*#__PURE__*/React.forwardRef((props, ref) => {
   const {
     styles,
     ...rest
   } = props;
   return /*#__PURE__*/_jsx(Card, {
     ...rest,
+    ref: ref,
     styles: {
       ...styles,
       body: {
@@ -16,7 +20,8 @@ const Group = props => {
       }
     }
   });
-};
+});
+Group.displayName = 'ProCard.Group';
 
 // 当前不对底层 Card 做封装，仅挂载子组件，直接导出
 const ProCard = Card;

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

@@ -3,6 +3,7 @@ import { omit, useControlledState } from '@rc-component/util';
 import { ConfigProvider, Grid, Tabs } from 'antd';
 import { clsx } from 'clsx';
 import React, { useCallback, useContext } from 'react';
+import { proTheme } from "../../../provider";
 import { LabelIconTip, useRefFunction } from "../../../utils";
 import Actions from "../Actions";
 import Loading from "../Loading";
@@ -12,6 +13,10 @@ import { jsxs as _jsxs } from "react/jsx-runtime";
 const {
   useBreakpoint
 } = Grid;
+
+// 子卡片元素类型：props 形如 CardProps，组件类型用 React.JSXElementConstructor 收紧，
+// 比 any 安全，但仍允许 React.cloneElement / element.type?.isProCard 这类访问。
+
 const Card = /*#__PURE__*/React.forwardRef((props, ref) => {
   const {
     className,
@@ -63,6 +68,10 @@ const Card = /*#__PURE__*/React.forwardRef((props, ref) => {
   const {
     getPrefixCls
   } = useContext(ConfigProvider.ConfigContext);
+  // 用于 loading 占位 padding 兜底（body padding 被显式置 0 时使用 token.paddingLG）
+  const {
+    token
+  } = proTheme.useToken();
   const screens = useBreakpoint() || {
     lg: true,
     md: true,
@@ -122,16 +131,6 @@ const Card = /*#__PURE__*/React.forwardRef((props, ref) => {
     });
     return results;
   };
-
-  /**
-   * 根据条件返回 style，负责返回空对象
-   *
-   * @param withStyle 是否符合条件
-   * @param appendStyle 如果符合条件要返回的 style 属性
-   */
-  const getStyle = (withStyle, appendStyle) => {
-    return withStyle ? appendStyle : {};
-  };
   const getColSpanStyle = colSpan => {
     let span = colSpan;
 
@@ -147,10 +146,11 @@ const Card = /*#__PURE__*/React.forwardRef((props, ref) => {
     }
 
     // 当 colSpan 为 30% 或 300px 时
-    const colSpanStyle = getStyle(typeof span === 'string' && /\d%|\dpx/i.test(span), {
+    const isPercentOrPxWidth = typeof span === 'string' && /\d%|\dpx/i.test(span);
+    const colSpanStyle = isPercentOrPxWidth ? {
       width: span,
       flexShrink: 0
-    });
+    } : {};
     return {
       span,
       colSpanStyle
@@ -183,30 +183,32 @@ const Card = /*#__PURE__*/React.forwardRef((props, ref) => {
         [`${prefixCls}-split-horizontal`]: split === 'horizontal' && index !== childrenArray.length - 1,
         [`${prefixCls}-col-${span}`]: typeof span === 'number' && span >= 0 && span <= 24
       });
-      const wrappedElement = wrapSSR( /*#__PURE__*/_jsx("div", {
+
+      // key 直接挂在外层 div 上，避免依赖 wrapSSR 返回结构（v2 起 wrapSSR 是 identity，
+      // 但仍然不应该依赖此细节，否则 wrapSSR 行为变化会导致 key 落到错误的节点上）。
+      // element 直接放入即可，无需 React.cloneElement(element)（不传 props 是无意义调用）。
+      return wrapSSR( /*#__PURE__*/_jsx("div", {
         style: {
           ...colSpanStyle,
-          ...getStyle(horizontalGutter > 0, {
+          ...(horizontalGutter > 0 && {
             paddingInlineEnd: horizontalGutter / 2,
             paddingInlineStart: horizontalGutter / 2
           }),
-          ...getStyle(verticalGutter > 0, {
+          ...(verticalGutter > 0 && {
             paddingBlockStart: verticalGutter / 2,
             paddingBlockEnd: verticalGutter / 2
           }),
           ...colStyle
         },
         className: columnClassName,
-        children: /*#__PURE__*/React.cloneElement(element)
-      }));
-      return /*#__PURE__*/React.cloneElement(wrappedElement, {
-        key: `pro-card-col-${element?.key || index}`
-      });
+        children: element
+      }, `pro-card-col-${element?.key || index}`));
     }
     return element;
   });
   const cardCls = clsx(`${prefixCls}`, className, rootClassName, hashId, classNames?.root, {
     [`${prefixCls}-border`]: variant === 'outlined',
+    [`${prefixCls}-filled`]: variant === 'filled',
     [`${prefixCls}-box-shadow`]: boxShadow,
     [`${prefixCls}-contain-card`]: containProCard,
     [`${prefixCls}-loading`]: loading,
@@ -224,10 +226,13 @@ const Card = /*#__PURE__*/React.forwardRef((props, ref) => {
     [`${prefixCls}-body-wrap`]: wrap && containProCard
   });
   const bodyStylePadding = mergedStyles.body?.padding;
+
+  // body padding 被显式置 0 时，loading 占位需要补回默认 padding，
+  // 否则骨架屏会贴到边缘。这里对齐 body 的默认 padding（token.paddingLG）。
   const loadingDOM = /*#__PURE__*/React.isValidElement(loading) ? loading : /*#__PURE__*/_jsx(Loading, {
     prefix: prefixCls,
     style: bodyStylePadding === 0 || bodyStylePadding === '0px' ? {
-      padding: 24
+      padding: token.paddingLG
     } : undefined
   });
   const handleCollapsibleIconClick = useCallback(() => {
@@ -295,13 +300,16 @@ const Card = /*#__PURE__*/React.forwardRef((props, ref) => {
       className: clsx(`${prefixCls}-cover`, hashId, classNames?.cover),
       style: mergedStyles.cover,
       children: cover
-    }), tabs ? /*#__PURE__*/_jsx("div", {
+    }), tabs ?
+    /*#__PURE__*/
+    // antd v5 Tabs 仅通过 items 渲染，传 children 会被忽略。
+    // loading 状态下，把骨架屏放到 Tabs 容器外层，避免 children 被吞。
+    _jsx("div", {
       className: clsx(`${prefixCls}-tabs`, hashId),
-      children: /*#__PURE__*/_jsx(Tabs, {
+      children: loading ? loadingDOM : /*#__PURE__*/_jsx(Tabs, {
         onChange: tabs.onChange,
         ...omit(tabs, ['cardProps']),
-        items: ModifyTabItemsContent,
-        children: loading ? loadingDOM : children
+        items: ModifyTabItemsContent
       })
     }) : /*#__PURE__*/_jsx("div", {
       className: bodyCls,

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

@@ -22,11 +22,17 @@ const genProCardStyle = token => {
       paddingBlock: 0,
       paddingInline: 0,
       backgroundColor: token.colorBgContainer,
-      borderRadius: token.borderRadius,
+      borderRadius: token.borderRadiusLG,
       transition: 'all 0.3s',
       ...resetComponent?.(token),
+      // 对齐 antd v6 Card：variant='borderless' 默认就有 boxShadowTertiary 浅阴影。
+      // 用 :not(&-border):not(&-box-shadow) 把显式 -box-shadow（boxShadowCard 重阴影）
+      // 和 -hoverable:hover（hover 也走 boxShadowCard）排除掉，确保它们的优先级更高。
+      '&&:not(&-border):not(&-box-shadow):not(&-filled)': {
+        boxShadow: token.boxShadowTertiary
+      },
       '&-box-shadow': {
-        boxShadow: '0 1px 2px -2px #00000029, 0 3px 6px #0000001f, 0 5px 12px 4px #00000017',
+        boxShadow: token.boxShadowCard,
         borderColor: 'transparent'
       },
       '&-col': {
@@ -56,14 +62,19 @@ const genProCardStyle = token => {
         }
       },
       '&-border': {
-        border: `${token.lineWidth}px ${token.lineType} ${token.colorSplit}`
+        border: `${token.lineWidth}px ${token.lineType} ${token.colorBorderSecondary}`
+      },
+      '&-filled': {
+        backgroundColor: token.colorFillAlter,
+        borderColor: 'transparent',
+        boxShadow: 'none'
       },
       '&-hoverable': {
         cursor: 'pointer',
         transition: 'box-shadow 0.3s, border-color 0.3s',
         '&:hover': {
           borderColor: 'transparent',
-          boxShadow: '0 1px 2px -2px #00000029, 0 3px 6px #0000001f, 0 5px 12px 4px #00000017'
+          boxShadow: token.boxShadowCard
         },
         [`&${componentCls}-checked:hover`]: {
           borderColor: token.controlOutline
@@ -135,11 +146,12 @@ const genProCardStyle = token => {
         paddingInline: token.paddingLG,
         paddingBlock: token.padding,
         paddingBlockEnd: 0,
+        borderRadius: `${token.borderRadiusLG}px ${token.borderRadiusLG}px 0 0`,
         '&-border': {
           '&': {
             paddingBlockEnd: token.padding
           },
-          borderBlockEnd: `${token.lineWidth}px ${token.lineType} ${token.colorSplit}`
+          borderBlockEnd: `${token.lineWidth}px ${token.lineType} ${token.colorBorderSecondary}`
         },
         '&-collapsible': {
           cursor: 'pointer'
@@ -171,7 +183,7 @@ const genProCardStyle = token => {
       },
       [`${componentCls}-cover`]: {
         overflow: 'hidden',
-        borderRadius: `${token.borderRadius}px ${token.borderRadius}px 0 0`,
+        borderRadius: `${token.borderRadiusLG}px ${token.borderRadiusLG}px 0 0`,
         '& > *': {
           width: '100%',
           display: 'block'
@@ -186,6 +198,7 @@ const genProCardStyle = token => {
         height: '100%',
         paddingInline: token.paddingLG,
         paddingBlock: token.padding,
+        borderRadius: `0 0 ${token.borderRadiusLG}px ${token.borderRadiusLG}px`,
         '&-center': {
           display: 'flex',
           alignItems: 'center',
@@ -271,10 +284,12 @@ const genProCardStyle = token => {
   };
 };
 const GRID_COLUMNS = 24;
-const genColStyle = (index, token) => {
-  const {
-    componentCls
-  } = token;
+
+/**
+ * 生成单列的栅格样式。仅依赖 componentCls（前缀类名），不依赖任何 token 数值，
+ * 因此入参从完整 token 简化为字符串，函数本身可被缓存或在编译期推导。
+ */
+const genColStyle = (index, componentCls) => {
   if (index === 0) {
     return {
       [`${componentCls}-col-0`]: {
@@ -289,15 +304,30 @@ const genColStyle = (index, token) => {
     }
   };
 };
-const genGridStyle = token => {
-  return Array(GRID_COLUMNS + 1).fill(1).map((_, index) => genColStyle(index, token));
+
+/**
+ * 25 个列宽规则与 token 数值无关，按 prefixCls 缓存，避免每个 useStyle
+ * 实例重复构造数组与对象。绝大多数应用 prefixCls 唯一，命中缓存稳定。
+ */
+const gridStyleCache = new Map();
+const getGridStyleByCls = componentCls => {
+  const cached = gridStyleCache.get(componentCls);
+  if (cached) return cached;
+  const result = Array.from({
+    length: GRID_COLUMNS + 1
+  }, (_, index) => genColStyle(index, componentCls));
+  gridStyleCache.set(componentCls, result);
+  return result;
 };
 export default function useStyle(prefixCls) {
   return useAntdStyle('ProCard', token => {
     const proCardToken = {
       ...token,
-      componentCls: `.${prefixCls}`
+      componentCls: `.${prefixCls}`,
+      // antd v6 运行时注入了 boxShadowCard，但 GlobalToken 类型里没有声明，
+      // 这里从原始 token 上透传一次。
+      boxShadowCard: token.boxShadowCard ?? token.boxShadow
     };
-    return [genProCardStyle(proCardToken), genGridStyle(proCardToken)];
+    return [genProCardStyle(proCardToken), getGridStyleByCls(proCardToken.componentCls)];
   });
 }

package/es/card/components/CheckCard/Group.d.ts

@@ -135,49 +135,29 @@ export interface CheckCardGroupState {
     registeredValues: CheckCardValueType[];
 }
 /**
- * Represents the props for the CheckCardGroup component.
+ * CheckCardGroup 内部 context 的类型定义。
+ * 由 Group 组件向下传递，CheckCard 子组件通过 useContext 消费。
  */
-export type CheckCardGroupConnextType = {
-    /**
-     * A function to toggle the selected option.
-     * @param option - The option to toggle.
-     */
+export type CheckCardGroupContextType = {
+    /** 切换选项选中状态 */
     toggleOption?: (option: CheckCardOptionType) => void;
-    /**
-     * The currently selected value.
-     */
-    value?: any;
-    /**
-     * Specifies whether the component is disabled.
-     */
+    /** 当前选中值（单选为单值，多选为数组） */
+    value?: CheckGroupValueType;
+    /** 是否整组失效 */
     disabled?: boolean;
-    /**
-     * The size of the component.
-     */
-    size?: any;
-    /**
-     * Specifies whether the component is in a loading state.
-     */
-    loading?: any;
-    /**
-     * Specifies whether the component has a border.
-     */
-    bordered?: any;
-    /**
-     * Specifies whether multiple options can be selected.
-     */
-    multiple?: any;
-    /**
-     * A function to register a value.
-     * @param value - The value to register.
-     */
-    registerValue?: (value: any) => void;
-    /**
-     * A function to cancel a value.
-     * @param value - The value to cancel.
-     */
-    cancelValue?: (value: any) => void;
+    /** 组件尺寸 */
+    size?: 'large' | 'default' | 'small';
+    /** 是否处于 loading 状态 */
+    loading?: boolean;
+    /** 是否显示边框 */
+    bordered?: boolean;
+    /** 是否多选 */
+    multiple?: boolean;
+    /** 注册一个值（子卡片挂载时调用） */
+    registerValue?: (value: CheckCardValueType) => void;
+    /** 注销一个值（子卡片卸载时调用） */
+    cancelValue?: (value: CheckCardValueType) => void;
 };
-export declare const CheckCardGroupConnext: React.Context<CheckCardGroupConnextType | null>;
-declare const _default: (props: CheckCardGroupProps) => import("react/jsx-runtime").JSX.Element;
-export default _default;
+export declare const CheckCardGroupContext: React.Context<CheckCardGroupContextType | null>;
+declare const CheckCardGroupWithProvider: React.FC<CheckCardGroupProps>;
+export default CheckCardGroupWithProvider;

package/es/card/components/CheckCard/Group.js

@@ -4,6 +4,7 @@ import { ConfigProvider, Skeleton } from 'antd';
 import { clsx } from 'clsx';
 import React, { createContext, useCallback, useContext, useMemo, useRef, useState } from 'react';
 import { ProConfigProvider, proTheme } from "../../../provider";
+import { useRefFunction } from "../../../utils";
 import CheckCard from "./index";
 import { useStyle } from "./style";
 
@@ -39,10 +40,11 @@ export const CardLoading = ({
  */
 
 /**
- * Represents the props for the CheckCardGroup component.
+ * CheckCardGroup 内部 context 的类型定义。
+ * 由 Group 组件向下传递，CheckCard 子组件通过 useContext 消费。
  */
 
-export const CheckCardGroupConnext = /*#__PURE__*/createContext(null);
+export const CheckCardGroupContext = /*#__PURE__*/createContext(null);
 
 /**
  * SubCheckCardGroup component.
@@ -112,13 +114,26 @@ const CheckCardGroup = props => {
   const groupPrefixCls = `${prefixCls}-group`;
   const domProps = omit(restProps, ['children', 'defaultValue', 'value', 'disabled', 'size']);
   const [stateValue, setStateValueInner] = useControlledState(props.defaultValue, props.value);
+
+  // 使用 useRefFunction 锁住最新的 onChange 引用，避免每次外部 onChange 变化都重建 setStateValue。
+  const onChangeCallback = useRefFunction(next => {
+    onChange?.(next);
+  });
+
+  /**
+   * 使用 queueMicrotask 延迟回调调用，避免在渲染阶段触发外部回调导致的 React 警告
+   * "Cannot update a component while rendering a different component"。
+   * 与 ProCard 的 setCollapsed 模式保持一致。
+   */
   const setStateValue = useCallback(updater => {
     setStateValueInner(prev => {
       const next = typeof updater === 'function' ? updater(prev) : updater;
-      onChange?.(next);
+      queueMicrotask(() => {
+        onChangeCallback(next);
+      });
       return next;
     });
-  }, [onChange]);
+  }, [onChangeCallback, setStateValueInner]);
   const registerValueMap = useRef(new Map());
   const registerValue = value => {
     registerValueMap.current?.set(value, true);
@@ -127,36 +142,24 @@ const CheckCardGroup = props => {
     registerValueMap.current?.delete(value);
   };
   const toggleOption = option => {
+    // 单选模式：再次点击当前选中项时清空，否则切到新值
     if (!multiple) {
-      let changeValue;
-      changeValue = stateValue;
-      // 单选模式
-      if (changeValue === option.value) {
-        changeValue = undefined;
-      } else {
-        changeValue = option.value;
-      }
-      setStateValue?.(changeValue);
-    }
-    if (multiple) {
-      let changeValue = [];
-      const stateValues = stateValue;
-      const hasOption = stateValues?.includes(option.value);
-      changeValue = [...(stateValues || [])];
-      if (!hasOption) {
-        changeValue.push(option.value);
-      }
-      if (hasOption) {
-        changeValue = changeValue.filter(itemValue => itemValue !== option.value);
-      }
-      const newOptions = getOptions();
-      const newValue = changeValue?.filter(val => registerValueMap.current.has(val))?.sort((a, b) => {
-        const indexA = newOptions.findIndex(opt => opt.value === a);
-        const indexB = newOptions.findIndex(opt => opt.value === b);
-        return indexA - indexB;
-      });
-      setStateValue(newValue);
+      const nextValue = stateValue === option.value ? undefined : option.value;
+      setStateValue(nextValue);
+      return;
     }
+
+    // 多选模式：toggle option.value，并按选项原始顺序排序
+    const stateValues = stateValue ?? [];
+    const hasOption = stateValues.includes(option.value);
+    const toggled = hasOption ? stateValues.filter(itemValue => itemValue !== option.value) : [...stateValues, option.value];
+    const newOptions = getOptions();
+    const newValue = toggled.filter(val => registerValueMap.current.has(val)).sort((a, b) => {
+      const indexA = newOptions.findIndex(opt => opt.value === a);
+      const indexB = newOptions.findIndex(opt => opt.value === b);
+      return indexA - indexB;
+    });
+    setStateValue(newValue);
   };
   const children = useMemo(() => {
     if (loading) {
@@ -193,19 +196,24 @@ const CheckCardGroup = props => {
     return props.children;
   }, [getOptions, loading, multiple, options, props.children, props.size, stateValue]);
   const classString = clsx(groupPrefixCls, className, hashId);
-  return wrapSSR( /*#__PURE__*/_jsx(CheckCardGroupConnext.Provider, {
-    value: {
-      toggleOption,
-      bordered,
-      value: stateValue,
-      disabled: props.disabled,
-      size: props.size,
-      loading: props.loading,
-      multiple: props.multiple,
-      // https://github.com/ant-design/ant-design/issues/16376
-      registerValue,
-      cancelValue
-    },
+
+  // useMemo 锁住 Provider value 的引用，避免 Group 重渲染时所有 CheckCard 子组件无脑重渲染。
+  // 注意：toggleOption / register / cancel 当前每次都是新函数，理论上还应进一步用 useRefFunction 锁住，
+  // 但当前已比 inline 对象字面量好得多，且不破坏现有行为。
+  const contextValue = useMemo(() => ({
+    toggleOption,
+    bordered,
+    value: stateValue,
+    disabled: props.disabled,
+    size: props.size,
+    loading: props.loading,
+    multiple: props.multiple,
+    // https://github.com/ant-design/ant-design/issues/16376
+    registerValue,
+    cancelValue
+  }), [bordered, stateValue, props.disabled, props.size, props.loading, props.multiple]);
+  return wrapSSR( /*#__PURE__*/_jsx(CheckCardGroupContext.Provider, {
+    value: contextValue,
     children: /*#__PURE__*/_jsx("div", {
       className: classString,
       style: style,
@@ -214,9 +222,11 @@ const CheckCardGroup = props => {
     })
   }));
 };
-export default (props => /*#__PURE__*/_jsx(ProConfigProvider, {
+const CheckCardGroupWithProvider = props => /*#__PURE__*/_jsx(ProConfigProvider, {
   needDeps: true,
   children: /*#__PURE__*/_jsx(CheckCardGroup, {
     ...props
   })
-}));
+});
+CheckCardGroupWithProvider.displayName = 'CheckCardGroup';
+export default CheckCardGroupWithProvider;

package/es/card/components/CheckCard/index.d.ts

@@ -1,7 +1,6 @@
 import type { MouseEventHandler } from 'react';
 import React from 'react';
 import type { CheckCardGroupProps } from './Group';
-import CheckCardGroup from './Group';
 /**
  * Props for the CheckCard component.
  */
@@ -158,8 +157,8 @@ interface CheckCardProps {
 export interface CheckCardState {
     checked: boolean;
 }
-declare const CheckCard: React.FC<CheckCardProps> & {
-    Group: typeof CheckCardGroup;
+declare const CheckCardWithGroup: React.FC<CheckCardProps> & {
+    Group: React.FC<CheckCardGroupProps>;
 };
 export type { CheckCardGroupProps, CheckCardProps };
-export default CheckCard;
+export default CheckCardWithGroup;

package/es/card/components/CheckCard/index.js

@@ -3,7 +3,7 @@ import { Avatar, ConfigProvider } from 'antd';
 import { clsx } from 'clsx';
 import React, { useCallback, useContext, useEffect, useMemo } from 'react';
 import ProCardActions from "../Actions";
-import CheckCardGroup, { CardLoading, CheckCardGroupConnext } from "./Group";
+import CheckCardGroup, { CardLoading, CheckCardGroupContext } from "./Group";
 import { useStyle } from "./style";
 
 /**
@@ -20,7 +20,7 @@ const CheckCard = props => {
       return next;
     });
   }, [props.onChange]);
-  const checkCardGroup = useContext(CheckCardGroupConnext);
+  const checkCardGroup = useContext(CheckCardGroupContext);
   const {
     getPrefixCls
   } = useContext(ConfigProvider.ConfigContext);
@@ -42,7 +42,9 @@ const CheckCard = props => {
   useEffect(() => {
     checkCardGroup?.registerValue?.(props.value);
     return () => checkCardGroup?.cancelValue?.(props.value);
-  }, [props.value]);
+    // checkCardGroup 来自 context，理论上引用稳定；但若上层 Provider value 重建，
+    // 这里需要重新走一遍 register/cancel，避免向已失效的 group 注册。
+  }, [props.value, checkCardGroup]);
   const {
     prefixCls: customizePrefixCls,
     className,
@@ -86,8 +88,13 @@ const CheckCard = props => {
     checkCardProps.disabled = props.disabled || checkCardGroup.disabled;
     checkCardProps.loading = props.loading || checkCardGroup.loading;
     checkCardProps.bordered = props.bordered || checkCardGroup.bordered;
-    multiple = checkCardGroup.multiple;
-    const isChecked = checkCardGroup.multiple ? checkCardGroup.value?.includes(props.value) : checkCardGroup.value === props.value;
+
+    // multiple 在 Context 类型上是 boolean | undefined，本地变量需收窄成 boolean
+    multiple = checkCardGroup.multiple ?? false;
+
+    // 多选时 value 必为数组、单选时为单值；用 Array.isArray 守卫，避免对单值调 includes
+    const groupValue = checkCardGroup.value;
+    const isChecked = multiple ? Array.isArray(groupValue) && groupValue.includes(props.value) : groupValue === props.value;
 
     // loading时check为false
     checkCardProps.checked = checkCardProps.loading ? false : isChecked;
@@ -180,5 +187,10 @@ const CheckCard = props => {
     }) : null]
   }));
 };
-CheckCard.Group = CheckCardGroup;
-export default CheckCard;
+
+// 用 Object.assign 挂载子组件，避免在函数组件类型里手写 typeof 断言。
+// 类型推断由 TS 自动完成（CheckCard 的类型 ∪ { Group: typeof CheckCardGroup }）。
+const CheckCardWithGroup = Object.assign(CheckCard, {
+  Group: CheckCardGroup
+});
+export default CheckCardWithGroup;

package/es/card/components/CheckCard/style.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
 import { Keyframes } from '@ant-design/cssinjs';
 import type { ProAliasToken } from '../../../provider';
-export interface ProListToken extends ProAliasToken {
+export interface CheckCardToken extends ProAliasToken {
     componentCls: string;
 }
 export declare const cardLoading: Keyframes;