img-upload-kit 1.1.1 → 2.0.1

package/dist/react.d.ts

@@ -1,13 +1,24 @@
-import { U as UploadTranslations, a as UploadLocale, b as UploadVisualState, B as BlurPlaceholderType, c as BlurSize, E as ExplicitOutputFormat, I as ImageDimensions, d as UploadedImageData, C as CustomImageRenderer, e as UploadPresetName, f as ImageUploadProps, M as MultiImageUploadProps, g as ImagePreview, Q as QualityLevel, S as SingleImageUploadProps } from './index-FVXXKf2v.js';
-export { h as BaseImageUploadProps, i as BlurModalTranslations, j as BlurServiceDebugger, k as ClientUploadRequestParams, l as CustomUploaderFn, H as HeadlessDropzoneProps, m as HeadlessFileInputProps, n as HeadlessMultiUpload, o as HeadlessMultiUploadProps, p as HeadlessSingleUpload, q as HeadlessSingleUploadProps, r as ImageUploadContextValue, s as ImageUploadProvider, t as ImageUploadProviderProps, u as MultiAddMoreRenderContext, v as MultiCustomRenderers, w as MultiEmptyRenderContext, x as MultiHeaderRenderContext, y as MultiTileRenderContext, z as MultiUploadClassNames, A as MultiUploadController, D as MultiUploadSlot, F as MultiUploadStats, G as MultiUploadStyles, R as RenderImageProps, J as SingleCustomRenderers, K as SingleDropzoneRenderContext, L as SinglePreviewRenderContext, N as SingleUploadClassNames, O as SingleUploadController, P as SingleUploadSlot, T as SingleUploadStyles, V as SizeInfo, W as UploadStatus, X as UseDragAndDropOptions, X as UseDropzoneOptions, Y as UseImageUploadOptions, Z as UseMultiUploadOptions, _ as UseSingleUploadOptions, $ as blurService, a0 as useDragAndDrop, a0 as useDropzone, a1 as useFilePreview, a2 as useImageUpload, a3 as useImageUploadContext, a4 as useMultiUpload, a5 as useSingleUpload } from './index-FVXXKf2v.js';
+import { U as UploadTranslations, a as UploadVisualState, C as CustomImageRenderer, I as ImageUploadProps, b as ImageUploadHandle, M as MultiImageUploadProps, c as ImagePreview, S as SingleImageUploadProps } from './index-CPMlaQsC.js';
+export { B as BaseImageUploadProps, d as BlurModalTranslations, e as ClientUploadRequestParams, f as CustomUploaderFn, H as HeadlessDropzoneProps, g as HeadlessFileInputProps, h as HeadlessMultiUpload, i as HeadlessMultiUploadProps, j as HeadlessSingleUpload, k as HeadlessSingleUploadProps, l as ImageUploadContextValue, m as ImageUploadProvider, n as ImageUploadProviderProps, o as MultiAddMoreRenderContext, p as MultiCustomRenderers, q as MultiEmptyRenderContext, r as MultiHeaderRenderContext, s as MultiTileRenderContext, t as MultiUploadClassNames, u as MultiUploadController, v as MultiUploadSlot, w as MultiUploadStats, x as MultiUploadStyles, R as RenderImageProps, y as SingleCustomRenderers, z as SingleDropzoneRenderContext, A as SinglePreviewRenderContext, D as SingleUploadClassNames, E as SingleUploadController, F as SingleUploadSlot, G as SingleUploadStyles, J as SizeInfo, K as UploadCallOptions, L as UploadStatus, N as UseDragAndDropOptions, N as UseDropzoneOptions, O as UseFilePreviewOptions, P as UseImageUploadOptions, Q as UseMultiUploadOptions, T as UseSingleUploadOptions, V as useDragAndDrop, V as useDropzone, W as useFilePreview, X as useImageUpload, Y as useImageUploadContext, Z as useMultiUpload, _ as useSingleUpload } from './index-CPMlaQsC.js';
 import * as react from 'react';
