deepsea-components 5.4.0 → 5.4.2

package/dist/cjs/components/AutoFit.d.ts

@@ -0,0 +1,25 @@
+import { HTMLAttributes } from "react";
+export interface AutoFitProps extends HTMLAttributes<HTMLDivElement> {
+    /** 设计稿宽度，默认 1920 */
+    width?: number;
+    /** 设计稿高度，默认 1080 */
+    height?: number;
+    /**
+     * 在哪些方向进行缩放，默认缩放所有方向
+     * 1. 水平方向是指，宽度按照设计稿进行占满，高度反向缩放
+     * 2. 垂直方向是指，高度按照设计稿进行占满，宽度反向缩放
+     * 3. 默认是水平和垂直方向都进行缩放，类似于 background-size: contain 的效果
+     */
+    direction?: "horizontal" | "vertical" | "both";
+}
+/**
+ * 自适应缩放组件
+ *
+ * 注意：
+ * 1. 父元素必须设置非 static 定位方式
+ * 2. 父元素只能有且仅有一个子元素，那就是 AutoFit
+ * 3. 不要设置 AutoFit 的 position、left、top、transform、width、height 属性
+ * 4. 在第一次完成缩放前，无论 props 是什么，返回的都是 <div style={{ display: "none" }} />
+ * 5. 元素的属性、事件、资源并不是立即加载的，会有一帧的延迟，在第一次完成缩放后才会显示
+ */
+export declare const AutoFit: import("react").ForwardRefExoticComponent<AutoFitProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/components/AutoScroll.d.ts

@@ -0,0 +1,38 @@
+import { CSSProperties } from "react";
+import { ScrollProps } from "./Scroll";
+export interface AutoScrollProps extends ScrollProps {
+    /** 轮播元素的个数 */
+    count: number;
+    /** 轮播元素的高度 */
+    itemHeight: number;
+    /**
+     * 轮播动画的时间，单位毫秒
+     * @default 1000
+     */
+    animation?: number;
+    /**
+     * 每个元素的停留时间，单位毫秒
+     * @default 3000
+     */
+    duration?: number;
+    /**
+     * 元素之间的间距
+     * @default 0
+     */
+    gap?: number;
+    /** 容器类名 */
+    containerClassName?: string;
+    /** 容器样式 */
+    containerStyle?: CSSProperties;
+    /**
+     * 在鼠标移入时是否继续播放
+     * @default false
+     */
+    playOnMouseEnter?: boolean;
+    /**
+     * 是否暂停
+     * @default false
+     */
+    paused?: boolean;
+}
+export declare const AutoScroll: import("react").ForwardRefExoticComponent<AutoScrollProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/components/AutoSizeTextarea.d.ts

@@ -0,0 +1,5 @@
+import { TextareaHTMLAttributes } from "react";
+/**
+ * 自适应高度的文本域
+ */
+export declare const AutoSizeTextArea: import("react").ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & import("react").RefAttributes<HTMLTextAreaElement>>;

package/dist/cjs/components/CircleText.d.ts

@@ -0,0 +1,25 @@
+import { FC, HTMLAttributes } from "react";
+export interface CircleTextProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
+    /** 每一个方块的宽度 */
+    width: number;
+    /** 每一个方块的高度 */
+    height: number;
+    /** 圆弧的半径，不包含方块的高度 */
+    radius: number;
+    /** 开始旋转的弧度，逆时针增加，0 为 x 轴方向 */
+    startAngel?: number;
+    /** 每一个方块之间间隔的弧度 */
+    gapAngel?: number;
+    /** 文字对齐的方式，默认居中 */
+    align?: "left" | "center" | "right";
+    /** 文字朝向圆心还是外侧，默认外侧 */
+    direction?: "inner" | "outer";
+    /** 是否反转文字顺序 */
+    reverse?: boolean;
+    /** 分割文字的方法 */
+    separator?: string | RegExp | ((text: string) => string[]);
+    /** 显示的文字 */
+    children: string;
+}
+/** 环形文字 */
+export declare const CircleText: FC<CircleTextProps>;

package/dist/cjs/components/Echart.d.ts

@@ -0,0 +1,15 @@
+import { BarSeriesOption, ComposeOption, DatasetComponentOption, ECharts, GridComponentOption, LineSeriesOption, PieSeriesOption, TitleComponentOption, TooltipComponentOption } from "echarts";
+import { ComponentProps, ForwardedRef, ForwardRefExoticComponent, RefAttributes } from "react";
+export type PieOption = ComposeOption<PieSeriesOption | TitleComponentOption | DatasetComponentOption | GridComponentOption | TooltipComponentOption>;
+export type BarOption = ComposeOption<BarSeriesOption | TitleComponentOption | DatasetComponentOption | GridComponentOption | TooltipComponentOption>;
+export type LineOption = ComposeOption<LineSeriesOption | TitleComponentOption | DatasetComponentOption | GridComponentOption | TooltipComponentOption>;
+export interface EchartProps<T extends any = any> extends Omit<ComponentProps<"div">, "children"> {
+    width: number;
+    height: number;
+    option: T;
+    chart?: ForwardedRef<ECharts>;
+}
+export type EchartComponent<T extends PieOption | BarOption | LineOption> = ForwardRefExoticComponent<Omit<EchartProps<T>, "ref"> & RefAttributes<HTMLDivElement>>;
+export declare const Pie: EchartComponent<PieOption>;
+export declare const Bar: EchartComponent<BarOption>;
+export declare const Line: EchartComponent<LineOption>;

