@useupup/core 3.3.0

package/dist/uploader-props-72242002.d.ts

@@ -0,0 +1,340 @@
+import { a as UploadFile, F as FileSource } from './contracts-pipeline-cf177270.js';
+import { I as ImageEditorOptions } from './core-141335ac.js';
+import { L as LocaleBundle, P as PartialMessages } from './ui-translations-c5d00392.js';
+import { M as MaxFileSizeObject, R as ResumableUploadOptions } from './contracts-strategies-378a16b7.js';
+import { f as UpupThemeConfig } from './vars-d3421f6c.js';
+
+declare enum UpupErrorCode {
+    AUTH_EXPIRED = "AUTH_EXPIRED",
+    AUTH_DENIED = "AUTH_DENIED",
+    AUTH_PROVIDER_ERROR = "AUTH_PROVIDER_ERROR",
+    FILE_TOO_LARGE = "FILE_TOO_LARGE",
+    FILE_TOO_SMALL = "FILE_TOO_SMALL",
+    TYPE_MISMATCH = "TYPE_MISMATCH",
+    LIMIT_EXCEEDED = "LIMIT_EXCEEDED",
+    TOTAL_SIZE_EXCEEDED = "TOTAL_SIZE_EXCEEDED",
+    DUPLICATE = "DUPLICATE",
+    MIN_FILES_NOT_MET = "MIN_FILES_NOT_MET",
+    UPLOAD_FAILED = "UPLOAD_FAILED",
+    UPLOAD_ABORTED = "UPLOAD_ABORTED",
+    PRESIGN_FAILED = "PRESIGN_FAILED",
+    CORS_ERROR = "CORS_ERROR",
+    PIPELINE_STEP_FAILED = "PIPELINE_STEP_FAILED",
+    HEIC_CONVERSION_FAILED = "HEIC_CONVERSION_FAILED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT = "TIMEOUT",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    QUOTA_EXCEEDED = "QUOTA_EXCEEDED",
+    NO_UPLOAD_TARGET = "NO_UPLOAD_TARGET",
+    BAD_REQUEST = "BAD_REQUEST",
+    AUTH_REQUIRED = "AUTH_REQUIRED",
+    /** The addressed resource is gone server-side — e.g. resuming a multipart
+     *  upload the storage provider has already completed, aborted, or reaped.
+     *  Always paired with a 4xx so the client starts fresh instead of retrying
+     *  something that will never come back. */
+    NOT_FOUND = "NOT_FOUND"
+}
+type RestrictionFailedReason = UpupErrorCode.TYPE_MISMATCH | UpupErrorCode.FILE_TOO_LARGE | UpupErrorCode.FILE_TOO_SMALL | UpupErrorCode.LIMIT_EXCEEDED | UpupErrorCode.TOTAL_SIZE_EXCEEDED | UpupErrorCode.DUPLICATE | 'BEFORE_FILE_ADDED_REJECTED';
+declare class UpupError extends Error {
+    code: string;
+    retryable: boolean;
+    /** Optional HTTP status the error originated from (set by uploadErrorFromResponse). */
+    status?: number;
+    constructor(message: string, code: string, retryable?: boolean);
+}
+declare class UpupAuthError extends UpupError {
+    provider: string;
+    constructor(message: string, provider: string);
+}
+declare class UpupNetworkError extends UpupError {
+    constructor(message: string, status?: number);
+}
+declare class UpupValidationError extends UpupError {
+    reason: RestrictionFailedReason;
+    file: File;
+    constructor(message: string, reason: RestrictionFailedReason, file: File);
+}
+declare class UpupQuotaError extends UpupError {
+    limit: number;
+    used: number;
+    constructor(message: string, limit: number, used: number);
+}
+declare class UpupStorageError extends UpupError {
+    provider: string;
+    operation: 'presign' | 'upload' | 'multipart-init' | 'multipart-complete' | 'multipart-sign-part' | 'multipart-abort' | 'multipart-resume';
+    constructor(message: string, provider: string, operation: UpupStorageError['operation']);
+}
+declare class UpupConfigError extends UpupError {
+    constructor(message: string, code?: string);
+}
+/**
+ * Best-effort parse of an HTTP error response body into a {code, message}
+ * pair. Tries, in order: JSON `{code, error|message}`, S3-style XML
+ * `<Error><Code>/<Message></Error>`, then falls back to a truncated text
+ * snippet with no code.
+ */
+declare function parseErrorBody(body: string | undefined): {
+    code?: string;
+    message: string;
+};
+interface UploadErrorFromResponseArgs {
+    status: number;
+    statusText: string;
+    body?: string;
+    kind: 'storage' | 'auth' | 'network';
+    /** Required when kind === 'storage'; ignored otherwise. */
+    operation?: UpupStorageError['operation'];
+    /** Provider label for storage/auth errors (e.g. 'S3', 'google-drive'). Defaults to 'server'. */
+    provider?: string;
+}
+/**
+ * Construct a typed, code-carrying error from a failed fetch/XHR response —
+ * the client-side half of the server's `{error, code}` convention (and S3's
+ * own `<Error><Code>` XML). Picks the error class by `kind`; the resulting
+ * `.code` is the server/S3-supplied machine code when present, else falls
+ * back to the HTTP status text.
+ */
+declare function uploadErrorFromResponse(args: UploadErrorFromResponseArgs): UpupError;
+
+type FileUploadResult = {
+    file: UploadFile;
+    url: string;
+    status: 'success' | 'failed' | 'skipped';
+    error?: UpupError;
+};
+
+declare enum StorageProvider {
+    AWS = "aws",
+    Azure = "azure",
+    BackBlaze = "backblaze",
+    DigitalOcean = "digitalocean",
+    CloudflareR2 = "r2",
+    Wasabi = "wasabi",
+    MinIO = "minio",
+    GCS = "gcs",
+    Supabase = "supabase",
+    Hetzner = "hetzner",
+    Linode = "linode",
+    Vultr = "vultr",
+    UpCloud = "upcloud",
+    Scaleway = "scaleway",
+    OVHcloud = "ovhcloud",
+    Alibaba = "alibaba",
+    Oracle = "oracle",
+    Contabo = "contabo",
+    Storj = "storj",
+    IDrive = "idrive",
+    Ceph = "ceph"
+}
+/**
+ * Providers with no S3-compatible API surface (F-657). @useupup/server's storage
+ * path (buildS3ClientConfig) always builds an @aws-sdk/client-s3 client — it
+ * cannot serve a provider in this set no matter what storage.type is set to.
+ * Kept next to the enum so any future non-S3 addition is an explicit,
+ * greppable decision; createUpupHandler's construct-time guard is the sole
+ * consumer.
+ */
+declare const NON_S3_STORAGE_PROVIDERS: ReadonlySet<StorageProvider>;
+
+/**
+ * String-literal accept-set for the public props: everywhere a prop takes a
+ * source id, plain strings ('local', 'googleDrive', …) must typecheck without
+ * importing the FileSource enum. Deliberately kept ALONGSIDE FileSource — not
+ * an accidental alias (F-726 ruling); the accept-set is pinned by
+ * src/__tests__/types/upload-source.test.ts.
+ */
+type UploadSource = `${FileSource}`;
+type UploadProvider = StorageProvider | (string & {});
+
+/**
+ * Shared shape of the UI-package `UploaderProps` across react/vue/svelte/
+ * angular. Each framework extends this with its own `icons` (component type
+ * differs per framework) and `style` (React.CSSProperties vs
+ * Record<string, string>) — the two genuinely framework-specific members.
+ *
+ * Canonical home for the props all four frameworks hand-authored in
+ * parallel; keeping one definition here means a field added to one
+ * framework's copy can no longer silently diverge from the others.
+ */
+type UploaderBaseProps = {
+    /**
+     * Storage provider. Optional for local-only selection and generic
+     * uploadEndpoint/serverUrl flows. When provided, accepts core provider
+     * enum values plus custom provider ids forwarded to user/server code.
+     */
+    provider?: UploadProvider | undefined;
+    /**
+     * Upload mode. `'client'` (default) = browser talks to storage
+     * directly; server only signs URLs. `'server'` = browser talks only
+     * to `serverUrl`, which proxies drive APIs + storage writes. Pick
+     * `'server'` when you can't expose OAuth client secrets to the
+     * browser or when you need server-side compliance/scanning.
+     */
+    mode?: 'client' | 'server' | undefined;
+    /** Source list. e.g. sources={['local','camera','googleDrive']} */
+    sources?: UploadSource[] | undefined;
+    /** Endpoint returning presigned upload URLs. */
+    uploadEndpoint?: string | undefined;
+    /** Server URL for @useupup/server handler. */
+    serverUrl?: string | undefined;
+    /** Maximum number of files that can be added. Default 10. */
+    maxFiles?: number | undefined;
+    /** v2: Theme configuration. mode replaces `dark`, tokens/slots replace flat styling overrides. */
+    theme?: UpupThemeConfig | undefined;
+    /** Folder upload configuration. */
+    folderUpload?: {
+        /** Traverse directories when a user drops a folder onto the uploader. */
+        allowDrop?: boolean;
+        /** Show a "Select folder" action in the local device source. */
+        showSelectFolderButton?: boolean;
+    } | undefined;
+    /** CORS configuration. `dangerouslyAutoConfigure` can mutate storage CORS and should only be used for quick setup. */
+    cors?: {
+        dangerouslyAutoConfigure?: boolean;
+        allowedOrigins: string[];
+        allowedMethods?: string[];
+        allowedHeaders?: string[];
+        maxAgeSeconds?: number;
+    } | undefined;
+    /** Cloud drive configurations. */
+    cloudDrives?: {
+        googleDrive?: {
+            clientId: string;
+            apiKey: string;
+            appId: string;
+        };
+        oneDrive?: {
+            clientId: string;
+            redirectUri?: string;
+        };
+        dropbox?: {
+            clientId: string;
+            redirectUri?: string;
+        };
+        box?: {
+            clientId: string;
+            redirectUri?: string;
+        };
+    } | undefined;
+    /** v2: Enable automatic image compression before upload. */
+    imageCompression?: boolean | undefined;
+    /** v2: Generate thumbnails for images/videos before upload. */
+    thumbnailGenerator?: boolean | undefined;
+    /** v2: Verify file integrity with SHA-256 checksums. */
+    checksumVerification?: boolean | undefined;
+    /** v2: Offload the file pipeline (hash/heic/exif/thumbnail/compress) to a Web Worker. Unset/true = auto; false = main thread. */
+    webWorker?: boolean | undefined;
+    /** v2: Convert HEIC/HEIF images to JPEG before upload. */
+    heicConversion?: boolean | undefined;
+    /** v2: Strip EXIF metadata from images for privacy. */
+    stripExifData?: boolean | undefined;
+    /** v2: Enable content-based deduplication (prevents same file added twice). */
+    contentDeduplication?: boolean | undefined;
+    /** v2: Upload files immediately after selection (no upload button needed). Default false. */
+    autoUpload?: boolean | undefined;
+    /** v2: Maximum concurrent uploads. Default 3. */
+    maxConcurrentUploads?: number | undefined;
+    /** v2: Enable crash recovery — saves upload state to IndexedDB for resume after page refresh */
+    crashRecovery?: boolean | undefined;
+    /** v3: React to browser connectivity — going offline mid-upload pauses the
+     *  run (so multipart sessions persist instead of burning retries against a
+     *  dead network) and coming back online resumes it, only when the pause was
+     *  offline-initiated. Default true; `false` restores fail-and-retry. */
+    networkAware?: boolean | undefined;
+    /** File type filter — MIME patterns, extensions, or preset names (e.g. "images", "documents"). */
+    allowedFileTypes?: string | string[] | undefined;
+    allowPreview?: boolean | undefined;
+    /** v2: Show/hide the upup branding footer. Default true. */
+    showBranding?: boolean | undefined;
+    /** v3: Quiet completion. When true, a successful run shows ONLY a brief
+     *  checkmark over the panel — no Done button, summary, or further CTAs — on
+     *  the assumption the host app takes over via the completion callbacks/events.
+     *  Default false (the normal Done/continue-after-upload flow). */
+    quietCompletion?: boolean | undefined;
+    /** v2: Default animation layer. `false` disables all decorative motion
+     *  (spinner/progress/focus stay). Reduced further automatically under
+     *  `prefers-reduced-motion`. Default true. */
+    animations?: boolean | undefined;
+    /** v2: Disable drag-and-drop (keep browse/click functional). Default false. */
+    disableDragDrop?: boolean | undefined;
+    /** v2: Additional CSS class name applied to the root container */
+    className?: string | undefined;
+    isProcessing?: boolean | undefined;
+    mini?: boolean | undefined;
+    maxFileSize?: MaxFileSizeObject | undefined;
+    /** v2: Minimum file size. Files smaller than this will be rejected. */
+    minFileSize?: MaxFileSizeObject | undefined;
+    /** v2: Maximum total size of all files combined. */
+    maxTotalFileSize?: MaxFileSizeObject | undefined;
+    /** Optional image editor. Pass `true` for defaults or an `ImageEditorOptions` object. */
+    imageEditor?: boolean | ImageEditorOptions | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    maxRetries?: number | undefined;
+    resumable?: ResumableUploadOptions | undefined;
+    /** i18n configuration. Uses ICU locale bundles from `@useupup/core`. */
+    i18n?: {
+        /**
+         * ICU-enabled locale bundle from `@useupup/core/i18n` (e.g. `import { enUS } from '@useupup/core'`).
+         * When provided, enables ICU pluralization, namespaced key overrides, and runtime locale switching.
+         * Takes precedence over `locale`.
+         */
+        bundle?: LocaleBundle;
+        /**
+         * Locale bundle (e.g. `frFR`) or a BCP-47 locale code string
+         * (e.g. 'ar-SA') for lang/dir only.
+         */
+        locale?: LocaleBundle | string;
+        /**
+         * Optional fallback locale bundle/code used when the active bundle is
+         * missing a message key. String codes are for playground/codegen
+         * convenience; pass bundles for translated fallback content.
+         */
+        fallbackLocale?: LocaleBundle | string;
+        /** Per-key overrides merged on top of the locale */
+        overrides?: PartialMessages;
+    } | undefined;
+    onFilesSelected?: ((files: UploadFile[]) => void) | undefined;
+    onDoneClicked?: (() => void) | undefined;
+    onPrepareFiles?: ((files: UploadFile[]) => Promise<UploadFile[]>) | undefined;
+    onFileClick?: ((file: UploadFile) => void) | undefined;
+    onIntegrationClick?: ((integrationType: string) => void) | undefined;
+    onFileUploadStart?: ((file: UploadFile) => void) | undefined;
+    onFileUploadComplete?: ((file: UploadFile, key: string) => void) | undefined;
+    onFilesUploadComplete?: ((files: UploadFile[]) => void) | undefined;
+    onFileUploadProgress?: ((file: UploadFile, progress: {
+        loaded: number;
+        total: number;
+        percentage: number;
+    }) => void) | undefined;
+    onFilesUploadProgress?: ((completedFiles: number, totalFiles: number) => void) | undefined;
+    /** v2: Called once when the batch upload starts */
+    onUploadStart?: (() => void) | undefined;
+    /** v2: Called when all uploads complete or fail */
+    onUploadComplete?: ((files: UploadFile[]) => void) | undefined;
+    /** v2: Called whenever upload status changes (idle → uploading → complete/failed) */
+    onStatusChange?: ((status: string) => void) | undefined;
+    /** v2: Called when a file is removed. */
+    onFileRemoved?: ((file: UploadFile) => void) | undefined;
+    onFilesDragOver?: ((files: File[]) => void) | undefined;
+    onFilesDragLeave?: ((files: File[]) => void) | undefined;
+    onFilesDrop?: ((files: File[]) => void) | undefined;
+    onFileTypeMismatch?: ((file: File, acceptedTypes: string) => void) | undefined;
+    /** v2: Called when a file is rejected for any reason (type, size, limit). */
+    onRestrictionFailed?: ((file: File, reason: 'TYPE_MISMATCH' | 'FILE_TOO_LARGE' | 'FILE_TOO_SMALL' | 'LIMIT_EXCEEDED') => void) | undefined;
+    /** v2: Enable clipboard paste uploads (Ctrl+V / Cmd+V). Default false. */
+    enablePaste?: boolean | undefined;
+    /** v2: Async filter called before each file is added. Return false to reject, a File to replace, or true/undefined to accept. */
+    onBeforeFileAdded?: ((file: File) => boolean | File | undefined | Promise<boolean | File | undefined>) | undefined;
+    onError?: ((errorMessage: string) => void) | undefined;
+    onWarn?: ((warningMessage: string) => void) | undefined;
+    /** v2: After each file upload, open an SSE connection to this endpoint.
+     *  The storage key is appended as ?key=... so the server can identify the file.
+     *  Use this to wait for server-side processing (virus scan, transcoding, etc.). */
+    processingEndpoint?: string | undefined;
+    /** v2: Called when the server sends a processing-complete SSE event for a file. */
+    onFileProcessed?: ((file: UploadFile, data: Record<string, unknown>) => void) | undefined;
+    /** v2: Max milliseconds to wait for the server SSE event before closing. Default 60000. */
+    processingTimeout?: number | undefined;
+};
+
+export { type FileUploadResult as F, NON_S3_STORAGE_PROVIDERS as N, type RestrictionFailedReason as R, StorageProvider as S, type UploadSource as U, type UploadProvider as a, type UploaderBaseProps as b, UpupErrorCode as c, UpupError as d, UpupAuthError as e, UpupNetworkError as f, UpupValidationError as g, UpupQuotaError as h, UpupStorageError as i, UpupConfigError as j, type UploadErrorFromResponseArgs as k, parseErrorBody as p, uploadErrorFromResponse as u };

