react-upload-pro 0.1.0

package/dist/UploadProgress-8cEls1YP.d.cts

@@ -0,0 +1,145 @@
+import { HTMLAttributes, InputHTMLAttributes, Ref, RefObject } from 'react';
+import { k as UploaderConfig, D as DropzoneCallbacks, f as UploadFile, l as ValidationError, d as DropzoneState, c as DropzoneOptions } from './types-BDyFUrlv.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type Listener = (files: UploadFile[]) => void;
+/**
+ * Central upload coordinator. Owns the list of files, drives the upload
+ * lifecycle (start/pause/resume/retry/cancel/remove), and emits updates
+ * to subscribed React hooks.
+ *
+ * The queue is intentionally framework-agnostic — the hooks layer adapts it.
+ */
+declare class UploadQueue {
+    private files;
+    private listeners;
+    private inFlight;
+    private callbacks;
+    private config;
+    private completionFired;
+    constructor(config?: UploaderConfig, callbacks?: DropzoneCallbacks);
+    getFiles(): UploadFile[];
+    subscribe(listener: Listener): () => void;
+    updateConfig(config: UploaderConfig): void;
+    updateCallbacks(callbacks: DropzoneCallbacks): void;
+    add(files: UploadFile[]): void;
+    remove(id: string): void;
+    removeAll(): void;
+    reorder(fromIndex: number, toIndex: number): void;
+    rename(id: string, newName: string): void;
+    setMetadata(id: string, metadata: UploadFile['metadata']): void;
+    start(): Promise<void>;
+    pause(id: string): void;
+    resume(id: string): void;
+    retry(id: string): void;
+    cancel(id: string): void;
+    private runFile;
+    private lookup;
+    private patch;
+    private emit;
+    private maybeFireCompletion;
+}
+
+interface UseUploadQueueOptions extends UploaderConfig, DropzoneCallbacks {
+}
+interface UseUploadQueueReturn {
+    queue: UploadQueue;
+    files: UploadFile[];
+    add: (files: UploadFile[]) => void;
+    remove: (id: string) => void;
+    removeAll: () => void;
+    reorder: (from: number, to: number) => void;
+    rename: (id: string, name: string) => void;
+    setMetadata: (id: string, metadata: UploadFile['metadata']) => void;
+    start: () => Promise<void>;
+    pause: (id: string) => void;
+    resume: (id: string) => void;
+    retry: (id: string) => void;
+    cancel: (id: string) => void;
+}
+/**
+ * Low-level hook that returns a stable UploadQueue instance bound to React state.
+ * Higher-level hooks (useDropzone, useUploader) compose this.
+ */
+declare function useUploadQueue(options?: UseUploadQueueOptions): UseUploadQueueReturn;
+
+/** The bag of props returned by getRootProps. Tagged with data-* attributes for styling. */
+type RootProps<T extends HTMLElement = HTMLDivElement> = HTMLAttributes<T> & {
+    [dataAttr: `data-${string}`]: string | undefined;
+};
+/** Input props returned by getInputProps. Includes a callback ref. */
+type InputProps = InputHTMLAttributes<HTMLInputElement> & {
+    ref?: Ref<HTMLInputElement>;
+    [dataAttr: `data-${string}`]: string | undefined;
+};
+interface UseDropzoneReturn {
+    /** Spread on the dropzone root element. */
+    getRootProps: <T extends HTMLElement = HTMLDivElement>(props?: HTMLAttributes<T>) => RootProps<T>;
+    /** Spread on a hidden <input type="file">. */
+    getInputProps: (props?: InputHTMLAttributes<HTMLInputElement>) => InputProps;
+    /** Open the native file dialog programmatically. */
+    open: () => void;
+    /** Files currently in the queue. */
+    files: UploadFile[];
+    /** Validation errors from the most recent drop. */
+    rejected: ValidationError[];
+    /** Whether anything is being dragged over the dropzone. */
+    isDragging: boolean;
+    /** Whether the current drag would be accepted. */
+    isDragAccept: boolean;
+    isDragReject: boolean;
+    /** Coarse state for styling. */
+    state: DropzoneState;
+    /** Queue helpers. */
+    add: (files: File[]) => Promise<{
+        accepted: UploadFile[];
+        rejected: ValidationError[];
+    }>;
+    remove: (id: string) => void;
+    removeAll: () => void;
+    reorder: (from: number, to: number) => void;
+    start: () => Promise<void>;
+    pause: (id: string) => void;
+    resume: (id: string) => void;
+    retry: (id: string) => void;
+    cancel: (id: string) => void;
+    rename: (id: string, name: string) => void;
+    setMetadata: (id: string, metadata: UploadFile['metadata']) => void;
+    /** Direct queue handle for advanced use. */
+    queue: ReturnType<typeof useUploadQueue>['queue'];
+    /** Ref to the hidden input. */
+    inputRef: RefObject<HTMLInputElement | null>;
+}
+/**
+ * The flagship hook. Wires drag-and-drop, paste, click, and folder upload
+ * to the validation + upload queue. SSR-safe: only attaches DOM listeners
+ * inside effects. Compatible with React 17/18/19.
+ */
+declare function useDropzone(options?: DropzoneOptions): UseDropzoneReturn;
+
+type ProgressVariant = 'bar' | 'striped' | 'circle' | 'minimal' | 'gradient' | 'segmented' | 'dots';
+interface UploadProgressProps extends HTMLAttributes<HTMLDivElement> {
+    /** Progress 0..1 */
+    value: number;
+    /** Visual variant. */
+    variant?: ProgressVariant;
+    /** Show the percentage label. */
+    showLabel?: boolean;
+    /** Size in px for circle/dots variants, height in px for bar variants. */
+    size?: number;
+    /** Color overrides via Tailwind classes (e.g., 'bg-emerald-500'). */
+    fillClassName?: string;
+    /** Track color override. */
+    trackClassName?: string;
+    /** Marks the upload as indeterminate (no known progress). */
+    indeterminate?: boolean;
+    /** Number of segments for segmented/dots variants (default 10). */
+    segments?: number;
+}
+/**
+ * Single-file progress visualization. Pure presentational — does not subscribe
+ * to the queue. Multiple visual variants supported; choose via `variant`.
+ */
+declare function UploadProgress({ value, variant, showLabel, size, fillClassName, trackClassName, indeterminate, segments, className, ...rest }: UploadProgressProps): react_jsx_runtime.JSX.Element;
+
+export { type InputProps as I, type ProgressVariant as P, type RootProps as R, UploadProgress as U, type UploadProgressProps as a, UploadQueue as b, type UseDropzoneReturn as c, type UseUploadQueueOptions as d, type UseUploadQueueReturn as e, useUploadQueue as f, useDropzone as u };