package/dist/cjs/components/Flow.d.ts

@@ -0,0 +1,86 @@
+import { CSSProperties, HTMLAttributes, Key, ReactNode, RefObject } from "react";
+export interface FlowSizeData {
+    /** 容器宽度 */
+    width: number;
+    /** 容器高度 */
+    height: number;
+    /** 元素宽度 */
+    itemWidth: number;
+    /** 元素高度 */
+    itemHeight: number;
+    /** 列间距 */
+    columnGap: number;
+    /** 列数 */
+    columnCount: number;
+    /** 行间距 */
+    rowGap: number;
+    /** 行数 */
+    rowCount: number;
+    /** 元素格数 */
+    itemCount: number;
+    /** 最大行数 */
+    maxRows: number | null;
+    /** 是否有元素被隐藏 */
+    overflow: boolean;
+}
+export interface FlowProps<T> extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 元素宽度 */
+    itemWidth: number;
+    /** 元素高度 */
+    itemHeight: number;
+    /**
+     * 列间距
+     * 1. 如果是数字，表示列间距是固定的
+     * 2. 如果是 auto，表示会在尽可能放进更多列的情况下，列间距是平均的
+     * 2. 如果是数组，表示列间距是区间的，第一个元素是最小值，第二个元素是最大值
+     */
+    columnGap?: number | "auto" | [number | "auto", number | "auto"];
+    /** 行间距 */
+    rowGap?: number;
+    gap?: number;
+    /** 最大行数 */
+    maxRows?: number | null;
+    /** 源数据 */
+    data?: T[];
+    /** 渲染 */
+    render: (item: T, index: number, arr: T[]) => ReactNode;
+    /** key释放器，默认为 index */
+    keyExactor?: (item: T, index: number, arr: T[]) => Key;
+    /**
+     * 渲染的元素由两层容器包裹，外层容器类名
+     */
+    wrapperClassName?: string;
+    /**
+     * 渲染的元素由两层容器包裹，外层容器样式
+     */
+    wrapperStyle?: CSSProperties;
+    /**
+     * 渲染的元素由两层容器包裹，内层容器类名
+     */
+    containerClassName?: string;
+    /**
+     * 渲染的元素由两层容器包裹，内层容器样式
+     */
+    containerStyle?: CSSProperties;
+    /** 节流时间，单位毫秒，默认200ms，传入 0 不节流 */
+    throttle?: number;
+    /** 动画时间，单位毫秒，默认400ms，传入 0 不展示动画 */
+    transitionDuration?: number;
+    /** 变化的回调函数 */
+    onSizeChange?: (sizeData: FlowSizeData) => void;
+    element?: RefObject<HTMLDivElement>;
+}
+export declare function getGapRange(gap?: undefined | number | "auto" | (number | "auto")[]): [number, number | "auto"];
+export interface GapAndCount {
+    count: number;
+    gap: number;
+}
+export declare function getGapCountAndSize(width: number, itemWidth: number, minGap: number, maxGap: number | "auto"): GapAndCount;
+export interface ManualFlowProps<T> extends FlowProps<T> {
+    /** 组件宽度，必须指定 */
+    width: number;
+}
+/** 手动组件，由外界指定宽度，性能更好 */
+export declare function ManualFlow<T>(props: ManualFlowProps<T>): import("react/jsx-runtime").JSX.Element;
+/** 自适应浮动组件 */
+export declare function Flow<T>(props: FlowProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/cjs/components/HlsPlayer.d.ts

@@ -0,0 +1,5 @@
+import { MediaHTMLAttributes } from "react";
+export interface HlsPlayerProps extends Omit<MediaHTMLAttributes<HTMLVideoElement>, "src"> {
+    src: string;
+}
+export declare const HlsPlayer: import("react").ForwardRefExoticComponent<HlsPlayerProps & import("react").RefAttributes<HTMLVideoElement>>;

package/dist/cjs/components/InfiniteScroll.d.ts

@@ -0,0 +1,31 @@
+import { ComponentProps, CSSProperties } from "react";
+export type InfiniteScrollProps = ComponentProps<"div"> & {
+    /**
+     * 滚动的方向
+     * @default "vertical"
+     */
+    direction?: "vertical" | "horizontal";
+    /** 渲染 children 的容器的类名 */
+    containerClassName?: string;
+    /** 渲染 children 的容器的样式 */
+    containerStyle?: CSSProperties;
+    /**
+     * 两个 children 容器之间的间距
+     * @default 0
+     */
+    gap?: number;
+    /** 一个周期的时间，单位：毫秒 */
+    duration: number;
+    /** 是否将 gap 的距离也加入 overflow 的计算 */
+    withGap?: boolean;
+    /** 尺寸刚好相同时，是否视为溢出 */
+    withEqual?: boolean;
+    /** 鼠标移入时，是否停止动画 */
+    pauseOnHover?: boolean;
+};
+/**
+ * 无限滚动的组件
+ * 子元素会内置的容器中被渲染两次，首尾相连，形成无限滚动的效果
+ * 但是，如果内部检测到并没有溢出，那么不会渲染两次，并且没有动画
+ */
+export declare const InfiniteScroll: import("react").ForwardRefExoticComponent<Omit<InfiniteScrollProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/components/InputFile.d.ts

@@ -0,0 +1,64 @@
+import { ButtonHTMLAttributes, InputHTMLAttributes } from "react";
+export interface InputFileDataTypes {
+    base64: string;
+    text: string;
+    arrayBuffer: ArrayBuffer;
+    binary: string;
+    file: File;
+}
+export type InputFileDataType = keyof InputFileDataTypes;
+export interface InputFileData<T> {
+    result: T;
+    file: File;
+}
+export type InputFileProps = ({
+    multiple?: false;
+    type: "base64" | "text" | "binary";
+    onChange?: (data: InputFileData<string>) => void;
+} | {
+    multiple?: false;
+    type: "arrayBuffer";
+    onChange?: (data: InputFileData<ArrayBuffer>) => void;
+} | {
+    multiple?: false;
+    type?: "file";
+    onChange?: (data: InputFileData<File>) => void;
+} | {
+    multiple: true;
+    type: "base64" | "text" | "binary";
+    onChange?: (data: InputFileData<string>[]) => void;
+} | {
+    multiple: true;
+    type: "arrayBuffer";
+    onChange?: (data: InputFileData<ArrayBuffer>[]) => void;
+} | {
+    multiple: true;
+    type?: "file";
+    onChange?: (data: InputFileData<File>[]) => void;
+}) & Omit<InputHTMLAttributes<HTMLInputElement>, "onChange" | "multiple" | "type"> & {
+    /** 是否在捕获文件后清除 input 上的文件，默认为 false，主要区别在于如果不清除，连续两次选择同样的文件不会触发 onChange 事件，如果用于 form 表单，请设置为 flase */
+    clearAfterChange?: boolean;
+};
+export declare function getFileData<T extends InputFileDataType>(file: File, type: T): Promise<InputFileDataTypes[T]>;
+/** 专用于读取文件的组件 */
+export declare const InputFile: import("react").ForwardRefExoticComponent<InputFileProps & import("react").RefAttributes<HTMLInputElement>>;
+export type InputFileButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    input: InputFileProps;
+};
+/** 专用于读取文件的 button 组件 */
+export declare const InputFileButton: import("react").ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & {
+    input: InputFileProps;
+} & import("react").RefAttributes<HTMLButtonElement>>;
+export interface ImportExcelProps extends Omit<InputFileProps, "multiple" | "onChange" | "accept" | "type"> {
+    onChange?: (data: Record<string, string>[]) => void;
+}
+/** 专门用于读取 excel 的组件 */
+export declare const ImportExcel: import("react").ForwardRefExoticComponent<ImportExcelProps & import("react").RefAttributes<HTMLInputElement>>;
+/** 手动导出 excel */
+export declare function exportExcel(data: Record<string, string>[], name: string): void;
+export interface ExportExcelProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    data: Record<string, string>[];
+    fileName: string;
+}
+/** 导出 excel 的 button 组件 */
+export declare const ExportExcel: import("react").ForwardRefExoticComponent<ExportExcelProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/cjs/components/LoopSwiper.d.ts

