@cloudtower/eagle 0.0.0-testid-rc-0 → 0.0.0-theme-rc-1

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

@@ -0,0 +1,169 @@
+/// <reference types="react" />
+import { ImmersiveDialogProps } from "../../core/ImmersiveDialog/type";
+/**
+ * 基于 ImmersiveDialog 的多步骤向导对话框。
+ *
+ * @description
+ * 自动管理步骤导航、步骤指示器和按钮文案切换。
+ * 非最后一步时，确定按钮显示"下一步"并触发 `onNextStep`；
+ * 最后一步时显示"确定"并触发 `onOk`。左侧面板默认渲染垂直步骤条。
+ * 通过 `usePushModal` 打开。
+ *
+ * @example
+ * ```tsx
+ * // 基础三步向导——创建集群
+ * import { WizardDialog } from "@cloudtower/eagle";
+ * import { usePushModal } from "@cloudtower/eagle/KitStoreProvider";
+ *
+ * const pushModal = usePushModal();
+ *
+ * pushModal({
+ *   component: () => (
+ *     <WizardDialog
+ *       title="创建集群"
+ *       steps={[
+ *         { title: "基本信息", children: <ClusterBasicForm /> },
+ *         { title: "网络配置", children: <ClusterNetworkForm /> },
+ *         { title: "确认创建", children: <ClusterConfirmPanel /> },
+ *       ]}
+ *       onOk={(e) => handleCreate()}
+ *     />
+ *   ),
+ *   props: { name: "CreateClusterWizard" },
+ * });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 带步骤校验的向导——onNextStep 返回 false 阻止导航
+ * <WizardDialog
+ *   title="创建虚拟机"
+ *   steps={steps}
+ *   onNextStep={(nextStep) => {
+ *     if (!validateCurrentStep()) {
+ *       message.error("请完善当前步骤的必填项");
+ *       return false; // 阻止跳转到下一步
+ *     }
+ *   }}
+ *   onOk={(e) => handleSubmit()}
+ * />
+ * ```
+ *
+ * 继承 `closeDisabled`：禁用右上角关闭按钮及 Escape、遮罩关闭；footer 和步骤导航需单独控制。
+ *
+ * 注意以下继承属性在 WizardDialog 中有特殊行为：
+ * - `footerLeftAction`：WizardDialog 内部使用此属性渲染"上一步"按钮，外部传入会被覆盖。
+ * - `isContentFull`：WizardDialog 内部强制设为 `false`，外部传入无效。
+ *
+ * @see ImmersiveDialog 基础全屏对话框组件
+ * @see Steps 步骤条组件
+ */
+export type WizardDialogProps = ImmersiveDialogProps & {
+    /**
+     * 当前步骤索引（从 0 开始）。
+     *
+     * @description
+     * 传入此属性时进入受控模式，步骤切换完全由外部状态驱动；
+     * 不传时为非受控模式，组件内部自动管理当前步骤。
+     *
+     * @default 0
+     */
+    step?: number;
+    /**
+     * 步骤配置数组，每项定义一个向导步骤。
+     *
+     * @description
+     * 每个步骤包含 `title`（显示在左侧步骤条中的标题）和
+     * `children`（该步骤的主体内容，通常为表单或信息面板）。
+     * 步骤数量决定导航行为：非最后一步点击确定按钮触发 `onNextStep`，
+     * 最后一步触发 `onOk`。
+     */
+    steps?: {
+        /** 步骤标题，显示在左侧垂直步骤条中 */
+        title: string;
+        /** 步骤内容，通常为表单或信息展示面板 */
+        children: React.ReactNode;
+        /** 测试标识，挂在对应的 step item 上 */
+        "data-testid"?: string;
+    }[];
+    /**
+     * 是否隐藏左侧步骤指示器。
+     *
+     * @description
+     * 设为 `true` 时不渲染默认的垂直步骤条。
+     * 可配合 `left` 属性放置自定义的步骤指示器或其他导航内容。
+     *
+     * @default false
+     */
+    hideSteps?: boolean;
+    /**
+     * 左侧面板自定义内容。
+     *
+     * @description
+     * 传入后将替换默认的步骤指示器。常用于自定义步骤导航样式。
+     */
+    left?: React.ReactNode;
+    /**
+     * 右侧面板自定义内容。
+     *
+     * @description
+     * 渲染在主内容区域右侧的额外面板。
+     */
+    right?: React.ReactNode;
+    /**
+     * 是否销毁非当前步骤的内容。
+     *
+     * @description
+     * - `true`：仅渲染当前步骤，切换时销毁前一步骤的 DOM，节省内存。
+     * - `false`：所有步骤始终保留在 DOM 中，通过 `display: none` 隐藏非当前步骤。
+     *   适用于需要保留表单状态的场景（如用户在步骤间来回切换时不丢失已填写的数据）。
+     *
+     * @default false
+     */
+    destroyOtherStep?: boolean;
+    /**
+     * "上一步"按钮的自定义文本。
+     *
+     * @default t("common.prev_step")（i18n：上一步 / Previous）
+     */
+    prevText?: string;
+    /**
+     * 点击"上一步"按钮时的回调。
+     *
+     * @param step - 即将跳转到的步骤索引（当前步骤 - 1）
+     */
+    onPrevStep?: (step: number) => void;
+    /**
+     * "下一步"按钮的自定义文本。
+     *
+     * @description
+     * 仅在非最后一步时显示，替换确定按钮的默认"下一步"文案。
+     *
+     * @default t("common.next_step")（i18n：下一步 / Next）
+     */
+    nextText?: string;
+    /**
+     * 点击"下一步"时的回调，支持阻止导航。
+     *
+     * @description
+     * 在非最后一步点击确定按钮时触发。这是实现步骤校验的核心机制：
+     * - 返回 `false` 将**阻止**导航到下一步（可用于表单校验失败时阻止前进）。
+     * - 返回 `void`（不返回值）或返回非 `false` 值时正常跳转到下一步。
+     *
+     * 注意：仅严格等于 `false`（`=== false`）时才阻止，返回 `undefined` 或其他假值不会阻止。
+     *
+     * @param step - 即将跳转到的步骤索引（当前步骤 + 1）
+     * @returns 返回 `false` 阻止导航，返回 `void` 允许导航
+     */
+    onNextStep?: (step: number) => void | boolean;
+    /**
+     * 步骤发生变化时的回调。
+     *
+     * @description
+     * 无论是通过"上一步"、"下一步"按钮，还是点击左侧步骤条直接跳转，
+     * 步骤变化后都会触发此回调。适合用于同步外部状态或埋点。
+     *
+     * @param step - 变化后的新步骤索引
+     */
+    onStepChange?: (step: number) => void;
+};

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

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

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

