@cloudtower/eagle 490.0.8 → 490.0.10

package/dist/src/core/AccordionCard/accordionCard.type.d.ts

@@ -6,4 +6,5 @@ export interface IAccordionCardProps {
     defaultExpand?: boolean;
     mountOnEnter?: boolean;
     unmountOnExit?: boolean;
+    "data-testid"?: string;
 }

package/dist/src/core/Alert/alert.type.d.ts

@@ -3,5 +3,6 @@ import { AlertProps as AntdAlertProps } from "antd/lib/alert";
 export type AlertProps = Omit<AntdAlertProps, "type"> & {
     type?: AntdAlertProps["type"] | "normal";
     action?: React.ReactNode;
+    "data-testid"?: string;
 };
 export type AlertComponentType = React.FunctionComponent<AlertProps>;

package/dist/src/core/Antd5Flex/index.d.ts

@@ -1,2 +1,2 @@
-export { Flex as Antd5Flex } from "antd5";
 export type { FlexProps as Antd5FlexProps } from "antd5";
+export { Flex as Antd5Flex } from "antd5";

package/dist/src/core/Arch/arch.type.d.ts

@@ -5,4 +5,5 @@ export declare enum Architecture {
 }
 export type ArchComponentType = React.FC<{
     architecture?: Architecture;
+    "data-testid"?: string;
 }>;

package/dist/src/core/AutoComplete/AutoComplete.d.ts

@@ -1,3 +1,6 @@
 import { AutoCompleteProps } from "antd5";
 import React from "react";
-export declare const AutoComplete: React.FC<AutoCompleteProps>;
+export declare const AutoComplete: React.FC<AutoCompleteProps & {
+    /** Test ID for automated testing */
+    "data-testid"?: string;
+}>;

package/dist/src/core/Avatar/avatar.type.d.ts

@@ -8,4 +8,5 @@ export type AvatarProps = {
      * 背景色
      */
     background?: "light-blue" | "dark-blue";
+    "data-testid"?: string;
 };

package/dist/src/core/Banner/banner.types.d.ts

@@ -18,9 +18,10 @@ import { ButtonProps } from "../Button";
  *   }
  * }
  */
