@zjlab-fe/data-hub-ui 0.2.0 → 0.2.1

package/dist/types/components/FileUploader/FileUploadModal.d.ts

@@ -0,0 +1,17 @@
+import { ModalProps } from 'antd';
+import { FileDraggerProps } from './FileUploaderFileDragger';
+import { FileInfo, UploadManager } from './types';
+export default function FileUploadModal({ config: { modal, dragArea }, ...props }: {
+    root?: string;
+    identifier: string;
+    showFinished?: boolean;
+    externalUploadContext?: FileInfo[];
+    onUploadSuccess?: (file: {
+        fileName: string;
+    }) => void;
+    extra?: React.ReactNode;
+    config: {
+        modal: ModalProps;
+        dragArea?: Omit<FileDraggerProps, 'onFileReceived'>;
+    };
+} & UploadManager): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploader.d.ts

@@ -0,0 +1,9 @@
+import { FileInfo, UploadableFile, UploadManager } from './types';
+import { FileUploaderProps } from './FileUploaderMain';
+export default function FileUploader(props: {
+    root?: string;
+    identifier: string;
+    showFinished?: boolean;
+    externalUploadContext?: FileInfo[];
+    onUploadSuccess?: (file: UploadableFile) => void;
+} & UploadManager & FileUploaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderContextProvider.d.ts

@@ -0,0 +1,9 @@
+import { FileInfo, UploadableFile, UploadManager } from './types';
+import { FileUploaderProps } from './FileUploaderMain';
+export default function FileUploaderContextProvider({ extra, dragAreaConfig, ...props }: {
+    root?: string;
+    identifier: string;
+    showFinished?: boolean;
+    externalUploadContext?: FileInfo[];
+    onUploadSuccess?: (file: UploadableFile) => void;
+} & UploadManager & FileUploaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderFileDragger.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+export interface FileDraggerProps {
+    accept?: string;
+    directory?: boolean;
+    dragAreaDescription?: ReactNode;
+    maxSizePerFile?: number;
+    onFileReceived: (_files: File[]) => void;
+}
+export default function FileUploaderFileDragger({ accept, directory, dragAreaDescription, maxSizePerFile, onFileReceived, }: FileDraggerProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderFileDraggerDragAreaDescription.d.ts

@@ -0,0 +1,4 @@
+import { ReactNode } from 'react';
+export default function FileDraggerDragAreaDescription({ description }: {
+    description: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderList.d.ts

@@ -0,0 +1 @@
+export default function FileUploadModalList(): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/FileUploader/FileUploaderListItem.d.ts

@@ -0,0 +1,26 @@
+import { ProgressProps } from 'antd';
+import { UploadableFile } from './types';
+export declare const progressStyleProps: ProgressProps;
+declare const _default: import("react").NamedExoticComponent<{
+    file: UploadableFile;
+}>;
+export default _default;
+export declare function ListItemOutline({ children, className }: {
+    children: React.ReactNode;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ListItemName({ fileName, className }: {
+    fileName: string;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ListItemStatus({ className, fileStatus, percentage, strokeColor, }: {
+    className?: string;
+    fileStatus: string;
+    percentage: number;
+    strokeColor?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ListItemActions({ onDelete, extraActions, className, }: {
+    onDelete: () => void;
+    extraActions?: React.ReactNode;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderListItemFail.d.ts

@@ -0,0 +1,5 @@
+import { UploadableFile } from './types';
+declare const _default: import("react").NamedExoticComponent<{
+    file: UploadableFile;
+}>;
+export default _default;

package/dist/types/components/FileUploader/FileUploaderListItemPaused.d.ts

@@ -0,0 +1,5 @@
+import { UploadableFile } from './types';
+declare const _default: import("react").NamedExoticComponent<{
+    file: UploadableFile;
+}>;
+export default _default;

package/dist/types/components/FileUploader/FileUploaderListItemUploading.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("react").NamedExoticComponent<object>;
+export default _default;

package/dist/types/components/FileUploader/FileUploaderMain.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { FileDraggerProps } from './FileUploaderFileDragger';
+export type FileUploaderProps = {
+    extra?: React.ReactNode;
+    dragAreaConfig?: Omit<FileDraggerProps, 'onFileReceived'>;
+};
+export default function FileUploaderMain({ extra, dragAreaConfig }: FileUploaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderlListItemFinished.d.ts

@@ -0,0 +1,5 @@
+import { UploadableFile } from './types';
+declare const _default: import("react").NamedExoticComponent<{
+    file: UploadableFile;
+}>;
+export default _default;

package/dist/types/components/FileUploader/UploadStoreProvider.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+import { UploadableFile } from './types';
+export type UploadStore = {
+    [key: string]: UploadableFile[];
+};
+type UploadStoreAction = {
+    type: 'add';
+    identifier: string | number;
+} | {
+    type: 'edit_file';
+    identifier: string | number;
+    file: UploadableFile;
+} | {
+    type: 'remove_file';
+    identifier: string | number;
+    fileName: string;
+} | {
+    type: 'add_file';
+    identifier: string | number;
+    file: UploadableFile;
+} | {
+    type: 'clear_finished';
+    identifier: string | number;
+} | {
+    type: 'add_files';
+    identifier: string | number;
+    files: UploadableFile[];
+};
+type UploadStoreDispatch = React.Dispatch<UploadStoreAction>;
+export declare const TEMP_STORE: {};
+export declare const UploadStoreContext: React.Context<UploadStore>;
+export declare const UploadStoreDispatchContext: React.Context<UploadStoreDispatch>;
+export default function UploadStoreProvider({ children }: {
+    children: React.ReactElement;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/FileUploader/hooks/useCancelUpload.d.ts

@@ -0,0 +1,2 @@
+import { UploadableFile } from '../types';
+export declare function useCancelUpload(): (file: UploadableFile) => Promise<void>;

package/dist/types/components/FileUploader/hooks/useCheckForDuplicates.d.ts

@@ -0,0 +1 @@
+export declare function useCheckForDuplicates(): (files: File[]) => Promise<[boolean, Set<string>]>;

package/dist/types/components/FileUploader/hooks/useCurrentFIleOnInit.d.ts

@@ -0,0 +1,5 @@
+import { UploadUrl } from '../types';
+export declare function useOnInit(): (chunks: {
+    url: UploadUrl;
+    chunk: Blob;
+}[]) => void;

package/dist/types/components/FileUploader/hooks/useCurrentFile.d.ts

@@ -0,0 +1,14 @@
+import { UploadableFile, FILE_UPLOAD_STATUS } from '../types';
+export declare const currentFileAtom: import("jotai").PrimitiveAtom<UploadableFile | null> & {
+    init: UploadableFile | null;
+};
+export declare const currentFileNameAtom: import("jotai").Atom<string | undefined>;
+export declare const currentFileStatusAtom: import("jotai").Atom<FILE_UPLOAD_STATUS | undefined>;
+export declare const currentFileExpiryTimeAtom: import("jotai").Atom<string | undefined>;
+export declare const currentFileUploadIdAtom: import("jotai").Atom<string | undefined>;
+export declare const currentFileRawAtom: import("jotai").Atom<File | undefined>;
+export declare const currentFilePercentageAtom: import("jotai").Atom<number | undefined>;
+export declare const currentFileCancelControllersAtom: import("jotai").Atom<{
+    [key: string]: AbortController;
+} | undefined>;
+export declare function useCurrentFile(): void;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnAllUploaded.d.ts

@@ -0,0 +1 @@
+export declare function useOnAllUploaded(): (allSuccess: boolean) => Promise<void>;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnCancel.d.ts

@@ -0,0 +1,2 @@
+import { UploadableFile } from '../types';
+export declare function useOnCancel(): (currentFile: UploadableFile) => void;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnFail.d.ts

@@ -0,0 +1,2 @@
+import { UploadableFile } from '../types';
+export declare function useOnFail(): (file: UploadableFile) => void;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnFinished.d.ts

@@ -0,0 +1,2 @@
+import { UploadableFile } from '../types';
+export declare function useOnFinished(): (file: UploadableFile) => void;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnUploading.d.ts

@@ -0,0 +1,5 @@
+import { UploadUrl } from '../types';
+export declare function useOnUploading(): (chunks: {
+    url: UploadUrl;
+    chunk: Blob;
+}[]) => Promise<void>;

package/dist/types/components/FileUploader/hooks/useFileDragAndDrop.d.ts

@@ -0,0 +1,9 @@
+export declare function useFileDragAndDrop(directory: boolean, acceptList: Set<string>, triggerOnFileReceived: (files: File[]) => void): {
+    isDragOver: boolean;
+    handleDragEvents: {
+        onDrop: (e: React.DragEvent<HTMLDivElement>) => Promise<void>;
+        onDragLeave: () => void;
+        onDragEnter: (e: React.DragEvent) => void;
+        onDragOver: (e: React.DragEvent) => void;
+    };
+};

package/dist/types/components/FileUploader/hooks/useFormatFiles.d.ts

@@ -0,0 +1 @@
+export declare function useFormatFiles(): (allFiles: File[]) => Promise<void>;

package/dist/types/components/FileUploader/hooks/useOnMounted.d.ts

@@ -0,0 +1 @@
+export declare function useOnMounted(): void;

package/dist/types/components/FileUploader/hooks/useRemoveFilesInUploadQueue.d.ts

@@ -0,0 +1 @@
+export declare function useRemoveFilesInUploadQueue(): (duplicationOfName: Set<string>) => void;

package/dist/types/components/FileUploader/hooks/useResumeUnfinishedUploads.d.ts

@@ -0,0 +1,3 @@
+import { ModalFuncProps } from 'antd';
+export declare const confirmModalConfig: ModalFuncProps;
+export declare function useResumeUnfinishedUploads(identifier: string): () => Promise<void>;

package/dist/types/components/FileUploader/hooks/useRetryUpload.d.ts

@@ -0,0 +1,2 @@
+import { UploadableFile } from '../types';
+export declare function useRetryUpload(): (selectedFile: UploadableFile) => Promise<void>;

package/dist/types/components/FileUploader/hooks/useSaveUnfinishedUploads.d.ts

@@ -0,0 +1,11 @@
+import { UploadStore } from '../UploadStoreProvider';
+import { UploadableFile } from '../types';
+/**
+ * 未完成任务信息存储在localStorage而不是indexdb中，需要分别处理
+ * 因为之前的测试中发现，indexdb的存储方式在某些浏览器中会丢失数据
+ * 所以需要将未完成任务信息存储在localStorage中
+ *
+ * TODO: 将未完成任务信息存储在indexdb中
+ */
+export declare function useSaveUnfinishedUploads(uploadStore: UploadStore): void;
+export declare function formatUnfinishedUploads(uploads: UploadableFile[]): string;

package/dist/types/components/FileUploader/hooks/useUploadContext.d.ts

@@ -0,0 +1,26 @@
+import { FileInfo, UploadableFile, UploadManager } from '../types';
+export declare const rootAtom: import("jotai").PrimitiveAtom<string> & {
+    init: string;
+};
+export declare const identifierAtom: import("jotai").PrimitiveAtom<string> & {
+    init: string;
+};
+export declare const showFinishedAtom: import("jotai").PrimitiveAtom<boolean> & {
+    init: boolean;
+};
+export declare const uploadManagerAtom: import("jotai").PrimitiveAtom<UploadManager | null> & {
+    init: UploadManager | null;
+};
+export declare const onUploadSuccessAtom: import("jotai").PrimitiveAtom<((file: UploadableFile) => void) | null> & {
+    init: ((file: UploadableFile) => void) | null;
+};
+export declare const externalUploadContextAtom: import("jotai").PrimitiveAtom<FileInfo[]> & {
+    init: FileInfo[];
+};
+export declare function useUploadContext({ root, identifier, showFinished, externalUploadContext, getUploadUrls, onCancelUpload, onOnePartDone, onAllPartDone, onUploadSuccess, onDeleteFile, }: {
+    root?: string;
+    identifier: string;
+    showFinished?: boolean;
+    externalUploadContext?: FileInfo[];
+    onUploadSuccess?: (file: UploadableFile) => void;
+} & UploadManager): void;

package/dist/types/components/FileUploader/hooks/useWathUploadQueueAndSetupCurrentFile.d.ts

@@ -0,0 +1 @@
+export declare function useWathUploadQueueAndSetupCurrentFile(): void;

package/dist/types/components/FileUploader/icons/CloseFilled.d.ts

@@ -0,0 +1 @@
+export default function CloseFilled(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/icons/UnkownFileIcon.d.ts

@@ -0,0 +1 @@
+export default function UnkownFileIcon(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/icons/UploadIcon.d.ts

@@ -0,0 +1 @@
+export default function UploadIcon(props: React.SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/index.d.ts

@@ -0,0 +1,6 @@
+import UploadStoreProvider from './UploadStoreProvider';
+import FileUploader from './FileUploader';
+import FileUploadModal from './FileUploadModal';
+export { UploadStoreProvider };
+export { FileUploadModal };
+export default FileUploader;

package/dist/types/components/FileUploader/types.d.ts

@@ -0,0 +1,60 @@
+export type UploadUrl = {
+    uploadUrl: string;
+    partNum: number;
+};
+export declare const enum FILE_UPLOAD_STATUS {
+    INIT = 1,
+    UPLOADING = 2,
+    ALL_UPLOADED = 3,
+    FINISHED = 4,
+    FAILED = 5,
+    PAUSED = 6,
+    CANCELED = 7
+}
+export type UploadableFile = {
+    raw?: File;
+    uploadId: string;
+    fileName: string;
+    chunkSize: number;
+    partCount: number;
+    percentage: number;
+    expiryTime?: string;
+    uploadStatus: number[];
+    failSeq: UploadUrl[];
+    uploadUrls: UploadUrl[];
+    completeSeq: UploadUrl[];
+    fileStatus: FILE_UPLOAD_STATUS;
+    cancelControllers: {
+        [key: string]: AbortController;
+    };
+};
+export type FileInfo = {
+    fileName: string;
+    isFolder?: boolean;
+};
+type UploadInfoErrorResult = {
+    status: false;
+    reason?: string;
+};
+type UploadInfoSuccessResult = {
+    status: true;
+    uploadInfo: {
+        uploadUrls: UploadUrl[];
+        uploadId: string;
+    };
+};
+type UploadInfoResult = UploadInfoErrorResult | UploadInfoSuccessResult;
+export type UploadManager = {
+    getUploadUrls: (fileName: string, partCount: number) => Promise<UploadInfoResult>;
+    onCancelUpload: (fileName: string, uploadId: string) => Promise<UploadInfoErrorResult | {
+        status: true;
+    }>;
+    onOnePartDone: (fileName: string, uploadId: string, partNum: number) => Promise<UploadInfoErrorResult | {
+        status: true;
+    }>;
+    onAllPartDone: (fileName: string, uploadId: string) => Promise<UploadInfoErrorResult | {
+        status: true;
+    }>;
+    onDeleteFile?: (filePath: string) => Promise<boolean>;
+};
+export {};

package/dist/types/components/FileUploader/utils/calcDisplaySize.d.ts

@@ -0,0 +1,4 @@
+export declare const KB: 1024;
+export declare const MB: 1048576;
+export declare const GB: 1073741824;
+export declare function calcDisplaySize(size: number): string;

package/dist/types/components/FileUploader/utils/checkExpiryTime.d.ts

@@ -0,0 +1,5 @@
+export declare const enum CHECK_RESULT {
+    SHOULD_CREATE_NEW_FILE = 0,
+    SHOULD_USE_OLD_INFO = 1
+}
+export declare function checkExpiryTime(expiryTime?: string): CHECK_RESULT;

package/dist/types/components/FileUploader/utils/createFileToUpload.d.ts

@@ -0,0 +1,2 @@
+import { UploadableFile, UploadManager } from '../types';
+export declare function createFileToUpload(raw: File, root: string | undefined, getUploadUrls: UploadManager['getUploadUrls']): Promise<UploadableFile>;

package/dist/types/components/FileUploader/utils/fileDB/addFilesToIndexdb.d.ts

@@ -0,0 +1 @@
+export declare function addFilesToIndexdb(storeName: string, files: File[]): void;

package/dist/types/components/FileUploader/utils/fileDB/deleteFileInStore.d.ts

@@ -0,0 +1 @@
+export declare function deleteFileInStore(storeName: string, fileName: string): void;

package/dist/types/components/FileUploader/utils/fileDB/deleteObjectStore.d.ts

@@ -0,0 +1 @@
+export declare function deleteObjectStore(storeName: string): Promise<void>;

package/dist/types/components/FileUploader/utils/fileDB/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * IndexedDB 是一个底层的 API，用于在客户端存储大量的结构化数据。
+ * 它是一个事务型数据库系统，类似于基于 SQL 的 RDBMS。
+ *
+ * 事务是一组原子性的数据库操作，具有以下特点(ACID):
+ * 1. 原子性(Atomicity): 事务中的所有操作要么全部成功，要么全部失败回滚
+ * 2. 一致性(Consistency): 事务执行前后数据库必须处于一致状态
+ * 3. 隔离性(Isolation): 多个事务并发执行时不会相互影响
+ * 4. 持久性(Durability): 事务一旦提交，其结果就是永久性的
+ *
+ * 一致状态（Consistency）是指数据库在事务执行前后都必须满足预定的规则和约束条件，保持数据的完整性和有效性。
+ *
+ * 在 IndexedDB 中:
+ * - 所有数据操作都必须在事务中进行
+ * - 事务可以是只读或读写的
+ * - 事务有自动提交和回滚机制
+ * - 事务具有作用域，只能访问指定的对象仓库
+ *
+ * 基本概念:
+ * - Database: 数据库
+ * - ObjectStore: 对象仓库，类似于关系型数据库中的表
+ * - Index: 索引，用于加快数据检索
+ * - Transaction: 事务，确保数据操作的原子性
+ * - Cursor: 游标，用于遍历数据
+ *
+ * 主要 API:
+ * 1. 打开数据库:
+ *    const request = indexedDB.open(dbName, version)
+ *
+ * 2. 创建对象仓库:
+ *    db.createObjectStore(storeName, { keyPath: 'id' })
+ *
+ * 3. 事务操作:
+ *    const transaction = db.transaction([storeName], 'readwrite')
+ *    const store = transaction.objectStore(storeName)
+ *
+ * 4. 数据操作:
+ *    - 添加: store.add(data)
+ *    - 获取: store.get(key)
+ *    - 更新: store.put(data)
+ *    - 删除: store.delete(key)
+ *
+ * 5. 索引操作:
+ *    - 创建: store.createIndex(indexName, keyPath)
+ *    - 使用: store.index(indexName).get(value)
+ *
+ * KeyPath 说明:
+ * - keyPath 是对象仓库中用于唯一标识记录的属性路径
+ * - 它类似于关系型数据库中的主键(Primary Key)
+ * - keyPath 可以是:
+ *   1. 简单字符串: { keyPath: 'id' }
+ *      示例数据: { id: 1, name: 'file1' }
+ *
+ *   2. 点符号路径: { keyPath: 'user.id' }
+ *      示例数据: { user: { id: 1 }, name: 'file1' }
+ *
+ *   3. 数组路径: { keyPath: ['userId', 'timestamp'] }
+ *      示例数据: { userId: 1, timestamp: 123456, name: 'file1' }
+ *
+ * - 如果不指定 keyPath，可以使用自动生成的键:
+ *   db.createObjectStore(storeName, { autoIncrement: true })
+ *
+ * - keyPath 的值必须是:
+ *   - 唯一的
+ *   - 非空的
+ *   - 可以是数字、字符串或日期类型
+ *   - 不能是数组或对象类型（除非是复合键）
+ */
+export declare const DATABASE_NAME = "uploadStore";
+export declare let CURRENT_DATABASE_CONNECTION: IDBDatabase;
+export declare function updateUploadsDatabase(db: IDBDatabase): void;
+export { openDBAndRetrieveData } from './openDBAndRetrieveData';
+export { addFilesToIndexdb } from './addFilesToIndexdb';
+export { deleteFileInStore } from './deleteFileInStore';
+export { deleteObjectStore } from './deleteObjectStore';

package/dist/types/components/FileUploader/utils/fileDB/openDBAndRetrieveData.d.ts

@@ -0,0 +1,29 @@
+/**
+ * IndexedDB 数据库操作说明：
+ *
+ * 1. 版本升级机制
+ *    - 每个数据库都有一个版本号，用于管理数据库结构的变化
+ *    - 当需要修改数据库结构（如添加/删除对象仓库）时，必须升级数据库版本
+ *    - 版本号必须递增，不能降级或重用相同版本号
+ *
+ * 2. 升级流程
+ *    - 首先关闭现有数据库连接
+ *    - 使用新版本号打开数据库，触发 onupgradeneeded 事件
+ *    - 在 onupgradeneeded 事件中进行数据库结构修改（这是唯一可以修改数据库结构的地方）
+ *
+ * 3. 注意事项
+ *    - 升级过程中需要处理各种错误情况（如被阻塞、升级失败等）
+ *    - 需要监听 versionchange 事件，确保数据库连接正确关闭
+ *    - 建议在升级完成后重新检查对象仓库是否创建成功
+ *
+ * 4. 事件执行顺序
+ *    - 当打开数据库时：
+ *      a. 如果数据库不需要升级：直接触发 onsuccess
+ *      b. 如果数据库需要升级：
+ *         1. 先触发 onupgradeneeded（在此事件中修改数据库结构）
+ *         2. 再触发 onsuccess（表示数据库打开成功）
+ *    - 错误处理：
+ *      - onerror：在任何阶段发生错误时触发
+ *      - onblocked：当其他标签页正在使用旧版本数据库时触发
+ */
+export declare function openDBAndRetrieveData(storeName: string): Promise<File[]>;

package/dist/types/components/FileUploader/utils/fileDB/retrieveExistingData.d.ts

@@ -0,0 +1,22 @@
+/**
+ * IDBDatabase.transaction 使用说明:
+ * - 用于创建一个事务，以便在 IndexedDB 数据库中执行一系列的操作。
+ * - 语法: const transaction = db.transaction(storeNames, mode);
+ *   - `storeNames`: 字符串或字符串数组，表示要访问的对象仓库名称。
+ *   - `mode`: 事务模式，'readonly' 或 'readwrite'，默认 'readonly'。
+ * - 事务模式:
+ *   - `readonly`: 只能读取数据。
+ *   - `readwrite`: 可以进行读写操作。
+ * - 注意:
+ *   - 事务只能访问在创建时指定的对象仓库。
+ *   - 事务在所有操作完成后会自动提交，失败则回滚。
+ *   - 事务和请求都有各自的事件处理程序。
+ *
+ * objectStore.openCursor 使用说明:
+ * - 游标的遍历是异步的，使用事件驱动机制:
+ *   - `onsuccess` 事件在游标初始化/游标成功移动到一条记录时触发。
+ *   - 当游标指向一条记录时，可以访问该记录的 key 和 value。
+ *   - 调用 cursor.continue() 会将游标移动到下一条记录，并再次触发 onsuccess 事件。
+ *   - 这个过程会一直持续，直到游标遍历完所有记录。当游标遍历完所有记录时，`onsuccess` 事件中 `cursor.result` 为 `null`，此时解析 Promise。
+ */
+export declare function retrieveExistingData(storeName: string): Promise<File[]>;

package/dist/types/components/FileUploader/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './checkExpiryTime';
+export * from './createFileToUpload';
+export * from './splitFileIntoChunk';
+export * from './calcDisplaySize';
+export * as fileDB from './fileDB';
+export * from './retrieveAllFiles';

package/dist/types/components/FileUploader/utils/retrieveAllFiles.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 文件系统 API 中，FileSystemEntry 是表示文件系统中的条目（项目）的基础接口, 它可以是文件或目录,主要有两种类型的 Entry：
+ * 1. FileSystemFileEntry（文件条目）代表一个文件, 可以通过 file() 方法获取实际的 File 对象
+ * 2. FileSystemDirectoryEntry（目录条目）代表一个文件夹/目录, 可以包含其他文件或目录, 可以通过 createReader() 方法读取目录内容
+ */
+declare function retrieveFilesFromEntry(item: FileSystemEntry, directory: boolean, acceptList: Set<string>, fileNameWithLocation?: string): Promise<File[]>;
+export { retrieveFilesFromEntry as retrieveAllFiles };

package/dist/types/components/FileUploader/utils/splitFileIntoChunk.d.ts

@@ -0,0 +1,8 @@
+import { UploadableFile } from '../types';
+import { UploadUrl } from '../types';
+type ChunkInfo = {
+    url: UploadUrl;
+    chunk: Blob;
+};
+export declare function splitFileIntoChunk(file: UploadableFile): ChunkInfo[];
+export {};

package/dist/types/components/copy/demo/index.d.ts

@@ -0,0 +1 @@
+export default function Demo(): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/copy/index.d.ts

@@ -0,0 +1,21 @@
+export interface ICopy {
+    /** 是否展示复制成功后的反馈信息，默认展示 */
+    showFeedback?: boolean;
+    /** 待复制到粘贴板的文本，如果传入为null or undefined，将不会自动复制到粘贴板 */
+    text?: string;
+    onClick?: () => void;
+    /** 语言，默认:zh */
+    lang?: 'zh' | 'en';
+}
+export default function Copy(props: ICopy): import("react/jsx-runtime").JSX.Element;
+/**
+ * 复制文本内容到粘贴板
+ * @param text {string} 文本内容
+ * @param options {object} 其它选项
+ * @param options.showFeedback {boolean} 是否展示复制成功的反馈信息，默认展示
+ * @param options.lang {string} 语言，默认:zh
+ */
+export declare function copy(text: string, options?: {
+    showFeedback?: boolean;
+    lang?: 'zh' | 'en';
+}): void;

package/dist/types/components/uploadDrawer/UploadStoreProvider.d.ts

@@ -30,7 +30,10 @@ type UploadStoreDispatch = React.Dispatch<UploadStoreAction>;
 export declare const TEMP_STORE: {};
 export declare const UploadStoreContext: React.Context<UploadStore>;
 export declare const UploadStoreDispatchContext: React.Context<UploadStoreDispatch>;
-export default function UploadStoreProvider({ children }: {
+/**
+ * @deprecated This component is deprecated and will be removed in future releases.
+ */
+export default function UploadDrawerUploadStoreProvider({ children }: {
     children: React.ReactElement;
 }): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/uploadDrawer/index.d.ts

@@ -1,4 +1,4 @@
-import UploadStoreProvider from './UploadStoreProvider';
+import UploadDrawerUploadStoreProvider from './UploadStoreProvider';
 import { FileUploadDrawerProps } from './fileUploadDrawer';
 import './index.css';
 export type UploadUrl = {
@@ -40,5 +40,8 @@ export type FileUploadDrawerContextProps = {
     }>;
 };
 export declare const FileUploadDrawerContext: import("react").Context<FileUploadDrawerContextProps>;
-export { UploadStoreProvider };
+export { UploadDrawerUploadStoreProvider };
+/**
+ * @deprecated This component is deprecated and will be removed in future releases.
+ */
 export default function FileUploadDrawer(props: FileUploadDrawerContextProps & FileUploadDrawerProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/index.d.ts

@@ -1,8 +1,14 @@
 export { default as Header } from './components/header';
 export { default as InputTag } from './components/input-tag';
 export type { IProps as InputTagProps } from './components/input-tag';
-export { default as FileUploadDrawer, UploadStoreProvider } from './components/uploadDrawer';
+export { default as FileUploadDrawer } from './components/uploadDrawer';
+export { UploadDrawerUploadStoreProvider } from './components/uploadDrawer';
+export { default as FileUploader } from './components/FileUploader';
+export { FileUploadModal } from './components/FileUploader';
+export { UploadStoreProvider } from './components/FileUploader';
 export { default as FilePreview } from './components/file-preview';
+export { default as Copy, copy } from './components/copy';
+export type { ICopy } from './components/copy';
 export { default as ConfirmAgain } from './components/confirm-again';
 export { default as FloatingLayer } from './components/floating-layer';
 export type { IFilePreviewProps } from './components/file-preview/interface';