@@ -0,0 +1,9 @@
+import { CSSProperties, HTMLAttributes } from "react";
+export interface LoopSwiperProps extends HTMLAttributes<HTMLDivElement> {
+    direction?: "horizontal" | "vertical";
+    reverse?: boolean;
+    period: number;
+    gap?: CSSProperties["gap"];
+}
+/** 循环播放组件 */
+export declare const LoopSwiper: import("react").ForwardRefExoticComponent<LoopSwiperProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/components/Ring.d.ts

@@ -0,0 +1,7 @@
+import { HTMLAttributes } from "react";
+export interface RingProps extends HTMLAttributes<HTMLDivElement> {
+    outerWidth: number;
+    innerWidth: number;
+}
+/** 环形组件 */
+export declare const Ring: import("react").ForwardRefExoticComponent<RingProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/components/Scroll.d.ts

@@ -0,0 +1,24 @@
+import { CSSProperties, ForwardedRef, HTMLAttributes } from "react";
+import Scrollbar from "smooth-scrollbar";
+import type { ScrollbarOptions, ScrollListener } from "smooth-scrollbar/interfaces";
+export { default as Scrollbar } from "smooth-scrollbar";
+export * from "smooth-scrollbar/interfaces";
+export interface ScrollOptions extends Partial<ScrollbarOptions> {
+    /** 滑块宽度 */
+    thumbWidth?: number | string;
+    /** 滑块圆角大小 */
+    thumbRadius?: number | string;
+    /** 滑块背景颜色 */
+    thumbColor?: CSSProperties["backgroundColor"];
+    /** 滚动条背景颜色 */
+    trackColor?: CSSProperties["backgroundColor"];
+}
+export interface ScrollProps extends HTMLAttributes<HTMLDivElement> {
+    /** 滚动的配置 */
+    options?: ScrollOptions;
+    /** 滚动条实例 */
+    scrollbar?: ForwardedRef<Scrollbar>;
+    /** 滚动条滚动事件 */
+    onScrollbar?: ScrollListener;
+}
+export declare const Scroll: import("react").ForwardRefExoticComponent<ScrollProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/components/SectionRing.d.ts

