@file-viewer/core 3.2.2 → 3.3.1

package/dist/output/canvasImage.js

@@ -1,4 +1,4 @@
-import { buildFileViewerWatermarkSvg, normalizeFileViewerWatermark } from "../features/watermark.js";
+import { buildFileViewerWatermarkSvg, normalizeFileViewerWatermark } from '../features/watermark.js';
 const loadImage = (document, source) => new Promise((resolve, reject) => {
     const image = document.createElement('img');
     const timer = setTimeout(() => finish(new Error('Image export resource timed out.')), 30000);
@@ -15,6 +15,7 @@ const loadImage = (document, source) => new Promise((resolve, reject) => {
     image.onerror = () => finish(new Error('Unable to render the export watermark.'));
     image.src = source;
 });
+/** Encodes a detached snapshot without mutating the renderer or omitting its watermark. */
 export async function createFileViewerCanvasImageBlob(snapshot, format, watermark, pixelRatio = 1) {
     if (!['png', 'jpeg'].includes(format))
         throw new Error('Unsupported image export format.');
@@ -37,6 +38,8 @@ export async function createFileViewerCanvasImageBlob(snapshot, format, watermar
     let normalized = normalizeFileViewerWatermark(watermark);
     if (normalized) {
         if (normalized.image) {
+            // SVG image documents do not load nested remote images. Inline the configured
+            // watermark first; an unreadable/tainted image must fail, never disappear.
             const image = await loadImage(document, normalized.image);
             const tile = document.createElement('canvas');
             tile.width = image.naturalWidth;

package/dist/output/export.d.ts

@@ -1,9 +1,11 @@
-import type { FileRenderExportAdapter, FileRenderExportOptions } from "../contracts/types.js";
+import type { FileRenderExportAdapter, FileRenderExportOptions } from '../contracts/types.js';
+/** Lightweight export helpers that remain on the normal viewer path. */
 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" | "cancelAnimationFrame" | "setTimeout" | "clearTimeout">>) => Promise<void>;
 export declare const waitForFileViewerImages: (root: ParentNode | null | undefined) => Promise<void>;
+/** Rewrite ephemeral blob URLs into portable data URLs for export and print. */
 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>;

package/dist/output/export.js

@@ -1,3 +1,4 @@
+/** Lightweight export helpers that remain on the normal viewer path. */
 export const triggerFileViewerBlobDownload = (blob, name) => {
     const objectUrl = URL.createObjectURL(blob);
     const link = document.createElement('a');
@@ -19,6 +20,9 @@ export const triggerFileViewerUrlDownload = (url, name) => {
     link.click();
     link.remove();
 };
+// Copy only presentation properties. The bitmap's pixel dimensions may be
+// several times larger than its CSS box, and canvas-only selectors will no
+// longer match after replacing the node with an image.
 const CANVAS_PRESENTATION_PROPERTIES = [
     'display', 'position', 'top', 'right', 'bottom', 'left', 'box-sizing',
     'width', 'height', 'min-width', 'min-height', 'max-width', 'max-height',
@@ -52,6 +56,7 @@ export const replaceFileViewerCanvasWithImages = (source, clone) => {
                         image.style.setProperty(property, value, canvas.style.getPropertyPriority(property));
                 }
             }
+            // Detached canvases have no used style; keep their normal intrinsic size.
             if (!image.style.width || image.style.width === 'auto')
                 image.style.width = `${sourceCanvas.width}px`;
             if (!image.style.height || image.style.height === 'auto')
@@ -59,6 +64,7 @@ export const replaceFileViewerCanvasWithImages = (source, clone) => {
             canvas.replaceWith(image);
         }
         catch {
+            // A canvas tainted by cross-origin resources cannot be exported.
         }
     });
 };
@@ -82,6 +88,7 @@ export const waitForFileViewerNextPaint = (targetWindow) => {
                 (_a = currentWindow === null || currentWindow === void 0 ? void 0 : currentWindow.cancelAnimationFrame) === null || _a === void 0 ? void 0 : _a.call(currentWindow, frame);
             resolve();
         };
+        // Background tabs and hidden print hosts may never run animation frames.
         timeout = schedule(finish, (currentWindow === null || currentWindow === void 0 ? void 0 : currentWindow.requestAnimationFrame) ? 250 : 0);
         if (finished || !(currentWindow === null || currentWindow === void 0 ? void 0 : currentWindow.requestAnimationFrame))
             return;
@@ -116,6 +123,7 @@ const waitForImage = (image, timeoutMs) => {
             image.removeEventListener('error', finish);
             resolve();
         };
+        // Start the timeout before decode(): a stalled decode must not bypass it.
         const timeout = setTimeout(finish, timeoutMs);
         image.addEventListener('load', finish, { once: true });
         image.addEventListener('error', finish, { once: true });
@@ -124,6 +132,7 @@ const waitForImage = (image, timeoutMs) => {
         else if (typeof image.decode === 'function') {
             try {
                 image.decode().then(finish, () => {
+                    // An error/load event may already have fired before decode rejects.
                     if (image.complete)
                         finish();
                 });
@@ -146,6 +155,7 @@ const waitForFonts = async (documentRef, timeoutMs) => {
         ]);
     }
     catch {
+        // A failed optional font should not prevent the browser's fallback print.
     }
     finally {
         if (timeout !== undefined)
@@ -181,6 +191,7 @@ const blobToDataUrl = async (blob) => {
             });
         }
         catch {
+            // Fall through to ArrayBuffer encoding for Node / incomplete FileReader shims.
         }
     }
     return bytesToDataUrl(await blob.arrayBuffer(), blob.type || 'application/octet-stream');
@@ -189,6 +200,7 @@ const collectBlobUrls = (html) => {
     const matches = html.match(/blob:[^\s"'<>)\\]+/g) || [];
     return Array.from(new Set(matches));
 };
+/** Rewrite ephemeral blob URLs into portable data URLs for export and print. */
 export const inlineFileViewerBlobUrlsInHtml = async (html) => {
     if (!html.includes('blob:') || typeof fetch !== 'function') {
         return html;

package/dist/output/printLayout.d.ts

@@ -7,10 +7,15 @@ export interface ApplyPrintPageSizeOptions {
 }
 export interface BuildPrintPageStyleOptions extends PrintPageSize {
     selector: string;
+    /** Per-page CSS pixel sizes, matched by data-viewer-print-page-index (fixed layout only). */
     pages?: readonly PrintPageSize[];
     heightMode?: 'fixed' | 'min';
 }
 export declare const formatCssPixels: (value: number) => string;
+/**
+ * Browser print helper. DOM measurement belongs in the core browser layer
+ * because it depends on CSS layout and HTMLElement.
+ */
 export declare const getElementPrintPageSize: (element: HTMLElement, fallback?: Partial<PrintPageSize>) => PrintPageSize;
 export declare const applyPrintPageSize: (element: HTMLElement, size: PrintPageSize, options?: ApplyPrintPageSizeOptions) => void;
 export declare const buildPrintPageStyle: ({ selector, width, height, heightMode, pages, }: BuildPrintPageStyleOptions) => string;

package/dist/output/printLayout.js

@@ -11,6 +11,10 @@ const readPositiveCssNumber = (value) => {
     const parsed = Number.parseFloat(value);
     return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
 };
+/**
+ * Browser print helper. DOM measurement belongs in the core browser layer
+ * because it depends on CSS layout and HTMLElement.
+ */
 export const getElementPrintPageSize = (element, fallback = {}) => {
     var _a;
     const style = (_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.getComputedStyle(element);

package/dist/output/snapshotDownload.d.ts

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

package/dist/output/snapshotDownload.js

@@ -1,7 +1,8 @@
-import { isFileViewerToolbarOperationPermitted } from "../lifecycle/operations.js";
-import { triggerFileViewerBlobDownload } from "./export.js";
+import { isFileViewerToolbarOperationPermitted } from '../lifecycle/operations.js';
+import { triggerFileViewerBlobDownload } from './export.js';
 export const isFileViewerSnapshotDownloadPermitted = (options) => isFileViewerToolbarOperationPermitted(options === null || options === void 0 ? void 0 : options.toolbar, 'download') &&
     isFileViewerToolbarOperationPermitted(options === null || options === void 0 ? void 0 : options.toolbar, 'export-html');
+/** Renderer-local downloads still use the owning viewer's hooks and request version. */
 export const createFileViewerSnapshotDownload = ({ getOptions, isCurrent, beforeDownload }) => async (create) => {
     var _a, _b;
     const allowed = () => isCurrent() && isFileViewerSnapshotDownloadPermitted(getOptions());

package/dist/platform/assets.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerArchiveOptions, FileViewerCadOptions, FileViewerChmOptions, FileViewerDataOptions, FileViewerDesignOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerIworkOptions, FileViewerHangulOptions, FileViewerModelOptions, FileViewerOptions, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerSpreadsheetOptions, FileViewerTypstOptions, FileViewerWordPerfectOptions } from "../contracts/types.js";
+import type { FileViewerArchiveOptions, FileViewerCadOptions, FileViewerChmOptions, FileViewerDataOptions, FileViewerDesignOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerIworkOptions, FileViewerHangulOptions, FileViewerModelOptions, FileViewerOptions, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerSpreadsheetOptions, FileViewerTypstOptions, FileViewerWordPerfectOptions } from '../contracts/types.js';
 export declare const DEFAULT_FILE_VIEWER_ARCHIVE_WORKER_PATH = "vendor/libarchive/worker-bundle.js";
 export declare const DEFAULT_FILE_VIEWER_ARCHIVE_WASM_PATH = "vendor/libarchive/libarchive.wasm";
 export declare const DEFAULT_FILE_VIEWER_CHM_WORKER_PATH = "vendor/chm/chm.worker.js";
@@ -9,7 +9,7 @@ export declare const DEFAULT_FILE_VIEWER_CHM_WASM_PATH = "vendor/chm/chm_wasm_bg
 export declare const DEFAULT_FILE_VIEWER_CHM_WASM_PACKAGE_PATH = "@file-viewer/renderer-chm/wasm/chm_wasm_bg.wasm";
 export declare const DEFAULT_FILE_VIEWER_DOCX_WORKER_PATH = "vendor/docx/docx.worker.js";
 export declare const DEFAULT_FILE_VIEWER_DOCX_WORKER_JSZIP_PATH = "vendor/docx/jszip.min.js";
-export declare const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = "0.3.36";
+export declare const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = "0.3.39";
 export declare const DEFAULT_FILE_VIEWER_PRESENTATION_WORKER_PATH = "vendor/pptx/pptx.worker.js";
 export declare const DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH = "vendor/ppt";
 export declare const DEFAULT_FILE_VIEWER_PPT_RUNTIME_VERSION = "0.3.6";
@@ -127,6 +127,13 @@ export interface ResolveFileViewerAssetUrlOptions {
 export declare const normalizeFileViewerAssetBaseUrl: (baseUrl?: string | URL | null) => string | undefined;
 export declare const setDefaultFileViewerAssetBaseUrl: (baseUrl?: string | URL | null) => void;
 export declare const resetDefaultFileViewerAssetBaseUrl: () => void;
+/**
+ * Resolves the stable public base for runtime assets without reading
+ * bundler-specific environment metadata or webpack public-path variables.
+ * Explicit HTML `<base>` configuration stays authoritative; for SPA fallback
+ * routes, emitted Vite/Webpack/UMI entry scripts reveal the deployment root
+ * more reliably than the route-derived page URL.
+ */
 export declare const resolveFileViewerRuntimeAssetBaseUrl: (documentRef: Document) => string;
 export declare const getDefaultFileViewerAssetBaseUrl: (documentRef?: Document | null) => string | undefined;
 export interface ResolvedFileViewerCadAssetUrls {

package/dist/platform/assets.js

@@ -8,7 +8,7 @@ export const DEFAULT_FILE_VIEWER_CHM_WASM_PATH = 'vendor/chm/chm_wasm_bg.wasm';
 export const DEFAULT_FILE_VIEWER_CHM_WASM_PACKAGE_PATH = '@file-viewer/renderer-chm/wasm/chm_wasm_bg.wasm';
 export const DEFAULT_FILE_VIEWER_DOCX_WORKER_PATH = 'vendor/docx/docx.worker.js';
 export const DEFAULT_FILE_VIEWER_DOCX_WORKER_JSZIP_PATH = 'vendor/docx/jszip.min.js';
-export const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = '0.3.36';
+export const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = '0.3.39';
 export const DEFAULT_FILE_VIEWER_PRESENTATION_WORKER_PATH = 'vendor/pptx/pptx.worker.js';
 export const DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH = 'vendor/ppt';
 export const DEFAULT_FILE_VIEWER_PPT_RUNTIME_VERSION = '0.3.6';
@@ -45,6 +45,8 @@ export const DEFAULT_FILE_VIEWER_CAD_LIBREDWG_WASM_PATH = `${DEFAULT_FILE_VIEWER
 export const DEFAULT_FILE_VIEWER_TYPST_COMPILER_WASM_URL = 'wasm/typst/typst_ts_web_compiler_bg.wasm';
 export const DEFAULT_FILE_VIEWER_TYPST_RENDERER_WASM_URL = 'wasm/typst/typst_ts_renderer_bg.wasm';
 export const DEFAULT_FILE_VIEWER_TYPST_FONT_ASSETS_URL = 'wasm/typst/fonts/';
+// Compatibility aliases kept for older imports. They intentionally resolve to
+// local viewer assets; the preview runtime must not fall back to a public CDN.
 export const FALLBACK_FILE_VIEWER_TYPST_COMPILER_WASM_URL = DEFAULT_FILE_VIEWER_TYPST_COMPILER_WASM_URL;
 export const FALLBACK_FILE_VIEWER_TYPST_RENDERER_WASM_URL = DEFAULT_FILE_VIEWER_TYPST_RENDERER_WASM_URL;
 export const DEFAULT_FILE_VIEWER_TYPST_COMPILER_WASM_PACKAGE_PATH = '@myriaddreamin/typst-ts-web-compiler/pkg/typst_ts_web_compiler_bg.wasm';
@@ -171,6 +173,9 @@ const resolveFileViewerScriptAssetBaseCandidate = (script, documentBaseUrl, inde
                 score += 8;
             }
             if (documentPathname.startsWith(candidateUrl.pathname)) {
+                // Prefer the deepest candidate that is still an ancestor of the SPA
+                // route. This avoids stripping an earlier deployment segment named
+                // `assets` when the emitted suffix is actually `static/js`.
                 score += 16 + pathDepth(candidateUrl.pathname) / 4;
             }
             if (script.type === 'module') {
@@ -225,6 +230,13 @@ const resolveFileViewerScriptAssetBaseCandidate = (script, documentBaseUrl, inde
         return [];
     }
 };
+/**
+ * Resolves the stable public base for runtime assets without reading
+ * bundler-specific environment metadata or webpack public-path variables.
+ * Explicit HTML `<base>` configuration stays authoritative; for SPA fallback
+ * routes, emitted Vite/Webpack/UMI entry scripts reveal the deployment root
+ * more reliably than the route-derived page URL.
+ */
 export const resolveFileViewerRuntimeAssetBaseUrl = (documentRef) => {
     var _a;
     const documentBaseUrl = documentRef.baseURI || documentRef.URL || 'file:///';
@@ -251,6 +263,8 @@ export const getDefaultFileViewerAssetBaseUrl = (documentRef) => {
     if (configuredFileViewerAssetBaseUrl !== automaticFileViewerAssetBaseUrl) {
         return configuredFileViewerAssetBaseUrl;
     }
+    // Core remains environment-neutral: callers that want automatic browser
+    // inference pass their owning Document explicitly.
     return documentRef ? resolveFileViewerRuntimeAssetBaseUrl(documentRef) : undefined;
 };
 const createDesignThirdPartyAssets = (rendererId, includeContainerXmlLicenses = false) => {

package/dist/platform/copiedAssets.d.ts

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

package/dist/platform/copiedAssets.js

@@ -1,4 +1,4 @@
-import { getFileViewerRendererAssetManifest, resolveFileViewerRuntimeAssetBaseUrl } from "./assets.js";
+import { getFileViewerRendererAssetManifest, resolveFileViewerRuntimeAssetBaseUrl } from './assets.js';
 const manifests = new WeakMap();
 const MAX_MANIFEST_BYTES = 1024 * 1024;
 const readManifest = async (url, signal) => {
@@ -56,6 +56,7 @@ const readManifest = async (url, signal) => {
         signal === null || signal === void 0 ? void 0 : signal.removeEventListener('abort', abort);
     }
 };
+/** Finds assets copied by the standard CLI without trusting a SPA fallback or arbitrary manifest URLs. */
 export async function resolveFileViewerCopiedAssetUrl(documentRef, rendererId, assetId, signal) {
     var _a, _b, _c;
     const asset = (_a = getFileViewerRendererAssetManifest(rendererId)) === null || _a === void 0 ? void 0 : _a.assets.find((item) => item.id === assetId);

package/dist/presentation/colorScheme.d.ts

@@ -0,0 +1,3 @@
+import type { FileViewerResolvedThemeMode, FileViewerThemeMode } from '../contracts/types.js';
+/** Observe the owning viewer, including hosts across a shadow boundary. */
+export declare const observeFileViewerColorScheme: (target: HTMLElement, fallback: FileViewerThemeMode | undefined, apply: (theme: FileViewerResolvedThemeMode) => void) => () => void;

package/dist/presentation/colorScheme.js

@@ -0,0 +1,40 @@
+import { resolveFileViewerColorScheme } from '../config/options.js';
+/** Observe the owning viewer, including hosts across a shadow boundary. */
+export const observeFileViewerColorScheme = (target, fallback, apply) => {
+    var _a;
+    const view = target.ownerDocument.defaultView;
+    const media = (_a = view === null || view === void 0 ? void 0 : view.matchMedia) === null || _a === void 0 ? void 0 : _a.call(view, '(prefers-color-scheme: dark)');
+    const ancestors = [];
+    let element = target;
+    while (element) {
+        ancestors.push(element);
+        const root = element.getRootNode();
+        element = element.parentElement || root.host || null;
+    }
+    let current;
+    const update = () => {
+        var _a;
+        const inherited = ancestors
+            .map((node) => node.getAttribute('data-viewer-theme'))
+            .find((value) => value === 'light' || value === 'dark' || value === 'system');
+        const next = resolveFileViewerColorScheme(inherited || fallback, (_a = media === null || media === void 0 ? void 0 : media.matches) !== null && _a !== void 0 ? _a : false);
+        if (next !== current) {
+            current = next;
+            apply(next);
+        }
+    };
+    const observer = (view === null || view === void 0 ? void 0 : view.MutationObserver) ? new view.MutationObserver(update) : undefined;
+    ancestors.forEach((node) => observer === null || observer === void 0 ? void 0 : observer.observe(node, { attributes: true, attributeFilter: ['data-viewer-theme'] }));
+    if (media === null || media === void 0 ? void 0 : media.addEventListener)
+        media.addEventListener('change', update);
+    else
+        media === null || media === void 0 ? void 0 : media.addListener(update);
+    update();
+    return () => {
+        observer === null || observer === void 0 ? void 0 : observer.disconnect();
+        if (media === null || media === void 0 ? void 0 : media.removeEventListener)
+            media.removeEventListener('change', update);
+        else
+            media === null || media === void 0 ? void 0 : media.removeListener(update);
+    };
+};

package/dist/presentation/state.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerFileRef, FileViewerOptions, FileViewerThemeMode, FileViewerToolbarOptions, FileViewerUiDensity } from "../contracts/types.js";
+import type { FileViewerFileRef, FileViewerOptions, FileViewerThemeMode, FileViewerToolbarOptions, FileViewerUiDensity } from '../contracts/types.js';
 export interface ResolveFileViewerPresentationStateInput {
     filename?: string;
     file?: FileViewerFileRef;

package/dist/presentation/state.js

@@ -1,6 +1,6 @@
-import { normalizeFileViewerToolbar } from "../lifecycle/operations.js";
-import { normalizeFileViewerTheme, resolveFileViewerUiDensity } from "../config/options.js";
-import { getExtension, resolveFileViewerSourceFilename } from "../source/index.js";
+import { normalizeFileViewerToolbar } from '../lifecycle/operations.js';
+import { normalizeFileViewerTheme, resolveFileViewerUiDensity } from '../config/options.js';
+import { getExtension, resolveFileViewerSourceFilename } from '../source/index.js';
 export const resolveFileViewerPresentationState = ({ filename, file, url, options, }) => {
     const displayFilename = resolveFileViewerSourceFilename({
         filename,

package/dist/print-mask.d.ts

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

package/dist/print-mask.js

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

package/dist/registry/capabilities.d.ts

@@ -1,10 +1,23 @@
-import type { FileRenderExportAdapter, FileViewerOperationAvailability, FileViewerZoomState, RendererDefinition, RendererSession } from "../contracts/types.js";
+import type { FileRenderExportAdapter, FileViewerOperationAvailability, FileViewerZoomState, RendererDefinition, RendererSession } from '../contracts/types.js';
 export declare const DEFAULT_OPERATION_AVAILABILITY: FileViewerOperationAvailability;
 export declare const getRendererAvailability: (renderer: RendererDefinition | undefined, session?: RendererSession | null) => FileViewerOperationAvailability;
 export declare const applyFileViewerZoomAvailability: (availability: FileViewerOperationAvailability, zoomState: FileViewerZoomState) => FileViewerOperationAvailability;
 export declare const createUnsupportedAvailability: (extension: string) => FileViewerOperationAvailability;
+/**
+ * 这些格式只有专属适配器准备好后才展示打印。
+ *
+ * 它们的在线预览常依赖分页引擎、虚拟渲染或 Worker 生命周期，直接克隆
+ * DOM 很容易只得到当前页或当前视口。
+ */
 export declare const ADAPTER_PRINT_REQUIRED_EXTENSIONS: readonly ["docx", "docm", "dotx", "dotm", "doc", "dot", "ppt", "pdf", "typ", "typst"];
+/**
+ * 这些格式的预览结果是完整 DOM / SVG / Canvas 截图，解除滚动容器裁切后
+ * 可以稳定进入浏览器打印流程。
+ */
 export declare const DOM_PRINTABLE_EXTENSIONS: readonly ["pptx", "pptm", "potx", "potm", "ppsx", "ppsm", "ofd", "dxf", "dwg", "dwf", "dwfx", "xps", "excalidraw", "drawio", "dio", "mermaid", "mmd", "plantuml", "puml", "umd", "md", "markdown", "olb", "dra", ...("markdown" | "webp" | "jpeg" | "png" | "pdf" | "xyz" | "wasm" | "chm" | "typst" | "xd" | "fla" | "js" | "html" | "svg" | "rb" | "docx" | "docm" | "dotx" | "dotm" | "doc" | "dot" | "ppt" | "pot" | "pptx" | "pptm" | "potx" | "potm" | "ppsx" | "ppsm" | "rtf" | "odt" | "odp" | "xlsx" | "xltx" | "xlsm" | "xlsb" | "xls" | "xlt" | "xla" | "xlam" | "xltm" | "csv" | "tsv" | "ods" | "fods" | "pages" | "numbers" | "key" | "wpd" | "wp" | "wp5" | "wp6" | "dbf" | "ofd" | "hwp" | "hwpx" | "typ" | "zip" | "zipx" | "7z" | "rar" | "tar" | "gz" | "gzip" | "tgz" | "bz2" | "bzip2" | "tbz" | "tbz2" | "xz" | "txz" | "lzma" | "zst" | "tzst" | "cab" | "ar" | "cpio" | "iso" | "xar" | "lha" | "lzh" | "jar" | "war" | "ear" | "apk" | "cbz" | "cbr" | "eml" | "msg" | "mbox" | "olb" | "dra" | "gds" | "oas" | "oasis" | "dxf" | "dwg" | "dwf" | "dwfx" | "xps" | "glb" | "gltf" | "obj" | "stl" | "ply" | "fbx" | "dae" | "3ds" | "3mf" | "amf" | "usd" | "usda" | "usdc" | "usdz" | "kmz" | "step" | "stp" | "iges" | "igs" | "ifc" | "3dm" | "brep" | "pcd" | "wrl" | "vrml" | "vtk" | "vtp" | "geojson" | "kml" | "gpx" | "shp" | "excalidraw" | "drawio" | "dio" | "mermaid" | "mmd" | "plantuml" | "puml" | "bpmn" | "xmind" | "epub" | "fb2" | "umd" | "gif" | "jpg" | "bmp" | "tiff" | "tif" | "avif" | "ico" | "heic" | "heif" | "jxl" | "dicom" | "dcm" | "p7m" | "p7s" | "p7c" | "p7b" | "pkcs7" | "cms" | "cmsc" | "tsd" | "tst" | "tsq" | "tsr" | "asics" | "scs" | "asice" | "sce" | "ers" | "asc" | "sig" | "pgp" | "gpg" | "jws" | "md" | "txt" | "lrc" | "json" | "mjs" | "cjs" | "css" | "java" | "py" | "htm" | "jsx" | "ts" | "tsx" | "xml" | "log" | "vue" | "yaml" | "yml" | "ini" | "sh" | "bash" | "sql" | "go" | "rs" | "php" | "c" | "cpp" | "cc" | "h" | "hpp" | "cs" | "diff" | "patch" | "bundle" | "bdl" | "jsonc" | "json5" | "ipynb" | "toml" | "proto" | "hcl" | "tex" | "gv" | "http" | "react" | "swift" | "kt" | "mp4" | "webm" | "m3u8" | "mp3" | "mpeg" | "wav" | "ogg" | "oga" | "opus" | "m4a" | "aac" | "flac" | "weba" | "midi" | "mid" | "psb" | "pdd" | "psdt" | "psd" | "ait" | "ai" | "idml" | "icml" | "idms" | "inx" | "xfl" | "indd" | "indt" | "ps" | "eps" | "ase" | "aco" | "abr" | "csh" | "pat" | "grd" | "asl" | "ttf" | "otf" | "woff" | "woff2" | "sqlite" | "parquet" | "avro" | "webarchive" | "bin" | "hex" | "elf" | "exe" | "dll" | "class" | "macho")[]];
+/**
+ * 这些格式默认不展示打印按钮，避免导出半截内容。
+ */
 export declare const NON_PRINTABLE_EXTENSIONS: readonly ["xlsx", "xltx", "xlsm", "xlsb", "xls", "xlt", "xltm", "csv", "tsv", "ods", "fods", "numbers", ...("markdown" | "webp" | "jpeg" | "png" | "pdf" | "xyz" | "wasm" | "chm" | "typst" | "xd" | "fla" | "js" | "html" | "svg" | "rb" | "docx" | "docm" | "dotx" | "dotm" | "doc" | "dot" | "ppt" | "pot" | "pptx" | "pptm" | "potx" | "potm" | "ppsx" | "ppsm" | "rtf" | "odt" | "odp" | "xlsx" | "xltx" | "xlsm" | "xlsb" | "xls" | "xlt" | "xla" | "xlam" | "xltm" | "csv" | "tsv" | "ods" | "fods" | "pages" | "numbers" | "key" | "wpd" | "wp" | "wp5" | "wp6" | "dbf" | "ofd" | "hwp" | "hwpx" | "typ" | "zip" | "zipx" | "7z" | "rar" | "tar" | "gz" | "gzip" | "tgz" | "bz2" | "bzip2" | "tbz" | "tbz2" | "xz" | "txz" | "lzma" | "zst" | "tzst" | "cab" | "ar" | "cpio" | "iso" | "xar" | "lha" | "lzh" | "jar" | "war" | "ear" | "apk" | "cbz" | "cbr" | "eml" | "msg" | "mbox" | "olb" | "dra" | "gds" | "oas" | "oasis" | "dxf" | "dwg" | "dwf" | "dwfx" | "xps" | "glb" | "gltf" | "obj" | "stl" | "ply" | "fbx" | "dae" | "3ds" | "3mf" | "amf" | "usd" | "usda" | "usdc" | "usdz" | "kmz" | "step" | "stp" | "iges" | "igs" | "ifc" | "3dm" | "brep" | "pcd" | "wrl" | "vrml" | "vtk" | "vtp" | "geojson" | "kml" | "gpx" | "shp" | "excalidraw" | "drawio" | "dio" | "mermaid" | "mmd" | "plantuml" | "puml" | "bpmn" | "xmind" | "epub" | "fb2" | "umd" | "gif" | "jpg" | "bmp" | "tiff" | "tif" | "avif" | "ico" | "heic" | "heif" | "jxl" | "dicom" | "dcm" | "p7m" | "p7s" | "p7c" | "p7b" | "pkcs7" | "cms" | "cmsc" | "tsd" | "tst" | "tsq" | "tsr" | "asics" | "scs" | "asice" | "sce" | "ers" | "asc" | "sig" | "pgp" | "gpg" | "jws" | "md" | "txt" | "lrc" | "json" | "mjs" | "cjs" | "css" | "java" | "py" | "htm" | "jsx" | "ts" | "tsx" | "xml" | "log" | "vue" | "yaml" | "yml" | "ini" | "sh" | "bash" | "sql" | "go" | "rs" | "php" | "c" | "cpp" | "cc" | "h" | "hpp" | "cs" | "diff" | "patch" | "bundle" | "bdl" | "jsonc" | "json5" | "ipynb" | "toml" | "proto" | "hcl" | "tex" | "gv" | "http" | "react" | "swift" | "kt" | "mp4" | "webm" | "m3u8" | "mp3" | "mpeg" | "wav" | "ogg" | "oga" | "opus" | "m4a" | "aac" | "flac" | "weba" | "midi" | "mid" | "psb" | "pdd" | "psdt" | "psd" | "ait" | "ai" | "idml" | "icml" | "idms" | "inx" | "xfl" | "indd" | "indt" | "ps" | "eps" | "ase" | "aco" | "abr" | "csh" | "pat" | "grd" | "asl" | "ttf" | "otf" | "woff" | "woff2" | "sqlite" | "parquet" | "avro" | "webarchive" | "bin" | "hex" | "elf" | "exe" | "dll" | "class" | "macho")[]];
 export declare const needsDedicatedPrintAdapter: (extension: string) => boolean;
 export declare const isDomPrintableExtension: (extension: string) => boolean;

package/dist/registry/capabilities.js

@@ -1,5 +1,5 @@
-import { ARCHIVE_EXTENSIONS, IMAGE_EXTENSIONS, MODEL_EXTENSIONS, TEXT_EXTENSIONS } from "./formats.js";
-import { normalizeFileExtension } from "../source/index.js";
+import { ARCHIVE_EXTENSIONS, IMAGE_EXTENSIONS, MODEL_EXTENSIONS, TEXT_EXTENSIONS } from './formats.js';
+import { normalizeFileExtension } from '../source/index.js';
 export const DEFAULT_OPERATION_AVAILABILITY = Object.freeze({
     download: false,
     print: false,
@@ -45,9 +45,19 @@ export const createUnsupportedAvailability = (extension) => ({
     ...DEFAULT_OPERATION_AVAILABILITY,
     download: normalizeFileExtension(extension).length > 0,
 });
+/**
+ * 这些格式只有专属适配器准备好后才展示打印。
+ *
+ * 它们的在线预览常依赖分页引擎、虚拟渲染或 Worker 生命周期，直接克隆
+ * DOM 很容易只得到当前页或当前视口。
+ */
 export const ADAPTER_PRINT_REQUIRED_EXTENSIONS = [
     'docx', 'docm', 'dotx', 'dotm', 'doc', 'dot', 'ppt', 'pdf', 'typ', 'typst',
 ];
+/**
+ * 这些格式的预览结果是完整 DOM / SVG / Canvas 截图，解除滚动容器裁切后
+ * 可以稳定进入浏览器打印流程。
+ */
 export const DOM_PRINTABLE_EXTENSIONS = [
     'pptx', 'pptm', 'potx', 'potm', 'ppsx', 'ppsm', 'ofd', 'dxf', 'dwg', 'dwf', 'dwfx', 'xps',
     'excalidraw', 'drawio', 'dio', 'mermaid', 'mmd', 'plantuml', 'puml', 'umd', 'md', 'markdown',
@@ -55,6 +65,9 @@ export const DOM_PRINTABLE_EXTENSIONS = [
     ...TEXT_EXTENSIONS,
     ...IMAGE_EXTENSIONS,
 ];
+/**
+ * 这些格式默认不展示打印按钮，避免导出半截内容。
+ */
 export const NON_PRINTABLE_EXTENSIONS = [
     'xlsx', 'xltx', 'xlsm', 'xlsb', 'xls', 'xlt', 'xltm', 'csv', 'tsv', 'ods', 'fods', 'numbers',
     ...ARCHIVE_EXTENSIONS,

package/dist/registry/formats.d.ts

@@ -1,4 +1,4 @@
-export { DEFAULT_REGISTERED_EXTENSIONS, DEFAULT_RENDERER_DEFINITIONS, DEFAULT_STABLE_SUPPORTED_EXTENSIONS, DEFAULT_SUPPORTED_EXTENSIONS, } from "./formats.generated.js";
+export { DEFAULT_REGISTERED_EXTENSIONS, DEFAULT_RENDERER_DEFINITIONS, DEFAULT_STABLE_SUPPORTED_EXTENSIONS, DEFAULT_SUPPORTED_EXTENSIONS, } from './formats.generated.js';
 export declare const ARCHIVE_EXTENSIONS: readonly ("markdown" | "webp" | "jpeg" | "png" | "pdf" | "xyz" | "wasm" | "chm" | "typst" | "xd" | "fla" | "js" | "html" | "svg" | "rb" | "docx" | "docm" | "dotx" | "dotm" | "doc" | "dot" | "ppt" | "pot" | "pptx" | "pptm" | "potx" | "potm" | "ppsx" | "ppsm" | "rtf" | "odt" | "odp" | "xlsx" | "xltx" | "xlsm" | "xlsb" | "xls" | "xlt" | "xla" | "xlam" | "xltm" | "csv" | "tsv" | "ods" | "fods" | "pages" | "numbers" | "key" | "wpd" | "wp" | "wp5" | "wp6" | "dbf" | "ofd" | "hwp" | "hwpx" | "typ" | "zip" | "zipx" | "7z" | "rar" | "tar" | "gz" | "gzip" | "tgz" | "bz2" | "bzip2" | "tbz" | "tbz2" | "xz" | "txz" | "lzma" | "zst" | "tzst" | "cab" | "ar" | "cpio" | "iso" | "xar" | "lha" | "lzh" | "jar" | "war" | "ear" | "apk" | "cbz" | "cbr" | "eml" | "msg" | "mbox" | "olb" | "dra" | "gds" | "oas" | "oasis" | "dxf" | "dwg" | "dwf" | "dwfx" | "xps" | "glb" | "gltf" | "obj" | "stl" | "ply" | "fbx" | "dae" | "3ds" | "3mf" | "amf" | "usd" | "usda" | "usdc" | "usdz" | "kmz" | "step" | "stp" | "iges" | "igs" | "ifc" | "3dm" | "brep" | "pcd" | "wrl" | "vrml" | "vtk" | "vtp" | "geojson" | "kml" | "gpx" | "shp" | "excalidraw" | "drawio" | "dio" | "mermaid" | "mmd" | "plantuml" | "puml" | "bpmn" | "xmind" | "epub" | "fb2" | "umd" | "gif" | "jpg" | "bmp" | "tiff" | "tif" | "avif" | "ico" | "heic" | "heif" | "jxl" | "dicom" | "dcm" | "p7m" | "p7s" | "p7c" | "p7b" | "pkcs7" | "cms" | "cmsc" | "tsd" | "tst" | "tsq" | "tsr" | "asics" | "scs" | "asice" | "sce" | "ers" | "asc" | "sig" | "pgp" | "gpg" | "jws" | "md" | "txt" | "lrc" | "json" | "mjs" | "cjs" | "css" | "java" | "py" | "htm" | "jsx" | "ts" | "tsx" | "xml" | "log" | "vue" | "yaml" | "yml" | "ini" | "sh" | "bash" | "sql" | "go" | "rs" | "php" | "c" | "cpp" | "cc" | "h" | "hpp" | "cs" | "diff" | "patch" | "bundle" | "bdl" | "jsonc" | "json5" | "ipynb" | "toml" | "proto" | "hcl" | "tex" | "gv" | "http" | "react" | "swift" | "kt" | "mp4" | "webm" | "m3u8" | "mp3" | "mpeg" | "wav" | "ogg" | "oga" | "opus" | "m4a" | "aac" | "flac" | "weba" | "midi" | "mid" | "psb" | "pdd" | "psdt" | "psd" | "ait" | "ai" | "idml" | "icml" | "idms" | "inx" | "xfl" | "indd" | "indt" | "ps" | "eps" | "ase" | "aco" | "abr" | "csh" | "pat" | "grd" | "asl" | "ttf" | "otf" | "woff" | "woff2" | "sqlite" | "parquet" | "avro" | "webarchive" | "bin" | "hex" | "elf" | "exe" | "dll" | "class" | "macho")[];
 export declare const MODEL_EXTENSIONS: readonly ("markdown" | "webp" | "jpeg" | "png" | "pdf" | "xyz" | "wasm" | "chm" | "typst" | "xd" | "fla" | "js" | "html" | "svg" | "rb" | "docx" | "docm" | "dotx" | "dotm" | "doc" | "dot" | "ppt" | "pot" | "pptx" | "pptm" | "potx" | "potm" | "ppsx" | "ppsm" | "rtf" | "odt" | "odp" | "xlsx" | "xltx" | "xlsm" | "xlsb" | "xls" | "xlt" | "xla" | "xlam" | "xltm" | "csv" | "tsv" | "ods" | "fods" | "pages" | "numbers" | "key" | "wpd" | "wp" | "wp5" | "wp6" | "dbf" | "ofd" | "hwp" | "hwpx" | "typ" | "zip" | "zipx" | "7z" | "rar" | "tar" | "gz" | "gzip" | "tgz" | "bz2" | "bzip2" | "tbz" | "tbz2" | "xz" | "txz" | "lzma" | "zst" | "tzst" | "cab" | "ar" | "cpio" | "iso" | "xar" | "lha" | "lzh" | "jar" | "war" | "ear" | "apk" | "cbz" | "cbr" | "eml" | "msg" | "mbox" | "olb" | "dra" | "gds" | "oas" | "oasis" | "dxf" | "dwg" | "dwf" | "dwfx" | "xps" | "glb" | "gltf" | "obj" | "stl" | "ply" | "fbx" | "dae" | "3ds" | "3mf" | "amf" | "usd" | "usda" | "usdc" | "usdz" | "kmz" | "step" | "stp" | "iges" | "igs" | "ifc" | "3dm" | "brep" | "pcd" | "wrl" | "vrml" | "vtk" | "vtp" | "geojson" | "kml" | "gpx" | "shp" | "excalidraw" | "drawio" | "dio" | "mermaid" | "mmd" | "plantuml" | "puml" | "bpmn" | "xmind" | "epub" | "fb2" | "umd" | "gif" | "jpg" | "bmp" | "tiff" | "tif" | "avif" | "ico" | "heic" | "heif" | "jxl" | "dicom" | "dcm" | "p7m" | "p7s" | "p7c" | "p7b" | "pkcs7" | "cms" | "cmsc" | "tsd" | "tst" | "tsq" | "tsr" | "asics" | "scs" | "asice" | "sce" | "ers" | "asc" | "sig" | "pgp" | "gpg" | "jws" | "md" | "txt" | "lrc" | "json" | "mjs" | "cjs" | "css" | "java" | "py" | "htm" | "jsx" | "ts" | "tsx" | "xml" | "log" | "vue" | "yaml" | "yml" | "ini" | "sh" | "bash" | "sql" | "go" | "rs" | "php" | "c" | "cpp" | "cc" | "h" | "hpp" | "cs" | "diff" | "patch" | "bundle" | "bdl" | "jsonc" | "json5" | "ipynb" | "toml" | "proto" | "hcl" | "tex" | "gv" | "http" | "react" | "swift" | "kt" | "mp4" | "webm" | "m3u8" | "mp3" | "mpeg" | "wav" | "ogg" | "oga" | "opus" | "m4a" | "aac" | "flac" | "weba" | "midi" | "mid" | "psb" | "pdd" | "psdt" | "psd" | "ait" | "ai" | "idml" | "icml" | "idms" | "inx" | "xfl" | "indd" | "indt" | "ps" | "eps" | "ase" | "aco" | "abr" | "csh" | "pat" | "grd" | "asl" | "ttf" | "otf" | "woff" | "woff2" | "sqlite" | "parquet" | "avro" | "webarchive" | "bin" | "hex" | "elf" | "exe" | "dll" | "class" | "macho")[];
 export declare const TEXT_EXTENSIONS: readonly ("markdown" | "webp" | "jpeg" | "png" | "pdf" | "xyz" | "wasm" | "chm" | "typst" | "xd" | "fla" | "js" | "html" | "svg" | "rb" | "docx" | "docm" | "dotx" | "dotm" | "doc" | "dot" | "ppt" | "pot" | "pptx" | "pptm" | "potx" | "potm" | "ppsx" | "ppsm" | "rtf" | "odt" | "odp" | "xlsx" | "xltx" | "xlsm" | "xlsb" | "xls" | "xlt" | "xla" | "xlam" | "xltm" | "csv" | "tsv" | "ods" | "fods" | "pages" | "numbers" | "key" | "wpd" | "wp" | "wp5" | "wp6" | "dbf" | "ofd" | "hwp" | "hwpx" | "typ" | "zip" | "zipx" | "7z" | "rar" | "tar" | "gz" | "gzip" | "tgz" | "bz2" | "bzip2" | "tbz" | "tbz2" | "xz" | "txz" | "lzma" | "zst" | "tzst" | "cab" | "ar" | "cpio" | "iso" | "xar" | "lha" | "lzh" | "jar" | "war" | "ear" | "apk" | "cbz" | "cbr" | "eml" | "msg" | "mbox" | "olb" | "dra" | "gds" | "oas" | "oasis" | "dxf" | "dwg" | "dwf" | "dwfx" | "xps" | "glb" | "gltf" | "obj" | "stl" | "ply" | "fbx" | "dae" | "3ds" | "3mf" | "amf" | "usd" | "usda" | "usdc" | "usdz" | "kmz" | "step" | "stp" | "iges" | "igs" | "ifc" | "3dm" | "brep" | "pcd" | "wrl" | "vrml" | "vtk" | "vtp" | "geojson" | "kml" | "gpx" | "shp" | "excalidraw" | "drawio" | "dio" | "mermaid" | "mmd" | "plantuml" | "puml" | "bpmn" | "xmind" | "epub" | "fb2" | "umd" | "gif" | "jpg" | "bmp" | "tiff" | "tif" | "avif" | "ico" | "heic" | "heif" | "jxl" | "dicom" | "dcm" | "p7m" | "p7s" | "p7c" | "p7b" | "pkcs7" | "cms" | "cmsc" | "tsd" | "tst" | "tsq" | "tsr" | "asics" | "scs" | "asice" | "sce" | "ers" | "asc" | "sig" | "pgp" | "gpg" | "jws" | "md" | "txt" | "lrc" | "json" | "mjs" | "cjs" | "css" | "java" | "py" | "htm" | "jsx" | "ts" | "tsx" | "xml" | "log" | "vue" | "yaml" | "yml" | "ini" | "sh" | "bash" | "sql" | "go" | "rs" | "php" | "c" | "cpp" | "cc" | "h" | "hpp" | "cs" | "diff" | "patch" | "bundle" | "bdl" | "jsonc" | "json5" | "ipynb" | "toml" | "proto" | "hcl" | "tex" | "gv" | "http" | "react" | "swift" | "kt" | "mp4" | "webm" | "m3u8" | "mp3" | "mpeg" | "wav" | "ogg" | "oga" | "opus" | "m4a" | "aac" | "flac" | "weba" | "midi" | "mid" | "psb" | "pdd" | "psdt" | "psd" | "ait" | "ai" | "idml" | "icml" | "idms" | "inx" | "xfl" | "indd" | "indt" | "ps" | "eps" | "ase" | "aco" | "abr" | "csh" | "pat" | "grd" | "asl" | "ttf" | "otf" | "woff" | "woff2" | "sqlite" | "parquet" | "avro" | "webarchive" | "bin" | "hex" | "elf" | "exe" | "dll" | "class" | "macho")[];

package/dist/registry/formats.generated.d.ts

@@ -900,4 +900,5 @@ export declare const DEFAULT_RENDERER_DEFINITIONS: readonly [{
 }];
 export declare const DEFAULT_REGISTERED_EXTENSIONS: readonly ("markdown" | "webp" | "jpeg" | "png" | "pdf" | "xyz" | "wasm" | "chm" | "typst" | "xd" | "fla" | "js" | "html" | "svg" | "rb" | "docx" | "docm" | "dotx" | "dotm" | "doc" | "dot" | "ppt" | "pot" | "pptx" | "pptm" | "potx" | "potm" | "ppsx" | "ppsm" | "rtf" | "odt" | "odp" | "xlsx" | "xltx" | "xlsm" | "xlsb" | "xls" | "xlt" | "xla" | "xlam" | "xltm" | "csv" | "tsv" | "ods" | "fods" | "pages" | "numbers" | "key" | "wpd" | "wp" | "wp5" | "wp6" | "dbf" | "ofd" | "hwp" | "hwpx" | "typ" | "zip" | "zipx" | "7z" | "rar" | "tar" | "gz" | "gzip" | "tgz" | "bz2" | "bzip2" | "tbz" | "tbz2" | "xz" | "txz" | "lzma" | "zst" | "tzst" | "cab" | "ar" | "cpio" | "iso" | "xar" | "lha" | "lzh" | "jar" | "war" | "ear" | "apk" | "cbz" | "cbr" | "eml" | "msg" | "mbox" | "olb" | "dra" | "gds" | "oas" | "oasis" | "dxf" | "dwg" | "dwf" | "dwfx" | "xps" | "glb" | "gltf" | "obj" | "stl" | "ply" | "fbx" | "dae" | "3ds" | "3mf" | "amf" | "usd" | "usda" | "usdc" | "usdz" | "kmz" | "step" | "stp" | "iges" | "igs" | "ifc" | "3dm" | "brep" | "pcd" | "wrl" | "vrml" | "vtk" | "vtp" | "geojson" | "kml" | "gpx" | "shp" | "excalidraw" | "drawio" | "dio" | "mermaid" | "mmd" | "plantuml" | "puml" | "bpmn" | "xmind" | "epub" | "fb2" | "umd" | "gif" | "jpg" | "bmp" | "tiff" | "tif" | "avif" | "ico" | "heic" | "heif" | "jxl" | "dicom" | "dcm" | "p7m" | "p7s" | "p7c" | "p7b" | "pkcs7" | "cms" | "cmsc" | "tsd" | "tst" | "tsq" | "tsr" | "asics" | "scs" | "asice" | "sce" | "ers" | "asc" | "sig" | "pgp" | "gpg" | "jws" | "md" | "txt" | "lrc" | "json" | "mjs" | "cjs" | "css" | "java" | "py" | "htm" | "jsx" | "ts" | "tsx" | "xml" | "log" | "vue" | "yaml" | "yml" | "ini" | "sh" | "bash" | "sql" | "go" | "rs" | "php" | "c" | "cpp" | "cc" | "h" | "hpp" | "cs" | "diff" | "patch" | "bundle" | "bdl" | "jsonc" | "json5" | "ipynb" | "toml" | "proto" | "hcl" | "tex" | "gv" | "http" | "react" | "swift" | "kt" | "mp4" | "webm" | "m3u8" | "mp3" | "mpeg" | "wav" | "ogg" | "oga" | "opus" | "m4a" | "aac" | "flac" | "weba" | "midi" | "mid" | "psb" | "pdd" | "psdt" | "psd" | "ait" | "ai" | "idml" | "icml" | "idms" | "inx" | "xfl" | "indd" | "indt" | "ps" | "eps" | "ase" | "aco" | "abr" | "csh" | "pat" | "grd" | "asl" | "ttf" | "otf" | "woff" | "woff2" | "sqlite" | "parquet" | "avro" | "webarchive" | "bin" | "hex" | "elf" | "exe" | "dll" | "class" | "macho")[];
 export declare const DEFAULT_STABLE_SUPPORTED_EXTENSIONS: readonly ("markdown" | "webp" | "jpeg" | "png" | "pdf" | "xyz" | "wasm" | "chm" | "typst" | "js" | "html" | "svg" | "rb" | "docx" | "docm" | "dotx" | "dotm" | "doc" | "dot" | "ppt" | "pot" | "pptx" | "pptm" | "potx" | "potm" | "ppsx" | "ppsm" | "rtf" | "odt" | "odp" | "xlsx" | "xltx" | "xlsm" | "xlsb" | "xls" | "xlt" | "xla" | "xlam" | "xltm" | "csv" | "tsv" | "ods" | "fods" | "pages" | "numbers" | "key" | "wpd" | "wp" | "wp5" | "wp6" | "dbf" | "ofd" | "hwp" | "hwpx" | "typ" | "zip" | "zipx" | "7z" | "rar" | "tar" | "gz" | "gzip" | "tgz" | "bz2" | "bzip2" | "tbz" | "tbz2" | "xz" | "txz" | "lzma" | "zst" | "tzst" | "cab" | "ar" | "cpio" | "iso" | "xar" | "lha" | "lzh" | "jar" | "war" | "ear" | "apk" | "cbz" | "cbr" | "eml" | "msg" | "mbox" | "olb" | "dra" | "gds" | "oas" | "oasis" | "dxf" | "dwg" | "dwf" | "dwfx" | "xps" | "glb" | "gltf" | "obj" | "stl" | "ply" | "fbx" | "dae" | "3ds" | "3mf" | "amf" | "usd" | "usda" | "usdc" | "usdz" | "kmz" | "step" | "stp" | "iges" | "igs" | "ifc" | "3dm" | "brep" | "pcd" | "wrl" | "vrml" | "vtk" | "vtp" | "geojson" | "kml" | "gpx" | "shp" | "excalidraw" | "drawio" | "dio" | "mermaid" | "mmd" | "plantuml" | "puml" | "xmind" | "epub" | "fb2" | "umd" | "gif" | "jpg" | "bmp" | "tiff" | "tif" | "avif" | "ico" | "heic" | "heif" | "jxl" | "md" | "txt" | "lrc" | "json" | "mjs" | "cjs" | "css" | "java" | "py" | "htm" | "jsx" | "ts" | "tsx" | "xml" | "log" | "vue" | "yaml" | "yml" | "ini" | "sh" | "bash" | "sql" | "go" | "rs" | "php" | "c" | "cpp" | "cc" | "h" | "hpp" | "cs" | "diff" | "patch" | "bundle" | "bdl" | "jsonc" | "json5" | "ipynb" | "toml" | "proto" | "hcl" | "tex" | "gv" | "http" | "react" | "swift" | "kt" | "mp4" | "webm" | "m3u8" | "mp3" | "mpeg" | "wav" | "ogg" | "oga" | "opus" | "m4a" | "aac" | "flac" | "weba" | "midi" | "mid" | "psd" | "ai" | "eps" | "ase" | "aco" | "ttf" | "otf" | "woff" | "woff2" | "sqlite" | "parquet" | "avro" | "webarchive")[];
+/** @deprecated Use DEFAULT_REGISTERED_EXTENSIONS when the experimental/stable distinction matters. */
 export declare const DEFAULT_SUPPORTED_EXTENSIONS: readonly ("markdown" | "webp" | "jpeg" | "png" | "pdf" | "xyz" | "wasm" | "chm" | "typst" | "xd" | "fla" | "js" | "html" | "svg" | "rb" | "docx" | "docm" | "dotx" | "dotm" | "doc" | "dot" | "ppt" | "pot" | "pptx" | "pptm" | "potx" | "potm" | "ppsx" | "ppsm" | "rtf" | "odt" | "odp" | "xlsx" | "xltx" | "xlsm" | "xlsb" | "xls" | "xlt" | "xla" | "xlam" | "xltm" | "csv" | "tsv" | "ods" | "fods" | "pages" | "numbers" | "key" | "wpd" | "wp" | "wp5" | "wp6" | "dbf" | "ofd" | "hwp" | "hwpx" | "typ" | "zip" | "zipx" | "7z" | "rar" | "tar" | "gz" | "gzip" | "tgz" | "bz2" | "bzip2" | "tbz" | "tbz2" | "xz" | "txz" | "lzma" | "zst" | "tzst" | "cab" | "ar" | "cpio" | "iso" | "xar" | "lha" | "lzh" | "jar" | "war" | "ear" | "apk" | "cbz" | "cbr" | "eml" | "msg" | "mbox" | "olb" | "dra" | "gds" | "oas" | "oasis" | "dxf" | "dwg" | "dwf" | "dwfx" | "xps" | "glb" | "gltf" | "obj" | "stl" | "ply" | "fbx" | "dae" | "3ds" | "3mf" | "amf" | "usd" | "usda" | "usdc" | "usdz" | "kmz" | "step" | "stp" | "iges" | "igs" | "ifc" | "3dm" | "brep" | "pcd" | "wrl" | "vrml" | "vtk" | "vtp" | "geojson" | "kml" | "gpx" | "shp" | "excalidraw" | "drawio" | "dio" | "mermaid" | "mmd" | "plantuml" | "puml" | "bpmn" | "xmind" | "epub" | "fb2" | "umd" | "gif" | "jpg" | "bmp" | "tiff" | "tif" | "avif" | "ico" | "heic" | "heif" | "jxl" | "dicom" | "dcm" | "p7m" | "p7s" | "p7c" | "p7b" | "pkcs7" | "cms" | "cmsc" | "tsd" | "tst" | "tsq" | "tsr" | "asics" | "scs" | "asice" | "sce" | "ers" | "asc" | "sig" | "pgp" | "gpg" | "jws" | "md" | "txt" | "lrc" | "json" | "mjs" | "cjs" | "css" | "java" | "py" | "htm" | "jsx" | "ts" | "tsx" | "xml" | "log" | "vue" | "yaml" | "yml" | "ini" | "sh" | "bash" | "sql" | "go" | "rs" | "php" | "c" | "cpp" | "cc" | "h" | "hpp" | "cs" | "diff" | "patch" | "bundle" | "bdl" | "jsonc" | "json5" | "ipynb" | "toml" | "proto" | "hcl" | "tex" | "gv" | "http" | "react" | "swift" | "kt" | "mp4" | "webm" | "m3u8" | "mp3" | "mpeg" | "wav" | "ogg" | "oga" | "opus" | "m4a" | "aac" | "flac" | "weba" | "midi" | "mid" | "psb" | "pdd" | "psdt" | "psd" | "ait" | "ai" | "idml" | "icml" | "idms" | "inx" | "xfl" | "indd" | "indt" | "ps" | "eps" | "ase" | "aco" | "abr" | "csh" | "pat" | "grd" | "asl" | "ttf" | "otf" | "woff" | "woff2" | "sqlite" | "parquet" | "avro" | "webarchive" | "bin" | "hex" | "elf" | "exe" | "dll" | "class" | "macho")[];

package/dist/registry/formats.generated.js

@@ -1656,4 +1656,5 @@ export const DEFAULT_REGISTERED_EXTENSIONS = Object.freeze(Array.from(new Set(DE
 export const DEFAULT_STABLE_SUPPORTED_EXTENSIONS = Object.freeze(Array.from(new Set(DEFAULT_RENDERER_DEFINITIONS
     .filter(definition => definition.status === 'stable')
     .flatMap(definition => definition.extensions))).sort());
+/** @deprecated Use DEFAULT_REGISTERED_EXTENSIONS when the experimental/stable distinction matters. */
 export const DEFAULT_SUPPORTED_EXTENSIONS = DEFAULT_REGISTERED_EXTENSIONS;

package/dist/registry/formats.js

@@ -1,5 +1,5 @@
-export { DEFAULT_REGISTERED_EXTENSIONS, DEFAULT_RENDERER_DEFINITIONS, DEFAULT_STABLE_SUPPORTED_EXTENSIONS, DEFAULT_SUPPORTED_EXTENSIONS, } from "./formats.generated.js";
-import { DEFAULT_RENDERER_DEFINITIONS } from "./formats.generated.js";
+export { DEFAULT_REGISTERED_EXTENSIONS, DEFAULT_RENDERER_DEFINITIONS, DEFAULT_STABLE_SUPPORTED_EXTENSIONS, DEFAULT_SUPPORTED_EXTENSIONS, } from './formats.generated.js';
+import { DEFAULT_RENDERER_DEFINITIONS } from './formats.generated.js';
 const extensionsFor = (rendererId) => {
     var _a, _b;
     return Object.freeze([...((_b = (_a = DEFAULT_RENDERER_DEFINITIONS.find(definition => definition.id === rendererId)) === null || _a === void 0 ? void 0 : _a.extensions) !== null && _b !== void 0 ? _b : [])]);

package/dist/registry/registry.d.ts

@@ -1,6 +1,13 @@
-import type { FileViewerRendererHandlerRegistration, FileViewerRendererPluginInput, FileViewerRendererPlugin, FileViewerRendererPresetInput, FileViewerRendererPresetName, RendererDefinition, RendererRegistry } from "../contracts/types.js";
+import type { FileViewerRendererHandlerRegistration, FileViewerRendererPluginInput, FileViewerRendererPlugin, FileViewerRendererPresetInput, FileViewerRendererPresetName, RendererDefinition, RendererRegistry } from '../contracts/types.js';
 export interface RegisterFileViewerAutoRendererPresetOptions {
+    /**
+     * Stable key used to replace an existing auto preset registration.
+     */
     id?: string;
+    /**
+     * Package name is useful for diagnostics and gives generated integrations a
+     * deterministic id even when the preset input is an array.
+     */
     packageName?: string;
 }
 export interface FileViewerAutoRendererPresetEntry<Handler = unknown> {
@@ -32,5 +39,12 @@ export declare const listFileViewerAutoRendererPresetEntries: <Handler = unknown
 export declare const findFileViewerAutoRendererPreset: <Handler = unknown>(id: FileViewerRendererPresetName | string) => FileViewerRendererPluginInput<Handler> | undefined;
 export declare const getFileViewerAutoRendererPresetVersion: () => number;
 export declare const hasFileViewerRendererPresetName: (input?: FileViewerRendererPresetInput | null) => boolean;
+/**
+ * Normalizes `options.preset` / `options.presets` into renderer plugin inputs.
+ *
+ * Passing a preset object is the most portable integration style because it
+ * works in any bundler. String selectors intentionally only resolve presets
+ * that are already registered by a side-effect import or by build tooling.
+ */
 export declare const resolveFileViewerRendererPresetInputs: <Handler = unknown>(input?: FileViewerRendererPresetInput<Handler> | null) => FileViewerRendererPluginInput<Handler>[];
 export declare const installFileViewerRendererPlugins: <Handler = unknown>({ registry, plugins, registerHandler, }: InstallFileViewerRendererPluginsOptions<Handler>) => Promise<RendererRegistry>;

package/dist/registry/registry.js

@@ -1,5 +1,5 @@
-import { DEFAULT_RENDERER_DEFINITIONS } from "./formats.js";
-import { getExtension, normalizeFileExtension, normalizeFilename } from "../source/index.js";
+import { DEFAULT_RENDERER_DEFINITIONS } from './formats.js';
+import { getExtension, normalizeFileExtension, normalizeFilename } from '../source/index.js';
 const autoRendererBucketKey = '__flyfish_file_viewer_auto_renderer_presets__';
 const getAutoRendererBucket = () => {
     const host = globalThis;
@@ -217,6 +217,7 @@ const createRendererDefinitionInstallPlan = (registry, definitions) => {
         ...regularDefinitions,
         ...enhancerDefinitions,
     ];
+    // Validate the complete ownership transition before mutating the caller's registry.
     const validationRegistry = createRendererRegistry(registry.list());
     plannedDefinitions.forEach(definition => validationRegistry.register(definition));
     return { definitions: plannedDefinitions };
@@ -327,6 +328,13 @@ export const hasFileViewerRendererPresetName = (input) => {
     }
     return false;
 };
+/**
+ * Normalizes `options.preset` / `options.presets` into renderer plugin inputs.
+ *
+ * Passing a preset object is the most portable integration style because it
+ * works in any bundler. String selectors intentionally only resolve presets
+ * that are already registered by a side-effect import or by build tooling.
+ */
 export const resolveFileViewerRendererPresetInputs = (input) => {
     if (!input) {
         return [];

package/dist/renderers/image.d.ts

@@ -1,2 +1,2 @@
-import type { FileRenderContext, FileViewerRenderedInstance } from "../contracts/types.js";
+import type { FileRenderContext, FileViewerRenderedInstance } from '../contracts/types.js';
 export default function renderImage(buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext): Promise<FileViewerRenderedInstance>;