@file-viewer/core 2.1.16 → 2.1.18

package/dist/features/document/fit.js

@@ -0,0 +1,339 @@
+import { findFileViewerViewStateProvider, findFileViewerZoomProvider, } from './dom/index.js';
+export const FILE_VIEWER_FIT_MODES = [
+    'auto',
+    'contain',
+    'cover',
+    'width',
+    'height',
+    'actual',
+    'scale-down',
+];
+export const FILE_VIEWER_FIT_RESIZE_MODES = [
+    'until-interaction',
+    'always',
+    'initial',
+];
+const DEFAULT_FILE_VIEWER_FIT_RESIZE = 'until-interaction';
+const DEFAULT_FILE_VIEWER_FIT_PADDING = 0;
+const MAX_FILE_VIEWER_FIT_RETRIES = 8;
+const isRecord = (value) => {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+};
+export const isFileViewerFitMode = (value) => {
+    return typeof value === 'string' && FILE_VIEWER_FIT_MODES.includes(value);
+};
+export const isFileViewerFitResize = (value) => {
+    return typeof value === 'string' &&
+        FILE_VIEWER_FIT_RESIZE_MODES.includes(value);
+};
+const normalizePositiveNumber = (value) => {
+    const nextValue = Number(value);
+    return Number.isFinite(nextValue) && nextValue > 0 ? nextValue : undefined;
+};
+const normalizePadding = (value) => {
+    const nextValue = Number(value);
+    return Number.isFinite(nextValue) && nextValue > 0 ? nextValue : DEFAULT_FILE_VIEWER_FIT_PADDING;
+};
+export const normalizeFileViewerFitOptions = (fit) => {
+    if (fit === undefined || fit === null || fit === false) {
+        return null;
+    }
+    if (isFileViewerFitMode(fit)) {
+        return {
+            mode: fit,
+            resize: DEFAULT_FILE_VIEWER_FIT_RESIZE,
+            padding: DEFAULT_FILE_VIEWER_FIT_PADDING,
+        };
+    }
+    if (!isRecord(fit)) {
+        return null;
+    }
+    const minScale = normalizePositiveNumber(fit.minScale);
+    const rawMaxScale = normalizePositiveNumber(fit.maxScale);
+    const maxScale = minScale !== undefined && rawMaxScale !== undefined && rawMaxScale < minScale
+        ? minScale
+        : rawMaxScale;
+    return {
+        mode: isFileViewerFitMode(fit.mode) ? fit.mode : 'auto',
+        resize: isFileViewerFitResize(fit.resize) ? fit.resize : DEFAULT_FILE_VIEWER_FIT_RESIZE,
+        padding: normalizePadding(fit.padding),
+        minScale,
+        maxScale,
+    };
+};
+const clampScale = (scale, minScale, maxScale) => {
+    let nextScale = scale;
+    if (Number.isFinite(minScale)) {
+        nextScale = Math.max(Number(minScale), nextScale);
+    }
+    if (Number.isFinite(maxScale)) {
+        nextScale = Math.min(Number(maxScale), nextScale);
+    }
+    return nextScale;
+};
+export const resolveFileViewerFitScale = ({ mode, viewportWidth, viewportHeight, contentWidth, contentHeight, currentScale = 1, minScale, maxScale, }) => {
+    if (viewportWidth <= 0 ||
+        viewportHeight <= 0 ||
+        contentWidth <= 0 ||
+        contentHeight <= 0) {
+        return undefined;
+    }
+    const widthScale = viewportWidth / contentWidth;
+    const heightScale = viewportHeight / contentHeight;
+    const containScale = Math.min(widthScale, heightScale);
+    const coverScale = Math.max(widthScale, heightScale);
+    const nextScale = (() => {
+        switch (mode) {
+            case 'cover':
+                return coverScale;
+            case 'width':
+                return widthScale;
+            case 'height':
+                return heightScale;
+            case 'actual':
+                return 1;
+            case 'scale-down':
+                return Math.min(1, containScale);
+            case 'auto':
+            case 'contain':
+            default:
+                return containScale;
+        }
+    })();
+    if (!Number.isFinite(nextScale) || nextScale <= 0) {
+        return undefined;
+    }
+    return clampScale(nextScale, minScale, maxScale);
+};
+export const hasFileViewerExplicitInitialViewState = (state) => {
+    var _a, _b;
+    if (!state) {
+        return false;
+    }
+    const scale = Number((_a = state.scale) !== null && _a !== void 0 ? _a : (_b = state.zoom) === null || _b === void 0 ? void 0 : _b.scale);
+    if (Number.isFinite(scale) && scale > 0) {
+        return true;
+    }
+    if (Number.isFinite(state.page) || Number.isFinite(state.rotation)) {
+        return true;
+    }
+    if (state.navigation && Object.keys(state.navigation).length > 0) {
+        return true;
+    }
+    if (state.extra && Object.keys(state.extra).length > 0) {
+        return true;
+    }
+    const scroll = state.scroll || {};
+    return ['top', 'left', 'topRatio', 'leftRatio'].some(key => {
+        const value = scroll[key];
+        return Number.isFinite(value);
+    });
+};
+const createNoopFitResult = (fit, reason, source = 'viewer', provider = 'none') => ({
+    applied: false,
+    mode: fit.mode,
+    resize: fit.resize,
+    source,
+    reason,
+    provider,
+});
+const withProviderResult = (result, request, provider) => ({
+    applied: !!(result === null || result === void 0 ? void 0 : result.applied),
+    mode: (result === null || result === void 0 ? void 0 : result.mode) || request.mode,
+    resize: (result === null || result === void 0 ? void 0 : result.resize) || request.resize,
+    scale: result === null || result === void 0 ? void 0 : result.scale,
+    source: (result === null || result === void 0 ? void 0 : result.source) || request.source,
+    reason: result === null || result === void 0 ? void 0 : result.reason,
+    provider: (result === null || result === void 0 ? void 0 : result.provider) || provider,
+    state: result === null || result === void 0 ? void 0 : result.state,
+});
+const readViewportSize = (root) => {
+    var _a;
+    const rect = (_a = root.getBoundingClientRect) === null || _a === void 0 ? void 0 : _a.call(root);
+    return {
+        width: Math.max(0, (rect === null || rect === void 0 ? void 0 : rect.width) || root.clientWidth || 0),
+        height: Math.max(0, (rect === null || rect === void 0 ? void 0 : rect.height) || root.clientHeight || 0),
+    };
+};
+export const createFileViewerFitController = ({ root, enabled, getFit = () => undefined, onFit, }) => {
+    let resizeObserver = null;
+    let resizeFrame = null;
+    let retryTimer = null;
+    let userInteracted = false;
+    let retryCount = 0;
+    const getWindow = () => {
+        var _a;
+        const currentRoot = root();
+        return ((_a = currentRoot === null || currentRoot === void 0 ? void 0 : currentRoot.ownerDocument) === null || _a === void 0 ? void 0 : _a.defaultView) ||
+            (typeof window !== 'undefined' ? window : undefined);
+    };
+    const cancelFrame = () => {
+        if (resizeFrame === null) {
+            return;
+        }
+        const view = getWindow();
+        if (view === null || view === void 0 ? void 0 : view.cancelAnimationFrame) {
+            view.cancelAnimationFrame(resizeFrame);
+        }
+        resizeFrame = null;
+    };
+    const cancelRetry = () => {
+        if (retryTimer) {
+            clearTimeout(retryTimer);
+        }
+        retryTimer = null;
+    };
+    const resolveFit = (fit, reason) => {
+        const configured = fit === undefined ? getFit() : fit;
+        if (configured !== undefined && configured !== null) {
+            return normalizeFileViewerFitOptions(configured);
+        }
+        return reason === 'api' ? normalizeFileViewerFitOptions('auto') : null;
+    };
+    const scheduleRetry = (fit, source, reason) => {
+        if (retryCount >= MAX_FILE_VIEWER_FIT_RETRIES) {
+            return;
+        }
+        cancelRetry();
+        retryCount += 1;
+        retryTimer = setTimeout(() => {
+            retryTimer = null;
+            void runFit(fit, { source, reason: reason === 'api' ? 'api' : 'retry' });
+        }, 32 * retryCount);
+    };
+    const runFit = async (fit, runOptions = {}) => {
+        const source = runOptions.source || 'api';
+        const reason = runOptions.reason || 'api';
+        const normalized = resolveFit(fit, reason);
+        if (!normalized) {
+            return {
+                applied: false,
+                mode: 'auto',
+                resize: DEFAULT_FILE_VIEWER_FIT_RESIZE,
+                source,
+                reason: 'not-configured',
+                provider: 'none',
+            };
+        }
+        if ((enabled === null || enabled === void 0 ? void 0 : enabled()) === false) {
+            return createNoopFitResult(normalized, 'disabled', source);
+        }
+        const currentRoot = root();
+        if (!currentRoot) {
+            scheduleRetry(fit, source, reason);
+            return createNoopFitResult(normalized, 'no-root', source);
+        }
+        const viewport = readViewportSize(currentRoot);
+        if (viewport.width <= 0 || viewport.height <= 0) {
+            scheduleRetry(fit, source, reason);
+            return createNoopFitResult(normalized, 'zero-size', source);
+        }
+        const request = {
+            ...normalized,
+            source,
+            reason,
+            viewportWidth: Math.max(0, viewport.width - normalized.padding * 2),
+            viewportHeight: Math.max(0, viewport.height - normalized.padding * 2),
+            container: currentRoot,
+        };
+        const viewStateProvider = findFileViewerViewStateProvider(currentRoot);
+        if (viewStateProvider === null || viewStateProvider === void 0 ? void 0 : viewStateProvider.fit) {
+            const result = withProviderResult(await viewStateProvider.fit(request), request, 'view-state');
+            if (result.applied) {
+                retryCount = 0;
+                onFit === null || onFit === void 0 ? void 0 : onFit(result);
+                return result;
+            }
+        }
+        const zoomProvider = findFileViewerZoomProvider(currentRoot);
+        if (zoomProvider === null || zoomProvider === void 0 ? void 0 : zoomProvider.fit) {
+            const result = withProviderResult(await zoomProvider.fit(request), request, 'zoom');
+            if (result.applied) {
+                retryCount = 0;
+                onFit === null || onFit === void 0 ? void 0 : onFit(result);
+                return result;
+            }
+        }
+        const noop = createNoopFitResult(normalized, viewStateProvider || zoomProvider
+            ? 'unsupported'
+            : 'no-provider', source);
+        if (noop.reason === 'no-provider') {
+            scheduleRetry(fit, source, reason);
+        }
+        return noop;
+    };
+    const scheduleFit = (reason = 'resize') => {
+        const normalized = normalizeFileViewerFitOptions(getFit());
+        if (!normalized || normalized.resize === 'initial') {
+            return;
+        }
+        if (normalized.resize === 'until-interaction' && userInteracted) {
+            return;
+        }
+        cancelFrame();
+        const view = getWindow();
+        const run = () => {
+            resizeFrame = null;
+            void runFit(undefined, { source: 'viewer', reason });
+        };
+        if (view === null || view === void 0 ? void 0 : view.requestAnimationFrame) {
+            resizeFrame = view.requestAnimationFrame(run);
+            return;
+        }
+        resizeFrame = setTimeout(run, 16);
+    };
+    const disconnectObserver = () => {
+        cancelFrame();
+        resizeObserver === null || resizeObserver === void 0 ? void 0 : resizeObserver.disconnect();
+        resizeObserver = null;
+    };
+    const controller = {
+        normalize: normalizeFileViewerFitOptions,
+        fit: async (fit, options) => {
+            cancelRetry();
+            userInteracted = false;
+            return runFit(fit, {
+                source: (options === null || options === void 0 ? void 0 : options.source) || 'api',
+                reason: (options === null || options === void 0 ? void 0 : options.reason) || 'api',
+            });
+        },
+        applyInitialFit: async (initialOptions = {}) => {
+            cancelRetry();
+            retryCount = 0;
+            userInteracted = false;
+            if (initialOptions.skip) {
+                const normalized = normalizeFileViewerFitOptions(getFit()) ||
+                    normalizeFileViewerFitOptions('auto');
+                return createNoopFitResult(normalized, 'initial-view-state', 'initial');
+            }
+            return runFit(undefined, { source: 'initial', reason: 'initial' });
+        },
+        scheduleFit,
+        observe() {
+            var _a, _b;
+            disconnectObserver();
+            const currentRoot = root();
+            const ResizeObserverCtor = ((_b = (_a = currentRoot === null || currentRoot === void 0 ? void 0 : currentRoot.ownerDocument) === null || _a === void 0 ? void 0 : _a.defaultView) === null || _b === void 0 ? void 0 : _b.ResizeObserver) ||
+                (typeof ResizeObserver !== 'undefined' ? ResizeObserver : undefined);
+            if (!currentRoot || !ResizeObserverCtor) {
+                return;
+            }
+            resizeObserver = new ResizeObserverCtor(() => scheduleFit('resize'));
+            resizeObserver.observe(currentRoot);
+        },
+        markUserInteraction() {
+            userInteracted = true;
+            cancelRetry();
+        },
+        resetAutoFit() {
+            userInteracted = false;
+            retryCount = 0;
+        },
+        destroy() {
+            disconnectObserver();
+            cancelRetry();
+            retryCount = 0;
+        },
+    };
+    return controller;
+};

