@pisell/materials 1.8.11 → 1.8.12

package/lib/components/pisellDateTimeDisplay/components/TimeDisplay.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+import type { Dayjs } from 'dayjs';
+import type { TimeFormatConfig, TextStyleConfig } from '../types';
+/**
+ * TimeDisplay 组件 Props
+ */
+export interface TimeDisplayProps {
+    /**
+     * 时间对象
+     */
+    time: Dayjs;
+    /**
+     * 时间格式配置
+     */
+    format?: TimeFormatConfig;
+    /**
+     * 文本样式
+     */
+    style?: TextStyleConfig;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+}
+/**
+ * 时间展示组件
+ *
+ * @description
+ * - 格式化并展示时间
+ * - 支持 12/24 小时制
+ * - 支持显示秒
+ * - 支持小时补零
+ *
+ * @example
+ * <TimeDisplay
+ *   time={dayjs()}
+ *   format={{ use12Hour: false, showSeconds: true }}
+ *   style={{ fontSize: 24, fontWeight: 600, color: '#000' }}
+ * />
+ */
+export declare const TimeDisplay: React.FC<TimeDisplayProps>;
+export default TimeDisplay;

package/lib/components/pisellDateTimeDisplay/components/WeekdayDisplay.d.ts

@@ -0,0 +1,57 @@
+import React from 'react';
+import type { Dayjs } from 'dayjs';
+import type { WeekdayFormatConfig, TextStyleConfig } from '../types';
+/**
+ * WeekdayDisplay 组件 Props
+ */
+export interface WeekdayDisplayProps {
+    /**
+     * 日期对象（用于获取星期）
+     */
+    weekday: Dayjs;
+    /**
+     * 星期格式配置
+     */
+    format?: WeekdayFormatConfig;
+    /**
+     * 文本样式
+     */
+    style?: TextStyleConfig;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+}
+/**
+ * 星期展示组件
+ *
+ * @description
+ * - 格式化并展示星期
+ * - 支持完整/缩写/单字母模式
+ * - 自动支持中英文
+ *
+ * @example
+ * // 默认（缩写）
+ * <WeekdayDisplay
+ *   weekday={dayjs()}
+ *   format={{ full: false, singleLetter: false }}
+ *   style={{ fontSize: 18, fontWeight: 400, color: '#666' }}
+ * />
+ * // => "Sat" / "周六"
+ *
+ * // 完整
+ * <WeekdayDisplay
+ *   weekday={dayjs()}
+ *   format={{ full: true }}
+ * />
+ * // => "Saturday" / "星期六"
+ *
+ * // 单字母
+ * <WeekdayDisplay
+ *   weekday={dayjs()}
+ *   format={{ singleLetter: true }}
+ * />
+ * // => "S" / "六"
+ */
+export declare const WeekdayDisplay: React.FC<WeekdayDisplayProps>;
+export default WeekdayDisplay;

package/lib/components/pisellDateTimeDisplay/components/index.d.ts

@@ -0,0 +1,6 @@
+export { TimeDisplay } from './TimeDisplay';
+export { DateDisplay } from './DateDisplay';
+export { WeekdayDisplay } from './WeekdayDisplay';
+export type { TimeDisplayProps } from './TimeDisplay';
+export type { DateDisplayProps } from './DateDisplay';
+export type { WeekdayDisplayProps } from './WeekdayDisplay';

package/lib/components/pisellDateTimeDisplay/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export { useCurrentTime } from './useCurrentTime';
+export type { UseCurrentTimeOptions } from './useCurrentTime';

package/lib/components/pisellDateTimeDisplay/utils/formatTime.d.ts

@@ -0,0 +1,19 @@
+import type { Dayjs } from 'dayjs';
+import type { TimeFormatConfig } from '../types';
+/**
+ * 格式化时间
+ * @param time dayjs 时间对象
+ * @param config 时间格式配置
+ * @returns 格式化后的时间字符串
+ *
+ * @example
+ * formatTime(dayjs(), { use12Hour: false, showSeconds: false, padHour: false })
+ * // => "13:45"
+ *
+ * formatTime(dayjs(), { use12Hour: true, showSeconds: false, padHour: true })
+ * // => "01:45 PM"
+ *
+ * formatTime(dayjs(), { use12Hour: false, showSeconds: true, padHour: false })
+ * // => "13:45:30"
+ */
+export declare function formatTime(time: Dayjs, config?: TimeFormatConfig): string;