@@ -0,0 +1,8 @@
+import { FC, HTMLAttributes } from "react";
+export interface SectionRingProps extends HTMLAttributes<HTMLDivElement> {
+    outerRadius: number;
+    innerRadius: number;
+    count: number;
+    angel: number;
+}
+export declare const SectionRing: FC<SectionRingProps>;

package/dist/cjs/components/Skeleton.d.ts

@@ -0,0 +1,5 @@
+import { HTMLAttributes } from "react";
+export interface SkeletonProps extends HTMLAttributes<HTMLDivElement> {
+    loading?: boolean;
+}
+export declare const Skeleton: import("react").ForwardRefExoticComponent<SkeletonProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/components/Title.d.ts

@@ -0,0 +1,3 @@
+import { ComponentProps } from "react";
+export type TitleProps = ComponentProps<"title">;
+export declare const Title: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLTitleElement>, HTMLTitleElement>, "ref"> & import("react").RefAttributes<HTMLTitleElement>>;

package/dist/cjs/components/TransitionBox.d.ts

@@ -0,0 +1,10 @@
+import { CSSProperties, FC, HTMLAttributes } from "react";
+export interface TransitionBoxProps extends HTMLAttributes<HTMLDivElement> {
+    containerClassName?: string;
+    containerStyle?: CSSProperties;
+    vertical?: boolean;
+    horizontal?: boolean;
+    time?: number;
+}
+/** 尺寸渐变的组件 */
+export declare const TransitionBox: FC<TransitionBoxProps>;

package/dist/cjs/components/TransitionNum.d.ts

@@ -0,0 +1,16 @@
+import { ForwardedRef, HTMLAttributes } from "react";
+export interface TransitionNumProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 当前数字 */
+    children: number;
+    /** 变换周期，单位帧 */
+    period: number;
+    /** 数字转换为字符串的方法 */
+    numToStr?: (num: number) => string;
+    /** 实例 */
+    ins?: ForwardedRef<TransitionNumIns>;
+}
+export interface TransitionNumIns {
+    get(): number;
+}
+/** 渐变数字组件 */
+export declare const TransitionNum: import("react").ForwardRefExoticComponent<TransitionNumProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/components/Trapezium.d.ts

@@ -0,0 +1,9 @@
+import { HTMLAttributes } from "react";
+export interface TrapeziumProps extends HTMLAttributes<HTMLDivElement> {
+    top: number;
+    bottom: number;
+    height: number;
+    borderRadius: number;
+}
+/** 梯形组件 */
+export declare const Trapezium: import("react").ForwardRefExoticComponent<TrapeziumProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/cjs/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./components/AutoFit";
+export * from "./components/AutoScroll";
+export * from "./components/AutoSizeTextarea";
+export * from "./components/CircleText";
+export * from "./components/Echart";
+export * from "./components/Flow";
+export * from "./components/HlsPlayer";
+export * from "./components/InfiniteScroll";
+export * from "./components/InputFile";
+export * from "./components/LoopSwiper";
+export * from "./components/Ring";
+export * from "./components/Scroll";
+export * from "./components/SectionRing";
+export * from "./components/Skeleton";
+export * from "./components/Title";
+export * from "./components/TransitionBox";
+export * from "./components/TransitionNum";
+export * from "./components/Trapezium";
+export * from "./utils/getReactVersion";
+export * from "./utils/index";

package/dist/cjs/utils/getReactVersion.d.ts

@@ -0,0 +1 @@
+export declare function getReactVersion(): number[];

package/dist/cjs/utils/index.d.ts

@@ -0,0 +1,9 @@
+import { CSSProperties } from "react";
+export type CSSVariableName = `--${string}`;
+export type CSSVariableValue = string | number | undefined;
+export interface StyleWithCSSVariable extends CSSProperties {
+    [X: CSSVariableName]: CSSVariableValue;
+}
+export declare function transformCSSVariableName(name: string): CSSVariableName;
+export declare function transformCSSVariable(style: Partial<Record<string, CSSVariableValue>>, style2?: CSSProperties): CSSProperties;
+export declare function px(value: string | number | undefined): string | undefined;

package/dist/esm/components/AutoFit.d.ts