@@ -0,0 +1,184 @@
+/// <reference types="react" />
+export * from "./AccordionCard";
+export * from "./Alert";
+export * from "./Antd5Anchor";
+export * from "./Antd5Dropdown";
+export * from "./Antd5Flex";
+export * from "./Antd5Tree";
+export * from "./Arch";
+export * from "./AutoComplete";
+export * from "./Badge";
+export * from "./Banner";
+export * from "./BaseIcon";
+export * from "./BasicCTError";
+export * from "./Bit";
+export * from "./BitPerSecond";
+export * from "./BlankState";
+export * from "./Bps";
+export * from "./Breadcrumb";
+export * from "./Button";
+export * from "./ButtonGroup";
+export * from "./Byte";
+export * from "./BytePerSecond";
+export * from "./Calendar";
+export * from "./Card";
+export * from "./Cascader";
+export * from "./Checkbox";
+export * from "./ConfigProvider";
+export * from "./DeprecatedProgress";
+export * from "./DetailCard";
+export * from "./DonutChart";
+export * from "./DropdownMenu";
+export * from "./Duration";
+export * from "./Empty";
+export * from "./ErrorBoundary";
+export * from "./ExpandableList";
+export * from "./FailedLoad";
+export * from "./Fields";
+export * from "./Form";
+export * from "./FormItem";
+export * from "./Frequency";
+export * from "./Icon";
+export * from "./ImmersiveDialog";
+export * from "./Input";
+export * from "./InputGroup";
+export * from "./InputInteger";
+export * from "./InputNumber";
+export * from "./InputPassword";
+export * from "./InputTagItem";
+export * from "./KitStoreProvider";
+export * from "./LegacyModal";
+export * from "./LegacySelect";
+export * from "./Legend";
+export * from "./LineChart";
+export * from "./Link";
+export * from "./Loading";
+export * from "./LocalUpload";
+export * from "./LogView";
+export * from "./MediumDialog";
+export * from "./message";
+export * from "./message-group";
+export * from "./Metric";
+export * from "./ModalStack";
+export * from "./Overflow";
+export * from "./Pagination";
+export * from "./ParrotTrans";
+export * from "./Percent";
+export * from "./Progress";
+export * from "./Radio";
+export * from "./SearchInput";
+export * from "./Second";
+export * from "./SegmentControl";
+export * from "./Select";
+export * from "./SidebarMenu";
+export * from "./SimplePagination";
+export * from "./Skeleton";
+export * from "./SmallDialog";
+export * from "./Space";
+export * from "./Speed";
+export * from "./StatusCapsule";
+export * from "./StepProgress";
+export * from "./Steps";
+export * from "./Styled";
+export * from "./Switch";
+export * from "./Tab";
+export * from "./Table";
+export * from "./TableForm";
+export * from "./Tag";
+export * from "./TextArea";
+export * from "./Time";
+export * from "./Timeline";
+export * from "./TimePicker";
+export * from "./TimeZoneSelect";
+export * from "./Token";
+export * from "./Tooltip";
+export * from "./Truncate";
+export * from "./Typo";
+export * from "./Units";
+export * from "./WizardDialog";
+export declare const units: {
+    Percent: import("./Units").PercentFn;
+    Byte: import("./Units").UnitFn;
+    BytePerSecond: import("./Units").UnitFn;
+    Frequency: import("./Units").UnitFn;
+    Speed: import("./Units").UnitFn;
+    Bps: import("./Units").UnitFn;
+    BitPerSecond: import("./Units").UnitFn;
+    Bit: import("./Units").UnitFn;
+    Second: import("./Units").UnitFn;
+    Duration: import("react").FC<import("./Duration/duration.type").DurationProps>;
+};
+export { units as Units };
+export { default as AccordionCard } from "./AccordionCard";
+export { default as Alert } from "./Alert";
+export { default as Antd5Anchor } from "./Antd5Anchor";
+export { default as Arch } from "./Arch";
+export { default as Avatar } from "./Avatar";
+export { default as Badge } from "./Badge";
+export { default as BaseIcon } from "./BaseIcon";
+export { default as Bit } from "./Bit";
+export { default as BitPerSecond } from "./BitPerSecond";
+export { default as BlankState } from "./BlankState";
+export { default as Bps } from "./Bps";
+export { default as Breadcrumb } from "./Breadcrumb";
+export { default as Button } from "./Button";
+export { default as ButtonGroup } from "./ButtonGroup";
+export { default as Byte } from "./Byte";
+export { default as BytePerSecond } from "./BytePerSecond";
+export { default as Calendar } from "./Calendar";
+export { default as Card } from "./Card";
+export { default as Checkbox } from "./Checkbox";
+export { default as DeprecatedProgress } from "./DeprecatedProgress";
+export { default as DetailCard } from "./DetailCard";
+export { default as DonutChart } from "./DonutChart";
+export { default as DropdownMenu } from "./DropdownMenu";
+export { default as Duration } from "./Duration";
+export { default as Empty } from "./Empty";
+export { default as Error } from "./Error";
+export { default as ErrorBoundary } from "./ErrorBoundary";
+export { default as FailedLoad } from "./FailedLoad";
+export { default as Fields } from "./Fields";
+export { default as Form } from "./Form";
+export { default as FormItem } from "./FormItem";
+export { default as Frequency } from "./Frequency";
+export { default as Icon } from "./Icon";
+export { default as Input } from "./Input";
+export { default as InputGroup } from "./InputGroup";
+export { default as InputInteger } from "./InputInteger";
+export { default as InputNumber } from "./InputNumber";
+export { default as InputPassword } from "./InputPassword";
+export { default as InputTagItem } from "./InputTagItem";
+export { default as KitStoreProvider } from "./KitStoreProvider";
+export { default as LegacyModal } from "./LegacyModal";
+export { default as LegacySelect } from "./LegacySelect";
+export { default as Legend } from "./Legend";
+export { default as LineChart } from "./LineChart";
+export { default as Link } from "./Link";
+export { default as Loading } from "./Loading";
+export { default as message } from "./message";
+export { default as Metric } from "./Metric";
+export { default as ModalStack } from "./ModalStack";
+export { default as Nav } from "./Nav";
+export { default as Overflow } from "./Overflow";
+export { default as Pagination } from "./Pagination";
+export { default as Percent } from "./Percent";
+export { default as Radio } from "./Radio";
+export { default as Second } from "./Second";
+export { default as SegmentControl } from "./SegmentControl";
+export { default as Select } from "./Select";
+export { default as SimplePagination } from "./SimplePagination";
+export { default as Space } from "./Space";
+export { default as Speed } from "./Speed";
+export { default as StatusCapsule } from "./StatusCapsule";
+export { default as Steps } from "./Steps";
+export { default as Switch } from "./Switch";
+export { default as Table } from "./Table";
+export { default as TableForm } from "./TableForm";
+export { default as Tag } from "./Tag";
+export { default as TextArea } from "./TextArea";
+export { default as Time } from "./Time";
+export { default as TimePicker } from "./TimePicker";
+export { default as TimeZoneSelect } from "./TimeZoneSelect";
+export { default as Token } from "./Token";
+export { default as Tooltip } from "./Tooltip";
+export { default as Truncate } from "./Truncate";