package/dist/UploadProgress-uRdhENqW.d.ts

@@ -0,0 +1,145 @@
+import { HTMLAttributes, InputHTMLAttributes, Ref, RefObject } from 'react';
+import { k as UploaderConfig, D as DropzoneCallbacks, f as UploadFile, l as ValidationError, d as DropzoneState, c as DropzoneOptions } from './types-BDyFUrlv.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type Listener = (files: UploadFile[]) => void;
+/**
+ * Central upload coordinator. Owns the list of files, drives the upload
+ * lifecycle (start/pause/resume/retry/cancel/remove), and emits updates
+ * to subscribed React hooks.
+ *
+ * The queue is intentionally framework-agnostic — the hooks layer adapts it.
+ */
+declare class UploadQueue {
+    private files;
+    private listeners;
+    private inFlight;
+    private callbacks;
+    private config;
+    private completionFired;
+    constructor(config?: UploaderConfig, callbacks?: DropzoneCallbacks);
+    getFiles(): UploadFile[];
+    subscribe(listener: Listener): () => void;
+    updateConfig(config: UploaderConfig): void;
+    updateCallbacks(callbacks: DropzoneCallbacks): void;
+    add(files: UploadFile[]): void;
+    remove(id: string): void;
+    removeAll(): void;
+    reorder(fromIndex: number, toIndex: number): void;
+    rename(id: string, newName: string): void;
+    setMetadata(id: string, metadata: UploadFile['metadata']): void;
+    start(): Promise<void>;
+    pause(id: string): void;
+    resume(id: string): void;
+    retry(id: string): void;
+    cancel(id: string): void;
+    private runFile;
+    private lookup;
+    private patch;
+    private emit;
+    private maybeFireCompletion;
+}
+
+interface UseUploadQueueOptions extends UploaderConfig, DropzoneCallbacks {
+}
+interface UseUploadQueueReturn {
+    queue: UploadQueue;
+    files: UploadFile[];
+    add: (files: UploadFile[]) => void;
+    remove: (id: string) => void;
+    removeAll: () => void;
+    reorder: (from: number, to: number) => void;
+    rename: (id: string, name: string) => void;
+    setMetadata: (id: string, metadata: UploadFile['metadata']) => void;
+    start: () => Promise<void>;
+    pause: (id: string) => void;
+    resume: (id: string) => void;
+    retry: (id: string) => void;
+    cancel: (id: string) => void;
+}
+/**
+ * Low-level hook that returns a stable UploadQueue instance bound to React state.
+ * Higher-level hooks (useDropzone, useUploader) compose this.
+ */
+declare function useUploadQueue(options?: UseUploadQueueOptions): UseUploadQueueReturn;
+
+/** The bag of props returned by getRootProps. Tagged with data-* attributes for styling. */
+type RootProps<T extends HTMLElement = HTMLDivElement> = HTMLAttributes<T> & {
+    [dataAttr: `data-${string}`]: string | undefined;
+};
+/** Input props returned by getInputProps. Includes a callback ref. */
+type InputProps = InputHTMLAttributes<HTMLInputElement> & {
+    ref?: Ref<HTMLInputElement>;
+    [dataAttr: `data-${string}`]: string | undefined;
+};
+interface UseDropzoneReturn {
+    /** Spread on the dropzone root element. */
+    getRootProps: <T extends HTMLElement = HTMLDivElement>(props?: HTMLAttributes<T>) => RootProps<T>;
+    /** Spread on a hidden <input type="file">. */
+    getInputProps: (props?: InputHTMLAttributes<HTMLInputElement>) => InputProps;
+    /** Open the native file dialog programmatically. */
+    open: () => void;
+    /** Files currently in the queue. */
+    files: UploadFile[];
+    /** Validation errors from the most recent drop. */
+    rejected: ValidationError[];
+    /** Whether anything is being dragged over the dropzone. */
+    isDragging: boolean;
+    /** Whether the current drag would be accepted. */
+    isDragAccept: boolean;
+    isDragReject: boolean;
+    /** Coarse state for styling. */
+    state: DropzoneState;
+    /** Queue helpers. */
+    add: (files: File[]) => Promise<{
+        accepted: UploadFile[];
+        rejected: ValidationError[];
+    }>;
+    remove: (id: string) => void;
+    removeAll: () => void;
+    reorder: (from: number, to: number) => void;
+    start: () => Promise<void>;
+    pause: (id: string) => void;
+    resume: (id: string) => void;
+    retry: (id: string) => void;
+    cancel: (id: string) => void;
+    rename: (id: string, name: string) => void;
+    setMetadata: (id: string, metadata: UploadFile['metadata']) => void;
+    /** Direct queue handle for advanced use. */
+    queue: ReturnType<typeof useUploadQueue>['queue'];
+    /** Ref to the hidden input. */
+    inputRef: RefObject<HTMLInputElement | null>;
+}
+/**
+ * The flagship hook. Wires drag-and-drop, paste, click, and folder upload
+ * to the validation + upload queue. SSR-safe: only attaches DOM listeners
+ * inside effects. Compatible with React 17/18/19.
+ */
+declare function useDropzone(options?: DropzoneOptions): UseDropzoneReturn;
+
+type ProgressVariant = 'bar' | 'striped' | 'circle' | 'minimal' | 'gradient' | 'segmented' | 'dots';
+interface UploadProgressProps extends HTMLAttributes<HTMLDivElement> {
+    /** Progress 0..1 */
+    value: number;
+    /** Visual variant. */
+    variant?: ProgressVariant;
+    /** Show the percentage label. */
+    showLabel?: boolean;
+    /** Size in px for circle/dots variants, height in px for bar variants. */
+    size?: number;
+    /** Color overrides via Tailwind classes (e.g., 'bg-emerald-500'). */
+    fillClassName?: string;
+    /** Track color override. */
+    trackClassName?: string;
+    /** Marks the upload as indeterminate (no known progress). */
+    indeterminate?: boolean;
+    /** Number of segments for segmented/dots variants (default 10). */
+    segments?: number;
+}
+/**
+ * Single-file progress visualization. Pure presentational — does not subscribe
+ * to the queue. Multiple visual variants supported; choose via `variant`.
+ */
+declare function UploadProgress({ value, variant, showLabel, size, fillClassName, trackClassName, indeterminate, segments, className, ...rest }: UploadProgressProps): react_jsx_runtime.JSX.Element;
+
+export { type InputProps as I, type ProgressVariant as P, type RootProps as R, UploadProgress as U, type UploadProgressProps as a, UploadQueue as b, type UseDropzoneReturn as c, type UseUploadQueueOptions as d, type UseUploadQueueReturn as e, useUploadQueue as f, useDropzone as u };