package/dist/uploader-props-7f956e60.d.cts

@@ -0,0 +1,340 @@
+import { a as UploadFile, F as FileSource } from './contracts-pipeline-cf177270.cjs';
+import { I as ImageEditorOptions } from './core-bea2ceca.cjs';
+import { L as LocaleBundle, P as PartialMessages } from './ui-translations-c5d00392.cjs';
+import { M as MaxFileSizeObject, R as ResumableUploadOptions } from './contracts-strategies-378a16b7.cjs';
+import { f as UpupThemeConfig } from './vars-d3421f6c.cjs';
+
+declare enum UpupErrorCode {
+    AUTH_EXPIRED = "AUTH_EXPIRED",
+    AUTH_DENIED = "AUTH_DENIED",
+    AUTH_PROVIDER_ERROR = "AUTH_PROVIDER_ERROR",
+    FILE_TOO_LARGE = "FILE_TOO_LARGE",
+    FILE_TOO_SMALL = "FILE_TOO_SMALL",
+    TYPE_MISMATCH = "TYPE_MISMATCH",
+    LIMIT_EXCEEDED = "LIMIT_EXCEEDED",
+    TOTAL_SIZE_EXCEEDED = "TOTAL_SIZE_EXCEEDED",
+    DUPLICATE = "DUPLICATE",
+    MIN_FILES_NOT_MET = "MIN_FILES_NOT_MET",
+    UPLOAD_FAILED = "UPLOAD_FAILED",
+    UPLOAD_ABORTED = "UPLOAD_ABORTED",
+    PRESIGN_FAILED = "PRESIGN_FAILED",
+    CORS_ERROR = "CORS_ERROR",
+    PIPELINE_STEP_FAILED = "PIPELINE_STEP_FAILED",
+    HEIC_CONVERSION_FAILED = "HEIC_CONVERSION_FAILED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT = "TIMEOUT",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    QUOTA_EXCEEDED = "QUOTA_EXCEEDED",
+    NO_UPLOAD_TARGET = "NO_UPLOAD_TARGET",
+    BAD_REQUEST = "BAD_REQUEST",
+    AUTH_REQUIRED = "AUTH_REQUIRED",
+    /** The addressed resource is gone server-side — e.g. resuming a multipart
+     *  upload the storage provider has already completed, aborted, or reaped.
+     *  Always paired with a 4xx so the client starts fresh instead of retrying
+     *  something that will never come back. */
+    NOT_FOUND = "NOT_FOUND"
+}
+type RestrictionFailedReason = UpupErrorCode.TYPE_MISMATCH | UpupErrorCode.FILE_TOO_LARGE | UpupErrorCode.FILE_TOO_SMALL | UpupErrorCode.LIMIT_EXCEEDED | UpupErrorCode.TOTAL_SIZE_EXCEEDED | UpupErrorCode.DUPLICATE | 'BEFORE_FILE_ADDED_REJECTED';
+declare class UpupError extends Error {
+    code: string;
+    retryable: boolean;
+    /** Optional HTTP status the error originated from (set by uploadErrorFromResponse). */
+    status?: number;
+    constructor(message: string, code: string, retryable?: boolean);
+}
+declare class UpupAuthError extends UpupError {
+    provider: string;
+    constructor(message: string, provider: string);
+}
+declare class UpupNetworkError extends UpupError {
+    constructor(message: string, status?: number);
+}
+declare class UpupValidationError extends UpupError {
+    reason: RestrictionFailedReason;
+    file: File;
+    constructor(message: string, reason: RestrictionFailedReason, file: File);
+}
+declare class UpupQuotaError extends UpupError {
+    limit: number;
+    used: number;
+    constructor(message: string, limit: number, used: number);
+}
+declare class UpupStorageError extends UpupError {
+    provider: string;
+    operation: 'presign' | 'upload' | 'multipart-init' | 'multipart-complete' | 'multipart-sign-part' | 'multipart-abort' | 'multipart-resume';
+    constructor(message: string, provider: string, operation: UpupStorageError['operation']);
+}
+declare class UpupConfigError extends UpupError {
+    constructor(message: string, code?: string);
+}
+/**
+ * Best-effort parse of an HTTP error response body into a {code, message}
+ * pair. Tries, in order: JSON `{code, error|message}`, S3-style XML
+ * `<Error><Code>/<Message></Error>`, then falls back to a truncated text
+ * snippet with no code.
+ */
+declare function parseErrorBody(body: string | undefined): {
+    code?: string;
+    message: string;
+};
+interface UploadErrorFromResponseArgs {
+    status: number;
+    statusText: string;
+    body?: string;
+    kind: 'storage' | 'auth' | 'network';
+    /** Required when kind === 'storage'; ignored otherwise. */
+    operation?: UpupStorageError['operation'];
+    /** Provider label for storage/auth errors (e.g. 'S3', 'google-drive'). Defaults to 'server'. */
+    provider?: string;
+}
+/**
+ * Construct a typed, code-carrying error from a failed fetch/XHR response —
+ * the client-side half of the server's `{error, code}` convention (and S3's
+ * own `<Error><Code>` XML). Picks the error class by `kind`; the resulting
+ * `.code` is the server/S3-supplied machine code when present, else falls
+ * back to the HTTP status text.
+ */
+declare function uploadErrorFromResponse(args: UploadErrorFromResponseArgs): UpupError;
+
+type FileUploadResult = {
+    file: UploadFile;
+    url: string;
+    status: 'success' | 'failed' | 'skipped';
+    error?: UpupError;
+};
+
+declare enum StorageProvider {
+    AWS = "aws",
+    Azure = "azure",
+    BackBlaze = "backblaze",
+    DigitalOcean = "digitalocean",
+    CloudflareR2 = "r2",
+    Wasabi = "wasabi",
+    MinIO = "minio",
+    GCS = "gcs",
+    Supabase = "supabase",
+    Hetzner = "hetzner",
+    Linode = "linode",
+    Vultr = "vultr",
+    UpCloud = "upcloud",
+    Scaleway = "scaleway",
+    OVHcloud = "ovhcloud",
+    Alibaba = "alibaba",
+    Oracle = "oracle",
+    Contabo = "contabo",
+    Storj = "storj",
+    IDrive = "idrive",
+    Ceph = "ceph"
+}
+/**
+ * Providers with no S3-compatible API surface (F-657). @useupup/server's storage
+ * path (buildS3ClientConfig) always builds an @aws-sdk/client-s3 client — it
+ * cannot serve a provider in this set no matter what storage.type is set to.
+ * Kept next to the enum so any future non-S3 addition is an explicit,
+ * greppable decision; createUpupHandler's construct-time guard is the sole
+ * consumer.
+ */
+declare const NON_S3_STORAGE_PROVIDERS: ReadonlySet<StorageProvider>;
+
+/**
+ * String-literal accept-set for the public props: everywhere a prop takes a
+ * source id, plain strings ('local', 'googleDrive', …) must typecheck without
+ * importing the FileSource enum. Deliberately kept ALONGSIDE FileSource — not
+ * an accidental alias (F-726 ruling); the accept-set is pinned by
+ * src/__tests__/types/upload-source.test.ts.
+ */
+type UploadSource = `${FileSource}`;
+type UploadProvider = StorageProvider | (string & {});
+
+/**
+ * Shared shape of the UI-package `UploaderProps` across react/vue/svelte/
+ * angular. Each framework extends this with its own `icons` (component type
+ * differs per framework) and `style` (React.CSSProperties vs
+ * Record<string, string>) — the two genuinely framework-specific members.
+ *
+ * Canonical home for the props all four frameworks hand-authored in
+ * parallel; keeping one definition here means a field added to one
+ * framework's copy can no longer silently diverge from the others.
+ */
+type UploaderBaseProps = {
+    /**
+     * Storage provider. Optional for local-only selection and generic
+     * uploadEndpoint/serverUrl flows. When provided, accepts core provider
+     * enum values plus custom provider ids forwarded to user/server code.
+     */
+    provider?: UploadProvider | undefined;
+    /**
+     * Upload mode. `'client'` (default) = browser talks to storage
+     * directly; server only signs URLs. `'server'` = browser talks only
+     * to `serverUrl`, which proxies drive APIs + storage writes. Pick
+     * `'server'` when you can't expose OAuth client secrets to the
+     * browser or when you need server-side compliance/scanning.
+     */
+    mode?: 'client' | 'server' | undefined;
+    /** Source list. e.g. sources={['local','camera','googleDrive']} */
+    sources?: UploadSource[] | undefined;
+    /** Endpoint returning presigned upload URLs. */
+    uploadEndpoint?: string | undefined;
+    /** Server URL for @useupup/server handler. */
+    serverUrl?: string | undefined;
+    /** Maximum number of files that can be added. Default 10. */
+    maxFiles?: number | undefined;
+    /** v2: Theme configuration. mode replaces `dark`, tokens/slots replace flat styling overrides. */
+    theme?: UpupThemeConfig | undefined;
+    /** Folder upload configuration. */
+    folderUpload?: {
+        /** Traverse directories when a user drops a folder onto the uploader. */
+        allowDrop?: boolean;
+        /** Show a "Select folder" action in the local device source. */
+        showSelectFolderButton?: boolean;
+    } | undefined;
+    /** CORS configuration. `dangerouslyAutoConfigure` can mutate storage CORS and should only be used for quick setup. */
+    cors?: {
+        dangerouslyAutoConfigure?: boolean;
+        allowedOrigins: string[];
+        allowedMethods?: string[];
+        allowedHeaders?: string[];
+        maxAgeSeconds?: number;
+    } | undefined;
+    /** Cloud drive configurations. */
+    cloudDrives?: {
+        googleDrive?: {
+            clientId: string;
+            apiKey: string;
+            appId: string;
+        };
+        oneDrive?: {
+            clientId: string;
+            redirectUri?: string;
+        };
+        dropbox?: {
+            clientId: string;
+            redirectUri?: string;
+        };
+        box?: {
+            clientId: string;
+            redirectUri?: string;
+        };
+    } | undefined;
+    /** v2: Enable automatic image compression before upload. */
+    imageCompression?: boolean | undefined;
+    /** v2: Generate thumbnails for images/videos before upload. */
+    thumbnailGenerator?: boolean | undefined;
+    /** v2: Verify file integrity with SHA-256 checksums. */
+    checksumVerification?: boolean | undefined;
+    /** v2: Offload the file pipeline (hash/heic/exif/thumbnail/compress) to a Web Worker. Unset/true = auto; false = main thread. */
+    webWorker?: boolean | undefined;
+    /** v2: Convert HEIC/HEIF images to JPEG before upload. */
+    heicConversion?: boolean | undefined;
+    /** v2: Strip EXIF metadata from images for privacy. */
+    stripExifData?: boolean | undefined;
+    /** v2: Enable content-based deduplication (prevents same file added twice). */
+    contentDeduplication?: boolean | undefined;
+    /** v2: Upload files immediately after selection (no upload button needed). Default false. */
+    autoUpload?: boolean | undefined;
+    /** v2: Maximum concurrent uploads. Default 3. */
+    maxConcurrentUploads?: number | undefined;
+    /** v2: Enable crash recovery — saves upload state to IndexedDB for resume after page refresh */
+    crashRecovery?: boolean | undefined;
+    /** v3: React to browser connectivity — going offline mid-upload pauses the
+     *  run (so multipart sessions persist instead of burning retries against a
+     *  dead network) and coming back online resumes it, only when the pause was
+     *  offline-initiated. Default true; `false` restores fail-and-retry. */
+    networkAware?: boolean | undefined;
+    /** File type filter — MIME patterns, extensions, or preset names (e.g. "images", "documents"). */
+    allowedFileTypes?: string | string[] | undefined;
+    allowPreview?: boolean | undefined;
+    /** v2: Show/hide the upup branding footer. Default true. */
+    showBranding?: boolean | undefined;
+    /** v3: Quiet completion. When true, a successful run shows ONLY a brief
+     *  checkmark over the panel — no Done button, summary, or further CTAs — on
+     *  the assumption the host app takes over via the completion callbacks/events.
+     *  Default false (the normal Done/continue-after-upload flow). */
+    quietCompletion?: boolean | undefined;
+    /** v2: Default animation layer. `false` disables all decorative motion
+     *  (spinner/progress/focus stay). Reduced further automatically under
+     *  `prefers-reduced-motion`. Default true. */
+    animations?: boolean | undefined;
+    /** v2: Disable drag-and-drop (keep browse/click functional). Default false. */
+    disableDragDrop?: boolean | undefined;
+    /** v2: Additional CSS class name applied to the root container */
+    className?: string | undefined;
+    isProcessing?: boolean | undefined;
+    mini?: boolean | undefined;
+    maxFileSize?: MaxFileSizeObject | undefined;
+    /** v2: Minimum file size. Files smaller than this will be rejected. */
+    minFileSize?: MaxFileSizeObject | undefined;
+    /** v2: Maximum total size of all files combined. */
+    maxTotalFileSize?: MaxFileSizeObject | undefined;
+    /** Optional image editor. Pass `true` for defaults or an `ImageEditorOptions` object. */
+    imageEditor?: boolean | ImageEditorOptions | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    maxRetries?: number | undefined;
+    resumable?: ResumableUploadOptions | undefined;
+    /** i18n configuration. Uses ICU locale bundles from `@useupup/core`. */
+    i18n?: {
+        /**
+         * ICU-enabled locale bundle from `@useupup/core/i18n` (e.g. `import { enUS } from '@useupup/core'`).
+         * When provided, enables ICU pluralization, namespaced key overrides, and runtime locale switching.
+         * Takes precedence over `locale`.
+         */
+        bundle?: LocaleBundle;
+        /**
+         * Locale bundle (e.g. `frFR`) or a BCP-47 locale code string
+         * (e.g. 'ar-SA') for lang/dir only.
+         */
+        locale?: LocaleBundle | string;
+        /**
+         * Optional fallback locale bundle/code used when the active bundle is
+         * missing a message key. String codes are for playground/codegen
+         * convenience; pass bundles for translated fallback content.
+         */
+        fallbackLocale?: LocaleBundle | string;
+        /** Per-key overrides merged on top of the locale */
+        overrides?: PartialMessages;
+    } | undefined;
+    onFilesSelected?: ((files: UploadFile[]) => void) | undefined;
+    onDoneClicked?: (() => void) | undefined;
+    onPrepareFiles?: ((files: UploadFile[]) => Promise<UploadFile[]>) | undefined;
+    onFileClick?: ((file: UploadFile) => void) | undefined;
+    onIntegrationClick?: ((integrationType: string) => void) | undefined;
+    onFileUploadStart?: ((file: UploadFile) => void) | undefined;
+    onFileUploadComplete?: ((file: UploadFile, key: string) => void) | undefined;
+    onFilesUploadComplete?: ((files: UploadFile[]) => void) | undefined;
+    onFileUploadProgress?: ((file: UploadFile, progress: {
+        loaded: number;
+        total: number;
+        percentage: number;
+    }) => void) | undefined;
+    onFilesUploadProgress?: ((completedFiles: number, totalFiles: number) => void) | undefined;
+    /** v2: Called once when the batch upload starts */
+    onUploadStart?: (() => void) | undefined;
+    /** v2: Called when all uploads complete or fail */
+    onUploadComplete?: ((files: UploadFile[]) => void) | undefined;
+    /** v2: Called whenever upload status changes (idle → uploading → complete/failed) */
+    onStatusChange?: ((status: string) => void) | undefined;
+    /** v2: Called when a file is removed. */
+    onFileRemoved?: ((file: UploadFile) => void) | undefined;
+    onFilesDragOver?: ((files: File[]) => void) | undefined;
+    onFilesDragLeave?: ((files: File[]) => void) | undefined;
+    onFilesDrop?: ((files: File[]) => void) | undefined;
+    onFileTypeMismatch?: ((file: File, acceptedTypes: string) => void) | undefined;
+    /** v2: Called when a file is rejected for any reason (type, size, limit). */
+    onRestrictionFailed?: ((file: File, reason: 'TYPE_MISMATCH' | 'FILE_TOO_LARGE' | 'FILE_TOO_SMALL' | 'LIMIT_EXCEEDED') => void) | undefined;
+    /** v2: Enable clipboard paste uploads (Ctrl+V / Cmd+V). Default false. */
+    enablePaste?: boolean | undefined;
+    /** v2: Async filter called before each file is added. Return false to reject, a File to replace, or true/undefined to accept. */
+    onBeforeFileAdded?: ((file: File) => boolean | File | undefined | Promise<boolean | File | undefined>) | undefined;
+    onError?: ((errorMessage: string) => void) | undefined;
+    onWarn?: ((warningMessage: string) => void) | undefined;
+    /** v2: After each file upload, open an SSE connection to this endpoint.
+     *  The storage key is appended as ?key=... so the server can identify the file.
+     *  Use this to wait for server-side processing (virus scan, transcoding, etc.). */
+    processingEndpoint?: string | undefined;
+    /** v2: Called when the server sends a processing-complete SSE event for a file. */
+    onFileProcessed?: ((file: UploadFile, data: Record<string, unknown>) => void) | undefined;
+    /** v2: Max milliseconds to wait for the server SSE event before closing. Default 60000. */
+    processingTimeout?: number | undefined;
+};
+
+export { type FileUploadResult as F, NON_S3_STORAGE_PROVIDERS as N, type RestrictionFailedReason as R, StorageProvider as S, type UploadSource as U, type UploadProvider as a, type UploaderBaseProps as b, UpupErrorCode as c, UpupError as d, UpupAuthError as e, UpupNetworkError as f, UpupValidationError as g, UpupQuotaError as h, UpupStorageError as i, UpupConfigError as j, type UploadErrorFromResponseArgs as k, parseErrorBody as p, uploadErrorFromResponse as u };