@file-viewer/core 2.1.13 → 2.1.14

package/dist/contracts/types.d.ts

@@ -78,6 +78,11 @@ export interface FileViewerPdfOptions {
     defaultNavigationVisible?: boolean;
     thumbnails?: boolean;
     rotation?: number;
+    /**
+     * Initial PDF view position. Prefer the top-level `initialViewState` when the
+     * same state should be passed through framework-neutral viewer APIs.
+     */
+    initialViewState?: FileViewerViewState;
     streaming?: boolean | 'same-origin';
     rangeChunkSize?: number;
     withCredentials?: boolean;
@@ -106,13 +111,19 @@ export interface FileViewerDocxOptions {
     ignoreLastRenderedPageBreak?: boolean;
 }
 export interface FileViewerSpreadsheetOptions {
-    worker?: boolean;
+    worker?: boolean | 'auto';
     workerUrl?: string;
+    /** `worker: 'auto'` 时，大于该字节数的表格自动使用静态 Worker，默认 1MB。 */
+    workerAutoThreshold?: number;
     /** 允许用户在 Excel / CSV / ODS 预览中拖拽表头边界调整列宽，默认关闭以保持历史行为。 */
     resizableColumns?: boolean;
     /** 允许用户在 Excel / CSV / ODS 预览中拖拽行头边界调整行高，默认关闭以保持历史行为。 */
     resizableRows?: boolean;
 }
+export interface FileViewerPresentationOptions {
+    workerUrl?: string | URL;
+    workerType?: WorkerType;
+}
 export type FileRenderExportMode = 'export' | 'print';
 export interface FileRenderExportOptions {
     mode: FileRenderExportMode;
@@ -387,9 +398,19 @@ export interface FileViewerOptions {
     toolbar?: boolean | FileViewerToolbarOptions;
     search?: boolean | FileViewerSearchOptions;
     ai?: boolean | FileViewerAiOptions;
+    /**
+     * Initial renderer view position used after the document becomes ready.
+     *
+     * Renderers apply the fields they understand. All standard renderer paths
+     * expose at least renderer / zoom / scroll snapshots through the generic
+     * provider; high-interaction renderers such as PDF, XMind, Geo, 3D, and CAD
+     * add page, navigation, canvas, map, camera, or native view details.
+     */
+    initialViewState?: FileViewerViewState;
     archive?: FileViewerArchiveOptions;
     pdf?: FileViewerPdfOptions;
     docx?: FileViewerDocxOptions;
+    presentation?: FileViewerPresentationOptions;
     spreadsheet?: FileViewerSpreadsheetOptions;
     typst?: FileViewerTypstOptions;
     geo?: FileViewerGeoOptions;
@@ -465,6 +486,49 @@ export interface FileViewerZoomProvider {
     getState: () => FileViewerZoomState;
     subscribe?: (listener: () => void) => () => void;
 }
+export interface FileViewerViewScrollState {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+    clientWidth: number;
+    clientHeight: number;
+    topRatio: number;
+    leftRatio: number;
+}
+export interface FileViewerNavigationState {
+    visible?: boolean;
+    mode?: string;
+}
+export interface FileViewerViewState {
+    renderer?: string;
+    page?: number;
+    pageCount?: number;
+    scale?: number;
+    zoom?: FileViewerZoomState;
+    rotation?: number;
+    scroll?: Partial<FileViewerViewScrollState>;
+    navigation?: FileViewerNavigationState;
+    extra?: Record<string, unknown>;
+}
+export type FileViewerViewStateChangeSource = 'initial' | 'api' | 'user' | 'viewer' | (string & {});
+export type FileViewerViewStateChangeAction = 'init' | 'restore' | 'page-change' | 'page-click' | 'page-step' | 'outline-click' | 'zoom-change' | 'zoom-in' | 'zoom-out' | 'zoom-reset' | 'rotation-change' | 'rotate-left' | 'rotate-right' | 'scroll' | 'navigation-toggle' | 'navigation-mode-change' | (string & {});
+export interface FileViewerViewStateChange {
+    state: FileViewerViewState;
+    action: FileViewerViewStateChangeAction;
+    source: FileViewerViewStateChangeSource;
+    timestamp: number;
+}
+export interface FileViewerApplyViewStateOptions {
+    notify?: boolean;
+    action?: FileViewerViewStateChangeAction;
+    source?: FileViewerViewStateChangeSource;
+}
+export interface FileViewerViewStateProvider {
+    getState: () => FileViewerViewState;
+    applyState?: (state: FileViewerViewState, options?: FileViewerApplyViewStateOptions) => FileViewerViewState | Promise<FileViewerViewState>;
+    subscribe?: (listener: (change: FileViewerViewStateChange) => void) => () => void;
+}
 export interface FileViewerSearchMatch {
     id: string;
     index: number;
@@ -523,6 +587,7 @@ export interface FileViewerComponentEventMap {
     'search-change': FileViewerSearchState;
     'location-change': FileViewerDocumentAnchor | null;
     'zoom-change': FileViewerZoomState;
+    'view-state-change': FileViewerViewStateChange;
 }
 export type FileViewerEventType = keyof FileViewerComponentEventMap;
 export type FileViewerEvent = {
@@ -543,6 +608,7 @@ export interface FileViewerComponentEmits {
     (event: 'search-change', state: FileViewerComponentEventMap['search-change']): void;
     (event: 'location-change', anchor: FileViewerComponentEventMap['location-change']): void;
     (event: 'zoom-change', state: FileViewerComponentEventMap['zoom-change']): void;
+    (event: 'view-state-change', change: FileViewerComponentEventMap['view-state-change']): void;
 }
 export interface FileViewerPublicApi {
     downloadOriginalFile(): Promise<void>;
@@ -552,6 +618,8 @@ export interface FileViewerPublicApi {
     zoomOut(): Promise<FileViewerZoomState>;
     resetZoom(): Promise<FileViewerZoomState>;
     getZoomState(): FileViewerZoomState;
+    getViewState(): FileViewerViewState | null;
+    applyViewState(state: FileViewerViewState, options?: FileViewerApplyViewStateOptions): Promise<FileViewerViewState | null>;
     getOperationAvailability(): FileViewerOperationAvailability;
     getScrollContainer(): HTMLElement | null;
     searchDocument(query: string): Promise<FileViewerSearchState>;
@@ -695,6 +763,8 @@ export interface FileViewerInstance {
     zoomOut(): Promise<FileViewerZoomState>;
     resetZoom(): Promise<FileViewerZoomState>;
     getZoomState(): FileViewerZoomState;
+    getViewState(): FileViewerViewState | null;
+    applyViewState(state: FileViewerViewState, options?: FileViewerApplyViewStateOptions): Promise<FileViewerViewState | null>;
     search(query: string): Promise<FileViewerSearchState>;
     nextSearchResult(): Promise<FileViewerSearchState>;
     previousSearchResult(): Promise<FileViewerSearchState>;

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, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from './providers';
-export type { FileViewerSearchProviderHost, FileViewerZoomProviderHost, } from './providers';
+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';

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, findFileViewerZoomProvider, registerFileViewerSearchProvider, registerFileViewerZoomProvider, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from './providers.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,13 +1,19 @@
-import type { FileViewerSearchProvider, FileViewerZoomProvider } from '../../../contracts/types';
+import type { FileViewerSearchProvider, FileViewerViewStateProvider, FileViewerZoomProvider } from '../../../contracts/types';
 export interface FileViewerSearchProviderHost extends HTMLElement {
     __flyfishViewerSearchProvider?: FileViewerSearchProvider;
 }
 export interface FileViewerZoomProviderHost extends HTMLElement {
     __flyfishViewerZoomProvider?: FileViewerZoomProvider;
 }
+export interface FileViewerViewStateProviderHost extends HTMLElement {
+    __flyfishViewerViewStateProvider?: FileViewerViewStateProvider;
+}
 export declare const registerFileViewerSearchProvider: (host: HTMLElement, provider: FileViewerSearchProvider) => void;
 export declare const unregisterFileViewerSearchProvider: (host: HTMLElement | null | undefined) => void;
 export declare const findFileViewerSearchProvider: (root: HTMLElement | null | undefined) => FileViewerSearchProvider | null;
 export declare const registerFileViewerZoomProvider: (host: HTMLElement, provider: FileViewerZoomProvider) => void;
 export declare const unregisterFileViewerZoomProvider: (host: HTMLElement | null | undefined) => void;
 export declare const findFileViewerZoomProvider: (root: HTMLElement | null | undefined) => FileViewerZoomProvider | null;
+export declare const registerFileViewerViewStateProvider: (host: HTMLElement, provider: FileViewerViewStateProvider) => void;
+export declare const unregisterFileViewerViewStateProvider: (host: HTMLElement | null | undefined) => void;
+export declare const findFileViewerViewStateProvider: (root: HTMLElement | null | undefined) => FileViewerViewStateProvider | null;

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

@@ -1,5 +1,6 @@
 const searchProviderRegistry = new WeakMap();
 const zoomProviderRegistry = new WeakMap();
+const viewStateProviderRegistry = new WeakMap();
 export const registerFileViewerSearchProvider = (host, provider) => {
     searchProviderRegistry.set(host, provider);
     host.__flyfishViewerSearchProvider = provider;
@@ -50,3 +51,34 @@ export const findFileViewerZoomProvider = (root) => {
         ? zoomProviderRegistry.get(host) || host.__flyfishViewerZoomProvider || null
         : null;
 };
+export const registerFileViewerViewStateProvider = (host, provider) => {
+    viewStateProviderRegistry.set(host, provider);
+    host.dataset.viewerViewStateProvider = host.dataset.viewerViewStateProvider || 'custom';
+    host.__flyfishViewerViewStateProvider = provider;
+};
+export const unregisterFileViewerViewStateProvider = (host) => {
+    if (!host) {
+        return;
+    }
+    viewStateProviderRegistry.delete(host);
+    delete host.dataset.viewerViewStateProvider;
+    delete host.__flyfishViewerViewStateProvider;
+};
+export const findFileViewerViewStateProvider = (root) => {
+    if (!root) {
+        return null;
+    }
+    const direct = viewStateProviderRegistry.get(root) ||
+        root.__flyfishViewerViewStateProvider;
+    if (direct && root.dataset.viewerViewStateProvider !== 'generic') {
+        return direct;
+    }
+    const hosts = Array.from(root.querySelectorAll('[data-viewer-view-state-provider]'));
+    const customHost = hosts.find(host => host.dataset.viewerViewStateProvider !== 'generic');
+    const genericHost = hosts.find(host => host.dataset.viewerViewStateProvider === 'generic');
+    const host = customHost || genericHost;
+    if (host) {
+        return viewStateProviderRegistry.get(host) || host.__flyfishViewerViewStateProvider || null;
+    }
+    return direct || null;
+};

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

@@ -0,0 +1,44 @@
+import type { FileViewerApplyViewStateOptions, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateProvider } from '../../contracts/types';
+export interface RegisterFileViewerGenericViewStateProviderOptions {
+    host: HTMLElement;
+    renderer?: string;
+    scrollTarget?: HTMLElement | (() => HTMLElement | null | undefined) | null;
+}
+export interface FileViewerGenericViewStateProviderRegistration {
+    provider: FileViewerViewStateProvider;
+    destroy: () => void;
+}
+export interface CreateFileViewerViewStateControllerOptions {
+    root: () => HTMLElement | null | undefined;
+    enabled?: () => boolean;
+    onChange?: (change: FileViewerViewStateChange) => void;
+}
+export interface FileViewerViewStateController {
+    readonly provider: FileViewerViewStateProvider | null;
+    readonly state: FileViewerViewState | null;
+    hasProvider(): boolean;
+    refreshProvider(): FileViewerViewStateProvider | null;
+    observe(): void;
+    clearProvider(): FileViewerViewState | null;
+    getState(): FileViewerViewState | null;
+    applyState(state: FileViewerViewState, options?: FileViewerApplyViewStateOptions): Promise<FileViewerViewState | null>;
+    destroy(): void;
+}
+export interface FileViewerViewStateControllerActionHandlers {
+    hasViewStateProvider(): boolean;
+    refreshViewStateProvider(): FileViewerViewStateProvider | null;
+    startViewStateObserver(): FileViewerViewState | null;
+    stopViewStateObserver(): FileViewerViewState | null;
+    clearViewStateProvider(): FileViewerViewState | null;
+    getViewState(): FileViewerViewState | null;
+    applyViewState(state: FileViewerViewState, options?: FileViewerApplyViewStateOptions): Promise<FileViewerViewState | null>;
+}
+export declare const cloneFileViewerViewState: (state?: FileViewerViewState | null) => FileViewerViewState | null;
+export declare const createFileViewerViewStateChange: (state: FileViewerViewState, patch?: Partial<Omit<FileViewerViewStateChange, "state">>) => FileViewerViewStateChange;
+export declare const createFileViewerViewStateChangeEmitter: () => {
+    emit(change: FileViewerViewStateChange): void;
+    subscribe(listener: (change: FileViewerViewStateChange) => void): () => void;
+};
+export declare const registerFileViewerGenericViewStateProvider: ({ host, renderer, scrollTarget, }: RegisterFileViewerGenericViewStateProviderOptions) => FileViewerGenericViewStateProviderRegistration;
+export declare const createFileViewerViewStateController: ({ root, enabled, onChange, }: CreateFileViewerViewStateControllerOptions) => FileViewerViewStateController;
+export declare const createFileViewerViewStateControllerActionHandlers: (controller: FileViewerViewStateController) => FileViewerViewStateControllerActionHandlers;

package/dist/features/document/viewState.js

@@ -0,0 +1,308 @@
+import { findFileViewerViewStateProvider, findFileViewerZoomProvider, registerFileViewerViewStateProvider, resolveFileViewerScrollContainer, unregisterFileViewerViewStateProvider, } from './dom/index.js';
+export const cloneFileViewerViewState = (state) => {
+    if (!state) {
+        return null;
+    }
+    return {
+        ...state,
+        zoom: state.zoom ? { ...state.zoom } : undefined,
+        scroll: state.scroll ? { ...state.scroll } : undefined,
+        navigation: state.navigation ? { ...state.navigation } : undefined,
+        extra: state.extra ? { ...state.extra } : undefined,
+    };
+};
+export const createFileViewerViewStateChange = (state, patch = {}) => ({
+    state: cloneFileViewerViewState(state) || {},
+    action: patch.action || 'init',
+    source: patch.source || 'viewer',
+    timestamp: patch.timestamp || Date.now(),
+});
+export const createFileViewerViewStateChangeEmitter = () => {
+    const listeners = new Set();
+    return {
+        emit(change) {
+            listeners.forEach(listener => listener(change));
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+};
+const getViewStateWindow = (host) => {
+    var _a;
+    return ((_a = host.ownerDocument) === null || _a === void 0 ? void 0 : _a.defaultView) || (typeof window !== 'undefined' ? window : undefined);
+};
+const waitForViewStateFrame = (host) => {
+    const ownerWindow = getViewStateWindow(host);
+    return new Promise(resolve => {
+        if (ownerWindow === null || ownerWindow === void 0 ? void 0 : ownerWindow.requestAnimationFrame) {
+            ownerWindow.requestAnimationFrame(() => resolve());
+            return;
+        }
+        setTimeout(resolve, 16);
+    });
+};
+const readFileViewerScrollState = (element) => {
+    const maxTop = Math.max(0, element.scrollHeight - element.clientHeight);
+    const maxLeft = Math.max(0, element.scrollWidth - element.clientWidth);
+    return {
+        top: element.scrollTop || 0,
+        left: element.scrollLeft || 0,
+        width: element.scrollWidth || 0,
+        height: element.scrollHeight || 0,
+        clientWidth: element.clientWidth || 0,
+        clientHeight: element.clientHeight || 0,
+        topRatio: maxTop > 0 ? (element.scrollTop || 0) / maxTop : 0,
+        leftRatio: maxLeft > 0 ? (element.scrollLeft || 0) / maxLeft : 0,
+    };
+};
+const resolveScrollValue = (value, ratio, maxValue) => {
+    if (Number.isFinite(value)) {
+        return Number(value);
+    }
+    if (Number.isFinite(ratio)) {
+        return Number(ratio) * maxValue;
+    }
+    return undefined;
+};
+export const registerFileViewerGenericViewStateProvider = ({ host, renderer, scrollTarget, }) => {
+    var _a;
+    const emitter = createFileViewerViewStateChangeEmitter();
+    const ownerWindow = getViewStateWindow(host);
+    let destroyed = false;
+    let scrollFrame = 0;
+    let suppressScrollEventUntil = 0;
+    let unsubscribeZoom = null;
+    const resolveScrollTarget = () => {
+        if (typeof scrollTarget === 'function') {
+            return scrollTarget() || host;
+        }
+        return scrollTarget || resolveFileViewerScrollContainer(host) || host;
+    };
+    const getZoomProvider = () => findFileViewerZoomProvider(host);
+    const getState = () => {
+        var _a, _b;
+        const zoom = (_b = (_a = getZoomProvider()) === null || _a === void 0 ? void 0 : _a.getState) === null || _b === void 0 ? void 0 : _b.call(_a);
+        const scrollElement = resolveScrollTarget();
+        return {
+            renderer,
+            scale: zoom === null || zoom === void 0 ? void 0 : zoom.scale,
+            zoom,
+            scroll: scrollElement ? readFileViewerScrollState(scrollElement) : undefined,
+        };
+    };
+    const emit = (action, source = 'viewer') => {
+        if (destroyed) {
+            return getState();
+        }
+        const state = getState();
+        emitter.emit(createFileViewerViewStateChange(state, { action, source }));
+        return state;
+    };
+    const suppressProgrammaticScrollEvents = () => {
+        suppressScrollEventUntil = Math.max(suppressScrollEventUntil, Date.now() + 180);
+    };
+    const applyScrollState = (scroll) => {
+        if (!scroll) {
+            return;
+        }
+        const scrollElement = resolveScrollTarget();
+        const maxTop = Math.max(0, scrollElement.scrollHeight - scrollElement.clientHeight);
+        const maxLeft = Math.max(0, scrollElement.scrollWidth - scrollElement.clientWidth);
+        const top = resolveScrollValue(scroll.top, scroll.topRatio, maxTop);
+        const left = resolveScrollValue(scroll.left, scroll.leftRatio, maxLeft);
+        suppressProgrammaticScrollEvents();
+        if (top !== undefined) {
+            scrollElement.scrollTop = Math.min(Math.max(0, top), maxTop);
+        }
+        if (left !== undefined) {
+            scrollElement.scrollLeft = Math.min(Math.max(0, left), maxLeft);
+        }
+    };
+    const scheduleScrollChange = () => {
+        if (destroyed || Date.now() < suppressScrollEventUntil || scrollFrame) {
+            return;
+        }
+        const requestFrame = (ownerWindow === null || ownerWindow === void 0 ? void 0 : ownerWindow.requestAnimationFrame) || ((callback) => {
+            return setTimeout(() => callback(Date.now()), 16);
+        });
+        scrollFrame = requestFrame(() => {
+            scrollFrame = 0;
+            emit('scroll', 'user');
+        });
+    };
+    const provider = {
+        getState,
+        async applyState(state, options = {}) {
+            var _a, _b;
+            const source = options.source || 'api';
+            const action = options.action || 'restore';
+            const notify = options.notify !== false;
+            const zoomProvider = getZoomProvider();
+            const nextScale = Number((_a = state.scale) !== null && _a !== void 0 ? _a : (_b = state.zoom) === null || _b === void 0 ? void 0 : _b.scale);
+            suppressProgrammaticScrollEvents();
+            if (Number.isFinite(nextScale) && (zoomProvider === null || zoomProvider === void 0 ? void 0 : zoomProvider.setZoom)) {
+                await zoomProvider.setZoom(nextScale);
+            }
+            await waitForViewStateFrame(host);
+            applyScrollState(state.scroll);
+            await waitForViewStateFrame(host);
+            applyScrollState(state.scroll);
+            if (notify) {
+                return emit(action, source);
+            }
+            return getState();
+        },
+        subscribe: emitter.subscribe,
+    };
+    host.dataset.viewerViewStateProvider = 'generic';
+    registerFileViewerViewStateProvider(host, provider);
+    host.addEventListener('scroll', scheduleScrollChange, {
+        capture: true,
+        passive: true,
+    });
+    const zoomProvider = getZoomProvider();
+    unsubscribeZoom = ((_a = zoomProvider === null || zoomProvider === void 0 ? void 0 : zoomProvider.subscribe) === null || _a === void 0 ? void 0 : _a.call(zoomProvider, () => {
+        emit('zoom-change', 'viewer');
+    })) || null;
+    return {
+        provider,
+        destroy() {
+            destroyed = true;
+            unsubscribeZoom === null || unsubscribeZoom === void 0 ? void 0 : unsubscribeZoom();
+            unsubscribeZoom = null;
+            if (scrollFrame && (ownerWindow === null || ownerWindow === void 0 ? void 0 : ownerWindow.cancelAnimationFrame)) {
+                ownerWindow.cancelAnimationFrame(scrollFrame);
+            }
+            scrollFrame = 0;
+            host.removeEventListener('scroll', scheduleScrollChange, true);
+            unregisterFileViewerViewStateProvider(host);
+        },
+    };
+};
+const getMutationObserverConstructor = (root) => {
+    var _a, _b;
+    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 createFileViewerViewStateController = ({ root, enabled, onChange, }) => {
+    let provider = null;
+    let unsubscribe = null;
+    let observer = null;
+    let state = null;
+    const readProviderState = () => { var _a; return cloneFileViewerViewState(((_a = provider === null || provider === void 0 ? void 0 : provider.getState) === null || _a === void 0 ? void 0 : _a.call(provider)) || null); };
+    const commitState = (nextState, change) => {
+        state = cloneFileViewerViewState(nextState);
+        if (change && state) {
+            onChange === null || onChange === void 0 ? void 0 : onChange({
+                ...change,
+                state: cloneFileViewerViewState(change.state) || state,
+            });
+        }
+        return cloneFileViewerViewState(state);
+    };
+    const clearProvider = () => {
+        unsubscribe === null || unsubscribe === void 0 ? void 0 : unsubscribe();
+        unsubscribe = null;
+        provider = null;
+        return commitState(null);
+    };
+    const syncProvider = () => {
+        var _a;
+        if ((enabled === null || enabled === void 0 ? void 0 : enabled()) === false) {
+            clearProvider();
+            return null;
+        }
+        const nextProvider = findFileViewerViewStateProvider(root());
+        if (nextProvider !== provider) {
+            unsubscribe === null || unsubscribe === void 0 ? void 0 : unsubscribe();
+            provider = nextProvider;
+            unsubscribe = ((_a = nextProvider === null || nextProvider === void 0 ? void 0 : nextProvider.subscribe) === null || _a === void 0 ? void 0 : _a.call(nextProvider, change => {
+                commitState(change.state, change);
+            })) || null;
+        }
+        commitState(readProviderState());
+        return nextProvider;
+    };
+    const disconnectObserver = () => {
+        observer === null || observer === void 0 ? void 0 : observer.disconnect();
+        observer = null;
+    };
+    return {
+        get provider() {
+            return provider;
+        },
+        get state() {
+            return cloneFileViewerViewState(state);
+        },
+        hasProvider() {
+            return !!syncProvider();
+        },
+        refreshProvider: syncProvider,
+        observe() {
+            disconnectObserver();
+            const currentRoot = root();
+            const MutationObserverCtor = getMutationObserverConstructor(currentRoot);
+            if (!currentRoot || !MutationObserverCtor) {
+                syncProvider();
+                return;
+            }
+            observer = new MutationObserverCtor(() => {
+                syncProvider();
+            });
+            observer.observe(currentRoot, {
+                childList: true,
+                subtree: true,
+            });
+            syncProvider();
+        },
+        clearProvider,
+        getState() {
+            syncProvider();
+            return cloneFileViewerViewState(state);
+        },
+        async applyState(nextState, options) {
+            const nextProvider = syncProvider();
+            if (!(nextProvider === null || nextProvider === void 0 ? void 0 : nextProvider.applyState)) {
+                return cloneFileViewerViewState(state);
+            }
+            const appliedState = await nextProvider.applyState(nextState, options);
+            commitState(appliedState || nextProvider.getState());
+            return cloneFileViewerViewState(state);
+        },
+        destroy() {
+            disconnectObserver();
+            clearProvider();
+        },
+    };
+};
+export const createFileViewerViewStateControllerActionHandlers = (controller) => {
+    return {
+        hasViewStateProvider() {
+            return controller.hasProvider();
+        },
+        refreshViewStateProvider() {
+            return controller.refreshProvider();
+        },
+        startViewStateObserver() {
+            controller.observe();
+            return controller.getState();
+        },
+        stopViewStateObserver() {
+            controller.destroy();
+            return null;
+        },
+        clearViewStateProvider() {
+            return controller.clearProvider();
+        },
+        getViewState() {
+            return controller.getState();
+        },
+        applyViewState(state, options) {
+            return controller.applyState(state, options);
+        },
+    };
+};

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

@@ -4,6 +4,7 @@ export interface CreateFileViewerZoomControllerOptions {
     root: () => HTMLElement | null | undefined;
     enabled?: () => boolean;
     beforeZoom?: (operation: FileViewerZoomOperation) => Promise<boolean> | boolean;
+    onChange?: (state: FileViewerZoomState) => void;
 }
 export type MutableFileViewerZoomState = FileViewerZoomState;
 export interface FileViewerZoomController {
@@ -44,4 +45,4 @@ export declare const createFileViewerZoomChangeEmitter: () => {
     emit(): void;
     subscribe(listener: () => void): () => void;
 };
-export declare const createFileViewerZoomController: ({ root, enabled, beforeZoom, }: CreateFileViewerZoomControllerOptions) => FileViewerZoomController;
+export declare const createFileViewerZoomController: ({ root, enabled, beforeZoom, onChange, }: CreateFileViewerZoomControllerOptions) => FileViewerZoomController;

package/dist/features/document/zoom.js

@@ -99,11 +99,15 @@ 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, }) => {
+export const createFileViewerZoomController = ({ root, enabled, beforeZoom, onChange, }) => {
     let provider = null;
     let unsubscribe = null;
     let observer = null;
+    let runningAction = false;
     const state = createFileViewerZoomState();
+    const notifyChange = () => {
+        onChange === null || onChange === void 0 ? void 0 : onChange(cloneFileViewerZoomState(state));
+    };
     const clearProvider = () => {
         unsubscribe === null || unsubscribe === void 0 ? void 0 : unsubscribe();
         unsubscribe = null;
@@ -122,6 +126,9 @@ export const createFileViewerZoomController = ({ root, enabled, beforeZoom, }) =
             provider = nextProvider;
             unsubscribe = ((_a = nextProvider === null || nextProvider === void 0 ? void 0 : nextProvider.subscribe) === null || _a === void 0 ? void 0 : _a.call(nextProvider, () => {
                 applyFileViewerZoomState(state, nextProvider.getState());
+                if (!runningAction) {
+                    notifyChange();
+                }
             })) || null;
         }
         applyFileViewerZoomState(state, ((_b = nextProvider === null || nextProvider === void 0 ? void 0 : nextProvider.getState) === null || _b === void 0 ? void 0 : _b.call(nextProvider)) || null);
@@ -139,9 +146,15 @@ export const createFileViewerZoomController = ({ root, enabled, beforeZoom, }) =
         if (beforeZoom && await beforeZoom(operation) === false) {
             return cloneFileViewerZoomState(state);
         }
-        const nextState = await action(nextProvider);
-        applyFileViewerZoomState(state, nextState || nextProvider.getState());
-        return cloneFileViewerZoomState(state);
+        runningAction = true;
+        try {
+            const nextState = await action(nextProvider);
+            applyFileViewerZoomState(state, nextState || nextProvider.getState());
+            return cloneFileViewerZoomState(state);
+        }
+        finally {
+            runningAction = false;
+        }
     };
     return {
         get provider() {

package/dist/headless.d.ts

@@ -1,6 +1,6 @@
 export { DEFAULT_FILE_VIEWER_ARCHIVE_WORKER_PATH, DEFAULT_FILE_VIEWER_ARCHIVE_WASM_PATH, DEFAULT_FILE_VIEWER_CAD_DWF_WASM_PATH, DEFAULT_FILE_VIEWER_CAD_WASM_PATH, DEFAULT_FILE_VIEWER_CAD_WORKER_PATH, DEFAULT_FILE_VIEWER_DATA_SQL_WASM_URL, DEFAULT_FILE_VIEWER_DOCX_WORKER_JSZIP_PATH, DEFAULT_FILE_VIEWER_DOCX_WORKER_PATH, DEFAULT_FILE_VIEWER_RENDERER_ASSET_MANIFESTS, DEFAULT_FILE_VIEWER_SPREADSHEET_WORKER_PATH, DEFAULT_FILE_VIEWER_TYPST_COMPILER_WASM_URL, DEFAULT_FILE_VIEWER_TYPST_RENDERER_WASM_PACKAGE_PATH, DEFAULT_FILE_VIEWER_TYPST_RENDERER_WASM_URL, getFileViewerRendererAssetManifest, listFileViewerRendererAssetManifests, resolveFileViewerArchiveWasmUrl, resolveFileViewerArchiveWorkerUrl, resolveFileViewerAssetUrl, resolveFileViewerCadAssetUrls, resolveFileViewerDataSqlWasmUrl, resolveFileViewerDocxWorkerJsZipUrl, resolveFileViewerDocxWorkerUrl, resolveFileViewerDrawioViewerScriptUrl, resolveFileViewerRendererAssets, resolveFileViewerSpreadsheetWorkerUrl, resolveFileViewerTypstCompilerWasmUrl, resolveFileViewerTypstRendererWasmUrl, } from './assets';
 export type { FileViewerRendererAssetDefinition, FileViewerRendererAssetKind, FileViewerRendererAssetManifest, FileViewerRendererAssetOptionPath, FileViewerRendererAssetTarget, ResolveFileViewerAssetUrlOptions, ResolveFileViewerRendererAssetsOptions, ResolvedFileViewerCadAssetUrls, ResolvedFileViewerRendererAsset, } from './assets';
-export { ADAPTER_PRINT_REQUIRED_EXTENSIONS, createUnsupportedAvailability, DEFAULT_OPERATION_AVAILABILITY, DOM_PRINTABLE_EXTENSIONS, getRendererAvailability, isDomPrintableExtension, isKnownNonPrintableExtension, needsDedicatedPrintAdapter, NON_PRINTABLE_EXTENSIONS, resolvePrintAvailability, } from './registry/capabilities';
+export { ADAPTER_PRINT_REQUIRED_EXTENSIONS, applyFileViewerZoomAvailability, createUnsupportedAvailability, DEFAULT_OPERATION_AVAILABILITY, DOM_PRINTABLE_EXTENSIONS, getRendererAvailability, isDomPrintableExtension, isKnownNonPrintableExtension, needsDedicatedPrintAdapter, NON_PRINTABLE_EXTENSIONS, resolvePrintAvailability, } from './registry/capabilities';
 export { DEFAULT_FILE_VIEWER_TEXT_CHUNK_OVERLAP, DEFAULT_FILE_VIEWER_TEXT_CHUNK_SIZE, DEFAULT_FILE_VIEWER_ZOOM_SCALE, buildFileViewerDocumentTextChunks, createEmptyFileViewerSearchState, createFileViewerZoomState, normalizeFileViewerAiOptions, normalizeFileViewerSearchOptions, } from './features/document/model';
 export { ARCHIVE_EXTENSIONS, DEFAULT_RENDERER_DEFINITIONS, DEFAULT_SUPPORTED_EXTENSIONS, IMAGE_EXTENSIONS, MODEL_EXTENSIONS, TEXT_EXTENSIONS, } from './registry/formats';
 export { FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, FILE_VIEWER_LIFECYCLE_HOOK_ERROR_MESSAGE_PREFIX, FILE_VIEWER_LIFECYCLE_HOOKS, FILE_VIEWER_OPERATION_LABELS, buildFileViewerLifecycleContext, buildFileViewerLifecycleContextFromNormalizedSource, buildFileViewerOperationContext, buildFileViewerOperationContextFromLifecycleState, cloneFileViewerOperationAvailability, createFileViewerLifecycleActions, createFileViewerLifecycleStateController, createFileViewerPublicApi, createFileViewerToolbarActions, createFileViewerToolbarControllerActionHandlers, createFileViewerToolbarZoomSyncSnapshot, DEFAULT_FILE_VIEWER_LIFECYCLE_HOOK_ERROR_LOGGER, DEFAULT_FILE_VIEWER_OPERATION_ERROR_LOGGER, dispatchFileViewerLifecycleEvent, dispatchFileViewerOperationAvailabilityChange, dispatchFileViewerOperationContextEvent, dispatchFileViewerZoomChange, emitFileViewerComponentLifecycleEvent, getFileViewerBeforeOperationHooks, getFileViewerLifecycleHookName, hasVisibleFileViewerToolbarActions, isFileViewerToolbarOperationPermitted, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, reportFileViewerLifecycleHookError, reportFileViewerOperationError, resolveFileViewerBeforeOperationErrorMessage, resolveFileViewerLifecycleFallbackSource, resolveFileViewerLifecycleHookErrorMessage, resolveFileViewerOperationAvailability, resolveFileViewerToolbarPosition, resolveFileViewerToolbarState, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from './lifecycle/operations';
@@ -24,4 +24,4 @@ export { DEFAULT_FILE_VIEWER_STATE_THEME, DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRI
 export type { FileViewerErrorMessageFormatter, } from './viewer/state';
 export { buildFileViewerWatermarkBackgroundImage, buildFileViewerWatermarkInlineStyle, buildFileViewerWatermarkStyle, buildFileViewerWatermarkSvg, normalizeFileViewerWatermark, resolveFileViewerWatermarkPresentationState, } from './features/watermark';
 export type { FileViewerWatermarkPresentationState, FileViewerWatermarkStyle, } from './features/watermark';
-export type { FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerAiOptions, FileViewerArchiveOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerDownloadOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerGeoOptions, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfOptions, FileViewerPrintOptions, FileViewerPublicApi, FileViewerRenderStateKind, FileViewerRenderedInstance, FileViewerRendererCategory, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerTypstOptions, FileViewerWatermarkOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RenderSurface, RendererCapability, RendererDefinition, RendererLoadContext, RendererLoader, RendererPlugin, RendererRegistry, RendererSession, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';
+export type { FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerAiOptions, FileViewerArchiveOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerDownloadOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerGeoOptions, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerNavigationState, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerPrintOptions, FileViewerPublicApi, FileViewerRenderStateKind, FileViewerRenderedInstance, FileViewerRendererCategory, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerTypstOptions, FileViewerViewScrollState, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateChangeAction, FileViewerViewStateChangeSource, FileViewerViewStateProvider, FileViewerWatermarkOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RenderSurface, RendererCapability, RendererDefinition, RendererLoadContext, RendererLoader, RendererPlugin, RendererRegistry, RendererSession, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';