img-upload-kit 0.0.0-stage → 2.0.0

package/dist/index-DHINe-rA.d.cts

@@ -0,0 +1,635 @@
+import * as react from 'react';
+import { ReactNode, HTMLAttributes, CSSProperties, DragEvent, InputHTMLAttributes, Ref, ReactElement } from 'react';
+import { U as UploadLocale, Q as QualityLevel, m as UploadedImageData, l as UploadPresetName, E as ExplicitOutputFormat, b as ImageDimensions } from './upload-C5Trd6Dh.cjs';
+import { f as BlurPlaceholderType } from './types-yShGNQnW.cjs';
+
+interface BlurModalTranslations {
+    title: string;
+    closeModal: string;
+    adjustColor: string;
+    clickToSample: string;
+    pickColorNote: string;
+    enterHexColor: string;
+    hexPlaceholder: string;
+    enablePenMode: string;
+    disablePenMode: string;
+    penModeActive: string;
+    resetToDetected: string;
+    sampled: string;
+    livePreview: string;
+    showingOriginal: string;
+    saved: string;
+    accessibility: string;
+    altText: string;
+    altTextPlaceholder: string;
+    saveAndClose: string;
+}
+interface UploadTranslations {
+    uploadWindow: string;
+    tapToResume: string;
+    restoreUploadWindow: string;
+    minimize: string;
+    minimizeUploader: string;
+    close: string;
+    editPrefix: string;
+    uploadImage: string;
+    uploadImages: string;
+    noValidImageFiles: string;
+    selectedImagesSkipped: string;
+    queued: string;
+    retrying: string;
+    preparingUpload: string;
+    uploadFailed: string;
+    failedCreatePreview: string;
+    failedCreatePreviewFor: string;
+    selectAll: string;
+    deselectAll: string;
+    removeSelected: string;
+    uploading: string;
+    uploadingCount: string;
+    someUploadsFailed: string;
+    retryFailedUploads: string;
+    needsAltBeforeSave: string;
+    networkError: string;
+    invalidUploadResponse: string;
+    uploadAborted: string;
+    uploadStartedLive: string;
+    uploadProgressLive: string;
+    uploadCompleteLive: string;
+    qualityTitle: string;
+    qualityLevelAria: string;
+    qualitySaved: string;
+    qualityRecommended: string;
+    selectFilesAria: string;
+    selectMoreFilesAria: string;
+    selectFolderAria: string;
+    dropImagesHere: string;
+    releaseToUpload: string;
+    dragDropOrChoose: string;
+    selectFiles: string;
+    selectFolder: string;
+    supportsFormats: string;
+    maxPerFile: string;
+    upToSizeMB: string;
+    dropHere: string;
+    addMore: string;
+    files: string;
+    folder: string;
+    withoutAltText: string;
+    saveImages: string;
+    addAltBeforeSaving: string;
+    missingDescription: string;
+    saveImage: string;
+    downloadImage: string;
+    dragDropOrClickToUpload: string;
+    browseFiles: string;
+    image: string;
+    processing: string;
+    uploadImageAria: string;
+    fileInputAria: string;
+    uploadingAlt: string;
+    previewAlt: string;
+    addImageDescription: string;
+    describeImagePlaceholder: string;
+    characters: string;
+    usedForA11ySeo: string;
+    cancel: string;
+    saveDescription: string;
+    selectImageAria: string;
+    editAltTextAria: string;
+    addAltTextAria: string;
+    addDescriptionForA11y: string;
+    adjustBlurColorAria: string;
+    adjustBlurColorTitle: string;
+    removeImageAria: string;
+    pasteHint: string;
+    cancelUpload: string;
+    retryUpload: string;
+    minImagesError: string;
+    requiredFieldError: string;
+    blurModal: BlurModalTranslations;
+}
+
+type UploadVisualState = 'idle' | 'dragging' | 'uploading' | 'ready' | 'error' | 'disabled';
+type SingleUploadSlot = 'root' | 'label' | 'qualitySelector' | 'dropzone' | 'dropzoneDragging' | 'dropzoneHasImage' | 'dropzoneDisabled' | 'dropzoneError' | 'dropzonePrompt' | 'dropzoneIcon' | 'dropzoneText' | 'dropzoneHint' | 'dropzoneProgress' | 'browseButton' | 'previewWrap' | 'tile' | 'downloadButton' | 'alert' | 'helperText' | 'errorText' | 'commitBar' | 'saveButton';
+type MultiUploadSlot = 'root' | 'header' | 'label' | 'count' | 'bulkActions' | 'bulkButton' | 'bulkDangerButton' | 'qualitySelector' | 'emptyDropzone' | 'emptyDropzoneDragging' | 'emptyDropzoneDisabled' | 'emptyDropzoneError' | 'emptyTitle' | 'emptyHint' | 'emptyActions' | 'primaryButton' | 'secondaryButton' | 'emptySubtext' | 'grid' | 'tile' | 'addMoreTile' | 'addMoreTileDragging' | 'addMoreContent' | 'addMoreActions' | 'alert' | 'helperText' | 'errorText' | 'commitBar' | 'saveButton';
+type SingleUploadClassNames = Partial<Record<SingleUploadSlot, string>>;
+type SingleUploadStyles = Partial<Record<SingleUploadSlot, CSSProperties>>;
+type MultiUploadClassNames = Partial<Record<MultiUploadSlot, string>>;
+type MultiUploadStyles = Partial<Record<MultiUploadSlot, CSSProperties>>;
+interface SingleDropzoneRenderContext {
+    state: UploadVisualState;
+    isDragging: boolean;
+    isUploading: boolean;
+    progress: number;
+    uploadMessage: string;
+    maxSizeMB: number;
+    disabled: boolean;
+    error?: string;
+    qualityLevel: QualityLevel;
+    setQualityLevel: (level: QualityLevel) => void;
+    openFileDialog: () => void;
+    dropzoneProps: HTMLAttributes<HTMLElement>;
+    locale: UploadLocale;
+    ui: UploadTranslations;
+}
+interface SinglePreviewRenderContext {
+    previewUrl: string;
+    uploadedData: UploadedImageData | null;
+    altText: string;
+    blurColor: string;
+    blurDataUrl: string;
+    isUploading: boolean;
+    progress: number;
+    uploadMessage: string;
+    sizeInfo: {
+        original: number;
+        optimized: number;
+    } | null;
+    disabled: boolean;
+    openFileDialog: () => void;
+    remove: () => void;
+    cancel: () => void;
+    openAltTextModal: () => void;
+    openBlurInspector: () => void;
+    download: () => Promise<void>;
+    locale: UploadLocale;
+    ui: UploadTranslations;
+}
+interface MultiHeaderRenderContext {
+    label?: string;
+    required: boolean;
+    disabled: boolean;
+    totalCount: number;
+    selectedCount: number;
+    uploadingCount: number;
+    isUploading: boolean;
+    hasFailedUploads: boolean;
+    selectAll: () => void;
+    clearSelection: () => void;
+    removeSelected: () => void;
+    retryFailed: () => void;
+    locale: UploadLocale;
+    ui: UploadTranslations;
+}
+interface MultiEmptyRenderContext {
+    state: UploadVisualState;
+    isDragging: boolean;
+    disabled: boolean;
+    allowFolder: boolean;
+    maxSizeMB: number;
+    maxImages: number;
+    error?: string;
+    openFileDialog: () => void;
+    openFolderDialog: () => void;
+    dropzoneProps: HTMLAttributes<HTMLElement>;
+    locale: UploadLocale;
+    ui: UploadTranslations;
+}
+interface MultiTileRenderContext {
+    item: ImagePreview;
+    index: number;
+    isSelected: boolean;
+    disabled: boolean;
+    toggleSelect: () => void;
+    remove: () => void;
+    cancel: () => void;
+    retry: () => void;
+    openAltTextModal: () => void;
+    setAltText: (altText: string) => void;
+    setBlurColor: (hex: string) => void;
+    locale: UploadLocale;
+    ui: UploadTranslations;
+}
+interface MultiAddMoreRenderContext {
+    isDragging: boolean;
+    disabled: boolean;
+    allowFolder: boolean;
+    remainingCount: number;
+    openFileDialog: () => void;
+    openFolderDialog: () => void;
+    dropzoneProps: HTMLAttributes<HTMLElement>;
+    locale: UploadLocale;
+    ui: UploadTranslations;
+}
+interface SingleCustomRenderers {
+    /** Replace the empty/uploading dropzone UI with custom JSX while preserving upload & drag behavior */
+    renderDropzone?: (ctx: SingleDropzoneRenderContext) => ReactNode;
+    /** Replace the uploaded image preview tile with custom JSX while preserving alt/blur modal actions */
+    renderPreview?: (ctx: SinglePreviewRenderContext) => ReactNode;
+}
+interface MultiCustomRenderers {
+    /** Replace the multi-upload header & bulk action toolbar with custom JSX */
+    renderHeader?: (ctx: MultiHeaderRenderContext) => ReactNode;
+    /** Replace the initial empty multi-upload dropzone with custom JSX */
+    renderEmptyDropzone?: (ctx: MultiEmptyRenderContext) => ReactNode;
+    /** Replace individual image preview cards inside the multi-upload grid */
+    renderTile?: (ctx: MultiTileRenderContext) => ReactNode;
+    /** Replace the trailing "Add More" tile inside the multi-upload grid (return `null` to hide) */
+    renderAddMore?: (ctx: MultiAddMoreRenderContext) => ReactNode;
+}
+
+interface RenderImageProps {
+    src: string;
+    alt: string;
+    className?: string;
+    style?: CSSProperties;
+    onLoad?: (img: HTMLImageElement | null) => void;
+}
+type CustomImageRenderer = (props: RenderImageProps) => ReactNode;
+interface ClientUploadRequestParams {
+    preset?: string;
+    folder?: string;
+    bucket?: string;
+    altText?: string;
+    customFilename?: string;
+    outputFormat?: ExplicitOutputFormat;
+    quality?: number;
+    maxDimensions?: ImageDimensions;
+    metadata?: Record<string, string>;
+    signal?: AbortSignal;
+    onUploadProgress?: (percent: number) => void;
+}
+type CustomUploaderFn = (file: File, params: ClientUploadRequestParams) => Promise<UploadedImageData>;
+interface ImageUploadHandle {
+    /** Move keyboard focus to the upload dropzone or primary trigger */
+    focus: () => void;
+    /** Programmatically open the native file picker dialog */
+    open: () => void;
+    /** Clear the currently selected / uploaded image(s) */
+    clear: () => void;
+}
+interface BaseImageUploadProps<TPreset extends string = UploadPresetName> {
+    /** Optional named preset (e.g. 'avatar', 'hero', or a custom project preset) */
+    preset?: TPreset;
+    /** Optional storage folder path (e.g. 'products/42' or 'users/avatars') */
+    folder?: string;
+    /** Optional target storage bucket */
+    bucket?: string;
+    /** Arbitrary project-specific metadata sent with the upload (e.g. { entityId: '42', scope: 'catalog' }) */
+    metadata?: Record<string, string>;
+    /** Server upload endpoint URL (defaults to '/api/upload' when `uploader` is not provided) */
+    endpoint?: string;
+    /** Custom async upload function (bypasses HTTP `endpoint` when provided) */
+    uploader?: CustomUploaderFn;
+    /** Additional HTTP headers sent with FormData requests to `endpoint` */
+    headers?: Record<string, string>;
+    /** Send cookies/credentials with FormData requests (`'same-origin' | 'include' | 'omit'`) */
+    withCredentials?: boolean;
+    /** UI language ('en' | 'ar'). Auto-detects RTL layout for 'ar'. */
+    locale?: UploadLocale;
+    /** Optional partial translation overrides */
+    translations?: Partial<UploadTranslations>;
+    /** Custom image renderer (e.g. wrap Next.js `<Image />` or custom CDN loader) */
+    renderImage?: CustomImageRenderer;
+    /** Field label */
+    label?: string;
+    /** Maximum file size in MB (defaults to preset maxSizeMB or 10) */
+    maxSizeMB?: number;
+    /** Maximum bounding box dimensions sent to the server */
+    maxDimensions?: ImageDimensions;
+    /** Accepted MIME types string for `<input type="file" accept="..." />` */
+    accept?: string;
+    /** Disable interactions */
+    disabled?: boolean;
+    /** External validation error message */
+    error?: string;
+    /** Helper text displayed below the uploader */
+    helperText?: string;
+    /** Show required asterisk next to label */
+    required?: boolean;
+    /** Require non-empty alt text before saving in modal mode (defaults to `true`) */
+    requireAltText?: boolean;
+    /** Custom wrapper className */
+    className?: string;
+    /** Custom wrapper inline style */
+    style?: CSSProperties;
+    /**
+     * Strip built-in `iuk-*` visual classes so you can style every slot cleanly
+     * with Tailwind CSS, CSS Modules, or custom stylesheets without specificity overrides.
+     */
+    unstyled?: boolean;
+    /** Fallback blur placeholder style variant */
+    blurType?: BlurPlaceholderType;
+    /** Show numeric upload percentage inside single dropzone */
+    showProgress?: boolean;
+    /** Show compression `<QualitySelector />` (defaults to `true`) */
+    showQualitySelector?: boolean;
+    /** Recommended quality level highlighted in `<QualitySelector />` */
+    recommendedQuality?: QualityLevel;
+    /** Optional guidance note shown inside `<QualitySelector />` */
+    qualityNote?: {
+        en: string;
+        ar?: string;
+    };
+    /** Modal title mode ('create' | 'edit') */
+    modeVariant?: 'create' | 'edit';
+    /** When defined (`true`/`false`), renders inside a minimizable modal dialog */
+    isOpen?: boolean;
+    /** Close callback for modal mode */
+    onClose?: () => void;
+    /** Modal header title */
+    title?: string;
+    /** Explicit output format ('avif' | 'webp' | 'jpeg' | 'png') */
+    outputFormat?: ExplicitOutputFormat;
+    /** Initial compression quality (1–100) */
+    quality?: number;
+    /** Custom filename target in storage */
+    customFilename?: string;
+    /** Camera capture attribute forwarded to `<input type="file" capture={...} />` on mobile devices */
+    capture?: 'user' | 'environment';
+    /** Enable pasting images from the clipboard (defaults to `true`) */
+    enablePaste?: boolean;
+    /** Scope for clipboard paste events: focused `'dropzone'` (default) or global `'document'` */
+    pasteTarget?: 'dropzone' | 'document';
+    /** Form field name; when set, renders a synchronized `<input type="hidden" name={name} />` */
+    name?: string;
+    /** Serialization format for the hidden form input (`'url'` default for single, `'json'` default for multi) */
+    formValue?: 'url' | 'json';
+    /** Blur callback invoked when focus leaves the uploader (e.g. for react-hook-form `field.onBlur`) */
+    onBlur?: () => void;
+}
+interface SingleImageUploadProps<TPreset extends string = UploadPresetName> extends BaseImageUploadProps<TPreset>, SingleCustomRenderers {
+    mode?: 'single';
+    value?: string | UploadedImageData | null;
+    onChange: (data: UploadedImageData | null) => void;
+    initialAltText?: string;
+    /** Per-slot custom CSS classes (Tailwind, CSS Modules, BEM) for SingleImageUpload */
+    classNames?: SingleUploadClassNames;
+    /** Per-slot inline CSS styles for SingleImageUpload */
+    styles?: SingleUploadStyles;
+}
+interface MultiImageUploadProps<TPreset extends string = UploadPresetName> extends BaseImageUploadProps<TPreset>, MultiCustomRenderers {
+    mode: 'multiple';
+    value?: UploadedImageData[];
+    onChange: (images: UploadedImageData[]) => void;
+    maxImages?: number;
+    /** Minimum required uploaded images before form submission / modal save */
+    minImages?: number;
+    allowFolder?: boolean;
+    maxParallelUploads?: number;
+    /** Invoked when a batch or retry upload begins */
+    onUploadStart?: (files: File[]) => void;
+    /** Invoked when a batch or retry upload finishes with the newly uploaded items */
+    onUploadComplete?: (results: UploadedImageData[]) => void;
+    /** Invoked when an in-flight tile upload is cancelled */
+    onUploadCancel?: (id: string) => void;
+    /** Per-slot custom CSS classes (Tailwind, CSS Modules, BEM) for MultiImageUpload */
+    classNames?: MultiUploadClassNames;
+    /** Per-slot inline CSS styles for MultiImageUpload */
+    styles?: MultiUploadStyles;
+}
+type ImageUploadProps<TPreset extends string = UploadPresetName> = SingleImageUploadProps<TPreset> | MultiImageUploadProps<TPreset>;
+interface ImagePreview {
+    id: string;
+    url: string;
+    file?: File | null;
+    data?: UploadedImageData;
+    altText?: string;
+    blurColor?: string;
+    isUploading?: boolean;
+    progress?: number;
+    error?: string;
+    uploadMessage?: string | null;
+    originalSize?: number;
+    optimizedSize?: number | null;
+    fileName?: string;
+}
+interface UploadStatus {
+    message: string;
+    progress: number;
+}
+interface SizeInfo {
+    original: number;
+    optimized: number;
+    reduction: number;
+}
+
+interface ImageUploadContextValue {
+    endpoint: string;
+    uploader?: CustomUploaderFn;
+    headers?: Record<string, string>;
+    withCredentials?: boolean;
+    locale?: UploadLocale;
+    translations?: Partial<UploadTranslations>;
+    renderImage?: CustomImageRenderer;
+    storageKeyPrefix: string;
+    requireAltText: boolean;
+    unstyled: boolean;
+    singleClassNames?: SingleUploadClassNames;
+    singleStyles?: SingleUploadStyles;
+    multiClassNames?: MultiUploadClassNames;
+    multiStyles?: MultiUploadStyles;
+}
+interface ImageUploadProviderProps {
+    children: ReactNode;
+    /** Default server endpoint for uploads (defaults to `'/api/upload'`) */
+    endpoint?: string;
+    /** Custom async uploader function used across all upload components */
+    uploader?: CustomUploaderFn;
+    /** Custom HTTP headers attached to FormData upload requests */
+    headers?: Record<string, string>;
+    /** Send credentials/cookies with XHR/fetch requests */
+    withCredentials?: boolean;
+    /** Default UI locale (`'en' | 'ar'`) */
+    locale?: UploadLocale;
+    /** Global translation overrides */
+    translations?: Partial<UploadTranslations>;
+    /** Custom image component renderer (e.g. for custom CDN or framework `<Image />`) */
+    renderImage?: CustomImageRenderer;
+    /** Prefix used for sessionStorage metadata cache keys (defaults to `'iuk'`) */
+    storageKeyPrefix?: string;
+    /** Require alt text before saving in modal mode (defaults to `true`) */
+    requireAltText?: boolean;
+    /** Globally strip default `iuk-*` classes across all Single/Multi upload components */
+    unstyled?: boolean;
+    /** Global default slot `classNames` applied to all `<SingleImageUpload />` instances */
+    singleClassNames?: SingleUploadClassNames;
+    /** Global default slot `styles` applied to all `<SingleImageUpload />` instances */
+    singleStyles?: SingleUploadStyles;
+    /** Global default slot `classNames` applied to all `<MultiImageUpload />` instances */
+    multiClassNames?: MultiUploadClassNames;
+    /** Global default slot `styles` applied to all `<MultiImageUpload />` instances */
+    multiStyles?: MultiUploadStyles;
+}
+declare function ImageUploadProvider({ children, endpoint, uploader, headers, withCredentials, locale, translations, renderImage, storageKeyPrefix, requireAltText, unstyled, singleClassNames, singleStyles, multiClassNames, multiStyles, }: ImageUploadProviderProps): react.JSX.Element;
+declare function useImageUploadContext(): ImageUploadContextValue;
+
+interface UseDragAndDropOptions {
+    disabled?: boolean;
+    onDrop: (files: FileList) => void;
+}
+declare function useDragAndDrop({ disabled, onDrop }: UseDragAndDropOptions): {
+    isDragging: boolean;
+    dragHandlers: {
+        onDragEnter: (e: DragEvent) => void;
+        onDragLeave: (e: DragEvent) => void;
+        onDragOver: (e: DragEvent) => void;
+        onDrop: (e: DragEvent) => void;
+    };
+};
+
+interface UseFilePreviewOptions {
+    errorLabel?: string;
+}
+declare function useFilePreview(options?: UseFilePreviewOptions): {
+    createPreview: (file: File) => Promise<string>;
+    revokePreview: (url?: string | null) => void;
+    revokeAllPreviews: () => void;
+};
+
+interface UploadCallOptions {
+    uploadId?: string;
+    signal?: AbortSignal;
+}
+interface UseImageUploadOptions {
+    preset?: string;
+    folder?: string;
+    bucket?: string;
+    metadata?: Record<string, string>;
+    altText?: string;
+    outputFormat?: ExplicitOutputFormat;
+    /** 1–100. When omitted, the server picks the preset or format default. */
+    quality?: number;
+    maxDimensions?: ImageDimensions;
+    customFilename?: string;
+    endpoint?: string;
+    uploader?: CustomUploaderFn;
+    headers?: Record<string, string>;
+    withCredentials?: boolean;
+    locale?: UploadLocale;
+    onSuccess?: (data: UploadedImageData, file?: File, uploadId?: string) => void;
+    onError?: (error: string, file?: File, uploadId?: string) => void;
+    onProgress?: (progress: number, message: string, file?: File, uploadId?: string) => void;
+}
+declare function useImageUpload({ preset, folder, bucket, metadata, altText, outputFormat, quality, maxDimensions, customFilename: defaultCustomFilename, endpoint: propEndpoint, uploader: propUploader, headers: propHeaders, withCredentials: propWithCredentials, locale: propLocale, onSuccess, onError, onProgress, }?: UseImageUploadOptions): {
+    uploadImage: (file: File, customAltText?: string, overrideCustomFilename?: string, callOptions?: UploadCallOptions) => Promise<UploadedImageData | null>;
+    abortUpload: (idOrFile: string | File) => boolean;
+    abortAll: () => void;
+    isUploading: boolean;
+    progress: number;
+    uploadMessage: string;
+    reset: () => void;
+};
+
+interface MultiUploadStats {
+    total: number;
+    completed: number;
+    failed: number;
+}
+
+interface HeadlessDropzoneProps extends HTMLAttributes<HTMLElement> {
+    [key: `data-${string}`]: unknown;
+}
+interface HeadlessFileInputProps extends InputHTMLAttributes<HTMLInputElement> {
+    ref: Ref<HTMLInputElement>;
+    webkitdirectory?: string;
+    directory?: string;
+}
+type UseSingleUploadOptions<TPreset extends string = UploadPresetName> = SingleImageUploadProps<TPreset>;
+interface SingleUploadController {
+    state: UploadVisualState;
+    preview: string | null;
+    uploadedData: UploadedImageData | null;
+    altText: string;
+    blurColor: string;
+    detectedBlurColor: string;
+    blurDataUrl: string;
+    isDragging: boolean;
+    isUploading: boolean;
+    progress: number;
+    uploadMessage: string;
+    error: string;
+    sizeInfo: {
+        original: number;
+        optimized: number;
+    } | null;
+    qualityLevel: QualityLevel;
+    maxSizeMB: number;
+    disabled: boolean;
+    canDownload: boolean;
+    locale: UploadLocale;
+    ui: UploadTranslations;
+    openFileDialog: () => void;
+    selectFiles: (files: FileList) => Promise<void>;
+    remove: () => void;
+    cancel: () => void;
+    cancelUpload: () => void;
+    save: () => void;
+    download: () => Promise<void>;
+    setQualityLevel: (level: QualityLevel) => void;
+    setAltText: (altText: string) => void;
+    setBlurColor: (hex: string) => void;
+    resetBlurColor: () => void;
+    getDropzoneProps: (overrides?: HTMLAttributes<HTMLElement>) => HeadlessDropzoneProps;
+    getInputProps: (overrides?: InputHTMLAttributes<HTMLInputElement>) => HeadlessFileInputProps;
+}
+type UseMultiUploadOptions<TPreset extends string = UploadPresetName> = Omit<MultiImageUploadProps<TPreset>, 'mode'> & {
+    mode?: 'multiple';
+};
+interface MultiUploadController {
+    state: UploadVisualState;
+    items: ImagePreview[];
+    completedItems: ImagePreview[];
+    uploadingItems: ImagePreview[];
+    selectedIds: Set<string>;
+    stats: MultiUploadStats;
+    isDragging: boolean;
+    isUploading: boolean;
+    hasFailedUploads: boolean;
+    error: string;
+    infoMessage: string;
+    qualityLevel: QualityLevel;
+    maxSizeMB: number;
+    maxImages: number;
+    remainingCount: number;
+    disabled: boolean;
+    locale: UploadLocale;
+    ui: UploadTranslations;
+    openFileDialog: () => void;
+    openFolderDialog: () => void;
+    selectFiles: (files: FileList) => Promise<void>;
+    remove: (id: string) => void;
+    removeSelected: () => void;
+    clear: () => void;
+    cancel: (id: string) => void;
+    cancelUpload: (id: string) => void;
+    retry: (id: string) => Promise<void>;
+    retryUpload: (id: string) => Promise<void>;
+    retryAll: () => Promise<void>;
+    toggleSelect: (id: string) => void;
+    selectAll: () => void;
+    clearSelection: () => void;
+    retryFailed: () => Promise<void>;
+    save: () => void;
+    setQualityLevel: (level: QualityLevel) => void;
+    setAltText: (id: string, altText: string) => void;
+    setBlurColor: (id: string, hex: string) => void;
+    getDropzoneProps: (overrides?: HTMLAttributes<HTMLElement>) => HeadlessDropzoneProps;
+    getInputProps: (overrides?: InputHTMLAttributes<HTMLInputElement>) => HeadlessFileInputProps;
+    getFolderInputProps: (overrides?: InputHTMLAttributes<HTMLInputElement>) => HeadlessFileInputProps;
+}
+type HeadlessSingleUploadProps<TPreset extends string = UploadPresetName> = UseSingleUploadOptions<TPreset> & {
+    children: (controller: SingleUploadController) => ReactNode;
+};
+type HeadlessMultiUploadProps<TPreset extends string = UploadPresetName> = UseMultiUploadOptions<TPreset> & {
+    children: (controller: MultiUploadController) => ReactNode;
+};
+
+declare function useSingleUpload<TPreset extends string = UploadPresetName>(options: UseSingleUploadOptions<TPreset>): SingleUploadController;
+
+declare function useMultiUpload<TPreset extends string = UploadPresetName>(options: UseMultiUploadOptions<TPreset>): MultiUploadController;
+
+/**
+ * Headless render-prop primitive for single-image upload workflows.
+ * Renders zero DOM elements of its own and delegates 100% of markup and styling to `children(controller)`.
+ */
+declare function HeadlessSingleUpload<TPreset extends string = UploadPresetName>(props: HeadlessSingleUploadProps<TPreset>): ReactElement;
+
+/**
+ * Headless render-prop primitive for multi-image and folder upload workflows.
+ * Renders zero DOM elements of its own and delegates 100% of markup and styling to `children(controller)`.
+ */
+declare function HeadlessMultiUpload<TPreset extends string = UploadPresetName>(props: HeadlessMultiUploadProps<TPreset>): ReactElement;
+
+export { type SinglePreviewRenderContext as A, type BaseImageUploadProps as B, type CustomImageRenderer as C, type SingleUploadClassNames as D, type SingleUploadController as E, type SingleUploadSlot as F, type SingleUploadStyles as G, type HeadlessDropzoneProps as H, type ImageUploadProps as I, type SizeInfo as J, type UploadCallOptions as K, type UploadStatus as L, type MultiImageUploadProps as M, type UseDragAndDropOptions as N, type UseFilePreviewOptions as O, type UseImageUploadOptions as P, type UseMultiUploadOptions as Q, type RenderImageProps as R, type SingleImageUploadProps as S, type UseSingleUploadOptions as T, type UploadTranslations as U, useDragAndDrop as V, useFilePreview as W, useImageUpload as X, useImageUploadContext as Y, useMultiUpload as Z, useSingleUpload as _, type UploadVisualState as a, type ImageUploadHandle as b, type ImagePreview as c, type BlurModalTranslations as d, type ClientUploadRequestParams as e, type CustomUploaderFn as f, type HeadlessFileInputProps as g, HeadlessMultiUpload as h, type HeadlessMultiUploadProps as i, HeadlessSingleUpload as j, type HeadlessSingleUploadProps as k, type ImageUploadContextValue as l, ImageUploadProvider as m, type ImageUploadProviderProps as n, type MultiAddMoreRenderContext as o, type MultiCustomRenderers as p, type MultiEmptyRenderContext as q, type MultiHeaderRenderContext as r, type MultiTileRenderContext as s, type MultiUploadClassNames as t, type MultiUploadController as u, type MultiUploadSlot as v, type MultiUploadStats as w, type MultiUploadStyles as x, type SingleCustomRenderers as y, type SingleDropzoneRenderContext as z };