package/dist/src/core/message/__tests__/index.test.d.ts

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

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

@@ -0,0 +1,4 @@
+import api from "./message";
+export * from "./message";
+export * from "./useMessage";
+export default api;

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

@@ -0,0 +1,58 @@
+import * as React from "react";
+import { type ConfigProps } from "../ConfigProvider";
+type NoticeType = "info" | "success" | "error" | "warning" | "loading";
+export declare const DEFAULT_DURATION = 3;
+export declare function getKeyThenIncreaseKey(): number;
+export interface ConfigOptions {
+    top?: number;
+    duration?: number;
+    prefixCls?: string;
+    getContainer?: () => HTMLElement;
+    transitionName?: string;
+    maxCount?: number;
+    rtl?: boolean;
+    /**
+     * ConfigProvider 的配置，用于在 message 中传递 context
+     */
+    configProviderProps?: ConfigProps;
+}
+export interface ThenableArgument {
+    (val: any): void;
+}
+export interface MessageType {
+    (): void;
+    then: (fill: ThenableArgument, reject: ThenableArgument) => Promise<void>;
+    promise: Promise<void>;
+}
+export interface ArgsProps {
+    content: React.ReactNode;
+    duration: number | null;
+    type?: NoticeType;
+    prefixCls?: string;
+    onClose?: () => void;
+    icon?: React.ReactNode;
+    key?: string | number;
+    style?: React.CSSProperties;
+    className?: string;
+}
+type ConfigContent = React.ReactNode | string;
+type ConfigDuration = number | (() => void);
+type JointContent = ConfigContent | ArgsProps;
+export type ConfigOnClose = () => void;
+export declare function attachTypeApi(originalApi: any, type: string): void;
+export interface MessageInstance {
+    info(content: JointContent, duration?: ConfigDuration, onClose?: ConfigOnClose): MessageType;
+    success(content: JointContent, duration?: ConfigDuration, onClose?: ConfigOnClose): MessageType;
+    error(content: JointContent, duration?: ConfigDuration, onClose?: ConfigOnClose): MessageType;
+    warning(content: JointContent, duration?: ConfigDuration, onClose?: ConfigOnClose): MessageType;
+    loading(content: JointContent, duration?: ConfigDuration, onClose?: ConfigOnClose): MessageType;
+    open(args: ArgsProps): MessageType;
+}
+export interface MessageApi extends MessageInstance {
+    warn(content: JointContent, duration?: ConfigDuration, onClose?: ConfigOnClose): MessageType;
+    config(options: ConfigOptions): void;
+    destroy(): void;
+    useMessage(): [MessageInstance, React.ReactElement];
+}
+declare const _default: MessageApi;
+export default _default;