package/dist/features/document/viewState.js

@@ -1,4 +1,5 @@
 import { findFileViewerViewStateProvider, findFileViewerZoomProvider, registerFileViewerViewStateProvider, resolveFileViewerScrollContainer, unregisterFileViewerViewStateProvider, } from './dom/index.js';
+import { resolveFileViewerFitScale } from './fit.js';
 export const cloneFileViewerViewState = (state) => {
     if (!state) {
         return null;
@@ -69,7 +70,7 @@ const resolveScrollValue = (value, ratio, maxValue) => {
     return undefined;
 };
 export const registerFileViewerGenericViewStateProvider = ({ host, renderer, scrollTarget, }) => {
-    var _a;
+    var _a, _b;
     const emitter = createFileViewerViewStateChangeEmitter();
     const ownerWindow = getViewStateWindow(host);
     let destroyed = false;
@@ -122,6 +123,63 @@ export const registerFileViewerGenericViewStateProvider = ({ host, renderer, scr
             scrollElement.scrollLeft = Math.min(Math.max(0, left), maxLeft);
         }
     };
+    const fit = async (request) => {
+        var _a, _b, _c, _d;
+        const zoomProvider = getZoomProvider();
+        if (zoomProvider === null || zoomProvider === void 0 ? void 0 : zoomProvider.fit) {
+            return zoomProvider.fit(request);
+        }
+        if (!(zoomProvider === null || zoomProvider === void 0 ? void 0 : zoomProvider.setZoom)) {
+            return {
+                applied: false,
+                mode: request.mode,
+                resize: request.resize,
+                source: request.source,
+                reason: 'zoom-provider-unavailable',
+                provider: 'view-state',
+            };
+        }
+        const zoomState = zoomProvider.getState();
+        const currentScale = Number(zoomState.scale) > 0 ? Number(zoomState.scale) : 1;
+        const scrollElement = resolveScrollTarget();
+        const viewportWidth = request.viewportWidth || scrollElement.clientWidth || host.clientWidth;
+        const viewportHeight = request.viewportHeight || scrollElement.clientHeight || host.clientHeight;
+        const contentWidth = Math.max(scrollElement.scrollWidth || 0, host.scrollWidth || 0, ((_a = scrollElement.getBoundingClientRect) === null || _a === void 0 ? void 0 : _a.call(scrollElement).width) || 0);
+        const contentHeight = Math.max(scrollElement.scrollHeight || 0, host.scrollHeight || 0, ((_b = scrollElement.getBoundingClientRect) === null || _b === void 0 ? void 0 : _b.call(scrollElement).height) || 0);
+        const scale = resolveFileViewerFitScale({
+            mode: request.mode,
+            viewportWidth,
+            viewportHeight,
+            contentWidth: contentWidth / currentScale,
+            contentHeight: contentHeight / currentScale,
+            currentScale,
+            minScale: (_c = request.minScale) !== null && _c !== void 0 ? _c : zoomState.minScale,
+            maxScale: (_d = request.maxScale) !== null && _d !== void 0 ? _d : zoomState.maxScale,
+        });
+        if (!scale) {
+            return {
+                applied: false,
+                mode: request.mode,
+                resize: request.resize,
+                source: request.source,
+                reason: 'unmeasurable',
+                provider: 'view-state',
+            };
+        }
+        suppressProgrammaticScrollEvents();
+        await zoomProvider.setZoom(scale);
+        await waitForViewStateFrame(host);
+        const state = emit('fit', request.source);
+        return {
+            applied: true,
+            mode: request.mode,
+            resize: request.resize,
+            scale,
+            source: request.source,
+            provider: 'view-state',
+            state,
+        };
+    };
     const scheduleScrollChange = () => {
         if (destroyed || Date.now() < suppressScrollEventUntil || scrollFrame) {
             return;
@@ -156,21 +214,23 @@ export const registerFileViewerGenericViewStateProvider = ({ host, renderer, scr
             }
             return getState();
         },
+        fit,
         subscribe: emitter.subscribe,
     };
     host.dataset.viewerViewStateProvider = 'generic';
     registerFileViewerViewStateProvider(host, provider);
-    host.addEventListener('scroll', scheduleScrollChange, {
+    (_a = host.addEventListener) === null || _a === void 0 ? void 0 : _a.call(host, '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, () => {
+    unsubscribeZoom = ((_b = zoomProvider === null || zoomProvider === void 0 ? void 0 : zoomProvider.subscribe) === null || _b === void 0 ? void 0 : _b.call(zoomProvider, () => {
         emit('zoom-change', 'viewer');
     })) || null;
     return {
         provider,
         destroy() {
+            var _a;
             destroyed = true;
             unsubscribeZoom === null || unsubscribeZoom === void 0 ? void 0 : unsubscribeZoom();
             unsubscribeZoom = null;
@@ -178,7 +238,7 @@ export const registerFileViewerGenericViewStateProvider = ({ host, renderer, scr
                 ownerWindow.cancelAnimationFrame(scrollFrame);
             }
             scrollFrame = 0;
-            host.removeEventListener('scroll', scheduleScrollChange, true);
+            (_a = host.removeEventListener) === null || _a === void 0 ? void 0 : _a.call(host, 'scroll', scheduleScrollChange, true);
             unregisterFileViewerViewStateProvider(host);
         },
     };

package/dist/headless.d.ts

@@ -3,7 +3,7 @@ export type { FileViewerRendererAssetDefinition, FileViewerRendererAssetKind, Fi
 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';
+export { FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, DEFAULT_FILE_VIEWER_TOOLBAR_ORDER, 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, resolveFileViewerToolbarOrder, resolveFileViewerToolbarState, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from './lifecycle/operations';
 export { FILE_VIEWER_BUILTIN_MESSAGES, FILE_VIEWER_DEFAULT_LOCALE, FILE_VIEWER_FALLBACK_LOCALE, createFileViewerTranslator, formatFileViewerMessage, normalizeFileViewerLocale, resolveFileViewerLocale, translateFileViewerMessage, } from './i18n/messages';
 export type { FileViewerI18nInput, FileViewerResolvedLocale, ResolveFileViewerI18nInput, } from './i18n/messages';
 export type { BuildFileViewerLifecycleContextFromNormalizedSourceInput, BuildFileViewerOperationContextFromLifecycleStateInput, BuildFileViewerLifecycleContextInput, BuiltFileViewerLifecycleContext, BuiltFileViewerOperationContext, CreateFileViewerLifecycleActionsInput, CreateFileViewerPublicApiInput, CreateFileViewerToolbarActionsInput, CreateFileViewerToolbarControllerActionHandlersInput, DispatchFileViewerLifecycleEventInput, DispatchFileViewerOperationAvailabilityChangeInput, DispatchFileViewerOperationContextEventInput, DispatchFileViewerZoomChangeInput, FileViewerActiveUnloadState, FileViewerLifecycleActions, FileViewerLifecycleComponentEmit, FileViewerLifecycleHookErrorLogger, FileViewerLifecycleStateController, FileViewerOperationErrorLogger, FileViewerToolbarActions, FileViewerToolbarControllerActionHandlers, FileViewerToolbarState, FileViewerToolbarZoomSyncSnapshot, FileViewerZoomButtonAction, ReportFileViewerLifecycleHookErrorInput, ReportFileViewerOperationErrorInput, ResolveFileViewerBeforeOperationErrorMessageInput, ResolveFileViewerLifecycleHookErrorMessageInput, ResolveFileViewerOperationAvailabilityInput, ResolveFileViewerToolbarStateInput, RunFileViewerActiveUnloadCompleteInput, RunFileViewerActiveUnloadStartInput, RunFileViewerBeforeOperationInput, RunFileViewerToolbarAvailabilitySyncInput, RunFileViewerToolbarZoomSyncInput, SerializedFileViewerContext, } 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, 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';
+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, FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, 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, FileViewerToolbarItem, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerResolvedToolbarItem, 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';

package/dist/headless.js

@@ -7,7 +7,7 @@ export { DEFAULT_FILE_VIEWER_ARCHIVE_WORKER_PATH, DEFAULT_FILE_VIEWER_ARCHIVE_WA
 export { ADAPTER_PRINT_REQUIRED_EXTENSIONS, applyFileViewerZoomAvailability, createUnsupportedAvailability, DEFAULT_OPERATION_AVAILABILITY, DOM_PRINTABLE_EXTENSIONS, getRendererAvailability, isDomPrintableExtension, isKnownNonPrintableExtension, needsDedicatedPrintAdapter, NON_PRINTABLE_EXTENSIONS, resolvePrintAvailability, } from './registry/capabilities.js';
 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.js';
 export { ARCHIVE_EXTENSIONS, DEFAULT_RENDERER_DEFINITIONS, DEFAULT_SUPPORTED_EXTENSIONS, IMAGE_EXTENSIONS, MODEL_EXTENSIONS, TEXT_EXTENSIONS, } from './registry/formats.js';
-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.js';
+export { FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, DEFAULT_FILE_VIEWER_TOOLBAR_ORDER, 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, resolveFileViewerToolbarOrder, resolveFileViewerToolbarState, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from './lifecycle/operations.js';
 export { FILE_VIEWER_BUILTIN_MESSAGES, FILE_VIEWER_DEFAULT_LOCALE, FILE_VIEWER_FALLBACK_LOCALE, createFileViewerTranslator, formatFileViewerMessage, normalizeFileViewerLocale, resolveFileViewerLocale, translateFileViewerMessage, } from './i18n/messages.js';
 export { getFileViewerOptionsSearchParam, normalizeFileViewerTheme, parseFileViewerOptions, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './config/options.js';
 export { resolveFileViewerPresentationState, } from './presentation/state.js';

package/dist/i18n/messages.js

@@ -42,6 +42,13 @@ const ZH_CN_MESSAGES = {
     'error.load': '加载文件异常',
     'error.stream': '加载 PDF 流式预览异常',
     'error.beforeOperation': '操作前置校验失败',
+    'error.unknown': '未知错误',
+    'error.blobUnavailable': '当前运行环境不支持 Blob，无法读取文件内容。',
+    'error.sourceUnsupported': '不支持当前文件来源输入。',
+    'error.fileReadArrayBuffer': '读取文件二进制内容失败。',
+    'error.fileReadDataUrl': '读取文件 Data URL 失败。',
+    'error.fileReadText': '读取文件文本内容失败。',
+    'error.imageDataUrlRead': '读取图片数据失败。',
     'operation.download': '下载原始文件',
     'operation.print': '打印完整渲染内容',
     'operation.exportHtml': '导出渲染 HTML',
@@ -88,6 +95,22 @@ const ZH_CN_MESSAGES = {
     'spreadsheet.state.rowsAndColumns': '共 {rows} 行，{cols} 列，按视口预取平滑加载',
     'spreadsheet.error.parseFailed': 'Excel 解析失败',
     'spreadsheet.error.workerFailed': 'Excel Worker 运行失败',
+    'word.error.invalidDocx': '文件不是有效的 DOCX/OOXML 压缩包，可能下载不完整或被服务端错误内容替换，请重新上传或检查文件源。',
+    'word.error.missingOdfContent': 'ODF 文件缺少 content.xml。',
+    'word.error.odfXmlParseFailed': 'ODF XML 解析失败。',
+    'word.title.rtf': 'RTF 文档预览',
+    'word.title.openDocumentPresentation': 'OpenDocument 演示文稿预览',
+    'word.title.openDocumentText': 'OpenDocument 文档预览',
+    'word.page.fallback': '第 {page} 页',
+    'word.page.empty': '该页没有可提取文本',
+    'word.body': '正文',
+    'word.body.empty': '没有提取到可读文本',
+    'ofd.state.loading': '正在解析 OFD...',
+    'ofd.error.empty': 'OFD 文件中没有可渲染的文档',
+    'ofd.error.parseFailed': 'OFD 文件解析失败',
+    'presentation.state.loading': '正在解析 PPTX...',
+    'presentation.error.title': 'PPTX 预览失败',
+    'presentation.error.parseFailed': 'PPTX 解析失败',
     'archive.error.nestedUnsupported': '不支持 .{type} 格式的在线预览，请下载后预览或转换为支持的格式',
     'archive.loading.readingDirectory': '正在读取压缩包目录...',
     'archive.loading.readingDirectoryHint': '大文件会在 Worker 中解析，避免阻塞主线程。',
@@ -124,6 +147,8 @@ const ZH_CN_MESSAGES = {
     'archive.loading.initializingWorker': '正在初始化压缩包解析 Worker...',
     'archive.loading.initializingWorkerHint': '大文件会在 Worker 中解析，避免阻塞主线程。',
     'archive.error.workerInitFailed': '压缩包 Worker 初始化失败',
+    'archive.error.workerUnsupported': '当前浏览器不支持 Web Worker。',
+    'archive.error.indexedDbUnavailable': 'IndexedDB 不可用',
     'archive.error.entryTooLarge': '压缩包内文件 {name} 体积 {size} 超过预览上限 {limit}。',
     'archive.loading.extracting': '正在按需解压 {name}...',
     'archive.loading.rendering': '正在渲染 {name}...',
@@ -419,6 +444,13 @@ const EN_US_MESSAGES = {
     'error.load': 'Failed to load file',
     'error.stream': 'Failed to load streaming PDF preview',
     'error.beforeOperation': 'Before-operation check failed',
+    'error.unknown': 'Unknown error',
+    'error.blobUnavailable': 'Blob is not available in the current execution environment.',
+    'error.sourceUnsupported': 'Unsupported file source input.',
+    'error.fileReadArrayBuffer': 'Failed to read the file as an ArrayBuffer.',
+    'error.fileReadDataUrl': 'Failed to read the file as a data URL.',
+    'error.fileReadText': 'Failed to read the file as text.',
+    'error.imageDataUrlRead': 'Unable to read image data URL.',
     'operation.download': 'Download original file',
     'operation.print': 'Print complete rendered content',
     'operation.exportHtml': 'Export rendered HTML',
@@ -465,6 +497,22 @@ const EN_US_MESSAGES = {
     'spreadsheet.state.rowsAndColumns': '{rows} rows, {cols} columns, loading smoothly by viewport',
     'spreadsheet.error.parseFailed': 'Failed to parse Excel',
     'spreadsheet.error.workerFailed': 'Excel Worker failed',
+    'word.error.invalidDocx': 'The file is not a valid DOCX/OOXML package. It may be incomplete or replaced by an error response from the server. Upload it again or check the file source.',
+    'word.error.missingOdfContent': 'The ODF file is missing content.xml.',
+    'word.error.odfXmlParseFailed': 'Failed to parse ODF XML.',
+    'word.title.rtf': 'RTF document preview',
+    'word.title.openDocumentPresentation': 'OpenDocument presentation preview',
+    'word.title.openDocumentText': 'OpenDocument document preview',
+    'word.page.fallback': 'Page {page}',
+    'word.page.empty': 'No extractable text on this page',
+    'word.body': 'Body',
+    'word.body.empty': 'No readable text was extracted',
+    'ofd.state.loading': 'Parsing OFD...',
+    'ofd.error.empty': 'The OFD file has no renderable document.',
+    'ofd.error.parseFailed': 'Failed to parse OFD file',
+    'presentation.state.loading': 'Parsing PPTX...',
+    'presentation.error.title': 'PPTX preview failed',
+    'presentation.error.parseFailed': 'Failed to parse PPTX',
     'archive.error.nestedUnsupported': '.{type} cannot be previewed online. Download it or convert it to a supported format.',
     'archive.loading.readingDirectory': 'Reading archive directory...',
     'archive.loading.readingDirectoryHint': 'Large files are parsed in a Worker to keep the main thread responsive.',
@@ -501,6 +549,8 @@ const EN_US_MESSAGES = {
     'archive.loading.initializingWorker': 'Initializing archive parsing Worker...',
     'archive.loading.initializingWorkerHint': 'Large files are parsed in a Worker to keep the main thread responsive.',
     'archive.error.workerInitFailed': 'Archive Worker initialization failed',
+    'archive.error.workerUnsupported': 'This browser does not support Web Workers.',
+    'archive.error.indexedDbUnavailable': 'IndexedDB is unavailable',
     'archive.error.entryTooLarge': 'Entry {name} is {size}, exceeding the preview limit {limit}.',
     'archive.loading.extracting': 'Extracting {name} on demand...',
     'archive.loading.rendering': 'Rendering {name}...',
@@ -760,10 +810,11 @@ export const FILE_VIEWER_BUILTIN_MESSAGES = Object.freeze({
 });
 const getBrowserLocale = () => {
     var _a;
-    if (typeof navigator === 'undefined') {
+    const browserNavigator = typeof window !== 'undefined' ? window.navigator : undefined;
+    if (!browserNavigator) {
         return undefined;
     }
-    return ((_a = navigator.languages) === null || _a === void 0 ? void 0 : _a[0]) || navigator.language;
+    return ((_a = browserNavigator.languages) === null || _a === void 0 ? void 0 : _a[0]) || browserNavigator.language;
 };
 export const normalizeFileViewerLocale = (locale) => {
     const candidate = !locale || locale === 'auto'