upload-motion 0.0.0-stage → 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,617 @@
+
+import { A as FileRejection, B as UploadTotals, C as AddFilesResult, D as ClearFilter, E as createUploadStore, F as UploadEventMap, G as isUploadError, H as UploadError, I as UploadHandler, K as toUploadError, L as UploadItem, M as RejectionReason, N as RetryOptions, O as CustomValidator, P as UploadContext, R as UploadSnapshot, S as createXhrUploader, T as computeTotals, U as UploadErrorCode, V as UploaderOptions, W as httpErrorMessage, _ as parseAccept, a as presetCatalog, b as XhrUploaderOptions, c as formatDuration, d as getExtension, f as getFileKind, g as isFileAccepted, h as describeAccept, i as PresetInfo, j as RejectionCode, k as FileKind, l as formatPercent, m as isPreviewableImage, n as PresetCategory, o as clamp01, p as getFileLabel, r as PresetId, s as formatBytes, t as PRESET_INFO, u as formatSpeed, v as validateFile, w as UploadStore, x as createSimulatedUploader, y as SimulatedUploaderOptions, z as UploadStatus } from "./index-BZJA26zI.cjs";
+import { CSSProperties, ComponentType, HTMLAttributes, InputHTMLAttributes, ReactNode, RefObject } from "react";
+//#region src/types/index.d.ts
+type ThemeMode = 'light' | 'dark' | 'system';
+type Density = 'compact' | 'comfortable' | 'spacious';
+type ProgressVariant = 'bar' | 'ring' | 'wave' | 'beam';
+type QueueLayout = 'list' | 'grid';
+/** Visual tokens. Every value maps to a `--um-*` CSS custom property you can also set in CSS. */
+interface Appearance {
+  theme?: ThemeMode;
+  /** Primary brand colour. Any CSS colour. */
+  accent?: string;
+  /** Second gradient stop. Defaults to a shifted accent. */
+  accentSecondary?: string;
+  background?: string;
+  surface?: string;
+  text?: string;
+  mutedText?: string;
+  border?: string;
+  success?: string;
+  danger?: string;
+  /** Corner radius, e.g. `16` or `"1rem"`. */
+  radius?: number | string;
+  density?: Density;
+  shadow?: 'none' | 'soft' | 'elevated' | (string & {});
+  fontFamily?: string;
+  /** Minimum height of the drop zone, e.g. `240` or `"18rem"`. */
+  zoneHeight?: number | string;
+}
+interface MotionOptions {
+  /** Playback speed multiplier. `2` = twice as fast. Default 1. */
+  speed?: number;
+  /** 0..1.5 amplitude of decorative motion (tilt, bounce, wobble). Default 1. */
+  intensity?: number;
+  /** 0..1 particle density for presets that use particles. 0 disables them. Default 1. */
+  particles?: number;
+  /** `user` follows `prefers-reduced-motion`; `always` forces reduced motion; `never` ignores the OS setting. */
+  reducedMotion?: 'user' | 'always' | 'never';
+}
+interface ResolvedMotion {
+  reduced: boolean;
+  speed: number;
+  intensity: number;
+  particles: number;
+}
+interface UploadLabels {
+  dropTitle: string;
+  dropHint: string;
+  browse: string;
+  dropActive: string;
+  dropReject: string;
+  zoneLabel: string;
+  upload: string;
+  uploadMore: string;
+  pause: string;
+  resume: string;
+  cancel: string;
+  cancelAll: string;
+  retry: string;
+  retryFailed: string;
+  remove: string;
+  clearCompleted: string;
+  clearAll: string;
+  expand: string;
+  collapse: string;
+  moreActions: string;
+  dismiss: string;
+  finishing: string;
+  simulated: string;
+  simulatedHint: string;
+  noHandler: string;
+  status: Record<UploadStatus, string>;
+  timeLeft: (duration: string) => string;
+  retryingIn: (seconds: number) => string;
+  summary: (totals: UploadTotals) => string;
+  acceptHint: (parts: {
+    types: string;
+    maxSize: string;
+    maxFiles: number | null;
+  }) => string;
+}
+/** Per-kind visualizers used by list presets (e.g. `adaptive`). */
+type FileVisualizer = 'bloom' | 'page' | 'filmstrip' | 'waveform' | 'pixel' | 'card';
+interface FileRenderHelpers {
+  remove: () => void;
+  cancel: () => void;
+  retry: () => void;
+  pause: () => void;
+  resume: () => void;
+  start: () => void;
+  labels: UploadLabels;
+}
+interface UploadClassNames {
+  root?: string;
+  zone?: string;
+  list?: string;
+  item?: string;
+  progress?: string;
+  actions?: string;
+}
+/** Props every preset understands. Presets ignore what doesn't fit their concept (documented per preset). */
+interface PresetProps {
+  /** Replace the per-file card. */
+  renderFile?: (item: UploadItem, helpers: FileRenderHelpers) => ReactNode;
+  /** Replace the default drop-zone content (icon + headline). */
+  zoneContent?: ReactNode;
+  classNames?: UploadClassNames;
+  progressVariant?: ProgressVariant;
+  layout?: QueueLayout;
+  fileAnimations?: Partial<Record<FileKind, FileVisualizer>>;
+  /** Show the list of rejected files. Default true. */
+  showRejections?: boolean;
+  /** Headline/title override for presets with a header. */
+  title?: ReactNode;
+  description?: ReactNode;
+}
+interface UploadPreset extends Omit<PresetInfo, 'id'> {
+  id: PresetId | (string & {});
+  Component: ComponentType<PresetProps>;
+}
+//#endregion
+//#region src/hooks/useDropzone.d.ts
+type DragState = 'idle' | 'accept' | 'reject';
+interface DropzoneOptions {
+  onFiles: (files: File[]) => void;
+  /** Parsed accept tokens (see `parseAccept`). */
+  accept?: readonly string[];
+  multiple?: boolean;
+  maxFiles?: number;
+  disabled?: boolean;
+  /** Mobile camera hint passed to the input (`capture` attribute). */
+  capture?: 'user' | 'environment';
+  /** Stop the browser from opening files dropped outside any drop zone. Default true. */
+  preventWindowDrop?: boolean;
+}
+interface DropPoint {
+  /** Client coordinates of the drop. */
+  x: number;
+  y: number;
+  at: number;
+}
+interface RootPropsOptions extends HTMLAttributes<HTMLElement> {
+  /** Make the zone itself a keyboard-focusable button. Use when it contains no other controls. */
+  focusable?: boolean;
+  /** Write `--um-px` / `--um-py` (0..1) pointer position CSS variables while hovering or dragging. */
+  trackPointer?: boolean;
+  /** Don't open the file dialog when the zone itself is clicked. */
+  noClick?: boolean;
+  'aria-label'?: string;
+}
+interface DropzoneApi {
+  dragState: DragState;
+  /** Files are being dragged over this zone. */
+  isDragActive: boolean;
+  /** Files are being dragged anywhere over the window. */
+  isWindowDrag: boolean;
+  lastDrop: DropPoint | null;
+  /** Synchronous read of the latest drop point – safe inside store event handlers fired during the drop. */
+  getLastDrop: () => DropPoint | null;
+  open: () => void;
+  inputRef: RefObject<HTMLInputElement | null>;
+  getRootProps: (options?: RootPropsOptions) => HTMLAttributes<HTMLElement> & Record<`data-${string}`, string | undefined>;
+  getInputProps: () => InputHTMLAttributes<HTMLInputElement> & {
+    ref: RefObject<HTMLInputElement | null>;
+  };
+}
+export declare function useDropzone(options: DropzoneOptions): DropzoneApi;
+//#endregion
+//#region src/hooks/useUploader.d.ts
+interface UseUploaderOptions<TResponse = unknown> extends UploaderOptions<TResponse> {
+  /**
+   * Bring your own store (e.g. created at module level) so uploads survive
+   * unmounts. When omitted the hook owns a store and aborts its uploads on unmount.
+   */
+  store?: UploadStore<TResponse>;
+  disabled?: boolean;
+  capture?: 'user' | 'environment';
+  preventWindowDrop?: boolean;
+}
+interface UploaderApi<TResponse = unknown> extends UploadSnapshot<TResponse> {
+  store: UploadStore<TResponse>;
+  dropzone: DropzoneApi;
+  /** Parsed accept tokens. */
+  accept: readonly string[];
+  disabled: boolean;
+  addFiles: UploadStore<TResponse>['addFiles'];
+  openFileDialog: () => void;
+  start: UploadStore<TResponse>['start'];
+  cancel: UploadStore<TResponse>['cancel'];
+  retry: UploadStore<TResponse>['retry'];
+  pause: UploadStore<TResponse>['pause'];
+  resume: UploadStore<TResponse>['resume'];
+  remove: UploadStore<TResponse>['remove'];
+  clear: (filter?: ClearFilter) => void;
+  dismissRejection: UploadStore<TResponse>['dismissRejection'];
+}
+/** Subscribe to any upload store. */
+export declare function useUploadSnapshot<TResponse>(store: UploadStore<TResponse>): UploadSnapshot<TResponse>;
+/**
+ * Headless uploader: queue state, actions and drag-and-drop wiring with no UI.
+ *
+ * ```tsx
+ * const uploader = useUploader({ upload: createXhrUploader({ url: '/api/upload' }) });
+ * <div {...uploader.dropzone.getRootProps({ focusable: true })}>
+ *   <input {...uploader.dropzone.getInputProps()} />
+ * </div>
+ * ```
+ */
+export declare function useUploader<TResponse = unknown>(options?: UseUploaderOptions<TResponse>): UploaderApi<TResponse>;
+//#endregion
+//#region src/components/Uploader.d.ts
+interface UploaderProps<TResponse = unknown> extends UseUploaderOptions<TResponse> {
+  appearance?: Appearance;
+  motion?: MotionOptions;
+  /** Override any UI string (i18n). */
+  labels?: Partial<Omit<UploadLabels, 'status'>> & {
+    status?: Partial<UploadLabels['status']>;
+  };
+  className?: string;
+  style?: CSSProperties;
+  id?: string;
+  children?: ReactNode;
+}
+/**
+ * Root of the composable API. Owns the upload store, the hidden file input,
+ * theme variables and the screen-reader announcer.
+ */
+export declare function Uploader<TResponse = unknown>(props: UploaderProps<TResponse>): import("react").JSX.Element;
+//#endregion
+//#region src/components/FileUpload.d.ts
+interface FileUploadProps<TResponse = unknown> extends UploaderProps<TResponse>, Omit<PresetProps, 'title' | 'description'> {
+  /** Built-in preset id or a custom preset object. Default `"essential"`. */
+  preset?: PresetId | (string & {}) | UploadPreset;
+  /** Headline override for presets that show one. */
+  title?: PresetProps['title'];
+  description?: PresetProps['description'];
+}
+/**
+ * Ready-made animated uploader.
+ *
+ * ```tsx
+ * <FileUpload
+ *   preset="wave-bar"
+ *   upload={createXhrUploader({ url: '/api/upload' })}
+ *   accept="image/*,.pdf"
+ *   maxSize={20_000_000}
+ * />
+ * ```
+ */
+export declare function FileUpload<TResponse = unknown>(props: FileUploadProps<TResponse>): import("react").JSX.Element;
+//#endregion
+//#region src/animations/beam.d.ts
+export declare const beamPreset: UploadPreset;
+//#endregion
+//#region src/animations/card-fan.d.ts
+export declare const cardFanPreset: UploadPreset;
+//#endregion
+//#region src/animations/essential.d.ts
+export declare const essentialPreset: UploadPreset;
+//#endregion
+//#region src/animations/hoop-shot.d.ts
+export declare const hoopShotPreset: UploadPreset;
+//#endregion
+//#region src/animations/liquid.d.ts
+export declare const liquidPreset: UploadPreset;
+//#endregion
+//#region src/animations/magnetic.d.ts
+export declare const magneticPreset: UploadPreset;
+//#endregion
+//#region src/animations/media.d.ts
+export declare const bloomPreset: UploadPreset;
+export declare const pixelPreset: UploadPreset;
+export declare const pageRevealPreset: UploadPreset;
+export declare const filmstripPreset: UploadPreset;
+export declare const waveformPreset: UploadPreset;
+export declare const adaptivePreset: UploadPreset;
+//#endregion
+//#region src/animations/orbit.d.ts
+export declare const orbitPreset: UploadPreset;
+//#endregion
+//#region src/animations/portal.d.ts
+export declare const portalPreset: UploadPreset;
+//#endregion
+//#region src/animations/segment-ring.d.ts
+export declare const segmentRingPreset: UploadPreset;
+//#endregion
+//#region src/animations/stack.d.ts
+export declare const stackPreset: UploadPreset;
+//#endregion
+//#region src/animations/wave-bar.d.ts
+export declare const waveBarPreset: UploadPreset;
+//#endregion
+//#region src/animations/index.d.ts
+/** All built-in presets, in gallery order. */
+export declare const presets: readonly UploadPreset[];
+export declare function getPreset(id: PresetId | (string & {})): UploadPreset | undefined;
+//#endregion
+//#region src/components/context.d.ts
+interface UploaderContextValue<TResponse = unknown> extends UploaderApi<TResponse> {
+  labels: UploadLabels;
+  motion: ResolvedMotion;
+  /** Human-readable accept/limit summary, e.g. "Images, PDF · up to 10 MB". */
+  hint: string;
+  hintId: string;
+  autoUpload: boolean;
+}
+/** Access the nearest `<Uploader>` / `<FileUpload>` state and actions. */
+export declare function useUploaderContext<TResponse = unknown>(): UploaderContextValue<TResponse>;
+//#endregion
+//#region src/components/Dropzone.d.ts
+interface UploadDropzoneProps {
+  children?: ReactNode;
+  className?: string;
+  style?: CSSProperties;
+  /**
+   * Make the whole zone a focusable button. Leave `false` (default) when the
+   * zone contains its own buttons, e.g. `<BrowseButton>`.
+   */
+  focusable?: boolean;
+  /** Track the pointer into `--um-px` / `--um-py` CSS variables. */
+  trackPointer?: boolean;
+  'aria-label'?: string;
+}
+/** Drop target. Click anywhere (outside inner controls) to open the file dialog; paste works while focused. */
+export declare function UploadDropzone({ children, className, style, focusable, trackPointer, ...rest }: UploadDropzoneProps): import("react").JSX.Element;
+/** Default zone content: icon, headline, browse button and limits hint. */
+export declare function DropzoneContent({ icon, title }: {
+  icon?: ReactNode;
+  title?: ReactNode;
+}): import("react").JSX.Element;
+export declare function UploadHint({ className }: {
+  className?: string;
+}): import("react").JSX.Element;
+interface BrowseButtonProps {
+  children?: ReactNode;
+  className?: string;
+  variant?: 'solid' | 'soft' | 'link' | 'icon';
+  'aria-label'?: string;
+}
+/** Keyboard-accessible trigger for the native file dialog. */
+export declare function BrowseButton({ children, className, variant, ...rest }: BrowseButtonProps): import("react").JSX.Element;
+/** Starts pending uploads in manual mode (`autoUpload={false}`). Shows aggregate progress while uploading. */
+export declare function StartUploadButton({ className, children }: {
+  className?: string;
+  children?: ReactNode;
+}): import("react").JSX.Element;
+//#endregion
+//#region src/components/FileList.d.ts
+interface AnimatedListProps<T extends {
+  id: string;
+}> {
+  items: readonly T[];
+  renderItem: (item: T, state: {
+    exiting: boolean;
+    index: number;
+  }) => ReactNode;
+  className?: string;
+  itemClassName?: string;
+  /** Exit animation length in ms. Default 320. */
+  exitDuration?: number;
+  as?: 'ul' | 'ol' | 'div';
+  /** Exposed as `data-layout` for styling (`list`, `grid`, …). */
+  layout?: string;
+  'aria-label'?: string;
+}
+/**
+ * List with enter/exit presence and FLIP re-layout animations.
+ * Generic so presets can animate any collection, not only upload items.
+ */
+export declare function AnimatedList<T extends {
+  id: string;
+}>({ items, renderItem, className, itemClassName, exitDuration, as: Tag, layout, 'aria-label': ariaLabel }: AnimatedListProps<T>): import("react").JSX.Element;
+interface UploadFileListProps {
+  layout?: QueueLayout;
+  progressVariant?: ProgressVariant;
+  renderFile?: (item: UploadItem, helpers: FileRenderHelpers) => ReactNode;
+  /** Defaults to every item in the queue. */
+  items?: readonly UploadItem[];
+  className?: string;
+  itemClassName?: string;
+  allowPause?: boolean;
+}
+/** The queue, rendered with `FileCard` (or your `renderFile`). */
+export declare function UploadFileList({ layout, progressVariant, renderFile, items, className, itemClassName, allowPause }: UploadFileListProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/components/FileItem.d.ts
+/** Plain-language status line, e.g. "45% · 2.1 MB/s · 3 seconds left". */
+export declare function describeItemStatus(item: UploadItem, labels: UploadLabels, transport: 'network' | 'simulated' | 'none'): string;
+export declare function ItemStatus({ item, className }: {
+  item: UploadItem;
+  className?: string;
+}): import("react").JSX.Element;
+interface ActionButtonProps {
+  label: string;
+  onClick: () => void;
+  children: ReactNode;
+  tone?: 'default' | 'danger' | 'accent';
+}
+export declare function IconButton({ label, onClick, children, tone }: ActionButtonProps): import("react").JSX.Element;
+/** Contextual actions for one file: start, pause/resume, cancel, retry, remove. */
+export declare function ItemActions({ item, className, allowPause }: {
+  item: UploadItem;
+  className?: string;
+  allowPause?: boolean;
+}): import("react").JSX.Element;
+interface FileCardProps {
+  item: UploadItem;
+  progressVariant?: ProgressVariant;
+  className?: string;
+  /** Leading visual. Defaults to a thumbnail/icon. */
+  media?: ReactNode;
+  allowPause?: boolean;
+  /** Celebrate success with a particle burst. Default true. */
+  celebrate?: boolean;
+}
+/** The default animated file row used by list-based presets. */
+export declare const FileCard: import("react").MemoExoticComponent<({ item, progressVariant, className, media, allowPause, celebrate }: FileCardProps) => import("react").JSX.Element>;
+//#endregion
+//#region src/components/Progress.d.ts
+/** Builds a sine-like quadratic wave: `width` px wide, one crest every `period` px. */
+export declare function wavePath(width: number, period: number, amplitude: number, baseline: number): string;
+interface UploadProgressProps {
+  /** 0..1 */
+  value: number;
+  status?: UploadStatus;
+  variant?: ProgressVariant;
+  /** Accessible name, e.g. the file name. */
+  label?: string;
+  /** Accessible value text, e.g. "45%, 3 seconds left". */
+  valueText?: string;
+  /** Ring diameter in px (ring variant). */
+  size?: number;
+  className?: string;
+}
+/**
+ * Progress indicator with four styles. Animates with transforms/clip-path only,
+ * so it stays cheap even with many concurrent uploads.
+ */
+export declare function UploadProgress({ value, status, variant, label, valueText, size, className }: UploadProgressProps): import("react").JSX.Element;
+//#endregion
+//#region src/components/FileVisual.d.ts
+interface FileIconProps {
+  kind: FileKind;
+  /** Badge text such as `PDF`. Omit to hide the badge. */
+  label?: string;
+  size?: number;
+  className?: string;
+}
+/** Paper-shaped file icon with a kind glyph and coloured extension badge. */
+export declare function FileIcon({ kind, label, size, className }: FileIconProps): import("react").JSX.Element;
+interface FilePreviewProps {
+  item: UploadItem;
+  size?: number;
+  /** Max bytes for generating an image preview. Default 25 MB. */
+  maxPreviewSize?: number;
+  className?: string;
+  rounded?: boolean;
+}
+/** Image thumbnail for previewable images, otherwise a `FileIcon`. Object URLs are revoked automatically. */
+export declare function FilePreview({ item, size, maxPreviewSize, className }: FilePreviewProps): import("react").JSX.Element;
+//#endregion
+//#region src/components/Effects.d.ts
+/** Stroke-drawn checkmark inside a circle. */
+export declare function AnimatedCheck({ size, className }: {
+  size?: number;
+  className?: string;
+}): import("react").JSX.Element;
+interface BurstProps {
+  /** Base particle count before the `particles` motion multiplier. */
+  count?: number;
+  seed?: string;
+  /** Spread radius in px. */
+  spread?: number;
+  className?: string;
+  shape?: 'dot' | 'petal' | 'spark';
+}
+/**
+ * One-shot particle burst built from a handful of spans animated with CSS
+ * transforms. Mount it (e.g. with a key) to play; renders nothing for reduced
+ * motion or `particles: 0`.
+ */
+export declare function Burst({ count, seed, spread, className, shape }: BurstProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/components/Status.d.ts
+/** "Uploading 3 files" + "63% · 6.4 MB/s · 5 seconds left". */
+export declare function useSummaryText(): {
+  title: string;
+  detail: string;
+};
+export declare function UploadSummary({ className }: {
+  className?: string;
+}): import("react").JSX.Element;
+/** Badge shown when the transport is simulated, so demos never pass fake progress off as real. */
+export declare function TransportBadge({ className }: {
+  className?: string;
+}): import("react").JSX.Element | null;
+/** Dismissible list of files that failed validation, with the reason in text (not colour alone). */
+export declare function UploadRejections({ className }: {
+  className?: string;
+}): import("react").JSX.Element | null;
+//#endregion
+//#region src/components/Announcer.d.ts
+/**
+ * Visually hidden live regions announcing lifecycle changes (not every
+ * progress tick). Errors use an assertive region.
+ */
+export declare function UploadAnnouncer(): import("react").JSX.Element;
+//#endregion
+//#region src/components/Menu.d.ts
+interface MenuAction {
+  id: string;
+  label: string;
+  onSelect: () => void;
+  disabled?: boolean;
+  tone?: 'default' | 'danger';
+}
+interface ActionMenuProps {
+  label: string;
+  icon: ReactNode;
+  actions: MenuAction[];
+  className?: string;
+  align?: 'start' | 'end';
+}
+/** Small accessible menu button: arrow-key navigation, Escape to close, focus restored to the trigger. */
+export declare function ActionMenu({ label, icon, actions, className, align }: ActionMenuProps): import("react").JSX.Element;
+//#endregion
+//#region src/animations/visualizers.d.ts
+/** Image sharpens and saturates from the centre outward as bytes upload. */
+export declare function BloomVisual({ item }: {
+  item: UploadItem;
+}): import("react").JSX.Element;
+/** A page whose lines are inked by a scanning beam. Text files show their real first lines. */
+export declare function PageVisual({ item }: {
+  item: UploadItem;
+}): import("react").JSX.Element;
+/** Real frames extracted from the video light up one by one as it uploads. */
+export declare function FilmstripVisual({ item }: {
+  item: UploadItem;
+}): import("react").JSX.Element;
+/** Waveform of the actual audio (decoded locally); a stable pseudo-waveform for other files. */
+export declare function WaveformVisual({ item }: {
+  item: UploadItem;
+}): import("react").JSX.Element;
+/** Play/pause a local preview of an audio file. The object URL is created on first play and revoked on unmount. */
+export declare function AudioPreviewButton({ item }: {
+  item: UploadItem;
+}): import("react").JSX.Element | null;
+/** The file assembles from flying pixels in a shuffled order driven by progress (one CSS variable, no per-cell renders). */
+export declare const PixelVisual: import("react").MemoExoticComponent<({ item }: {
+  item: UploadItem;
+}) => import("react").JSX.Element>;
+/** Square tile with overlay meta – used by Bloom and Pixel presets. */
+export declare const VisualTile: import("react").MemoExoticComponent<({ item, visual }: {
+  item: UploadItem;
+  visual: ReactNode;
+}) => import("react").JSX.Element>;
+/** Row with a visual on the left – used by Filmstrip, Waveform and Adaptive presets. */
+export declare const VisualRow: import("react").MemoExoticComponent<({ item, visual, visualKind, leading }: {
+  item: UploadItem;
+  visual: ReactNode;
+  visualKind: FileVisualizer;
+  leading?: ReactNode;
+}) => import("react").JSX.Element>;
+//#endregion
+//#region src/hooks/useMedia.d.ts
+/**
+ * Object URL for an image preview, revoked automatically on unmount or when the
+ * file changes. Returns `null` for non-images and files above `maxSize` (large
+ * images are expensive to decode, so they get an icon instead).
+ */
+export declare function useFilePreview(item: Pick<UploadItem, 'file'> | null, maxSize?: number): string | null;
+/**
+ * Extracts `count` evenly spaced frames from a local video as small JPEG data
+ * URLs. Everything happens in the browser; unsupported codecs yield `[]`.
+ */
+export declare function useVideoFrames(file: File | null, count: number, enabled?: boolean): string[];
+/**
+ * Real waveform peaks decoded with the Web Audio API for audio files up to
+ * 30 MB; a stable pseudo waveform otherwise. `real` tells you which you got.
+ */
+export declare function useAudioPeaks(file: File | null, bars: number, enabled?: boolean): {
+  peaks: number[];
+  real: boolean;
+};
+/** First lines of small text-like files, for document previews. `null` when not applicable. */
+export declare function useTextSnippet(item: Pick<UploadItem, 'file' | 'kind' | 'size'> | null, lines?: number): string[] | null;
+//#endregion
+//#region src/hooks/useListAnimation.d.ts
+interface PresenceEntry<T> {
+  item: T;
+  exiting: boolean;
+}
+/**
+ * Keeps removed items rendered for `exitMs` so they can animate out.
+ * Removed items are re-inserted at their previous index.
+ */
+export declare function usePresence<T extends {
+  id: string;
+}>(items: readonly T[], exitMs: number): PresenceEntry<T>[];
+/**
+ * FLIP layout animation: when the set/order of `[data-flip-id]` children
+ * changes, children animate from their old offset to the new one using WAAPI.
+ */
+export declare function useFlip(containerRef: RefObject<HTMLElement | null>, layoutKey: string, enabled: boolean, duration?: number): void;
+//#endregion
+//#region src/hooks/utils.d.ts
+/** `true` when the OS asks for reduced motion. Always `false` during SSR. */
+export declare function usePrefersReducedMotion(): boolean;
+//#endregion
+//#region src/themes/index.d.ts
+/** Converts appearance + motion settings to inline CSS custom properties. Unset values fall back to the stylesheet. */
+export declare function appearanceToStyle(appearance: Appearance | undefined, motion: ResolvedMotion): CSSProperties;
+export declare function resolveMotion(motion: MotionOptions | undefined, prefersReduced: boolean): ResolvedMotion;
+export declare const defaultLabels: UploadLabels;
+//#endregion
+export { type ActionMenuProps, type AddFilesResult, type AnimatedListProps, type Appearance, type BrowseButtonProps, type BurstProps, type ClearFilter, type CustomValidator, type Density, type DragState, type DropPoint, type DropzoneApi, type DropzoneOptions, type FileCardProps, type FileIconProps, type FileKind, type FilePreviewProps, type FileRejection, type FileRenderHelpers, type FileUploadProps, type FileVisualizer, type MenuAction, type MotionOptions, PRESET_INFO, type PresetCategory, type PresetId, type PresetInfo, type PresetProps, type ProgressVariant, type QueueLayout, type RejectionCode, type RejectionReason, type ResolvedMotion, type RetryOptions, type SimulatedUploaderOptions, type ThemeMode, type UploadClassNames, type UploadContext, type UploadDropzoneProps, UploadError, type UploadErrorCode, type UploadEventMap, type UploadFileListProps, type UploadHandler, type UploadItem, type UploadLabels, type UploadPreset, type UploadProgressProps, type UploadSnapshot, type UploadStatus, type UploadStore, type UploadTotals, type UploaderApi, type UploaderContextValue, type UploaderOptions, type UploaderProps, type UseUploaderOptions, type XhrUploaderOptions, clamp01, computeTotals, createSimulatedUploader, createUploadStore, createXhrUploader, describeAccept, formatBytes, formatDuration, formatPercent, formatSpeed, getExtension, getFileKind, getFileLabel, httpErrorMessage, isFileAccepted, isPreviewableImage, isUploadError, parseAccept, presetCatalog, toUploadError, validateFile };