-import { CSSProperties, ImgHTMLAttributes, ElementType, HTMLAttributes, SyntheticEvent, ButtonHTMLAttributes, ReactNode } from 'react';
+import { CSSProperties, ClipboardEvent, RefObject, ImgHTMLAttributes, ReactNode, ElementType, HTMLAttributes, SyntheticEvent, Ref, ReactElement, ButtonHTMLAttributes } from 'react';
+import { U as UploadLocale, E as ExplicitOutputFormat, b as ImageDimensions, m as UploadedImageData, e as ImageVariant, l as UploadPresetName, i as StandardPresetName, Q as QualityLevel } from './upload-C5Trd6Dh.js';
+import { f as BlurPlaceholderType, i as BlurSize } from './types-yShGNQnW.js';
+export { D as DEFAULT_PLACEHOLDERS } from './placeholders-C4ftwaII.js';
+export { b as blurService } from './blurService-D5TpMNji.js';
 
 declare const arTranslations: UploadTranslations;
 
 declare const enTranslations: UploadTranslations;
 
+declare const DEFAULT_UPLOAD_TRANSLATIONS: UploadTranslations;
+declare const ARABIC_UPLOAD_TRANSLATIONS: UploadTranslations;
+
 declare function normalizeUploadLocale(locale?: string): UploadLocale;
+declare function selectPluralCategory(locale: UploadLocale, count: number): Intl.LDMLPluralRule;
+declare function formatUploadingCount(ui: UploadTranslations, count: number, locale: UploadLocale, overrides?: Partial<UploadTranslations>): string;
+declare function formatNeedsAltMessage(ui: UploadTranslations, count: number, locale: UploadLocale): string;
+declare function formatSkippedImagesMessage(ui: UploadTranslations, imageCount: number, skippedCount: number, locale: UploadLocale): string;
 declare const uploadText: Record<UploadLocale, UploadTranslations>;
 declare function resolveTranslations(locale?: UploadLocale, overrides?: Partial<UploadTranslations>): UploadTranslations;
 
@@ -42,8 +53,6 @@ declare function resolveUploadDataState(flags: {
     hasContent?: boolean;
 }): UploadVisualState;
 