package/lib/components/pisellDateTimeDisplay/utils/getRefreshInterval.d.ts

@@ -0,0 +1,18 @@
+import type { TimeFormatConfig } from '../types';
+/**
+ * 根据时间格式配置计算刷新间隔
+ * @param timeFormat 时间格式配置
+ * @returns 刷新间隔（毫秒）
+ *
+ * @description
+ * - 显示秒时：1000ms (1秒刷新一次)
+ * - 不显示秒时：60000ms (60秒刷新一次)
+ *
+ * @example
+ * getRefreshInterval({ showSeconds: true })
+ * // => 1000
+ *
+ * getRefreshInterval({ showSeconds: false })
+ * // => 60000
+ */
+export declare function getRefreshInterval(timeFormat?: TimeFormatConfig): number;

package/lib/components/pisellDraggable/components/Action/Action.d.ts

@@ -0,0 +1,10 @@
+import React, { CSSProperties } from 'react';
+import './Action.less';
+export interface Props extends React.HTMLAttributes<HTMLButtonElement> {
+    active?: {
+        fill: string;
+        background: string;
+    };
+    cursor?: CSSProperties['cursor'];
+}
+export declare const Action: React.ForwardRefExoticComponent<Props & React.RefAttributes<HTMLButtonElement>>;

package/lib/components/pisellDraggable/components/Action/index.d.ts

@@ -0,0 +1,2 @@
+export { Action } from './Action';
+export type { Props as ActionProps } from './Action';

package/lib/components/pisellDraggable/components/Handle/Handle.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { ActionProps } from '../Action';
+export declare const Handle: React.ForwardRefExoticComponent<ActionProps & React.RefAttributes<HTMLButtonElement>>;

package/lib/components/pisellDraggable/components/Handle/index.d.ts

@@ -0,0 +1 @@
+export { Handle } from './Handle';

package/lib/components/pisellDraggable/components/Remove/Remove.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { ActionProps } from '../Action';
+export declare function Remove(props: ActionProps): JSX.Element;

package/lib/components/pisellDraggable/components/Remove/index.d.ts

@@ -0,0 +1 @@
+export { Remove } from './Remove';

package/lib/components/pisellDraggable/components/TreeItem/SortableTreeItem.d.ts

@@ -0,0 +1,9 @@
+import type { UniqueIdentifier } from '@dnd-kit/core';
+import React from 'react';
+import { Props as TreeItemProps } from './TreeItem';
+interface Props extends TreeItemProps {
+    id: UniqueIdentifier;
+    __designMode?: string;
+}
+declare const _default: React.MemoExoticComponent<({ id, depth, ...props }: Props) => JSX.Element>;
+export default _default;

package/lib/components/pisellDraggable/components/TreeItem/TreeItem.d.ts

@@ -0,0 +1,24 @@
+import React, { HTMLAttributes } from 'react';
+import type { TreeItem as TreeItemType } from '../../types';
+import './TreeItem.less';
+export interface Props extends Omit<HTMLAttributes<HTMLLIElement>, 'id'> {
+    childCount?: number;
+    clone?: boolean;
+    collapsed?: boolean;
+    depth: number;
+    disableInteraction?: boolean;
+    disableSelection?: boolean;
+    ghost?: boolean;
+    handleProps?: any;
+    indicator?: boolean;
+    indentationWidth: number;
+    onCollapse?(): void;
+    onRemove?(): void;
+    wrapperRef?(node: HTMLLIElement): void;
+    item: TreeItemType;
+    renderItem?(item: Props, ref: React.ForwardedRef<HTMLDivElement>): React.ReactNode;
+    __designMode?: string;
+    isBlocked?: boolean;
+    isError?: boolean;
+}
+export declare const TreeItem: React.ForwardRefExoticComponent<Props & React.RefAttributes<HTMLDivElement>>;

