TypeScript
Update document viewer docs and demos
Andrew Luo960010489dc1
diff --git a/apps/v4/app/(app)/(root)/page.tsx b/apps/v4/app/(app)/(root)/page.tsxindex 0b880ef..0f717d2 100644--- a/apps/v4/app/(app)/(root)/page.tsx+++ b/apps/v4/app/(app)/(root)/page.tsx@@ -12,10 +12,11 @@ import {MobileRootPreview,RootComponentsCollage,} from "@/components/root-components-collage"+import { RootLiquidLogo } from "@/components/root-liquid-logo"const title = "Document components for modern apps"const description =- "Open source viewers, uploads, thumbnails, citations, OCR blocks, and e-signing primitives for document processing products."+ "Open source PDF, DOCX, and XLSX viewers, uploads, CSV previews, OCR blocks, and e-signing primitives for document processing products."export const dynamic = "force-static"export const revalidate = false@@ -47,7 +48,8 @@ export const metadata: Metadata = {export default function IndexPage() {return (<div className="flex flex-1 flex-col">- <PageHeader className="[&_.container]:pt-20 md:[&_.container]:pt-28 lg:[&_.container]:pt-32">+ <PageHeader className="[&_.container]:pt-12 md:[&_.container]:pt-16 lg:[&_.container]:pt-20">+ <RootLiquidLogo /><PageHeaderHeading className="max-w-4xl">{title}</PageHeaderHeading><PageHeaderDescription>{description}</PageHeaderDescription><PageActions>diff --git a/apps/v4/components/components-list.tsx b/apps/v4/components/components-list.tsxindex 3912f67..43baaa7 100644--- a/apps/v4/components/components-list.tsx+++ b/apps/v4/components/components-list.tsx@@ -1,6 +1,35 @@import Link from "next/link"import { getPagesFromFolder, type PageTreeFolder } from "@/lib/page-tree"+import { cn } from "@/lib/utils"++const PDF_VIEWER_SUBPAGE_LINKS = [+ {+ $id: "pdf-viewer/citations",+ name: "Citations",+ url: "/docs/components/pdf-viewer/citations",+ },+ {+ $id: "pdf-viewer/ocr-blocks",+ name: "OCR Blocks",+ url: "/docs/components/pdf-viewer/ocr-blocks",+ },+ {+ $id: "pdf-viewer/e-signature",+ name: "E-Signature",+ url: "/docs/components/pdf-viewer/e-signature",+ },+ {+ $id: "pdf-viewer/human-review",+ name: "Human Review",+ url: "/docs/components/pdf-viewer/human-review",+ },+ {+ $id: "pdf-viewer/document-splits",+ name: "Document Splits",+ url: "/docs/components/pdf-viewer/document-splits",+ },+]export function ComponentsList({componentsFolder,@@ -9,7 +38,18 @@ export function ComponentsList({componentsFolder: PageTreeFoldercurrentBase: string}) {- const list = getPagesFromFolder(componentsFolder, currentBase)+ const pages = getPagesFromFolder(componentsFolder, currentBase)+ const pageUrls = new Set(pages.map((page) => page.url))+ const list = pages.flatMap((page) => {+ if (page.url !== "/docs/components/pdf-viewer") {+ return [page]+ }++ return [+ page,+ ...PDF_VIEWER_SUBPAGE_LINKS.filter((link) => !pageUrls.has(link.url)),+ ]+ })return (<div className="grid grid-cols-2 gap-4 md:grid-cols-3 md:gap-x-8 lg:gap-x-16 lg:gap-y-6 xl:gap-x-20">@@ -17,7 +57,11 @@ export function ComponentsList({<Linkkey={component.$id}href={component.url}- className="inline-flex items-center gap-2 text-lg font-medium underline-offset-4 hover:underline md:text-base"+ className={cn(+ "inline-flex items-center gap-2 text-lg font-medium underline-offset-4 hover:underline md:text-base",+ component.url.includes("/pdf-viewer/") &&+ "pl-4 text-muted-foreground"+ )}>{component.name}</Link>diff --git a/apps/v4/components/csv-viewer-docs.tsx b/apps/v4/components/csv-viewer-docs.tsxindex 56842ae..b2e9abf 100644--- a/apps/v4/components/csv-viewer-docs.tsx+++ b/apps/v4/components/csv-viewer-docs.tsx@@ -1,5 +1,92 @@"use client"+import * as React from "react"+import dynamic from "next/dynamic"++import { Button } from "@/components/ui/button"+import { HighlightedCodeBlock } from "@/components/highlighted-code-block"++function ViewerPreviewLoading() {+ return (+ <div className="grid h-[560px] place-items-center bg-background">+ <div className="size-4 animate-spin rounded-full border-2 border-muted-foreground/30 border-t-foreground" />+ </div>+ )+}++const CsvViewer = dynamic(+ () => import("@/components/ui/csv-viewer").then((mod) => mod.CsvViewer),+ {+ ssr: false,+ loading: () => <ViewerPreviewLoading />,+ }+)++export const CsvViewerPreviewClient = CsvViewer++export function CsvViewerDemo() {+ const [isCodeVisible, setIsCodeVisible] = React.useState(false)++ return (+ <div+ data-slot="component-preview"+ className="group relative mt-4 mb-12 flex flex-col overflow-hidden rounded-xl border"+ >+ <CsvViewer />+ <div+ data-slot="code"+ data-mobile-code-visible={isCodeVisible}+ className="relative overflow-hidden **:data-[slot=copy-button]:right-4 **:data-[slot=copy-button]:hidden data-[mobile-code-visible=true]:**:data-[slot=copy-button]:flex [&_[data-rehype-pretty-code-figure]]:m-0! [&_[data-rehype-pretty-code-figure]]:rounded-t-none [&_[data-rehype-pretty-code-figure]]:border-t [&_pre]:max-h-72"+ >+ {isCodeVisible ? (+ <HighlightedCodeBlock+ code={csvViewerUsageCode}+ className="rounded-none border-x-0 border-b-0"+ />+ ) : (+ <div className="relative">+ <HighlightedCodeBlock+ code={csvViewerUsageCode}+ className="rounded-none border-x-0 border-b-0"+ maxHeightClassName="max-h-56"+ previewLines={10}+ showCopy={false}+ />+ <div className="absolute inset-0 flex items-center justify-center pb-4">+ <div+ className="absolute inset-0"+ style={{+ background:+ "linear-gradient(to top, var(--color-code), color-mix(in oklab, var(--color-code) 60%, transparent), transparent)",+ }}+ />+ <Button+ type="button"+ size="sm"+ variant="outline"+ className="relative z-10 rounded-lg bg-background text-foreground shadow-none hover:bg-muted dark:bg-background dark:text-foreground dark:hover:bg-muted"+ onClick={() => setIsCodeVisible(true)}+ >+ View Code+ </Button>+ </div>+ </div>+ )}+ </div>+ </div>+ )+}++const csvViewerUsageCode = `"use client";++import { CsvViewer } from "@/components/ui/csv-viewer";++export function CsvViewerExample() {+ return <CsvViewer />;+}`++const csvViewerSourceCode = `"use client"+import * as React from "react"import type * as GlideDataGrid from "@glideapps/glide-data-grid"import type {@@ -13,14 +100,12 @@ import {Loading03Icon,MinusSignCircleIcon,PlusSignCircleIcon,- TableIcon,Upload01Icon,} from "@hugeicons/core-free-icons"import { HugeiconsIcon } from "@hugeicons/react"import Papa from "papaparse"import { Button } from "@/components/ui/button"-import { HighlightedCodeBlock } from "@/components/highlighted-code-block"import {Select,SelectContent,@@ -36,7 +121,7 @@ import {TooltipTrigger,} from "@/registry/new-york-v4/ui/tooltip"-const SAMPLE_CSV = `Invoice,Customer,Status,Amount,Submitted+const SAMPLE_CSV = \`Invoice,Customer,Status,Amount,SubmittedINV-1001,Northstar Supply,Approved,4280.50,2026-04-28INV-1002,Bluebird Medical,Needs review,1190.00,2026-04-29INV-1003,Aster Logistics,Approved,845.75,2026-04-30@@ -46,7 +131,7 @@ INV-1006,Monarch Studio,Processing,1510.45,2026-05-03INV-1007,Orchard Bank,Approved,7820.00,2026-05-04INV-1008,Riverstone Energy,Needs review,632.25,2026-05-05INV-1009,Summit Health,Approved,2730.00,2026-05-06-INV-1010,Westhaven Legal,Processing,410.80,2026-05-07`+INV-1010,Westhaven Legal,Processing,410.80,2026-05-07\`const ZOOM_OPTIONS = [0.75, 1, 1.25, 1.5, 2] as consttype GlideDataGridModule = typeof GlideDataGrid@@ -57,7 +142,7 @@ function toDisplayString(value: unknown): string {function normalizeHeaderTitle(header: string, index: number): string {const trimmed = header.trim()- return trimmed.length > 0 ? trimmed : `Column ${index + 1}`+ return trimmed.length > 0 ? trimmed : \`Column \${index + 1}\`}function parseDelimitedText(text: string): {@@ -93,7 +178,7 @@ function parseDelimitedText(text: string): {...fieldKeys.map((field, index) => normalizeHeaderTitle(field, index)),...Array.from({ length: extraColumnCount },- (_, index) => `Extra ${index + 1}`+ (_, index) => \`Extra \${index + 1}\`),]@@ -170,11 +255,10 @@ function ToolbarTooltip({)}-export function CsvViewerPreviewClient() {+export function CsvViewer() {const inputRef = React.useRef<HTMLInputElement | null>(null)const isDark = useIsDarkTheme()const [glide, setGlide] = React.useState<GlideDataGridModule | null>(null)- const [fileName, setFileName] = React.useState("invoice-review.csv")const [zoom, setZoom] = React.useState<(typeof ZOOM_OPTIONS)[number]>(1)const [parsed, setParsed] = React.useState(() =>parseDelimitedText(SAMPLE_CSV)@@ -222,11 +306,11 @@ export function CsvViewerPreviewClient() {cellHorizontalPadding: scale(8),cellVerticalPadding: Math.max(2, scale(3)),headerIconSize: scale(18),- baseFontStyle: `${scale(13)}px`,- headerFontStyle: `600 ${scale(13)}px`,- markerFontStyle: `${scale(11)}px`,+ baseFontStyle: \`\${scale(13)}px\`,+ headerFontStyle: \`600 \${scale(13)}px\`,+ markerFontStyle: \`\${scale(11)}px\`,fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',- editorFontSize: `${scale(13)}px`,+ editorFontSize: \`\${scale(13)}px\`,}),[isDark, scale])@@ -234,8 +318,8 @@ export function CsvViewerPreviewClient() {const columns = React.useMemo<GridColumn[]>(() =>Array.from({ length: columnCount }, (_, index) => ({- id: `column-${index}`,- title: parsed.headers[index] ?? `Column ${index + 1}`,+ id: \`column-\${index}\`,+ title: parsed.headers[index] ?? \`Column \${index + 1}\`,width: scale(index === 0 ? 180 : 160),})),[columnCount, parsed.headers, scale]@@ -265,7 +349,6 @@ export function CsvViewerPreviewClient() {try {const text = await file.text()setParsed(parseDelimitedText(text))- setFileName(file.name)} catch (error) {setParsed({headers: [],@@ -290,21 +373,7 @@ export function CsvViewerPreviewClient() {return (<div className="flex h-[560px] w-full flex-col overflow-hidden bg-background">- <div className="flex min-h-12 items-center justify-between gap-3 border-b px-3">- <div className="flex min-w-0 items-center gap-3">- <div className="flex size-7 shrink-0 items-center justify-center rounded-md border bg-muted text-muted-foreground">- <HugeiconsIcon icon={TableIcon} className="size-4" />- </div>- <div className="min-w-0">- <div className="truncate text-sm font-medium text-foreground">- {fileName}- </div>- <div className="text-xs text-muted-foreground">- {parsed.rows.length.toLocaleString()} rows -{" "}- {parsed.headers.length.toLocaleString()} columns- </div>- </div>- </div>+ <div className="flex min-h-12 items-center justify-end gap-3 border-b px-3"><TooltipProvider><div className="ml-auto flex shrink-0 items-center gap-1"><ToolbarTooltip label="Zoom out">@@ -410,473 +479,8 @@ export function CsvViewerPreviewClient() {</div>)}--const csvViewerUsageCode = `"use client";--import * as React from "react";-import type * as GlideDataGrid from "@glideapps/glide-data-grid";-import type {- GridCell,- GridCellKind,- GridColumn,- Item,- Theme,-} from "@glideapps/glide-data-grid";-import {- Loading03Icon,- MinusSignCircleIcon,- PlusSignCircleIcon,- TableIcon,- Upload01Icon,-} from "@hugeicons/core-free-icons";-import { HugeiconsIcon } from "@hugeicons/react";-import Papa from "papaparse";--import { cn } from "@/lib/utils";-import { Button } from "@/components/ui/button";-import {- Select,- SelectContent,- SelectItem,- SelectTrigger,- SelectValue,-} from "@/components/ui/select";-import { Separator } from "@/components/ui/separator";-import {- Tooltip,- TooltipContent,- TooltipProvider,- TooltipTrigger,-} from "@/components/ui/tooltip";--type CsvViewerProps = {- csvText?: string;- fileName?: string;- className?: string;-};--const SAMPLE_CSV = "Invoice,Customer,Status,Amount,Submitted\\nINV-1001,Northstar Supply,Approved,4280.50,2026-04-28\\nINV-1002,Bluebird Medical,Needs review,1190.00,2026-04-29\\nINV-1003,Aster Logistics,Approved,845.75,2026-04-30";--const ZOOM_OPTIONS = [0.75, 1, 1.25, 1.5, 2] as const;-type GlideDataGridModule = typeof GlideDataGrid;--function toDisplayString(value: unknown): string {- return value === null || value === undefined ? "" : String(value);-}--function normalizeHeaderTitle(header: string, index: number): string {- const trimmed = header.trim();- return trimmed.length > 0 ? trimmed : "Column " + (index + 1);-}--function parseDelimitedText(text: string): {- headers: string[];- rows: string[][];- error: string | null;-} {- const results = Papa.parse<Record<string, unknown>>(text, {- header: true,- skipEmptyLines: "greedy",- });-- const objectRows = Array.isArray(results.data)- ? results.data.filter(- (row): row is Record<string, unknown> =>- !!row && typeof row === "object" && !Array.isArray(row),- )- : [];- const metaFields = Array.isArray(results.meta.fields)- ? results.meta.fields.map((field) => String(field))- : [];- const fieldKeys =- metaFields.length > 0- ? metaFields- : Object.keys(objectRows[0] ?? {}).filter(- (key) => key !== "__parsed_extra",- );- const extraColumnCount = objectRows.reduce((maxCount, row) => {- const extras = row.__parsed_extra;- return Array.isArray(extras) ? Math.max(maxCount, extras.length) : maxCount;- }, 0);- const headers = [- ...fieldKeys.map((field, index) => normalizeHeaderTitle(field, index)),- ...Array.from(- { length: extraColumnCount },- (_, index) => "Extra " + (index + 1),- ),- ];-- const rows = objectRows.map((row) => {- const baseValues = fieldKeys.map((fieldKey) =>- toDisplayString(row[fieldKey]),- );- const extras = Array.isArray(row.__parsed_extra)- ? row.__parsed_extra.map((value) => toDisplayString(value))- : [];- const paddedExtras =- extras.length >= extraColumnCount- ? extras.slice(0, extraColumnCount)- : [- ...extras,- ...Array.from(- { length: extraColumnCount - extras.length },- () => "",- ),- ];-- return [...baseValues, ...paddedExtras];- });-- const firstError =- Array.isArray(results.errors) && results.errors.length > 0- ? results.errors[0]- : null;-- return {- headers,- rows,- error:- rows.length === 0 && firstError- ? String(firstError.message ?? "Could not parse CSV file.")- : null,- };-}--function useIsDarkTheme() {- const [isDark, setIsDark] = React.useState(false);-- React.useEffect(() => {- const update = () =>- setIsDark(document.documentElement.classList.contains("dark"));- update();-- const observer = new MutationObserver(update);- observer.observe(document.documentElement, {- attributeFilter: ["class"],- attributes: true,- });-- return () => observer.disconnect();- }, []);-- return isDark;-}--function ToolbarTooltip({- label,- children,-}: {- label: string;- children: React.ReactNode;-}) {- return (- <Tooltip>- <TooltipTrigger asChild>- <span className="inline-flex">{children}</span>- </TooltipTrigger>- <TooltipContent side="bottom">{label}</TooltipContent>- </Tooltip>- );-}--export function CsvViewer({- csvText = SAMPLE_CSV,- fileName: initialFileName = "invoice-review.csv",- className,-}: CsvViewerProps) {- const inputRef = React.useRef<HTMLInputElement | null>(null);- const isDark = useIsDarkTheme();- const [glide, setGlide] = React.useState<GlideDataGridModule | null>(null);- const [fileName, setFileName] = React.useState(initialFileName);- const [zoom, setZoom] = React.useState<(typeof ZOOM_OPTIONS)[number]>(1);- const [parsed, setParsed] = React.useState(() => parseDelimitedText(csvText));- const [isPending, setIsPending] = React.useState(false);-- React.useEffect(() => {- let mounted = true;-- void import("@glideapps/glide-data-grid").then((module) => {- if (mounted) {- setGlide(module);- }- });-- return () => {- mounted = false;- };- }, []);-- const columnCount = Math.max(1, parsed.headers.length);- const scale = React.useCallback(- (value: number) => Math.round(value * zoom),- [zoom],- );-- const theme = React.useMemo<Partial<Theme>>(- () => ({- accentColor: isDark ? "#60a5fa" : "#2563eb",- accentLight: isDark ? "#1d4ed826" : "#dbeafe",- accentFg: "#ffffff",- textDark: isDark ? "#e5e5e5" : "#171717",- textMedium: isDark ? "#a3a3a3" : "#525252",- textLight: isDark ? "#737373" : "#a3a3a3",- textBubble: isDark ? "#f5f5f5" : "#171717",- textHeader: isDark ? "#f5f5f5" : "#171717",- textGroupHeader: isDark ? "#a3a3a3" : "#525252",- bgCell: isDark ? "#0a0a0a" : "#ffffff",- bgCellMedium: isDark ? "#171717" : "#fafafa",- bgHeader: isDark ? "#171717" : "#fafafa",- bgHeaderHasFocus: isDark ? "#262626" : "#f5f5f5",- bgHeaderHovered: isDark ? "#262626" : "#f5f5f5",- borderColor: isDark ? "#262626" : "#e5e5e5",- horizontalBorderColor: isDark ? "#262626" : "#e5e5e5",- cellHorizontalPadding: scale(8),- cellVerticalPadding: Math.max(2, scale(3)),- headerIconSize: scale(18),- baseFontStyle: scale(13) + "px",- headerFontStyle: "600 " + scale(13) + "px",- markerFontStyle: scale(11) + "px",- fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',- editorFontSize: scale(13) + "px",- }),- [isDark, scale],- );-- const columns = React.useMemo<GridColumn[]>(- () =>- Array.from({ length: columnCount }, (_, index) => ({- id: "column-" + index,- title: parsed.headers[index] ?? "Column " + (index + 1),- width: scale(index === 0 ? 180 : 160),- })),- [columnCount, parsed.headers, scale],- );-- const getCellContent = React.useCallback(- ([col, row]: Item): GridCell => {- const value = parsed.rows[row]?.[col] ?? "";- const textKind = glide?.GridCellKind.Text as GridCellKind.Text;-- return {- kind: textKind,- data: value,- displayData: value,- allowOverlay: true,- readonly: true,- };- },- [glide, parsed.rows],- );-- async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {- const file = event.target.files?.[0];- if (!file) return;-- setIsPending(true);- try {- const text = await file.text();- setParsed(parseDelimitedText(text));- setFileName(file.name);- } catch (error) {- setParsed({- headers: [],- rows: [],- error:- error instanceof Error ? error.message : "Could not read CSV file.",- });- } finally {- event.target.value = "";- setIsPending(false);- }- }-- function stepZoom(direction: -1 | 1) {- const index = ZOOM_OPTIONS.indexOf(zoom);- const nextIndex = Math.min(- ZOOM_OPTIONS.length - 1,- Math.max(0, index + direction),- );- setZoom(ZOOM_OPTIONS[nextIndex]);- }-- return (- <div- className={cn(- "flex h-[560px] w-full flex-col overflow-hidden rounded-xl border bg-background",- className,- )}- >- <div className="flex min-h-12 items-center justify-between gap-3 border-b px-3">- <div className="flex min-w-0 items-center gap-3">- <div className="flex size-7 shrink-0 items-center justify-center rounded-md border bg-muted text-muted-foreground">- <HugeiconsIcon icon={TableIcon} className="size-4" />- </div>- <div className="min-w-0">- <div className="truncate text-sm font-medium text-foreground">- {fileName}- </div>- <div className="text-xs text-muted-foreground">- {parsed.rows.length.toLocaleString()} rows -{" "}- {parsed.headers.length.toLocaleString()} columns- </div>- </div>- </div>- <TooltipProvider>- <div className="ml-auto flex shrink-0 items-center gap-1">- <ToolbarTooltip label="Zoom out">- <Button- variant="ghost"- size="icon-sm"- aria-label="Zoom out"- disabled={zoom <= ZOOM_OPTIONS[0]}- onClick={() => stepZoom(-1)}- >- <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />- </Button>- </ToolbarTooltip>- <Select- value={zoom.toString()}- onValueChange={(value) =>- setZoom(Number(value) as (typeof ZOOM_OPTIONS)[number])- }- >- <SelectTrigger- size="sm"- className="w-[84px] min-w-[84px]"- aria-label="Zoom level"- >- <SelectValue>{Math.round(zoom * 100)}%</SelectValue>- </SelectTrigger>- <SelectContent align="end">- {ZOOM_OPTIONS.map((option) => (- <SelectItem key={option} value={option.toString()}>- {Math.round(option * 100)}%- </SelectItem>- ))}- </SelectContent>- </Select>- <ToolbarTooltip label="Zoom in">- <Button- variant="ghost"- size="icon-sm"- aria-label="Zoom in"- disabled={zoom >= ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]}- onClick={() => stepZoom(1)}- >- <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />- </Button>- </ToolbarTooltip>- <Separator- orientation="vertical"- className="mx-1 h-4 self-center"- />- <input- ref={inputRef}- type="file"- accept=".csv,.tsv,text/csv,text/tab-separated-values"- className="hidden"- onChange={handleUpload}- />- <ToolbarTooltip label="Upload CSV">- <Button- variant="ghost"- size="icon-sm"- aria-label="Upload CSV"- loading={isPending}- onClick={() => inputRef.current?.click()}- >- <HugeiconsIcon icon={Upload01Icon} className="size-4" />- </Button>- </ToolbarTooltip>- </div>- </TooltipProvider>- </div>- <div className="min-h-0 flex-1">- {parsed.error ? (- <div className="flex h-full items-center justify-center px-4 text-center text-sm text-destructive">- {parsed.error}- </div>- ) : !glide ? (- <div className="grid h-full place-items-center bg-background">- <HugeiconsIcon icon={Loading03Icon} className="size-4 animate-spin" />- </div>- ) : (- <glide.DataEditor- key={zoom}- columns={columns}- rows={parsed.rows.length}- getCellContent={getCellContent}- rowMarkers="number"- rowSelectionMode="multi"- keybindings={{ search: true }}- smoothScrollX- smoothScrollY- getCellsForSelection- width="100%"- height="100%"- theme={theme}- rowHeight={scale(34)}- headerHeight={scale(36)}- />- )}- </div>- </div>- );-}`--export function CsvViewerDemo() {- const [isCodeVisible, setIsCodeVisible] = React.useState(false)-- return (- <div- data-slot="component-preview"- className="group relative mt-4 mb-12 flex flex-col overflow-hidden rounded-xl border"- >- <CsvViewerPreviewClient />- <div- data-slot="code"- data-mobile-code-visible={isCodeVisible}- className="relative overflow-hidden **:data-[slot=copy-button]:right-4 **:data-[slot=copy-button]:hidden data-[mobile-code-visible=true]:**:data-[slot=copy-button]:flex [&_[data-rehype-pretty-code-figure]]:m-0! [&_[data-rehype-pretty-code-figure]]:rounded-t-none [&_[data-rehype-pretty-code-figure]]:border-t [&_pre]:max-h-72"- >- {isCodeVisible ? (- <HighlightedCodeBlock- code={csvViewerUsageCode}- className="rounded-none border-x-0 border-b-0"- />- ) : (- <div className="relative">- <HighlightedCodeBlock- code={csvViewerUsageCode}- className="rounded-none border-x-0 border-b-0"- maxHeightClassName="max-h-56"- previewLines={10}- showCopy={false}- />- <div className="absolute inset-0 flex items-center justify-center pb-4">- <div- className="absolute inset-0"- style={{- background:- "linear-gradient(to top, var(--color-code), color-mix(in oklab, var(--color-code) 60%, transparent), transparent)",- }}- />- <Button- type="button"- size="sm"- variant="outline"- className="relative z-10 rounded-lg bg-background text-foreground shadow-none hover:bg-muted dark:bg-background dark:text-foreground dark:hover:bg-muted"- onClick={() => setIsCodeVisible(true)}- >- View Code- </Button>- </div>- </div>- )}- </div>- </div>- )-}+`export function CsvViewerSource() {- return <HighlightedCodeBlock code={csvViewerUsageCode} />+ return <HighlightedCodeBlock code={csvViewerSourceCode} />}diff --git a/apps/v4/components/document-splitter-docs.tsx b/apps/v4/components/document-splitter-docs.tsxindex c0ecef4..5ee12f5 100644--- a/apps/v4/components/document-splitter-docs.tsx+++ b/apps/v4/components/document-splitter-docs.tsx@@ -22,45 +22,80 @@ import {verticalListSortingStrategy,} from "@dnd-kit/sortable"import { CSS } from "@dnd-kit/utilities"+import {+ useXlsxViewer,+ useXlsxViewerController,+ useXlsxViewerThumbnails,+ XlsxViewerProvider,+} from "@extend-ai/react-xlsx"import {Add01Icon,Delete02Icon,DragDropVerticalIcon,} from "@hugeicons/core-free-icons"import { HugeiconsIcon } from "@hugeicons/react"+import { useTheme } from "next-themes"import type * as ReactPdf from "react-pdf"import { cn } from "@/lib/utils"import { Button } from "@/components/ui/button"+import {+ FileThumbnail,+ type ThumbnailFile,+} from "@/components/ui/file-thumbnail"import { PDFViewer, type PDFViewerHandle } from "@/components/ui/pdf-viewer"import { ScrollArea } from "@/components/ui/scroll-area"-import { FileThumbnailLoadingOverlay } from "@/components/file-thumbnail-docs"+import {+ useWorkbookNightRenderPreference,+ WorkbookSheetTabs,+ WorkbookTableHeaderMenu,+ XlsxWorkbookSurface,+} from "@/components/ui/xlsx-viewer"import { HighlightedCodeBlock } from "@/components/highlighted-code-block"import { PdfBlockResizableShell } from "@/components/pdf-block-resizable-shell"import { Badge } from "@/registry/new-york-v4/ui/badge"import { Card } from "@/registry/new-york-v4/ui/card"type ReactPdfModule = typeof ReactPdf-type PageId = `page-${number}`+export type DocumentSplitPageId = `page-${number}`+export type DocumentSplitItemId = string+type PageId = DocumentSplitItemId+type WorkbookSheetId = `sheet-${number}`-type SplitGroup = {+export type DocumentSplit = {id: stringtitle: string- pages: PageId[]+ pages: DocumentSplitItemId[]}+type SplitGroup = DocumentSplitconst PDF_URL = "/samples/attention.pdf"+const XLSX_URL = "/samples/crazy-chart-zoo.xlsx"+const XLSX_THUMBNAIL_FILE = {+ name: "crazy-chart-zoo.xlsx",+ type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",+ url: XLSX_URL,+}const PDF_WORKER_URL = new URL("pdfjs-dist/legacy/build/pdf.worker.min.mjs",import.meta.url).toString()const THUMBNAIL_WIDTH = 72const THUMBNAIL_HEIGHT = 92-const THUMBNAIL_ROOT_MARGIN = "360px"+const SHEET_THUMBNAIL_WIDTH = 112+const SHEET_THUMBNAIL_HEIGHT = 76const DEFAULT_ZOOM = 0.75const DEFAULT_PREVIEW_PAGE_COUNT = 15+const DEFAULT_PREVIEW_SHEET_COUNT = 8const DRAG_OVERLAY_DROP_ANIMATION = null+type ThumbnailLabelPlacement = "corner" | "bottom"++type ThumbnailSize = {+ width: number+ height: number+}+const splitterCollisionDetection: CollisionDetection = (args) => {const dragType = args.active.data.current?.type@@ -92,7 +127,7 @@ function toPageId(pageNumber: number): PageId {return `page-${pageNumber}`}-function getPageNumber(pageId: PageId): number {+function getPageNumber(pageId: DocumentSplitItemId): number {return Number(pageId.replace("page-", ""))}@@ -100,6 +135,14 @@ function getSplitSortableId(groupId: string) {return `split-sortable-${groupId}`}+function toWorkbookSheetId(sheetIndex: number): WorkbookSheetId {+ return `sheet-${sheetIndex}`+}++function getWorkbookSheetIndex(sheetId: WorkbookSheetId): number {+ return Number(sheetId.replace("sheet-", ""))+}+function createInitialGroups(pageCount: number): SplitGroup[] {const pages = Array.from({ length: pageCount }, (_, index) =>toPageId(index + 1)@@ -124,6 +167,30 @@ function createInitialGroups(pageCount: number): SplitGroup[] {].filter((group) => group.pages.length > 0)}+function createInitialWorkbookSplits(sheetCount: number): DocumentSplit[] {+ const sheets = Array.from({ length: sheetCount }, (_, index) =>+ toWorkbookSheetId(index)+ )++ return [+ {+ id: "workbook-split-1",+ title: "Workbook guide",+ pages: sheets.slice(0, Math.min(1, sheetCount)),+ },+ {+ id: "workbook-split-2",+ title: "Chart review",+ pages: sheets.slice(1, Math.min(6, sheetCount)),+ },+ {+ id: "workbook-split-3",+ title: "Format checks",+ pages: sheets.slice(6),+ },+ ].filter((group) => group.pages.length > 0)+}+function formatPageRanges(pageIds: PageId[]) {if (pageIds.length === 0) return "No pages"@@ -154,37 +221,18 @@ function createPageRangeLabels(groups: SplitGroup[]) {)}-function useLazyThumbnail() {- const [node, setNode] = React.useState<HTMLDivElement | null>(null)- const [shouldRender, setShouldRender] = React.useState(false)-- React.useEffect(() => {- if (!node || shouldRender) return-- const observer = new IntersectionObserver(- ([entry]) => {- if (entry?.isIntersecting) {- setShouldRender(true)- observer.disconnect()- }- },- { rootMargin: THUMBNAIL_ROOT_MARGIN }- )-- observer.observe(node)+function createWorkbookSplitLabel(split: DocumentSplit, sheetNames: string[]) {+ if (split.pages.length === 0) return "No sheets"- return () => observer.disconnect()- }, [node, shouldRender])+ const names = split.pages.map((sheetId) => {+ const sheetIndex = getWorkbookSheetIndex(sheetId as WorkbookSheetId)- return { setNode, shouldRender }-}+ return sheetNames[sheetIndex] ?? `Sheet ${sheetIndex + 1}`+ })+ const visibleNames = names.slice(0, 2).join(", ")+ const hiddenCount = names.length - 2-function PageThumbnailLoading() {- return (- <div className="absolute inset-0 overflow-hidden bg-muted">- <FileThumbnailLoadingOverlay />- </div>- )+ return hiddenCount > 0 ? `${visibleNames} +${hiddenCount}` : visibleNames}function SplitGroupDropzone({@@ -218,40 +266,30 @@ function SplitGroupDropzone({}const PageThumbnailPreview = React.memo(function PageThumbnailPreview({- pageId,- pageNumber,- reactPdf,+ itemFile,+ itemId,+ itemLabel,+ labelPlacement,isActive,imageUrl,+ thumbnailSize,onSelect,- onThumbnailReady,}: {- pageId: PageId- pageNumber: number- reactPdf: ReactPdfModule | null+ itemFile: ThumbnailFile+ itemId: DocumentSplitItemId+ itemLabel: React.ReactNode+ labelPlacement: ThumbnailLabelPlacementisActive: booleanimageUrl?: string- onSelect: (pageNumber: number) => void- onThumbnailReady?: (pageId: PageId, imageUrl: string) => void+ thumbnailSize: ThumbnailSize+ onSelect: (itemId: DocumentSplitItemId) => void}) {- const [isThumbnailLoading, setIsThumbnailLoading] = React.useState(true)- const { setNode, shouldRender } = useLazyThumbnail()- const rootRef = React.useRef<HTMLButtonElement>(null)-- React.useEffect(() => {- if (reactPdf && shouldRender) {- setIsThumbnailLoading(true)- }- }, [pageNumber, reactPdf, shouldRender])-return (<div- ref={setNode}className="relative"- style={{ width: THUMBNAIL_WIDTH, height: THUMBNAIL_HEIGHT }}+ style={{ width: thumbnailSize.width, height: thumbnailSize.height }}><button- ref={rootRef}type="button"className={cn("relative cursor-grab overflow-hidden rounded-md border bg-muted text-left shadow-xs transition-[border-color,box-shadow,opacity] active:cursor-grabbing",@@ -259,61 +297,26 @@ const PageThumbnailPreview = React.memo(function PageThumbnailPreview({? "border-blue-500 shadow-[0_0_0_2px_rgb(59_130_246_/_14%)]": "border-border hover:border-foreground/30")}- style={{ width: THUMBNAIL_WIDTH, height: THUMBNAIL_HEIGHT }}- onClick={() => onSelect(pageNumber)}+ style={{ width: thumbnailSize.width, height: thumbnailSize.height }}+ onClick={() => onSelect(itemId)}>- {imageUrl ? (- <img- src={imageUrl}- alt=""- className="absolute inset-0 size-full object-cover"- draggable={false}- />- ) : reactPdf && shouldRender ? (- <>- <reactPdf.Thumbnail- pageNumber={pageNumber}- width={THUMBNAIL_WIDTH}- className={cn(- "absolute inset-0 block size-full [&_.react-pdf__Thumbnail__page]:!m-0 [&_.react-pdf__Thumbnail__page]:!size-full [&_.react-pdf__Thumbnail__page]:overflow-hidden [&_canvas]:!size-full [&_canvas]:object-cover [&_canvas]:align-top [&_canvas]:transition-[opacity,filter,transform] [&_canvas]:duration-[160ms] [&_canvas]:ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:[&_canvas]:transition-none",- isThumbnailLoading- ? "[&_canvas]:scale-[1.01] [&_canvas]:opacity-0 [&_canvas]:blur-sm"- : "[&_canvas]:blur-0 [&_canvas]:scale-100 [&_canvas]:opacity-100"- )}- onItemClick={({ pageNumber: clickedPageNumber }) => {- onSelect(clickedPageNumber)- }}- onRenderSuccess={() => {- setIsThumbnailLoading(false)-- if (!onThumbnailReady) return-- window.requestAnimationFrame(() => {- const canvas = rootRef.current?.querySelector("canvas")-- if (!canvas) return-- try {- canvas.toBlob((blob) => {- if (!blob) return-- onThumbnailReady(pageId, URL.createObjectURL(blob))- }, "image/png")- } catch {- // Canvas export can fail if the browser marks it tainted.- }- })- }}- onRenderError={() => setIsThumbnailLoading(false)}- loading={null}- />- {isThumbnailLoading ? <PageThumbnailLoading /> : null}- </>- ) : (- <PageThumbnailLoading />- )}- <span className="absolute right-1 bottom-1 rounded bg-background/90 px-1.5 py-0.5 text-[10px] font-medium shadow-xs">- {pageNumber}+ <FileThumbnail+ file={itemFile}+ showMetadata={false}+ previewImageUrl={imageUrl}+ previewClassName="h-full aspect-auto"+ className="size-full rounded-[inherit] border-0"+ isLoading={!imageUrl}+ />+ <span+ className={cn(+ "absolute bottom-1 rounded bg-background/90 px-1.5 py-0.5 text-[10px] font-medium shadow-xs",+ labelPlacement === "bottom"+ ? "inset-x-1 truncate"+ : "right-1 max-w-[calc(100%-0.5rem)]"+ )}+ >+ {itemLabel}</span></button></div>@@ -321,23 +324,25 @@ const PageThumbnailPreview = React.memo(function PageThumbnailPreview({})function SortablePageThumbnail({+ getItemFile,+ getItemLabel,groupId,pageId,- pageNumber,- reactPdf,+ labelPlacement,isActive,imageUrl,+ thumbnailSize,onSelect,- onThumbnailReady,}: {+ getItemFile: (itemId: DocumentSplitItemId) => ThumbnailFile+ getItemLabel: (itemId: DocumentSplitItemId) => React.ReactNodegroupId: stringpageId: PageId- pageNumber: number- reactPdf: ReactPdfModule | null+ labelPlacement: ThumbnailLabelPlacementisActive: booleanimageUrl?: string- onSelect: (pageNumber: number) => void- onThumbnailReady?: (pageId: PageId, imageUrl: string) => void+ thumbnailSize: ThumbnailSize+ onSelect: (itemId: DocumentSplitItemId) => void}) {const {attributes,@@ -367,119 +372,52 @@ function SortablePageThumbnail({{...listeners}><PageThumbnailPreview- pageId={pageId}- pageNumber={pageNumber}- reactPdf={reactPdf}+ itemFile={getItemFile(pageId)}+ itemId={pageId}+ itemLabel={getItemLabel(pageId)}+ labelPlacement={labelPlacement}isActive={isActive}imageUrl={imageUrl}+ thumbnailSize={thumbnailSize}onSelect={onSelect}- onThumbnailReady={onThumbnailReady}/></div>)}function SplitGroupCard({+ activeItemId,+ emptyLabel,+ getItemFile,+ getItemLabel,group,+ labelPlacement,pageRangeLabel,- reactPdf,- activePage,canReorder = false,dragHandleProps,isPageDragging = false,thumbnailImages,+ thumbnailSize,canRemove,onRemove,- onSelectPage,- onThumbnailReady,+ onSelectItem,}: {+ activeItemId?: DocumentSplitItemId+ emptyLabel: string+ getItemFile: (itemId: DocumentSplitItemId) => ThumbnailFile+ getItemLabel: (itemId: DocumentSplitItemId) => React.ReactNodegroup: SplitGroup+ labelPlacement: ThumbnailLabelPlacementpageRangeLabel: string- reactPdf: ReactPdfModule | null- activePage: numbercanReorder?: booleandragHandleProps?: React.ComponentPropsWithoutRef<"button">isPageDragging?: boolean- thumbnailImages?: Record<PageId, string>+ thumbnailImages?: Record<DocumentSplitItemId, string>+ thumbnailSize: ThumbnailSizecanRemove: booleanonRemove: () => void- onSelectPage: (pageNumber: number) => void- onThumbnailReady?: (pageId: PageId, imageUrl: string) => void+ onSelectItem: (itemId: DocumentSplitItemId) => void}) {- if (!reactPdf) {- return (- <Card className="overflow-hidden rounded-xl before:rounded-[calc(var(--radius-xl)-1px)]">- <div className="flex items-start justify-between gap-3 border-b p-3">- <div className="flex min-w-0 items-start gap-2">- <button- type="button"- aria-label={`Reorder ${group.title}`}- className="mt-0.5 inline-flex size-7 shrink-0 cursor-default items-center justify-center rounded-md text-muted-foreground"- disabled- >- <HugeiconsIcon icon={DragDropVerticalIcon} className="size-4" />- </button>- <div className="min-w-0">- <div className="truncate text-sm font-medium">{group.title}</div>- <div className="mt-1 text-xs text-muted-foreground">- {pageRangeLabel}- </div>- </div>- </div>- <div className="flex shrink-0 items-center gap-2">- <Badge variant="secondary" className="rounded-full">- {group.pages.length}- </Badge>- {canRemove ? (- <Button- type="button"- variant="ghost"- size="icon-sm"- aria-label={`Remove ${group.title}`}- onClick={onRemove}- >- <HugeiconsIcon icon={Delete02Icon} className="size-4" />- </Button>- ) : null}- </div>- </div>- <div className="min-h-[116px] rounded-lg p-2">- <ScrollArea- className="h-[110px] w-full overflow-hidden"- orientation="horizontal"- scrollbarGutter- scrollbarOverflowOnly- viewportClassName="overflow-y-hidden"- >- <div className="flex w-max gap-2 overflow-y-hidden py-1 pr-6">- {group.pages.map((pageId) => {- const pageNumber = getPageNumber(pageId)-- return (- <div- key={pageId}- className={cn(- "relative shrink-0 overflow-hidden rounded-md border bg-muted shadow-xs",- activePage === pageNumber- ? "border-blue-500 shadow-[0_0_0_2px_rgb(59_130_246_/_14%)]"- : "border-border"- )}- style={{ width: THUMBNAIL_WIDTH, height: THUMBNAIL_HEIGHT }}- >- <PageThumbnailLoading />- <span className="absolute right-1 bottom-1 rounded bg-background/90 px-1.5 py-0.5 text-[10px] font-medium shadow-xs">- {pageNumber}- </span>- </div>- )- })}- </div>- </ScrollArea>- </div>- </Card>- )- }-return (<Card className="overflow-hidden rounded-xl before:rounded-[calc(var(--radius-xl)-1px)]"><div className="flex items-start justify-between gap-3 border-b p-3">@@ -541,19 +479,18 @@ function SplitGroupCard({><div className="flex w-max gap-2 overflow-y-hidden py-1 pr-6">{group.pages.map((pageId) => {- const pageNumber = getPageNumber(pageId)-return (<SortablePageThumbnailkey={pageId}+ getItemFile={getItemFile}+ getItemLabel={getItemLabel}groupId={group.id}pageId={pageId}- pageNumber={pageNumber}- reactPdf={reactPdf}- isActive={activePage === pageNumber}+ labelPlacement={labelPlacement}+ isActive={activeItemId === pageId}imageUrl={thumbnailImages?.[pageId]}- onSelect={onSelectPage}- onThumbnailReady={onThumbnailReady}+ thumbnailSize={thumbnailSize}+ onSelect={onSelectItem}/>)})}@@ -562,7 +499,7 @@ function SplitGroupCard({</SortableContext>) : (<div className="grid h-[104px] place-items-center rounded-lg bg-muted/35 text-xs text-muted-foreground">- Drop pages here+ {emptyLabel}</div>)}</SplitGroupDropzone>@@ -608,31 +545,42 @@ function SortableSplitGroupCard(}function PageDragOverlay({+ getItemFile,+ getItemLabel,+ labelPlacement,pageId,imageUrl,+ thumbnailSize,}: {+ getItemFile: (itemId: DocumentSplitItemId) => ThumbnailFile+ getItemLabel: (itemId: DocumentSplitItemId) => React.ReactNode+ labelPlacement: ThumbnailLabelPlacementpageId: PageIdimageUrl?: string+ thumbnailSize: ThumbnailSize}) {- const pageNumber = getPageNumber(pageId)-return (<divclassName="relative overflow-hidden rounded-md border border-blue-500 bg-background shadow-lg shadow-black/10"- style={{ width: THUMBNAIL_WIDTH, height: THUMBNAIL_HEIGHT }}+ style={{ width: thumbnailSize.width, height: thumbnailSize.height }}>- {imageUrl ? (- <img- src={imageUrl}- alt=""- className="size-full object-cover"- draggable={false}- />- ) : (- <PageThumbnailLoading />- )}- <span className="absolute right-1 bottom-1 rounded bg-background/90 px-1.5 py-0.5 text-[10px] font-medium shadow-xs">- {pageNumber}+ <FileThumbnail+ file={getItemFile(pageId)}+ showMetadata={false}+ previewImageUrl={imageUrl}+ previewClassName="h-full aspect-auto"+ className="size-full rounded-[inherit] border-0"+ isLoading={!imageUrl}+ />+ <span+ className={cn(+ "absolute bottom-1 rounded bg-background/90 px-1.5 py-0.5 text-[10px] font-medium shadow-xs",+ labelPlacement === "bottom"+ ? "inset-x-1 truncate"+ : "right-1 max-w-[calc(100%-0.5rem)]"+ )}+ >+ {getItemLabel(pageId)}</span></div>)@@ -697,31 +645,86 @@ function reorderPageInGroup({)}-function SplitterGroupsPane({+function useWorkbookSheetThumbnailUrls(workbookIdentity: string) {+ const { thumbnails } = useXlsxViewerThumbnails({+ includeHeaders: true,+ resolution: {+ maxHeight: 320,+ maxWidth: 520,+ },+ })+ const [thumbnailUrls, setThumbnailUrls] = React.useState<+ Record<number, string>+ >({})++ React.useEffect(() => {+ setThumbnailUrls({})+ }, [workbookIdentity])++ React.useEffect(() => {+ thumbnails.forEach((thumbnail) => {+ setThumbnailUrls((current) => {+ if (current[thumbnail.sheetIndex]) return current++ const canvas = document.createElement("canvas")+ canvas.width = thumbnail.width+ canvas.height = thumbnail.height++ if (!thumbnail.paint(canvas)) return current++ return {+ ...current,+ [thumbnail.sheetIndex]: canvas.toDataURL("image/png"),+ }+ })+ })+ }, [thumbnails])++ return thumbnailUrls+}++export function DocumentSplits({+ activeItemId,activePage,+ addSplitLabel = "Add split",className,- documentKey,- pageCount,- reactPdf,+ dndId = "document-splits-dnd",+ emptyLabel = "Drop pages here",+ getItemFile,+ getItemLabel,+ getSplitLabel,+ labelPlacement = "corner",+ splits,+ thumbnailSize = { width: THUMBNAIL_WIDTH, height: THUMBNAIL_HEIGHT },+ thumbnailImages = {},withFrameDivider = true,+ onSplitsChange,+ onSelectItem,onSelectPage,+ onAddSplit,+ onRemoveSplit,}: {- activePage: number+ activeItemId?: DocumentSplitItemId+ activePage?: number+ addSplitLabel?: stringclassName?: string- documentKey: string- pageCount: number- reactPdf: ReactPdfModule | null+ dndId?: string+ emptyLabel?: string+ getItemFile?: (itemId: DocumentSplitItemId) => ThumbnailFile+ getItemLabel?: (itemId: DocumentSplitItemId) => React.ReactNode+ getSplitLabel?: (split: DocumentSplit) => string+ labelPlacement?: ThumbnailLabelPlacement+ splits: DocumentSplit[]+ thumbnailSize?: ThumbnailSize+ thumbnailImages?: Record<DocumentSplitItemId, string>withFrameDivider?: boolean- onSelectPage: (pageNumber: number) => void+ onSplitsChange: (splits: DocumentSplit[]) => void+ onSelectItem?: (itemId: DocumentSplitItemId) => void+ onSelectPage?: (pageNumber: number) => void+ onAddSplit?: () => void+ onRemoveSplit?: (groupId: string) => void}) {- const [groups, setGroups] = React.useState<SplitGroup[]>(() =>- createInitialGroups(DEFAULT_PREVIEW_PAGE_COUNT)- )const [activePageId, setActivePageId] = React.useState<PageId | null>(null)- const [thumbnailImages, setThumbnailImages] = React.useState<- Record<PageId, string>- >({})- const thumbnailObjectUrlsRef = React.useRef(new Set<string>())const dragStartGroupIdRef = React.useRef<string | null>(null)const dragStartGroupsRef = React.useRef<SplitGroup[] | null>(null)const sensors = useSensors(@@ -730,81 +733,87 @@ function SplitterGroupsPane({}))- const clearCachedThumbnails = React.useCallback(() => {- thumbnailObjectUrlsRef.current.forEach((imageUrl) => {- URL.revokeObjectURL(imageUrl)- })- thumbnailObjectUrlsRef.current.clear()- setThumbnailImages({})- }, [])-- React.useEffect(() => {- const nextGroups = createInitialGroups(- pageCount || DEFAULT_PREVIEW_PAGE_COUNT- )-- setGroups(nextGroups)- clearCachedThumbnails()- setActivePageId(null)- }, [clearCachedThumbnails, documentKey, pageCount])+ const pageRangeLabels = React.useMemo(+ () => createPageRangeLabels(splits),+ [splits]+ )+ const resolvedActiveItemId =+ activeItemId ?? (activePage ? toPageId(activePage) : undefined)+ const resolvedGetItemLabel = React.useCallback(+ (itemId: DocumentSplitItemId) =>+ getItemLabel?.(itemId) ?? getPageNumber(itemId),+ [getItemLabel]+ )+ const resolvedGetItemFile = React.useCallback(+ (itemId: DocumentSplitItemId): ThumbnailFile => {+ if (getItemFile) return getItemFile(itemId)- React.useEffect(() => {- const objectUrls = thumbnailObjectUrlsRef.current+ const pageNumber = getPageNumber(itemId)- return () => {- objectUrls.forEach((imageUrl) => {- URL.revokeObjectURL(imageUrl)- })- objectUrls.clear()- }- }, [])+ return {+ name: `page-${pageNumber}.pdf`,+ type: "application/pdf",+ size: `Page ${pageNumber}`,+ }+ },+ [getItemFile]+ )+ const selectItem = React.useCallback(+ (itemId: DocumentSplitItemId) => {+ if (onSelectItem) {+ onSelectItem(itemId)+ return+ }- const pageRangeLabels = React.useMemo(- () => createPageRangeLabels(groups),- [groups]+ onSelectPage?.(getPageNumber(itemId))+ },+ [onSelectItem, onSelectPage])const addSplit = React.useCallback(() => {- setGroups((previousGroups) => [- ...previousGroups,+ if (onAddSplit) {+ onAddSplit()+ return+ }++ onSplitsChange([+ ...splits,{- id: `split-${Date.now()}-${previousGroups.length}`,- title: `Split ${previousGroups.length + 1}`,+ id: `split-${Date.now()}-${splits.length}`,+ title: `Split ${splits.length + 1}`,pages: [],},])- }, [])+ }, [onAddSplit, onSplitsChange, splits])- const removeSplit = React.useCallback((groupId: string) => {- setGroups((previousGroups) => {- const groupToRemove = previousGroups.find((group) => group.id === groupId)- const remainingGroups = previousGroups.filter(- (group) => group.id !== groupId- )+ const removeSplit = React.useCallback(+ (groupId: string) => {+ if (onRemoveSplit) {+ onRemoveSplit(groupId)+ return+ }- if (!groupToRemove || remainingGroups.length === 0) return previousGroups+ const groupToRemove = splits.find((group) => group.id === groupId)+ const remainingGroups = splits.filter((group) => group.id !== groupId)- return remainingGroups.map((group, index) =>- index === 0- ? { ...group, pages: [...group.pages, ...groupToRemove.pages] }- : group- )- })- }, [])+ if (!groupToRemove || remainingGroups.length === 0) return- const handleThumbnailReady = React.useCallback(- (pageId: PageId, imageUrl: string) => {- setThumbnailImages((currentImages) => {- if (currentImages[pageId]) {- URL.revokeObjectURL(imageUrl)- return currentImages- }+ onSplitsChange(+ remainingGroups.map((group, index) =>+ index === 0+ ? { ...group, pages: [...group.pages, ...groupToRemove.pages] }+ : group+ )+ )+ },+ [onRemoveSplit, onSplitsChange, splits]+ )- thumbnailObjectUrlsRef.current.add(imageUrl)- return { ...currentImages, [pageId]: imageUrl }- })+ const updateSplits = React.useCallback(+ (updater: (currentSplits: SplitGroup[]) => SplitGroup[]) => {+ onSplitsChange(updater(splits))},- []+ [onSplitsChange, splits])const handleDragStart = React.useCallback(@@ -813,8 +822,8 @@ function SplitterGroupsPane({if (dragType === "page") {const pageId = String(event.active.id) as PageId- dragStartGroupIdRef.current = findGroupId(groups, pageId)- dragStartGroupsRef.current = groups+ dragStartGroupIdRef.current = findGroupId(splits, pageId)+ dragStartGroupsRef.current = splitssetActivePageId(pageId)return}@@ -823,111 +832,118 @@ function SplitterGroupsPane({dragStartGroupsRef.current = nullsetActivePageId(null)},- [groups]+ [splits])- const handleDragOver = React.useCallback((event: DragOverEvent) => {- const dragType = event.active.data.current?.type- const overId = event.over?.id-- if (dragType !== "page" || !overId) return+ const handleDragOver = React.useCallback(+ (event: DragOverEvent) => {+ const dragType = event.active.data.current?.type+ const overId = event.over?.id- const pageId = String(event.active.id) as PageId+ if (dragType !== "page" || !overId) return- setGroups((previousGroups) => {- const sourceGroupId = findGroupId(previousGroups, pageId)- const targetGroupId = findGroupId(previousGroups, String(overId))+ const pageId = String(event.active.id) as PageId- if (!sourceGroupId || !targetGroupId || sourceGroupId === targetGroupId) {- return previousGroups- }+ updateSplits((previousSplits) => {+ const sourceGroupId = findGroupId(previousSplits, pageId)+ const targetGroupId = findGroupId(previousSplits, String(overId))- const targetPages = getGroupPages(previousGroups, targetGroupId)- const overPageIndex = targetPages.indexOf(String(overId) as PageId)- const overRect = event.over?.rect- const activeRect = event.active.rect.current.translated- const isAfterOverPage =- overPageIndex !== -1 &&- activeRect &&- overRect &&- activeRect.left > overRect.left + overRect.width / 2- const insertIndex =- overPageIndex === -1- ? targetPages.length- : overPageIndex + (isAfterOverPage ? 1 : 0)+ if (+ !sourceGroupId ||+ !targetGroupId ||+ sourceGroupId === targetGroupId+ ) {+ return previousSplits+ }- return movePageToGroup({- groups: previousGroups,- activePageId: pageId,- targetGroupId,- insertIndex,+ const targetPages = getGroupPages(previousSplits, targetGroupId)+ const overPageIndex = targetPages.indexOf(String(overId) as PageId)+ const overRect = event.over?.rect+ const activeRect = event.active.rect.current.translated+ const isAfterOverPage =+ overPageIndex !== -1 &&+ activeRect &&+ overRect &&+ activeRect.left > overRect.left + overRect.width / 2+ const insertIndex =+ overPageIndex === -1+ ? targetPages.length+ : overPageIndex + (isAfterOverPage ? 1 : 0)++ return movePageToGroup({+ groups: previousSplits,+ activePageId: pageId,+ targetGroupId,+ insertIndex,+ })})- })- }, [])-- const handleDragEnd = React.useCallback((event: DragEndEvent) => {- const dragType = event.active.data.current?.type- const overId = event.over?.id-- if (dragType === "split" && overId) {- const activeGroupId = event.active.data.current?.groupId as- | string- | undefined- const overGroupId = event.over?.data.current?.groupId as- | string- | undefined-- setGroups((previousGroups) => {- const activeIndex = previousGroups.findIndex(- (group) => group.id === activeGroupId- )- const overIndex = previousGroups.findIndex(- (group) => group.id === overGroupId- )-- if (activeIndex === -1 || overIndex === -1) return previousGroups+ },+ [updateSplits]+ )- return arrayMove(previousGroups, activeIndex, overIndex)- })- }+ const handleDragEnd = React.useCallback(+ (event: DragEndEvent) => {+ const dragType = event.active.data.current?.type+ const overId = event.over?.id++ if (dragType === "split" && overId) {+ const activeGroupId = event.active.data.current?.groupId as+ | string+ | undefined+ const overGroupId = event.over?.data.current?.groupId as+ | string+ | undefined++ updateSplits((previousSplits) => {+ const activeIndex = previousSplits.findIndex(+ (group) => group.id === activeGroupId+ )+ const overIndex = previousSplits.findIndex(+ (group) => group.id === overGroupId+ )++ if (activeIndex === -1 || overIndex === -1) return previousSplits++ return arrayMove(previousSplits, activeIndex, overIndex)+ })+ }- if (dragType === "page" && overId) {- const activePageId = String(event.active.id) as PageId- const overPageId = String(overId) as PageId+ if (dragType === "page" && overId) {+ const activePageId = String(event.active.id) as PageId+ const overPageId = String(overId) as PageId- setGroups((previousGroups) => {- const overGroupId = findGroupId(previousGroups, String(overId))+ updateSplits((previousSplits) => {+ const overGroupId = findGroupId(previousSplits, String(overId))- if (dragStartGroupIdRef.current !== overGroupId) {- return previousGroups- }+ if (dragStartGroupIdRef.current !== overGroupId) {+ return previousSplits+ }- return reorderPageInGroup({- groups: previousGroups,- activePageId,- overPageId,+ return reorderPageInGroup({+ groups: previousSplits,+ activePageId,+ overPageId,+ })})- })- }+ }- dragStartGroupIdRef.current = null- dragStartGroupsRef.current = null- setActivePageId(null)- }, [])+ dragStartGroupIdRef.current = null+ dragStartGroupsRef.current = null+ setActivePageId(null)+ },+ [updateSplits]+ )const handleDragCancel = React.useCallback(() => {if (dragStartGroupsRef.current) {- setGroups(dragStartGroupsRef.current)+ onSplitsChange(dragStartGroupsRef.current)}dragStartGroupIdRef.current = nulldragStartGroupsRef.current = nullsetActivePageId(null)- }, [])+ }, [onSplitsChange])- const visibleActivePage = activePageId- ? getPageNumber(activePageId)- : activePageconst isPageDragging = activePageId !== nullreturn (@@ -941,130 +957,312 @@ function SplitterGroupsPane({<div className="flex min-h-12 items-center justify-end gap-3 border-b bg-background px-3"><Button type="button" variant="outline" size="sm" onClick={addSplit}><HugeiconsIcon icon={Add01Icon} className="size-4" />- Add split+ {addSplitLabel}</Button></div>- {reactPdf ? (- <DndContext- sensors={sensors}- collisionDetection={splitterCollisionDetection}- onDragStart={handleDragStart}- onDragOver={handleDragOver}- onDragEnd={handleDragEnd}- onDragCancel={handleDragCancel}- >- <ScrollArea className="min-h-0 flex-1" scrollFade>- <SortableContext- items={groups.map((group) => getSplitSortableId(group.id))}- strategy={verticalListSortingStrategy}- >- <div className="space-y-3 p-3">- {groups.map((group) => (- <SortableSplitGroupCard- key={group.id}- group={group}- pageRangeLabel={pageRangeLabels[group.id] ?? "No pages"}- reactPdf={reactPdf}- activePage={visibleActivePage}- isPageDragging={isPageDragging}- thumbnailImages={thumbnailImages}- canRemove={groups.length > 1}- onRemove={() => removeSplit(group.id)}- onSelectPage={onSelectPage}- onThumbnailReady={handleThumbnailReady}- />- ))}- </div>- </SortableContext>- </ScrollArea>- <DragOverlay dropAnimation={DRAG_OVERLAY_DROP_ANIMATION}>- {activePageId ? (- <PageDragOverlay- pageId={activePageId}- imageUrl={thumbnailImages[activePageId]}- />- ) : null}- </DragOverlay>- </DndContext>- ) : (+ <DndContext+ id={dndId}+ sensors={sensors}+ collisionDetection={splitterCollisionDetection}+ onDragStart={handleDragStart}+ onDragOver={handleDragOver}+ onDragEnd={handleDragEnd}+ onDragCancel={handleDragCancel}+ ><ScrollArea className="min-h-0 flex-1" scrollFade>- <div className="space-y-3 p-3">- {groups.map((group) => (- <SplitGroupCard- key={group.id}- group={group}- pageRangeLabel={pageRangeLabels[group.id] ?? "No pages"}- reactPdf={null}- activePage={visibleActivePage}- canRemove={groups.length > 1}- onRemove={() => removeSplit(group.id)}- onSelectPage={onSelectPage}- />- ))}- </div>+ <SortableContext+ items={splits.map((group) => getSplitSortableId(group.id))}+ strategy={verticalListSortingStrategy}+ >+ <div className="space-y-3 p-3">+ {splits.map((group) => (+ <SortableSplitGroupCard+ key={group.id}+ activeItemId={+ activePageId ? activePageId : resolvedActiveItemId+ }+ emptyLabel={emptyLabel}+ getItemFile={resolvedGetItemFile}+ getItemLabel={resolvedGetItemLabel}+ group={group}+ labelPlacement={labelPlacement}+ pageRangeLabel={+ getSplitLabel?.(group) ??+ pageRangeLabels[group.id] ??+ "No pages"+ }+ isPageDragging={isPageDragging}+ thumbnailImages={thumbnailImages}+ thumbnailSize={thumbnailSize}+ canRemove={splits.length > 1}+ onRemove={() => removeSplit(group.id)}+ onSelectItem={selectItem}+ />+ ))}+ </div>+ </SortableContext></ScrollArea>- )}+ <DragOverlay dropAnimation={DRAG_OVERLAY_DROP_ANIMATION}>+ {activePageId ? (+ <PageDragOverlay+ getItemFile={resolvedGetItemFile}+ getItemLabel={resolvedGetItemLabel}+ labelPlacement={labelPlacement}+ pageId={activePageId}+ imageUrl={thumbnailImages[activePageId]}+ thumbnailSize={thumbnailSize}+ />+ ) : null}+ </DragOverlay>+ </DndContext></aside>)}-export function DocumentSplits({- file = PDF_URL,- className,-}: {- file?: string- className?: string-} = {}) {- const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null)- const [numPages, setNumPages] = React.useState(0)+function usePdfThumbnailImages(documentKey: string) {+ const [thumbnailImages, setThumbnailImages] = React.useState<+ Record<PageId, string>+ >({})+ const thumbnailObjectUrlsRef = React.useRef(new Set<string>())- React.useEffect(() => {- let isMounted = true+ const clearCachedThumbnails = React.useCallback(() => {+ thumbnailObjectUrlsRef.current.forEach((imageUrl) => {+ URL.revokeObjectURL(imageUrl)+ })+ thumbnailObjectUrlsRef.current.clear()+ setThumbnailImages({})+ }, [])- import("react-pdf").then((module) => {- module.pdfjs.GlobalWorkerOptions.workerSrc = PDF_WORKER_URL+ React.useEffect(() => {+ clearCachedThumbnails()+ }, [clearCachedThumbnails, documentKey])- if (isMounted) {- setReactPdf(module)- }- })+ React.useEffect(() => {+ const objectUrls = thumbnailObjectUrlsRef.currentreturn () => {- isMounted = false+ objectUrls.forEach((imageUrl) => {+ URL.revokeObjectURL(imageUrl)+ })+ objectUrls.clear()}}, [])- const renderPanel = (pdfModule: ReactPdfModule | null) => (- <div className={cn("h-[620px] overflow-hidden bg-background", className)}>- <SplitterGroupsPane- activePage={1}- documentKey={file}- pageCount={numPages}- reactPdf={pdfModule}- onSelectPage={() => {}}+ const handleThumbnailReady = React.useCallback(+ (pageId: PageId, imageUrl: string) => {+ setThumbnailImages((currentImages) => {+ if (currentImages[pageId]) {+ URL.revokeObjectURL(imageUrl)+ return currentImages+ }++ thumbnailObjectUrlsRef.current.add(imageUrl)+ return { ...currentImages, [pageId]: imageUrl }+ })+ },+ []+ )++ return { thumbnailImages, onThumbnailReady: handleThumbnailReady }+}++function PdfThumbnailCacheItem({+ pageId,+ reactPdf,+ onThumbnailReady,+}: {+ pageId: PageId+ reactPdf: ReactPdfModule+ onThumbnailReady: (pageId: PageId, imageUrl: string) => void+}) {+ const rootRef = React.useRef<HTMLDivElement>(null)+ const pageNumber = getPageNumber(pageId)++ return (+ <div ref={rootRef} className="size-[1px] overflow-hidden">+ <reactPdf.Thumbnail+ pageNumber={pageNumber}+ width={THUMBNAIL_WIDTH}+ className="block [&_.react-pdf__Thumbnail__page]:!m-0"+ onRenderSuccess={() => {+ window.requestAnimationFrame(() => {+ const canvas = rootRef.current?.querySelector("canvas")++ if (!canvas) return++ try {+ canvas.toBlob((blob) => {+ if (!blob) return++ onThumbnailReady(pageId, URL.createObjectURL(blob))+ }, "image/png")+ } catch {+ // Canvas export can fail if the browser marks it tainted.+ }+ })+ }}+ loading={null}/></div>)+}- if (!reactPdf) {- return renderPanel(null)- }+function PdfThumbnailCache({+ splits,+ thumbnailImages,+ reactPdf,+ onThumbnailReady,+}: {+ splits: SplitGroup[]+ thumbnailImages: Record<PageId, string>+ reactPdf: ReactPdfModule+ onThumbnailReady: (pageId: PageId, imageUrl: string) => void+}) {+ const uncachedPageIds = React.useMemo(+ () =>+ Array.from(new Set(splits.flatMap((split) => split.pages))).filter(+ (pageId) => !thumbnailImages[pageId]+ ),+ [splits, thumbnailImages]+ )++ if (uncachedPageIds.length === 0) return nullreturn (- <reactPdf.Document- file={file}- onLoadSuccess={({ numPages: pageCount }) => {- setNumPages(pageCount)+ <div+ aria-hidden="true"+ className="pointer-events-none fixed top-0 left-[-10000px] z-[-1] opacity-0"+ >+ {uncachedPageIds.map((pageId) => (+ <PdfThumbnailCacheItem+ key={pageId}+ pageId={pageId}+ reactPdf={reactPdf}+ onThumbnailReady={onThumbnailReady}+ />+ ))}+ </div>+ )+}++function WorkbookViewerPane({+ workbookIdentity,+}: {+ workbookIdentity: string+}) {+ const { resolvedTheme } = useTheme()+ const { nightRenderEnabled, setNightRenderEnabled } =+ useWorkbookNightRenderPreference()+ const shouldRenderNightMode = resolvedTheme === "dark"+ const effectiveIsDark = shouldRenderNightMode && nightRenderEnabled++ return (+ <XlsxWorkbookSurface+ className="h-full"+ isDark={effectiveIsDark}+ onIsDarkChange={setNightRenderEnabled}+ onUploadClick={() => {}}+ renderTableHeaderMenu={(props) => <WorkbookTableHeaderMenu {...props} />}+ rounded={false}+ showNightRenderToggle={shouldRenderNightMode}+ showUploadButton={false}+ workbookIdentity={workbookIdentity}+ />+ )+}++function WorkbookSplitsPane({+ className,+ workbookIdentity,+}: {+ className?: string+ workbookIdentity: string+}) {+ const { activeSheetIndex, setActiveSheetIndex, sheets } = useXlsxViewer()+ const sheetNames = React.useMemo(+ () => sheets.map((sheet) => sheet.name),+ [sheets]+ )+ const [splits, setSplits] = React.useState<DocumentSplit[]>(() =>+ createInitialWorkbookSplits(DEFAULT_PREVIEW_SHEET_COUNT)+ )+ const thumbnailUrls = useWorkbookSheetThumbnailUrls(workbookIdentity)+ const thumbnailImages = React.useMemo(+ () =>+ Object.fromEntries(+ Object.entries(thumbnailUrls).map(([sheetIndex, imageUrl]) => [+ toWorkbookSheetId(Number(sheetIndex)),+ imageUrl,+ ])+ ),+ [thumbnailUrls]+ )++ React.useEffect(() => {+ if (sheets.length === 0) return++ setSplits(createInitialWorkbookSplits(sheets.length))+ }, [sheets.length, workbookIdentity])++ return (+ <DocumentSplits+ activeItemId={toWorkbookSheetId(activeSheetIndex)}+ addSplitLabel="Add split"+ className={className}+ dndId="workbook-document-splits-dnd"+ emptyLabel="Drop sheets here"+ getItemFile={() => ({+ name: XLSX_THUMBNAIL_FILE.name,+ type: XLSX_THUMBNAIL_FILE.type,+ })}+ getItemLabel={(itemId) => {+ const sheetIndex = getWorkbookSheetIndex(itemId as WorkbookSheetId)++ return sheetNames[sheetIndex] ?? `Sheet ${sheetIndex + 1}`}}- loading={renderPanel(null)}- error={- <div className="grid h-[620px] place-items-center bg-background text-sm text-muted-foreground">- Unable to load PDF.- </div>+ getSplitLabel={(split) => createWorkbookSplitLabel(split, sheetNames)}+ labelPlacement="bottom"+ splits={splits}+ thumbnailImages={thumbnailImages}+ thumbnailSize={{+ width: SHEET_THUMBNAIL_WIDTH,+ height: SHEET_THUMBNAIL_HEIGHT,+ }}+ withFrameDivider={false}+ onSelectItem={(itemId) =>+ setActiveSheetIndex(getWorkbookSheetIndex(itemId as WorkbookSheetId))}- >- {renderPanel(reactPdf)}- </reactPdf.Document>+ onSplitsChange={setSplits}+ />+ )+}++export function XlsxDocumentSplitsBlock() {+ const controller = useXlsxViewerController(+ React.useMemo(+ () => ({+ allowResizeInReadOnly: true,+ fileName: "crazy-chart-zoo.xlsx",+ readOnly: true,+ src: XLSX_URL,+ useWorker: true,+ }),+ []+ )+ )++ return (+ <XlsxViewerProvider controller={controller}>+ <PdfBlockResizableShell+ autoSaveId="xlsx-block-document-splits"+ heightClassName="h-[720px]"+ rightDefaultSize={48}+ rightMaxSize={64}+ rightMinSize={30}+ left={<WorkbookViewerPane workbookIdentity={XLSX_URL} />}+ right={<WorkbookSplitsPane workbookIdentity={XLSX_URL} />}+ />+ </XlsxViewerProvider>)}@@ -1073,6 +1271,10 @@ export function DocumentSplitsBlock() {const [pdfUrl, setPdfUrl] = React.useState(PDF_URL)const [numPages, setNumPages] = React.useState(0)const [activePage, setActivePage] = React.useState(1)+ const [splits, setSplits] = React.useState<SplitGroup[]>(() =>+ createInitialGroups(DEFAULT_PREVIEW_PAGE_COUNT)+ )+ const { thumbnailImages, onThumbnailReady } = usePdfThumbnailImages(pdfUrl)const viewerRef = React.useRef<PDFViewerHandle>(null)const uploadedPdfUrlRef = React.useRef<string | null>(null)@@ -1100,6 +1302,10 @@ export function DocumentSplitsBlock() {}}, [])+ React.useEffect(() => {+ setSplits(createInitialGroups(numPages || DEFAULT_PREVIEW_PAGE_COUNT))+ }, [numPages, pdfUrl])+const handleLoadSuccess = React.useCallback(({ numPages: pageCount }: { numPages: number }) => {setNumPages(pageCount)@@ -1143,7 +1349,7 @@ export function DocumentSplitsBlock() {})}, [])- const renderShell = (pdfModule: ReactPdfModule | null) => (+ const renderShell = () => (<PdfBlockResizableShellautoSaveId="pdf-block-document-splits"heightClassName="h-[720px]"@@ -1161,12 +1367,12 @@ export function DocumentSplitsBlock() {/>}right={- <SplitterGroupsPane+ <DocumentSplitsactivePage={activePage}- documentKey={pdfUrl}- pageCount={numPages}- reactPdf={pdfModule}+ splits={splits}+ thumbnailImages={thumbnailImages}withFrameDivider={false}+ onSplitsChange={setSplits}onSelectPage={scrollToPage}/>}@@ -1174,21 +1380,27 @@ export function DocumentSplitsBlock() {)if (!reactPdf) {- return renderShell(null)+ return renderShell()}return (<reactPdf.Documentfile={pdfUrl}onLoadSuccess={handleLoadSuccess}- loading={renderShell(null)}+ loading={renderShell()}error={<div className="grid h-[720px] place-items-center bg-background text-sm text-muted-foreground">Unable to load PDF.</div>}>- {renderShell(reactPdf)}+ <PdfThumbnailCache+ splits={splits}+ thumbnailImages={thumbnailImages}+ reactPdf={reactPdf}+ onThumbnailReady={onThumbnailReady}+ />+ {renderShell()}</reactPdf.Document>)}@@ -1274,6 +1486,70 @@ function DocumentSplitsExample() {)}+function DocumentSplitsPreview({ file }: { file: string }) {+ const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null)+ const [pageCount, setPageCount] = React.useState(0)+ const [splits, setSplits] = React.useState<SplitGroup[]>(() =>+ createInitialGroups(DEFAULT_PREVIEW_PAGE_COUNT)+ )+ const { thumbnailImages, onThumbnailReady } = usePdfThumbnailImages(file)++ React.useEffect(() => {+ let isMounted = true++ import("react-pdf").then((module) => {+ module.pdfjs.GlobalWorkerOptions.workerSrc = PDF_WORKER_URL++ if (isMounted) {+ setReactPdf(module)+ }+ })++ return () => {+ isMounted = false+ }+ }, [])++ React.useEffect(() => {+ setSplits(createInitialGroups(pageCount || DEFAULT_PREVIEW_PAGE_COUNT))+ }, [file, pageCount])++ const panel = (+ <DocumentSplits+ activePage={1}+ className="h-[620px]"+ splits={splits}+ thumbnailImages={thumbnailImages}+ withFrameDivider={false}+ onSplitsChange={setSplits}+ onSelectPage={() => {}}+ />+ )++ if (!reactPdf) return panel++ return (+ <reactPdf.Document+ file={file}+ onLoadSuccess={({ numPages }) => setPageCount(numPages)}+ loading={panel}+ error={+ <div className="grid h-[620px] place-items-center bg-background text-sm text-muted-foreground">+ Unable to load PDF.+ </div>+ }+ >+ <PdfThumbnailCache+ splits={splits}+ thumbnailImages={thumbnailImages}+ reactPdf={reactPdf}+ onThumbnailReady={onThumbnailReady}+ />+ {panel}+ </reactPdf.Document>+ )+}+export function DocumentSplitsDemo() {const [isCodeVisible, setIsCodeVisible] = React.useState(false)@@ -1282,7 +1558,7 @@ export function DocumentSplitsDemo() {data-slot="component-preview"className="group relative mt-4 mb-12 flex flex-col overflow-hidden rounded-xl border">- <DocumentSplits file="/samples/attention.pdf" />+ <DocumentSplitsPreview file="/samples/attention.pdf" /><divdata-slot="code"data-mobile-code-visible={isCodeVisible}@@ -1327,61 +1603,225 @@ export function DocumentSplitsDemo() {)}-const documentSplitterUsageCode = `"use client";+const documentSplitterUsageCode = String.raw`"use client";++import * as React from "react";++import {+ DocumentSplits,+ type DocumentSplit,+ type DocumentSplitPageId,+} from "@/components/ui/document-splits";++type ReactPdfModule = typeof import("react-pdf");++const PDF_FILE = "/samples/attention.pdf";+const PDF_WORKER_URL = new URL(+ "pdfjs-dist/legacy/build/pdf.worker.min.mjs",+ import.meta.url,+).toString();+const THUMBNAIL_WIDTH = 72;+const DEFAULT_PAGE_COUNT = 15;++function toPageId(pageNumber: number): DocumentSplitPageId {+ return ("page-" + pageNumber) as DocumentSplitPageId;+}++function getPageNumber(pageId: DocumentSplitPageId) {+ return Number(pageId.replace("page-", ""));+}++function createInitialSplits(pageCount: number): DocumentSplit[] {+ const pages = Array.from({ length: pageCount }, (_, index) => toPageId(index + 1));++ return [+ { id: "split-1", title: "Abstract and intro", pages: pages.slice(0, Math.min(3, pageCount)) },+ { id: "split-2", title: "Model architecture", pages: pages.slice(3, Math.min(8, pageCount)) },+ { id: "split-3", title: "Training and results", pages: pages.slice(8) },+ ].filter((split) => split.pages.length > 0);+}++function usePdfThumbnailImages(documentKey: string) {+ const [thumbnailImages, setThumbnailImages] = React.useState<Record<DocumentSplitPageId, string>>({});+ const objectUrlsRef = React.useRef(new Set<string>());++ React.useEffect(() => {+ objectUrlsRef.current.forEach((imageUrl) => URL.revokeObjectURL(imageUrl));+ objectUrlsRef.current.clear();+ setThumbnailImages({});+ }, [documentKey]);++ React.useEffect(() => {+ const objectUrls = objectUrlsRef.current;++ return () => {+ objectUrls.forEach((imageUrl) => URL.revokeObjectURL(imageUrl));+ objectUrls.clear();+ };+ }, []);++ const onThumbnailReady = React.useCallback((pageId: DocumentSplitPageId, imageUrl: string) => {+ setThumbnailImages((currentImages) => {+ if (currentImages[pageId]) {+ URL.revokeObjectURL(imageUrl);+ return currentImages;+ }++ objectUrlsRef.current.add(imageUrl);+ return { ...currentImages, [pageId]: imageUrl };+ });+ }, []);++ return { thumbnailImages, onThumbnailReady };+}++function PdfThumbnailCacheItem({+ pageId,+ reactPdf,+ onThumbnailReady,+}: {+ pageId: DocumentSplitPageId;+ reactPdf: ReactPdfModule;+ onThumbnailReady: (pageId: DocumentSplitPageId, imageUrl: string) => void;+}) {+ const rootRef = React.useRef<HTMLDivElement>(null);++ return (+ <div ref={rootRef} className="size-[1px] overflow-hidden">+ <reactPdf.Thumbnail+ pageNumber={getPageNumber(pageId)}+ width={THUMBNAIL_WIDTH}+ loading={null}+ onRenderSuccess={() => {+ window.requestAnimationFrame(() => {+ const canvas = rootRef.current?.querySelector("canvas");++ if (!canvas) return;++ canvas.toBlob((blob) => {+ if (!blob) return;+ onThumbnailReady(pageId, URL.createObjectURL(blob));+ }, "image/png");+ });+ }}+ />+ </div>+ );+}++function PdfThumbnailCache({+ splits,+ thumbnailImages,+ reactPdf,+ onThumbnailReady,+}: {+ splits: DocumentSplit[];+ thumbnailImages: Record<DocumentSplitPageId, string>;+ reactPdf: ReactPdfModule;+ onThumbnailReady: (pageId: DocumentSplitPageId, imageUrl: string) => void;+}) {+ const uncachedPageIds = React.useMemo(+ () =>+ Array.from(new Set(splits.flatMap((split) => split.pages))).filter(+ (pageId) => !thumbnailImages[pageId],+ ),+ [splits, thumbnailImages],+ );++ if (uncachedPageIds.length === 0) return null;-import { DocumentSplits } from "@/components/ui/document-splits";+ return (+ <div aria-hidden="true" className="pointer-events-none fixed top-0 left-[-10000px] z-[-1] opacity-0">+ {uncachedPageIds.map((pageId) => (+ <PdfThumbnailCacheItem+ key={pageId}+ pageId={pageId}+ reactPdf={reactPdf}+ onThumbnailReady={onThumbnailReady}+ />+ ))}+ </div>+ );+}export function DocumentSplitsExample() {- return <DocumentSplits file="/samples/attention.pdf" className="h-[620px]" />;+ const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null);+ const [pageCount, setPageCount] = React.useState(0);+ const [splits, setSplits] = React.useState<DocumentSplit[]>(() => createInitialSplits(DEFAULT_PAGE_COUNT));+ const { thumbnailImages, onThumbnailReady } = usePdfThumbnailImages(PDF_FILE);++ React.useEffect(() => {+ let isMounted = true;++ import("react-pdf").then((module) => {+ module.pdfjs.GlobalWorkerOptions.workerSrc = PDF_WORKER_URL;++ if (isMounted) setReactPdf(module);+ });++ return () => {+ isMounted = false;+ };+ }, []);++ React.useEffect(() => {+ setSplits(createInitialSplits(pageCount || DEFAULT_PAGE_COUNT));+ }, [pageCount]);++ const panel = (+ <DocumentSplits+ activePage={1}+ className="h-[620px]"+ splits={splits}+ thumbnailImages={thumbnailImages}+ withFrameDivider={false}+ onSplitsChange={setSplits}+ onSelectPage={() => {}}+ />+ );++ if (!reactPdf) return panel;++ return (+ <reactPdf.Document file={PDF_FILE} onLoadSuccess={({ numPages }) => setPageCount(numPages)} loading={panel}>+ <PdfThumbnailCache+ splits={splits}+ thumbnailImages={thumbnailImages}+ reactPdf={reactPdf}+ onThumbnailReady={onThumbnailReady}+ />+ {panel}+ </reactPdf.Document>+ );}`-const documentSplitterSourceCode = `"use client";+const documentSplitterSourceCode = String.raw`"use client";import * as React from "react";-import {- closestCenter,- DndContext,- DragOverlay,- PointerSensor,- useDroppable,- useSensor,- useSensors,- type DragEndEvent,- type DragOverEvent,- type DragStartEvent,-} from "@dnd-kit/core";-import {- SortableContext,- arrayMove,- horizontalListSortingStrategy,- useSortable,- verticalListSortingStrategy,-} from "@dnd-kit/sortable";+import { closestCenter, DndContext, DragOverlay, PointerSensor, useDroppable, useSensor, useSensors, type DragEndEvent, type DragOverEvent, type DragStartEvent } from "@dnd-kit/core";+import { SortableContext, arrayMove, horizontalListSortingStrategy, useSortable, verticalListSortingStrategy } from "@dnd-kit/sortable";import { CSS } from "@dnd-kit/utilities";-import { Add01Icon, DragDropVerticalIcon } from "@hugeicons/core-free-icons";+import { Add01Icon, Delete02Icon, DragDropVerticalIcon } from "@hugeicons/core-free-icons";import { HugeiconsIcon } from "@hugeicons/react";-import type * as ReactPdf from "react-pdf";import { Button } from "@/components/ui/button";+import { FileThumbnail } from "@/components/ui/file-thumbnail";import { ScrollArea } from "@/components/ui/scroll-area";import { cn } from "@/lib/utils";-type ReactPdfModule = typeof ReactPdf;-type PageId = string;-type SplitGroup = {+export type DocumentSplitPageId = \`page-\${number}\`;+export type DocumentSplit = {id: string;title: string;- pages: PageId[];+ pages: DocumentSplitPageId[];};-const DEFAULT_PAGE_COUNT = 15;+type PageId = DocumentSplitPageId;+type SplitGroup = DocumentSplit;+const THUMBNAIL_WIDTH = 72;const THUMBNAIL_HEIGHT = 92;-function toPageId(pageNumber: number) {- return "page-" + pageNumber;-}-function getPageNumber(pageId: PageId) {return Number(pageId.replace("page-", ""));}@@ -1390,19 +1830,9 @@ function getSplitSortableId(groupId: string) {return "split-sortable-" + groupId;}-function createInitialGroups(pageCount: number): SplitGroup[] {- const pages = Array.from({ length: pageCount }, (_, index) => toPageId(index + 1));-- return [- { id: "split-1", title: "Abstract and intro", pages: pages.slice(0, Math.min(3, pageCount)) },- { id: "split-2", title: "Model architecture", pages: pages.slice(3, Math.min(8, pageCount)) },- { id: "split-3", title: "Training and results", pages: pages.slice(8) },- ].filter((group) => group.pages.length > 0);-}-function findGroupId(groups: SplitGroup[], id: string) {if (groups.some((group) => group.id === id)) return id;- return groups.find((group) => group.pages.includes(id))?.id ?? null;+ return groups.find((group) => group.pages.includes(id as PageId))?.id ?? null;}function getGroupPages(groups: SplitGroup[], groupId: string | null) {@@ -1454,7 +1884,12 @@ function reorderPageInGroup({);}-function SplitDropzone({+function createPageRangeLabel(pageIds: PageId[]) {+ if (pageIds.length === 0) return "No pages";+ return "Pages " + pageIds.map(getPageNumber).join(", ");+}++function SplitGroupDropzone({children,group,}: {@@ -1469,7 +1904,7 @@ function SplitDropzone({return (<divref={setNodeRef}- className={cn("min-h-[116px] rounded-lg p-2", isOver && "bg-accent/30 ring-1 ring-border")}+ className={cn("min-h-[116px] rounded-lg p-2 transition-[background-color,box-shadow]", isOver && "bg-accent/30 shadow-[inset_0_0_0_1px_var(--border)]")}>{children}</div>@@ -1477,11 +1912,15 @@ function SplitDropzone({}function PageThumbnail({+ imageUrl,+ isActive,+ onSelect,pageId,- reactPdf,}: {+ imageUrl?: string;+ isActive: boolean;+ onSelect: (pageNumber: number) => void;pageId: PageId;- reactPdf: ReactPdfModule;}) {const pageNumber = getPageNumber(pageId);const { attributes, isDragging, listeners, setNodeRef, transform, transition } = useSortable({@@ -1494,7 +1933,8 @@ function PageThumbnail({ref={setNodeRef}type="button"className={cn(- "relative shrink-0 cursor-grab overflow-hidden rounded-md border bg-muted shadow-xs active:cursor-grabbing",+ "relative shrink-0 cursor-grab overflow-hidden rounded-md border bg-muted text-left shadow-xs active:cursor-grabbing",+ isActive ? "border-blue-500 shadow-[0_0_0_2px_rgb(59_130_246_/_14%)]" : "border-border hover:border-foreground/30",isDragging && "opacity-0",)}style={{@@ -1503,15 +1943,17 @@ function PageThumbnail({transform: CSS.Transform.toString(transform),transition,}}+ onClick={() => onSelect(pageNumber)}{...attributes}{...listeners}>- <reactPdf.Thumbnail- pageNumber={pageNumber}- width={THUMBNAIL_WIDTH}- renderTextLayer={false}- className="absolute inset-0 block size-full [&_.react-pdf__Thumbnail__page]:!m-0 [&_.react-pdf__Thumbnail__page]:!size-full [&_.react-pdf__Thumbnail__page]:overflow-hidden [&_canvas]:!size-full [&_canvas]:object-cover"- loading={<div className="absolute inset-0 animate-pulse bg-muted" />}+ <FileThumbnail+ file={{ name: "page-" + pageNumber + ".pdf", type: "application/pdf", size: "Page " + pageNumber }}+ showMetadata={false}+ previewImageUrl={imageUrl}+ isLoading={!imageUrl}+ previewClassName="h-full aspect-auto"+ className="size-full rounded-[inherit] border-0"/><span className="absolute right-1 bottom-1 rounded bg-background/90 px-1.5 py-0.5 text-[10px] font-medium shadow-xs">{pageNumber}@@ -1521,13 +1963,19 @@ function PageThumbnail({}function SplitGroupCard({+ activePage,group,dragHandleProps,- reactPdf,+ thumbnailImages,+ onRemove,+ onSelectPage,}: {+ activePage: number;group: SplitGroup;dragHandleProps?: React.ComponentPropsWithoutRef<"button">;- reactPdf: ReactPdfModule;+ thumbnailImages: Record<PageId, string>;+ onRemove: () => void;+ onSelectPage: (pageNumber: number) => void;}) {return (<section className="rounded-lg border bg-background">@@ -1541,13 +1989,21 @@ function SplitGroupCard({><HugeiconsIcon icon={DragDropVerticalIcon} className="size-4" /></button>- <div className="truncate text-sm font-medium">{group.title}</div>+ <div className="min-w-0">+ <div className="truncate text-sm font-medium">{group.title}</div>+ <div className="mt-1 text-xs text-muted-foreground">{createPageRangeLabel(group.pages)}</div>+ </div></div>- <div className="shrink-0 rounded-full bg-muted px-2 py-0.5 text-xs text-muted-foreground">- {group.pages.length} pages+ <div className="flex shrink-0 items-center gap-2">+ <div className="rounded-full bg-muted px-2 py-0.5 text-xs text-muted-foreground">+ {group.pages.length}+ </div>+ <Button type="button" variant="ghost" size="icon-sm" aria-label={"Remove " + group.title} onClick={onRemove}>+ <HugeiconsIcon icon={Delete02Icon} className="size-4" />+ </Button></div></div>- <SplitDropzone group={group}>+ <SplitGroupDropzone group={group}><SortableContext items={group.pages} strategy={horizontalListSortingStrategy}><ScrollAreaclassName="h-[110px] w-full overflow-hidden"@@ -1558,22 +2014,34 @@ function SplitGroupCard({><div className="flex w-max gap-2 overflow-y-hidden py-1 pr-6">{group.pages.map((pageId) => (- <PageThumbnail key={pageId} pageId={pageId} reactPdf={reactPdf} />+ <PageThumbnail+ key={pageId}+ pageId={pageId}+ imageUrl={thumbnailImages[pageId]}+ isActive={activePage === getPageNumber(pageId)}+ onSelect={onSelectPage}+ />))}</div></ScrollArea></SortableContext>- </SplitDropzone>+ </SplitGroupDropzone></section>);}function SortableSplitGroupCard({+ activePage,group,- reactPdf,+ thumbnailImages,+ onRemove,+ onSelectPage,}: {+ activePage: number;group: SplitGroup;- reactPdf: ReactPdfModule;+ thumbnailImages: Record<PageId, string>;+ onRemove: () => void;+ onSelectPage: (pageNumber: number) => void;}) {const { attributes, isDragging, listeners, setNodeRef, transform, transition } = useSortable({id: getSplitSortableId(group.id),@@ -1590,62 +2058,56 @@ function SortableSplitGroupCard({}}><SplitGroupCard+ activePage={activePage}group={group}- reactPdf={reactPdf}+ thumbnailImages={thumbnailImages}dragHandleProps={{ ...attributes, ...listeners }}+ onRemove={onRemove}+ onSelectPage={onSelectPage}/></div>);}export function DocumentSplits({- file,- workerUrl = new URL("pdfjs-dist/legacy/build/pdf.worker.min.mjs", import.meta.url).toString(),+ activePage,className,+ splits,+ thumbnailImages = {},+ withFrameDivider = true,+ onSelectPage,+ onSplitsChange,}: {- file: string | File;- workerUrl?: string;+ activePage: number;className?: string;+ splits: SplitGroup[];+ thumbnailImages?: Record<PageId, string>;+ withFrameDivider?: boolean;+ onSelectPage: (pageNumber: number) => void;+ onSplitsChange: (splits: SplitGroup[]) => void;}) {- const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null);- const [pageCount, setPageCount] = React.useState(0);- const [groups, setGroups] = React.useState(() => createInitialGroups(DEFAULT_PAGE_COUNT));const [activePageId, setActivePageId] = React.useState<PageId | null>(null);const dragStartGroupIdRef = React.useRef<string | null>(null);+ const dragStartSplitsRef = React.useRef<SplitGroup[] | null>(null);const sensors = useSensors(useSensor(PointerSensor, { activationConstraint: { distance: 6 } }));- React.useEffect(() => {- let mounted = true;-- void import("react-pdf").then((module) => {- module.pdfjs.GlobalWorkerOptions.workerSrc = workerUrl;- if (mounted) setReactPdf(module);- });-- return () => {- mounted = false;- };- }, [workerUrl]);-- React.useEffect(() => {- setGroups(createInitialGroups(pageCount || DEFAULT_PAGE_COUNT));- }, [pageCount, file]);-const handleDragStart = React.useCallback((event: DragStartEvent) => {if (event.active.data.current?.type === "page") {const pageId = String(event.active.id);- dragStartGroupIdRef.current = findGroupId(groups, pageId);- setActivePageId(pageId);+ dragStartGroupIdRef.current = findGroupId(splits, pageId);+ dragStartSplitsRef.current = splits;+ setActivePageId(pageId as PageId);}- }, [groups]);+ }, [splits]);const handleDragOver = React.useCallback((event: DragOverEvent) => {if (event.active.data.current?.type !== "page" || !event.over) return;- const pageId = String(event.active.id);+ const pageId = String(event.active.id) as PageId;const overId = String(event.over.id);- setGroups((current) => {+ onSplitsChange((() => {+ const current = splits;const sourceGroupId = findGroupId(current, pageId);const targetGroupId = findGroupId(current, overId);@@ -1663,19 +2125,17 @@ export function DocumentSplits({insertIndex,targetGroupId,});- });- }, []);+ })());+ }, [onSplitsChange, splits]);const handleDragEnd = React.useCallback((event: DragEndEvent) => {if (event.active.data.current?.type === "split" && event.over) {const activeGroupId = event.active.data.current.groupId;const overGroupId = event.over.data.current?.groupId;- setGroups((current) => {- const activeIndex = current.findIndex((group) => group.id === activeGroupId);- const overIndex = current.findIndex((group) => group.id === overGroupId);- return activeIndex === -1 || overIndex === -1 ? current : arrayMove(current, activeIndex, overIndex);- });+ const activeIndex = splits.findIndex((group) => group.id === activeGroupId);+ const overIndex = splits.findIndex((group) => group.id === overGroupId);+ if (activeIndex !== -1 && overIndex !== -1) onSplitsChange(arrayMove(splits, activeIndex, overIndex));return;}@@ -1686,43 +2146,67 @@ export function DocumentSplits({return;}- const pageId = String(event.active.id);- const overId = String(event.over.id);+ const pageId = String(event.active.id) as PageId;+ const overId = String(event.over.id) as PageId;- setGroups((current) => {- const overGroupId = findGroupId(current, overId);- if (dragStartGroupIdRef.current !== overGroupId) return current;+ const overGroupId = findGroupId(splits, overId);- return reorderPageInGroup({+ if (dragStartGroupIdRef.current === overGroupId) {+ onSplitsChange(reorderPageInGroup({activePageId: pageId,- groups: current,+ groups: splits,overPageId: overId,- });- });+ }));+ }dragStartGroupIdRef.current = null;setActivePageId(null);- }, []);+ }, [onSplitsChange, splits]);- const shell = (pdfModule: ReactPdfModule | null) => (- <div className={cn("h-[620px] overflow-hidden bg-background", className)}>- {pdfModule ? (+ return (+ <aside className={cn("flex h-full min-h-0 flex-col bg-muted/20", withFrameDivider && "border-t md:border-t-0 md:border-l", className)}>+ <div className="flex min-h-12 items-center justify-end gap-3 border-b bg-background px-3">+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() =>+ onSplitsChange([+ ...splits,+ { id: "split-" + Date.now(), title: "Split " + (splits.length + 1), pages: [] },+ ])+ }+ >+ <HugeiconsIcon icon={Add01Icon} className="size-4" />+ Add split+ </Button>+ </div><DndContext+ id="document-splits-dnd"sensors={sensors}collisionDetection={closestCenter}onDragStart={handleDragStart}onDragOver={handleDragOver}onDragEnd={handleDragEnd}onDragCancel={() => {+ if (dragStartSplitsRef.current) onSplitsChange(dragStartSplitsRef.current);+ dragStartSplitsRef.current = null;dragStartGroupIdRef.current = null;setActivePageId(null);}}>- <ScrollArea className="h-full" scrollFade>- <SortableContext items={groups.map((group) => getSplitSortableId(group.id))} strategy={verticalListSortingStrategy}>+ <ScrollArea className="min-h-0 flex-1" scrollFade>+ <SortableContext items={splits.map((group) => getSplitSortableId(group.id))} strategy={verticalListSortingStrategy}><div className="space-y-3 p-3">- {groups.map((group) => (- <SortableSplitGroupCard key={group.id} group={group} reactPdf={pdfModule} />+ {splits.map((group) => (+ <SortableSplitGroupCard+ key={group.id}+ activePage={activePageId ? getPageNumber(activePageId) : activePage}+ group={group}+ thumbnailImages={thumbnailImages}+ onRemove={() => onSplitsChange(splits.filter((split) => split.id !== group.id))}+ onSelectPage={onSelectPage}+ />))}</div></SortableContext>@@ -1733,29 +2217,19 @@ export function DocumentSplits({className="relative overflow-hidden rounded-md border bg-background shadow-lg"style={{ width: THUMBNAIL_WIDTH, height: THUMBNAIL_HEIGHT }}>- <pdfModule.Thumbnail pageNumber={getPageNumber(activePageId)} width={THUMBNAIL_WIDTH} />+ <FileThumbnail+ file={{ name: activePageId + ".pdf", type: "application/pdf" }}+ showMetadata={false}+ previewImageUrl={thumbnailImages[activePageId]}+ isLoading={!thumbnailImages[activePageId]}+ previewClassName="h-full aspect-auto"+ className="size-full rounded-[inherit] border-0"+ /></div>) : null}</DragOverlay></DndContext>- ) : (- <div className="grid h-full place-items-center text-sm text-muted-foreground">Loading pages...</div>- )}- </div>- );-- if (!reactPdf) {- return shell(null);- }-- return (- <reactPdf.Document- file={file}- onLoadSuccess={({ numPages }) => setPageCount(numPages)}- loading={shell(null)}- >- {shell(reactPdf)}- </reactPdf.Document>+ </aside>);}`diff --git a/apps/v4/components/docx-viewer-docs.tsx b/apps/v4/components/docx-viewer-docs.tsxnew file mode 100644index 0000000..ac9176a--- /dev/null+++ b/apps/v4/components/docx-viewer-docs.tsx@@ -0,0 +1,691 @@+"use client"++import * as React from "react"+import dynamic from "next/dynamic"++import { Button } from "@/components/ui/button"+import { HighlightedCodeBlock } from "@/components/highlighted-code-block"++function ViewerPreviewLoading() {+ return (+ <div className="grid h-[640px] place-items-center bg-background">+ <div className="size-4 animate-spin rounded-full border-2 border-muted-foreground/30 border-t-foreground" />+ </div>+ )+}++const DocxViewerPreview = dynamic(+ () => import("@/components/ui/docx-viewer").then((mod) => mod.DocxViewerPreview),+ {+ ssr: false,+ loading: () => <ViewerPreviewLoading />,+ }+)++export function DocxViewerDemo() {+ const [isCodeVisible, setIsCodeVisible] = React.useState(false)++ return (+ <div+ data-slot="component-preview"+ className="group relative mt-4 mb-12 flex flex-col overflow-hidden rounded-xl border"+ >+ <DocxViewerPreview />+ <div+ data-slot="code"+ data-mobile-code-visible={isCodeVisible}+ className="relative overflow-hidden **:data-[slot=copy-button]:right-4 **:data-[slot=copy-button]:hidden data-[mobile-code-visible=true]:**:data-[slot=copy-button]:flex [&_[data-rehype-pretty-code-figure]]:m-0! [&_[data-rehype-pretty-code-figure]]:rounded-t-none [&_[data-rehype-pretty-code-figure]]:border-t [&_pre]:max-h-72"+ >+ {isCodeVisible ? (+ <HighlightedCodeBlock+ code={docxViewerUsageCode}+ className="rounded-none border-x-0 border-b-0"+ />+ ) : (+ <div className="relative">+ <HighlightedCodeBlock+ code={docxViewerUsageCode}+ className="rounded-none border-x-0 border-b-0"+ maxHeightClassName="max-h-56"+ previewLines={10}+ showCopy={false}+ />+ <div className="absolute inset-0 flex items-center justify-center pb-4">+ <div+ className="absolute inset-0"+ style={{+ background:+ "linear-gradient(to top, var(--color-code), color-mix(in oklab, var(--color-code) 60%, transparent), transparent)",+ }}+ />+ <Button+ type="button"+ size="sm"+ variant="outline"+ className="relative z-10 rounded-lg bg-background text-foreground shadow-none hover:bg-muted dark:bg-background dark:text-foreground dark:hover:bg-muted"+ onClick={() => setIsCodeVisible(true)}+ >+ View Code+ </Button>+ </div>+ </div>+ )}+ </div>+ </div>+ )+}++const docxViewerUsageCode = `"use client";++import { DocxViewerPreview } from "@/components/ui/docx-viewer";++export function DocxViewerExample() {+ return <DocxViewerPreview />;+}`++const docxViewerSourceCode = `"use client"++import * as React from "react"+import {+ DocxEditorViewer,+ useDocxEditor,+ type DocxDocumentTheme,+} from "@extend-ai/react-docx"+import {+ Loading03Icon,+ Moon02Icon,+ MinusSignCircleIcon,+ PlusSignCircleIcon,+ Sun03Icon,+ Upload01Icon,+} from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"+import { useTheme } from "next-themes"++import { cn } from "@/lib/utils"+import { Button } from "@/components/ui/button"+import {+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+} from "@/registry/new-york-v4/ui/select"+import { Separator } from "@/registry/new-york-v4/ui/separator"+import {+ Tooltip,+ TooltipContent,+ TooltipProvider,+ TooltipTrigger,+} from "@/registry/new-york-v4/ui/tooltip"++const SAMPLE_DOCX_URL = "/samples/demo.docx"+const DOCX_MIME_TYPE =+ "application/vnd.openxmlformats-officedocument.wordprocessingml.document"+const DOCX_SOURCE_CACHE_LIMIT = 3+const DOCX_LOADING_INDICATOR_DELAY_MS = 300+const ZOOM_OPTIONS = [10, 25, 50, 75, 100, 125, 150, 175, 200, 400] as const+const DOCX_PADDING_WARNING_TEXT = "a style property during rerender"++const docxFileCache = new Map<string, File>()+const docxFilePromiseCache = new Map<string, Promise<File>>()++type UploadedDocxFile = {+ file: File+ identity: string+}++function getDocumentCacheKey(url: string, fileName?: string) {+ return \`\${url.split("?")[0] ?? url}::\${fileName ?? ""}\`+}++function rememberDocxFile(cacheKey: string, file: File) {+ if (docxFileCache.has(cacheKey)) {+ docxFileCache.delete(cacheKey)+ }++ docxFileCache.set(cacheKey, file)++ while (docxFileCache.size > DOCX_SOURCE_CACHE_LIMIT) {+ const oldestKey = docxFileCache.keys().next().value+ if (!oldestKey) break+ docxFileCache.delete(oldestKey)+ }+}++async function loadCachedDocxFile(+ url: string,+ displayFileName: string,+ cacheKey: string+): Promise<File> {+ const cachedFile = docxFileCache.get(cacheKey)+ if (cachedFile) return cachedFile++ const pendingRequest = docxFilePromiseCache.get(cacheKey)+ if (pendingRequest) return pendingRequest++ const nextRequest = fetch(url)+ .then(async (response) => {+ if (!response.ok) {+ throw new Error(\`Failed to fetch DOCX (\${response.status})\`)+ }++ const blob = await response.blob()+ const docxFile = new File([blob], displayFileName, {+ type: blob.type || DOCX_MIME_TYPE,+ })++ rememberDocxFile(cacheKey, docxFile)+ return docxFile+ })+ .finally(() => {+ docxFilePromiseCache.delete(cacheKey)+ })++ docxFilePromiseCache.set(cacheKey, nextRequest)+ return nextRequest+}++function formatDocumentName(fileName: string | undefined, url: string) {+ if (fileName?.trim()) return fileName++ const pathname = url.split("?")[0] ?? ""+ const rawName = pathname.split("/").pop() ?? "document.docx"++ try {+ return decodeURIComponent(rawName)+ } catch {+ return rawName+ }+}++function getNextZoomScale(currentZoomScale: number, direction: 1 | -1) {+ const currentIndex = ZOOM_OPTIONS.indexOf(+ currentZoomScale as (typeof ZOOM_OPTIONS)[number]+ )+ let fallbackIndex = -1++ if (direction > 0) {+ fallbackIndex = ZOOM_OPTIONS.findIndex(+ (value) => value > currentZoomScale+ )+ } else {+ for (let index = ZOOM_OPTIONS.length - 1; index >= 0; index -= 1) {+ if (ZOOM_OPTIONS[index] < currentZoomScale) {+ fallbackIndex = index+ break+ }+ }+ }++ const resolvedIndex = currentIndex >= 0 ? currentIndex : fallbackIndex+ if (resolvedIndex < 0) return currentZoomScale++ const nextIndex = Math.min(+ Math.max(resolvedIndex + direction, 0),+ ZOOM_OPTIONS.length - 1+ )++ return ZOOM_OPTIONS[nextIndex] ?? currentZoomScale+}++function useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {+ const [showSpinner, setShowSpinner] = React.useState(false)++ React.useEffect(() => {+ if (!isLoading) {+ setShowSpinner(false)+ return+ }++ const timeoutId = window.setTimeout(() => {+ setShowSpinner(true)+ }, delayMs)++ return () => window.clearTimeout(timeoutId)+ }, [delayMs, isLoading])++ return showSpinner+}++function useDocumentNightRenderPreference() {+ const [nightRenderEnabled, setNightRenderEnabled] = React.useState(false)+ const [nightRenderPrefLoaded, setNightRenderPrefLoaded] =+ React.useState(false)++ React.useEffect(() => {+ const storedValue = window.localStorage.getItem("docx-night-render")+ setNightRenderEnabled(storedValue !== "false")+ setNightRenderPrefLoaded(true)+ }, [])++ const updateNightRenderEnabled = React.useCallback((checked: boolean) => {+ setNightRenderEnabled(checked)+ window.localStorage.setItem("docx-night-render", String(checked))+ }, [])++ return {+ nightRenderEnabled,+ nightRenderPrefLoaded,+ setNightRenderEnabled: updateNightRenderEnabled,+ }+}++function isDocxPaddingWarning(args: unknown[]) {+ return (+ typeof args[0] === "string" &&+ args[0].includes(DOCX_PADDING_WARNING_TEXT) &&+ args.some((arg) => String(arg).includes("padding"))+ )+}++function useSuppressDocxPaddingWarning(enabled: boolean) {+ React.useEffect(() => {+ if (!enabled) return++ const originalConsoleError = console.error++ console.error = (...args: unknown[]) => {+ if (isDocxPaddingWarning(args)) return+ originalConsoleError(...args)+ }++ return () => {+ console.error = originalConsoleError+ }+ }, [enabled])+}++function ToolbarTooltip({+ label,+ children,+}: {+ label: string+ children: React.ReactNode+}) {+ return (+ <Tooltip>+ <TooltipTrigger asChild>+ <span className="inline-flex">{children}</span>+ </TooltipTrigger>+ <TooltipContent side="bottom">{label}</TooltipContent>+ </Tooltip>+ )+}++function ViewerLoadingSurface({ showSpinner = true }: { showSpinner?: boolean }) {+ return (+ <div className="grid h-full min-h-52 place-items-center bg-transparent">+ {showSpinner ? (+ <HugeiconsIcon icon={Loading03Icon} className="size-4 animate-spin" />+ ) : null}+ </div>+ )+}++function DocxToolbar({+ isDark,+ onIsDarkChange,+ onUploadClick,+ setZoomScale,+ showNightRenderToggle,+ zoomScale,+}: {+ isDark: boolean+ onIsDarkChange: (checked: boolean) => void+ onUploadClick: () => void+ setZoomScale: React.Dispatch<React.SetStateAction<number>>+ showNightRenderToggle: boolean+ zoomScale: number+}) {+ const canZoomIn = zoomScale < ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]+ const canZoomOut = zoomScale > ZOOM_OPTIONS[0]++ return (+ <div className="flex min-h-12 items-center justify-end gap-3 overflow-x-auto overflow-y-hidden border-b bg-background px-3">+ <TooltipProvider>+ <div className="ml-auto flex shrink-0 items-center gap-1">+ {showNightRenderToggle ? (+ <>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ <ToolbarTooltip+ label={isDark ? "Use light document" : "Use dark document"}+ >+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label={+ isDark ? "Use light document" : "Use dark document"+ }+ onClick={() => onIsDarkChange(!isDark)}+ >+ <HugeiconsIcon+ icon={isDark ? Sun03Icon : Moon02Icon}+ className="size-4"+ />+ </Button>+ </ToolbarTooltip>+ </>+ ) : null}+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <ToolbarTooltip label="Zoom out">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ disabled={!canZoomOut}+ aria-label="Zoom out"+ onClick={() =>+ setZoomScale((currentZoomScale) =>+ getNextZoomScale(currentZoomScale, -1)+ )+ }+ >+ <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Select+ value={zoomScale.toString()}+ onValueChange={(value) => setZoomScale(Number(value))}+ >+ <SelectTrigger+ size="sm"+ className="w-[84px] min-w-[84px]"+ aria-label="Zoom level"+ >+ <SelectValue>{Math.round(zoomScale)}%</SelectValue>+ </SelectTrigger>+ <SelectContent align="end">+ {ZOOM_OPTIONS.map((value) => (+ <SelectItem key={value} value={value.toString()}>+ {value}%+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ <ToolbarTooltip label="Zoom in">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ disabled={!canZoomIn}+ aria-label="Zoom in"+ onClick={() =>+ setZoomScale((currentZoomScale) =>+ getNextZoomScale(currentZoomScale, 1)+ )+ }+ >+ <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <ToolbarTooltip label="Upload DOCX">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Upload DOCX"+ onClick={onUploadClick}+ >+ <HugeiconsIcon icon={Upload01Icon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ </div>+ </TooltipProvider>+ </div>+ )+}++export function DocxViewerPreview({+ className,+ fileName,+ rounded = false,+ src = SAMPLE_DOCX_URL,+}: {+ className?: string+ fileName?: string+ rounded?: boolean+ src?: string+}) {+ const { resolvedTheme } = useTheme()+ const {+ nightRenderEnabled,+ nightRenderPrefLoaded,+ setNightRenderEnabled,+ } = useDocumentNightRenderPreference()+ const isViewerHydrated = resolvedTheme !== undefined && nightRenderPrefLoaded+ const shouldShowHydrationSpinner = useDelayedLoadingIndicator(+ !isViewerHydrated,+ DOCX_LOADING_INDICATOR_DELAY_MS+ )++ if (!isViewerHydrated) {+ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <div+ className={cn(+ "min-h-0 flex-1 overflow-hidden bg-muted/30 p-4",+ rounded && "rounded-b-lg"+ )}+ >+ <ViewerLoadingSurface showSpinner={shouldShowHydrationSpinner} />+ </div>+ </div>+ )+ }++ const shouldRenderNightMode = resolvedTheme === "dark"+ const effectiveIsDark = shouldRenderNightMode && nightRenderEnabled++ return (+ <DocxViewerContent+ className={className}+ effectiveIsDark={effectiveIsDark}+ fileName={fileName}+ rounded={rounded}+ setNightRenderEnabled={setNightRenderEnabled}+ shouldRenderNightMode={shouldRenderNightMode}+ url={src}+ />+ )+}++function DocxViewerContent({+ className,+ effectiveIsDark,+ fileName,+ rounded,+ setNightRenderEnabled,+ shouldRenderNightMode,+ url,+}: {+ className?: string+ effectiveIsDark: boolean+ fileName?: string+ rounded: boolean+ setNightRenderEnabled: (checked: boolean) => void+ shouldRenderNightMode: boolean+ url: string+}) {+ const fileInputRef = React.useRef<HTMLInputElement>(null)+ const viewerBackgroundColor = "color-mix(in oklab, var(--muted) 40%, transparent)"+ const displayFileName = React.useMemo(+ () => formatDocumentName(fileName, url),+ [fileName, url]+ )+ const cacheKey = React.useMemo(+ () => getDocumentCacheKey(url, displayFileName),+ [displayFileName, url]+ )+ const [initialDocumentTheme] = React.useState<DocxDocumentTheme>(() =>+ effectiveIsDark ? "dark" : "light"+ )+ const editorOptions = React.useMemo(+ () => ({+ initialDocumentTheme,+ initialFileName: displayFileName,+ }),+ [displayFileName, initialDocumentTheme]+ )+ const editor = useDocxEditor(editorOptions)+ const { importDocxFile, setDocumentTheme, status } = editor+ const [zoomScale, setZoomScale] = React.useState(50)+ const [loadError, setLoadError] = React.useState<string>()+ const [isLoadingDocument, setIsLoadingDocument] = React.useState(true)+ const [uploadedDocxFile, setUploadedDocxFile] =+ React.useState<UploadedDocxFile | null>(null)+ const shouldShowDocumentSpinner = useDelayedLoadingIndicator(+ isLoadingDocument,+ DOCX_LOADING_INDICATOR_DELAY_MS+ )+ const loadingState = (+ <ViewerLoadingSurface showSpinner={shouldShowDocumentSpinner} />+ )++ useSuppressDocxPaddingWarning(!isLoadingDocument && !loadError)++ React.useEffect(() => {+ setZoomScale(50)+ }, [url])++ React.useEffect(() => {+ setDocumentTheme(effectiveIsDark ? "dark" : "light")+ }, [effectiveIsDark, setDocumentTheme])++ React.useEffect(() => {+ if (+ status.startsWith("Failed to load file") ||+ status === "Only .docx files are supported"+ ) {+ setLoadError(status)+ setIsLoadingDocument(false)+ }+ }, [status])++ React.useEffect(() => {+ let isCurrent = true++ async function load() {+ setIsLoadingDocument(true)+ setLoadError(undefined)++ try {+ const docxFile =+ uploadedDocxFile?.file ??+ (await loadCachedDocxFile(url, displayFileName, cacheKey))+ await importDocxFile(docxFile)++ if (isCurrent) {+ setIsLoadingDocument(false)+ }+ } catch (error) {+ if (isCurrent) {+ setLoadError(+ error instanceof Error ? error.message : "Unknown DOCX load error"+ )+ setIsLoadingDocument(false)+ }+ }+ }++ void load()++ return () => {+ isCurrent = false+ }+ }, [cacheKey, displayFileName, importDocxFile, uploadedDocxFile, url])++ React.useEffect(() => {+ setUploadedDocxFile(null)+ }, [url])++ async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {+ const file = event.target.files?.[0]+ event.target.value = ""++ if (!file) return++ setZoomScale(50)+ setUploadedDocxFile({+ file,+ identity: \`\${file.name}-\${file.size}-\${file.lastModified}\`,+ })+ }++ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <input+ ref={fileInputRef}+ type="file"+ accept=".docx,application/vnd.openxmlformats-officedocument.wordprocessingml.document"+ className="hidden"+ onChange={handleUpload}+ />+ <DocxToolbar+ isDark={effectiveIsDark}+ onIsDarkChange={setNightRenderEnabled}+ onUploadClick={() => fileInputRef.current?.click()}+ setZoomScale={setZoomScale}+ showNightRenderToggle={shouldRenderNightMode}+ zoomScale={zoomScale}+ />+ <div+ className={cn(+ "min-h-0 flex-1 overflow-auto p-4",+ rounded && "rounded-b-lg"+ )}+ style={{ backgroundColor: viewerBackgroundColor }}+ >+ {loadError ? (+ <div className="grid h-full min-h-96 place-items-center p-6 text-center">+ <div className="max-w-md rounded-lg border bg-background p-4 text-sm text-destructive shadow-xs">+ <div className="font-medium">Unable to display DOCX</div>+ <div className="mt-1 text-muted-foreground">{loadError}</div>+ </div>+ </div>+ ) : isLoadingDocument ? (+ loadingState+ ) : (+ <div className="mx-auto flex min-h-full justify-center">+ <div+ className={cn(+ "origin-top",+ effectiveIsDark && "docx-night-reader-shell"+ )}+ style={{ zoom: zoomScale / 100 }}+ >+ <DocxEditorViewer+ editor={editor}+ mode="read-only"+ loadingState={loadingState}+ pageBackgroundColor={effectiveIsDark ? "#0a0a0a" : undefined}+ pageGapBackgroundColor={viewerBackgroundColor}+ deferInitialPaginationPaint={false}+ />+ </div>+ </div>+ )}+ </div>+ </div>+ )+}+`++export function DocxViewerSource() {+ return <HighlightedCodeBlock code={docxViewerSourceCode} />+}diff --git a/apps/v4/components/e-signature-docs.tsx b/apps/v4/components/e-signature-docs.tsxindex 540bf1c..a11b406 100644--- a/apps/v4/components/e-signature-docs.tsx+++ b/apps/v4/components/e-signature-docs.tsx@@ -909,14 +909,6 @@ function ESignatureExample() {iconClassName="bg-emerald-500/10 text-emerald-700 dark:text-emerald-300"onAction={() => setDialogOpen(true)}/>- <SignatureFieldExampleCard- label="Approval date"- status="optional"- pageLabel="p. 2"- description="Optional date field"- iconClassName="bg-amber-500/10 text-amber-700 dark:text-amber-300"- actionLabel="Add date"- /></div><SignatureDialogopen={dialogOpen}@@ -1004,15 +996,6 @@ export function ESignatureExample() {iconClassName="bg-emerald-500/10 text-emerald-700 dark:text-emerald-300"onAction={() => {}}/>- <SignatureFieldCard- label="Approval date"- status="optional"- pageLabel="p. 2"- description="Optional date field"- iconClassName="bg-amber-500/10 text-amber-700 dark:text-amber-300"- actionLabel="Add date"- onAction={() => {}}- /></div>);}`diff --git a/apps/v4/components/file-thumbnail-docs.tsx b/apps/v4/components/file-thumbnail-docs.tsxindex 7745615..2c44994 100644--- a/apps/v4/components/file-thumbnail-docs.tsx+++ b/apps/v4/components/file-thumbnail-docs.tsx@@ -1,38 +1,51 @@"use client"import * as React from "react"-import { File01Icon, FileImageIcon } from "@hugeicons/core-free-icons"-import { HugeiconsIcon } from "@hugeicons/react"+import {+ DocxEditorViewer,+ useDocxEditor,+ useDocxViewerThumbnails,+} from "@extend-ai/react-docx"+import {+ useXlsxViewer,+ useXlsxViewerController,+ useXlsxViewerThumbnails,+ XlsxViewerProvider,+} from "@extend-ai/react-xlsx"import type * as ReactPdf from "react-pdf"-import { cn } from "@/lib/utils"import { Button } from "@/components/ui/button"+import {+ FileThumbnail,+ type ThumbnailFile,+} from "@/components/ui/file-thumbnail"import { HighlightedCodeBlock } from "@/components/highlighted-code-block"-type ThumbnailFile = {- name: string- type: string+type DemoFile = ThumbnailFile & {url: string- size?: string-}--type FileThumbnailProps = {- file: ThumbnailFile- className?: string- showMetadata?: boolean- thumbnailWidth?: number- loadingDelayMs?: number}type ReactPdfModule = typeof ReactPdf-const SAMPLE_FILES: ThumbnailFile[] = [+const SAMPLE_FILES: DemoFile[] = [{name: "attention.pdf",type: "application/pdf",url: "/samples/attention.pdf",size: "15 pages",},+ {+ name: "demo.docx",+ type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",+ url: "/samples/demo.docx",+ size: "DOCX",+ },+ {+ name: "crazy-chart-zoo.xlsx",+ type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",+ url: "/samples/crazy-chart-zoo.xlsx",+ size: "XLSX",+ },{name: "opengraph-image.png",type: "image/png",@@ -41,150 +54,259 @@ const SAMPLE_FILES: ThumbnailFile[] = [},]-function isPdfFile(file: ThumbnailFile) {+function isPdfFile(file: DemoFile) {return (file.type === "application/pdf" || file.name.toLowerCase().endsWith(".pdf"))}-function isImageFile(file: ThumbnailFile) {+function isImageFile(file: DemoFile) {return file.type.startsWith("image/")}-function useLazyRender<TElement extends HTMLElement>() {- const ref = React.useRef<TElement | null>(null)- const [shouldRender, setShouldRender] = React.useState(false)+function isDocxFile(file: DemoFile) {+ return (+ file.type ===+ "application/vnd.openxmlformats-officedocument.wordprocessingml.document" ||+ file.name.toLowerCase().endsWith(".docx")+ )+}++function isXlsxFile(file: DemoFile) {+ const fileName = file.name.toLowerCase()++ return (+ file.type ===+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" ||+ file.type === "application/vnd.ms-excel" ||+ fileName.endsWith(".xlsx") ||+ fileName.endsWith(".xls")+ )+}++function getFileKindLabel(file: DemoFile) {+ if (isPdfFile(file)) return "PDF"+ if (isImageFile(file)) return "Image"+ if (isDocxFile(file)) return "DOCX"+ if (isXlsxFile(file)) return "XLSX"++ return "File"+}++function getThumbnailFile(file: DemoFile): ThumbnailFile {+ return {+ name: file.name,+ size: file.size,+ type: file.type,+ }+}++function useThumbnailActivation(delayMs: number) {+ const [isActive, setIsActive] = React.useState(false)React.useEffect(() => {- const element = ref.current- if (!element) return+ const timeout = window.setTimeout(() => {+ setIsActive(true)+ }, delayMs)- if (!("IntersectionObserver" in window)) {- setShouldRender(true)- return- }+ return () => window.clearTimeout(timeout)+ }, [delayMs])- const observer = new IntersectionObserver(- ([entry]) => {- if (entry?.isIntersecting) {- setShouldRender(true)- observer.disconnect()- }- },- { rootMargin: "200px" }- )+ return isActive+}- observer.observe(element)+function useObjectUrl() {+ const [objectUrl, setObjectUrl] = React.useState<string | null>(null)- return () => observer.disconnect()+ const updateObjectUrl = React.useCallback((blob: Blob) => {+ const nextUrl = URL.createObjectURL(blob)+ setObjectUrl((currentUrl) => {+ if (currentUrl) URL.revokeObjectURL(currentUrl)+ return nextUrl+ })}, [])- return { ref, shouldRender }+ React.useEffect(() => {+ return () => {+ if (objectUrl) URL.revokeObjectURL(objectUrl)+ }+ }, [objectUrl])++ return { objectUrl, updateObjectUrl }}-function FileKindIcon({ file }: { file: ThumbnailFile }) {- const icon = isImageFile(file) ? FileImageIcon : File01Icon+function canvasToBlob(canvas: HTMLCanvasElement | null) {+ if (!canvas) return Promise.resolve<Blob | null>(null)- return <HugeiconsIcon icon={icon} className="size-4" />-}+ const blobFromDataUrl = () => {+ if (typeof canvas.toDataURL !== "function") return Promise.resolve(null)-export function FileThumbnailLoadingOverlay() {- return (- <div className="absolute inset-0 z-10 overflow-hidden bg-muted">- <style>{`- @keyframes file-thumbnail-preview-shimmer {- 0% { transform: translateX(-100%); }- 100% { transform: translateX(100%); }- }- @media (prefers-reduced-motion: reduce) {- .file-thumbnail-preview-shimmer {- animation: none !important;- transform: translateX(0);- opacity: 0.55;+ return fetch(canvas.toDataURL("image/png"))+ .then((response) => response.blob())+ .catch(() => null)+ }++ return new Promise<Blob | null>((resolve) => {+ try {+ if (typeof canvas.toBlob === "function") {+ canvas.toBlob((blob) => {+ if (blob) {+ resolve(blob)+ return}- }- `}</style>- <div className="absolute inset-0 bg-muted" />- <div- className="file-thumbnail-preview-shimmer absolute inset-0 bg-linear-to-r from-transparent via-background/65 to-transparent"- style={{- animation:- "file-thumbnail-preview-shimmer 1.25s ease-in-out infinite",- }}++ void blobFromDataUrl().then(resolve)+ }, "image/png")+ return+ }++ void blobFromDataUrl().then(resolve)+ } catch {+ resolve(null)+ }+ })+}++function DocumentAwareFileThumbnail({+ file,+ className,+ generationDelayMs = 0,+ showMetadata = false,+}: {+ file: DemoFile+ className?: string+ generationDelayMs?: number+ showMetadata?: boolean+}) {+ const isActive = useThumbnailActivation(generationDelayMs)++ if (isImageFile(file)) {+ return (+ <FileThumbnail+ file={getThumbnailFile(file)}+ previewImageUrl={file.url}+ className={className}+ showMetadata={showMetadata}/>- </div>+ )+ }++ if (isPdfFile(file)) {+ return (+ <PdfFileThumbnail+ file={file}+ isActive={isActive}+ className={className}+ showMetadata={showMetadata}+ thumbnailWidth={520}+ />+ )+ }++ if (isDocxFile(file)) {+ return (+ <DocxFileThumbnail+ file={file}+ isActive={isActive}+ className={className}+ showMetadata={showMetadata}+ thumbnailWidth={520}+ />+ )+ }++ if (isXlsxFile(file)) {+ return (+ <XlsxFileThumbnail+ file={file}+ isActive={isActive}+ className={className}+ showMetadata={showMetadata}+ thumbnailWidth={680}+ />+ )+ }++ return (+ <FileThumbnail+ file={getThumbnailFile(file)}+ className={className}+ showMetadata={showMetadata}+ />)}-export function FileThumbnail({+function PdfFileThumbnail({file,className,- showMetadata = true,- thumbnailWidth = 260,- loadingDelayMs = 0,-}: FileThumbnailProps) {- const isPdf = isPdfFile(file)- const isImage = isImageFile(file)- const { ref, shouldRender } = useLazyRender<HTMLDivElement>()+ isActive,+ showMetadata,+ thumbnailWidth,+}: {+ file: DemoFile+ className?: string+ isActive: boolean+ showMetadata: boolean+ thumbnailWidth: number+}) {const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null)- const [isLoading, setIsLoading] = React.useState(isPdf || isImage)- const [isDelayLoading, setIsDelayLoading] = React.useState(loadingDelayMs > 0)+ const [isLoading, setIsLoading] = React.useState(true)const [hasError, setHasError] = React.useState(false)- const showLoading = (isLoading || isDelayLoading) && !hasError-- React.useEffect(() => {- setIsLoading(isPdf || isImage)- setHasError(false)- }, [file.url, isImage, isPdf])-- React.useEffect(() => {- setIsDelayLoading(loadingDelayMs > 0)+ const rootRef = React.useRef<HTMLDivElement | null>(null)+ const { objectUrl, updateObjectUrl } = useObjectUrl()+ const shouldRenderPdf = isActive && reactPdf && !objectUrl && !hasError+ const capturePdfCanvas = React.useCallback(() => {+ const canvas = rootRef.current?.querySelector("canvas") ?? null- if (loadingDelayMs <= 0) return+ void canvasToBlob(canvas).then((blob) => {+ if (!blob) return- const timeout = window.setTimeout(() => {- setIsDelayLoading(false)- }, loadingDelayMs)-- return () => window.clearTimeout(timeout)- }, [file.url, loadingDelayMs])+ updateObjectUrl(blob)+ setHasError(false)+ setIsLoading(false)+ })+ }, [updateObjectUrl])React.useEffect(() => {- if (!isPdf || !shouldRender) return+ if (!isActive || reactPdf || objectUrl) return- let mounted = true+ let isMounted = truesetIsLoading(true)+ setHasError(false)void import("react-pdf").then((module) => {module.pdfjs.GlobalWorkerOptions.workerSrc = `https://unpkg.com/pdfjs-dist@${module.pdfjs.version}/legacy/build/pdf.worker.min.mjs`-- if (mounted) {- setReactPdf(module)- }+ if (isMounted) setReactPdf(module)}).catch(() => {- if (mounted) {+ if (isMounted) {setHasError(true)setIsLoading(false)}})return () => {- mounted = false+ isMounted = false}- }, [isPdf, shouldRender])+ }, [isActive, objectUrl, reactPdf])return (- <div- ref={ref}- className={cn(- "group overflow-hidden rounded-lg border bg-background text-foreground",- className- )}- >- <div className="relative aspect-square overflow-hidden bg-muted">- {isPdf && shouldRender && reactPdf ? (+ <>+ <FileThumbnail+ file={getThumbnailFile(file)}+ previewImageUrl={objectUrl}+ isLoading={isLoading && !objectUrl}+ hasError={hasError}+ className={className}+ showMetadata={showMetadata}+ />+ {shouldRenderPdf ? (+ <div+ ref={rootRef}+ aria-hidden="true"+ className="pointer-events-none fixed top-0 left-[-10000px] w-[560px] overflow-hidden bg-white"+ ><reactPdf.Documentfile={file.url}loading={null}@@ -200,63 +322,275 @@ export function FileThumbnail({width={thumbnailWidth}loading={null}error={null}- onRenderSuccess={() => setIsLoading(false)}+ onRenderSuccess={() => {+ window.requestAnimationFrame(() => {+ capturePdfCanvas()+ })+ }}onRenderError={() => {setHasError(true)setIsLoading(false)}}- className={cn(- "flex size-full items-center justify-center [&_canvas]:!h-full [&_canvas]:!w-full [&_canvas]:object-cover [&_canvas]:transition-[opacity,filter,transform] [&_canvas]:duration-[160ms] [&_canvas]:ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:[&_canvas]:transition-none",- showLoading- ? "[&_canvas]:scale-[1.01] [&_canvas]:opacity-0 [&_canvas]:blur-sm"- : "[&_canvas]:blur-0 [&_canvas]:scale-100 [&_canvas]:opacity-100"- )}/></reactPdf.Document>- ) : null}- {isImage ? (- <img- src={file.url}- alt=""- loading="lazy"- decoding="async"- className={cn(- "size-full object-cover transition-[opacity,filter,transform] duration-[160ms] ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none",- showLoading- ? "scale-[1.01] opacity-0 blur-sm"- : "blur-0 scale-100 opacity-100"- )}- onLoad={() => setIsLoading(false)}- onError={() => {- setHasError(true)- setIsLoading(false)- }}- />- ) : null}- {showLoading ? <FileThumbnailLoadingOverlay /> : null}- {hasError || (!isPdf && !isImage) ? (- <div className="absolute inset-0 grid place-items-center bg-muted text-muted-foreground">- <FileKindIcon file={file} />- </div>- ) : null}- </div>- {showMetadata ? (- <div className="flex items-center gap-2 border-t px-3 py-2">- <div className="flex size-7 shrink-0 items-center justify-center rounded-md border bg-muted text-muted-foreground">- <FileKindIcon file={file} />- </div>- <div className="min-w-0">- <div className="truncate text-sm font-medium">{file.name}</div>- <div className="truncate text-xs text-muted-foreground">- {file.size ?? file.type}- </div>+ </div>+ ) : null}+ </>+ )+}++function DocxFileThumbnail({+ file,+ className,+ isActive,+ showMetadata,+ thumbnailWidth,+}: {+ file: DemoFile+ className?: string+ isActive: boolean+ showMetadata: boolean+ thumbnailWidth: number+}) {+ if (!isActive) {+ return (+ <FileThumbnail+ file={getThumbnailFile(file)}+ isLoading+ className={className}+ showMetadata={showMetadata}+ />+ )+ }++ return (+ <DocxFileThumbnailContent+ file={file}+ className={className}+ showMetadata={showMetadata}+ thumbnailWidth={thumbnailWidth}+ />+ )+}++function DocxFileThumbnailContent({+ className,+ file,+ showMetadata,+ thumbnailWidth,+}: {+ className?: string+ file: DemoFile+ showMetadata: boolean+ thumbnailWidth: number+}) {+ const editor = useDocxEditor({+ initialDocumentTheme: "light",+ initialFileName: file.name,+ })+ const { thumbnails } = useDocxViewerThumbnails(editor, {+ pixelRatio: 2,+ resolution: {+ maxHeight: thumbnailWidth,+ maxWidth: thumbnailWidth,+ },+ })+ const firstThumbnail = thumbnails[0]+ const [hasError, setHasError] = React.useState(false)+ const [isReady, setIsReady] = React.useState(false)++ React.useEffect(() => {+ let isCurrent = true++ async function loadDocx() {+ try {+ const response = await fetch(file.url)+ if (!response.ok) {+ throw new Error(`Failed to fetch DOCX (${response.status})`)+ }++ const blob = await response.blob()+ const docxFile = new File([blob], file.name, {+ type:+ blob.type ||+ "application/vnd.openxmlformats-officedocument.wordprocessingml.document",+ })+ await editor.importDocxFile(docxFile)+ } catch {+ if (isCurrent) setHasError(true)+ }+ }++ void loadDocx()++ return () => {+ isCurrent = false+ }+ }, [editor, file.name, file.url])++ React.useEffect(() => {+ if (firstThumbnail?.status === "ready") {+ setIsReady(true)+ } else if (firstThumbnail?.status === "error") {+ setHasError(true)+ }+ }, [firstThumbnail?.status])++ const previewContent = firstThumbnail ? (+ <canvas+ ref={firstThumbnail.canvasRef}+ width={firstThumbnail.pixelWidthPx}+ height={firstThumbnail.pixelHeightPx}+ className="!size-full bg-white object-cover object-top"+ />+ ) : null++ return (+ <>+ <FileThumbnail+ file={getThumbnailFile(file)}+ previewContent={previewContent}+ isLoading={!isReady && !hasError}+ hasError={hasError}+ className={className}+ previewClassName="bg-white"+ showMetadata={showMetadata}+ />+ {!hasError ? (+ <div+ aria-hidden="true"+ className="pointer-events-none fixed top-0 left-[-10000px] w-[816px] overflow-hidden bg-white"+ >+ <div className="w-[816px]">+ <DocxEditorViewer+ editor={editor}+ mode="read-only"+ pageBackgroundColor="#ffffff"+ pageGapBackgroundColor="transparent"+ visiblePageRange={{ endPageIndex: 0, startPageIndex: 0 }}+ pageVirtualization={{ enabled: false }}+ deferInitialPaginationPaint={false}+ /></div></div>) : null}- </div>+ </>)}+function XlsxFileThumbnail({+ file,+ className,+ isActive,+ showMetadata,+ thumbnailWidth,+}: {+ file: DemoFile+ className?: string+ isActive: boolean+ showMetadata: boolean+ thumbnailWidth: number+}) {+ const [imageUrl, setImageUrl] = React.useState<string | null>(null)+ const [hasError, setHasError] = React.useState(false)+ const handleError = React.useCallback(() => {+ setHasError(true)+ }, [])++ return (+ <>+ <FileThumbnail+ file={getThumbnailFile(file)}+ previewImageUrl={imageUrl}+ isLoading={isActive && !imageUrl && !hasError}+ hasError={hasError}+ className={className}+ previewClassName="bg-white [&>img]:object-left-top"+ showMetadata={showMetadata}+ />+ {isActive && !imageUrl && !hasError ? (+ <XlsxThumbnailGenerator+ file={file}+ thumbnailWidth={thumbnailWidth}+ onError={handleError}+ onImageUrl={setImageUrl}+ />+ ) : null}+ </>+ )+}++function XlsxThumbnailGenerator({+ file,+ onError,+ onImageUrl,+ thumbnailWidth,+}: {+ file: DemoFile+ onError: () => void+ onImageUrl: (url: string) => void+ thumbnailWidth: number+}) {+ const controller = useXlsxViewerController(+ React.useMemo(+ () => ({+ fileName: file.name,+ readOnly: true,+ src: file.url,+ useWorker: true,+ }),+ [file.name, file.url]+ )+ )++ return (+ <XlsxViewerProvider controller={controller}>+ <XlsxThumbnailGeneratorContent+ thumbnailWidth={thumbnailWidth}+ onError={onError}+ onImageUrl={onImageUrl}+ />+ </XlsxViewerProvider>+ )+}++function XlsxThumbnailGeneratorContent({+ onError,+ onImageUrl,+ thumbnailWidth,+}: {+ onError: () => void+ onImageUrl: (url: string) => void+ thumbnailWidth: number+}) {+ const controller = useXlsxViewer()+ const { thumbnails } = useXlsxViewerThumbnails({+ includeHeaders: true,+ resolution: {+ maxHeight: thumbnailWidth,+ maxWidth: thumbnailWidth,+ },+ })+ const firstThumbnail = thumbnails[0]++ React.useEffect(() => {+ if (controller.error) {+ onError()+ return+ }++ if (!firstThumbnail) return++ const canvas = document.createElement("canvas")++ if (!firstThumbnail.paint(canvas)) return++ onImageUrl(canvas.toDataURL("image/png"))+ }, [controller.error, firstThumbnail, onError, onImageUrl])++ return null+}+export function FileThumbnailDemo() {const [isCodeVisible, setIsCodeVisible] = React.useState(false)@@ -265,13 +599,14 @@ export function FileThumbnailDemo() {data-slot="component-preview"className="group relative mt-4 mb-12 flex flex-col overflow-hidden rounded-xl border">- <div className="grid gap-6 bg-background p-6 sm:grid-cols-2">+ <div className="grid gap-6 bg-background p-6 sm:grid-cols-2 lg:grid-cols-4">{SAMPLE_FILES.map((file) => (<div key={file.url} className="space-y-2">- <div className="text-sm font-medium">- {isPdfFile(file) ? "PDF" : "Image"}- </div>- <FileThumbnail file={file} showMetadata={false} />+ <div className="text-sm font-medium">{getFileKindLabel(file)}</div>+ <DocumentAwareFileThumbnail+ file={file}+ generationDelayMs={250 + SAMPLE_FILES.indexOf(file) * 300}+ /></div>))}</div>@@ -319,117 +654,307 @@ export function FileThumbnailDemo() {)}-const fileThumbnailDemoCode = `import { FileThumbnail } from "@/components/ui/file-thumbnail";+const fileThumbnailDemoCode = `"use client"-const files = [- {- label: "PDF",- file: {- name: "attention.pdf",- type: "application/pdf",- url: "/samples/attention.pdf",- size: "15 pages",- },- },- {- label: "Image",- file: {- name: "opengraph-image.png",- type: "image/png",- url: "/opengraph-image.png",- size: "1200 x 630",- },- },-];+import * as React from "react"+import {+ DocxEditorViewer,+ useDocxEditor,+ useDocxViewerThumbnails,+} from "@extend-ai/react-docx"+import {+ useXlsxViewer,+ useXlsxViewerController,+ useXlsxViewerThumbnails,+ XlsxViewerProvider,+} from "@extend-ai/react-xlsx"+import type * as ReactPdf from "react-pdf"++import {+ FileThumbnail,+ type ThumbnailFile,+} from "@/components/ui/file-thumbnail"++type DemoFile = ThumbnailFile & {+ url: string+}++type ReactPdfModule = typeof ReactPdf++function toThumbnailFile(file: DemoFile): ThumbnailFile {+ return {+ name: file.name,+ size: file.size,+ type: file.type,+ }+}++function useObjectUrl() {+ const [objectUrl, setObjectUrl] = React.useState<string | null>(null)++ const updateObjectUrl = React.useCallback((blob: Blob) => {+ const nextUrl = URL.createObjectURL(blob)+ setObjectUrl((currentUrl) => {+ if (currentUrl) URL.revokeObjectURL(currentUrl)+ return nextUrl+ })+ }, [])++ React.useEffect(() => {+ return () => {+ if (objectUrl) URL.revokeObjectURL(objectUrl)+ }+ }, [objectUrl])++ return { objectUrl, updateObjectUrl }+}++function canvasToBlob(canvas: HTMLCanvasElement | null) {+ if (!canvas) return Promise.resolve<Blob | null>(null)++ return new Promise<Blob | null>((resolve) => {+ try {+ canvas.toBlob((blob) => resolve(blob), "image/png")+ } catch {+ resolve(null)+ }+ })+}++function PdfThumbnail({ file }: { file: DemoFile }) {+ const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null)+ const [isLoading, setIsLoading] = React.useState(true)+ const [hasError, setHasError] = React.useState(false)+ const rootRef = React.useRef<HTMLDivElement | null>(null)+ const { objectUrl, updateObjectUrl } = useObjectUrl()++ React.useEffect(() => {+ let isMounted = true++ void import("react-pdf")+ .then((module) => {+ module.pdfjs.GlobalWorkerOptions.workerSrc = \`https://unpkg.com/pdfjs-dist@\${module.pdfjs.version}/legacy/build/pdf.worker.min.mjs\`+ if (isMounted) setReactPdf(module)+ })+ .catch(() => {+ if (isMounted) {+ setHasError(true)+ setIsLoading(false)+ }+ })++ return () => {+ isMounted = false+ }+ }, [])-export function FileThumbnailExample() {return (- <div className="grid gap-6 sm:grid-cols-2">- {files.map((item) => (- <div key={item.file.url} className="space-y-2">- <div className="text-sm font-medium">{item.label}</div>- <FileThumbnail file={item.file} showMetadata={false} />+ <>+ <FileThumbnail+ file={toThumbnailFile(file)}+ previewImageUrl={objectUrl}+ isLoading={isLoading}+ hasError={hasError}+ showMetadata={false}+ />+ {reactPdf ? (+ <div+ ref={rootRef}+ aria-hidden="true"+ className="pointer-events-none fixed top-0 left-[-10000px] w-[300px] overflow-hidden bg-white"+ >+ <reactPdf.Document file={file.url} loading={null}>+ <reactPdf.Thumbnail+ pageNumber={1}+ width={260}+ loading={null}+ onRenderSuccess={() => {+ window.requestAnimationFrame(() => {+ const canvas = rootRef.current?.querySelector("canvas")+ void canvasToBlob(canvas).then((blob) => {+ if (!blob) {+ setHasError(true)+ setIsLoading(false)+ return+ }++ updateObjectUrl(blob)+ setIsLoading(false)+ })+ })+ }}+ onRenderError={() => {+ setHasError(true)+ setIsLoading(false)+ }}+ />+ </reactPdf.Document></div>- ))}- </div>- );-}`--const fileThumbnailUsageCode = `"use client";+ ) : null}+ </>+ )+}-import * as React from "react";-import type * as ReactPdf from "react-pdf";-import { File01Icon, FileImageIcon } from "@hugeicons/core-free-icons";-import { HugeiconsIcon } from "@hugeicons/react";+function DocxThumbnail({ file }: { file: DemoFile }) {+ const editor = useDocxEditor({+ initialDocumentTheme: "light",+ initialFileName: file.name,+ })+ const { thumbnails } = useDocxViewerThumbnails(editor, {+ pixelRatio: 2,+ resolution: { maxHeight: 520, maxWidth: 520 },+ })+ const firstThumbnail = thumbnails[0]+ const [isLoading, setIsLoading] = React.useState(true)+ const [hasError, setHasError] = React.useState(false)-import { cn } from "@/lib/utils";+ React.useEffect(() => {+ async function loadDocx() {+ try {+ const response = await fetch(file.url)+ const blob = await response.blob()+ await editor.importDocxFile(new File([blob], file.name))+ } catch {+ setHasError(true)+ setIsLoading(false)+ }+ }-type ThumbnailFile = {- name: string;- type: string;- url: string;- size?: string;-};+ void loadDocx()+ }, [editor, file.name, file.url])-type FileThumbnailProps = {- file: ThumbnailFile;- className?: string;- showMetadata?: boolean;- thumbnailWidth?: number;- loadingDelayMs?: number;-};+ React.useEffect(() => {+ if (firstThumbnail?.status === "ready") {+ setIsLoading(false)+ } else if (firstThumbnail?.status === "error") {+ setHasError(true)+ setIsLoading(false)+ }+ }, [firstThumbnail?.status])-type ReactPdfModule = typeof ReactPdf;+ const previewContent = firstThumbnail ? (+ <canvas+ ref={firstThumbnail.canvasRef}+ width={firstThumbnail.pixelWidthPx}+ height={firstThumbnail.pixelHeightPx}+ className="!size-full bg-white object-cover object-top"+ />+ ) : null-function isPdfFile(file: ThumbnailFile) {- return file.type === "application/pdf" || file.name.toLowerCase().endsWith(".pdf");+ return (+ <>+ <FileThumbnail+ file={toThumbnailFile(file)}+ previewContent={previewContent}+ isLoading={isLoading}+ hasError={hasError}+ previewClassName="bg-white"+ showMetadata={false}+ />+ <div+ aria-hidden="true"+ className="pointer-events-none fixed top-0 left-[-10000px] w-[816px] overflow-hidden bg-white"+ >+ <div className="w-[816px]">+ <DocxEditorViewer editor={editor} mode="read-only" />+ </div>+ </div>+ </>+ )}-function isImageFile(file: ThumbnailFile) {- return file.type.startsWith("image/");+function XlsxThumbnail({ file }: { file: DemoFile }) {+ const controller = useXlsxViewerController(+ React.useMemo(+ () => ({+ fileName: file.name,+ readOnly: true,+ src: file.url,+ useWorker: true,+ }),+ [file.name, file.url]+ )+ )++ return (+ <XlsxViewerProvider controller={controller}>+ <XlsxThumbnailContent file={file} />+ </XlsxViewerProvider>+ )}-function useLazyRender<TElement extends HTMLElement>() {- const ref = React.useRef<TElement | null>(null);- const [shouldRender, setShouldRender] = React.useState(false);+function XlsxThumbnailContent({ file }: { file: DemoFile }) {+ const controller = useXlsxViewer()+ const { thumbnails } = useXlsxViewerThumbnails({+ includeHeaders: true,+ resolution: { maxHeight: 680, maxWidth: 680 },+ })+ const firstThumbnail = thumbnails[0]+ const [imageUrl, setImageUrl] = React.useState<string | null>(null)React.useEffect(() => {- const element = ref.current;- if (!element) return;+ if (!firstThumbnail) return- if (!("IntersectionObserver" in window)) {- setShouldRender(true);- return;+ const canvas = document.createElement("canvas")+ canvas.width = firstThumbnail.width+ canvas.height = firstThumbnail.height++ if (firstThumbnail.paint(canvas)) {+ setImageUrl(canvas.toDataURL("image/png"))}+ }, [firstThumbnail])- const observer = new IntersectionObserver(- ([entry]) => {- if (entry?.isIntersecting) {- setShouldRender(true);- observer.disconnect();- }- },- { rootMargin: "200px" },- );+ return (+ <FileThumbnail+ file={toThumbnailFile(file)}+ previewImageUrl={imageUrl}+ isLoading={controller.isLoading || !imageUrl}+ hasError={Boolean(controller.error)}+ previewClassName="bg-white [&>img]:object-left-top"+ showMetadata={false}+ />+ )+}`- observer.observe(element);+const fileThumbnailSourceCode = `"use client"- return () => observer.disconnect();- }, []);+import * as React from "react"+import { File01Icon, FileImageIcon } from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"- return { ref, shouldRender };+import { cn } from "@/lib/utils"++export type ThumbnailFile = {+ name: string+ type: string+ size?: string+}++export type FileThumbnailProps = {+ file: ThumbnailFile+ className?: string+ previewClassName?: string+ previewContent?: React.ReactNode+ previewImageUrl?: string | null+ isLoading?: boolean+ hasError?: boolean+ showMetadata?: boolean+}++function isImageFile(file: ThumbnailFile) {+ return file.type.startsWith("image/")}function FileKindIcon({ file }: { file: ThumbnailFile }) {- const icon = isImageFile(file) ? FileImageIcon : File01Icon;+ const icon = isImageFile(file) ? FileImageIcon : File01Icon- return <HugeiconsIcon icon={icon} className="size-4" />;+ return <HugeiconsIcon icon={icon} className="size-4" />}export function FileThumbnailLoadingOverlay() {return (<div className="absolute inset-0 z-10 overflow-hidden bg-muted">- <style>{\`+ <style>{\\\`@keyframes file-thumbnail-preview-shimmer {0% { transform: translateX(-100%); }100% { transform: translateX(100%); }@@ -441,124 +966,77 @@ export function FileThumbnailLoadingOverlay() {opacity: 0.55;}}- \`}</style>+ \\\`}</style><div className="absolute inset-0 bg-muted" /><divclassName="file-thumbnail-preview-shimmer absolute inset-0 bg-linear-to-r from-transparent via-background/65 to-transparent"style={{- animation: "file-thumbnail-preview-shimmer 1.25s ease-in-out infinite",+ animation:+ "file-thumbnail-preview-shimmer 1.25s ease-in-out infinite",}}/></div>- );+ )}export function FileThumbnail({file,className,+ previewClassName,+ previewContent,+ previewImageUrl,+ isLoading = false,+ hasError = false,showMetadata = true,- thumbnailWidth = 260,- loadingDelayMs = 0,}: FileThumbnailProps) {- const isPdf = isPdfFile(file);- const isImage = isImageFile(file);- const { ref, shouldRender } = useLazyRender<HTMLDivElement>();- const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null);- const [isLoading, setIsLoading] = React.useState(isPdf || isImage);- const [isDelayLoading, setIsDelayLoading] = React.useState(- loadingDelayMs > 0,- );- const [hasError, setHasError] = React.useState(false);- const showLoading = (isLoading || isDelayLoading) && !hasError;+ const imageRef = React.useRef<HTMLImageElement | null>(null)+ const [isImageLoading, setIsImageLoading] = React.useState(+ Boolean(previewImageUrl)+ )+ const [imageFailed, setImageFailed] = React.useState(false)+ const showLoading = isLoading || isImageLoading+ const hasPreviewContent = Boolean(previewContent)+ const showFallback =+ hasError || imageFailed || (!previewImageUrl && !hasPreviewContent)+ const markImageLoaded = React.useCallback((image: HTMLImageElement) => {+ const didLoad = image.naturalWidth > 0 && image.naturalHeight > 0++ setImageFailed(!didLoad)+ setIsImageLoading(false)+ }, [])React.useEffect(() => {- setIsLoading(isPdf || isImage);- setHasError(false);- }, [file.url, isImage, isPdf]);+ setIsImageLoading(Boolean(previewImageUrl))+ setImageFailed(false)+ }, [previewImageUrl])React.useEffect(() => {- setIsDelayLoading(loadingDelayMs > 0);-- if (loadingDelayMs <= 0) return;-- const timeout = window.setTimeout(() => {- setIsDelayLoading(false);- }, loadingDelayMs);+ const image = imageRef.current- return () => window.clearTimeout(timeout);- }, [file.url, loadingDelayMs]);+ if (!image || !previewImageUrl) return- React.useEffect(() => {- if (!isPdf || !shouldRender) return;-- let mounted = true;- setIsLoading(true);-- void import("react-pdf")- .then((module) => {- module.pdfjs.GlobalWorkerOptions.workerSrc =- "https://unpkg.com/pdfjs-dist@" +- module.pdfjs.version +- "/legacy/build/pdf.worker.min.mjs";-- if (mounted) {- setReactPdf(module);- }- })- .catch(() => {- if (mounted) {- setHasError(true);- setIsLoading(false);- }- });-- return () => {- mounted = false;- };- }, [isPdf, shouldRender]);+ if (image.complete) {+ markImageLoaded(image)+ }+ }, [markImageLoaded, previewImageUrl])return (<div- ref={ref}className={cn("group overflow-hidden rounded-lg border bg-background text-foreground",- className,+ className)}>- <div className="relative aspect-square overflow-hidden bg-muted">- {isPdf && shouldRender && reactPdf ? (- <reactPdf.Document- file={file.url}- loading={null}- error={null}- noData={null}- onLoadError={() => {- setHasError(true);- setIsLoading(false);- }}- >- <reactPdf.Thumbnail- pageNumber={1}- width={thumbnailWidth}- loading={null}- error={null}- onRenderSuccess={() => setIsLoading(false)}- onRenderError={() => {- setHasError(true);- setIsLoading(false);- }}- className={cn(- "flex size-full items-center justify-center [&_canvas]:!h-full [&_canvas]:!w-full [&_canvas]:object-cover [&_canvas]:transition-[opacity,filter,transform] [&_canvas]:duration-[160ms] [&_canvas]:ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:[&_canvas]:transition-none",- showLoading- ? "[&_canvas]:scale-[1.01] [&_canvas]:opacity-0 [&_canvas]:blur-sm"- : "[&_canvas]:scale-100 [&_canvas]:opacity-100 [&_canvas]:blur-0",- )}- />- </reactPdf.Document>- ) : null}- {isImage ? (+ <div+ className={cn(+ "relative aspect-square overflow-hidden bg-muted",+ previewClassName+ )}+ >+ {previewImageUrl ? (<img- src={file.url}+ ref={imageRef}+ src={previewImageUrl}alt=""loading="lazy"decoding="async"@@ -566,19 +1044,31 @@ export function FileThumbnail({"size-full object-cover transition-[opacity,filter,transform] duration-[160ms] ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none",showLoading? "scale-[1.01] opacity-0 blur-sm"- : "scale-100 opacity-100 blur-0",+ : "blur-0 scale-100 opacity-100")}- onLoad={() => setIsLoading(false)}+ onLoad={(event) => {+ markImageLoaded(event.currentTarget)+ }}onError={() => {- setHasError(true);- setIsLoading(false);+ setImageFailed(true)+ setIsImageLoading(false)}}/>) : null}- {showLoading ? (- <FileThumbnailLoadingOverlay />+ {previewContent ? (+ <div+ className={cn(+ "size-full transition-[opacity,filter,transform] duration-[160ms] ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none",+ showLoading+ ? "scale-[1.01] opacity-0 blur-sm"+ : "blur-0 scale-100 opacity-100"+ )}+ >+ {previewContent}+ </div>) : null}- {hasError || (!isPdf && !isImage) ? (+ {showLoading ? <FileThumbnailLoadingOverlay /> : null}+ {showFallback ? (<div className="absolute inset-0 grid place-items-center bg-muted text-muted-foreground"><FileKindIcon file={file} /></div>@@ -598,9 +1088,9 @@ export function FileThumbnail({</div>) : null}</div>- );+ )}`export function FileThumbnailSource() {- return <HighlightedCodeBlock code={fileThumbnailUsageCode} />+ return <HighlightedCodeBlock code={fileThumbnailSourceCode} />}diff --git a/apps/v4/components/file-upload-docs.tsx b/apps/v4/components/file-upload-docs.tsxindex 4feea66..02bee23 100644--- a/apps/v4/components/file-upload-docs.tsx+++ b/apps/v4/components/file-upload-docs.tsx@@ -13,7 +13,7 @@ import { useTheme } from "next-themes"import { cn } from "@/lib/utils"import { Button } from "@/components/ui/button"-import { FileThumbnail } from "@/components/file-thumbnail-docs"+import { FileThumbnail } from "@/components/ui/file-thumbnail"import { HighlightedCodeBlock } from "@/components/highlighted-code-block"import { Card } from "@/registry/new-york-v4/ui/card"@@ -301,12 +301,13 @@ export function FileUpload({file={{name: file.name,type: file.type,- url: file.url,size: formatBytes(file.size),}}+ previewImageUrl={+ file.type.startsWith("image/") ? file.url : null+ }className="size-10 shrink-0 rounded-lg"showMetadata={false}- thumbnailWidth={56}/><div className="min-w-0 flex-1"><div className="truncate text-sm font-medium">{file.name}</div>@@ -599,12 +600,11 @@ export function FileUpload({ className, onFilesChange }: FileUploadProps) {file={{name: file.name,type: file.type,- url: file.url,size: formatBytes(file.size),}}+ previewImageUrl={file.type.startsWith("image/") ? file.url : null}className="size-10 shrink-0 rounded-lg"showMetadata={false}- thumbnailWidth={56}/><div className="min-w-0 flex-1"><div className="truncate text-sm font-medium">{file.name}</div>diff --git a/apps/v4/components/highlighted-code-block.tsx b/apps/v4/components/highlighted-code-block.tsxindex 6fa8c5a..b6763da 100644--- a/apps/v4/components/highlighted-code-block.tsx+++ b/apps/v4/components/highlighted-code-block.tsx@@ -1,11 +1,12 @@"use client"import * as React from "react"-import { codeToHtml } from "shiki"import { cn } from "@/lib/utils"import { CopyButton } from "@/components/copy-button"+const highlightedCodeCache = new Map<string, string>()+export function HighlightedCodeBlock({code,className,@@ -20,6 +21,8 @@ export function HighlightedCodeBlock({showCopy?: boolean}) {const [html, setHtml] = React.useState<string | null>(null)+ const [isVisible, setIsVisible] = React.useState(false)+ const containerRef = React.useRef<HTMLDivElement | null>(null)const visibleCode = React.useMemo(() => {if (!previewLines) {return code@@ -27,11 +30,48 @@ export function HighlightedCodeBlock({return code.split("\n").slice(0, previewLines).join("\n")}, [code, previewLines])+ const cacheKey = React.useMemo(+ () => `${visibleCode}::${maxHeightClassName}::${showCopy}`,+ [maxHeightClassName, showCopy, visibleCode]+ )++ React.useEffect(() => {+ const container = containerRef.current+ if (!container) return++ if (!("IntersectionObserver" in window)) {+ setIsVisible(true)+ return+ }++ const observer = new IntersectionObserver(+ ([entry]) => {+ if (entry?.isIntersecting) {+ setIsVisible(true)+ observer.disconnect()+ }+ },+ { rootMargin: "800px 0px" }+ )++ observer.observe(container)++ return () => observer.disconnect()+ }, [])React.useEffect(() => {let cancelled = falseasync function highlight() {+ if (!isVisible) return++ const cachedHtml = highlightedCodeCache.get(cacheKey)+ if (cachedHtml) {+ setHtml(cachedHtml)+ return+ }++ const { codeToHtml } = await import("shiki")const highlighted = await codeToHtml(visibleCode, {lang: "tsx",themes: {@@ -61,6 +101,7 @@ export function HighlightedCodeBlock({})if (!cancelled) {+ highlightedCodeCache.set(cacheKey, highlighted)setHtml(highlighted)}}@@ -71,10 +112,11 @@ export function HighlightedCodeBlock({return () => {cancelled = true}- }, [maxHeightClassName, showCopy, visibleCode])+ }, [cacheKey, isVisible, maxHeightClassName, showCopy, visibleCode])return (<div+ ref={containerRef}data-rehype-pretty-code-figureclassName={cn("relative m-0! overflow-hidden rounded-lg border bg-code text-code-foreground",diff --git a/apps/v4/components/pdf-viewer-blocks.tsx b/apps/v4/components/pdf-viewer-blocks.tsxindex ce03006..f22dfd4 100644--- a/apps/v4/components/pdf-viewer-blocks.tsx+++ b/apps/v4/components/pdf-viewer-blocks.tsx@@ -1,17 +1,61 @@"use client"import * as React from "react"+import dynamic from "next/dynamic"import Link from "next/link"import { ArrowUpRight01Icon, Refresh01Icon } from "@hugeicons/core-free-icons"import { HugeiconsIcon } from "@hugeicons/react"import { Button } from "@/components/ui/button"-import { CitationsBlock } from "@/components/citations-docs"-import { DocumentSplitsBlock } from "@/components/document-splitter-docs"-import { ESignatureBlock } from "@/components/e-signature-docs"-import { HumanReviewBlock } from "@/components/human-review-docs"-import { OcrBlocksBlock } from "@/components/ocr-blocks-docs"-import { PdfDropzoneBlock } from "@/components/pdf-dropzone-block"++const PreviewLoading = () => (+ <div className="grid h-[420px] place-items-center bg-muted/20 text-sm text-muted-foreground">+ Loading preview...+ </div>+)++const PdfDropzoneBlock = dynamic(+ () =>+ import("@/components/pdf-dropzone-block").then(+ (mod) => mod.PdfDropzoneBlock+ ),+ { loading: PreviewLoading, ssr: false }+)+const CitationsBlock = dynamic(+ () => import("@/components/citations-docs").then((mod) => mod.CitationsBlock),+ { loading: PreviewLoading, ssr: false }+)+const OcrBlocksBlock = dynamic(+ () =>+ import("@/components/ocr-blocks-docs").then((mod) => mod.OcrBlocksBlock),+ { loading: PreviewLoading, ssr: false }+)+const ESignatureBlock = dynamic(+ () =>+ import("@/components/e-signature-docs").then((mod) => mod.ESignatureBlock),+ { loading: PreviewLoading, ssr: false }+)+const HumanReviewBlock = dynamic(+ () =>+ import("@/components/human-review-docs").then(+ (mod) => mod.HumanReviewBlock+ ),+ { loading: PreviewLoading, ssr: false }+)+const DocumentSplitsBlock = dynamic(+ () =>+ import("@/components/document-splitter-docs").then(+ (mod) => mod.DocumentSplitsBlock+ ),+ { loading: PreviewLoading, ssr: false }+)+const XlsxDocumentSplitsBlock = dynamic(+ () =>+ import("@/components/document-splitter-docs").then(+ (mod) => mod.XlsxDocumentSplitsBlock+ ),+ { loading: PreviewLoading, ssr: false }+)const pdfViewerBlocks = [{@@ -70,6 +114,15 @@ const pdfViewerBlocks = [docsHref: "/docs/components/pdf-viewer/document-splits",component: DocumentSplitsBlock,},+ {+ id: "excel-document-splits",+ title: "Excel Document Splits",+ description:+ "Workbook sheets split into draggable groups with thumbnails from the XLSX viewer.",+ command: "npx shadcn@latest add xlsx-viewer document-splits",+ docsHref: "/docs/components/xlsx-viewer",+ component: XlsxDocumentSplitsBlock,+ },]export function PdfViewerBlocks() {@@ -87,11 +140,37 @@ function PdfViewerBlockPreview({}: {block: (typeof pdfViewerBlocks)[number]}) {+ const rootRef = React.useRef<HTMLElement | null>(null)+ const [isPreviewVisible, setIsPreviewVisible] = React.useState(false)const [previewKey, setPreviewKey] = React.useState(0)const Preview = block.component+ React.useEffect(() => {+ const root = rootRef.current+ if (!root || isPreviewVisible) return++ if (!("IntersectionObserver" in window)) {+ setIsPreviewVisible(true)+ return+ }++ const observer = new IntersectionObserver(+ ([entry]) => {+ if (entry?.isIntersecting) {+ setIsPreviewVisible(true)+ observer.disconnect()+ }+ },+ { rootMargin: "700px" }+ )++ observer.observe(root)++ return () => observer.disconnect()+ }, [isPreviewVisible])+return (- <article id={block.id} className="space-y-3">+ <article ref={rootRef} id={block.id} className="space-y-3"><divclassName={["flex flex-col gap-3 sm:flex-row sm:items-end",@@ -139,7 +218,7 @@ function PdfViewerBlockPreview({</div></div><div className="bg-background">- <Preview key={previewKey} />+ {isPreviewVisible ? <Preview key={previewKey} /> : <PreviewLoading />}</div></div></article>diff --git a/apps/v4/components/pdf-viewer-docs.tsx b/apps/v4/components/pdf-viewer-docs.tsxindex 61d75c9..9d8fa1c 100644--- a/apps/v4/components/pdf-viewer-docs.tsx+++ b/apps/v4/components/pdf-viewer-docs.tsx@@ -173,314 +173,335 @@ const PdfViewerPreview = dynamic(const pdfViewerUsageCode = `"use client";-import { Button } from "@/components/ui/button";-import { Input } from "@/components/ui/input";-import { ScrollArea } from "@/components/ui/scroll-area";+import { PDFViewer } from "@/components/ui/pdf-viewer";++export function PdfViewerExample() {+ return <PDFViewer className="h-[640px]" />;+}`++const pdfViewerSourceCode = `"use client"++import * as React from "react"+import {+ Loading03Icon,+ MinusSignCircleIcon,+ PlusSignCircleIcon,+ RotateClockwiseIcon,+ Search01Icon,+ SidebarLeftIcon,+ Upload01Icon,+} from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"+import type * as ReactPdf from "react-pdf"++import { cn } from "@/lib/utils"+import { Button } from "@/components/ui/button"+import { ScrollArea } from "@/components/ui/scroll-area"+import { Input } from "@/registry/new-york-v4/ui/input"import {Popover,PopoverContent,PopoverTrigger,-} from "@/components/ui/popover";+} from "@/registry/new-york-v4/ui/popover"import {Select,SelectContent,SelectItem,SelectTrigger,SelectValue,-} from "@/components/ui/select";-import { Separator } from "@/components/ui/separator";+} from "@/registry/new-york-v4/ui/select"+import { Separator } from "@/registry/new-york-v4/ui/separator"import {Tooltip,TooltipContent,TooltipProvider,TooltipTrigger,-} from "@/components/ui/tooltip";-import { cn } from "@/lib/utils";-import {- Loading03Icon,- MinusSignCircleIcon,- PlusSignCircleIcon,- RotateClockwiseIcon,- Search01Icon,- SidebarLeftIcon,- Upload01Icon,-} from "@hugeicons/core-free-icons";-import { HugeiconsIcon } from "@hugeicons/react";-import {- memo,- useCallback,- useEffect,- useMemo,- useRef,- useState,- useSyncExternalStore,-} from "react";-import { Document, Page, pdfjs, Thumbnail } from "react-pdf";--pdfjs.GlobalWorkerOptions.workerSrc =- "https://unpkg.com/pdfjs-dist@" +- pdfjs.version +- "/legacy/build/pdf.worker.min.mjs";--const ZOOM_OPTIONS = [0.5, 0.75, 1, 1.25, 1.5, 2];-const DEFAULT_PDF_URL = "/path/to/document.pdf";-const PAGE_RENDER_BUFFER = 2;-const PAGE_BASE_WIDTH = 612;-const PAGE_BASE_HEIGHT = 792;-const MAX_DEVICE_PIXEL_RATIO = 2;-const THUMBNAIL_WIDTH = 92;-const DEFAULT_ZOOM = 0.75;--function createSearchStore() {- let draftValue = "";- let appliedValue = "";- const listeners = new Set<() => void>();-- return {- getSnapshot: () => appliedValue,- getDraftSnapshot: () => draftValue,- setDraftSnapshot: (nextValue: string) => {- draftValue = nextValue;- },- applyDraftSnapshot: () => {- if (draftValue === appliedValue) {- return;- }+} from "@/registry/new-york-v4/ui/tooltip"- appliedValue = draftValue;- listeners.forEach((listener) => listener());- },- clearSnapshot: () => {- if (!draftValue && !appliedValue) {- return;- }+type ReactPdfModule = typeof ReactPdf- draftValue = "";- appliedValue = "";- listeners.forEach((listener) => listener());- },- subscribe: (listener: () => void) => {- listeners.add(listener);+export type PDFViewerPageOverlayProps = {+ pageNumber: number+ pageWidth: number+ pageHeight: number+ scale: number+ rotation: number+}- return () => {- listeners.delete(listener);- };- },- };+export type PDFViewerHandle = {+ scrollToPage: (pageNumber: number, options?: ScrollIntoViewOptions) => void+ scrollToPageArea: (+ pageNumber: number,+ area: { top: number; left?: number; width?: number; height?: number },+ options?: ScrollToOptions+ ) => void+ getViewportElement: () => HTMLDivElement | null+}++export type PDFViewerProps = {+ file?: string+ className?: string+ defaultZoom?: number+ pageWidth?: number+ pageHeight?: number+ pageNumbers?: number[]+ pageRenderBuffer?: number+ showRotateControls?: boolean+ showUpload?: boolean+ toolbarActions?: React.ReactNode+ pageClassName?: (pageNumber: number) => string | undefined+ renderPageOverlay?: (props: PDFViewerPageOverlayProps) => React.ReactNode+ onActivePageChange?: (pageNumber: number) => void+ onDocumentLoadSuccess?: (numPages: number) => void+ onPdfUpload?: (file: File) => void+ onPagePointerDown?: (+ event: React.PointerEvent<HTMLDivElement>,+ pageNumber: number+ ) => void+ onPagePointerMove?: (+ event: React.PointerEvent<HTMLDivElement>,+ pageNumber: number+ ) => void+ onPagePointerUp?: (+ event: React.PointerEvent<HTMLDivElement>,+ pageNumber: number+ ) => void+ onPagePointerCancel?: (+ event: React.PointerEvent<HTMLDivElement>,+ pageNumber: number+ ) => void}-type SearchStore = ReturnType<typeof createSearchStore>;+const DEFAULT_FILE = "/samples/attention.pdf"+const DEFAULT_PAGE_WIDTH = 612+const DEFAULT_PAGE_HEIGHT = 792+const DEFAULT_ZOOM = 0.75+const ZOOM_OPTIONS = [0.5, 0.75, 1, 1.25, 1.5, 2]+const MAX_DEVICE_PIXEL_RATIO = 2+const DEFAULT_PAGE_RENDER_BUFFER = 2+const THUMBNAIL_WIDTH = 92+const PDF_WORKER_URL = new URL(+ "pdfjs-dist/legacy/build/pdf.worker.min.mjs",+ import.meta.url+).toString()type SearchHighlight = {- id: string;- left: number;- top: number;- width: number;- height: number;-};+ id: string+ left: number+ top: number+ width: number+ height: number+}-function SearchInput({- searchStore,+function ToolbarTooltip({+ label,+ children,}: {- searchStore: SearchStore;+ label: string+ children: React.ReactNode}) {- const [value, setValue] = useState(() => searchStore.getDraftSnapshot());+ return (+ <Tooltip>+ <TooltipTrigger asChild>+ <span className="inline-flex">{children}</span>+ </TooltipTrigger>+ <TooltipContent side="bottom">{label}</TooltipContent>+ </Tooltip>+ )+}+function SearchInput({+ value,+ onValueChange,+ onApply,+ onClear,+}: {+ value: string+ onValueChange: (value: string) => void+ onApply: () => void+ onClear: () => void+}) {return (<div className="space-y-3"><Inputplaceholder="Search text"value={value}- onChange={(event) => {- const nextValue = event.target.value;- setValue(nextValue);- searchStore.setDraftSnapshot(nextValue);- }}- onKeyDown={(event) => {+ onChange={(event: React.ChangeEvent<HTMLInputElement>) =>+ onValueChange(event.target.value)+ }+ onKeyDown={(event: React.KeyboardEvent<HTMLInputElement>) => {if (event.key === "Enter") {- searchStore.applyDraftSnapshot();+ onApply()}}}/><div className="flex justify-end gap-2">- <Button- type="button"- variant="outline"- size="sm"- onClick={() => {- setValue("");- searchStore.clearSnapshot();- }}- >+ <Button type="button" variant="outline" size="sm" onClick={onClear}>Clear</Button>- <Button- type="button"- size="sm"- onClick={() => {- searchStore.setDraftSnapshot(value);- searchStore.applyDraftSnapshot();- }}- >+ <Button type="button" size="sm" onClick={onApply}>Search</Button></div></div>- );-}--function ToolbarTooltip({- label,- children,-}: {- label: string;- children: React.ReactNode;-}) {- return (- <Tooltip>- <TooltipTrigger asChild>- <span className="inline-flex">{children}</span>- </TooltipTrigger>- <TooltipContent side="bottom">{label}</TooltipContent>- </Tooltip>- );+ )}-const PdfPage = memo(function PdfPage({+function PDFViewerPage({+ reactPdf,pageNumber,+ pageStyle,+ renderedPageWidth,+ zoom,rotation,- scale,- searchQuery,shouldRenderPage,- onFirstPageRender,+ searchQuery,+ isFirstRenderedPage,+ pageClassName,+ renderPageOverlay,+ onFirstPageSettled,+ onPagePointerDown,+ onPagePointerMove,+ onPagePointerUp,+ onPagePointerCancel,}: {- pageNumber: number;- rotation: number;- scale: number;- searchQuery: string;- shouldRenderPage: boolean;- onFirstPageRender: () => void;+ reactPdf: ReactPdfModule+ pageNumber: number+ pageStyle: React.CSSProperties & { width: number; height: number }+ renderedPageWidth: number+ zoom: number+ rotation: number+ shouldRenderPage: boolean+ searchQuery: string+ isFirstRenderedPage: boolean+ pageClassName?: (pageNumber: number) => string | undefined+ renderPageOverlay?: (props: PDFViewerPageOverlayProps) => React.ReactNode+ onFirstPageSettled: () => void+ onPagePointerDown?: (+ event: React.PointerEvent<HTMLDivElement>,+ pageNumber: number+ ) => void+ onPagePointerMove?: (+ event: React.PointerEvent<HTMLDivElement>,+ pageNumber: number+ ) => void+ onPagePointerUp?: (+ event: React.PointerEvent<HTMLDivElement>,+ pageNumber: number+ ) => void+ onPagePointerCancel?: (+ event: React.PointerEvent<HTMLDivElement>,+ pageNumber: number+ ) => void}) {- const pageRef = useRef<HTMLDivElement>(null);- const [searchHighlights, setSearchHighlights] = useState<SearchHighlight[]>(- []- );- const isRotated = Math.abs(Math.round(rotation / 90)) % 2 === 1;- const hasSearchQuery = Boolean(searchQuery.trim());- const pageSize = {- width: (isRotated ? PAGE_BASE_HEIGHT : PAGE_BASE_WIDTH) * scale,- height: (isRotated ? PAGE_BASE_WIDTH : PAGE_BASE_HEIGHT) * scale,- };- const devicePixelRatio =- typeof window === "undefined"- ? 1- : Math.min(MAX_DEVICE_PIXEL_RATIO, window.devicePixelRatio || 1);-- const updateSearchHighlights = useCallback(() => {- const pageElement = pageRef.current;- const query = searchQuery.trim().toLowerCase();+ const pageRef = React.useRef<HTMLDivElement>(null)+ const [searchHighlights, setSearchHighlights] = React.useState<+ SearchHighlight[]+ >([])+ const hasSearchQuery = Boolean(searchQuery.trim())++ const updateSearchHighlights = React.useCallback(() => {+ const pageElement = pageRef.current+ const query = searchQuery.trim().toLowerCase()if (!pageElement || !query) {- setSearchHighlights([]);- return;+ setSearchHighlights([])+ return}const textLayer = pageElement.querySelector<HTMLElement>(".react-pdf__Page__textContent"- );+ )if (!textLayer) {- setSearchHighlights([]);- return;+ setSearchHighlights([])+ return}- const pageRect = pageElement.getBoundingClientRect();- const nextHighlights: SearchHighlight[] = [];+ const pageRect = pageElement.getBoundingClientRect()+ const nextHighlights: SearchHighlight[] = []textLayer.querySelectorAll<HTMLElement>("span").forEach((span, index) => {const textNode = Array.from(span.childNodes).find((node): node is Text => node.nodeType === Node.TEXT_NODE- );- const text = textNode?.textContent ?? "";- const normalizedText = text.toLowerCase();- let matchIndex = normalizedText.indexOf(query);+ )+ const text = textNode?.textContent ?? ""+ const normalizedText = text.toLowerCase()+ let matchIndex = normalizedText.indexOf(query)while (textNode && matchIndex !== -1) {- const range = document.createRange();- range.setStart(textNode, matchIndex);- range.setEnd(textNode, matchIndex + query.length);+ const range = document.createRange()+ range.setStart(textNode, matchIndex)+ range.setEnd(textNode, matchIndex + query.length)Array.from(range.getClientRects()).forEach((rect, rectIndex) => {- if (rect.width <= 0 || rect.height <= 0) {- return;- }+ if (rect.width <= 0 || rect.height <= 0) returnnextHighlights.push({- id: pageNumber + "-" + index + "-" + matchIndex + "-" + rectIndex,+ id: \`\${pageNumber}-\${index}-\${matchIndex}-\${rectIndex}\`,left: rect.left - pageRect.left,top: rect.top - pageRect.top,width: rect.width,height: rect.height,- });- });+ })+ })- range.detach();- matchIndex = normalizedText.indexOf(query, matchIndex + query.length);+ range.detach()+ matchIndex = normalizedText.indexOf(query, matchIndex + query.length)}- });+ })- setSearchHighlights(nextHighlights);- }, [pageNumber, searchQuery]);+ setSearchHighlights(nextHighlights)+ }, [pageNumber, searchQuery])- useEffect(() => {+ React.useEffect(() => {if (!shouldRenderPage || !hasSearchQuery) {- setSearchHighlights([]);- return;+ setSearchHighlights([])+ return}- const frame = window.requestAnimationFrame(updateSearchHighlights);- return () => window.cancelAnimationFrame(frame);- }, [hasSearchQuery, shouldRenderPage, updateSearchHighlights]);+ const frame = window.requestAnimationFrame(updateSearchHighlights)+ return () => window.cancelAnimationFrame(frame)+ }, [hasSearchQuery, shouldRenderPage, updateSearchHighlights])return (<divref={pageRef}- data-page-number={pageNumber}- className="relative"- style={pageSize}+ data-pdf-viewer-page={pageNumber}+ className={cn("relative", pageClassName?.(pageNumber))}+ style={pageStyle}+ onPointerDown={(event) => onPagePointerDown?.(event, pageNumber)}+ onPointerMove={(event) => onPagePointerMove?.(event, pageNumber)}+ onPointerUp={(event) => onPagePointerUp?.(event, pageNumber)}+ onPointerCancel={(event) => onPagePointerCancel?.(event, pageNumber)}>{shouldRenderPage ? (<>- <Page+ <reactPdf.PagepageNumber={pageNumber}+ width={renderedPageWidth}+ rotate={rotation}className="overflow-hidden border bg-background shadow-xs"renderAnnotationLayer={false}renderTextLayer={hasSearchQuery}- devicePixelRatio={devicePixelRatio}- rotate={rotation}- scale={scale}+ devicePixelRatio={+ typeof window === "undefined"+ ? 1+ : Math.min(MAX_DEVICE_PIXEL_RATIO, window.devicePixelRatio || 1)+ }loading={- <div- style={pageSize}- className="flex items-center justify-center"- >+ <div className="grid place-items-center" style={pageStyle}><HugeiconsIconicon={Loading03Icon}className="size-4 animate-spin"/></div>}- onRenderSuccess={() => {- if (pageNumber === 1) {- onFirstPageRender();- }- }}+ onRenderSuccess={+ isFirstRenderedPage ? onFirstPageSettled : undefined+ }onRenderTextLayerSuccess={updateSearchHighlights}- onRenderError={() => {- if (pageNumber === 1) {- onFirstPageRender();- }- }}+ onRenderError={isFirstRenderedPage ? onFirstPageSettled : undefined}/>{searchHighlights.length ? (<div className="pointer-events-none absolute inset-0 z-10">@@ -502,470 +523,650 @@ const PdfPage = memo(function PdfPage({) : (<div className="size-full border bg-muted/30 shadow-xs" />)}+ {renderPageOverlay?.({+ pageNumber,+ pageWidth: pageStyle.width,+ pageHeight: pageStyle.height,+ scale: zoom,+ rotation,+ })}</div>- );-});--const PdfPages = memo(function PdfPages({- pageNumbers,- currentPage,- rotation,- scale,- searchStore,- onFirstPageRender,-}: {- pageNumbers: number[];- currentPage: number;- rotation: number;- scale: number;- searchStore: SearchStore;- onFirstPageRender: () => void;-}) {- const searchQuery = useSyncExternalStore(- searchStore.subscribe,- searchStore.getSnapshot,- searchStore.getSnapshot- );- const hasSearchQuery = Boolean(searchQuery.trim());+ )+}- return (- <>- {pageNumbers.map((pageNumber) => (- <PdfPage- key={pageNumber}- pageNumber={pageNumber}- rotation={rotation}- scale={scale}- shouldRenderPage={- Math.abs(pageNumber - currentPage) <= PAGE_RENDER_BUFFER+export const PDFViewer = React.forwardRef<PDFViewerHandle, PDFViewerProps>(+ function PDFViewer(+ {+ file = DEFAULT_FILE,+ className,+ defaultZoom = DEFAULT_ZOOM,+ pageWidth = DEFAULT_PAGE_WIDTH,+ pageHeight = DEFAULT_PAGE_HEIGHT,+ pageNumbers,+ pageRenderBuffer = DEFAULT_PAGE_RENDER_BUFFER,+ showRotateControls = true,+ showUpload = true,+ toolbarActions,+ pageClassName,+ renderPageOverlay,+ onActivePageChange,+ onDocumentLoadSuccess,+ onPdfUpload,+ onPagePointerDown,+ onPagePointerMove,+ onPagePointerUp,+ onPagePointerCancel,+ },+ ref+ ) {+ const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null)+ const [pdfFile, setPdfFile] = React.useState(file)+ const [uploadedPdfUrl, setUploadedPdfUrl] = React.useState<string | null>(+ null+ )+ const [numPages, setNumPages] = React.useState(0)+ const [activePage, setActivePage] = React.useState(1)+ const [zoom, setZoom] = React.useState(defaultZoom)+ const [rotation, setRotation] = React.useState(0)+ const [sidebarOpen, setSidebarOpen] = React.useState(true)+ const [searchDraft, setSearchDraft] = React.useState("")+ const [searchQuery, setSearchQuery] = React.useState("")+ const [isDocumentLoading, setIsDocumentLoading] = React.useState(true)+ const [isFirstPageRendering, setIsFirstPageRendering] = React.useState(true)+ const [loadError, setLoadError] = React.useState(false)+ const viewportRef = React.useRef<HTMLDivElement>(null)+ const thumbnailClickScrollYRef = React.useRef<number | null>(null)++ React.useEffect(() => {+ setPdfFile(file)+ }, [file])++ React.useEffect(() => {+ let mounted = true++ void import("react-pdf")+ .then((module) => {+ module.pdfjs.GlobalWorkerOptions.workerSrc = PDF_WORKER_URL++ if (mounted) {+ setReactPdf(module)}- searchQuery={- hasSearchQuery && Math.abs(pageNumber - currentPage) <= 1- ? searchQuery- : ""+ })+ .catch(() => {+ if (mounted) {+ setLoadError(true)+ setIsDocumentLoading(false)+ setIsFirstPageRendering(false)}- onFirstPageRender={onFirstPageRender}- />- ))}- </>- );-});--function Component({ url = DEFAULT_PDF_URL }: { url?: string }) {- const [numPages, setNumPages] = useState<number | null>(null);- const [currentPage, setCurrentPage] = useState(1);- const [zoom, setZoom] = useState(DEFAULT_ZOOM);- const [rotation, setRotation] = useState(0);- const [sidebarOpen, setSidebarOpen] = useState(true);- const [fileUrl, setFileUrl] = useState(url);- const [isDocumentLoading, setIsDocumentLoading] = useState(true);- const [isPageRendering, setIsPageRendering] = useState(true);- const [loadError, setLoadError] = useState(false);- const fileInputRef = useRef<HTMLInputElement>(null);- const thumbnailClickScrollYRef = useRef<number | null>(null);- const viewportRef = useRef<HTMLDivElement>(null);- const searchStore = useMemo(() => createSearchStore(), []);-- const handleFirstPageRender = useCallback(() => {- setIsPageRendering(false);- }, []);- const handleDocumentLoadStart = useCallback(() => {- setIsDocumentLoading(true);- setIsPageRendering(true);- setLoadError(false);- setNumPages(null);- setCurrentPage(1);- viewportRef.current?.scrollTo({ top: 0, left: 0 });- }, []);- const handleDocumentLoadSuccess = useCallback(- ({ numPages }: { numPages: number }) => {- setNumPages(numPages);- setCurrentPage(1);- setIsDocumentLoading(false);- setIsPageRendering(true);- setLoadError(false);- viewportRef.current?.scrollTo({ top: 0, left: 0 });- },- []- );- const handleDocumentLoadError = useCallback(() => {- setIsDocumentLoading(false);- setIsPageRendering(false);- setLoadError(true);- setNumPages(null);- }, []);-- const pageNumbers = useMemo(() => {- return Array.from({ length: numPages ?? 0 }, (_, index) => index + 1);- }, [numPages]);- const thumbnailIsRotated = Math.abs(Math.round(rotation / 90)) % 2 === 1;- const thumbnailSize = {- width: THUMBNAIL_WIDTH,- height: Math.round(- THUMBNAIL_WIDTH *- (thumbnailIsRotated- ? PAGE_BASE_WIDTH / PAGE_BASE_HEIGHT- : PAGE_BASE_HEIGHT / PAGE_BASE_WIDTH)- ),- };- const isViewerLoading = isDocumentLoading || isPageRendering;- const controlsDisabled = isViewerLoading || loadError || !numPages;-- const updateCurrentPageFromViewport = useCallback(() => {- const viewport = viewportRef.current;- if (!viewport || !numPages) {- return;- }-- const viewportRect = viewport.getBoundingClientRect();- const viewportCenter = viewportRect.top + viewportRect.height / 2;- let closestPage = 1;- let closestDistance = Number.POSITIVE_INFINITY;+ })- viewport.querySelectorAll<HTMLElement>("[data-page-number]").forEach((page) => {- const pageRect = page.getBoundingClientRect();- const pageCenter = pageRect.top + pageRect.height / 2;- const distance = Math.abs(pageCenter - viewportCenter);-- if (distance < closestDistance) {- closestDistance = distance;- closestPage = Number(page.dataset.pageNumber || "1");+ return () => {+ mounted = false}- });+ }, [])- setCurrentPage((page) => (page === closestPage ? page : closestPage));- }, [numPages]);-- useEffect(() => {- return () => {- if (fileUrl.startsWith("blob:")) {- URL.revokeObjectURL(fileUrl);+ React.useEffect(() => {+ return () => {+ if (uploadedPdfUrl) {+ URL.revokeObjectURL(uploadedPdfUrl)+ }}- };- }, [fileUrl]);-- useEffect(() => {- const viewport = viewportRef.current;- if (!viewport || !numPages) {- return;+ }, [uploadedPdfUrl])++ const renderedPageNumbers = React.useMemo(() => {+ if (pageNumbers?.length) return pageNumbers++ return Array.from({ length: numPages || 1 }, (_, index) => index + 1)+ }, [numPages, pageNumbers])++ const firstRenderedPage = renderedPageNumbers[0] ?? 1+ const isRotated = Math.abs(Math.round(rotation / 90)) % 2 === 1+ const renderedPageWidth = (isRotated ? pageHeight : pageWidth) * zoom+ const renderedPageHeight = (isRotated ? pageWidth : pageHeight) * zoom+ const controlsDisabled = !reactPdf || !numPages+ const isLoading = !reactPdf || isDocumentLoading || isFirstPageRendering+ const thumbnailIsRotated = Math.abs(Math.round(rotation / 90)) % 2 === 1+ const thumbnailSize = {+ width: THUMBNAIL_WIDTH,+ height: Math.round(+ THUMBNAIL_WIDTH *+ (thumbnailIsRotated ? pageWidth / pageHeight : pageHeight / pageWidth)+ ),}- let frameId = 0;- const handleScroll = () => {- window.cancelAnimationFrame(frameId);- frameId = window.requestAnimationFrame(updateCurrentPageFromViewport);- };-- frameId = window.requestAnimationFrame(updateCurrentPageFromViewport);- viewport.addEventListener("scroll", handleScroll, { passive: true });-- return () => {- window.cancelAnimationFrame(frameId);- viewport.removeEventListener("scroll", handleScroll);- };- }, [numPages, rotation, updateCurrentPageFromViewport, zoom]);-- function restoreWindowScroll(scrollY: number) {- window.scrollTo({ top: scrollY });- window.requestAnimationFrame(() => {- window.scrollTo({ top: scrollY });- window.requestAnimationFrame(() => {- window.scrollTo({ top: scrollY });- });- });- [0, 50, 150, 300].forEach((delay) => {- window.setTimeout(() => {- window.scrollTo({ top: scrollY });- }, delay);- });- }-- function scrollToPage(pageNumber: number) {- const windowScrollY = thumbnailClickScrollYRef.current ?? window.scrollY;- setCurrentPage(pageNumber);-- const viewport = viewportRef.current;- const page = viewport?.querySelector<HTMLElement>(- '[data-page-number="' + pageNumber + '"]'- );-- if (!viewport || !page) {- restoreWindowScroll(windowScrollY);- return;- }-- viewport.scrollTo({- top:- page.getBoundingClientRect().top -- viewport.getBoundingClientRect().top +- viewport.scrollTop -- 24,- behavior: "auto",- });- restoreWindowScroll(windowScrollY);- window.setTimeout(() => {- if (thumbnailClickScrollYRef.current === windowScrollY) {- thumbnailClickScrollYRef.current = null;+ const updateActivePageFromViewport = React.useCallback(() => {+ const viewport = viewportRef.current+ if (!viewport || !renderedPageNumbers.length) return++ const viewportRect = viewport.getBoundingClientRect()+ const viewportCenter = viewportRect.top + viewportRect.height / 2+ let closestPage = renderedPageNumbers[0] ?? 1+ let closestDistance = Number.POSITIVE_INFINITY++ viewport+ .querySelectorAll<HTMLElement>("[data-pdf-viewer-page]")+ .forEach((page) => {+ const pageRect = page.getBoundingClientRect()+ const pageCenter = pageRect.top + pageRect.height / 2+ const distance = Math.abs(pageCenter - viewportCenter)++ if (distance < closestDistance) {+ closestDistance = distance+ closestPage = Number(page.dataset.pdfViewerPage || "1")+ }+ })++ setActivePage((currentPage) => {+ if (currentPage === closestPage) return currentPage+ onActivePageChange?.(closestPage)+ return closestPage+ })+ }, [onActivePageChange, renderedPageNumbers])++ React.useEffect(() => {+ const viewport = viewportRef.current+ if (!viewport || !numPages) return++ let frameId = 0+ const handleScroll = () => {+ window.cancelAnimationFrame(frameId)+ frameId = window.requestAnimationFrame(updateActivePageFromViewport)}- }, 350);- }-- function preserveThumbnailClickScroll(event: React.PointerEvent | React.MouseEvent) {- event.preventDefault();- if (thumbnailClickScrollYRef.current === null) {- thumbnailClickScrollYRef.current = window.scrollY;- }- }+ frameId = window.requestAnimationFrame(updateActivePageFromViewport)+ viewport.addEventListener("scroll", handleScroll, { passive: true })- return (- <div- data-slot="pdf-viewer"- data-loading={isViewerLoading}- className="flex h-[560px] w-full flex-col overflow-hidden bg-background [overflow-anchor:none]"- >- <div className="flex min-h-12 items-center justify-between gap-3 border-b px-3">- <div className="flex items-center gap-2">- <TooltipProvider>- <ToolbarTooltip label="Toggle thumbnails">- <Button- variant="ghost"- size="icon-sm"- aria-label="Toggle thumbnails"- disabled={controlsDisabled}- onClick={() => setSidebarOpen((open) => !open)}- >- <HugeiconsIcon icon={SidebarLeftIcon} className="size-4" />- </Button>- </ToolbarTooltip>- </TooltipProvider>- <div className="text-sm whitespace-nowrap text-primary">- Page {currentPage} of {numPages ?? "-"}- </div>- </div>- <TooltipProvider>- <div className="flex min-w-0 items-center gap-1">- <input- ref={fileInputRef}- type="file"- accept="application/pdf,.pdf"- className="sr-only"- onChange={(event) => {- const file = event.target.files?.[0];- if (!file) return;-- setFileUrl((previousUrl) => {- if (previousUrl.startsWith("blob:")) {- URL.revokeObjectURL(previousUrl);- }-- return URL.createObjectURL(file);- });- event.target.value = "";- }}- />- <ToolbarTooltip label="Rotate counterclockwise">- <Button- variant="ghost"- size="icon-sm"- aria-label="Rotate counterclockwise"- disabled={controlsDisabled}- onClick={() => setRotation((value) => value - 90)}- >- <HugeiconsIcon- icon={RotateClockwiseIcon}- className="size-4 -scale-x-100"- />- </Button>- </ToolbarTooltip>- <ToolbarTooltip label="Rotate clockwise">- <Button- variant="ghost"- size="icon-sm"- aria-label="Rotate clockwise"- disabled={controlsDisabled}- onClick={() => setRotation((value) => value + 90)}- >- <HugeiconsIcon icon={RotateClockwiseIcon} className="size-4" />- </Button>- </ToolbarTooltip>- <Separator- orientation="vertical"- className="mx-1 h-4 self-center"- />- <ToolbarTooltip label="Zoom out">- <Button- variant="ghost"- size="icon-sm"- aria-label="Zoom out"- disabled={controlsDisabled || zoom <= ZOOM_OPTIONS[0]}- onClick={() => setZoom((value) => Math.max(0.5, value - 0.25))}- >- <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />- </Button>- </ToolbarTooltip>- <Select- value={zoom.toString()}- onValueChange={(value) => setZoom(Number(value))}- disabled={controlsDisabled}- >- <div className="hidden sm:block">- <SelectTrigger size="sm" className="w-[84px] min-w-[84px]">- <SelectValue placeholder="Zoom">{zoom * 100 + "%"}</SelectValue>- </SelectTrigger>- </div>- <SelectContent align="end">- {ZOOM_OPTIONS.map((option) => (- <SelectItem key={option} value={option.toString()}>- {option * 100 + "%"}- </SelectItem>- ))}- </SelectContent>- </Select>- <ToolbarTooltip label="Zoom in">- <Button- variant="ghost"- size="icon-sm"- aria-label="Zoom in"- disabled={- controlsDisabled ||- zoom >= ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]- }- onClick={() => setZoom((value) => Math.min(2, value + 0.25))}- >- <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />- </Button>- </ToolbarTooltip>- <Separator- orientation="vertical"- className="mx-1 h-4 self-center"- />- <Popover>- <ToolbarTooltip label="Search text">- <PopoverTrigger asChild>+ return () => {+ window.cancelAnimationFrame(frameId)+ viewport.removeEventListener("scroll", handleScroll)+ }+ }, [numPages, updateActivePageFromViewport])++ React.useImperativeHandle(+ ref,+ () => ({+ scrollToPage: (pageNumber, options) => {+ const page = viewportRef.current?.querySelector<HTMLElement>(+ \`[data-pdf-viewer-page="\${pageNumber}"]\`+ )++ page?.scrollIntoView({+ block: "start",+ inline: "nearest",+ ...options,+ })+ },+ scrollToPageArea: (pageNumber, area, options) => {+ const viewport = viewportRef.current+ const page = viewport?.querySelector<HTMLElement>(+ \`[data-pdf-viewer-page="\${pageNumber}"]\`+ )++ if (!viewport || !page) return++ const pageTop =+ page.getBoundingClientRect().top -+ viewport.getBoundingClientRect().top ++ viewport.scrollTop+ const targetTop =+ pageTop ++ (area.top / 100) * page.getBoundingClientRect().height -+ 96++ viewport.scrollTo({+ top: Math.max(0, targetTop),+ behavior: "smooth",+ ...options,+ })+ },+ getViewportElement: () => viewportRef.current,+ }),+ []+ )++ const restoreWindowScroll = React.useCallback((scrollY: number) => {+ window.scrollTo({ top: scrollY })+ window.requestAnimationFrame(() => {+ window.scrollTo({ top: scrollY })+ window.requestAnimationFrame(() => {+ window.scrollTo({ top: scrollY })+ })+ })+ ;[0, 50, 150, 300].forEach((delay) => {+ window.setTimeout(() => {+ window.scrollTo({ top: scrollY })+ }, delay)+ })+ }, [])++ const scrollToPage = React.useCallback(+ (pageNumber: number) => {+ const windowScrollY = thumbnailClickScrollYRef.current ?? window.scrollY+ setActivePage(pageNumber)++ const viewport = viewportRef.current+ const page = viewport?.querySelector<HTMLElement>(+ \`[data-pdf-viewer-page="\${pageNumber}"]\`+ )++ if (!viewport || !page) {+ restoreWindowScroll(windowScrollY)+ return+ }++ viewport.scrollTo({+ top:+ page.getBoundingClientRect().top -+ viewport.getBoundingClientRect().top ++ viewport.scrollTop -+ 24,+ behavior: "auto",+ })+ restoreWindowScroll(windowScrollY)+ window.setTimeout(() => {+ if (thumbnailClickScrollYRef.current === windowScrollY) {+ thumbnailClickScrollYRef.current = null+ }+ }, 350)+ },+ [restoreWindowScroll]+ )++ const preserveThumbnailClickScroll = React.useCallback(+ (event: React.PointerEvent | React.MouseEvent) => {+ event.preventDefault()++ if (thumbnailClickScrollYRef.current === null) {+ thumbnailClickScrollYRef.current = window.scrollY+ }+ },+ []+ )++ const handleLoadStart = React.useCallback(() => {+ setIsDocumentLoading(true)+ setIsFirstPageRendering(true)+ setLoadError(false)+ setNumPages(0)+ setActivePage(1)+ onActivePageChange?.(1)+ setSearchQuery("")+ setSearchDraft("")+ viewportRef.current?.scrollTo({ top: 0, left: 0 })+ }, [onActivePageChange])++ const handleLoadSuccess = React.useCallback(+ ({ numPages: nextNumPages }: { numPages: number }) => {+ setNumPages(nextNumPages)+ setIsDocumentLoading(false)+ setIsFirstPageRendering(true)+ setLoadError(false)+ setActivePage(1)+ onActivePageChange?.(1)+ onDocumentLoadSuccess?.(nextNumPages)+ setSearchQuery("")+ setSearchDraft("")+ viewportRef.current?.scrollTo({ top: 0, left: 0 })+ },+ [onActivePageChange, onDocumentLoadSuccess]+ )++ const handleLoadError = React.useCallback(() => {+ setIsDocumentLoading(false)+ setIsFirstPageRendering(false)+ setLoadError(true)+ setNumPages(0)+ }, [])++ const handleUpload = React.useCallback(+ (file: File) => {+ const nextUrl = URL.createObjectURL(file)++ setUploadedPdfUrl((previousUrl) => {+ if (previousUrl) URL.revokeObjectURL(previousUrl)+ return nextUrl+ })+ setPdfFile(nextUrl)+ onPdfUpload?.(file)+ },+ [onPdfUpload]+ )++ return (+ <div+ data-slot="pdf-viewer"+ className={cn(+ "flex h-full max-h-full min-h-0 w-full flex-col overflow-hidden bg-background",+ className+ )}+ >+ <div className="flex min-h-12 items-center justify-between gap-3 border-b px-3">+ <div className="flex items-center gap-2">+ <TooltipProvider>+ <ToolbarTooltip label="Toggle thumbnails"><Button+ type="button"variant="ghost"size="icon-sm"- aria-label="Search text"+ aria-label="Toggle thumbnails"disabled={controlsDisabled}+ onClick={() => setSidebarOpen((open) => !open)}>- <HugeiconsIcon icon={Search01Icon} className="size-4" />+ <HugeiconsIcon icon={SidebarLeftIcon} className="size-4" /></Button>- </PopoverTrigger>- </ToolbarTooltip>- <PopoverContent align="end" className="w-64">- <SearchInput searchStore={searchStore} />- </PopoverContent>- </Popover>- <ToolbarTooltip label="Upload PDF">- <Button- variant="ghost"- size="icon-sm"- aria-label="Upload PDF"- disabled={isViewerLoading}- onClick={() => fileInputRef.current?.click()}- >- <HugeiconsIcon icon={Upload01Icon} className="size-4" />- </Button>- </ToolbarTooltip>- </div>- </TooltipProvider>- </div>-- <div className="relative flex h-full min-h-0 w-full flex-1">- {isViewerLoading && !loadError ? (- <div className="absolute inset-0 z-10 grid place-items-center bg-background">- <HugeiconsIcon icon={Loading03Icon} className="size-4 animate-spin" />- </div>- ) : null}- {loadError ? (- <div className="absolute inset-0 z-10 grid place-items-center bg-background p-6 text-sm text-muted-foreground">- Unable to load the PDF preview.+ </ToolbarTooltip>+ </TooltipProvider>+ <div className="text-sm whitespace-nowrap text-primary">+ Page {activePage} of {numPages || "-"}+ </div></div>- ) : null}- <Document- key={fileUrl}- file={fileUrl}- onLoadStart={handleDocumentLoadStart}- onLoadSuccess={handleDocumentLoadSuccess}- onLoadError={handleDocumentLoadError}- className={cn(- "flex h-full min-h-0 w-full flex-1",- (isViewerLoading || loadError) && "invisible"- )}- loading={null}- error={null}- >- <div className="flex h-full min-h-0 w-full flex-1">- <aside- className={cn(- "hidden w-40 shrink-0 overflow-hidden border-r bg-sidebar transition-[margin-left,border-color] duration-200 ease-out md:block",- sidebarOpen && !isViewerLoading && !loadError- ? "ml-0"- : "-ml-40 border-r-0"- )}- >- <ScrollArea className="h-full" scrollFade>- <div className="p-4">- <div className="flex flex-col items-center gap-3">- {pageNumbers.map((pageNumber) => (+ <TooltipProvider>+ <div className="flex min-w-0 items-center gap-1">+ {showRotateControls ? (+ <>+ <ToolbarTooltip label="Rotate counterclockwise"><Button+ type="button"variant="ghost"- size="sm"- key={pageNumber}- className={cn(- "!h-auto w-full flex-col items-center gap-2 p-2 text-xs text-muted-foreground shadow-none hover:bg-sidebar-accent",- pageNumber === currentPage && "bg-sidebar-accent"- )}- onFocus={(event) => event.currentTarget.blur()}- onMouseDown={preserveThumbnailClickScroll}- onPointerDown={preserveThumbnailClickScroll}- onClick={() => scrollToPage(pageNumber)}+ size="icon-sm"+ aria-label="Rotate counterclockwise"+ disabled={controlsDisabled}+ onClick={() => setRotation((value) => value - 90)}>- <div- className="shrink-0 overflow-hidden border bg-background shadow-xs"- style={thumbnailSize}- >- <Thumbnail- pageNumber={pageNumber}- className="flex size-full items-center justify-center [&_.react-pdf__Thumbnail__page]:!m-0 [&_.react-pdf__Thumbnail__page]:!h-auto [&_.react-pdf__Thumbnail__page]:!w-full [&_.react-pdf__Thumbnail__page]:overflow-hidden [&_canvas]:!h-auto [&_canvas]:!w-full"- width={THUMBNAIL_WIDTH}- rotate={rotation}- />- </div>- {pageNumber}+ <HugeiconsIcon+ icon={RotateClockwiseIcon}+ className="size-4 -scale-x-100"+ />+ </Button>+ </ToolbarTooltip>+ <ToolbarTooltip label="Rotate clockwise">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Rotate clockwise"+ disabled={controlsDisabled}+ onClick={() => setRotation((value) => value + 90)}+ >+ <HugeiconsIcon+ icon={RotateClockwiseIcon}+ className="size-4"+ /></Button>+ </ToolbarTooltip>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ </>+ ) : null}+ <ToolbarTooltip label="Zoom out">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Zoom out"+ disabled={controlsDisabled || zoom <= ZOOM_OPTIONS[0]}+ onClick={() => {+ const currentIndex = ZOOM_OPTIONS.indexOf(zoom)+ setZoom(ZOOM_OPTIONS[Math.max(0, currentIndex - 1)] ?? zoom)+ }}+ >+ <HugeiconsIcon+ icon={MinusSignCircleIcon}+ className="size-4"+ />+ </Button>+ </ToolbarTooltip>+ <Select+ value={String(zoom)}+ onValueChange={(value) => setZoom(Number(value))}+ disabled={controlsDisabled}+ >+ <SelectTrigger size="sm" className="w-[84px] min-w-[84px]">+ <SelectValue placeholder="Zoom">+ {Math.round(zoom * 100)}%+ </SelectValue>+ </SelectTrigger>+ <SelectContent>+ {ZOOM_OPTIONS.map((option) => (+ <SelectItem key={option} value={String(option)}>+ {Math.round(option * 100)}%+ </SelectItem>))}- </div>- </div>- </ScrollArea>- </aside>- <ScrollArea- className="min-h-0 min-w-0 flex-1"- viewportClassName={cn(- isPageRendering && !loadError && "invisible"- )}- viewportRef={viewportRef}- >- <div className="flex min-h-full w-max min-w-full flex-col items-center justify-start gap-6 p-6">- <PdfPages- pageNumbers={pageNumbers}- currentPage={currentPage}- rotation={rotation}- scale={zoom}- searchStore={searchStore}- onFirstPageRender={handleFirstPageRender}+ </SelectContent>+ </Select>+ <ToolbarTooltip label="Zoom in">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Zoom in"+ disabled={+ controlsDisabled ||+ zoom >= ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]+ }+ onClick={() => {+ const currentIndex = ZOOM_OPTIONS.indexOf(zoom)+ setZoom(+ ZOOM_OPTIONS[+ Math.min(ZOOM_OPTIONS.length - 1, currentIndex + 1)+ ] ?? zoom+ )+ }}+ >+ <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ <Popover>+ <ToolbarTooltip label="Search text">+ <PopoverTrigger asChild>+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Search text"+ disabled={controlsDisabled}+ >+ <HugeiconsIcon icon={Search01Icon} className="size-4" />+ </Button>+ </PopoverTrigger>+ </ToolbarTooltip>+ <PopoverContent align="end" className="w-64">+ <SearchInput+ value={searchDraft}+ onValueChange={setSearchDraft}+ onApply={() => setSearchQuery(searchDraft)}+ onClear={() => {+ setSearchDraft("")+ setSearchQuery("")+ }}+ />+ </PopoverContent>+ </Popover>+ {toolbarActions ? (+ <>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ {toolbarActions}+ </>+ ) : null}+ {showUpload ? (+ <>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ <ToolbarTooltip label="Upload PDF">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Upload PDF"+ render={+ <label>+ <input+ type="file"+ accept="application/pdf,.pdf"+ className="sr-only"+ onChange={(event) => {+ const nextFile = event.target.files?.[0]++ if (nextFile) {+ handleUpload(nextFile)+ event.currentTarget.value = ""+ }+ }}+ />+ <HugeiconsIcon+ icon={Upload01Icon}+ className="size-4"+ />+ </label>+ }+ />+ </ToolbarTooltip>+ </>+ ) : null}+ </div>+ </TooltipProvider>+ </div>+ <div className="relative flex min-h-0 flex-1 overflow-hidden bg-muted/30">+ {isLoading && !loadError ? (+ <div className="absolute inset-0 z-20 grid place-items-center bg-background">+ <HugeiconsIcon+ icon={Loading03Icon}+ className="size-4 animate-spin"/></div>- </ScrollArea>- </div>- </Document>+ ) : null}+ {loadError ? (+ <div className="absolute inset-0 z-20 grid place-items-center bg-background p-6 text-sm text-muted-foreground">+ Unable to load the PDF preview.+ </div>+ ) : null}+ {reactPdf ? (+ <reactPdf.Document+ file={pdfFile}+ className={cn(+ "flex h-full min-h-0 w-full flex-1",+ (isLoading || loadError) && "invisible"+ )}+ loading={null}+ error={null}+ onLoadStart={handleLoadStart}+ onLoadSuccess={handleLoadSuccess}+ onLoadError={handleLoadError}+ >+ <div className="flex h-full max-h-full min-h-0 w-full flex-1 overflow-hidden">+ <aside+ className={cn(+ "hidden w-40 shrink-0 overflow-hidden border-r bg-sidebar transition-[margin-left,border-color] duration-200 ease-out md:block",+ sidebarOpen && !isLoading && !loadError+ ? "ml-0"+ : "-ml-40 border-r-0"+ )}+ >+ <ScrollArea className="h-full" scrollFade>+ <div className="p-4">+ <div className="flex flex-col items-center gap-3">+ {renderedPageNumbers.map((pageNumber) => (+ <Button+ key={pageNumber}+ type="button"+ variant="ghost"+ size="sm"+ className={cn(+ "!h-auto w-full flex-col items-center gap-2 p-2 text-xs text-muted-foreground shadow-none hover:bg-sidebar-accent",+ pageNumber === activePage && "bg-sidebar-accent"+ )}+ onFocus={(event) => event.currentTarget.blur()}+ onMouseDown={preserveThumbnailClickScroll}+ onPointerDown={preserveThumbnailClickScroll}+ onClick={() => scrollToPage(pageNumber)}+ >+ <div+ className="shrink-0 overflow-hidden border bg-background shadow-xs"+ style={thumbnailSize}+ >+ <reactPdf.Thumbnail+ pageNumber={pageNumber}+ width={THUMBNAIL_WIDTH}+ rotate={rotation}+ className="flex size-full items-center justify-center [&_.react-pdf__Thumbnail__page]:!m-0 [&_.react-pdf__Thumbnail__page]:!h-auto [&_.react-pdf__Thumbnail__page]:!w-full [&_.react-pdf__Thumbnail__page]:overflow-hidden [&_canvas]:!h-auto [&_canvas]:!w-full"+ onItemClick={() => scrollToPage(pageNumber)}+ />+ </div>+ {pageNumber}+ </Button>+ ))}+ </div>+ </div>+ </ScrollArea>+ </aside>+ <ScrollArea+ className="h-full max-h-full min-h-0 min-w-0 flex-1"+ viewportClassName={cn(+ isFirstPageRendering && !loadError && "invisible"+ )}+ viewportRef={viewportRef}+ >+ <div className="flex min-h-full w-max min-w-full flex-col items-center justify-start gap-6 p-6">+ {renderedPageNumbers.map((pageNumber) => {+ const shouldRenderPage =+ Math.abs(pageNumber - activePage) <= pageRenderBuffer ||+ renderedPageNumbers.length <= pageRenderBuffer * 2 + 1+ const pageStyle = {+ width: renderedPageWidth,+ height: renderedPageHeight,+ }+ const pageSearchQuery =+ searchQuery.trim() &&+ Math.abs(pageNumber - activePage) <= 1+ ? searchQuery+ : ""++ return (+ <PDFViewerPage+ key={pageNumber}+ reactPdf={reactPdf}+ pageNumber={pageNumber}+ pageStyle={pageStyle}+ renderedPageWidth={renderedPageWidth}+ zoom={zoom}+ rotation={rotation}+ shouldRenderPage={shouldRenderPage}+ searchQuery={pageSearchQuery}+ isFirstRenderedPage={pageNumber === firstRenderedPage}+ pageClassName={pageClassName}+ renderPageOverlay={renderPageOverlay}+ onFirstPageSettled={() =>+ setIsFirstPageRendering(false)+ }+ onPagePointerDown={onPagePointerDown}+ onPagePointerMove={onPagePointerMove}+ onPagePointerUp={onPagePointerUp}+ onPagePointerCancel={onPagePointerCancel}+ />+ )+ })}+ </div>+ </ScrollArea>+ </div>+ </reactPdf.Document>+ ) : null}+ </div></div>- </div>- );-}--export { Component };`+ )+ }+)+`export function PdfViewerDemo() {const [isCodeVisible, setIsCodeVisible] = React.useState(false)@@ -1021,5 +1222,5 @@ export function PdfViewerDemo() {}export function PdfViewerSource() {- return <HighlightedCodeBlock code={pdfViewerUsageCode} />+ return <HighlightedCodeBlock code={pdfViewerSourceCode} />}diff --git a/apps/v4/components/pdf-viewer-preview-client.tsx b/apps/v4/components/pdf-viewer-preview-client.tsxindex a0f3930..223defc 100644--- a/apps/v4/components/pdf-viewer-preview-client.tsx+++ b/apps/v4/components/pdf-viewer-preview-client.tsx@@ -11,7 +11,7 @@ import {Upload01Icon,} from "@hugeicons/core-free-icons"import { HugeiconsIcon } from "@hugeicons/react"-import { Document, Page, pdfjs, Thumbnail } from "react-pdf"+import type * as ReactPdf from "react-pdf"import { cn } from "@/lib/utils"import { Button } from "@/components/ui/button"@@ -37,7 +37,7 @@ import {TooltipTrigger,} from "@/registry/new-york-v4/ui/tooltip"-pdfjs.GlobalWorkerOptions.workerSrc = `https://unpkg.com/pdfjs-dist@${pdfjs.version}/legacy/build/pdf.worker.min.mjs`+type ReactPdfModule = typeof ReactPdfconst ZOOM_OPTIONS = [0.5, 0.75, 1, 1.25, 1.5, 2]const SAMPLE_PDF_URL = "/samples/attention.pdf"@@ -47,6 +47,10 @@ const PAGE_BASE_HEIGHT = 792const MAX_DEVICE_PIXEL_RATIO = 2const THUMBNAIL_WIDTH = 92const DEFAULT_ZOOM = 0.75+const PDF_WORKER_URL = new URL(+ "pdfjs-dist/build/pdf.worker.min.mjs",+ import.meta.url+).toString()function createSearchStore() {let draftValue = ""@@ -160,6 +164,7 @@ function ToolbarTooltip({}const PdfPage = React.memo(function PdfPage({+ reactPdf,pageNumber,rotation,scale,@@ -167,6 +172,7 @@ const PdfPage = React.memo(function PdfPage({shouldRenderPage,onFirstPageRender,}: {+ reactPdf: ReactPdfModulepageNumber: numberrotation: numberscale: number@@ -264,7 +270,7 @@ const PdfPage = React.memo(function PdfPage({>{shouldRenderPage ? (<>- <Page+ <reactPdf.PagepageNumber={pageNumber}className="overflow-hidden border bg-background shadow-xs"renderAnnotationLayer={false}@@ -320,6 +326,7 @@ const PdfPage = React.memo(function PdfPage({})const PdfPages = React.memo(function PdfPages({+ reactPdf,pageNumbers,currentPage,rotation,@@ -327,6 +334,7 @@ const PdfPages = React.memo(function PdfPages({searchStore,onFirstPageRender,}: {+ reactPdf: ReactPdfModulepageNumbers: number[]currentPage: numberrotation: number@@ -346,6 +354,7 @@ const PdfPages = React.memo(function PdfPages({{pageNumbers.map((pageNumber) => (<PdfPagekey={pageNumber}+ reactPdf={reactPdf}pageNumber={pageNumber}rotation={rotation}scale={scale}@@ -365,6 +374,7 @@ const PdfPages = React.memo(function PdfPages({})export function PdfViewerPreviewClient() {+ const [reactPdf, setReactPdf] = React.useState<ReactPdfModule | null>(null)const [numPages, setNumPages] = React.useState<number | null>(null)const [currentPage, setCurrentPage] = React.useState(1)const [zoom, setZoom] = React.useState(DEFAULT_ZOOM)@@ -379,6 +389,30 @@ export function PdfViewerPreviewClient() {const viewportRef = React.useRef<HTMLDivElement>(null)const searchStore = React.useMemo(() => createSearchStore(), [])+ React.useEffect(() => {+ let mounted = true++ void import("react-pdf")+ .then((module) => {+ module.pdfjs.GlobalWorkerOptions.workerSrc = PDF_WORKER_URL++ if (mounted) {+ setReactPdf(module)+ }+ })+ .catch(() => {+ if (mounted) {+ setLoadError(true)+ setIsDocumentLoading(false)+ setIsPageRendering(false)+ }+ })++ return () => {+ mounted = false+ }+ }, [])+const handleFirstPageRender = React.useCallback(() => {setIsPageRendering(false)}, [])@@ -421,7 +455,7 @@ export function PdfViewerPreviewClient() {: PAGE_BASE_HEIGHT / PAGE_BASE_WIDTH)),}- const isViewerLoading = isDocumentLoading || isPageRendering+ const isViewerLoading = !reactPdf || isDocumentLoading || isPageRenderingconst controlsDisabled = isViewerLoading || loadError || !numPagesconst updateCurrentPageFromViewport = React.useCallback(() => {@@ -704,83 +738,88 @@ export function PdfViewerPreviewClient() {Unable to load the PDF preview.</div>) : null}- <Document- key={fileUrl}- file={fileUrl}- onLoadStart={handleDocumentLoadStart}- onLoadSuccess={handleDocumentLoadSuccess}- onLoadError={handleDocumentLoadError}- className={cn(- "flex h-full min-h-0 w-full flex-1",- (isViewerLoading || loadError) && "invisible"- )}- loading={null}- error={null}- >- <div className="flex h-full min-h-0 w-full flex-1">- <aside- className={cn(- "hidden w-40 shrink-0 overflow-hidden border-r bg-sidebar transition-[margin-left,border-color] duration-200 ease-out md:block",- sidebarOpen && !isViewerLoading && !loadError- ? "ml-0"- : "-ml-40 border-r-0"- )}- >- <ScrollArea className="h-full" scrollFade>- <div className="p-4">- <div className="flex flex-col items-center gap-3">- {pageNumbers.map((pageNumber) => (- <Button- variant="ghost"- size="sm"- key={pageNumber}- className={cn(- "!h-auto w-full flex-col items-center gap-2 p-2 text-xs text-muted-foreground shadow-none hover:bg-sidebar-accent",- pageNumber === currentPage && "bg-sidebar-accent"- )}- onFocus={(event) => event.currentTarget.blur()}- onMouseDown={preserveThumbnailClickScroll}- onPointerDown={preserveThumbnailClickScroll}- onClick={() => scrollToPage(pageNumber)}- >- <div- className="shrink-0 overflow-hidden border bg-background shadow-xs"- style={thumbnailSize}+ {reactPdf ? (+ <reactPdf.Document+ key={fileUrl}+ file={fileUrl}+ onLoadStart={handleDocumentLoadStart}+ onLoadSuccess={handleDocumentLoadSuccess}+ onLoadError={() => {+ handleDocumentLoadError()+ }}+ className={cn(+ "flex h-full min-h-0 w-full flex-1",+ (isViewerLoading || loadError) && "invisible"+ )}+ loading={null}+ error={null}+ >+ <div className="flex h-full min-h-0 w-full flex-1">+ <aside+ className={cn(+ "hidden w-40 shrink-0 overflow-hidden border-r bg-sidebar transition-[margin-left,border-color] duration-200 ease-out md:block",+ sidebarOpen && !isViewerLoading && !loadError+ ? "ml-0"+ : "-ml-40 border-r-0"+ )}+ >+ <ScrollArea className="h-full" scrollFade>+ <div className="p-4">+ <div className="flex flex-col items-center gap-3">+ {pageNumbers.map((pageNumber) => (+ <Button+ variant="ghost"+ size="sm"+ key={pageNumber}+ className={cn(+ "!h-auto w-full flex-col items-center gap-2 p-2 text-xs text-muted-foreground shadow-none hover:bg-sidebar-accent",+ pageNumber === currentPage && "bg-sidebar-accent"+ )}+ onFocus={(event) => event.currentTarget.blur()}+ onMouseDown={preserveThumbnailClickScroll}+ onPointerDown={preserveThumbnailClickScroll}+ onClick={() => scrollToPage(pageNumber)}>- <Thumbnail- pageNumber={pageNumber}- className="flex size-full items-center justify-center [&_.react-pdf__Thumbnail__page]:!m-0 [&_.react-pdf__Thumbnail__page]:!h-auto [&_.react-pdf__Thumbnail__page]:!w-full [&_.react-pdf__Thumbnail__page]:overflow-hidden [&_canvas]:!h-auto [&_canvas]:!w-full"- width={THUMBNAIL_WIDTH}- rotate={rotation}- />- </div>- {pageNumber}- </Button>- ))}+ <div+ className="shrink-0 overflow-hidden border bg-background shadow-xs"+ style={thumbnailSize}+ >+ <reactPdf.Thumbnail+ pageNumber={pageNumber}+ className="flex size-full items-center justify-center [&_.react-pdf__Thumbnail__page]:!m-0 [&_.react-pdf__Thumbnail__page]:!h-auto [&_.react-pdf__Thumbnail__page]:!w-full [&_.react-pdf__Thumbnail__page]:overflow-hidden [&_canvas]:!h-auto [&_canvas]:!w-full"+ width={THUMBNAIL_WIDTH}+ rotate={rotation}+ />+ </div>+ {pageNumber}+ </Button>+ ))}+ </div></div>+ </ScrollArea>+ </aside>+ <ScrollArea+ className="min-h-0 min-w-0 flex-1"+ viewportClassName={cn(+ isPageRendering && !loadError && "invisible"+ )}+ viewportRef={viewportRef}+ >+ <div className="flex min-h-full w-max min-w-full flex-col items-center justify-start gap-6 p-6">+ <PdfPages+ reactPdf={reactPdf}+ pageNumbers={pageNumbers}+ currentPage={currentPage}+ rotation={rotation}+ scale={zoom}+ searchStore={searchStore}+ onFirstPageRender={handleFirstPageRender}+ /></div></ScrollArea>- </aside>- <ScrollArea- className="min-h-0 min-w-0 flex-1"- viewportClassName={cn(- isPageRendering && !loadError && "invisible"- )}- viewportRef={viewportRef}- >- <div className="flex min-h-full w-max min-w-full flex-col items-center justify-start gap-6 p-6">- <PdfPages- pageNumbers={pageNumbers}- currentPage={currentPage}- rotation={rotation}- scale={zoom}- searchStore={searchStore}- onFirstPageRender={handleFirstPageRender}- />- </div>- </ScrollArea>- </div>- </Document>+ </div>+ </reactPdf.Document>+ ) : null}</div></div>)diff --git a/apps/v4/components/root-components-collage.tsx b/apps/v4/components/root-components-collage.tsxindex 0ed1603..b78d37a 100644--- a/apps/v4/components/root-components-collage.tsx+++ b/apps/v4/components/root-components-collage.tsx@@ -2,47 +2,45 @@import type * as React from "react"import dynamic from "next/dynamic"+import {+ Loading03Icon,+ MinusSignCircleIcon,+ PlusSignCircleIcon,+ RotateClockwiseIcon,+ Search01Icon,+ SidebarLeftIcon,+ Upload01Icon,+} from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"-import { Citations } from "@/components/citations-docs"+import { Button } from "@/components/ui/button"import { CsvViewerPreviewClient } from "@/components/csv-viewer-docs"-import { FileThumbnail } from "@/components/file-thumbnail-docs"import { FileUpload } from "@/components/file-upload-docs"import { OcrBlocks } from "@/components/ocr-blocks-docs"+import { Separator } from "@/registry/new-york-v4/ui/separator"-const PdfViewerPreviewClient = dynamic(+const DocxViewerPreview = dynamic(() =>- import("@/components/pdf-viewer-preview-client").then(- (module) => module.PdfViewerPreviewClient- ),+ import("@/components/ui/docx-viewer").then((mod) => mod.DocxViewerPreview),{ssr: false,- loading: () => (- <div className="grid h-[560px] place-items-center bg-background text-sm text-muted-foreground">- Loading PDF viewer...- </div>- ),+ loading: () => <ViewerPreviewLoading />,})-const thumbnailFiles = [- {- name: "attention.pdf",- type: "application/pdf",- url: "/samples/attention.pdf",- size: "15 pages",- },+const XlsxViewerPreview = dynamic(+ () =>+ import("@/components/ui/xlsx-viewer").then((mod) => mod.XlsxViewerPreview),{- name: "opengraph-image.png",- type: "image/png",- url: "/opengraph-image.png",- size: "1200 x 630",- },-]+ ssr: false,+ loading: () => <ViewerPreviewLoading />,+ }+)export function MobileRootPreview() {return (- <ComponentCrop className="h-[560px]">- <PdfViewerPreviewClient />+ <ComponentCrop className="h-[560px] border bg-background">+ <RootPdfPreview /></ComponentCrop>)}@@ -51,22 +49,24 @@ export function RootComponentsCollage() {return (<div className="mx-auto grid gap-4 py-1 md:grid-cols-2 lg:grid-cols-3"><div className="flex flex-col gap-4">- <ComponentCrop className="h-[560px]">- <PdfViewerPreviewClient />+ <ComponentCrop className="h-[560px] border bg-background">+ <RootPdfPreview />+ </ComponentCrop>+ <ComponentCrop className="h-[560px] border bg-background">+ <DocxViewerPreview className="h-full" /></ComponentCrop>- <ThumbnailPair /></div><div className="flex flex-col gap-4"><ComponentCrop className="h-[280px]"><FileUpload className="p-4" /></ComponentCrop>- <ComponentCrop className="h-[400px]">+ <ComponentCrop className="h-[400px] border bg-background"><CsvViewerPreviewClient /></ComponentCrop></div><div className="flex flex-col gap-4">- <ComponentCrop className="h-[430px]">- <Citations />+ <ComponentCrop className="h-[560px] border bg-background">+ <XlsxViewerPreview className="h-full" /></ComponentCrop><ComponentCrop className="h-[430px]"><OcrBlocks />@@ -76,6 +76,14 @@ export function RootComponentsCollage() {)}+function ViewerPreviewLoading() {+ return (+ <div className="grid h-full min-h-52 place-items-center bg-background">+ <HugeiconsIcon icon={Loading03Icon} className="size-4 animate-spin" />+ </div>+ )+}+function ComponentCrop({className,children,@@ -90,18 +98,85 @@ function ComponentCrop({)}-function ThumbnailPair() {+function RootPdfPreview() {return (- <div className="grid gap-3 overflow-hidden rounded-lg bg-background p-3 sm:grid-cols-2">- {thumbnailFiles.map((file, index) => (- <FileThumbnail- key={file.url}- file={file}- showMetadata={false}- thumbnailWidth={220}- loadingDelayMs={index === 1 ? 1600 : 0}+ <div+ data-slot="pdf-viewer"+ className="flex h-[560px] w-full flex-col overflow-hidden bg-background [overflow-anchor:none]"+ >+ <div className="flex min-h-12 items-center justify-between gap-3 border-b px-3">+ <div className="flex items-center gap-2">+ <Button+ variant="ghost"+ size="icon-sm"+ aria-label="Toggle thumbnails"+ disabled+ >+ <HugeiconsIcon icon={SidebarLeftIcon} className="size-4" />+ </Button>+ <div className="text-sm whitespace-nowrap text-primary">+ Page 1 of 15+ </div>+ </div>+ <div className="flex min-w-0 items-center gap-1">+ <Button+ variant="ghost"+ size="icon-sm"+ aria-label="Rotate counterclockwise"+ disabled+ >+ <HugeiconsIcon+ icon={RotateClockwiseIcon}+ className="size-4 -scale-x-100"+ />+ </Button>+ <Button+ variant="ghost"+ size="icon-sm"+ aria-label="Rotate clockwise"+ disabled+ >+ <HugeiconsIcon icon={RotateClockwiseIcon} className="size-4" />+ </Button>+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <Button variant="ghost" size="icon-sm" aria-label="Zoom out" disabled>+ <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />+ </Button>+ <div className="hidden h-8 w-[84px] items-center justify-center rounded-md border bg-background text-sm sm:flex">+ 75%+ </div>+ <Button variant="ghost" size="icon-sm" aria-label="Zoom in" disabled>+ <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />+ </Button>+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <Button+ variant="ghost"+ size="icon-sm"+ aria-label="Search text"+ disabled+ >+ <HugeiconsIcon icon={Search01Icon} className="size-4" />+ </Button>+ <Button+ variant="ghost"+ size="icon-sm"+ aria-label="Upload PDF"+ disabled+ >+ <HugeiconsIcon icon={Upload01Icon} className="size-4" />+ </Button>+ </div>+ </div>+ <div className="relative min-h-0 flex-1 bg-muted/30">+ <div className="absolute inset-0 grid place-items-center text-muted-foreground">+ <HugeiconsIcon icon={Loading03Icon} className="size-4 animate-spin" />+ </div>+ <iframe+ src="/samples/attention.pdf#toolbar=0&navpanes=0&scrollbar=0"+ title="Attention PDF preview"+ className="relative z-10 size-full border-0 bg-background"/>- ))}+ </div></div>)}diff --git a/apps/v4/components/root-liquid-logo.tsx b/apps/v4/components/root-liquid-logo.tsxnew file mode 100644index 0000000..91b8db1--- /dev/null+++ b/apps/v4/components/root-liquid-logo.tsx@@ -0,0 +1,37 @@+"use client"++import { LiquidMetal } from "@paper-design/shaders-react"+import { useTheme } from "next-themes"++export function RootLiquidLogo() {+ const { resolvedTheme } = useTheme()+ const isDark = resolvedTheme !== "light"++ return (+ <div+ aria-hidden="true"+ className="pointer-events-none relative -mb-12 h-44 w-full overflow-hidden sm:-mb-14 sm:h-52 md:-mb-16 md:h-60"+ >+ <LiquidMetal+ width="100%"+ height="100%"+ image="/extend-logo.svg"+ colorBack="#00000000"+ colorTint="#ffffff"+ shape="none"+ repetition={2.8}+ softness={0.16}+ shiftRed={0.26}+ shiftBlue={0.32}+ distortion={0.08}+ contour={0.48}+ angle={68}+ speed={0.72}+ scale={0.72}+ fit="contain"+ maxPixelCount={900000}+ className="mx-auto h-full w-full max-w-[560px] [mask-image:linear-gradient(to_bottom,transparent_0%,black_14%,black_50%,rgba(0,0,0,0.52)_66%,rgba(0,0,0,0.12)_80%,transparent_92%)] opacity-95 [filter:contrast(1.18)_brightness(0.9)]"+ />+ </div>+ )+}diff --git a/apps/v4/components/ui/csv-viewer.tsx b/apps/v4/components/ui/csv-viewer.tsxnew file mode 100644index 0000000..8b0bb07--- /dev/null+++ b/apps/v4/components/ui/csv-viewer.tsx@@ -0,0 +1,394 @@+"use client"++import * as React from "react"+import type * as GlideDataGrid from "@glideapps/glide-data-grid"+import type {+ GridCell,+ GridCellKind,+ GridColumn,+ Item,+ Theme,+} from "@glideapps/glide-data-grid"+import {+ Loading03Icon,+ MinusSignCircleIcon,+ PlusSignCircleIcon,+ Upload01Icon,+} from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"+import Papa from "papaparse"++import { Button } from "@/components/ui/button"+import {+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+} from "@/registry/new-york-v4/ui/select"+import { Separator } from "@/registry/new-york-v4/ui/separator"+import {+ Tooltip,+ TooltipContent,+ TooltipProvider,+ TooltipTrigger,+} from "@/registry/new-york-v4/ui/tooltip"++const SAMPLE_CSV = `Invoice,Customer,Status,Amount,Submitted+INV-1001,Northstar Supply,Approved,4280.50,2026-04-28+INV-1002,Bluebird Medical,Needs review,1190.00,2026-04-29+INV-1003,Aster Logistics,Approved,845.75,2026-04-30+INV-1004,Juniper Foods,Exception,3499.99,2026-05-01+INV-1005,Keystone Labs,Approved,920.10,2026-05-02+INV-1006,Monarch Studio,Processing,1510.45,2026-05-03+INV-1007,Orchard Bank,Approved,7820.00,2026-05-04+INV-1008,Riverstone Energy,Needs review,632.25,2026-05-05+INV-1009,Summit Health,Approved,2730.00,2026-05-06+INV-1010,Westhaven Legal,Processing,410.80,2026-05-07`++const ZOOM_OPTIONS = [0.75, 1, 1.25, 1.5, 2] as const+type GlideDataGridModule = typeof GlideDataGrid++function toDisplayString(value: unknown): string {+ return value === null || value === undefined ? "" : String(value)+}++function normalizeHeaderTitle(header: string, index: number): string {+ const trimmed = header.trim()+ return trimmed.length > 0 ? trimmed : `Column ${index + 1}`+}++function parseDelimitedText(text: string): {+ headers: string[]+ rows: string[][]+ error: string | null+} {+ const results = Papa.parse<Record<string, unknown>>(text, {+ header: true,+ skipEmptyLines: "greedy",+ })++ const objectRows = Array.isArray(results.data)+ ? results.data.filter(+ (row): row is Record<string, unknown> =>+ !!row && typeof row === "object" && !Array.isArray(row)+ )+ : []+ const metaFields = Array.isArray(results.meta.fields)+ ? results.meta.fields.map((field) => String(field))+ : []+ const fieldKeys =+ metaFields.length > 0+ ? metaFields+ : Object.keys(objectRows[0] ?? {}).filter(+ (key) => key !== "__parsed_extra"+ )+ const extraColumnCount = objectRows.reduce((maxCount, row) => {+ const extras = row.__parsed_extra+ return Array.isArray(extras) ? Math.max(maxCount, extras.length) : maxCount+ }, 0)+ const headers = [+ ...fieldKeys.map((field, index) => normalizeHeaderTitle(field, index)),+ ...Array.from(+ { length: extraColumnCount },+ (_, index) => `Extra ${index + 1}`+ ),+ ]++ const rows = objectRows.map((row) => {+ const baseValues = fieldKeys.map((fieldKey) =>+ toDisplayString(row[fieldKey])+ )+ const extras = Array.isArray(row.__parsed_extra)+ ? row.__parsed_extra.map((value) => toDisplayString(value))+ : []+ const paddedExtras =+ extras.length >= extraColumnCount+ ? extras.slice(0, extraColumnCount)+ : [+ ...extras,+ ...Array.from(+ { length: extraColumnCount - extras.length },+ () => ""+ ),+ ]++ return [...baseValues, ...paddedExtras]+ })++ const firstError =+ Array.isArray(results.errors) && results.errors.length > 0+ ? results.errors[0]+ : null++ return {+ headers,+ rows,+ error:+ rows.length === 0 && firstError+ ? String(firstError.message ?? "Could not parse CSV file.")+ : null,+ }+}++function useIsDarkTheme() {+ const [isDark, setIsDark] = React.useState(false)++ React.useEffect(() => {+ const update = () =>+ setIsDark(document.documentElement.classList.contains("dark"))+ update()++ const observer = new MutationObserver(update)+ observer.observe(document.documentElement, {+ attributeFilter: ["class"],+ attributes: true,+ })++ return () => observer.disconnect()+ }, [])++ return isDark+}++function ToolbarTooltip({+ label,+ children,+}: {+ label: string+ children: React.ReactNode+}) {+ return (+ <Tooltip>+ <TooltipTrigger asChild>+ <span className="inline-flex">{children}</span>+ </TooltipTrigger>+ <TooltipContent side="bottom">{label}</TooltipContent>+ </Tooltip>+ )+}++export function CsvViewer() {+ const inputRef = React.useRef<HTMLInputElement | null>(null)+ const isDark = useIsDarkTheme()+ const [glide, setGlide] = React.useState<GlideDataGridModule | null>(null)+ const [zoom, setZoom] = React.useState<(typeof ZOOM_OPTIONS)[number]>(1)+ const [parsed, setParsed] = React.useState(() =>+ parseDelimitedText(SAMPLE_CSV)+ )+ const [isPending, setIsPending] = React.useState(false)++ React.useEffect(() => {+ let mounted = true++ void import("@glideapps/glide-data-grid").then((module) => {+ if (mounted) {+ setGlide(module)+ }+ })++ return () => {+ mounted = false+ }+ }, [])++ const columnCount = Math.max(1, parsed.headers.length)+ const scale = React.useCallback(+ (value: number) => Math.round(value * zoom),+ [zoom]+ )++ const theme = React.useMemo<Partial<Theme>>(+ () => ({+ accentColor: isDark ? "#60a5fa" : "#2563eb",+ accentLight: isDark ? "#1d4ed826" : "#dbeafe",+ accentFg: "#ffffff",+ textDark: isDark ? "#e5e5e5" : "#171717",+ textMedium: isDark ? "#a3a3a3" : "#525252",+ textLight: isDark ? "#737373" : "#a3a3a3",+ textBubble: isDark ? "#f5f5f5" : "#171717",+ textHeader: isDark ? "#f5f5f5" : "#171717",+ textGroupHeader: isDark ? "#a3a3a3" : "#525252",+ bgCell: isDark ? "#0a0a0a" : "#ffffff",+ bgCellMedium: isDark ? "#171717" : "#fafafa",+ bgHeader: isDark ? "#171717" : "#fafafa",+ bgHeaderHasFocus: isDark ? "#262626" : "#f5f5f5",+ bgHeaderHovered: isDark ? "#262626" : "#f5f5f5",+ borderColor: isDark ? "#262626" : "#e5e5e5",+ horizontalBorderColor: isDark ? "#262626" : "#e5e5e5",+ cellHorizontalPadding: scale(8),+ cellVerticalPadding: Math.max(2, scale(3)),+ headerIconSize: scale(18),+ baseFontStyle: `${scale(13)}px`,+ headerFontStyle: `600 ${scale(13)}px`,+ markerFontStyle: `${scale(11)}px`,+ fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',+ editorFontSize: `${scale(13)}px`,+ }),+ [isDark, scale]+ )++ const columns = React.useMemo<GridColumn[]>(+ () =>+ Array.from({ length: columnCount }, (_, index) => ({+ id: `column-${index}`,+ title: parsed.headers[index] ?? `Column ${index + 1}`,+ width: scale(index === 0 ? 180 : 160),+ })),+ [columnCount, parsed.headers, scale]+ )++ const getCellContent = React.useCallback(+ ([col, row]: Item): GridCell => {+ const value = parsed.rows[row]?.[col] ?? ""+ const textKind = glide?.GridCellKind.Text as GridCellKind.Text++ return {+ kind: textKind,+ data: value,+ displayData: value,+ allowOverlay: true,+ readonly: true,+ }+ },+ [glide, parsed.rows]+ )++ async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {+ const file = event.target.files?.[0]+ if (!file) return++ setIsPending(true)+ try {+ const text = await file.text()+ setParsed(parseDelimitedText(text))+ } catch (error) {+ setParsed({+ headers: [],+ rows: [],+ error:+ error instanceof Error ? error.message : "Could not read CSV file.",+ })+ } finally {+ event.target.value = ""+ setIsPending(false)+ }+ }++ function stepZoom(direction: -1 | 1) {+ const index = ZOOM_OPTIONS.indexOf(zoom)+ const nextIndex = Math.min(+ ZOOM_OPTIONS.length - 1,+ Math.max(0, index + direction)+ )+ setZoom(ZOOM_OPTIONS[nextIndex])+ }++ return (+ <div className="flex h-[560px] w-full flex-col overflow-hidden bg-background">+ <div className="flex min-h-12 items-center justify-end gap-3 border-b px-3">+ <TooltipProvider>+ <div className="ml-auto flex shrink-0 items-center gap-1">+ <ToolbarTooltip label="Zoom out">+ <Button+ variant="ghost"+ size="icon-sm"+ aria-label="Zoom out"+ disabled={zoom <= ZOOM_OPTIONS[0]}+ onClick={() => stepZoom(-1)}+ >+ <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Select+ value={zoom.toString()}+ onValueChange={(value) =>+ setZoom(Number(value) as (typeof ZOOM_OPTIONS)[number])+ }+ >+ <SelectTrigger+ size="sm"+ className="w-[84px] min-w-[84px]"+ aria-label="Zoom level"+ >+ <SelectValue>{Math.round(zoom * 100)}%</SelectValue>+ </SelectTrigger>+ <SelectContent align="end">+ {ZOOM_OPTIONS.map((option) => (+ <SelectItem key={option} value={option.toString()}>+ {Math.round(option * 100)}%+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ <ToolbarTooltip label="Zoom in">+ <Button+ variant="ghost"+ size="icon-sm"+ aria-label="Zoom in"+ disabled={zoom >= ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]}+ onClick={() => stepZoom(1)}+ >+ <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ <input+ ref={inputRef}+ type="file"+ accept=".csv,.tsv,text/csv,text/tab-separated-values"+ className="hidden"+ onChange={handleUpload}+ />+ <ToolbarTooltip label="Upload CSV">+ <Button+ variant="ghost"+ size="icon-sm"+ aria-label="Upload CSV"+ loading={isPending}+ onClick={() => inputRef.current?.click()}+ >+ <HugeiconsIcon icon={Upload01Icon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ </div>+ </TooltipProvider>+ </div>+ <div className="min-h-0 flex-1">+ {parsed.error ? (+ <div className="flex h-full items-center justify-center px-4 text-center text-sm text-destructive">+ {parsed.error}+ </div>+ ) : !glide ? (+ <div className="grid h-full place-items-center bg-background">+ <HugeiconsIcon+ icon={Loading03Icon}+ className="size-4 animate-spin"+ />+ </div>+ ) : (+ <glide.DataEditor+ key={zoom}+ columns={columns}+ rows={parsed.rows.length}+ getCellContent={getCellContent}+ rowMarkers="number"+ rowSelectionMode="multi"+ keybindings={{ search: true }}+ smoothScrollX+ smoothScrollY+ getCellsForSelection+ width="100%"+ height="100%"+ theme={theme}+ rowHeight={scale(34)}+ headerHeight={scale(36)}+ />+ )}+ </div>+ </div>+ )+}diff --git a/apps/v4/components/ui/docx-viewer.tsx b/apps/v4/components/ui/docx-viewer.tsxnew file mode 100644index 0000000..c008a5e--- /dev/null+++ b/apps/v4/components/ui/docx-viewer.tsx@@ -0,0 +1,601 @@+"use client"++import * as React from "react"+import {+ DocxEditorViewer,+ useDocxEditor,+ type DocxDocumentTheme,+} from "@extend-ai/react-docx"+import {+ Loading03Icon,+ Moon02Icon,+ MinusSignCircleIcon,+ PlusSignCircleIcon,+ Sun03Icon,+ Upload01Icon,+} from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"+import { useTheme } from "next-themes"++import { cn } from "@/lib/utils"+import { Button } from "@/components/ui/button"+import {+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+} from "@/registry/new-york-v4/ui/select"+import { Separator } from "@/registry/new-york-v4/ui/separator"+import {+ Tooltip,+ TooltipContent,+ TooltipProvider,+ TooltipTrigger,+} from "@/registry/new-york-v4/ui/tooltip"++const SAMPLE_DOCX_URL = "/samples/demo.docx"+const DOCX_MIME_TYPE =+ "application/vnd.openxmlformats-officedocument.wordprocessingml.document"+const DOCX_SOURCE_CACHE_LIMIT = 3+const DOCX_LOADING_INDICATOR_DELAY_MS = 300+const ZOOM_OPTIONS = [10, 25, 50, 75, 100, 125, 150, 175, 200, 400] as const+const DOCX_PADDING_WARNING_TEXT = "a style property during rerender"++const docxFileCache = new Map<string, File>()+const docxFilePromiseCache = new Map<string, Promise<File>>()++type UploadedDocxFile = {+ file: File+ identity: string+}++function getDocumentCacheKey(url: string, fileName?: string) {+ return `${url.split("?")[0] ?? url}::${fileName ?? ""}`+}++function rememberDocxFile(cacheKey: string, file: File) {+ if (docxFileCache.has(cacheKey)) {+ docxFileCache.delete(cacheKey)+ }++ docxFileCache.set(cacheKey, file)++ while (docxFileCache.size > DOCX_SOURCE_CACHE_LIMIT) {+ const oldestKey = docxFileCache.keys().next().value+ if (!oldestKey) break+ docxFileCache.delete(oldestKey)+ }+}++async function loadCachedDocxFile(+ url: string,+ displayFileName: string,+ cacheKey: string+): Promise<File> {+ const cachedFile = docxFileCache.get(cacheKey)+ if (cachedFile) return cachedFile++ const pendingRequest = docxFilePromiseCache.get(cacheKey)+ if (pendingRequest) return pendingRequest++ const nextRequest = fetch(url)+ .then(async (response) => {+ if (!response.ok) {+ throw new Error(`Failed to fetch DOCX (${response.status})`)+ }++ const blob = await response.blob()+ const docxFile = new File([blob], displayFileName, {+ type: blob.type || DOCX_MIME_TYPE,+ })++ rememberDocxFile(cacheKey, docxFile)+ return docxFile+ })+ .finally(() => {+ docxFilePromiseCache.delete(cacheKey)+ })++ docxFilePromiseCache.set(cacheKey, nextRequest)+ return nextRequest+}++function formatDocumentName(fileName: string | undefined, url: string) {+ if (fileName?.trim()) return fileName++ const pathname = url.split("?")[0] ?? ""+ const rawName = pathname.split("/").pop() ?? "document.docx"++ try {+ return decodeURIComponent(rawName)+ } catch {+ return rawName+ }+}++function getNextZoomScale(currentZoomScale: number, direction: 1 | -1) {+ const currentIndex = ZOOM_OPTIONS.indexOf(+ currentZoomScale as (typeof ZOOM_OPTIONS)[number]+ )+ let fallbackIndex = -1++ if (direction > 0) {+ fallbackIndex = ZOOM_OPTIONS.findIndex(+ (value) => value > currentZoomScale+ )+ } else {+ for (let index = ZOOM_OPTIONS.length - 1; index >= 0; index -= 1) {+ if (ZOOM_OPTIONS[index] < currentZoomScale) {+ fallbackIndex = index+ break+ }+ }+ }++ const resolvedIndex = currentIndex >= 0 ? currentIndex : fallbackIndex+ if (resolvedIndex < 0) return currentZoomScale++ const nextIndex = Math.min(+ Math.max(resolvedIndex + direction, 0),+ ZOOM_OPTIONS.length - 1+ )++ return ZOOM_OPTIONS[nextIndex] ?? currentZoomScale+}++function useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {+ const [showSpinner, setShowSpinner] = React.useState(false)++ React.useEffect(() => {+ if (!isLoading) {+ setShowSpinner(false)+ return+ }++ const timeoutId = window.setTimeout(() => {+ setShowSpinner(true)+ }, delayMs)++ return () => window.clearTimeout(timeoutId)+ }, [delayMs, isLoading])++ return showSpinner+}++function useDocumentNightRenderPreference() {+ const [nightRenderEnabled, setNightRenderEnabled] = React.useState(false)+ const [nightRenderPrefLoaded, setNightRenderPrefLoaded] =+ React.useState(false)++ React.useEffect(() => {+ const storedValue = window.localStorage.getItem("docx-night-render")+ setNightRenderEnabled(storedValue !== "false")+ setNightRenderPrefLoaded(true)+ }, [])++ const updateNightRenderEnabled = React.useCallback((checked: boolean) => {+ setNightRenderEnabled(checked)+ window.localStorage.setItem("docx-night-render", String(checked))+ }, [])++ return {+ nightRenderEnabled,+ nightRenderPrefLoaded,+ setNightRenderEnabled: updateNightRenderEnabled,+ }+}++function isDocxPaddingWarning(args: unknown[]) {+ return (+ typeof args[0] === "string" &&+ args[0].includes(DOCX_PADDING_WARNING_TEXT) &&+ args.some((arg) => String(arg).includes("padding"))+ )+}++function useSuppressDocxPaddingWarning(enabled: boolean) {+ React.useEffect(() => {+ if (!enabled) return++ const originalConsoleError = console.error++ console.error = (...args: unknown[]) => {+ if (isDocxPaddingWarning(args)) return+ originalConsoleError(...args)+ }++ return () => {+ console.error = originalConsoleError+ }+ }, [enabled])+}++function ToolbarTooltip({+ label,+ children,+}: {+ label: string+ children: React.ReactNode+}) {+ return (+ <Tooltip>+ <TooltipTrigger asChild>+ <span className="inline-flex">{children}</span>+ </TooltipTrigger>+ <TooltipContent side="bottom">{label}</TooltipContent>+ </Tooltip>+ )+}++function ViewerLoadingSurface({ showSpinner = true }: { showSpinner?: boolean }) {+ return (+ <div className="grid h-full min-h-52 place-items-center bg-transparent">+ {showSpinner ? (+ <HugeiconsIcon icon={Loading03Icon} className="size-4 animate-spin" />+ ) : null}+ </div>+ )+}++function DocxToolbar({+ isDark,+ onIsDarkChange,+ onUploadClick,+ setZoomScale,+ showNightRenderToggle,+ zoomScale,+}: {+ isDark: boolean+ onIsDarkChange: (checked: boolean) => void+ onUploadClick: () => void+ setZoomScale: React.Dispatch<React.SetStateAction<number>>+ showNightRenderToggle: boolean+ zoomScale: number+}) {+ const canZoomIn = zoomScale < ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]+ const canZoomOut = zoomScale > ZOOM_OPTIONS[0]++ return (+ <div className="flex min-h-12 items-center justify-end gap-3 overflow-x-auto overflow-y-hidden border-b bg-background px-3">+ <TooltipProvider>+ <div className="ml-auto flex shrink-0 items-center gap-1">+ {showNightRenderToggle ? (+ <>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ <ToolbarTooltip+ label={isDark ? "Use light document" : "Use dark document"}+ >+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label={+ isDark ? "Use light document" : "Use dark document"+ }+ onClick={() => onIsDarkChange(!isDark)}+ >+ <HugeiconsIcon+ icon={isDark ? Sun03Icon : Moon02Icon}+ className="size-4"+ />+ </Button>+ </ToolbarTooltip>+ </>+ ) : null}+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <ToolbarTooltip label="Zoom out">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ disabled={!canZoomOut}+ aria-label="Zoom out"+ onClick={() =>+ setZoomScale((currentZoomScale) =>+ getNextZoomScale(currentZoomScale, -1)+ )+ }+ >+ <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Select+ value={zoomScale.toString()}+ onValueChange={(value) => setZoomScale(Number(value))}+ >+ <SelectTrigger+ size="sm"+ className="w-[84px] min-w-[84px]"+ aria-label="Zoom level"+ >+ <SelectValue>{Math.round(zoomScale)}%</SelectValue>+ </SelectTrigger>+ <SelectContent align="end">+ {ZOOM_OPTIONS.map((value) => (+ <SelectItem key={value} value={value.toString()}>+ {value}%+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ <ToolbarTooltip label="Zoom in">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ disabled={!canZoomIn}+ aria-label="Zoom in"+ onClick={() =>+ setZoomScale((currentZoomScale) =>+ getNextZoomScale(currentZoomScale, 1)+ )+ }+ >+ <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <ToolbarTooltip label="Upload DOCX">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Upload DOCX"+ onClick={onUploadClick}+ >+ <HugeiconsIcon icon={Upload01Icon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ </div>+ </TooltipProvider>+ </div>+ )+}++export function DocxViewerPreview({+ className,+ fileName,+ rounded = false,+ src = SAMPLE_DOCX_URL,+}: {+ className?: string+ fileName?: string+ rounded?: boolean+ src?: string+}) {+ const { resolvedTheme } = useTheme()+ const {+ nightRenderEnabled,+ nightRenderPrefLoaded,+ setNightRenderEnabled,+ } = useDocumentNightRenderPreference()+ const isViewerHydrated = resolvedTheme !== undefined && nightRenderPrefLoaded+ const shouldShowHydrationSpinner = useDelayedLoadingIndicator(+ !isViewerHydrated,+ DOCX_LOADING_INDICATOR_DELAY_MS+ )++ if (!isViewerHydrated) {+ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <div+ className={cn(+ "min-h-0 flex-1 overflow-hidden bg-muted/30 p-4",+ rounded && "rounded-b-lg"+ )}+ >+ <ViewerLoadingSurface showSpinner={shouldShowHydrationSpinner} />+ </div>+ </div>+ )+ }++ const shouldRenderNightMode = resolvedTheme === "dark"+ const effectiveIsDark = shouldRenderNightMode && nightRenderEnabled++ return (+ <DocxViewerContent+ className={className}+ effectiveIsDark={effectiveIsDark}+ fileName={fileName}+ rounded={rounded}+ setNightRenderEnabled={setNightRenderEnabled}+ shouldRenderNightMode={shouldRenderNightMode}+ url={src}+ />+ )+}++function DocxViewerContent({+ className,+ effectiveIsDark,+ fileName,+ rounded,+ setNightRenderEnabled,+ shouldRenderNightMode,+ url,+}: {+ className?: string+ effectiveIsDark: boolean+ fileName?: string+ rounded: boolean+ setNightRenderEnabled: (checked: boolean) => void+ shouldRenderNightMode: boolean+ url: string+}) {+ const fileInputRef = React.useRef<HTMLInputElement>(null)+ const viewerBackgroundColor = "color-mix(in oklab, var(--muted) 40%, transparent)"+ const displayFileName = React.useMemo(+ () => formatDocumentName(fileName, url),+ [fileName, url]+ )+ const cacheKey = React.useMemo(+ () => getDocumentCacheKey(url, displayFileName),+ [displayFileName, url]+ )+ const [initialDocumentTheme] = React.useState<DocxDocumentTheme>(() =>+ effectiveIsDark ? "dark" : "light"+ )+ const editorOptions = React.useMemo(+ () => ({+ initialDocumentTheme,+ initialFileName: displayFileName,+ }),+ [displayFileName, initialDocumentTheme]+ )+ const editor = useDocxEditor(editorOptions)+ const { importDocxFile, setDocumentTheme, status } = editor+ const [zoomScale, setZoomScale] = React.useState(50)+ const [loadError, setLoadError] = React.useState<string>()+ const [isLoadingDocument, setIsLoadingDocument] = React.useState(true)+ const [uploadedDocxFile, setUploadedDocxFile] =+ React.useState<UploadedDocxFile | null>(null)+ const shouldShowDocumentSpinner = useDelayedLoadingIndicator(+ isLoadingDocument,+ DOCX_LOADING_INDICATOR_DELAY_MS+ )+ const loadingState = (+ <ViewerLoadingSurface showSpinner={shouldShowDocumentSpinner} />+ )++ useSuppressDocxPaddingWarning(!isLoadingDocument && !loadError)++ React.useEffect(() => {+ setZoomScale(50)+ }, [url])++ React.useEffect(() => {+ setDocumentTheme(effectiveIsDark ? "dark" : "light")+ }, [effectiveIsDark, setDocumentTheme])++ React.useEffect(() => {+ if (+ status.startsWith("Failed to load file") ||+ status === "Only .docx files are supported"+ ) {+ setLoadError(status)+ setIsLoadingDocument(false)+ }+ }, [status])++ React.useEffect(() => {+ let isCurrent = true++ async function load() {+ setIsLoadingDocument(true)+ setLoadError(undefined)++ try {+ const docxFile =+ uploadedDocxFile?.file ??+ (await loadCachedDocxFile(url, displayFileName, cacheKey))+ await importDocxFile(docxFile)++ if (isCurrent) {+ setIsLoadingDocument(false)+ }+ } catch (error) {+ if (isCurrent) {+ setLoadError(+ error instanceof Error ? error.message : "Unknown DOCX load error"+ )+ setIsLoadingDocument(false)+ }+ }+ }++ void load()++ return () => {+ isCurrent = false+ }+ }, [cacheKey, displayFileName, importDocxFile, uploadedDocxFile, url])++ React.useEffect(() => {+ setUploadedDocxFile(null)+ }, [url])++ async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {+ const file = event.target.files?.[0]+ event.target.value = ""++ if (!file) return++ setZoomScale(50)+ setUploadedDocxFile({+ file,+ identity: `${file.name}-${file.size}-${file.lastModified}`,+ })+ }++ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <input+ ref={fileInputRef}+ type="file"+ accept=".docx,application/vnd.openxmlformats-officedocument.wordprocessingml.document"+ className="hidden"+ onChange={handleUpload}+ />+ <DocxToolbar+ isDark={effectiveIsDark}+ onIsDarkChange={setNightRenderEnabled}+ onUploadClick={() => fileInputRef.current?.click()}+ setZoomScale={setZoomScale}+ showNightRenderToggle={shouldRenderNightMode}+ zoomScale={zoomScale}+ />+ <div+ className={cn(+ "min-h-0 flex-1 overflow-auto p-4",+ rounded && "rounded-b-lg"+ )}+ style={{ backgroundColor: viewerBackgroundColor }}+ >+ {loadError ? (+ <div className="grid h-full min-h-96 place-items-center p-6 text-center">+ <div className="max-w-md rounded-lg border bg-background p-4 text-sm text-destructive shadow-xs">+ <div className="font-medium">Unable to display DOCX</div>+ <div className="mt-1 text-muted-foreground">{loadError}</div>+ </div>+ </div>+ ) : isLoadingDocument ? (+ loadingState+ ) : (+ <div className="mx-auto flex min-h-full justify-center">+ <div+ className={cn(+ "origin-top",+ effectiveIsDark && "docx-night-reader-shell"+ )}+ style={{ zoom: zoomScale / 100 }}+ >+ <DocxEditorViewer+ editor={editor}+ mode="read-only"+ loadingState={loadingState}+ pageBackgroundColor={effectiveIsDark ? "#0a0a0a" : undefined}+ pageGapBackgroundColor={viewerBackgroundColor}+ deferInitialPaginationPaint={false}+ />+ </div>+ </div>+ )}+ </div>+ </div>+ )+}diff --git a/apps/v4/components/ui/file-thumbnail.tsx b/apps/v4/components/ui/file-thumbnail.tsxnew file mode 100644index 0000000..93c9e1c--- /dev/null+++ b/apps/v4/components/ui/file-thumbnail.tsx@@ -0,0 +1,174 @@+"use client"++import * as React from "react"+import { File01Icon, FileImageIcon } from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"++import { cn } from "@/lib/utils"++export type ThumbnailFile = {+ name: string+ type: string+ size?: string+}++export type FileThumbnailProps = {+ file: ThumbnailFile+ className?: string+ previewClassName?: string+ previewContent?: React.ReactNode+ previewImageUrl?: string | null+ isLoading?: boolean+ hasError?: boolean+ showMetadata?: boolean+}++function isImageFile(file: ThumbnailFile) {+ return file.type.startsWith("image/")+}++function FileKindIcon({ file }: { file: ThumbnailFile }) {+ const icon = isImageFile(file) ? FileImageIcon : File01Icon++ return <HugeiconsIcon icon={icon} className="size-4" />+}++export function FileThumbnailLoadingOverlay() {+ return (+ <div className="absolute inset-0 z-10 overflow-hidden bg-muted">+ <style>{`+ @keyframes file-thumbnail-preview-shimmer {+ 0% { transform: translateX(-100%); }+ 100% { transform: translateX(100%); }+ }+ @media (prefers-reduced-motion: reduce) {+ .file-thumbnail-preview-shimmer {+ animation: none !important;+ transform: translateX(0);+ opacity: 0.55;+ }+ }+ `}</style>+ <div className="absolute inset-0 bg-muted" />+ <div+ className="file-thumbnail-preview-shimmer absolute inset-0 bg-linear-to-r from-transparent via-background/65 to-transparent"+ style={{+ animation:+ "file-thumbnail-preview-shimmer 1.25s ease-in-out infinite",+ }}+ />+ </div>+ )+}++export function FileThumbnail({+ file,+ className,+ previewClassName,+ previewContent,+ previewImageUrl,+ isLoading = false,+ hasError = false,+ showMetadata = true,+}: FileThumbnailProps) {+ const imageRef = React.useRef<HTMLImageElement | null>(null)+ const [isImageLoading, setIsImageLoading] = React.useState(+ Boolean(previewImageUrl)+ )+ const [imageFailed, setImageFailed] = React.useState(false)+ const showLoading = isLoading || isImageLoading+ const hasPreviewContent = Boolean(previewContent)+ const showFallback =+ hasError || imageFailed || (!previewImageUrl && !hasPreviewContent)+ const markImageLoaded = React.useCallback((image: HTMLImageElement) => {+ const didLoad = image.naturalWidth > 0 && image.naturalHeight > 0++ setImageFailed(!didLoad)+ setIsImageLoading(false)+ }, [])++ React.useEffect(() => {+ setIsImageLoading(Boolean(previewImageUrl))+ setImageFailed(false)+ }, [previewImageUrl])++ React.useEffect(() => {+ const image = imageRef.current++ if (!image || !previewImageUrl) return++ if (image.complete) {+ markImageLoaded(image)+ }+ }, [markImageLoaded, previewImageUrl])++ return (+ <div+ className={cn(+ "group overflow-hidden rounded-lg border bg-background text-foreground",+ className+ )}+ >+ <div+ className={cn(+ "relative aspect-square overflow-hidden bg-muted",+ previewClassName+ )}+ >+ {previewImageUrl ? (+ <img+ ref={imageRef}+ src={previewImageUrl}+ alt=""+ loading="lazy"+ decoding="async"+ className={cn(+ "size-full object-cover transition-[opacity,filter,transform] duration-[160ms] ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none",+ showLoading+ ? "scale-[1.01] opacity-0 blur-sm"+ : "blur-0 scale-100 opacity-100"+ )}+ onLoad={(event) => {+ markImageLoaded(event.currentTarget)+ }}+ onError={() => {+ setImageFailed(true)+ setIsImageLoading(false)+ }}+ />+ ) : null}+ {previewContent ? (+ <div+ className={cn(+ "size-full transition-[opacity,filter,transform] duration-[160ms] ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none",+ showLoading+ ? "scale-[1.01] opacity-0 blur-sm"+ : "blur-0 scale-100 opacity-100"+ )}+ >+ {previewContent}+ </div>+ ) : null}+ {showLoading ? <FileThumbnailLoadingOverlay /> : null}+ {showFallback ? (+ <div className="absolute inset-0 grid place-items-center bg-muted text-muted-foreground">+ <FileKindIcon file={file} />+ </div>+ ) : null}+ </div>+ {showMetadata ? (+ <div className="flex items-center gap-2 border-t px-3 py-2">+ <div className="flex size-7 shrink-0 items-center justify-center rounded-md border bg-muted text-muted-foreground">+ <FileKindIcon file={file} />+ </div>+ <div className="min-w-0">+ <div className="truncate text-sm font-medium">{file.name}</div>+ <div className="truncate text-xs text-muted-foreground">+ {file.size ?? file.type}+ </div>+ </div>+ </div>+ ) : null}+ </div>+ )+}diff --git a/apps/v4/components/ui/xlsx-viewer.tsx b/apps/v4/components/ui/xlsx-viewer.tsxnew file mode 100644index 0000000..d1d7fc5--- /dev/null+++ b/apps/v4/components/ui/xlsx-viewer.tsx@@ -0,0 +1,975 @@+"use client"++import * as React from "react"+import {+ useXlsxViewer,+ useXlsxViewerController,+ useXlsxViewerThumbnails,+ useXlsxViewerZoom,+ XlsxViewer,+ XlsxViewerProvider,+ type XlsxTableHeaderMenuRenderProps,+} from "@extend-ai/react-xlsx"+import {+ Loading03Icon,+ MinusSignCircleIcon,+ Moon02Icon,+ MoreHorizontalIcon,+ PlusSignCircleIcon,+ Sun03Icon,+ Upload01Icon,+} from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"+import { useTheme } from "next-themes"+import { createPortal } from "react-dom"++import { cn } from "@/lib/utils"+import { Button } from "@/components/ui/button"+import { ScrollArea } from "@/components/ui/scroll-area"+import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"+import {+ DropdownMenu,+ DropdownMenuContent,+ DropdownMenuItem,+ DropdownMenuRadioGroup,+ DropdownMenuRadioItem,+ DropdownMenuTrigger,+} from "@/registry/new-york-v4/ui/dropdown-menu"+import {+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+} from "@/registry/new-york-v4/ui/select"+import { Separator } from "@/registry/new-york-v4/ui/separator"+import {+ Tooltip,+ TooltipContent,+ TooltipProvider,+ TooltipTrigger,+} from "@/registry/new-york-v4/ui/tooltip"++const SAMPLE_XLSX_URL = "/samples/crazy-chart-zoo.xlsx"+const XLSX_SOURCE_CACHE_LIMIT = 3+const XLSX_LOADING_INDICATOR_DELAY_MS = 300+const XLSX_DROPDOWN_Z_INDEX_CLASS = "z-[100010]"+const ZOOM_OPTIONS = [10, 25, 50, 75, 100, 125, 150, 175, 200, 400] as const++const xlsxWorkbookBufferCache = new Map<string, ArrayBuffer>()+const xlsxWorkbookBufferPromiseCache = new Map<string, Promise<ArrayBuffer>>()++type UploadedWorkbook = {+ buffer: ArrayBuffer+ fileName: string+ identity: string+}++function getWorkbookCacheKey(url: string, fileName?: string) {+ return `${url.split("?")[0] ?? url}::${fileName ?? ""}`+}++function rememberWorkbookBuffer(cacheKey: string, workbookBuffer: ArrayBuffer) {+ if (xlsxWorkbookBufferCache.has(cacheKey)) {+ xlsxWorkbookBufferCache.delete(cacheKey)+ }++ xlsxWorkbookBufferCache.set(cacheKey, workbookBuffer)++ while (xlsxWorkbookBufferCache.size > XLSX_SOURCE_CACHE_LIMIT) {+ const oldestKey = xlsxWorkbookBufferCache.keys().next().value+ if (!oldestKey) break+ xlsxWorkbookBufferCache.delete(oldestKey)+ }+}++async function loadCachedWorkbookBuffer(+ url: string,+ cacheKey: string+): Promise<ArrayBuffer> {+ const cachedWorkbookBuffer = xlsxWorkbookBufferCache.get(cacheKey)+ if (cachedWorkbookBuffer) return cachedWorkbookBuffer++ const pendingRequest = xlsxWorkbookBufferPromiseCache.get(cacheKey)+ if (pendingRequest) return pendingRequest++ const nextRequest = fetch(url)+ .then(async (response) => {+ if (!response.ok) {+ throw new Error(`Failed to fetch XLSX (${response.status})`)+ }++ const workbookBuffer = await response.arrayBuffer()+ rememberWorkbookBuffer(cacheKey, workbookBuffer)+ return workbookBuffer+ })+ .finally(() => {+ xlsxWorkbookBufferPromiseCache.delete(cacheKey)+ })++ xlsxWorkbookBufferPromiseCache.set(cacheKey, nextRequest)+ return nextRequest+}++function formatWorkbookName(fileName: string | undefined, url: string) {+ if (fileName?.trim()) return fileName++ const pathname = url.split("?")[0] ?? ""+ const rawName = pathname.split("/").pop() ?? "workbook.xlsx"++ try {+ return decodeURIComponent(rawName)+ } catch {+ return rawName+ }+}++function useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {+ const [showSpinner, setShowSpinner] = React.useState(false)++ React.useEffect(() => {+ if (!isLoading) {+ setShowSpinner(false)+ return+ }++ const timeoutId = window.setTimeout(() => {+ setShowSpinner(true)+ }, delayMs)++ return () => window.clearTimeout(timeoutId)+ }, [delayMs, isLoading])++ return showSpinner+}++export function useWorkbookNightRenderPreference() {+ const [nightRenderEnabled, setNightRenderEnabled] = React.useState(false)+ const [nightRenderPrefLoaded, setNightRenderPrefLoaded] =+ React.useState(false)++ React.useEffect(() => {+ const storedValue = window.localStorage.getItem("xlsx-night-render")+ setNightRenderEnabled(storedValue !== "false")+ setNightRenderPrefLoaded(true)+ }, [])++ const updateNightRenderEnabled = React.useCallback((checked: boolean) => {+ setNightRenderEnabled(checked)+ window.localStorage.setItem("xlsx-night-render", String(checked))+ }, [])++ return {+ nightRenderEnabled,+ nightRenderPrefLoaded,+ setNightRenderEnabled: updateNightRenderEnabled,+ }+}++function ToolbarTooltip({+ label,+ children,+}: {+ label: string+ children: React.ReactNode+}) {+ return (+ <Tooltip>+ <TooltipTrigger asChild>+ <span className="inline-flex">{children}</span>+ </TooltipTrigger>+ <TooltipContent side="bottom">{label}</TooltipContent>+ </Tooltip>+ )+}++function ViewerLoadingSurface({+ showSpinner = true,+}: {+ showSpinner?: boolean+}) {+ return (+ <div className="grid h-full min-h-52 w-full min-w-full place-items-center bg-transparent">+ {showSpinner ? (+ <HugeiconsIcon icon={Loading03Icon} className="size-4 animate-spin" />+ ) : null}+ </div>+ )+}++export function WorkbookTableHeaderMenu({+ direction,+ sortAscending,+ sortDescending,+ triggerIcon,+ triggerProps,+}: XlsxTableHeaderMenuRenderProps) {+ const [open, setOpen] = React.useState(false)++ return (+ <DropdownMenu open={open} onOpenChange={setOpen}>+ <DropdownMenuTrigger asChild>+ <Button+ {...triggerProps}+ type="button"+ variant="ghost"+ size="icon-sm"+ className={cn("size-6 rounded-sm", triggerProps.className)}+ aria-label="Column menu"+ >+ {triggerIcon ? (+ triggerIcon+ ) : (+ <HugeiconsIcon icon={MoreHorizontalIcon} className="size-3.5" />+ )}+ </Button>+ </DropdownMenuTrigger>+ <DropdownMenuContent+ align="end"+ className={cn("w-40", XLSX_DROPDOWN_Z_INDEX_CLASS)}+ >+ <DropdownMenuRadioGroup+ value={direction ?? ""}+ onValueChange={(value) => {+ if (value === "ascending") {+ sortAscending()+ } else {+ sortDescending()+ }+ setOpen(false)+ }}+ >+ <DropdownMenuRadioItem value="ascending">+ Sort ascending+ </DropdownMenuRadioItem>+ <DropdownMenuRadioItem value="descending">+ Sort descending+ </DropdownMenuRadioItem>+ </DropdownMenuRadioGroup>+ </DropdownMenuContent>+ </DropdownMenu>+ )+}++function WorkbookToolbar({+ isDark,+ onIsDarkChange,+ onUploadClick,+ showNightRenderToggle,+ showUploadButton = true,+ workbookIdentity,+}: {+ isDark: boolean+ onIsDarkChange: (checked: boolean) => void+ onUploadClick: () => void+ showNightRenderToggle: boolean+ showUploadButton?: boolean+ workbookIdentity: string+}) {+ const { canZoomIn, canZoomOut, setZoomScale, zoomIn, zoomOut, zoomScale } =+ useXlsxViewerZoom()+ const currentZoom = Math.round(zoomScale)++ React.useEffect(() => {+ setZoomScale(100)+ }, [setZoomScale, workbookIdentity])++ return (+ <div className="flex min-h-12 items-center justify-end gap-3 overflow-x-auto overflow-y-hidden border-b bg-background px-3">+ <TooltipProvider>+ <div className="ml-auto flex shrink-0 items-center gap-1">+ {showNightRenderToggle ? (+ <>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ <ToolbarTooltip+ label={isDark ? "Use light workbook" : "Use dark workbook"}+ >+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label={+ isDark ? "Use light workbook" : "Use dark workbook"+ }+ onClick={() => onIsDarkChange(!isDark)}+ >+ <HugeiconsIcon+ icon={isDark ? Sun03Icon : Moon02Icon}+ className="size-4"+ />+ </Button>+ </ToolbarTooltip>+ </>+ ) : null}+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <ToolbarTooltip label="Zoom out">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ disabled={!canZoomOut}+ aria-label="Zoom out"+ onClick={zoomOut}+ >+ <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Select+ value={currentZoom.toString()}+ onValueChange={(value) => setZoomScale(Number(value))}+ >+ <SelectTrigger+ size="sm"+ className="w-[84px] min-w-[84px]"+ aria-label="Zoom level"+ >+ <SelectValue>{currentZoom}%</SelectValue>+ </SelectTrigger>+ <SelectContent align="end" className={XLSX_DROPDOWN_Z_INDEX_CLASS}>+ {ZOOM_OPTIONS.map((value) => (+ <SelectItem key={value} value={value.toString()}>+ {value}%+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ <ToolbarTooltip label="Zoom in">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ disabled={!canZoomIn}+ aria-label="Zoom in"+ onClick={zoomIn}+ >+ <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ {showUploadButton ? (+ <>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ <ToolbarTooltip label="Upload XLSX">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Upload XLSX"+ onClick={onUploadClick}+ >+ <HugeiconsIcon icon={Upload01Icon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ </>+ ) : null}+ </div>+ </TooltipProvider>+ </div>+ )+}++export function WorkbookSheetTabs({+ workbookIdentity,+}: {+ workbookIdentity: string+}) {+ const { activeSheetIndex, setActiveSheetIndex, sheets } = useXlsxViewer()+ const { thumbnails } = useXlsxViewerThumbnails({+ resolution: {+ maxHeight: 360,+ maxWidth: 560,+ },+ })+ const [visiblePreviewIndex, setVisiblePreviewIndex] = React.useState<+ number | null+ >(null)+ const [previewPosition, setPreviewPosition] = React.useState({+ left: 0,+ top: 0,+ })+ const [thumbnailUrls, setThumbnailUrls] = React.useState<+ Record<number, string>+ >({})+ const scrollRef = React.useRef<HTMLDivElement | null>(null)+ const itemRefs = React.useRef<Record<number, HTMLButtonElement | null>>({})+ const openTimeoutRef = React.useRef<ReturnType<typeof setTimeout> | null>(+ null+ )+ const closeTimeoutRef = React.useRef<ReturnType<typeof setTimeout> | null>(+ null+ )+ const previewWidth = 220+ const previewHeight = (previewWidth * 7) / 11+ const previewGap = 12+ const previewOpenDelayMs = 500++ const clearOpenTimeout = React.useCallback(() => {+ if (openTimeoutRef.current) {+ clearTimeout(openTimeoutRef.current)+ openTimeoutRef.current = null+ }+ }, [])++ const clearCloseTimeout = React.useCallback(() => {+ if (closeTimeoutRef.current) {+ clearTimeout(closeTimeoutRef.current)+ closeTimeoutRef.current = null+ }+ }, [])++ const getPreviewPosition = React.useCallback(+ (sheetIndex: number) => {+ const item = itemRefs.current[sheetIndex]+ if (!item || typeof window === "undefined") {+ return { left: 0, top: 0 }+ }++ const itemRect = item.getBoundingClientRect()+ const centeredLeft = itemRect.left + itemRect.width / 2 - previewWidth / 2+ const minLeft = 8+ const maxLeft = Math.max(minLeft, window.innerWidth - previewWidth - 8)+ const left = Math.max(minLeft, Math.min(centeredLeft, maxLeft))+ const top = Math.max(8, itemRect.top - previewHeight - previewGap)++ return { left, top }+ },+ [previewHeight]+ )++ const updatePreviewPosition = React.useCallback(+ (sheetIndex: number) => {+ setPreviewPosition(getPreviewPosition(sheetIndex))+ },+ [getPreviewPosition]+ )++ const handleItemEnter = React.useCallback(+ (sheetIndex: number) => {+ clearCloseTimeout()+ const nextPreviewPosition = getPreviewPosition(sheetIndex)++ if (visiblePreviewIndex !== null) {+ clearOpenTimeout()+ setPreviewPosition(nextPreviewPosition)+ setVisiblePreviewIndex(sheetIndex)+ return+ }++ clearOpenTimeout()+ openTimeoutRef.current = setTimeout(() => {+ setPreviewPosition(nextPreviewPosition)+ setVisiblePreviewIndex(sheetIndex)+ }, previewOpenDelayMs)+ },+ [+ clearCloseTimeout,+ clearOpenTimeout,+ getPreviewPosition,+ visiblePreviewIndex,+ ]+ )++ const handleContainerLeave = React.useCallback(() => {+ clearOpenTimeout()+ clearCloseTimeout()+ closeTimeoutRef.current = setTimeout(() => {+ setVisiblePreviewIndex(null)+ }, 80)+ }, [clearCloseTimeout, clearOpenTimeout])++ React.useEffect(() => {+ return () => {+ clearOpenTimeout()+ clearCloseTimeout()+ }+ }, [clearCloseTimeout, clearOpenTimeout])++ React.useEffect(() => {+ clearOpenTimeout()+ clearCloseTimeout()+ setVisiblePreviewIndex(null)+ setPreviewPosition({ left: 0, top: 0 })+ setThumbnailUrls({})+ }, [clearCloseTimeout, clearOpenTimeout, workbookIdentity])++ React.useEffect(() => {+ thumbnails.forEach((thumbnail) => {+ if (thumbnailUrls[thumbnail.sheetIndex]) return++ const canvas = document.createElement("canvas")+ canvas.width = thumbnail.width+ canvas.height = thumbnail.height++ if (!thumbnail.paint(canvas)) return++ const nextUrl = canvas.toDataURL("image/png")+ setThumbnailUrls((current) => {+ if (current[thumbnail.sheetIndex]) return current++ return {+ ...current,+ [thumbnail.sheetIndex]: nextUrl,+ }+ })+ })+ }, [thumbnailUrls, thumbnails])++ React.useEffect(() => {+ if (visiblePreviewIndex === null) return++ const handleReposition = () => updatePreviewPosition(visiblePreviewIndex)+ handleReposition()++ const scrollElement = scrollRef.current+ window.addEventListener("resize", handleReposition)+ scrollElement?.addEventListener("scroll", handleReposition, {+ passive: true,+ })++ return () => {+ window.removeEventListener("resize", handleReposition)+ scrollElement?.removeEventListener("scroll", handleReposition)+ }+ }, [updatePreviewPosition, visiblePreviewIndex])++ if (sheets.length <= 1) return null++ const previewUrl =+ visiblePreviewIndex === null ? null : thumbnailUrls[visiblePreviewIndex]+ const previewSheet =+ visiblePreviewIndex === null ? null : sheets[visiblePreviewIndex]++ return (+ <div+ className="border-t bg-muted/40 px-3 py-2"+ onMouseLeave={handleContainerLeave}+ >+ <Tabs+ value={String(activeSheetIndex)}+ onValueChange={(value) => setActiveSheetIndex(Number(value))}+ className="gap-0"+ >+ <ScrollArea+ orientation="horizontal"+ className="h-8 w-full"+ viewportClassName="overflow-y-hidden"+ viewportRef={scrollRef}+ >+ <TabsList className="rounded-none bg-transparent p-0">+ {sheets.map((sheet, index) => (+ <TabsTrigger+ key={`${sheet.workbookSheetIndex}-${sheet.name}`}+ ref={(node) => {+ itemRefs.current[index] = node+ }}+ value={String(index)}+ className="h-8 max-w-48 flex-none rounded-md border border-transparent px-3 shadow-none data-active:border-input data-active:bg-background"+ onMouseEnter={() => handleItemEnter(index)}+ >+ <span className="truncate">{sheet.name}</span>+ </TabsTrigger>+ ))}+ </TabsList>+ </ScrollArea>+ </Tabs>+ {typeof document !== "undefined" && previewSheet+ ? createPortal(+ <div+ className={cn(+ "pointer-events-none fixed z-[2147483647] overflow-hidden rounded-lg border bg-background/95 shadow-xl backdrop-blur-md transition-[opacity,transform] duration-100",+ previewUrl+ ? "translate-y-0 opacity-100"+ : "translate-y-1 opacity-0"+ )}+ style={{+ left: previewPosition.left,+ top: previewPosition.top,+ width: previewWidth,+ }}+ >+ <div className="relative aspect-[11/7] w-full overflow-hidden bg-muted/60">+ {previewUrl ? (+ <img+ src={previewUrl}+ alt={`${previewSheet.name} preview`}+ className="absolute inset-0 size-full object-cover object-left-top"+ draggable={false}+ />+ ) : (+ <div className="grid size-full place-items-center">+ <HugeiconsIcon+ icon={Loading03Icon}+ className="size-4 animate-spin text-muted-foreground"+ />+ </div>+ )}+ </div>+ </div>,+ document.body+ )+ : null}+ </div>+ )+}++export function XlsxWorkbookSurface({+ className,+ isDark,+ onIsDarkChange,+ onUploadClick,+ renderTableHeaderMenu,+ rounded,+ showNightRenderToggle,+ showUploadButton = true,+ workbookIdentity,+}: {+ className?: string+ isDark: boolean+ onIsDarkChange: (checked: boolean) => void+ onUploadClick: () => void+ renderTableHeaderMenu: (+ props: XlsxTableHeaderMenuRenderProps+ ) => React.ReactNode+ rounded: boolean+ showNightRenderToggle: boolean+ showUploadButton?: boolean+ workbookIdentity: string+}) {+ const { error } = useXlsxViewer()++ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className,+ rounded && "rounded-lg"+ )}+ >+ <WorkbookToolbar+ isDark={isDark}+ onIsDarkChange={onIsDarkChange}+ onUploadClick={onUploadClick}+ showNightRenderToggle={showNightRenderToggle}+ showUploadButton={showUploadButton}+ workbookIdentity={workbookIdentity}+ />+ <div className="flex min-h-0 flex-1 flex-col">+ <ScrollArea+ orientation="both"+ className="min-h-0 flex-1 bg-muted/20"+ viewportClassName="min-h-0"+ >+ <XlsxViewer+ experimentalCanvas+ allowResizeInReadOnly+ className="h-full min-h-0 min-w-0"+ height="100%"+ isDark={isDark}+ readOnly+ rounded={false}+ showDefaultToolbar={false}+ showImages+ fileTooLargeState={+ <div className="grid h-full w-full min-w-full place-items-center p-6">+ <div className="max-w-sm rounded-lg border bg-background p-4 text-sm">+ <p className="font-medium">File too large</p>+ <p className="mt-1 text-muted-foreground">+ This workbook exceeds the display limit. Download it to view+ the full file.+ </p>+ </div>+ </div>+ }+ loadingState={<ViewerLoadingSurface />}+ errorState={+ <div className="grid h-full w-full min-w-full place-items-center p-6 text-sm text-destructive">+ {error?.message ?? "Unable to display workbook."}+ </div>+ }+ renderTableHeaderMenu={renderTableHeaderMenu}+ />+ </ScrollArea>+ <WorkbookSheetTabs workbookIdentity={workbookIdentity} />+ </div>+ </div>+ )+}++export function XlsxViewerPreview({+ className,+ fileName,+ rounded = false,+ src = SAMPLE_XLSX_URL,+}: {+ className?: string+ fileName?: string+ rounded?: boolean+ src?: string+}) {+ const { resolvedTheme } = useTheme()+ const { nightRenderEnabled, nightRenderPrefLoaded, setNightRenderEnabled } =+ useWorkbookNightRenderPreference()+ const isViewerHydrated = resolvedTheme !== undefined && nightRenderPrefLoaded+ const shouldShowHydrationSpinner = useDelayedLoadingIndicator(+ !isViewerHydrated,+ XLSX_LOADING_INDICATOR_DELAY_MS+ )++ if (!isViewerHydrated) {+ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <div+ className={cn(+ "min-h-0 flex-1 overflow-hidden bg-muted/30 p-4",+ rounded && "rounded-b-lg"+ )}+ >+ <ViewerLoadingSurface showSpinner={shouldShowHydrationSpinner} />+ </div>+ </div>+ )+ }++ const shouldRenderNightMode = resolvedTheme === "dark"+ const effectiveIsDark = shouldRenderNightMode && nightRenderEnabled++ return (+ <XlsxViewerContent+ className={className}+ effectiveIsDark={effectiveIsDark}+ fileName={fileName}+ rounded={rounded}+ setNightRenderEnabled={setNightRenderEnabled}+ shouldRenderNightMode={shouldRenderNightMode}+ url={src}+ />+ )+}++function XlsxViewerContent({+ className,+ effectiveIsDark,+ fileName,+ rounded,+ setNightRenderEnabled,+ shouldRenderNightMode,+ url,+}: {+ className?: string+ effectiveIsDark: boolean+ fileName?: string+ rounded: boolean+ setNightRenderEnabled: (checked: boolean) => void+ shouldRenderNightMode: boolean+ url: string+}) {+ const fileInputRef = React.useRef<HTMLInputElement>(null)+ const displayFileName = React.useMemo(+ () => formatWorkbookName(fileName, url),+ [fileName, url]+ )+ const cacheKey = React.useMemo(+ () => getWorkbookCacheKey(url, displayFileName),+ [displayFileName, url]+ )+ const [workbookBuffer, setWorkbookBuffer] =+ React.useState<ArrayBuffer | null>(+ () => xlsxWorkbookBufferCache.get(cacheKey) ?? null+ )+ const [uploadedWorkbook, setUploadedWorkbook] =+ React.useState<UploadedWorkbook | null>(null)+ const [loadError, setLoadError] = React.useState<string>()+ const shouldShowLoadingSpinner = useDelayedLoadingIndicator(+ !workbookBuffer && !loadError && !uploadedWorkbook,+ XLSX_LOADING_INDICATOR_DELAY_MS+ )++ React.useEffect(() => {+ let isCurrent = true+ setUploadedWorkbook(null)++ async function loadWorkbook(): Promise<void> {+ setWorkbookBuffer(xlsxWorkbookBufferCache.get(cacheKey) ?? null)+ setLoadError(undefined)++ try {+ const nextWorkbookBuffer = await loadCachedWorkbookBuffer(url, cacheKey)+ if (!isCurrent) return++ setWorkbookBuffer(nextWorkbookBuffer)+ } catch (error) {+ if (!isCurrent) return++ setLoadError(+ error instanceof Error ? error.message : "Unknown XLSX load error"+ )+ }+ }++ void loadWorkbook()++ return () => {+ isCurrent = false+ }+ }, [cacheKey, url])++ async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {+ const file = event.target.files?.[0]+ event.target.value = ""++ if (!file) return++ const buffer = await file.arrayBuffer()+ setLoadError(undefined)+ setUploadedWorkbook({+ buffer,+ fileName: file.name,+ identity: `${file.name}-${file.size}-${file.lastModified}`,+ })+ }++ const activeBuffer = uploadedWorkbook?.buffer ?? workbookBuffer+ const activeFileName = uploadedWorkbook?.fileName ?? displayFileName+ const activeIdentity = uploadedWorkbook?.identity ?? cacheKey++ if (loadError && !activeBuffer) {+ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <input+ ref={fileInputRef}+ type="file"+ accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"+ className="hidden"+ onChange={handleUpload}+ />+ <div className="grid min-h-0 flex-1 place-items-center bg-muted/30 p-4">+ <div className="max-w-md rounded-lg border bg-background p-4 text-sm">+ <p className="font-medium">Unable to display workbook</p>+ <p className="mt-1 text-muted-foreground">{loadError}</p>+ <Button+ type="button"+ variant="outline"+ size="sm"+ className="mt-4"+ onClick={() => fileInputRef.current?.click()}+ >+ <HugeiconsIcon icon={Upload01Icon} className="size-4" />+ Upload XLSX+ </Button>+ </div>+ </div>+ </div>+ )+ }++ if (!activeBuffer) {+ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <input+ ref={fileInputRef}+ type="file"+ accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"+ className="hidden"+ onChange={handleUpload}+ />+ <ViewerLoadingSurface showSpinner={shouldShowLoadingSpinner} />+ </div>+ )+ }++ return (+ <div className={cn("overflow-hidden", className)}>+ <input+ ref={fileInputRef}+ type="file"+ accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"+ className="hidden"+ onChange={handleUpload}+ />+ <XlsxWorkbookLoadedViewer+ fileName={activeFileName}+ isDark={effectiveIsDark}+ onIsDarkChange={setNightRenderEnabled}+ onUploadClick={() => fileInputRef.current?.click()}+ renderTableHeaderMenu={(props) => (+ <WorkbookTableHeaderMenu {...props} />+ )}+ rounded={rounded}+ showNightRenderToggle={shouldRenderNightMode}+ workbookBuffer={activeBuffer}+ workbookIdentity={activeIdentity}+ />+ </div>+ )+}++function XlsxWorkbookLoadedViewer({+ fileName,+ isDark,+ onIsDarkChange,+ onUploadClick,+ renderTableHeaderMenu,+ rounded,+ showNightRenderToggle,+ workbookBuffer,+ workbookIdentity,+}: {+ fileName: string+ isDark: boolean+ onIsDarkChange: (checked: boolean) => void+ onUploadClick: () => void+ renderTableHeaderMenu: (+ props: XlsxTableHeaderMenuRenderProps+ ) => React.ReactNode+ rounded: boolean+ showNightRenderToggle: boolean+ workbookBuffer: ArrayBuffer+ workbookIdentity: string+}) {+ const controller = useXlsxViewerController(+ React.useMemo(+ () => ({+ allowResizeInReadOnly: true,+ file: workbookBuffer,+ fileName,+ readOnly: true,+ useWorker: true,+ }),+ [fileName, workbookBuffer]+ )+ )++ return (+ <XlsxViewerProvider controller={controller} isDark={isDark}>+ <XlsxWorkbookSurface+ isDark={isDark}+ onIsDarkChange={onIsDarkChange}+ onUploadClick={onUploadClick}+ renderTableHeaderMenu={renderTableHeaderMenu}+ rounded={rounded}+ showNightRenderToggle={showNightRenderToggle}+ workbookIdentity={workbookIdentity}+ />+ </XlsxViewerProvider>+ )+}diff --git a/apps/v4/components/xlsx-viewer-docs.tsx b/apps/v4/components/xlsx-viewer-docs.tsxnew file mode 100644index 0000000..42353b9--- /dev/null+++ b/apps/v4/components/xlsx-viewer-docs.tsx@@ -0,0 +1,1042 @@+"use client"++import * as React from "react"+import dynamic from "next/dynamic"++import { Button } from "@/components/ui/button"+import { HighlightedCodeBlock } from "@/components/highlighted-code-block"++function ViewerPreviewLoading() {+ return (+ <div className="grid h-[640px] place-items-center bg-background">+ <div className="size-4 animate-spin rounded-full border-2 border-muted-foreground/30 border-t-foreground" />+ </div>+ )+}++const XlsxViewerPreview = dynamic(+ () => import("@/components/ui/xlsx-viewer").then((mod) => mod.XlsxViewerPreview),+ {+ ssr: false,+ loading: () => <ViewerPreviewLoading />,+ }+)++export function XlsxViewerDemo() {+ const [isCodeVisible, setIsCodeVisible] = React.useState(false)++ return (+ <div+ data-slot="component-preview"+ className="group relative mt-4 mb-12 flex flex-col overflow-hidden rounded-xl border"+ >+ <XlsxViewerPreview />+ <div+ data-slot="code"+ data-mobile-code-visible={isCodeVisible}+ className="relative overflow-hidden **:data-[slot=copy-button]:right-4 **:data-[slot=copy-button]:hidden data-[mobile-code-visible=true]:**:data-[slot=copy-button]:flex [&_[data-rehype-pretty-code-figure]]:m-0! [&_[data-rehype-pretty-code-figure]]:rounded-t-none [&_[data-rehype-pretty-code-figure]]:border-t [&_pre]:max-h-72"+ >+ {isCodeVisible ? (+ <HighlightedCodeBlock+ code={xlsxViewerUsageCode}+ className="rounded-none border-x-0 border-b-0"+ />+ ) : (+ <div className="relative">+ <HighlightedCodeBlock+ code={xlsxViewerUsageCode}+ className="rounded-none border-x-0 border-b-0"+ maxHeightClassName="max-h-56"+ previewLines={10}+ showCopy={false}+ />+ <div className="absolute inset-0 flex items-center justify-center pb-4">+ <div+ className="absolute inset-0"+ style={{+ background:+ "linear-gradient(to top, var(--color-code), color-mix(in oklab, var(--color-code) 60%, transparent), transparent)",+ }}+ />+ <Button+ type="button"+ size="sm"+ variant="outline"+ className="relative z-10 rounded-lg bg-background text-foreground shadow-none hover:bg-muted dark:bg-background dark:text-foreground dark:hover:bg-muted"+ onClick={() => setIsCodeVisible(true)}+ >+ View Code+ </Button>+ </div>+ </div>+ )}+ </div>+ </div>+ )+}++const xlsxViewerUsageCode = `"use client";++import { XlsxViewerPreview } from "@/components/ui/xlsx-viewer";++export function XlsxViewerExample() {+ return <XlsxViewerPreview />;+}`++const xlsxViewerSourceCode = `"use client"++import * as React from "react"+import { createPortal } from "react-dom"+import {+ useXlsxViewer,+ useXlsxViewerController,+ useXlsxViewerThumbnails,+ useXlsxViewerZoom,+ XlsxViewer,+ XlsxViewerProvider,+ type XlsxTableHeaderMenuRenderProps,+} from "@extend-ai/react-xlsx"+import {+ Loading03Icon,+ MinusSignCircleIcon,+ Moon02Icon,+ MoreHorizontalIcon,+ PlusSignCircleIcon,+ Sun03Icon,+ Upload01Icon,+} from "@hugeicons/core-free-icons"+import { HugeiconsIcon } from "@hugeicons/react"+import { useTheme } from "next-themes"++import { cn } from "@/lib/utils"+import { Button } from "@/components/ui/button"+import { ScrollArea } from "@/components/ui/scroll-area"+import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"+import {+ DropdownMenu,+ DropdownMenuContent,+ DropdownMenuItem,+ DropdownMenuRadioGroup,+ DropdownMenuRadioItem,+ DropdownMenuTrigger,+} from "@/registry/new-york-v4/ui/dropdown-menu"+import {+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+} from "@/registry/new-york-v4/ui/select"+import { Separator } from "@/registry/new-york-v4/ui/separator"+import {+ Tooltip,+ TooltipContent,+ TooltipProvider,+ TooltipTrigger,+} from "@/registry/new-york-v4/ui/tooltip"++const SAMPLE_XLSX_URL = "/samples/crazy-chart-zoo.xlsx"+const XLSX_SOURCE_CACHE_LIMIT = 3+const XLSX_LOADING_INDICATOR_DELAY_MS = 300+const XLSX_DROPDOWN_Z_INDEX_CLASS = "z-[100010]"+const ZOOM_OPTIONS = [10, 25, 50, 75, 100, 125, 150, 175, 200, 400] as const++const xlsxWorkbookBufferCache = new Map<string, ArrayBuffer>()+const xlsxWorkbookBufferPromiseCache = new Map<string, Promise<ArrayBuffer>>()++type UploadedWorkbook = {+ buffer: ArrayBuffer+ fileName: string+ identity: string+}++function getWorkbookCacheKey(url: string, fileName?: string) {+ return \`\${url.split("?")[0] ?? url}::\${fileName ?? ""}\`+}++function rememberWorkbookBuffer(cacheKey: string, workbookBuffer: ArrayBuffer) {+ if (xlsxWorkbookBufferCache.has(cacheKey)) {+ xlsxWorkbookBufferCache.delete(cacheKey)+ }++ xlsxWorkbookBufferCache.set(cacheKey, workbookBuffer)++ while (xlsxWorkbookBufferCache.size > XLSX_SOURCE_CACHE_LIMIT) {+ const oldestKey = xlsxWorkbookBufferCache.keys().next().value+ if (!oldestKey) break+ xlsxWorkbookBufferCache.delete(oldestKey)+ }+}++async function loadCachedWorkbookBuffer(+ url: string,+ cacheKey: string+): Promise<ArrayBuffer> {+ const cachedWorkbookBuffer = xlsxWorkbookBufferCache.get(cacheKey)+ if (cachedWorkbookBuffer) return cachedWorkbookBuffer++ const pendingRequest = xlsxWorkbookBufferPromiseCache.get(cacheKey)+ if (pendingRequest) return pendingRequest++ const nextRequest = fetch(url)+ .then(async (response) => {+ if (!response.ok) {+ throw new Error(\`Failed to fetch XLSX (\${response.status})\`)+ }++ const workbookBuffer = await response.arrayBuffer()+ rememberWorkbookBuffer(cacheKey, workbookBuffer)+ return workbookBuffer+ })+ .finally(() => {+ xlsxWorkbookBufferPromiseCache.delete(cacheKey)+ })++ xlsxWorkbookBufferPromiseCache.set(cacheKey, nextRequest)+ return nextRequest+}++function formatWorkbookName(fileName: string | undefined, url: string) {+ if (fileName?.trim()) return fileName++ const pathname = url.split("?")[0] ?? ""+ const rawName = pathname.split("/").pop() ?? "workbook.xlsx"++ try {+ return decodeURIComponent(rawName)+ } catch {+ return rawName+ }+}++function useDelayedLoadingIndicator(isLoading: boolean, delayMs: number) {+ const [showSpinner, setShowSpinner] = React.useState(false)++ React.useEffect(() => {+ if (!isLoading) {+ setShowSpinner(false)+ return+ }++ const timeoutId = window.setTimeout(() => {+ setShowSpinner(true)+ }, delayMs)++ return () => window.clearTimeout(timeoutId)+ }, [delayMs, isLoading])++ return showSpinner+}++function useWorkbookNightRenderPreference() {+ const [nightRenderEnabled, setNightRenderEnabled] = React.useState(false)+ const [nightRenderPrefLoaded, setNightRenderPrefLoaded] =+ React.useState(false)++ React.useEffect(() => {+ const storedValue = window.localStorage.getItem("xlsx-night-render")+ setNightRenderEnabled(storedValue !== "false")+ setNightRenderPrefLoaded(true)+ }, [])++ const updateNightRenderEnabled = React.useCallback((checked: boolean) => {+ setNightRenderEnabled(checked)+ window.localStorage.setItem("xlsx-night-render", String(checked))+ }, [])++ return {+ nightRenderEnabled,+ nightRenderPrefLoaded,+ setNightRenderEnabled: updateNightRenderEnabled,+ }+}++function ToolbarTooltip({+ label,+ children,+}: {+ label: string+ children: React.ReactNode+}) {+ return (+ <Tooltip>+ <TooltipTrigger asChild>+ <span className="inline-flex">{children}</span>+ </TooltipTrigger>+ <TooltipContent side="bottom">{label}</TooltipContent>+ </Tooltip>+ )+}++function ViewerLoadingSurface({ showSpinner = true }: { showSpinner?: boolean }) {+ return (+ <div className="grid h-full min-h-52 w-full min-w-full place-items-center bg-transparent">+ {showSpinner ? (+ <HugeiconsIcon icon={Loading03Icon} className="size-4 animate-spin" />+ ) : null}+ </div>+ )+}++function WorkbookTableHeaderMenu({+ direction,+ sortAscending,+ sortDescending,+ triggerIcon,+ triggerProps,+}: XlsxTableHeaderMenuRenderProps) {+ const [open, setOpen] = React.useState(false)++ return (+ <DropdownMenu open={open} onOpenChange={setOpen}>+ <DropdownMenuTrigger asChild>+ <Button+ {...triggerProps}+ type="button"+ variant="ghost"+ size="icon-sm"+ className={cn("size-6 rounded-sm", triggerProps.className)}+ aria-label="Column menu"+ >+ {triggerIcon ? (+ triggerIcon+ ) : (+ <HugeiconsIcon icon={MoreHorizontalIcon} className="size-3.5" />+ )}+ </Button>+ </DropdownMenuTrigger>+ <DropdownMenuContent+ align="end"+ className={cn("w-40", XLSX_DROPDOWN_Z_INDEX_CLASS)}+ >+ <DropdownMenuRadioGroup+ value={direction ?? ""}+ onValueChange={(value) => {+ if (value === "ascending") {+ sortAscending()+ } else {+ sortDescending()+ }+ setOpen(false)+ }}+ >+ <DropdownMenuRadioItem value="ascending">+ Sort ascending+ </DropdownMenuRadioItem>+ <DropdownMenuRadioItem value="descending">+ Sort descending+ </DropdownMenuRadioItem>+ </DropdownMenuRadioGroup>+ </DropdownMenuContent>+ </DropdownMenu>+ )+}++function WorkbookToolbar({+ isDark,+ onIsDarkChange,+ onUploadClick,+ showNightRenderToggle,+ workbookIdentity,+}: {+ isDark: boolean+ onIsDarkChange: (checked: boolean) => void+ onUploadClick: () => void+ showNightRenderToggle: boolean+ workbookIdentity: string+}) {+ const { canZoomIn, canZoomOut, setZoomScale, zoomIn, zoomOut, zoomScale } =+ useXlsxViewerZoom()+ const currentZoom = Math.round(zoomScale)++ React.useEffect(() => {+ setZoomScale(100)+ }, [setZoomScale, workbookIdentity])++ return (+ <div className="flex min-h-12 items-center justify-end gap-3 overflow-x-auto overflow-y-hidden border-b bg-background px-3">+ <TooltipProvider>+ <div className="ml-auto flex shrink-0 items-center gap-1">+ {showNightRenderToggle ? (+ <>+ <Separator+ orientation="vertical"+ className="mx-1 h-4 self-center"+ />+ <ToolbarTooltip+ label={isDark ? "Use light workbook" : "Use dark workbook"}+ >+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label={+ isDark ? "Use light workbook" : "Use dark workbook"+ }+ onClick={() => onIsDarkChange(!isDark)}+ >+ <HugeiconsIcon+ icon={isDark ? Sun03Icon : Moon02Icon}+ className="size-4"+ />+ </Button>+ </ToolbarTooltip>+ </>+ ) : null}+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <ToolbarTooltip label="Zoom out">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ disabled={!canZoomOut}+ aria-label="Zoom out"+ onClick={zoomOut}+ >+ <HugeiconsIcon icon={MinusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Select+ value={currentZoom.toString()}+ onValueChange={(value) => setZoomScale(Number(value))}+ >+ <SelectTrigger+ size="sm"+ className="w-[84px] min-w-[84px]"+ aria-label="Zoom level"+ >+ <SelectValue>{currentZoom}%</SelectValue>+ </SelectTrigger>+ <SelectContent+ align="end"+ className={XLSX_DROPDOWN_Z_INDEX_CLASS}+ >+ {ZOOM_OPTIONS.map((value) => (+ <SelectItem key={value} value={value.toString()}>+ {value}%+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ <ToolbarTooltip label="Zoom in">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ disabled={!canZoomIn}+ aria-label="Zoom in"+ onClick={zoomIn}+ >+ <HugeiconsIcon icon={PlusSignCircleIcon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ <Separator orientation="vertical" className="mx-1 h-4 self-center" />+ <ToolbarTooltip label="Upload XLSX">+ <Button+ type="button"+ variant="ghost"+ size="icon-sm"+ aria-label="Upload XLSX"+ onClick={onUploadClick}+ >+ <HugeiconsIcon icon={Upload01Icon} className="size-4" />+ </Button>+ </ToolbarTooltip>+ </div>+ </TooltipProvider>+ </div>+ )+}++function WorkbookSheetTabs({ workbookIdentity }: { workbookIdentity: string }) {+ const { activeSheetIndex, setActiveSheetIndex, sheets } = useXlsxViewer()+ const { thumbnails } = useXlsxViewerThumbnails({+ resolution: {+ maxHeight: 360,+ maxWidth: 560,+ },+ })+ const [visiblePreviewIndex, setVisiblePreviewIndex] = React.useState<+ number | null+ >(null)+ const [previewPosition, setPreviewPosition] = React.useState({+ left: 0,+ top: 0,+ })+ const [thumbnailUrls, setThumbnailUrls] = React.useState<+ Record<number, string>+ >({})+ const scrollRef = React.useRef<HTMLDivElement | null>(null)+ const itemRefs = React.useRef<Record<number, HTMLButtonElement | null>>({})+ const openTimeoutRef = React.useRef<ReturnType<typeof setTimeout> | null>(+ null+ )+ const closeTimeoutRef = React.useRef<ReturnType<typeof setTimeout> | null>(+ null+ )+ const previewWidth = 220+ const previewHeight = (previewWidth * 7) / 11+ const previewGap = 12+ const previewOpenDelayMs = 500++ const clearOpenTimeout = React.useCallback(() => {+ if (openTimeoutRef.current) {+ clearTimeout(openTimeoutRef.current)+ openTimeoutRef.current = null+ }+ }, [])++ const clearCloseTimeout = React.useCallback(() => {+ if (closeTimeoutRef.current) {+ clearTimeout(closeTimeoutRef.current)+ closeTimeoutRef.current = null+ }+ }, [])++ const getPreviewPosition = React.useCallback(+ (sheetIndex: number) => {+ const item = itemRefs.current[sheetIndex]+ if (!item || typeof window === "undefined") {+ return { left: 0, top: 0 }+ }++ const itemRect = item.getBoundingClientRect()+ const centeredLeft = itemRect.left + itemRect.width / 2 - previewWidth / 2+ const minLeft = 8+ const maxLeft = Math.max(minLeft, window.innerWidth - previewWidth - 8)+ const left = Math.max(minLeft, Math.min(centeredLeft, maxLeft))+ const top = Math.max(8, itemRect.top - previewHeight - previewGap)++ return { left, top }+ },+ [previewHeight]+ )++ const updatePreviewPosition = React.useCallback(+ (sheetIndex: number) => {+ setPreviewPosition(getPreviewPosition(sheetIndex))+ },+ [getPreviewPosition]+ )++ const handleItemEnter = React.useCallback(+ (sheetIndex: number) => {+ clearCloseTimeout()+ const nextPreviewPosition = getPreviewPosition(sheetIndex)++ if (visiblePreviewIndex !== null) {+ clearOpenTimeout()+ setPreviewPosition(nextPreviewPosition)+ setVisiblePreviewIndex(sheetIndex)+ return+ }++ clearOpenTimeout()+ openTimeoutRef.current = setTimeout(() => {+ setPreviewPosition(nextPreviewPosition)+ setVisiblePreviewIndex(sheetIndex)+ }, previewOpenDelayMs)+ },+ [+ clearCloseTimeout,+ clearOpenTimeout,+ getPreviewPosition,+ visiblePreviewIndex,+ ]+ )++ const handleContainerLeave = React.useCallback(() => {+ clearOpenTimeout()+ clearCloseTimeout()+ closeTimeoutRef.current = setTimeout(() => {+ setVisiblePreviewIndex(null)+ }, 80)+ }, [clearCloseTimeout, clearOpenTimeout])++ React.useEffect(() => {+ return () => {+ clearOpenTimeout()+ clearCloseTimeout()+ }+ }, [clearCloseTimeout, clearOpenTimeout])++ React.useEffect(() => {+ clearOpenTimeout()+ clearCloseTimeout()+ setVisiblePreviewIndex(null)+ setPreviewPosition({ left: 0, top: 0 })+ setThumbnailUrls({})+ }, [clearCloseTimeout, clearOpenTimeout, workbookIdentity])++ React.useEffect(() => {+ thumbnails.forEach((thumbnail) => {+ if (thumbnailUrls[thumbnail.sheetIndex]) return++ const canvas = document.createElement("canvas")+ canvas.width = thumbnail.width+ canvas.height = thumbnail.height++ if (!thumbnail.paint(canvas)) return++ const nextUrl = canvas.toDataURL("image/png")+ setThumbnailUrls((current) => {+ if (current[thumbnail.sheetIndex]) return current++ return {+ ...current,+ [thumbnail.sheetIndex]: nextUrl,+ }+ })+ })+ }, [thumbnailUrls, thumbnails])++ React.useEffect(() => {+ if (visiblePreviewIndex === null) return++ const handleReposition = () => updatePreviewPosition(visiblePreviewIndex)+ handleReposition()++ const scrollElement = scrollRef.current+ window.addEventListener("resize", handleReposition)+ scrollElement?.addEventListener("scroll", handleReposition, {+ passive: true,+ })++ return () => {+ window.removeEventListener("resize", handleReposition)+ scrollElement?.removeEventListener("scroll", handleReposition)+ }+ }, [updatePreviewPosition, visiblePreviewIndex])++ if (sheets.length <= 1) return null++ const previewUrl =+ visiblePreviewIndex === null ? null : thumbnailUrls[visiblePreviewIndex]+ const previewSheet =+ visiblePreviewIndex === null ? null : sheets[visiblePreviewIndex]++ return (+ <div+ className="border-t bg-muted/40 px-3 py-2"+ onMouseLeave={handleContainerLeave}+ >+ <Tabs+ value={String(activeSheetIndex)}+ onValueChange={(value) => setActiveSheetIndex(Number(value))}+ className="gap-0"+ >+ <ScrollArea+ orientation="horizontal"+ className="h-8 w-full"+ viewportClassName="overflow-y-hidden"+ viewportRef={scrollRef}+ >+ <TabsList className="rounded-none bg-transparent p-0">+ {sheets.map((sheet, index) => (+ <TabsTrigger+ key={\`\${sheet.workbookSheetIndex}-\${sheet.name}\`}+ ref={(node) => {+ itemRefs.current[index] = node+ }}+ value={String(index)}+ className="h-8 max-w-48 flex-none rounded-md border border-transparent px-3 shadow-none data-active:border-input data-active:bg-background"+ onMouseEnter={() => handleItemEnter(index)}+ >+ <span className="truncate">{sheet.name}</span>+ </TabsTrigger>+ ))}+ </TabsList>+ </ScrollArea>+ </Tabs>+ {typeof document !== "undefined" && previewSheet+ ? createPortal(+ <div+ className={cn(+ "pointer-events-none fixed z-[2147483647] overflow-hidden rounded-lg border bg-background/95 shadow-xl backdrop-blur-md transition-[opacity,transform] duration-100",+ previewUrl+ ? "opacity-100 translate-y-0"+ : "opacity-0 translate-y-1"+ )}+ style={{+ left: previewPosition.left,+ top: previewPosition.top,+ width: previewWidth,+ }}+ >+ <div className="relative aspect-[11/7] w-full overflow-hidden bg-muted/60">+ {previewUrl ? (+ <img+ src={previewUrl}+ alt={\`\${previewSheet.name} preview\`}+ className="absolute inset-0 size-full object-cover object-left-top"+ draggable={false}+ />+ ) : (+ <div className="grid size-full place-items-center">+ <HugeiconsIcon+ icon={Loading03Icon}+ className="size-4 animate-spin text-muted-foreground"+ />+ </div>+ )}+ </div>+ </div>,+ document.body+ )+ : null}+ </div>+ )+}++function WorkbookSurface({+ isDark,+ onIsDarkChange,+ onUploadClick,+ renderTableHeaderMenu,+ rounded,+ showNightRenderToggle,+ workbookIdentity,+}: {+ isDark: boolean+ onIsDarkChange: (checked: boolean) => void+ onUploadClick: () => void+ renderTableHeaderMenu: (props: XlsxTableHeaderMenuRenderProps) => React.ReactNode+ rounded: boolean+ showNightRenderToggle: boolean+ workbookIdentity: string+}) {+ const { error } = useXlsxViewer()++ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ rounded && "rounded-lg"+ )}+ >+ <WorkbookToolbar+ isDark={isDark}+ onIsDarkChange={onIsDarkChange}+ onUploadClick={onUploadClick}+ showNightRenderToggle={showNightRenderToggle}+ workbookIdentity={workbookIdentity}+ />+ <div className="flex min-h-0 flex-1 flex-col">+ <ScrollArea+ orientation="both"+ className="min-h-0 flex-1 bg-muted/20"+ viewportClassName="min-h-0"+ >+ <XlsxViewer+ experimentalCanvas+ allowResizeInReadOnly+ className="h-full min-h-0 min-w-0"+ height="100%"+ isDark={isDark}+ readOnly+ rounded={false}+ showDefaultToolbar={false}+ showImages+ fileTooLargeState={+ <div className="grid h-full w-full min-w-full place-items-center p-6">+ <div className="max-w-sm rounded-lg border bg-background p-4 text-sm">+ <p className="font-medium">File too large</p>+ <p className="mt-1 text-muted-foreground">+ This workbook exceeds the display limit. Download it to view+ the full file.+ </p>+ </div>+ </div>+ }+ loadingState={<ViewerLoadingSurface />}+ errorState={+ <div className="grid h-full w-full min-w-full place-items-center p-6 text-sm text-destructive">+ {error?.message ?? "Unable to display workbook."}+ </div>+ }+ renderTableHeaderMenu={renderTableHeaderMenu}+ />+ </ScrollArea>+ <WorkbookSheetTabs workbookIdentity={workbookIdentity} />+ </div>+ </div>+ )+}++export function XlsxViewerPreview({+ className,+ fileName,+ rounded = false,+ src = SAMPLE_XLSX_URL,+}: {+ className?: string+ fileName?: string+ rounded?: boolean+ src?: string+}) {+ const { resolvedTheme } = useTheme()+ const {+ nightRenderEnabled,+ nightRenderPrefLoaded,+ setNightRenderEnabled,+ } = useWorkbookNightRenderPreference()+ const isViewerHydrated = resolvedTheme !== undefined && nightRenderPrefLoaded+ const shouldShowHydrationSpinner = useDelayedLoadingIndicator(+ !isViewerHydrated,+ XLSX_LOADING_INDICATOR_DELAY_MS+ )++ if (!isViewerHydrated) {+ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <div+ className={cn(+ "min-h-0 flex-1 overflow-hidden bg-muted/30 p-4",+ rounded && "rounded-b-lg"+ )}+ >+ <ViewerLoadingSurface showSpinner={shouldShowHydrationSpinner} />+ </div>+ </div>+ )+ }++ const shouldRenderNightMode = resolvedTheme === "dark"+ const effectiveIsDark = shouldRenderNightMode && nightRenderEnabled++ return (+ <XlsxViewerContent+ className={className}+ effectiveIsDark={effectiveIsDark}+ fileName={fileName}+ rounded={rounded}+ setNightRenderEnabled={setNightRenderEnabled}+ shouldRenderNightMode={shouldRenderNightMode}+ url={src}+ />+ )+}++function XlsxViewerContent({+ className,+ effectiveIsDark,+ fileName,+ rounded,+ setNightRenderEnabled,+ shouldRenderNightMode,+ url,+}: {+ className?: string+ effectiveIsDark: boolean+ fileName?: string+ rounded: boolean+ setNightRenderEnabled: (checked: boolean) => void+ shouldRenderNightMode: boolean+ url: string+}) {+ const fileInputRef = React.useRef<HTMLInputElement>(null)+ const displayFileName = React.useMemo(+ () => formatWorkbookName(fileName, url),+ [fileName, url]+ )+ const cacheKey = React.useMemo(+ () => getWorkbookCacheKey(url, displayFileName),+ [displayFileName, url]+ )+ const [workbookBuffer, setWorkbookBuffer] =+ React.useState<ArrayBuffer | null>(+ () => xlsxWorkbookBufferCache.get(cacheKey) ?? null+ )+ const [uploadedWorkbook, setUploadedWorkbook] =+ React.useState<UploadedWorkbook | null>(null)+ const [loadError, setLoadError] = React.useState<string>()+ const shouldShowLoadingSpinner = useDelayedLoadingIndicator(+ !workbookBuffer && !loadError && !uploadedWorkbook,+ XLSX_LOADING_INDICATOR_DELAY_MS+ )++ React.useEffect(() => {+ let isCurrent = true+ setUploadedWorkbook(null)++ async function loadWorkbook(): Promise<void> {+ setWorkbookBuffer(xlsxWorkbookBufferCache.get(cacheKey) ?? null)+ setLoadError(undefined)++ try {+ const nextWorkbookBuffer = await loadCachedWorkbookBuffer(url, cacheKey)+ if (!isCurrent) return++ setWorkbookBuffer(nextWorkbookBuffer)+ } catch (error) {+ if (!isCurrent) return++ setLoadError(+ error instanceof Error ? error.message : "Unknown XLSX load error"+ )+ }+ }++ void loadWorkbook()++ return () => {+ isCurrent = false+ }+ }, [cacheKey, url])++ async function handleUpload(event: React.ChangeEvent<HTMLInputElement>) {+ const file = event.target.files?.[0]+ event.target.value = ""++ if (!file) return++ const buffer = await file.arrayBuffer()+ setLoadError(undefined)+ setUploadedWorkbook({+ buffer,+ fileName: file.name,+ identity: \`\${file.name}-\${file.size}-\${file.lastModified}\`,+ })+ }++ const activeBuffer = uploadedWorkbook?.buffer ?? workbookBuffer+ const activeFileName = uploadedWorkbook?.fileName ?? displayFileName+ const activeIdentity = uploadedWorkbook?.identity ?? cacheKey++ if (loadError && !activeBuffer) {+ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <input+ ref={fileInputRef}+ type="file"+ accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"+ className="hidden"+ onChange={handleUpload}+ />+ <div className="grid min-h-0 flex-1 place-items-center bg-muted/30 p-4">+ <div className="max-w-md rounded-lg border bg-background p-4 text-sm">+ <p className="font-medium">Unable to display workbook</p>+ <p className="mt-1 text-muted-foreground">{loadError}</p>+ <Button+ type="button"+ variant="outline"+ size="sm"+ className="mt-4"+ onClick={() => fileInputRef.current?.click()}+ >+ <HugeiconsIcon icon={Upload01Icon} className="size-4" />+ Upload XLSX+ </Button>+ </div>+ </div>+ </div>+ )+ }++ if (!activeBuffer) {+ return (+ <div+ className={cn(+ "flex h-[640px] min-h-0 flex-col overflow-hidden bg-background",+ className+ )}+ >+ <input+ ref={fileInputRef}+ type="file"+ accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"+ className="hidden"+ onChange={handleUpload}+ />+ <ViewerLoadingSurface showSpinner={shouldShowLoadingSpinner} />+ </div>+ )+ }++ return (+ <div className={cn("overflow-hidden", className)}>+ <input+ ref={fileInputRef}+ type="file"+ accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel"+ className="hidden"+ onChange={handleUpload}+ />+ <XlsxWorkbookLoadedViewer+ fileName={activeFileName}+ isDark={effectiveIsDark}+ onIsDarkChange={setNightRenderEnabled}+ onUploadClick={() => fileInputRef.current?.click()}+ renderTableHeaderMenu={(props) => <WorkbookTableHeaderMenu {...props} />}+ rounded={rounded}+ showNightRenderToggle={shouldRenderNightMode}+ workbookBuffer={activeBuffer}+ workbookIdentity={activeIdentity}+ />+ </div>+ )+}++function XlsxWorkbookLoadedViewer({+ fileName,+ isDark,+ onIsDarkChange,+ onUploadClick,+ renderTableHeaderMenu,+ rounded,+ showNightRenderToggle,+ workbookBuffer,+ workbookIdentity,+}: {+ fileName: string+ isDark: boolean+ onIsDarkChange: (checked: boolean) => void+ onUploadClick: () => void+ renderTableHeaderMenu: (props: XlsxTableHeaderMenuRenderProps) => React.ReactNode+ rounded: boolean+ showNightRenderToggle: boolean+ workbookBuffer: ArrayBuffer+ workbookIdentity: string+}) {+ const controller = useXlsxViewerController(+ React.useMemo(+ () => ({+ allowResizeInReadOnly: true,+ file: workbookBuffer,+ fileName,+ readOnly: true,+ useWorker: true,+ }),+ [fileName, workbookBuffer]+ )+ )++ return (+ <XlsxViewerProvider controller={controller} isDark={isDark}>+ <WorkbookSurface+ isDark={isDark}+ onIsDarkChange={onIsDarkChange}+ onUploadClick={onUploadClick}+ renderTableHeaderMenu={renderTableHeaderMenu}+ rounded={rounded}+ showNightRenderToggle={showNightRenderToggle}+ workbookIdentity={workbookIdentity}+ />+ </XlsxViewerProvider>+ )+}+`++export function XlsxViewerSource() {+ return <HighlightedCodeBlock code={xlsxViewerSourceCode} />+}diff --git a/apps/v4/content/docs/components/csv-tsv-viewer.mdx b/apps/v4/content/docs/components/csv-tsv-viewer.mdxindex c8084aa..5473da5 100644--- a/apps/v4/content/docs/components/csv-tsv-viewer.mdx+++ b/apps/v4/content/docs/components/csv-tsv-viewer.mdx@@ -59,10 +59,12 @@ import "@glideapps/glide-data-grid/dist/index.css"- Header controls for upload, row and column counts, and zoom.- Grid zoom that scales row height, header height, column width, and cell text.-## Common slots+## API Reference-| Slot | Purpose |-| ------------- | ------------------------------------------------------ |-| `toolbar` | File summary, zoom controls, and CSV upload actions. |-| `grid` | Virtualized Glide Data Grid table surface. |-| `parseErrors` | Malformed rows, encoding issues, and delimiter errors. |+### CsvViewer++The CsvViewer component renders its built-in CSV/TSV upload flow, parser state, zoom controls, and virtualized grid.++| Prop | Type | Default | Required |+| ---- | ---- | ------- | -------- |+| `-` | `-` | `-` | No |diff --git a/apps/v4/content/docs/components/docx-viewer.mdx b/apps/v4/content/docs/components/docx-viewer.mdxindex c4e7f4e..b36b0ee 100644--- a/apps/v4/content/docs/components/docx-viewer.mdx+++ b/apps/v4/content/docs/components/docx-viewer.mdx@@ -7,6 +7,46 @@ featured: trueThe DOCX Viewer is for contracts, proposals, reports, and internal docs where visual structure matters more than plain text extraction.+<DocxViewerDemo />++## Installation++<CodeTabs>++<TabsList>+ <TabsTrigger value="cli">Command</TabsTrigger>+ <TabsTrigger value="manual">Manual</TabsTrigger>+</TabsList>+<TabsContent value="cli">++```bash+npx shadcn@latest add docx-viewer+```++</TabsContent>++<TabsContent value="manual">++<Steps className="mb-0 pt-2">++<Step>Install the following dependencies:</Step>++```bash+npm install @extend-ai/react-docx+```++<Step>Copy and paste the following code into your project.</Step>++<DocxViewerSource />++<Step>Update the import paths to match your project setup.</Step>++</Steps>++</TabsContent>++</CodeTabs>+## Useful behaviors- Preserve headings, lists, tables, images, headers, footers, and page breaks.@@ -14,10 +54,15 @@ The DOCX Viewer is for contracts, proposals, reports, and internal docs where vi- Support comments, tracked-change surfaces, and copyable text.- Provide a predictable fallback state for unsupported Word features.-## Common slots+## API Reference++### DocxViewerPreview++The DocxViewerPreview component renders a DOCX file with upload, theme, and zoom controls around the `@extend-ai/react-docx` viewer.-| Slot | Purpose |-| ------------- | ------------------------------------------------------- |-| `toolbar` | Zoom, layout mode, page navigation, and export actions. |-| `outline` | Headings and section navigation. |-| `reviewPanel` | Comments, redlines, and unresolved changes. |+| Prop | Type | Default | Required |+| ----------- | --------- | ---------------------- | -------- |+| `className` | `string` | `-` | No |+| `fileName` | `string` | `-` | No |+| `rounded` | `boolean` | `false` | No |+| `src` | `string` | `"/samples/demo.docx"` | No |diff --git a/apps/v4/content/docs/components/file-thumbnail.mdx b/apps/v4/content/docs/components/file-thumbnail.mdxindex 9a753bb..b545d46 100644--- a/apps/v4/content/docs/components/file-thumbnail.mdx+++ b/apps/v4/content/docs/components/file-thumbnail.mdx@@ -1,10 +1,10 @@---title: File Thumbnail-description: Render a compact first-page preview for PDFs and direct image previews for image files.+description: Render compact file preview images with a skeleton, fade transition, metadata, and fallback state.component: true----File Thumbnail gives document lists, upload queues, and attachment trays a fast visual preview without mounting a full viewer.+File Thumbnail gives document lists, upload queues, and attachment trays a consistent preview shell. The core component only renders an image URL, loading state, metadata, and fallback icon; generate PDF, DOCX, or XLSX preview images outside the component with the viewer libraries you already use.<FileThumbnailDemo />@@ -28,12 +28,6 @@ npx shadcn@latest add file-thumbnail<Steps className="mb-0 pt-2">-<Step>Install the following dependencies:</Step>--```bash-npm install react-pdf-```-<Step>Copy and paste the following code into your project.</Step><FileThumbnailSource />@@ -46,17 +40,47 @@ npm install react-pdf</CodeTabs>-## Useful behaviors+## Document Previews++The preview can come from an image URL or a rendered preview node. For document thumbnails, the code example above shows:++```bash+npm install react-pdf @extend-ai/react-docx @extend-ai/react-xlsx+```++- Use `react-pdf` to render a first-page PDF thumbnail to a hidden canvas, then pass the resulting object URL to `previewImageUrl`.+- Use `@extend-ai/react-docx` `useDocxViewerThumbnails` to attach a first-page DOCX thumbnail canvas outside the core component.+- Use `@extend-ai/react-xlsx` `useXlsxViewerThumbnails` to paint a sheet thumbnail to a canvas, then pass the data URL to `previewImageUrl`.++## Useful Behaviors++- Keeps the reusable component free of PDF, DOCX, and XLSX renderer dependencies.+- Shows a shimmering file-preview state while an external preview is being generated or loaded.+- Fades the preview in after it loads.+- Falls back to a compact file icon when no preview image is available or image loading fails.+- Supports optional metadata for file name, type, size, page count, or processing status.++## API Reference++### FileThumbnail++The FileThumbnail component renders the reusable thumbnail shell. It accepts externally generated image URLs or preview content without depending on PDF, DOCX, or XLSX renderers.-- Uses `react-pdf` `Thumbnail` for the first page instead of mounting a full PDF page viewer.-- Lazily mounts PDF rendering when the thumbnail approaches the viewport.-- Uses a native `img` tag for image files with browser-level lazy loading and async decoding.-- Shows a shimmering file-preview state while PDF thumbnails render.-- Falls back to a compact file icon when the preview cannot render.+| Prop | Type | Default | Required |+| ------------------ | ----------------- | ------- | -------- |+| `file` | `ThumbnailFile` | `-` | Yes |+| `className` | `string` | `-` | No |+| `previewClassName` | `string` | `-` | No |+| `previewContent` | `React.ReactNode` | `-` | No |+| `previewImageUrl` | `string \| null` | `-` | No |+| `isLoading` | `boolean` | `false` | No |+| `hasError` | `boolean` | `false` | No |+| `showMetadata` | `boolean` | `true` | No |-## Common slots+### ThumbnailFile-| Slot | Purpose |-| ---------- | ---------------------------------------------------------- |-| `preview` | First-page PDF thumbnail, image preview, or fallback icon. |-| `metadata` | File name, type, size, page count, or processing status. |+| Prop | Type | Default | Required |+| ------ | -------- | ------- | -------- |+| `name` | `string` | `-` | Yes |+| `type` | `string` | `-` | Yes |+| `size` | `string` | `-` | No |diff --git a/apps/v4/content/docs/components/file-upload.mdx b/apps/v4/content/docs/components/file-upload.mdxindex 047dfc3..5f7acdd 100644--- a/apps/v4/content/docs/components/file-upload.mdx+++ b/apps/v4/content/docs/components/file-upload.mdx@@ -55,11 +55,23 @@ npm install border-beam- Batch upload summaries for mixed PDFs, DOCX files, Excel workbooks, images, and CSVs.- Hooks for parsing, extraction, review, or routing once files are accepted.-## Common slots--| Slot | Purpose |-| ------------------- | ---------------------------------------------------------------- |-| `dropzone` | Primary drag-and-drop and browse surface. |-| `fileItem` | Individual file row with name, type, size, progress, and status. |-| `validationMessage` | File-level or batch-level errors and warnings. |-| `actions` | Retry, cancel, remove, or continue controls. |+## API Reference++### FileUpload++The FileUpload component renders a drag-and-drop file picker, validates accepted files, and keeps an internal upload queue unless you mirror it through callbacks.++| Prop | Type | Default | Required |+| ------------------- | ----------------------------------- | ------------------------------------- | -------- |+| `accept` | `string` | `-` | No |+| `acceptedFileTypes` | `AcceptedFileType[]` | Image, PDF, and Sheet icons | No |+| `browseLabel` | `string` | `"Browse files"` | No |+| `className` | `string` | `-` | No |+| `description` | `string` | `"PDF, DOCX, XLSX, CSV, PNG, or JPG"` | No |+| `draggingLabel` | `string` | `"Drop to add"` | No |+| `multiple` | `boolean` | `true` | No |+| `showBorderBeam` | `boolean` | `true` | No |+| `showFileList` | `boolean` | `true` | No |+| `title` | `string` | `"Click to upload or drop files"` | No |+| `onFilesAccepted` | `(files: File[]) => void` | `-` | No |+| `onFilesChange` | `(files: FileUploadItem[]) => void` | `-` | No |diff --git a/apps/v4/content/docs/components/pdf-viewer.mdx b/apps/v4/content/docs/components/pdf-viewer.mdxindex 28e520d..ae57c55 100644--- a/apps/v4/content/docs/components/pdf-viewer.mdx+++ b/apps/v4/content/docs/components/pdf-viewer.mdx@@ -60,10 +60,30 @@ import "react-pdf/dist/Page/TextLayer.css"- Optional citation anchors, OCR block overlays, e-signature fields, search highlights, and annotation layer.- Text layer support for selection, copy, search, and accessibility.-## Common slots--| Slot | Purpose |-| --------- | -------------------------------------------------------- |-| `toolbar` | Page navigation, zoom, rotate, and download controls. |-| `sidebar` | Citations, OCR results, signing status, or search. |-| `overlay` | Citations, OCR blocks, signing fields, and search marks. |+## API Reference++### PDFViewer++The PDFViewer component renders a scrollable PDF surface with toolbar controls, lazy page rendering, uploads, and page-level extension hooks.++| Prop | Type | Default | Required |+| ----------------------- | --------------------------------------------------------- | -------------------------- | -------- |+| `file` | `string` | `"/samples/attention.pdf"` | No |+| `className` | `string` | `-` | No |+| `defaultZoom` | `number` | `0.75` | No |+| `pageWidth` | `number` | `612` | No |+| `pageHeight` | `number` | `792` | No |+| `pageNumbers` | `number[]` | `-` | No |+| `pageRenderBuffer` | `number` | `2` | No |+| `showRotateControls` | `boolean` | `true` | No |+| `showUpload` | `boolean` | `true` | No |+| `toolbarActions` | `React.ReactNode` | `-` | No |+| `pageClassName` | `(pageNumber: number) => string \| undefined` | `-` | No |+| `renderPageOverlay` | `(props: PDFViewerPageOverlayProps) => React.ReactNode` | `-` | No |+| `onActivePageChange` | `(pageNumber: number) => void` | `-` | No |+| `onDocumentLoadSuccess` | `(numPages: number) => void` | `-` | No |+| `onPdfUpload` | `(file: File) => void` | `-` | No |+| `onPagePointerDown` | `(event: React.PointerEvent, pageNumber: number) => void` | `-` | No |+| `onPagePointerMove` | `(event: React.PointerEvent, pageNumber: number) => void` | `-` | No |+| `onPagePointerUp` | `(event: React.PointerEvent, pageNumber: number) => void` | `-` | No |+| `onPagePointerCancel` | `(event: React.PointerEvent, pageNumber: number) => void` | `-` | No |diff --git a/apps/v4/content/docs/components/pdf-viewer/citations.mdx b/apps/v4/content/docs/components/pdf-viewer/citations.mdxindex c2241fe..6296c55 100644--- a/apps/v4/content/docs/components/pdf-viewer/citations.mdx+++ b/apps/v4/content/docs/components/pdf-viewer/citations.mdx@@ -49,9 +49,19 @@ npx shadcn@latest add citations- Citation lists grouped by answer, field, or reviewer note.- Empty and unresolved states when the cited page or region is unavailable.-## Common slots--| Slot | Purpose |-| ---------- | --------------------------------------------- |-| `citation` | Source page, label, confidence, and snippet. |-| `anchor` | Page region or text range highlighted in PDF. |+## API Reference++### CitationCard++The CitationCard component renders a clickable citation result that can focus a related PDF page or region.++| Prop | Type | Default | Required |+| ----------------- | ----------------------------------------------- | ------------------------------------ | -------- |+| `label` | `string` | `-` | Yes |+| `value` | `string` | `-` | Yes |+| `snippet` | `string` | `-` | No |+| `pageLabel` | `string` | `-` | No |+| `active` | `boolean` | `false` | No |+| `accentClassName` | `string` | `"border-blue-500/60 bg-blue-500/5"` | No |+| `className` | `string` | `-` | No |+| `...props` | `React.ButtonHTMLAttributes<HTMLButtonElement>` | `-` | No |diff --git a/apps/v4/content/docs/components/pdf-viewer/document-splits.mdx b/apps/v4/content/docs/components/pdf-viewer/document-splits.mdxindex 9c33abf..3e6be27 100644--- a/apps/v4/content/docs/components/pdf-viewer/document-splits.mdx+++ b/apps/v4/content/docs/components/pdf-viewer/document-splits.mdx@@ -33,7 +33,7 @@ npx shadcn@latest add document-splits<Step>Install the following dependencies:</Step>```bash-npm install react-pdf pdfjs-dist @dnd-kit/core @dnd-kit/sortable @dnd-kit/utilities @hugeicons/react @hugeicons/core-free-icons+npm install react-pdf pdfjs-dist @dnd-kit/core @dnd-kit/sortable @dnd-kit/utilities```<Step>Copy and paste the following code into your project.</Step>@@ -55,10 +55,27 @@ npm install react-pdf pdfjs-dist @dnd-kit/core @dnd-kit/sortable @dnd-kit/utilit- Vertically scrollable split groups with horizontally scrolling page rows.- Pair with the PDF Viewer block when selected pages should scroll the document canvas.-## Common slots--| Slot | Purpose |-| ----------- | --------------------------------------------------- |-| `split` | A grouped output document with ordered pages. |-| `thumbnail` | A draggable page preview rendered only when needed. |-| `actions` | Add, remove, split, and export controls. |+## API Reference++### DocumentSplits++The DocumentSplits component renders controlled split groups and paints cached page images through FileThumbnail.++| Prop | Type | Default | Required |+| ------------------ | ------------------------------------------------ | ------- | -------- |+| `splits` | `DocumentSplit[]` | `-` | Yes |+| `thumbnailImages` | `Record<DocumentSplitItemId, string>` | `{}` | No |+| `onSplitsChange` | `(splits: DocumentSplit[]) => void` | `-` | Yes |+| `activePage` | `number` | `-` | No |+| `activeItemId` | `DocumentSplitItemId` | `-` | No |+| `onSelectPage` | `(pageNumber: number) => void` | `-` | No |+| `onSelectItem` | `(itemId: DocumentSplitItemId) => void` | `-` | No |+| `getItemFile` | `(itemId: DocumentSplitItemId) => ThumbnailFile` | PDF | No |+| `getItemLabel` | `(itemId: DocumentSplitItemId) => ReactNode` | page # | No |+| `getSplitLabel` | `(split: DocumentSplit) => string` | pages | No |+| `thumbnailSize` | `{ width: number; height: number }` | PDF | No |+| `labelPlacement` | `"corner" \| "bottom"` | corner | No |+| `onAddSplit` | `() => void` | `-` | No |+| `onRemoveSplit` | `(groupId: string) => void` | `-` | No |+| `withFrameDivider` | `boolean` | `true` | No |+| `className` | `string` | `-` | No |diff --git a/apps/v4/content/docs/components/pdf-viewer/e-signature.mdx b/apps/v4/content/docs/components/pdf-viewer/e-signature.mdxindex 603bdde..8c754a5 100644--- a/apps/v4/content/docs/components/pdf-viewer/e-signature.mdx+++ b/apps/v4/content/docs/components/pdf-viewer/e-signature.mdx@@ -55,10 +55,20 @@ npm install signature_pad- Required-field validation before submit.- Audit-friendly signed, pending, and declined states.-## Common slots--| Slot | Purpose |-| ---------- | -------------------------------------------- |-| `field` | Signature or form field positioned on a PDF. |-| `status` | Recipient and completion state. |-| `controls` | Review, clear, decline, or submit actions. |+## API Reference++### SignatureFieldCard++The SignatureFieldCard component renders a signature field summary with status, recipient context, and an optional action.++| Prop | Type | Default | Required |+| --------------- | -------------------------------------- | --------------------------------------------------- | -------- |+| `label` | `string` | `-` | Yes |+| `status` | `"unsigned" \| "signed" \| "optional"` | `"unsigned"` | No |+| `pageLabel` | `string` | `-` | No |+| `description` | `string` | `-` | No |+| `iconClassName` | `string` | `"bg-blue-500/10 text-blue-600 dark:text-blue-300"` | No |+| `actionLabel` | `string` | `"Sign"` or `"Edit signature"` | No |+| `onAction` | `() => void` | `-` | No |+| `className` | `string` | `-` | No |+| `...props` | `React.HTMLAttributes<HTMLDivElement>` | `-` | No |diff --git a/apps/v4/content/docs/components/pdf-viewer/human-review.mdx b/apps/v4/content/docs/components/pdf-viewer/human-review.mdxindex 22d2ed6..98de48c 100644--- a/apps/v4/content/docs/components/pdf-viewer/human-review.mdx+++ b/apps/v4/content/docs/components/pdf-viewer/human-review.mdx@@ -33,7 +33,7 @@ npx shadcn@latest add human-review<Step>Install the following dependencies:</Step>```bash-npm install @pierre/diffs @hugeicons/react @hugeicons/core-free-icons+npm install @pierre/diffs```<Step>Copy and paste the following code into your project.</Step>@@ -55,11 +55,24 @@ npm install @pierre/diffs @hugeicons/react @hugeicons/core-free-icons- Per-field undo and Set to NULL actions.- Form and JSON diff views for the same reviewed output state.-## Common slots+## API Reference-| Slot | Purpose |-| ---------- | ----------------------------------------------------- |-| `field` | A schema property, extracted value, and review value. |-| `actual` | Read-only machine output for comparison. |-| `expected` | Editable reviewed output for correction. |-| `diff` | JSON-level actual versus expected comparison. |+### HumanReviewPanel++The HumanReviewPanel component renders editable review fields and a JSON diff for the same extraction output.++| Prop | Type | Default | Required |+| ---------------- | ------------------------------ | ------- | -------- |+| `fields` | `ReviewField[]` | `-` | Yes |+| `values` | `JsonObject` | `-` | Yes |+| `onValuesChange` | `(values: JsonObject) => void` | `-` | Yes |+| `className` | `string` | `-` | No |++### ReviewField++| Prop | Type | Default | Required |+| ---------- | ------------------- | ------- | -------- |+| `key` | `string` | `-` | Yes |+| `schema` | `ReviewFieldSchema` | `-` | Yes |+| `actual` | `JsonPrimitive` | `-` | Yes |+| `expected` | `JsonPrimitive` | `-` | Yes |diff --git a/apps/v4/content/docs/components/pdf-viewer/ocr-blocks.mdx b/apps/v4/content/docs/components/pdf-viewer/ocr-blocks.mdxindex dbacbe9..7d24006 100644--- a/apps/v4/content/docs/components/pdf-viewer/ocr-blocks.mdx+++ b/apps/v4/content/docs/components/pdf-viewer/ocr-blocks.mdx@@ -30,12 +30,6 @@ npx shadcn@latest add ocr-blocks<Steps className="mb-0 pt-2">-<Step>Install the following dependencies:</Step>--```bash-npm install @hugeicons/react @hugeicons/core-free-icons-```-<Step>Copy and paste the following code into your project.</Step><OcrBlocksSource />@@ -55,9 +49,22 @@ npm install @hugeicons/react @hugeicons/core-free-icons- Hover and selection states that reveal text and geometry.- Region navigation from OCR results to the rendered PDF page.-## Common slots--| Slot | Purpose |-| --------- | -------------------------------------------- |-| `overlay` | OCR boxes positioned over the rendered page. |-| `details` | Selected text, confidence, and coordinates. |+## API Reference++### OcrBlockCard++The OcrBlockCard component renders a selectable OCR result with label, type, text, confidence, and page context.++| Prop | Type | Default | Required |+| ----------------- | ---------------------------------------------------- | --------------------------------------------------- | -------- |+| `label` | `string` | `-` | Yes |+| `kind` | `string` | `-` | Yes |+| `text` | `string` | `-` | Yes |+| `confidence` | `number` | `-` | No |+| `pageLabel` | `string` | `-` | No |+| `icon` | `React.ComponentProps<typeof HugeiconsIcon>["icon"]` | `ParagraphIcon` | No |+| `active` | `boolean` | `false` | No |+| `iconClassName` | `string` | `"bg-blue-500/10 text-blue-600 dark:text-blue-300"` | No |+| `activeClassName` | `string` | `"border-blue-500/60 bg-blue-500/5"` | No |+| `className` | `string` | `-` | No |+| `...props` | `React.ButtonHTMLAttributes<HTMLButtonElement>` | `-` | No |diff --git a/apps/v4/content/docs/components/xlsx-viewer.mdx b/apps/v4/content/docs/components/xlsx-viewer.mdxindex c896b0a..0362e62 100644--- a/apps/v4/content/docs/components/xlsx-viewer.mdx+++ b/apps/v4/content/docs/components/xlsx-viewer.mdx@@ -7,6 +7,46 @@ featured: trueThe Excel Viewer is the core spreadsheet preview for financial models, imports, exports, schedules, and operational reports.+<XlsxViewerDemo />++## Installation++<CodeTabs>++<TabsList>+ <TabsTrigger value="cli">Command</TabsTrigger>+ <TabsTrigger value="manual">Manual</TabsTrigger>+</TabsList>+<TabsContent value="cli">++```bash+npx shadcn@latest add xlsx-viewer+```++</TabsContent>++<TabsContent value="manual">++<Steps className="mb-0 pt-2">++<Step>Install the following dependencies:</Step>++```bash+npm install @extend-ai/react-xlsx+```++<Step>Copy and paste the following code into your project.</Step>++<XlsxViewerSource />++<Step>Update the import paths to match your project setup.</Step>++</Steps>++</TabsContent>++</CodeTabs>+## Useful behaviors- Sheet tabs, grid virtualization, column resizing, and frozen rows or columns.@@ -14,10 +54,15 @@ The Excel Viewer is the core spreadsheet preview for financial models, imports,- Search across sheets and cell ranges.- Optional metadata for workbook properties, hidden sheets, and named ranges.-## Common slots+## API Reference++### XlsxViewerPreview++The XlsxViewerPreview component renders an Excel workbook with upload, theme, zoom, sheet navigation, and grid controls around the `@extend-ai/react-xlsx` viewer.-| Slot | Purpose |-| ------------ | -------------------------------------- |-| `sheetTabs` | Workbook sheet navigation. |-| `formulaBar` | Selected cell value, formula, or note. |-| `statusBar` | Selection summary and range metadata. |+| Prop | Type | Default | Required |+| ----------- | --------- | --------------------------------- | -------- |+| `className` | `string` | `-` | No |+| `fileName` | `string` | `-` | No |+| `rounded` | `boolean` | `false` | No |+| `src` | `string` | `"/samples/crazy-chart-zoo.xlsx"` | No |diff --git a/apps/v4/lib/page-tree.ts b/apps/v4/lib/page-tree.tsindex d7afb5b..6b99de3 100644--- a/apps/v4/lib/page-tree.ts+++ b/apps/v4/lib/page-tree.ts@@ -43,11 +43,10 @@ export function getPagesFromFolder(}}- // Fallback: return direct component pages. Nested folders are rendered as- // contextual subpages in the sidebar instead of top-level component links.- return folder.children.filter(- (child): child is PageTreePage =>- child.type === "page" && !child.url.endsWith("/components")+ // Fallback: include nested component pages so the components index can act+ // as the complete jump list, including PDF Viewer subpages.+ return getAllPagesFromFolder(folder).filter(+ (page) => !page.url.endsWith("/components"))}diff --git a/apps/v4/mdx-components.tsx b/apps/v4/mdx-components.tsxindex 8fa7d80..9cb55a5 100644--- a/apps/v4/mdx-components.tsx+++ b/apps/v4/mdx-components.tsx@@ -17,6 +17,7 @@ import {DocumentSplitsDemo,DocumentSplitsSource,} from "@/components/document-splitter-docs"+import { DocxViewerDemo, DocxViewerSource } from "@/components/docx-viewer-docs"import { ESignatureDemo, ESignatureSource } from "@/components/e-signature-docs"import {FileThumbnailDemo,@@ -30,6 +31,7 @@ import {import { getIconForLanguageExtension } from "@/components/icons"import { OcrBlocksDemo, OcrBlocksSource } from "@/components/ocr-blocks-docs"import { PdfViewerDemo, PdfViewerSource } from "@/components/pdf-viewer-docs"+import { XlsxViewerDemo, XlsxViewerSource } from "@/components/xlsx-viewer-docs"import {Accordion,AccordionContent,@@ -375,6 +377,8 @@ export const mdxComponents = {CsvViewerSource,DocumentSplitsDemo,DocumentSplitsSource,+ DocxViewerDemo,+ DocxViewerSource,ESignatureDemo,ESignatureSource,FileThumbnailDemo,@@ -387,6 +391,8 @@ export const mdxComponents = {OcrBlocksSource,PdfViewerDemo,PdfViewerSource,+ XlsxViewerDemo,+ XlsxViewerSource,Link: ({ className, ...props }: React.ComponentProps<typeof Link>) => (<LinkclassName={cn("font-medium underline underline-offset-4", className)}diff --git a/apps/v4/next.config.mjs b/apps/v4/next.config.mjsindex 93b0a3e..f3e69b3 100644--- a/apps/v4/next.config.mjs+++ b/apps/v4/next.config.mjs@@ -32,6 +32,25 @@ const nextConfig = {experimental: {turbopackFileSystemCacheForDev: true,},+ webpack: (config) => {+ config.resolve.alias = {+ ...config.resolve.alias,+ "pdfjs-dist$": "pdfjs-dist/build/pdf.min.mjs",+ }++ config.experiments = {+ ...config.experiments,+ asyncWebAssembly: true,+ }++ config.module.rules.unshift({+ resourceQuery: /url/,+ test: /\.wasm$/,+ type: "asset/resource",+ })++ return config+ },redirects() {return [{diff --git a/apps/v4/package.json b/apps/v4/package.jsonindex 607082f..5ae952a 100644--- a/apps/v4/package.json+++ b/apps/v4/package.json@@ -4,7 +4,7 @@"private": true,"type": "module","scripts": {- "dev": "next dev --turbopack --port 4000",+ "dev": "next dev --webpack --port 4000","build": "next build","start": "next start --port 4000","preview": "next build && next start --port 4000",@@ -20,9 +20,12 @@"@dnd-kit/core": "^6.3.1","@dnd-kit/sortable": "^10.0.0","@dnd-kit/utilities": "^3.2.2",+ "@extend-ai/react-docx": "^0.6.5",+ "@extend-ai/react-xlsx": "^0.8.7","@glideapps/glide-data-grid": "6.0.4-alpha24","@hugeicons/core-free-icons": "^4.1.1","@hugeicons/react": "^1.1.6",+ "@paper-design/shaders-react": "^0.0.76","@pierre/diffs": "^1.1.22","@tabler/icons-react": "^3.31.0","border-beam": "^1.0.1",diff --git a/apps/v4/public/extend-logo.svg b/apps/v4/public/extend-logo.svgnew file mode 100644index 0000000..9dc25ce--- /dev/null+++ b/apps/v4/public/extend-logo.svg@@ -0,0 +1,3 @@+<svg width="753" height="579" viewBox="0 0 753 579" fill="none" xmlns="http://www.w3.org/2000/svg">+<path d="M752.546 401.315C729.873 412.462 707.597 423.455 685.254 434.403C620.711 466.041 556.168 497.634 491.625 529.271C462.729 543.43 433.878 557.721 404.916 571.747C385.96 580.915 366.806 581.047 347.806 571.747C253.861 525.732 159.961 479.672 66.0163 433.656C45.4989 423.609 24.9375 413.605 4.39815 403.558C2.94676 402.832 1.53935 401.997 0 401.117V340.833C34.5255 323.882 69.051 306.953 104.764 289.431C69.029 271.842 34.4815 254.891 0 237.962V177.48C11.7431 171.698 23.3542 165.938 35.0093 160.221C106.765 125.022 178.521 89.8455 250.277 54.6686C283.131 38.5752 315.919 22.4158 348.883 6.54217C367.334 -2.34 386.136 -2.12015 404.476 6.84997C473.659 40.6198 542.754 74.5875 611.871 108.489C656.534 130.387 701.219 152.241 745.883 174.138C748.016 175.172 750.083 176.293 752.436 177.502V238.006C718.196 254.803 683.649 271.776 647.804 289.365C683.385 306.843 717.91 323.772 752.502 340.767V401.315H752.546ZM375.8 507.791C381.342 506.252 386.949 505.571 391.743 503.218C472.296 463.974 552.738 424.51 633.224 385.156C639.117 382.276 643.186 378.12 643.318 371.371C643.45 364.357 639.447 359.938 633.312 356.992C616.995 349.143 600.919 340.811 584.404 333.424C579.698 331.313 573.563 330.368 568.571 331.357C560.808 332.918 553.156 335.952 545.987 339.448C499.102 362.203 452.372 385.288 405.532 408.131C386.444 417.431 367.158 417.826 347.916 408.438C311.433 390.608 275.038 372.646 238.534 354.926C223.074 347.428 207.505 340.195 191.803 333.204C182.743 329.158 173.749 330.192 164.843 334.721C149.515 342.504 134.034 349.979 118.552 357.432C113.12 360.048 109.668 364.072 109.294 370.008C108.876 376.911 112.329 381.66 118.618 384.738C198.752 423.982 278.843 463.336 359.021 502.493C364.167 504.999 370.038 506.032 375.778 507.813L375.8 507.791ZM375.822 70.828C369.599 72.9386 362.957 74.4336 357.02 77.3357C277.655 116.074 198.401 155.033 119.058 193.837C113.054 196.783 109.25 201.005 109.272 207.732C109.294 214.174 112.747 218.549 118.618 221.363C134.935 229.19 151.142 237.237 167.416 245.152C174.145 248.427 181.248 249.153 188.219 246.625C196.795 243.503 205.284 240.051 213.486 236.072C258.545 214.152 303.428 191.925 348.51 170.027C367.29 160.903 386.356 161.321 405.114 170.467C439.793 187.395 474.385 204.456 509.064 221.363C525.337 229.278 541.654 237.127 558.103 244.646C566.46 248.471 575.3 249.988 584.096 245.745C600.897 237.655 617.742 229.63 634.301 221.033C637.688 219.275 640.877 215.603 642.394 212.063C645.407 205.028 641.778 197.883 634.104 194.101C611.959 183.174 589.77 172.379 567.603 161.518C509.306 132.981 451.03 104.378 392.667 75.9946C387.697 73.5762 382.001 72.6748 375.822 70.828ZM258.303 289.255C259.469 290.046 260.129 290.64 260.898 291.014C294.214 307.393 327.486 323.838 360.89 340.019C371.182 345.01 381.869 344.79 392.183 339.778C425.081 323.794 457.914 307.701 490.768 291.607C491.933 291.035 492.945 290.156 494.286 289.233C493.099 288.463 492.527 288.001 491.867 287.672C458.353 271.292 424.905 254.781 391.282 238.6C380.77 233.543 369.907 234.203 359.461 239.303C327.091 255.133 294.786 271.051 262.46 286.968C261.206 287.584 260.019 288.309 258.281 289.255H258.303Z" fill="#1E1E1E"/>+</svg>diff --git a/apps/v4/public/extend-ui-readme.png b/apps/v4/public/extend-ui-readme.pngindex 5513947..60546ec 100644Binary files a/apps/v4/public/extend-ui-readme.png and b/apps/v4/public/extend-ui-readme.png differdiff --git a/apps/v4/public/samples/attention-page-1.png b/apps/v4/public/samples/attention-page-1.pngnew file mode 100644index 0000000..91cc75dBinary files /dev/null and b/apps/v4/public/samples/attention-page-1.png differdiff --git a/apps/v4/public/samples/crazy-chart-zoo.xlsx b/apps/v4/public/samples/crazy-chart-zoo.xlsxnew file mode 100644index 0000000..5de98e4Binary files /dev/null and b/apps/v4/public/samples/crazy-chart-zoo.xlsx differdiff --git a/apps/v4/public/samples/demo.docx b/apps/v4/public/samples/demo.docxnew file mode 100644index 0000000..b172c43Binary files /dev/null and b/apps/v4/public/samples/demo.docx differdiff --git a/excel-document-splits-block.png b/excel-document-splits-block.pngnew file mode 100644index 0000000..a6516b8Binary files /dev/null and b/excel-document-splits-block.png differdiff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex 470055c..a3fffb3 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -30,6 +30,12 @@ importers:'@dnd-kit/utilities':specifier: ^3.2.2version: 3.2.2([email protected])+ '@extend-ai/react-docx':+ specifier: ^0.6.5+ '@extend-ai/react-xlsx':+ specifier: ^0.8.7'@glideapps/glide-data-grid':specifier: 6.0.4-alpha24version: 6.0.4-alpha24([email protected])([email protected])([email protected]([email protected]))([email protected])([email protected])@@ -39,6 +45,9 @@ importers:'@hugeicons/react':specifier: ^1.1.6version: 1.1.6([email protected])+ '@paper-design/shaders-react':+ specifier: ^0.0.76+ version: 0.0.76(@types/[email protected])([email protected])'@pierre/diffs':specifier: ^1.1.22@@ -303,6 +312,9 @@ packages:'@types/react':optional: true+ '@chenglou/[email protected]':+ resolution: {integrity: sha512-A8GZN10REdFGsyuiUgLV8jjPDDFMg5GmgxGWV0I3igxBOnzj+jgz2VMmVD7g+SFyoctfeqHFxbNatKSzVRWtRg==}+'@dnd-kit/[email protected]':resolution: {integrity: sha512-2P+YgaXF+gRsIihwwY1gCsQSYnu9Zyj2py8kY5fFvUM1qm2WA2u639R6YNVfU4GWr+ZM5mqEsfHZZLoRONbemw==}peerDependencies:@@ -325,6 +337,9 @@ packages:peerDependencies:react: '>=16.8.0'+ '@dukelib/[email protected]':+ resolution: {integrity: sha512-UX6Kdyo05u5PZEJHLza0BwbGovEai4xolTVPhewxF8RoaYtHa2uy4oWYdHinFyxX3YKoJ1B2mgzdyvdxmUvU2g==}+'@emnapi/[email protected]':resolution: {integrity: sha512-XsLw1dEOpkSX/WucdqUhPWP7hDxSvZiY+fsUC14h+FtQ2Ifni4znbBt8punRX+Uj2JG/uDb8nEHVKvrVlvdZ5Q==}@@ -690,6 +705,18 @@ packages:resolution: {integrity: sha512-ZAoA40rNMPwSm+AeHpCq8STiNAwzWLJuP8Xv4CHIc9wv/PSuExjMrmjfYNj682vW0OOiZ1HKxzvjQr9XZIisQA==}engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}+ '@extend-ai/[email protected]':+ resolution: {integrity: sha512-ezaELz93wdI5qqQPlVzc0nBI4awhbeBVRbRonJM35l3vVyvJGHbYkpiJKsciDXBFDHjXU51I6sZ7j7MzUbK16A==}+ peerDependencies:+ react: '>=18'+ react-dom: '>=18'++ '@extend-ai/[email protected]':+ resolution: {integrity: sha512-zBFCIzozshW3CFso8M3uT2AbQKHpngW7/r/4lwUYzvIF7RAck1Lq8azWV6ut8bWQzkVeL7XrTGsvWzl59YXkng==}+ peerDependencies:+ react: '>=18'+ react-dom: '>=18'+'@floating-ui/[email protected]':resolution: {integrity: sha512-1Ih4WTWyw0+lKyFMcBHGbb5U5FtuHJuujoyyr5zTaWS5EYMeT6Jb2AuDeftsCsEuchO+mM2ij5+q9crhydzLhQ==}@@ -1092,6 +1119,18 @@ packages:resolution: {integrity: sha512-scSmQBD8eANlMUOglxHrN1JdSW8tDghsPuS83otqealBiIeMukCQMOf/wc0JJjDXomqwNdEQFLXLGHrU6PGxuA==}engines: {node: '>= 20.0.0'}+ '@paper-design/[email protected]':+ resolution: {integrity: sha512-uPJWrYRf6cJdO2H+fuXlahaqz0QjYglNAyUTaRfIInpzCa/d6guxBIK003soAZQFuQ035yg9FhtfFzKNWm+a5A==}+ peerDependencies:+ '@types/react': 19.2.2+ react: ^18 || ^19+ peerDependenciesMeta:+ '@types/react':+ optional: true++ '@paper-design/[email protected]':+ resolution: {integrity: sha512-AcNDY4J66YQHUfQYFInkCP7M9VOje0od7wLpOR7LtCmc532opJy6ll+h1W9zBovz8tt9U7OADUmJ/qKEXyOX/A==}+'@pdf-lib/[email protected]':resolution: {integrity: sha512-hU30BK9IUN/su0Mn9VdlVKsWBS6GyhVfqjwl1FjZN4TxP6cCw0jP2w7V3Hf5uX7M0AZJ16vey9yE0ny7Sa59ZA==}@@ -1579,6 +1618,15 @@ packages:'@tailwindcss/[email protected]':resolution: {integrity: sha512-wgAVj6nUWAolAu8YFvzT2cTBIElWHkjZwFYovF+xsqKsW2ADxM/X2opxj5NsF/qVccAOjRNe8X2IdPzMsWyHTg==}+ '@tanstack/[email protected]':+ resolution: {integrity: sha512-DosdgjOxCLahkn0o+ilmZYwEjo1glfMGuRT/j3PQ18yr5XqA8N/BCaL9IJ3B5TRl+nnzyK2IOFgAILwzN3a9xQ==}+ peerDependencies:+ react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0+ react-dom: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0++ '@tanstack/[email protected]':+ resolution: {integrity: sha512-Er2N7q3WOiH6y2JLxsxNX+u2/sLqSsL0bxFgDjuiPiA7vKhZRm+IzcS17vRee3GNXr64UsesA5CAp9yTiIYw9A==}+'@tybys/[email protected]':resolution: {integrity: sha512-VyyPYFlOMNylG45GoAe0xDoLwWuowvf92F9kySqzYh8vmYm7D2u4iUJKa1tOUpS70Ku13ASrOkS4ScXFsTaCNQ==}@@ -2017,6 +2065,9 @@ packages:resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==}+ resolution: {integrity: sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==}+resolution: {integrity: sha512-VRhuHOLoKYOy4UbilLbUzbYg93XLjv2PncJC50EuTWPA3gaja1UjBsUP/D/9/juV3vQFr6XBEzn9KCAHdUvOHw==}@@ -2053,6 +2104,50 @@ packages:resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}+ resolution: {integrity: sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-AJDdYOdnyRDV5b6ArilzCPPwc1ejkHcoyFarqlPqT7zRYjhavcT3uSrqcMvsgh2CgoPbK3RCwyHaVyxYcP2Arg==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-637ln3gXKXOwhalDzinUgY83KzNWZRKbYubaG+fGVuc/dxO64RRljtCTnf5ecMyE1RIdtqpkVcq0IbtU2S8j2Q==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-FX/9frcub54beBdugHjDCdikxThEqjnR93Qt7PvQTOHxyiNCAlvMrHhclk3cD5VeAaq9fxmfRp+CnWw9rEMBuA==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q==}+ engines: {node: '>=12'}+resolution: {integrity: sha512-sdQSFB7+llfUcQHUQO3+B8ERRj0Oa4w9POWMI/puGtuf7gFywGmkaLCElnudfTiKZV+NvHqL0ifzdrI8Ro7ESA==}@@ -2398,6 +2493,9 @@ packages:resolution: {integrity: sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==}+ resolution: {integrity: sha512-gCysNasJ8KEMgfdYIKd/wTDo6ENK1PWT0RJO7O+0pgmuHPw2O6tA1WvdxFRJoLf9V8yFYpG0FA1YgI8X97OhJA==}+resolution: {integrity: sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==}@@ -2413,6 +2511,9 @@ packages:picomatch:optional: true+ resolution: {integrity: sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==}+resolution: {integrity: sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==}engines: {node: '>=16.0.0'}@@ -2682,6 +2783,13 @@ packages:resolution: {integrity: sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==}engines: {node: '>= 0.4'}+ resolution: {integrity: sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-SZWYkWNfjIXIBYSDpXDYIgshqtbOPsi4lviawAEceR1Kqk+sHDlcQjWrzNQsii80AyBY0q5c8HCTNjqo74ul+Q==}+resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==}engines: {node: '>= 0.10'}@@ -3645,6 +3753,9 @@ packages:resolution: {integrity: sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==}engines: {node: '>= 0.4'}+ resolution: {integrity: sha512-+IOGrxl3FZ8ZM9ixCWQZzFRiRn7Rzn9bu3iFHwg/yz4tlOUQgbO4PHLgG+1ZT60zcIV8tief6Qrmyl8qcoJP0g==}+resolution: {integrity: sha512-ksCzCD0Fgfh7trPDxr2rSylbwq9iYDkSn8TCDmEJ49ljEUBxDVCzCHv7QNzZOfODanX4+bWQ4WZqLCRWYLfhag==}@@ -3930,6 +4041,10 @@ packages:resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==}engines: {node: '>=0.6'}+ resolution: {integrity: sha512-605uxS6bcYxGXw9qi62XyrV6Q3xwbndjachmNxu8HWTtVPxZfEJN9fd/SZS1Q54Sn2y0TMyMxFj/cJINqGHrKw==}+ hasBin: true+resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==}@@ -4080,6 +4195,9 @@ packages:resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==}+ resolution: {integrity: sha512-wEIZCq0ImPvGblTd8gZMqNNCPkQshugMUG/8nkSWXb02+XqNFREg9atHOKP9w6prLZTpqcLhSvdBW81MkV3/0Q==}+resolution: {integrity: sha512-jQL3lRnocaFtu3V00JToYz/4QkNWswxijDaCVNZRiRTO3HQDLsdu1ZtmIUvV4yPp+rvWm5j0y0TG/S61cuijTg==}engines: {node: '>=10'}@@ -4105,6 +4223,9 @@ packages:peerDependencies:react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0+ resolution: {integrity: sha512-WEo4D/xOvFW53K5f5QTaTbbiORcm2/pCL9P6qmJnup+17eYfKaEhDeX9PeQkuyEoIxlbGklDuGl8xwuXYMrrXQ==}+resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==}engines: {node: '>= 0.8'}@@ -4189,6 +4310,9 @@ packages:resolution: {integrity: sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==}engines: {node: '>=0.10.0'}+ resolution: {integrity: sha512-IXfV0qwlKXpckz1FhwXVwKRjiIhOnWttOskm5CtxMsjgE/MXAYRHWJqgXOpM8IkcPBoXnyTU5lFHcYa5ChG0LQ==}+resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}@@ -4391,6 +4515,8 @@ snapshots:optionalDependencies:'@types/react': 19.2.2+ '@chenglou/[email protected]': {}+'@dnd-kit/[email protected]([email protected])':dependencies:react: 19.2.3@@ -4416,6 +4542,8 @@ snapshots:react: 19.2.3tslib: 2.8.1+ '@dukelib/[email protected]': {}+'@emnapi/[email protected]':dependencies:'@emnapi/wasi-threads': 1.0.4@@ -4638,6 +4766,31 @@ snapshots:'@eslint/core': 0.13.0levn: 0.4.1+ dependencies:+ '@chenglou/pretext': 0.0.5+ fast-png: 8.0.0+ react: 19.2.3+ react-dom: 19.2.3([email protected])+ utif: 3.1.0++ dependencies:+ '@dukelib/sheets-wasm': 0.1.13+ d3-geo: 3.1.1+ d3-hierarchy: 3.1.2+ d3-scale: 4.0.2+ d3-shape: 3.2.0+ fflate: 0.8.3+ react: 19.2.3+ react-dom: 19.2.3([email protected])+ regl: 2.1.1+ topojson-client: 3.1.0+ us-atlas: 3.0.1+ world-atlas: 2.0.2+'@floating-ui/[email protected]':dependencies:'@floating-ui/utils': 0.2.11@@ -4996,6 +5149,15 @@ snapshots:'@orama/[email protected]': {}+ dependencies:+ '@paper-design/shaders': 0.0.76+ react: 19.2.3+ optionalDependencies:+ '@types/react': 19.2.2++ '@paper-design/[email protected]': {}+'@pdf-lib/[email protected]':dependencies:pako: 1.0.11@@ -5417,6 +5579,14 @@ snapshots:postcss: 8.5.8tailwindcss: 4.2.4+ dependencies:+ '@tanstack/virtual-core': 3.16.0+ react: 19.2.3+ react-dom: 19.2.3([email protected])++ '@tanstack/[email protected]': {}+'@tybys/[email protected]':dependencies:tslib: 2.8.1@@ -5885,6 +6055,8 @@ snapshots:+ [email protected]: {}+@@ -5912,6 +6084,46 @@ snapshots:+ dependencies:+ internmap: 2.0.3++ [email protected]: {}++ [email protected]: {}++ dependencies:+ d3-array: 3.2.4++ [email protected]: {}++ dependencies:+ d3-color: 3.1.0++ [email protected]: {}++ dependencies:+ d3-array: 3.2.4+ d3-format: 3.1.2+ d3-interpolate: 3.0.1+ d3-time: 3.1.0+ d3-time-format: 4.1.0++ dependencies:+ d3-path: 3.1.0++ dependencies:+ d3-time: 3.1.0++ dependencies:+ d3-array: 3.2.4+@@ -6489,6 +6701,11 @@ snapshots:+ dependencies:+ fflate: 0.8.3+ iobuffer: 6.0.1+@@ -6504,6 +6721,8 @@ snapshots:picomatch: 4.0.4optional: true+ [email protected]: {}+dependencies:flat-cache: 4.0.1@@ -6833,6 +7052,10 @@ snapshots:hasown: 2.0.2side-channel: 1.1.0+ [email protected]: {}++ [email protected]: {}+@@ -7978,6 +8201,8 @@ snapshots:gopd: 1.2.0set-function-name: 2.0.2+ [email protected]: {}+dependencies:'@types/hast': 3.0.4@@ -8415,6 +8640,10 @@ snapshots:+ dependencies:+ commander: 2.20.3+@@ -8618,6 +8847,8 @@ snapshots:dependencies:punycode: 2.3.1+ [email protected]: {}+dependencies:react: 19.2.3@@ -8637,6 +8868,10 @@ snapshots:dependencies:react: 19.2.3+ dependencies:+ pako: 1.0.11+@@ -8724,6 +8959,8 @@ snapshots:+ [email protected]: {}+