package/dist/src/core/message/useMessage.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import { MessageApi } from "./message";
+export declare const MessageContext: import("react").Context<MessageApi>;
+export declare const useMessage: () => MessageApi;

package/dist/src/core/message-group/__test__/message-group.test.d.ts

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

package/dist/src/core/message-group/index.d.ts

@@ -0,0 +1,27 @@
+import { MessageApi } from "../../core/message";
+import { ArgsProps, ConfigOnClose, MessageType } from "antd/lib/message";
+import { ReactNode } from "react";
+export declare function makeUUID(length?: number): string;
+export type BatchHelper = {
+    getBatchKey: (content: ReactNode) => string | undefined;
+    getBatchContent: (batchKey: string, count: number) => ReactNode;
+};
+type KeyedArgsProps = ArgsProps & {
+    key: string;
+};
+declare type ConfigContent = React.ReactNode | string;
+declare type ConfigDuration = number | (() => void);
+declare type JointContent = ConfigContent | ArgsProps;
+type OriginalMethod = (content: JointContent, duration?: ConfigDuration, onClose?: ConfigOnClose) => MessageType;
+export declare class Batcher {
+    private batchSize;
+    private batchTime;
+    private scheduler;
+    private originalMethod;
+    private batchHelper;
+    constructor(originalMethod: OriginalMethod, batchHelper: BatchHelper);
+    addMessage(originContent: KeyedArgsProps): void;
+    private applyContent;
+}
+export declare function createBatchMessageMethods(message: MessageApi, batchHelper: BatchHelper): MessageApi;
+export {};

