Skip to content

armgit / ui

Public Imported from GitHub
0
TypeScript

Polish DOCX viewer docs source code snippet

Andrew Luo6c00045e5208
diff --git a/apps/v4/components/docx-viewer-docs.tsx b/apps/v4/components/docx-viewer-docs.tsx
index dac6982..de2e69d 100644
--- a/apps/v4/components/docx-viewer-docs.tsx
+++ b/apps/v4/components/docx-viewer-docs.tsx
@@ -65,7 +65,7 @@ export function DocxViewerExample() {
}`
const docxViewerSourceCode =
- '"use client"\n\nimport * as React from "react"\nimport {\n DocxEditorViewer,\n useDocxComments,\n useDocxEditor,\n useDocxPageLayout,\n useDocxTrackChanges,\n useDocxViewerThumbnails,\n type DocxDocumentTheme,\n type DocxEditorController,\n type DocxPageThumbnailItem,\n} from "@extend-ai/react-docx"\nimport {\n Comment01Icon,\n Download01Icon,\n MinusSignCircleIcon,\n Moon02Icon,\n MoreHorizontalIcon,\n PlusSignCircleIcon,\n SidebarLeftIcon,\n Upload01Icon,\n} from "@hugeicons/core-free-icons"\nimport { HugeiconsIcon } from "@hugeicons/react"\nimport { useVirtualizer } from "@tanstack/react-virtual"\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 {\n renderDocxCommentCard,\n renderDocxTrackedChangeCard,\n} from "@/components/ui/docx-annotation-card"\nimport {\n DropdownMenu,\n DropdownMenuCheckboxItem,\n DropdownMenuContent,\n DropdownMenuItem,\n DropdownMenuSeparator,\n DropdownMenuTrigger,\n} from "@/components/ui/dropdown-menu"\nimport { FileThumbnail } from "@/components/ui/file-thumbnail"\nimport { Input } from "@/components/ui/input"\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 DOCX_THUMBNAIL_LIST_PADDING = 16\nconst DOCX_THUMBNAIL_ROW_ESTIMATE = 172\nconst DEFAULT_ZOOM = 50\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"\nconst DOCX_THUMBNAIL_FOCUS_RING_CLASS =\n "group-focus-visible/docx-thumbnail-sidebar:ring-2 group-focus-visible/docx-thumbnail-sidebar:ring-ring group-focus-visible/docx-thumbnail-sidebar:ring-offset-1 group-focus-visible/docx-thumbnail-sidebar:ring-offset-background"\n\ntype UploadedDocxFile = {\n file: File\n identity: string\n sourceUrl: string | undefined\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 normalizeDocxZoomScale(value: number | undefined): number {\n return typeof value === "number" &&\n ZOOM_OPTIONS.includes(value as (typeof ZOOM_OPTIONS)[number])\n ? value\n : DEFAULT_ZOOM\n}\n\nfunction useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {\n const [showSpinner, setShowSpinner] = React.useState(false)\n\n React.useEffect(() => {\n if (!isLoading) return\n\n const timeoutId = window.setTimeout(() => {\n setShowSpinner(true)\n }, delayMs)\n\n return () => {\n window.clearTimeout(timeoutId)\n setShowSpinner(false)\n }\n }, [delayMs, isLoading])\n\n return isLoading && showSpinner\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 isInteractiveViewerTarget(target: EventTarget | null) {\n return (\n target instanceof Element &&\n Boolean(\n target.closest(\n \'a[href], button, input, select, textarea, [contenteditable="true"], [role="button"], [role="link"]\'\n )\n )\n )\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 DocxFileActionsMenu({\n controlsDisabled,\n downloadDisabled,\n isPreparingDownload,\n isDark,\n onDownload,\n onIsDarkChange,\n onShowDocumentMarkupChange,\n onUploadClick,\n showDocumentMarkup,\n showDownloadButton,\n showNightRenderToggle,\n showUploadButton,\n}: {\n controlsDisabled: boolean\n downloadDisabled: boolean\n isPreparingDownload: boolean\n isDark: boolean\n onDownload: () => void\n onIsDarkChange: (checked: boolean) => void\n onShowDocumentMarkupChange: (checked: boolean) => void\n onUploadClick: () => void\n showDocumentMarkup: boolean\n showDownloadButton: boolean\n showNightRenderToggle: boolean\n showUploadButton: boolean\n}) {\n const showFileActions = showDownloadButton || showUploadButton\n\n return (\n <DropdownMenu>\n <DropdownMenuTrigger asChild>\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Open DOCX actions"\n >\n <HugeiconsIcon icon={MoreHorizontalIcon} className="size-4" />\n </Button>\n </DropdownMenuTrigger>\n <DropdownMenuContent align="end" className="w-52">\n {showNightRenderToggle ? (\n <>\n <DropdownMenuCheckboxItem\n checked={isDark}\n disabled={controlsDisabled}\n variant="switch"\n onCheckedChange={(checked) => onIsDarkChange(checked === true)}\n >\n <span className="flex min-w-0 items-center gap-2">\n <HugeiconsIcon icon={Moon02Icon} className="size-4" />\n Dark mode\n </span>\n </DropdownMenuCheckboxItem>\n <DropdownMenuSeparator />\n </>\n ) : null}\n <DropdownMenuCheckboxItem\n checked={showDocumentMarkup}\n disabled={controlsDisabled}\n variant="switch"\n onCheckedChange={(checked) =>\n onShowDocumentMarkupChange(checked === true)\n }\n >\n <span className="flex min-w-0 items-center gap-2">\n <HugeiconsIcon icon={Comment01Icon} className="size-4" />\n Comments/edits\n </span>\n </DropdownMenuCheckboxItem>\n {showFileActions ? <DropdownMenuSeparator /> : null}\n {showDownloadButton ? (\n <DropdownMenuItem disabled={downloadDisabled} onClick={onDownload}>\n {isPreparingDownload ? (\n <Spinner className="size-4" />\n ) : (\n <HugeiconsIcon icon={Download01Icon} className="size-4" />\n )}\n Download\n </DropdownMenuItem>\n ) : null}\n {showUploadButton ? (\n <DropdownMenuItem onClick={onUploadClick}>\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n Upload\n </DropdownMenuItem>\n ) : null}\n </DropdownMenuContent>\n </DropdownMenu>\n )\n}\n\nfunction DocxPageNumberControl({\n activePage,\n controlsDisabled,\n onPageChange,\n pageCount,\n}: {\n activePage: number\n controlsDisabled: boolean\n onPageChange: (pageNumber: number) => void\n pageCount: number\n}) {\n const inputRef = React.useRef<HTMLInputElement>(null)\n const displayPage = pageCount ? activePage : 1\n const [isEditing, setIsEditing] = React.useState(false)\n const [draftPage, setDraftPage] = React.useState(() => String(displayPage))\n\n React.useEffect(() => {\n if (!isEditing) {\n setDraftPage(String(displayPage))\n }\n }, [displayPage, isEditing])\n\n React.useEffect(() => {\n if (!isEditing) return\n\n inputRef.current?.focus()\n inputRef.current?.select()\n }, [isEditing])\n\n const applyPageDraft = React.useCallback(\n (value: string) => {\n const trimmedValue = value.trim()\n\n if (!trimmedValue) return\n\n const parsedPage = Number(trimmedValue)\n\n if (!Number.isInteger(parsedPage)) return\n\n onPageChange(Math.min(Math.max(parsedPage, 1), Math.max(pageCount, 1)))\n },\n [onPageChange, pageCount]\n )\n\n return (\n <div className="flex items-center text-sm whitespace-nowrap text-primary">\n <span>Page</span>\n {isEditing ? (\n <Input\n ref={inputRef}\n aria-label="Page number"\n inputMode="numeric"\n pattern="[0-9]*"\n size="sm"\n value={draftPage}\n className="mx-1 w-14 min-w-14 rounded-md [&_[data-slot=input]]:text-center"\n onBlur={() => setIsEditing(false)}\n onChange={(event: React.ChangeEvent<HTMLInputElement>) => {\n const nextValue = event.target.value\n\n setDraftPage(nextValue)\n applyPageDraft(nextValue)\n }}\n onKeyDown={(event: React.KeyboardEvent<HTMLInputElement>) => {\n if (event.key === "Enter" || event.key === "Escape") {\n event.currentTarget.blur()\n }\n }}\n />\n ) : (\n <Button\n type="button"\n variant="ghost"\n size="sm"\n className="font-normal"\n aria-label={`Current page ${displayPage}. Edit page number`}\n disabled={controlsDisabled || !pageCount}\n onClick={() => {\n setDraftPage(String(displayPage))\n setIsEditing(true)\n }}\n >\n {displayPage}\n </Button>\n )}\n <span>of {pageCount || "-"}</span>\n </div>\n )\n}\n\nfunction DocxToolbar({\n activePage,\n controlsDisabled,\n isDark,\n isPreparingDownload,\n onDownload,\n onIsDarkChange,\n onPageChange,\n onShowDocumentMarkupChange,\n onToggleSidebar,\n onUploadClick,\n pageCount,\n setZoomScale,\n showDocumentMarkup,\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 onPageChange: (pageNumber: number) => void\n onShowDocumentMarkupChange: (checked: boolean) => void\n onToggleSidebar: () => void\n onUploadClick: () => void\n pageCount: number\n setZoomScale: React.Dispatch<React.SetStateAction<number>>\n showDocumentMarkup: boolean\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 <DocxPageNumberControl\n activePage={activePage}\n controlsDisabled={controlsDisabled}\n onPageChange={onPageChange}\n pageCount={pageCount}\n />\n </div>\n <div className="ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1">\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 {toolbarActions ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n {toolbarActions}\n </>\n ) : null}\n <Separator orientation="vertical" className="mx-1 h-4 self-center" />\n <DocxFileActionsMenu\n controlsDisabled={controlsDisabled}\n downloadDisabled={controlsDisabled || isPreparingDownload}\n isPreparingDownload={isPreparingDownload}\n isDark={isDark}\n onDownload={onDownload}\n onIsDarkChange={onIsDarkChange}\n onShowDocumentMarkupChange={onShowDocumentMarkupChange}\n onUploadClick={onUploadClick}\n showDocumentMarkup={showDocumentMarkup}\n showDownloadButton={showDownloadButton}\n showNightRenderToggle={showNightRenderToggle}\n showUploadButton={showUploadButton}\n />\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\nfunction DocxThumbnailSidebarList({\n activePage,\n displayFileName,\n isLoadingDocument,\n onSelectPage,\n pageCount,\n sidebarOpen,\n thumbnails,\n}: {\n activePage: number\n displayFileName: string\n isLoadingDocument: boolean\n onSelectPage: (pageNumber: number) => void\n pageCount: number\n sidebarOpen: boolean\n thumbnails: DocxPageThumbnailItem[]\n}) {\n const viewportRef = React.useRef<HTMLDivElement | null>(null)\n const thumbnailListboxId = React.useId()\n const visibleThumbnails = React.useMemo(\n () => thumbnails.slice(0, pageCount || 0),\n [pageCount, thumbnails]\n )\n const activeDescendantId =\n activePage > 0 && visibleThumbnails.length\n ? `${thumbnailListboxId}-page-${activePage}`\n : undefined\n // eslint-disable-next-line react-hooks/incompatible-library -- TanStack Virtual returns imperative helpers used by the thumbnail rail.\n const virtualizer = useVirtualizer({\n count: visibleThumbnails.length,\n estimateSize: () => DOCX_THUMBNAIL_ROW_ESTIMATE,\n getItemKey: (index) => visibleThumbnails[index]?.pageIndex ?? index,\n getScrollElement: () => viewportRef.current,\n overscan: 3,\n })\n\n React.useEffect(() => {\n if (!sidebarOpen || activePage < 1 || !visibleThumbnails.length) return\n\n virtualizer.scrollToIndex(\n Math.min(activePage - 1, visibleThumbnails.length - 1),\n { align: "auto" }\n )\n }, [activePage, sidebarOpen, virtualizer, visibleThumbnails.length])\n\n const handleKeyDown = React.useCallback(\n (event: React.KeyboardEvent<HTMLDivElement>) => {\n if (pageCount < 1) return\n\n const currentPage = activePage > 0 ? activePage : 1\n let nextPage: number | null = null\n\n if (event.key === "ArrowDown") {\n nextPage = Math.min(pageCount, currentPage + 1)\n } else if (event.key === "ArrowUp") {\n nextPage = Math.max(1, currentPage - 1)\n } else if (event.key === "Home") {\n nextPage = 1\n } else if (event.key === "End") {\n nextPage = pageCount\n }\n\n if (nextPage === null) return\n\n event.preventDefault()\n onSelectPage(nextPage)\n },\n [activePage, onSelectPage, pageCount]\n )\n\n return (\n <ScrollArea\n className="h-full"\n scrollFade\n viewportClassName="group/docx-thumbnail-sidebar focus-visible:ring-0 focus-visible:ring-offset-0"\n viewportProps={{\n "aria-activedescendant": activeDescendantId,\n "aria-busy": isLoadingDocument || undefined,\n "aria-label": "DOCX pages",\n onKeyDown: handleKeyDown,\n onMouseDown: (event) => {\n event.currentTarget.focus({ preventScroll: true })\n },\n role: "listbox",\n tabIndex: 0,\n }}\n viewportRef={viewportRef}\n >\n {isLoadingDocument ? (\n <div className="p-4">\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 </div>\n ) : visibleThumbnails.length ? (\n <div\n className="relative"\n style={{\n height:\n virtualizer.getTotalSize() + DOCX_THUMBNAIL_LIST_PADDING * 2,\n }}\n >\n {virtualizer.getVirtualItems().map((virtualRow) => {\n const thumbnail = visibleThumbnails[virtualRow.index]\n if (!thumbnail) return null\n\n return (\n <div\n key={virtualRow.key}\n ref={virtualizer.measureElement}\n data-index={virtualRow.index}\n className={cn(\n "absolute top-0 right-3 left-3 pb-3 [contain:layout]",\n thumbnail.pageNumber === activePage && "z-10"\n )}\n style={{\n transform: `translateY(${\n virtualRow.start + DOCX_THUMBNAIL_LIST_PADDING\n }px)`,\n }}\n >\n <div\n id={`${thumbnailListboxId}-page-${thumbnail.pageNumber}`}\n role="option"\n aria-current={\n thumbnail.pageNumber === activePage ? "page" : undefined\n }\n aria-label={`Page ${thumbnail.pageNumber}`}\n aria-posinset={thumbnail.pageNumber}\n aria-selected={thumbnail.pageNumber === activePage}\n aria-setsize={pageCount}\n data-docx-viewer-thumbnail-option={thumbnail.pageNumber}\n className={cn(\n "flex h-auto w-full cursor-default flex-col items-center gap-2 rounded-md p-2 text-xs transition-shadow outline-none select-none hover:bg-sidebar-accent",\n thumbnail.pageNumber === activePage &&\n "bg-sidebar-accent text-foreground",\n thumbnail.pageNumber !== activePage &&\n "text-muted-foreground",\n thumbnail.pageNumber === activePage &&\n DOCX_THUMBNAIL_FOCUS_RING_CLASS\n )}\n onClick={() => onSelectPage(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.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 </div>\n </div>\n )\n })}\n </div>\n ) : null}\n </ScrollArea>\n )\n}\n\nexport function DocxViewerPreview({\n className,\n defaultZoom = DEFAULT_ZOOM,\n fileName,\n isDark,\n onIsDarkChange,\n showDownload = true,\n showToolbar = true,\n showUpload = true,\n src,\n toolbarActions,\n}: {\n className?: string\n defaultZoom?: number\n fileName?: string\n isDark: boolean\n onIsDarkChange: (isDark: boolean) => void\n showDownload?: boolean\n showToolbar?: boolean\n showUpload?: boolean\n src?: string\n toolbarActions?: React.ReactNode\n}) {\n return (\n <DocxViewerContent\n className={className}\n defaultZoom={defaultZoom}\n effectiveIsDark={isDark}\n fileName={fileName}\n setNightRenderEnabled={onIsDarkChange}\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 defaultZoom,\n effectiveIsDark,\n fileName,\n setNightRenderEnabled,\n shouldRenderNightMode,\n showDownload,\n showToolbar = true,\n showUpload,\n toolbarActions,\n url,\n}: {\n className?: string\n defaultZoom?: number\n effectiveIsDark: boolean\n fileName?: string\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 [viewportElement, setViewportElement] =\n React.useState<HTMLDivElement | null>(null)\n const [viewerShellRef, viewerShellWidth] = useElementWidth<HTMLDivElement>()\n const [uploadedDocxFile, setUploadedDocxFile] =\n React.useState<UploadedDocxFile | null>(null)\n const [sidebarOpen, setSidebarOpen] = React.useState(false)\n const resolvedDefaultZoomScale = normalizeDocxZoomScale(defaultZoom)\n const activeUploadedDocxFile =\n uploadedDocxFile?.sourceUrl === url ? uploadedDocxFile : null\n const documentKey = activeUploadedDocxFile?.identity ?? url ?? ""\n const [activePageState, setActivePageState] = React.useState({\n documentKey: "",\n value: 1,\n })\n const activePage =\n activePageState.documentKey === documentKey ? activePageState.value : 1\n const setActivePage = React.useCallback<\n React.Dispatch<React.SetStateAction<number>>\n >(\n (nextPage) => {\n setActivePageState((currentState) => {\n const currentPage =\n currentState.documentKey === documentKey ? currentState.value : 1\n const value =\n typeof nextPage === "function" ? nextPage(currentPage) : nextPage\n\n return { documentKey, value }\n })\n },\n [documentKey]\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 activeUploadedDocxFile?.file.name ??\n (url ? formatDocumentName(fileName, url) : (fileName ?? "document.docx")),\n [activeUploadedDocxFile?.file.name, fileName, 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 { layout: pageLayout } = useDocxPageLayout(editor)\n const { importDocxFile, setDocumentTheme, status } = editor\n const { showComments, setShowComments } = useDocxComments(editor)\n const { showTrackedChanges, setShowTrackedChanges } =\n useDocxTrackChanges(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 // Detached thumbnail rendering handles offscreen pages; keep the raster\n // queue dormant while the sidebar is closed.\n disabled: !sidebarOpen,\n pixelRatio: 2,\n resolution: {\n maxHeight: DOCX_THUMBNAIL_WIDTH * 1.35,\n maxWidth: DOCX_THUMBNAIL_WIDTH,\n },\n }),\n [sidebarOpen]\n )\n const { thumbnails } = useDocxViewerThumbnails(\n thumbnailEditor,\n thumbnailOptions\n )\n const [zoomScaleState, setZoomScaleState] = React.useState({\n documentKey: "",\n value: resolvedDefaultZoomScale,\n })\n const zoomScale =\n zoomScaleState.documentKey === documentKey\n ? zoomScaleState.value\n : resolvedDefaultZoomScale\n const setZoomScale = React.useCallback<\n React.Dispatch<React.SetStateAction<number>>\n >(\n (nextZoomScale) => {\n setZoomScaleState((currentState) => {\n const currentZoomScale =\n currentState.documentKey === documentKey\n ? currentState.value\n : resolvedDefaultZoomScale\n const value =\n typeof nextZoomScale === "function"\n ? nextZoomScale(currentZoomScale)\n : nextZoomScale\n\n return { documentKey, value }\n })\n },\n [documentKey, resolvedDefaultZoomScale]\n )\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 || activeUploadedDocxFile)\n const pageCount =\n hasDocument && !isLoadingDocument && !loadError\n ? Math.max(1, reportedPageCount || editor.totalPages)\n : 0\n const thumbnailSidebarVisible = Boolean(\n sidebarOpen && (pageCount || isLoadingDocument)\n )\n const controlsDisabled =\n !hasDocument || isLoadingDocument || Boolean(loadError)\n const showDocumentMarkup = showComments || showTrackedChanges\n const handlePageCountChange = React.useCallback((nextPageCount: number) => {\n setReportedPageCount(Math.max(1, Math.round(nextPageCount || 1)))\n }, [])\n const setViewportRef = React.useCallback((element: HTMLDivElement | null) => {\n viewportRef.current = element\n setViewportElement(element)\n }, [])\n const pageVirtualization = React.useMemo(\n () => ({\n enabled: true,\n overscan: 1,\n scrollElement: viewportElement,\n zoomScale: zoomScale / 100,\n }),\n [viewportElement, zoomScale]\n )\n const handleDownload = React.useCallback(async () => {\n if (isPreparingDownload) return\n if (!activeUploadedDocxFile && !url) return\n\n setIsPreparingDownload(true)\n\n try {\n await downloadDocxFile({\n file: activeUploadedDocxFile?.file,\n fileName: displayFileName,\n url,\n })\n } catch (error) {\n console.error(error)\n } finally {\n setIsPreparingDownload(false)\n }\n }, [activeUploadedDocxFile, displayFileName, isPreparingDownload, url])\n const handleShowDocumentMarkupChange = React.useCallback(\n (checked: boolean) => {\n setShowComments(checked)\n setShowTrackedChanges(checked)\n },\n [setShowComments, setShowTrackedChanges]\n )\n\n useSuppressDocxPaddingWarning(!isLoadingDocument && !loadError)\n\n React.useEffect(() => {\n viewportRef.current?.scrollTo({ top: 0, left: 0 })\n }, [documentKey])\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 const frame = window.requestAnimationFrame(() => {\n setLoadError(status)\n setIsLoadingDocument(false)\n })\n\n return () => window.cancelAnimationFrame(frame)\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 (!activeUploadedDocxFile && !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 activeUploadedDocxFile?.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 }, [\n activeUploadedDocxFile,\n displayFileName,\n importDocxFile,\n setActivePage,\n url,\n ])\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, setActivePage])\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(\n (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) return\n\n if (!page) {\n const pageStridePx =\n (pageLayout.pageHeightPx + pageLayout.viewportDefaults.pageGapPx) *\n (zoomScale / 100)\n\n viewport.scrollTo({\n top: Math.max(0, targetPageIndex * pageStridePx - 24),\n behavior: "auto",\n })\n return\n }\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 pageLayout.pageHeightPx,\n pageLayout.viewportDefaults.pageGapPx,\n setActivePage,\n zoomScale,\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(resolvedDefaultZoomScale)\n setActivePage(1)\n setReportedPageCount(0)\n setUploadedDocxFile({\n file,\n identity: `${file.name}-${file.size}-${file.lastModified}`,\n sourceUrl: url,\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=".doc,.docx,application/msword,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 onPageChange={scrollToPage}\n onShowDocumentMarkupChange={handleShowDocumentMarkupChange}\n onToggleSidebar={() => setSidebarOpen((open) => !open)}\n onUploadClick={() => fileInputRef.current?.click()}\n pageCount={pageCount}\n setZoomScale={setZoomScale}\n showDocumentMarkup={showDocumentMarkup}\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={thumbnailSidebarVisible}\n >\n {thumbnailSidebarVisible ? (\n <DocxThumbnailSidebarList\n activePage={activePage}\n displayFileName={displayFileName}\n isLoadingDocument={isLoadingDocument}\n onSelectPage={scrollToPage}\n pageCount={pageCount}\n sidebarOpen={thumbnailSidebarVisible}\n thumbnails={thumbnails}\n />\n ) : null}\n </DocumentViewerThumbnailSidebar>\n <ScrollArea\n className="min-h-0 flex-1"\n style={{ backgroundColor: viewerBackgroundColor }}\n viewportClassName="px-4 py-6"\n viewportProps={{\n "aria-label": "DOCX document",\n onMouseDown: (event) => {\n if (isInteractiveViewerTarget(event.target)) return\n event.currentTarget.focus({ preventScroll: true })\n },\n tabIndex: 0,\n }}\n viewportRef={setViewportRef}\n >\n {!url && !activeUploadedDocxFile ? (\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">\n Upload a Word document to preview\n </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 <div className="mt-1 text-muted-foreground">\n Legacy <code>.doc</code> support is limited and experimental;\n convert to DOCX for best fidelity.\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 Word document\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="flex min-h-full min-w-full w-max 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 showTrackedChanges={showTrackedChanges}\n renderTrackedChangeCard={renderDocxTrackedChangeCard}\n showComments={showComments}\n renderCommentCard={renderDocxCommentCard}\n loadingState={loadingState}\n pageBackgroundColor={effectiveIsDark ? "#0a0a0a" : undefined}\n pageGapBackgroundColor={viewerBackgroundColor}\n pageVirtualization={pageVirtualization}\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 useDocxComments,\n useDocxEditor,\n useDocxPageLayout,\n useDocxTrackChanges,\n useDocxViewerThumbnails,\n type DocxDocumentTheme,\n type DocxEditorController,\n type DocxPageThumbnailItem,\n} from "@extend-ai/react-docx"\nimport {\n Comment01Icon,\n Download01Icon,\n MinusSignCircleIcon,\n Moon02Icon,\n MoreHorizontalIcon,\n PlusSignCircleIcon,\n SidebarLeftIcon,\n Upload01Icon,\n} from "@hugeicons/core-free-icons"\nimport { HugeiconsIcon } from "@hugeicons/react"\nimport { useVirtualizer } from "@tanstack/react-virtual"\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 {\n renderDocxCommentCard,\n renderDocxTrackedChangeCard,\n} from "@/components/ui/docx-annotation-card"\nimport {\n DropdownMenu,\n DropdownMenuCheckboxItem,\n DropdownMenuContent,\n DropdownMenuItem,\n DropdownMenuSeparator,\n DropdownMenuTrigger,\n} from "@/components/ui/dropdown-menu"\nimport { FileThumbnail } from "@/components/ui/file-thumbnail"\nimport { Input } from "@/components/ui/input"\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 DOCX_THUMBNAIL_LIST_PADDING = 16\nconst DOCX_THUMBNAIL_ROW_ESTIMATE = 172\nconst DEFAULT_ZOOM = 50\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"\nconst DOCX_THUMBNAIL_FOCUS_RING_CLASS =\n "group-focus-visible/docx-thumbnail-sidebar:ring-2 group-focus-visible/docx-thumbnail-sidebar:ring-ring group-focus-visible/docx-thumbnail-sidebar:ring-offset-1 group-focus-visible/docx-thumbnail-sidebar:ring-offset-background"\n\ntype UploadedDocxFile = {\n file: File\n identity: string\n sourceUrl: string | undefined\n}\n\ntype DocxActivePageStore = {\n getSnapshot: () => number\n setActivePage: React.Dispatch<React.SetStateAction<number>>\n subscribe: (listener: () => void) => () => void\n}\n\nfunction createDocxActivePageStore(): DocxActivePageStore {\n let activePage = 1\n const listeners = new Set<() => void>()\n\n return {\n getSnapshot: () => activePage,\n setActivePage: (nextPage) => {\n const value =\n typeof nextPage === "function" ? nextPage(activePage) : nextPage\n const normalizedValue = Math.max(1, Math.round(value || 1))\n\n if (normalizedValue === activePage) return\n\n activePage = normalizedValue\n listeners.forEach((listener) => listener())\n },\n subscribe: (listener) => {\n listeners.add(listener)\n return () => listeners.delete(listener)\n },\n }\n}\n\nfunction useDocxActivePage(activePageStore: DocxActivePageStore) {\n return React.useSyncExternalStore(\n activePageStore.subscribe,\n activePageStore.getSnapshot,\n activePageStore.getSnapshot\n )\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 normalizeDocxZoomScale(value: number | undefined): number {\n return typeof value === "number" &&\n ZOOM_OPTIONS.includes(value as (typeof ZOOM_OPTIONS)[number])\n ? value\n : DEFAULT_ZOOM\n}\n\nfunction useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {\n const [showSpinner, setShowSpinner] = React.useState(false)\n\n React.useEffect(() => {\n if (!isLoading) return\n\n const timeoutId = window.setTimeout(() => {\n setShowSpinner(true)\n }, delayMs)\n\n return () => {\n window.clearTimeout(timeoutId)\n setShowSpinner(false)\n }\n }, [delayMs, isLoading])\n\n return isLoading && showSpinner\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 isInteractiveViewerTarget(target: EventTarget | null) {\n return (\n target instanceof Element &&\n Boolean(\n target.closest(\n \'a[href], button, input, select, textarea, [contenteditable="true"], [role="button"], [role="link"]\'\n )\n )\n )\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 DocxFileActionsMenu({\n controlsDisabled,\n downloadDisabled,\n isPreparingDownload,\n isDark,\n onDownload,\n onIsDarkChange,\n onShowDocumentMarkupChange,\n onUploadClick,\n showDocumentMarkup,\n showDownloadButton,\n showNightRenderToggle,\n showUploadButton,\n}: {\n controlsDisabled: boolean\n downloadDisabled: boolean\n isPreparingDownload: boolean\n isDark: boolean\n onDownload: () => void\n onIsDarkChange: (checked: boolean) => void\n onShowDocumentMarkupChange: (checked: boolean) => void\n onUploadClick: () => void\n showDocumentMarkup: boolean\n showDownloadButton: boolean\n showNightRenderToggle: boolean\n showUploadButton: boolean\n}) {\n const showFileActions = showDownloadButton || showUploadButton\n\n return (\n <DropdownMenu>\n <DropdownMenuTrigger asChild>\n <Button\n type="button"\n variant="ghost"\n size="icon-sm"\n aria-label="Open DOCX actions"\n >\n <HugeiconsIcon icon={MoreHorizontalIcon} className="size-4" />\n </Button>\n </DropdownMenuTrigger>\n <DropdownMenuContent align="end" className="w-52">\n {showNightRenderToggle ? (\n <>\n <DropdownMenuCheckboxItem\n checked={isDark}\n disabled={controlsDisabled}\n variant="switch"\n onCheckedChange={(checked) => onIsDarkChange(checked === true)}\n >\n <span className="flex min-w-0 items-center gap-2">\n <HugeiconsIcon icon={Moon02Icon} className="size-4" />\n Dark mode\n </span>\n </DropdownMenuCheckboxItem>\n <DropdownMenuSeparator />\n </>\n ) : null}\n <DropdownMenuCheckboxItem\n checked={showDocumentMarkup}\n disabled={controlsDisabled}\n variant="switch"\n onCheckedChange={(checked) =>\n onShowDocumentMarkupChange(checked === true)\n }\n >\n <span className="flex min-w-0 items-center gap-2">\n <HugeiconsIcon icon={Comment01Icon} className="size-4" />\n Comments/edits\n </span>\n </DropdownMenuCheckboxItem>\n {showFileActions ? <DropdownMenuSeparator /> : null}\n {showDownloadButton ? (\n <DropdownMenuItem disabled={downloadDisabled} onClick={onDownload}>\n {isPreparingDownload ? (\n <Spinner className="size-4" />\n ) : (\n <HugeiconsIcon icon={Download01Icon} className="size-4" />\n )}\n Download\n </DropdownMenuItem>\n ) : null}\n {showUploadButton ? (\n <DropdownMenuItem onClick={onUploadClick}>\n <HugeiconsIcon icon={Upload01Icon} className="size-4" />\n Upload\n </DropdownMenuItem>\n ) : null}\n </DropdownMenuContent>\n </DropdownMenu>\n )\n}\n\nfunction DocxPageNumberControl({\n activePageStore,\n controlsDisabled,\n onPageChange,\n pageCount,\n}: {\n activePageStore: DocxActivePageStore\n controlsDisabled: boolean\n onPageChange: (pageNumber: number) => void\n pageCount: number\n}) {\n const activePage = useDocxActivePage(activePageStore)\n const inputRef = React.useRef<HTMLInputElement>(null)\n const displayPage = pageCount ? activePage : 1\n const [isEditing, setIsEditing] = React.useState(false)\n const [draftPage, setDraftPage] = React.useState(() => String(displayPage))\n\n React.useEffect(() => {\n if (!isEditing) {\n setDraftPage(String(displayPage))\n }\n }, [displayPage, isEditing])\n\n React.useEffect(() => {\n if (!isEditing) return\n\n inputRef.current?.focus()\n inputRef.current?.select()\n }, [isEditing])\n\n const applyPageDraft = React.useCallback(\n (value: string) => {\n const trimmedValue = value.trim()\n\n if (!trimmedValue) return\n\n const parsedPage = Number(trimmedValue)\n\n if (!Number.isInteger(parsedPage)) return\n\n onPageChange(Math.min(Math.max(parsedPage, 1), Math.max(pageCount, 1)))\n },\n [onPageChange, pageCount]\n )\n\n return (\n <div className="flex items-center text-sm whitespace-nowrap text-primary">\n <span>Page</span>\n {isEditing ? (\n <Input\n ref={inputRef}\n aria-label="Page number"\n inputMode="numeric"\n pattern="[0-9]*"\n size="sm"\n value={draftPage}\n className="mx-1 w-14 min-w-14 rounded-md [&_[data-slot=input]]:text-center"\n onBlur={() => setIsEditing(false)}\n onChange={(event: React.ChangeEvent<HTMLInputElement>) => {\n const nextValue = event.target.value\n\n setDraftPage(nextValue)\n applyPageDraft(nextValue)\n }}\n onKeyDown={(event: React.KeyboardEvent<HTMLInputElement>) => {\n if (event.key === "Enter" || event.key === "Escape") {\n event.currentTarget.blur()\n }\n }}\n />\n ) : (\n <Button\n type="button"\n variant="ghost"\n size="sm"\n className="font-normal"\n aria-label={`Current page ${displayPage}. Edit page number`}\n disabled={controlsDisabled || !pageCount}\n onClick={() => {\n setDraftPage(String(displayPage))\n setIsEditing(true)\n }}\n >\n {displayPage}\n </Button>\n )}\n <span>of {pageCount || "-"}</span>\n </div>\n )\n}\n\nfunction DocxToolbar({\n activePageStore,\n controlsDisabled,\n isDark,\n isPreparingDownload,\n onDownload,\n onIsDarkChange,\n onPageChange,\n onShowDocumentMarkupChange,\n onToggleSidebar,\n onUploadClick,\n pageCount,\n setZoomScale,\n showDocumentMarkup,\n showDownloadButton = true,\n showNightRenderToggle,\n showUploadButton = true,\n toolbarActions,\n zoomScale,\n}: {\n activePageStore: DocxActivePageStore\n controlsDisabled: boolean\n isDark: boolean\n isPreparingDownload: boolean\n onDownload: () => void\n onIsDarkChange: (checked: boolean) => void\n onPageChange: (pageNumber: number) => void\n onShowDocumentMarkupChange: (checked: boolean) => void\n onToggleSidebar: () => void\n onUploadClick: () => void\n pageCount: number\n setZoomScale: React.Dispatch<React.SetStateAction<number>>\n showDocumentMarkup: boolean\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 <DocxPageNumberControl\n activePageStore={activePageStore}\n controlsDisabled={controlsDisabled}\n onPageChange={onPageChange}\n pageCount={pageCount}\n />\n </div>\n <div className="ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1">\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 {toolbarActions ? (\n <>\n <Separator\n orientation="vertical"\n className="mx-1 h-4 self-center"\n />\n {toolbarActions}\n </>\n ) : null}\n <Separator orientation="vertical" className="mx-1 h-4 self-center" />\n <DocxFileActionsMenu\n controlsDisabled={controlsDisabled}\n downloadDisabled={controlsDisabled || isPreparingDownload}\n isPreparingDownload={isPreparingDownload}\n isDark={isDark}\n onDownload={onDownload}\n onIsDarkChange={onIsDarkChange}\n onShowDocumentMarkupChange={onShowDocumentMarkupChange}\n onUploadClick={onUploadClick}\n showDocumentMarkup={showDocumentMarkup}\n showDownloadButton={showDownloadButton}\n showNightRenderToggle={showNightRenderToggle}\n showUploadButton={showUploadButton}\n />\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\nfunction DocxThumbnailSidebarList({\n activePage,\n displayFileName,\n isLoadingDocument,\n onSelectPage,\n pageCount,\n sidebarOpen,\n thumbnails,\n}: {\n activePage: number\n displayFileName: string\n isLoadingDocument: boolean\n onSelectPage: (pageNumber: number) => void\n pageCount: number\n sidebarOpen: boolean\n thumbnails: DocxPageThumbnailItem[]\n}) {\n const viewportRef = React.useRef<HTMLDivElement | null>(null)\n const thumbnailListboxId = React.useId()\n const visibleThumbnails = React.useMemo(\n () => thumbnails.slice(0, pageCount || 0),\n [pageCount, thumbnails]\n )\n const activeDescendantId =\n activePage > 0 && visibleThumbnails.length\n ? `${thumbnailListboxId}-page-${activePage}`\n : undefined\n const virtualizer = useVirtualizer({\n count: visibleThumbnails.length,\n estimateSize: () => DOCX_THUMBNAIL_ROW_ESTIMATE,\n getItemKey: (index) => visibleThumbnails[index]?.pageIndex ?? index,\n getScrollElement: () => viewportRef.current,\n overscan: 3,\n })\n\n React.useEffect(() => {\n if (!sidebarOpen || activePage < 1 || !visibleThumbnails.length) return\n\n virtualizer.scrollToIndex(\n Math.min(activePage - 1, visibleThumbnails.length - 1),\n { align: "auto" }\n )\n }, [activePage, sidebarOpen, virtualizer, visibleThumbnails.length])\n\n const handleKeyDown = React.useCallback(\n (event: React.KeyboardEvent<HTMLDivElement>) => {\n if (pageCount < 1) return\n\n const currentPage = activePage > 0 ? activePage : 1\n let nextPage: number | null = null\n\n if (event.key === "ArrowDown") {\n nextPage = Math.min(pageCount, currentPage + 1)\n } else if (event.key === "ArrowUp") {\n nextPage = Math.max(1, currentPage - 1)\n } else if (event.key === "Home") {\n nextPage = 1\n } else if (event.key === "End") {\n nextPage = pageCount\n }\n\n if (nextPage === null) return\n\n event.preventDefault()\n onSelectPage(nextPage)\n },\n [activePage, onSelectPage, pageCount]\n )\n\n return (\n <ScrollArea\n className="h-full"\n scrollFade\n viewportClassName="group/docx-thumbnail-sidebar focus-visible:ring-0 focus-visible:ring-offset-0"\n viewportProps={{\n "aria-activedescendant": activeDescendantId,\n "aria-busy": isLoadingDocument || undefined,\n "aria-label": "DOCX pages",\n onKeyDown: handleKeyDown,\n onMouseDown: (event) => {\n event.currentTarget.focus({ preventScroll: true })\n },\n role: "listbox",\n tabIndex: 0,\n }}\n viewportRef={viewportRef}\n >\n {isLoadingDocument ? (\n <div className="p-4">\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 </div>\n ) : visibleThumbnails.length ? (\n <div\n className="relative"\n style={{\n height:\n virtualizer.getTotalSize() + DOCX_THUMBNAIL_LIST_PADDING * 2,\n }}\n >\n {virtualizer.getVirtualItems().map((virtualRow) => {\n const thumbnail = visibleThumbnails[virtualRow.index]\n if (!thumbnail) return null\n\n return (\n <div\n key={virtualRow.key}\n ref={virtualizer.measureElement}\n data-index={virtualRow.index}\n className={cn(\n "absolute top-0 right-3 left-3 pb-3 [contain:layout]",\n thumbnail.pageNumber === activePage && "z-10"\n )}\n style={{\n transform: `translateY(${\n virtualRow.start + DOCX_THUMBNAIL_LIST_PADDING\n }px)`,\n }}\n >\n <div\n id={`${thumbnailListboxId}-page-${thumbnail.pageNumber}`}\n role="option"\n aria-current={\n thumbnail.pageNumber === activePage ? "page" : undefined\n }\n aria-label={`Page ${thumbnail.pageNumber}`}\n aria-posinset={thumbnail.pageNumber}\n aria-selected={thumbnail.pageNumber === activePage}\n aria-setsize={pageCount}\n data-docx-viewer-thumbnail-option={thumbnail.pageNumber}\n className={cn(\n "flex h-auto w-full cursor-default flex-col items-center gap-2 rounded-md p-2 text-xs transition-shadow outline-none select-none hover:bg-sidebar-accent",\n thumbnail.pageNumber === activePage &&\n "bg-sidebar-accent text-foreground",\n thumbnail.pageNumber !== activePage &&\n "text-muted-foreground",\n thumbnail.pageNumber === activePage &&\n DOCX_THUMBNAIL_FOCUS_RING_CLASS\n )}\n onClick={() => onSelectPage(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.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 </div>\n </div>\n )\n })}\n </div>\n ) : null}\n </ScrollArea>\n )\n}\n\nfunction DocxThumbnailSidebarContent({\n activePageStore,\n displayFileName,\n editor,\n isLoadingDocument,\n onSelectPage,\n pageCount,\n reportedPageCount,\n sidebarOpen,\n}: {\n activePageStore: DocxActivePageStore\n displayFileName: string\n editor: DocxEditorController\n isLoadingDocument: boolean\n onSelectPage: (pageNumber: number) => void\n pageCount: number\n reportedPageCount: number\n sidebarOpen: boolean\n}) {\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 // Detached thumbnail rendering handles offscreen pages; keep the raster\n // queue dormant while the sidebar is closed.\n disabled: !sidebarOpen,\n pixelRatio: 2,\n resolution: {\n maxHeight: DOCX_THUMBNAIL_WIDTH * 1.35,\n maxWidth: DOCX_THUMBNAIL_WIDTH,\n },\n }),\n [sidebarOpen]\n )\n const { thumbnails } = useDocxViewerThumbnails(\n thumbnailEditor,\n thumbnailOptions\n )\n const activePage = useDocxActivePage(activePageStore)\n\n if (!sidebarOpen) return null\n\n return (\n <DocxThumbnailSidebarList\n activePage={activePage}\n displayFileName={displayFileName}\n isLoadingDocument={isLoadingDocument}\n onSelectPage={onSelectPage}\n pageCount={pageCount}\n sidebarOpen={sidebarOpen}\n thumbnails={thumbnails}\n />\n )\n}\n\nexport function DocxViewerPreview({\n className,\n defaultZoom = DEFAULT_ZOOM,\n fileName,\n isDark,\n onIsDarkChange,\n showDownload = true,\n showToolbar = true,\n showUpload = true,\n src,\n toolbarActions,\n}: {\n className?: string\n defaultZoom?: number\n fileName?: string\n isDark: boolean\n onIsDarkChange: (isDark: boolean) => void\n showDownload?: boolean\n showToolbar?: boolean\n showUpload?: boolean\n src?: string\n toolbarActions?: React.ReactNode\n}) {\n return (\n <DocxViewerContent\n className={className}\n defaultZoom={defaultZoom}\n effectiveIsDark={isDark}\n fileName={fileName}\n setNightRenderEnabled={onIsDarkChange}\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 defaultZoom,\n effectiveIsDark,\n fileName,\n setNightRenderEnabled,\n shouldRenderNightMode,\n showDownload,\n showToolbar = true,\n showUpload,\n toolbarActions,\n url,\n}: {\n className?: string\n defaultZoom?: number\n effectiveIsDark: boolean\n fileName?: string\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 [viewportElement, setViewportElement] =\n React.useState<HTMLDivElement | null>(null)\n const [viewerShellRef, viewerShellWidth] = useElementWidth<HTMLDivElement>()\n const [uploadedDocxFile, setUploadedDocxFile] =\n React.useState<UploadedDocxFile | null>(null)\n const [sidebarOpen, setSidebarOpen] = React.useState(false)\n const activePageStore = React.useMemo(createDocxActivePageStore, [])\n const resolvedDefaultZoomScale = normalizeDocxZoomScale(defaultZoom)\n const activeUploadedDocxFile =\n uploadedDocxFile?.sourceUrl === url ? uploadedDocxFile : null\n const documentKey = activeUploadedDocxFile?.identity ?? url ?? ""\n const setActivePage = activePageStore.setActivePage\n const sidebarInline = useInlineThumbnailSidebar(viewerShellWidth)\n const viewerBackgroundColor =\n "color-mix(in oklab, var(--muted) 40%, transparent)"\n const displayFileName = React.useMemo(\n () =>\n activeUploadedDocxFile?.file.name ??\n (url ? formatDocumentName(fileName, url) : (fileName ?? "document.docx")),\n [activeUploadedDocxFile?.file.name, fileName, 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 { layout: pageLayout } = useDocxPageLayout(editor)\n const { importDocxFile, setDocumentTheme, status } = editor\n const { showComments, setShowComments } = useDocxComments(editor)\n const { showTrackedChanges, setShowTrackedChanges } =\n useDocxTrackChanges(editor)\n const [reportedPageCount, setReportedPageCount] = React.useState(0)\n const [zoomScaleState, setZoomScaleState] = React.useState({\n documentKey: "",\n value: resolvedDefaultZoomScale,\n })\n const zoomScale =\n zoomScaleState.documentKey === documentKey\n ? zoomScaleState.value\n : resolvedDefaultZoomScale\n const setZoomScale = React.useCallback<\n React.Dispatch<React.SetStateAction<number>>\n >(\n (nextZoomScale) => {\n setZoomScaleState((currentState) => {\n const currentZoomScale =\n currentState.documentKey === documentKey\n ? currentState.value\n : resolvedDefaultZoomScale\n const value =\n typeof nextZoomScale === "function"\n ? nextZoomScale(currentZoomScale)\n : nextZoomScale\n\n return { documentKey, value }\n })\n },\n [documentKey, resolvedDefaultZoomScale]\n )\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 || activeUploadedDocxFile)\n const pageCount =\n hasDocument && !isLoadingDocument && !loadError\n ? Math.max(1, reportedPageCount || editor.totalPages)\n : 0\n const thumbnailSidebarVisible = Boolean(\n sidebarOpen && (pageCount || isLoadingDocument)\n )\n const controlsDisabled =\n !hasDocument || isLoadingDocument || Boolean(loadError)\n const showDocumentMarkup = showComments || showTrackedChanges\n const handlePageCountChange = React.useCallback((nextPageCount: number) => {\n setReportedPageCount(Math.max(1, Math.round(nextPageCount || 1)))\n }, [])\n const setViewportRef = React.useCallback((element: HTMLDivElement | null) => {\n viewportRef.current = element\n setViewportElement(element)\n }, [])\n const pageVirtualization = React.useMemo(\n () => ({\n enabled: true,\n overscan: 1,\n scrollElement: viewportElement,\n zoomScale: zoomScale / 100,\n }),\n [viewportElement, zoomScale]\n )\n const handleDownload = React.useCallback(async () => {\n if (isPreparingDownload) return\n if (!activeUploadedDocxFile && !url) return\n\n setIsPreparingDownload(true)\n\n try {\n await downloadDocxFile({\n file: activeUploadedDocxFile?.file,\n fileName: displayFileName,\n url,\n })\n } catch (error) {\n console.error(error)\n } finally {\n setIsPreparingDownload(false)\n }\n }, [activeUploadedDocxFile, displayFileName, isPreparingDownload, url])\n const handleShowDocumentMarkupChange = React.useCallback(\n (checked: boolean) => {\n setShowComments(checked)\n setShowTrackedChanges(checked)\n },\n [setShowComments, setShowTrackedChanges]\n )\n\n useSuppressDocxPaddingWarning(!isLoadingDocument && !loadError)\n\n React.useEffect(() => {\n setActivePage(1)\n viewportRef.current?.scrollTo({ top: 0, left: 0 })\n }, [documentKey, setActivePage])\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 const frame = window.requestAnimationFrame(() => {\n setLoadError(status)\n setIsLoadingDocument(false)\n })\n\n return () => window.cancelAnimationFrame(frame)\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 (!activeUploadedDocxFile && !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 activeUploadedDocxFile?.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 }, [\n activeUploadedDocxFile,\n displayFileName,\n importDocxFile,\n setActivePage,\n url,\n ])\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 activePageStore.setActivePage((currentPage) =>\n currentPage === closestPage ? currentPage : closestPage\n )\n }, [activePageStore, 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(\n (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) return\n\n if (!page) {\n const pageStridePx =\n (pageLayout.pageHeightPx + pageLayout.viewportDefaults.pageGapPx) *\n (zoomScale / 100)\n\n viewport.scrollTo({\n top: Math.max(0, targetPageIndex * pageStridePx - 24),\n behavior: "auto",\n })\n return\n }\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 pageLayout.pageHeightPx,\n pageLayout.viewportDefaults.pageGapPx,\n setActivePage,\n zoomScale,\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(resolvedDefaultZoomScale)\n setActivePage(1)\n setReportedPageCount(0)\n setUploadedDocxFile({\n file,\n identity: `${file.name}-${file.size}-${file.lastModified}`,\n sourceUrl: url,\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=".doc,.docx,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document"\n className="hidden"\n onChange={handleUpload}\n />\n {showToolbar ? (\n <DocxToolbar\n activePageStore={activePageStore}\n controlsDisabled={controlsDisabled}\n isDark={effectiveIsDark}\n isPreparingDownload={isPreparingDownload}\n onDownload={handleDownload}\n onIsDarkChange={setNightRenderEnabled}\n onPageChange={scrollToPage}\n onShowDocumentMarkupChange={handleShowDocumentMarkupChange}\n onToggleSidebar={() => setSidebarOpen((open) => !open)}\n onUploadClick={() => fileInputRef.current?.click()}\n pageCount={pageCount}\n setZoomScale={setZoomScale}\n showDocumentMarkup={showDocumentMarkup}\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={thumbnailSidebarVisible}\n >\n <DocxThumbnailSidebarContent\n activePageStore={activePageStore}\n displayFileName={displayFileName}\n editor={editor}\n isLoadingDocument={isLoadingDocument}\n onSelectPage={scrollToPage}\n pageCount={pageCount}\n reportedPageCount={reportedPageCount}\n sidebarOpen={thumbnailSidebarVisible}\n />\n </DocumentViewerThumbnailSidebar>\n <ScrollArea\n className="min-h-0 flex-1"\n style={{ backgroundColor: viewerBackgroundColor }}\n viewportClassName="px-4 py-6"\n viewportProps={{\n "aria-label": "DOCX document",\n onMouseDown: (event) => {\n if (isInteractiveViewerTarget(event.target)) return\n event.currentTarget.focus({ preventScroll: true })\n },\n tabIndex: 0,\n }}\n viewportRef={setViewportRef}\n >\n {!url && !activeUploadedDocxFile ? (\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">\n Upload a Word document to preview\n </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 <div className="mt-1 text-muted-foreground">\n Legacy <code>.doc</code> support is limited and experimental;\n convert to DOCX for best fidelity.\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 Word document\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="flex min-h-full w-max min-w-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 showTrackedChanges={showTrackedChanges}\n renderTrackedChangeCard={renderDocxTrackedChangeCard}\n showComments={showComments}\n renderCommentCard={renderDocxCommentCard}\n loadingState={loadingState}\n pageBackgroundColor={effectiveIsDark ? "#0a0a0a" : undefined}\n pageGapBackgroundColor={viewerBackgroundColor}\n pageVirtualization={pageVirtualization}\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/ui/docx-viewer.tsx b/apps/v4/components/ui/docx-viewer.tsx
index 876e7eb..58fa638 100644
--- a/apps/v4/components/ui/docx-viewer.tsx
+++ b/apps/v4/components/ui/docx-viewer.tsx
@@ -81,6 +81,43 @@ type UploadedDocxFile = {
sourceUrl: string | undefined
}
+type DocxActivePageStore = {
+ getSnapshot: () => number
+ setActivePage: React.Dispatch<React.SetStateAction<number>>
+ subscribe: (listener: () => void) => () => void
+}
+
+function createDocxActivePageStore(): DocxActivePageStore {
+ let activePage = 1
+ const listeners = new Set<() => void>()
+
+ return {
+ getSnapshot: () => activePage,
+ setActivePage: (nextPage) => {
+ const value =
+ typeof nextPage === "function" ? nextPage(activePage) : nextPage
+ const normalizedValue = Math.max(1, Math.round(value || 1))
+
+ if (normalizedValue === activePage) return
+
+ activePage = normalizedValue
+ listeners.forEach((listener) => listener())
+ },
+ subscribe: (listener) => {
+ listeners.add(listener)
+ return () => listeners.delete(listener)
+ },
+ }
+}
+
+function useDocxActivePage(activePageStore: DocxActivePageStore) {
+ return React.useSyncExternalStore(
+ activePageStore.subscribe,
+ activePageStore.getSnapshot,
+ activePageStore.getSnapshot
+ )
+}
+
async function loadDocxFile(
url: string,
displayFileName: string
@@ -365,16 +402,17 @@ function DocxFileActionsMenu({
}
function DocxPageNumberControl({
- activePage,
+ activePageStore,
controlsDisabled,
onPageChange,
pageCount,
}: {
- activePage: number
+ activePageStore: DocxActivePageStore
controlsDisabled: boolean
onPageChange: (pageNumber: number) => void
pageCount: number
}) {
+ const activePage = useDocxActivePage(activePageStore)
const inputRef = React.useRef<HTMLInputElement>(null)
const displayPage = pageCount ? activePage : 1
const [isEditing, setIsEditing] = React.useState(false)
@@ -455,7 +493,7 @@ function DocxPageNumberControl({
}
function DocxToolbar({
- activePage,
+ activePageStore,
controlsDisabled,
isDark,
isPreparingDownload,
@@ -474,7 +512,7 @@ function DocxToolbar({
toolbarActions,
zoomScale,
}: {
- activePage: number
+ activePageStore: DocxActivePageStore
controlsDisabled: boolean
isDark: boolean
isPreparingDownload: boolean
@@ -513,7 +551,7 @@ function DocxToolbar({
</Button>
</ToolbarTooltip>
<DocxPageNumberControl
- activePage={activePage}
+ activePageStore={activePageStore}
controlsDisabled={controlsDisabled}
onPageChange={onPageChange}
pageCount={pageCount}
@@ -679,7 +717,6 @@ function DocxThumbnailSidebarList({
activePage > 0 && visibleThumbnails.length
? `${thumbnailListboxId}-page-${activePage}`
: undefined
- // eslint-disable-next-line react-hooks/incompatible-library -- TanStack Virtual returns imperative helpers used by the thumbnail rail.
const virtualizer = useVirtualizer({
count: visibleThumbnails.length,
estimateSize: () => DOCX_THUMBNAIL_ROW_ESTIMATE,
@@ -821,6 +858,66 @@ function DocxThumbnailSidebarList({
)
}
+function DocxThumbnailSidebarContent({
+ activePageStore,
+ displayFileName,
+ editor,
+ isLoadingDocument,
+ onSelectPage,
+ pageCount,
+ reportedPageCount,
+ sidebarOpen,
+}: {
+ activePageStore: DocxActivePageStore
+ displayFileName: string
+ editor: DocxEditorController
+ isLoadingDocument: boolean
+ onSelectPage: (pageNumber: number) => void
+ pageCount: number
+ reportedPageCount: number
+ sidebarOpen: boolean
+}) {
+ const thumbnailEditor = React.useMemo<DocxEditorController>(
+ () => ({
+ ...editor,
+ totalPages: Math.max(editor.totalPages, reportedPageCount),
+ }),
+ [editor, reportedPageCount]
+ )
+ const thumbnailOptions = React.useMemo(
+ () => ({
+ // Detached thumbnail rendering handles offscreen pages; keep the raster
+ // queue dormant while the sidebar is closed.
+ disabled: !sidebarOpen,
+ pixelRatio: 2,
+ resolution: {
+ maxHeight: DOCX_THUMBNAIL_WIDTH * 1.35,
+ maxWidth: DOCX_THUMBNAIL_WIDTH,
+ },
+ }),
+ [sidebarOpen]
+ )
+ const { thumbnails } = useDocxViewerThumbnails(
+ thumbnailEditor,
+ thumbnailOptions
+ )
+ const activePage = useDocxActivePage(activePageStore)
+
+ if (!sidebarOpen) return null
+
+ return (
+ <DocxThumbnailSidebarList
+ activePage={activePage}
+ displayFileName={displayFileName}
+ isLoadingDocument={isLoadingDocument}
+ onSelectPage={onSelectPage}
+ pageCount={pageCount}
+ sidebarOpen={sidebarOpen}
+ thumbnails={thumbnails}
+ />
+ )
+}
+
export function DocxViewerPreview({
className,
defaultZoom = DEFAULT_ZOOM,
@@ -894,31 +991,12 @@ function DocxViewerContent({
const [uploadedDocxFile, setUploadedDocxFile] =
React.useState<UploadedDocxFile | null>(null)
const [sidebarOpen, setSidebarOpen] = React.useState(false)
+ const activePageStore = React.useMemo(createDocxActivePageStore, [])
const resolvedDefaultZoomScale = normalizeDocxZoomScale(defaultZoom)
const activeUploadedDocxFile =
uploadedDocxFile?.sourceUrl === url ? uploadedDocxFile : null
const documentKey = activeUploadedDocxFile?.identity ?? url ?? ""
- const [activePageState, setActivePageState] = React.useState({
- documentKey: "",
- value: 1,
- })
- const activePage =
- activePageState.documentKey === documentKey ? activePageState.value : 1
- const setActivePage = React.useCallback<
- React.Dispatch<React.SetStateAction<number>>
- >(
- (nextPage) => {
- setActivePageState((currentState) => {
- const currentPage =
- currentState.documentKey === documentKey ? currentState.value : 1
- const value =
- typeof nextPage === "function" ? nextPage(currentPage) : nextPage
-
- return { documentKey, value }
- })
- },
- [documentKey]
- )
+ const setActivePage = activePageStore.setActivePage
const sidebarInline = useInlineThumbnailSidebar(viewerShellWidth)
const viewerBackgroundColor =
"color-mix(in oklab, var(--muted) 40%, transparent)"
@@ -945,30 +1023,6 @@ function DocxViewerContent({
const { showTrackedChanges, setShowTrackedChanges } =
useDocxTrackChanges(editor)
const [reportedPageCount, setReportedPageCount] = React.useState(0)
- const thumbnailEditor = React.useMemo<DocxEditorController>(
- () => ({
- ...editor,
- totalPages: Math.max(editor.totalPages, reportedPageCount),
- }),
- [editor, reportedPageCount]
- )
- const thumbnailOptions = React.useMemo(
- () => ({
- // Detached thumbnail rendering handles offscreen pages; keep the raster
- // queue dormant while the sidebar is closed.
- disabled: !sidebarOpen,
- pixelRatio: 2,
- resolution: {
- maxHeight: DOCX_THUMBNAIL_WIDTH * 1.35,
- maxWidth: DOCX_THUMBNAIL_WIDTH,
- },
- }),
- [sidebarOpen]
- )
- const { thumbnails } = useDocxViewerThumbnails(
- thumbnailEditor,
- thumbnailOptions
- )
const [zoomScaleState, setZoomScaleState] = React.useState({
documentKey: "",
value: resolvedDefaultZoomScale,
@@ -1062,8 +1116,9 @@ function DocxViewerContent({
useSuppressDocxPaddingWarning(!isLoadingDocument && !loadError)
React.useEffect(() => {
+ setActivePage(1)
viewportRef.current?.scrollTo({ top: 0, left: 0 })
- }, [documentKey])
+ }, [documentKey, setActivePage])
React.useEffect(() => {
setDocumentTheme(effectiveIsDark ? "dark" : "light")
@@ -1167,10 +1222,10 @@ function DocxViewerContent({
}
})
- setActivePage((currentPage) =>
+ activePageStore.setActivePage((currentPage) =>
currentPage === closestPage ? currentPage : closestPage
)
- }, [pageCount, setActivePage])
+ }, [activePageStore, pageCount])
React.useEffect(() => {
const viewport = viewportRef.current
@@ -1264,7 +1319,7 @@ function DocxViewerContent({
/>
{showToolbar ? (
<DocxToolbar
- activePage={activePage}
+ activePageStore={activePageStore}
controlsDisabled={controlsDisabled}
isDark={effectiveIsDark}
isPreparingDownload={isPreparingDownload}
@@ -1292,17 +1347,16 @@ function DocxViewerContent({
inline={sidebarInline}
open={thumbnailSidebarVisible}
>
- {thumbnailSidebarVisible ? (
- <DocxThumbnailSidebarList
- activePage={activePage}
- displayFileName={displayFileName}
- isLoadingDocument={isLoadingDocument}
- onSelectPage={scrollToPage}
- pageCount={pageCount}
- sidebarOpen={thumbnailSidebarVisible}
- thumbnails={thumbnails}
- />
- ) : null}
+ <DocxThumbnailSidebarContent
+ activePageStore={activePageStore}
+ displayFileName={displayFileName}
+ editor={editor}
+ isLoadingDocument={isLoadingDocument}
+ onSelectPage={scrollToPage}
+ pageCount={pageCount}
+ reportedPageCount={reportedPageCount}
+ sidebarOpen={thumbnailSidebarVisible}
+ />
</DocumentViewerThumbnailSidebar>
<ScrollArea
className="min-h-0 flex-1"