package/lib/components/pisellDraggable/components/TreeItem/index.d.ts

@@ -0,0 +1,2 @@
+export { TreeItem } from './TreeItem';
+export { default as SortableTreeItem } from './SortableTreeItem';

package/lib/components/pisellDraggable/components/index.d.ts

@@ -0,0 +1,4 @@
+export { Action } from './Action';
+export { Handle } from './Handle';
+export { Remove } from './Remove';
+export { TreeItem, SortableTreeItem } from './TreeItem';

package/lib/components/pisellDraggable/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 可拖拽树形组件
+ * 基于@dnd-kit库实现，支持拖拽排序、展开折叠、删除等功能
+ */
+import { UniqueIdentifier } from '@dnd-kit/core';
+import React from 'react';
+import type { FlattenedItem, TreeItem, TreeItems } from './types';
+import type { Props as TreeItemProps } from './components/TreeItem/TreeItem';
+interface Props {
+    /** 是否支持折叠功能 */
+    collapsible?: boolean;
+    /** 初始树形数据，默认使用 initialItems */
+    value?: TreeItems;
+    /** 缩进宽度，控制子节点的缩进距离 */
+    indentationWidth?: number;
+    /** 是否显示拖拽指示器 */
+    indicator?: boolean;
+    /** 是否支持删除节点功能 */
+    removable?: boolean;
+    /** 自定义渲染树节点 */
+    renderItem?: (item: TreeItemProps, ref: React.RefObject<HTMLDivElement>) => React.ReactNode;
+    /** 树形数据变化回调 */
+    onChange?: (items: TreeItems) => void;
+    /** 删除节点前 */
+    onRemoveBefore?: (item: TreeItem) => Promise<boolean>;
+    /** 设计模式 */
+    __designMode?: string;
+    /** 最大层级 */
+    maxLevel?: number;
+    /** 自定义拖拽判断函数，返回false时阻止拖拽 */
+    canDrop?: (dragItem: FlattenedItem, dropTarget: FlattenedItem, parentId: UniqueIdentifier | null, parentNode: any) => boolean;
+}
+export declare function SortableTree({ collapsible, value, indicator, indentationWidth, removable, renderItem, onChange, onRemoveBefore, __designMode, maxLevel, canDrop, }: Props): JSX.Element;
+declare const Demo: (props: Props) => JSX.Element;
+export default Demo;

package/lib/components/pisellDraggable/types.d.ts

@@ -0,0 +1,19 @@
+import type { MutableRefObject } from 'react';
+import type { UniqueIdentifier } from '@dnd-kit/core';
+export interface TreeItem {
+    id: UniqueIdentifier;
+    children: TreeItem[];
+    collapsed?: boolean;
+    disabledDrop?: boolean;
+    [key: string]: any;
+}
+export declare type TreeItems = TreeItem[];
+export interface FlattenedItem extends TreeItem {
+    parentId: UniqueIdentifier | null;
+    depth: number;
+    index: number;
+}
+export declare type SensorContext = MutableRefObject<{
+    items: FlattenedItem[];
+    offset: number;
+}>;

package/lib/components/pisellDraggable/utilities.d.ts

@@ -0,0 +1,17 @@
+import type { UniqueIdentifier } from '@dnd-kit/core';
+import type { FlattenedItem, TreeItem, TreeItems } from './types';
+export declare const iOS: boolean;
+export declare function getProjection(items: FlattenedItem[], activeId: UniqueIdentifier, overId: UniqueIdentifier, dragOffset: number, indentationWidth: number): {
+    depth: number;
+    maxDepth: number;
+    minDepth: number;
+    parentId: UniqueIdentifier | null;
+};
+export declare function flattenTree(items: TreeItems): FlattenedItem[];
+export declare function buildTree(flattenedItems: FlattenedItem[]): TreeItems;
+export declare function findItem(items: TreeItem[], itemId: UniqueIdentifier): TreeItem | undefined;
+export declare function findItemDeep(items: TreeItems, itemId: UniqueIdentifier): TreeItem | undefined;
+export declare function removeItem(items: TreeItems, id: UniqueIdentifier): TreeItem[];
+export declare function setProperty<T extends keyof TreeItem>(items: TreeItems, id: UniqueIdentifier, property: T, setter: (value: TreeItem[T]) => TreeItem[T]): TreeItem[];
+export declare function getChildCount(items: TreeItems, id: UniqueIdentifier): number;
+export declare function removeChildrenOf(items: FlattenedItem[], ids: UniqueIdentifier[]): FlattenedItem[];