-declare const DEFAULT_PLACEHOLDERS: Record<BlurPlaceholderType, string>;
-
 declare function useBlurDataURL(imageSrc: string | undefined, options?: {
     type?: BlurPlaceholderType;
     size?: BlurSize;
@@ -80,10 +89,45 @@ declare function useBlurDataWithColor(imageSrc: string | undefined, size?: BlurS
 };
 declare function useBlurVariant(imageSrc: string | undefined, size?: BlurSize, type?: BlurPlaceholderType): string;
 
+type PasteTargetMode = 'dropzone' | 'document';
+interface UseClipboardPasteOptions {
+    /** Enable clipboard image paste handling (defaults to `true`) */
+    enabled?: boolean;
+    /** Listen on the focused dropzone (`'dropzone'`) or globally on `document` (`'document'`). Defaults to `'dropzone'`. */
+    pasteTarget?: PasteTargetMode;
+    /** Disable paste handling when the uploader is disabled */
+    disabled?: boolean;
+    /** Allow pasting multiple images at once (defaults to `false` for single upload, `true` for multi upload) */
+    multiple?: boolean;
+    /** Callback invoked when one or more image files are pasted */
+    onPasteFiles: (files: FileList) => void;
+}
+declare function extractClipboardImageFiles(clipboardData: DataTransfer | null | undefined, multiple: boolean): File[];
+declare function toFileListLike(files: File[]): FileList;
+declare function useClipboardPaste({ enabled, pasteTarget, disabled, multiple, onPasteFiles, }: UseClipboardPasteOptions): {
+    onPaste: (event: ClipboardEvent<HTMLElement>) => void;
+};
+
+interface UseDialogOptions {
+    isOpen: boolean;
+    onClose?: () => void;
+    initialFocusRef?: RefObject<HTMLElement | null>;
+    lockScroll?: boolean;
+}
+declare function useDialog({ isOpen, onClose, initialFocusRef, lockScroll, }: UseDialogOptions): {
+    dialogRef: RefObject<HTMLDivElement | null>;
+    titleId: string;
+    descriptionId: string;
+};
+
 interface XhrUploadOptions {
     headers?: Record<string, string>;
     withCredentials?: boolean;
+    signal?: AbortSignal;
     fallbackErrorLabel?: string;
+    networkErrorLabel?: string;
+    invalidResponseLabel?: string;
+    abortedErrorLabel?: string;
     onUploadProgress?: (percent: number) => void;
 }
 interface UploadFormFields {
@@ -97,6 +141,8 @@ interface UploadFormFields {
     maxDimensions?: ImageDimensions;
     metadata?: Record<string, string>;
 }
+declare function createUploadAbortError(message?: string): Error;
+declare function isUploadAbortError(err: unknown): boolean;
 declare function parseErrorPayload(status: number, rawBody: string, fallbackLabel?: string): string;
 declare function buildUploadFormData(file: File | Blob, fields?: UploadFormFields): FormData;
 declare function uploadViaXhr(endpoint: string, formData: FormData, options?: XhrUploadOptions): Promise<UploadedImageData>;
@@ -114,8 +160,9 @@ interface AltTextInputProps {
     showHint?: boolean;
     locale?: UploadLocale;
     translations?: Partial<UploadTranslations>;
+    unstyled?: boolean;
 }
-declare function AltTextInput({ value, onChange, disabled, placeholder, maxLength, label, showHint, locale: propLocale, translations, }: AltTextInputProps): react.JSX.Element;
+declare function AltTextInput({ value, onChange, disabled, placeholder, maxLength, label, showHint, locale: propLocale, translations, unstyled: propUnstyled, }: AltTextInputProps): react.JSX.Element;
 
 interface AltTextModalProps {
     imageUrl: string;
@@ -125,10 +172,12 @@ interface AltTextModalProps {
     locale?: UploadLocale;
     translations?: Partial<UploadTranslations>;
     renderImage?: CustomImageRenderer;
+    unstyled?: boolean;
 }
-declare function AltTextModal({ imageUrl, initialAltText, onSave, onClose, locale: propLocale, translations, renderImage, }: AltTextModalProps): react.JSX.Element;
+declare function AltTextModal({ imageUrl, initialAltText, onSave, onClose, locale: propLocale, translations, renderImage, unstyled: propUnstyled, }: AltTextModalProps): react.JSX.Element;
 
 type AnimatedImageObjectFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
+type AnimatedImageColorPlaceholder = 'flat' | 'gradient';
 interface AnimatedImageSource {
     url: string;
     altText?: string | null;
@@ -137,25 +186,59 @@ interface AnimatedImageSource {
     blurColor?: string | null;
     width?: number;
     height?: number;
+    variants?: ImageVariant[];
+    srcSet?: string;
+}
+interface AnimatedImageErrorContext {
+    src: string;
+    retry: () => void;
 }
 interface AnimatedImageBaseProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'src' | 'alt' | 'onLoad' | 'onError' | 'placeholder'> {
     /** LQIP data URL (e.g. `UploadedImageData.blurDataUrl`). Highest priority placeholder. */
     blurDataUrl?: string | null;
     /** BlurHash string, decoded client-side when no `blurDataUrl` is given. */
     blurHash?: string | null;
-    /** Dominant color (e.g. `UploadedImageData.blurColor`) used as background & gradient fallback. */
+    /** Dominant color or CSS variable (e.g. `'#3b82f6'` or `'var(--background-card)'`) used as wrapper background. */
     blurColor?: string | null;
+    /**
+     * Placeholder behavior when only `blurColor` is available (no `blurDataUrl` or `blurHash`):
+     * - `'flat'` (default): uses flat `blurColor` wrapper background with no extra placeholder `<img>` layer (Imagine-Global parity).
+     * - `'gradient'`: mounts an inline SVG gradient placeholder `<img>`.
+     */
+    colorPlaceholder?: AnimatedImageColorPlaceholder;
+    /**
+     * Neutral colors ignored by `resolveBackgroundColor` / `resolveMeaningfulColor`.
+     * Defaults to `DEFAULT_NEUTRAL_COLORS`. Pass `[]` to allow all colors (including `#000000` / `#ffffff`).
+     */
+    neutralColors?: readonly string[];
     /** Absolutely fill the nearest positioned parent (like `next/image` `fill`). */
     fill?: boolean;
+    /**
+     * Mark image as high-priority above-the-fold content:
+     * - Native `<img>`: sets `loading="eager"` and `fetchPriority="high"`.
+     * - Custom `as={Image}`: forwards `priority={true}` and omits default `loading="lazy"`.
+     */
+    priority?: boolean;
+    /**
+     * Image quality hint (1–100) forwarded only when `as` is provided (e.g. `next/image`).
+     * Never rendered as a DOM attribute on a native `<img>`.
+     */
+    quality?: number;
     objectFit?: AnimatedImageObjectFit;
     objectPosition?: CSSProperties['objectPosition'];
-    /** Show an animated shimmer while loading. Default `false`. */
+    /** Show an animated shimmer while loading. Unmounted once loaded. Default `false`. */
     showShimmer?: boolean;
-    /** Crossfade duration in ms. Default `700`. */
+    /** Reveal transition duration in ms. Default `600`. */
     animationDuration?: number;
+    /** Initial scale of the image before reveal (`scale(revealScale) -> scale(1)`). Default `1.02` (`1` = pure fade). */
+    revealScale?: number;
+    /** Optional fallback image URL tried once if the primary `src` fails to load. */
+    fallbackSrc?: string;
+    /** Optional custom error overlay rendered when image loading fails. */
+    renderError?: (ctx: AnimatedImageErrorContext) => ReactNode;
     /** Render a custom image component (e.g. `next/image`, Gatsby, Astro). Receives all img props. */
     as?: ElementType;
-    /** Extra props forwarded only to the `as` component (e.g. `{ quality: 80, priority: true }`). */
+    /** Extra props forwarded only to the `as` component. */
     imageComponentProps?: Record<string, unknown>;
     /** Strip all default `iuk-animated-image*` classes (bring your own CSS). */
     unstyled?: boolean;
@@ -179,60 +262,93 @@ type AnimatedImageProps = AnimatedImageBaseProps & ({
     /** Accessible alt text (use `""` for decorative images). */
     alt: string;
 });
+
 /**
- * Blur-up image with a smooth, GPU-friendly crossfade from placeholder to sharp image.
- * Pure React, SSR-safe, framework-agnostic — plug in `next/image` via `as`.
+ * Blur-up image with a smooth, GPU-friendly crossfade and subtle zoom reveal.
+ * Matches the Imagine-Global reference design while remaining pure React,
+ * SSR-safe, and framework-agnostic — plug in `next/image` via `as`.
  */
-declare function AnimatedImage({ image, src: srcProp, alt: altProp, blurDataUrl: blurDataUrlProp, blurHash: blurHashProp, blurColor: blurColorProp, width: widthProp, height: heightProp, fill, objectFit, objectPosition, showShimmer, animationDuration, as: ImageComponent, imageComponentProps, unstyled, wrapperClassName, wrapperStyle, wrapperProps, placeholderClassName, className, style, loading, decoding, draggable, onLoad, onError, ...imgProps }: AnimatedImageProps): react.JSX.Element;
+declare function AnimatedImage({ image, src: srcProp, alt: altProp, blurDataUrl: blurDataUrlProp, blurHash: blurHashProp, blurColor: blurColorProp, colorPlaceholder, neutralColors, width: widthProp, height: heightProp, fill, priority, quality, objectFit, objectPosition, showShimmer, animationDuration, revealScale, fallbackSrc, renderError, as: ImageComponent, imageComponentProps, unstyled, wrapperClassName, wrapperStyle, wrapperProps, placeholderClassName, className, style, loading: loadingProp, decoding, draggable, onLoad, onError, ...imgProps }: AnimatedImageProps): react.JSX.Element;
+
+/**
+ * Default neutral colors that carry no real information about the image (common
+ * DB defaults or "empty" values). Ignored by default so placeholders never
+ * flash pitch-black or stark white unless `neutralColors={[]}` is passed.
+ */
+declare const DEFAULT_NEUTRAL_COLORS: readonly ["#1a1a1a", "#121212", "#000000", "#000", "#e5e7eb", "#ffffff", "#fff"];
+/**
+ * Returns a safe, meaningful literal color (`#hex`, `rgb(...)`, `hsl(...)`, `oklch(...)`)
+ * suitable for inline SVG embedding, or `undefined` when empty/neutral/invalid.
+ * Rejects CSS variables (`var(--*)`) because SVG data URLs cannot resolve host DOM tokens.
+ */
+declare function resolveMeaningfulColor(color?: string | null, neutralColors?: readonly string[]): string | undefined;
+/**
+ * Returns a safe CSS background-color value for the wrapper element.
+ * Accepts literal colors AND safe CSS custom property expressions (`var(--token)`),
+ * while rejecting neutral defaults and CSS injection payloads.
+ */
+declare function resolveBackgroundColor(color?: string | null, neutralColors?: readonly string[]): string | undefined;
+/**
+ * Inline SVG data URL that renders a soft gradient placeholder.
+ * Uses the dominant color when provided, otherwise a neutral slate gradient.
+ */
+declare function createFallbackBlurSvg(color?: string | null, neutralColors?: readonly string[]): string;
+interface PlaceholderSources {
+    blurDataUrl?: string | null;
+    blurHash?: string | null;
+    blurColor?: string | null;
+    neutralColors?: readonly string[];
+}
+/**
+ * Resolves an intrinsic image placeholder (`blurDataUrl` or decoded `blurHash`)
+ * without falling back to an SVG gradient. Returns `undefined` when neither is present.
+ */
+declare function resolveIntrinsicPlaceholderUrl({ blurDataUrl, blurHash, }: Pick<PlaceholderSources, 'blurDataUrl' | 'blurHash'>): string | undefined;
+/**
+ * Resolves the best available placeholder URL in priority order:
+ * 1. `blurDataUrl` (LQIP data URL / remote URL)
+ * 2. `blurHash` (decoded client-side; browser only)
+ * 3. Gradient SVG derived from `blurColor` (or neutral fallback)
+ */
+declare function resolvePlaceholderUrl({ blurDataUrl, blurHash, blurColor, neutralColors, }: PlaceholderSources): string;
 
 interface UseImageRevealOptions {
-    /** Identity of the current source; a change resets the reveal state. */
+    /** Identity of the primary source; a change resets the reveal state. */
     srcKey: string;
+    /** Optional fallback URL tried once if `srcKey` fails to load. */
+    fallbackSrc?: string;
     /** Crossfade duration in ms. */
     animationDuration: number;
     onLoad?: (img: HTMLImageElement | null) => void;
 }
 interface ImageRevealState {
+    /** Active image URL (`srcKey` initially, or `fallbackSrc` after primary failure). */
+    activeSrc: string;
+    /** Monotonic counter incremented when `retry()` is invoked. */
+    retryKey: number;
     /** True once the sharp image is decoded and ready to fade in. */
     isLoaded: boolean;
-    /** Whether the placeholder layer is still mounted (kept until fade completes). */
+    /** Whether the placeholder layer is still mounted (kept until fade completes, or on error). */
     showPlaceholder: boolean;
-    /** True when the image failed to load. */
+    /** True when the image (and optional `fallbackSrc`) failed to load. */
     hasError: boolean;
     /** Callback ref to attach to the underlying `<img>` element. */
     imgRef: (node: HTMLImageElement | null) => void;
     handleLoad: (img?: HTMLImageElement | null) => void;
-    handleError: () => void;
+    /** Returns `true` if the error is terminal, or `false` if switching to `fallbackSrc`. */
+    handleError: () => boolean;
+    /** Resets error state and retries loading from the primary `srcKey`. */
+    retry: () => void;
 }
 /**
  * Framework-agnostic reveal state machine for blur-up images:
  * - resets synchronously when `srcKey` changes (no stale 1-frame flash)
  * - pre-decodes via `HTMLImageElement.decode()` before crossfading
  * - detects already-cached images after the first paint
- * - keeps the placeholder mounted until the crossfade finishes, then unmounts it
- * - clears all timers / animation frames on unmount
- */
-declare function useImageReveal({ srcKey, animationDuration, onLoad }: UseImageRevealOptions): ImageRevealState;
-
-/** Returns a safe, meaningful color or `undefined` when the value is empty/neutral/invalid. */
-declare function resolveMeaningfulColor(color?: string | null): string | undefined;
-/**
- * Inline SVG data URL that renders a soft gradient placeholder.
- * Uses the dominant color when provided, otherwise a neutral slate gradient.
- */
-declare function createFallbackBlurSvg(color?: string | null): string;
-interface PlaceholderSources {
-    blurDataUrl?: string | null;
-    blurHash?: string | null;
-    blurColor?: string | null;
-}
-/**
- * Resolves the best available placeholder in priority order:
- * 1. `blurDataUrl` (LQIP data URL / remote URL)
- * 2. `blurHash` (decoded client-side; browser only)
- * 3. Gradient SVG derived from `blurColor` (or neutral fallback)
+ * - unmounts placeholder after crossfade (`animationDuration + 50ms`)
+ * - on error: tries `fallbackSrc` once if provided; on terminal error keeps placeholder visible
  */
-declare function resolvePlaceholderUrl({ blurDataUrl, blurHash, blurColor }: PlaceholderSources): string;
+declare function useImageReveal({ srcKey, fallbackSrc, animationDuration, onLoad, }: UseImageRevealOptions): ImageRevealState;
 
 interface BlurImageProps {
     src: string;
@@ -249,6 +365,13 @@ interface BlurImageProps {
 }
 declare function BlurImage({ src, alt, blurDataUrl, blurColor, blurHash, objectFit, className, imageClassName, style, renderImage: propRenderImage, onImageLoad, }: BlurImageProps): react.JSX.Element;
 
+/**
+ * Development helper: exposes the shared `blurService` singleton as
+ * `window.blurService` while mounted, for inspection in the browser console.
+ * Does not augment the global `Window` type of consuming apps.
+ */
+declare function BlurServiceDebugger(): null;
+
 interface BlurVisualizationModalProps {
     isOpen: boolean;
     onClose: () => void;
@@ -265,17 +388,26 @@ interface BlurVisualizationModalProps {
     locale?: UploadLocale;
     translations?: Partial<UploadTranslations>;
     renderImage?: CustomImageRenderer;
+    unstyled?: boolean;
 }
-declare function BlurVisualizationModal({ isOpen, onClose, imageUrl, blurDataUrl, blurColor, altText, originalSize, optimizedSize, detectedColor, onChangeColor, onUseDetectedColor, onChangeAltText, locale: propLocale, translations, renderImage, }: BlurVisualizationModalProps): react.ReactPortal | null;
+declare function BlurVisualizationModal({ isOpen, onClose, imageUrl, blurDataUrl, blurColor, altText, originalSize, optimizedSize, detectedColor, onChangeColor, onUseDetectedColor, onChangeAltText, locale: propLocale, translations, renderImage, unstyled: propUnstyled, }: BlurVisualizationModalProps): react.ReactPortal | null;
 
-declare function ImageUpload<TPreset extends string = UploadPresetName>(props: ImageUploadProps<TPreset>): react.JSX.Element | null;
-declare const UnifiedImageUpload: typeof ImageUpload;
+declare const ImageUpload: <TPreset extends string = UploadPresetName>(props: ImageUploadProps<TPreset> & {
+    ref?: Ref<ImageUploadHandle>;
+}) => ReactElement | null;
+declare const UnifiedImageUpload: <TPreset extends string = StandardPresetName | (string & {})>(props: ImageUploadProps<TPreset> & {
+    ref?: Ref<ImageUploadHandle>;
+}) => ReactElement | null;
 
-declare function MultiImageUpload<TPreset extends string = UploadPresetName>(props: MultiImageUploadProps<TPreset>): react.JSX.Element;
+declare const MultiImageUpload: <TPreset extends string = UploadPresetName>(props: MultiImageUploadProps<TPreset> & {
+    ref?: Ref<ImageUploadHandle>;
+}) => ReactElement | null;
 
 interface PreviewTileProps {
     preview: ImagePreview;
     onRemove: (id: string) => void;
+    onCancel?: (id: string) => void;
+    onRetry?: (id: string) => void;
     disabled?: boolean;
     blurType?: BlurPlaceholderType;
     isSelected?: boolean;
@@ -285,6 +417,7 @@ interface PreviewTileProps {
     onAdjustColor?: (id: string) => void;
     onChangeColor?: (id: string, color: string) => void;
     onChangeAltText?: (id: string, altText: string) => void;
+    appendCacheBuster?: boolean;
     locale?: UploadLocale;
     translations?: Partial<UploadTranslations>;
     renderImage?: CustomImageRenderer;
@@ -292,7 +425,7 @@ interface PreviewTileProps {
     className?: string;
     style?: CSSProperties;
 }
-declare function PreviewTile({ preview, onRemove, disabled, blurType, isSelected, onToggleSelect, onEditAltText, showCheckbox, onAdjustColor, onChangeColor, onChangeAltText, locale: propLocale, translations, renderImage, unstyled: propUnstyled, className, style, }: PreviewTileProps): react.JSX.Element;
+declare function PreviewTile({ preview, onRemove, onCancel, onRetry, disabled, blurType, isSelected, onToggleSelect, onEditAltText, showCheckbox, onAdjustColor, onChangeColor, onChangeAltText, appendCacheBuster: appendBuster, locale: propLocale, translations, renderImage, unstyled: propUnstyled, className, style, }: PreviewTileProps): react.JSX.Element;
 
 interface QualitySelectorProps {
     value: QualityLevel;
@@ -305,9 +438,11 @@ interface QualitySelectorProps {
     };
     originalFileSize?: number;
     locale?: UploadLocale;
+    translations?: Partial<UploadTranslations>;
     disabled?: boolean;
+    unstyled?: boolean;
 }
-declare function QualitySelector({ value, onChange, preset, recommendedLevel, recommendationNote, originalFileSize, locale, disabled, }: QualitySelectorProps): react.JSX.Element;
+declare function QualitySelector({ value, onChange, preset, recommendedLevel, recommendationNote, originalFileSize, locale, translations, disabled, unstyled, }: QualitySelectorProps): react.JSX.Element;
 
 interface SaveButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     icon?: ReactNode;
@@ -316,7 +451,9 @@ interface SaveButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
 }
 declare function SaveButton({ icon, unstyled, children, className, type, ...rest }: SaveButtonProps): react.JSX.Element;
 
-declare function SingleImageUpload<TPreset extends string = UploadPresetName>(props: SingleImageUploadProps<TPreset>): react.JSX.Element;
+declare const SingleImageUpload: <TPreset extends string = UploadPresetName>(props: SingleImageUploadProps<TPreset> & {
+    ref?: Ref<ImageUploadHandle>;
+}) => ReactElement | null;
 
 interface UploadItem {
     id: string;
@@ -332,7 +469,8 @@ interface UploadProgressPanelProps {
     locale?: UploadLocale;
     translations?: Partial<UploadTranslations>;
     renderImage?: CustomImageRenderer;
+    unstyled?: boolean;
 }
-declare function UploadProgressPanel({ items, completedCount, totalCount, locale: propLocale, translations, renderImage, }: UploadProgressPanelProps): react.JSX.Element | null;
+declare function UploadProgressPanel({ items, completedCount, totalCount, locale: propLocale, translations, renderImage, unstyled: propUnstyled, }: UploadProgressPanelProps): react.JSX.Element | null;
 
-export { AltTextInput, type AltTextInputProps, AltTextModal, type AltTextModalProps, AnimatedImage, type AnimatedImageObjectFit, type AnimatedImageProps, type AnimatedImageSource, BlurImage, type BlurImageProps, BlurPlaceholderType, BlurSize, BlurVisualizationModal, type BlurVisualizationModalProps, CustomImageRenderer, DEFAULT_PLACEHOLDERS, HIDDEN_INPUT_STYLE, ImagePreview, type ImageRevealState, ImageUpload, ImageUploadProps, MultiImageUpload, MultiImageUploadProps, PreviewTile, type PreviewTileProps, QualitySelector, type QualitySelectorProps, SaveButton, type SaveButtonProps, SingleImageUpload, SingleImageUploadProps, UnifiedImageUpload, type UploadFormFields, type UploadItem, UploadProgressPanel, type UploadProgressPanelProps, UploadTranslations, UploadVisualState, type UseImageRevealOptions, type XhrUploadOptions, arTranslations, buildUploadFormData, createFallbackBlurSvg, cx, enTranslations, normalizeUploadLocale, parseErrorPayload, resolveMeaningfulColor, resolvePlaceholderUrl, resolveSlotClass, resolveSlotStyle, resolveTranslations, resolveUploadDataState, uploadText, uploadViaXhr, useBlurDataURL, useBlurDataWithColor, useBlurHash, useBlurMetadata, useBlurPreload, useBlurVariant, useBulkBlurData, useDominantColor, useHasBlurHash, useImageReveal, useProgressiveBlur, useProgressiveImage };
+export { ARABIC_UPLOAD_TRANSLATIONS, AltTextInput, type AltTextInputProps, AltTextModal, type AltTextModalProps, AnimatedImage, type AnimatedImageBaseProps, type AnimatedImageColorPlaceholder, type AnimatedImageErrorContext, type AnimatedImageObjectFit, type AnimatedImageProps, type AnimatedImageSource, BlurImage, type BlurImageProps, BlurPlaceholderType, BlurServiceDebugger, BlurSize, BlurVisualizationModal, type BlurVisualizationModalProps, CustomImageRenderer, DEFAULT_NEUTRAL_COLORS, DEFAULT_UPLOAD_TRANSLATIONS, HIDDEN_INPUT_STYLE, ImagePreview, type ImageRevealState, ImageUpload, ImageUploadHandle, ImageUploadProps, MultiImageUpload, MultiImageUploadProps, type PasteTargetMode, type PlaceholderSources, PreviewTile, type PreviewTileProps, QualitySelector, type QualitySelectorProps, SaveButton, type SaveButtonProps, SingleImageUpload, SingleImageUploadProps, UnifiedImageUpload, type UploadFormFields, type UploadItem, UploadLocale, UploadProgressPanel, type UploadProgressPanelProps, UploadTranslations, UploadVisualState, type UseClipboardPasteOptions, type UseDialogOptions, type UseImageRevealOptions, type XhrUploadOptions, arTranslations, buildUploadFormData, createFallbackBlurSvg, createUploadAbortError, cx, enTranslations, extractClipboardImageFiles, formatNeedsAltMessage, formatSkippedImagesMessage, formatUploadingCount, isUploadAbortError, normalizeUploadLocale, parseErrorPayload, resolveBackgroundColor, resolveIntrinsicPlaceholderUrl, resolveMeaningfulColor, resolvePlaceholderUrl, resolveSlotClass, resolveSlotStyle, resolveTranslations, resolveUploadDataState, selectPluralCategory, toFileListLike, uploadText, uploadViaXhr, useBlurDataURL, useBlurDataWithColor, useBlurHash, useBlurMetadata, useBlurPreload, useBlurVariant, useBulkBlurData, useClipboardPaste, useDialog, useDominantColor, useHasBlurHash, useImageReveal, useProgressiveBlur, useProgressiveImage };