Files
wehub-resource-sync e4dcfc49aa
Tests / Import Check (Python 3.13) (push) Has been cancelled
Tests / Import Check (Python 3.14) (push) Has been cancelled
Tests / Python Tests (Python 3.11) (push) Has been cancelled
Tests / Python Tests (Python 3.12) (push) Has been cancelled
Tests / Python Tests (Python 3.14) (push) Has been cancelled
Tests / Test Summary (push) Has been cancelled
Tests / Lint and Format (push) Has been cancelled
Tests / Web Node Tests (push) Has been cancelled
Tests / Import Check (Python 3.11) (push) Has been cancelled
Tests / Import Check (Python 3.12) (push) Has been cancelled
Tests / Python Tests (Python 3.13) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:00:43 +08:00

330 lines
12 KiB
TypeScript

"use client";
import dynamic from "next/dynamic";
import { useEffect, useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import {
Check,
Copy,
Download,
FileText,
Loader2,
Maximize2,
Minimize2,
PanelLeftClose,
PanelLeftOpen,
} from "lucide-react";
import { apiUrl } from "@/lib/api";
import { docIconFor, formatBytes } from "@/lib/doc-attachments";
import {
previewKindFor,
resolveSourceUrl,
type FilePreviewSource,
} from "@/components/chat/preview/previewerFor";
// Full-size loading placeholder. Crucially, giving each dynamic() its own
// `loading` keeps chunk-load suspension *inside* the preview pane. Without it,
// the suspension bubbles up to the route-level <Suspense> wrapping the whole
// page, so first-preview / file-type-switch flashed the entire page to a
// spinner.
const PreviewLoading = () => (
<div className="flex h-full w-full items-center justify-center bg-[var(--background)]">
<Loader2 className="h-4 w-4 animate-spin text-[var(--muted-foreground)]" />
</div>
);
// Reuse the chat renderers — they're pure presentation given (url, filename)
// and don't carry chat-specific state. next/dynamic's compiler requires the
// options to be an inline object literal (not a shared const), so each call
// repeats `{ loading, ssr }`.
const PdfPreview = dynamic(
() => import("@/components/chat/preview/previewers/PdfPreview"),
{ loading: PreviewLoading, ssr: false },
);
const ImagePreview = dynamic(
() => import("@/components/chat/preview/previewers/ImagePreview"),
{ loading: PreviewLoading, ssr: false },
);
const SvgPreview = dynamic(
() => import("@/components/chat/preview/previewers/SvgPreview"),
{ loading: PreviewLoading, ssr: false },
);
const MarkdownPreview = dynamic(
() => import("@/components/chat/preview/previewers/MarkdownPreview"),
{ loading: PreviewLoading, ssr: false },
);
const TextPreview = dynamic(
() => import("@/components/chat/preview/previewers/TextPreview"),
{ loading: PreviewLoading, ssr: false },
);
const DocxPreview = dynamic(
() => import("@/components/chat/preview/previewers/DocxPreview"),
{ loading: PreviewLoading, ssr: false },
);
const XlsxPreview = dynamic(
() => import("@/components/chat/preview/previewers/XlsxPreview"),
{ loading: PreviewLoading, ssr: false },
);
const OfficeTextPreview = dynamic(
() => import("@/components/chat/preview/previewers/OfficeTextPreview"),
{ loading: PreviewLoading, ssr: false },
);
const FallbackPreview = dynamic(
() => import("@/components/chat/preview/previewers/FallbackPreview"),
{ loading: PreviewLoading, ssr: false },
);
interface KbFilePreviewProps {
source: FilePreviewSource | null;
/**
* Optional slot rendered to the right of the breadcrumb / title — used
* to surface metadata (e.g. file count, modified date) inline in the
* preview header, since this component is the right pane of the
* master-detail and there's no separate header above it.
*/
metaSuffix?: React.ReactNode;
/** Current collapsed state of the file list. When provided, the preview
* header shows a toggle so the user can claim more width without
* reaching for the file list's own toggle button. */
fileListCollapsed?: boolean;
onToggleFileList?: () => void;
}
/**
* Inline file preview pane that fits the /knowledge master-detail layout.
*
* Unlike the chat's slide-in drawer, this is just an in-flow panel — header
* (filename + actions) on top, body (renderer) below. It owns no animation
* timers and no portal; the parent decides how/when to mount it. That keeps
* the visual language consistent with the rest of the knowledge surface
* (tabs, sidebars, plain panels) instead of pulling in a drawer chrome that
* fights the page's existing master-detail.
*/
export default function KbFilePreview({
source,
metaSuffix,
fileListCollapsed,
onToggleFileList,
}: KbFilePreviewProps) {
const { t } = useTranslation();
const [copied, setCopied] = useState(false);
// Master-detail caps the inline pane height; fullscreen lets a tall PDF use
// the whole window so you're not stuck reading half a page at a time.
const [fullscreen, setFullscreen] = useState(false);
useEffect(() => {
if (!fullscreen) return;
const onKey = (event: KeyboardEvent) => {
if (event.key === "Escape") setFullscreen(false);
};
window.addEventListener("keydown", onKey);
return () => window.removeEventListener("keydown", onKey);
}, [fullscreen]);
const previewUrl = useMemo(
() => (source ? resolveSourceUrl(source, apiUrl) : null),
[source],
);
const extractedTextUrl = useMemo(() => {
if (!source?.extractedTextUrl) return null;
return source.extractedTextUrl.startsWith("http")
? source.extractedTextUrl
: apiUrl(source.extractedTextUrl);
}, [source]);
const kind = useMemo(
() => (source ? previewKindFor(source) : null),
[source],
);
if (!source) {
return (
<div className="flex h-full flex-col">
{onToggleFileList && (
<div className="flex items-center justify-end border-b border-[var(--border)] bg-[var(--card)]/40 px-3 py-1.5">
<button
type="button"
onClick={onToggleFileList}
title={
fileListCollapsed ? t("Show file list") : t("Hide file list")
}
aria-label={
fileListCollapsed ? t("Show file list") : t("Hide file list")
}
className="flex h-7 w-7 items-center justify-center rounded-md text-[var(--muted-foreground)] transition-colors hover:bg-[var(--muted)] hover:text-[var(--foreground)]"
>
{fileListCollapsed ? (
<PanelLeftOpen size={13} strokeWidth={1.7} />
) : (
<PanelLeftClose size={13} strokeWidth={1.7} />
)}
</button>
</div>
)}
<div className="flex flex-1 flex-col items-center justify-center gap-3 px-6 py-12 text-center">
<div className="flex h-12 w-12 items-center justify-center rounded-2xl bg-[var(--muted)] text-[var(--muted-foreground)]">
<FileText className="h-5 w-5" />
</div>
<div>
<div className="text-[13px] font-medium text-[var(--foreground)]">
{t("Select a file to preview")}
</div>
<p className="mt-1 max-w-xs text-[11.5px] leading-relaxed text-[var(--muted-foreground)]">
{t(
"Pick any document from the list on the left to view it here without leaving the knowledge base.",
)}
</p>
</div>
</div>
</div>
);
}
const spec = docIconFor(source.filename);
const HeaderIcon = spec.Icon;
const sizeLabel = source.size ? formatBytes(source.size) : "";
const handleCopy = async () => {
if (!previewUrl) return;
try {
await navigator.clipboard.writeText(previewUrl);
setCopied(true);
setTimeout(() => setCopied(false), 1500);
} catch {
// clipboard rejected; ignore
}
};
return (
<div
className={
fullscreen
? "fixed inset-0 z-50 flex min-h-0 flex-col bg-[var(--background)]"
: "mx-auto flex h-full w-full min-h-0 max-w-5xl flex-col"
}
>
{/* Header */}
<div className="flex items-center gap-2 border-b border-[var(--border)] bg-[var(--card)]/80 px-3 py-2">
{onToggleFileList && !fullscreen && (
<button
type="button"
onClick={onToggleFileList}
title={
fileListCollapsed ? t("Show file list") : t("Hide file list")
}
aria-label={
fileListCollapsed ? t("Show file list") : t("Hide file list")
}
className="flex h-7 w-7 shrink-0 items-center justify-center rounded-md text-[var(--muted-foreground)] transition-colors hover:bg-[var(--muted)] hover:text-[var(--foreground)]"
>
{fileListCollapsed ? (
<PanelLeftOpen size={13} strokeWidth={1.7} />
) : (
<PanelLeftClose size={13} strokeWidth={1.7} />
)}
</button>
)}
<div className="flex h-8 w-8 shrink-0 items-center justify-center rounded-md bg-[var(--muted)]/60">
<HeaderIcon size={15} strokeWidth={1.6} className={spec.tint} />
</div>
<div className="min-w-0 flex-1">
<div className="truncate text-[12.5px] font-medium text-[var(--foreground)]">
{source.filename}
</div>
<div className="truncate text-[10.5px] uppercase tracking-wide text-[var(--muted-foreground)]">
{sizeLabel ? `${spec.label} · ${sizeLabel}` : spec.label}
</div>
</div>
{metaSuffix && (
<div className="shrink-0 text-[11px] text-[var(--muted-foreground)]">
{metaSuffix}
</div>
)}
<button
type="button"
onClick={() => setFullscreen((value) => !value)}
title={fullscreen ? t("Exit fullscreen") : t("Fullscreen")}
aria-label={fullscreen ? t("Exit fullscreen") : t("Fullscreen")}
className="flex h-7 w-7 items-center justify-center rounded-md text-[var(--muted-foreground)] transition-colors hover:bg-[var(--muted)] hover:text-[var(--foreground)]"
>
{fullscreen ? (
<Minimize2 size={13} strokeWidth={1.7} />
) : (
<Maximize2 size={13} strokeWidth={1.7} />
)}
</button>
{previewUrl && (
<>
<a
href={previewUrl}
download={source.filename}
title={t("Download")}
aria-label={t("Download")}
className="flex h-7 w-7 items-center justify-center rounded-md text-[var(--muted-foreground)] transition-colors hover:bg-[var(--muted)] hover:text-[var(--foreground)]"
>
<Download size={13} strokeWidth={1.7} />
</a>
<button
type="button"
onClick={() => void handleCopy()}
title={t("Copy link")}
aria-label={t("Copy link")}
className="flex h-7 w-7 items-center justify-center rounded-md text-[var(--muted-foreground)] transition-colors hover:bg-[var(--muted)] hover:text-[var(--foreground)]"
>
{copied ? (
<Check
size={13}
strokeWidth={1.7}
className="text-emerald-500"
/>
) : (
<Copy size={13} strokeWidth={1.7} />
)}
</button>
</>
)}
</div>
{/* Body */}
<div className="relative min-h-0 flex-1 overflow-hidden">
{!previewUrl ? (
<FallbackPreview
filename={source.filename}
url={null}
reason="legacy"
/>
) : kind === "office-text" ? (
<OfficeTextPreview
filename={source.filename}
extractedText={source.extractedText}
extractedTextUrl={extractedTextUrl}
url={previewUrl}
/>
) : kind === "pdf" ? (
<PdfPreview url={previewUrl} filename={source.filename} />
) : kind === "docx" ? (
<DocxPreview url={previewUrl} />
) : kind === "xlsx" ? (
<XlsxPreview url={previewUrl} />
) : kind === "image" ? (
<ImagePreview url={previewUrl} filename={source.filename} />
) : kind === "svg" ? (
<SvgPreview url={previewUrl} filename={source.filename} />
) : kind === "markdown" ? (
<div className="h-full overflow-y-auto">
<MarkdownPreview url={previewUrl} />
</div>
) : kind === "code" || kind === "text" ? (
<div className="h-full overflow-y-auto">
<TextPreview url={previewUrl} filename={source.filename} />
</div>
) : (
<FallbackPreview filename={source.filename} url={previewUrl} />
)}
</div>
</div>
);
}