package/lib/components/pisellDropSort/PisellDropSort.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { PisellDropSortProps } from './types';
+import './PisellDropSort.less';
+declare const PisellDropSort: React.FC<PisellDropSortProps>;
+export default PisellDropSort;

package/lib/components/pisellDropSort/components/SortableItem/index.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { Props as TreeItem } from '../../../pisellDraggable/components/TreeItem/TreeItem';
+import './index.less';
+interface SortableItemProps {
+    itemProps: TreeItem;
+    render?: (itemProps: TreeItem) => React.ReactNode;
+    domRef: React.RefObject<HTMLDivElement>;
+    allowAddChild?: boolean;
+    allowDelete?: boolean;
+    allowIsShow?: boolean;
+    allowDrag?: boolean;
+    disabled?: boolean;
+    onAdd?: (itemProps: TreeItem) => void;
+    onDelete?: (itemProps: TreeItem) => void;
+    showBorder?: boolean;
+    spacing?: number;
+    maxLevel?: number;
+    /** 设计模式 */
+    __designMode?: string;
+    /** 是否自定义操作 */
+    isCustomAction?: boolean;
+    /** 获取item样式 */
+    getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
+}
+declare const SortableItem: (props: SortableItemProps) => JSX.Element;
+export default SortableItem;

package/lib/components/pisellDropSort/index.d.ts

@@ -0,0 +1,3 @@
+import PisellDropSort from './PisellDropSort';
+export default PisellDropSort;
+export type { PisellDropSortProps, DropSortItem } from './types';

package/lib/components/pisellDropSort/types.d.ts

@@ -0,0 +1,58 @@
+import { CSSProperties } from 'react';
+import type { Props as TreeItem } from '../pisellDraggable/components/TreeItem/TreeItem';
+import type { TreeItem as TreeItemType } from '../pisellDraggable/types';
+export interface DropSortItem extends TreeItemType {
+    [key: string]: any;
+}
+export interface PisellDropSortProps {
+    /** value */
+    value: DropSortItem[];
+    /** 允许拖拽 */
+    allowDrag?: boolean;
+    /** 允许删除 */
+    allowDelete?: boolean;
+    /** 允许添加子节点 */
+    allowAddChild?: boolean;
+    /** 允许添加根节点 */
+    allowAddRoot?: boolean;
+    /** 是否允许显示隐藏 */
+    allowIsShow?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 节点间距 */
+    spacing?: number;
+    /** 最大层级数 */
+    maxLevel?: number;
+    /** 是否显示边框 */
+    showBorder?: boolean;
+    /** 样式 */
+    style?: CSSProperties;
+    /** 类名 */
+    className?: string;
+    /** 数据源变化回调 */
+    onChange?: (items: DropSortItem[]) => void;
+    /** 删除节点回调 */
+    onDelete?: (itemProps: TreeItem) => void;
+    /** 添加节点回调 */
+    onAdd?: (itemProps: TreeItem) => void;
+    /** 自定义渲染节点 */
+    renderItem?: (itemProps: TreeItem) => React.ReactNode;
+    /** 添加根节点回调 */
+    onAddRoot?: () => void;
+    /** 左侧自定义内容 */
+    leftContent?: React.ReactNode;
+    /** 右侧自定义内容 */
+    rightContent?: React.ReactNode;
+    /** 空状态自定义内容 */
+    emptyContent?: React.ReactNode;
+    /** 设计模式 */
+    __designMode?: string;
+    /** 是否自定义操作 */
+    isCustomAction?: boolean;
+    /** 获取item样式 */
+    getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
+    /** 自定义拖拽判断函数，返回false时阻止拖拽 */
+    canDrop?: (dragItem: DropSortItem, dropTarget: DropSortItem, parentId: string | number | null) => boolean;
+    /** 节点缩进宽度 */
+    indentationWidth?: number;
+}

