@file-viewer/core 2.1.22 → 2.1.24

package/assets.d.ts

@@ -0,0 +1 @@
+export * from './dist/assets';

package/assets.js

@@ -0,0 +1 @@
+export * from './dist/assets.js';

package/browser.d.ts

@@ -0,0 +1 @@
+export * from './dist/browser';

package/browser.js

@@ -0,0 +1 @@
+export * from './dist/browser.js';

package/dist/config/options.js

@@ -41,7 +41,7 @@ const sanitizeJsonValue = (value) => {
     return Object.keys(output).length ? output : undefined;
 };
 const stripExecutionOnlyOptions = (value) => {
-    const { beforeOperation: _beforeOperation, hooks: _hooks, preset: _preset, presets: _presets, renderers: _renderers, rendererMode: _rendererMode, branding: _branding, ...rest } = value;
+    const { beforeOperation: _beforeOperation, hooks: _hooks, preset: _preset, presets: _presets, renderers: _renderers, rendererMode: _rendererMode, ...rest } = value;
     if (isRecord(rest.toolbar)) {
         const { beforeOperation: _toolbarBeforeOperation, beforeDownload: _beforeDownload, beforePrint: _beforePrint, beforeExportHtml: _beforeExportHtml, ...toolbar } = rest.toolbar;
         rest.toolbar = toolbar;

package/dist/contracts/types.d.ts

@@ -2,7 +2,7 @@ export type FileViewerSourceKind = 'file' | 'url' | 'buffer' | 'empty';
 export type FileViewerThemeMode = 'light' | 'dark' | 'system';
 export type FileViewerLocale = 'auto' | 'zh-CN' | 'en-US' | (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.exportHtml' | 'toolbar.exportHtmlTitle' | 'toolbar.search' | 'toolbar.searchPlaceholder' | 'toolbar.searchPrevious' | 'toolbar.searchNext' | 'toolbar.searchClear' | '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.state.loading' | 'ofd.error.empty' | 'ofd.error.parseFailed' | 'presentation.state.loading' | 'presentation.error.title' | 'presentation.error.parseFailed' | '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.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' | '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.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.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.exportHtml' | 'toolbar.exportHtmlTitle' | 'toolbar.search' | 'toolbar.searchPlaceholder' | 'toolbar.searchPrevious' | 'toolbar.searchNext' | 'toolbar.searchClear' | '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.state.loading' | 'ofd.error.empty' | 'ofd.error.parseFailed' | 'presentation.state.loading' | 'presentation.error.title' | 'presentation.error.parseFailed' | '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.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' | '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.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.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;
@@ -142,6 +142,8 @@ export interface FileViewerDocxOptions {
     updatePageReferences?: boolean;
     hideWebHiddenContent?: boolean;
     ignoreLastRenderedPageBreak?: boolean;
+    /** Overrides automatic DOCX dark rendering derived from the viewer theme. */
+    darkMode?: boolean;
 }
 export interface FileViewerSpreadsheetOptions {
     worker?: boolean | 'auto';
@@ -705,7 +707,8 @@ export interface FileViewerComponentEmits {
 export interface FileViewerPublicApi {
     destroy(): void;
     downloadOriginalFile(): Promise<void>;
-    printRenderedHtml(): Promise<void>;
+    printRenderedHtml(options?: FileViewerPrintOptions): Promise<void>;
+    printWithMask(options?: FileViewerPrintOptions): Promise<void>;
     exportRenderedHtml(): Promise<void>;
     zoomIn(): Promise<FileViewerZoomState>;
     zoomOut(): Promise<FileViewerZoomState>;
@@ -735,12 +738,27 @@ export interface FileViewerExportHtmlOptions {
     title?: string;
     watermarkInlineStyle?: string;
 }
+/** Normalized print-mask rectangle in percent of the rendered content box. */
+export interface FileViewerPrintMaskRegion {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface FileViewerPrintMaskOptions {
+    /** Solid black cover blocks, matching common OFD/business redaction UX. */
+    regions?: FileViewerPrintMaskRegion[];
+    /** Fill color for print masks. Defaults to opaque black. */
+    color?: string;
+}
 export interface FileViewerPrintOptions {
     autoPrint?: boolean;
     openWindow?: () => Window | null;
     printWindow?: Window | null;
     title?: string;
     watermarkInlineStyle?: string;
+    /** Optional print-time cover masks applied above content and below watermark. */
+    mask?: FileViewerPrintMaskOptions | null;
 }
 export interface FileViewerSource {
     url?: string;
@@ -855,6 +873,8 @@ export interface FileViewerInstance {
     download(options?: FileViewerDownloadOptions): Promise<void>;
     exportHtml(options?: FileViewerExportHtmlOptions): Promise<string>;
     print(options?: FileViewerPrintOptions): Promise<void>;
+    /** Open the async print-mask designer, then print with the chosen covers. */
+    printWithMask(options?: FileViewerPrintOptions): Promise<void>;
     zoomIn(): Promise<FileViewerZoomState>;
     zoomOut(): Promise<FileViewerZoomState>;
     resetZoom(): Promise<FileViewerZoomState>;

package/dist/features/printMask.d.ts

@@ -0,0 +1,5 @@
+import type { FileViewerPrintMaskOptions, FileViewerPrintMaskRegion } from '../contracts/types';
+export declare const normalizeFileViewerPrintMaskRegion: (region: Partial<FileViewerPrintMaskRegion> | null | undefined) => FileViewerPrintMaskRegion | null;
+export declare const normalizeFileViewerPrintMaskOptions: (mask?: FileViewerPrintMaskOptions | null) => FileViewerPrintMaskOptions | null;
+export declare const buildFileViewerPrintMaskOverlayHtml: (mask?: FileViewerPrintMaskOptions | null) => string;
+export declare const FILE_VIEWER_PRINT_MASK_STYLE = "\n  .viewer-export-print-mask{position:absolute;inset:0;z-index:15;pointer-events:none;print-color-adjust:exact;-webkit-print-color-adjust:exact;}\n  .viewer-export-print-mask-block{position:absolute;box-sizing:border-box;print-color-adjust:exact;-webkit-print-color-adjust:exact;}\n";

package/dist/features/printMask.js

@@ -0,0 +1,48 @@
+const clampPercent = (value) => Math.max(0, Math.min(100, value));
+export const normalizeFileViewerPrintMaskRegion = (region) => {
+    if (!region) {
+        return null;
+    }
+    const left = clampPercent(Number(region.left) || 0);
+    const top = clampPercent(Number(region.top) || 0);
+    const width = clampPercent(Number(region.width) || 0);
+    const height = clampPercent(Number(region.height) || 0);
+    if (width <= 0 || height <= 0) {
+        return null;
+    }
+    return {
+        left,
+        top,
+        width: Math.min(width, 100 - left),
+        height: Math.min(height, 100 - top),
+    };
+};
+export const normalizeFileViewerPrintMaskOptions = (mask) => {
+    if (!mask || !Array.isArray(mask.regions) || !mask.regions.length) {
+        return null;
+    }
+    const regions = mask.regions
+        .map(region => normalizeFileViewerPrintMaskRegion(region))
+        .filter((region) => !!region);
+    if (!regions.length) {
+        return null;
+    }
+    return {
+        regions,
+        color: mask.color || '#000000',
+    };
+};
+export const buildFileViewerPrintMaskOverlayHtml = (mask) => {
+    var _a;
+    const normalized = normalizeFileViewerPrintMaskOptions(mask);
+    if (!((_a = normalized === null || normalized === void 0 ? void 0 : normalized.regions) === null || _a === void 0 ? void 0 : _a.length)) {
+        return '';
+    }
+    const color = normalized.color || '#000000';
+    const blocks = normalized.regions.map(region => (`<div class="viewer-export-print-mask-block" style="left:${region.left}%;top:${region.top}%;width:${region.width}%;height:${region.height}%;background:${color};"></div>`)).join('');
+    return `<div class="viewer-export-print-mask" aria-hidden="true">${blocks}</div>`;
+};
+export const FILE_VIEWER_PRINT_MASK_STYLE = `
+  .viewer-export-print-mask{position:absolute;inset:0;z-index:15;pointer-events:none;print-color-adjust:exact;-webkit-print-color-adjust:exact;}
+  .viewer-export-print-mask-block{position:absolute;box-sizing:border-box;print-color-adjust:exact;-webkit-print-color-adjust:exact;}
+`;

package/dist/features/printMaskDesigner.d.ts

@@ -0,0 +1,16 @@
+import type { FileViewerPrintMaskOptions, FileViewerPrintMaskRegion } from '../contracts/types';
+import { type FileViewerI18nInput } from '../i18n/messages';
+export interface OpenFileViewerPrintMaskDesignerOptions {
+    root: HTMLElement;
+    i18n?: FileViewerI18nInput;
+    color?: string;
+    initialRegions?: FileViewerPrintMaskRegion[];
+}
+export interface FileViewerPrintMaskDesignerResult {
+    mask: FileViewerPrintMaskOptions;
+}
+/**
+ * Opens an interactive print-mask designer over the rendered content.
+ * Loaded asynchronously so the main viewer bundle stays lean.
+ */
+export declare const openFileViewerPrintMaskDesigner: (options: OpenFileViewerPrintMaskDesignerOptions) => Promise<FileViewerPrintMaskDesignerResult | null>;

package/dist/features/printMaskDesigner.js

@@ -0,0 +1,200 @@
+import { createFileViewerTranslator } from '../i18n/messages.js';
+import { normalizeFileViewerPrintMaskRegion } from './printMask.js';
+const DESIGNER_STYLE = `
+.fv-print-mask-layer{position:absolute;inset:0;z-index:40;pointer-events:none;}
+.fv-print-mask-canvas{position:absolute;inset:0;pointer-events:auto;cursor:crosshair;touch-action:none;}
+.fv-print-mask-block{position:absolute;background:#000;box-sizing:border-box;pointer-events:auto;}
+.fv-print-mask-block-remove{position:absolute;right:-8px;top:-8px;width:18px;height:18px;border:0;border-radius:999px;background:#111;color:#fff;font:700 12px/18px system-ui,sans-serif;cursor:pointer;padding:0;}
+.fv-print-mask-toolbar{position:absolute;left:50%;bottom:16px;transform:translateX(-50%);z-index:41;display:inline-flex;align-items:center;gap:6px;padding:6px 8px;border:1px solid rgba(20,35,53,.12);border-radius:999px;background:rgba(255,255,255,.94);box-shadow:0 12px 28px rgba(15,23,42,.16);pointer-events:auto;max-width:calc(100% - 24px);flex-wrap:wrap;justify-content:center;}
+.fv-print-mask-toolbar span{font:600 12px/1.2 system-ui,sans-serif;color:#40546a;white-space:nowrap;}
+.fv-print-mask-toolbar button{min-width:42px;height:30px;padding:0 10px;border:0;border-radius:999px;background:transparent;color:#40546a;font:800 12px/1 system-ui,sans-serif;cursor:pointer;}
+.fv-print-mask-toolbar button:hover{background:rgba(33,163,102,.1);color:#16774c;}
+.fv-print-mask-toolbar button.primary{background:#16774c;color:#fff;}
+.fv-print-mask-toolbar button.primary:hover{background:#0f5f3c;}
+`;
+const ensureDesignerStyle = (documentRef) => {
+    if (documentRef.getElementById('fv-print-mask-designer-style')) {
+        return;
+    }
+    const style = documentRef.createElement('style');
+    style.id = 'fv-print-mask-designer-style';
+    style.textContent = DESIGNER_STYLE;
+    documentRef.head.appendChild(style);
+};
+const toPercentRegion = (start, end, bounds) => {
+    if (!bounds.width || !bounds.height) {
+        return null;
+    }
+    const leftPx = Math.min(start.x, end.x);
+    const topPx = Math.min(start.y, end.y);
+    const widthPx = Math.abs(end.x - start.x);
+    const heightPx = Math.abs(end.y - start.y);
+    if (widthPx < 8 || heightPx < 8) {
+        return null;
+    }
+    return normalizeFileViewerPrintMaskRegion({
+        left: (leftPx / bounds.width) * 100,
+        top: (topPx / bounds.height) * 100,
+        width: (widthPx / bounds.width) * 100,
+        height: (heightPx / bounds.height) * 100,
+    });
+};
+/**
+ * Opens an interactive print-mask designer over the rendered content.
+ * Loaded asynchronously so the main viewer bundle stays lean.
+ */
+export const openFileViewerPrintMaskDesigner = (options) => {
+    const root = options.root;
+    const documentRef = root.ownerDocument;
+    const t = createFileViewerTranslator(options.i18n);
+    const color = options.color || '#000000';
+    const regions = [...(options.initialRegions || [])]
+        .map(region => normalizeFileViewerPrintMaskRegion(region))
+        .filter((region) => !!region);
+    ensureDesignerStyle(documentRef);
+    const previousPosition = root.style.position;
+    if (!previousPosition || previousPosition === 'static') {
+        root.style.position = 'relative';
+    }
+    return new Promise(resolve => {
+        let settled = false;
+        let drawing = null;
+        const layer = documentRef.createElement('div');
+        layer.className = 'fv-print-mask-layer';
+        layer.setAttribute('data-viewer-print-mask-designer', 'true');
+        const canvas = documentRef.createElement('div');
+        canvas.className = 'fv-print-mask-canvas';
+        const toolbar = documentRef.createElement('div');
+        toolbar.className = 'fv-print-mask-toolbar';
+        toolbar.setAttribute('role', 'toolbar');
+        toolbar.setAttribute('aria-label', t('toolbar.printMaskTitle'));
+        const hint = documentRef.createElement('span');
+        hint.textContent = t('toolbar.printMaskHint');
+        const clearButton = documentRef.createElement('button');
+        clearButton.type = 'button';
+        clearButton.textContent = t('toolbar.printMaskClear');
+        const cancelButton = documentRef.createElement('button');
+        cancelButton.type = 'button';
+        cancelButton.textContent = t('toolbar.printMaskCancel');
+        const confirmButton = documentRef.createElement('button');
+        confirmButton.type = 'button';
+        confirmButton.className = 'primary';
+        confirmButton.textContent = t('toolbar.printMaskConfirm');
+        toolbar.append(hint, clearButton, cancelButton, confirmButton);
+        layer.append(canvas, toolbar);
+        root.appendChild(layer);
+        const finish = (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            layer.remove();
+            if (!previousPosition) {
+                root.style.removeProperty('position');
+            }
+            else {
+                root.style.position = previousPosition;
+            }
+            resolve(result);
+        };
+        const renderRegions = () => {
+            canvas.replaceChildren();
+            regions.forEach((region, index) => {
+                const block = documentRef.createElement('div');
+                block.className = 'fv-print-mask-block';
+                block.style.left = `${region.left}%`;
+                block.style.top = `${region.top}%`;
+                block.style.width = `${region.width}%`;
+                block.style.height = `${region.height}%`;
+                block.style.background = color;
+                const remove = documentRef.createElement('button');
+                remove.type = 'button';
+                remove.className = 'fv-print-mask-block-remove';
+                remove.title = t('toolbar.printMaskClear');
+                remove.setAttribute('aria-label', t('toolbar.printMaskClear'));
+                remove.textContent = '−';
+                remove.addEventListener('click', event => {
+                    event.preventDefault();
+                    event.stopPropagation();
+                    regions.splice(index, 1);
+                    renderRegions();
+                });
+                block.appendChild(remove);
+                canvas.appendChild(block);
+            });
+        };
+        const pointFromEvent = (event) => {
+            const bounds = canvas.getBoundingClientRect();
+            return {
+                x: Math.max(0, Math.min(bounds.width, event.clientX - bounds.left)),
+                y: Math.max(0, Math.min(bounds.height, event.clientY - bounds.top)),
+            };
+        };
+        canvas.addEventListener('pointerdown', event => {
+            if (event.button !== 0) {
+                return;
+            }
+            event.preventDefault();
+            const start = pointFromEvent(event);
+            const preview = documentRef.createElement('div');
+            preview.className = 'fv-print-mask-block';
+            preview.style.background = color;
+            preview.style.opacity = '0.72';
+            canvas.appendChild(preview);
+            drawing = { start, preview };
+            canvas.setPointerCapture(event.pointerId);
+        });
+        canvas.addEventListener('pointermove', event => {
+            if (!drawing) {
+                return;
+            }
+            const end = pointFromEvent(event);
+            const left = Math.min(drawing.start.x, end.x);
+            const top = Math.min(drawing.start.y, end.y);
+            drawing.preview.style.left = `${left}px`;
+            drawing.preview.style.top = `${top}px`;
+            drawing.preview.style.width = `${Math.abs(end.x - drawing.start.x)}px`;
+            drawing.preview.style.height = `${Math.abs(end.y - drawing.start.y)}px`;
+        });
+        const endDrawing = (event) => {
+            if (!drawing) {
+                return;
+            }
+            const end = pointFromEvent(event);
+            const bounds = canvas.getBoundingClientRect();
+            const region = toPercentRegion(drawing.start, end, bounds);
+            drawing.preview.remove();
+            drawing = null;
+            try {
+                canvas.releasePointerCapture(event.pointerId);
+            }
+            catch {
+                // ignore
+            }
+            if (region) {
+                regions.push(region);
+                renderRegions();
+            }
+        };
+        canvas.addEventListener('pointerup', endDrawing);
+        canvas.addEventListener('pointercancel', endDrawing);
+        clearButton.addEventListener('click', () => {
+            regions.splice(0, regions.length);
+            renderRegions();
+        });
+        cancelButton.addEventListener('click', () => finish(null));
+        confirmButton.addEventListener('click', () => {
+            if (!regions.length) {
+                finish(null);
+                return;
+            }
+            finish({
+                mask: {
+                    regions: regions.map(region => ({ ...region })),
+                    color,
+                },
+            });
+        });
+        renderRegions();
+    });
+};

package/dist/features/printMaskLoader.d.ts

@@ -0,0 +1,8 @@
+import type { FileViewerPrintMaskDesignerResult, OpenFileViewerPrintMaskDesignerOptions } from './printMaskDesigner';
+/**
+ * Lazily opens the print-mask designer.
+ * Kept as a dynamic import so the designer stays out of the main core graph,
+ * while remaining reachable through the primary `@file-viewer/core` entry
+ * (no consumer alias / subpath setup required).
+ */
+export declare const openFileViewerPrintMaskDesignerAsync: (options: OpenFileViewerPrintMaskDesignerOptions) => Promise<FileViewerPrintMaskDesignerResult | null>;

package/dist/features/printMaskLoader.js

@@ -0,0 +1,10 @@
+/**
+ * Lazily opens the print-mask designer.
+ * Kept as a dynamic import so the designer stays out of the main core graph,
+ * while remaining reachable through the primary `@file-viewer/core` entry
+ * (no consumer alias / subpath setup required).
+ */
+export const openFileViewerPrintMaskDesignerAsync = async (options) => {
+    const { openFileViewerPrintMaskDesigner } = await import('../print-mask.js');
+    return openFileViewerPrintMaskDesigner(options);
+};

package/dist/i18n/messages.js

@@ -9,6 +9,14 @@ const ZH_CN_MESSAGES = {
     'toolbar.downloadTitle': '下载原始文件',
     'toolbar.print': '打印',
     'toolbar.printTitle': '打印完整渲染内容',
+    'toolbar.printDirect': '直接打印',
+    'toolbar.printMask': '掩膜打印',
+    'toolbar.printMaskTitle': '遮盖敏感区域后再打印',
+    'toolbar.printMaskAdd': '添加掩膜',
+    'toolbar.printMaskClear': '清空',
+    'toolbar.printMaskCancel': '取消',
+    'toolbar.printMaskConfirm': '确认打印',
+    'toolbar.printMaskHint': '拖拽绘制黑色遮盖块，可删除后继续调整',
     'toolbar.exportHtml': 'HTML',
     'toolbar.exportHtmlTitle': '导出当前渲染后的 HTML',
     'toolbar.search': '搜索',
@@ -411,6 +419,14 @@ const EN_US_MESSAGES = {
     'toolbar.downloadTitle': 'Download the original file',
     'toolbar.print': 'Print',
     'toolbar.printTitle': 'Print the complete rendered document',
+    'toolbar.printDirect': 'Print now',
+    'toolbar.printMask': 'Mask & print',
+    'toolbar.printMaskTitle': 'Cover sensitive areas before printing',
+    'toolbar.printMaskAdd': 'Add mask',
+    'toolbar.printMaskClear': 'Clear',
+    'toolbar.printMaskCancel': 'Cancel',
+    'toolbar.printMaskConfirm': 'Print',
+    'toolbar.printMaskHint': 'Drag to draw black cover blocks. Delete and adjust as needed.',
     'toolbar.exportHtml': 'HTML',
     'toolbar.exportHtmlTitle': 'Export the rendered HTML',
     'toolbar.search': 'Search',

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export type { ApplyInitialFileViewerFitOptions, CreateFileViewerFitControllerOpt
 export { cloneFileViewerViewState, createFileViewerViewStateChange, createFileViewerViewStateChangeEmitter, createFileViewerViewStateController, createFileViewerViewStateControllerActionHandlers, registerFileViewerGenericViewStateProvider, } from './features/document/viewState';
 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 { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export';
+export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, inlineFileViewerBlobUrlsInHtml, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout';
 export type { ApplyPrintPageSizeOptions, BuildPrintPageStyleOptions, PrintPageSize, } from './output/printLayout';
 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';
@@ -67,6 +67,9 @@ export { DEFAULT_FILE_VIEWER_STATE_THEME, DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRI
 export type { FileViewerErrorMessageFormatter, FileViewerRendererInstallHint, } from './viewer/state';
 export { buildFileViewerWatermarkBackgroundImage, buildFileViewerWatermarkInlineStyle, buildFileViewerWatermarkStyle, buildFileViewerWatermarkSvg, normalizeFileViewerWatermark, resolveFileViewerWatermarkPresentationState, } from './features/watermark';
 export type { FileViewerWatermarkPresentationState, FileViewerWatermarkStyle, } from './features/watermark';
+export { buildFileViewerPrintMaskOverlayHtml, normalizeFileViewerPrintMaskOptions, normalizeFileViewerPrintMaskRegion, FILE_VIEWER_PRINT_MASK_STYLE, } from './features/printMask';
+export { openFileViewerPrintMaskDesignerAsync, } from './features/printMaskLoader';
+export type { FileViewerPrintMaskDesignerResult, OpenFileViewerPrintMaskDesignerOptions, } from './features/printMaskDesigner';
 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';
 export type { CreateFileViewerPreviewStateTargetInput, CreateFileViewerSourceLoadingActionHandlersInput, CreateFileViewerLoadStartStateInput, CreateFileViewerReadPreviewStateInput, CreateFileViewerRenderCompleteStateInput, CommitFileViewerEmptyPreviewResetStateInput, CancelFileViewerPreviewRequestInput, CommitFileViewerLoadStartStateInput, CommitFileViewerPreviewRequestStartStateInput, CommitFileViewerRenderCompleteStateInput, CommitFileViewerRemoteDownloadStateInput, FileViewerEmptyPreviewState, FileViewerMutableAccessor, FileViewerLocationLike, FileViewerFileRefSourcePlan, FileViewerLocalFilePreviewState, FileViewerLoadStartState, FileViewerPreviewLoadErrorKind, FileViewerPreviewLoadErrorPrefixes, FileViewerPreviewLoadErrorLogger, FileViewerPreviewComponentUnmountState, FileViewerPreviewRequestResetState, FileViewerSourceLoadingActionHandlers, FileViewerReadAndRenderFileState, FileViewerRenderCompleteState, FileViewerRenderReadinessState, FileViewerRemoteDownloadState, FileViewerRemoteFilePreviewErrorKind, FileViewerRemoteFilePreviewState, FileViewerRemoteFileDownloadInput, FileViewerReadPreviewState, FileViewerPreviewRequestRunState, FileViewerRemoteSourcePlan, FileViewerRequestController, FileViewerRequestScope, FileViewerStreamingPdfPreviewState, FinalizeFileViewerPreviewLoadStateInput, MutableFileViewerPreviewFilenameState, MutableFileViewerPreviewSourceUrlState, MutableFileViewerPreviewRequestState, MutableFileViewerPreviewState, MutableFileViewerRenderReadinessState, MutableFileViewerReadPreviewState, RunFileViewerLocalFilePreviewInput, RunFileViewerPreviewComponentUnmountInput, RunFileViewerPreviewRequestInput, RunFileViewerPreviewSourceChangeInput, RunFileViewerRemoteFilePreviewInput, RunFileViewerReadAndRenderFileInput, RunFileViewerStreamingPdfPreviewInput, ResolveFileViewerFileRefSourcePlanInput, ResolveFileViewerMissingRemoteDataErrorMessageInput, ResolveFileViewerPreviewLoadErrorMessageInput, ResolveFileViewerPreviewRequestReasonInput, ReportFileViewerMissingRemoteDataInput, ReportFileViewerPreviewLoadErrorInput, } from './source/loading';
 export { createViewer } from './viewer/createViewer';

package/dist/index.js

@@ -7,7 +7,7 @@ export { applyFileViewerZoomState, clearFileViewerZoomControllerProvider, create
 export { FILE_VIEWER_FIT_MODES, FILE_VIEWER_FIT_RESIZE_MODES, createFileViewerFitController, hasFileViewerExplicitInitialViewState, isFileViewerFitMode, isFileViewerFitResize, normalizeFileViewerFitOptions, resolveFileViewerFitScale, } from './features/document/fit.js';
 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 { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export.js';
+export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, inlineFileViewerBlobUrlsInHtml, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export.js';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout.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';
 export { FILE_VIEWER_BUILTIN_MESSAGES, FILE_VIEWER_DEFAULT_LOCALE, FILE_VIEWER_FALLBACK_LOCALE, createFileViewerTranslator, formatFileViewerMessage, normalizeFileViewerLocale, resolveFileViewerLocale, translateFileViewerMessage, } from './i18n/messages.js';
@@ -173,6 +173,8 @@ export { appendFileViewerStyle, buildFileRenderContextFromLoadContext, applyFile
 export { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, decodeFilename, getExtension, normalizeFileExtension, normalizeFilename, resolveFileViewerSourceFilename, normalizeSource, readFileViewerBuffer, readFileViewerDataUrl, readFileViewerText, wrapFileViewerFileRef, } from './source/index.js';
 export { DEFAULT_FILE_VIEWER_STATE_THEME, DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRIPTION, FILE_VIEWER_PREVIEW_MESSAGES, createFileViewerEmptyState, createFileViewerErrorState, createFileViewerPreviewLoadingState, createFileViewerReadyState, createFileViewerUnsupportedState, formatFileViewerErrorMessage, normalizeFileViewerErrorMessage, resolveFileViewerRendererInstallHint, } from './viewer/state.js';
 export { buildFileViewerWatermarkBackgroundImage, buildFileViewerWatermarkInlineStyle, buildFileViewerWatermarkStyle, buildFileViewerWatermarkSvg, normalizeFileViewerWatermark, resolveFileViewerWatermarkPresentationState, } from './features/watermark.js';
+export { buildFileViewerPrintMaskOverlayHtml, normalizeFileViewerPrintMaskOptions, normalizeFileViewerPrintMaskRegion, FILE_VIEWER_PRINT_MASK_STYLE, } from './features/printMask.js';
+export { openFileViewerPrintMaskDesignerAsync, } from './features/printMaskLoader.js';
 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';

package/dist/output/export.d.ts

@@ -1,26 +1,33 @@
-import type { FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions } from '../contracts/types';
+import type { FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileViewerPrintMaskOptions } from '../contracts/types';
 export interface BuildExportHtmlDocumentOptions {
     contentHtml: string;
     includeDocumentStyles?: boolean;
     printStyle?: string;
     title: string;
     watermarkInlineStyle?: string;
+    mask?: FileViewerPrintMaskOptions | null;
 }
 export declare const collectDocumentStyles: () => string;
-export declare const buildExportHtmlDocument: ({ contentHtml, includeDocumentStyles, printStyle, title, watermarkInlineStyle }: BuildExportHtmlDocumentOptions) => string;
+export declare const buildExportHtmlDocument: ({ contentHtml, includeDocumentStyles, printStyle, title, watermarkInlineStyle, mask, }: BuildExportHtmlDocumentOptions) => string;
 export interface BuildFileViewerRenderedHtmlDocumentOptions {
     source: HTMLElement;
     mode?: FileRenderExportMode;
     title: string;
     adapter?: FileRenderExportAdapter | null;
     watermarkInlineStyle?: string;
+    mask?: FileViewerPrintMaskOptions | null;
 }
 export declare const triggerFileViewerBlobDownload: (blob: Blob, name: string) => void;
 export declare const triggerFileViewerUrlDownload: (url: string, name: string) => void;
 export declare const replaceFileViewerCanvasWithImages: (source: HTMLElement, clone: HTMLElement) => void;
 export declare const waitForFileViewerNextPaint: (targetWindow?: Partial<Pick<Window, "requestAnimationFrame" | "setTimeout">>) => Promise<void>;
-export declare const waitForFileViewerImages: (root: ParentNode) => Promise<void>;
+export declare const waitForFileViewerImages: (root: ParentNode | null | undefined) => Promise<void>;
+/**
+ * Rewrite ephemeral `blob:` URLs into portable `data:` URLs so exported / printed
+ * HTML keeps images after leaving the live viewer document (GitHub #90).
+ */
+export declare const inlineFileViewerBlobUrlsInHtml: (html: string) => Promise<string>;
 export declare const waitForFileViewerPrintWindowReady: (printWindow: Window) => Promise<void>;
 export declare const resolveFileViewerPrintStyle: (adapter: FileRenderExportAdapter | null, options: FileRenderExportOptions) => Promise<string>;
 export declare const prepareFileViewerRenderedContentForSnapshot: (source: HTMLElement, adapter?: FileRenderExportAdapter | null) => Promise<void>;
-export declare const buildFileViewerRenderedHtmlDocument: ({ source, mode, title, adapter, watermarkInlineStyle }: BuildFileViewerRenderedHtmlDocumentOptions) => Promise<string>;
+export declare const buildFileViewerRenderedHtmlDocument: ({ source, mode, title, adapter, watermarkInlineStyle, mask, }: BuildFileViewerRenderedHtmlDocumentOptions) => Promise<string>;

package/dist/output/export.js

@@ -1,3 +1,4 @@
+import { buildFileViewerPrintMaskOverlayHtml, FILE_VIEWER_PRINT_MASK_STYLE, normalizeFileViewerPrintMaskOptions, } from '../features/printMask.js';
 const escapeHtmlAttribute = (value) => value
     .replace(/&/g, '&')
     .replace(/"/g, '"')
@@ -9,6 +10,7 @@ const EXPORT_DOCUMENT_STYLE = `
   body { padding: 24px; }
   .viewer-export-shell { position: relative; min-height: calc(100vh - 48px); overflow: visible; background: #f2f4f7; }
   .viewer-export-content { position: relative; z-index: 1; contain: none; width: 100%; min-height: 100%; overflow: visible; }
+  .viewer-export-watermark { position: absolute; inset: 0; pointer-events: none; z-index: 20; background-repeat: repeat; print-color-adjust: exact; -webkit-print-color-adjust: exact; }
   .viewer-export-content .file-render,
   .viewer-export-content .file-viewer,
   .viewer-export-content .viewer-stage,
@@ -286,12 +288,14 @@ export const collectDocumentStyles = () => {
         .filter(Boolean)
         .join('\n');
 };
-export const buildExportHtmlDocument = ({ contentHtml, includeDocumentStyles = true, printStyle = '', title, watermarkInlineStyle = '' }) => {
+export const buildExportHtmlDocument = ({ contentHtml, includeDocumentStyles = true, printStyle = '', title, watermarkInlineStyle = '', mask = null, }) => {
     const watermark = watermarkInlineStyle
         ? `<div class="viewer-export-watermark" style="${watermarkInlineStyle}"></div>`
         : '';
+    const maskHtml = buildFileViewerPrintMaskOverlayHtml(mask);
     const styles = includeDocumentStyles ? collectDocumentStyles() : '';
     const printOverrideStyle = printStyle ? `<style data-viewer-print-style>${printStyle}</style>` : '';
+    const maskStyle = maskHtml ? `<style data-viewer-print-mask-style>${FILE_VIEWER_PRINT_MASK_STYLE}</style>` : '';
     const safeTitle = escapeHtmlAttribute(title);
     return `<!doctype html>
 <html lang="zh-CN">
@@ -301,10 +305,12 @@ export const buildExportHtmlDocument = ({ contentHtml, includeDocumentStyles = t
   <title>${safeTitle}</title>
   ${styles}
   <style>${EXPORT_DOCUMENT_STYLE}</style>
+  ${maskStyle}
 </head>
 <body>
   <main class="viewer-export-shell">
     <div class="viewer-export-content">${contentHtml}</div>
+    ${maskHtml}
     ${watermark}
   </main>
   ${printOverrideStyle}
@@ -371,6 +377,9 @@ export const waitForFileViewerNextPaint = (targetWindow) => {
     });
 };
 export const waitForFileViewerImages = async (root) => {
+    if (!root || typeof root.querySelectorAll !== 'function') {
+        return;
+    }
     const images = Array.from(root.querySelectorAll('img'));
     await Promise.all(images.map(async (image) => {
         if (image.complete) {
@@ -391,6 +400,75 @@ export const waitForFileViewerImages = async (root) => {
         });
     }));
 };
+const bytesToDataUrl = (bytes, mimeType) => {
+    const type = mimeType || 'application/octet-stream';
+    const nodeBuffer = globalThis.Buffer;
+    if (nodeBuffer) {
+        return `data:${type};base64,${nodeBuffer.from(bytes).toString('base64')}`;
+    }
+    let binary = '';
+    const view = new Uint8Array(bytes);
+    for (let index = 0; index < view.length; index += 1) {
+        binary += String.fromCharCode(view[index]);
+    }
+    return `data:${type};base64,${btoa(binary)}`;
+};
+const blobToDataUrl = async (blob) => {
+    if (typeof FileReader === 'function') {
+        try {
+            return await new Promise((resolve, reject) => {
+                const reader = new FileReader();
+                reader.onload = () => resolve(String(reader.result || ''));
+                reader.onerror = () => reject(reader.error || new Error('Failed to read blob'));
+                reader.readAsDataURL(blob);
+            });
+        }
+        catch {
+            // Fall through to ArrayBuffer encoding for Node / incomplete FileReader shims.
+        }
+    }
+    return bytesToDataUrl(await blob.arrayBuffer(), blob.type || 'application/octet-stream');
+};
+const collectBlobUrls = (html) => {
+    const matches = html.match(/blob:[^\s"'<>)\\]+/g) || [];
+    return Array.from(new Set(matches));
+};
+/**
+ * Rewrite ephemeral `blob:` URLs into portable `data:` URLs so exported / printed
+ * HTML keeps images after leaving the live viewer document (GitHub #90).
+ */
+export const inlineFileViewerBlobUrlsInHtml = async (html) => {
+    if (!html.includes('blob:') || typeof fetch !== 'function') {
+        return html;
+    }
+    const urls = collectBlobUrls(html);
+    if (!urls.length) {
+        return html;
+    }
+    const replacements = await Promise.all(urls.map(async (url) => {
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                return null;
+            }
+            const blob = await response.blob();
+            const dataUrl = await blobToDataUrl(blob);
+            return dataUrl ? [url, dataUrl] : null;
+        }
+        catch {
+            return null;
+        }
+    }));
+    let next = html;
+    for (const pair of replacements) {
+        if (!pair) {
+            continue;
+        }
+        const [from, to] = pair;
+        next = next.split(from).join(to);
+    }
+    return next;
+};
 export const waitForFileViewerPrintWindowReady = async (printWindow) => {
     const { document: printDocument } = printWindow;
     if (printDocument.readyState !== 'complete') {
@@ -439,18 +517,21 @@ export const prepareFileViewerRenderedContentForSnapshot = async (source, adapte
     await waitForFileViewerNextPaint();
     await waitForFileViewerImages(source);
 };
-export const buildFileViewerRenderedHtmlDocument = async ({ source, mode = 'export', title, adapter = null, watermarkInlineStyle = '' }) => {
+export const buildFileViewerRenderedHtmlDocument = async ({ source, mode = 'export', title, adapter = null, watermarkInlineStyle = '', mask = null, }) => {
     const exportOptions = { mode, title };
     const toHtml = adapter === null || adapter === void 0 ? void 0 : adapter.toHtml;
+    const normalizedMask = normalizeFileViewerPrintMaskOptions(mask);
     if (toHtml) {
-        const contentHtml = await toHtml(exportOptions);
+        await prepareFileViewerRenderedContentForSnapshot(source, adapter);
+        const contentHtml = await inlineFileViewerBlobUrlsInHtml(await toHtml(exportOptions));
         const printStyle = await resolveFileViewerPrintStyle(adapter, exportOptions);
         return buildExportHtmlDocument({
             contentHtml,
             includeDocumentStyles: adapter.includeDocumentStyles !== false,
             printStyle,
             title,
-            watermarkInlineStyle
+            watermarkInlineStyle,
+            mask: normalizedMask,
         });
     }
     await prepareFileViewerRenderedContentForSnapshot(source, adapter);
@@ -459,9 +540,10 @@ export const buildFileViewerRenderedHtmlDocument = async ({ source, mode = 'expo
     replaceFileViewerCanvasWithImages(source, clone);
     const printStyle = await resolveFileViewerPrintStyle(adapter, exportOptions);
     return buildExportHtmlDocument({
-        contentHtml: clone.innerHTML,
+        contentHtml: await inlineFileViewerBlobUrlsInHtml(clone.innerHTML),
         printStyle,
         title,
-        watermarkInlineStyle
+        watermarkInlineStyle,
+        mask: normalizedMask,
     });
 };

package/dist/print-mask.d.ts

@@ -0,0 +1,2 @@
+export { openFileViewerPrintMaskDesigner, } from './features/printMaskDesigner';
+export type { FileViewerPrintMaskDesignerResult, OpenFileViewerPrintMaskDesignerOptions, } from './features/printMaskDesigner';

package/dist/print-mask.js

@@ -0,0 +1 @@
+export { openFileViewerPrintMaskDesigner, } from './features/printMaskDesigner.js';

package/dist/renderers/image.js

@@ -26,8 +26,8 @@ const imageStyle = `
 .image-lightbox[hidden]{display:none}
 .image-lightbox img{display:block;max-width:100%;max-height:100%;object-fit:contain;background:#fff;box-shadow:0 30px 80px rgba(0,0,0,.4);cursor:zoom-out}
 .image-lightbox button{position:absolute;top:20px;right:20px;width:40px;height:40px;border:0;border-radius:999px;background:rgba(255,255,255,.92);color:#172033;font-size:24px;line-height:40px;cursor:pointer;box-shadow:0 12px 28px rgba(0,0,0,.18)}
-.file-viewer[data-viewer-theme='dark'] .image-viewer{background:#101820}
-@media (prefers-color-scheme:dark){.file-viewer[data-viewer-theme='system'] .image-viewer{background:#101820}}
+[data-viewer-theme='dark'] .image-viewer{background:#101820}
+@media (prefers-color-scheme:dark){[data-viewer-theme='system'] .image-viewer{background:#101820}}
 @media (max-width:767px){.image-stage{padding:12px}.image-lightbox{padding:16px}.image-lightbox button{top:12px;right:12px}}
 `;
 const createStyle = (documentRef) => {

package/dist/source/loading.js

@@ -95,8 +95,78 @@ export const hasFileViewerPreviewSource = ({ file, url, } = {}) => {
 export const resolveFileViewerPreviewRequestReason = (input = {}) => {
     return hasFileViewerPreviewSource(input) ? 'replace' : 'reset';
 };
+const FILE_VIEWER_HIERARCHICAL_URL_PATTERN = /^[a-z][a-z0-9+.-]*:\/\//i;
+const FILE_VIEWER_SCHEME_URL_PATTERN = /^[a-z][a-z0-9+.-]*:/i;
+const findFileViewerUrlSuffixIndex = (value) => {
+    const queryIndex = value.indexOf('?');
+    const hashIndex = value.indexOf('#');
+    if (queryIndex === -1) {
+        return hashIndex;
+    }
+    if (hashIndex === -1) {
+        return queryIndex;
+    }
+    return Math.min(queryIndex, hashIndex);
+};
+const encodeFileViewerUrlPathSegment = (segment) => {
+    if (!segment) {
+        return segment;
+    }
+    let decoded = segment;
+    try {
+        decoded = decodeURIComponent(segment);
+    }
+    catch {
+        // Invalid percent escapes are treated as literal filename characters.
+    }
+    return encodeURIComponent(decoded)
+        .replace(/%3A/gi, ':')
+        .replace(/%40/gi, '@')
+        .replace(/%24/g, '$')
+        .replace(/%26/g, '&')
+        .replace(/%2B/gi, '+')
+        .replace(/%2C/gi, ',')
+        .replace(/%3B/gi, ';')
+        .replace(/%3D/gi, '=');
+};
+const normalizeFileViewerUrlPathname = (pathname) => {
+    return pathname
+        .split('/')
+        .map(encodeFileViewerUrlPathSegment)
+        .join('/');
+};
+const splitFileViewerUrlPathPrefix = (pathPart) => {
+    if (pathPart.startsWith('//')) {
+        const pathStart = pathPart.indexOf('/', 2);
+        return pathStart === -1
+            ? { prefix: pathPart, pathname: '' }
+            : { prefix: pathPart.slice(0, pathStart), pathname: pathPart.slice(pathStart) };
+    }
+    const hierarchical = pathPart.match(FILE_VIEWER_HIERARCHICAL_URL_PATTERN);
+    if (hierarchical) {
+        const pathStart = pathPart.indexOf('/', hierarchical[0].length);
+        return pathStart === -1
+            ? { prefix: pathPart, pathname: '' }
+            : { prefix: pathPart.slice(0, pathStart), pathname: pathPart.slice(pathStart) };
+    }
+    if (FILE_VIEWER_SCHEME_URL_PATTERN.test(pathPart)) {
+        return { prefix: pathPart, pathname: '' };
+    }
+    return { prefix: '', pathname: pathPart };
+};
 export const normalizeFileViewerSourceUrl = (sourceUrl) => {
-    return sourceUrl || null;
+    const trimmed = sourceUrl === null || sourceUrl === void 0 ? void 0 : sourceUrl.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const suffixIndex = findFileViewerUrlSuffixIndex(trimmed);
+    const pathPart = suffixIndex === -1 ? trimmed : trimmed.slice(0, suffixIndex);
+    const suffix = suffixIndex === -1 ? '' : trimmed.slice(suffixIndex);
+    const { prefix, pathname } = splitFileViewerUrlPathPrefix(pathPart);
+    if (!pathname) {
+        return `${prefix}${suffix}`;
+    }
+    return `${prefix}${normalizeFileViewerUrlPathname(pathname)}${suffix}`;
 };
 export const createFileViewerEmptyPreviewState = () => {
     return {
@@ -491,6 +561,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
         streaming,
         url,
     });
+    const sourceUrl = remoteSource.url;
     commitFileViewerLoadStartState({
         version,
         filename: remoteSource.filename,
@@ -498,7 +569,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
         buildState: () => buildLoadStartState({
             version,
             source: 'url',
-            sourceUrl: url,
+            sourceUrl,
         }),
         onMarkLoadStarted,
         onLifecycle,
@@ -506,7 +577,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
     });
     if (remoteSource.streamPdf) {
         const stream = await runFileViewerStreamingPdfPreview({
-            url,
+            url: sourceUrl,
             version,
             filename: remoteSource.filename,
             previewTarget,
@@ -516,7 +587,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
             buildRenderCompleteState: input => buildRenderCompleteState({
                 version: input.version,
                 source: 'url',
-                sourceUrl: url,
+                sourceUrl,
             }),
             i18n,
             onStartLoading,
@@ -559,7 +630,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
     const controller = requestController.createAbortController();
     try {
         const data = await downloadFile({
-            url,
+            url: sourceUrl,
             signal: controller === null || controller === void 0 ? void 0 : controller.signal,
         });
         const download = commitFileViewerRemoteDownloadState({
@@ -595,7 +666,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
             file: download.source.file,
             version,
             source: 'url',
-            sourceUrl: url,
+            sourceUrl,
             previewTarget,
             isCurrent,
             mountRenderedContent,
@@ -604,7 +675,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
                 version: input.version,
                 source: 'url',
                 file: input.file,
-                sourceUrl: url,
+                sourceUrl,
             }),
             onSession,
             onActiveDocumentContext,
@@ -885,10 +956,11 @@ export const resolveFileViewerPageHref = (locationLike) => {
     return (locationLike === null || locationLike === void 0 ? void 0 : locationLike.href) || undefined;
 };
 export const resolveFileViewerRemoteSourcePlan = ({ filename, fallbackFilename = DEFAULT_FILE_VIEWER_SOURCE_FILENAME, pageHref, streaming, url, }) => {
+    const sourceUrl = normalizeFileViewerSourceUrl(url) || url;
     const nextFilename = normalizeFilename(filename || url, fallbackFilename);
     const extension = getExtension(nextFilename);
     return {
-        url,
+        url: sourceUrl,
         filename: nextFilename,
         extension,
         streamPdf: pageHref
@@ -896,7 +968,7 @@ export const resolveFileViewerRemoteSourcePlan = ({ filename, fallbackFilename =
                 extension,
                 pageHref,
                 streaming,
-                url,
+                url: sourceUrl,
             })
             : false,
     };

package/dist/viewer/createViewer.js

@@ -10,6 +10,7 @@ import { createFileViewerZoomController } from '../features/document/zoom.js';
 import { createFileViewerViewStateController } from '../features/document/viewState.js';
 import { createFileViewerFitController, hasFileViewerExplicitInitialViewState, } from '../features/document/fit.js';
 import { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, createFileViewerOriginalSourceStateFromNormalizedSource, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, resolveFileViewerDisplayFilename, resolveFileViewerOperationFilename, } from './operations.js';
+import { openFileViewerPrintMaskDesignerAsync } from '../features/printMaskLoader.js';
 import { applyFileViewerZoomAvailability, createUnsupportedAvailability, getRendererAvailability, } from '../registry/capabilities.js';
 import { buildFileViewerLifecycleContextFromNormalizedSource, buildFileViewerOperationContext, runFileViewerBeforeOperation, runFileViewerLifecycleHook, } from '../lifecycle/operations.js';
 import { collectFileViewerRendererPlugins, createRendererRegistry, getFileViewerAutoRendererPresetVersion, hasFileViewerRendererPresetName, installFileViewerRendererPlugins, listFileViewerAutoRendererPresets, resolveFileViewerRendererPresetInputs, } from '../registry/registry.js';
@@ -437,7 +438,7 @@ export const createViewer = (container, createOptions = {}) => {
             await emitLifecycle(options, createOptions.onEvent, 'unload-complete', source, version, startedAt, reason);
         }
     };
-    return {
+    const instance = {
         container,
         async load(source) {
             const version = requestScope.requestController.createVersion();
@@ -579,10 +580,27 @@ export const createViewer = (container, createOptions = {}) => {
                     fallback: DEFAULT_FILE_VIEWER_PREVIEW_TITLE,
                 }),
                 watermarkInlineStyle: getWatermarkInlineStyle(printOptions.watermarkInlineStyle),
+                mask: printOptions.mask,
                 printAvailable: getCapabilitiesForExtension().print,
                 beforeOperation: runBeforeViewerOperation,
             });
         },
+        async printWithMask(printOptions = {}) {
+            var _a, _b;
+            const result = await openFileViewerPrintMaskDesignerAsync({
+                root: container,
+                i18n: options,
+                color: (_a = printOptions.mask) === null || _a === void 0 ? void 0 : _a.color,
+                initialRegions: (_b = printOptions.mask) === null || _b === void 0 ? void 0 : _b.regions,
+            });
+            if (!(result === null || result === void 0 ? void 0 : result.mask)) {
+                return;
+            }
+            await instance.print({
+                ...printOptions,
+                mask: result.mask,
+            });
+        },
         async zoomIn() {
             fitController.markUserInteraction();
             const state = await zoomController.zoomIn();
@@ -649,4 +667,5 @@ export const createViewer = (container, createOptions = {}) => {
             return documentActions.getDocumentTextChunks(textOptions);
         },
     };
+    return instance;
 };

package/dist/viewer/operations.d.ts

@@ -71,12 +71,14 @@ export interface CreateFileViewerOperationActionHandlersInput extends FileViewer
 export interface FileViewerOperationActionHandlers {
     downloadOriginalFile(): Promise<boolean | undefined>;
     exportRenderedHtml(): Promise<string | undefined>;
-    printRenderedHtml(): Promise<boolean | undefined>;
+    printRenderedHtml(options?: FileViewerPrintOptions): Promise<boolean | undefined>;
+    printWithMask(options?: FileViewerPrintOptions): Promise<boolean | undefined>;
 }
 export interface FileViewerPublicOperationActionHandlers {
     downloadOriginalFile(): Promise<void>;
     exportRenderedHtml(): Promise<void>;
-    printRenderedHtml(): Promise<void>;
+    printRenderedHtml(options?: FileViewerPrintOptions): Promise<void>;
+    printWithMask(options?: FileViewerPrintOptions): Promise<void>;
 }
 export declare const createFileViewerOriginalSourceState: ({ buffer, file, url, filename, mimeType, }?: CreateFileViewerOriginalSourceStateInput) => FileViewerOriginalSourceState;
 export declare const resolveFileViewerDisplayFilename: (source?: Pick<NormalizedFileViewerSource, "filename"> | null, fallback?: string) => string;

package/dist/viewer/operations.js

@@ -61,7 +61,7 @@ const runBeforeOperation = async (beforeOperation, operation) => {
     }
     return await beforeOperation(operation);
 };
-const buildRenderedHtmlDocumentFromOperation = async (mode, { source, title, filename, adapter = null, watermarkInlineStyle, i18n, }) => {
+const buildRenderedHtmlDocumentFromOperation = async (mode, { source, title, filename, adapter = null, watermarkInlineStyle, mask = null, i18n, }) => {
     if (!source) {
         throw new Error(translateFileViewerMessage(i18n, 'error.noExportContent'));
     }
@@ -74,6 +74,7 @@ const buildRenderedHtmlDocumentFromOperation = async (mode, { source, title, fil
         }),
         adapter,
         watermarkInlineStyle,
+        mask: mode === 'print' ? mask : null,
     });
 };
 export const executeFileViewerDownloadOperation = async ({ source, filename, beforeOperation, i18n, throwOnMissingSource = true, }) => {
@@ -222,12 +223,51 @@ export const createFileViewerOperationActionHandlers = ({ getBuffer, getFile, ge
                 return undefined;
             }
         },
-        async printRenderedHtml() {
-            var _a;
+        async printRenderedHtml(options = {}) {
+            var _a, _b, _c;
             try {
                 return await executeFileViewerPrintOperation({
                     ...getRenderedOperationInput(),
-                    printAvailable: (_a = getPrintAvailable === null || getPrintAvailable === void 0 ? void 0 : getPrintAvailable()) !== null && _a !== void 0 ? _a : true,
+                    ...options,
+                    watermarkInlineStyle: (_b = (_a = options.watermarkInlineStyle) !== null && _a !== void 0 ? _a : getWatermarkInlineStyle === null || getWatermarkInlineStyle === void 0 ? void 0 : getWatermarkInlineStyle()) !== null && _b !== void 0 ? _b : undefined,
+                    printAvailable: (_c = getPrintAvailable === null || getPrintAvailable === void 0 ? void 0 : getPrintAvailable()) !== null && _c !== void 0 ? _c : true,
+                });
+            }
+            catch (error) {
+                handleFileViewerOperationActionError('print', error, {
+                    errorPrefixes,
+                    formatErrorMessage,
+                    getI18n,
+                    i18n,
+                    onError,
+                    onErrorMessage,
+                });
+                return undefined;
+            }
+        },
+        async printWithMask(options = {}) {
+            var _a, _b, _c, _d, _e;
+            try {
+                const source = getRenderedSource();
+                if (!source) {
+                    throw new Error(translateFileViewerMessage(resolveI18n(), 'error.noExportContent'));
+                }
+                const { openFileViewerPrintMaskDesignerAsync } = await import('../features/printMaskLoader.js');
+                const result = await openFileViewerPrintMaskDesignerAsync({
+                    root: source,
+                    i18n: resolveI18n(),
+                    color: (_a = options.mask) === null || _a === void 0 ? void 0 : _a.color,
+                    initialRegions: (_b = options.mask) === null || _b === void 0 ? void 0 : _b.regions,
+                });
+                if (!(result === null || result === void 0 ? void 0 : result.mask)) {
+                    return undefined;
+                }
+                return await executeFileViewerPrintOperation({
+                    ...getRenderedOperationInput(),
+                    ...options,
+                    watermarkInlineStyle: (_d = (_c = options.watermarkInlineStyle) !== null && _c !== void 0 ? _c : getWatermarkInlineStyle === null || getWatermarkInlineStyle === void 0 ? void 0 : getWatermarkInlineStyle()) !== null && _d !== void 0 ? _d : undefined,
+                    mask: result.mask,
+                    printAvailable: (_e = getPrintAvailable === null || getPrintAvailable === void 0 ? void 0 : getPrintAvailable()) !== null && _e !== void 0 ? _e : true,
                 });
             }
             catch (error) {
@@ -253,8 +293,11 @@ export const createFileViewerPublicOperationActionHandlers = (input) => {
         async exportRenderedHtml() {
             await actions.exportRenderedHtml();
         },
-        async printRenderedHtml() {
-            await actions.printRenderedHtml();
+        async printRenderedHtml(options) {
+            await actions.printRenderedHtml(options);
+        },
+        async printWithMask(options) {
+            await actions.printWithMask(options);
         },
     };
 };

package/headless.d.ts

@@ -0,0 +1 @@
+export * from './dist/headless';

package/headless.js

@@ -0,0 +1 @@
+export * from './dist/headless.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/core",
-  "version": "2.1.22",
+  "version": "2.1.24",
   "private": false,
   "type": "module",
   "description": "Framework-neutral modular TypeScript core for Flyfish File Viewer renderer orchestration, lifecycle APIs, search, zoom, print, and export",
@@ -62,10 +62,23 @@
       "import": "./dist/browser.js",
       "default": "./dist/browser.js"
     },
+    "./print-mask": {
+      "types": "./dist/print-mask.d.ts",
+      "import": "./dist/print-mask.js",
+      "default": "./dist/print-mask.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
+    "assets.js",
+    "assets.d.ts",
+    "browser.js",
+    "browser.d.ts",
     "dist",
+    "headless.js",
+    "headless.d.ts",
+    "print-mask.js",
+    "print-mask.d.ts",
     "vendor",
     "README.md",
     "README.en.md",

package/print-mask.d.ts

@@ -0,0 +1 @@
+export * from './dist/print-mask';

package/print-mask.js

@@ -0,0 +1 @@
+export * from './dist/print-mask.js';