package/dist/src/coreX/BarChart/index.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+export declare function getWidth(input: number): string;
+export interface IBarChartProps {
+    data: Array<{
+        value: number;
+        color: string;
+        shape?: "stripes" | "fill";
+    }>;
+    total: number;
+    className?: string;
+}
+declare const BarChart: React.FC<IBarChartProps>;
+export default BarChart;

package/dist/src/coreX/BatchOperation/batchOperation.type.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="react" />
+export type NormalAction = {
+    key: string;
+    icon?: React.ReactElement;
+    title: string;
+    onClick: () => void;
+    danger?: boolean;
+    count?: number;
+    disabled?: boolean;
+    tooltip?: string;
+};
+type SubAction = {
+    key: string;
+    icon?: React.ReactElement;
+    title: string;
+    children: Array<Action>;
+    danger?: boolean;
+    canMove?: {
+        id: string;
+    }[];
+    canDelete?: {
+        id: string;
+    }[];
+};
+export type Action = NormalAction | SubAction | "divider";
+export interface IBatchOperation {
+    count: number;
+    onClearSelection: () => void;
+    actions: Action[];
+}
+export {};

package/dist/src/coreX/BatchOperation/index.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import { Action } from "./batchOperation.type";
+export declare const renderBatchOperationMenuItem: (act: Action, idx?: number) => React.JSX.Element;
+declare const BatchOperation: React.FC<{
+    count: number;
+    onClearSelection: () => void;
+    actions: Action[];
+}>;
+export default BatchOperation;
+export * from "./batchOperation.type";

package/dist/src/coreX/ChartWithTooltip/index.d.ts

@@ -0,0 +1,40 @@
+import { ChartType, IUnitWithChartProps } from "../../coreX/UnitWithChart";
+import React from "react";
+export interface ICWTProps {
+    title: {
+        label: string;
+        value?: number | null;
+    };
+    items: {
+        label: string;
+        color: string;
+        value: number;
+        saturated?: boolean;
+    }[];
+    rawValue?: number | null;
+    unit: IUnitWithChartProps["unit"];
+    chartType?: ChartType;
+    /**
+     * pass the parameter if table cell unit different with tooltip
+     */
+    tableUnit?: IUnitWithChartProps["unit"];
+    saturated?: boolean;
+}
+export type IChartWithUnitProps = {
+    total: number;
+    items: {
+        label: string;
+        color: string;
+        value: number;
+    }[];
+    rawValue?: number | null;
+    unit: IUnitWithChartProps["unit"];
+    chartType?: ChartType;
+    /**
+     * pass the parameter if table cell unit different with tooltip
+     */
+    tableUnit?: IUnitWithChartProps["unit"];
+};
+export declare const ChartWithUnit: React.FC<IChartWithUnitProps>;
+declare const ChartWithTooltip: React.FunctionComponent<ICWTProps>;
+export default ChartWithTooltip;

package/dist/src/coreX/CheckPointList/checkpointlist.style.d.ts

@@ -0,0 +1,3 @@
+export declare const CheckPointListStyle: import("@linaria/core").LinariaClassName;
+export declare const CheckPointItemStyle: import("@linaria/core").LinariaClassName;
+export declare const EmptyWrapper: import("@linaria/core").LinariaClassName;

package/dist/src/coreX/CheckPointList/checkpointlist.type.d.ts