package/lib/components/pisellDropdown/index.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import './index.less';
+export interface MenuItemType {
+    key: string;
+    label: string;
+    icon?: React.ReactNode;
+    shortcut?: string;
+    divider?: boolean;
+}
+export interface PisellDropdownProps {
+    trigger?: React.ReactNode;
+    items?: MenuItemType[];
+    showShortcut?: boolean;
+    triggerType?: ('click' | 'hover')[];
+    className?: string;
+    style?: React.CSSProperties;
+    onSelect?: (key: string) => void;
+}
+declare const PisellDropdown: React.FC<PisellDropdownProps>;
+export default PisellDropdown;

package/lib/components/pisellEmail/constants/emailDomains.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 常用邮箱域名列表
+ * 用于域名自动补全功能
+ */
+export declare const COMMON_EMAIL_DOMAINS: string[];

package/lib/components/pisellEmail/constants/emailRegex.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 邮箱正则表达式常量
+ */
+/**
+ * 标准邮箱格式正则
+ * 覆盖99%的常见邮箱格式
+ */
+export declare const EMAIL_REGEX: RegExp;
+/**
+ * 严格邮箱格式正则（RFC 5322）
+ * 支持更复杂的邮箱格式，符合 RFC 5322 标准
+ */
+export declare const STRICT_EMAIL_REGEX: RegExp;

package/lib/components/pisellEmail/utils/domainSuggestions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 域名补全工具函数（框架占位符）
+ * TODO: 实现完整的补全逻辑
+ */
+/**
+ * 获取邮箱域名补全建议
+ * @param input 用户输入
+ * @param domains 域名列表
+ * @returns 补全建议列表
+ *
+ * @example
+ * getEmailSuggestions('user@g', COMMON_EMAIL_DOMAINS)
+ * // 返回: ['user@gmail.com']
+ */
+export declare function getEmailSuggestions(input: string, domains?: string[]): string[];

package/lib/components/pisellEmpty/index.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { EmptyProps } from 'antd';
+import { PisellContextType } from '../pisell-config-provider/context';
+import './index.less';
+export interface PisellEmptyProps extends EmptyProps {
+    /** 平台 */
+    platform?: PisellContextType['platform'];
+    /** 额外内容描述 */
+    extraDescription?: React.ReactNode;
+    /** 额外内容描述 */
+    icon?: React.ReactNode;
+    /** 自定义底部额外操作区域 */
+    footer?: React.ReactNode;
+    [key: string]: any;
+    /** 最大宽度 */
+    maxWidth?: number;
+}
+declare const PisellEmpty: (props: PisellEmptyProps) => JSX.Element;
+export default PisellEmpty;

package/lib/components/pisellFilter/index.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { PisellFilterProps } from './type';
-declare const PisellFilter: (props: PisellFilterProps) => React.JSX.Element;
+declare const PisellFilter: (props: PisellFilterProps) => JSX.Element;
 export default PisellFilter;

package/lib/components/pisellFilter/type.d.ts

@@ -0,0 +1,5 @@
+import { FilterListProps } from '../filter/components/FilterButton/types';
+import { FormInstance } from 'antd';
+export declare type PisellFilterProps = FilterListProps & FormInstance & {
+    hasForm?: boolean;
+};

package/lib/components/pisellFloatingPanel/index.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import './index.less';
+export interface PisellFloatingPanelProps {
+    fullHeight?: string | number;
+    retractHeight?: string | number;
+    width?: string | number;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    defaultOpen?: boolean;
+    isFloat?: boolean;
+    children?: React.ReactNode;
+    retractSlot?: React.ReactNode;
+    style?: React.CSSProperties;
+    retractIconStyle?: React.CSSProperties;
+}
+declare const PisellFloatingPanel: (props: PisellFloatingPanelProps) => JSX.Element;
+export default PisellFloatingPanel;