-export type BannerProps = HTMLAttributes<"DIV"> & {
+export type BannerProps = HTMLAttributes<HTMLDivElement> & {
     type: "error" | "info" | "warning";
     message: string;
+    "data-testid"?: string;
     btnProps?: Pick<ButtonProps, "onClick"> & {
         text: string;
         hide?: boolean;

package/dist/src/core/BasicCTError/BasicCTError.type.d.ts

@@ -1,6 +1,6 @@
-import React from "react";
-import { CTError } from "../../utils/cterror";
 import { UseCTErrorMsgOptions } from "../../hooks/useCTErrorMsg";
+import { CTError } from "../../utils/cterror";
+import React from "react";
 /**
  * 错误详情渲染器的 props
  */
@@ -20,6 +20,8 @@ export interface ErrorContainerRenderProps {
     children?: React.ReactNode;
     /** 错误信息 */
     errorMsgs: (string | undefined)[];
+    /** 测试标识符 */
+    "data-testid"?: string;
 }
 /**
  * BasicCTError 组件的 props
@@ -53,4 +55,8 @@ export interface BasicCTErrorProps {
      * 用于配置国际化命名空间和其他翻译选项
      */
     errorMsgOptions?: UseCTErrorMsgOptions;
+    /**
+     * 测试标识符，用于自动化测试定位元素
+     */
+    "data-testid"?: string;
 }

package/dist/src/core/BlankState/index.d.ts

@@ -1,4 +1,4 @@
 import React from "react";
 import { IBlankStateProps } from "./type";
-declare const BlankState: (props: IBlankStateProps) => React.JSX.Element;
+declare const BlankState: ({ className, style, width, height, title, description, action, backgroundColor, size, "data-testid": dataTestId, }: IBlankStateProps) => React.JSX.Element;
 export default BlankState;

package/dist/src/core/BlankState/type.d.ts

@@ -46,4 +46,5 @@ export interface IBlankStateProps {
          */
         onClick: () => void;
     };
+    "data-testid"?: string;
 }

package/dist/src/core/Breadcrumb/breadcrumb.type.d.ts

@@ -4,8 +4,10 @@ export interface BreadcrumbLink {
     id?: string;
     resource: string;
     tab?: string;
+    "data-testid"?: string;
     onClick: React.MouseEventHandler<HTMLSpanElement>;
 }
 export interface IBreadcrumbProps {
     items: BreadcrumbLink[];
+    "data-testid"?: string;
 }

package/dist/src/core/Button/button.type.d.ts

@@ -10,6 +10,7 @@ export type ButtonProps = {
 } & Omit<AntdButtonProps, "type" | "icon">;
 export type ButtonGroupType = {
     className?: string;
+    "data-testid"?: string;
     size?: SizeType;
     options: Array<Omit<ButtonProps, "shape" | "size" | "icon"> & {
         key: string;

package/dist/src/core/Card/index.d.ts

@@ -7,6 +7,10 @@ export type CardProps = {
     className?: string;
     hoverable?: boolean;
     shadow?: boolean;
+    /**
+     * 用于测试的标识符，会传递到卡片根容器元素。
+     */
+    "data-testid"?: string;
 } & React.DOMAttributes<HTMLDivElement>;
 declare const Card: React.ForwardRefExoticComponent<{
     collapsible?: boolean | undefined;
@@ -16,6 +20,10 @@ declare const Card: React.ForwardRefExoticComponent<{
     className?: string | undefined;
     hoverable?: boolean | undefined;
     shadow?: boolean | undefined;
+    /**
+     * 用于测试的标识符，会传递到卡片根容器元素。
+     */
+    "data-testid"?: string | undefined;
 } & React.DOMAttributes<HTMLDivElement> & {
     children?: React.ReactNode;
 } & React.RefAttributes<HTMLDivElement>>;

package/dist/src/core/Cascader/cascader.type.d.ts

@@ -16,6 +16,8 @@ export type PresetCascaderRenderProps = {
     };
 };
 export type CascaderProps = Antd5CascaderProps & {
+    /** Test ID for automated testing */
+    "data-testid"?: string;
     /**
      * 自定义下拉菜单内容，具体可以参考[antd5](https://ant.design/components/cascader-cn/#API)
      * 注意：如果需要自定义下拉菜单，会覆盖掉已有的 header / footer 表现。

package/dist/src/core/Checkbox/index.d.ts

@@ -3,6 +3,6 @@ import React, { ReactNode } from "react";
 declare const Checkbox: React.FC<CheckboxProps & {
     description?: ReactNode;
     compact?: boolean;
-    "data-test"?: string;
+    "data-testid"?: string;
 }>;
 export default Checkbox;

package/dist/src/core/DetailCard/detailCard.type.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="react" />
 export interface IDetailCardProps {
     title?: React.ReactNode;
+    "data-testid"?: string;
 }

package/dist/src/core/DonutChart/index.d.ts

@@ -8,6 +8,7 @@ export declare enum DonutChartColor {
     PURPLE = "purple"
 }
 export type IDonutChartProps = {
+    "data-testid"?: string;
     /**
      * 默认支持单色系展示，如果是单色系直接传入颜色类型
      */

package/dist/src/core/DropdownMenu/dropdownMenu.type.d.ts

@@ -9,6 +9,7 @@ export interface IDropDownMenuItem {
     onClick?: () => void;
     danger?: boolean;
     tooltip?: string;
+    "data-testid"?: string;
 }
 export type Placement = "topLeft" | "topCenter" | "topRight" | "bottomLeft" | "bottomCenter" | "bottomRight";
 export interface IDropdownMenuProps {
@@ -25,4 +26,5 @@ export interface IDropdownMenuProps {
     slotsElements: {
         trigger?: (args: object) => string | React.ReactNode;
     };
+    "data-testid"?: string;
 }

package/dist/src/core/DropdownMenu/index.d.ts

@@ -10,6 +10,7 @@ interface IItem {
     onClick?: () => void;
     danger?: boolean;
     tooltip?: string;
+    "data-testid"?: string;
 }
 export declare const RenderMenuItem: (item: IItem & {
     title?: string;

package/dist/src/core/Duration/duration.type.d.ts

@@ -4,6 +4,11 @@ import { DurationUnitType, FormatDurationItem } from "../../utils/formatDuration
 import { RawValue } from "../Units/units.type";
 /**
  * Duration 组件的属性类型
+ *
+ * data-testid 在空态（Empty）和 noUnitOnZero 分支生效。
+ * 默认渲染分支（多单位拼接）和 contentRender 分支返回 Fragment，不支持 data-testid。
+ * 需要 data-testid 时，请在 Duration 外层自行包一层 wrapper 并设置 data-testid。
+ * 使用 contentRender 时，也可在 contentRender 返回的根元素上自行设置 data-testid。
  */
 export interface DurationProps extends Omit<RawValue, "decimals"> {
     /**
@@ -25,13 +30,15 @@ export interface DurationProps extends Omit<RawValue, "decimals"> {
      */
     emptyProps?: IEmptyProps;
     /**
-     * 自定义返回结果的渲染
-     * 当提供此函数时，将使用自定义渲染函数来渲染持续时间，而不是使用默认的渲染方式
+     * 自定义返回结果的渲染。
+     * 当提供此函数时，将使用自定义渲染函数来渲染持续时间，而不是使用默认的渲染方式。
+     * 注意：使用 contentRender 时，组件不会透传 data-testid，
+     * 调用方需要在返回的根元素上自行设置 data-testid。
      * @param parts 格式化后的持续时间数组，每个元素包含 value 和 unit
      * @returns 自定义的 React 节点
      * @example
      * contentRender={(parts) => (
-     *   <div>
+     *   <div data-testid="my-duration">
      *     {parts.map((part, i) => (
      *       <span key={i}>{part.value} {part.unit}</span>
      *     ))}
@@ -39,4 +46,5 @@ export interface DurationProps extends Omit<RawValue, "decimals"> {
      * )}
      */
     contentRender?: (parts: FormatDurationItem[]) => React.ReactNode;
+    "data-testid"?: string;
 }

package/dist/src/core/Empty/index.d.ts

@@ -1,7 +1,8 @@
 import React, { CSSProperties } from "react";
 export interface IEmptyProps {
+    "data-testid"?: string;
     className?: string;
     style?: CSSProperties;
 }
-declare const Empty: (props: IEmptyProps) => React.JSX.Element;
+declare const Empty: ({ className, style, "data-testid": dataTestId, }: IEmptyProps) => React.JSX.Element;
 export default Empty;

package/dist/src/core/Error/index.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
-declare const Error: ({ error }: {
+declare const Error: ({ error, "data-testid": dataTestId, }: {
     error: unknown;
+    "data-testid"?: string | undefined;
 }) => React.JSX.Element;
 export default Error;

package/dist/src/core/FailedLoad/index.d.ts

@@ -5,5 +5,6 @@ declare const FailedLoad: React.FC<{
     refetchText?: string;
     className?: string;
     title?: string;
+    "data-testid"?: string;
 }>;
 export default FailedLoad;

package/dist/src/core/Fields/FieldsBoolean/index.d.ts

@@ -1,4 +1,4 @@
 import React from "react";
 import { FieldBaseProps } from "../fields.type";
-declare const FieldsBoolean: ({ input, children, ...props }: FieldBaseProps) => React.JSX.Element;
+declare const FieldsBoolean: ({ input, children, "data-testid": dataTestId, ...props }: FieldBaseProps) => React.JSX.Element;
 export default FieldsBoolean;

package/dist/src/core/Fields/FieldsDateTime/index.d.ts

@@ -1,4 +1,4 @@
 import React from "react";
 import { FieldBaseProps } from "../fields.type";
-declare const FieldsDateTime: ({ input }: FieldBaseProps) => React.JSX.Element;
+declare const FieldsDateTime: ({ input, "data-testid": dataTestId, }: FieldBaseProps) => React.JSX.Element;
 export default FieldsDateTime;

package/dist/src/core/Fields/FieldsEnum/fieldsEnum.type.d.ts

@@ -16,4 +16,5 @@ export type EnumProps<V = any, T extends HTMLElement = HTMLElement> = {
     disabled?: boolean;
     className?: string;
     dropdownClassName?: string;
+    "data-testid"?: string;
 } & BaseEnumProps;

package/dist/src/core/Fields/FieldsEnum/index.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
 import { EnumProps } from "./fieldsEnum.type";
-declare const FieldsEnum: ({ meta: __, enumValues, emptyLabel, ...restProps }: EnumProps) => React.JSX.Element;
+declare const FieldsEnum: ({ meta: __, enumValues, emptyLabel, "data-testid": dataTestId, ...restProps }: EnumProps) => React.JSX.Element;
 export default FieldsEnum;
 export * from "./fieldsEnum.type";

package/dist/src/core/Fields/FieldsFloat/index.d.ts

@@ -1,4 +1,4 @@
 import React from "react";
 import { FloatFieldProps } from "../../../spec";
-declare const FieldsFloat: ({ input, meta, onBlur, autoComplete, ...props }: FloatFieldProps) => React.JSX.Element;
+declare const FieldsFloat: ({ input, meta, onBlur, autoComplete, "data-testid": dataTestId, ...props }: FloatFieldProps) => React.JSX.Element;
 export default FieldsFloat;

package/dist/src/core/Fields/FieldsInt/index.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
 import { IntFieldProps } from "./fieldsInt.type";
-declare const FieldsInt: ({ input, meta, onBlur, autoComplete, supportNegativeValue, ...props }: IntFieldProps) => React.JSX.Element;
+declare const FieldsInt: ({ input, meta, onBlur, autoComplete, supportNegativeValue, "data-testid": dataTestId, ...props }: IntFieldProps) => React.JSX.Element;
 export default FieldsInt;
 export * from "./fieldsInt.type";

package/dist/src/core/Fields/FieldsInteger/index.d.ts

@@ -1,4 +1,4 @@
 import React from "react";
 import { IntegerFieldProps } from "../../../spec";
-declare const FieldsInteger: ({ meta, input, onBlur, ...props }: IntegerFieldProps) => React.JSX.Element;
+declare const FieldsInteger: ({ meta, input, onBlur, "data-testid": dataTestId, ...props }: IntegerFieldProps) => React.JSX.Element;
 export default FieldsInteger;

package/dist/src/core/Fields/FieldsString/index.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import { FieldBaseProps } from "../fields.type";
 import { StringProps } from "./fieldsString.type";
-declare const FieldsString: ({ input, meta, autoComplete, size, tags, className, allowClear, tagsOverflow, onTagsAllowClearClick, onClick, maxLength, focusIndicator, ...props }: FieldBaseProps & StringProps) => React.JSX.Element;
+declare const FieldsString: ({ input, meta, autoComplete, size, tags, className, allowClear, tagsOverflow, onTagsAllowClearClick, onClick, maxLength, focusIndicator, "data-testid": dataTestId, ...props }: FieldBaseProps & StringProps) => React.JSX.Element;
 export default FieldsString;
 export * from "./fieldsString.type";

package/dist/src/core/Fields/FieldsTextArea/index.d.ts

@@ -1,5 +1,5 @@
 import { TextAreaProps } from "antd/lib/input";
 import React from "react";
 import { FieldBaseProps } from "../fields.type";
-declare const FieldsTextArea: ({ input, meta, onFocusChangeHeight, ...props }: FieldBaseProps & TextAreaProps) => React.JSX.Element;
+declare const FieldsTextArea: ({ input, meta, onFocusChangeHeight, "data-testid": dataTestId, ...props }: FieldBaseProps & TextAreaProps) => React.JSX.Element;
 export default FieldsTextArea;

package/dist/src/core/Fields/FieldsTimePicker/index.d.ts

@@ -1,5 +1,5 @@
 import { TimePickerProps } from "antd/lib/time-picker";
 import React from "react";
 import { FieldBaseProps } from "../fields.type";
-declare const FieldsTimePicker: ({ input, meta, ...props }: FieldBaseProps & TimePickerProps) => React.JSX.Element;
+declare const FieldsTimePicker: ({ input, meta, "data-testid": dataTestId, ...props }: FieldBaseProps & TimePickerProps) => React.JSX.Element;
 export default FieldsTimePicker;

package/dist/src/core/Fields/__test__/data-testid.test.d.ts

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

package/dist/src/core/Fields/fields.type.d.ts

@@ -29,7 +29,7 @@ export interface FieldState<FieldValue> {
     visited?: boolean;
 }
 export type FieldMetaState<FieldValue> = Pick<FieldState<FieldValue>, Exclude<keyof FieldState<FieldValue>, "blur" | "change" | "focus" | "name" | "value">>;
-interface FieldInputProps<FieldValue, T extends HTMLElement = HTMLElement> extends AnyObject {
+export interface FieldInputProps<FieldValue, T extends HTMLElement = HTMLElement> extends AnyObject {
     name: string;
     onBlur: (event?: React.FocusEvent<T>) => void;
     onChange: (event: React.ChangeEvent<T> | any) => void;
@@ -47,5 +47,6 @@ export interface FieldRenderProps<FieldValue, T extends HTMLElement = HTMLElemen
 export type FieldBaseProps<V = any, T extends HTMLElement = HTMLElement> = FieldRenderProps<V, T> & {
     disabled?: boolean;
     className?: string;
+    "data-testid"?: string;
 };
 export {};

package/dist/src/core/Fields/index.d.ts

@@ -1,26 +1,30 @@
 /// <reference types="react" />
 declare const fields: {
-    Int: ({ input, meta, onBlur, autoComplete, supportNegativeValue, ...props }: import("./FieldsInt").IntFieldProps) => import("react").JSX.Element;
-    Integer: ({ meta, input, onBlur, ...props }: import("../..").IntegerFieldProps) => import("react").JSX.Element;
-    Float: ({ input, meta, onBlur, autoComplete, ...props }: import("../..").FloatFieldProps) => import("react").JSX.Element;
-    DateTime: ({ input }: import("./fields.type").FieldBaseProps) => import("react").JSX.Element;
-    TimePicker: ({ input, meta, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
+    Int: ({ input, meta, onBlur, autoComplete, supportNegativeValue, "data-testid": dataTestId, ...props }: import("./FieldsInt").IntFieldProps) => import("react").JSX.Element;
+    Integer: ({ meta, input, onBlur, "data-testid": dataTestId, ...props }: import("../..").IntegerFieldProps) => import("react").JSX.Element;
+    Float: ({ input, meta, onBlur, autoComplete, "data-testid": dataTestId, ...props }: import("../..").FloatFieldProps) => import("react").JSX.Element;
+    DateTime: ({ input, "data-testid": dataTestId, }: import("./fields.type").FieldBaseProps) => import("react").JSX.Element;
+    TimePicker: ({ input, meta, "data-testid": dataTestId, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
         disabled?: boolean | undefined;
         className?: string | undefined;
+        "data-testid"?: string | undefined;
     } & import("antd/lib/time-picker").TimePickerProps) => import("react").JSX.Element;
-    Enum: ({ meta: __, enumValues, emptyLabel, ...restProps }: import("./FieldsEnum").EnumProps) => import("react").JSX.Element;
-    String: ({ input, meta, autoComplete, size, tags, className, allowClear, tagsOverflow, onTagsAllowClearClick, onClick, maxLength, focusIndicator, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
+    Enum: ({ meta: __, enumValues, emptyLabel, "data-testid": dataTestId, ...restProps }: import("./FieldsEnum").EnumProps) => import("react").JSX.Element;
+    String: ({ input, meta, autoComplete, size, tags, className, allowClear, tagsOverflow, onTagsAllowClearClick, onClick, maxLength, focusIndicator, "data-testid": dataTestId, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
         disabled?: boolean | undefined;
         className?: string | undefined;
+        "data-testid"?: string | undefined;
     } & import("./FieldsString").StringProps) => import("react").JSX.Element;
-    Boolean: ({ input, children, ...props }: import("./fields.type").FieldBaseProps) => import("react").JSX.Element;
-    TextArea: ({ input, meta, onFocusChangeHeight, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
+    Boolean: ({ input, children, "data-testid": dataTestId, ...props }: import("./fields.type").FieldBaseProps) => import("react").JSX.Element;
+    TextArea: ({ input, meta, onFocusChangeHeight, "data-testid": dataTestId, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
         disabled?: boolean | undefined;
         className?: string | undefined;
+        "data-testid"?: string | undefined;
     } & import("antd/lib/input").TextAreaProps) => import("react").JSX.Element;
     DateTimeRange: import("react").FC<import("./fields.type").FieldRenderProps<any, HTMLElement> & {
         disabled?: boolean | undefined;
         className?: string | undefined;
+        "data-testid"?: string | undefined;
     } & import("antd/lib/date-picker").DatePickerProps>;
 };
 export default fields;

package/dist/src/core/FormItem/index.d.ts

@@ -1,4 +1,6 @@
 import { FormItemProps } from "antd/lib/form";
 import React from "react";
-declare const FormItem: (props: React.PropsWithChildren<FormItemProps>) => React.ReactElement;
+declare const FormItem: (props: React.PropsWithChildren<FormItemProps> & {
+    "data-testid"?: string;
+}) => React.ReactElement;
 export default FormItem;

package/dist/src/core/ImmersiveDialog/type.d.ts

@@ -148,4 +148,9 @@ export type ImmersiveDialogProps = React.PropsWithChildren<AntdModalProps & {
      * 失败时设 initializing=false 并设置 initializingError。
      */
     initializingError?: string | React.ReactNode;
+    /**
+     * 测试标识符前缀，用于自动化测试定位元素。
+     * 派生子 testid：`${testId}-cancel`、`${testId}-ok`、`${testId}-close`
+     */
+    "data-testid"?: string;
 }>;

package/dist/src/core/Input/input.type.d.ts

@@ -12,7 +12,12 @@ export interface AdditionOptions {
      * 开启 control 后，不会显示 suffix
      */
     suffix?: string;
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
 }
 export type InputProps = AntdInputProps & {
     error?: boolean;
+    "data-testid"?: string;
 };

package/dist/src/core/InputPassword/index.d.ts

@@ -1,10 +1,15 @@
 import { PasswordProps } from "antd/lib/input";
 import React from "react";
 export declare const AntdPasswordInputStyled: import("@linaria/react").StyledMeta & React.ForwardRefExoticComponent<PasswordProps & React.RefAttributes<unknown>>;
-declare const InputPassword: React.FC<PasswordProps & {
+export type InputPasswordProps = PasswordProps & {
     /**
      * 使用变量控制是否显示 error 效果
      */
     error?: boolean;
-}>;
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
+};
+declare const InputPassword: React.FC<InputPasswordProps>;
 export default InputPassword;

package/dist/src/core/LegacySelect/select.type.d.ts

@@ -9,6 +9,7 @@ export type KitLegacySelectProps = {
     scrollBottomBuffer?: number;
     onScrollBottom?: () => void;
     selectLimit?: number;
+    "data-testid"?: string;
 } & AntdSelectProps<string>;
 export interface LooseFieldRenderProps<V, T extends HTMLElement> {
     input: {

package/dist/src/core/Legend/legend.type.d.ts

@@ -22,4 +22,6 @@ export type LegendComponentType = React.FC<{
     key?: string | number;
     /** Callback function triggered when the legend item is clicked */
     onClick?: (e: React.MouseEvent<HTMLDivElement>, key?: string | number) => void;
+    /** Test ID for automated testing */
+    "data-testid"?: string;
 }>;

package/dist/src/core/LineChart/type.d.ts

@@ -88,6 +88,10 @@ export interface ILineChartLegend {
  * @description 用于展示时序数据的折线图组件，支持多种展示模式和交互功能
  */
 export type LineChartProps = {
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
     /**
      * 图表高度
      * @default 154

package/dist/src/core/LocalUpload/LocalUpload.type.d.ts

@@ -124,6 +124,10 @@ export type LocalUploadFileInfoProps = {
 export type LocalUploadProps = {
     /** 自定义类名 */
     className?: string;
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
     /** 标签 */
     label?: React.ReactNode;
     /** 描述文本 */

package/dist/src/core/Metric/index.d.ts

@@ -12,6 +12,7 @@ export type MetricProps = {
         unit: TimeUnit;
     } | string;
     chartProps: Omit<IChartProps, "uuid">;
+    "data-testid"?: string;
 };
 declare const Metric: (props: MetricProps) => React.JSX.Element;
 export default Metric;

package/dist/src/core/Nav/nav.type.d.ts

@@ -14,4 +14,6 @@ export type NavProps = {
     center?: React.ReactNode[];
     isScrolled?: boolean;
     navRef?: React.RefObject<HTMLHeadElement>;
+    className?: string;
+    "data-testid"?: string;
 };

package/dist/src/core/Pagination/pagination.type.d.ts

@@ -1,4 +1,5 @@
 export interface PaginationProps {
+    "data-testid"?: string;
     current: number;
     count: number;
     size: number;

package/dist/src/core/Progress/progress.type.d.ts

@@ -82,4 +82,8 @@ export type ProgressProps = {
     rightBottom?: React.ReactNode;
     size?: "small" | "large";
     style?: React.CSSProperties;
+    /**
+     * 用于测试的标识符，会传递到进度条根容器元素。
+     */
+    "data-testid"?: string;
 };

package/dist/src/core/Radio/index.d.ts

@@ -2,7 +2,9 @@ import { RadioGroupProps as AntdRadioGroupProps } from "antd/lib/radio";
 import React from "react";
 import { RadioButtonProps, RadioProps } from "./radio.type";
 declare const Radio: React.FC<RadioProps>;
-declare const RadioGroup: React.FC<AntdRadioGroupProps>;
+declare const RadioGroup: React.FC<AntdRadioGroupProps & {
+    "data-testid"?: string;
+}>;
 declare const RadioButton: React.FC<RadioButtonProps>;
 export { RadioButton, RadioGroup };
 export default Radio;

package/dist/src/core/Radio/radio.type.d.ts

@@ -4,6 +4,7 @@ import { RadioButtonProps as AntdRadioButtonProps } from "antd/lib/radio/radioBu
 export type RadioProps = AntdRadioProps & {
     description?: React.ReactNode;
     compact?: boolean;
+    "data-testid"?: string;
 };
 export type RadioButtonProps = AntdRadioButtonProps & {
     type?: "input" | "input-number";
@@ -13,4 +14,5 @@ export type RadioButtonProps = AntdRadioButtonProps & {
     placeholder?: string;
     initialValue?: string | number;
     onInputChange?: (val: number | string | undefined) => void;
+    "data-testid"?: string;
 };

package/dist/src/core/SearchInput/SearchInput.type.d.ts

@@ -58,6 +58,10 @@ import { SrcType } from "../BaseIcon";
  * @see Cascader 级联选择器（内置了 SearchInput 作为搜索区域）
  */
 export type SearchInputProps = Omit<InputProps, "value" | "onChange"> & {
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
     /**
      * 输入框的值，用于受控模式。
      * 配置 value 时，需把 debounceWait 设置为 0，否则输入时会有卡顿的问题

package/dist/src/core/SegmentControl/segmentControl.type.d.ts

@@ -1,4 +1,6 @@
 import { SegmentedProps as AntdSegmentedProps } from "antd5";
 export interface ISegmentedControlProps extends Omit<AntdSegmentedProps, "ref"> {
     size?: "small" | "middle";
+    /** Test ID for automated testing */
+    "data-testid"?: string;
 }

package/dist/src/core/SimplePagination/simplePagination.type.d.ts

@@ -4,4 +4,5 @@ export interface ISimplePaginationProps {
     count: number;
     size: number;
     onPageChange?: (page: number) => void;
+    "data-testid"?: string;
 }

package/dist/src/core/SmallDialog/SmallDialog.type.d.ts

@@ -175,4 +175,9 @@ export interface SmallDialogProps {
      * @default 2
      */
     initializingSkeletonRows?: number;
+    /**
+     * 测试标识符前缀，用于自动化测试定位元素。
+     * 派生子 testid：`${testId}-cancel`（取消按钮）、`${testId}-ok`（确认按钮）、`${testId}-close`（关闭按钮）
+     */
+    "data-testid"?: string;
 }

package/dist/src/core/SmallDialog/index.d.ts

@@ -1,3 +1,3 @@
 export * from "./SmallDialog";
-export * from "./SmallDialog.type";
 export * from "./SmallDialog.style";
+export * from "./SmallDialog.type";

package/dist/src/core/StepProgress/stepProgress.type.d.ts

@@ -2,4 +2,5 @@ export interface ICircleProgressProps {
     percent: number;
     color?: string;
     className?: string;
+    "data-testid"?: string;
 }

package/dist/src/core/Steps/steps.type.d.ts

@@ -5,6 +5,7 @@ export type StepProps = {
     title: string;
     style?: React.CSSProperties;
     disabled?: boolean;
+    "data-testid"?: string;
 };
 export type IStepsProps = {
     className?: string;