@file-viewer/core 2.1.18 → 2.1.20

package/dist/config/options.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerArchiveOptions, FileViewerCadOptions, FileViewerOptions, FileViewerThemeMode, FileViewerToolbarOptions } from '../contracts/types';
+import type { FileViewerArchiveOptions, FileViewerCadOptions, FileViewerOptions, FileViewerThemeMode, FileViewerToolbarOptions, FileViewerUiDensity } from '../contracts/types';
 export type FileViewerSerializableToolbarOptions = Omit<FileViewerToolbarOptions, 'beforeOperation' | 'beforeDownload' | 'beforePrint' | 'beforeExportHtml'>;
 export type FileViewerSerializableCadOptions = Omit<FileViewerCadOptions, 'workerUrl'> & {
     workerUrl?: string;
@@ -9,6 +9,8 @@ export interface FileViewerSerializableOptions extends Omit<FileViewerOptions, '
     cad?: FileViewerSerializableCadOptions;
 }
 export declare const normalizeFileViewerTheme: (theme: FileViewerThemeMode | undefined) => FileViewerThemeMode;
+export declare const normalizeFileViewerUiDensity: (density: FileViewerUiDensity | undefined) => FileViewerUiDensity;
+export declare const resolveFileViewerUiDensity: (options?: Pick<FileViewerOptions, "ui"> | null) => FileViewerUiDensity;
 export declare const sanitizeFileViewerOptions: (options?: FileViewerOptions | FileViewerSerializableOptions | null) => FileViewerSerializableOptions | undefined;
 export declare const serializeFileViewerOptions: (options?: FileViewerOptions | FileViewerSerializableOptions | null) => string | undefined;
 export declare const parseFileViewerOptions: (value: unknown) => FileViewerSerializableOptions | undefined;

package/dist/config/options.js