@@ -0,0 +1,25 @@
+import { HTMLAttributes } from "react";
+export interface AutoFitProps extends HTMLAttributes<HTMLDivElement> {
+    /** 设计稿宽度，默认 1920 */
+    width?: number;
+    /** 设计稿高度，默认 1080 */
+    height?: number;
+    /**
+     * 在哪些方向进行缩放，默认缩放所有方向
+     * 1. 水平方向是指，宽度按照设计稿进行占满，高度反向缩放
+     * 2. 垂直方向是指，高度按照设计稿进行占满，宽度反向缩放
+     * 3. 默认是水平和垂直方向都进行缩放，类似于 background-size: contain 的效果
+     */
+    direction?: "horizontal" | "vertical" | "both";
+}
+/**
+ * 自适应缩放组件
+ *
+ * 注意：
+ * 1. 父元素必须设置非 static 定位方式
+ * 2. 父元素只能有且仅有一个子元素，那就是 AutoFit
+ * 3. 不要设置 AutoFit 的 position、left、top、transform、width、height 属性
+ * 4. 在第一次完成缩放前，无论 props 是什么，返回的都是 <div style={{ display: "none" }} />
+ * 5. 元素的属性、事件、资源并不是立即加载的，会有一帧的延迟，在第一次完成缩放后才会显示
+ */
+export declare const AutoFit: import("react").ForwardRefExoticComponent<AutoFitProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/components/AutoScroll.d.ts

@@ -0,0 +1,38 @@
+import { CSSProperties } from "react";
+import { ScrollProps } from "./Scroll";
+export interface AutoScrollProps extends ScrollProps {
+    /** 轮播元素的个数 */
+    count: number;
+    /** 轮播元素的高度 */
+    itemHeight: number;
+    /**
+     * 轮播动画的时间，单位毫秒
+     * @default 1000
+     */
+    animation?: number;
+    /**
+     * 每个元素的停留时间，单位毫秒
+     * @default 3000
+     */
+    duration?: number;
+    /**
+     * 元素之间的间距
+     * @default 0
+     */
+    gap?: number;
+    /** 容器类名 */
+    containerClassName?: string;
+    /** 容器样式 */
+    containerStyle?: CSSProperties;
+    /**
+     * 在鼠标移入时是否继续播放
+     * @default false
+     */
+    playOnMouseEnter?: boolean;
+    /**
+     * 是否暂停
+     * @default false
+     */
+    paused?: boolean;
+}
+export declare const AutoScroll: import("react").ForwardRefExoticComponent<AutoScrollProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/components/AutoSizeTextarea.d.ts

@@ -0,0 +1,5 @@
+import { TextareaHTMLAttributes } from "react";
+/**
+ * 自适应高度的文本域
+ */
+export declare const AutoSizeTextArea: import("react").ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & import("react").RefAttributes<HTMLTextAreaElement>>;

package/dist/esm/components/CircleText.d.ts

@@ -0,0 +1,25 @@
+import { FC, HTMLAttributes } from "react";
+export interface CircleTextProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
+    /** 每一个方块的宽度 */
+    width: number;
+    /** 每一个方块的高度 */
+    height: number;
+    /** 圆弧的半径，不包含方块的高度 */
+    radius: number;
+    /** 开始旋转的弧度，逆时针增加，0 为 x 轴方向 */
+    startAngel?: number;
+    /** 每一个方块之间间隔的弧度 */
+    gapAngel?: number;
+    /** 文字对齐的方式，默认居中 */
+    align?: "left" | "center" | "right";
+    /** 文字朝向圆心还是外侧，默认外侧 */
+    direction?: "inner" | "outer";
+    /** 是否反转文字顺序 */
+    reverse?: boolean;
+    /** 分割文字的方法 */
+    separator?: string | RegExp | ((text: string) => string[]);
+    /** 显示的文字 */
+    children: string;
+}
+/** 环形文字 */
+export declare const CircleText: FC<CircleTextProps>;

package/dist/esm/components/Echart.d.ts

@@ -0,0 +1,15 @@
+import { BarSeriesOption, ComposeOption, DatasetComponentOption, ECharts, GridComponentOption, LineSeriesOption, PieSeriesOption, TitleComponentOption, TooltipComponentOption } from "echarts";
+import { ComponentProps, ForwardedRef, ForwardRefExoticComponent, RefAttributes } from "react";
+export type PieOption = ComposeOption<PieSeriesOption | TitleComponentOption | DatasetComponentOption | GridComponentOption | TooltipComponentOption>;
+export type BarOption = ComposeOption<BarSeriesOption | TitleComponentOption | DatasetComponentOption | GridComponentOption | TooltipComponentOption>;
+export type LineOption = ComposeOption<LineSeriesOption | TitleComponentOption | DatasetComponentOption | GridComponentOption | TooltipComponentOption>;
+export interface EchartProps<T extends any = any> extends Omit<ComponentProps<"div">, "children"> {
+    width: number;
+    height: number;
+    option: T;
+    chart?: ForwardedRef<ECharts>;
+}
+export type EchartComponent<T extends PieOption | BarOption | LineOption> = ForwardRefExoticComponent<Omit<EchartProps<T>, "ref"> & RefAttributes<HTMLDivElement>>;
+export declare const Pie: EchartComponent<PieOption>;
+export declare const Bar: EchartComponent<BarOption>;
+export declare const Line: EchartComponent<LineOption>;

