@file-viewer/core 3.1.1 → 3.2.0

package/dist/contracts/xml.d.ts

@@ -0,0 +1,48 @@
+export interface FileViewerXmlProfile {
+    id: string;
+    match: {
+        rootNamespace?: {
+            enabled: boolean;
+            root?: string;
+            namespace?: string;
+        };
+        xsd?: {
+            enabled: boolean;
+        };
+    };
+    xsd?: string;
+    xslt: string;
+}
+export interface FileViewerXmlManifest {
+    profiles: FileViewerXmlProfile[];
+}
+export type FileViewerXmlDiagnosticCode = 'invalid-xml' | 'invalid-manifest' | 'resource-error' | 'unsafe-resource' | 'limit-exceeded' | 'timeout' | 'cancelled' | 'no-match' | 'ambiguous-profile' | 'root-mismatch' | 'xsd-invalid' | 'engine-error' | 'transform-error' | 'profile-selected' | 'capability-unavailable';
+export interface FileViewerXmlDiagnostic {
+    code: FileViewerXmlDiagnosticCode;
+    message: string;
+    profileId?: string;
+}
+export interface FileViewerXmlOptions {
+    profilesUrl?: string;
+    profiles?: FileViewerXmlProfile[];
+    baseUrl?: string;
+    runtime?: {
+        xsdWorkerUrl?: string;
+        xsltModuleUrl?: string;
+    };
+    timeoutMs?: number;
+    limits?: {
+        maxXmlBytes?: number;
+        maxResourceBytes?: number;
+        maxOutputBytes?: number;
+        maxProfiles?: number;
+        maxTotalResourceBytes?: number;
+    };
+    initialView?: 'source' | 'rendered';
+    labels?: {
+        viewSource?: string;
+        viewRendered?: string;
+        diagnostics?: string;
+    };
+    onDiagnostic?: (diagnostic: FileViewerXmlDiagnostic) => void;
+}

package/dist/contracts/xml.js

@@ -0,0 +1 @@
+export {};

package/dist/export.d.ts

@@ -1,10 +1,3 @@
-/**
- * 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';
+export { buildFileViewerRenderedDomDocument, buildFileViewerRenderedHtmlDocument, buildExportDomDocument, buildExportHtmlDocument, collectDocumentStyles, sanitizeFileViewerExportDocumentDom, sanitizeFileViewerExportDocumentHtml, } from "./exportDocument.js";
+export type { BuildExportHtmlDocumentOptions, BuildFileViewerRenderedHtmlDocumentOptions, } from "./exportDocument.js";
+export { inlineFileViewerBlobUrlsInHtml, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from "./output/export.js";

package/dist/export.js

@@ -1,9 +1,2 @@
-/**
- * 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';
+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

@@ -1,15 +1,5 @@
-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.
- */
+import type { FileRenderExportAdapter, FileRenderExportMode, FileViewerPrintMaskOptions } from "./contracts/types.js";
 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;
