@file-viewer/core 2.1.13 → 2.1.15

package/dist/headless.js

@@ -4,7 +4,7 @@
 // lifecycle operations, and renderer registry utilities without importing any
 // framework wrapper. It is the safest entrypoint for React/Vue/Web packages.
 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.js';
-export { ADAPTER_PRINT_REQUIRED_EXTENSIONS, createUnsupportedAvailability, DEFAULT_OPERATION_AVAILABILITY, DOM_PRINTABLE_EXTENSIONS, getRendererAvailability, isDomPrintableExtension, isKnownNonPrintableExtension, needsDedicatedPrintAdapter, NON_PRINTABLE_EXTENSIONS, resolvePrintAvailability, } from './registry/capabilities.js';
+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';

package/dist/i18n/messages.js

@@ -195,7 +195,7 @@ const ZH_CN_MESSAGES = {
     'psd.layers.hidden': '隐藏',
     'drawing.error.viewerLoadFailed': 'diagrams.net viewer 加载失败',
     'drawing.error.excalidrawEmpty': 'Excalidraw 文件中没有可预览图元',
-    'drawing.error.excalidrawTimeout': 'Excalidraw 官方导出超时，自动切换 rough.js 兼容渲染',
+    'drawing.error.excalidrawTimeout': 'Excalidraw SVG 导出超时，自动切换 rough.js 兼容渲染',
     'drawing.error.drawioParseFailed': 'Draw.io XML 解析失败：{message}',
     'drawing.error.drawioNoModel': '当前 Draw.io 文件没有可直接渲染的 mxGraphModel。',
     'drawing.error.drawioNoElements': '当前 Draw.io 文件没有可预览图元。',
@@ -203,7 +203,7 @@ const ZH_CN_MESSAGES = {
     'drawing.error.drawioTimeout': 'diagrams.net 官方 Viewer 加载超时，自动切换本地 SVG 预览',
     'drawing.error.svgParseFailed': 'SVG 解析失败',
     'drawing.error.plantumlRenderFailed': 'PlantUML SVG 渲染失败：{status}',
-    'drawing.title.excalidraw': 'Excalidraw 官方 SVG 预览',
+    'drawing.title.excalidraw': 'Excalidraw SVG 预览',
     'drawing.title.mermaid': 'Mermaid SVG 预览',
     'drawing.title.plantuml': 'PlantUML SVG 预览',
     'drawing.title.drawio': 'Draw.io 离线 SVG 预览',
@@ -567,7 +567,7 @@ const EN_US_MESSAGES = {
     'psd.layers.hidden': 'hidden',
     'drawing.error.viewerLoadFailed': 'Failed to load the diagrams.net viewer',
     'drawing.error.excalidrawEmpty': 'This Excalidraw file has no previewable elements',
-    'drawing.error.excalidrawTimeout': 'Official Excalidraw export timed out. Falling back to the rough.js renderer.',
+    'drawing.error.excalidrawTimeout': 'Excalidraw SVG export timed out. Falling back to the rough.js renderer.',
     'drawing.error.drawioParseFailed': 'Failed to parse Draw.io XML: {message}',
     'drawing.error.drawioNoModel': 'This Draw.io file has no directly renderable mxGraphModel.',
     'drawing.error.drawioNoElements': 'This Draw.io file has no previewable elements.',
@@ -575,7 +575,7 @@ const EN_US_MESSAGES = {
     'drawing.error.drawioTimeout': 'Official diagrams.net Viewer timed out. Falling back to the local SVG preview.',
     'drawing.error.svgParseFailed': 'Failed to parse SVG',
     'drawing.error.plantumlRenderFailed': 'Failed to render PlantUML SVG: {status}',
-    'drawing.title.excalidraw': 'Official Excalidraw SVG preview',
+    'drawing.title.excalidraw': 'Excalidraw SVG preview',
     'drawing.title.mermaid': 'Mermaid SVG preview',
     'drawing.title.plantuml': 'PlantUML SVG preview',
     'drawing.title.drawio': 'Draw.io offline SVG preview',

package/dist/index.d.ts

@@ -8,7 +8,9 @@ export { createFileViewerDocumentFeatureActions, createFileViewerDocumentFeature
 export type { CreateFileViewerDocumentChangeSnapshotInput, FileViewerDocumentFeatureActionOptions, DispatchFileViewerLocationChangeInput, DispatchFileViewerSearchChangeInput, FileViewerDocumentChangeSnapshot, FileViewerDocumentFeatureActions, FileViewerDocumentFeatureControllerActionHandlers, FileViewerDocumentFeatureSearchController, CreateFileViewerDocumentFeatureActionsInput, CreateFileViewerDocumentFeatureControllerActionHandlersInput, ResolveFileViewerLocationChangeAnchorInput, } from './features/document/events';
 export { applyFileViewerZoomState, clearFileViewerZoomControllerProvider, createFileViewerZoomChangeEmitter, createFileViewerZoomChangeState, cloneFileViewerZoomState, createFileViewerZoomController, createFileViewerZoomControllerActionHandlers, destroyFileViewerZoomController, observeFileViewerZoomController, refreshFileViewerZoomControllerProvider, runFileViewerZoomControllerAction, syncFileViewerZoomControllerState, } from './features/document/zoom';
 export type { FileViewerZoomController, FileViewerZoomControllerActionHandlers, MutableFileViewerZoomState, } from './features/document/zoom';
-export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, findFileViewerZoomProvider, getCurrentFileViewerDocumentAnchor, getFileViewerScrollableRange, isFileViewerScrollableElement, registerFileViewerSearchProvider, registerFileViewerZoomProvider, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from './features/document/dom';
+export { cloneFileViewerViewState, createFileViewerViewStateChange, createFileViewerViewStateChangeEmitter, createFileViewerViewStateController, createFileViewerViewStateControllerActionHandlers, registerFileViewerGenericViewStateProvider, } from './features/document/viewState';
+export type { CreateFileViewerViewStateControllerOptions, FileViewerGenericViewStateProviderRegistration, FileViewerViewStateController, FileViewerViewStateControllerActionHandlers, RegisterFileViewerGenericViewStateProviderOptions, } from './features/document/viewState';
+export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, getCurrentFileViewerDocumentAnchor, getFileViewerScrollableRange, isFileViewerScrollableElement, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from './features/document/dom';
 export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout';
 export type { ApplyPrintPageSizeOptions, BuildPrintPageStyleOptions, PrintPageSize, } from './output/printLayout';
@@ -44,7 +46,7 @@ export declare const renderFileViewerWordDoc: (buffer: ArrayBuffer, target: HTML
 export declare const renderFileViewerWordDocx: (buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
 export declare const renderFileViewerSpreadsheet: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
 export declare const parseEdaFile: (buffer: ArrayBuffer, type?: string) => Promise<never>;
-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 { FILE_VIEWER_LIFECYCLE_HOOKS, FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, 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, resolveFileViewerToolbarState, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from './lifecycle/operations';
 export type { BuildFileViewerOperationContextFromLifecycleStateInput, CreateFileViewerLifecycleActionsInput, DispatchFileViewerLifecycleEventInput, DispatchFileViewerOperationContextEventInput, DispatchFileViewerOperationAvailabilityChangeInput, DispatchFileViewerZoomChangeInput, FileViewerActiveUnloadState, FileViewerLifecycleActions, FileViewerLifecycleComponentEmit, FileViewerToolbarActions, FileViewerToolbarControllerActionHandlers, FileViewerToolbarZoomSyncSnapshot, FileViewerZoomButtonAction, FileViewerToolbarState, CreateFileViewerPublicApiInput, CreateFileViewerToolbarActionsInput, CreateFileViewerToolbarControllerActionHandlersInput, BuildFileViewerLifecycleContextFromNormalizedSourceInput, ResolveFileViewerBeforeOperationErrorMessageInput, ResolveFileViewerToolbarStateInput, RunFileViewerActiveUnloadCompleteInput, RunFileViewerActiveUnloadStartInput, RunFileViewerToolbarAvailabilitySyncInput, RunFileViewerToolbarZoomSyncInput, } from './lifecycle/operations';
 export { FALLBACK_FILE_VIEWER_LOADING_THEME, FILE_VIEWER_LOADING_THEME_MAP, applyFileViewerLoadingState, cloneFileViewerLoadingState, createFileViewerLoadingController, createFileViewerLoadingControllerActionHandlers, createFileViewerLoadingState, createFileViewerLoadingStyleVars, runFileViewerLoadingControllerAction, runFileViewerLoadingExtensionSync, resolveFileViewerLoadingTheme, syncFileViewerLoadingControllerState, } from './viewer/loading';
@@ -75,10 +77,10 @@ export type { FileViewerSerializableCadOptions, FileViewerSerializableOptions, F
 export type { InstallFileViewerRendererPluginsOptions, } from './registry/registry';
 export type { CreateFileViewerRendererDispatcherOptions, FileViewerRendererDispatcher, FileViewerRendererHandlerEntry, } from './rendering/dispatcher';
 export type { CreateFileViewerRenderTargetOptions, CreateFileRenderHandlerRegistryOptions, CreateFileRenderHandlerLoaderOptions, DisposeFileViewerRendererSessionOptions, FileRenderHandlerRegistryResult, FileRenderHandlerRendererSession, RenderFileViewerHandlerInput, } from './rendering/handler';
-export type { FileViewerSearchProviderHost, ResolveFileViewerScrollContainerOptions, FileViewerZoomProviderHost, } from './features/document/dom';
+export type { FileViewerSearchProviderHost, ResolveFileViewerScrollContainerOptions, FileViewerViewStateProviderHost, FileViewerZoomProviderHost, } from './features/document/dom';
 export type { CreateFileViewerDomSearchControllerOptions, FileViewerInternalSearchMatch, } from './features/document/search';
 export type { CreateFileViewerZoomControllerOptions, FileViewerZoomOperation, } from './features/document/zoom';
 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, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileViewerGeoBasemapOptions, FileViewerGeoBasemapPreset, FileViewerGeoOptions, FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfOptions, 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, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerTypstOptions, FileViewerWatermarkOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';
+export type { FileViewerAiOptions, FileViewerArchivePasswordRequestContext, FileViewerArchivePasswordRequestReason, FileViewerArchiveOptions, FileViewerApplyViewStateOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, 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, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarOptions, FileViewerToolbarPosition, 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

@@ -4,7 +4,8 @@ export { DEFAULT_FILE_VIEWER_TEXT_CHUNK_OVERLAP, DEFAULT_FILE_VIEWER_TEXT_CHUNK_
 export { DEFAULT_FILE_VIEWER_SEARCH_ACTIVE_CLASS, DEFAULT_FILE_VIEWER_SEARCH_MATCH_CLASS, DEFAULT_FILE_VIEWER_SEARCH_MAX_MATCHES, applyFileViewerSearchState, cloneFileViewerSearchState, createFileViewerDomSearchController, createFileViewerDomSearchControllerActionHandlers, destroyFileViewerDomSearchController, observeFileViewerDomSearchController, runFileViewerDomSearchControllerAction, syncFileViewerDomSearchControllerState, } from './features/document/search.js';
 export { createFileViewerDocumentFeatureActions, createFileViewerDocumentFeatureControllerActionHandlers, createFileViewerDocumentChangeSnapshot, createFileViewerSearchChangeState, dispatchFileViewerLocationChange, dispatchFileViewerSearchChange, resolveFileViewerLocationChangeAnchor, } from './features/document/events.js';
 export { applyFileViewerZoomState, clearFileViewerZoomControllerProvider, createFileViewerZoomChangeEmitter, createFileViewerZoomChangeState, cloneFileViewerZoomState, createFileViewerZoomController, createFileViewerZoomControllerActionHandlers, destroyFileViewerZoomController, observeFileViewerZoomController, refreshFileViewerZoomControllerProvider, runFileViewerZoomControllerAction, syncFileViewerZoomControllerState, } from './features/document/zoom.js';
-export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, findFileViewerZoomProvider, getCurrentFileViewerDocumentAnchor, getFileViewerScrollableRange, isFileViewerScrollableElement, registerFileViewerSearchProvider, registerFileViewerZoomProvider, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, unregisterFileViewerSearchProvider, unregisterFileViewerZoomProvider, } from './features/document/dom/index.js';
+export { cloneFileViewerViewState, createFileViewerViewStateChange, createFileViewerViewStateChangeEmitter, createFileViewerViewStateController, createFileViewerViewStateControllerActionHandlers, registerFileViewerGenericViewStateProvider, } from './features/document/viewState.js';
+export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_CANDIDATE_SELECTOR, DEFAULT_FILE_VIEWER_SCROLL_CONTAINER_SELECTOR, DEFAULT_FILE_VIEWER_SCROLLABLE_OVERFLOW_VALUES, collectFileViewerDocumentAnchors, findFileViewerAnchorForElement, findFileViewerSearchProvider, findFileViewerViewStateProvider, findFileViewerZoomProvider, getCurrentFileViewerDocumentAnchor, getFileViewerScrollableRange, isFileViewerScrollableElement, registerFileViewerSearchProvider, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, resolveFileViewerScrollContainer, scrollToFileViewerDocumentAnchor, unregisterFileViewerSearchProvider, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from './features/document/dom/index.js';
 export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export.js';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout.js';
 export { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, FILE_VIEWER_OPERATION_ACTION_ERROR_PREFIXES, createFileViewerOperationActionHandlers, createFileViewerOriginalSourceState, createFileViewerOriginalSourceStateFromNormalizedSource, createFileViewerPublicOperationActionHandlers, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, hasFileViewerOriginalSource, resolveFileViewerDisplayFilename, resolveFileViewerOperationActionErrorMessage, resolveFileViewerOperationFilename, resolveFileViewerOriginalFilename, } from './viewer/operations.js';
@@ -160,7 +161,7 @@ export const parseEdaFile = async (buffer, type) => {
     void type;
     throw new Error('EDA parsing has moved out of @file-viewer/core. Import parseEdaFile from @file-viewer/renderer-eda instead.');
 };
-export { ADAPTER_PRINT_REQUIRED_EXTENSIONS, createUnsupportedAvailability, DEFAULT_OPERATION_AVAILABILITY, DOM_PRINTABLE_EXTENSIONS, getRendererAvailability, isDomPrintableExtension, isKnownNonPrintableExtension, needsDedicatedPrintAdapter, NON_PRINTABLE_EXTENSIONS, resolvePrintAvailability, } from './registry/capabilities.js';
+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 { FILE_VIEWER_LIFECYCLE_HOOKS, FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, 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, 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';

package/dist/registry/capabilities.d.ts

@@ -1,6 +1,7 @@
-import type { FileRenderExportAdapter, FileViewerOperationAvailability, RendererDefinition, RendererSession } from '../contracts/types';
+import type { FileRenderExportAdapter, FileViewerOperationAvailability, FileViewerZoomState, RendererDefinition, RendererSession } from '../contracts/types';
 export declare const DEFAULT_OPERATION_AVAILABILITY: FileViewerOperationAvailability;
 export declare const getRendererAvailability: (renderer: RendererDefinition | undefined, session?: RendererSession | null) => FileViewerOperationAvailability;
+export declare const applyFileViewerZoomAvailability: (availability: FileViewerOperationAvailability, zoomState: FileViewerZoomState) => FileViewerOperationAvailability;
 export declare const createUnsupportedAvailability: (extension: string) => FileViewerOperationAvailability;
 /**
  * 这些格式只有专属适配器准备好后才展示打印。

package/dist/registry/capabilities.js

@@ -31,6 +31,16 @@ export const getRendererAvailability = (renderer, session) => {
         ...(_h = session === null || session === void 0 ? void 0 : session.getAvailability) === null || _h === void 0 ? void 0 : _h.call(session),
     };
 };
+export const applyFileViewerZoomAvailability = (availability, zoomState) => {
+    const zoom = availability.zoom && (zoomState.canZoomIn || zoomState.canZoomOut || zoomState.canReset);
+    return {
+        ...availability,
+        zoom,
+        zoomIn: zoom && zoomState.canZoomIn,
+        zoomOut: zoom && zoomState.canZoomOut,
+        zoomReset: zoom && zoomState.canReset,
+    };
+};
 export const createUnsupportedAvailability = (extension) => ({
     ...DEFAULT_OPERATION_AVAILABILITY,
     download: normalizeFileExtension(extension).length > 0,

package/dist/renderers/image.js

@@ -60,15 +60,8 @@ const resolveImageUrl = async (buffer, type) => {
     }
     return readBlobDataUrl(new Blob([buffer], { type: getImageBlobType(normalizedType) }));
 };
-const clampZoom = (value) => {
-    return Math.min(5, Math.max(0.1, Number(value.toFixed(2))));
-};
-const applyImageZoom = (image, viewportHeight, zoom) => {
-    if (viewportHeight > 0) {
-        image.style.height = `${Math.max(1, Math.round(viewportHeight * zoom))}px`;
-        return;
-    }
-    image.style.height = `${zoom * 100}%`;
+const roundImageScale = (value) => {
+    return Number(value.toFixed(3));
 };
 const createLightbox = (src) => {
     const lightbox = document.createElement('div');
@@ -108,7 +101,9 @@ const createLightbox = (src) => {
 };
 export default async function renderImage(buffer, target, type) {
     const src = await resolveImageUrl(buffer, type);
-    let zoom = 1;
+    let userZoom = 1;
+    let fitScale = 1;
+    let currentScale = 1;
     let viewportHeight = 0;
     const zoomEmitter = createZoomChangeEmitter();
     const root = document.createElement('div');
@@ -125,32 +120,67 @@ export default async function renderImage(buffer, target, type) {
     const openLightbox = () => lightbox.open();
     image.addEventListener('click', openLightbox);
     document.body.append(lightbox.element);
+    const getMinScale = () => Math.min(0.1, fitScale || 0.1);
+    const clampScale = (value) => {
+        const minScale = getMinScale();
+        return Math.min(5, Math.max(minScale, roundImageScale(value)));
+    };
+    const computeFitScale = () => {
+        const naturalWidth = image.naturalWidth || 0;
+        const naturalHeight = image.naturalHeight || 0;
+        if (!naturalWidth || !naturalHeight) {
+            return 1;
+        }
+        const availableWidth = Math.max((root.clientWidth || 0) - 48, 1);
+        const availableHeight = Math.max((root.clientHeight || viewportHeight || 0) - 48, 1);
+        return Math.min(1, availableWidth / naturalWidth, availableHeight / naturalHeight);
+    };
+    const applyImageZoom = () => {
+        fitScale = computeFitScale();
+        currentScale = clampScale(fitScale * userZoom);
+        if (image.naturalWidth && image.naturalHeight) {
+            image.style.width = `${Math.max(1, Math.round(image.naturalWidth * currentScale))}px`;
+            image.style.height = `${Math.max(1, Math.round(image.naturalHeight * currentScale))}px`;
+            return;
+        }
+        image.style.width = 'auto';
+        image.style.height = viewportHeight > 0
+            ? `${Math.max(1, Math.round(viewportHeight * userZoom))}px`
+            : `${userZoom * 100}%`;
+    };
     const updateViewportSize = () => {
         viewportHeight = root.clientHeight || 0;
-        applyImageZoom(image, viewportHeight, zoom);
+        applyImageZoom();
         zoomEmitter.emit();
     };
     const resizeObserver = new ResizeObserver(updateViewportSize);
     resizeObserver.observe(root);
+    image.addEventListener('load', updateViewportSize);
     const getZoomState = () => ({
-        scale: zoom,
-        label: `${Math.round(zoom * 100)}%`,
-        canZoomIn: zoom < 5,
-        canZoomOut: zoom > 0.1,
-        canReset: zoom !== 1,
-        minScale: 0.1,
+        scale: currentScale,
+        label: `${Math.round(currentScale * 100)}%`,
+        canZoomIn: currentScale < 5,
+        canZoomOut: currentScale > getMinScale(),
+        canReset: Math.abs(userZoom - 1) > 0.001,
+        minScale: getMinScale(),
         maxScale: 5,
     });
     const setZoom = (scale) => {
-        zoom = clampZoom(scale);
-        applyImageZoom(image, viewportHeight, zoom);
+        const nextScale = clampScale(scale);
+        userZoom = nextScale / Math.max(fitScale, 0.001);
+        applyImageZoom();
         zoomEmitter.emit();
         return getZoomState();
     };
     registerFileViewerZoomProvider(root, {
-        zoomIn: () => setZoom(zoom + 0.15),
-        zoomOut: () => setZoom(zoom - 0.15),
-        resetZoom: () => setZoom(1),
+        zoomIn: () => setZoom(currentScale + 0.15),
+        zoomOut: () => setZoom(currentScale - 0.15),
+        resetZoom: () => {
+            userZoom = 1;
+            applyImageZoom();
+            zoomEmitter.emit();
+            return getZoomState();
+        },
         setZoom,
         getState: getZoomState,
         subscribe: zoomEmitter.subscribe,
@@ -162,6 +192,7 @@ export default async function renderImage(buffer, target, type) {
         unmount() {
             unregisterFileViewerZoomProvider(root);
             resizeObserver.disconnect();
+            image.removeEventListener('load', updateViewportSize);
             image.removeEventListener('click', openLightbox);
             lightbox.destroy();
             target.replaceChildren();

package/dist/rendering/handler.d.ts

@@ -20,6 +20,7 @@ export interface RenderFileViewerHandlerInput<Rendered = unknown, Target extends
 }
 export interface CreateFileRenderHandlerLoaderOptions<Rendered = unknown, Target extends HTMLElement = HTMLElement> {
     handler: FileRenderHandler<Rendered, Target>;
+    rendererId?: string;
     getTarget?: (context: RendererLoadContext) => Target;
     createContext?: (context: RendererLoadContext) => FileRenderContext;
     destroy?: (rendered: Rendered, context: RendererLoadContext) => void | Promise<void>;
@@ -82,8 +83,10 @@ export interface RunFileViewerRenderSurfaceMountInput<Session extends RendererSe
     waitForPaint?: () => Promise<unknown> | unknown;
     disposeSession?: (session?: Session | null) => void;
     onStartZoomObserver?: () => void;
+    onStartViewStateObserver?: () => void;
     onRefreshDocumentIndex?: () => Promise<unknown> | unknown;
     onRefreshZoomProvider?: () => void;
+    onRefreshViewStateProvider?: () => void;
 }
 export interface RunFileViewerRenderSurfaceClearInput<Session extends RendererSession = RendererSession, UnloadContext = FileViewerLifecycleContext | null> {
     reason?: FileViewerLifecycleContext['reason'];
@@ -97,6 +100,8 @@ export interface RunFileViewerRenderSurfaceClearInput<Session extends RendererSe
     onClearDocumentState?: () => void;
     onStopZoomObserver?: () => void;
     onClearZoomProvider?: () => void;
+    onStopViewStateObserver?: () => void;
+    onClearViewStateProvider?: () => void;
 }
 export interface FileViewerRenderSurfaceClearState<Session extends RendererSession = RendererSession, UnloadContext = FileViewerLifecycleContext | null> {
     reason: FileViewerLifecycleContext['reason'];
@@ -125,8 +130,12 @@ export interface CreateFileViewerRenderSurfaceActionHandlersInput<Session extend
     onStartZoomObserver?: () => void;
     onStopZoomObserver?: () => void;
     onClearZoomProvider?: () => void;
+    onStartViewStateObserver?: () => void;
+    onStopViewStateObserver?: () => void;
+    onClearViewStateProvider?: () => void;
     onRefreshDocumentIndex?: () => Promise<unknown> | unknown;
     onRefreshZoomProvider?: () => void;
+    onRefreshViewStateProvider?: () => void;
 }
 export declare const DEFAULT_FILE_VIEWER_RENDER_TARGET_CLASS = "file-render";
 export declare const clearFileViewerRenderSurface: (container?: HTMLElement | null) => void;
@@ -156,10 +165,10 @@ export declare const reportFileViewerRenderSessionDisposeError: ({ error, onLogE
 export declare const disposeFileViewerRendererSession: (session?: RendererSession | null, options?: DisposeFileViewerRendererSessionOptions) => void;
 export declare const disposeActiveFileViewerRendererSession: <Session extends RendererSession, Target extends MutableFileViewerRenderSurfaceState<Session>>(target: Target, options?: DisposeFileViewerRendererSessionOptions) => Session | null;
 export declare const resetFileViewerRenderSurface: <Session extends RendererSession>({ surfaceState, readinessState, container, disposeOptions, }: ResetFileViewerRenderSurfaceInput<Session>) => Session | null;
-export declare const runFileViewerRenderSurfaceClear: <Session extends RendererSession, UnloadContext = FileViewerLifecycleContext | null>({ reason, surfaceState, readinessState, container, disposeOptions, onUnloadStart, onUnloadComplete, onClearActiveDocumentContext, onClearDocumentState, onStopZoomObserver, onClearZoomProvider, }: RunFileViewerRenderSurfaceClearInput<Session, UnloadContext>) => FileViewerRenderSurfaceClearState<Session, UnloadContext>;
-export declare const runFileViewerRenderSurfaceMount: <Session extends RendererSession>({ buffer, file, version, sourceUrl, streamUrl, getContainer, surfaceState, readinessState, isCurrent, clearRenderedContent, render, waitForContainer, waitForPaint, disposeSession, onStartZoomObserver, onRefreshDocumentIndex, onRefreshZoomProvider, }: RunFileViewerRenderSurfaceMountInput<Session>) => Promise<Session | undefined>;
-export declare const createFileViewerRenderSurfaceActionHandlers: <Session extends RendererSession, UnloadContext = FileViewerLifecycleContext | null>({ getContainer, surfaceState, readinessState, isCurrent, render, waitForContainer, waitForPaint, disposeOptions, onUnloadStart, onUnloadComplete, onClearActiveDocumentContext, onClearDocumentState, onStartZoomObserver, onStopZoomObserver, onClearZoomProvider, onRefreshDocumentIndex, onRefreshZoomProvider, }: CreateFileViewerRenderSurfaceActionHandlersInput<Session, UnloadContext>) => FileViewerRenderSurfaceActionHandlers<Session, UnloadContext>;
+export declare const runFileViewerRenderSurfaceClear: <Session extends RendererSession, UnloadContext = FileViewerLifecycleContext | null>({ reason, surfaceState, readinessState, container, disposeOptions, onUnloadStart, onUnloadComplete, onClearActiveDocumentContext, onClearDocumentState, onStopZoomObserver, onClearZoomProvider, onStopViewStateObserver, onClearViewStateProvider, }: RunFileViewerRenderSurfaceClearInput<Session, UnloadContext>) => FileViewerRenderSurfaceClearState<Session, UnloadContext>;
+export declare const runFileViewerRenderSurfaceMount: <Session extends RendererSession>({ buffer, file, version, sourceUrl, streamUrl, getContainer, surfaceState, readinessState, isCurrent, clearRenderedContent, render, waitForContainer, waitForPaint, disposeSession, onStartZoomObserver, onStartViewStateObserver, onRefreshDocumentIndex, onRefreshZoomProvider, onRefreshViewStateProvider, }: RunFileViewerRenderSurfaceMountInput<Session>) => Promise<Session | undefined>;
+export declare const createFileViewerRenderSurfaceActionHandlers: <Session extends RendererSession, UnloadContext = FileViewerLifecycleContext | null>({ getContainer, surfaceState, readinessState, isCurrent, render, waitForContainer, waitForPaint, disposeOptions, onUnloadStart, onUnloadComplete, onClearActiveDocumentContext, onClearDocumentState, onStartZoomObserver, onStopZoomObserver, onClearZoomProvider, onStartViewStateObserver, onStopViewStateObserver, onClearViewStateProvider, onRefreshDocumentIndex, onRefreshZoomProvider, onRefreshViewStateProvider, }: CreateFileViewerRenderSurfaceActionHandlersInput<Session, UnloadContext>) => FileViewerRenderSurfaceActionHandlers<Session, UnloadContext>;
 export declare const buildFileRenderContextFromLoadContext: ({ source, options, registerExportAdapter, renderContext, }: RendererLoadContext) => FileRenderContext;
 export declare const renderFileViewerHandler: <Rendered = unknown, Target extends HTMLElement = HTMLElement>({ dispatcher, buffer, target, type, context, throwOnMissingHandler, }: RenderFileViewerHandlerInput<Rendered, Target>) => Promise<Rendered | undefined>;
-export declare const createFileRenderHandlerLoader: <Rendered = unknown, Target extends HTMLElement = HTMLElement>({ handler, getTarget, createContext, destroy, }: CreateFileRenderHandlerLoaderOptions<Rendered, Target>) => RendererLoader;
+export declare const createFileRenderHandlerLoader: <Rendered = unknown, Target extends HTMLElement = HTMLElement>({ handler, rendererId, getTarget, createContext, destroy, }: CreateFileRenderHandlerLoaderOptions<Rendered, Target>) => RendererLoader;
 export declare const createFileRenderHandlerRegistry: <Rendered = unknown, Target extends HTMLElement = HTMLElement>({ definitions, handlers, getTarget, createContext, destroy, }: CreateFileRenderHandlerRegistryOptions<Rendered, Target>) => FileRenderHandlerRegistryResult<Rendered, Target>;

package/dist/rendering/handler.js

@@ -9,6 +9,8 @@ import { createFileViewerRendererDispatcher } from './dispatcher.js';
 import { createRendererRegistry } from '../registry/registry.js';
 import { getExtension, normalizeFileExtension } from '../source/index.js';
 import { applyFileViewerRenderReadinessState, } from '../source/loading.js';
+import { findFileViewerViewStateProvider } from '../features/document/dom/index.js';
+import { registerFileViewerGenericViewStateProvider } from '../features/document/viewState.js';
 export const FILE_VIEWER_RENDER_SESSION_DISPOSE_ERROR_MESSAGE = '预览内容卸载失败';
 export const DEFAULT_FILE_VIEWER_RENDER_TARGET_CLASS = 'file-render';
 const isPromiseLike = (value) => {
@@ -156,7 +158,7 @@ export const resetFileViewerRenderSurface = ({ surfaceState, readinessState, con
     clearFileViewerRenderSurface(container);
     return session;
 };
-export const runFileViewerRenderSurfaceClear = ({ reason = 'replace', surfaceState, readinessState, container, disposeOptions, onUnloadStart, onUnloadComplete, onClearActiveDocumentContext, onClearDocumentState, onStopZoomObserver, onClearZoomProvider, }) => {
+export const runFileViewerRenderSurfaceClear = ({ reason = 'replace', surfaceState, readinessState, container, disposeOptions, onUnloadStart, onUnloadComplete, onClearActiveDocumentContext, onClearDocumentState, onStopZoomObserver, onClearZoomProvider, onStopViewStateObserver, onClearViewStateProvider, }) => {
     const unloadContext = onUnloadStart === null || onUnloadStart === void 0 ? void 0 : onUnloadStart(reason);
     let session;
     try {
@@ -172,6 +174,8 @@ export const runFileViewerRenderSurfaceClear = ({ reason = 'replace', surfaceSta
         onClearDocumentState === null || onClearDocumentState === void 0 ? void 0 : onClearDocumentState();
         onStopZoomObserver === null || onStopZoomObserver === void 0 ? void 0 : onStopZoomObserver();
         onClearZoomProvider === null || onClearZoomProvider === void 0 ? void 0 : onClearZoomProvider();
+        onStopViewStateObserver === null || onStopViewStateObserver === void 0 ? void 0 : onStopViewStateObserver();
+        onClearViewStateProvider === null || onClearViewStateProvider === void 0 ? void 0 : onClearViewStateProvider();
     }
     onUnloadComplete === null || onUnloadComplete === void 0 ? void 0 : onUnloadComplete(unloadContext, reason);
     return {
@@ -180,7 +184,7 @@ export const runFileViewerRenderSurfaceClear = ({ reason = 'replace', surfaceSta
         session,
     };
 };
-export const runFileViewerRenderSurfaceMount = async ({ buffer, file, version, sourceUrl, streamUrl, getContainer, surfaceState, readinessState, isCurrent, clearRenderedContent, render, waitForContainer, waitForPaint = waitForFileViewerNextPaint, disposeSession = disposeFileViewerRendererSession, onStartZoomObserver, onRefreshDocumentIndex, onRefreshZoomProvider, }) => {
+export const runFileViewerRenderSurfaceMount = async ({ buffer, file, version, sourceUrl, streamUrl, getContainer, surfaceState, readinessState, isCurrent, clearRenderedContent, render, waitForContainer, waitForPaint = waitForFileViewerNextPaint, disposeSession = disposeFileViewerRendererSession, onStartZoomObserver, onStartViewStateObserver, onRefreshDocumentIndex, onRefreshZoomProvider, onRefreshViewStateProvider, }) => {
     if (!getContainer()) {
         await (waitForContainer === null || waitForContainer === void 0 ? void 0 : waitForContainer());
     }
@@ -191,6 +195,7 @@ export const runFileViewerRenderSurfaceMount = async ({ buffer, file, version, s
     clearRenderedContent('replace');
     const target = createFileViewerRenderTarget(container);
     onStartZoomObserver === null || onStartZoomObserver === void 0 ? void 0 : onStartZoomObserver();
+    onStartViewStateObserver === null || onStartViewStateObserver === void 0 ? void 0 : onStartViewStateObserver();
     await (waitForContainer === null || waitForContainer === void 0 ? void 0 : waitForContainer());
     await waitForPaint();
     if (!isCurrent(version)) {
@@ -227,6 +232,7 @@ export const runFileViewerRenderSurfaceMount = async ({ buffer, file, version, s
         }
         void (onRefreshDocumentIndex === null || onRefreshDocumentIndex === void 0 ? void 0 : onRefreshDocumentIndex());
         onRefreshZoomProvider === null || onRefreshZoomProvider === void 0 ? void 0 : onRefreshZoomProvider();
+        onRefreshViewStateProvider === null || onRefreshViewStateProvider === void 0 ? void 0 : onRefreshViewStateProvider();
         return session;
     }
     catch (error) {
@@ -234,7 +240,7 @@ export const runFileViewerRenderSurfaceMount = async ({ buffer, file, version, s
         throw error;
     }
 };
-export const createFileViewerRenderSurfaceActionHandlers = ({ getContainer, surfaceState, readinessState, isCurrent, render, waitForContainer, waitForPaint, disposeOptions, onUnloadStart, onUnloadComplete, onClearActiveDocumentContext, onClearDocumentState, onStartZoomObserver, onStopZoomObserver, onClearZoomProvider, onRefreshDocumentIndex, onRefreshZoomProvider, }) => {
+export const createFileViewerRenderSurfaceActionHandlers = ({ getContainer, surfaceState, readinessState, isCurrent, render, waitForContainer, waitForPaint, disposeOptions, onUnloadStart, onUnloadComplete, onClearActiveDocumentContext, onClearDocumentState, onStartZoomObserver, onStopZoomObserver, onClearZoomProvider, onStartViewStateObserver, onStopViewStateObserver, onClearViewStateProvider, onRefreshDocumentIndex, onRefreshZoomProvider, onRefreshViewStateProvider, }) => {
     const handleDisposeError = (error) => {
         if (disposeOptions === null || disposeOptions === void 0 ? void 0 : disposeOptions.onError) {
             disposeOptions.onError(error);
@@ -265,6 +271,8 @@ export const createFileViewerRenderSurfaceActionHandlers = ({ getContainer, surf
             onClearDocumentState,
             onStopZoomObserver,
             onClearZoomProvider,
+            onStopViewStateObserver,
+            onClearViewStateProvider,
         });
     };
     const mountRenderedContent = async (buffer, file, version, sourceUrl, streamUrl) => {
@@ -284,8 +292,10 @@ export const createFileViewerRenderSurfaceActionHandlers = ({ getContainer, surf
             waitForPaint,
             disposeSession: destroyRenderSession,
             onStartZoomObserver,
+            onStartViewStateObserver,
             onRefreshDocumentIndex,
             onRefreshZoomProvider,
+            onRefreshViewStateProvider,
         });
     };
     return {
@@ -314,19 +324,42 @@ export const renderFileViewerHandler = async ({ dispatcher, buffer, target, type
     }
     return handler(buffer, target, normalizedType, context);
 };
-export const createFileRenderHandlerLoader = ({ handler, getTarget = context => context.surface.container, createContext = buildFileRenderContextFromLoadContext, destroy, }) => {
+export const createFileRenderHandlerLoader = ({ handler, rendererId, getTarget = context => context.surface.container, createContext = buildFileRenderContextFromLoadContext, destroy, }) => {
     return async (context) => {
         const { source } = context;
         if (!source.buffer) {
             throw new Error('FileRenderHandler renderer requires an ArrayBuffer source.');
         }
         const target = getTarget(context);
-        const rendered = await handler(source.buffer, target, source.extension, createContext(context));
+        const renderContext = createContext(context);
+        const rendered = await handler(source.buffer, target, source.extension, renderContext);
+        const existingProvider = findFileViewerViewStateProvider(target);
+        const genericViewStateProvider = existingProvider
+            ? null
+            : registerFileViewerGenericViewStateProvider({
+                host: target,
+                renderer: rendererId || source.extension,
+            });
+        const viewStateProvider = existingProvider || (genericViewStateProvider === null || genericViewStateProvider === void 0 ? void 0 : genericViewStateProvider.provider) || null;
+        if (context.options.initialViewState && (viewStateProvider === null || viewStateProvider === void 0 ? void 0 : viewStateProvider.applyState)) {
+            await viewStateProvider.applyState(context.options.initialViewState, {
+                action: 'restore',
+                source: 'initial',
+            });
+        }
         return createFileRenderHandlerRendererSession(rendered, () => {
-            if (destroy) {
-                return destroy(rendered, context);
+            const destroyRendered = () => {
+                if (destroy) {
+                    return destroy(rendered, context);
+                }
+                return disposeFileViewerRendered(rendered);
+            };
+            try {
+                genericViewStateProvider === null || genericViewStateProvider === void 0 ? void 0 : genericViewStateProvider.destroy();
+            }
+            finally {
+                return destroyRendered();
             }
-            return disposeFileViewerRendered(rendered);
         });
     };
 };
@@ -345,6 +378,7 @@ export const createFileRenderHandlerRegistry = ({ definitions = DEFAULT_RENDERER
             ...definition,
             load: createFileRenderHandlerLoader({
                 handler,
+                rendererId: definition.id,
                 getTarget,
                 createContext,
                 destroy,

package/dist/source/loading.d.ts

@@ -432,6 +432,7 @@ export interface RunFileViewerPreviewComponentUnmountInput {
     onCancelPreview?: (reason: FileViewerLifecycleContext['reason']) => void;
     onResetLoading?: () => void;
     onStopZoomObserver?: () => void;
+    onStopViewStateObserver?: () => void;
 }
 export interface FileViewerPreviewComponentUnmountState {
     reason: FileViewerLifecycleContext['reason'];
@@ -501,7 +502,7 @@ export declare const applyFileViewerPreviewRequestResetState: <Target extends Mu
 export declare const commitFileViewerPreviewRequestStartState: ({ reason, requestController, previewTarget, onClearRenderedContent, onClearError, }: CommitFileViewerPreviewRequestStartStateInput) => number;
 export declare const cancelFileViewerPreviewRequest: ({ reason, requestController, previewTarget, onClearRenderedContent, onClearError, }: CancelFileViewerPreviewRequestInput) => number;
 export declare const runFileViewerPreviewSourceChange: ({ onRefreshPreview, }?: RunFileViewerPreviewSourceChangeInput) => unknown;
-export declare const runFileViewerPreviewComponentUnmount: ({ reason, onCancelPreview, onResetLoading, onStopZoomObserver, }?: RunFileViewerPreviewComponentUnmountInput) => FileViewerPreviewComponentUnmountState;
+export declare const runFileViewerPreviewComponentUnmount: ({ reason, onCancelPreview, onResetLoading, onStopZoomObserver, onStopViewStateObserver, }?: RunFileViewerPreviewComponentUnmountInput) => FileViewerPreviewComponentUnmountState;
 export declare const applyFileViewerEmptyPreviewState: <Target extends MutableFileViewerPreviewState>(target: Target, state?: FileViewerEmptyPreviewState) => Target;
 export declare const commitFileViewerEmptyPreviewResetState: ({ previewTarget, state, reason, onClearRenderedContent, onResetLoading, }: CommitFileViewerEmptyPreviewResetStateInput) => MutableFileViewerPreviewState;
 export declare const runFileViewerPreviewRequest: <LocalResult = unknown, RemoteResult = unknown>({ file, url, reason, requestController, previewTarget, onPreviewLocalFile, onPreviewRemoteFile, onClearRenderedContent, onClearError, onResetLoading, }: RunFileViewerPreviewRequestInput<LocalResult, RemoteResult>) => Promise<FileViewerPreviewRequestRunState<LocalResult, RemoteResult>>;

package/dist/source/loading.js

@@ -182,10 +182,11 @@ export const cancelFileViewerPreviewRequest = ({ reason = 'component-unmount', r
 export const runFileViewerPreviewSourceChange = ({ onRefreshPreview, } = {}) => {
     return onRefreshPreview === null || onRefreshPreview === void 0 ? void 0 : onRefreshPreview();
 };
-export const runFileViewerPreviewComponentUnmount = ({ reason = 'component-unmount', onCancelPreview, onResetLoading, onStopZoomObserver, } = {}) => {
+export const runFileViewerPreviewComponentUnmount = ({ reason = 'component-unmount', onCancelPreview, onResetLoading, onStopZoomObserver, onStopViewStateObserver, } = {}) => {
     onCancelPreview === null || onCancelPreview === void 0 ? void 0 : onCancelPreview(reason);
     onResetLoading === null || onResetLoading === void 0 ? void 0 : onResetLoading();
     onStopZoomObserver === null || onStopZoomObserver === void 0 ? void 0 : onStopZoomObserver();
+    onStopViewStateObserver === null || onStopViewStateObserver === void 0 ? void 0 : onStopViewStateObserver();
     return {
         reason,
     };