Skip to content

armgit / ui

Public Imported from GitHub
0
TypeScript

Add getting started docs to README

Andrew Luobfc449eaee22
diff --git a/README.md b/README.md
index 1ea2ba7..412e7a8 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,33 @@ human review, document splitting, and e-signature flows.
- Documentation: `http://localhost:4000`
- GitHub: [extend-hq/ui](https://github.com/extend-hq/ui)
+## Getting Started
+
+Install a component with the shadcn CLI:
+
+```bash
+npx shadcn@latest add @extend/pdf-viewer
+```
+
+Then render the installed component from your app:
+
+```tsx
+import { PDFViewer } from "@/components/ui/pdf-viewer"
+
+export default function Page() {
+ return <PDFViewer file="/sample.pdf" className="h-[720px]" />
+}
+```
+
+Extend UI components are copied into your project as source, so you can adapt
+them to your app. Shared primitives such as `Button`, `Select`, `Dialog`,
+`ScrollArea`, and `Tooltip` are expected to use the primitives your app already
+has. If your project uses a different alias or design-system path, update the
+generated imports to match, for example changing
+`@/components/ui/button` or `@/components/ui/select` to your local primitive
+paths. You can also set those aliases in `components.json` before installing so
+new components are generated closer to your app structure.
+
## Development
```bash
diff --git a/apps/v4/components/docx-viewer-docs.tsx b/apps/v4/components/docx-viewer-docs.tsx
index 11648ff..4e24a13 100644
--- a/apps/v4/components/docx-viewer-docs.tsx
+++ b/apps/v4/components/docx-viewer-docs.tsx
@@ -59,7 +59,7 @@ export function DocxViewerExample() {
}`
const docxViewerSourceCode =
- '"use client"\n\nimport * as React from "react"\nimport {\n DocxEditorViewer,\n useDocxEditor,\n useDocxViewerThumbnails,\n type DocxDocumentTheme,\n type DocxEditorController,\n} from "@extend-ai/react-docx"\nimport {\n MinusSignCircleIcon,\n Moon02Icon,\n PlusSignCircleIcon,\n SidebarLeftIcon,\n Sun03Icon,\n Upload01Icon,\n} from "@hugeicons/core-free-icons"\nimport { HugeiconsIcon } from "@hugeicons/react"\n\nimport { cn } from "@/lib/utils"\nimport { Button } from "@/components/ui/button"\nimport {\n DocumentViewerThumbnailSidebar,\n useElementWidth,\n useInlineThumbnailSidebar,\n} from "@/components/ui/document-viewer-sidebar"\nimport { FileThumbnail } from "@/components/ui/file-thumbnail"\nimport { ScrollArea } from "@/components/ui/scroll-area"\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from "@/components/ui/select"\nimport { Separator } from "@/components/ui/separator"\nimport { Spinner } from "@/components/ui/spinner"\nimport {\n Tooltip,\n TooltipContent,\n TooltipProvider,\n TooltipTrigger,\n} from "@/components/ui/tooltip"\n\nconst DOCX_MIME_TYPE =\n "application/vnd.openxmlformats-officedocument.wordprocessingml.document"\nconst DOCX_LOADING_INDICATOR_DELAY_MS = 300\nconst DOCX_THUMBNAIL_WIDTH = 92\nconst ZOOM_OPTIONS = [10, 25, 50, 75, 100, 125, 150, 175, 200, 400] as const\nconst DOCX_PADDING_WARNING_TEXT = "a style property during rerender"\n\ntype UploadedDocxFile = {\n file: File\n identity: string\n}\n\nasync function loadDocxFile(\n url: string,\n displayFileName: string\n): Promise<File> {\n const response = await fetch(url)\n if (!response.ok) {\n throw new Error(`Failed to fetch DOCX (${response.status})`)\n }\n\n const blob = await response.blob()\n return new File([blob], displayFileName, {\n type: blob.type || DOCX_MIME_TYPE,\n })\n}\n\nfunction formatDocumentName(fileName: string | undefined, url: string) {\n if (fileName?.trim()) return fileName\n\n const pathname = url.split("?")[0] ?? ""\n const rawName = pathname.split("/").pop() ?? "document.docx"\n\n try {\n return decodeURIComponent(rawName)\n } catch {\n return rawName\n }\n}\n\nfunction getNextZoomScale(currentZoomScale: number, direction: 1 | -1) {\n const currentIndex = ZOOM_OPTIONS.indexOf(\n currentZoomScale as (typeof ZOOM_OPTIONS)[number]\n )\n let fallbackIndex = -1\n\n if (direction > 0) {\n fallbackIndex = ZOOM_OPTIONS.findIndex((value) => value > currentZoomScale)\n } else {\n for (let index = ZOOM_OPTIONS.length - 1; index >= 0; index -= 1) {\n if (ZOOM_OPTIONS[index] < currentZoomScale) {\n fallbackIndex = index\n break\n }\n }\n }\n\n const resolvedIndex = currentIndex >= 0 ? currentIndex : fallbackIndex\n if (resolvedIndex < 0) return currentZoomScale\n\n const nextIndex = Math.min(\n Math.max(resolvedIndex + direction, 0),\n ZOOM_OPTIONS.length - 1\n )\n\n return ZOOM_OPTIONS[nextIndex] ?? currentZoomScale\n}\n\nfunction useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {\n const [showSpinner, setShowSpinner] = React.useState(false)\n\n React.useEffect(() => {\n if (!isLoading) {\n setShowSpinner(false)\n return\n }\n\n const timeoutId = window.setTimeout(() => {\n setShowSpinner(true)\n }, delayMs)\n\n return () => window.clearTimeout(timeoutId)\n }, [delayMs, isLoading])\n\n return showSpinner\n}\n\nfunction useControllableDarkMode({\n defaultIsDark = false,\n isDark,\n onIsDarkChange,\n}: {\n defaultIsDark?: boolean\n isDark?: boolean\n onIsDarkChange?: (isDark: boolean) => void\n}) {\n const [uncontrolledIsDark, setUncontrolledIsDark] =\n React.useState(defaultIsDark)\n const resolvedIsDark = isDark ?? uncontrolledIsDark\n\n const setIsDark = React.useCallback(\n (nextIsDark: boolean) => {\n if (isDark === undefined) {\n setUncontrolledIsDark(nextIsDark)\n }\n\n onIsDarkChange?.(nextIsDark)\n },\n [isDark, onIsDarkChange]\n )\n\n return [resolvedIsDark, setIsDark] as const\n}\n\nfunction isDocxPaddingWarning(args: unknown[]) {\n return (\n typeof args[0] === "string" &&\n args[0].includes(DOCX_PADDING_WARNING_TEXT) &&\n args.some((arg) => String(arg).includes("padding"))\n )\n}\n\nfunction useSuppressDocxPaddingWarning(enabled: boolean) {\n React.useEffect(() => {\n if (!enabled) return\n\n const originalConsoleError = console.error\n\n console.error = (...args: unknown[]) => {\n if (isDocxPaddingWarning(args)) return\n originalConsoleError(...args)\n }\n\n return () => {\n console.error = originalConsoleError\n }\n }, [enabled])\n}\n\nfunction ToolbarTooltip({\n label,\n children,\n}: {\n label: string\n children: React.ReactNode\n}) {\n return (\n <Tooltip>\n <TooltipTrigger asChild>\n <span className="inline-flex">{children}</span>\n </TooltipTrigger>\n <TooltipContent side="bottom">{label}</TooltipContent>\n </Tooltip>\n )\n}\n\nfunction ViewerLoadingSurface({\n showSpinner = true,\n}: {\n showSpinner?: boolean\n}) {\n return (\n <div className="grid h-full min-h-52 place-items-center bg-transparent">\n {showSpinner ? <Spinner className="size-4" /> : null}\n </div>\n )\n}\n\nfunction DocxToolbar({\n activePage,\n controlsDisabled,\n isDark,\n onIsDarkChange,\n onToggleSidebar,\n onUploadClick,\n pageCount,\n setZoomScale,\n showNightRenderToggle,\n showUploadButton = true,\n toolbarActions,\n zoomScale,\n}: {\n activePage: number\n controlsDisabled: boolean\n isDark: boolean\n onIsDarkChange: (checked: boolean) => void\n onToggleSidebar: () => void\n onUploadClick: () => void\n pageCount: number\n setZoomScale: React.Dispatch<React.SetStateAction<number>>\n showNightRenderToggle: boolean\n showUploadButton?: boolean\n toolbarActions?: React.ReactNode\n zoomScale: number\n}) {\n const canZoomIn = zoomScale < ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]\n const canZoomOut = zoomScale > ZOOM_OPTIONS[0]\n\n return (\n <div className="flex min-h-12 flex-wrap items-center justify-between gap-2 border-b bg-background px-3 py-2">\n <TooltipProvider>\n <div className="flex min-w-0 flex-wrap items-center gap-2">\n <ToolbarTooltip label="Toggle thumbnails">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Toggle thumbnails"\n disabled={controlsDisabled}\n onClick={onToggleSidebar}\n >\n <HugeiconsIcon icon={SidebarLeftIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n <div className="text-sm whitespace-nowrap text-primary">\n Page {pageCount ? activePage : 1} of {pageCount || "-"}\n </div>\n </div>\n <div className="ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1">\n {showNightRenderToggle ? (\n <ToolbarTooltip\n label={isDark ? "Use light document" : "Use dark document"}\n >\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={controlsDisabled}\n aria-label={isDark ? "Use light document" : "Use dark document"}\n onClick={() => onIsDarkChange(!isDark)}\n >\n <HugeiconsIcon\n icon={isDark ? Sun03Icon : Moon02Icon}\n className="size-4"\n />\n </Button>\n </ToolbarTooltip>\n ) : null}\n <Separator orientation="vertical" className="mx-1 h-4 self-center" />\n <div className="flex flex-none items-center gap-1">\n <ToolbarTooltip label="Zoom out">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={controlsDisabled || !canZoomOut}\n aria-label="Zoom out"\n onClick={() =>\n setZoomScale((currentZoomScale) =>\n getNextZoomScale(currentZoomScale, -1)\n )\n }\n >\n <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n <Select\n value={zoomScale.toString()}\n onValueChange={(value) => setZoomScale(Number(value))}\n disabled={controlsDisabled}\n modal={false}\n >\n <SelectTrigger\n size="sm"\n className="w-[84px] min-w-[84px]"\n aria-label="Zoom level"\n >\n <SelectValue>{Math.round(zoomScale)}%</SelectValue>\n </SelectTrigger>\n <SelectContent align="end" alignItemWithTrigger={false}>\n {ZOOM_OPTIONS.map((value) => (\n <SelectItem key={value} value={value.toString()}>\n {value}%\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n <ToolbarTooltip label="Zoom in">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={controlsDisabled || !canZoomIn}\n aria-label="Zoom in"\n onClick={() =>\n setZoomScale((currentZoomScale) =>\n getNextZoomScale(currentZoomScale, 1)\n )\n }\n >\n <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </div>\n {showUploadButton ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n <ToolbarTooltip label="Upload DOCX">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Upload DOCX"\n onClick={onUploadClick}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </>\n ) : null}\n {toolbarActions ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n {toolbarActions}\n </>\n ) : null}\n </div>\n </TooltipProvider>\n </div>\n )\n}\n\nfunction DocxSidebarThumbnail({\n canvasRef,\n displayFileName,\n hasError,\n isActive,\n isLoading,\n pageNumber,\n pixelHeightPx,\n pixelWidthPx,\n previewAspectRatio,\n}: {\n canvasRef: React.RefCallback<HTMLCanvasElement>\n displayFileName: string\n hasError: boolean\n isActive: boolean\n isLoading: boolean\n pageNumber: number\n pixelHeightPx: number\n pixelWidthPx: number\n previewAspectRatio: number\n}) {\n return (\n <FileThumbnail\n file={{\n name: `${displayFileName} page ${pageNumber}`,\n type: DOCX_MIME_TYPE,\n }}\n previewAspectRatio={previewAspectRatio}\n previewClassName="rounded-md bg-white"\n previewContent={\n <canvas\n ref={canvasRef}\n width={pixelWidthPx}\n height={pixelHeightPx}\n className="!size-full bg-white object-cover object-top"\n />\n }\n isLoading={isLoading}\n hasError={hasError}\n className={cn(\n "w-[92px] rounded-md border-0 shadow-xs ring-0 transition-shadow duration-150",\n isActive && "shadow-sm"\n )}\n />\n )\n}\n\nexport function DocxViewerPreview({\n className,\n defaultThumbnailSidebarOpen = false,\n defaultIsDark = false,\n fileName,\n isDark: controlledIsDark,\n onIsDarkChange,\n rounded = false,\n showToolbar = true,\n showUpload = true,\n src,\n toolbarActions,\n}: {\n className?: string\n defaultThumbnailSidebarOpen?: boolean\n defaultIsDark?: boolean\n fileName?: string\n isDark?: boolean\n onIsDarkChange?: (isDark: boolean) => void\n rounded?: boolean\n showToolbar?: boolean\n showUpload?: boolean\n src?: string\n toolbarActions?: React.ReactNode\n}) {\n const [effectiveIsDark, setIsDark] = useControllableDarkMode({\n defaultIsDark,\n isDark: controlledIsDark,\n onIsDarkChange,\n })\n\n return (\n <DocxViewerContent\n className={className}\n defaultThumbnailSidebarOpen={defaultThumbnailSidebarOpen}\n effectiveIsDark={effectiveIsDark}\n fileName={fileName}\n rounded={rounded}\n setNightRenderEnabled={setIsDark}\n shouldRenderNightMode\n showToolbar={showToolbar}\n showUpload={showUpload}\n toolbarActions={toolbarActions}\n url={src}\n />\n )\n}\n\nfunction DocxViewerContent({\n className,\n defaultThumbnailSidebarOpen,\n effectiveIsDark,\n fileName,\n rounded,\n setNightRenderEnabled,\n shouldRenderNightMode,\n showToolbar = true,\n showUpload,\n toolbarActions,\n url,\n}: {\n className?: string\n defaultThumbnailSidebarOpen: boolean\n effectiveIsDark: boolean\n fileName?: string\n rounded: boolean\n setNightRenderEnabled: (checked: boolean) => void\n shouldRenderNightMode: boolean\n showToolbar?: boolean\n showUpload: boolean\n toolbarActions?: React.ReactNode\n url?: string\n}) {\n const fileInputRef = React.useRef<HTMLInputElement>(null)\n const viewportRef = React.useRef<HTMLDivElement | null>(null)\n const [viewerShellRef, viewerShellWidth] = useElementWidth<HTMLDivElement>()\n const [uploadedDocxFile, setUploadedDocxFile] =\n React.useState<UploadedDocxFile | null>(null)\n const [activePage, setActivePage] = React.useState(1)\n const [sidebarOpen, setSidebarOpen] = React.useState(\n defaultThumbnailSidebarOpen\n )\n const sidebarInline = useInlineThumbnailSidebar(viewerShellWidth)\n const viewerBackgroundColor =\n "color-mix(in oklab, var(--muted) 40%, transparent)"\n const displayFileName = React.useMemo(\n () =>\n uploadedDocxFile?.file.name ??\n (url ? formatDocumentName(fileName, url) : (fileName ?? "document.docx")),\n [fileName, uploadedDocxFile?.file.name, url]\n )\n const [initialDocumentTheme] = React.useState<DocxDocumentTheme>(() =>\n effectiveIsDark ? "dark" : "light"\n )\n const editorOptions = React.useMemo(\n () => ({\n initialDocumentTheme,\n initialFileName: displayFileName,\n }),\n [displayFileName, initialDocumentTheme]\n )\n const editor = useDocxEditor(editorOptions)\n const { importDocxFile, setDocumentTheme, status } = editor\n const [reportedPageCount, setReportedPageCount] = React.useState(0)\n const thumbnailEditor = React.useMemo<DocxEditorController>(\n () => ({\n ...editor,\n totalPages: Math.max(editor.totalPages, reportedPageCount),\n }),\n [editor, reportedPageCount]\n )\n const thumbnailOptions = React.useMemo(\n () => ({\n pixelRatio: 2,\n resolution: {\n maxHeight: DOCX_THUMBNAIL_WIDTH * 1.35,\n maxWidth: DOCX_THUMBNAIL_WIDTH,\n },\n }),\n []\n )\n const { thumbnails } = useDocxViewerThumbnails(\n thumbnailEditor,\n thumbnailOptions\n )\n const [zoomScale, setZoomScale] = React.useState(100)\n const [loadError, setLoadError] = React.useState<string>()\n const [isLoadingDocument, setIsLoadingDocument] = React.useState(true)\n const shouldShowDocumentSpinner = useDelayedLoadingIndicator(\n isLoadingDocument,\n DOCX_LOADING_INDICATOR_DELAY_MS\n )\n const loadingState = (\n <ViewerLoadingSurface showSpinner={shouldShowDocumentSpinner} />\n )\n const hasDocument = Boolean(url || uploadedDocxFile)\n const pageCount =\n hasDocument && !isLoadingDocument && !loadError\n ? Math.max(1, reportedPageCount || editor.totalPages)\n : 0\n const controlsDisabled =\n !hasDocument || isLoadingDocument || Boolean(loadError)\n const handlePageCountChange = React.useCallback((nextPageCount: number) => {\n setReportedPageCount(Math.max(1, Math.round(nextPageCount || 1)))\n }, [])\n\n useSuppressDocxPaddingWarning(!isLoadingDocument && !loadError)\n\n React.useEffect(() => {\n setZoomScale(100)\n setActivePage(1)\n viewportRef.current?.scrollTo({ top: 0, left: 0 })\n }, [url])\n\n React.useEffect(() => {\n setDocumentTheme(effectiveIsDark ? "dark" : "light")\n }, [effectiveIsDark, setDocumentTheme])\n\n React.useEffect(() => {\n if (\n status.startsWith("Failed to load file") ||\n status === "Only .docx files are supported"\n ) {\n setLoadError(status)\n setIsLoadingDocument(false)\n }\n }, [status])\n\n // Imports mutate the shared editor instance; concurrent calls (effect\n // re-runs, StrictMode double-invoke) race inside the parser and surface as\n // bogus "Invalid DOCX ZIP" errors, so every import is chained through here.\n const importQueueRef = React.useRef<Promise<void>>(Promise.resolve())\n\n React.useEffect(() => {\n let isCurrent = true\n\n async function load() {\n // Superseded while queued — let the newest import run instead.\n if (!isCurrent) return\n if (!uploadedDocxFile && !url) {\n setIsLoadingDocument(false)\n setLoadError(undefined)\n setReportedPageCount(0)\n return\n }\n\n setIsLoadingDocument(true)\n setLoadError(undefined)\n setReportedPageCount(0)\n\n try {\n const docxFile =\n uploadedDocxFile?.file ??\n (url ? await loadDocxFile(url, displayFileName) : null)\n if (!docxFile) return\n await importDocxFile(docxFile)\n\n if (isCurrent) {\n setIsLoadingDocument(false)\n setActivePage(1)\n viewportRef.current?.scrollTo({ top: 0, left: 0 })\n }\n } catch (error) {\n if (isCurrent) {\n setLoadError(\n error instanceof Error ? error.message : "Unknown DOCX load error"\n )\n setIsLoadingDocument(false)\n }\n }\n }\n\n importQueueRef.current = importQueueRef.current.then(load)\n\n return () => {\n isCurrent = false\n }\n }, [displayFileName, importDocxFile, uploadedDocxFile, url])\n\n React.useEffect(() => {\n if (url) {\n setUploadedDocxFile(null)\n }\n }, [url])\n\n const updateActivePageFromViewport = React.useCallback(() => {\n const viewport = viewportRef.current\n if (!viewport || !pageCount) return\n\n const viewportRect = viewport.getBoundingClientRect()\n const viewportCenter = viewportRect.top + viewportRect.height / 2\n let closestPage = 1\n let closestDistance = Number.POSITIVE_INFINITY\n\n viewport\n .querySelectorAll<HTMLElement>(\n \'[data-docx-page-wrapper="true"][data-index]\'\n )\n .forEach((page) => {\n const pageIndex = Number(page.dataset.index)\n if (!Number.isFinite(pageIndex)) return\n\n const pageRect = page.getBoundingClientRect()\n const pageCenter = pageRect.top + pageRect.height / 2\n const distance = Math.abs(pageCenter - viewportCenter)\n\n if (distance < closestDistance) {\n closestDistance = distance\n closestPage = pageIndex + 1\n }\n })\n\n setActivePage((currentPage) =>\n currentPage === closestPage ? currentPage : closestPage\n )\n }, [pageCount])\n\n React.useEffect(() => {\n const viewport = viewportRef.current\n if (!viewport || !pageCount) return\n\n let frameId = 0\n const handleScroll = () => {\n window.cancelAnimationFrame(frameId)\n frameId = window.requestAnimationFrame(updateActivePageFromViewport)\n }\n\n frameId = window.requestAnimationFrame(updateActivePageFromViewport)\n viewport.addEventListener("scroll", handleScroll, { passive: true })\n\n return () => {\n window.cancelAnimationFrame(frameId)\n viewport.removeEventListener("scroll", handleScroll)\n }\n }, [pageCount, updateActivePageFromViewport])\n\n const scrollToPage = React.useCallback((pageNumber: number) => {\n const viewport = viewportRef.current\n const targetPageIndex = pageNumber - 1\n const page = viewport?.querySelector<HTMLElement>(\n `[data-docx-page-wrapper="true"][data-index="${targetPageIndex}"]`\n )\n\n setActivePage(pageNumber)\n\n if (!viewport || !page) return\n\n viewport.scrollTo({\n top:\n page.getBoundingClientRect().top -\n viewport.getBoundingClientRect().top +\n viewport.scrollTop -\n 24,\n behavior: "auto",\n })\n }, [])\n\n async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {\n const file = event.target.files?.[0]\n event.target.value = ""\n\n if (!file) return\n\n setZoomScale(100)\n setActivePage(1)\n setReportedPageCount(0)\n setUploadedDocxFile({\n file,\n identity: `${file.name}-${file.size}-${file.lastModified}`,\n })\n }\n\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className\n )}\n >\n <input\n ref={fileInputRef}\n type="file"\n accept=".docx,application/vnd.openxmlformats-officedocument.wordprocessingml.document"\n className="hidden"\n onChange={handleUpload}\n />\n {showToolbar ? (\n <DocxToolbar\n activePage={activePage}\n controlsDisabled={controlsDisabled}\n isDark={effectiveIsDark}\n onIsDarkChange={setNightRenderEnabled}\n onToggleSidebar={() => setSidebarOpen((open) => !open)}\n onUploadClick={() => fileInputRef.current?.click()}\n pageCount={pageCount}\n setZoomScale={setZoomScale}\n showNightRenderToggle={shouldRenderNightMode}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n zoomScale={zoomScale}\n />\n ) : null}\n <div\n ref={viewerShellRef}\n className="relative flex min-h-0 flex-1 overflow-hidden bg-muted/30"\n >\n <DocumentViewerThumbnailSidebar\n inline={sidebarInline}\n open={Boolean(sidebarOpen && (pageCount || isLoadingDocument))}\n >\n <ScrollArea className="h-full" scrollFade>\n <div className="p-4">\n {isLoadingDocument ? (\n <>\n <div className="mx-auto h-28 w-20 overflow-hidden rounded-md bg-background shadow-xs">\n <div className="h-full animate-pulse bg-muted" />\n </div>\n <div className="mx-auto mt-3 h-3 w-10 rounded-full bg-muted" />\n </>\n ) : (\n <div className="flex flex-col items-center gap-3">\n {thumbnails.slice(0, pageCount || 0).map((thumbnail) => (\n <Button\n key={thumbnail.pageIndex}\n type="button"\n variant="ghost"\n size="sm"\n className={cn(\n "!h-auto w-full flex-col items-center gap-2 p-2 text-xs shadow-none hover:bg-sidebar-accent",\n thumbnail.pageNumber === activePage &&\n "bg-sidebar-accent text-foreground",\n thumbnail.pageNumber !== activePage &&\n "text-muted-foreground"\n )}\n onFocus={(event) => event.currentTarget.blur()}\n onClick={() => scrollToPage(thumbnail.pageNumber)}\n >\n <DocxSidebarThumbnail\n canvasRef={thumbnail.canvasRef}\n displayFileName={displayFileName}\n hasError={thumbnail.status === "error"}\n isActive={thumbnail.pageNumber === activePage}\n isLoading={\n !thumbnail.isMounted &&\n thumbnail.status !== "ready" &&\n thumbnail.status !== "error"\n }\n pageNumber={thumbnail.pageNumber}\n pixelHeightPx={thumbnail.pixelHeightPx}\n pixelWidthPx={thumbnail.pixelWidthPx}\n previewAspectRatio={thumbnail.aspectRatio}\n />\n {thumbnail.pageNumber}\n </Button>\n ))}\n </div>\n )}\n </div>\n </ScrollArea>\n </DocumentViewerThumbnailSidebar>\n <ScrollArea\n className={cn("min-h-0 flex-1", rounded && "rounded-b-lg")}\n style={{ backgroundColor: viewerBackgroundColor }}\n viewportClassName="p-4"\n viewportRef={viewportRef}\n >\n {!url && !uploadedDocxFile ? (\n <div className="grid h-full min-h-96 place-items-center p-6 text-center">\n <div className="max-w-md rounded-lg border bg-background p-4 text-sm shadow-xs">\n <div className="font-medium">Upload a DOCX to preview</div>\n <div className="mt-1 text-muted-foreground">\n Pass a DOCX URL with the <code>src</code> prop or upload a\n file.\n </div>\n <Button\n type="button"\n variant="outline"\n size="sm"\n className="mt-4"\n onClick={() => fileInputRef.current?.click()}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n Upload DOCX\n </Button>\n </div>\n </div>\n ) : loadError ? (\n <div className="grid h-full min-h-96 place-items-center p-6 text-center">\n <div className="max-w-md rounded-lg border bg-background p-4 text-sm text-destructive shadow-xs">\n <div className="font-medium">Unable to display DOCX</div>\n <div className="mt-1 text-muted-foreground">{loadError}</div>\n </div>\n </div>\n ) : isLoadingDocument ? (\n loadingState\n ) : (\n <div className="mx-auto flex min-h-full justify-center">\n <div\n className={cn(\n "origin-top",\n effectiveIsDark && "docx-night-reader-shell"\n )}\n style={{ zoom: zoomScale / 100 }}\n >\n <DocxEditorViewer\n editor={editor}\n mode="read-only"\n loadingState={loadingState}\n pageBackgroundColor={effectiveIsDark ? "#0a0a0a" : undefined}\n pageGapBackgroundColor={viewerBackgroundColor}\n pageVirtualization={{ enabled: false }}\n deferInitialPaginationPaint={false}\n onPageCountChange={handlePageCountChange}\n />\n </div>\n </div>\n )}\n </ScrollArea>\n </div>\n </div>\n )\n}\n'
+ '"use client"\n\nimport * as React from "react"\nimport {\n DocxEditorViewer,\n useDocxEditor,\n useDocxViewerThumbnails,\n type DocxDocumentTheme,\n type DocxEditorController,\n} from "@extend-ai/react-docx"\nimport {\n Download01Icon,\n MinusSignCircleIcon,\n Moon02Icon,\n PlusSignCircleIcon,\n SidebarLeftIcon,\n Sun03Icon,\n Upload01Icon,\n} from "@hugeicons/core-free-icons"\nimport { HugeiconsIcon } from "@hugeicons/react"\n\nimport { cn } from "@/lib/utils"\nimport { Button } from "@/components/ui/button"\nimport {\n DocumentViewerThumbnailSidebar,\n useElementWidth,\n useInlineThumbnailSidebar,\n} from "@/components/ui/document-viewer-sidebar"\nimport { FileThumbnail } from "@/components/ui/file-thumbnail"\nimport { ScrollArea } from "@/components/ui/scroll-area"\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from "@/components/ui/select"\nimport { Separator } from "@/components/ui/separator"\nimport { Spinner } from "@/components/ui/spinner"\nimport {\n Tooltip,\n TooltipContent,\n TooltipProvider,\n TooltipTrigger,\n} from "@/components/ui/tooltip"\n\nconst DOCX_MIME_TYPE =\n "application/vnd.openxmlformats-officedocument.wordprocessingml.document"\nconst DOCX_LOADING_INDICATOR_DELAY_MS = 300\nconst DOCX_THUMBNAIL_WIDTH = 92\nconst ZOOM_OPTIONS = [10, 25, 50, 75, 100, 125, 150, 175, 200, 400] as const\nconst DOCX_PADDING_WARNING_TEXT = "a style property during rerender"\n\ntype UploadedDocxFile = {\n file: File\n identity: string\n}\n\nasync function loadDocxFile(\n url: string,\n displayFileName: string\n): Promise<File> {\n const response = await fetch(url)\n if (!response.ok) {\n throw new Error(`Failed to fetch DOCX (${response.status})`)\n }\n\n const blob = await response.blob()\n return new File([blob], displayFileName, {\n type: blob.type || DOCX_MIME_TYPE,\n })\n}\n\nfunction formatDocumentName(fileName: string | undefined, url: string) {\n if (fileName?.trim()) return fileName\n\n const pathname = url.split("?")[0] ?? ""\n const rawName = pathname.split("/").pop() ?? "document.docx"\n\n try {\n return decodeURIComponent(rawName)\n } catch {\n return rawName\n }\n}\n\nfunction ensureDocxExtension(fileName: string) {\n return fileName.toLowerCase().endsWith(".docx")\n ? fileName\n : `${fileName}.docx`\n}\n\nfunction downloadBlob(blob: Blob, fileName: string) {\n const url = URL.createObjectURL(blob)\n const anchor = document.createElement("a")\n\n anchor.href = url\n anchor.download = fileName\n anchor.rel = "noopener"\n document.body.append(anchor)\n anchor.click()\n anchor.remove()\n window.setTimeout(() => URL.revokeObjectURL(url), 0)\n}\n\nasync function downloadDocxFile({\n file,\n fileName,\n url,\n}: {\n file?: File\n fileName: string\n url?: string\n}) {\n if (file) {\n downloadBlob(file, ensureDocxExtension(fileName))\n return\n }\n\n if (!url) return\n\n const response = await fetch(url)\n if (!response.ok) {\n throw new Error(`Failed to download DOCX (${response.status})`)\n }\n\n downloadBlob(await response.blob(), ensureDocxExtension(fileName))\n}\n\nfunction getNextZoomScale(currentZoomScale: number, direction: 1 | -1) {\n const currentIndex = ZOOM_OPTIONS.indexOf(\n currentZoomScale as (typeof ZOOM_OPTIONS)[number]\n )\n let fallbackIndex = -1\n\n if (direction > 0) {\n fallbackIndex = ZOOM_OPTIONS.findIndex((value) => value > currentZoomScale)\n } else {\n for (let index = ZOOM_OPTIONS.length - 1; index >= 0; index -= 1) {\n if (ZOOM_OPTIONS[index] < currentZoomScale) {\n fallbackIndex = index\n break\n }\n }\n }\n\n const resolvedIndex = currentIndex >= 0 ? currentIndex : fallbackIndex\n if (resolvedIndex < 0) return currentZoomScale\n\n const nextIndex = Math.min(\n Math.max(resolvedIndex + direction, 0),\n ZOOM_OPTIONS.length - 1\n )\n\n return ZOOM_OPTIONS[nextIndex] ?? currentZoomScale\n}\n\nfunction useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {\n const [showSpinner, setShowSpinner] = React.useState(false)\n\n React.useEffect(() => {\n if (!isLoading) {\n setShowSpinner(false)\n return\n }\n\n const timeoutId = window.setTimeout(() => {\n setShowSpinner(true)\n }, delayMs)\n\n return () => window.clearTimeout(timeoutId)\n }, [delayMs, isLoading])\n\n return showSpinner\n}\n\nfunction useControllableDarkMode({\n defaultIsDark = false,\n isDark,\n onIsDarkChange,\n}: {\n defaultIsDark?: boolean\n isDark?: boolean\n onIsDarkChange?: (isDark: boolean) => void\n}) {\n const [uncontrolledIsDark, setUncontrolledIsDark] =\n React.useState(defaultIsDark)\n const resolvedIsDark = isDark ?? uncontrolledIsDark\n\n const setIsDark = React.useCallback(\n (nextIsDark: boolean) => {\n if (isDark === undefined) {\n setUncontrolledIsDark(nextIsDark)\n }\n\n onIsDarkChange?.(nextIsDark)\n },\n [isDark, onIsDarkChange]\n )\n\n return [resolvedIsDark, setIsDark] as const\n}\n\nfunction isDocxPaddingWarning(args: unknown[]) {\n return (\n typeof args[0] === "string" &&\n args[0].includes(DOCX_PADDING_WARNING_TEXT) &&\n args.some((arg) => String(arg).includes("padding"))\n )\n}\n\nfunction useSuppressDocxPaddingWarning(enabled: boolean) {\n React.useEffect(() => {\n if (!enabled) return\n\n const originalConsoleError = console.error\n\n console.error = (...args: unknown[]) => {\n if (isDocxPaddingWarning(args)) return\n originalConsoleError(...args)\n }\n\n return () => {\n console.error = originalConsoleError\n }\n }, [enabled])\n}\n\nfunction ToolbarTooltip({\n label,\n children,\n}: {\n label: string\n children: React.ReactNode\n}) {\n return (\n <Tooltip>\n <TooltipTrigger asChild>\n <span className="inline-flex">{children}</span>\n </TooltipTrigger>\n <TooltipContent side="bottom">{label}</TooltipContent>\n </Tooltip>\n )\n}\n\nfunction ViewerLoadingSurface({\n showSpinner = true,\n}: {\n showSpinner?: boolean\n}) {\n return (\n <div className="grid h-full min-h-52 place-items-center bg-transparent">\n {showSpinner ? <Spinner className="size-4" /> : null}\n </div>\n )\n}\n\nfunction DocxToolbar({\n activePage,\n controlsDisabled,\n isDark,\n isPreparingDownload,\n onDownload,\n onIsDarkChange,\n onToggleSidebar,\n onUploadClick,\n pageCount,\n setZoomScale,\n showDownloadButton = true,\n showNightRenderToggle,\n showUploadButton = true,\n toolbarActions,\n zoomScale,\n}: {\n activePage: number\n controlsDisabled: boolean\n isDark: boolean\n isPreparingDownload: boolean\n onDownload: () => void\n onIsDarkChange: (checked: boolean) => void\n onToggleSidebar: () => void\n onUploadClick: () => void\n pageCount: number\n setZoomScale: React.Dispatch<React.SetStateAction<number>>\n showDownloadButton?: boolean\n showNightRenderToggle: boolean\n showUploadButton?: boolean\n toolbarActions?: React.ReactNode\n zoomScale: number\n}) {\n const canZoomIn = zoomScale < ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]\n const canZoomOut = zoomScale > ZOOM_OPTIONS[0]\n\n return (\n <div className="flex min-h-12 flex-wrap items-center justify-between gap-2 border-b bg-background px-3 py-2">\n <TooltipProvider>\n <div className="flex min-w-0 flex-wrap items-center gap-2">\n <ToolbarTooltip label="Toggle thumbnails">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Toggle thumbnails"\n disabled={controlsDisabled}\n onClick={onToggleSidebar}\n >\n <HugeiconsIcon icon={SidebarLeftIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n <div className="text-sm whitespace-nowrap text-primary">\n Page {pageCount ? activePage : 1} of {pageCount || "-"}\n </div>\n </div>\n <div className="ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1">\n {showNightRenderToggle ? (\n <ToolbarTooltip\n label={isDark ? "Use light document" : "Use dark document"}\n >\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={controlsDisabled}\n aria-label={isDark ? "Use light document" : "Use dark document"}\n onClick={() => onIsDarkChange(!isDark)}\n >\n <HugeiconsIcon\n icon={isDark ? Sun03Icon : Moon02Icon}\n className="size-4"\n />\n </Button>\n </ToolbarTooltip>\n ) : null}\n <Separator orientation="vertical" className="mx-1 h-4 self-center" />\n <div className="flex flex-none items-center gap-1">\n <ToolbarTooltip label="Zoom out">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={controlsDisabled || !canZoomOut}\n aria-label="Zoom out"\n onClick={() =>\n setZoomScale((currentZoomScale) =>\n getNextZoomScale(currentZoomScale, -1)\n )\n }\n >\n <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n <Select\n value={zoomScale.toString()}\n onValueChange={(value) => setZoomScale(Number(value))}\n disabled={controlsDisabled}\n modal={false}\n >\n <SelectTrigger\n size="sm"\n className="w-[84px] min-w-[84px]"\n aria-label="Zoom level"\n >\n <SelectValue>{Math.round(zoomScale)}%</SelectValue>\n </SelectTrigger>\n <SelectContent align="end" alignItemWithTrigger={false}>\n {ZOOM_OPTIONS.map((value) => (\n <SelectItem key={value} value={value.toString()}>\n {value}%\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n <ToolbarTooltip label="Zoom in">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={controlsDisabled || !canZoomIn}\n aria-label="Zoom in"\n onClick={() =>\n setZoomScale((currentZoomScale) =>\n getNextZoomScale(currentZoomScale, 1)\n )\n }\n >\n <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </div>\n {showDownloadButton ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n <ToolbarTooltip label="Download DOCX">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Download DOCX"\n disabled={controlsDisabled || isPreparingDownload}\n onClick={onDownload}\n >\n {isPreparingDownload ? (\n <Spinner className="size-4" />\n ) : (\n <HugeiconsIcon icon={Download01Icon} className="size-4" />\n )}\n </Button>\n </ToolbarTooltip>\n </>\n ) : null}\n {showUploadButton ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n <ToolbarTooltip label="Upload DOCX">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Upload DOCX"\n onClick={onUploadClick}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </>\n ) : null}\n {toolbarActions ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n {toolbarActions}\n </>\n ) : null}\n </div>\n </TooltipProvider>\n </div>\n )\n}\n\nfunction DocxSidebarThumbnail({\n canvasRef,\n displayFileName,\n hasError,\n isActive,\n isLoading,\n pageNumber,\n pixelHeightPx,\n pixelWidthPx,\n previewAspectRatio,\n}: {\n canvasRef: React.RefCallback<HTMLCanvasElement>\n displayFileName: string\n hasError: boolean\n isActive: boolean\n isLoading: boolean\n pageNumber: number\n pixelHeightPx: number\n pixelWidthPx: number\n previewAspectRatio: number\n}) {\n return (\n <FileThumbnail\n file={{\n name: `${displayFileName} page ${pageNumber}`,\n type: DOCX_MIME_TYPE,\n }}\n previewAspectRatio={previewAspectRatio}\n previewClassName="rounded-md bg-white"\n previewContent={\n <canvas\n ref={canvasRef}\n width={pixelWidthPx}\n height={pixelHeightPx}\n className="!size-full bg-white object-cover object-top"\n />\n }\n isLoading={isLoading}\n hasError={hasError}\n className={cn(\n "w-[92px] rounded-md border-0 shadow-xs ring-0 transition-shadow duration-150",\n isActive && "shadow-sm"\n )}\n />\n )\n}\n\nexport function DocxViewerPreview({\n className,\n defaultThumbnailSidebarOpen = false,\n defaultIsDark = false,\n fileName,\n isDark: controlledIsDark,\n onIsDarkChange,\n rounded = false,\n showDownload = true,\n showToolbar = true,\n showUpload = true,\n src,\n toolbarActions,\n}: {\n className?: string\n defaultThumbnailSidebarOpen?: boolean\n defaultIsDark?: boolean\n fileName?: string\n isDark?: boolean\n onIsDarkChange?: (isDark: boolean) => void\n rounded?: boolean\n showDownload?: boolean\n showToolbar?: boolean\n showUpload?: boolean\n src?: string\n toolbarActions?: React.ReactNode\n}) {\n const [effectiveIsDark, setIsDark] = useControllableDarkMode({\n defaultIsDark,\n isDark: controlledIsDark,\n onIsDarkChange,\n })\n\n return (\n <DocxViewerContent\n className={className}\n defaultThumbnailSidebarOpen={defaultThumbnailSidebarOpen}\n effectiveIsDark={effectiveIsDark}\n fileName={fileName}\n rounded={rounded}\n setNightRenderEnabled={setIsDark}\n shouldRenderNightMode\n showDownload={showDownload}\n showToolbar={showToolbar}\n showUpload={showUpload}\n toolbarActions={toolbarActions}\n url={src}\n />\n )\n}\n\nfunction DocxViewerContent({\n className,\n defaultThumbnailSidebarOpen,\n effectiveIsDark,\n fileName,\n rounded,\n setNightRenderEnabled,\n shouldRenderNightMode,\n showDownload,\n showToolbar = true,\n showUpload,\n toolbarActions,\n url,\n}: {\n className?: string\n defaultThumbnailSidebarOpen: boolean\n effectiveIsDark: boolean\n fileName?: string\n rounded: boolean\n setNightRenderEnabled: (checked: boolean) => void\n shouldRenderNightMode: boolean\n showDownload: boolean\n showToolbar?: boolean\n showUpload: boolean\n toolbarActions?: React.ReactNode\n url?: string\n}) {\n const fileInputRef = React.useRef<HTMLInputElement>(null)\n const viewportRef = React.useRef<HTMLDivElement | null>(null)\n const [viewerShellRef, viewerShellWidth] = useElementWidth<HTMLDivElement>()\n const [uploadedDocxFile, setUploadedDocxFile] =\n React.useState<UploadedDocxFile | null>(null)\n const [activePage, setActivePage] = React.useState(1)\n const [sidebarOpen, setSidebarOpen] = React.useState(\n defaultThumbnailSidebarOpen\n )\n const sidebarInline = useInlineThumbnailSidebar(viewerShellWidth)\n const viewerBackgroundColor =\n "color-mix(in oklab, var(--muted) 40%, transparent)"\n const displayFileName = React.useMemo(\n () =>\n uploadedDocxFile?.file.name ??\n (url ? formatDocumentName(fileName, url) : (fileName ?? "document.docx")),\n [fileName, uploadedDocxFile?.file.name, url]\n )\n const [initialDocumentTheme] = React.useState<DocxDocumentTheme>(() =>\n effectiveIsDark ? "dark" : "light"\n )\n const editorOptions = React.useMemo(\n () => ({\n initialDocumentTheme,\n initialFileName: displayFileName,\n }),\n [displayFileName, initialDocumentTheme]\n )\n const editor = useDocxEditor(editorOptions)\n const { importDocxFile, setDocumentTheme, status } = editor\n const [reportedPageCount, setReportedPageCount] = React.useState(0)\n const thumbnailEditor = React.useMemo<DocxEditorController>(\n () => ({\n ...editor,\n totalPages: Math.max(editor.totalPages, reportedPageCount),\n }),\n [editor, reportedPageCount]\n )\n const thumbnailOptions = React.useMemo(\n () => ({\n pixelRatio: 2,\n resolution: {\n maxHeight: DOCX_THUMBNAIL_WIDTH * 1.35,\n maxWidth: DOCX_THUMBNAIL_WIDTH,\n },\n }),\n []\n )\n const { thumbnails } = useDocxViewerThumbnails(\n thumbnailEditor,\n thumbnailOptions\n )\n const [zoomScale, setZoomScale] = React.useState(100)\n const [loadError, setLoadError] = React.useState<string>()\n const [isLoadingDocument, setIsLoadingDocument] = React.useState(true)\n const [isPreparingDownload, setIsPreparingDownload] = React.useState(false)\n const shouldShowDocumentSpinner = useDelayedLoadingIndicator(\n isLoadingDocument,\n DOCX_LOADING_INDICATOR_DELAY_MS\n )\n const loadingState = (\n <ViewerLoadingSurface showSpinner={shouldShowDocumentSpinner} />\n )\n const hasDocument = Boolean(url || uploadedDocxFile)\n const pageCount =\n hasDocument && !isLoadingDocument && !loadError\n ? Math.max(1, reportedPageCount || editor.totalPages)\n : 0\n const controlsDisabled =\n !hasDocument || isLoadingDocument || Boolean(loadError)\n const handlePageCountChange = React.useCallback((nextPageCount: number) => {\n setReportedPageCount(Math.max(1, Math.round(nextPageCount || 1)))\n }, [])\n const handleDownload = React.useCallback(async () => {\n if (isPreparingDownload) return\n if (!uploadedDocxFile && !url) return\n\n setIsPreparingDownload(true)\n\n try {\n await downloadDocxFile({\n file: uploadedDocxFile?.file,\n fileName: displayFileName,\n url,\n })\n } catch (error) {\n console.error(error)\n } finally {\n setIsPreparingDownload(false)\n }\n }, [displayFileName, isPreparingDownload, uploadedDocxFile, url])\n\n useSuppressDocxPaddingWarning(!isLoadingDocument && !loadError)\n\n React.useEffect(() => {\n setZoomScale(100)\n setActivePage(1)\n viewportRef.current?.scrollTo({ top: 0, left: 0 })\n }, [url])\n\n React.useEffect(() => {\n setDocumentTheme(effectiveIsDark ? "dark" : "light")\n }, [effectiveIsDark, setDocumentTheme])\n\n React.useEffect(() => {\n if (\n status.startsWith("Failed to load file") ||\n status === "Only .docx files are supported"\n ) {\n setLoadError(status)\n setIsLoadingDocument(false)\n }\n }, [status])\n\n // Imports mutate the shared editor instance; concurrent calls (effect\n // re-runs, StrictMode double-invoke) race inside the parser and surface as\n // bogus "Invalid DOCX ZIP" errors, so every import is chained through here.\n const importQueueRef = React.useRef<Promise<void>>(Promise.resolve())\n\n React.useEffect(() => {\n let isCurrent = true\n\n async function load() {\n // Superseded while queued — let the newest import run instead.\n if (!isCurrent) return\n if (!uploadedDocxFile && !url) {\n setIsLoadingDocument(false)\n setLoadError(undefined)\n setReportedPageCount(0)\n return\n }\n\n setIsLoadingDocument(true)\n setLoadError(undefined)\n setReportedPageCount(0)\n\n try {\n const docxFile =\n uploadedDocxFile?.file ??\n (url ? await loadDocxFile(url, displayFileName) : null)\n if (!docxFile) return\n await importDocxFile(docxFile)\n\n if (isCurrent) {\n setIsLoadingDocument(false)\n setActivePage(1)\n viewportRef.current?.scrollTo({ top: 0, left: 0 })\n }\n } catch (error) {\n if (isCurrent) {\n setLoadError(\n error instanceof Error ? error.message : "Unknown DOCX load error"\n )\n setIsLoadingDocument(false)\n }\n }\n }\n\n importQueueRef.current = importQueueRef.current.then(load)\n\n return () => {\n isCurrent = false\n }\n }, [displayFileName, importDocxFile, uploadedDocxFile, url])\n\n React.useEffect(() => {\n if (url) {\n setUploadedDocxFile(null)\n }\n }, [url])\n\n const updateActivePageFromViewport = React.useCallback(() => {\n const viewport = viewportRef.current\n if (!viewport || !pageCount) return\n\n const viewportRect = viewport.getBoundingClientRect()\n const viewportCenter = viewportRect.top + viewportRect.height / 2\n let closestPage = 1\n let closestDistance = Number.POSITIVE_INFINITY\n\n viewport\n .querySelectorAll<HTMLElement>(\n \'[data-docx-page-wrapper="true"][data-index]\'\n )\n .forEach((page) => {\n const pageIndex = Number(page.dataset.index)\n if (!Number.isFinite(pageIndex)) return\n\n const pageRect = page.getBoundingClientRect()\n const pageCenter = pageRect.top + pageRect.height / 2\n const distance = Math.abs(pageCenter - viewportCenter)\n\n if (distance < closestDistance) {\n closestDistance = distance\n closestPage = pageIndex + 1\n }\n })\n\n setActivePage((currentPage) =>\n currentPage === closestPage ? currentPage : closestPage\n )\n }, [pageCount])\n\n React.useEffect(() => {\n const viewport = viewportRef.current\n if (!viewport || !pageCount) return\n\n let frameId = 0\n const handleScroll = () => {\n window.cancelAnimationFrame(frameId)\n frameId = window.requestAnimationFrame(updateActivePageFromViewport)\n }\n\n frameId = window.requestAnimationFrame(updateActivePageFromViewport)\n viewport.addEventListener("scroll", handleScroll, { passive: true })\n\n return () => {\n window.cancelAnimationFrame(frameId)\n viewport.removeEventListener("scroll", handleScroll)\n }\n }, [pageCount, updateActivePageFromViewport])\n\n const scrollToPage = React.useCallback((pageNumber: number) => {\n const viewport = viewportRef.current\n const targetPageIndex = pageNumber - 1\n const page = viewport?.querySelector<HTMLElement>(\n `[data-docx-page-wrapper="true"][data-index="${targetPageIndex}"]`\n )\n\n setActivePage(pageNumber)\n\n if (!viewport || !page) return\n\n viewport.scrollTo({\n top:\n page.getBoundingClientRect().top -\n viewport.getBoundingClientRect().top +\n viewport.scrollTop -\n 24,\n behavior: "auto",\n })\n }, [])\n\n async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {\n const file = event.target.files?.[0]\n event.target.value = ""\n\n if (!file) return\n\n setZoomScale(100)\n setActivePage(1)\n setReportedPageCount(0)\n setUploadedDocxFile({\n file,\n identity: `${file.name}-${file.size}-${file.lastModified}`,\n })\n }\n\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className\n )}\n >\n <input\n ref={fileInputRef}\n type="file"\n accept=".docx,application/vnd.openxmlformats-officedocument.wordprocessingml.document"\n className="hidden"\n onChange={handleUpload}\n />\n {showToolbar ? (\n <DocxToolbar\n activePage={activePage}\n controlsDisabled={controlsDisabled}\n isDark={effectiveIsDark}\n isPreparingDownload={isPreparingDownload}\n onDownload={handleDownload}\n onIsDarkChange={setNightRenderEnabled}\n onToggleSidebar={() => setSidebarOpen((open) => !open)}\n onUploadClick={() => fileInputRef.current?.click()}\n pageCount={pageCount}\n setZoomScale={setZoomScale}\n showDownloadButton={showDownload}\n showNightRenderToggle={shouldRenderNightMode}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n zoomScale={zoomScale}\n />\n ) : null}\n <div\n ref={viewerShellRef}\n className="relative flex min-h-0 flex-1 overflow-hidden bg-muted/30"\n >\n <DocumentViewerThumbnailSidebar\n inline={sidebarInline}\n open={Boolean(sidebarOpen && (pageCount || isLoadingDocument))}\n >\n <ScrollArea className="h-full" scrollFade>\n <div className="p-4">\n {isLoadingDocument ? (\n <>\n <div className="mx-auto h-28 w-20 overflow-hidden rounded-md bg-background shadow-xs">\n <div className="h-full animate-pulse bg-muted" />\n </div>\n <div className="mx-auto mt-3 h-3 w-10 rounded-full bg-muted" />\n </>\n ) : (\n <div className="flex flex-col items-center gap-3">\n {thumbnails.slice(0, pageCount || 0).map((thumbnail) => (\n <Button\n key={thumbnail.pageIndex}\n type="button"\n variant="ghost"\n size="sm"\n className={cn(\n "!h-auto w-full flex-col items-center gap-2 p-2 text-xs shadow-none hover:bg-sidebar-accent",\n thumbnail.pageNumber === activePage &&\n "bg-sidebar-accent text-foreground",\n thumbnail.pageNumber !== activePage &&\n "text-muted-foreground"\n )}\n onFocus={(event) => event.currentTarget.blur()}\n onClick={() => scrollToPage(thumbnail.pageNumber)}\n >\n <DocxSidebarThumbnail\n canvasRef={thumbnail.canvasRef}\n displayFileName={displayFileName}\n hasError={thumbnail.status === "error"}\n isActive={thumbnail.pageNumber === activePage}\n isLoading={\n !thumbnail.isMounted &&\n thumbnail.status !== "ready" &&\n thumbnail.status !== "error"\n }\n pageNumber={thumbnail.pageNumber}\n pixelHeightPx={thumbnail.pixelHeightPx}\n pixelWidthPx={thumbnail.pixelWidthPx}\n previewAspectRatio={thumbnail.aspectRatio}\n />\n {thumbnail.pageNumber}\n </Button>\n ))}\n </div>\n )}\n </div>\n </ScrollArea>\n </DocumentViewerThumbnailSidebar>\n <ScrollArea\n className={cn("min-h-0 flex-1", rounded && "rounded-b-lg")}\n style={{ backgroundColor: viewerBackgroundColor }}\n viewportClassName="p-4"\n viewportRef={viewportRef}\n >\n {!url && !uploadedDocxFile ? (\n <div className="grid h-full min-h-96 place-items-center p-6 text-center">\n <div className="max-w-md rounded-lg border bg-background p-4 text-sm shadow-xs">\n <div className="font-medium">Upload a DOCX to preview</div>\n <div className="mt-1 text-muted-foreground">\n Pass a DOCX URL with the <code>src</code> prop or upload a\n file.\n </div>\n <Button\n type="button"\n variant="outline"\n size="sm"\n className="mt-4"\n onClick={() => fileInputRef.current?.click()}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n Upload DOCX\n </Button>\n </div>\n </div>\n ) : loadError ? (\n <div className="grid h-full min-h-96 place-items-center p-6 text-center">\n <div className="max-w-md rounded-lg border bg-background p-4 text-sm text-destructive shadow-xs">\n <div className="font-medium">Unable to display DOCX</div>\n <div className="mt-1 text-muted-foreground">{loadError}</div>\n </div>\n </div>\n ) : isLoadingDocument ? (\n loadingState\n ) : (\n <div className="mx-auto flex min-h-full justify-center">\n <div\n className={cn(\n "origin-top",\n effectiveIsDark && "docx-night-reader-shell"\n )}\n style={{ zoom: zoomScale / 100 }}\n >\n <DocxEditorViewer\n editor={editor}\n mode="read-only"\n loadingState={loadingState}\n pageBackgroundColor={effectiveIsDark ? "#0a0a0a" : undefined}\n pageGapBackgroundColor={viewerBackgroundColor}\n pageVirtualization={{ enabled: false }}\n deferInitialPaginationPaint={false}\n onPageCountChange={handlePageCountChange}\n />\n </div>\n </div>\n )}\n </ScrollArea>\n </div>\n </div>\n )\n}\n'
export function DocxViewerSource() {
return (
diff --git a/apps/v4/components/root-components-collage.tsx b/apps/v4/components/root-components-collage.tsx
index a6314a1..b371b2f 100644
--- a/apps/v4/components/root-components-collage.tsx
+++ b/apps/v4/components/root-components-collage.tsx
@@ -99,6 +99,17 @@ const ESignatureBlock = dynamic(
}
)
+const FileSystemBlock = dynamic(
+ () =>
+ import("@/components/file-system-docs").then(
+ (mod) => mod.FileSystemFinderBlock
+ ),
+ {
+ ssr: false,
+ loading: () => <ViewerPreviewLoading />,
+ }
+)
+
export function MobileRootPreview() {
return (
<div className="relative bg-background px-4">
@@ -135,7 +146,7 @@ export function RootComponentsCollage() {
<ComponentXlsxViewerTile />
</div>
<div className="flex flex-col gap-4">
- <FileUploadTile />
+ <FileSystemTile />
<DocxViewerTile />
<FileThumbnailTile />
<SchemaBuilderTile />
@@ -148,7 +159,7 @@ export function RootComponentsCollage() {
<DocumentSplitsTile />
</div>
<div className="flex flex-col gap-4">
- <FileUploadTile />
+ <FileSystemTile />
<DocxViewerTile />
<FileThumbnailTile />
</div>
@@ -166,6 +177,7 @@ export function RootBlocksShowcase() {
<div className="flex w-full flex-col gap-12 py-1">
<LayoutBlocksTile />
<BoundingBoxCitationsTile />
+ <BlockFileSystemTile />
<BlockXlsxViewerTile />
<BlockFileUploadTile />
<DocxEditorTile />
@@ -189,14 +201,16 @@ function PdfViewerTile() {
)
}
-function FileUploadTile() {
+function FileSystemTile() {
return (
<ComponentCrop
- label="File Upload"
- viewHref="/docs/components/file-upload"
- className="bg-background p-3"
+ label="File System"
+ viewHref="/docs/components/file-system"
+ className="h-[560px] bg-background"
>
- <FileUpload showFileList={false} />
+ <RootPreviewLoader>
+ <FileSystemBlock />
+ </RootPreviewLoader>
</ComponentCrop>
)
}
@@ -312,6 +326,20 @@ function BlockFileUploadTile() {
)
}
+function BlockFileSystemTile() {
+ return (
+ <ComponentCrop
+ label="File System"
+ viewHref="/blocks#file-system"
+ className="h-[680px] bg-background"
+ >
+ <RootPreviewLoader>
+ <FileSystemBlock />
+ </RootPreviewLoader>
+ </ComponentCrop>
+ )
+}
+
function DocxEditorTile() {
return (
<ComponentCrop
diff --git a/apps/v4/components/ui/docx-viewer.tsx b/apps/v4/components/ui/docx-viewer.tsx
index 25a9530..3d5c4e4 100644
--- a/apps/v4/components/ui/docx-viewer.tsx
+++ b/apps/v4/components/ui/docx-viewer.tsx
@@ -9,6 +9,7 @@ import {
type DocxEditorController,
} from "@extend-ai/react-docx"
import {
+ Download01Icon,
MinusSignCircleIcon,
Moon02Icon,
PlusSignCircleIcon,
@@ -83,6 +84,49 @@ function formatDocumentName(fileName: string | undefined, url: string) {
}
}
+function ensureDocxExtension(fileName: string) {
+ return fileName.toLowerCase().endsWith(".docx")
+ ? fileName
+ : `${fileName}.docx`
+}
+
+function downloadBlob(blob: Blob, fileName: string) {
+ const url = URL.createObjectURL(blob)
+ const anchor = document.createElement("a")
+
+ anchor.href = url
+ anchor.download = fileName
+ anchor.rel = "noopener"
+ document.body.append(anchor)
+ anchor.click()
+ anchor.remove()
+ window.setTimeout(() => URL.revokeObjectURL(url), 0)
+}
+
+async function downloadDocxFile({
+ file,
+ fileName,
+ url,
+}: {
+ file?: File
+ fileName: string
+ url?: string
+}) {
+ if (file) {
+ downloadBlob(file, ensureDocxExtension(fileName))
+ return
+ }
+
+ if (!url) return
+
+ const response = await fetch(url)
+ if (!response.ok) {
+ throw new Error(`Failed to download DOCX (${response.status})`)
+ }
+
+ downloadBlob(await response.blob(), ensureDocxExtension(fileName))
+}
+
function getNextZoomScale(currentZoomScale: number, direction: 1 | -1) {
const currentIndex = ZOOM_OPTIONS.indexOf(
currentZoomScale as (typeof ZOOM_OPTIONS)[number]
@@ -215,11 +259,14 @@ function DocxToolbar({
activePage,
controlsDisabled,
isDark,
+ isPreparingDownload,
+ onDownload,
onIsDarkChange,
onToggleSidebar,
onUploadClick,
pageCount,
setZoomScale,
+ showDownloadButton = true,
showNightRenderToggle,
showUploadButton = true,
toolbarActions,
@@ -228,11 +275,14 @@ function DocxToolbar({
activePage: number
controlsDisabled: boolean
isDark: boolean
+ isPreparingDownload: boolean
+ onDownload: () => void
onIsDarkChange: (checked: boolean) => void
onToggleSidebar: () => void
onUploadClick: () => void
pageCount: number
setZoomScale: React.Dispatch<React.SetStateAction<number>>
+ showDownloadButton?: boolean
showNightRenderToggle: boolean
showUploadButton?: boolean
toolbarActions?: React.ReactNode
@@ -337,6 +387,30 @@ function DocxToolbar({
</Button>
</ToolbarTooltip>
</div>
+ {showDownloadButton ? (
+ <>
+ <Separator
+ orientation="vertical"
+ className="mx-1 h-4 self-center"
+ />
+ <ToolbarTooltip label="Download DOCX">
+ <Button
+ type="button"
+ variant="ghost"
+ size="icon-sm"
+ aria-label="Download DOCX"
+ disabled={controlsDisabled || isPreparingDownload}
+ onClick={onDownload}
+ >
+ {isPreparingDownload ? (
+ <Spinner className="size-4" />
+ ) : (
+ <HugeiconsIcon icon={Download01Icon} className="size-4" />
+ )}
+ </Button>
+ </ToolbarTooltip>
+ </>
+ ) : null}
{showUploadButton ? (
<>
<Separator
@@ -426,6 +500,7 @@ export function DocxViewerPreview({
isDark: controlledIsDark,
onIsDarkChange,
rounded = false,
+ showDownload = true,
showToolbar = true,
showUpload = true,
src,
@@ -438,6 +513,7 @@ export function DocxViewerPreview({
isDark?: boolean
onIsDarkChange?: (isDark: boolean) => void
rounded?: boolean
+ showDownload?: boolean
showToolbar?: boolean
showUpload?: boolean
src?: string
@@ -458,6 +534,7 @@ export function DocxViewerPreview({
rounded={rounded}
setNightRenderEnabled={setIsDark}
shouldRenderNightMode
+ showDownload={showDownload}
showToolbar={showToolbar}
showUpload={showUpload}
toolbarActions={toolbarActions}
@@ -474,6 +551,7 @@ function DocxViewerContent({
rounded,
setNightRenderEnabled,
shouldRenderNightMode,
+ showDownload,
showToolbar = true,
showUpload,
toolbarActions,
@@ -486,6 +564,7 @@ function DocxViewerContent({
rounded: boolean
setNightRenderEnabled: (checked: boolean) => void
shouldRenderNightMode: boolean
+ showDownload: boolean
showToolbar?: boolean
showUpload: boolean
toolbarActions?: React.ReactNode
@@ -546,6 +625,7 @@ function DocxViewerContent({
const [zoomScale, setZoomScale] = React.useState(100)
const [loadError, setLoadError] = React.useState<string>()
const [isLoadingDocument, setIsLoadingDocument] = React.useState(true)
+ const [isPreparingDownload, setIsPreparingDownload] = React.useState(false)
const shouldShowDocumentSpinner = useDelayedLoadingIndicator(
isLoadingDocument,
DOCX_LOADING_INDICATOR_DELAY_MS
@@ -563,6 +643,24 @@ function DocxViewerContent({
const handlePageCountChange = React.useCallback((nextPageCount: number) => {
setReportedPageCount(Math.max(1, Math.round(nextPageCount || 1)))
}, [])
+ const handleDownload = React.useCallback(async () => {
+ if (isPreparingDownload) return
+ if (!uploadedDocxFile && !url) return
+
+ setIsPreparingDownload(true)
+
+ try {
+ await downloadDocxFile({
+ file: uploadedDocxFile?.file,
+ fileName: displayFileName,
+ url,
+ })
+ } catch (error) {
+ console.error(error)
+ } finally {
+ setIsPreparingDownload(false)
+ }
+ }, [displayFileName, isPreparingDownload, uploadedDocxFile, url])
useSuppressDocxPaddingWarning(!isLoadingDocument && !loadError)
@@ -749,11 +847,14 @@ function DocxViewerContent({
activePage={activePage}
controlsDisabled={controlsDisabled}
isDark={effectiveIsDark}
+ isPreparingDownload={isPreparingDownload}
+ onDownload={handleDownload}
onIsDarkChange={setNightRenderEnabled}
onToggleSidebar={() => setSidebarOpen((open) => !open)}
onUploadClick={() => fileInputRef.current?.click()}
pageCount={pageCount}
setZoomScale={setZoomScale}
+ showDownloadButton={showDownload}
showNightRenderToggle={shouldRenderNightMode}
showUploadButton={showUpload}
toolbarActions={toolbarActions}
diff --git a/apps/v4/components/ui/xlsx-viewer.tsx b/apps/v4/components/ui/xlsx-viewer.tsx
index 21a0e12..86fd3fd 100644
--- a/apps/v4/components/ui/xlsx-viewer.tsx
+++ b/apps/v4/components/ui/xlsx-viewer.tsx
@@ -12,6 +12,7 @@ import {
type XlsxTableHeaderMenuRenderProps,
} from "@extend-ai/react-xlsx"
import {
+ Download01Icon,
MinusSignCircleIcon,
Moon02Icon,
MoreHorizontalIcon,
@@ -82,6 +83,32 @@ function formatWorkbookName(fileName: string | undefined, url: string) {
}
}
+function ensureWorkbookExtension(fileName: string) {
+ const lowerFileName = fileName.toLowerCase()
+ return lowerFileName.endsWith(".xlsx") || lowerFileName.endsWith(".xls")
+ ? fileName
+ : `${fileName}.xlsx`
+}
+
+function downloadWorkbookBuffer(buffer: ArrayBuffer, fileName: string) {
+ const resolvedFileName = ensureWorkbookExtension(fileName)
+ const blob = new Blob([buffer], {
+ type: resolvedFileName.toLowerCase().endsWith(".xls")
+ ? "application/vnd.ms-excel"
+ : "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+ })
+ const url = URL.createObjectURL(blob)
+ const anchor = document.createElement("a")
+
+ anchor.href = url
+ anchor.download = resolvedFileName
+ anchor.rel = "noopener"
+ document.body.append(anchor)
+ anchor.click()
+ anchor.remove()
+ window.setTimeout(() => URL.revokeObjectURL(url), 0)
+}
+
function useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {
const [showSpinner, setShowSpinner] = React.useState(false)
@@ -227,16 +254,20 @@ export function WorkbookTableHeaderMenu({
function WorkbookToolbar({
isDark,
+ onDownload,
onIsDarkChange,
onUploadClick,
+ showDownloadButton = true,
showNightRenderToggle,
showUploadButton = true,
toolbarActions,
workbookIdentity,
}: {
isDark: boolean
+ onDownload?: () => void
onIsDarkChange: (checked: boolean) => void
onUploadClick: () => void
+ showDownloadButton?: boolean
showNightRenderToggle: boolean
showUploadButton?: boolean
toolbarActions?: React.ReactNode
@@ -323,6 +354,25 @@ function WorkbookToolbar({
</Button>
</ToolbarTooltip>
</div>
+ {showDownloadButton && onDownload ? (
+ <>
+ <Separator
+ orientation="vertical"
+ className="mx-1 h-4 self-center"
+ />
+ <ToolbarTooltip label="Download XLSX">
+ <Button
+ type="button"
+ variant="ghost"
+ size="icon-sm"
+ aria-label="Download XLSX"
+ onClick={onDownload}
+ >
+ <HugeiconsIcon icon={Download01Icon} className="size-4" />
+ </Button>
+ </ToolbarTooltip>
+ </>
+ ) : null}
{showUploadButton ? (
<>
<Separator
@@ -669,10 +719,12 @@ const WorkbookSheetTabsInner = React.memo(function WorkbookSheetTabsInner({
export function XlsxWorkbookSurface({
className,
isDark,
+ onDownload,
onIsDarkChange,
onUploadClick,
renderTableHeaderMenu,
rounded,
+ showDownloadButton = true,
showNightRenderToggle,
showToolbar = true,
showUploadButton = true,
@@ -681,12 +733,14 @@ export function XlsxWorkbookSurface({
}: {
className?: string
isDark: boolean
+ onDownload?: () => void
onIsDarkChange: (checked: boolean) => void
onUploadClick: () => void
renderTableHeaderMenu: (
props: XlsxTableHeaderMenuRenderProps
) => React.ReactNode
rounded: boolean
+ showDownloadButton?: boolean
showNightRenderToggle: boolean
showToolbar?: boolean
showUploadButton?: boolean
@@ -706,8 +760,10 @@ export function XlsxWorkbookSurface({
{showToolbar ? (
<WorkbookToolbar
isDark={isDark}
+ onDownload={onDownload}
onIsDarkChange={onIsDarkChange}
onUploadClick={onUploadClick}
+ showDownloadButton={showDownloadButton}
showNightRenderToggle={showNightRenderToggle}
showUploadButton={showUploadButton}
toolbarActions={toolbarActions}
@@ -760,6 +816,7 @@ export function XlsxViewerPreview({
isDark: controlledIsDark,
onIsDarkChange,
rounded = false,
+ showDownload = true,
showToolbar = true,
showUpload = true,
src,
@@ -771,6 +828,7 @@ export function XlsxViewerPreview({
isDark?: boolean
onIsDarkChange?: (isDark: boolean) => void
rounded?: boolean
+ showDownload?: boolean
showToolbar?: boolean
showUpload?: boolean
src?: string
@@ -790,6 +848,7 @@ export function XlsxViewerPreview({
rounded={rounded}
setNightRenderEnabled={setIsDark}
shouldRenderNightMode
+ showDownload={showDownload}
showToolbar={showToolbar}
showUpload={showUpload}
toolbarActions={toolbarActions}
@@ -805,6 +864,7 @@ function XlsxViewerContent({
rounded,
setNightRenderEnabled,
shouldRenderNightMode,
+ showDownload,
showToolbar = true,
showUpload,
toolbarActions,
@@ -816,6 +876,7 @@ function XlsxViewerContent({
rounded: boolean
setNightRenderEnabled: (checked: boolean) => void
shouldRenderNightMode: boolean
+ showDownload: boolean
showToolbar?: boolean
showUpload: boolean
toolbarActions?: React.ReactNode
@@ -1026,12 +1087,14 @@ function XlsxViewerContent({
className={className}
fileName={activeFileName}
isDark={effectiveIsDark}
+ onDownload={() => downloadWorkbookBuffer(activeBuffer, activeFileName)}
onIsDarkChange={setNightRenderEnabled}
onUploadClick={() => fileInputRef.current?.click()}
renderTableHeaderMenu={(props) => (
<WorkbookTableHeaderMenu {...props} />
)}
rounded={rounded}
+ showDownloadButton={showDownload}
showNightRenderToggle={shouldRenderNightMode}
showToolbar={showToolbar}
showUploadButton={showUpload}
@@ -1047,10 +1110,12 @@ function XlsxWorkbookLoadedViewer({
className,
fileName,
isDark,
+ onDownload,
onIsDarkChange,
onUploadClick,
renderTableHeaderMenu,
rounded,
+ showDownloadButton,
showNightRenderToggle,
showToolbar = true,
showUploadButton,
@@ -1061,12 +1126,14 @@ function XlsxWorkbookLoadedViewer({
className?: string
fileName: string
isDark: boolean
+ onDownload: () => void
onIsDarkChange: (checked: boolean) => void
onUploadClick: () => void
renderTableHeaderMenu: (
props: XlsxTableHeaderMenuRenderProps
) => React.ReactNode
rounded: boolean
+ showDownloadButton: boolean
showNightRenderToggle: boolean
showToolbar?: boolean
showUploadButton: boolean
@@ -1092,10 +1159,12 @@ function XlsxWorkbookLoadedViewer({
<XlsxWorkbookSurface
className={className}
isDark={isDark}
+ onDownload={onDownload}
onIsDarkChange={onIsDarkChange}
onUploadClick={onUploadClick}
renderTableHeaderMenu={renderTableHeaderMenu}
rounded={rounded}
+ showDownloadButton={showDownloadButton}
showNightRenderToggle={showNightRenderToggle}
showToolbar={showToolbar}
showUploadButton={showUploadButton}
diff --git a/apps/v4/components/xlsx-viewer-docs.tsx b/apps/v4/components/xlsx-viewer-docs.tsx
index 04183b0..e4463d6 100644
--- a/apps/v4/components/xlsx-viewer-docs.tsx
+++ b/apps/v4/components/xlsx-viewer-docs.tsx
@@ -51,7 +51,7 @@ export function XlsxViewerExample() {
}`
const xlsxViewerSourceCode =
- '"use client"\n\nimport * as React from "react"\nimport {\n useXlsxViewer,\n useXlsxViewerController,\n useXlsxViewerThumbnails,\n useXlsxViewerZoom,\n XlsxViewer,\n XlsxViewerProvider,\n type XlsxScrollerRenderProps,\n type XlsxTableHeaderMenuRenderProps,\n} from "@extend-ai/react-xlsx"\nimport {\n MinusSignCircleIcon,\n Moon02Icon,\n MoreHorizontalIcon,\n PlusSignCircleIcon,\n Sun03Icon,\n Upload01Icon,\n} from "@hugeicons/core-free-icons"\nimport { HugeiconsIcon } from "@hugeicons/react"\nimport { createPortal } from "react-dom"\n\nimport { cn } from "@/lib/utils"\nimport { Button } from "@/components/ui/button"\nimport {\n DropdownMenu,\n DropdownMenuContent,\n DropdownMenuItem,\n DropdownMenuRadioGroup,\n DropdownMenuRadioItem,\n DropdownMenuTrigger,\n} from "@/components/ui/dropdown-menu"\nimport { ScrollArea } from "@/components/ui/scroll-area"\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from "@/components/ui/select"\nimport { Separator } from "@/components/ui/separator"\nimport { Spinner } from "@/components/ui/spinner"\nimport { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"\nimport {\n Tooltip,\n TooltipContent,\n TooltipProvider,\n TooltipTrigger,\n} from "@/components/ui/tooltip"\n\nconst XLSX_LOADING_INDICATOR_DELAY_MS = 300\nconst XLSX_DROPDOWN_Z_INDEX_CLASS = "z-40"\nconst ZOOM_OPTIONS = [10, 25, 50, 75, 100, 125, 150, 175, 200, 400] as const\n\n// Stable reference so the thumbnails memo isn\'t invalidated on every render\n// (e.g. by selection changes), which would recompute every sheet thumbnail.\nconst XLSX_SHEET_TAB_THUMBNAIL_OPTIONS = {\n resolution: {\n maxHeight: 360,\n maxWidth: 560,\n },\n} as const\n\ntype UploadedWorkbook = {\n buffer: ArrayBuffer\n fileName: string\n identity: string\n}\n\nfunction formatWorkbookName(fileName: string | undefined, url: string) {\n if (fileName?.trim()) return fileName\n\n const pathname = url.split("?")[0] ?? ""\n const rawName = pathname.split("/").pop() ?? "workbook.xlsx"\n\n try {\n return decodeURIComponent(rawName)\n } catch {\n return rawName\n }\n}\n\nfunction useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {\n const [showSpinner, setShowSpinner] = React.useState(false)\n\n React.useEffect(() => {\n if (!isLoading) {\n setShowSpinner(false)\n return\n }\n\n const timeoutId = window.setTimeout(() => {\n setShowSpinner(true)\n }, delayMs)\n\n return () => window.clearTimeout(timeoutId)\n }, [delayMs, isLoading])\n\n return showSpinner\n}\n\nexport function useControllableDarkMode({\n defaultIsDark = false,\n isDark,\n onIsDarkChange,\n}: {\n defaultIsDark?: boolean\n isDark?: boolean\n onIsDarkChange?: (isDark: boolean) => void\n}) {\n const [uncontrolledIsDark, setUncontrolledIsDark] =\n React.useState(defaultIsDark)\n const resolvedIsDark = isDark ?? uncontrolledIsDark\n\n const setIsDark = React.useCallback(\n (nextIsDark: boolean) => {\n if (isDark === undefined) {\n setUncontrolledIsDark(nextIsDark)\n }\n\n onIsDarkChange?.(nextIsDark)\n },\n [isDark, onIsDarkChange]\n )\n\n return [resolvedIsDark, setIsDark] as const\n}\n\nfunction ToolbarTooltip({\n label,\n children,\n}: {\n label: string\n children: React.ReactNode\n}) {\n return (\n <Tooltip>\n <TooltipTrigger asChild>\n <span className="inline-flex">{children}</span>\n </TooltipTrigger>\n <TooltipContent side="bottom">{label}</TooltipContent>\n </Tooltip>\n )\n}\n\nfunction ViewerLoadingSurface({\n showSpinner = true,\n}: {\n showSpinner?: boolean\n}) {\n return (\n <div className="grid h-full min-h-52 w-full min-w-full place-items-center bg-transparent">\n {showSpinner ? <Spinner className="size-4" /> : null}\n </div>\n )\n}\n\nexport function renderXlsxScroller({\n children,\n viewportProps,\n}: XlsxScrollerRenderProps) {\n return (\n <ScrollArea\n className="h-full min-h-0 w-full min-w-0 flex-1"\n viewportProps={viewportProps}\n >\n {children}\n </ScrollArea>\n )\n}\n\nexport function WorkbookTableHeaderMenu({\n direction,\n sortAscending,\n sortDescending,\n triggerIcon,\n triggerProps,\n}: XlsxTableHeaderMenuRenderProps) {\n const [open, setOpen] = React.useState(false)\n\n return (\n <DropdownMenu open={open} onOpenChange={setOpen}>\n <DropdownMenuTrigger asChild>\n <Button\n {...triggerProps}\n type="button"\n variant="ghost"\n size="icon-sm"\n className={cn("size-6 rounded-sm", triggerProps.className)}\n aria-label="Column menu"\n >\n {triggerIcon ? (\n triggerIcon\n ) : (\n <HugeiconsIcon icon={MoreHorizontalIcon} className="size-3.5" />\n )}\n </Button>\n </DropdownMenuTrigger>\n <DropdownMenuContent\n align="end"\n className={cn("w-40", XLSX_DROPDOWN_Z_INDEX_CLASS)}\n >\n <DropdownMenuRadioGroup\n value={direction ?? ""}\n onValueChange={(value) => {\n if (value === "ascending") {\n sortAscending()\n } else {\n sortDescending()\n }\n setOpen(false)\n }}\n >\n <DropdownMenuRadioItem value="ascending">\n Sort ascending\n </DropdownMenuRadioItem>\n <DropdownMenuRadioItem value="descending">\n Sort descending\n </DropdownMenuRadioItem>\n </DropdownMenuRadioGroup>\n </DropdownMenuContent>\n </DropdownMenu>\n )\n}\n\nfunction WorkbookToolbar({\n isDark,\n onIsDarkChange,\n onUploadClick,\n showNightRenderToggle,\n showUploadButton = true,\n toolbarActions,\n workbookIdentity,\n}: {\n isDark: boolean\n onIsDarkChange: (checked: boolean) => void\n onUploadClick: () => void\n showNightRenderToggle: boolean\n showUploadButton?: boolean\n toolbarActions?: React.ReactNode\n workbookIdentity: string\n}) {\n const { canZoomIn, canZoomOut, setZoomScale, zoomIn, zoomOut, zoomScale } =\n useXlsxViewerZoom()\n const currentZoom = Math.round(zoomScale)\n\n React.useEffect(() => {\n setZoomScale(100)\n }, [setZoomScale, workbookIdentity])\n\n return (\n <div className="flex min-h-12 flex-wrap items-center justify-end gap-2 border-b bg-background px-3 py-2">\n <TooltipProvider>\n <div className="ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1">\n {showNightRenderToggle ? (\n <ToolbarTooltip\n label={isDark ? "Use light workbook" : "Use dark workbook"}\n >\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label={isDark ? "Use light workbook" : "Use dark workbook"}\n onClick={() => onIsDarkChange(!isDark)}\n >\n <HugeiconsIcon\n icon={isDark ? Sun03Icon : Moon02Icon}\n className="size-4"\n />\n </Button>\n </ToolbarTooltip>\n ) : null}\n <Separator orientation="vertical" className="mx-1 h-4 self-center" />\n <div className="flex flex-none items-center gap-1">\n <ToolbarTooltip label="Zoom out">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={!canZoomOut}\n aria-label="Zoom out"\n onClick={zoomOut}\n >\n <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n <Select\n value={currentZoom.toString()}\n onValueChange={(value) => setZoomScale(Number(value))}\n modal={false}\n >\n <SelectTrigger\n size="sm"\n className="w-[84px] min-w-[84px]"\n aria-label="Zoom level"\n >\n <SelectValue>{currentZoom}%</SelectValue>\n </SelectTrigger>\n <SelectContent\n align="end"\n alignItemWithTrigger={false}\n className={XLSX_DROPDOWN_Z_INDEX_CLASS}\n >\n {ZOOM_OPTIONS.map((value) => (\n <SelectItem key={value} value={value.toString()}>\n {value}%\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n <ToolbarTooltip label="Zoom in">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={!canZoomIn}\n aria-label="Zoom in"\n onClick={zoomIn}\n >\n <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </div>\n {showUploadButton ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n <ToolbarTooltip label="Upload XLSX">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Upload XLSX"\n onClick={onUploadClick}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </>\n ) : null}\n {toolbarActions ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n {toolbarActions}\n </>\n ) : null}\n </div>\n </TooltipProvider>\n </div>\n )\n}\n\nfunction WorkbookStandaloneToolbar({\n onUploadClick,\n showUploadButton = true,\n toolbarActions,\n}: {\n onUploadClick: () => void\n showUploadButton?: boolean\n toolbarActions?: React.ReactNode\n}) {\n return (\n <div className="flex min-h-12 flex-wrap items-center justify-end gap-2 border-b bg-background px-3 py-2">\n <TooltipProvider>\n <div className="ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1">\n {showUploadButton ? (\n <ToolbarTooltip label="Upload XLSX">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Upload XLSX"\n onClick={onUploadClick}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n ) : null}\n {toolbarActions ? (\n <>\n {showUploadButton ? (\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n ) : null}\n {toolbarActions}\n </>\n ) : null}\n </div>\n </TooltipProvider>\n </div>\n )\n}\n\ntype WorkbookSheetTab = {\n name: string\n workbookSheetIndex: number\n}\n\ntype WorkbookSheetTabsInnerProps = {\n activeSheetIndex: number\n onActiveSheetIndexChange: (index: number) => void\n sheets: WorkbookSheetTab[]\n workbookIdentity: string\n}\n\nexport function WorkbookSheetTabs({\n workbookIdentity,\n}: {\n workbookIdentity: string\n}) {\n const { activeSheetIndex, setActiveSheetIndex, sheets } = useXlsxViewer()\n\n const handleActiveSheetIndexChange = React.useCallback(\n (index: number) => setActiveSheetIndex(index),\n [setActiveSheetIndex]\n )\n\n return (\n <WorkbookSheetTabsInner\n activeSheetIndex={activeSheetIndex}\n onActiveSheetIndexChange={handleActiveSheetIndexChange}\n sheets={sheets}\n workbookIdentity={workbookIdentity}\n />\n )\n}\n\nconst WorkbookSheetTabsInner = React.memo(function WorkbookSheetTabsInner({\n activeSheetIndex,\n onActiveSheetIndexChange,\n sheets,\n workbookIdentity,\n}: WorkbookSheetTabsInnerProps) {\n const [visiblePreviewIndex, setVisiblePreviewIndex] = React.useState<\n number | null\n >(null)\n const [previewPosition, setPreviewPosition] = React.useState({\n left: 0,\n top: 0,\n })\n const { thumbnails } = useXlsxViewerThumbnails(\n XLSX_SHEET_TAB_THUMBNAIL_OPTIONS\n )\n const [thumbnailUrls, setThumbnailUrls] = React.useState<\n Record<number, string>\n >({})\n const scrollRef = React.useRef<HTMLDivElement | null>(null)\n const itemRefs = React.useRef<Record<number, HTMLButtonElement | null>>({})\n const openTimeoutRef = React.useRef<ReturnType<typeof setTimeout> | null>(\n null\n )\n const closeTimeoutRef = React.useRef<ReturnType<typeof setTimeout> | null>(\n null\n )\n const previewWidth = 220\n const previewHeight = (previewWidth * 7) / 11\n const previewGap = 12\n const previewOpenDelayMs = 500\n\n const clearOpenTimeout = React.useCallback(() => {\n if (openTimeoutRef.current) {\n clearTimeout(openTimeoutRef.current)\n openTimeoutRef.current = null\n }\n }, [])\n\n const clearCloseTimeout = React.useCallback(() => {\n if (closeTimeoutRef.current) {\n clearTimeout(closeTimeoutRef.current)\n closeTimeoutRef.current = null\n }\n }, [])\n\n const getPreviewPosition = React.useCallback(\n (sheetIndex: number) => {\n const item = itemRefs.current[sheetIndex]\n if (!item || typeof window === "undefined") {\n return { left: 0, top: 0 }\n }\n\n const itemRect = item.getBoundingClientRect()\n const centeredLeft = itemRect.left + itemRect.width / 2 - previewWidth / 2\n const minLeft = 8\n const maxLeft = Math.max(minLeft, window.innerWidth - previewWidth - 8)\n const left = Math.max(minLeft, Math.min(centeredLeft, maxLeft))\n const top = Math.max(8, itemRect.top - previewHeight - previewGap)\n\n return { left, top }\n },\n [previewHeight]\n )\n\n const updatePreviewPosition = React.useCallback(\n (sheetIndex: number) => {\n setPreviewPosition(getPreviewPosition(sheetIndex))\n },\n [getPreviewPosition]\n )\n\n const handleItemEnter = React.useCallback(\n (sheetIndex: number) => {\n clearCloseTimeout()\n const nextPreviewPosition = getPreviewPosition(sheetIndex)\n\n if (visiblePreviewIndex !== null) {\n clearOpenTimeout()\n setPreviewPosition(nextPreviewPosition)\n setVisiblePreviewIndex(sheetIndex)\n return\n }\n\n clearOpenTimeout()\n openTimeoutRef.current = setTimeout(() => {\n setPreviewPosition(nextPreviewPosition)\n setVisiblePreviewIndex(sheetIndex)\n }, previewOpenDelayMs)\n },\n [\n clearCloseTimeout,\n clearOpenTimeout,\n getPreviewPosition,\n visiblePreviewIndex,\n ]\n )\n\n const handleContainerLeave = React.useCallback(() => {\n clearOpenTimeout()\n clearCloseTimeout()\n closeTimeoutRef.current = setTimeout(() => {\n setVisiblePreviewIndex(null)\n }, 80)\n }, [clearCloseTimeout, clearOpenTimeout])\n\n React.useEffect(() => {\n return () => {\n clearOpenTimeout()\n clearCloseTimeout()\n }\n }, [clearCloseTimeout, clearOpenTimeout])\n\n React.useEffect(() => {\n clearOpenTimeout()\n clearCloseTimeout()\n setVisiblePreviewIndex(null)\n setPreviewPosition({ left: 0, top: 0 })\n setThumbnailUrls({})\n }, [clearCloseTimeout, clearOpenTimeout, workbookIdentity])\n\n React.useEffect(() => {\n thumbnails.forEach((thumbnail) => {\n setThumbnailUrls((current) => {\n if (current[thumbnail.sheetIndex]) return current\n\n const canvas = document.createElement("canvas")\n canvas.width = thumbnail.width\n canvas.height = thumbnail.height\n\n if (!thumbnail.paint(canvas)) return current\n\n return {\n ...current,\n [thumbnail.sheetIndex]: canvas.toDataURL("image/png"),\n }\n })\n })\n }, [thumbnails])\n\n React.useEffect(() => {\n if (visiblePreviewIndex === null) return\n\n const handleReposition = () => updatePreviewPosition(visiblePreviewIndex)\n handleReposition()\n\n const scrollElement = scrollRef.current\n window.addEventListener("resize", handleReposition)\n scrollElement?.addEventListener("scroll", handleReposition, {\n passive: true,\n })\n\n return () => {\n window.removeEventListener("resize", handleReposition)\n scrollElement?.removeEventListener("scroll", handleReposition)\n }\n }, [updatePreviewPosition, visiblePreviewIndex])\n\n if (sheets.length <= 1) return null\n\n const previewSheet =\n visiblePreviewIndex === null ? null : sheets[visiblePreviewIndex]\n const previewUrl =\n visiblePreviewIndex === null\n ? null\n : (thumbnailUrls[visiblePreviewIndex] ?? null)\n\n return (\n <div\n className="border-t bg-muted/40 px-3 py-2"\n onMouseLeave={handleContainerLeave}\n >\n <Tabs\n value={String(activeSheetIndex)}\n onValueChange={(value) => onActiveSheetIndexChange(Number(value))}\n className="gap-0"\n >\n <ScrollArea\n orientation="horizontal"\n scrollbarGutter\n className="h-10 w-full has-[[data-slot=scroll-area-viewport][data-has-overflow-x]]:h-[50px]"\n viewportClassName="overflow-y-hidden"\n viewportRef={scrollRef}\n >\n <div className="flex h-full items-center">\n <TabsList className="shrink-0">\n {sheets.map((sheet, index) => (\n <TabsTrigger\n key={`${sheet.workbookSheetIndex}-${sheet.name}`}\n ref={(node) => {\n itemRefs.current[index] = node\n }}\n value={String(index)}\n className="max-w-48 flex-none"\n onMouseEnter={() => handleItemEnter(index)}\n >\n <span className="truncate">{sheet.name}</span>\n </TabsTrigger>\n ))}\n </TabsList>\n </div>\n </ScrollArea>\n </Tabs>\n {typeof document !== "undefined" &&\n previewSheet &&\n visiblePreviewIndex !== null &&\n previewUrl\n ? createPortal(\n <div\n className="pointer-events-none fixed z-40 translate-y-0 overflow-hidden rounded-lg border bg-background/95 opacity-100 shadow-xl backdrop-blur-md transition-[opacity,transform] duration-100"\n style={{\n left: previewPosition.left,\n top: previewPosition.top,\n width: previewWidth,\n }}\n >\n <div className="relative aspect-[11/7] w-full overflow-hidden bg-muted/60">\n <img\n key={`${workbookIdentity}-${visiblePreviewIndex}-${previewUrl}`}\n src={previewUrl}\n alt={`${previewSheet.name} preview`}\n className="absolute inset-0 h-full w-full object-cover object-left-top"\n />\n </div>\n </div>,\n document.body\n )\n : null}\n </div>\n )\n})\n\nexport function XlsxWorkbookSurface({\n className,\n isDark,\n onIsDarkChange,\n onUploadClick,\n renderTableHeaderMenu,\n rounded,\n showNightRenderToggle,\n showToolbar = true,\n showUploadButton = true,\n toolbarActions,\n workbookIdentity,\n}: {\n className?: string\n isDark: boolean\n onIsDarkChange: (checked: boolean) => void\n onUploadClick: () => void\n renderTableHeaderMenu: (\n props: XlsxTableHeaderMenuRenderProps\n ) => React.ReactNode\n rounded: boolean\n showNightRenderToggle: boolean\n showToolbar?: boolean\n showUploadButton?: boolean\n toolbarActions?: React.ReactNode\n workbookIdentity: string\n}) {\n const { error } = useXlsxViewer()\n\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className,\n rounded && "rounded-lg"\n )}\n >\n {showToolbar ? (\n <WorkbookToolbar\n isDark={isDark}\n onIsDarkChange={onIsDarkChange}\n onUploadClick={onUploadClick}\n showNightRenderToggle={showNightRenderToggle}\n showUploadButton={showUploadButton}\n toolbarActions={toolbarActions}\n workbookIdentity={workbookIdentity}\n />\n ) : null}\n <div className="flex min-h-0 flex-1 flex-col">\n <div className="min-h-0 flex-1 bg-muted/20">\n <XlsxViewer\n experimentalCanvas\n allowResizeInReadOnly\n className="h-full min-h-0 min-w-0"\n height="100%"\n isDark={isDark}\n readOnly\n rounded={false}\n showDefaultToolbar={false}\n showImages\n fileTooLargeState={\n <div className="grid h-full w-full min-w-full place-items-center p-6">\n <div className="max-w-sm rounded-lg border bg-background p-4 text-sm">\n <p className="font-medium">File too large</p>\n <p className="mt-1 text-muted-foreground">\n This workbook exceeds the display limit. Download it to view\n the full file.\n </p>\n </div>\n </div>\n }\n loadingState={<ViewerLoadingSurface />}\n renderScroller={renderXlsxScroller}\n errorState={\n <div className="grid h-full w-full min-w-full place-items-center p-6 text-sm text-destructive">\n {error?.message ?? "Unable to display workbook."}\n </div>\n }\n renderTableHeaderMenu={renderTableHeaderMenu}\n />\n </div>\n <WorkbookSheetTabs workbookIdentity={workbookIdentity} />\n </div>\n </div>\n )\n}\n\nexport function XlsxViewerPreview({\n className,\n defaultIsDark = false,\n fileName,\n isDark: controlledIsDark,\n onIsDarkChange,\n rounded = false,\n showToolbar = true,\n showUpload = true,\n src,\n toolbarActions,\n}: {\n className?: string\n defaultIsDark?: boolean\n fileName?: string\n isDark?: boolean\n onIsDarkChange?: (isDark: boolean) => void\n rounded?: boolean\n showToolbar?: boolean\n showUpload?: boolean\n src?: string\n toolbarActions?: React.ReactNode\n}) {\n const [effectiveIsDark, setIsDark] = useControllableDarkMode({\n defaultIsDark,\n isDark: controlledIsDark,\n onIsDarkChange,\n })\n\n return (\n <XlsxViewerContent\n className={className}\n effectiveIsDark={effectiveIsDark}\n fileName={fileName}\n rounded={rounded}\n setNightRenderEnabled={setIsDark}\n shouldRenderNightMode\n showToolbar={showToolbar}\n showUpload={showUpload}\n toolbarActions={toolbarActions}\n url={src}\n />\n )\n}\n\nfunction XlsxViewerContent({\n className,\n effectiveIsDark,\n fileName,\n rounded,\n setNightRenderEnabled,\n shouldRenderNightMode,\n showToolbar = true,\n showUpload,\n toolbarActions,\n url,\n}: {\n className?: string\n effectiveIsDark: boolean\n fileName?: string\n rounded: boolean\n setNightRenderEnabled: (checked: boolean) => void\n shouldRenderNightMode: boolean\n showToolbar?: boolean\n showUpload: boolean\n toolbarActions?: React.ReactNode\n url?: string\n}) {\n const fileInputRef = React.useRef<HTMLInputElement>(null)\n const [uploadedWorkbook, setUploadedWorkbook] =\n React.useState<UploadedWorkbook | null>(null)\n const sourceFileName = React.useMemo(\n () =>\n url ? formatWorkbookName(fileName, url) : (fileName ?? "workbook.xlsx"),\n [fileName, url]\n )\n const displayFileName = React.useMemo(\n () => uploadedWorkbook?.fileName ?? sourceFileName,\n [sourceFileName, uploadedWorkbook?.fileName]\n )\n const workbookIdentity = React.useMemo(\n () => uploadedWorkbook?.identity ?? `${url ?? "empty"}::${displayFileName}`,\n [displayFileName, uploadedWorkbook?.identity, url]\n )\n const [workbookBuffer, setWorkbookBuffer] =\n React.useState<ArrayBuffer | null>(null)\n const [loadError, setLoadError] = React.useState<string>()\n const shouldShowLoadingSpinner = useDelayedLoadingIndicator(\n !workbookBuffer && !loadError && !uploadedWorkbook,\n XLSX_LOADING_INDICATOR_DELAY_MS\n )\n\n React.useEffect(() => {\n let isCurrent = true\n if (url) {\n setUploadedWorkbook(null)\n }\n\n async function loadWorkbook(): Promise<void> {\n if (!url) {\n setWorkbookBuffer(null)\n setLoadError(undefined)\n return\n }\n\n setWorkbookBuffer(null)\n setLoadError(undefined)\n\n try {\n const response = await fetch(url)\n if (!response.ok) {\n throw new Error(`Failed to fetch XLSX (${response.status})`)\n }\n\n const nextWorkbookBuffer = await response.arrayBuffer()\n if (!isCurrent) return\n\n setWorkbookBuffer(nextWorkbookBuffer)\n } catch (error) {\n if (!isCurrent) return\n\n setLoadError(\n error instanceof Error ? error.message : "Unknown XLSX load error"\n )\n }\n }\n\n void loadWorkbook()\n\n return () => {\n isCurrent = false\n }\n }, [url])\n\n async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {\n const file = event.target.files?.[0]\n event.target.value = ""\n\n if (!file) return\n\n const buffer = await file.arrayBuffer()\n setLoadError(undefined)\n setUploadedWorkbook({\n buffer,\n fileName: file.name,\n identity: `${file.name}-${file.size}-${file.lastModified}`,\n })\n }\n\n const activeBuffer = uploadedWorkbook?.buffer ?? workbookBuffer\n const activeFileName = uploadedWorkbook?.fileName ?? displayFileName\n const activeIdentity = workbookIdentity\n\n if (!url && !uploadedWorkbook) {\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className\n )}\n >\n <input\n ref={fileInputRef}\n type="file"\n accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"\n className="hidden"\n onChange={handleUpload}\n />\n <WorkbookStandaloneToolbar\n onUploadClick={() => fileInputRef.current?.click()}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n />\n <div className="grid min-h-0 flex-1 place-items-center bg-muted/30 p-4">\n <div className="max-w-md rounded-lg border bg-background p-4 text-center text-sm shadow-xs">\n <p className="font-medium">Upload a workbook to preview</p>\n <p className="mt-1 text-muted-foreground">\n Pass an XLSX URL with the <code>src</code> prop or upload a file.\n </p>\n <Button\n type="button"\n variant="outline"\n size="sm"\n className="mt-4"\n onClick={() => fileInputRef.current?.click()}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n Upload XLSX\n </Button>\n </div>\n </div>\n </div>\n )\n }\n\n if (loadError && !activeBuffer) {\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className\n )}\n >\n <input\n ref={fileInputRef}\n type="file"\n accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"\n className="hidden"\n onChange={handleUpload}\n />\n <WorkbookStandaloneToolbar\n onUploadClick={() => fileInputRef.current?.click()}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n />\n <div className="grid min-h-0 flex-1 place-items-center bg-muted/30 p-4">\n <div className="max-w-md rounded-lg border bg-background p-4 text-sm">\n <p className="font-medium">Unable to display workbook</p>\n <p className="mt-1 text-muted-foreground">{loadError}</p>\n <Button\n type="button"\n variant="outline"\n size="sm"\n className="mt-4"\n onClick={() => fileInputRef.current?.click()}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n Upload XLSX\n </Button>\n </div>\n </div>\n </div>\n )\n }\n\n if (!activeBuffer) {\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className\n )}\n >\n <input\n ref={fileInputRef}\n type="file"\n accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"\n className="hidden"\n onChange={handleUpload}\n />\n <WorkbookStandaloneToolbar\n onUploadClick={() => fileInputRef.current?.click()}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n />\n <ViewerLoadingSurface showSpinner={shouldShowLoadingSpinner} />\n </div>\n )\n }\n\n return (\n <div className={cn("overflow-hidden", className)}>\n <input\n ref={fileInputRef}\n type="file"\n accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"\n className="hidden"\n onChange={handleUpload}\n />\n <XlsxWorkbookLoadedViewer\n className={className}\n fileName={activeFileName}\n isDark={effectiveIsDark}\n onIsDarkChange={setNightRenderEnabled}\n onUploadClick={() => fileInputRef.current?.click()}\n renderTableHeaderMenu={(props) => (\n <WorkbookTableHeaderMenu {...props} />\n )}\n rounded={rounded}\n showNightRenderToggle={shouldRenderNightMode}\n showToolbar={showToolbar}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n workbookBuffer={activeBuffer}\n workbookIdentity={activeIdentity}\n />\n </div>\n )\n}\n\nfunction XlsxWorkbookLoadedViewer({\n className,\n fileName,\n isDark,\n onIsDarkChange,\n onUploadClick,\n renderTableHeaderMenu,\n rounded,\n showNightRenderToggle,\n showToolbar = true,\n showUploadButton,\n toolbarActions,\n workbookBuffer,\n workbookIdentity,\n}: {\n className?: string\n fileName: string\n isDark: boolean\n onIsDarkChange: (checked: boolean) => void\n onUploadClick: () => void\n renderTableHeaderMenu: (\n props: XlsxTableHeaderMenuRenderProps\n ) => React.ReactNode\n rounded: boolean\n showNightRenderToggle: boolean\n showToolbar?: boolean\n showUploadButton: boolean\n toolbarActions?: React.ReactNode\n workbookBuffer: ArrayBuffer\n workbookIdentity: string\n}) {\n const controller = useXlsxViewerController(\n React.useMemo(\n () => ({\n allowResizeInReadOnly: true,\n file: workbookBuffer,\n fileName,\n readOnly: true,\n useWorker: true,\n }),\n [fileName, workbookBuffer]\n )\n )\n\n return (\n <XlsxViewerProvider controller={controller} isDark={isDark}>\n <XlsxWorkbookSurface\n className={className}\n isDark={isDark}\n onIsDarkChange={onIsDarkChange}\n onUploadClick={onUploadClick}\n renderTableHeaderMenu={renderTableHeaderMenu}\n rounded={rounded}\n showNightRenderToggle={showNightRenderToggle}\n showToolbar={showToolbar}\n showUploadButton={showUploadButton}\n toolbarActions={toolbarActions}\n workbookIdentity={workbookIdentity}\n />\n </XlsxViewerProvider>\n )\n}\n'
+ '"use client"\n\nimport * as React from "react"\nimport {\n useXlsxViewer,\n useXlsxViewerController,\n useXlsxViewerThumbnails,\n useXlsxViewerZoom,\n XlsxViewer,\n XlsxViewerProvider,\n type XlsxScrollerRenderProps,\n type XlsxTableHeaderMenuRenderProps,\n} from "@extend-ai/react-xlsx"\nimport {\n Download01Icon,\n MinusSignCircleIcon,\n Moon02Icon,\n MoreHorizontalIcon,\n PlusSignCircleIcon,\n Sun03Icon,\n Upload01Icon,\n} from "@hugeicons/core-free-icons"\nimport { HugeiconsIcon } from "@hugeicons/react"\nimport { createPortal } from "react-dom"\n\nimport { cn } from "@/lib/utils"\nimport { Button } from "@/components/ui/button"\nimport {\n DropdownMenu,\n DropdownMenuContent,\n DropdownMenuItem,\n DropdownMenuRadioGroup,\n DropdownMenuRadioItem,\n DropdownMenuTrigger,\n} from "@/components/ui/dropdown-menu"\nimport { ScrollArea } from "@/components/ui/scroll-area"\nimport {\n Select,\n SelectContent,\n SelectItem,\n SelectTrigger,\n SelectValue,\n} from "@/components/ui/select"\nimport { Separator } from "@/components/ui/separator"\nimport { Spinner } from "@/components/ui/spinner"\nimport { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"\nimport {\n Tooltip,\n TooltipContent,\n TooltipProvider,\n TooltipTrigger,\n} from "@/components/ui/tooltip"\n\nconst XLSX_LOADING_INDICATOR_DELAY_MS = 300\nconst XLSX_DROPDOWN_Z_INDEX_CLASS = "z-40"\nconst ZOOM_OPTIONS = [10, 25, 50, 75, 100, 125, 150, 175, 200, 400] as const\n\n// Stable reference so the thumbnails memo isn\'t invalidated on every render\n// (e.g. by selection changes), which would recompute every sheet thumbnail.\nconst XLSX_SHEET_TAB_THUMBNAIL_OPTIONS = {\n resolution: {\n maxHeight: 360,\n maxWidth: 560,\n },\n} as const\n\ntype UploadedWorkbook = {\n buffer: ArrayBuffer\n fileName: string\n identity: string\n}\n\nfunction formatWorkbookName(fileName: string | undefined, url: string) {\n if (fileName?.trim()) return fileName\n\n const pathname = url.split("?")[0] ?? ""\n const rawName = pathname.split("/").pop() ?? "workbook.xlsx"\n\n try {\n return decodeURIComponent(rawName)\n } catch {\n return rawName\n }\n}\n\nfunction ensureWorkbookExtension(fileName: string) {\n const lowerFileName = fileName.toLowerCase()\n return lowerFileName.endsWith(".xlsx") || lowerFileName.endsWith(".xls")\n ? fileName\n : `${fileName}.xlsx`\n}\n\nfunction downloadWorkbookBuffer(buffer: ArrayBuffer, fileName: string) {\n const resolvedFileName = ensureWorkbookExtension(fileName)\n const blob = new Blob([buffer], {\n type: resolvedFileName.toLowerCase().endsWith(".xls")\n ? "application/vnd.ms-excel"\n : "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",\n })\n const url = URL.createObjectURL(blob)\n const anchor = document.createElement("a")\n\n anchor.href = url\n anchor.download = resolvedFileName\n anchor.rel = "noopener"\n document.body.append(anchor)\n anchor.click()\n anchor.remove()\n window.setTimeout(() => URL.revokeObjectURL(url), 0)\n}\n\nfunction useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {\n const [showSpinner, setShowSpinner] = React.useState(false)\n\n React.useEffect(() => {\n if (!isLoading) {\n setShowSpinner(false)\n return\n }\n\n const timeoutId = window.setTimeout(() => {\n setShowSpinner(true)\n }, delayMs)\n\n return () => window.clearTimeout(timeoutId)\n }, [delayMs, isLoading])\n\n return showSpinner\n}\n\nexport function useControllableDarkMode({\n defaultIsDark = false,\n isDark,\n onIsDarkChange,\n}: {\n defaultIsDark?: boolean\n isDark?: boolean\n onIsDarkChange?: (isDark: boolean) => void\n}) {\n const [uncontrolledIsDark, setUncontrolledIsDark] =\n React.useState(defaultIsDark)\n const resolvedIsDark = isDark ?? uncontrolledIsDark\n\n const setIsDark = React.useCallback(\n (nextIsDark: boolean) => {\n if (isDark === undefined) {\n setUncontrolledIsDark(nextIsDark)\n }\n\n onIsDarkChange?.(nextIsDark)\n },\n [isDark, onIsDarkChange]\n )\n\n return [resolvedIsDark, setIsDark] as const\n}\n\nfunction ToolbarTooltip({\n label,\n children,\n}: {\n label: string\n children: React.ReactNode\n}) {\n return (\n <Tooltip>\n <TooltipTrigger asChild>\n <span className="inline-flex">{children}</span>\n </TooltipTrigger>\n <TooltipContent side="bottom">{label}</TooltipContent>\n </Tooltip>\n )\n}\n\nfunction ViewerLoadingSurface({\n showSpinner = true,\n}: {\n showSpinner?: boolean\n}) {\n return (\n <div className="grid h-full min-h-52 w-full min-w-full place-items-center bg-transparent">\n {showSpinner ? <Spinner className="size-4" /> : null}\n </div>\n )\n}\n\nexport function renderXlsxScroller({\n children,\n viewportProps,\n}: XlsxScrollerRenderProps) {\n return (\n <ScrollArea\n className="h-full min-h-0 w-full min-w-0 flex-1"\n viewportProps={viewportProps}\n >\n {children}\n </ScrollArea>\n )\n}\n\nexport function WorkbookTableHeaderMenu({\n direction,\n sortAscending,\n sortDescending,\n triggerIcon,\n triggerProps,\n}: XlsxTableHeaderMenuRenderProps) {\n const [open, setOpen] = React.useState(false)\n\n return (\n <DropdownMenu open={open} onOpenChange={setOpen}>\n <DropdownMenuTrigger asChild>\n <Button\n {...triggerProps}\n type="button"\n variant="ghost"\n size="icon-sm"\n className={cn("size-6 rounded-sm", triggerProps.className)}\n aria-label="Column menu"\n >\n {triggerIcon ? (\n triggerIcon\n ) : (\n <HugeiconsIcon icon={MoreHorizontalIcon} className="size-3.5" />\n )}\n </Button>\n </DropdownMenuTrigger>\n <DropdownMenuContent\n align="end"\n className={cn("w-40", XLSX_DROPDOWN_Z_INDEX_CLASS)}\n >\n <DropdownMenuRadioGroup\n value={direction ?? ""}\n onValueChange={(value) => {\n if (value === "ascending") {\n sortAscending()\n } else {\n sortDescending()\n }\n setOpen(false)\n }}\n >\n <DropdownMenuRadioItem value="ascending">\n Sort ascending\n </DropdownMenuRadioItem>\n <DropdownMenuRadioItem value="descending">\n Sort descending\n </DropdownMenuRadioItem>\n </DropdownMenuRadioGroup>\n </DropdownMenuContent>\n </DropdownMenu>\n )\n}\n\nfunction WorkbookToolbar({\n isDark,\n onDownload,\n onIsDarkChange,\n onUploadClick,\n showDownloadButton = true,\n showNightRenderToggle,\n showUploadButton = true,\n toolbarActions,\n workbookIdentity,\n}: {\n isDark: boolean\n onDownload?: () => void\n onIsDarkChange: (checked: boolean) => void\n onUploadClick: () => void\n showDownloadButton?: boolean\n showNightRenderToggle: boolean\n showUploadButton?: boolean\n toolbarActions?: React.ReactNode\n workbookIdentity: string\n}) {\n const { canZoomIn, canZoomOut, setZoomScale, zoomIn, zoomOut, zoomScale } =\n useXlsxViewerZoom()\n const currentZoom = Math.round(zoomScale)\n\n React.useEffect(() => {\n setZoomScale(100)\n }, [setZoomScale, workbookIdentity])\n\n return (\n <div className="flex min-h-12 flex-wrap items-center justify-end gap-2 border-b bg-background px-3 py-2">\n <TooltipProvider>\n <div className="ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1">\n {showNightRenderToggle ? (\n <ToolbarTooltip\n label={isDark ? "Use light workbook" : "Use dark workbook"}\n >\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label={isDark ? "Use light workbook" : "Use dark workbook"}\n onClick={() => onIsDarkChange(!isDark)}\n >\n <HugeiconsIcon\n icon={isDark ? Sun03Icon : Moon02Icon}\n className="size-4"\n />\n </Button>\n </ToolbarTooltip>\n ) : null}\n <Separator orientation="vertical" className="mx-1 h-4 self-center" />\n <div className="flex flex-none items-center gap-1">\n <ToolbarTooltip label="Zoom out">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={!canZoomOut}\n aria-label="Zoom out"\n onClick={zoomOut}\n >\n <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n <Select\n value={currentZoom.toString()}\n onValueChange={(value) => setZoomScale(Number(value))}\n modal={false}\n >\n <SelectTrigger\n size="sm"\n className="w-[84px] min-w-[84px]"\n aria-label="Zoom level"\n >\n <SelectValue>{currentZoom}%</SelectValue>\n </SelectTrigger>\n <SelectContent\n align="end"\n alignItemWithTrigger={false}\n className={XLSX_DROPDOWN_Z_INDEX_CLASS}\n >\n {ZOOM_OPTIONS.map((value) => (\n <SelectItem key={value} value={value.toString()}>\n {value}%\n </SelectItem>\n ))}\n </SelectContent>\n </Select>\n <ToolbarTooltip label="Zoom in">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n disabled={!canZoomIn}\n aria-label="Zoom in"\n onClick={zoomIn}\n >\n <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </div>\n {showDownloadButton && onDownload ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n <ToolbarTooltip label="Download XLSX">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Download XLSX"\n onClick={onDownload}\n >\n <HugeiconsIcon icon={Download01Icon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </>\n ) : null}\n {showUploadButton ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n <ToolbarTooltip label="Upload XLSX">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Upload XLSX"\n onClick={onUploadClick}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n </>\n ) : null}\n {toolbarActions ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n {toolbarActions}\n </>\n ) : null}\n </div>\n </TooltipProvider>\n </div>\n )\n}\n\nfunction WorkbookStandaloneToolbar({\n onUploadClick,\n showUploadButton = true,\n toolbarActions,\n}: {\n onUploadClick: () => void\n showUploadButton?: boolean\n toolbarActions?: React.ReactNode\n}) {\n return (\n <div className="flex min-h-12 flex-wrap items-center justify-end gap-2 border-b bg-background px-3 py-2">\n <TooltipProvider>\n <div className="ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1">\n {showUploadButton ? (\n <ToolbarTooltip label="Upload XLSX">\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Upload XLSX"\n onClick={onUploadClick}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n </Button>\n </ToolbarTooltip>\n ) : null}\n {toolbarActions ? (\n <>\n {showUploadButton ? (\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n ) : null}\n {toolbarActions}\n </>\n ) : null}\n </div>\n </TooltipProvider>\n </div>\n )\n}\n\ntype WorkbookSheetTab = {\n name: string\n workbookSheetIndex: number\n}\n\ntype WorkbookSheetTabsInnerProps = {\n activeSheetIndex: number\n onActiveSheetIndexChange: (index: number) => void\n sheets: WorkbookSheetTab[]\n workbookIdentity: string\n}\n\nexport function WorkbookSheetTabs({\n workbookIdentity,\n}: {\n workbookIdentity: string\n}) {\n const { activeSheetIndex, setActiveSheetIndex, sheets } = useXlsxViewer()\n\n const handleActiveSheetIndexChange = React.useCallback(\n (index: number) => setActiveSheetIndex(index),\n [setActiveSheetIndex]\n )\n\n return (\n <WorkbookSheetTabsInner\n activeSheetIndex={activeSheetIndex}\n onActiveSheetIndexChange={handleActiveSheetIndexChange}\n sheets={sheets}\n workbookIdentity={workbookIdentity}\n />\n )\n}\n\nconst WorkbookSheetTabsInner = React.memo(function WorkbookSheetTabsInner({\n activeSheetIndex,\n onActiveSheetIndexChange,\n sheets,\n workbookIdentity,\n}: WorkbookSheetTabsInnerProps) {\n const [visiblePreviewIndex, setVisiblePreviewIndex] = React.useState<\n number | null\n >(null)\n const [previewPosition, setPreviewPosition] = React.useState({\n left: 0,\n top: 0,\n })\n const { thumbnails } = useXlsxViewerThumbnails(\n XLSX_SHEET_TAB_THUMBNAIL_OPTIONS\n )\n const [thumbnailUrls, setThumbnailUrls] = React.useState<\n Record<number, string>\n >({})\n const scrollRef = React.useRef<HTMLDivElement | null>(null)\n const itemRefs = React.useRef<Record<number, HTMLButtonElement | null>>({})\n const openTimeoutRef = React.useRef<ReturnType<typeof setTimeout> | null>(\n null\n )\n const closeTimeoutRef = React.useRef<ReturnType<typeof setTimeout> | null>(\n null\n )\n const previewWidth = 220\n const previewHeight = (previewWidth * 7) / 11\n const previewGap = 12\n const previewOpenDelayMs = 500\n\n const clearOpenTimeout = React.useCallback(() => {\n if (openTimeoutRef.current) {\n clearTimeout(openTimeoutRef.current)\n openTimeoutRef.current = null\n }\n }, [])\n\n const clearCloseTimeout = React.useCallback(() => {\n if (closeTimeoutRef.current) {\n clearTimeout(closeTimeoutRef.current)\n closeTimeoutRef.current = null\n }\n }, [])\n\n const getPreviewPosition = React.useCallback(\n (sheetIndex: number) => {\n const item = itemRefs.current[sheetIndex]\n if (!item || typeof window === "undefined") {\n return { left: 0, top: 0 }\n }\n\n const itemRect = item.getBoundingClientRect()\n const centeredLeft = itemRect.left + itemRect.width / 2 - previewWidth / 2\n const minLeft = 8\n const maxLeft = Math.max(minLeft, window.innerWidth - previewWidth - 8)\n const left = Math.max(minLeft, Math.min(centeredLeft, maxLeft))\n const top = Math.max(8, itemRect.top - previewHeight - previewGap)\n\n return { left, top }\n },\n [previewHeight]\n )\n\n const updatePreviewPosition = React.useCallback(\n (sheetIndex: number) => {\n setPreviewPosition(getPreviewPosition(sheetIndex))\n },\n [getPreviewPosition]\n )\n\n const handleItemEnter = React.useCallback(\n (sheetIndex: number) => {\n clearCloseTimeout()\n const nextPreviewPosition = getPreviewPosition(sheetIndex)\n\n if (visiblePreviewIndex !== null) {\n clearOpenTimeout()\n setPreviewPosition(nextPreviewPosition)\n setVisiblePreviewIndex(sheetIndex)\n return\n }\n\n clearOpenTimeout()\n openTimeoutRef.current = setTimeout(() => {\n setPreviewPosition(nextPreviewPosition)\n setVisiblePreviewIndex(sheetIndex)\n }, previewOpenDelayMs)\n },\n [\n clearCloseTimeout,\n clearOpenTimeout,\n getPreviewPosition,\n visiblePreviewIndex,\n ]\n )\n\n const handleContainerLeave = React.useCallback(() => {\n clearOpenTimeout()\n clearCloseTimeout()\n closeTimeoutRef.current = setTimeout(() => {\n setVisiblePreviewIndex(null)\n }, 80)\n }, [clearCloseTimeout, clearOpenTimeout])\n\n React.useEffect(() => {\n return () => {\n clearOpenTimeout()\n clearCloseTimeout()\n }\n }, [clearCloseTimeout, clearOpenTimeout])\n\n React.useEffect(() => {\n clearOpenTimeout()\n clearCloseTimeout()\n setVisiblePreviewIndex(null)\n setPreviewPosition({ left: 0, top: 0 })\n setThumbnailUrls({})\n }, [clearCloseTimeout, clearOpenTimeout, workbookIdentity])\n\n React.useEffect(() => {\n thumbnails.forEach((thumbnail) => {\n setThumbnailUrls((current) => {\n if (current[thumbnail.sheetIndex]) return current\n\n const canvas = document.createElement("canvas")\n canvas.width = thumbnail.width\n canvas.height = thumbnail.height\n\n if (!thumbnail.paint(canvas)) return current\n\n return {\n ...current,\n [thumbnail.sheetIndex]: canvas.toDataURL("image/png"),\n }\n })\n })\n }, [thumbnails])\n\n React.useEffect(() => {\n if (visiblePreviewIndex === null) return\n\n const handleReposition = () => updatePreviewPosition(visiblePreviewIndex)\n handleReposition()\n\n const scrollElement = scrollRef.current\n window.addEventListener("resize", handleReposition)\n scrollElement?.addEventListener("scroll", handleReposition, {\n passive: true,\n })\n\n return () => {\n window.removeEventListener("resize", handleReposition)\n scrollElement?.removeEventListener("scroll", handleReposition)\n }\n }, [updatePreviewPosition, visiblePreviewIndex])\n\n if (sheets.length <= 1) return null\n\n const previewSheet =\n visiblePreviewIndex === null ? null : sheets[visiblePreviewIndex]\n const previewUrl =\n visiblePreviewIndex === null\n ? null\n : (thumbnailUrls[visiblePreviewIndex] ?? null)\n\n return (\n <div\n className="border-t bg-muted/40 px-3 py-2"\n onMouseLeave={handleContainerLeave}\n >\n <Tabs\n value={String(activeSheetIndex)}\n onValueChange={(value) => onActiveSheetIndexChange(Number(value))}\n className="gap-0"\n >\n <ScrollArea\n orientation="horizontal"\n scrollbarGutter\n className="h-10 w-full has-[[data-slot=scroll-area-viewport][data-has-overflow-x]]:h-[50px]"\n viewportClassName="overflow-y-hidden"\n viewportRef={scrollRef}\n >\n <div className="flex h-full items-center">\n <TabsList className="shrink-0">\n {sheets.map((sheet, index) => (\n <TabsTrigger\n key={`${sheet.workbookSheetIndex}-${sheet.name}`}\n ref={(node) => {\n itemRefs.current[index] = node\n }}\n value={String(index)}\n className="max-w-48 flex-none"\n onMouseEnter={() => handleItemEnter(index)}\n >\n <span className="truncate">{sheet.name}</span>\n </TabsTrigger>\n ))}\n </TabsList>\n </div>\n </ScrollArea>\n </Tabs>\n {typeof document !== "undefined" &&\n previewSheet &&\n visiblePreviewIndex !== null &&\n previewUrl\n ? createPortal(\n <div\n className="pointer-events-none fixed z-40 translate-y-0 overflow-hidden rounded-lg border bg-background/95 opacity-100 shadow-xl backdrop-blur-md transition-[opacity,transform] duration-100"\n style={{\n left: previewPosition.left,\n top: previewPosition.top,\n width: previewWidth,\n }}\n >\n <div className="relative aspect-[11/7] w-full overflow-hidden bg-muted/60">\n <img\n key={`${workbookIdentity}-${visiblePreviewIndex}-${previewUrl}`}\n src={previewUrl}\n alt={`${previewSheet.name} preview`}\n className="absolute inset-0 h-full w-full object-cover object-left-top"\n />\n </div>\n </div>,\n document.body\n )\n : null}\n </div>\n )\n})\n\nexport function XlsxWorkbookSurface({\n className,\n isDark,\n onDownload,\n onIsDarkChange,\n onUploadClick,\n renderTableHeaderMenu,\n rounded,\n showDownloadButton = true,\n showNightRenderToggle,\n showToolbar = true,\n showUploadButton = true,\n toolbarActions,\n workbookIdentity,\n}: {\n className?: string\n isDark: boolean\n onDownload?: () => void\n onIsDarkChange: (checked: boolean) => void\n onUploadClick: () => void\n renderTableHeaderMenu: (\n props: XlsxTableHeaderMenuRenderProps\n ) => React.ReactNode\n rounded: boolean\n showDownloadButton?: boolean\n showNightRenderToggle: boolean\n showToolbar?: boolean\n showUploadButton?: boolean\n toolbarActions?: React.ReactNode\n workbookIdentity: string\n}) {\n const { error } = useXlsxViewer()\n\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className,\n rounded && "rounded-lg"\n )}\n >\n {showToolbar ? (\n <WorkbookToolbar\n isDark={isDark}\n onDownload={onDownload}\n onIsDarkChange={onIsDarkChange}\n onUploadClick={onUploadClick}\n showDownloadButton={showDownloadButton}\n showNightRenderToggle={showNightRenderToggle}\n showUploadButton={showUploadButton}\n toolbarActions={toolbarActions}\n workbookIdentity={workbookIdentity}\n />\n ) : null}\n <div className="flex min-h-0 flex-1 flex-col">\n <div className="min-h-0 flex-1 bg-muted/20">\n <XlsxViewer\n experimentalCanvas\n allowResizeInReadOnly\n className="h-full min-h-0 min-w-0"\n height="100%"\n isDark={isDark}\n readOnly\n rounded={false}\n showDefaultToolbar={false}\n showImages\n fileTooLargeState={\n <div className="grid h-full w-full min-w-full place-items-center p-6">\n <div className="max-w-sm rounded-lg border bg-background p-4 text-sm">\n <p className="font-medium">File too large</p>\n <p className="mt-1 text-muted-foreground">\n This workbook exceeds the display limit. Download it to view\n the full file.\n </p>\n </div>\n </div>\n }\n loadingState={<ViewerLoadingSurface />}\n renderScroller={renderXlsxScroller}\n errorState={\n <div className="grid h-full w-full min-w-full place-items-center p-6 text-sm text-destructive">\n {error?.message ?? "Unable to display workbook."}\n </div>\n }\n renderTableHeaderMenu={renderTableHeaderMenu}\n />\n </div>\n <WorkbookSheetTabs workbookIdentity={workbookIdentity} />\n </div>\n </div>\n )\n}\n\nexport function XlsxViewerPreview({\n className,\n defaultIsDark = false,\n fileName,\n isDark: controlledIsDark,\n onIsDarkChange,\n rounded = false,\n showDownload = true,\n showToolbar = true,\n showUpload = true,\n src,\n toolbarActions,\n}: {\n className?: string\n defaultIsDark?: boolean\n fileName?: string\n isDark?: boolean\n onIsDarkChange?: (isDark: boolean) => void\n rounded?: boolean\n showDownload?: boolean\n showToolbar?: boolean\n showUpload?: boolean\n src?: string\n toolbarActions?: React.ReactNode\n}) {\n const [effectiveIsDark, setIsDark] = useControllableDarkMode({\n defaultIsDark,\n isDark: controlledIsDark,\n onIsDarkChange,\n })\n\n return (\n <XlsxViewerContent\n className={className}\n effectiveIsDark={effectiveIsDark}\n fileName={fileName}\n rounded={rounded}\n setNightRenderEnabled={setIsDark}\n shouldRenderNightMode\n showDownload={showDownload}\n showToolbar={showToolbar}\n showUpload={showUpload}\n toolbarActions={toolbarActions}\n url={src}\n />\n )\n}\n\nfunction XlsxViewerContent({\n className,\n effectiveIsDark,\n fileName,\n rounded,\n setNightRenderEnabled,\n shouldRenderNightMode,\n showDownload,\n showToolbar = true,\n showUpload,\n toolbarActions,\n url,\n}: {\n className?: string\n effectiveIsDark: boolean\n fileName?: string\n rounded: boolean\n setNightRenderEnabled: (checked: boolean) => void\n shouldRenderNightMode: boolean\n showDownload: boolean\n showToolbar?: boolean\n showUpload: boolean\n toolbarActions?: React.ReactNode\n url?: string\n}) {\n const fileInputRef = React.useRef<HTMLInputElement>(null)\n const [uploadedWorkbook, setUploadedWorkbook] =\n React.useState<UploadedWorkbook | null>(null)\n const sourceFileName = React.useMemo(\n () =>\n url ? formatWorkbookName(fileName, url) : (fileName ?? "workbook.xlsx"),\n [fileName, url]\n )\n const displayFileName = React.useMemo(\n () => uploadedWorkbook?.fileName ?? sourceFileName,\n [sourceFileName, uploadedWorkbook?.fileName]\n )\n const workbookIdentity = React.useMemo(\n () => uploadedWorkbook?.identity ?? `${url ?? "empty"}::${displayFileName}`,\n [displayFileName, uploadedWorkbook?.identity, url]\n )\n const [workbookBuffer, setWorkbookBuffer] =\n React.useState<ArrayBuffer | null>(null)\n const [loadError, setLoadError] = React.useState<string>()\n const shouldShowLoadingSpinner = useDelayedLoadingIndicator(\n !workbookBuffer && !loadError && !uploadedWorkbook,\n XLSX_LOADING_INDICATOR_DELAY_MS\n )\n\n React.useEffect(() => {\n let isCurrent = true\n if (url) {\n setUploadedWorkbook(null)\n }\n\n async function loadWorkbook(): Promise<void> {\n if (!url) {\n setWorkbookBuffer(null)\n setLoadError(undefined)\n return\n }\n\n setWorkbookBuffer(null)\n setLoadError(undefined)\n\n try {\n const response = await fetch(url)\n if (!response.ok) {\n throw new Error(`Failed to fetch XLSX (${response.status})`)\n }\n\n const nextWorkbookBuffer = await response.arrayBuffer()\n if (!isCurrent) return\n\n setWorkbookBuffer(nextWorkbookBuffer)\n } catch (error) {\n if (!isCurrent) return\n\n setLoadError(\n error instanceof Error ? error.message : "Unknown XLSX load error"\n )\n }\n }\n\n void loadWorkbook()\n\n return () => {\n isCurrent = false\n }\n }, [url])\n\n async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {\n const file = event.target.files?.[0]\n event.target.value = ""\n\n if (!file) return\n\n const buffer = await file.arrayBuffer()\n setLoadError(undefined)\n setUploadedWorkbook({\n buffer,\n fileName: file.name,\n identity: `${file.name}-${file.size}-${file.lastModified}`,\n })\n }\n\n const activeBuffer = uploadedWorkbook?.buffer ?? workbookBuffer\n const activeFileName = uploadedWorkbook?.fileName ?? displayFileName\n const activeIdentity = workbookIdentity\n\n if (!url && !uploadedWorkbook) {\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className\n )}\n >\n <input\n ref={fileInputRef}\n type="file"\n accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"\n className="hidden"\n onChange={handleUpload}\n />\n <WorkbookStandaloneToolbar\n onUploadClick={() => fileInputRef.current?.click()}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n />\n <div className="grid min-h-0 flex-1 place-items-center bg-muted/30 p-4">\n <div className="max-w-md rounded-lg border bg-background p-4 text-center text-sm shadow-xs">\n <p className="font-medium">Upload a workbook to preview</p>\n <p className="mt-1 text-muted-foreground">\n Pass an XLSX URL with the <code>src</code> prop or upload a file.\n </p>\n <Button\n type="button"\n variant="outline"\n size="sm"\n className="mt-4"\n onClick={() => fileInputRef.current?.click()}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n Upload XLSX\n </Button>\n </div>\n </div>\n </div>\n )\n }\n\n if (loadError && !activeBuffer) {\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className\n )}\n >\n <input\n ref={fileInputRef}\n type="file"\n accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"\n className="hidden"\n onChange={handleUpload}\n />\n <WorkbookStandaloneToolbar\n onUploadClick={() => fileInputRef.current?.click()}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n />\n <div className="grid min-h-0 flex-1 place-items-center bg-muted/30 p-4">\n <div className="max-w-md rounded-lg border bg-background p-4 text-sm">\n <p className="font-medium">Unable to display workbook</p>\n <p className="mt-1 text-muted-foreground">{loadError}</p>\n <Button\n type="button"\n variant="outline"\n size="sm"\n className="mt-4"\n onClick={() => fileInputRef.current?.click()}\n >\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n Upload XLSX\n </Button>\n </div>\n </div>\n </div>\n )\n }\n\n if (!activeBuffer) {\n return (\n <div\n className={cn(\n "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",\n className\n )}\n >\n <input\n ref={fileInputRef}\n type="file"\n accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"\n className="hidden"\n onChange={handleUpload}\n />\n <WorkbookStandaloneToolbar\n onUploadClick={() => fileInputRef.current?.click()}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n />\n <ViewerLoadingSurface showSpinner={shouldShowLoadingSpinner} />\n </div>\n )\n }\n\n return (\n <div className={cn("overflow-hidden", className)}>\n <input\n ref={fileInputRef}\n type="file"\n accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"\n className="hidden"\n onChange={handleUpload}\n />\n <XlsxWorkbookLoadedViewer\n className={className}\n fileName={activeFileName}\n isDark={effectiveIsDark}\n onDownload={() => downloadWorkbookBuffer(activeBuffer, activeFileName)}\n onIsDarkChange={setNightRenderEnabled}\n onUploadClick={() => fileInputRef.current?.click()}\n renderTableHeaderMenu={(props) => (\n <WorkbookTableHeaderMenu {...props} />\n )}\n rounded={rounded}\n showDownloadButton={showDownload}\n showNightRenderToggle={shouldRenderNightMode}\n showToolbar={showToolbar}\n showUploadButton={showUpload}\n toolbarActions={toolbarActions}\n workbookBuffer={activeBuffer}\n workbookIdentity={activeIdentity}\n />\n </div>\n )\n}\n\nfunction XlsxWorkbookLoadedViewer({\n className,\n fileName,\n isDark,\n onDownload,\n onIsDarkChange,\n onUploadClick,\n renderTableHeaderMenu,\n rounded,\n showDownloadButton,\n showNightRenderToggle,\n showToolbar = true,\n showUploadButton,\n toolbarActions,\n workbookBuffer,\n workbookIdentity,\n}: {\n className?: string\n fileName: string\n isDark: boolean\n onDownload: () => void\n onIsDarkChange: (checked: boolean) => void\n onUploadClick: () => void\n renderTableHeaderMenu: (\n props: XlsxTableHeaderMenuRenderProps\n ) => React.ReactNode\n rounded: boolean\n showDownloadButton: boolean\n showNightRenderToggle: boolean\n showToolbar?: boolean\n showUploadButton: boolean\n toolbarActions?: React.ReactNode\n workbookBuffer: ArrayBuffer\n workbookIdentity: string\n}) {\n const controller = useXlsxViewerController(\n React.useMemo(\n () => ({\n allowResizeInReadOnly: true,\n file: workbookBuffer,\n fileName,\n readOnly: true,\n useWorker: true,\n }),\n [fileName, workbookBuffer]\n )\n )\n\n return (\n <XlsxViewerProvider controller={controller} isDark={isDark}>\n <XlsxWorkbookSurface\n className={className}\n isDark={isDark}\n onDownload={onDownload}\n onIsDarkChange={onIsDarkChange}\n onUploadClick={onUploadClick}\n renderTableHeaderMenu={renderTableHeaderMenu}\n rounded={rounded}\n showDownloadButton={showDownloadButton}\n showNightRenderToggle={showNightRenderToggle}\n showToolbar={showToolbar}\n showUploadButton={showUploadButton}\n toolbarActions={toolbarActions}\n workbookIdentity={workbookIdentity}\n />\n </XlsxViewerProvider>\n )\n}\n'
export function XlsxViewerSource() {
return (
diff --git a/apps/v4/lib/pdf-viewer-blocks.ts b/apps/v4/lib/pdf-viewer-blocks.ts
index 6c3404c..605b6fd 100644
--- a/apps/v4/lib/pdf-viewer-blocks.ts
+++ b/apps/v4/lib/pdf-viewer-blocks.ts
@@ -34,6 +34,15 @@ export const PDF_VIEWER_BLOCKS = [
docsHref: "/docs/components/bounding-box-citations",
viewHref: "/view/blocks/bounding-box-citations",
},
+ {
+ id: "file-system",
+ title: "File System (Finder)",
+ description:
+ "A Finder-style file browser that opens PDF, DOCX, XLSX, and image files in viewer dialogs.",
+ command: getRegistryAddCommand("file-system-block"),
+ docsHref: "/docs/components/file-system",
+ viewHref: "/view/blocks/file-system",
+ },
{
id: "pdf-dropzone",
title: "PDF Dropzone",
@@ -82,15 +91,6 @@ export const PDF_VIEWER_BLOCKS = [
viewHref: "/view/blocks/docx-editor-block",
previewHeightClassName: "h-[720px]",
},
- {
- id: "file-system",
- title: "File System (Finder)",
- description:
- "A Finder-style file browser that opens PDF, DOCX, XLSX, and image files in viewer dialogs.",
- command: getRegistryAddCommand("file-system-block"),
- docsHref: "/docs/components/file-system",
- viewHref: "/view/blocks/file-system",
- },
] as const satisfies readonly PdfViewerBlockConfig[]
export type PdfViewerBlockId = (typeof PDF_VIEWER_BLOCKS)[number]["id"]