react-public-components 1.1.18 → 1.2.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import React__default, { ReactNode, CSSProperties, Key, HTMLAttributes } from 'react';
+import React__default, { ReactNode, CSSProperties, Key, HTMLAttributes, FC } from 'react';
 
 type CollapseBoxDirection = 'horizontal' | 'vertical';
 type CollapseBoxButtonPosition = 'left' | 'right' | 'top' | 'bottom';
@@ -186,4 +186,1519 @@ interface BorderBeamProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'>
 }
 declare const BorderBeam: (props: BorderBeamProps) => React.JSX.Element;
 
-export { BorderBeam, type BorderBeamColorStop, type BorderBeamProps, type Breakpoint, CollapsibleBox as CollapseBox, type CollapseBoxButtonPosition, type CollapseBoxDirection, type CollapseBoxProps, DisabledBox, type DisabledBoxProps, type Gap, Masonry, type MasonryClassNames, type MasonryItem, type MasonryProps, type MasonrySemanticDOM, type MasonryStyles, CustomSplitter as Splitter, type SplitterCollapsible, type SplitterOrientation, type SplitterPanelProps, type SplitterProps, type SplitterSize };
+interface HsbColor {
+    h: number;
+    s: number;
+    b: number;
+    a: number;
+}
+interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+interface ColorGradientStop {
+    color: Color;
+    percent: number;
+}
+type ColorInput = string | Color | {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+} | {
+    h: number;
+    s: number;
+    b: number;
+    a?: number;
+};
+declare class Color {
+    h: number;
+    s: number;
+    b: number;
+    a: number;
+    constructor(colorInput?: ColorInput);
+    static rgbToHsb(r: number, g: number, b: number, a?: number): HsbColor;
+    static hsbToRgb(h: number, s: number, b: number, a?: number): RgbColor;
+    static parseString(str: string): HsbColor;
+    toRgb(): RgbColor;
+    toRgbString(): string;
+    toHsb(): HsbColor;
+    toHsbString(): string;
+    toHex(): string;
+    toHexString(): string;
+    toCssString(): string;
+}
+declare const generateColor: (color: ColorInput) => Color;
+
+type ColorFormat = 'hex' | 'rgb' | 'hsb';
+type ColorMode = 'single' | 'gradient';
+interface ColorPresetItem {
+    label: ReactNode;
+    colors: (string | Color)[];
+    defaultOpen?: boolean;
+    key?: Key;
+}
+interface ColorPickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'value' | 'defaultValue' | 'children'> {
+    allowClear?: boolean;
+    arrow?: boolean | {
+        pointAtCenter?: boolean;
+    };
+    children?: ReactNode | ((color: Color) => ReactNode);
+    defaultValue?: ColorInput;
+    defaultFormat?: ColorFormat;
+    disabled?: boolean;
+    disabledAlpha?: boolean;
+    disabledFormat?: boolean;
+    destroyOnHidden?: boolean;
+    format?: ColorFormat;
+    mode?: ColorMode | ColorMode[];
+    open?: boolean;
+    presets?: ColorPresetItem[];
+    placement?: 'top' | 'topLeft' | 'topRight' | 'bottom' | 'bottomLeft' | 'bottomRight';
+    panelRender?: (panel: ReactNode, extra: {
+        components: {
+            Picker: FC;
+            Presets: FC;
+        };
+    }) => ReactNode;
+    showText?: boolean | ((color: Color | ColorGradientStop[]) => ReactNode);
+    size?: 'large' | 'middle' | 'small';
+    trigger?: 'hover' | 'click';
+    value?: ColorInput;
+    onChange?: (value: Color, css: string) => void;
+    onChangeComplete?: (value: Color) => void;
+    onFormatChange?: (format: ColorFormat) => void;
+    onOpenChange?: (open: boolean) => void;
+    onClear?: () => void;
+}
+declare const ColorPicker: (props: ColorPickerProps) => React.JSX.Element;
+
+interface CopyButtonProps {
+    /** 要复制的目标文本 */
+    text?: string;
+    /** 动态获取要复制的目标文本（支持异步） */
+    getText?: () => string | Promise<string>;
+    /** 复制按钮的展示形态：button 按钮形态、icon 纯图标、inline 行内文本 */
+    mode?: 'button' | 'icon' | 'inline';
+    /** 按钮类型（仅在 mode='button' 时有效） */
+    type?: 'default' | 'primary';
+    /** 默认图标 */
+    icon?: ReactNode;
+    /** 复制成功后的图标 */
+    copiedIcon?: ReactNode;
+    /** 复制成功后展示的文本 */
+    copiedText?: ReactNode;
+    /** 默认展示的子内容/按钮文案 */
+    children?: ReactNode;
+    /** 复制成功提示的 Tooltip 配置（传 false 禁用，传字符串/ReactNode 自定义文案，传 true 使用默认'复制成功'） */
+    tooltip?: boolean | ReactNode;
+    /** 复制成功后的高亮展示持续时间（毫秒），默认 2000ms */
+    duration?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 成功复制回调 */
+    onCopy?: (text: string) => void;
+    /** 复制失败回调 */
+    onError?: (error: unknown) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const CopyButton: React__default.FC<CopyButtonProps>;
+
+interface TextEllipsisExpandConfig {
+    /** 展开按钮文案，默认为 '展开' */
+    collapsedText?: ReactNode;
+    /** 收起按钮文案，默认为 '收起' */
+    expandedText?: ReactNode;
+    /** 默认是否展开 */
+    defaultExpanded?: boolean;
+    /** 展开状态改变回调 */
+    onExpandChange?: (expanded: boolean) => void;
+}
+interface TextEllipsisProps {
+    /** 显示的文本或节点 */
+    children: ReactNode;
+    /** 最大显示行数，超过则截断，默认为 1 */
+    lines?: number;
+    /** 是否支持展开/收起，可传 boolean 或配置对象 */
+    expandable?: boolean | TextEllipsisExpandConfig;
+    /** Tooltip 浮层展示配置：'auto' 仅在溢出截断时展示、true 始终在 hover 时展示、false 禁用 */
+    tooltip?: 'auto' | boolean | ReactNode;
+    /** 是否显示复制按钮 */
+    copyable?: boolean;
+    /** 前缀节点 */
+    prefix?: ReactNode;
+    /** 后缀节点 */
+    suffix?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const TextEllipsis: React__default.FC<TextEllipsisProps>;
+
+interface SelectOption {
+    label: ReactNode;
+    value: string | number;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+type SelectValue = string | number | SelectOption | (string | number | SelectOption)[] | undefined;
+interface DebounceSelectProps {
+    /** 异步拉取选项列表的函数 */
+    fetchOptions: (search: string) => Promise<SelectOption[]>;
+    /** 防抖等待时间（毫秒），默认为 300ms */
+    debounceTimeout?: number;
+    /** 选择模式：'single' 单选，'multiple' 多选（Tag标签形式） */
+    mode?: 'single' | 'multiple';
+    /** 当前选中值 */
+    value?: SelectValue;
+    /** 默认选中值 */
+    defaultValue?: SelectValue;
+    /** 选中值变化回调 */
+    onChange?: (value: any, option?: SelectOption | SelectOption[]) => void;
+    /** 输入框占位符 */
+    placeholder?: string;
+    /** 是否支持清空 */
+    allowClear?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 空数据时的展示内容 */
+    notFoundContent?: ReactNode;
+    /** 默认选项列表（搜索前展示） */
+    defaultOptions?: SelectOption[];
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const DebounceSelect: React__default.FC<DebounceSelectProps>;
+
+interface CountUpProps {
+    /** 起始数值，默认为 0 */
+    start?: number;
+    /** 目标数值 */
+    end: number;
+    /** 动画持续时间（秒），默认为 2 */
+    duration?: number;
+    /** 保留小数位数，默认为 0 */
+    decimals?: number;
+    /** 小数点符号，默认为 '.' */
+    decimal?: string;
+    /** 千分位分隔符，默认为 ','，若不显示可传空字符串 */
+    separator?: string;
+    /** 前缀字符或节点（如 '¥'、'$'） */
+    prefix?: ReactNode;
+    /** 后缀字符或节点（如 '%'、'件'） */
+    suffix?: ReactNode;
+    /** 是否启用缓动过渡，默认为 true */
+    useEasing?: boolean;
+    /** 是否自动开始动画，默认为 true */
+    autoStart?: boolean;
+    /** 动画完成回调 */
+    onEnd?: () => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+interface CountUpRef {
+    /** 开始/重新播放动画 */
+    start: () => void;
+    /** 重置回起始值 */
+    reset: () => void;
+    /** 更新目标值并平滑过渡 */
+    update: (newEnd: number) => void;
+}
+declare const CountUp: React__default.ForwardRefExoticComponent<CountUpProps & React__default.RefAttributes<CountUpRef>>;
+
+interface ContextMenuItem {
+    /** 菜单项唯一标识 */
+    key: string;
+    /** 菜单项展示文本或节点 */
+    label?: ReactNode;
+    /** 菜单项前置图标 */
+    icon?: ReactNode;
+    /** 是否为分割线 */
+    type?: 'divider';
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否为警示/危险操作（红色显示） */
+    danger?: boolean;
+    /** 快捷键提示（如 '⌘ C' / 'Ctrl+C'） */
+    shortcut?: string;
+    /** 二级子菜单项列表 */
+    children?: ContextMenuItem[];
+    /** 点击菜单项回调 */
+    onClick?: (item: ContextMenuItem, e: React__default.MouseEvent) => void;
+}
+interface ContextMenuProps {
+    /** 菜单项列表配置 */
+    items: ContextMenuItem[];
+    /** 被右键激活的目标子组件/容器 */
+    children: ReactNode;
+    /** 是否禁用右键上下文菜单 */
+    disabled?: boolean;
+    /** 菜单显隐状态改变回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 自定义菜单类名 */
+    menuClassName?: string;
+    /** 自定义菜单样式 */
+    menuStyle?: CSSProperties;
+    /** 自定义外层包裹类名 */
+    className?: string;
+    /** 自定义外层包裹样式 */
+    style?: CSSProperties;
+}
+declare const ContextMenu: React__default.FC<ContextMenuProps>;
+
+interface FullscreenRef {
+    /** 进入全屏 */
+    enter: () => Promise<void>;
+    /** 退出全屏 */
+    exit: () => Promise<void>;
+    /** 切换全屏状态 */
+    toggle: () => Promise<void>;
+    /** 当前是否处于全屏状态 */
+    isFullscreen: boolean;
+    /** 当前目标容器 DOM 元素 */
+    getElement: () => HTMLElement | null;
+}
+type FullscreenMode = 'browser' | 'web';
+type FullscreenButtonPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+interface FullscreenRenderProps {
+    isFullscreen: boolean;
+    enter: () => Promise<void>;
+    exit: () => Promise<void>;
+    toggle: () => Promise<void>;
+}
+interface FullscreenProps {
+    /** 子元素或 Render Props 函数 */
+    children?: ReactNode | ((props: FullscreenRenderProps) => ReactNode);
+    /** 全屏模式：'browser' 原生浏览器全屏，'web' 网页内最大化置顶 */
+    mode?: FullscreenMode;
+    /** 自定义目标全屏元素（不传时默认为当前包裹的容器元素，传 document.documentElement 时为整页全屏） */
+    target?: HTMLElement | (() => HTMLElement | null) | null;
+    /** 受控全屏状态 */
+    fullscreen?: boolean;
+    /** 默认全屏状态 */
+    defaultFullscreen?: boolean;
+    /** 全屏状态变化回调 */
+    onChange?: (isFullscreen: boolean) => void;
+    /** 是否在容器角落展示快速全屏切换悬浮按钮，默认 false */
+    showButton?: boolean;
+    /** 悬浮按钮对齐位置，默认 'top-right' */
+    buttonPosition?: FullscreenButtonPosition;
+    /** 悬浮按钮的自定义 Tooltip 提示或图标 */
+    enterIcon?: ReactNode;
+    exitIcon?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const Fullscreen: React__default.ForwardRefExoticComponent<FullscreenProps & React__default.RefAttributes<FullscreenRef>>;
+
+type CropShape = 'rect' | 'round';
+interface CropResult {
+    dataURL: string;
+    blob: Blob | null;
+    width: number;
+    height: number;
+}
+interface ImageCropperRef {
+    /** 获取当前裁剪结果（DataURL 与 Blob） */
+    getCroppedResult: (type?: string, quality?: number) => Promise<CropResult>;
+    /** 顺时针旋转 90 度 */
+    rotate: (degree?: number) => void;
+    /** 缩放图片 */
+    zoom: (delta: number) => void;
+    /** 重置所有变换参数 */
+    reset: () => void;
+}
+interface ImageCropperProps {
+    /** 图片源地址或 Base64 字符串 */
+    src: string;
+    /** 裁剪框宽高比（如 1 代表 1:1 正方形，16/9 代表宽屏，0 代表自由矩形），默认为 1 */
+    aspectRatio?: number;
+    /** 裁剪框形状：'rect' 矩形，'round' 圆形（适合头像），默认为 'rect' */
+    shape?: CropShape;
+    /** 是否以 Modal 模态弹窗形式展示，默认为 false */
+    modal?: boolean;
+    /** Modal 模式下的标题，默认为 '图片裁剪' */
+    title?: ReactNode;
+    /** Modal 模式下的显隐受控状态 */
+    open?: boolean;
+    /** 确认裁剪回调 */
+    onOk?: (result: CropResult) => void;
+    /** 取消/关闭回调 */
+    onCancel?: () => void;
+    /** 容器高度（内联模式有效），默认为 360 */
+    height?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const ImageCropper: React__default.ForwardRefExoticComponent<ImageCropperProps & React__default.RefAttributes<ImageCropperRef>>;
+
+interface ScrollTrackerProps {
+    /** 进度条吸附位置：'top' 顶部，'bottom' 底部，默认为 'top' */
+    position?: 'top' | 'bottom';
+    /** 进度条高度（像素），默认为 3 */
+    height?: number;
+    /** 进度条颜色或渐变色配置（如 '#1677ff' 或 ['#1677ff', '#52c41a']） */
+    color?: string | string[];
+    /** 是否显示右上角/角落的百分比数字浮签，默认为 false */
+    showPercentage?: boolean;
+    /** 监听滚动的目标元素或 ref（不传时监听整个 window 视口） */
+    target?: HTMLElement | (() => HTMLElement | null) | null;
+    /** 进度改变回调 (0 ~ 100) */
+    onChange?: (percent: number) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const ScrollTracker: React__default.FC<ScrollTrackerProps>;
+interface StickyHeaderProps {
+    /** 子内容 */
+    children: ReactNode | ((isSticky: boolean) => ReactNode);
+    /** 吸顶距离顶部偏移量（像素），默认为 0 */
+    offsetTop?: number;
+    /** 吸顶状态改变回调 */
+    onStickyChange?: (isSticky: boolean) => void;
+    /** 监听滚动的目标容器（默认为 window） */
+    target?: HTMLElement | (() => HTMLElement | null) | null;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const StickyHeader: React__default.FC<StickyHeaderProps>;
+
+type FileType = 'image' | 'video' | 'audio' | 'pdf' | 'text' | 'unknown';
+interface FileItem {
+    /** 文件访问 URL 或 Base64 */
+    url: string;
+    /** 文件名称 */
+    name?: string;
+    /** 文件类型（如不传则根据文件名后缀或 URL 自动推断） */
+    fileType?: FileType;
+    /** 文件大小描述（如 '2.4 MB'） */
+    size?: string;
+    /** 纯文本内容（针对直接传入 text 字符串预览） */
+    textContent?: string;
+}
+interface FilePreviewerProps {
+    /** 是否打开预览弹窗 */
+    open: boolean;
+    /** 当前预览的文件对象或 URL 字符串 */
+    file?: FileItem | string | null;
+    /** 关闭弹窗回调 */
+    onCancel?: () => void;
+    /** 自定义下载行为（不传时使用默认浏览器下载） */
+    onDownload?: (file: FileItem) => void;
+    /** 自定义标题栏右侧额外操作按钮 */
+    extraActions?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare function inferFileType(urlOrName: string): FileType;
+declare const FilePreviewer: React__default.FC<FilePreviewerProps> & {
+    preview: (options: FileItem) => {
+        close: () => void;
+    };
+};
+
+interface FloatingActionItem {
+    key: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    type?: 'default' | 'primary' | 'danger';
+    disabled?: boolean;
+    onClick?: (e: React__default.MouseEvent) => void;
+}
+interface FloatingActionBarProps {
+    /** 是否显示悬浮操作栏（如传 selectedCount 时，默认 selectedCount > 0 自动显示） */
+    open?: boolean;
+    /** 当前选中的项目数 */
+    selectedCount?: number;
+    /** 总项目数（可选，如传则展示 '已选 X / 共 Y 项'） */
+    totalCount?: number;
+    /** 清空/取消全部选择的回调 */
+    onClear?: () => void;
+    /** 取消选择按钮文案，默认为 '取消选择' */
+    clearText?: ReactNode;
+    /** 批量操作按钮列表 */
+    actions?: FloatingActionItem[];
+    /** 自定义操作区内容插槽 */
+    children?: ReactNode;
+    /** 距离屏幕底部的偏移量（像素），默认为 28 */
+    offsetBottom?: number;
+    /** 是否支持右上角关闭按钮 */
+    closable?: boolean;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const FloatingActionBar: React__default.FC<FloatingActionBarProps>;
+
+interface TagInputProps {
+    /** 标签列表（受控） */
+    value?: string[];
+    /** 默认标签列表 */
+    defaultValue?: string[];
+    /** 标签列表改变回调 */
+    onChange?: (tags: string[]) => void;
+    /** 最大允许输入的标签数量 */
+    maxCount?: number;
+    /** 单个标签的最大字符长度 */
+    maxLength?: number;
+    /** 是否允许重复标签，默认为 false */
+    allowDuplicates?: boolean;
+    /** 触发添加标签的按键/分隔符，默认为 ['Enter', ',', '，'] */
+    separators?: string[];
+    /** 标签自定义校验函数（返回 true 通过，返回 false 或 string 报错） */
+    validate?: (tag: string) => boolean | string;
+    /** 占位提示文案 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 自定义渲染单个 Tag */
+    renderTag?: (tag: string, index: number, onClose: () => void) => ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const TagInput: React__default.FC<TagInputProps>;
+
+type PasswordStrengthLevel = 0 | 1 | 2 | 3 | 4;
+interface PasswordRule {
+    key: string;
+    label: ReactNode;
+    validator: (password: string) => boolean;
+}
+interface PasswordStrengthProps {
+    /** 当前输入的密码文本 */
+    password?: string;
+    /** 是否显示密码强度文字（弱/中/强/极强），默认为 true */
+    showText?: boolean;
+    /** 是否显示密码规则校验清单，默认为 false */
+    showRules?: boolean;
+    /** 自定义规则列表 */
+    rules?: PasswordRule[];
+    /** 强度等级改变回调 */
+    onLevelChange?: (level: PasswordStrengthLevel) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare function evaluatePasswordStrength(pwd?: string, rules?: PasswordRule[]): {
+    level: PasswordStrengthLevel;
+    score: number;
+    passedKeys: string[];
+};
+declare const PasswordStrength: React__default.FC<PasswordStrengthProps>;
+
+interface JsonEditorProps {
+    /** JSON 数据内容（可传 JSON 字符串或 Object 对象） */
+    value?: string | object;
+    /** 默认 JSON 数据内容 */
+    defaultValue?: string | object;
+    /** 内容变化回调 */
+    onChange?: (rawJson: string, parsedObject?: any) => void;
+    /** 是否只读模式，默认为 false */
+    readOnly?: boolean;
+    /** 缩进空格数，默认为 2 */
+    indent?: number;
+    /** 编辑器高度，默认为 280 */
+    height?: number | string;
+    /** 是否展示行号，默认为 true */
+    showLineNumbers?: boolean;
+    /** 是否展示顶部工具栏，默认为 true */
+    showToolbar?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const JsonEditor: React__default.FC<JsonEditorProps>;
+
+interface InfiniteScrollListProps {
+    /** 列表项子内容 */
+    children: ReactNode;
+    /** 是否还有更多数据可供加载 */
+    hasMore: boolean;
+    /** 当前是否正在加载下一页 */
+    loading: boolean;
+    /** 触底加载下一页回调 */
+    onLoadMore: () => void | Promise<void>;
+    /** 触发加载的触底距离阈值（像素），默认为 40 */
+    threshold?: number;
+    /** 没有更多数据时的底部提示内容，默认为 '已经到底啦 ~' */
+    endMessage?: ReactNode;
+    /** 加载中指示器组件，默认为 Spin 图标与 '正在加载更多...' */
+    loadingIndicator?: ReactNode;
+    /** 容器固定高度（传值时为局部滚动容器，不传时监听 window 全局滚动） */
+    height?: number | string;
+    /** 滚动容器 ref 或自定义对象 */
+    scrollableTarget?: HTMLElement | (() => HTMLElement | null) | null;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const InfiniteScrollList: React__default.FC<InfiniteScrollListProps>;
+
+type MarqueeDirection = 'left' | 'right' | 'up' | 'down';
+interface MarqueeProps {
+    /** 滚动子内容 */
+    children: ReactNode;
+    /** 滚动方向：'left' | 'right' | 'up' | 'down'，默认为 'left' */
+    direction?: MarqueeDirection;
+    /** 滚动速度（像素/秒），默认为 50 */
+    speed?: number;
+    /** 鼠标悬浮时是否暂停动画，默认为 true */
+    pauseOnHover?: boolean;
+    /** 是否开启两侧边缘羽化渐变遮罩，默认为 false */
+    gradient?: boolean;
+    /** 边缘渐变遮罩的颜色（通常与背景色一致），默认为 '#ffffff' */
+    gradientColor?: string;
+    /** 子项间距（像素），默认为 24 */
+    gap?: number;
+    /** 是否持续保持播放 */
+    play?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const Marquee: React__default.FC<MarqueeProps>;
+
+interface SpotlightCardProps {
+    /** 卡片子内容 */
+    children: ReactNode;
+    /** 聚光灯光晕颜色，默认为 'rgba(22, 119, 255, 0.15)' */
+    spotlightColor?: string;
+    /** 聚光灯光晕半径（像素），默认为 320 */
+    spotlightSize?: number;
+    /** 是否开启暗色主题（高对比科技感），默认为 false */
+    dark?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const SpotlightCard: React__default.FC<SpotlightCardProps>;
+
+type SensitiveType = 'phone' | 'idcard' | 'email' | 'bankcard' | 'custom';
+interface SensitiveMaskProps {
+    /** 原始敏感文本 */
+    text: string;
+    /** 脱敏类型：'phone' | 'idcard' | 'email' | 'bankcard' | 'custom'，默认为 'phone' */
+    type?: SensitiveType;
+    /** 默认是否脱敏遮蔽，默认为 true */
+    defaultMasked?: boolean;
+    /** 遮罩字符，默认为 '*' */
+    maskSymbol?: string;
+    /** 自定义保留头部明文字符数（仅 type='custom' 有效） */
+    unmaskedStart?: number;
+    /** 自定义保留尾部明文字符数（仅 type='custom' 有效） */
+    unmaskedEnd?: number;
+    /** 是否支持切换明文/密文查看，默认为 true */
+    toggleable?: boolean;
+    /** 是否支持一键复制，默认为 false */
+    copyable?: boolean;
+    /** 切换明文时的拦截回调（返回 false 可阻止切换，支持异步鉴权） */
+    onToggle?: (nextMasked: boolean) => boolean | Promise<boolean>;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare function maskSensitiveText(raw: string, type?: SensitiveType, maskSymbol?: string, startCount?: number, endCount?: number): string;
+declare const SensitiveMask: React__default.FC<SensitiveMaskProps>;
+
+type DiffViewMode = 'split' | 'unified';
+interface DiffViewerProps {
+    /** 修改前的旧文本 */
+    oldValue: string;
+    /** 修改后的新文本 */
+    newValue: string;
+    /** 视图模式：'split' 左右分栏，'unified' 单列行内，默认为 'split' */
+    viewMode?: DiffViewMode;
+    /** 是否允许用户自由切换视图模式，默认为 true */
+    allowModeChange?: boolean;
+    /** 文件标题或说明 */
+    title?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const DiffViewer: React__default.FC<DiffViewerProps>;
+
+type CronPeriodType = 'minute' | 'hour' | 'day' | 'week' | 'month' | 'custom';
+interface CronPickerProps {
+    /** 当前 Cron 表达式（受控） */
+    value?: string;
+    /** 默认 Cron 表达式，默认为 '0 0 12 * * ?' */
+    defaultValue?: string;
+    /** 表达式改变回调 */
+    onChange?: (cron: string, humanReadable: string) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const CronPicker: React__default.FC<CronPickerProps>;
+
+type TourPlacement = 'top' | 'bottom' | 'left' | 'right';
+interface TourStep {
+    /** 目标 DOM 节点选择器、DOM 对象或获取函数 */
+    target: string | HTMLElement | (() => HTMLElement | null) | null;
+    /** 引导步骤标题 */
+    title: ReactNode;
+    /** 引导步骤详细说明 */
+    description: ReactNode;
+    /** 气泡对齐方向，默认为 'bottom' */
+    placement?: TourPlacement;
+}
+interface GuidedTourProps {
+    /** 引导步骤列表 */
+    steps: TourStep[];
+    /** 是否开启引导 */
+    open: boolean;
+    /** 当前步数（受控，可选） */
+    current?: number;
+    /** 步数改变回调 */
+    onChange?: (current: number) => void;
+    /** 关闭/跳过引导回调 */
+    onClose?: () => void;
+    /** 全部引导完成回调 */
+    onFinish?: () => void;
+    /** LocalStorage 存储已完成状态的 Key（若提供则完成或跳过后自动持久化记录） */
+    storageKey?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const GuidedTour: React__default.FC<GuidedTourProps>;
+
+type RangeValue = [number | undefined, number | undefined];
+interface RangeShortcut {
+    label: string;
+    value: RangeValue;
+}
+interface NumericRangeInputProps {
+    /** 当前区间值 [min, max]（受控） */
+    value?: RangeValue;
+    /** 默认区间值 */
+    defaultValue?: RangeValue;
+    /** 区间改变回调 */
+    onChange?: (range: RangeValue) => void;
+    /** 允许输入的最小值 */
+    min?: number;
+    /** 允许输入的最大值 */
+    max?: number;
+    /** 步长，默认为 1 */
+    step?: number;
+    /** 精度小数位数 */
+    precision?: number;
+    /** 前缀标签（如 '¥'） */
+    prefix?: ReactNode;
+    /** 后缀标签（如 '元'） */
+    suffix?: ReactNode;
+    /** 连接分隔符，默认为 '~' */
+    separator?: ReactNode;
+    /** 快捷区间选项列表 */
+    shortcuts?: RangeShortcut[];
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const NumericRangeInput: React__default.FC<NumericRangeInputProps>;
+
+interface MetricCardProps {
+    /** 卡片标题 */
+    title: ReactNode;
+    /** 指标数值（若是数字则自动平滑滚动） */
+    value: number | string;
+    /** 数值前缀（如 '¥'） */
+    prefix?: ReactNode;
+    /** 数值后缀（如 '元' / '%'） */
+    suffix?: ReactNode;
+    /** 趋势方向：'up' 上升（绿色），'down' 下降（红色） */
+    trend?: 'up' | 'down';
+    /** 趋势数值说明（如 '+18.5%' 或 '-3.2%'） */
+    trendValue?: ReactNode;
+    /** 趋势比较文本说明（如 '较上月'） */
+    trendLabel?: ReactNode;
+    /** 迷你折线图数据数组（如 [12, 18, 15, 26, 32, 40]） */
+    chartData?: number[];
+    /** 折线图颜色，默认为 '#1677ff' */
+    chartColor?: string;
+    /** 底部说明节点 */
+    footer?: ReactNode;
+    /** 右上角额外操作节点 */
+    extra?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const MetricCard: React__default.FC<MetricCardProps>;
+
+interface AudioPlayerProps {
+    /** 音频资源地址 */
+    src: string;
+    /** 音频标题或文件名 */
+    title?: ReactNode;
+    /** 默认倍速，默认为 1 */
+    defaultPlaybackRate?: number;
+    /** 是否显示下载按钮，默认为 true */
+    showDownload?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const AudioPlayer: React__default.FC<AudioPlayerProps>;
+
+type QrCodeStatus = 'active' | 'expired' | 'loading';
+interface QrCodeCardProps {
+    /** 二维码内容或跳转 URL */
+    value: string;
+    /** 二维码尺寸（像素），默认为 160 */
+    size?: number;
+    /** 中心嵌入的 Logo 图标地址 */
+    icon?: string;
+    /** 二维码状态：'active' 正常，'expired' 已过期，'loading' 生成中，默认为 'active' */
+    status?: QrCodeStatus;
+    /** 卡片标题说明 */
+    title?: ReactNode;
+    /** 卡片副标题或扫码提示 */
+    description?: ReactNode;
+    /** 是否显示一键下载二维码按钮，默认为 false */
+    downloadable?: boolean;
+    /** 点击过期遮罩刷新时的回调 */
+    onRefresh?: () => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const QrCodeCard: React__default.FC<QrCodeCardProps>;
+
+interface ActivityItem {
+    /** 唯一标识 */
+    id: string | number;
+    /** 操作人昵称 */
+    operator: string;
+    /** 操作人头像链接或文字 */
+    avatar?: string;
+    /** 操作人角色（如 '管理员' / '运维工程师'） */
+    role?: string;
+    /** 动作类型描述（如 '发布了版本' / '修改了配置'） */
+    action: ReactNode;
+    /** 操作目标（如 'v2.1.0' / 'RDS-MySQL-Master'） */
+    target?: ReactNode;
+    /** 发生时间戳或文本（如 '3分钟前' / '2026-08-15 14:20'） */
+    time: string;
+    /** 变动详情内容（支持折叠展开） */
+    detail?: ReactNode;
+    /** 是否默认展开详情，默认为 false */
+    defaultExpanded?: boolean;
+}
+interface ActivityLogProps {
+    /** 日志动态列表 */
+    items: ActivityItem[];
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const ActivityLog: React__default.FC<ActivityLogProps>;
+
+interface DragSortListProps<T> {
+    /** 数据列表 */
+    items: T[];
+    /** 拖拽排序完成后的新列表回调 */
+    onReorder: (newItems: T[]) => void;
+    /** 提取唯一 Key */
+    keyExtractor: (item: T, index: number) => string | number;
+    /** 自定义渲染单个列表项内容 */
+    renderItem: (item: T, index: number, isDragging: boolean) => ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare function DragSortList<T>({ items, onReorder, keyExtractor, renderItem, className, style, }: DragSortListProps<T>): React__default.JSX.Element;
+
+interface TiltCardProps {
+    /** 卡片子内容 */
+    children: ReactNode;
+    /** 最大倾斜旋转角度（度），默认为 15 */
+    maxAngle?: number;
+    /** 鼠标悬停时的缩放比例，默认为 1.02 */
+    scale?: number;
+    /** 是否开启表面跟随高光（Glare），默认为 true */
+    glare?: boolean;
+    /** 透视景深（像素），默认为 1000 */
+    perspective?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const TiltCard: React__default.FC<TiltCardProps>;
+
+interface VirtualListProps<T> {
+    /** 数据源数组 */
+    items: T[];
+    /** 单个列表项固定高度（像素），默认为 48 */
+    itemHeight?: number;
+    /** 滚动容器可视高度（像素），默认为 360 */
+    height?: number;
+    /** 自定义渲染单个列表项 */
+    renderItem: (item: T, index: number) => ReactNode;
+    /** 提取唯一 Key */
+    keyExtractor?: (item: T, index: number) => string | number;
+    /** 上下视口外额外渲染的缓冲项数量，默认为 5 */
+    buffer?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare function VirtualList<T>({ items, itemHeight, height, renderItem, keyExtractor, buffer, className, style, }: VirtualListProps<T>): React__default.JSX.Element;
+
+interface WatermarkProps {
+    /** 水印文本内容或多行文本数组 */
+    content: string | string[];
+    /** 子元素内容 */
+    children?: ReactNode;
+    /** 水印旋转角度，默认为 -22 */
+    rotate?: number;
+    /** 字体大小（像素），默认为 14 */
+    fontSize?: number;
+    /** 水印颜色，默认为 'rgba(0, 0, 0, 0.12)' */
+    color?: string;
+    /** 单个水印单元宽度，默认为 240 */
+    width?: number;
+    /** 单个水印单元高度，默认为 160 */
+    height?: number;
+    /** 水印层级 zIndex，默认为 9999 */
+    zIndex?: number;
+    /** 是否开启 MutationObserver 与心跳巡检防审查元素篡改，默认为 true */
+    antiTamper?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const Watermark: React__default.FC<WatermarkProps>;
+
+interface VideoPlayerProps {
+    /** 视频播放地址 */
+    src: string;
+    /** 视频封面图 */
+    poster?: string;
+    /** 是否自动播放，默认为 false */
+    autoPlay?: boolean;
+    /** 是否循环播放，默认为 false */
+    loop?: boolean;
+    /** 是否默认静音，默认为 false */
+    muted?: boolean;
+    /** 宽度，默认为 640 */
+    width?: number | string;
+    /** 高度，默认为 360 */
+    height?: number | string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const VideoPlayer: React__default.FC<VideoPlayerProps>;
+
+interface PdfViewerProps {
+    /** PDF 文件 URL 地址 */
+    src: string;
+    /** 文档标题 */
+    title?: ReactNode;
+    /** 宽度，默认为 '100%' */
+    width?: number | string;
+    /** 高度，默认为 500 */
+    height?: number | string;
+    /** 是否显示下载按钮，默认为 true */
+    showDownload?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const PdfViewer: React__default.FC<PdfViewerProps>;
+
+type RibbonPlacement = 'start' | 'end';
+interface BadgeRibbonProps {
+    /** 缎带文字内容 */
+    text: ReactNode;
+    /** 缎带背景颜色，默认为 '#ff4d4f' */
+    color?: string;
+    /** 挂载位置：'start' 左上角，'end' 右上角，默认为 'end' */
+    placement?: RibbonPlacement;
+    /** 被包裹的卡片子元素 */
+    children: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const BadgeRibbon: React__default.FC<BadgeRibbonProps>;
+
+type SkeletonType = 'text' | 'card' | 'list' | 'avatar';
+interface ShimmerSkeletonProps {
+    /** 骨架类型：'text' 文本，'card' 卡片，'list' 列表，'avatar' 头像，默认为 'card' */
+    type?: SkeletonType;
+    /** 文本骨架行数，默认为 3 */
+    rows?: number;
+    /** 是否处于加载中状态，为 false 时渲染 children，默认为 true */
+    loading?: boolean;
+    /** 加载完成后的子元素内容 */
+    children?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const ShimmerSkeleton: React__default.FC<ShimmerSkeletonProps>;
+
+type FlipTrigger = 'hover' | 'click';
+type FlipDirection = 'horizontal' | 'vertical';
+interface FlipCardProps {
+    /** 卡片正面内容 */
+    front: ReactNode;
+    /** 卡片背面内容 */
+    back: ReactNode;
+    /** 触发翻转方式：'hover' 悬停，'click' 点击，默认为 'hover' */
+    trigger?: FlipTrigger;
+    /** 翻转方向：'horizontal' 水平，'vertical' 垂直，默认为 'horizontal' */
+    direction?: FlipDirection;
+    /** 当前是否翻转到背面（受控） */
+    flipped?: boolean;
+    /** 翻转状态改变回调 */
+    onFlip?: (isFlipped: boolean) => void;
+    /** 宽度，默认为 300 */
+    width?: number | string;
+    /** 高度，默认为 200 */
+    height?: number | string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const FlipCard: React__default.FC<FlipCardProps>;
+
+interface KanbanColumn<T> {
+    id: string;
+    title: string;
+    color?: string;
+    items: T[];
+}
+interface KanbanBoardProps<T> {
+    /** 泳道列数据 */
+    columns: KanbanColumn<T>[];
+    /** 提取卡片唯一 Key */
+    keyExtractor: (item: T) => string;
+    /** 自定义渲染单个卡片 */
+    renderCard: (item: T, columnId: string) => ReactNode;
+    /** 卡片拖拽移动完成回调 */
+    onCardMove?: (cardId: string, sourceColId: string, targetColId: string, newIndex: number) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare function KanbanBoard<T>({ columns, keyExtractor, renderCard, onCardMove, className, style, }: KanbanBoardProps<T>): React__default.JSX.Element;
+
+interface TreeFilterNode {
+    label: string;
+    value: string | number;
+    children?: TreeFilterNode[];
+}
+interface TreeFilterPanelProps {
+    /** 树形分类选项列表 */
+    options: TreeFilterNode[];
+    /** 当前选中的值数组（受控） */
+    value?: (string | number)[];
+    /** 默认选中的值数组 */
+    defaultValue?: (string | number)[];
+    /** 选中值变化回调 */
+    onChange?: (values: (string | number)[]) => void;
+    /** 是否支持多选，默认为 true */
+    multiple?: boolean;
+    /** 标题前缀，默认为 ['一级分类', '二级分类', '三级标签'] */
+    levelLabels?: string[];
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const TreeFilterPanel: React__default.FC<TreeFilterPanelProps>;
+
+type EnvType = 'dev' | 'test' | 'uat' | 'staging' | 'prod';
+type EnvPlacement = 'top-right' | 'top-left' | 'bottom-right';
+interface EnvBuildInfo {
+    apiHost?: string;
+    branch?: string;
+    commit?: string;
+    buildTime?: string;
+    version?: string;
+}
+interface EnvSwitchItem {
+    label: string;
+    url: string;
+    env: EnvType;
+}
+interface EnvBadgeProps {
+    /** 当前运行环境：'dev' | 'test' | 'uat' | 'staging' | 'prod' */
+    env: EnvType;
+    /** 显示文本（不传则默认大写环境名） */
+    label?: ReactNode;
+    /** 悬浮挂载位置，默认为 'top-right' */
+    placement?: EnvPlacement;
+    /** 当前构建与部署版本信息 */
+    info?: EnvBuildInfo;
+    /** 快捷切换至其他环境列表 */
+    switchList?: EnvSwitchItem[];
+    /** 是否默认常驻，默认为 true */
+    visible?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const EnvBadge: React__default.FC<EnvBadgeProps>;
+
+type TimelineStatus = 'finish' | 'process' | 'error' | 'wait';
+interface TimelineOperator {
+    name: string;
+    avatar?: ReactNode;
+}
+interface StatusTimelineItem {
+    title: ReactNode;
+    description?: ReactNode;
+    time?: string;
+    duration?: string;
+    status?: TimelineStatus;
+    operator?: TimelineOperator;
+}
+interface StatusTimelineProps {
+    /** 时间轴节点列表 */
+    items: StatusTimelineItem[];
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const StatusTimeline: React__default.FC<StatusTimelineProps>;
+
+interface GradientTextProps {
+    /** 文字内容 */
+    children: ReactNode;
+    /** 渐变色定义，默认为 'linear-gradient(90deg, #1677ff 0%, #722ed1 50%, #eb2f96 100%)' */
+    gradient?: string;
+    /** 是否开启流光滚动动画，默认为 true */
+    animate?: boolean;
+    /** 流光动画周期时间（秒），默认为 4 */
+    speed?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const GradientText: React__default.FC<GradientTextProps>;
+
+interface KeyValItem {
+    key: string;
+    value: string;
+    enabled?: boolean;
+    isSecret?: boolean;
+}
+interface KeyValEditorProps {
+    /** 键值对数组（受控） */
+    value?: KeyValItem[];
+    /** 默认键值对数组 */
+    defaultValue?: KeyValItem[];
+    /** 变化回调 */
+    onChange?: (items: KeyValItem[]) => void;
+    /** Key 输入框占位文案，默认为 'Key 键名' */
+    keyPlaceholder?: string;
+    /** Value 输入框占位文案，默认为 'Value 键值' */
+    valPlaceholder?: string;
+    /** 是否允许配置 Secret 密码掩码，默认为 true */
+    allowSecret?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const KeyValEditor: React__default.FC<KeyValEditorProps>;
+
+interface ShortcutItem {
+    key: string;
+    label: string;
+    calc: () => [string, string];
+}
+interface QuickDateRangeProps {
+    /** 当前选中项的 key（受控） */
+    activeKey?: string;
+    /** 默认选中的 key，默认为 '7days' */
+    defaultKey?: string;
+    /** 切换回调 */
+    onChange?: (dateRange: [string, string], key: string) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const QuickDateRange: React__default.FC<QuickDateRangeProps>;
+
+interface DiffColumn {
+    key: string;
+    title: string;
+    /** 是否为数值对比列，默认为 false */
+    isNumeric?: boolean;
+}
+interface DiffTableProps {
+    /** 列定义 */
+    columns: DiffColumn[];
+    /** 基准期数据（如上月/上期） */
+    baseData: Record<string, any>[];
+    /** 当前期数据（如本月/当期） */
+    currentData: Record<string, any>[];
+    /** 唯一行主键，默认为 'id' */
+    rowKey?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const DiffTable: React__default.FC<DiffTableProps>;
+
+interface PhotoItem {
+    src: string;
+    alt?: string;
+    title?: string;
+}
+interface PhotoViewerProps {
+    /** 相册图片列表 */
+    images: PhotoItem[];
+    /** 默认展示图片下标，默认为 0 */
+    defaultIndex?: number;
+    /** 图片高度，默认为 380 */
+    height?: number | string;
+    /** 图片切换回调 */
+    onChange?: (index: number) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const PhotoViewer: React__default.FC<PhotoViewerProps>;
+
+interface TrendIndicatorProps {
+    /** 变动数值（如 14.2 代表 +14.2%，-5.8 代表 -5.8%） */
+    value: number;
+    /** 数值后缀，默认为 '%' */
+    suffix?: string;
+    /** 数值前缀 */
+    prefix?: string;
+    /** 保留小数位数，默认为 1 */
+    precision?: number;
+    /** 展示模式：'filled' 填充色块 | 'outlined' 线框 | 'text' 纯文字，默认为 'filled' */
+    type?: 'filled' | 'outlined' | 'text';
+    /** 是否反转红绿色彩规则（如成本/延时降低为绿色），默认为 false */
+    reverse?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const TrendIndicator: React__default.FC<TrendIndicatorProps>;
+
+interface CountdownButtonProps {
+    /** 初始按钮文案，默认为 '获取验证码' */
+    text?: ReactNode;
+    /** 倒计时时长（秒），默认为 60 */
+    seconds?: number;
+    /** 倒计时中文案生成函数，默认为 (sec) => `${sec}s 后重试` */
+    countdownText?: (secondsLeft: number) => ReactNode;
+    /** 重置后的再次获取文案，默认使用 text */
+    resetText?: ReactNode;
+    /** 点击触发异步前置检查，返回 true 启动倒计时，返回 false 阻止，若抛错也自动恢复 */
+    onBeforeStart?: () => Promise<boolean> | boolean;
+    /** 倒计时结束回调 */
+    onEnd?: () => void;
+    /** 是否外部强行禁用 */
+    disabled?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const CountdownButton: React__default.FC<CountdownButtonProps>;
+
+interface ProgressSegment {
+    label: string;
+    value: number;
+    color: string;
+    suffix?: string;
+}
+interface SegmentedProgressProps {
+    /** 分段数据列表 */
+    segments: ProgressSegment[];
+    /** 总量基准（不传则自动对各分段 value 求和） */
+    total?: number;
+    /** 进度条高度（像素），默认为 10 */
+    height?: number;
+    /** 是否显示底部图例 Legend，默认为 true */
+    showLegend?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const SegmentedProgress: React__default.FC<SegmentedProgressProps>;
+
+interface HoverCardProps {
+    /** 触发宿主元素 */
+    children: ReactNode;
+    /** 悬浮弹出的卡片内容 */
+    content: ReactNode;
+    /** 鼠标移入展开延迟（毫秒），默认为 200 */
+    openDelay?: number;
+    /** 鼠标移出关闭延迟（毫秒），默认为 200 */
+    closeDelay?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const HoverCard: React__default.FC<HoverCardProps>;
+
+interface TreeTransferNode {
+    key: string;
+    title: string;
+    children?: TreeTransferNode[];
+}
+interface TreeTransferProps {
+    /** 树形数据源 */
+    treeData: TreeTransferNode[];
+    /** 右侧已选择 keys 列表（受控） */
+    targetKeys?: string[];
+    /** 默认已选择 keys 列表 */
+    defaultTargetKeys?: string[];
+    /** 改变回调 */
+    onChange?: (targetKeys: string[]) => void;
+    /** 左侧面板标题，默认为 '待选项目录' */
+    sourceTitle?: string;
+    /** 右侧面板标题，默认为 '已选项目' */
+    targetTitle?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const TreeTransfer: React__default.FC<TreeTransferProps>;
+
+interface NumberStepperProps {
+    /** 当前数值（受控） */
+    value?: number;
+    /** 默认数值 */
+    defaultValue?: number;
+    /** 最小值，默认为 0 */
+    min?: number;
+    /** 最大值，默认为 100 */
+    max?: number;
+    /** 步长，默认为 1 */
+    step?: number;
+    /** 改变回调 */
+    onChange?: (val: number) => void;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const NumberStepper: React__default.FC<NumberStepperProps>;
+
+interface JsonTreeProps {
+    /** JSON 数据源 */
+    data: any;
+    /** 默认展开层级深度，默认为 2 */
+    defaultExpandedLevel?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const JsonTree: React__default.FC<JsonTreeProps>;
+
+interface CodeSnippetProps {
+    /** 代码文本内容 */
+    code: string;
+    /** 编程语言标识，默认为 'bash' */
+    language?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const CodeSnippet: React__default.FC<CodeSnippetProps>;
+
+interface MiniSparklineProps {
+    /** 数值序列 */
+    data: number[];
+    /** 折线与填充主题色，默认为 '#1677ff' */
+    color?: string;
+    /** 是否展示面积渐变填充，默认为 true */
+    fill?: boolean;
+    /** 宽度（像素），默认为 80 */
+    width?: number;
+    /** 高度（像素），默认为 28 */
+    height?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const MiniSparkline: React__default.FC<MiniSparklineProps>;
+
+interface FileDropZoneProps {
+    /** 文件选择/拖拽/粘贴回调 */
+    onDropFiles: (files: File[]) => void;
+    /** 允许的文件类型，例如 'image/*' 或 '.pdf,.png' */
+    accept?: string;
+    /** 是否支持多选，默认为 true */
+    multiple?: boolean;
+    /** 提示标题，默认为 '点击或将文件拖拽至此处上传' */
+    title?: ReactNode;
+    /** 提示副标题，默认为 '支持拖拽文件或直接按 Ctrl+V 粘贴截图' */
+    hint?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const FileDropZone: React__default.FC<FileDropZoneProps>;
+
+interface CascadeLevel {
+    id: string;
+    title: string;
+    content: ReactNode;
+}
+interface CascadeDrawerProps {
+    /** 是否打开抽屉 */
+    open: boolean;
+    /** 关闭抽屉回调 */
+    onClose: () => void;
+    /** 初始根层级 */
+    rootLevel: CascadeLevel;
+    /** 抽屉宽度，默认为 440 */
+    width?: number | string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const CascadeDrawer: React__default.FC<CascadeDrawerProps>;
+
+interface DualRangeSliderProps {
+    /** 最小值，默认为 0 */
+    min?: number;
+    /** 最大值，默认为 100 */
+    max?: number;
+    /** 步长，默认为 1 */
+    step?: number;
+    /** 当前区间值 [minVal, maxVal]（受控） */
+    value?: [number, number];
+    /** 默认区间值 */
+    defaultValue?: [number, number];
+    /** 改变回调 */
+    onChange?: (val: [number, number]) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const DualRangeSlider: React__default.FC<DualRangeSliderProps>;
+
+interface FilterChipItem {
+    id: string;
+    label: string;
+    value: string;
+}
+interface FilterChipsProps {
+    /** 筛选胶囊列表 */
+    chips: FilterChipItem[];
+    /** 单项删除回调 */
+    onRemove?: (id: string) => void;
+    /** 全部清空回调 */
+    onClearAll?: () => void;
+    /** 清空按钮文案，默认为 '清空筛选' */
+    clearText?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const FilterChips: React__default.FC<FilterChipsProps>;
+
+interface AnnouncementBarProps {
+    /** 横幅广播内容 */
+    children: ReactNode;
+    /** 是否支持点击关闭，默认为 true */
+    closable?: boolean;
+    /** 自定义渐变或背景样式 */
+    background?: string;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const AnnouncementBar: React__default.FC<AnnouncementBarProps>;
+
+interface JsonDiffViewerProps {
+    /** 变更前原始 JSON 对象 */
+    before: Record<string, any>;
+    /** 变更后最新 JSON 对象 */
+    after: Record<string, any>;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+declare const JsonDiffViewer: React__default.FC<JsonDiffViewerProps>;
+
+export { type ActivityItem, ActivityLog, type ActivityLogProps, AnnouncementBar, type AnnouncementBarProps, AudioPlayer, type AudioPlayerProps, BadgeRibbon, type BadgeRibbonProps, BorderBeam, type BorderBeamColorStop, type BorderBeamProps, type Breakpoint, CascadeDrawer, type CascadeDrawerProps, type CascadeLevel, CodeSnippet, type CodeSnippetProps, CollapsibleBox as CollapseBox, type CollapseBoxButtonPosition, type CollapseBoxDirection, type CollapseBoxProps, Color, type ColorFormat, type ColorMode, ColorPicker, type ColorPickerProps, type ColorPresetItem, ContextMenu, type ContextMenuItem, type ContextMenuProps, CopyButton, type CopyButtonProps, CountUp, type CountUpProps, type CountUpRef, CountdownButton, type CountdownButtonProps, type CronPeriodType, CronPicker, type CronPickerProps, type CropResult, type CropShape, DebounceSelect, type DebounceSelectProps, type DiffColumn, DiffTable, type DiffTableProps, type DiffViewMode, DiffViewer, type DiffViewerProps, DisabledBox, type DisabledBoxProps, DragSortList, type DragSortListProps, DualRangeSlider, type DualRangeSliderProps, EnvBadge, type EnvBadgeProps, type EnvBuildInfo, type EnvPlacement, type EnvSwitchItem, type EnvType, FileDropZone, type FileDropZoneProps, type FileItem, FilePreviewer, type FilePreviewerProps, type FileType, type FilterChipItem, FilterChips, type FilterChipsProps, FlipCard, type FlipCardProps, type FlipDirection, type FlipTrigger, FloatingActionBar, type FloatingActionBarProps, type FloatingActionItem, Fullscreen, type FullscreenButtonPosition, type FullscreenMode, type FullscreenProps, type FullscreenRef, type FullscreenRenderProps, type Gap, GradientText, type GradientTextProps, GuidedTour, type GuidedTourProps, HoverCard, type HoverCardProps, type HsbColor, ImageCropper, type ImageCropperProps, type ImageCropperRef, InfiniteScrollList, type InfiniteScrollListProps, JsonDiffViewer, type JsonDiffViewerProps, JsonEditor, type JsonEditorProps, JsonTree, type JsonTreeProps, KanbanBoard, type KanbanBoardProps, type KanbanColumn, KeyValEditor, type KeyValEditorProps, type KeyValItem, Marquee, type MarqueeDirection, type MarqueeProps, Masonry, type MasonryClassNames, type MasonryItem, type MasonryProps, type MasonrySemanticDOM, type MasonryStyles, MetricCard, type MetricCardProps, MiniSparkline, type MiniSparklineProps, NumberStepper, type NumberStepperProps, NumericRangeInput, type NumericRangeInputProps, type PasswordRule, PasswordStrength, type PasswordStrengthLevel, type PasswordStrengthProps, PdfViewer, type PdfViewerProps, type PhotoItem, PhotoViewer, type PhotoViewerProps, type ProgressSegment, QrCodeCard, type QrCodeCardProps, type QrCodeStatus, QuickDateRange, type QuickDateRangeProps, type RangeShortcut, type RangeValue, type RgbColor, type RibbonPlacement, ScrollTracker, type ScrollTrackerProps, SegmentedProgress, type SegmentedProgressProps, type SelectOption, type SelectValue, SensitiveMask, type SensitiveMaskProps, type SensitiveType, ShimmerSkeleton, type ShimmerSkeletonProps, type ShortcutItem, type SkeletonType, CustomSplitter as Splitter, type SplitterCollapsible, type SplitterOrientation, type SplitterPanelProps, type SplitterProps, type SplitterSize, SpotlightCard, type SpotlightCardProps, StatusTimeline, type StatusTimelineItem, type StatusTimelineProps, StickyHeader, type StickyHeaderProps, TagInput, type TagInputProps, TextEllipsis, type TextEllipsisExpandConfig, type TextEllipsisProps, TiltCard, type TiltCardProps, type TimelineOperator, type TimelineStatus, type TourPlacement, type TourStep, type TreeFilterNode, TreeFilterPanel, type TreeFilterPanelProps, TreeTransfer, type TreeTransferNode, type TreeTransferProps, TrendIndicator, type TrendIndicatorProps, VideoPlayer, type VideoPlayerProps, VirtualList, type VirtualListProps, Watermark, type WatermarkProps, evaluatePasswordStrength, generateColor, inferFileType, maskSensitiveText };