package/dist/esm/components/Flow.d.ts

@@ -0,0 +1,86 @@
+import { CSSProperties, HTMLAttributes, Key, ReactNode, RefObject } from "react";
+export interface FlowSizeData {
+    /** 容器宽度 */
+    width: number;
+    /** 容器高度 */
+    height: number;
+    /** 元素宽度 */
+    itemWidth: number;
+    /** 元素高度 */
+    itemHeight: number;
+    /** 列间距 */
+    columnGap: number;
+    /** 列数 */
+    columnCount: number;
+    /** 行间距 */
+    rowGap: number;
+    /** 行数 */
+    rowCount: number;
+    /** 元素格数 */
+    itemCount: number;
+    /** 最大行数 */
+    maxRows: number | null;
+    /** 是否有元素被隐藏 */
+    overflow: boolean;
+}
+export interface FlowProps<T> extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 元素宽度 */
+    itemWidth: number;
+    /** 元素高度 */
+    itemHeight: number;
+    /**
+     * 列间距
+     * 1. 如果是数字，表示列间距是固定的
+     * 2. 如果是 auto，表示会在尽可能放进更多列的情况下，列间距是平均的
+     * 2. 如果是数组，表示列间距是区间的，第一个元素是最小值，第二个元素是最大值
+     */
+    columnGap?: number | "auto" | [number | "auto", number | "auto"];
+    /** 行间距 */
+    rowGap?: number;
+    gap?: number;
+    /** 最大行数 */
+    maxRows?: number | null;
+    /** 源数据 */
+    data?: T[];
+    /** 渲染 */
+    render: (item: T, index: number, arr: T[]) => ReactNode;
+    /** key释放器，默认为 index */
+    keyExactor?: (item: T, index: number, arr: T[]) => Key;
+    /**
+     * 渲染的元素由两层容器包裹，外层容器类名
+     */
+    wrapperClassName?: string;
+    /**
+     * 渲染的元素由两层容器包裹，外层容器样式
+     */
+    wrapperStyle?: CSSProperties;
+    /**
+     * 渲染的元素由两层容器包裹，内层容器类名
+     */
+    containerClassName?: string;
+    /**
+     * 渲染的元素由两层容器包裹，内层容器样式
+     */
+    containerStyle?: CSSProperties;
+    /** 节流时间，单位毫秒，默认200ms，传入 0 不节流 */
+    throttle?: number;
+    /** 动画时间，单位毫秒，默认400ms，传入 0 不展示动画 */
+    transitionDuration?: number;
+    /** 变化的回调函数 */
+    onSizeChange?: (sizeData: FlowSizeData) => void;
+    element?: RefObject<HTMLDivElement>;
+}
+export declare function getGapRange(gap?: undefined | number | "auto" | (number | "auto")[]): [number, number | "auto"];
+export interface GapAndCount {
+    count: number;
+    gap: number;
+}
+export declare function getGapCountAndSize(width: number, itemWidth: number, minGap: number, maxGap: number | "auto"): GapAndCount;
+export interface ManualFlowProps<T> extends FlowProps<T> {
+    /** 组件宽度，必须指定 */
+    width: number;
+}
+/** 手动组件，由外界指定宽度，性能更好 */
+export declare function ManualFlow<T>(props: ManualFlowProps<T>): import("react/jsx-runtime").JSX.Element;
+/** 自适应浮动组件 */
+export declare function Flow<T>(props: FlowProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/esm/components/HlsPlayer.d.ts

@@ -0,0 +1,5 @@
+import { MediaHTMLAttributes } from "react";
+export interface HlsPlayerProps extends Omit<MediaHTMLAttributes<HTMLVideoElement>, "src"> {
+    src: string;
+}
+export declare const HlsPlayer: import("react").ForwardRefExoticComponent<HlsPlayerProps & import("react").RefAttributes<HTMLVideoElement>>;

package/dist/esm/components/InfiniteScroll.d.ts

@@ -0,0 +1,31 @@
+import { ComponentProps, CSSProperties } from "react";
+export type InfiniteScrollProps = ComponentProps<"div"> & {
+    /**
+     * 滚动的方向
+     * @default "vertical"
+     */
+    direction?: "vertical" | "horizontal";
+    /** 渲染 children 的容器的类名 */
+    containerClassName?: string;
+    /** 渲染 children 的容器的样式 */
+    containerStyle?: CSSProperties;
+    /**
+     * 两个 children 容器之间的间距
+     * @default 0
+     */
+    gap?: number;
+    /** 一个周期的时间，单位：毫秒 */
+    duration: number;
+    /** 是否将 gap 的距离也加入 overflow 的计算 */
+    withGap?: boolean;
+    /** 尺寸刚好相同时，是否视为溢出 */
+    withEqual?: boolean;
+    /** 鼠标移入时，是否停止动画 */
+    pauseOnHover?: boolean;
+};
+/**
+ * 无限滚动的组件
+ * 子元素会内置的容器中被渲染两次，首尾相连，形成无限滚动的效果
+ * 但是，如果内部检测到并没有溢出，那么不会渲染两次，并且没有动画
+ */
+export declare const InfiniteScroll: import("react").ForwardRefExoticComponent<Omit<InfiniteScrollProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/components/InputFile.d.ts

@@ -0,0 +1,64 @@
+import { ButtonHTMLAttributes, InputHTMLAttributes } from "react";
+export interface InputFileDataTypes {
+    base64: string;
+    text: string;
+    arrayBuffer: ArrayBuffer;
+    binary: string;
+    file: File;
+}
+export type InputFileDataType = keyof InputFileDataTypes;
+export interface InputFileData<T> {
+    result: T;
+    file: File;
+}
+export type InputFileProps = ({
+    multiple?: false;
+    type: "base64" | "text" | "binary";
+    onChange?: (data: InputFileData<string>) => void;
+} | {
+    multiple?: false;
+    type: "arrayBuffer";
+    onChange?: (data: InputFileData<ArrayBuffer>) => void;
+} | {
+    multiple?: false;
+    type?: "file";
+    onChange?: (data: InputFileData<File>) => void;
+} | {
+    multiple: true;
+    type: "base64" | "text" | "binary";
+    onChange?: (data: InputFileData<string>[]) => void;
+} | {
+    multiple: true;
+    type: "arrayBuffer";
+    onChange?: (data: InputFileData<ArrayBuffer>[]) => void;
+} | {
+    multiple: true;
+    type?: "file";
+    onChange?: (data: InputFileData<File>[]) => void;
+}) & Omit<InputHTMLAttributes<HTMLInputElement>, "onChange" | "multiple" | "type"> & {
+    /** 是否在捕获文件后清除 input 上的文件，默认为 false，主要区别在于如果不清除，连续两次选择同样的文件不会触发 onChange 事件，如果用于 form 表单，请设置为 flase */
+    clearAfterChange?: boolean;
+};
+export declare function getFileData<T extends InputFileDataType>(file: File, type: T): Promise<InputFileDataTypes[T]>;
+/** 专用于读取文件的组件 */
+export declare const InputFile: import("react").ForwardRefExoticComponent<InputFileProps & import("react").RefAttributes<HTMLInputElement>>;
+export type InputFileButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    input: InputFileProps;
+};
+/** 专用于读取文件的 button 组件 */
+export declare const InputFileButton: import("react").ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & {
+    input: InputFileProps;
+} & import("react").RefAttributes<HTMLButtonElement>>;
+export interface ImportExcelProps extends Omit<InputFileProps, "multiple" | "onChange" | "accept" | "type"> {
+    onChange?: (data: Record<string, string>[]) => void;
+}
+/** 专门用于读取 excel 的组件 */
+export declare const ImportExcel: import("react").ForwardRefExoticComponent<ImportExcelProps & import("react").RefAttributes<HTMLInputElement>>;
+/** 手动导出 excel */
+export declare function exportExcel(data: Record<string, string>[], name: string): void;
+export interface ExportExcelProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    data: Record<string, string>[];
+    fileName: string;
+}
+/** 导出 excel 的 button 组件 */
+export declare const ExportExcel: import("react").ForwardRefExoticComponent<ExportExcelProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/esm/components/LoopSwiper.d.ts

