@zjlab-fe/data-hub-ui 0.9.1 → 0.10.1

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

@@ -8,4 +8,7 @@ export interface FileUploadModalProps extends Omit<FileUploaderProps, 'dragAreaC
         uploadRequest?: FileUploaderProps['uploadRequestConfig'];
     };
 }
+/**
+ * @deprecated This component is deprecated and will be removed in future releases.
+ */
 export default function FileUploadModal({ config: { modal, dragArea, uploadRequest }, ...props }: FileUploadModalProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,2 +1,5 @@
 import { FileUploaderProps } from './FileUploaderImpl/FileUploader';
+/**
+ * @deprecated This component is deprecated and will be removed in future releases.
+ */
 export default function FileUploader(props: FileUploaderProps): import("react/jsx-runtime").JSX.Element;

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

@@ -9,6 +9,9 @@ export declare const AllOnUploadSuccessesDispatchContext: React.Context<Dispath<
 export declare const TEMP_STORE: {};
 export declare const UploadStoreContext: React.Context<UploadStore>;
 export declare const UploadStoreDispatchContext: React.Context<UploadStoreDispatch>;
+/**
+ * @deprecated This component is deprecated and will be removed in future releases.
+ */
 export default function UploadStoreProvider({ locale, children, }: {
     locale?: 'zh' | 'en';
     children: React.ReactElement;

package/dist/types/components/file-uploader/components/circle-progress.d.ts

@@ -1,6 +1,6 @@
 import './circle-progress.css';
-export declare function CircleProgress({ percent, isFailed, isCompleted, }: {
+export declare function CircleProgress({ percent, isFailed, isSuccess, }: {
     percent: number;
     isFailed: boolean;
-    isCompleted: boolean;
+    isSuccess: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/file-uploader/components/hooks/use-drop-zone.d.ts

@@ -1,10 +1,11 @@
 import { type DragEvent } from 'react';
+import { type FileWithPath } from '../utils/directory-reader';
 import type { DropZoneError } from '../uploader-drop-zone';
 interface UseDropZoneProps {
     disabled: boolean;
     directory: boolean;
     accept: string;
-    onFilesReady: (files: File[]) => void;
+    onFilesReady: (files: FileWithPath[]) => void;
     onError?: (error: DropZoneError) => void;
 }
 export declare function useDropZone({ disabled, directory, accept, onFilesReady, onError }: UseDropZoneProps): {

package/dist/types/components/file-uploader/components/hooks/use-file-validation.d.ts

@@ -1,12 +1,13 @@
 import type { DropZoneError } from '../uploader-drop-zone';
+import type { FileWithPath } from '../utils/directory-reader';
 interface UseFileValidationProps {
     maxSize?: number;
     maxFiles?: number;
     fileValidation?: (file: File) => boolean | Promise<boolean>;
-    onDrop: (files: File[]) => void;
+    onDrop: (files: FileWithPath[]) => void;
     onError?: (error: DropZoneError) => void;
 }
 export declare function useFileValidation({ maxSize, maxFiles, fileValidation, onDrop, onError, }: UseFileValidationProps): {
-    processFiles: (files: File[]) => Promise<void>;
+    processFiles: (files: FileWithPath[]) => Promise<void>;
 };
 export {};

package/dist/types/components/file-uploader/components/uploader-drop-zone.d.ts

@@ -1,7 +1,8 @@
 import { type ReactNode } from 'react';
+import type { FileWithPath } from './utils/directory-reader';
 import './theme.css';
 import './uploader-drop-zone.css';
-export interface UploadDropZoneClassNames {
+export interface UploaderDropZoneClassNames {
     /** Container wrapper class */
     container?: string;
     /** Drag area class */
@@ -17,7 +18,7 @@ export interface UploadDropZoneClassNames {
     /** File input class */
     input?: string;
 }
-export interface UploadDropZoneProps {
+export interface UploaderDropZoneProps {
     /** File type filter (e.g., "image/*,video/*" or ".pdf,.doc") */
     accept?: string;
     /** Maximum file size in bytes */
@@ -33,9 +34,9 @@ export interface UploadDropZoneProps {
     /** Custom icon - can be a React component or image/svg path */
     icon?: ReactNode | string;
     /** Custom class names for different elements */
-    classNames?: UploadDropZoneClassNames;
+    classNames?: UploaderDropZoneClassNames;
     /** Callback when files are dropped or selected */
-    onDrop: (files: File[]) => void;
+    onDrop: (files: FileWithPath[]) => void;
     /** custom file validation callback */
     fileValidation?: (file: File) => boolean | Promise<boolean>;
     /** Called when validation fails */
@@ -46,4 +47,4 @@ export interface DropZoneError {
     message: string;
     rejectedFiles?: File[];
 }
-export declare function UploadDropZone({ accept, maxSize, maxFiles, directory, disabled, dragAreaDescription, icon, classNames, onDrop, fileValidation, onError, }: UploadDropZoneProps): import("react/jsx-runtime").JSX.Element;
+export declare function UploaderDropZone({ accept, maxSize, maxFiles, directory, disabled, dragAreaDescription, icon, classNames, onDrop, fileValidation, onError, }: UploaderDropZoneProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/file-uploader/components/uploader-file-item.d.ts

@@ -10,6 +10,8 @@ export interface UploaderFileItemClassNames {
     icon?: string;
     /** File name text */
     name?: string;
+    /** File relative path text */
+    relativePath?: string;
     /** Status section wrapper */
     status?: string;
     /** Status text */
@@ -27,6 +29,8 @@ interface FileItemProps {
     file: UploadFile;
     /** Custom class names for different elements */
     classNames?: UploaderFileItemClassNames;
+    /** start function passed from parent that has upload handlers */
+    onStart?: (id: string) => void;
     /** Cancel function passed from parent that has upload handlers */
     onCancel?: (id: string) => void;
     /** Remove function passed from parent that has upload handlers */

package/dist/types/components/file-uploader/components/uploader.d.ts

@@ -1,7 +1,7 @@
 import './theme.css';
 import './uploader.css';
 import { type ReactNode } from 'react';
-import { type DropZoneError, type UploadDropZoneClassNames } from './uploader-drop-zone';
+import { type DropZoneError, type UploaderDropZoneClassNames } from './uploader-drop-zone';
 import type { UploadHandlers } from '../types';
 import { type FileListClassNames } from './uploader-file-list';
 import { type UploaderFileItemClassNames } from './uploader-file-item';
@@ -23,7 +23,7 @@ interface UploaderProps {
     /** Additional class name for the uploader container */
     classNames?: {
         container?: string;
-        dragZone?: UploadDropZoneClassNames;
+        dragZone?: UploaderDropZoneClassNames;
         fileList?: UploaderFileItemClassNames;
         fileItem?: FileListClassNames;
     };

package/dist/types/components/file-uploader/components/uploading-status.d.ts

@@ -0,0 +1,9 @@
+import './uploading-status.css';
+interface UploadingStatusProps {
+    /** Interval in ms to shuffle messages (default: 10000) */
+    interval?: number;
+    /** Custom class name */
+    className?: string;
+}
+export declare function UploadingStatus({ interval, className }: UploadingStatusProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/file-uploader/components/utils/directory-reader.d.ts

@@ -1,4 +1,8 @@
+export interface FileWithPath {
+    file: File;
+    relativePath: string;
+}
 /**
  * Recursively reads files from a FileSystemEntry (file or directory)
  */
-export declare function readEntry(entry: FileSystemEntry, acceptFilter: string): Promise<File[]>;
+export declare function readEntry(entry: FileSystemEntry, acceptFilter: string, directory?: boolean, basePath?: string): Promise<FileWithPath[]>;

package/dist/types/components/file-uploader/constants.d.ts

@@ -13,7 +13,7 @@ export declare const UploadStatus: {
     readonly UPLOADING: "uploading";
     readonly PAUSED: "paused";
     readonly MERGING: "merging";
-    readonly COMPLETED: "completed";
+    readonly SUCCESS: "success";
     readonly FAILED: "failed";
     readonly CANCELLED: "cancelled";
 };

package/dist/types/components/file-uploader/hooks/use-upload.d.ts

@@ -1,14 +1,15 @@
+import type { AddFilesOptions, UploadFile } from '../types';
+import type { FileWithPath } from '../components/utils/directory-reader';
 /**
- * Main consumer hook for file uploads - Composition of all specialized hooks.
+ * Main consumer hook for file uploads - Core functionality.
  *
- * This hook provides the complete upload API by composing:
- * - `useUploadFiles` - File state and selectors
- * - `useUploadOperations` - File management (add, remove, clear)
- * - `useUploadControl` - Single file controls (start, pause, resume, cancel)
- * - `useUploadBatch` - Batch operations (startAll, pauseAll, etc.)
+ * This hook provides essential upload API with:
+ * - `files` - All files in the upload queue
+ * - `start`, `pause`, `resume`, `cancel` - Single file controls
+ * - `addFiles`, `removeFile` - File operations
  *
- * Use this hook when you need the full upload functionality.
- * For more focused components, use the specialized hooks directly.
+ * Use this hook for the most common upload scenarios.
+ * For extended functionality (batch operations, file selectors), use `useUploadExtend`.
  *
  * Global config (chunk sizes, concurrency) comes from UploadProvider.
  * Handlers are provided per-file at selection time via addFiles options,
@@ -16,59 +17,69 @@
  *
  * @example
  * ```tsx
- * // Full featured uploader
  * function MyUploader({ datasetId }: { datasetId: string }) {
- *   const { files, addFiles, start, pause, startAll } = useUpload();
+ *   const { files, addFiles, start, pause } = useUpload();
  *
  *   return (
- *     <input
- *       type="file"
- *       onChange={(e) =>
- *         addFiles(e.target.files, {
- *           getHandlers: (file) => ({
- *             onGetUploadUrls: (fileName, partCount) =>
- *               api.getUploadUrls(datasetId, fileName, partCount),
- *             onPartComplete: (fileName, uploadId, partNum) =>
- *               api.markPartComplete(datasetId, uploadId, partNum),
- *             onFileComplete: (fileName, uploadId) =>
- *               api.completeUpload(datasetId, uploadId),
- *           }),
- *         })
- *       }
- *     />
+ *     <>
+ *       <input
+ *         type="file"
+ *         onChange={(e) =>
+ *           addFiles(e.target.files, {
+ *             getHandlers: (file) => ({
+ *               onGetUploadUrls: (fileName, partCount) =>
+ *                 api.getUploadUrls(datasetId, fileName, partCount),
+ *               onPartComplete: (fileName, uploadId, partNum) =>
+ *                 api.markPartComplete(datasetId, uploadId, partNum),
+ *               onFileComplete: (fileName, uploadId) =>
+ *                 api.completeUpload(datasetId, uploadId),
+ *             }),
+ *           })
+ *         }
+ *       />
+ *       <div>
+ *         {files.map(f => (
+ *           <div key={f.id}>
+ *             {f.fileName}
+ *             <button onClick={() => start(f.id)}>Start</button>
+ *           </div>
+ *         ))}
+ *       </div>
+ *     </>
  *   );
  * }
- *
- * // Or use specialized hooks for focused components:
- * function FileList() {
- *   const { files, pendingFiles } = useUploadFiles();
- *   // ...
- * }
- *
- * function ControlButtons({ fileId }) {
- *   const { start, pause } = useUploadControl();
- *   // ...
- * }
  * ```
  */
 export declare function useUpload(): {
-    startAll: () => Promise<void>;
-    pauseAll: () => void;
-    resumeAll: () => Promise<void>;
-    cancelAll: () => void;
+    files: UploadFile[];
+    addFiles: (files: FileWithPath[], addOptions: AddFilesOptions, runtime?: unknown) => undefined;
+    removeFile: (id: string) => Promise<void>;
     start: (id: string) => Promise<void>;
     pause: (id: string) => void;
     resume: (id: string) => Promise<void>;
     cancel: (id: string) => Promise<void>;
-    addFiles: (files: FileList | File[], addOptions: import("..").AddFilesOptions, runtime?: unknown) => import("..").UploadFile[] | undefined;
-    removeFile: (id: string) => Promise<void>;
-    clearCompleted: () => void;
-    clearAll: () => void;
-    files: import("..").UploadFile[];
-    getFileById: (id: string) => import("..").UploadFile | undefined;
-    pendingFiles: import("..").UploadFile[];
-    uploadingFiles: import("..").UploadFile[];
-    completedFiles: import("..").UploadFile[];
-    failedFiles: import("..").UploadFile[];
-    pausedFiles: import("..").UploadFile[];
+    /** Get a specific file by ID */
+    getFileById: (id: string) => UploadFile | undefined;
+    /** Files waiting to be uploaded */
+    pendingFiles: UploadFile[];
+    /** Files currently uploading */
+    uploadingFiles: UploadFile[];
+    /** Successfully completed uploads */
+    successFiles: UploadFile[];
+    /** Failed uploads */
+    failedFiles: UploadFile[];
+    /** Paused uploads */
+    pausedFiles: UploadFile[];
+    /** Start all pending files */
+    startAll: () => Promise<void>;
+    /** Pause all uploading files */
+    pauseAll: () => void;
+    /** Resume all paused files */
+    resumeAll: () => Promise<void>;
+    /** Cancel all uploads */
+    cancelAll: () => void;
+    /** Clear all succeeded files */
+    clearSucceeded: () => Promise<void>;
+    /** Clear all files */
+    clearAll: () => Promise<void>;
 };

package/dist/types/components/file-uploader/index.d.ts

@@ -1,15 +1,12 @@
 export { UploadProvider } from './context/upload-provider';
 export { Uploader as FileUploader } from './components/uploader';
-export { UploadDropZone as UploaderDropZone } from './components/uploader-drop-zone';
+export { UploaderDropZone } from './components/uploader-drop-zone';
 export { UploaderFileListLayout } from './components/uploader-file-list';
 export { UploaderFileItem } from './components/uploader-file-item';
 export { useUpload } from './hooks/use-upload';
-export { useUploadFiles } from './hooks/use-upload-files';
-export { useUploadOperations } from './hooks/use-upload-operations';
-export { useUploadControl } from './hooks/use-upload-control';
-export { useUploadBatch } from './hooks/use-upload-batch';
 export type { UploadFile, ChunkState, UploadHandlers, CallbackResult, GetUploadUrlsResult, UploadUrl, UploadConfig, AddFilesOptions, } from './types';
-export type { DropZoneError, UploadDropZoneClassNames, UploadDropZoneProps, } from './components/uploader-drop-zone';
+export type { DropZoneError, UploaderDropZoneClassNames, UploaderDropZoneProps, } from './components/uploader-drop-zone';
+export type { FileWithPath } from './components/utils/directory-reader';
 export type { FileListClassNames } from './components/uploader-file-list';
 export type { UploaderFileItemClassNames } from './components/uploader-file-item';
 export { UploadStatus } from './constants';

package/dist/types/components/file-uploader/persistence/types.d.ts

@@ -59,7 +59,7 @@ export type RestoreHandlerFn = (runtime: unknown, meta: StoredFileMeta) => Uploa
  * Stored chunk metadata (without actual data)
  */
 export interface StoredChunkMeta {
-    partNum: number;
+    partNum?: number;
     status: ChunkStatusType;
     progress: number;
     uploadUrl?: string;
@@ -76,6 +76,8 @@ export interface StoredFileMeta {
     fileName: string;
     /** File size in bytes */
     fileSize: number;
+    /** Relative path of the file */
+    relativePath: string;
     /** File last modified timestamp */
     lastModified: number;
     /** Current upload status */

package/dist/types/components/file-uploader/types.d.ts

@@ -5,7 +5,7 @@ export interface UploadUrl {
     partNum: number;
 }
 export interface ChunkState {
-    partNum: number;
+    partNum?: number;
     status: ChunkStatusType;
     progress: number;
     uploadUrl?: string;
@@ -22,6 +22,7 @@ export interface UploadFile {
     uploadId: string;
     chunks: ChunkState[];
     chunkSize: number;
+    relativePath: string;
     runtime?: unknown;
     error?: string;
     errorCode?: string;
@@ -118,10 +119,6 @@ export type UploadAction = {
 } | {
     type: 'REMOVE_FILE';
     id: string;
-} | {
-    type: 'CLEAR_COMPLETED';
-} | {
-    type: 'CLEAR_ALL';
 };
 export interface UploadContextValue {
     /** Upload state (files list, processing status) */

package/dist/types/components/file-uploader/utils/chunk-handlers.d.ts

@@ -11,7 +11,7 @@ export declare function calculateTotalChunks(fileSize: number, chunkSize: number
  * Create initial chunk states for a file
  * @param fileSize - Total file size in bytes
  * @param chunkSize - Size of each chunk in bytes
- * @returns Array of ChunkState objects
+ * @returns Array of ChunkState objects with status and progress, partNum will be assigned later based on server response
  */
 export declare function createChunks(fileSize: number, chunkSize: number): ChunkState[];
 /**

package/dist/types/index.d.ts

@@ -3,11 +3,12 @@ export { default as InputTag } from './components/input-tag';
 export type { IProps as InputTagProps } from './components/input-tag';
 export { default as FileUploadDrawer } from './components/uploadDrawer';
 export { UploadDrawerUploadStoreProvider } from './components/uploadDrawer';
-export { default as FileUploader } from './components/FileUploader';
+export { default as FileUploaderDeprecated } from './components/FileUploader';
 export { FileUploadModal } from './components/FileUploader';
 export { UploadStoreProvider } from './components/FileUploader';
 export type { FileUploadModalProps } from './components/FileUploader/FileUploadModal';
 export type { FileUploaderProps } from './components/FileUploader/FileUploaderImpl/FileUploader';
+export * from './components/file-uploader';
 export { default as FilePreview } from './components/file-preview';
 export { default as Copy, copy } from './components/copy';
 export type { ICopy } from './components/copy';