@@ -0,0 +1,113 @@
+import { AlertProps } from "../../core/Alert";
+import { ButtonProps } from "../../core/Button";
+import { IconProps } from "../../core/Icon";
+import { LinkProps } from "../../core/Link";
+import { TagProps } from "../../core/Tag";
+import React from "react";
+/**
+ * 检查点项的属性
+ * @property {React.ReactNode} description - 检查点项的描述文本，用于展示检查内容，支持传入 React 节点
+ * @property {'success' | 'failed' | 'loading' | 'warning'} status - 检查点状态，success 表示通过，failed 表示失败，loading 表示加载中，warning 表示警告
+ * @property {TagProps} [tagProps] - 标签的自定义属性，可以自定义标签的颜色、图标等
+ * @property {AlertProps} [alertProps] - 警告组件的自定义属性，用于展示失败信息及其样式
+ * @example
+ * {
+ *   description: "存储空间检查",
+ *   status: "success",
+ *   tagProps: {
+ *     color: "green",
+ *     children: "通过"
+ *   }
+ * }
+ * @example
+ * {
+ *   description: <span>网络连接检查 <b>(重要)</b></span>,
+ *   status: "failed",
+ *   tagProps: {
+ *     color: "red",
+ *     children: "失败"
+ *   },
+ *   alertProps: {
+ *     message: "网络连接失败",
+ *     type: "error"
+ *   }
+ * }
+ */
+export type CheckPointItemAction = {
+    type: "button";
+    props: ButtonProps;
+} | {
+    type: "link";
+    props: LinkProps;
+} | {
+    type: "icon";
+    props: IconProps;
+};
+export interface CheckPointItem {
+    description: React.ReactNode;
+    status: "success" | "failed" | "loading" | "warning" | "idle";
+    actions?: CheckPointItemAction[];
+    tagProps?: TagProps;
+    alertProps?: AlertProps;
+}
+/**
+ * 检查点列表的属性
+ * @property {CheckPointItem[]} items - 检查点列表的项，包含检查项的描述、状态等信息
+ * @property {boolean} [showSwitchControl=true] - 是否显示切换控制来过滤未通过的项
+ * @property {(checked: boolean) => void} [onClickSwitch] - 切换开关时的回调函数
+ * @property {string | React.ReactNode} title - 自定义检查点列表的标题
+ * @property {string} [switchText] - 自定义开关按钮的文本描述
+ * @property {string | React.ReactNode} [emptyText] - 列表为空时显示的文本
+ * @property {string} [emptyTextClassName] - 空状态文本的自定义类名
+ * @property {(emptyText: string | React.ReactNode) => React.ReactNode} [emptyRender] - 自定义渲染空状态的函数
+ * @property {boolean} [defaultChecked] - 开关的默认选中状态，决定是否默认只显示未通过的检查项
+ * @property {boolean} [border] - 是否显示边框, 默认为显示
+ * @example
+ * {
+ *   title: "系统检查项",
+ *   items: [
+ *     {
+ *       description: "存储空间检查",
+ *       status: "success",
+ *       tagProps: { color: "green", children: "通过" }
+ *     },
+ *     {
+ *       description: "权限检查",
+ *       status: "failed",
+ *       tagProps: { color: "red", children: "失败" },
+ *       alertProps: { message: "当前用户没有管理员权限", type: "error" }
+ *     }
+ *   ],
+ *   showSwitchControl: true,
+ *   switchText: "只显示失败项",
+ *   defaultChecked: true
+ * }
+ * @example
+ * {
+ *   title: "系统检查项",
+ *   items: [],
+ *   emptyText: "暂无检查项",
+ *   emptyTextClassName: "custom-empty-class"
+ * }
+ */
+export interface CheckPointListProps {
+    items: CheckPointItem[];
+    emptyText?: string | React.ReactNode;
+    emptyTextClassName?: string;
+    emptyRender?: (emptyText: string | React.ReactNode) => React.ReactNode;
+    showSwitchControl?: boolean;
+    defaultChecked?: boolean;
+    onClickSwitch?: (checked: boolean) => void;
+    title: string | React.ReactNode;
+    switchText?: string;
+    className?: string;
+    border?: boolean;
+}
+/**
+ * CheckPointItem 组件的属性
+ * @extends CheckPointItem
+ * @property {string} [key] - React 列表项的唯一标识符
+ */
+export interface CheckPointItemProps extends CheckPointItem {
+    key?: string;
+}