@@ -0,0 +1,9 @@
+import { CSSProperties, HTMLAttributes } from "react";
+export interface LoopSwiperProps extends HTMLAttributes<HTMLDivElement> {
+    direction?: "horizontal" | "vertical";
+    reverse?: boolean;
+    period: number;
+    gap?: CSSProperties["gap"];
+}
+/** 循环播放组件 */
+export declare const LoopSwiper: import("react").ForwardRefExoticComponent<LoopSwiperProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/components/Ring.d.ts

@@ -0,0 +1,7 @@
+import { HTMLAttributes } from "react";
+export interface RingProps extends HTMLAttributes<HTMLDivElement> {
+    outerWidth: number;
+    innerWidth: number;
+}
+/** 环形组件 */
+export declare const Ring: import("react").ForwardRefExoticComponent<RingProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/components/Scroll.d.ts

@@ -0,0 +1,24 @@
+import { CSSProperties, ForwardedRef, HTMLAttributes } from "react";
+import Scrollbar from "smooth-scrollbar";
+import type { ScrollbarOptions, ScrollListener } from "smooth-scrollbar/interfaces";
+export { default as Scrollbar } from "smooth-scrollbar";
+export * from "smooth-scrollbar/interfaces";
+export interface ScrollOptions extends Partial<ScrollbarOptions> {
+    /** 滑块宽度 */
+    thumbWidth?: number | string;
+    /** 滑块圆角大小 */
+    thumbRadius?: number | string;
+    /** 滑块背景颜色 */
+    thumbColor?: CSSProperties["backgroundColor"];
+    /** 滚动条背景颜色 */
+    trackColor?: CSSProperties["backgroundColor"];
+}
+export interface ScrollProps extends HTMLAttributes<HTMLDivElement> {
+    /** 滚动的配置 */
+    options?: ScrollOptions;
+    /** 滚动条实例 */
+    scrollbar?: ForwardedRef<Scrollbar>;
+    /** 滚动条滚动事件 */
+    onScrollbar?: ScrollListener;
+}
+export declare const Scroll: import("react").ForwardRefExoticComponent<ScrollProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/components/SectionRing.d.ts