@@ -18,7 +8,6 @@ export interface BuildExportHtmlDocumentOptions {
     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;

package/dist/exportDocument.js

@@ -1,6 +1,6 @@
 import createDOMPurify from 'dompurify';
-import { applyFileViewerPagePrintMasksToHtml, buildFileViewerPrintMaskOverlayHtml, FILE_VIEWER_PRINT_MASK_STYLE, normalizeFileViewerPrintMaskOptions, } from './features/printMask.js';
-import { inlineFileViewerBlobUrlsInHtml, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, } from './output/export.js';
+import { applyFileViewerPagePrintMasksToHtml, buildFileViewerPrintMaskOverlayHtml, FILE_VIEWER_PRINT_MASK_STYLE, normalizeFileViewerPrintMaskOptions, } from "./features/printMask.js";
+import { inlineFileViewerBlobUrlsInHtml, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, } from "./output/export.js";
 const escapeHtmlAttribute = (value) => value
     .replace(/&/g, '&')
     .replace(/"/g, '"')
@@ -47,11 +47,6 @@ const decodeCssEscape = (value, slashIndex) => {
     }
     return { value: first, nextIndex: cursor + 1 };
 };
-/**
- * Remove CSS comments and decode identifier escapes before looking for URL
- * functions. CSS comments and escapes may otherwise split security-sensitive
- * tokens such as `url` or `@import` while the browser still accepts them.
- */
 const canonicalizeCssForSecurity = (css) => {
     let output = '';
     let quote = '';
@@ -246,12 +241,6 @@ const inspectCssNetworkTokens = (css) => {
     }
     return { hasImport, hasUrl };
 };
-/**
- * Keep ordinary CSS and local embedded resources, but remove every construct
- * that can make an exported document initiate a new network request. Imported
- * stylesheets fail closed; unsafe url() values become `none` so the rest of a
- * declaration can still render.
- */
 const sanitizeExportCss = (css) => {
     const canonical = canonicalizeCssForSecurity(css);
     const canonicalTokens = inspectCssNetworkTokens(canonical);
@@ -353,13 +342,9 @@ const getExportPurifier = (documentRef) => {
             element.setAttribute('rel', 'noopener noreferrer');
         }
         if (localName === 'a' || localName === 'area') {
-            // Keep ordinary links, but never preserve document-controlled beacons.
             element.removeAttribute('ping');
         }
         if (element.hasAttribute('srcset')) {
-            // Candidate lists have their own comma/descriptor grammar. The export
-            // keeps the materialized src and drops candidates that could select a
-            // remote resource after the standalone document is opened.
             element.removeAttribute('srcset');
         }
         if (['img', 'audio', 'video', 'source', 'track', 'input'].includes(localName || '')) {
@@ -392,19 +377,12 @@ const EXPORT_STATIC_META = [
     '<meta charset="utf-8" />',
     '<meta name="viewport" content="width=device-width,initial-scale=1" />',
 ].join('\n  ');
-/**
- * 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 const sanitizeFileViewerExportDocumentHtml = (html, documentRef) => {
     const currentDocument = resolveExportDocument(documentRef);
     const purifier = currentDocument
         ? getExportPurifier(currentDocument)
         : null;
     if (!purifier) {
-        // Export is a browser feature. Fail closed rather than return executable
-        // markup when called without a usable DOM implementation.
         return '<!doctype html>\n<html lang="en"><head><meta charset="utf-8" /></head><body></body></html>';
     }
     const sanitized = String(purifier.sanitize(html, EXPORT_SANITIZER_OPTIONS));
@@ -439,11 +417,6 @@ const ensureFileViewerExportDocumentMeta = (root) => {
     }
     return root;
 };
-/**
- * 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 const sanitizeFileViewerExportDocumentDom = (html, documentRef) => {
     const currentDocument = resolveExportDocument(documentRef);
     if (!currentDocument) {
@@ -728,6 +701,11 @@ const EXPORT_DOCUMENT_STYLE = `
       overflow: visible;
       background: #ffffff;
     }
+    .viewer-export-content .docx-print-document {
+      width: auto !important;
+      max-width: none !important;
+      margin: 0 !important;
+    }
     .viewer-export-content .pdf-export-document {
       display: block;
       padding: 0;
@@ -801,8 +779,6 @@ export const collectDocumentStyles = (documentRef) => {
                 : '';
         }
         catch {
-            // Cross-origin and unreadable stylesheets fail closed. Keeping their
-            // link would make a standalone export initiate a second request.
             return '';
         }
     })

package/dist/features/document/dom/anchors.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerDocumentAnchor } from '../../../contracts/types';
+import type { FileViewerDocumentAnchor } from "../../../contracts/types.js";
 export declare const DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR: string;
 export declare const DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR: string;
 export declare const collectFileViewerDocumentAnchors: (root: HTMLElement | null) => FileViewerDocumentAnchor[];

package/dist/features/document/dom/index.d.ts

@@ -1,5 +1,5 @@
-export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, getCurrentFileViewerDocumentAnchor, scrollToFileViewerDocumentAnchor, } from './anchors';
-export { findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from './providers';
-export type { FileViewerSearchProviderHost, FileViewerViewStateProviderHost, FileViewerZoomProviderHost, } from './providers';
-export { DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, getFileViewerScrollableRange, isFileViewerScrollableElement, resolveFileViewerScrollContainer, } from './scroll';
-export type { ResolveFileViewerScrollContainerOptions, } from './scroll';
+export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, getCurrentFileViewerDocumentAnchor, scrollToFileViewerDocumentAnchor, } from "./anchors.js";
+export { findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from "./providers.js";
+export type { FileViewerSearchProviderHost, FileViewerViewStateProviderHost, FileViewerZoomProviderHost, } from "./providers.js";
+export { DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, getFileViewerScrollableRange, isFileViewerScrollableElement, resolveFileViewerScrollContainer, } from "./scroll.js";
+export type { ResolveFileViewerScrollContainerOptions, } from "./scroll.js";

package/dist/features/document/dom/index.js

@@ -1,3 +1,3 @@
-export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, getCurrentFileViewerDocumentAnchor, scrollToFileViewerDocumentAnchor, } from './anchors.js';
-export { findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from './providers.js';
-export { DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, getFileViewerScrollableRange, isFileViewerScrollableElement, resolveFileViewerScrollContainer, } from './scroll.js';
+export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, getCurrentFileViewerDocumentAnchor, scrollToFileViewerDocumentAnchor, } from "./anchors.js";
+export { findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from "./providers.js";
+export { DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, getFileViewerScrollableRange, isFileViewerScrollableElement, resolveFileViewerScrollContainer, } from "./scroll.js";

package/dist/features/document/dom/providers.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerSearchProvider, FileViewerViewStateProvider, FileViewerZoomProvider } from '../../../contracts/types';
+import type { FileViewerSearchProvider, FileViewerViewStateProvider, FileViewerZoomProvider } from "../../../contracts/types.js";
 export interface FileViewerSearchProviderHost extends HTMLElement {
     __flyfishViewerSearchProvider?: FileViewerSearchProvider;
 }

package/dist/features/document/events.d.ts

@@ -1,5 +1,5 @@
-import { type FileViewerDomSearchControllerStateTarget } from './search';
-import type { FileViewerAiOptions, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerSearchOptions, FileViewerSearchState } from '../../contracts/types';
+import { type FileViewerDomSearchControllerStateTarget } from "./search.js";
+import type { FileViewerAiOptions, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerSearchOptions, FileViewerSearchState } from "../../contracts/types.js";
 export interface ResolveFileViewerLocationChangeAnchorInput {
     root: HTMLElement | null | undefined;
     anchors: FileViewerDocumentAnchor[];

package/dist/features/document/events.js

@@ -1,6 +1,6 @@
-import { buildFileViewerDocumentTextChunks } from './model.js';
-import { getCurrentFileViewerDocumentAnchor, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, } from './dom/index.js';
-import { cloneFileViewerSearchState, createFileViewerDomSearchController, createFileViewerDomSearchControllerActionHandlers, } from './search.js';
+import { buildFileViewerDocumentTextChunks } from "./model.js";
+import { getCurrentFileViewerDocumentAnchor, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, } from "./dom/index.js";
+import { cloneFileViewerSearchState, createFileViewerDomSearchController, createFileViewerDomSearchControllerActionHandlers, } from "./search.js";
 export const createFileViewerSearchChangeState = (state) => {
     return cloneFileViewerSearchState(state);
 };

package/dist/features/document/fit.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerViewState, FileViewerViewStateChangeSource } from '../../contracts/types';
+import type { FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerViewState, FileViewerViewStateChangeSource } from "../../contracts/types.js";
 export declare const FILE_VIEWER_FIT_MODES: readonly ["auto", "contain", "cover", "width", "height", "actual", "scale-down"];
 export declare const FILE_VIEWER_FIT_RESIZE_MODES: readonly ["until-interaction", "always", "initial"];
 export interface NormalizedFileViewerFitOptions extends Required<Pick<FileViewerFitOptions, 'mode' | 'resize' | 'padding'>> {

package/dist/features/document/fit.js

@@ -1,4 +1,4 @@
-import { findFileViewerViewStateProvider, findFileViewerZoomProvider, } from './dom/index.js';
+import { findFileViewerViewStateProvider, findFileViewerZoomProvider, } from "./dom/index.js";
 export const FILE_VIEWER_FIT_MODES = [
     'auto',
     'contain',

package/dist/features/document/model.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerAiOptions, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerSearchOptions, FileViewerSearchState, FileViewerZoomState } from '../../contracts/types';
+import type { FileViewerAiOptions, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerSearchOptions, FileViewerSearchState, FileViewerZoomState } from "../../contracts/types.js";
 export declare const DEFAULT_FILE_VIEWER_ZOOM_SCALE = 1;
 export declare const DEFAULT_FILE_VIEWER_TEXT_CHUNK_SIZE = 1200;
 export declare const DEFAULT_FILE_VIEWER_TEXT_CHUNK_OVERLAP = 160;

package/dist/features/document/search.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerDocumentAnchor, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchState } from '../../contracts/types';
+import type { FileViewerDocumentAnchor, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchState } from "../../contracts/types.js";
 export interface CreateFileViewerDomSearchControllerOptions {
     root: () => HTMLElement | null | undefined;
     options?: () => boolean | FileViewerSearchOptions | undefined;

package/dist/features/document/search.js

@@ -1,5 +1,5 @@
-import { collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, } from './dom/index.js';
-import { createEmptyFileViewerSearchState, normalizeFileViewerSearchOptions, } from './model.js';
+import { collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, } from "./dom/index.js";
+import { createEmptyFileViewerSearchState, normalizeFileViewerSearchOptions, } from "./model.js";
 export const DEFAULT_FILE_VIEWER_SEARCH_MATCH_CLASS = 'flyfish-search-match';
 export const DEFAULT_FILE_VIEWER_SEARCH_ACTIVE_CLASS = 'flyfish-search-match--active';
 export const DEFAULT_FILE_VIEWER_SEARCH_MAX_MATCHES = 1000;

package/dist/features/document/viewState.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerApplyViewStateOptions, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateProvider } from '../../contracts/types';
+import type { FileViewerApplyViewStateOptions, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateProvider } from "../../contracts/types.js";
 export interface RegisterFileViewerGenericViewStateProviderOptions {
     host: HTMLElement;
     renderer?: string;

package/dist/features/document/viewState.js

@@ -1,5 +1,5 @@
-import { findFileViewerViewStateProvider, findFileViewerZoomProvider, registerFileViewerViewStateProvider, resolveFileViewerScrollContainer, unregisterFileViewerViewStateProvider, } from './dom/index.js';
-import { resolveFileViewerFitScale } from './fit.js';
+import { findFileViewerViewStateProvider, findFileViewerZoomProvider, registerFileViewerViewStateProvider, resolveFileViewerScrollContainer, unregisterFileViewerViewStateProvider, } from "./dom/index.js";
+import { resolveFileViewerFitScale } from "./fit.js";
 export const cloneFileViewerViewState = (state) => {
     if (!state) {
         return null;

package/dist/features/document/zoom.d.ts

@@ -1,8 +1,9 @@
-import type { FileViewerOperationType, FileViewerZoomProvider, FileViewerZoomState } from '../../contracts/types';
+import type { FileViewerOptions, FileViewerOperationType, FileViewerZoomProvider, FileViewerZoomState } from "../../contracts/types.js";
 export type FileViewerZoomOperation = Extract<FileViewerOperationType, 'zoom-in' | 'zoom-out' | 'zoom-reset'>;
 export interface CreateFileViewerZoomControllerOptions {
     root: () => HTMLElement | null | undefined;
     enabled?: () => boolean;
+    gestures?: () => FileViewerOptions['zoomGestures'];
     beforeZoom?: (operation: FileViewerZoomOperation) => Promise<boolean> | boolean;
     onChange?: (state: FileViewerZoomState) => void;
 }
@@ -46,4 +47,4 @@ export declare const createFileViewerZoomChangeEmitter: () => {
     subscribe(listener: () => void): () => void;
     clear(): void;
 };
-export declare const createFileViewerZoomController: ({ root, enabled, beforeZoom, onChange, }: CreateFileViewerZoomControllerOptions) => FileViewerZoomController;
+export declare const createFileViewerZoomController: ({ root, enabled, gestures, beforeZoom, onChange, }: CreateFileViewerZoomControllerOptions) => FileViewerZoomController;

package/dist/features/document/zoom.js

@@ -1,5 +1,6 @@
-import { createFileViewerZoomState } from './model.js';
-import { findFileViewerZoomProvider } from './dom/index.js';
+import { createFileViewerZoomState } from "./model.js";
+import { findFileViewerZoomProvider } from "./dom/index.js";
+import { installFileViewerZoomGestures } from "./zoomGestures.js";
 export const cloneFileViewerZoomState = (state) => ({
     scale: state.scale,
     label: state.label,
@@ -102,10 +103,11 @@ const getMutationObserverConstructor = (root) => {
     return ((_b = (_a = root === null || root === void 0 ? void 0 : root.ownerDocument) === null || _a === void 0 ? void 0 : _a.defaultView) === null || _b === void 0 ? void 0 : _b.MutationObserver) ||
         (typeof MutationObserver !== 'undefined' ? MutationObserver : undefined);
 };
-export const createFileViewerZoomController = ({ root, enabled, beforeZoom, onChange, }) => {
+export const createFileViewerZoomController = ({ root, enabled, gestures, beforeZoom, onChange, }) => {
     let provider = null;
     let unsubscribe = null;
     let observer = null;
+    let disposeGestures = null;
     let runningAction = false;
     const state = createFileViewerZoomState();
     const notifyChange = () => {
@@ -140,6 +142,8 @@ export const createFileViewerZoomController = ({ root, enabled, beforeZoom, onCh
     const disconnectObserver = () => {
         observer === null || observer === void 0 ? void 0 : observer.disconnect();
         observer = null;
+        disposeGestures === null || disposeGestures === void 0 ? void 0 : disposeGestures();
+        disposeGestures = null;
     };
     const runZoomAction = async (operation, action) => {
         const nextProvider = syncProvider();
@@ -171,6 +175,18 @@ export const createFileViewerZoomController = ({ root, enabled, beforeZoom, onCh
         observe() {
             disconnectObserver();
             const currentRoot = root();
+            if (currentRoot) {
+                disposeGestures = installFileViewerZoomGestures(currentRoot, {
+                    provider: syncProvider,
+                    enabled: () => (enabled === null || enabled === void 0 ? void 0 : enabled()) !== false,
+                    settings: () => gestures === null || gestures === void 0 ? void 0 : gestures(),
+                    beforeZoom: operation => { var _a; return (_a = beforeZoom === null || beforeZoom === void 0 ? void 0 : beforeZoom(operation)) !== null && _a !== void 0 ? _a : true; },
+                    onZoom: () => {
+                        syncProvider();
+                        notifyChange();
+                    },
+                });
+            }
             const MutationObserverCtor = getMutationObserverConstructor(currentRoot);
             if (!currentRoot || !MutationObserverCtor) {
                 syncProvider();

package/dist/features/document/zoomGestures.d.ts

@@ -0,0 +1,11 @@
+import type { FileViewerOptions, FileViewerZoomProvider } from "../../contracts/types.js";
+import type { FileViewerZoomOperation } from "./zoom.js";
+interface ZoomGestureOptions {
+    provider: () => FileViewerZoomProvider | null;
+    enabled: () => boolean;
+    settings: () => FileViewerOptions['zoomGestures'];
+    beforeZoom: (operation: FileViewerZoomOperation) => boolean | Promise<boolean>;
+    onZoom: () => void;
+}
+export declare function installFileViewerZoomGestures(container: HTMLElement, options: ZoomGestureOptions): () => void;
+export {};

package/dist/features/document/zoomGestures.js

@@ -0,0 +1,111 @@
+export function installFileViewerZoomGestures(container, options) {
+    const view = container.ownerDocument.defaultView;
+    if (!view)
+        return () => { };
+    let disposed = false;
+    let frame = 0;
+    let busy = false;
+    let pending = null;
+    let pendingProvider = null;
+    let pinch = null;
+    const allowed = (kind) => {
+        const settings = options.settings();
+        return settings !== false &&
+            (typeof settings !== 'object' || settings[kind] !== false) && options.enabled();
+    };
+    const interactive = (event) => event.composedPath().some(target => target instanceof view.Element && target.matches('button,a[href],input,textarea,select,[contenteditable]:not([contenteditable="false"])'));
+    const clamp = (scale, provider) => {
+        var _a, _b;
+        const state = provider.getState();
+        return Math.min((_a = state.maxScale) !== null && _a !== void 0 ? _a : 4, Math.max((_b = state.minScale) !== null && _b !== void 0 ? _b : 0.1, scale));
+    };
+    const schedule = () => {
+        if (!disposed && !busy && !frame && pending !== null) {
+            frame = view.requestAnimationFrame(() => { frame = 0; void flush(); });
+        }
+    };
+    const flush = async () => {
+        const scale = pending;
+        const provider = pendingProvider;
+        pending = null;
+        pendingProvider = null;
+        if (disposed || !options.enabled() || scale === null || !(provider === null || provider === void 0 ? void 0 : provider.setZoom) ||
+            provider !== options.provider())
+            return;
+        const operation = scale >= provider.getState().scale ? 'zoom-in' : 'zoom-out';
+        busy = true;
+        try {
+            if (!await options.beforeZoom(operation) || disposed || !options.enabled() ||
+                provider !== options.provider())
+                return;
+            await provider.setZoom(clamp(scale, provider));
+            if (!disposed && provider === options.provider())
+                options.onZoom();
+        }
+        catch {
+        }
+        finally {
+            busy = false;
+            schedule();
+        }
+    };
+    const queue = (scale, provider) => {
+        pending = clamp(scale, provider);
+        pendingProvider = provider;
+        schedule();
+    };
+    const wheel = (event) => {
+        if (event.defaultPrevented || !allowed('wheel') || !(event.ctrlKey || event.metaKey) ||
+            interactive(event) || !Number.isFinite(event.deltaY) || event.deltaY === 0)
+            return;
+        const provider = options.provider();
+        if (!(provider === null || provider === void 0 ? void 0 : provider.setZoom))
+            return;
+        const unit = event.deltaMode === 1 ? 16 : event.deltaMode === 2 ? Math.max(1, container.clientHeight) : 1;
+        const start = pendingProvider === provider && pending !== null ? pending : provider.getState().scale;
+        queue(start * Math.exp(-Math.max(-1000, Math.min(1000, event.deltaY * unit)) * 0.002), provider);
+        event.preventDefault();
+    };
+    const distance = (touches) => Math.hypot(touches[0].clientX - touches[1].clientX, touches[0].clientY - touches[1].clientY);
+    const start = (event) => {
+        if (event.defaultPrevented || event.touches.length !== 2 || !allowed('pinch') || interactive(event))
+            return;
+        const provider = options.provider();
+        const d = distance(event.touches);
+        if (!(provider === null || provider === void 0 ? void 0 : provider.setZoom) || !Number.isFinite(d) || d <= 0)
+            return;
+        pinch = { distance: d, scale: provider.getState().scale, provider };
+        event.preventDefault();
+    };
+    const move = (event) => {
+        if (!pinch || event.touches.length !== 2 || !allowed('pinch') || pinch.provider !== options.provider()) {
+            pinch = null;
+            return;
+        }
+        const d = distance(event.touches);
+        if (!Number.isFinite(d) || d <= 0)
+            return;
+        queue(pinch.scale * d / pinch.distance, pinch.provider);
+        event.preventDefault();
+    };
+    const end = (event) => { if (event.touches.length !== 2)
+        pinch = null; };
+    container.addEventListener('wheel', wheel, { passive: false });
+    container.addEventListener('touchstart', start, { passive: false });
+    container.addEventListener('touchmove', move, { passive: false });
+    container.addEventListener('touchend', end);
+    container.addEventListener('touchcancel', end);
+    return () => {
+        disposed = true;
+        pending = null;
+        pendingProvider = null;
+        pinch = null;
+        if (frame)
+            view.cancelAnimationFrame(frame);
+        container.removeEventListener('wheel', wheel);
+        container.removeEventListener('touchstart', start);
+        container.removeEventListener('touchmove', move);
+        container.removeEventListener('touchend', end);
+        container.removeEventListener('touchcancel', end);
+    };
+}

package/dist/features/printMask.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintStamp } from '../contracts/types';
+import type { FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintStamp } from "../contracts/types.js";
 export declare const normalizeFileViewerPrintMaskRegion: (region: Partial<FileViewerPrintMaskRegion> | null | undefined) => FileViewerPrintMaskRegion | null;
 export declare const normalizeFileViewerPrintStamp: (stamp: Partial<FileViewerPrintStamp> | null | undefined) => FileViewerPrintStamp | null;
 export declare const normalizeFileViewerPrintMaskOptions: (mask?: FileViewerPrintMaskOptions | null) => FileViewerPrintMaskOptions | null;

package/dist/features/printMaskDesigner.d.ts

@@ -1,5 +1,5 @@
-import type { FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintStamp } from '../contracts/types';
-import { type FileViewerI18nInput } from '../i18n/messages';
+import type { FileViewerPrintMaskOptions, FileViewerPrintMaskRegion, FileViewerPrintStamp } from "../contracts/types.js";
+import { type FileViewerI18nInput } from "../i18n/messages.js";
 export interface OpenFileViewerPrintMaskDesignerOptions {
     root: HTMLElement;
     pages?: readonly HTMLElement[];
@@ -11,8 +11,4 @@ export interface OpenFileViewerPrintMaskDesignerOptions {
 export interface FileViewerPrintMaskDesignerResult {
     mask: FileViewerPrintMaskOptions;
 }
-/**
- * Opens a page-aware print-mask designer. Browsing remains the default mode;
- * drawing is armed for the currently visible page only and disarms after one block.
- */
 export declare const openFileViewerPrintMaskDesigner: (options: OpenFileViewerPrintMaskDesignerOptions) => Promise<FileViewerPrintMaskDesignerResult | null>;

package/dist/features/printMaskDesigner.js

@@ -1,5 +1,5 @@
-import { createFileViewerTranslator } from '../i18n/messages.js';
-import { normalizeFileViewerPrintMaskRegion, normalizeFileViewerPrintStamp, } from './printMask.js';
+import { createFileViewerTranslator } from "../i18n/messages.js";
+import { normalizeFileViewerPrintMaskRegion, normalizeFileViewerPrintStamp, } from "./printMask.js";
 const DESIGNER_STYLE = `
 .fv-print-mask-layer{position:absolute;inset:0;z-index:2147483000;pointer-events:none;}
 .fv-print-mask-canvas{position:absolute;inset:0;z-index:2147483000;pointer-events:none;cursor:default;}
@@ -74,10 +74,6 @@ const readStampFileAsDataUrl = (file, windowRef) => new Promise((resolve, reject
     reader.addEventListener('error', () => reject(reader.error || new Error('Failed to read print stamp image')));
     reader.readAsDataURL(file);
 });
-/**
- * Opens a page-aware print-mask designer. Browsing remains the default mode;
- * drawing is armed for the currently visible page only and disarms after one block.
- */
 export const openFileViewerPrintMaskDesigner = (options) => {
     const root = options.root;
     const documentRef = root.ownerDocument;
@@ -105,8 +101,6 @@ export const openFileViewerPrintMaskDesigner = (options) => {
         }
         return previousPosition;
     };
-    // The toolbar layer is positioned against the viewer root even when page
-    // canvases live on child page elements.
     const previousRootPosition = ensureOverlayContainingBlock(root);
     return new Promise(resolve => {
         let settled = false;
@@ -316,7 +310,6 @@ export const openFileViewerPrintMaskDesigner = (options) => {
                         (_a = stampElement.releasePointerCapture) === null || _a === void 0 ? void 0 : _a.call(stampElement, interaction.pointerId);
                     }
                     catch {
-                        // Pointer capture may already be released by the browser.
                     }
                     interaction = null;
                 };
@@ -371,7 +364,6 @@ export const openFileViewerPrintMaskDesigner = (options) => {
                     surface.canvas.releasePointerCapture(drawing.pointerId);
                 }
                 catch {
-                    // Pointer capture may already be released by the browser.
                 }
                 drawing = null;
                 disarm();
@@ -435,7 +427,6 @@ export const openFileViewerPrintMaskDesigner = (options) => {
                 }
             }
             catch {
-                // Unsupported or unreadable images are ignored; the document stays untouched.
             }
         });
         clearButton.addEventListener('click', () => {

package/dist/features/printMaskLoader.d.ts

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

package/dist/features/printMaskLoader.js

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

package/dist/features/watermark.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerWatermarkOptions } from '../contracts/types';
+import type { FileViewerWatermarkOptions } from "../contracts/types.js";
 export type FileViewerWatermarkStyle = Record<string, string> & {
     backgroundImage: string;
 };