@file-viewer/core 2.0.7 → 2.0.9

package/dist/renderers/pdf.js

@@ -1,11 +1,12 @@
-import { getDocument, GlobalWorkerOptions, PDFWorker as PdfJsWorker, PixelsPerInch, version, } from 'pdfjs-dist/legacy/build/pdf.mjs';
+import { getDocument, GlobalWorkerOptions, PDFWorker as PdfJsWorker, PixelsPerInch, } from 'pdfjs-dist/legacy/build/pdf.mjs';
 import { EventBus, GenericL10n, PDFFindController, PDFLinkService, PDFViewer, } from 'pdfjs-dist/legacy/web/pdf_viewer.mjs';
 import { registerFileViewerSearchProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from '../features/document/dom/index.js';
 import { createFileViewerZoomChangeEmitter } from '../features/document/zoom.js';
 import { buildPrintPageStyle, formatCssPixels, } from '../output/printLayout.js';
+import { DEFAULT_FILE_VIEWER_PDF_WORKER_PATH, resolveFileViewerPdfAssetUrls, } from '../platform/assets.js';
 import { DEFAULT_PDF_RANGE_CHUNK_SIZE } from '../source/loading.js';
 import { pdfViewerStyle } from './pdfStyles.js';
-export const DEFAULT_FILE_VIEWER_PDF_WORKER_URL = `https://npm.onmicrosoft.cn/pdfjs-dist@${version}/legacy/build/pdf.worker.mjs`;
+export const DEFAULT_FILE_VIEWER_PDF_WORKER_URL = DEFAULT_FILE_VIEWER_PDF_WORKER_PATH;
 const MIN_SCALE = 0.2;
 const MAX_SCALE = 3;
 const SCALE_STEP = 0.1;
@@ -21,6 +22,10 @@ const createStyle = (documentRef) => {
     const style = documentRef.createElement('style');
     style.textContent = `${normalizedPdfViewerStyle}
 .pdf-state[hidden],.pdf-nav-pane[hidden]{display:none!important}
+.pdf-page-button--with-thumbnail{grid-template-columns:52px minmax(0,1fr);min-height:74px}
+.pdf-page-thumb--thumbnail{width:46px;height:60px;overflow:hidden;background:#fff}
+.pdf-page-thumb--thumbnail img{display:block;width:100%;height:100%;object-fit:contain}
+.pdf-page-thumb--thumbnail span{display:inline-flex;align-items:center;justify-content:center;width:100%;height:100%}
 `;
     return style;
 };
@@ -71,16 +76,7 @@ const waitForPaint = (view) => new Promise(resolve => {
     globalThis.setTimeout(resolve, 0);
 });
 const resolvePdfWorkerUrl = (options, documentUrl) => {
-    const configured = options === null || options === void 0 ? void 0 : options.workerUrl;
-    if (!configured) {
-        return DEFAULT_FILE_VIEWER_PDF_WORKER_URL;
-    }
-    try {
-        return documentUrl ? new URL(configured, documentUrl).href : configured;
-    }
-    catch {
-        return configured;
-    }
+    return resolveFileViewerPdfAssetUrls(options, documentUrl).workerUrl;
 };
 const buildOutlineItems = (items, prefix = 'outline') => items.map((item, index) => {
     const id = `${prefix}-${index}`;
@@ -105,6 +101,7 @@ export default async function renderPdf(buffer, target, context) {
     const options = (_a = context === null || context === void 0 ? void 0 : context.options) === null || _a === void 0 ? void 0 : _a.pdf;
     const navigationEnabled = (options === null || options === void 0 ? void 0 : options.navigation) !== false;
     const toolbarVisible = (options === null || options === void 0 ? void 0 : options.toolbar) !== false;
+    const thumbnailsEnabled = (options === null || options === void 0 ? void 0 : options.thumbnails) === true;
     const zoomEmitter = createFileViewerZoomChangeEmitter();
     let navVisible = (options === null || options === void 0 ? void 0 : options.navigation) === false ? false : (options === null || options === void 0 ? void 0 : options.defaultNavigationVisible) !== false;
     let navMode = 'pages';
@@ -117,13 +114,17 @@ export default async function renderPdf(buffer, target, context) {
     let currentRotation = normalizeRotation((_b = options === null || options === void 0 ? void 0 : options.rotation) !== null && _b !== void 0 ? _b : 0);
     let outlineItems = [];
     let resizeObserver = null;
+    let thumbnailObserver = null;
     let fitFrame = 0;
+    let pageDimensionFrame = 0;
     let destroyed = false;
     let loadVersion = 0;
     let pdfSearchState = createPdfSearchState();
     let pdfMatchesCount = { current: 0, total: 0 };
     let pdfSearchOptions;
     let pdfSearchWaiters = [];
+    const pdfThumbnails = new Map();
+    const pendingPdfThumbnails = new Set();
     const pdfContext = {
         viewer: null,
         linkService: null,
@@ -222,11 +223,21 @@ export default async function renderPdf(buffer, target, context) {
         navList.replaceChildren();
         navList.className = navMode === 'pages' ? 'pdf-page-list' : 'pdf-outline-list';
         if (navMode === 'pages') {
+            thumbnailObserver === null || thumbnailObserver === void 0 ? void 0 : thumbnailObserver.disconnect();
             for (let page = 1; page <= pageCount; page += 1) {
                 const button = createElement(documentRef, 'button', 'pdf-page-button');
                 button.type = 'button';
                 button.classList.toggle('pdf-page-button--active', page === currentPage);
-                button.append(createElement(documentRef, 'span', 'pdf-page-thumb', String(page)), createElement(documentRef, 'span', 'pdf-page-label', `第 ${page} 页`));
+                button.classList.toggle('pdf-page-button--with-thumbnail', thumbnailsEnabled);
+                const thumb = createElement(documentRef, 'span', 'pdf-page-thumb');
+                if (thumbnailsEnabled) {
+                    thumb.classList.add('pdf-page-thumb--thumbnail');
+                    queuePdfThumbnail(page, thumb);
+                }
+                else {
+                    thumb.textContent = String(page);
+                }
+                button.append(thumb, createElement(documentRef, 'span', 'pdf-page-label', `第 ${page} 页`));
                 button.addEventListener('click', () => goToPage(page));
                 navList.append(button);
             }
@@ -253,6 +264,101 @@ export default async function renderPdf(buffer, target, context) {
             navList.append(createElement(documentRef, 'div', 'pdf-outline-empty', '当前 PDF 没有可用目录'));
         }
     };
+    const paintPdfThumbnail = (pageNumber, thumb) => {
+        const imageUrl = pdfThumbnails.get(pageNumber);
+        thumb.dataset.pdfThumbnailPage = String(pageNumber);
+        if (!imageUrl) {
+            thumb.replaceChildren(createElement(documentRef, 'span', undefined, String(pageNumber)));
+            return false;
+        }
+        const image = documentRef.createElement('img');
+        image.src = imageUrl;
+        image.alt = `第 ${pageNumber} 页缩略图`;
+        image.loading = 'lazy';
+        thumb.replaceChildren(image);
+        return true;
+    };
+    const renderPdfThumbnail = async (pageNumber) => {
+        var _a, _b;
+        const pdfDocument = pdfContext.document;
+        if (!pdfDocument || pdfThumbnails.has(pageNumber) || pendingPdfThumbnails.has(pageNumber)) {
+            return;
+        }
+        pendingPdfThumbnails.add(pageNumber);
+        try {
+            const page = await pdfDocument.getPage(pageNumber);
+            if (destroyed || pdfContext.document !== pdfDocument) {
+                return;
+            }
+            const baseViewport = page.getViewport({
+                scale: PixelsPerInch.PDF_TO_CSS_UNITS,
+                rotation: currentRotation,
+            });
+            const deviceScale = Math.min(2, Math.max(1, targetWindow.devicePixelRatio || 1));
+            const thumbnailWidth = 46;
+            const ratio = Math.min(1, thumbnailWidth / Math.max(baseViewport.width, 1));
+            const renderViewport = page.getViewport({
+                scale: PixelsPerInch.PDF_TO_CSS_UNITS * ratio * deviceScale,
+                rotation: currentRotation,
+            });
+            const canvas = documentRef.createElement('canvas');
+            const canvasContext = canvas.getContext('2d');
+            if (!canvasContext) {
+                return;
+            }
+            canvas.width = Math.max(1, Math.ceil(renderViewport.width));
+            canvas.height = Math.max(1, Math.ceil(renderViewport.height));
+            await page.render({ canvas, canvasContext, viewport: renderViewport }).promise;
+            if (destroyed || pdfContext.document !== pdfDocument) {
+                return;
+            }
+            pdfThumbnails.set(pageNumber, canvas.toDataURL('image/png'));
+            canvas.width = 0;
+            canvas.height = 0;
+            (_b = (_a = page).cleanup) === null || _b === void 0 ? void 0 : _b.call(_a);
+            navList
+                .querySelectorAll(`.pdf-page-thumb--thumbnail[data-pdf-thumbnail-page="${pageNumber}"]`)
+                .forEach(thumb => paintPdfThumbnail(pageNumber, thumb));
+        }
+        catch (error) {
+            console.warn('[file-viewer] PDF 缩略图渲染失败。', error);
+        }
+        finally {
+            pendingPdfThumbnails.delete(pageNumber);
+        }
+    };
+    const ensureThumbnailObserver = () => {
+        if (!thumbnailsEnabled || thumbnailObserver || typeof targetWindow.IntersectionObserver !== 'function') {
+            return;
+        }
+        thumbnailObserver = new targetWindow.IntersectionObserver(entries => {
+            entries.forEach(entry => {
+                if (!entry.isIntersecting) {
+                    return;
+                }
+                const targetElement = entry.target;
+                const pageNumber = Number(targetElement.dataset.pdfThumbnailPage || '0');
+                thumbnailObserver === null || thumbnailObserver === void 0 ? void 0 : thumbnailObserver.unobserve(targetElement);
+                if (pageNumber > 0) {
+                    void renderPdfThumbnail(pageNumber);
+                }
+            });
+        }, {
+            root: navList,
+            rootMargin: '96px 0px',
+        });
+    };
+    const queuePdfThumbnail = (pageNumber, thumb) => {
+        if (paintPdfThumbnail(pageNumber, thumb)) {
+            return;
+        }
+        ensureThumbnailObserver();
+        if (thumbnailObserver) {
+            thumbnailObserver.observe(thumb);
+            return;
+        }
+        void renderPdfThumbnail(pageNumber);
+    };
     const syncUi = () => {
         root.classList.toggle('pdf-shell--nav-hidden', !navigationEnabled || !navVisible);
         root.classList.toggle('pdf-shell--toolbar-hidden', !toolbarVisible);
@@ -278,6 +384,33 @@ export default async function renderPdf(buffer, target, context) {
         stateNode.textContent = loadStatus === 'error' ? errorMessage : '正在加载 PDF...';
         renderNavList();
     };
+    const writeLegacyCompatiblePageDimensions = () => {
+        var _a, _b;
+        const pdfViewer = pdfContext.viewer;
+        if (!pdfViewer) {
+            return;
+        }
+        const totalPages = pageCount || pdfViewer.pagesCount || 0;
+        for (let index = 0; index < totalPages; index += 1) {
+            const pageView = pdfViewer.getPageView(index);
+            const pageElement = (pageView === null || pageView === void 0 ? void 0 : pageView.div) ||
+                pdfViewerRoot.querySelector(`.page[data-page-number="${index + 1}"]`);
+            const width = (_a = pageView === null || pageView === void 0 ? void 0 : pageView.viewport) === null || _a === void 0 ? void 0 : _a.width;
+            const height = (_b = pageView === null || pageView === void 0 ? void 0 : pageView.viewport) === null || _b === void 0 ? void 0 : _b.height;
+            if (!pageElement || !Number.isFinite(width) || !Number.isFinite(height)) {
+                continue;
+            }
+            pageElement.style.setProperty('width', `${Math.max(1, Math.round(width || 0))}px`, 'important');
+            pageElement.style.setProperty('height', `${Math.max(1, Math.round(height || 0))}px`, 'important');
+        }
+    };
+    const scheduleLegacyPageDimensionPatch = () => {
+        targetWindow.cancelAnimationFrame(pageDimensionFrame);
+        pageDimensionFrame = targetWindow.requestAnimationFrame(() => {
+            writeLegacyCompatiblePageDimensions();
+            targetWindow.requestAnimationFrame(writeLegacyCompatiblePageDimensions);
+        });
+    };
     const createPdfWorker = () => {
         if (!(targetWindow === null || targetWindow === void 0 ? void 0 : targetWindow.Worker)) {
             return null;
@@ -435,6 +568,7 @@ export default async function renderPdf(buffer, target, context) {
         const normalizedScale = clampScale(scale);
         pdfContext.viewer.currentScale = normalizedScale;
         currentScale = normalizedScale;
+        scheduleLegacyPageDimensionPatch();
         zoomEmitter.emit();
         syncUi();
     };
@@ -489,6 +623,8 @@ export default async function renderPdf(buffer, target, context) {
     const applyRotation = (rotation) => {
         const normalized = normalizeRotation(rotation);
         currentRotation = normalized;
+        pdfThumbnails.clear();
+        pendingPdfThumbnails.clear();
         if (!pdfContext.viewer) {
             syncUi();
             return;
@@ -501,6 +637,7 @@ export default async function renderPdf(buffer, target, context) {
                 return;
             }
             (_a = pdfContext.viewer) === null || _a === void 0 ? void 0 : _a.update();
+            scheduleLegacyPageDimensionPatch();
             syncUi();
         });
     };
@@ -669,6 +806,9 @@ export default async function renderPdf(buffer, target, context) {
         errorMessage = '';
         pdfContext.document = null;
         outlineItems = [];
+        pdfThumbnails.clear();
+        pendingPdfThumbnails.clear();
+        thumbnailObserver === null || thumbnailObserver === void 0 ? void 0 : thumbnailObserver.disconnect();
         (_a = context === null || context === void 0 ? void 0 : context.registerExportAdapter) === null || _a === void 0 ? void 0 : _a.call(context, null);
         syncUi();
         let resource = null;
@@ -702,6 +842,7 @@ export default async function renderPdf(buffer, target, context) {
                 var _a;
                 applyRotation(currentRotation);
                 fitToWidth();
+                scheduleLegacyPageDimensionPatch();
                 loadStatus = 'ready';
                 syncUi();
                 (_a = context === null || context === void 0 ? void 0 : context.onProgressiveRender) === null || _a === void 0 ? void 0 : _a.call(context);
@@ -715,13 +856,16 @@ export default async function renderPdf(buffer, target, context) {
             });
             eventBus.on('scalechanging', ({ scale }) => {
                 currentScale = clampScale(scale);
+                scheduleLegacyPageDimensionPatch();
                 zoomEmitter.emit();
                 syncUi();
             });
+            eventBus.on('pagerendered', scheduleLegacyPageDimensionPatch);
             if (!(context === null || context === void 0 ? void 0 : context.streamUrl) && !buffer.byteLength) {
                 throw new Error('PDF 缺少可读取的数据源');
             }
             const worker = createPdfWorker();
+            const pdfAssets = resolveFileViewerPdfAssetUrls(options, documentRef.URL || documentRef.baseURI);
             const source = (context === null || context === void 0 ? void 0 : context.streamUrl)
                 ? {
                     url: context.streamUrl,
@@ -734,8 +878,9 @@ export default async function renderPdf(buffer, target, context) {
             const loadingTask = getDocument({
                 ...source,
                 worker: worker || undefined,
-                cMapUrl: `https://npm.onmicrosoft.cn/pdfjs-dist@${version}/cmaps/`,
-                wasmUrl: `https://npm.onmicrosoft.cn/pdfjs-dist@${version}/wasm/`,
+                cMapUrl: pdfAssets.cMapUrl,
+                wasmUrl: pdfAssets.wasmUrl,
+                standardFontDataUrl: pdfAssets.standardFontDataUrl,
                 useWorkerFetch: true,
                 cMapPacked: true,
                 enableXfa: true,
@@ -831,6 +976,9 @@ export default async function renderPdf(buffer, target, context) {
             destroyed = true;
             loadVersion += 1;
             targetWindow.cancelAnimationFrame(fitFrame);
+            targetWindow.cancelAnimationFrame(pageDimensionFrame);
+            thumbnailObserver === null || thumbnailObserver === void 0 ? void 0 : thumbnailObserver.disconnect();
+            thumbnailObserver = null;
             resizeObserver === null || resizeObserver === void 0 ? void 0 : resizeObserver.disconnect();
             resizeObserver = null;
             unregisterFileViewerSearchProvider(root);

package/dist/renderers/typst.js

@@ -21,11 +21,6 @@ const typstStyle = `
 .typst-loading p{margin:0;color:#6a778b;font-size:13px}
 .typst-error{color:#9f1d1d}
 .typst-error pre{max-height:360px;margin:14px 0 0;overflow:auto;border-radius:10px;background:#fff1f2;color:#9f1d1d;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,'Liberation Mono',monospace;font-size:12px;line-height:1.7;padding:14px;white-space:pre-wrap}
-.typst-source-fallback{box-sizing:border-box;width:min(1040px,calc(100% - 32px));margin:28px auto 44px;border:1px solid rgba(20,35,53,.1);border-radius:16px;background:#fff;box-shadow:0 18px 44px rgba(15,23,42,.14);overflow:hidden}
-.typst-source-fallback header{padding:18px 20px;border-bottom:1px solid rgba(120,134,155,.18);background:linear-gradient(135deg,#f0fdf4,#eff6ff)}
-.typst-source-fallback strong{display:block;color:#172033;font-size:15px;font-weight:850}
-.typst-source-fallback p{margin:6px 0 0;color:#5f6e84;font-size:13px;line-height:1.7}
-.typst-source-fallback pre{box-sizing:border-box;max-height:none;margin:0;overflow:auto;background:#0f172a;color:#e2e8f0;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,'Liberation Mono',monospace;font-size:13px;line-height:1.75;padding:20px;tab-size:2;white-space:pre}
 .file-viewer[data-viewer-theme='dark'] .typst-viewer{background:#101820;color:#e6edf3}
 .file-viewer[data-viewer-theme='dark'] .typst-toolbar{border-bottom-color:rgba(139,148,158,.22);background:rgba(15,23,42,.9)}
 .file-viewer[data-viewer-theme='dark'] .typst-toolbar strong{color:#f8fafc}
@@ -33,19 +28,15 @@ const typstStyle = `
 .file-viewer[data-viewer-theme='dark'] .typst-page-shell{border-color:rgba(139,148,158,.26);box-shadow:0 24px 56px rgba(0,0,0,.38)}
 .file-viewer[data-viewer-theme='dark'] .typst-loading,.file-viewer[data-viewer-theme='dark'] .typst-error{border-color:rgba(139,148,158,.22);background:#151b23;box-shadow:0 24px 56px rgba(0,0,0,.32)}
 .file-viewer[data-viewer-theme='dark'] .typst-loading strong,.file-viewer[data-viewer-theme='dark'] .typst-error strong{color:#f8fafc}
-.file-viewer[data-viewer-theme='dark'] .typst-source-fallback{border-color:rgba(139,148,158,.26);background:#151b23;box-shadow:0 24px 56px rgba(0,0,0,.32)}
-.file-viewer[data-viewer-theme='dark'] .typst-source-fallback header{border-bottom-color:rgba(139,148,158,.22);background:linear-gradient(135deg,rgba(16,185,129,.18),rgba(59,130,246,.16))}
-.file-viewer[data-viewer-theme='dark'] .typst-source-fallback strong{color:#f8fafc}
-.file-viewer[data-viewer-theme='dark'] .typst-source-fallback p{color:#9aa7b8}
 @keyframes typst-spin{to{transform:rotate(360deg)}}
 @media (max-width:767px){.typst-toolbar{align-items:flex-start;flex-direction:column;gap:4px}.typst-pages{gap:16px;padding:16px 10px 28px}}
-@media (prefers-color-scheme:dark){.file-viewer[data-viewer-theme='system'] .typst-viewer{background:#101820;color:#e6edf3}.file-viewer[data-viewer-theme='system'] .typst-toolbar{border-bottom-color:rgba(139,148,158,.22);background:rgba(15,23,42,.9)}.file-viewer[data-viewer-theme='system'] .typst-toolbar strong{color:#f8fafc}.file-viewer[data-viewer-theme='system'] .typst-toolbar span,.file-viewer[data-viewer-theme='system'] .typst-toolbar em{color:#9aa7b8}.file-viewer[data-viewer-theme='system'] .typst-page-shell{border-color:rgba(139,148,158,.26);box-shadow:0 24px 56px rgba(0,0,0,.38)}.file-viewer[data-viewer-theme='system'] .typst-loading,.file-viewer[data-viewer-theme='system'] .typst-error{border-color:rgba(139,148,158,.22);background:#151b23;box-shadow:0 24px 56px rgba(0,0,0,.32)}.file-viewer[data-viewer-theme='system'] .typst-loading strong,.file-viewer[data-viewer-theme='system'] .typst-error strong{color:#f8fafc}.file-viewer[data-viewer-theme='system'] .typst-source-fallback{border-color:rgba(139,148,158,.26);background:#151b23;box-shadow:0 24px 56px rgba(0,0,0,.32)}.file-viewer[data-viewer-theme='system'] .typst-source-fallback header{border-bottom-color:rgba(139,148,158,.22);background:linear-gradient(135deg,rgba(16,185,129,.18),rgba(59,130,246,.16))}.file-viewer[data-viewer-theme='system'] .typst-source-fallback strong{color:#f8fafc}.file-viewer[data-viewer-theme='system'] .typst-source-fallback p{color:#9aa7b8}}
+@media (prefers-color-scheme:dark){.file-viewer[data-viewer-theme='system'] .typst-viewer{background:#101820;color:#e6edf3}.file-viewer[data-viewer-theme='system'] .typst-toolbar{border-bottom-color:rgba(139,148,158,.22);background:rgba(15,23,42,.9)}.file-viewer[data-viewer-theme='system'] .typst-toolbar strong{color:#f8fafc}.file-viewer[data-viewer-theme='system'] .typst-toolbar span,.file-viewer[data-viewer-theme='system'] .typst-toolbar em{color:#9aa7b8}.file-viewer[data-viewer-theme='system'] .typst-page-shell{border-color:rgba(139,148,158,.26);box-shadow:0 24px 56px rgba(0,0,0,.38)}.file-viewer[data-viewer-theme='system'] .typst-loading,.file-viewer[data-viewer-theme='system'] .typst-error{border-color:rgba(139,148,158,.22);background:#151b23;box-shadow:0 24px 56px rgba(0,0,0,.32)}.file-viewer[data-viewer-theme='system'] .typst-loading strong,.file-viewer[data-viewer-theme='system'] .typst-error strong{color:#f8fafc}}
 `;
 let typstEngineConfigKey = '';
-const DEFAULT_TYPST_RENDER_TIMEOUT_MS = 20000;
+const DEFAULT_TYPST_RENDER_TIMEOUT_MS = 60000;
 class TypstRenderTimeoutError extends Error {
     constructor(timeoutMs) {
-        super(`Typst 编译超过 ${Math.round(timeoutMs / 1000)} 秒，已切换为源码预览`);
+        super(`Typst 编译超过 ${Math.round(timeoutMs / 1000)} 秒`);
         this.name = 'TypstRenderTimeoutError';
     }
 }
@@ -70,15 +61,7 @@ const getWindowOverride = (key) => {
     }
     return window[key];
 };
-const configureTypstEngine = (context, documentBaseUrl) => {
-    var _a;
-    const typstOptions = (_a = context === null || context === void 0 ? void 0 : context.options) === null || _a === void 0 ? void 0 : _a.typst;
-    const compilerWasmUrl = resolveFileViewerTypstCompilerWasmUrl(typstOptions, [
-        getWindowOverride('__FLYFISH_TYPST_COMPILER_WASM_URL__'),
-    ], documentBaseUrl);
-    const rendererWasmUrl = resolveFileViewerTypstRendererWasmUrl(typstOptions, [
-        getWindowOverride('__FLYFISH_TYPST_RENDERER_WASM_URL__'),
-    ], documentBaseUrl);
+const configureTypstEngine = (compilerWasmUrl, rendererWasmUrl) => {
     const configKey = `${compilerWasmUrl}\n${rendererWasmUrl}`;
     if (typstEngineConfigKey === configKey) {
         return;
@@ -91,6 +74,69 @@ const configureTypstEngine = (context, documentBaseUrl) => {
     });
     typstEngineConfigKey = configKey;
 };
+const pushUniqueTypstCandidate = (candidates, candidate) => {
+    if (candidates.some(item => item.compilerWasmUrl === candidate.compilerWasmUrl &&
+        item.rendererWasmUrl === candidate.rendererWasmUrl)) {
+        return;
+    }
+    candidates.push(candidate);
+};
+const resolveTypstEngineCandidates = (context, documentBaseUrl) => {
+    var _a;
+    const typstOptions = (_a = context === null || context === void 0 ? void 0 : context.options) === null || _a === void 0 ? void 0 : _a.typst;
+    const compilerOverride = getWindowOverride('__FLYFISH_TYPST_COMPILER_WASM_URL__');
+    const rendererOverride = getWindowOverride('__FLYFISH_TYPST_RENDERER_WASM_URL__');
+    const compilerWasmUrl = resolveFileViewerTypstCompilerWasmUrl(typstOptions, [
+        compilerOverride,
+    ], documentBaseUrl);
+    const rendererWasmUrl = resolveFileViewerTypstRendererWasmUrl(typstOptions, [
+        rendererOverride,
+    ], documentBaseUrl);
+    const hasConfiguredAsset = Boolean((typstOptions === null || typstOptions === void 0 ? void 0 : typstOptions.compilerWasmUrl) ||
+        (typstOptions === null || typstOptions === void 0 ? void 0 : typstOptions.rendererWasmUrl) ||
+        compilerOverride ||
+        rendererOverride);
+    const candidates = [];
+    pushUniqueTypstCandidate(candidates, {
+        compilerWasmUrl,
+        rendererWasmUrl,
+        source: hasConfiguredAsset ? 'configured' : 'local',
+        preflight: !hasConfiguredAsset,
+    });
+    return candidates;
+};
+const isHttpUrl = (url) => /^https?:\/\//i.test(url);
+const isKnownMissingWasmUrl = async (url) => {
+    if (typeof fetch !== 'function' || !isHttpUrl(url)) {
+        return false;
+    }
+    try {
+        const response = await fetch(url, {
+            cache: 'force-cache',
+            method: 'HEAD',
+        });
+        return response.status === 404 || response.status === 410;
+    }
+    catch {
+        return false;
+    }
+};
+const resolveKnownMissingTypstAsset = async (candidate) => {
+    if (await isKnownMissingWasmUrl(candidate.compilerWasmUrl)) {
+        return `Typst compiler WASM missing: ${candidate.compilerWasmUrl}`;
+    }
+    if (await isKnownMissingWasmUrl(candidate.rendererWasmUrl)) {
+        return `Typst renderer WASM missing: ${candidate.rendererWasmUrl}`;
+    }
+    return '';
+};
+const isTypstAssetLoadError = (error) => {
+    if (Array.isArray(error)) {
+        return false;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return /wasm|webassembly|fetch|module|instantiate|compile|network|404|410/i.test(message);
+};
 const escapeAttribute = (value) => {
     return value.replace(/[&<>"']/g, char => {
         const entities = {
@@ -184,6 +230,22 @@ const formatTypstError = (error) => {
     }
     return String(error);
 };
+const formatTypstRuntimeError = (error) => {
+    const message = formatTypstError(error);
+    if (error instanceof TypstRenderTimeoutError) {
+        return [
+            message,
+            '请检查 Typst 源文件复杂度，或通过 options.typst.renderTimeoutMs 调大浏览器端编译超时。'
+        ].join('\n\n');
+    }
+    if (isTypstAssetLoadError(error)) {
+        return [
+            message,
+            'Typst 需要本地 compiler / renderer WASM。请运行 file-viewer-copy-assets，或配置 options.typst.compilerWasmUrl / options.typst.rendererWasmUrl，并确认服务器以 application/wasm 返回资源。'
+        ].join('\n\n');
+    }
+    return message;
+};
 const clampZoom = (value) => {
     return Math.min(3, Math.max(0.3, Number(value.toFixed(2))));
 };
@@ -308,7 +370,6 @@ export default async function renderTypst(buffer, target, _type, context) {
     let state = 'loading';
     let pages = [];
     let errorMessage = '';
-    let sourceFallbackMessage = '';
     let zoom = 1;
     let renderToken = 0;
     let disposed = false;
@@ -374,16 +435,6 @@ export default async function renderTypst(buffer, target, _type, context) {
         error.append(createElement(documentRef, 'strong', undefined, 'Typst 渲染失败'), createElement(documentRef, 'pre', undefined, errorMessage));
         body.replaceChildren(error);
     };
-    const renderSourceFallback = () => {
-        const fallback = createElement(documentRef, 'main', 'typst-source-fallback');
-        fallback.setAttribute('aria-label', 'Typst source preview');
-        const header = createElement(documentRef, 'header');
-        header.append(createElement(documentRef, 'strong', undefined, '已切换为 Typst 源码预览'), createElement(documentRef, 'p', undefined, sourceFallbackMessage || '当前浏览器没有在预期时间内完成 Typst 编译，源码仍可完整查看。'));
-        const pre = createElement(documentRef, 'pre');
-        pre.textContent = source;
-        fallback.append(header, pre);
-        body.replaceChildren(fallback);
-    };
     const renderPages = () => {
         pageShells.clear();
         const pagesRoot = createElement(documentRef, 'main', 'typst-pages');
@@ -403,49 +454,66 @@ export default async function renderTypst(buffer, target, _type, context) {
     const syncUi = () => {
         summary.textContent = state === 'ready'
             ? getPageSummary(pages)
-            : state === 'source'
-                ? 'Typst source preview'
-                : 'Typst WASM renderer';
+            : 'Typst WASM renderer';
         status.textContent = state === 'loading'
             ? '正在编译'
             : state === 'error'
                 ? '编译失败'
-                : state === 'source'
-                    ? '源码预览'
-                    : '已渲染';
+                : '已渲染';
         if (state === 'loading') {
             renderLoading();
         }
         else if (state === 'error') {
             renderError();
         }
-        else if (state === 'source') {
-            renderSourceFallback();
-        }
         else {
             renderPages();
         }
     };
+    const renderTypstSvg = async () => {
+        var _a, _b;
+        const candidates = resolveTypstEngineCandidates(context, documentRef.baseURI);
+        const timeoutMs = normalizeRenderTimeoutMs((_b = (_a = context === null || context === void 0 ? void 0 : context.options) === null || _a === void 0 ? void 0 : _a.typst) === null || _b === void 0 ? void 0 : _b.renderTimeoutMs);
+        let lastError;
+        for (const candidate of candidates) {
+            const missingAsset = candidate.preflight
+                ? await resolveKnownMissingTypstAsset(candidate)
+                : '';
+            if (missingAsset) {
+                lastError = new Error(missingAsset);
+                continue;
+            }
+            try {
+                configureTypstEngine(candidate.compilerWasmUrl, candidate.rendererWasmUrl);
+                return await withRenderTimeout($typst.svg({
+                    mainContent: source,
+                    data_selection: {
+                        body: true,
+                        defs: true,
+                        css: true,
+                        js: false,
+                    },
+                }), timeoutMs);
+            }
+            catch (error) {
+                lastError = error;
+                if (error instanceof TypstRenderTimeoutError || !isTypstAssetLoadError(error)) {
+                    throw error;
+                }
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error('Typst WASM 加载失败');
+    };
     const render = async () => {
-        var _a, _b, _c, _d, _e;
+        var _a, _b;
         const token = ++renderToken;
         state = 'loading';
         errorMessage = '';
-        sourceFallbackMessage = '';
         pages = [];
         (_a = context === null || context === void 0 ? void 0 : context.registerExportAdapter) === null || _a === void 0 ? void 0 : _a.call(context, null);
         syncUi();
         try {
-            configureTypstEngine(context, documentRef.baseURI);
-            const svg = await withRenderTimeout($typst.svg({
-                mainContent: source,
-                data_selection: {
-                    body: true,
-                    defs: true,
-                    css: true,
-                    js: false,
-                },
-            }), normalizeRenderTimeoutMs((_c = (_b = context === null || context === void 0 ? void 0 : context.options) === null || _b === void 0 ? void 0 : _b.typst) === null || _c === void 0 ? void 0 : _c.renderTimeoutMs));
+            const svg = await renderTypstSvg();
             if (disposed || token !== renderToken) {
                 return;
             }
@@ -453,20 +521,13 @@ export default async function renderTypst(buffer, target, _type, context) {
             state = 'ready';
             syncUi();
             registerExportAdapter();
-            (_d = context === null || context === void 0 ? void 0 : context.onProgressiveRender) === null || _d === void 0 ? void 0 : _d.call(context);
+            (_b = context === null || context === void 0 ? void 0 : context.onProgressiveRender) === null || _b === void 0 ? void 0 : _b.call(context);
         }
         catch (error) {
             if (disposed || token !== renderToken) {
                 return;
             }
-            if (error instanceof TypstRenderTimeoutError) {
-                sourceFallbackMessage = error.message;
-                state = 'source';
-                syncUi();
-                (_e = context === null || context === void 0 ? void 0 : context.onProgressiveRender) === null || _e === void 0 ? void 0 : _e.call(context);
-                return;
-            }
-            errorMessage = formatTypstError(error);
+            errorMessage = formatTypstRuntimeError(error);
             state = 'error';
             syncUi();
         }