@@ -0,0 +1,8 @@
+import { FC, HTMLAttributes } from "react";
+export interface SectionRingProps extends HTMLAttributes<HTMLDivElement> {
+    outerRadius: number;
+    innerRadius: number;
+    count: number;
+    angel: number;
+}
+export declare const SectionRing: FC<SectionRingProps>;

package/dist/esm/components/Skeleton.d.ts

@@ -0,0 +1,5 @@
+import { HTMLAttributes } from "react";
+export interface SkeletonProps extends HTMLAttributes<HTMLDivElement> {
+    loading?: boolean;
+}
+export declare const Skeleton: import("react").ForwardRefExoticComponent<SkeletonProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/components/Title.d.ts

@@ -0,0 +1,3 @@
+import { ComponentProps } from "react";
+export type TitleProps = ComponentProps<"title">;
+export declare const Title: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLTitleElement>, HTMLTitleElement>, "ref"> & import("react").RefAttributes<HTMLTitleElement>>;

package/dist/esm/components/TransitionBox.d.ts

@@ -0,0 +1,10 @@
+import { CSSProperties, FC, HTMLAttributes } from "react";
+export interface TransitionBoxProps extends HTMLAttributes<HTMLDivElement> {
+    containerClassName?: string;
+    containerStyle?: CSSProperties;
+    vertical?: boolean;
+    horizontal?: boolean;
+    time?: number;
+}
+/** 尺寸渐变的组件 */
+export declare const TransitionBox: FC<TransitionBoxProps>;

package/dist/esm/components/TransitionNum.d.ts

@@ -0,0 +1,16 @@
+import { ForwardedRef, HTMLAttributes } from "react";
+export interface TransitionNumProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 当前数字 */
+    children: number;
+    /** 变换周期，单位帧 */
+    period: number;
+    /** 数字转换为字符串的方法 */
+    numToStr?: (num: number) => string;
+    /** 实例 */
+    ins?: ForwardedRef<TransitionNumIns>;
+}
+export interface TransitionNumIns {
+    get(): number;
+}
+/** 渐变数字组件 */
+export declare const TransitionNum: import("react").ForwardRefExoticComponent<TransitionNumProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/components/Trapezium.d.ts

@@ -0,0 +1,9 @@
+import { HTMLAttributes } from "react";
+export interface TrapeziumProps extends HTMLAttributes<HTMLDivElement> {
+    top: number;
+    bottom: number;
+    height: number;
+    borderRadius: number;
+}
+/** 梯形组件 */
+export declare const Trapezium: import("react").ForwardRefExoticComponent<TrapeziumProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/esm/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./components/AutoFit";
+export * from "./components/AutoScroll";
+export * from "./components/AutoSizeTextarea";
+export * from "./components/CircleText";
+export * from "./components/Echart";
+export * from "./components/Flow";
+export * from "./components/HlsPlayer";
+export * from "./components/InfiniteScroll";
+export * from "./components/InputFile";
+export * from "./components/LoopSwiper";
+export * from "./components/Ring";
+export * from "./components/Scroll";
+export * from "./components/SectionRing";
+export * from "./components/Skeleton";
+export * from "./components/Title";
+export * from "./components/TransitionBox";
+export * from "./components/TransitionNum";
+export * from "./components/Trapezium";
+export * from "./utils/getReactVersion";
+export * from "./utils/index";

package/dist/esm/utils/getReactVersion.d.ts

@@ -0,0 +1 @@
+export declare function getReactVersion(): number[];

package/dist/esm/utils/index.d.ts

@@ -0,0 +1,9 @@
+import { CSSProperties } from "react";
+export type CSSVariableName = `--${string}`;
+export type CSSVariableValue = string | number | undefined;
+export interface StyleWithCSSVariable extends CSSProperties {
+    [X: CSSVariableName]: CSSVariableValue;
+}
+export declare function transformCSSVariableName(name: string): CSSVariableName;
+export declare function transformCSSVariable(style: Partial<Record<string, CSSVariableValue>>, style2?: CSSProperties): CSSProperties;
+export declare function px(value: string | number | undefined): string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepsea-components",
-  "version": "5.4.0",
+  "version": "5.4.2",
   "description": "格数科技自用组件库",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -30,7 +30,7 @@
     "hls.js": "^1.5.8",
     "smooth-scrollbar": "^8.8.4",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.2/xlsx-0.20.2.tgz",
-    "deepsea-tools": "5.6.0"
+    "deepsea-tools": "5.7.0"
   },
   "devDependencies": {
     "father": "^4.4.1",