@file-viewer/core 3.0.1 → 3.0.3

package/dist/browser/controller.js

@@ -326,7 +326,9 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
             // customer's ShadowRoot. Reusing the ancestor would let that component's
             // resets override the toolbar and would make our :host rules mutate the
             // customer's outer custom element.
-            renderRoot = container.attachShadow({ mode: 'open', delegatesFocus: true });
+            // Delegated focus makes Safari taps on renderer controls focus the first
+            // toolbar input instead, triggering keyboard zoom and viewport scrolling.
+            renderRoot = container.attachShadow({ mode: 'open' });
             ownedViewerShadowRoots.set(container, renderRoot);
         }
         catch {
@@ -345,7 +347,7 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
         existingHostShadowRoot.appendChild(mountBoundary);
         if (shouldUseShadowRoot && typeof mountBoundary.attachShadow === 'function') {
             try {
-                renderRoot = mountBoundary.attachShadow({ mode: 'open', delegatesFocus: true });
+                renderRoot = mountBoundary.attachShadow({ mode: 'open' });
             }
             catch {
                 renderRoot = mountBoundary;

package/dist/contracts/types.d.ts

@@ -3,7 +3,7 @@ export type FileViewerThemeMode = 'light' | 'dark' | 'system';
 export type FileViewerResolvedThemeMode = Exclude<FileViewerThemeMode, 'system'>;
 export type FileViewerLocale = 'auto' | 'zh-CN' | 'en-US' | 'ja-JP' | 'de-DE' | (string & {});
 export type FileViewerStyleIsolation = 'auto' | 'shadow' | 'scoped' | 'none';
-export type FileViewerMessageKey = 'toolbar.zoomGroup' | 'toolbar.zoomOut' | 'toolbar.zoomIn' | 'toolbar.zoomReset' | 'toolbar.download' | 'toolbar.downloadTitle' | 'toolbar.print' | 'toolbar.printTitle' | 'toolbar.printDirect' | 'toolbar.printMask' | 'toolbar.printMaskTitle' | 'toolbar.printMaskAdd' | 'toolbar.printMaskClear' | 'toolbar.printMaskCancel' | 'toolbar.printMaskConfirm' | 'toolbar.printMaskHint' | 'toolbar.printStampUpload' | 'toolbar.printStampRemove' | 'toolbar.printStampResize' | 'toolbar.exportHtml' | 'toolbar.exportHtmlTitle' | 'toolbar.search' | 'toolbar.searchPlaceholder' | 'toolbar.searchPrevious' | 'toolbar.searchNext' | 'toolbar.searchClear' | 'toolbar.theme' | 'toolbar.themeToLight' | 'toolbar.themeToDark' | 'state.ready.title' | 'state.ready.message' | 'state.empty.title' | 'state.empty.message' | 'state.unsupported.install.title' | 'state.unsupported.install.message' | 'state.unsupported.install.description' | 'state.unsupported.title' | 'state.unsupported.message' | 'state.unsupported.description' | 'state.error.title' | 'preview.downloading' | 'preview.streamingPdf' | 'preview.reading' | 'error.download' | 'error.print' | 'error.exportHtml' | 'error.noDownloadSource' | 'error.noExportContent' | 'error.printUnavailable' | 'error.printWindowBlocked' | 'error.remoteDownload' | 'error.localRead' | 'error.load' | 'error.stream' | 'error.beforeOperation' | 'error.unknown' | 'error.blobUnavailable' | 'error.sourceUnsupported' | 'error.fileReadArrayBuffer' | 'error.fileReadDataUrl' | 'error.fileReadText' | 'error.imageDataUrlRead' | 'operation.download' | 'operation.print' | 'operation.exportHtml' | 'operation.zoomIn' | 'operation.zoomOut' | 'operation.zoomReset' | 'pdf.toolbar.toggleNavigation' | 'pdf.toolbar.previousPage' | 'pdf.toolbar.nextPage' | 'pdf.toolbar.fitWidth' | 'pdf.toolbar.zoomOut' | 'pdf.toolbar.zoomIn' | 'pdf.toolbar.rotateLeft' | 'pdf.toolbar.rotateRight' | 'pdf.nav.typeLabel' | 'pdf.nav.pagesTab' | 'pdf.nav.outlineTab' | 'pdf.nav.pagesTitle' | 'pdf.nav.outlineTitle' | 'pdf.nav.pageCount' | 'pdf.nav.itemCount' | 'pdf.nav.pageLabel' | 'pdf.nav.outlineEmpty' | 'pdf.nav.outlineFallbackTitle' | 'pdf.thumbnail.alt' | 'pdf.state.loading' | 'pdf.error.browserWindow' | 'pdf.error.missingSource' | 'pdf.error.loadFailed' | 'pdf.error.notLoaded' | 'pdf.error.unloaded' | 'pdf.error.canvasUnavailable' | 'pdf.export.pageTitle' | 'spreadsheet.loading.kicker' | 'spreadsheet.loading.title' | 'spreadsheet.loading.hint' | 'spreadsheet.loading.streaming' | 'spreadsheet.tabs.ariaLabel' | 'spreadsheet.state.parsingWorkbook' | 'spreadsheet.state.preparingSheet' | 'spreadsheet.state.preparingSheetNamed' | 'spreadsheet.state.cachedRows' | 'spreadsheet.state.rows' | 'spreadsheet.state.rowsAndColumns' | 'spreadsheet.error.parseFailed' | 'spreadsheet.error.workerFailed' | 'word.error.invalidDocx' | 'word.error.missingOdfContent' | 'word.error.odfXmlParseFailed' | 'word.title.rtf' | 'word.title.openDocumentPresentation' | 'word.title.openDocumentText' | 'word.page.fallback' | 'word.page.empty' | 'word.body' | 'word.body.empty' | 'ofd.toolbar.pageNavigation' | 'ofd.toolbar.documentPages' | 'ofd.toolbar.previousPage' | 'ofd.toolbar.nextPage' | 'ofd.toolbar.pageStatus' | 'ofd.toolbar.noPages' | 'ofd.state.loading' | 'ofd.error.empty' | 'ofd.error.parseFailed' | 'presentation.state.loading' | 'presentation.error.title' | 'presentation.error.parseFailed' | 'presentation.ppt.state.loading' | 'presentation.ppt.error.title' | 'presentation.ppt.error.parseFailed' | 'presentation.ppt.error.assetHint' | 'presentation.slideshow.start' | 'presentation.slideshow.exit' | 'presentation.slideshow.hint' | 'archive.error.nestedUnsupported' | 'archive.loading.readingDirectory' | 'archive.loading.readingDirectoryHint' | 'archive.search.placeholder' | 'archive.sidebar.hide' | 'archive.sidebar.show' | 'archive.preview.title' | 'archive.preview.chooseFile' | 'archive.preview.downloadFile' | 'archive.error.title' | 'archive.stats.summary' | 'archive.warning.encrypted' | 'archive.password.title' | 'archive.password.description' | 'archive.password.placeholder' | 'archive.password.invalid' | 'archive.password.required' | 'archive.password.cancel' | 'archive.password.confirm' | 'archive.error.passwordRequired' | 'archive.error.encryptedRequiresWorker' | 'archive.empty.title' | 'archive.empty.message' | 'archive.loading.initializingCandidate' | 'archive.loading.initializingCandidateHint' | 'archive.error.candidateInitTimeout' | 'archive.error.encryptedCheckTimeout' | 'archive.loading.directoryReadyHint' | 'archive.error.candidateReadTimeout' | 'archive.loading.workerFallback' | 'archive.loading.workerFallbackHint' | 'archive.notice.workerFallback' | 'archive.error.tooLarge' | 'archive.loading.initializingWorker' | 'archive.loading.initializingWorkerHint' | 'archive.error.workerInitFailed' | 'archive.error.workerUnsupported' | 'archive.error.indexedDbUnavailable' | 'archive.error.entryTooLarge' | 'archive.loading.extracting' | 'archive.loading.rendering' | 'archive.loading.exporting' | 'media.audio.title' | 'media.audio.description' | 'media.audio.unsupported' | 'media.video.title' | 'media.video.unsupported' | 'media.video.hlsHint' | 'media.video.codecUnsupportedBadge' | 'media.video.codecUnsupportedTitle' | 'media.video.codecUnsupportedDescription' | 'media.video.codecUnsupportedAction' | 'media.video.softwareLoading' | 'media.video.softwareBadge' | 'media.video.play' | 'media.video.pause' | 'media.video.seek' | 'media.video.mute' | 'media.video.unmute' | 'media.video.fullscreen' | 'media.midi.title' | 'media.midi.loading' | 'media.midi.trackHeader' | 'media.midi.instrumentHeader' | 'media.midi.channelHeader' | 'media.midi.noteCountHeader' | 'media.midi.durationHeader' | 'media.midi.durationStat' | 'media.midi.trackStat' | 'media.midi.noteStat' | 'media.midi.parseFailed' | 'email.mbox.subject' | 'email.mbox.summary' | 'email.error.title' | 'email.meta.from' | 'email.meta.to' | 'email.meta.cc' | 'email.meta.date' | 'email.tabs.text' | 'email.tabs.headers' | 'email.attachments.title' | 'email.attachments.empty' | 'email.attachments.download' | 'email.attachments.opening' | 'email.attachments.nestedUnavailable' | 'email.loading.parsing' | 'data.font.sample' | 'data.error.fontFaceUnsupported' | 'data.title.font' | 'data.title.sqlite' | 'data.title.parquet' | 'data.title.avro' | 'data.title.wasm' | 'data.title.eps' | 'data.title.ai' | 'data.title.webarchive' | 'data.title.summary' | 'data.label.format' | 'data.label.size' | 'data.label.rendering' | 'data.label.objects' | 'data.label.sampleTable' | 'data.label.rows' | 'data.label.columns' | 'data.label.sampleRows' | 'data.label.imports' | 'data.label.exports' | 'data.label.magic' | 'data.label.note' | 'data.label.container' | 'data.value.schemaRead' | 'data.value.schemaUnread' | 'data.note.aiSummary' | 'data.note.postscriptSummary' | 'data.note.webarchive' | 'data.image.alt' | 'psd.title' | 'psd.action.fit' | 'psd.action.showAll' | 'psd.action.hideAll' | 'psd.layers.title' | 'psd.layers.redrawable' | 'psd.layers.empty' | 'psd.layers.hidden' | 'drawing.error.viewerLoadFailed' | 'drawing.error.excalidrawEmpty' | 'drawing.error.excalidrawTimeout' | 'drawing.error.drawioParseFailed' | 'drawing.error.drawioNoModel' | 'drawing.error.drawioNoElements' | 'drawing.error.viewerInitFailed' | 'drawing.error.drawioTimeout' | 'drawing.error.svgParseFailed' | 'drawing.error.plantumlRenderFailed' | 'drawing.title.excalidraw' | 'drawing.title.mermaid' | 'drawing.title.plantuml' | 'drawing.title.drawio' | 'drawing.toolbar.zoomOut' | 'drawing.toolbar.zoomIn' | 'drawing.toolbar.fit' | 'drawing.toolbar.fitWidth' | 'drawing.state.loading' | 'text.code.loadingHighlight' | 'text.code.formattedPreview' | 'text.code.showOriginal' | 'text.code.showFormatted' | 'text.code.indexingLargeFile' | 'text.code.virtualized' | 'text.code.firstSegment' | 'text.code.previousSegment' | 'text.code.nextSegment' | 'text.code.lastSegment' | 'ebook.toc' | 'ebook.reading' | 'ebook.itemCount' | 'epub.title' | 'epub.previousPage' | 'epub.nextPage' | 'epub.loading' | 'epub.chapterFallback' | 'epub.renderIncomplete' | 'umd.title' | 'umd.previousChapter' | 'umd.nextChapter' | 'umd.loading' | 'umd.emptyContent' | 'umd.chapterFallback' | 'umd.galleryFallback' | 'umd.warningBodyTooShort' | 'umd.error.unexpectedEnd' | 'umd.error.invalidFile' | 'typst.summaryRenderer' | 'typst.pageSummary.empty' | 'typst.pageSummary.ready' | 'typst.status.compiling' | 'typst.status.failed' | 'typst.status.rendered' | 'typst.loading.title' | 'typst.loading.hint' | 'typst.error.title' | 'typst.error.timeout' | 'typst.error.timeoutHint' | 'typst.error.assetHint' | 'typst.error.svgParseFailed' | 'typst.error.wasmLoadFailed' | 'xmind.toolbar.zoomOut' | 'xmind.toolbar.zoomIn' | 'xmind.toolbar.fit' | 'xmind.toolbar.fitTitle' | 'xmind.state.loading' | 'xmind.stats.nodes' | 'xmind.stats.depth' | 'xmind.stats.theme' | 'xmind.stats.template' | 'xmind.badge.paused' | 'xmind.badge.collapsed' | 'xmind.badge.floating' | 'xmind.badge.summary' | 'xmind.badge.callout' | 'xmind.imageResource' | 'xmind.error.unrecognized' | 'xmind.error.noCanvas' | 'cad.toolbar.fit' | 'cad.toolbar.zoomOut' | 'cad.toolbar.zoomIn' | 'cad.layers.title' | 'cad.layers.count' | 'cad.layers.merged' | 'cad.inspector.title' | 'cad.inspector.entities' | 'cad.inspector.blocks' | 'cad.inspector.pages' | 'cad.inspector.drawn' | 'cad.state.loadingViewer' | 'cad.state.parsing' | 'cad.error.parseFailed' | 'image.alt' | 'image.toolbar.rotation' | 'image.toolbar.rotateLeft' | 'image.toolbar.rotateRight' | 'image.lightbox.alt' | 'image.lightbox.close' | 'gitBundle.error.invalid' | 'gitBundle.error.missingPack' | 'gitBundle.notice.delta' | 'gitBundle.title.history' | 'gitBundle.title.fileTree' | 'gitBundle.file.choose' | 'gitBundle.file.noTree' | 'gitBundle.file.none' | 'gitBundle.history.empty' | 'gitBundle.toolbar.summary' | 'gitBundle.meta.bundle' | 'gitBundle.meta.refs' | 'gitBundle.meta.commits' | 'gitBundle.meta.objects' | 'gitBundle.meta.deltas' | 'gitBundle.meta.objectFormat' | 'gitBundle.meta.objectTypes' | 'geo.error.unrecognized' | 'geo.error.xmlParseFailed' | 'geo.error.unsupported' | 'geo.title' | 'geo.featureCount' | 'geo.bounds' | 'geo.geometryTypes' | 'geo.aria' | 'geo.loading' | 'geo.projection' | 'geo.engine' | 'geo.basemap' | 'geo.basemap.offline' | 'geo.basemap.custom' | 'geo.engine.maplibre' | 'geo.engine.svg' | 'geo.error.projection' | 'geo.action.fit' | 'model.toolbar.fit' | 'model.toolbar.rotate' | 'model.toolbar.wireframe' | 'model.toolbar.grid' | 'model.toolbar.axes' | 'model.state.loadingSummary' | 'model.state.loading' | 'model.state.loaded' | 'model.state.parseFailed' | 'model.summary.meshes' | 'model.summary.points' | 'model.error.daeEmpty' | 'model.error.unsupported' | 'model.error.parseFailed' | 'model.notice.signature' | 'loading.generic.label' | 'loading.generic.hint' | 'loading.word.label' | 'loading.word.hint' | 'loading.wordWorker.hint' | 'loading.sheet.label' | 'loading.sheet.hint' | 'loading.csv.label' | 'loading.csv.hint' | 'loading.presentation.label' | 'loading.presentation.hint' | 'loading.pdf.label' | 'loading.pdf.hint' | 'loading.ofd.label' | 'loading.ofd.hint' | 'loading.archive.label' | 'loading.archive.hint' | 'loading.email.label' | 'loading.email.hint' | 'loading.msg.hint' | 'loading.eda.label' | 'loading.eda.hint' | 'loading.cad.label' | 'loading.cad.hint' | 'loading.dwg.hint' | 'loading.dwf.hint' | 'loading.dwfx.hint' | 'loading.xps.hint' | 'loading.drawio.label' | 'loading.drawio.hint' | 'loading.excalidraw.label' | 'loading.excalidraw.hint' | 'loading.epub.label' | 'loading.epub.hint' | 'loading.umd.label' | 'loading.umd.hint' | 'loading.image.label' | 'loading.image.hint' | 'loading.video.label' | 'loading.video.hint' | 'loading.audio.label' | 'loading.audio.hint';
+export type FileViewerMessageKey = 'toolbar.zoomGroup' | 'toolbar.zoomOut' | 'toolbar.zoomIn' | 'toolbar.zoomReset' | 'toolbar.download' | 'toolbar.downloadTitle' | 'toolbar.print' | 'toolbar.printTitle' | 'toolbar.printDirect' | 'toolbar.printMask' | 'toolbar.printMaskTitle' | 'toolbar.printMaskAdd' | 'toolbar.printMaskClear' | 'toolbar.printMaskCancel' | 'toolbar.printMaskConfirm' | 'toolbar.printMaskHint' | 'toolbar.printStampUpload' | 'toolbar.printStampRemove' | 'toolbar.printStampResize' | 'toolbar.exportHtml' | 'toolbar.exportHtmlTitle' | 'toolbar.search' | 'toolbar.searchPlaceholder' | 'toolbar.searchPrevious' | 'toolbar.searchNext' | 'toolbar.searchClear' | 'toolbar.searchClose' | 'toolbar.more' | 'toolbar.theme' | 'toolbar.themeToLight' | 'toolbar.themeToDark' | 'state.ready.title' | 'state.ready.message' | 'state.empty.title' | 'state.empty.message' | 'state.unsupported.install.title' | 'state.unsupported.install.message' | 'state.unsupported.install.description' | 'state.unsupported.title' | 'state.unsupported.message' | 'state.unsupported.description' | 'state.error.title' | 'preview.downloading' | 'preview.streamingPdf' | 'preview.reading' | 'error.download' | 'error.print' | 'error.exportHtml' | 'error.noDownloadSource' | 'error.noExportContent' | 'error.printUnavailable' | 'error.printWindowBlocked' | 'error.remoteDownload' | 'error.localRead' | 'error.load' | 'error.stream' | 'error.beforeOperation' | 'error.unknown' | 'error.blobUnavailable' | 'error.sourceUnsupported' | 'error.fileReadArrayBuffer' | 'error.fileReadDataUrl' | 'error.fileReadText' | 'error.imageDataUrlRead' | 'operation.download' | 'operation.print' | 'operation.exportHtml' | 'operation.zoomIn' | 'operation.zoomOut' | 'operation.zoomReset' | 'pdf.toolbar.toggleNavigation' | 'pdf.toolbar.previousPage' | 'pdf.toolbar.nextPage' | 'pdf.toolbar.fitWidth' | 'pdf.toolbar.zoomOut' | 'pdf.toolbar.zoomIn' | 'pdf.toolbar.rotateLeft' | 'pdf.toolbar.rotateRight' | 'pdf.nav.typeLabel' | 'pdf.nav.pagesTab' | 'pdf.nav.outlineTab' | 'pdf.nav.pagesTitle' | 'pdf.nav.outlineTitle' | 'pdf.nav.pageCount' | 'pdf.nav.itemCount' | 'pdf.nav.pageLabel' | 'pdf.nav.outlineEmpty' | 'pdf.nav.outlineFallbackTitle' | 'pdf.thumbnail.alt' | 'pdf.state.loading' | 'pdf.error.browserWindow' | 'pdf.error.missingSource' | 'pdf.error.loadFailed' | 'pdf.error.notLoaded' | 'pdf.error.unloaded' | 'pdf.error.canvasUnavailable' | 'pdf.export.pageTitle' | 'spreadsheet.loading.kicker' | 'spreadsheet.loading.title' | 'spreadsheet.loading.hint' | 'spreadsheet.loading.streaming' | 'spreadsheet.tabs.ariaLabel' | 'spreadsheet.state.parsingWorkbook' | 'spreadsheet.state.preparingSheet' | 'spreadsheet.state.preparingSheetNamed' | 'spreadsheet.state.cachedRows' | 'spreadsheet.state.rows' | 'spreadsheet.state.rowsAndColumns' | 'spreadsheet.error.parseFailed' | 'spreadsheet.error.workerFailed' | 'word.error.invalidDocx' | 'word.error.missingOdfContent' | 'word.error.odfXmlParseFailed' | 'word.title.rtf' | 'word.title.openDocumentPresentation' | 'word.title.openDocumentText' | 'word.page.fallback' | 'word.page.empty' | 'word.body' | 'word.body.empty' | 'ofd.toolbar.pageNavigation' | 'ofd.toolbar.documentPages' | 'ofd.toolbar.previousPage' | 'ofd.toolbar.nextPage' | 'ofd.toolbar.pageStatus' | 'ofd.toolbar.noPages' | 'ofd.state.loading' | 'ofd.error.empty' | 'ofd.error.parseFailed' | 'presentation.state.loading' | 'presentation.error.title' | 'presentation.error.parseFailed' | 'presentation.ppt.state.loading' | 'presentation.ppt.error.title' | 'presentation.ppt.error.parseFailed' | 'presentation.ppt.error.assetHint' | 'presentation.slideshow.start' | 'presentation.slideshow.exit' | 'presentation.slideshow.hint' | 'archive.error.nestedUnsupported' | 'archive.loading.readingDirectory' | 'archive.loading.readingDirectoryHint' | 'archive.search.placeholder' | 'archive.sidebar.hide' | 'archive.sidebar.show' | 'archive.preview.title' | 'archive.preview.chooseFile' | 'archive.preview.downloadFile' | 'archive.error.title' | 'archive.stats.summary' | 'archive.warning.encrypted' | 'archive.password.title' | 'archive.password.description' | 'archive.password.placeholder' | 'archive.password.invalid' | 'archive.password.required' | 'archive.password.cancel' | 'archive.password.confirm' | 'archive.error.passwordRequired' | 'archive.error.encryptedRequiresWorker' | 'archive.empty.title' | 'archive.empty.message' | 'archive.loading.initializingCandidate' | 'archive.loading.initializingCandidateHint' | 'archive.error.candidateInitTimeout' | 'archive.error.encryptedCheckTimeout' | 'archive.loading.directoryReadyHint' | 'archive.error.candidateReadTimeout' | 'archive.loading.workerFallback' | 'archive.loading.workerFallbackHint' | 'archive.notice.workerFallback' | 'archive.error.tooLarge' | 'archive.loading.initializingWorker' | 'archive.loading.initializingWorkerHint' | 'archive.error.workerInitFailed' | 'archive.error.workerUnsupported' | 'archive.error.indexedDbUnavailable' | 'archive.error.entryTooLarge' | 'archive.loading.extracting' | 'archive.loading.rendering' | 'archive.loading.exporting' | 'media.audio.title' | 'media.audio.description' | 'media.audio.unsupported' | 'media.video.title' | 'media.video.unsupported' | 'media.video.hlsHint' | 'media.video.codecUnsupportedBadge' | 'media.video.codecUnsupportedTitle' | 'media.video.codecUnsupportedDescription' | 'media.video.codecUnsupportedAction' | 'media.video.softwareLoading' | 'media.video.softwareBadge' | 'media.video.play' | 'media.video.pause' | 'media.video.seek' | 'media.video.mute' | 'media.video.unmute' | 'media.video.fullscreen' | 'media.midi.title' | 'media.midi.loading' | 'media.midi.trackHeader' | 'media.midi.instrumentHeader' | 'media.midi.channelHeader' | 'media.midi.noteCountHeader' | 'media.midi.durationHeader' | 'media.midi.durationStat' | 'media.midi.trackStat' | 'media.midi.noteStat' | 'media.midi.parseFailed' | 'email.mbox.subject' | 'email.mbox.summary' | 'email.error.title' | 'email.meta.from' | 'email.meta.to' | 'email.meta.cc' | 'email.meta.date' | 'email.tabs.text' | 'email.tabs.headers' | 'email.attachments.title' | 'email.attachments.empty' | 'email.attachments.download' | 'email.attachments.opening' | 'email.attachments.nestedUnavailable' | 'email.loading.parsing' | 'data.font.sample' | 'data.error.fontFaceUnsupported' | 'data.title.font' | 'data.title.sqlite' | 'data.title.parquet' | 'data.title.avro' | 'data.title.wasm' | 'data.title.eps' | 'data.title.ai' | 'data.title.webarchive' | 'data.title.summary' | 'data.label.format' | 'data.label.size' | 'data.label.rendering' | 'data.label.objects' | 'data.label.sampleTable' | 'data.label.rows' | 'data.label.columns' | 'data.label.sampleRows' | 'data.label.imports' | 'data.label.exports' | 'data.label.magic' | 'data.label.note' | 'data.label.container' | 'data.value.schemaRead' | 'data.value.schemaUnread' | 'data.note.aiSummary' | 'data.note.postscriptSummary' | 'data.note.webarchive' | 'data.image.alt' | 'psd.title' | 'psd.action.fit' | 'psd.action.showAll' | 'psd.action.hideAll' | 'psd.layers.title' | 'psd.layers.redrawable' | 'psd.layers.empty' | 'psd.layers.hidden' | 'drawing.error.viewerLoadFailed' | 'drawing.error.excalidrawEmpty' | 'drawing.error.excalidrawTimeout' | 'drawing.error.drawioParseFailed' | 'drawing.error.drawioNoModel' | 'drawing.error.drawioNoElements' | 'drawing.error.viewerInitFailed' | 'drawing.error.drawioTimeout' | 'drawing.error.svgParseFailed' | 'drawing.error.plantumlRenderFailed' | 'drawing.title.excalidraw' | 'drawing.title.mermaid' | 'drawing.title.plantuml' | 'drawing.title.drawio' | 'drawing.toolbar.zoomOut' | 'drawing.toolbar.zoomIn' | 'drawing.toolbar.fit' | 'drawing.toolbar.fitWidth' | 'drawing.state.loading' | 'text.code.loadingHighlight' | 'text.code.formattedPreview' | 'text.code.showOriginal' | 'text.html.preview' | 'text.html.source' | 'text.html.safePreview' | 'text.code.showFormatted' | 'text.code.indexingLargeFile' | 'text.code.virtualized' | 'text.code.firstSegment' | 'text.code.previousSegment' | 'text.code.nextSegment' | 'text.code.lastSegment' | 'ebook.toc' | 'ebook.reading' | 'ebook.itemCount' | 'epub.title' | 'epub.previousPage' | 'epub.nextPage' | 'epub.loading' | 'epub.chapterFallback' | 'epub.renderIncomplete' | 'umd.title' | 'umd.previousChapter' | 'umd.nextChapter' | 'umd.loading' | 'umd.emptyContent' | 'umd.chapterFallback' | 'umd.galleryFallback' | 'umd.warningBodyTooShort' | 'umd.error.unexpectedEnd' | 'umd.error.invalidFile' | 'typst.summaryRenderer' | 'typst.pageSummary.empty' | 'typst.pageSummary.ready' | 'typst.status.compiling' | 'typst.status.failed' | 'typst.status.rendered' | 'typst.loading.title' | 'typst.loading.hint' | 'typst.error.title' | 'typst.error.timeout' | 'typst.error.timeoutHint' | 'typst.error.assetHint' | 'typst.error.svgParseFailed' | 'typst.error.wasmLoadFailed' | 'xmind.toolbar.zoomOut' | 'xmind.toolbar.zoomIn' | 'xmind.toolbar.fit' | 'xmind.toolbar.fitTitle' | 'xmind.state.loading' | 'xmind.stats.nodes' | 'xmind.stats.depth' | 'xmind.stats.theme' | 'xmind.stats.template' | 'xmind.badge.paused' | 'xmind.badge.collapsed' | 'xmind.badge.floating' | 'xmind.badge.summary' | 'xmind.badge.callout' | 'xmind.imageResource' | 'xmind.error.unrecognized' | 'xmind.error.noCanvas' | 'cad.toolbar.fit' | 'cad.toolbar.zoomOut' | 'cad.toolbar.zoomIn' | 'cad.toolbar.colorSource' | 'cad.toolbar.monochrome' | 'cad.toolbar.exportImage' | 'cad.layers.title' | 'cad.layers.count' | 'cad.layers.merged' | 'cad.inspector.title' | 'cad.inspector.entities' | 'cad.inspector.blocks' | 'cad.inspector.pages' | 'cad.inspector.drawn' | 'cad.state.loadingViewer' | 'cad.state.parsing' | 'cad.error.parseFailed' | 'cad.error.exportFailed' | 'image.alt' | 'image.toolbar.rotation' | 'image.toolbar.rotateLeft' | 'image.toolbar.rotateRight' | 'image.lightbox.alt' | 'image.lightbox.close' | 'gitBundle.error.invalid' | 'gitBundle.error.missingPack' | 'gitBundle.notice.delta' | 'gitBundle.title.history' | 'gitBundle.title.fileTree' | 'gitBundle.file.choose' | 'gitBundle.file.noTree' | 'gitBundle.file.none' | 'gitBundle.history.empty' | 'gitBundle.toolbar.summary' | 'gitBundle.meta.bundle' | 'gitBundle.meta.refs' | 'gitBundle.meta.commits' | 'gitBundle.meta.objects' | 'gitBundle.meta.deltas' | 'gitBundle.meta.objectFormat' | 'gitBundle.meta.objectTypes' | 'geo.error.unrecognized' | 'geo.error.xmlParseFailed' | 'geo.error.unsupported' | 'geo.title' | 'geo.featureCount' | 'geo.bounds' | 'geo.geometryTypes' | 'geo.aria' | 'geo.loading' | 'geo.projection' | 'geo.engine' | 'geo.basemap' | 'geo.basemap.offline' | 'geo.basemap.custom' | 'geo.engine.maplibre' | 'geo.engine.svg' | 'geo.error.projection' | 'geo.action.fit' | 'model.toolbar.fit' | 'model.toolbar.rotate' | 'model.toolbar.wireframe' | 'model.toolbar.grid' | 'model.toolbar.axes' | 'model.state.loadingSummary' | 'model.state.loading' | 'model.state.loaded' | 'model.state.parseFailed' | 'model.summary.meshes' | 'model.summary.points' | 'model.error.daeEmpty' | 'model.error.unsupported' | 'model.error.parseFailed' | 'model.notice.signature' | 'loading.generic.label' | 'loading.generic.hint' | 'loading.word.label' | 'loading.word.hint' | 'loading.wordWorker.hint' | 'loading.sheet.label' | 'loading.sheet.hint' | 'loading.csv.label' | 'loading.csv.hint' | 'loading.presentation.label' | 'loading.presentation.hint' | 'loading.pdf.label' | 'loading.pdf.hint' | 'loading.ofd.label' | 'loading.ofd.hint' | 'loading.archive.label' | 'loading.archive.hint' | 'loading.email.label' | 'loading.email.hint' | 'loading.msg.hint' | 'loading.eda.label' | 'loading.eda.hint' | 'loading.cad.label' | 'loading.cad.hint' | 'loading.dwg.hint' | 'loading.dwf.hint' | 'loading.dwfx.hint' | 'loading.xps.hint' | 'loading.drawio.label' | 'loading.drawio.hint' | 'loading.excalidraw.label' | 'loading.excalidraw.hint' | 'loading.epub.label' | 'loading.epub.hint' | 'loading.umd.label' | 'loading.umd.hint' | 'loading.image.label' | 'loading.image.hint' | 'loading.video.label' | 'loading.video.hint' | 'loading.audio.label' | 'loading.audio.hint';
 export type FileViewerMessageParams = Record<string, string | number | boolean | null | undefined>;
 export type FileViewerMessageResolver = (key: FileViewerMessageKey, params: FileViewerMessageParams, locale: FileViewerLocale) => string | undefined;
 export type FileViewerMessages = Partial<Record<FileViewerMessageKey, string>> | FileViewerMessageResolver;
@@ -204,6 +204,8 @@ export interface FileViewerPdfBoundingBox {
     label?: string;
 }
 export interface FileViewerDocxOptions {
+    /** DOC/DOCX 默认保留插入和删除修订；final 显示定稿，original 显示修订前原稿。 */
+    reviewMode?: 'all' | 'final' | 'original';
     worker?: boolean;
     workerUrl?: string;
     workerJsZipUrl?: string;
@@ -371,6 +373,11 @@ export interface FileRenderContext {
     registerExportAdapter?: (adapter: FileRenderExportAdapter | null) => void;
     registerThumbnailAdapter?: (adapter: FileRenderThumbnailAdapter | null) => void;
     renderPurpose?: FileViewerRenderPurpose;
+    /** Derived-image download, guarded by the owning viewer's permissions, hooks and request version. */
+    requestSnapshotDownload?: (create: (watermark: FileViewerOptions['watermark']) => Promise<{
+        blob: Blob;
+        filename: string;
+    }>) => Promise<boolean>;
     onProgressiveRender?: () => void;
     renderNestedBuffer?: (buffer: ArrayBuffer, type: string, target: HTMLDivElement, context?: FileRenderContext) => Promise<FileViewerRenderedInstance | undefined>;
 }
@@ -728,6 +735,7 @@ export interface FileViewerDrawingOptions {
 }
 export type FileViewerCadRenderer = 'auto' | 'webgl' | 'canvas2d';
 export type FileViewerCadDwfLineWeightMode = 'adaptive' | 'physical' | 'hairline';
+export type FileViewerCadColorMode = 'source' | 'monochrome';
 export type FileViewerCadFitMode = 'best' | 'native';
 export interface FileViewerCadOptions {
     wasmPath?: string;
@@ -737,6 +745,14 @@ export interface FileViewerCadOptions {
     useWorker?: boolean;
     workerTimeoutMs?: number;
     renderer?: FileViewerCadRenderer;
+    /** Initial CAD color policy. `monochrome` applies one plot color without mutating source data. */
+    colorMode?: FileViewerCadColorMode;
+    /** CSS color used by monochrome mode. Defaults to black (#000000). */
+    monochromeColor?: string;
+    /** Shows the CAD toolbar color-mode toggle. Defaults to true. */
+    showColorModeToggle?: boolean;
+    /** Show native PNG/JPEG snapshot downloads. Download/export permissions still apply. */
+    showImageExport?: boolean;
     preferDwgWasm?: boolean;
     includePaperSpace?: boolean;
     maxInsertDepth?: number;
@@ -754,6 +770,7 @@ export interface FileViewerCadOptions {
     fitPadding?: number;
     dwfPreferWebgl?: boolean;
     dwfPreferWasm?: boolean;
+    /** Explicit DWF background override; otherwise follows the current color mode. */
     dwfBackground?: string;
     dwfMaxDevicePixelRatio?: number;
     dwfMaxCanvasPixels?: number;
@@ -764,6 +781,7 @@ export interface FileViewerCadOptions {
     dwfMaxOverviewStrokeCssPx?: number;
     dwfMinTextCssPx?: number;
     dwfMinFilledAreaCssPx?: number;
+    /** Default background is dark for source colors and white for monochrome. Explicit colors are retained. */
     canvasOptions?: Record<string, unknown>;
 }
 export type FileViewerRendererMode = 'extend' | 'replace';
@@ -795,6 +813,8 @@ export interface FileViewerAiOptions {
     chunkOverlap?: number;
 }
 export interface FileViewerTextOptions {
+    /** Initial HTML/HTM view. Preview is static, sandboxed, and offline; defaults to preview. */
+    htmlView?: 'preview' | 'source';
     /**
      * Source encoding. Defaults to `auto`: BOM and UTF-16 structure first,
      * then strict UTF-8, with GB18030 (including GBK) as the final fallback.

package/dist/headless.d.ts

@@ -26,4 +26,4 @@ export { DEFAULT_FILE_VIEWER_STATE_THEME, DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRI
 export type { FileViewerErrorMessageFormatter, } from './viewer/state';
 export { buildFileViewerWatermarkBackgroundImage, buildFileViewerWatermarkInlineStyle, buildFileViewerWatermarkStyle, buildFileViewerWatermarkSvg, normalizeFileViewerWatermark, resolveFileViewerWatermarkPresentationState, } from './features/watermark';
 export type { FileViewerWatermarkPresentationState, FileViewerWatermarkStyle, } from './features/watermark';
-export type { FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerAiOptions, FileViewerArchiveEntryActionContext, FileViewerArchiveEntryActionPolicy, FileViewerArchiveEntryActionsOptions, FileViewerArchiveOptions, FileViewerChmOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerDownloadOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerFormatStatus, FileViewerFormatSupportLevel, FileViewerGeoOptions, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerIworkEmbeddedPreviewMode, FileViewerIworkOptions, FileViewerHangulOptions, FileViewerDiagnostic, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerNavigationState, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfBoundingBox, FileViewerPdfBoundingBoxOrigin, FileViewerPdfBoundingBoxUnit, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintOptions, FileViewerPrintStamp, FileViewerPublicApi, FileViewerRenderStateKind, FileViewerRenderedInstance, FileViewerRendererCategory, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerTextOptions, FileViewerResolvedThemeMode, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarItem, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerResolvedToolbarItem, FileViewerUiDensity, FileViewerUiOptions, FileViewerTypstOptions, FileViewerViewScrollState, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateChangeAction, FileViewerViewStateChangeSource, FileViewerViewStateProvider, FileViewerWatermarkOptions, FileViewerWordPerfectOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RenderSurface, RendererCapability, RendererDefinition, RendererLoadContext, RendererLoader, RendererPlugin, RendererRegistry, RendererSession, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';
+export type { FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerAiOptions, FileViewerArchiveEntryActionContext, FileViewerArchiveEntryActionPolicy, FileViewerArchiveEntryActionsOptions, FileViewerArchiveOptions, FileViewerChmOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadColorMode, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerDownloadOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerFormatStatus, FileViewerFormatSupportLevel, FileViewerGeoOptions, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerIworkEmbeddedPreviewMode, FileViewerIworkOptions, FileViewerHangulOptions, FileViewerDiagnostic, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerNavigationState, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfBoundingBox, FileViewerPdfBoundingBoxOrigin, FileViewerPdfBoundingBoxUnit, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintOptions, FileViewerPrintStamp, FileViewerPublicApi, FileViewerRenderStateKind, FileViewerRenderedInstance, FileViewerRendererCategory, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerTextOptions, FileViewerResolvedThemeMode, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarItem, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerResolvedToolbarItem, FileViewerUiDensity, FileViewerUiOptions, FileViewerTypstOptions, FileViewerViewScrollState, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateChangeAction, FileViewerViewStateChangeSource, FileViewerViewStateProvider, FileViewerWatermarkOptions, FileViewerWordPerfectOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RenderSurface, RendererCapability, RendererDefinition, RendererLoadContext, RendererLoader, RendererPlugin, RendererRegistry, RendererSession, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';

package/dist/i18n/messages.de.js

@@ -29,6 +29,8 @@ export const DE_DE_MESSAGES = {
     "toolbar.searchPrevious": "Vorheriger Treffer",
     "toolbar.searchNext": "Nächster Treffer",
     "toolbar.searchClear": "Suche löschen",
+    "toolbar.searchClose": "Suche schließen",
+    "toolbar.more": "Weitere Aktionen",
     "toolbar.theme": "Thema",
     "toolbar.themeToLight": "Wechseln Sie in den Lichtmodus",
     "toolbar.themeToDark": "Wechseln Sie in den Dunkelmodus",
@@ -286,6 +288,9 @@ export const DE_DE_MESSAGES = {
     "text.code.loadingHighlight": "Syntaxhervorhebung wird geladen...",
     "text.code.formattedPreview": "Formatierte Vorschau",
     "text.code.showOriginal": "Originalquelltext anzeigen",
+    "text.html.preview": "Seitenvorschau",
+    "text.html.source": "HTML-Quelltext",
+    "text.html.safePreview": "Statische Vorschau. Skripte und externe Ressourcen sind gesperrt.",
     "text.code.showFormatted": "Formatierte Vorschau anzeigen",
     "text.code.indexingLargeFile": "Indizieren großer Dateien {progress}%",
     "text.code.virtualized": "Große Datei · virtuelles Scrollen · Hervorheben aus",
@@ -346,6 +351,9 @@ export const DE_DE_MESSAGES = {
     "cad.toolbar.fit": "Fit",
     "cad.toolbar.zoomOut": "Herauszoomen",
     "cad.toolbar.zoomIn": "Vergrößern",
+    "cad.toolbar.colorSource": "Originalfarben",
+    "cad.toolbar.monochrome": "Monochrom",
+    "cad.toolbar.exportImage": "{format}-Bild herunterladen",
     "cad.layers.title": "Schichten",
     "cad.layers.count": "{count} Artikel",
     "cad.layers.merged": "{name} ({count} zusammengeführte Ebenen)",
@@ -357,6 +365,7 @@ export const DE_DE_MESSAGES = {
     "cad.state.loadingViewer": "CAD-Viewer wird geladen...",
     "cad.state.parsing": "CAD wird analysiert...",
     "cad.error.parseFailed": "Die CAD-Datei konnte nicht analysiert werden",
+    "cad.error.exportFailed": "Bildexport fehlgeschlagen: {message}",
     "image.alt": "Bild",
     "image.toolbar.rotation": "Bilddrehung",
     "image.toolbar.rotateLeft": "Bild nach links drehen",

package/dist/i18n/messages.ja.js

@@ -30,6 +30,8 @@ export const JA_JP_MESSAGES = {
     'toolbar.searchPrevious': '前の一致',
     'toolbar.searchNext': '次の一致',
     'toolbar.searchClear': '検索をクリア',
+    'toolbar.searchClose': '検索を閉じる',
+    'toolbar.more': 'その他の操作',
     'toolbar.theme': 'テーマ',
     'toolbar.themeToLight': 'ライトモードに切り替え',
     'toolbar.themeToDark': 'ダークモードに切り替え',
@@ -287,6 +289,9 @@ export const JA_JP_MESSAGES = {
     'text.code.loadingHighlight': 'シンタックスハイライトを読み込んでいます...',
     'text.code.formattedPreview': '整形済みプレビュー',
     'text.code.showOriginal': '元のソースを表示',
+    'text.html.preview': 'ページプレビュー',
+    'text.html.source': 'HTML ソース',
+    'text.html.safePreview': '静的プレビュー。スクリプトと外部リソースは無効です。',
     'text.code.showFormatted': '整形済みプレビューを表示',
     'text.code.indexingLargeFile': '大きなファイルを索引化しています {progress}%',
     'text.code.virtualized': '大きなファイル · 仮想スクロール · ハイライト無効',
@@ -347,6 +352,9 @@ export const JA_JP_MESSAGES = {
     'cad.toolbar.fit': '全体表示',
     'cad.toolbar.zoomOut': '縮小',
     'cad.toolbar.zoomIn': '拡大',
+    'cad.toolbar.colorSource': '元の色',
+    'cad.toolbar.monochrome': 'モノクロ',
+    'cad.toolbar.exportImage': '{format} 画像をダウンロード',
     'cad.layers.title': 'レイヤー',
     'cad.layers.count': '{count} 件',
     'cad.layers.merged': '{name}（同名レイヤー {count} 件を統合）',
@@ -358,6 +366,7 @@ export const JA_JP_MESSAGES = {
     'cad.state.loadingViewer': 'CAD ビューアーを読み込んでいます...',
     'cad.state.parsing': 'CAD を解析しています...',
     'cad.error.parseFailed': 'CAD ファイルの解析に失敗しました',
+    'cad.error.exportFailed': '画像を出力できませんでした: {message}',
     'image.alt': '画像',
     'image.toolbar.rotation': '画像の回転',
     'image.toolbar.rotateLeft': '画像を左に回転',

package/dist/i18n/messages.js

@@ -30,6 +30,8 @@ const ZH_CN_MESSAGES = {
     'toolbar.searchPrevious': '上一个匹配',
     'toolbar.searchNext': '下一个匹配',
     'toolbar.searchClear': '清除搜索',
+    'toolbar.searchClose': '收起搜索',
+    'toolbar.more': '更多操作',
     'toolbar.theme': '主题',
     'toolbar.themeToLight': '切换为浅色模式',
     'toolbar.themeToDark': '切换为深色模式',
@@ -287,6 +289,9 @@ const ZH_CN_MESSAGES = {
     'text.code.loadingHighlight': '正在加载高亮...',
     'text.code.formattedPreview': '格式化预览',
     'text.code.showOriginal': '查看原始源码',
+    'text.html.preview': '页面预览',
+    'text.html.source': 'HTML 源码',
+    'text.html.safePreview': '静态预览，不执行脚本或加载外部资源',
     'text.code.showFormatted': '查看格式化预览',
     'text.code.indexingLargeFile': '正在建立大文件索引 {progress}%',
     'text.code.virtualized': '大文件 · 虚拟滚动 · 已关闭高亮',
@@ -347,6 +352,9 @@ const ZH_CN_MESSAGES = {
     'cad.toolbar.fit': '适配',
     'cad.toolbar.zoomOut': '缩小',
     'cad.toolbar.zoomIn': '放大',
+    'cad.toolbar.colorSource': '彩色',
+    'cad.toolbar.monochrome': '黑白',
+    'cad.toolbar.exportImage': '下载 {format} 图片',
     'cad.layers.title': '图层',
     'cad.layers.count': '{count} 项',
     'cad.layers.merged': '{name}（已合并 {count} 个同名图层）',
@@ -358,6 +366,7 @@ const ZH_CN_MESSAGES = {
     'cad.state.loadingViewer': '正在加载 CAD 预览器...',
     'cad.state.parsing': '正在解析 CAD...',
     'cad.error.parseFailed': 'CAD 文件解析失败',
+    'cad.error.exportFailed': '图片导出失败：{message}',
     'image.alt': '图片',
     'image.toolbar.rotation': '图片旋转',
     'image.toolbar.rotateLeft': '向左旋转图片',
@@ -484,6 +493,8 @@ const EN_US_MESSAGES = {
     'toolbar.searchPrevious': 'Previous match',
     'toolbar.searchNext': 'Next match',
     'toolbar.searchClear': 'Clear search',
+    'toolbar.searchClose': 'Close search',
+    'toolbar.more': 'More actions',
     'toolbar.theme': 'Theme',
     'toolbar.themeToLight': 'Switch to light mode',
     'toolbar.themeToDark': 'Switch to dark mode',
@@ -741,6 +752,9 @@ const EN_US_MESSAGES = {
     'text.code.loadingHighlight': 'Loading syntax highlighting...',
     'text.code.formattedPreview': 'Formatted preview',
     'text.code.showOriginal': 'Show original source',
+    'text.html.preview': 'Page preview',
+    'text.html.source': 'HTML source',
+    'text.html.safePreview': 'Static preview. Scripts and external resources are blocked.',
     'text.code.showFormatted': 'Show formatted preview',
     'text.code.indexingLargeFile': 'Indexing large file {progress}%',
     'text.code.virtualized': 'Large file · virtual scrolling · highlighting off',
@@ -801,6 +815,9 @@ const EN_US_MESSAGES = {
     'cad.toolbar.fit': 'Fit',
     'cad.toolbar.zoomOut': 'Zoom out',
     'cad.toolbar.zoomIn': 'Zoom in',
+    'cad.toolbar.colorSource': 'Source colors',
+    'cad.toolbar.monochrome': 'Monochrome',
+    'cad.toolbar.exportImage': 'Download {format} image',
     'cad.layers.title': 'Layers',
     'cad.layers.count': '{count} items',
     'cad.layers.merged': '{name} ({count} merged layers)',
@@ -812,6 +829,7 @@ const EN_US_MESSAGES = {
     'cad.state.loadingViewer': 'Loading CAD viewer...',
     'cad.state.parsing': 'Parsing CAD...',
     'cad.error.parseFailed': 'Failed to parse CAD file',
+    'cad.error.exportFailed': 'Image export failed: {message}',
     'image.alt': 'Image',
     'image.toolbar.rotation': 'Image rotation',
     'image.toolbar.rotateLeft': 'Rotate image left',

package/dist/index.d.ts

@@ -16,6 +16,8 @@ export { cloneFileViewerViewState, createFileViewerViewStateChange, createFileVi
 export type { CreateFileViewerViewStateControllerOptions, FileViewerGenericViewStateProviderRegistration, FileViewerViewStateController, FileViewerViewStateControllerActionHandlers, RegisterFileViewerGenericViewStateProviderOptions, } from './features/document/viewState';
 export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, getCurrentFileViewerDocumentAnchor, getFileViewerScrollableRange, isFileViewerScrollableElement, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from './features/document/dom';
 export { prepareFileViewerRenderedContentForSnapshot, inlineFileViewerBlobUrlsInHtml, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export';
+export { createFileViewerCanvasImageBlob } from './output/canvasImage';
+export { createFileViewerSnapshotDownload, isFileViewerSnapshotDownloadPermitted } from './output/snapshotDownload';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout';
 export { assertFileViewerMermaidSourceHasNoExternalResources, sanitizeFileViewerSvgCss, sanitizeFileViewerSvgResources, } from './security/svgResources';
 export type { ApplyPrintPageSizeOptions, BuildPrintPageStyleOptions, PrintPageSize, } from './output/printLayout';
@@ -91,4 +93,5 @@ export type { CreateFileViewerZoomControllerOptions, FileViewerZoomOperation, }
 export type { CreateViewerOptions } from './viewer/createViewer';
 export type { BuildExportHtmlDocumentOptions, BuildFileViewerRenderedHtmlDocumentOptions, } from './exportDocument';
 export type { CreateFileViewerWorkerControllerOptions, FileViewerWorkerContext, FileViewerWorkerController, FileViewerWorkerErrorHook, FileViewerWorkerEventHandler, FileViewerWorkerFactory, FileViewerWorkerMessageHook, WorkerProvider, WorkerRef, } from './platform/worker';
-export type { FileViewerAiOptions, FileViewerArchiveEntryActionContext, FileViewerArchiveEntryActionPolicy, FileViewerArchiveEntryActionsOptions, FileViewerArchivePasswordRequestContext, FileViewerArchivePasswordRequestReason, FileViewerArchiveOptions, FileViewerChmOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerModelLinearUnit, FileViewerModelOptions, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerFormatStatus, FileViewerFormatSupportLevel, FileViewerGeoBasemapOptions, FileViewerGeoBasemapPreset, FileViewerGeoOptions, FileViewerTiandituMapStyle, FileRenderContext, FileRenderExportAdapter, FileRenderThumbnailAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerInstance, FileViewerLoadOptions, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerIworkEmbeddedPreviewMode, FileViewerIworkOptions, FileViewerHangulOptions, FileViewerDiagnostic, FileViewerDesignOptions, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerNavigationState, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfBoundingBox, FileViewerPdfBoundingBoxOrigin, FileViewerPdfBoundingBoxUnit, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerPrintOptions, FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintStamp, FileViewerPublicApi, FileViewerRenderedInstance, FileViewerRendererMode, FileViewerRendererPluginAssetKind, FileViewerRendererPluginAssetManifest, FileViewerRendererPluginAssetEntry, FileViewerRenderStateKind, FileViewerRenderPurpose, FileViewerRendererCategory, FileViewerRendererHandlerRegistration, FileViewerRendererInstallContext, FileViewerRendererPlugin, FileViewerRendererPluginInput, FileViewerRendererPresetInput, FileViewerRendererPresetName, FileViewerRendererPreset, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerThumbnailCaptureOptions, FileViewerThumbnailFit, FileViewerThumbnailFormat, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerStyleIsolation, FileViewerTextOptions, FileViewerResolvedThemeMode, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarItem, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerResolvedToolbarItem, FileViewerUiDensity, FileViewerUiOptions, FileViewerTypstOptions, FileViewerViewScrollState, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateChangeAction, FileViewerViewStateChangeSource, FileViewerViewStateProvider, FileViewerWatermarkOptions, FileViewerWordPerfectOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';
+export type { FileViewerAiOptions, FileViewerArchiveEntryActionContext, FileViewerArchiveEntryActionPolicy, FileViewerArchiveEntryActionsOptions, FileViewerArchivePasswordRequestContext, FileViewerArchivePasswordRequestReason, FileViewerArchiveOptions, FileViewerChmOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadColorMode, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerModelLinearUnit, FileViewerModelOptions, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerFormatStatus, FileViewerFormatSupportLevel, FileViewerGeoBasemapOptions, FileViewerGeoBasemapPreset, FileViewerGeoOptions, FileViewerTiandituMapStyle, FileRenderContext, FileRenderExportAdapter, FileRenderThumbnailAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerInstance, FileViewerLoadOptions, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerIworkEmbeddedPreviewMode, FileViewerIworkOptions, FileViewerHangulOptions, FileViewerDiagnostic, FileViewerDesignOptions, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerNavigationState, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfBoundingBox, FileViewerPdfBoundingBoxOrigin, FileViewerPdfBoundingBoxUnit, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerPrintOptions, FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintStamp, FileViewerPublicApi, FileViewerRenderedInstance, FileViewerRendererMode, FileViewerRendererPluginAssetKind, FileViewerRendererPluginAssetManifest, FileViewerRendererPluginAssetEntry, FileViewerRenderStateKind, FileViewerRenderPurpose, FileViewerRendererCategory, FileViewerRendererHandlerRegistration, FileViewerRendererInstallContext, FileViewerRendererPlugin, FileViewerRendererPluginInput, FileViewerRendererPresetInput, FileViewerRendererPresetName, FileViewerRendererPreset, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerThumbnailCaptureOptions, FileViewerThumbnailFit, FileViewerThumbnailFormat, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerStyleIsolation, FileViewerTextOptions, FileViewerResolvedThemeMode, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarItem, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerResolvedToolbarItem, FileViewerUiDensity, FileViewerUiOptions, FileViewerTypstOptions, FileViewerViewScrollState, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateChangeAction, FileViewerViewStateChangeSource, FileViewerViewStateProvider, FileViewerWatermarkOptions, FileViewerWordPerfectOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';
+export { resolveFileViewerCopiedAssetUrl } from './platform/copiedAssets';

package/dist/index.js

@@ -9,6 +9,8 @@ export { FILE_VIEWER_FIT_MODES, FILE_VIEWER_FIT_RESIZE_MODES, createFileViewerFi
 export { cloneFileViewerViewState, createFileViewerViewStateChange, createFileViewerViewStateChangeEmitter, createFileViewerViewStateController, createFileViewerViewStateControllerActionHandlers, registerFileViewerGenericViewStateProvider, } from './features/document/viewState.js';
 export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, getCurrentFileViewerDocumentAnchor, getFileViewerScrollableRange, isFileViewerScrollableElement, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from './features/document/dom/index.js';
 export { prepareFileViewerRenderedContentForSnapshot, inlineFileViewerBlobUrlsInHtml, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export.js';
+export { createFileViewerCanvasImageBlob } from './output/canvasImage.js';
+export { createFileViewerSnapshotDownload, isFileViewerSnapshotDownloadPermitted } from './output/snapshotDownload.js';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout.js';
 export { assertFileViewerMermaidSourceHasNoExternalResources, sanitizeFileViewerSvgCss, sanitizeFileViewerSvgResources, } from './security/svgResources.js';
 export { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, FILE_VIEWER_OPERATION_ACTION_ERROR_PREFIXES, createFileViewerOperationActionHandlers, createFileViewerOriginalSourceState, createFileViewerOriginalSourceStateFromNormalizedSource, createFileViewerPublicOperationActionHandlers, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, hasFileViewerOriginalSource, resolveFileViewerDisplayFilename, resolveFileViewerOperationActionErrorMessage, resolveFileViewerOperationFilename, resolveFileViewerOriginalFilename, } from './viewer/operations.js';
@@ -180,3 +182,4 @@ export { openFileViewerPrintMaskDesignerAsync, } from './features/printMaskLoade
 export { cancelFileViewerPreviewRequest, DEFAULT_FILE_VIEWER_STREAMING_PDF_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_LOAD_ERROR_LOGGER, DEFAULT_PDF_RANGE_CHUNK_SIZE, FILE_VIEWER_PREVIEW_LOAD_ERROR_PREFIXES, FILE_VIEWER_REMOTE_MISSING_DATA_ERROR_MESSAGE, applyFileViewerEmptyPreviewState, applyFileViewerPreviewFilenameState, applyFileViewerPreviewSourceUrlState, applyFileViewerReadPreviewState, applyFileViewerRenderReadinessState, applyFileViewerPreviewRequestResetState, commitFileViewerEmptyPreviewResetState, commitFileViewerLoadStartState, commitFileViewerPreviewRequestStartState, commitFileViewerRenderCompleteState, commitFileViewerRemoteDownloadState, createFileViewerEmptyPreviewState, createFileViewerLoadStartState, createFileViewerPreviewStateTarget, createFileViewerSourceLoadingActionHandlers, createFileViewerReadPreviewState, createFileViewerPreviewRequestResetState, createFileViewerRenderCompleteState, createFileViewerRequestController, createFileViewerRequestScope, createFileViewerStreamingPdfPlaceholderFile, finalizeFileViewerPreviewLoadState, hasFileViewerPreviewSource, isFileViewerAbortError, isSameOriginUrl, normalizeFileViewerSourceUrl, normalizePdfStreamingMode, resolveFileViewerFileRefSourcePlan, resolveFileViewerLoadStartMessage, resolveFileViewerMissingRemoteDataErrorMessage, resolveFileViewerPreviewLoadErrorMessage, resolveFileViewerPreviewRequestReason, resolveFileViewerRemoteSourcePlan, resolveFileViewerPageHref, reportFileViewerMissingRemoteData, reportFileViewerPreviewLoadError, runFileViewerLocalFilePreview, runFileViewerPreviewComponentUnmount, runFileViewerPreviewRequest, runFileViewerPreviewSourceChange, runFileViewerRemoteFilePreview, runFileViewerReadAndRenderFile, runFileViewerStreamingPdfPreview, shouldStreamPdfUrl, } from './source/loading.js';
 export { createViewer } from './viewer/createViewer.js';
 export { WorkerRefImpl, createFileViewerWorkerController, refWorker, } from './platform/worker.js';
+export { resolveFileViewerCopiedAssetUrl } from './platform/copiedAssets.js';

package/dist/output/canvasImage.d.ts

@@ -0,0 +1,3 @@
+import type { FileViewerWatermarkOptions } from '../contracts/types';
+/** Encodes a detached snapshot without mutating the renderer or omitting its watermark. */
+export declare function createFileViewerCanvasImageBlob(snapshot: HTMLCanvasElement, format: 'png' | 'jpeg', watermark?: boolean | FileViewerWatermarkOptions, pixelRatio?: number): Promise<Blob>;

package/dist/output/canvasImage.js

@@ -0,0 +1,76 @@
+import { buildFileViewerWatermarkSvg, normalizeFileViewerWatermark } from '../features/watermark.js';
+const loadImage = (document, source) => new Promise((resolve, reject) => {
+    const image = document.createElement('img');
+    const timer = setTimeout(() => finish(new Error('Image export resource timed out.')), 30000);
+    const finish = (error) => {
+        clearTimeout(timer);
+        image.onload = image.onerror = null;
+        if (error)
+            reject(error);
+        else
+            resolve(image);
+    };
+    image.crossOrigin = 'anonymous';
+    image.onload = () => finish();
+    image.onerror = () => finish(new Error('Unable to render the export watermark.'));
+    image.src = source;
+});
+/** Encodes a detached snapshot without mutating the renderer or omitting its watermark. */
+export async function createFileViewerCanvasImageBlob(snapshot, format, watermark, pixelRatio = 1) {
+    if (!['png', 'jpeg'].includes(format))
+        throw new Error('Unsupported image export format.');
+    if (!(snapshot.width > 0 && snapshot.height > 0) ||
+        snapshot.width * snapshot.height > 64000000) {
+        throw new Error('The image export size is empty or exceeds 64 million pixels.');
+    }
+    const document = snapshot.ownerDocument;
+    const canvas = document.createElement('canvas');
+    canvas.width = snapshot.width;
+    canvas.height = snapshot.height;
+    const context = canvas.getContext('2d');
+    if (!context)
+        throw new Error('A Canvas 2D context is required for image export.');
+    if (format === 'jpeg') {
+        context.fillStyle = '#ffffff';
+        context.fillRect(0, 0, canvas.width, canvas.height);
+    }
+    context.drawImage(snapshot, 0, 0);
+    let normalized = normalizeFileViewerWatermark(watermark);
+    if (normalized) {
+        if (normalized.image) {
+            // SVG image documents do not load nested remote images. Inline the configured
+            // watermark first; an unreadable/tainted image must fail, never disappear.
+            const image = await loadImage(document, normalized.image);
+            const tile = document.createElement('canvas');
+            tile.width = image.naturalWidth;
+            tile.height = image.naturalHeight;
+            if (!tile.width || !tile.height || tile.width * tile.height > 16000000) {
+                throw new Error('The watermark image size is invalid.');
+            }
+            const tileContext = tile.getContext('2d');
+            if (!tileContext)
+                throw new Error('Unable to render the export watermark.');
+            tileContext.drawImage(image, 0, 0);
+            normalized = { ...normalized, image: tile.toDataURL('image/png') };
+        }
+        const tile = await loadImage(document, `data:image/svg+xml;charset=utf-8,${encodeURIComponent(buildFileViewerWatermarkSvg(normalized))}`);
+        const pattern = context.createPattern(tile, 'repeat');
+        if (!pattern)
+            throw new Error('Unable to render the export watermark.');
+        const scale = Number.isFinite(pixelRatio) && pixelRatio > 0 ? pixelRatio : 1;
+        context.save();
+        context.scale(scale, scale);
+        context.fillStyle = pattern;
+        context.fillRect(0, 0, canvas.width / scale, canvas.height / scale);
+        context.restore();
+    }
+    const mime = `image/${format}`;
+    return new Promise((resolve, reject) => {
+        canvas.toBlob((blob) => {
+            if ((blob === null || blob === void 0 ? void 0 : blob.type) === mime && blob.size > 0)
+                resolve(blob);
+            else
+                reject(new Error(`Unable to encode ${format.toUpperCase()} output.`));
+        }, mime, 0.92);
+    });
+}

package/dist/output/snapshotDownload.d.ts

@@ -0,0 +1,8 @@
+import type { FileRenderContext, FileViewerOptions } from '../contracts/types';
+export declare const isFileViewerSnapshotDownloadPermitted: (options?: FileViewerOptions) => boolean;
+/** Renderer-local downloads still use the owning viewer's hooks and request version. */
+export declare const createFileViewerSnapshotDownload: ({ getOptions, isCurrent, beforeDownload }: {
+    getOptions: () => FileViewerOptions | undefined;
+    isCurrent: () => boolean;
+    beforeDownload: () => Promise<boolean>;
+}) => NonNullable<FileRenderContext["requestSnapshotDownload"]>;

package/dist/output/snapshotDownload.js

@@ -0,0 +1,19 @@
+import { isFileViewerToolbarOperationPermitted } from '../lifecycle/operations.js';
+import { triggerFileViewerBlobDownload } from './export.js';
+export const isFileViewerSnapshotDownloadPermitted = (options) => isFileViewerToolbarOperationPermitted(options === null || options === void 0 ? void 0 : options.toolbar, 'download') &&
+    isFileViewerToolbarOperationPermitted(options === null || options === void 0 ? void 0 : options.toolbar, 'export-html');
+/** Renderer-local downloads still use the owning viewer's hooks and request version. */
+export const createFileViewerSnapshotDownload = ({ getOptions, isCurrent, beforeDownload }) => async (create) => {
+    var _a, _b;
+    const allowed = () => isCurrent() && isFileViewerSnapshotDownloadPermitted(getOptions());
+    if (!allowed() || !(await beforeDownload()) || !allowed())
+        return false;
+    const watermark = (_a = getOptions()) === null || _a === void 0 ? void 0 : _a.watermark;
+    const watermarkState = JSON.stringify(watermark);
+    const capturedWatermark = watermark && typeof watermark === 'object' ? Object.freeze({ ...watermark }) : watermark;
+    const result = await create(capturedWatermark);
+    if (!allowed() || JSON.stringify((_b = getOptions()) === null || _b === void 0 ? void 0 : _b.watermark) !== watermarkState)
+        return false;
+    triggerFileViewerBlobDownload(result.blob, result.filename);
+    return true;
+};

package/dist/platform/assets.d.ts

@@ -9,10 +9,10 @@ export declare const DEFAULT_FILE_VIEWER_CHM_WASM_PATH = "vendor/chm/chm_wasm_bg
 export declare const DEFAULT_FILE_VIEWER_CHM_WASM_PACKAGE_PATH = "@file-viewer/renderer-chm/wasm/chm_wasm_bg.wasm";
 export declare const DEFAULT_FILE_VIEWER_DOCX_WORKER_PATH = "vendor/docx/docx.worker.js";
 export declare const DEFAULT_FILE_VIEWER_DOCX_WORKER_JSZIP_PATH = "vendor/docx/jszip.min.js";
-export declare const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = "0.3.26";
+export declare const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = "0.3.31";
 export declare const DEFAULT_FILE_VIEWER_PRESENTATION_WORKER_PATH = "vendor/pptx/pptx.worker.js";
 export declare const DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH = "vendor/ppt";
-export declare const DEFAULT_FILE_VIEWER_PPT_RUNTIME_VERSION = "0.3.3";
+export declare const DEFAULT_FILE_VIEWER_PPT_RUNTIME_VERSION = "0.3.4";
 export declare const DEFAULT_FILE_VIEWER_PPT_MODULE_PATH = "vendor/ppt/index.mjs";
 export declare const DEFAULT_FILE_VIEWER_PPT_WORKER_PATH = "vendor/ppt/worker.mjs";
 export declare const DEFAULT_FILE_VIEWER_PPT_FRAME_CACHE_PATH = "vendor/ppt/frame-cache.mjs";
@@ -36,12 +36,13 @@ export declare const DEFAULT_FILE_VIEWER_PDF_STANDARD_FONT_PATH = "vendor/pdf/st
 export declare const DEFAULT_FILE_VIEWER_PDF_CJK_FONT_FALLBACK_PATH = "vendor/pdf/fonts/";
 export declare const DEFAULT_FILE_VIEWER_DRAWIO_VIEWER_SCRIPT_PATH = "vendor/drawio/viewer-static.min.js";
 export declare const DEFAULT_FILE_VIEWER_DRAWIO_ASSET_PATH = "vendor/drawio/";
-export declare const DEFAULT_FILE_VIEWER_CAD_RUNTIME_VERSION = "0.8.0";
-export declare const DEFAULT_FILE_VIEWER_CAD_WASM_PATH = "wasm/cad/0.8.0/";
-export declare const DEFAULT_FILE_VIEWER_CAD_WORKER_PATH = "wasm/cad/0.8.0/dwg-worker.js";
-export declare const DEFAULT_FILE_VIEWER_CAD_DWF_WASM_PATH = "wasm/cad/0.8.0/dwfv-render.wasm";
-export declare const DEFAULT_FILE_VIEWER_CAD_LIBREDWG_SCRIPT_PATH = "wasm/cad/0.8.0/libredwg-web.js";
-export declare const DEFAULT_FILE_VIEWER_CAD_LIBREDWG_WASM_PATH = "wasm/cad/0.8.0/libredwg-web.wasm";
+export declare const DEFAULT_FILE_VIEWER_CAD_RUNTIME_VERSION = "0.8.2";
+export declare const COMPATIBILITY_FILE_VIEWER_CAD_RUNTIME_VERSION = "0.8.0";
+export declare const DEFAULT_FILE_VIEWER_CAD_WASM_PATH = "wasm/cad/0.8.2/";
+export declare const DEFAULT_FILE_VIEWER_CAD_WORKER_PATH = "wasm/cad/0.8.2/dwg-worker.js";
+export declare const DEFAULT_FILE_VIEWER_CAD_DWF_WASM_PATH = "wasm/cad/0.8.2/dwfv-render.wasm";
+export declare const DEFAULT_FILE_VIEWER_CAD_LIBREDWG_SCRIPT_PATH = "wasm/cad/0.8.2/libredwg-web.js";
+export declare const DEFAULT_FILE_VIEWER_CAD_LIBREDWG_WASM_PATH = "wasm/cad/0.8.2/libredwg-web.wasm";
 export declare const DEFAULT_FILE_VIEWER_TYPST_COMPILER_WASM_URL = "wasm/typst/typst_ts_web_compiler_bg.wasm";
 export declare const DEFAULT_FILE_VIEWER_TYPST_RENDERER_WASM_URL = "wasm/typst/typst_ts_renderer_bg.wasm";
 export declare const DEFAULT_FILE_VIEWER_TYPST_FONT_ASSETS_URL = "wasm/typst/fonts/";

package/dist/platform/assets.js

@@ -8,10 +8,10 @@ export const DEFAULT_FILE_VIEWER_CHM_WASM_PATH = 'vendor/chm/chm_wasm_bg.wasm';
 export const DEFAULT_FILE_VIEWER_CHM_WASM_PACKAGE_PATH = '@file-viewer/renderer-chm/wasm/chm_wasm_bg.wasm';
 export const DEFAULT_FILE_VIEWER_DOCX_WORKER_PATH = 'vendor/docx/docx.worker.js';
 export const DEFAULT_FILE_VIEWER_DOCX_WORKER_JSZIP_PATH = 'vendor/docx/jszip.min.js';
-export const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = '0.3.26';
+export const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = '0.3.31';
 export const DEFAULT_FILE_VIEWER_PRESENTATION_WORKER_PATH = 'vendor/pptx/pptx.worker.js';
 export const DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH = 'vendor/ppt';
-export const DEFAULT_FILE_VIEWER_PPT_RUNTIME_VERSION = '0.3.3';
+export const DEFAULT_FILE_VIEWER_PPT_RUNTIME_VERSION = '0.3.4';
 export const DEFAULT_FILE_VIEWER_PPT_MODULE_PATH = `${DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH}/index.mjs`;
 export const DEFAULT_FILE_VIEWER_PPT_WORKER_PATH = `${DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH}/worker.mjs`;
 export const DEFAULT_FILE_VIEWER_PPT_FRAME_CACHE_PATH = `${DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH}/frame-cache.mjs`;
@@ -35,7 +35,8 @@ export const DEFAULT_FILE_VIEWER_PDF_STANDARD_FONT_PATH = 'vendor/pdf/standard_f
 export const DEFAULT_FILE_VIEWER_PDF_CJK_FONT_FALLBACK_PATH = 'vendor/pdf/fonts/';
 export const DEFAULT_FILE_VIEWER_DRAWIO_VIEWER_SCRIPT_PATH = 'vendor/drawio/viewer-static.min.js';
 export const DEFAULT_FILE_VIEWER_DRAWIO_ASSET_PATH = 'vendor/drawio/';
-export const DEFAULT_FILE_VIEWER_CAD_RUNTIME_VERSION = '0.8.0';
+export const DEFAULT_FILE_VIEWER_CAD_RUNTIME_VERSION = '0.8.2';
+export const COMPATIBILITY_FILE_VIEWER_CAD_RUNTIME_VERSION = '0.8.0';
 export const DEFAULT_FILE_VIEWER_CAD_WASM_PATH = `wasm/cad/${DEFAULT_FILE_VIEWER_CAD_RUNTIME_VERSION}/`;
 export const DEFAULT_FILE_VIEWER_CAD_WORKER_PATH = `${DEFAULT_FILE_VIEWER_CAD_WASM_PATH}dwg-worker.js`;
 export const DEFAULT_FILE_VIEWER_CAD_DWF_WASM_PATH = `${DEFAULT_FILE_VIEWER_CAD_WASM_PATH}dwfv-render.wasm`;
@@ -601,6 +602,51 @@ export const DEFAULT_FILE_VIEWER_RENDERER_ASSET_MANIFESTS = [
                 defaultPath: DEFAULT_FILE_VIEWER_CAD_LIBREDWG_WASM_PATH,
                 description: 'LibreDWG WebAssembly runtime loaded by the CAD DWG worker for offline parsing.',
             },
+            {
+                id: 'cad-compat-0-8-0-wasm-directory',
+                rendererId: 'cad',
+                kind: 'wasm-directory',
+                target: 'public',
+                required: true,
+                defaultPath: `wasm/cad/${COMPATIBILITY_FILE_VIEWER_CAD_RUNTIME_VERSION}/`,
+                description: 'Legacy @flyfish-dev/cad-viewer 0.8.0 directory kept for full-package path compatibility.',
+            },
+            {
+                id: 'cad-compat-0-8-0-dwg-worker',
+                rendererId: 'cad',
+                kind: 'worker',
+                target: 'public',
+                required: true,
+                defaultPath: `wasm/cad/${COMPATIBILITY_FILE_VIEWER_CAD_RUNTIME_VERSION}/dwg-worker.js`,
+                description: 'Legacy CAD 0.8.0 DWG worker kept for full-package path compatibility.',
+            },
+            {
+                id: 'cad-compat-0-8-0-dwf-wasm',
+                rendererId: 'cad',
+                kind: 'wasm',
+                target: 'public',
+                required: true,
+                defaultPath: `wasm/cad/${COMPATIBILITY_FILE_VIEWER_CAD_RUNTIME_VERSION}/dwfv-render.wasm`,
+                description: 'Legacy CAD 0.8.0 DWF runtime kept for full-package path compatibility.',
+            },
+            {
+                id: 'cad-compat-0-8-0-libredwg-script',
+                rendererId: 'cad',
+                kind: 'script',
+                target: 'public',
+                required: true,
+                defaultPath: `wasm/cad/${COMPATIBILITY_FILE_VIEWER_CAD_RUNTIME_VERSION}/libredwg-web.js`,
+                description: 'Legacy CAD 0.8.0 LibreDWG script kept for full-package path compatibility.',
+            },
+            {
+                id: 'cad-compat-0-8-0-libredwg-wasm',
+                rendererId: 'cad',
+                kind: 'wasm',
+                target: 'public',
+                required: true,
+                defaultPath: `wasm/cad/${COMPATIBILITY_FILE_VIEWER_CAD_RUNTIME_VERSION}/libredwg-web.wasm`,
+                description: 'Legacy CAD 0.8.0 LibreDWG WebAssembly runtime kept for full-package path compatibility.',
+            },
             {
                 id: 'cad-legacy-dwg-worker',
                 rendererId: 'cad',

package/dist/platform/copiedAssets.d.ts

@@ -0,0 +1,2 @@
+/** Finds assets copied by the standard CLI without trusting a SPA fallback or arbitrary manifest URLs. */
+export declare function resolveFileViewerCopiedAssetUrl(documentRef: Document, rendererId: string, assetId: string, signal?: AbortSignal): Promise<string | undefined>;

package/dist/platform/copiedAssets.js

@@ -0,0 +1,93 @@
+import { getFileViewerRendererAssetManifest, resolveFileViewerRuntimeAssetBaseUrl } from './assets.js';
+const manifests = new WeakMap();
+const MAX_MANIFEST_BYTES = 1024 * 1024;
+const readManifest = async (url, signal) => {
+    var _a, _b, _c;
+    const controller = new AbortController();
+    const abort = () => controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
+    if (signal === null || signal === void 0 ? void 0 : signal.aborted)
+        abort();
+    else
+        signal === null || signal === void 0 ? void 0 : signal.addEventListener('abort', abort, { once: true });
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    try {
+        const response = await fetch(url, { signal: controller.signal, credentials: 'same-origin' });
+        if (!response.ok ||
+            !((_a = response.headers.get('content-type')) === null || _a === void 0 ? void 0 : _a.includes('json')) ||
+            Number(response.headers.get('content-length')) > MAX_MANIFEST_BYTES)
+            return null;
+        const reader = (_b = response.body) === null || _b === void 0 ? void 0 : _b.getReader();
+        if (!reader)
+            return null;
+        const chunks = [];
+        let size = 0;
+        try {
+            while (true) {
+                const { value, done } = await reader.read();
+                if (done)
+                    break;
+                size += value.byteLength;
+                if (size > MAX_MANIFEST_BYTES)
+                    return null;
+                chunks.push(value);
+            }
+        }
+        finally {
+            await reader.cancel();
+        }
+        const bytes = new Uint8Array(size);
+        let offset = 0;
+        for (const chunk of chunks) {
+            bytes.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        const manifest = JSON.parse(new TextDecoder().decode(bytes));
+        return (manifest === null || manifest === void 0 ? void 0 : manifest.schemaVersion) === 1 &&
+            manifest.packageName === 'file-viewer-copy-assets' &&
+            Array.isArray((_c = manifest.validation) === null || _c === void 0 ? void 0 : _c.assets)
+            ? manifest
+            : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+        signal === null || signal === void 0 ? void 0 : signal.removeEventListener('abort', abort);
+    }
+};
+/** Finds assets copied by the standard CLI without trusting a SPA fallback or arbitrary manifest URLs. */
+export async function resolveFileViewerCopiedAssetUrl(documentRef, rendererId, assetId, signal) {
+    var _a, _b, _c;
+    const asset = (_a = getFileViewerRendererAssetManifest(rendererId)) === null || _a === void 0 ? void 0 : _a.assets.find((item) => item.id === assetId);
+    if (!(asset === null || asset === void 0 ? void 0 : asset.defaultPath))
+        return undefined;
+    const base = new URL(resolveFileViewerRuntimeAssetBaseUrl(documentRef));
+    if (!['http:', 'https:'].includes(base.protocol))
+        return undefined;
+    const bases = base.pathname.endsWith('/file-viewer/')
+        ? [base]
+        : [new URL('file-viewer/', base), base];
+    let cache = manifests.get(documentRef);
+    if (!cache) {
+        cache = new Map();
+        manifests.set(documentRef, cache);
+    }
+    for (const directory of bases) {
+        if (signal === null || signal === void 0 ? void 0 : signal.aborted)
+            return undefined;
+        const url = new URL('flyfish-viewer-assets.json', directory).href;
+        const manifest = cache.has(url) ? cache.get(url) : await readManifest(url, signal);
+        if (signal === null || signal === void 0 ? void 0 : signal.aborted)
+            return undefined;
+        cache.set(url, manifest || null);
+        const copied = (_c = (_b = manifest === null || manifest === void 0 ? void 0 : manifest.validation) === null || _b === void 0 ? void 0 : _b.assets) === null || _c === void 0 ? void 0 : _c.find((item) => item &&
+            item.id === assetId &&
+            item.rendererId === rendererId &&
+            item.exists === true &&
+            item.relativePath === asset.defaultPath);
+        if (copied)
+            return new URL(asset.defaultPath, directory).href;
+    }
+    return undefined;
+}

package/dist/viewer/createViewer.js

@@ -19,6 +19,7 @@ import { createFileViewerCoreRendererRegistry } from '../renderers/index.js';
 import { createFileViewerRequestScope } from '../source/loading.js';
 import { normalizeSource } from '../source/index.js';
 import { buildFileViewerWatermarkInlineStyle } from '../features/watermark.js';
+import { createFileViewerSnapshotDownload } from '../output/snapshotDownload.js';
 import { createFileViewerUnsupportedState } from './state.js';
 const emitLifecycle = async (options, onEvent, phase, source, version, startedAt, reason) => {
     const now = Date.now();
@@ -556,6 +557,11 @@ export const createViewer = (container, createOptions = {}) => {
                     renderContext: {
                         renderPurpose: createOptions.renderPurpose || 'preview',
                         renderNestedBuffer,
+                        requestSnapshotDownload: createFileViewerSnapshotDownload({
+                            getOptions: () => options,
+                            isCurrent: () => requestScope.isCurrentRequest(version),
+                            beforeDownload: () => runBeforeViewerOperation('download'),
+                        }),
                     },
                 });
             }

package/dist/viewer/operations.js

@@ -206,24 +206,41 @@ export const executeFileViewerPrintOperation = async ({ autoPrint = true, before
     if (!printAvailable) {
         throw new Error(translateFileViewerMessage(i18n, 'error.printUnavailable'));
     }
-    if (!await runBeforeOperation(beforeOperation, 'print')) {
+    const beforeResult = beforeOperation ? beforeOperation('print') : true;
+    if (beforeResult === false) {
         return false;
     }
-    const printableRoot = await buildRenderedDomDocumentFromOperation({ ...input, i18n });
+    // Preserve the browser's transient user activation while the snapshot is built.
+    const ownsPrintWindow = !printWindow;
     const targetWindow = printWindow ||
         (openWindow === null || openWindow === void 0 ? void 0 : openWindow()) ||
         (typeof window !== 'undefined' ? window.open('', '_blank') : null);
     if (!targetWindow) {
         throw new Error(translateFileViewerMessage(i18n, 'error.printWindowBlocked'));
     }
-    await ensureFileViewerPrintStandardsMode(targetWindow);
-    replaceFileViewerPrintDocument(targetWindow.document, printableRoot);
-    targetWindow.focus();
-    await waitForFileViewerPrintWindowReady(targetWindow);
-    if (autoPrint !== false) {
-        targetWindow.print();
+    try {
+        if (!await beforeResult) {
+            if (ownsPrintWindow) {
+                targetWindow.close();
+            }
+            return false;
+        }
+        const printableRoot = await buildRenderedDomDocumentFromOperation({ ...input, i18n });
+        await ensureFileViewerPrintStandardsMode(targetWindow);
+        replaceFileViewerPrintDocument(targetWindow.document, printableRoot);
+        targetWindow.focus();
+        await waitForFileViewerPrintWindowReady(targetWindow);
+        if (autoPrint !== false) {
+            targetWindow.print();
+        }
+        return true;
+    }
+    catch (error) {
+        if (ownsPrintWindow) {
+            targetWindow.close();
+        }
+        throw error;
     }
-    return true;
 };
 const handleFileViewerOperationActionError = (operation, error, { errorPrefixes, formatErrorMessage, getI18n, i18n, onError, onErrorMessage, }) => {
     var _a;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/core",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "private": false,
   "type": "module",
   "description": "Framework-neutral modular TypeScript core for File Viewer renderer orchestration, lifecycle APIs, search, zoom, print, and export",
@@ -27,11 +27,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/flyfish-dev/file-viewer-core.git",
+    "url": "git+https://github.com/flyfish-dev/file-viewer.git",
     "directory": "packages/core"
   },
   "bugs": {
-    "url": "https://github.com/flyfish-dev/file-viewer-core/issues"
+    "url": "https://github.com/flyfish-dev/file-viewer/issues"
   },
   "funding": {
     "type": "individual",
@@ -90,7 +90,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "dompurify": "3.4.14"
+    "dompurify": "3.4.15"
   },
   "devDependencies": {
     "typescript": "^6.0.3"