package/lib/components/pisellGoodPassCard/index.d.ts

@@ -46,5 +46,5 @@ export interface PisellGoodPassCardProps {
     mixedSort?: (val: Discount[]) => Discount[];
     isInModal: boolean;
 }
-declare const index: (props: PisellGoodPassCardProps) => React.JSX.Element;
+declare const index: (props: PisellGoodPassCardProps) => JSX.Element;
 export default index;

package/lib/components/pisellGridPro/GridPro.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface GridProProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const PisellGridPro: (props: GridProProps) => JSX.Element;
+export default PisellGridPro;

package/lib/components/pisellGridPro/GridView/index.d.ts

@@ -0,0 +1,5 @@
+import './index.less';
+import { GridViewProps } from './type';
+export type { GridViewProps };
+declare const GridView: (props: GridViewProps) => JSX.Element;
+export default GridView;

package/lib/components/pisellGridPro/GridView/type.d.ts

@@ -0,0 +1,3 @@
+import { PisellScrollViewProps } from '../../PisellScrollView/types';
+export interface GridViewProps extends PisellScrollViewProps {
+}

package/lib/components/pisellGridPro/ToolBar/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { ToolBarProps } from './type';
+export type { ToolBarProps };
+declare const Toolbar: React.FC<ToolBarProps>;
+export default Toolbar;

package/lib/components/pisellGridPro/ToolBar/type.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+export interface ToolBarProps {
+    className?: string;
+    style?: React.CSSProperties;
+    tabs?: React.ReactNode;
+    topLeft?: React.ReactNode;
+    topRight?: React.ReactNode;
+    bottomLeft?: React.ReactNode;
+    bottomRight?: React.ReactNode;
+}

package/lib/components/pisellGridPro/components/DataCard/components/StatCard/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { StatCardItem } from '../../types';
+import './index.less';
+/**
+ * StatCard 统计卡片组件
+ * @description 用于展示单个统计数据，包含标题、数值和对比信息
+ * @author Pisell Team
+ */
+declare const StatCard: React.FC<StatCardItem>;
+export default StatCard;

package/lib/components/pisellGridPro/components/DataCard/index.d.ts

@@ -0,0 +1,5 @@
+import { DataCardProps } from './types';
+export type { DataCardProps };
+import './index.less';
+declare const DataCard: (props: DataCardProps) => JSX.Element | null;
+export default DataCard;

package/lib/components/pisellGridPro/components/DataCard/types.d.ts

@@ -0,0 +1,70 @@
+import React from 'react';
+/**
+ * PisellGridProDataCard 组件属性接口
+ */
+export interface DataCardProps {
+    /**
+     * 统计卡片数据列表
+     */
+    dataItems?: StatCardItem[];
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 统计卡片数据项接口
+ */
+export interface StatCardItem {
+    /**
+     * 唯一标识
+     */
+    key: string;
+    /**
+     * 卡片标题
+     * @example "Total Orders"
+     */
+    title: React.ReactNode;
+    /**
+     * 主要数值
+     * @example 50 或 "$1580"
+     */
+    value: React.ReactNode;
+    /**
+     * 对比数值
+     * @example "+12" 或 "-230"
+     */
+    compareValue?: React.ReactNode;
+    /**
+     * 对比趋势
+     * @description up-增长(绿色), down-下降(红色)
+     * @default undefined
+     */
+    trend?: 'up' | 'down';
+    /**
+     * 对比前缀文本
+     * @default "v.s. pre"
+     */
+    comparePrefix?: string;
+    /**
+     * 是否显示对比信息
+     * @default true
+     */
+    showCompare?: boolean;
+    /**
+     * 自定义卡片样式
+     */
+    style?: React.CSSProperties;
+    /**
+     * 自定义卡片类名
+     */
+    className?: string;
+    /**
+     * 点击回调
+     */
+    onClick?: () => void;
+}