{"slug":"file-upload","name":"File Upload","description":"Two file upload patterns: an attachment workspace for mixed files, links, audio and media, plus a progress queue with retry and removal.","category":"blocks","source_url":"https://beui.dev/r/file-upload/raw","detail_url":"https://beui.dev/r/file-upload","raw_url":"https://beui.dev/r/file-upload/raw","page_url":"https://beui.dev/components/blocks/file-upload","markdown_url":"https://beui.dev/components/blocks/file-upload.md","published_at":"2026-06-18","updated_at":"2026-07-30","dependencies":["clsx","lucide-react","motion","react","react-dom","tailwind-merge"],"internal":["@/components/motion/file-upload","@/components/motion/tooltip","@/lib/ease","@/lib/hooks/use-hover-capable","@/lib/utils"],"files":[{"path":"components/motion/file-upload.tsx","type":"component","content":"\"use client\";\n// beui.dev/components/blocks/file-upload\n\nimport {\n AlertCircle,\n CheckCircle2,\n FileArchive,\n FileAudio,\n FileCode2,\n FileIcon,\n FileImage,\n FileSpreadsheet,\n FileText,\n FileVideo,\n Loader2,\n RotateCcw,\n UploadCloud,\n X,\n} from \"lucide-react\";\nimport { AnimatePresence, motion, useReducedMotion } from \"motion/react\";\nimport { useCallback, useId, useRef, useState } from \"react\";\nimport { EASE_OUT } from \"@/lib/ease\";\nimport { cn } from \"@/lib/utils\";\n\nexport type FileUploadStatus = \"queued\" | \"uploading\" | \"success\" | \"error\";\nexport type FileUploadVariant = \"default\" | \"centered\";\n\nexport type FileUploadItem = {\n id: string;\n name: string;\n size: number;\n type?: string;\n progress?: number;\n status?: FileUploadStatus;\n error?: string;\n file?: File;\n};\n\nexport type FileUploadClassNames = {\n root?: string;\n dropzone?: string;\n queue?: string;\n item?: string;\n leading?: string;\n content?: string;\n name?: string;\n meta?: string;\n progress?: string;\n action?: string;\n};\n\nexport interface FileUploadProps {\n value?: FileUploadItem[];\n defaultValue?: FileUploadItem[];\n onValueChange?: (items: FileUploadItem[]) => void;\n onFilesAdded?: (items: FileUploadItem[], files: File[]) => void;\n onRemove?: (item: FileUploadItem) => void;\n onRetry?: (item: FileUploadItem) => void;\n accept?: string;\n multiple?: boolean;\n maxFiles?: number;\n disabled?: boolean;\n variant?: FileUploadVariant;\n title?: string;\n description?: string;\n browseLabel?: string;\n className?: string;\n classNames?: FileUploadClassNames;\n}\n\nconst ROW_TRANSITION = { duration: 0.22, ease: EASE_OUT } as const;\nconst FAST_TRANSITION = { duration: 0.16, ease: EASE_OUT } as const;\n\nconst STATUS_LABEL: Record = {\n queued: \"Queued\",\n uploading: \"Uploading\",\n success: \"Uploaded\",\n error: \"Failed\",\n};\n\nconst STATUS_TONE: Record = {\n queued: \"text-muted-foreground\",\n uploading: \"text-foreground\",\n success: \"text-emerald-600 dark:text-emerald-400\",\n error: \"text-destructive\",\n};\n\nfunction useControllableUpload({\n value,\n defaultValue,\n onValueChange,\n}: {\n value?: FileUploadItem[];\n defaultValue?: FileUploadItem[];\n onValueChange?: (items: FileUploadItem[]) => void;\n}) {\n const [internalValue, setInternalValue] = useState(defaultValue ?? []);\n const isControlled = value !== undefined;\n const items = value ?? internalValue;\n\n const setItems = useCallback(\n (next: FileUploadItem[]) => {\n if (!isControlled) {\n setInternalValue(next);\n }\n\n onValueChange?.(next);\n },\n [isControlled, onValueChange],\n );\n\n return [items, setItems] as const;\n}\n\nfunction clampProgress(value: number | undefined, status: FileUploadStatus) {\n if (status === \"success\") return 100;\n if (value === undefined || Number.isNaN(value)) return 0;\n return Math.max(0, Math.min(100, value));\n}\n\nfunction formatBytes(bytes: number) {\n if (!Number.isFinite(bytes) || bytes <= 0) return \"0 B\";\n\n const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n const exponent = Math.min(\n Math.floor(Math.log(bytes) / Math.log(1024)),\n units.length - 1,\n );\n const value = bytes / 1024 ** exponent;\n\n return `${value >= 10 || exponent === 0 ? value.toFixed(0) : value.toFixed(1)} ${\n units[exponent]\n }`;\n}\n\nfunction fileKind(item: FileUploadItem) {\n const extension = item.name.includes(\".\")\n ? item.name.split(\".\").pop()\n : undefined;\n\n if (extension) return extension.toUpperCase();\n if (item.type) return item.type.split(\"/\").pop()?.toUpperCase();\n return \"FILE\";\n}\n\nfunction getFileIcon(item: FileUploadItem) {\n const extension = item.name.includes(\".\")\n ? item.name.split(\".\").pop()?.toLowerCase()\n : undefined;\n const type = item.type ?? \"\";\n\n if (type.startsWith(\"image/\")) return FileImage;\n if (type.startsWith(\"video/\")) return FileVideo;\n if (type.startsWith(\"audio/\")) return FileAudio;\n if (\n type.includes(\"zip\") ||\n type.includes(\"compressed\") ||\n [\"zip\", \"rar\", \"7z\", \"tar\", \"gz\"].includes(extension ?? \"\")\n ) {\n return FileArchive;\n }\n if (\n type.includes(\"spreadsheet\") ||\n type.includes(\"excel\") ||\n [\"csv\", \"xls\", \"xlsx\"].includes(extension ?? \"\")\n ) {\n return FileSpreadsheet;\n }\n if (\n type.includes(\"pdf\") ||\n type.startsWith(\"text/\") ||\n [\"pdf\", \"doc\", \"docx\", \"md\", \"txt\"].includes(extension ?? \"\")\n ) {\n return FileText;\n }\n if (\n [\n \"css\",\n \"html\",\n \"js\",\n \"jsx\",\n \"json\",\n \"mdx\",\n \"ts\",\n \"tsx\",\n \"xml\",\n \"yaml\",\n \"yml\",\n ].includes(extension ?? \"\")\n ) {\n return FileCode2;\n }\n\n return FileIcon;\n}\n\nexport function createFileUploadItem(file: File, index = 0): FileUploadItem {\n return {\n id: `${Date.now()}-${index}-${file.name}`,\n name: file.name,\n size: file.size,\n type: file.type,\n progress: 0,\n status: \"uploading\",\n file,\n };\n}\n\nfunction StatusIcon({\n status,\n reduce,\n}: {\n status: FileUploadStatus;\n reduce: boolean;\n}) {\n const iconClassName = \"h-4 w-4\";\n\n return (\n \n \n {status === \"success\" ? (\n \n ) : status === \"error\" ? (\n \n ) : status === \"uploading\" ? (\n \n ) : (\n \n )}\n {STATUS_LABEL[status]}\n \n \n );\n}\n\nfunction FileUploadRow({\n item,\n onRemove,\n onRetry,\n classNames,\n}: {\n item: FileUploadItem;\n onRemove: (item: FileUploadItem) => void;\n onRetry: (item: FileUploadItem) => void;\n classNames?: FileUploadClassNames;\n}) {\n const reduce = useReducedMotion() ?? false;\n const status = item.status ?? \"queued\";\n const progress = clampProgress(item.progress, status);\n const progressRatio = progress / 100;\n const showProgress = status === \"uploading\" || status === \"success\";\n const LeadingIcon = getFileIcon(item);\n\n return (\n \n
\n \n \n
\n\n
\n
\n
\n \n {item.name}\n

\n \n {fileKind(item)} · {formatBytes(item.size)}\n {status === \"error\" && item.error ? ` · ${item.error}` : null}\n

\n
\n\n
\n \n {status === \"error\" ? (\n onRetry(item)}\n aria-label={`Retry ${item.name}`}\n className={cn(\n \"grid h-7 w-7 place-items-center rounded-full text-muted-foreground transition-colors duration-150 hover:bg-muted hover:text-foreground active:scale-95\",\n classNames?.action,\n )}\n >\n \n \n ) : null}\n onRemove(item)}\n aria-label={`Remove ${item.name}`}\n className={cn(\n \"grid h-7 w-7 place-items-center rounded-full text-muted-foreground transition-colors duration-150 hover:bg-muted hover:text-foreground active:scale-95\",\n classNames?.action,\n )}\n >\n \n \n
\n
\n\n {showProgress ? (\n \n \n
\n ) : null}\n \n \n \n );\n}\n\nexport function FileUpload({\n value,\n defaultValue,\n onValueChange,\n onFilesAdded,\n onRemove,\n onRetry,\n accept,\n multiple = true,\n maxFiles,\n disabled = false,\n variant = \"default\",\n title = \"Drop files here\",\n description = \"Add files to the upload queue\",\n browseLabel = \"Browse\",\n className,\n classNames,\n}: FileUploadProps) {\n const inputId = useId();\n const inputRef = useRef(null);\n const dragDepthRef = useRef(0);\n const reduce = useReducedMotion() ?? false;\n const [items, setItems] = useControllableUpload({\n value,\n defaultValue,\n onValueChange,\n });\n const [dragging, setDragging] = useState(false);\n\n const commit = useCallback(\n (next: FileUploadItem[]) => {\n setItems(next);\n },\n [setItems],\n );\n\n const addFiles = useCallback(\n (incomingFiles: File[]) => {\n if (disabled || incomingFiles.length === 0) return;\n\n const remainingSlots =\n maxFiles === undefined ? incomingFiles.length : maxFiles - items.length;\n if (remainingSlots <= 0) return;\n\n const files = incomingFiles.slice(\n 0,\n multiple ? remainingSlots : Math.min(1, remainingSlots),\n );\n const added = files.map((file, index) => createFileUploadItem(file, index));\n\n if (added.length === 0) return;\n\n commit([...items, ...added]);\n onFilesAdded?.(added, files);\n },\n [commit, disabled, items, maxFiles, multiple, onFilesAdded],\n );\n\n const removeItem = useCallback(\n (item: FileUploadItem) => {\n commit(items.filter((entry) => entry.id !== item.id));\n onRemove?.(item);\n },\n [commit, items, onRemove],\n );\n\n const retryItem = useCallback(\n (item: FileUploadItem) => {\n const retryingItem = {\n ...item,\n error: undefined,\n progress: 0,\n status: \"uploading\" as const,\n };\n\n commit(\n items.map((entry) => (entry.id === item.id ? retryingItem : entry)),\n );\n onRetry?.(retryingItem);\n },\n [commit, items, onRetry],\n );\n\n const resetDrag = useCallback(() => {\n dragDepthRef.current = 0;\n setDragging(false);\n }, []);\n\n const maxReached = maxFiles !== undefined && items.length >= maxFiles;\n const centered = variant === \"centered\";\n\n return (\n
\n {\n addFiles(Array.from(event.currentTarget.files ?? []));\n event.currentTarget.value = \"\";\n }}\n />\n\n inputRef.current?.click()}\n onDragEnter={(event) => {\n if (disabled || maxReached) return;\n event.preventDefault();\n dragDepthRef.current += 1;\n setDragging(true);\n }}\n onDragOver={(event) => {\n if (disabled || maxReached) return;\n event.preventDefault();\n event.dataTransfer.dropEffect = \"copy\";\n setDragging(true);\n }}\n onDragLeave={(event) => {\n if (disabled || maxReached) return;\n event.preventDefault();\n dragDepthRef.current = Math.max(0, dragDepthRef.current - 1);\n if (dragDepthRef.current === 0) setDragging(false);\n }}\n onDrop={(event) => {\n if (disabled || maxReached) return;\n event.preventDefault();\n resetDrag();\n addFiles(Array.from(event.dataTransfer.files));\n }}\n className={cn(\n \"group relative flex w-full overflow-hidden rounded-3xl border border-dashed border-border bg-background outline-none\",\n \"transition-[border-color,transform] duration-200 active:scale-[0.99]\",\n \"hover:border-foreground/40 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background\",\n \"data-[dragging=true]:border-foreground\",\n \"disabled:pointer-events-none disabled:opacity-55\",\n centered\n ? \"min-h-56 flex-col items-center justify-center gap-3 p-7 text-center\"\n : \"items-center gap-4 p-5 text-left\",\n classNames?.dropzone,\n )}\n >\n \n \n \n\n \n \n {maxReached ? \"Upload limit reached\" : title}\n \n \n {maxReached\n ? `${items.length} of ${maxFiles} files added`\n : description}\n \n \n\n \n {browseLabel}\n \n \n\n
    \n \n {items.map((item) => (\n \n ))}\n \n
\n
\n );\n}\n"},{"path":"components/motion/attachment-upload.tsx","type":"component","content":"\"use client\";\n// beui.dev/components/blocks/file-upload\n\nimport {\n AlertCircle,\n Check,\n ExternalLink,\n FileImage,\n Link as LinkIcon,\n LoaderCircle,\n Mic,\n Paperclip,\n Pause,\n Play,\n RotateCcw,\n Upload,\n X,\n} from \"lucide-react\";\nimport {\n AnimatePresence,\n LayoutGroup,\n motion,\n useReducedMotion,\n} from \"motion/react\";\nimport {\n useCallback,\n useEffect,\n useId,\n useRef,\n useState,\n} from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { Tooltip } from \"@/components/motion/tooltip\";\nimport {\n EASE_OUT,\n SPRING_LAYOUT,\n SPRING_PRESS,\n} from \"@/lib/ease\";\nimport { cn } from \"@/lib/utils\";\n\nexport type AttachmentUploadKind = \"file\" | \"link\" | \"image\" | \"audio\";\nexport type AttachmentRejectReason = \"too-large\" | \"max-files\";\nexport type AttachmentUploadStatus =\n | \"idle\"\n | \"uploading\"\n | \"complete\"\n | \"failed\";\n\nexport type AttachmentUploadItem = {\n id: string;\n name: string;\n kind: AttachmentUploadKind;\n size?: number;\n href?: string;\n previewUrl?: string;\n currentTime?: number;\n duration?: number;\n status?: AttachmentUploadStatus;\n error?: string;\n file?: File;\n};\n\nexport type AttachmentUploadClassNames = {\n dropzone?: string;\n list?: string;\n row?: string;\n};\n\nexport interface AttachmentUploadProps {\n value?: AttachmentUploadItem[];\n defaultValue?: AttachmentUploadItem[];\n onValueChange?: (items: AttachmentUploadItem[]) => void;\n onFilesAdded?: (items: AttachmentUploadItem[], files: File[]) => void;\n onFilesRejected?: (files: File[], reason: AttachmentRejectReason) => void;\n onRemove?: (item: AttachmentUploadItem) => void;\n onRetry?: (item: AttachmentUploadItem) => void;\n playingId?: string;\n onAudioToggle?: (item: AttachmentUploadItem) => void;\n accept?: string;\n multiple?: boolean;\n maxFiles?: number;\n maxFileSize?: number;\n disabled?: boolean;\n title?: string;\n description?: string;\n attachmentsLabel?: string;\n className?: string;\n classNames?: AttachmentUploadClassNames;\n}\n\nconst ITEM_TRANSITION = { duration: 0.2, ease: EASE_OUT } as const;\nconst DEFAULT_MAX_FILE_SIZE = 500 * 1024 * 1024;\nconst UPLOAD_PROGRESS_MS = 900;\nconst UPLOAD_COMPLETE_HOLD_MS = 1000;\nconst REMOVE_PENDING_MS = 420;\n\nconst WAVEFORM_BARS = [\n 18, 31, 24, 39, 30, 43, 27, 18, 9, 29, 38, 24, 34, 18, 26, 37, 21, 14,\n 7, 11, 22, 35, 18, 26, 41, 29, 17, 33,\n].map((height, index) => ({ id: `wave-${index}-${height}`, height }));\n\nfunction useControllableList({\n value,\n defaultValue,\n onValueChange,\n}: {\n value?: T[];\n defaultValue?: T[];\n onValueChange?: (items: T[]) => void;\n}) {\n const [internalValue, setInternalValue] = useState(defaultValue ?? []);\n const controlled = value !== undefined;\n const items = value ?? internalValue;\n\n const setItems = useCallback(\n (next: T[]) => {\n if (!controlled) setInternalValue(next);\n onValueChange?.(next);\n },\n [controlled, onValueChange],\n );\n\n return [items, setItems] as const;\n}\n\nfunction formatBytes(bytes: number | undefined) {\n if (bytes === undefined || !Number.isFinite(bytes) || bytes <= 0) {\n return null;\n }\n\n const units = [\"B\", \"KB\", \"MB\", \"GB\"];\n const exponent = Math.min(\n Math.floor(Math.log(bytes) / Math.log(1024)),\n units.length - 1,\n );\n const value = bytes / 1024 ** exponent;\n\n return `${value >= 10 || exponent === 0 ? value.toFixed(0) : value.toFixed(1)} ${units[exponent]}`;\n}\n\nfunction formatDuration(seconds: number | undefined) {\n const safeSeconds = Math.max(0, Math.round(seconds ?? 0));\n const minutes = Math.floor(safeSeconds / 60);\n return `${minutes}:${String(safeSeconds % 60).padStart(2, \"0\")}`;\n}\n\nfunction formatMaxSize(bytes: number) {\n const megabytes = bytes / (1024 * 1024);\n return `${Number.isInteger(megabytes) ? megabytes : megabytes.toFixed(1)} MB`;\n}\n\nfunction inferKind(file: File): AttachmentUploadKind {\n if (file.type.startsWith(\"image/\")) return \"image\";\n if (file.type.startsWith(\"audio/\")) return \"audio\";\n return \"file\";\n}\n\nfunction AttachmentIcon({ kind }: { kind: AttachmentUploadKind }) {\n if (kind === \"link\") return ;\n if (kind === \"image\") return ;\n if (kind === \"audio\") return ;\n return ;\n}\n\nfunction imageSource(item: AttachmentUploadItem) {\n if (item.kind !== \"image\") return undefined;\n return item.previewUrl ?? item.href;\n}\n\ntype RowActionState =\n | \"idle\"\n | \"uploading\"\n | \"complete\"\n | \"failed\"\n | \"removing\";\n\nfunction RowAction({\n label,\n onClick,\n state,\n retryable = false,\n reduce = false,\n}: {\n label: string;\n onClick: () => void;\n state: RowActionState;\n retryable?: boolean;\n reduce?: boolean;\n}) {\n if (state === \"uploading\") {\n return ;\n }\n\n if (state === \"complete\") {\n return (\n \n \n \n \n \n );\n }\n\n if (state === \"removing\") {\n return (\n \n \n \n \n \n \n \n );\n }\n\n if (state === \"failed\") {\n if (!retryable) {\n return (\n \n \n \n \n \n );\n }\n\n return (\n \n \n \n \n \n );\n }\n\n return (\n \n \n \n \n \n );\n}\n\nfunction ImageThumbnail({\n item,\n layoutId,\n onPreview,\n reduce,\n}: {\n item: AttachmentUploadItem;\n layoutId?: string;\n onPreview: (item: AttachmentUploadItem) => void;\n reduce: boolean;\n}) {\n const src = imageSource(item);\n\n if (!src) {\n return (\n \n \n \n );\n }\n\n return (\n \n {/* biome-ignore lint/performance/noImgElement: Blob and remote previews keep this registry component framework-agnostic. */}\n \n \n Click to preview\n \n \n }\n >\n {\n event.currentTarget.blur();\n onPreview(item);\n }}\n whileTap={reduce ? undefined : { scale: 0.94 }}\n transition={SPRING_PRESS}\n className=\"group/image relative size-9 shrink-0 overflow-hidden rounded-[10px] bg-muted outline-none ring-1 ring-border/70 focus-visible:ring-2 focus-visible:ring-ring\"\n >\n {/* biome-ignore lint/performance/noImgElement: Motion layout requires the image element and portable blob URLs. */}\n \n \n \n );\n}\n\nfunction ImagePreviewDialog({\n item,\n layoutId,\n onClose,\n reduce,\n}: {\n item: AttachmentUploadItem | null;\n layoutId?: string;\n onClose: () => void;\n reduce: boolean;\n}) {\n const closeRef = useRef(null);\n\n useEffect(() => {\n if (!item) return;\n\n const previousFocus =\n document.activeElement instanceof HTMLElement\n ? document.activeElement\n : null;\n const previousOverflow = document.body.style.overflow;\n document.body.style.overflow = \"hidden\";\n closeRef.current?.focus();\n\n const handleKeyDown = (event: KeyboardEvent) => {\n if (event.key === \"Escape\") onClose();\n if (event.key === \"Tab\") {\n event.preventDefault();\n closeRef.current?.focus();\n }\n };\n document.addEventListener(\"keydown\", handleKeyDown);\n\n return () => {\n document.removeEventListener(\"keydown\", handleKeyDown);\n document.body.style.overflow = previousOverflow;\n previousFocus?.focus();\n };\n }, [item, onClose]);\n\n if (typeof document === \"undefined\") return null;\n\n const src = item ? imageSource(item) : undefined;\n const content =\n item && src ? (\n
\n \n\n
\n \n {/* biome-ignore lint/performance/noImgElement: Motion layout requires the image element and portable blob URLs. */}\n \n \n \n \n \n
\n
\n ) : null;\n\n return createPortal(\n reduce ? content : {content},\n document.body,\n );\n}\n\nfunction AttachmentRow({\n item,\n playing,\n uploading,\n uploadComplete,\n failed,\n removing,\n arrivalIndex,\n imageLayoutId,\n onAudioToggle,\n onImagePreview,\n onRemove,\n onRetry,\n reduce,\n className,\n}: {\n item: AttachmentUploadItem;\n playing: boolean;\n uploading: boolean;\n uploadComplete: boolean;\n failed: boolean;\n removing: boolean;\n arrivalIndex: number;\n imageLayoutId?: string;\n onAudioToggle?: (item: AttachmentUploadItem) => void;\n onImagePreview: (item: AttachmentUploadItem) => void;\n onRemove: (item: AttachmentUploadItem) => void;\n onRetry?: (item: AttachmentUploadItem) => void;\n reduce: boolean;\n className?: string;\n}) {\n const size = formatBytes(item.size);\n const progress =\n item.duration && item.duration > 0\n ? Math.min(1, Math.max(0, (item.currentTime ?? 0) / item.duration))\n : 0;\n const actionState: RowActionState = removing\n ? \"removing\"\n : uploading\n ? \"uploading\"\n : uploadComplete\n ? \"complete\"\n : failed\n ? \"failed\"\n : \"idle\";\n const arrivalDelay = Math.min(Math.max(arrivalIndex, 0), 5) * 0.055;\n const rowTransition =\n !reduce && arrivalIndex >= 0\n ? {\n ...SPRING_LAYOUT,\n delay: arrivalDelay,\n opacity: {\n duration: 0.16,\n ease: EASE_OUT,\n delay: arrivalDelay,\n },\n }\n : ITEM_TRANSITION;\n const showUploadProgress = uploading || uploadComplete;\n const uploadProgress = (\n \n );\n\n return (\n = 0\n ? { opacity: 0, y: -16, scale: 0.985 }\n : { opacity: 0, y: 6 }\n }\n animate={{ opacity: 1, y: 0, scale: 1 }}\n exit={reduce ? undefined : { opacity: 0, y: -4 }}\n transition={rowTransition}\n className={cn(\n \"flex min-h-14 items-center gap-1 rounded-2xl bg-muted/70 p-1\",\n className,\n )}\n >\n
\n {failed ? (\n \n ) : null}\n\n {item.kind === \"image\" ? (\n \n ) : (\n \n \n \n )}\n\n {item.kind === \"audio\" ? (\n <>\n \n {formatDuration(item.currentTime)}\n \n \n {WAVEFORM_BARS.map((bar, index) => (\n \n ))}\n \n \n {formatDuration(item.duration)}\n \n onAudioToggle?.(item)}\n whileTap={{ scale: 0.94 }}\n transition={SPRING_PRESS}\n className=\"grid size-9 shrink-0 place-items-center rounded-full bg-foreground text-background outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background\"\n >\n \n \n {playing ? (\n \n ) : (\n \n )}\n \n \n \n \n ) : (\n <>\n \n \n {item.name}\n \n {failed ? (\n \n {item.error ?? \"Upload failed\"}\n \n ) : null}\n \n \n {item.kind === \"link\" ? \"Web\" : size}\n \n {item.kind === \"link\" && item.href ? (\n \n \n \n ) : null}\n \n )}\n\n {reduce ? (\n showUploadProgress ? (\n uploadProgress\n ) : null\n ) : (\n \n {showUploadProgress ? uploadProgress : null}\n \n )}\n
\n\n {\n if (actionState === \"failed\") {\n onRetry?.(item);\n return;\n }\n onRemove(item);\n }}\n state={actionState}\n retryable={onRetry !== undefined}\n reduce={reduce}\n />\n \n );\n}\n\nexport function AttachmentUpload({\n value,\n defaultValue,\n onValueChange,\n onFilesAdded,\n onFilesRejected,\n onRemove,\n onRetry,\n playingId,\n onAudioToggle,\n accept,\n multiple = true,\n maxFiles = 12,\n maxFileSize = DEFAULT_MAX_FILE_SIZE,\n disabled = false,\n title = \"Drag and drop or browse files\",\n description,\n attachmentsLabel = \"Attachments\",\n className,\n classNames,\n}: AttachmentUploadProps) {\n const inputId = useId();\n const inputRef = useRef(null);\n const dragDepthRef = useRef(0);\n const ownedUrlsRef = useRef(new Set());\n const lifecycleTimersRef = useRef(\n new Set>(),\n );\n const reduce = useReducedMotion() ?? false;\n const [dragging, setDragging] = useState(false);\n const [previewItem, setPreviewItem] =\n useState(null);\n const [uploadingIds, setUploadingIds] = useState>(\n () => new Set(),\n );\n const [uploadCompleteIds, setUploadCompleteIds] = useState>(\n () => new Set(),\n );\n const [removingIds, setRemovingIds] = useState>(\n () => new Set(),\n );\n const [items, setItems] = useControllableList({\n value,\n defaultValue,\n onValueChange,\n });\n const itemsRef = useRef(items);\n itemsRef.current = items;\n\n useEffect(\n () => () => {\n for (const url of ownedUrlsRef.current) URL.revokeObjectURL(url);\n ownedUrlsRef.current.clear();\n for (const timer of lifecycleTimersRef.current) {\n clearTimeout(timer);\n }\n lifecycleTimersRef.current.clear();\n },\n [],\n );\n\n const maxReached = items.length >= maxFiles;\n const scheduleLifecycle = useCallback(\n (callback: () => void, delay: number) => {\n const timer = setTimeout(() => {\n lifecycleTimersRef.current.delete(timer);\n callback();\n }, delay);\n lifecycleTimersRef.current.add(timer);\n },\n [],\n );\n\n const addFiles = useCallback(\n (incomingFiles: File[]) => {\n if (disabled || incomingFiles.length === 0) return;\n\n const availableSlots = Math.max(0, maxFiles - items.length);\n if (availableSlots === 0) {\n onFilesRejected?.(incomingFiles, \"max-files\");\n return;\n }\n\n const selectedFiles = incomingFiles.slice(\n 0,\n multiple ? availableSlots : Math.min(1, availableSlots),\n );\n const oversized = selectedFiles.filter(\n (file) => file.size > maxFileSize,\n );\n const accepted = selectedFiles.filter(\n (file) => file.size <= maxFileSize,\n );\n\n if (oversized.length > 0) onFilesRejected?.(oversized, \"too-large\");\n if (incomingFiles.length > selectedFiles.length) {\n onFilesRejected?.(incomingFiles.slice(selectedFiles.length), \"max-files\");\n }\n\n const added = accepted.map((file, index) => {\n const kind = inferKind(file);\n const objectUrl = URL.createObjectURL(file);\n ownedUrlsRef.current.add(objectUrl);\n\n return {\n id: `${Date.now()}-${index}-${file.name}`,\n name: file.name,\n kind,\n size: file.size,\n previewUrl: kind === \"image\" ? objectUrl : undefined,\n href: objectUrl,\n currentTime: kind === \"audio\" ? 0 : undefined,\n duration: kind === \"audio\" ? 0 : undefined,\n file,\n };\n });\n\n if (added.length === 0) return;\n setItems([...items, ...added]);\n const addedIds = added.map((item) => item.id);\n setUploadingIds((current) => new Set([...current, ...addedIds]));\n scheduleLifecycle(\n () => {\n setUploadingIds((current) => {\n const next = new Set(current);\n for (const id of addedIds) next.delete(id);\n return next;\n });\n setUploadCompleteIds(\n (current) => new Set([...current, ...addedIds]),\n );\n scheduleLifecycle(() => {\n setUploadCompleteIds((current) => {\n const next = new Set(current);\n for (const id of addedIds) next.delete(id);\n return next;\n });\n }, UPLOAD_COMPLETE_HOLD_MS);\n },\n reduce ? 140 : UPLOAD_PROGRESS_MS,\n );\n onFilesAdded?.(added, accepted);\n },\n [\n disabled,\n items,\n maxFileSize,\n maxFiles,\n multiple,\n onFilesAdded,\n onFilesRejected,\n reduce,\n scheduleLifecycle,\n setItems,\n ],\n );\n\n const finalizeRemove = useCallback(\n (item: AttachmentUploadItem) => {\n const ownedUrl = [item.previewUrl, item.href].find(\n (url): url is string =>\n url !== undefined && ownedUrlsRef.current.has(url),\n );\n if (ownedUrl) {\n URL.revokeObjectURL(ownedUrl);\n ownedUrlsRef.current.delete(ownedUrl);\n }\n setPreviewItem((current) =>\n current?.id === item.id ? null : current,\n );\n setUploadingIds((current) => {\n const next = new Set(current);\n next.delete(item.id);\n return next;\n });\n setUploadCompleteIds((current) => {\n const next = new Set(current);\n next.delete(item.id);\n return next;\n });\n setItems(itemsRef.current.filter((entry) => entry.id !== item.id));\n onRemove?.(item);\n },\n [onRemove, setItems],\n );\n\n const requestRemove = useCallback(\n (item: AttachmentUploadItem) => {\n if (removingIds.has(item.id)) return;\n\n setRemovingIds((current) => new Set(current).add(item.id));\n scheduleLifecycle(\n () => {\n finalizeRemove(item);\n setRemovingIds((current) => {\n const next = new Set(current);\n next.delete(item.id);\n return next;\n });\n },\n reduce ? 140 : REMOVE_PENDING_MS,\n );\n },\n [\n finalizeRemove,\n reduce,\n removingIds,\n scheduleLifecycle,\n ],\n );\n\n const resetDrag = useCallback(() => {\n dragDepthRef.current = 0;\n setDragging(false);\n }, []);\n const closePreview = useCallback(() => setPreviewItem(null), []);\n\n useEffect(() => {\n if (\n previewItem &&\n !items.some((item) => item.id === previewItem.id)\n ) {\n setPreviewItem(null);\n }\n }, [items, previewItem]);\n\n const uploadOrder = Array.from(uploadingIds);\n const previewLayoutId = previewItem\n ? `attachment-image-${previewItem.id}`\n : undefined;\n\n return (\n \n
\n {\n addFiles(Array.from(event.currentTarget.files ?? []));\n event.currentTarget.value = \"\";\n }}\n />\n\n inputRef.current?.click()}\n onDragEnter={(event) => {\n if (disabled || maxReached) return;\n event.preventDefault();\n dragDepthRef.current += 1;\n setDragging(true);\n }}\n onDragOver={(event) => {\n if (disabled || maxReached) return;\n event.preventDefault();\n event.dataTransfer.dropEffect = \"copy\";\n setDragging(true);\n }}\n onDragLeave={(event) => {\n if (disabled || maxReached) return;\n event.preventDefault();\n dragDepthRef.current = Math.max(0, dragDepthRef.current - 1);\n if (dragDepthRef.current === 0) setDragging(false);\n }}\n onDrop={(event) => {\n if (disabled || maxReached) return;\n event.preventDefault();\n resetDrag();\n addFiles(Array.from(event.dataTransfer.files));\n }}\n className={cn(\n \"group relative isolate flex min-h-52 w-full flex-col items-center justify-center overflow-hidden rounded-[2rem] bg-muted/65 p-2 text-center outline-none\",\n \"transition-colors duration-200 hover:bg-muted/85\",\n \"focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background\",\n \"data-[dragging=true]:bg-muted\",\n \"disabled:pointer-events-none disabled:opacity-55\",\n classNames?.dropzone,\n )}\n >\n \n \n \n \n \n {maxReached ? \"Attachment limit reached\" : title}\n \n \n {maxReached\n ? `${items.length} of ${maxFiles} attachments added`\n : description ?? `Maximum ${formatMaxSize(maxFileSize)} file size`}\n \n \n\n {items.length > 0 ? (\n
\n \n {attachmentsLabel}\n \n\n {items.length > 0 ? (\n
    \n 0}>\n {items.map((item) => (\n \n ))}\n \n
\n ) : null}\n
\n ) : null}\n\n \n
\n \n );\n}\n"},{"path":"lib/ease.ts","type":"util","content":"// Shared motion tokens. Easing curves mirror the CSS custom properties in\n// globals.css; springs are the canonical physics used across components.\n// Strong custom variants — defaults like `ease-in`/`ease-out` feel weak.\n\nexport const EASE_OUT = [0.16, 1, 0.3, 1] as const;\nexport const EASE_IN_OUT = [0.77, 0, 0.175, 1] as const;\nexport const EASE_DRAWER = [0.32, 0.72, 0, 1] as const;\n\n/** CSS string form of EASE_OUT for inline style transitions. */\nexport const EASE_OUT_CSS = \"cubic-bezier(0.16, 1, 0.3, 1)\";\n\n/** Press feedback on buttons and other tappable surfaces. */\nexport const SPRING_PRESS = {\n type: \"spring\",\n stiffness: 500,\n damping: 30,\n mass: 0.6,\n} as const;\n\n/** Content swaps — label/icon slots trading places inside a control. */\nexport const SPRING_SWAP = {\n type: \"spring\",\n stiffness: 460,\n damping: 30,\n mass: 0.55,\n} as const;\n\n/** Overlay panel entrances — modals and sheets summoned by pointer. */\nexport const SPRING_PANEL = {\n type: \"spring\",\n stiffness: 420,\n damping: 40,\n mass: 0.5,\n} as const;\n\n/** Shared-layout glides — pills, indicators and panels morphing between positions. */\nexport const SPRING_LAYOUT = {\n type: \"spring\",\n stiffness: 360,\n damping: 32,\n mass: 0.6,\n} as const;\n\n/** Cursor-follow physics for decorative mouse tracking (magnetic, tilt, dock). */\nexport const SPRING_MOUSE = {\n stiffness: 200,\n damping: 15,\n mass: 0.3,\n} as const;\n\n/** Dragged handles and fills (sliders) — critically damped `useSpring` config,\n * so the value follows the pointer butterily and never rebounds off an end. */\nexport const SPRING_GLIDE = {\n stiffness: 700,\n damping: 50,\n mass: 0.5,\n} as const;\n"},{"path":"lib/utils.ts","type":"util","content":"import { clsx, type ClassValue } from \"clsx\"\nimport { twMerge } from \"tailwind-merge\"\n\nexport function cn(...inputs: ClassValue[]) {\n return twMerge(clsx(inputs))\n}\n"},{"path":"components/motion/tooltip.tsx","type":"util","content":"\"use client\";\n\nimport {\n AnimatePresence,\n motion,\n useReducedMotion,\n type Variants,\n} from \"motion/react\";\nimport {\n cloneElement,\n isValidElement,\n type ReactElement,\n type ReactNode,\n useCallback,\n useEffect,\n useId,\n useMemo,\n useRef,\n useState,\n} from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { EASE_OUT } from \"@/lib/ease\";\nimport { useHoverCapable } from \"@/lib/hooks/use-hover-capable\";\nimport { cn } from \"@/lib/utils\";\n\ntype Side = \"top\" | \"right\" | \"bottom\" | \"left\";\n\nexport interface TooltipProps {\n content: ReactNode;\n children: ReactElement;\n side?: Side;\n /** Delay before showing (ms). Default 120. */\n delay?: number;\n className?: string;\n /** Classes for the outer wrapper span. Use to fix baseline / fill parent. */\n wrapperClassName?: string;\n}\n\n// Gap between trigger and tooltip, in px.\nconst GAP = 8;\n\n// Centering transform for the fixed-positioned anchor point, per side.\nconst anchorTransform: Record = {\n top: \"translate(-50%, -100%)\",\n bottom: \"translate(-50%, 0)\",\n left: \"translate(-100%, -50%)\",\n right: \"translate(0, -50%)\",\n};\n\nconst transformOrigin: Record = {\n top: \"center bottom\",\n bottom: \"center top\",\n left: \"right center\",\n right: \"left center\",\n};\n\n// Offset is in the direction *away* from the trigger — content originates near\n// the trigger and rises into resting position.\nconst offsetFrom: Record = {\n top: { y: 8 },\n bottom: { y: -8 },\n left: { x: 8 },\n right: { x: -8 },\n};\n\nfunction buildVariants(side: Side): Variants {\n const o = offsetFrom[side];\n return {\n initial: {\n opacity: 0,\n scale: 0.9,\n filter: \"blur(5px)\",\n x: o.x ?? 0,\n y: o.y ?? 0,\n },\n animate: {\n opacity: 1,\n scale: 1,\n filter: \"blur(0px)\",\n x: 0,\n y: 0,\n transition: {\n type: \"spring\",\n stiffness: 380,\n damping: 30,\n mass: 0.7,\n opacity: { duration: 0.14, ease: EASE_OUT },\n filter: { duration: 0.18, ease: EASE_OUT },\n },\n },\n exit: {\n opacity: 0,\n scale: 0.94,\n filter: \"blur(3px)\",\n x: (o.x ?? 0) * 0.6,\n y: (o.y ?? 0) * 0.6,\n transition: { duration: 0.12, ease: EASE_OUT },\n },\n };\n}\n\nconst REDUCED_VARIANTS: Variants = {\n initial: { opacity: 0 },\n animate: { opacity: 1, transition: { duration: 0.14, ease: EASE_OUT } },\n exit: { opacity: 0, transition: { duration: 0.1, ease: EASE_OUT } },\n};\n\n// Once any tooltip has just closed, neighbouring tooltips open without the\n// initial delay — moving along a toolbar feels instant after the first one.\nconst WARM_WINDOW_MS = 300;\nlet lastHiddenAt = 0;\n\nexport function Tooltip({\n content,\n children,\n side = \"top\",\n delay = 120,\n className,\n wrapperClassName,\n}: TooltipProps) {\n const [open, setOpen] = useState(false);\n const [coords, setCoords] = useState<{ top: number; left: number } | null>(\n null,\n );\n const id = useId();\n const timer = useRef | null>(null);\n const anchorRef = useRef(null);\n const reduce = useReducedMotion();\n const canHover = useHoverCapable();\n\n // Anchor point in viewport coords, on the edge of the trigger facing `side`.\n // Position:fixed means these viewport coords place the tooltip directly, so\n // it escapes every ancestor's stacking context and overflow.\n const place = useCallback(() => {\n const el = anchorRef.current;\n if (!el) return;\n const r = el.getBoundingClientRect();\n const cx = r.left + r.width / 2;\n const cy = r.top + r.height / 2;\n const point: Record = {\n top: { top: r.top - GAP, left: cx },\n bottom: { top: r.bottom + GAP, left: cx },\n left: { top: cy, left: r.left - GAP },\n right: { top: cy, left: r.right + GAP },\n };\n setCoords(point[side]);\n }, [side]);\n\n const show = useCallback(() => {\n if (!canHover) return;\n if (timer.current) clearTimeout(timer.current);\n const warm = Date.now() - lastHiddenAt < WARM_WINDOW_MS;\n timer.current = setTimeout(\n () => {\n place();\n setOpen(true);\n },\n warm ? 0 : delay,\n );\n }, [canHover, delay, place]);\n\n const hide = useCallback(() => {\n if (timer.current) {\n clearTimeout(timer.current);\n timer.current = null;\n }\n if (open) lastHiddenAt = Date.now();\n setOpen(false);\n }, [open]);\n\n // Keep the tooltip pinned to the trigger while it's open and the page scrolls\n // or resizes (fixed coords are viewport-relative).\n useEffect(() => {\n if (!open) return;\n const onMove = () => place();\n window.addEventListener(\"scroll\", onMove, true);\n window.addEventListener(\"resize\", onMove);\n return () => {\n window.removeEventListener(\"scroll\", onMove, true);\n window.removeEventListener(\"resize\", onMove);\n };\n }, [open, place]);\n\n const variants = useMemo(\n () => (reduce ? REDUCED_VARIANTS : buildVariants(side)),\n [reduce, side],\n );\n\n if (!isValidElement(children)) return children;\n\n const trigger = cloneElement(\n children as ReactElement>,\n {\n onMouseEnter: show,\n onMouseLeave: hide,\n onFocus: show,\n onBlur: hide,\n \"aria-describedby\": id,\n },\n );\n\n return (\n <>\n \n {trigger}\n \n {typeof document !== \"undefined\"\n ? createPortal(\n \n {open && coords ? (\n \n \n {content}\n \n \n ) : null}\n ,\n document.body,\n )\n : null}\n \n );\n}\n"},{"path":"lib/hooks/use-hover-capable.ts","type":"util","content":"\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\n/**\n * Returns true only on devices that have a true hover (mouse / trackpad).\n * Touch devices fire phantom `:hover` on tap that sticks until tap-elsewhere\n * — gate hover-only effects (scale lifts, magnetic pulls) behind this.\n */\nexport function useHoverCapable() {\n const [canHover, setCanHover] = useState(false);\n\n useEffect(() => {\n if (typeof window === \"undefined\" || !window.matchMedia) return;\n const mq = window.matchMedia(\"(hover: hover) and (pointer: fine)\");\n const update = () => setCanHover(mq.matches);\n update();\n mq.addEventListener?.(\"change\", update);\n return () => mq.removeEventListener?.(\"change\", update);\n }, []);\n\n return canHover;\n}\n"},{"path":"components/previews/blocks/file-upload.preview.tsx","type":"preview","content":"\"use client\";\n\nimport { RotateCcw } from \"lucide-react\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n FileUpload,\n type FileUploadItem,\n type FileUploadVariant,\n} from \"@/components/motion/file-upload\";\n\nconst initialItems: FileUploadItem[] = [\n {\n id: \"brand-assets\",\n name: \"brand-assets.zip\",\n size: 18_400_000,\n type: \"application/zip\",\n progress: 100,\n status: \"success\",\n },\n {\n id: \"release-video\",\n name: \"release-cut.mov\",\n size: 84_200_000,\n type: \"video/quicktime\",\n progress: 58,\n status: \"uploading\",\n },\n {\n id: \"contracts\",\n name: \"vendor-contract.pdf\",\n size: 2_800_000,\n type: \"application/pdf\",\n progress: 32,\n status: \"error\",\n error: \"Connection lost\",\n },\n];\n\nconst variants: { id: FileUploadVariant; label: string }[] = [\n { id: \"centered\", label: \"Centered\" },\n { id: \"default\", label: \"Row\" },\n];\n\nexport function FileUploadPreview() {\n const [items, setItems] = useState(initialItems);\n const [variant, setVariant] = useState(\"centered\");\n const timersRef = useRef>>(\n new Map(),\n );\n\n const stopUpload = useCallback((id: string) => {\n const timer = timersRef.current.get(id);\n if (!timer) return;\n clearInterval(timer);\n timersRef.current.delete(id);\n }, []);\n\n const startUpload = useCallback(\n (id: string) => {\n stopUpload(id);\n\n const timer = setInterval(() => {\n setItems((current) => {\n const target = current.find((item) => item.id === id);\n if (target?.status !== \"uploading\") {\n stopUpload(id);\n return current;\n }\n\n const nextProgress = Math.min(\n 100,\n (target.progress ?? 0) + 7 + Math.random() * 12,\n );\n\n if (nextProgress >= 100) {\n stopUpload(id);\n }\n\n return current.map((item) =>\n item.id === id\n ? {\n ...item,\n progress: nextProgress,\n status: nextProgress >= 100 ? \"success\" : \"uploading\",\n }\n : item,\n );\n });\n }, 520);\n\n timersRef.current.set(id, timer);\n },\n [stopUpload],\n );\n\n useEffect(() => {\n startUpload(\"release-video\");\n\n return () => {\n for (const timer of timersRef.current.values()) {\n clearInterval(timer);\n }\n timersRef.current.clear();\n };\n }, [startUpload]);\n\n return (\n
\n
\n
\n
\n

\n Upload package\n

\n

\n {items.filter((item) => item.status === \"success\").length} of{\" \"}\n {items.length} files ready\n

\n
\n\n
\n
\n {variants.map((entry) => {\n const selected = entry.id === variant;\n\n return (\n setVariant(entry.id)}\n data-selected={selected}\n className=\"h-7 rounded-full px-3 text-xs font-medium text-muted-foreground transition-[background-color,color,transform] duration-150 hover:text-foreground active:scale-95 data-[selected=true]:bg-background data-[selected=true]:text-foreground\"\n >\n {entry.label}\n \n );\n })}\n
\n\n {\n for (const item of items) {\n stopUpload(item.id);\n }\n setItems(initialItems);\n startUpload(\"release-video\");\n }}\n className=\"grid h-9 w-9 place-items-center rounded-full border border-border text-muted-foreground transition-colors hover:text-foreground active:scale-95\"\n aria-label=\"Reset upload queue\"\n >\n \n \n
\n
\n\n {\n for (const item of added) {\n startUpload(item.id);\n }\n }}\n onRetry={(item) => startUpload(item.id)}\n onRemove={(item) => stopUpload(item.id)}\n maxFiles={5}\n title={variant === \"centered\" ? \"Drop files to upload\" : \"Drop release files\"}\n description=\"PDF, images, video or zipped assets\"\n />\n
\n
\n );\n}\n"}]}