@@ -51,6 +51,10 @@ const stripExecutionOnlyOptions = (value) => {
 export const normalizeFileViewerTheme = (theme) => {
     return theme === 'light' || theme === 'dark' || theme === 'system' ? theme : 'system';
 };
+export const normalizeFileViewerUiDensity = (density) => {
+    return density === 'compact' ? 'compact' : 'comfortable';
+};
+export const resolveFileViewerUiDensity = (options) => { var _a; return normalizeFileViewerUiDensity((_a = options === null || options === void 0 ? void 0 : options.ui) === null || _a === void 0 ? void 0 : _a.density); };
 export const sanitizeFileViewerOptions = (options) => {
     if (!isRecord(options)) {
         return undefined;

package/dist/contracts/types.d.ts

@@ -60,6 +60,23 @@ export interface FileViewerToolbarOptions {
     beforePrint?: FileViewerBeforeOperation;
     beforeExportHtml?: FileViewerBeforeOperation;
 }
+export interface FileViewerArchiveEntryActionContext {
+    path: string;
+    name: string;
+    extension: string;
+    size: number;
+    lastModified?: number;
+    depth: number;
+    previewable: boolean;
+}
+export type FileViewerArchiveEntryActionPolicy = boolean | ((entry: FileViewerArchiveEntryActionContext) => boolean);
+export interface FileViewerArchiveEntryActionsOptions {
+    /**
+     * Controls the download button for files opened from inside an archive.
+     * The viewer-level original-file download remains controlled by toolbar options.
+     */
+    download?: FileViewerArchiveEntryActionPolicy;
+}
 export interface FileViewerArchiveOptions {
     workerUrl?: string;
     wasmUrl?: string;
@@ -67,6 +84,7 @@ export interface FileViewerArchiveOptions {
     cache?: boolean;
     maxArchiveSize?: number;
     maxEntryPreviewSize?: number;
+    entryActions?: FileViewerArchiveEntryActionsOptions;
     /**
      * Optional archive password. It is used for the first encrypted archive
      * attempt; if it is wrong, the built-in password dialog or requestPassword
@@ -360,6 +378,14 @@ export interface FileViewerAiOptions {
     chunkSize?: number;
     chunkOverlap?: number;
 }
+export type FileViewerUiDensity = 'comfortable' | 'compact';
+export interface FileViewerUiOptions {
+    /**
+     * Controls spacing density for viewer chrome such as toolbars, headers,
+     * archive lists, badges, search inputs, and compact action clusters.
+     */
+    density?: FileViewerUiDensity;
+}
 export interface FileViewerOptions {
     theme?: FileViewerThemeMode;
     /**
@@ -428,6 +454,7 @@ export interface FileViewerOptions {
     presets?: FileViewerRendererPresetInput;
     renderers?: FileViewerRendererPluginInput;
     watermark?: boolean | FileViewerWatermarkOptions;
+    ui?: FileViewerUiOptions;
     toolbar?: boolean | FileViewerToolbarOptions;
     search?: boolean | FileViewerSearchOptions;
     ai?: boolean | FileViewerAiOptions;

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

@@ -8,12 +8,14 @@ export interface FileViewerZoomProviderHost extends HTMLElement {
 export interface FileViewerViewStateProviderHost extends HTMLElement {
     __flyfishViewerViewStateProvider?: FileViewerViewStateProvider;
 }
+type FileViewerProviderSearchRoot = HTMLElement | ShadowRoot | null | undefined;
 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 findFileViewerSearchProvider: (root: FileViewerProviderSearchRoot) => 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 findFileViewerZoomProvider: (root: FileViewerProviderSearchRoot) => 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;
+export declare const findFileViewerViewStateProvider: (root: FileViewerProviderSearchRoot) => FileViewerViewStateProvider | null;
+export {};

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

@@ -1,6 +1,25 @@
 const searchProviderRegistry = new WeakMap();
 const zoomProviderRegistry = new WeakMap();
 const viewStateProviderRegistry = new WeakMap();
+const isProviderElement = (root) => {
+    return !!root && root.nodeType === 1;
+};
+const queryProviderHosts = (root, selector) => {
+    if (!(root === null || root === void 0 ? void 0 : root.querySelectorAll)) {
+        return [];
+    }
+    const hosts = Array.from(root.querySelectorAll(selector));
+    if (isProviderElement(root) && root.shadowRoot) {
+        hosts.push(...queryProviderHosts(root.shadowRoot, selector));
+    }
+    const elements = Array.from(root.querySelectorAll('*'));
+    for (const element of elements) {
+        if (element.shadowRoot) {
+            hosts.push(...queryProviderHosts(element.shadowRoot, selector));
+        }
+    }
+    return hosts;
+};
 export const registerFileViewerSearchProvider = (host, provider) => {
     searchProviderRegistry.set(host, provider);
     host.__flyfishViewerSearchProvider = provider;
@@ -13,15 +32,16 @@ export const unregisterFileViewerSearchProvider = (host) => {
     delete host.__flyfishViewerSearchProvider;
 };
 export const findFileViewerSearchProvider = (root) => {
-    var _a;
     if (!root) {
         return null;
     }
-    const direct = searchProviderRegistry.get(root) || root.__flyfishViewerSearchProvider;
+    const direct = isProviderElement(root)
+        ? searchProviderRegistry.get(root) || root.__flyfishViewerSearchProvider
+        : null;
     if (direct) {
         return direct;
     }
-    const host = (_a = root.querySelector) === null || _a === void 0 ? void 0 : _a.call(root, '[data-viewer-search-provider]');
+    const host = queryProviderHosts(root, '[data-viewer-search-provider]')[0];
     return host
         ? searchProviderRegistry.get(host) || host.__flyfishViewerSearchProvider || null
         : null;
@@ -40,15 +60,16 @@ export const unregisterFileViewerZoomProvider = (host) => {
     delete host.__flyfishViewerZoomProvider;
 };
 export const findFileViewerZoomProvider = (root) => {
-    var _a;
     if (!root) {
         return null;
     }
-    const direct = zoomProviderRegistry.get(root) || root.__flyfishViewerZoomProvider;
+    const direct = isProviderElement(root)
+        ? zoomProviderRegistry.get(root) || root.__flyfishViewerZoomProvider
+        : null;
     if (direct) {
         return direct;
     }
-    const host = (_a = root.querySelector) === null || _a === void 0 ? void 0 : _a.call(root, '[data-viewer-zoom-provider]');
+    const host = queryProviderHosts(root, '[data-viewer-zoom-provider]')[0];
     return host
         ? zoomProviderRegistry.get(host) || host.__flyfishViewerZoomProvider || null
         : null;
@@ -67,16 +88,17 @@ export const unregisterFileViewerViewStateProvider = (host) => {
     delete host.__flyfishViewerViewStateProvider;
 };
 export const findFileViewerViewStateProvider = (root) => {
-    var _a;
     if (!root) {
         return null;
     }
-    const direct = viewStateProviderRegistry.get(root) ||
-        root.__flyfishViewerViewStateProvider;
-    if (direct && root.dataset.viewerViewStateProvider !== 'generic') {
+    const direct = isProviderElement(root)
+        ? viewStateProviderRegistry.get(root) ||
+            root.__flyfishViewerViewStateProvider
+        : null;
+    if (direct && (!isProviderElement(root) || root.dataset.viewerViewStateProvider !== 'generic')) {
         return direct;
     }
-    const hosts = Array.from(((_a = root.querySelectorAll) === null || _a === void 0 ? void 0 : _a.call(root, '[data-viewer-view-state-provider]')) || []);
+    const hosts = queryProviderHosts(root, '[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;

package/dist/features/document/fit.js

@@ -147,6 +147,12 @@ const withProviderResult = (result, request, provider) => ({
     provider: (result === null || result === void 0 ? void 0 : result.provider) || provider,
     state: result === null || result === void 0 ? void 0 : result.state,
 });
+const isRetriableFitReason = (reason) => {
+    return reason === 'pending' ||
+        reason === 'retry' ||
+        reason === 'image-not-ready' ||
+        reason === 'unmeasurable';
+};
 const readViewportSize = (root) => {
     var _a;
     const rect = (_a = root.getBoundingClientRect) === null || _a === void 0 ? void 0 : _a.call(root);
@@ -237,6 +243,7 @@ export const createFileViewerFitController = ({ root, enabled, getFit = () => un
             container: currentRoot,
         };
         const viewStateProvider = findFileViewerViewStateProvider(currentRoot);
+        let lastProviderResult = null;
         if (viewStateProvider === null || viewStateProvider === void 0 ? void 0 : viewStateProvider.fit) {
             const result = withProviderResult(await viewStateProvider.fit(request), request, 'view-state');
             if (result.applied) {
@@ -244,6 +251,7 @@ export const createFileViewerFitController = ({ root, enabled, getFit = () => un
                 onFit === null || onFit === void 0 ? void 0 : onFit(result);
                 return result;
             }
+            lastProviderResult = result;
         }
         const zoomProvider = findFileViewerZoomProvider(currentRoot);
         if (zoomProvider === null || zoomProvider === void 0 ? void 0 : zoomProvider.fit) {
@@ -253,11 +261,12 @@ export const createFileViewerFitController = ({ root, enabled, getFit = () => un
                 onFit === null || onFit === void 0 ? void 0 : onFit(result);
                 return result;
             }
+            lastProviderResult = result;
         }
         const noop = createNoopFitResult(normalized, viewStateProvider || zoomProvider
             ? 'unsupported'
             : 'no-provider', source);
-        if (noop.reason === 'no-provider') {
+        if (noop.reason === 'no-provider' || isRetriableFitReason(lastProviderResult === null || lastProviderResult === void 0 ? void 0 : lastProviderResult.reason)) {
             scheduleRetry(fit, source, reason);
         }
         return noop;

package/dist/headless.d.ts

@@ -7,7 +7,7 @@ export { FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, DEFAULT_FILE_VIEWER_TOOLBAR_
 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';
-export { getFileViewerOptionsSearchParam, normalizeFileViewerTheme, parseFileViewerOptions, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './config/options';
+export { getFileViewerOptionsSearchParam, normalizeFileViewerUiDensity, normalizeFileViewerTheme, parseFileViewerOptions, resolveFileViewerUiDensity, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './config/options';
 export type { FileViewerSerializableCadOptions, FileViewerSerializableOptions, FileViewerSerializableToolbarOptions, } from './config/options';
 export { resolveFileViewerPresentationState, } from './presentation/state';
 export type { FileViewerPresentationState, ResolveFileViewerPresentationStateInput, } from './presentation/state';
@@ -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, 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';
+export type { FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerAiOptions, FileViewerArchiveEntryActionContext, FileViewerArchiveEntryActionPolicy, FileViewerArchiveEntryActionsOptions, 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, FileViewerUiDensity, FileViewerUiOptions, 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

@@ -9,7 +9,7 @@ export { DEFAULT_FILE_VIEWER_TEXT_CHUNK_OVERLAP, DEFAULT_FILE_VIEWER_TEXT_CHUNK_
 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, 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 { getFileViewerOptionsSearchParam, normalizeFileViewerUiDensity, normalizeFileViewerTheme, parseFileViewerOptions, resolveFileViewerUiDensity, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './config/options.js';
 export { resolveFileViewerPresentationState, } from './presentation/state.js';
 export { createRendererRegistry, } from './registry/registry.js';
 export { createFileViewerRendererDispatcher, } from './rendering/dispatcher.js';

package/dist/index.d.ts

@@ -55,7 +55,7 @@ export { FALLBACK_FILE_VIEWER_LOADING_THEME, FILE_VIEWER_LOADING_THEME_MAP, appl
 export type { FileViewerLoadingController, FileViewerLoadingControllerActionHandlers, RunFileViewerLoadingExtensionSyncInput, } from './viewer/loading';
 export { createFileViewerLifecycleFacade, } from './lifecycle/facade';
 export type { BuildFileViewerLifecycleFacadeLoadStartStateInput, BuildFileViewerLifecycleFacadeRenderCompleteStateInput, CreateFileViewerLifecycleFacadeInput, FileViewerLifecycleFacade, } from './lifecycle/facade';
-export { getFileViewerOptionsSearchParam, normalizeFileViewerTheme, parseFileViewerOptions, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './config/options';
+export { getFileViewerOptionsSearchParam, normalizeFileViewerUiDensity, normalizeFileViewerTheme, parseFileViewerOptions, resolveFileViewerUiDensity, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './config/options';
 export { resolveFileViewerPresentationState, } from './presentation/state';
 export type { FileViewerPresentationState, ResolveFileViewerPresentationStateInput, } from './presentation/state';
 export { createFileViewerRendererDispatcher, } from './rendering/dispatcher';
@@ -85,4 +85,4 @@ export type { CreateFileViewerZoomControllerOptions, FileViewerZoomOperation, }
 export type { CreateViewerOptions } from './viewer/createViewer';
 export type { BuildExportHtmlDocumentOptions, BuildFileViewerRenderedHtmlDocumentOptions, } from './output/export';
 export type { CreateFileViewerWorkerControllerOptions, FileViewerWorkerContext, FileViewerWorkerController, FileViewerWorkerErrorHook, FileViewerWorkerEventHandler, FileViewerWorkerFactory, FileViewerWorkerMessageHook, WorkerProvider, WorkerRef, } from './platform/worker';
-export type { FileViewerAiOptions, FileViewerArchivePasswordRequestContext, FileViewerArchivePasswordRequestReason, FileViewerArchiveOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerGeoBasemapOptions, FileViewerGeoBasemapPreset, FileViewerGeoOptions, FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerNavigationState, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerPrintOptions, FileViewerPublicApi, FileViewerRenderedInstance, FileViewerRendererMode, FileViewerRendererPluginAssetKind, FileViewerRendererPluginAssetManifest, FileViewerRendererPluginAssetEntry, FileViewerRenderStateKind, FileViewerRendererCategory, FileViewerRendererHandlerRegistration, FileViewerRendererInstallContext, FileViewerRendererPlugin, FileViewerRendererPluginInput, FileViewerRendererPresetInput, FileViewerRendererPresetName, FileViewerRendererPreset, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerStyleIsolation, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarItem, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerResolvedToolbarItem, FileViewerTypstOptions, FileViewerViewScrollState, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateChangeAction, FileViewerViewStateChangeSource, FileViewerViewStateProvider, FileViewerWatermarkOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';
+export type { FileViewerAiOptions, FileViewerArchiveEntryActionContext, FileViewerArchiveEntryActionPolicy, FileViewerArchiveEntryActionsOptions, FileViewerArchivePasswordRequestContext, FileViewerArchivePasswordRequestReason, FileViewerArchiveOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerFitMode, FileViewerFitOptions, FileViewerFitRequest, FileViewerFitResize, FileViewerFitResult, FileViewerGeoBasemapOptions, FileViewerGeoBasemapPreset, FileViewerGeoOptions, FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerNavigationState, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfOptions, FileViewerPresentationOptions, FileViewerPrintOptions, FileViewerPublicApi, FileViewerRenderedInstance, FileViewerRendererMode, FileViewerRendererPluginAssetKind, FileViewerRendererPluginAssetManifest, FileViewerRendererPluginAssetEntry, FileViewerRenderStateKind, FileViewerRendererCategory, FileViewerRendererHandlerRegistration, FileViewerRendererInstallContext, FileViewerRendererPlugin, FileViewerRendererPluginInput, FileViewerRendererPresetInput, FileViewerRendererPresetName, FileViewerRendererPreset, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerStyleIsolation, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarItem, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerResolvedToolbarItem, FileViewerUiDensity, FileViewerUiOptions, FileViewerTypstOptions, FileViewerViewScrollState, FileViewerViewState, FileViewerViewStateChange, FileViewerViewStateChangeAction, FileViewerViewStateChangeSource, FileViewerViewStateProvider, FileViewerWatermarkOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';

package/dist/index.js

@@ -166,7 +166,7 @@ export { ADAPTER_PRINT_REQUIRED_EXTENSIONS, applyFileViewerZoomAvailability, cre
 export { FILE_VIEWER_LIFECYCLE_HOOKS, FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, DEFAULT_FILE_VIEWER_TOOLBAR_ORDER, FILE_VIEWER_LIFECYCLE_HOOK_ERROR_MESSAGE_PREFIX, 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, dispatchFileViewerOperationContextEvent, dispatchFileViewerOperationAvailabilityChange, dispatchFileViewerZoomChange, emitFileViewerComponentLifecycleEvent, getFileViewerBeforeOperationHooks, getFileViewerLifecycleHookName, hasVisibleFileViewerToolbarActions, isFileViewerToolbarOperationPermitted, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, reportFileViewerLifecycleHookError, reportFileViewerOperationError, resolveFileViewerLifecycleFallbackSource, resolveFileViewerLifecycleHookErrorMessage, resolveFileViewerBeforeOperationErrorMessage, resolveFileViewerOperationAvailability, resolveFileViewerToolbarOrder, resolveFileViewerToolbarState, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from './lifecycle/operations.js';
 export { FALLBACK_FILE_VIEWER_LOADING_THEME, FILE_VIEWER_LOADING_THEME_MAP, applyFileViewerLoadingState, cloneFileViewerLoadingState, createFileViewerLoadingController, createFileViewerLoadingControllerActionHandlers, createFileViewerLoadingState, createFileViewerLoadingStyleVars, runFileViewerLoadingControllerAction, runFileViewerLoadingExtensionSync, resolveFileViewerLoadingTheme, syncFileViewerLoadingControllerState, } from './viewer/loading.js';
 export { createFileViewerLifecycleFacade, } from './lifecycle/facade.js';
-export { getFileViewerOptionsSearchParam, normalizeFileViewerTheme, parseFileViewerOptions, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './config/options.js';
+export { getFileViewerOptionsSearchParam, normalizeFileViewerUiDensity, normalizeFileViewerTheme, parseFileViewerOptions, resolveFileViewerUiDensity, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './config/options.js';
 export { resolveFileViewerPresentationState, } from './presentation/state.js';
 export { createFileViewerRendererDispatcher, } from './rendering/dispatcher.js';
 export { appendFileViewerStyle, buildFileRenderContextFromLoadContext, applyFileViewerRenderSurfaceState, clearFileViewerRenderSurface, createFileRenderHandlerRendererSession, createFileRenderHandlerRegistry, createFileRenderHandlerLoader, createFileViewerRenderSurfaceActionHandlers, createFileViewerRenderReadinessTarget, createFileViewerRenderSurface, createFileViewerRenderSurfaceState, createFileViewerRenderSurfaceStateTarget, createFileViewerRenderTarget, DEFAULT_FILE_VIEWER_RENDER_TARGET_CLASS, DEFAULT_FILE_VIEWER_RENDER_SESSION_DISPOSE_ERROR_LOGGER, FILE_VIEWER_RENDER_SESSION_DISPOSE_ERROR_MESSAGE, disposeActiveFileViewerRendererSession, disposeFileViewerRendered, disposeFileViewerRendererSession, getFileViewerShadowRootForNode, isFileViewerShadowRoot, normalizeFileViewerStyleIsolation, removeFileViewerRenderTarget, reportFileViewerRenderSessionDisposeError, resetFileViewerRenderSurface, resolveFileViewerStyleIsolation, resolveFileViewerRenderSessionDisposeErrorMessage, runFileViewerRenderSurfaceClear, runFileViewerRenderSurfaceMount, renderFileViewerHandler, } from './rendering/handler.js';

package/dist/presentation/state.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerFileRef, FileViewerOptions, FileViewerThemeMode, FileViewerToolbarOptions } from '../contracts/types';
+import type { FileViewerFileRef, FileViewerOptions, FileViewerThemeMode, FileViewerToolbarOptions, FileViewerUiDensity } from '../contracts/types';
 export interface ResolveFileViewerPresentationStateInput {
     filename?: string;
     file?: FileViewerFileRef;
@@ -10,5 +10,6 @@ export interface FileViewerPresentationState {
     extension: string;
     toolbar: FileViewerToolbarOptions;
     theme: FileViewerThemeMode;
+    density: FileViewerUiDensity;
 }
 export declare const resolveFileViewerPresentationState: ({ filename, file, url, options, }: ResolveFileViewerPresentationStateInput) => FileViewerPresentationState;

package/dist/presentation/state.js

@@ -1,5 +1,5 @@
 import { normalizeFileViewerToolbar } from '../lifecycle/operations.js';
-import { normalizeFileViewerTheme } from '../config/options.js';
+import { normalizeFileViewerTheme, resolveFileViewerUiDensity } from '../config/options.js';
 import { getExtension, resolveFileViewerSourceFilename } from '../source/index.js';
 export const resolveFileViewerPresentationState = ({ filename, file, url, options, }) => {
     const displayFilename = resolveFileViewerSourceFilename({
@@ -12,5 +12,6 @@ export const resolveFileViewerPresentationState = ({ filename, file, url, option
         extension: getExtension(displayFilename),
         toolbar: normalizeFileViewerToolbar(options),
         theme: normalizeFileViewerTheme(options === null || options === void 0 ? void 0 : options.theme),
+        density: resolveFileViewerUiDensity(options),
     };
 };

package/dist/renderers/image.js

@@ -1,4 +1,5 @@
 import { registerFileViewerZoomProvider, unregisterFileViewerZoomProvider, } from '../features/document/dom/index.js';
+import { resolveFileViewerFitScale, } from '../features/document/fit.js';
 import { createFileViewerTranslator } from '../i18n/messages.js';
 import { createFileViewerZoomChangeEmitter as createZoomChangeEmitter } from '../features/document/zoom.js';
 const imageMimeMap = {
@@ -175,6 +176,51 @@ export default async function renderImage(buffer, target, type, context) {
         zoomEmitter.emit();
         return getZoomState();
     };
+    const fitImage = (request) => {
+        var _a, _b;
+        const naturalWidth = image.naturalWidth || 0;
+        const naturalHeight = image.naturalHeight || 0;
+        if (!naturalWidth || !naturalHeight) {
+            return {
+                applied: false,
+                mode: request.mode,
+                resize: request.resize,
+                source: request.source,
+                reason: 'image-not-ready',
+                provider: 'zoom',
+            };
+        }
+        const mode = request.mode === 'auto' ? 'scale-down' : request.mode;
+        const scale = resolveFileViewerFitScale({
+            mode,
+            viewportWidth: Math.max(1, request.viewportWidth || root.clientWidth || 0),
+            viewportHeight: Math.max(1, request.viewportHeight || root.clientHeight || viewportHeight || 0),
+            contentWidth: naturalWidth,
+            contentHeight: naturalHeight,
+            currentScale,
+            minScale: (_a = request.minScale) !== null && _a !== void 0 ? _a : getMinScale(),
+            maxScale: (_b = request.maxScale) !== null && _b !== void 0 ? _b : 5,
+        });
+        if (!scale) {
+            return {
+                applied: false,
+                mode: request.mode,
+                resize: request.resize,
+                source: request.source,
+                reason: 'unmeasurable',
+                provider: 'zoom',
+            };
+        }
+        const state = setZoom(scale);
+        return {
+            applied: true,
+            mode: request.mode,
+            resize: request.resize,
+            scale: state.scale,
+            source: request.source,
+            provider: 'zoom',
+        };
+    };
     registerFileViewerZoomProvider(root, {
         zoomIn: () => setZoom(currentScale + 0.15),
         zoomOut: () => setZoom(currentScale - 0.15),
@@ -185,6 +231,7 @@ export default async function renderImage(buffer, target, type, context) {
             return getZoomState();
         },
         setZoom,
+        fit: fitImage,
         getState: getZoomState,
         subscribe: zoomEmitter.subscribe,
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/core",
-  "version": "2.1.18",
+  "version": "2.1.20",
   "private": false,
   "type": "module",
   "description": "Framework-neutral modular TypeScript core for Flyfish File Viewer renderer orchestration, lifecycle APIs, search, zoom, print, and export",