@file-viewer/core 2.4.0 → 3.0.1

package/README.en.md

@@ -66,9 +66,26 @@ const viewer = createViewer(document.querySelector('#viewer')!, {
 await viewer.load({ url: '/files/report.pdf' })
 ```
 
+HTML document builders live in the opt-in export entry so ordinary previews do
+not download the sanitizer. The viewer's `exportHtml()` and `print()` methods
+load this entry only when invoked. For v3, migrate direct builder imports from
+the package root to the explicit subpath:
+
+```ts
+import {
+  buildExportHtmlDocument,
+  buildFileViewerRenderedHtmlDocument
+} from '@file-viewer/core/export'
+```
+
+The deprecated Vue 3 template re-exports are asynchronous in v3 to preserve
+this lazy boundary, so legacy calls must use `await buildExportHtmlDocument(...)`
+or `await collectDocumentStyles()`. Direct imports from the `export` subpath
+keep their documented return types.
+
 `options.styleIsolation` accepts `auto`, `shadow`, `scoped`, or `none`. Use `shadow` when a custom host or framework wrapper needs a ShadowRoot-backed render surface. Core passes the resolved `surface` to renderer `load(context)`, so custom renderers should inject styles into `context.surface.shadowRoot` or the renderer container instead of `document.head`, and should mount overlays inside the same isolated surface when possible.
 
-The root `@file-viewer/core` entry remains the complete compatibility entry for existing integrations. New component packages should prefer the narrowest explicit entry point they need: `headless` for contracts and build-time helpers, `browser` for real browser preview.
+The root `@file-viewer/core` entry remains the normal browser-compatible entry. New component packages should prefer the narrowest explicit entry point they need: `headless` for contracts and build-time helpers, `browser` for real browser preview, and `export` for sanitized standalone HTML documents.
 
 ```ts
 import {

package/README.md

@@ -66,9 +66,26 @@ const viewer = createViewer(document.querySelector('#viewer')!, {
 await viewer.load({ url: '/files/report.pdf' })
 ```
 
+HTML document builders live in the opt-in export entry so ordinary previews do
+not download the sanitizer. The viewer's `exportHtml()` and `print()` methods
+load this entry only when invoked. For v3, migrate direct builder imports from
+the package root to the explicit subpath:
+
+```ts
+import {
+  buildExportHtmlDocument,
+  buildFileViewerRenderedHtmlDocument
+} from '@file-viewer/core/export'
+```
+
+Vue 3 模板中已弃用的兼容导出在 v3 中改为异步，以保持这条懒加载边界；
+旧调用需要使用 `await buildExportHtmlDocument(...)` 或
+`await collectDocumentStyles()`。直接从 `export` 子路径导入时，返回类型仍
+按该子路径的 API 文档保持不变。
+
 `options.styleIsolation` accepts `auto`, `shadow`, `scoped`, or `none`. Use `shadow` when a custom host or framework wrapper needs a ShadowRoot-backed render surface. Core passes the resolved `surface` to renderer `load(context)`, so custom renderers should inject styles into `context.surface.shadowRoot` or the renderer container instead of `document.head`, and should mount overlays inside the same isolated surface when possible.
 
-The root `@file-viewer/core` entry remains the complete compatibility entry for existing integrations. New component packages should prefer the narrowest explicit entry point they need: `headless` for contracts and build-time helpers, `browser` for real browser preview.
+The root `@file-viewer/core` entry remains the normal browser-compatible entry. New component packages should prefer the narrowest explicit entry point they need: `headless` for contracts and build-time helpers, `browser` for real browser preview, and `export` for sanitized standalone HTML documents.
 
 ```ts
 import {

package/dist/config/options.js

@@ -1,3 +1,4 @@
+const UNSAFE_JSON_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 const isRecord = (value) => {
     return !!value && typeof value === 'object' && !Array.isArray(value);
 };
@@ -31,14 +32,19 @@ const sanitizeJsonValue = (value) => {
     if (!isRecord(value)) {
         return undefined;
     }
-    const output = {};
+    const outputEntries = [];
     Object.entries(value).forEach(([key, nextValue]) => {
+        if (UNSAFE_JSON_KEYS.has(key)) {
+            return;
+        }
         const sanitized = sanitizeJsonValue(nextValue);
         if (sanitized !== undefined) {
-            output[key] = sanitized;
+            outputEntries.push([key, sanitized]);
         }
     });
-    return Object.keys(output).length ? output : undefined;
+    return outputEntries.length
+        ? Object.fromEntries(outputEntries)
+        : undefined;
 };
 const stripExecutionOnlyOptions = (value) => {
     const { beforeOperation: _beforeOperation, hooks: _hooks, preset: _preset, presets: _presets, renderers: _renderers, rendererMode: _rendererMode, ...rest } = value;

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.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.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 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;
@@ -28,7 +28,7 @@ export type FileViewerToolbarItem = 'search' | 'zoom' | 'download' | 'print' | '
 export type FileViewerResolvedToolbarItem = 'search' | 'zoom' | 'download' | 'print' | 'exportHtml' | 'theme';
 export type FileViewerToolbarActionMap = Partial<Record<FileViewerOperationType, boolean>>;
 export type FileViewerRenderStateKind = 'idle' | 'loading' | 'ready' | 'empty' | 'unsupported' | 'error';
-export type FileViewerRendererCategory = 'office' | 'document' | 'archive' | 'email' | 'eda' | 'cad' | 'model' | 'geo' | 'drawing' | 'mindmap' | 'ebook' | 'image' | 'markdown' | 'code' | 'media' | 'asset' | 'fallback';
+export type FileViewerRendererCategory = 'office' | 'document' | 'archive' | 'email' | 'eda' | 'cad' | 'model' | 'geo' | 'drawing' | 'mindmap' | 'ebook' | 'image' | 'medical-image' | 'cryptographic-container' | 'markdown' | 'code' | 'media' | 'asset' | 'fallback';
 export interface FileViewerWatermarkOptions {
     enabled?: boolean;
     text?: string;
@@ -100,6 +100,30 @@ export interface FileViewerArchiveOptions {
      */
     requestPassword?: (context: FileViewerArchivePasswordRequestContext) => string | null | undefined | Promise<string | null | undefined>;
 }
+export interface FileViewerChmOptions {
+    /** Self-hosted module Worker that owns all untrusted CHM parsing and decompression. */
+    workerUrl?: string | URL;
+    /** Self-hosted wasm-bindgen JavaScript module loaded by the CHM Worker. */
+    wasmModuleUrl?: string | URL;
+    /** Self-hosted Rust WebAssembly binary loaded by the CHM Worker. */
+    wasmUrl?: string | URL;
+    /** Maximum time for an individual Worker request. Defaults to 60 seconds. */
+    workerTimeoutMs?: number;
+    /** Maximum accepted CHM input size. Defaults to 320 MiB. */
+    maxArchiveBytes?: number;
+    /** Maximum number of virtual files accepted from one CHM. Defaults to 50,000. */
+    maxEntries?: number;
+    /** Maximum uncompressed size of one virtual file. Defaults to 32 MiB. */
+    maxEntryBytes?: number;
+    /** Maximum total unique decoded content exposed by the parser. Defaults to 512 MiB. */
+    maxTotalDecompressedBytes?: number;
+    /** Maximum HTML topic size. Defaults to 16 MiB. */
+    maxHtmlBytes?: number;
+    /** Maximum topic count scanned by the built-in search. Defaults to 10,000. */
+    maxSearchTopics?: number;
+    /** Maximum built-in search result count. Defaults to 200. */
+    maxSearchResults?: number;
+}
 export type FileViewerArchivePasswordRequestReason = 'encrypted' | 'invalid-password' | 'read-failed' | 'extract-failed';
 export interface FileViewerArchivePasswordRequestContext {
     filename: string;
@@ -197,8 +221,10 @@ export interface FileViewerDocxOptions {
     updatePageReferences?: boolean;
     hideWebHiddenContent?: boolean;
     ignoreLastRenderedPageBreak?: boolean;
-    /** External DOCX links are blocked by default; internal bookmark links remain active. */
+    /** External DOC/DOCX/RTF links are blocked by default; internal bookmark links remain active. */
     externalLinkPolicy?: 'allow' | 'block';
+    /** Linked DOC/DOCX/RTF image resources are blocked by default; embedded images remain available. */
+    externalResourcePolicy?: 'allow' | 'block';
     /** Overrides automatic DOCX dark rendering derived from the viewer theme. */
     darkMode?: boolean;
 }
@@ -337,6 +363,8 @@ export interface FileRenderContext {
     filename?: string;
     url?: string;
     streamUrl?: string;
+    /** Original browser File retained for renderers that support Blob-backed random access. */
+    sourceFile?: File;
     signal?: AbortSignal;
     options?: FileViewerOptions;
     surface?: RenderSurface;
@@ -394,6 +422,195 @@ export interface FileViewerModelOptions {
 export interface FileViewerDataOptions {
     sqlWasmUrl?: string;
 }
+export type FileViewerIllustratorMode = 'auto' | 'pdf' | 'native';
+/** Resource budgets forwarded to the standalone illustrator-pgf Worker. */
+export interface FileViewerIllustratorLimits {
+    maxFileBytes: number;
+    maxDecodedBytes: number;
+    maxPdfObjects: number;
+    maxPrivateBlocks: number;
+    maxTokens: number;
+    maxStatements: number;
+    maxNodes: number;
+    maxPathPoints: number;
+    maxNesting: number;
+    maxStringBytes: number;
+    maxSingleRasterPixels: number;
+    maxTotalRasterBytes: number;
+    maxWorkerTimeMs: number;
+    maxRenderPixels: number;
+    maxCacheBytes: number;
+}
+export interface FileViewerIllustratorFontReference {
+    postScriptName: string;
+    family?: string;
+    style?: string;
+    subset?: boolean;
+}
+export interface FileViewerIllustratorResourceReference {
+    id: string;
+    kind: string;
+    path?: string;
+    uri?: string;
+    sha256?: string;
+}
+export interface FileViewerIllustratorFontResolver {
+    resolve(reference: FileViewerIllustratorFontReference, signal: AbortSignal): Promise<ArrayBuffer | FontFace | null>;
+}
+export interface FileViewerIllustratorResourceResolver {
+    resolve(reference: FileViewerIllustratorResourceReference, signal: AbortSignal): Promise<ArrayBuffer | null>;
+}
+export interface FileViewerDesignOptions {
+    /** Illustrator routing: PDF-compatible surface, native PGF scene, or safe automatic fallback. */
+    illustratorMode?: FileViewerIllustratorMode;
+    /** Self-hosted module Worker that runs the standalone illustrator-pgf parser and renderer. */
+    illustratorWorkerUrl?: string | URL;
+    /** Resource budgets forwarded to illustrator-pgf. Defaults to the SDK's bounded limits. */
+    illustratorLimits?: Partial<FileViewerIllustratorLimits>;
+    /** Optional host font resolver used only by the native Illustrator session. */
+    illustratorFontResolver?: FileViewerIllustratorFontResolver;
+    /** Optional host linked/embedded resource resolver used only by the native Illustrator session. */
+    illustratorResourceResolver?: FileViewerIllustratorResourceResolver;
+    /** Self-hosted module Worker used for heavy Adobe document parsing and pixel synthesis. */
+    workerUrl?: string | URL;
+    /** Self-hosted module Worker used for bounded FLA/XFL, XD, INDD/INDT, ICML/IDMS/INX, ASE, and ACO parsing. */
+    containerWorkerUrl?: string | URL;
+    /** Self-hosted module Worker used for ABR/CSH/PAT/GRD/ASL resource parsing. */
+    adobeResourceWorkerUrl?: string | URL;
+    /** Self-hosted module Worker that runs the bounded EPS/PostScript interpreter. */
+    postscriptWorkerUrl?: string | URL;
+    /** Self-hosted, license-safe Stet WebAssembly binary used only inside the PostScript Worker. */
+    postscriptWasmUrl?: string | URL;
+    /** Defaults to true. Disable only when Worker is unavailable. */
+    useWorker?: boolean;
+    /** Maximum parser time before the Worker is terminated. Defaults to 60 seconds. */
+    workerTimeoutMs?: number;
+    /** Base EPS/PostScript rasterization density. Defaults to 96 DPI. */
+    postscriptRenderDpi?: number;
+    /** Maximum pages produced by one EPS/PostScript program. Defaults to 100. */
+    postscriptMaxPages?: number;
+    /** Maximum source width or height reported by a PostScript page. Defaults to 100,000 units. */
+    postscriptMaxSourceDimension?: number;
+    /** Maximum PostScript virtual-machine allocation. Defaults to 256 MiB. */
+    postscriptMaxVmBytes?: number;
+    /** Maximum PostScript print working set across visible, cached, transient, and print RGBA canvases. Defaults to 128 MiB. */
+    postscriptMaxPrintBytes?: number;
+    /** Self-hosted module Worker used by the high-fidelity IDML page renderer. */
+    idmlWorkerUrl?: string | URL;
+    /** Self-hosted @paged-media/introspect-wasm binary used only inside the IDML Worker. */
+    idmlWasmUrl?: string | URL;
+    /** Base rasterization density for IDML pages. Defaults to 96 DPI. */
+    idmlRenderDpi?: number;
+    /** Maximum IDML ZIP entry count. Defaults to 20,000. */
+    idmlMaxEntries?: number;
+    /** Maximum total expanded bytes declared by an IDML package. Defaults to 512 MiB. */
+    idmlMaxExpandedBytes?: number;
+    /** Maximum IDML page count exposed by the renderer. Defaults to 500. */
+    idmlMaxPages?: number;
+    /** Maximum frame count exposed by the IDML page tree. Defaults to 100,000. */
+    idmlMaxFrames?: number;
+    /** Maximum IDML print working set across visible, cached, transient, and print RGBA canvases. Defaults to 128 MiB. */
+    idmlMaxPrintBytes?: number;
+    /** Maximum structured result returned for ICML/IDMS/INX parsing. Defaults to 24 MiB and is hard-capped at 64 MiB. */
+    indesignExchangeMaxResultBytes?: number;
+    /** Maximum geometry points retained for one ICML/IDMS/INX page item. Defaults to 4,096 and is hard-capped at 16,384. */
+    indesignExchangeMaxPointsPerItem?: number;
+    /** Maximum DOM/SVG nodes materialized for one active ICML/IDMS/INX panel. Defaults to 8,000 and is hard-capped at 20,000. */
+    indesignExchangeMaxDomNodesPerPanel?: number;
+    /** Maximum accepted Photoshop source size. Defaults to 128 MiB. */
+    maxFileBytes?: number;
+    /** Maximum document canvas area. Defaults to 16 megapixels. */
+    maxCanvasPixels?: number;
+    /** Maximum width or height accepted for a browser canvas. Defaults to 16,384 pixels. */
+    maxCanvasDimension?: number;
+    /** Maximum decoded layer count. Defaults to 2,000. */
+    maxLayers?: number;
+    /** Maximum group nesting depth. Defaults to 64. */
+    maxNestingDepth?: number;
+    /** Maximum area decoded for one interactive layer. Defaults to 16 megapixels. */
+    maxLayerPixels?: number;
+    /** Maximum transferred RGBA bytes for one result. Defaults to 128 MiB. */
+    maxDecodedBytes?: number;
+    /** Maximum retained interactive layer canvas bytes. Defaults to 64 MiB. */
+    maxLayerCacheBytes?: number;
+    /** Maximum colors, brushes, shapes, pages, or other resource records. Defaults to 4,096. */
+    maxResourceItems?: number;
+    /** Maximum UTF-16 code units accepted for one resource name. Defaults to 4,096. */
+    maxResourceNameCodeUnits?: number;
+    /** Maximum total pixels decoded for one resource preview collection. Defaults to 16 megapixels. */
+    maxResourcePreviewPixels?: number;
+    /** Safety and inventory limits for XD UCF/ZIP containers and saved raster previews. */
+    xd?: {
+        maxFileBytes?: number;
+        maxEntries?: number;
+        maxCentralDirectoryBytes?: number;
+        maxEntryNameBytes?: number;
+        maxPathDepth?: number;
+        maxEntryCompressedBytes?: number;
+        maxEntryUncompressedBytes?: number;
+        maxTotalUncompressedBytes?: number;
+        maxCompressionRatio?: number;
+        maxManifestBytes?: number;
+        maxStructureFileBytes?: number;
+        maxStructureTotalBytes?: number;
+        maxStructureFiles?: number;
+        maxJsonNodes?: number;
+        maxJsonDepth?: number;
+        maxJsonStringBytes?: number;
+        maxPreviewCandidates?: number;
+        maxPreviewBytes?: number;
+        maxPreviewTotalBytes?: number;
+        maxPreviewDimension?: number;
+        maxPreviewPixels?: number;
+        maxReportedResources?: number;
+        maxReportedArtboards?: number;
+    };
+    /** Safety and bounded first-frame reconstruction limits for modern ZIP/XFL-based Animate FLA files. */
+    fla?: {
+        maxFileBytes?: number;
+        maxEntries?: number;
+        maxCentralDirectoryBytes?: number;
+        maxEntryNameBytes?: number;
+        maxPathDepth?: number;
+        maxEntryCompressedBytes?: number;
+        maxEntryUncompressedBytes?: number;
+        maxTotalUncompressedBytes?: number;
+        maxCompressionRatio?: number;
+        maxXmlFileBytes?: number;
+        maxXmlTotalBytes?: number;
+        maxXmlFiles?: number;
+        maxXmlNodes?: number;
+        maxXmlDepth?: number;
+        maxXmlAttributes?: number;
+        maxXmlTextBytes?: number;
+        maxAttributeBytes?: number;
+        maxTimelines?: number;
+        maxLayers?: number;
+        maxFrames?: number;
+        maxSymbols?: number;
+        maxReportedResources?: number;
+        maxPreviewElements?: number;
+        maxPreviewPathCommands?: number;
+        maxPreviewSvgBytes?: number;
+        maxPreviewAssetBytes?: number;
+        maxPreviewAssetTotalBytes?: number;
+        maxPreviewDimension?: number;
+        maxPreviewPixels?: number;
+        maxSymbolDepth?: number;
+    };
+    /** Safety limits for native INDD/INDT master-page, contiguous-object, XMP, and thumbnail reads. */
+    inDesign?: {
+        maxFileBytes?: number;
+        maxDatabasePages?: number;
+        maxContiguousObjects?: number;
+        maxObjectBytes?: number;
+        maxXmpBytes?: number;
+        maxPreviewCandidates?: number;
+        maxPreviewBytes?: number;
+        maxPreviewDimension?: number;
+        maxPreviewPixels?: number;
+    };
+}
 export type FileViewerGeoBasemapPreset = 'none' | 'offline' | 'openfreemap' | 'openfreemap-liberty' | 'openfreemap-bright' | 'openfreemap-positron' | 'openfreemap-dark' | 'openfreemap-fiord' | 'osm-raster' | 'tianditu-vector' | 'tianditu-imagery' | 'tianditu-terrain';
 export type FileViewerTiandituMapStyle = 'vector' | 'imagery' | 'terrain';
 export interface FileViewerGeoBasemapOptions {
@@ -483,14 +700,16 @@ export interface FileViewerDrawingOptions {
     /**
      * Self-hosted diagrams.net viewer script.
      *
-     * The default points to the viewer asset copied under
-     * `vendor/drawio/viewer-static.min.js`, so Draw.io uses the official viewer
-     * offline without reaching public diagrams.net hosts.
+     * The default points to the optional viewer asset copied under
+     * `vendor/drawio/viewer-static.min.js`. It is only requested when
+     * `preferOfficial` is explicitly enabled and never reaches public
+     * diagrams.net hosts.
      */
     viewerScriptUrl?: string;
     /**
-     * Defaults to true. Set to false only when a deployment prefers the small
-     * built-in SVG fallback over the official diagrams.net viewer runtime.
+     * Defaults to false so untrusted diagrams use the inert built-in SVG path.
+     * Set to true only to opt into the separately delivered diagrams.net viewer
+     * runtime. It runs in a no-same-origin iframe with a restrictive CSP.
      */
     preferOfficial?: boolean;
     /**
@@ -549,7 +768,7 @@ export interface FileViewerCadOptions {
 }
 export type FileViewerRendererMode = 'extend' | 'replace';
 export type FileViewerBuiltinRendererPreset = 'all' | 'lite' | 'none';
-export type FileViewerRendererPresetName = 'all' | 'lite' | 'office' | 'engineering';
+export type FileViewerRendererPresetName = 'all' | 'lite' | 'standard' | 'office' | 'engineering';
 export interface FileViewerAutoRendererOptions {
     /**
      * Uses renderer presets registered by build tooling or preset side-effect imports.
@@ -593,6 +812,21 @@ export interface FileViewerTextOptions {
      * historical visible gutter when this option is omitted; pass false to hide it.
      */
     lineNumbers?: boolean;
+    /**
+     * Visually wraps long logical lines without inserting source newlines. Defaults to false.
+     * Wrapped continuation rows remain associated with their original line number.
+     */
+    wrapLongLines?: boolean;
+    /**
+     * Formats supported structured text with lazily loaded Prettier plugins for display only.
+     * Defaults to false; malformed, unsupported, or oversized inputs keep their original source.
+     */
+    prettyPrint?: boolean;
+    /**
+     * Maximum decoded UTF-8 source bytes eligible for Prettier. Defaults to the effective
+     * `virtualizeAboveBytes` value, or 512 KiB when that option is omitted.
+     */
+    prettyPrintMaxBytes?: number;
     /** Switches text and code to bounded virtual rendering above this byte size. Defaults to 512 KiB. */
     virtualizeAboveBytes?: number;
     /**
@@ -720,6 +954,7 @@ export interface FileViewerOptions {
      */
     initialViewState?: FileViewerViewState;
     archive?: FileViewerArchiveOptions;
+    chm?: FileViewerChmOptions;
     pdf?: FileViewerPdfOptions;
     docx?: FileViewerDocxOptions;
     presentation?: FileViewerPresentationOptions;
@@ -732,6 +967,7 @@ export interface FileViewerOptions {
     typst?: FileViewerTypstOptions;
     geo?: FileViewerGeoOptions;
     data?: FileViewerDataOptions;
+    design?: FileViewerDesignOptions;
     drawing?: FileViewerDrawingOptions;
     cad?: FileViewerCadOptions;
     model?: FileViewerModelOptions;
@@ -1073,6 +1309,10 @@ export interface RendererDefinition {
     packageName?: string;
     /** Presets that assemble this renderer. */
     presets?: readonly FileViewerRendererPresetName[];
+    /** Existing renderer whose fallback extensions this specialist replaces when installed. */
+    enhancesRendererId?: string;
+    /** Extensions transferred from enhancesRendererId to this specialist when installed. */
+    enhancesExtensions?: readonly string[];
     containerVersions?: readonly string[];
     knownLimits?: readonly string[];
     capabilities?: RendererCapability;

package/dist/export.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Explicit HTML export and print-document entrypoint.
+ *
+ * This subpath owns the DOM sanitizer and is intentionally excluded from the
+ * normal viewer/headless graph. Viewer operations load it only when the user
+ * starts an HTML export or print operation.
+ */
+export { buildFileViewerRenderedDomDocument, buildFileViewerRenderedHtmlDocument, buildExportDomDocument, buildExportHtmlDocument, collectDocumentStyles, sanitizeFileViewerExportDocumentDom, sanitizeFileViewerExportDocumentHtml, } from './exportDocument';
+export type { BuildExportHtmlDocumentOptions, BuildFileViewerRenderedHtmlDocumentOptions, } from './exportDocument';
+export { inlineFileViewerBlobUrlsInHtml, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export';

package/dist/export.js

@@ -0,0 +1,9 @@
+/**
+ * Explicit HTML export and print-document entrypoint.
+ *
+ * This subpath owns the DOM sanitizer and is intentionally excluded from the
+ * normal viewer/headless graph. Viewer operations load it only when the user
+ * starts an HTML export or print operation.
+ */
+export { buildFileViewerRenderedDomDocument, buildFileViewerRenderedHtmlDocument, buildExportDomDocument, buildExportHtmlDocument, collectDocumentStyles, sanitizeFileViewerExportDocumentDom, sanitizeFileViewerExportDocumentHtml, } from './exportDocument.js';
+export { inlineFileViewerBlobUrlsInHtml, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export.js';

package/dist/exportDocument.d.ts

@@ -0,0 +1,36 @@
+import type { FileRenderExportAdapter, FileRenderExportMode, FileViewerPrintMaskOptions } from './contracts/types';
+/**
+ * Sanitize the complete standalone export document before it is downloaded or
+ * mounted into a print window. This is deliberately enforced in core because
+ * third-party render adapters and watermark overrides are library inputs.
+ */
+export declare const sanitizeFileViewerExportDocumentHtml: (html: string, documentRef?: Document) => string;
+/**
+ * Produce a sanitized, inert document tree for the print-window mount path.
+ * Returning DOM here avoids reinterpreting the sanitized string through a
+ * second HTML sink such as document.write or innerHTML.
+ */
+export declare const sanitizeFileViewerExportDocumentDom: (html: string, documentRef?: Document) => HTMLHtmlElement;
+export interface BuildExportHtmlDocumentOptions {
+    contentHtml: string;
+    includeDocumentStyles?: boolean;
+    printStyle?: string;
+    title: string;
+    watermarkInlineStyle?: string;
+    mask?: FileViewerPrintMaskOptions | null;
+    /** Document whose Window owns the sanitizer. Defaults to the active document. */
+    documentRef?: Document;
+}
+export declare const collectDocumentStyles: (documentRef?: Document) => string;
+export declare const buildExportHtmlDocument: (options: BuildExportHtmlDocumentOptions) => string;
+export declare const buildExportDomDocument: (options: BuildExportHtmlDocumentOptions) => HTMLHtmlElement;
+export interface BuildFileViewerRenderedHtmlDocumentOptions {
+    source: HTMLElement;
+    mode?: FileRenderExportMode;
+    title: string;
+    adapter?: FileRenderExportAdapter | null;
+    watermarkInlineStyle?: string;
+    mask?: FileViewerPrintMaskOptions | null;
+}
+export declare const buildFileViewerRenderedHtmlDocument: (options: BuildFileViewerRenderedHtmlDocumentOptions) => Promise<string>;
+export declare const buildFileViewerRenderedDomDocument: (options: BuildFileViewerRenderedHtmlDocumentOptions) => Promise<HTMLHtmlElement>;