@file-viewer/core 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+import type { FileRenderContext, FileViewerRenderedInstance } from './types';
+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_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_URL, DEFAULT_FILE_VIEWER_TYPST_RENDERER_WASM_PACKAGE_PATH, getFileViewerRendererAssetManifest, listFileViewerRendererAssetManifests, resolveFileViewerArchiveWasmUrl, resolveFileViewerArchiveWorkerUrl, resolveFileViewerAssetUrl, resolveFileViewerCadAssetUrls, resolveFileViewerDataSqlWasmUrl, resolveFileViewerDocxWorkerUrl, resolveFileViewerRendererAssets, resolveFileViewerSpreadsheetWorkerUrl, resolveFileViewerTypstCompilerWasmUrl, resolveFileViewerTypstRendererWasmUrl, } from './assets';
+export { ARCHIVE_EXTENSIONS, DEFAULT_RENDERER_DEFINITIONS, DEFAULT_SUPPORTED_EXTENSIONS, IMAGE_EXTENSIONS, MODEL_EXTENSIONS, TEXT_EXTENSIONS, } from './formats';
+export { DEFAULT_FILE_VIEWER_TEXT_CHUNK_OVERLAP, DEFAULT_FILE_VIEWER_TEXT_CHUNK_SIZE, DEFAULT_FILE_VIEWER_ZOOM_SCALE, buildFileViewerDocumentTextChunks, createEmptyFileViewerSearchState, createFileViewerZoomState, normalizeFileViewerAiOptions, normalizeFileViewerSearchOptions, } from './document';
+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 './documentSearch';
+export type { FileViewerDocumentAnchorsTarget, FileViewerDomSearchController, FileViewerDomSearchControllerActionHandlers, FileViewerDomSearchControllerStateTarget, MutableFileViewerSearchState, } from './documentSearch';
+export { createFileViewerDocumentFeatureActions, createFileViewerDocumentFeatureControllerActionHandlers, createFileViewerDocumentChangeSnapshot, createFileViewerSearchChangeState, dispatchFileViewerLocationChange, dispatchFileViewerSearchChange, resolveFileViewerLocationChangeAnchor, } from './documentEvents';
+export type { CreateFileViewerDocumentChangeSnapshotInput, FileViewerDocumentFeatureActionOptions, DispatchFileViewerLocationChangeInput, DispatchFileViewerSearchChangeInput, FileViewerDocumentChangeSnapshot, FileViewerDocumentFeatureActions, FileViewerDocumentFeatureControllerActionHandlers, FileViewerDocumentFeatureSearchController, CreateFileViewerDocumentFeatureActionsInput, CreateFileViewerDocumentFeatureControllerActionHandlersInput, ResolveFileViewerLocationChangeAnchorInput, } from './documentEvents';
+export { applyFileViewerZoomState, clearFileViewerZoomControllerProvider, createFileViewerZoomChangeEmitter, createFileViewerZoomChangeState, cloneFileViewerZoomState, createFileViewerZoomController, createFileViewerZoomControllerActionHandlers, destroyFileViewerZoomController, observeFileViewerZoomController, refreshFileViewerZoomControllerProvider, runFileViewerZoomControllerAction, syncFileViewerZoomControllerState, } from './documentZoom';
+export type { FileViewerZoomController, FileViewerZoomControllerActionHandlers, MutableFileViewerZoomState, } from './documentZoom';
+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 './documentDom';
+export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './export';
+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 './viewerOperations';
+export type { CreateFileViewerOperationActionHandlersInput, FileViewerOperationActionErrorFormatter, FileViewerFileOperationType, FileViewerOperationActionErrorContext, FileViewerOperationActionErrorPrefixes, FileViewerOperationActionHandlers, FileViewerPublicOperationActionHandlers, ResolveFileViewerOperationActionErrorMessageInput, } from './viewerOperations';
+export { createRendererRegistry } from './registry';
+export { coreBrowserRendererHandlers, createFileViewerCoreRendererRegistry, fileViewerCoreRendererDispatcher, fileViewerCoreRendererRegistry, fileViewerCoreRendererRegistryBridge, missingFileViewerCoreRendererHandlers, } from './renderers/index';
+export declare const renderFileViewerAudio: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerArchive: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerCad: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerCode: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerDataAsset: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerDrawing: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerEda: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerEmail: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerEpub: (buffer: ArrayBuffer, target: HTMLDivElement) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerGeo: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerImage: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerMarkdown: (buffer: ArrayBuffer, target: HTMLDivElement) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerModel: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerOfd: (buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerOpenDocument: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerPdf: (buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerPptx: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerTypst: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerUmd: (buffer: ArrayBuffer, target: HTMLDivElement) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerVideo: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+export declare const renderFileViewerWordDoc: (buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext) => Promise<FileViewerRenderedInstance>;
+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 { parseEdaFile, } from './renderers/edaParser';
+export type { EdaDiagnostic, EdaDiagnosticLevel, EdaDomainRole, EdaEntity, EdaFileType, EdaParseResult, EdaParserMode, EdaProperty, EdaStats, EdaStreamKind, EdaStreamView, EdaTreeNode, } from './renderers/edaParser';
+export { ADAPTER_PRINT_REQUIRED_EXTENSIONS, createUnsupportedAvailability, DEFAULT_OPERATION_AVAILABILITY, DOM_PRINTABLE_EXTENSIONS, getRendererAvailability, isDomPrintableExtension, isKnownNonPrintableExtension, needsDedicatedPrintAdapter, NON_PRINTABLE_EXTENSIONS, resolvePrintAvailability, } from './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, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, reportFileViewerLifecycleHookError, reportFileViewerOperationError, resolveFileViewerLifecycleFallbackSource, resolveFileViewerLifecycleHookErrorMessage, resolveFileViewerBeforeOperationErrorMessage, resolveFileViewerOperationAvailability, resolveFileViewerToolbarState, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from './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 './operations';
+export { FALLBACK_FILE_VIEWER_LOADING_THEME, FILE_VIEWER_LOADING_THEME_MAP, applyFileViewerLoadingState, cloneFileViewerLoadingState, createFileViewerLoadingController, createFileViewerLoadingControllerActionHandlers, createFileViewerLoadingState, createFileViewerLoadingStyleVars, runFileViewerLoadingControllerAction, runFileViewerLoadingExtensionSync, resolveFileViewerLoadingTheme, syncFileViewerLoadingControllerState, } from './loading';
+export type { FileViewerLoadingController, FileViewerLoadingControllerActionHandlers, RunFileViewerLoadingExtensionSyncInput, } from './loading';
+export { createFileViewerLifecycleFacade, } from './lifecycleFacade';
+export type { BuildFileViewerLifecycleFacadeLoadStartStateInput, BuildFileViewerLifecycleFacadeRenderCompleteStateInput, CreateFileViewerLifecycleFacadeInput, FileViewerLifecycleFacade, } from './lifecycleFacade';
+export { getFileViewerOptionsSearchParam, normalizeFileViewerTheme, parseFileViewerOptions, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './options';
+export { resolveFileViewerPresentationState, } from './presentation';
+export type { FileViewerPresentationState, ResolveFileViewerPresentationStateInput, } from './presentation';
+export { createFileViewerRendererDispatcher, } from './rendererDispatcher';
+export { buildFileRenderContextFromLoadContext, applyFileViewerRenderSurfaceState, clearFileViewerRenderSurface, createFileRenderHandlerRendererSession, createFileRenderHandlerRegistry, createFileRenderHandlerLoader, createFileViewerRenderSurfaceActionHandlers, createFileViewerRenderReadinessTarget, 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, removeFileViewerRenderTarget, reportFileViewerRenderSessionDisposeError, resetFileViewerRenderSurface, resolveFileViewerRenderSessionDisposeErrorMessage, runFileViewerRenderSurfaceClear, runFileViewerRenderSurfaceMount, renderFileViewerHandler, } from './rendererHandler';
+export type { CreateFileViewerRenderSurfaceActionHandlersInput, CreateFileViewerRenderReadinessTargetInput, CreateFileViewerRenderSurfaceStateTargetInput, FileViewerRenderSurfaceActionHandlers, FileViewerRenderSurfaceClearState, FileViewerRenderSurfaceState, FileViewerRenderSurfaceMountContext, FileViewerRenderSessionDisposeErrorLogger, MutableFileViewerRenderSurfaceState, ReportFileViewerRenderSessionDisposeErrorInput, ResetFileViewerRenderSurfaceInput, ResolveFileViewerRenderSessionDisposeErrorMessageInput, RunFileViewerRenderSurfaceClearInput, RunFileViewerRenderSurfaceMountInput, } from './rendererHandler';
+export { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, decodeFilename, getExtension, normalizeFileExtension, normalizeFilename, resolveFileViewerSourceFilename, normalizeSource, readFileViewerBuffer, readFileViewerDataUrl, readFileViewerText, wrapFileViewerFileRef, } from './source';
+export type { FileViewerReadResult } from './source';
+export { DEFAULT_FILE_VIEWER_STATE_THEME, DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRIPTION, FILE_VIEWER_PREVIEW_MESSAGES, createFileViewerEmptyState, createFileViewerErrorState, createFileViewerPreviewLoadingState, createFileViewerReadyState, createFileViewerUnsupportedState, formatFileViewerErrorMessage, normalizeFileViewerErrorMessage, } from './state';
+export type { FileViewerErrorMessageFormatter, } from './state';
+export { buildFileViewerWatermarkBackgroundImage, buildFileViewerWatermarkInlineStyle, buildFileViewerWatermarkStyle, buildFileViewerWatermarkSvg, normalizeFileViewerWatermark, resolveFileViewerWatermarkPresentationState, } from './watermark';
+export type { FileViewerWatermarkPresentationState, FileViewerWatermarkStyle, } from './watermark';
+export { cancelFileViewerPreviewRequest, DEFAULT_FILE_VIEWER_STREAMING_PDF_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_LOAD_ERROR_LOGGER, DEFAULT_PDF_RANGE_CHUNK_SIZE, FILE_VIEWER_PREVIEW_LOAD_ERROR_PREFIXES, FILE_VIEWER_REMOTE_MISSING_DATA_ERROR_MESSAGE, applyFileViewerEmptyPreviewState, applyFileViewerPreviewFilenameState, applyFileViewerPreviewSourceUrlState, applyFileViewerReadPreviewState, applyFileViewerRenderReadinessState, applyFileViewerPreviewRequestResetState, commitFileViewerEmptyPreviewResetState, commitFileViewerLoadStartState, commitFileViewerPreviewRequestStartState, commitFileViewerRenderCompleteState, commitFileViewerRemoteDownloadState, createFileViewerEmptyPreviewState, createFileViewerLoadStartState, createFileViewerPreviewStateTarget, createFileViewerSourceLoadingActionHandlers, createFileViewerReadPreviewState, createFileViewerPreviewRequestResetState, createFileViewerRenderCompleteState, createFileViewerRequestController, createFileViewerRequestScope, createFileViewerStreamingPdfPlaceholderFile, finalizeFileViewerPreviewLoadState, hasFileViewerPreviewSource, isFileViewerAbortError, isSameOriginUrl, normalizeFileViewerSourceUrl, normalizePdfStreamingMode, resolveFileViewerFileRefSourcePlan, resolveFileViewerLoadStartMessage, resolveFileViewerMissingRemoteDataErrorMessage, resolveFileViewerPreviewLoadErrorMessage, resolveFileViewerPreviewRequestReason, resolveFileViewerRemoteSourcePlan, resolveFileViewerPageHref, reportFileViewerMissingRemoteData, reportFileViewerPreviewLoadError, runFileViewerLocalFilePreview, runFileViewerPreviewComponentUnmount, runFileViewerPreviewRequest, runFileViewerPreviewSourceChange, runFileViewerRemoteFilePreview, runFileViewerReadAndRenderFile, runFileViewerStreamingPdfPreview, shouldStreamPdfUrl, } from './sourceLoading';
+export type { CreateFileViewerPreviewStateTargetInput, CreateFileViewerSourceLoadingActionHandlersInput, CreateFileViewerLoadStartStateInput, CreateFileViewerReadPreviewStateInput, CreateFileViewerRenderCompleteStateInput, CommitFileViewerEmptyPreviewResetStateInput, CancelFileViewerPreviewRequestInput, CommitFileViewerLoadStartStateInput, CommitFileViewerPreviewRequestStartStateInput, CommitFileViewerRenderCompleteStateInput, CommitFileViewerRemoteDownloadStateInput, FileViewerEmptyPreviewState, FileViewerMutableAccessor, FileViewerLocationLike, FileViewerFileRefSourcePlan, FileViewerLocalFilePreviewState, FileViewerLoadStartState, FileViewerPreviewLoadErrorKind, FileViewerPreviewLoadErrorPrefixes, FileViewerPreviewLoadErrorLogger, FileViewerPreviewComponentUnmountState, FileViewerPreviewRequestResetState, FileViewerSourceLoadingActionHandlers, FileViewerReadAndRenderFileState, FileViewerRenderCompleteState, FileViewerRenderReadinessState, FileViewerRemoteDownloadState, FileViewerRemoteFilePreviewErrorKind, FileViewerRemoteFilePreviewState, FileViewerRemoteFileDownloadInput, FileViewerReadPreviewState, FileViewerPreviewRequestRunState, FileViewerRemoteSourcePlan, FileViewerRequestController, FileViewerRequestScope, FileViewerStreamingPdfPreviewState, FinalizeFileViewerPreviewLoadStateInput, MutableFileViewerPreviewFilenameState, MutableFileViewerPreviewSourceUrlState, MutableFileViewerPreviewRequestState, MutableFileViewerPreviewState, MutableFileViewerRenderReadinessState, MutableFileViewerReadPreviewState, RunFileViewerLocalFilePreviewInput, RunFileViewerPreviewComponentUnmountInput, RunFileViewerPreviewRequestInput, RunFileViewerPreviewSourceChangeInput, RunFileViewerRemoteFilePreviewInput, RunFileViewerReadAndRenderFileInput, RunFileViewerStreamingPdfPreviewInput, ResolveFileViewerFileRefSourcePlanInput, ResolveFileViewerMissingRemoteDataErrorMessageInput, ResolveFileViewerPreviewLoadErrorMessageInput, ResolveFileViewerPreviewRequestReasonInput, ReportFileViewerMissingRemoteDataInput, ReportFileViewerPreviewLoadErrorInput, } from './sourceLoading';
+export { createViewer } from './viewer';
+export { WorkerRefImpl, createFileViewerWorkerController, refWorker, } from './worker';
+export type { FileViewerRendererAssetDefinition, FileViewerRendererAssetKind, FileViewerRendererAssetManifest, FileViewerRendererAssetOptionPath, FileViewerRendererAssetTarget, ResolveFileViewerAssetUrlOptions, ResolveFileViewerRendererAssetsOptions, ResolvedFileViewerRendererAsset, ResolvedFileViewerCadAssetUrls, } from './assets';
+export type { BuildFileViewerLifecycleContextInput, BuiltFileViewerLifecycleContext, BuiltFileViewerOperationContext, FileViewerLifecycleStateController, FileViewerLifecycleHookErrorLogger, FileViewerOperationErrorLogger, ResolveFileViewerOperationAvailabilityInput, ReportFileViewerLifecycleHookErrorInput, ReportFileViewerOperationErrorInput, RunFileViewerBeforeOperationInput, SerializedFileViewerContext, ResolveFileViewerLifecycleHookErrorMessageInput, } from './operations';
+export type { FileViewerLoadingState, FileViewerLoadingTheme, MutableFileViewerLoadingState, } from './loading';
+export type { ExecuteFileViewerDownloadOperationInput, ExecuteFileViewerExportHtmlOperationInput, ExecuteFileViewerPrintOperationInput, FileViewerOperationExecutorBase, FileViewerOriginalSourceState, ResolveFileViewerOperationFilenameInput, } from './viewerOperations';
+export type { FileViewerSerializableCadOptions, FileViewerSerializableOptions, FileViewerSerializableToolbarOptions, } from './options';
+export type { CreateFileViewerRendererDispatcherOptions, FileViewerRendererDispatcher, FileViewerRendererHandlerEntry, } from './rendererDispatcher';
+export type { CreateFileViewerRenderTargetOptions, CreateFileRenderHandlerRegistryOptions, CreateFileRenderHandlerLoaderOptions, DisposeFileViewerRendererSessionOptions, FileRenderHandlerRegistryResult, FileRenderHandlerRendererSession, RenderFileViewerHandlerInput, } from './rendererHandler';
+export type { FileViewerSearchProviderHost, ResolveFileViewerScrollContainerOptions, FileViewerZoomProviderHost, } from './documentDom';
+export type { CreateFileViewerDomSearchControllerOptions, FileViewerInternalSearchMatch, } from './documentSearch';
+export type { CreateFileViewerZoomControllerOptions, FileViewerZoomOperation, } from './documentZoom';
+export type { CreateViewerOptions } from './viewer';
+export type { BuildExportHtmlDocumentOptions, BuildFileViewerRenderedHtmlDocumentOptions, } from './export';
+export type { CreateFileViewerWorkerControllerOptions, FileViewerWorkerContext, FileViewerWorkerController, FileViewerWorkerErrorHook, FileViewerWorkerEventHandler, FileViewerWorkerFactory, FileViewerWorkerMessageHook, WorkerProvider, WorkerRef, } from './worker';
+export type { FileViewerAiOptions, FileViewerArchiveOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfOptions, FileViewerPrintOptions, FileViewerPublicApi, FileViewerRenderedInstance, FileViewerRenderStateKind, FileViewerRendererCategory, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerThemeMode, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerTypstOptions, FileViewerWatermarkOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './types';

package/dist/index.js

@@ -0,0 +1,118 @@
+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_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_URL, DEFAULT_FILE_VIEWER_TYPST_RENDERER_WASM_PACKAGE_PATH, getFileViewerRendererAssetManifest, listFileViewerRendererAssetManifests, resolveFileViewerArchiveWasmUrl, resolveFileViewerArchiveWorkerUrl, resolveFileViewerAssetUrl, resolveFileViewerCadAssetUrls, resolveFileViewerDataSqlWasmUrl, resolveFileViewerDocxWorkerUrl, resolveFileViewerRendererAssets, resolveFileViewerSpreadsheetWorkerUrl, resolveFileViewerTypstCompilerWasmUrl, resolveFileViewerTypstRendererWasmUrl, } from './assets.js';
+export { ARCHIVE_EXTENSIONS, DEFAULT_RENDERER_DEFINITIONS, DEFAULT_SUPPORTED_EXTENSIONS, IMAGE_EXTENSIONS, MODEL_EXTENSIONS, TEXT_EXTENSIONS, } from './formats.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 './document.js';
+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 './documentSearch.js';
+export { createFileViewerDocumentFeatureActions, createFileViewerDocumentFeatureControllerActionHandlers, createFileViewerDocumentChangeSnapshot, createFileViewerSearchChangeState, dispatchFileViewerLocationChange, dispatchFileViewerSearchChange, resolveFileViewerLocationChangeAnchor, } from './documentEvents.js';
+export { applyFileViewerZoomState, clearFileViewerZoomControllerProvider, createFileViewerZoomChangeEmitter, createFileViewerZoomChangeState, cloneFileViewerZoomState, createFileViewerZoomController, createFileViewerZoomControllerActionHandlers, destroyFileViewerZoomController, observeFileViewerZoomController, refreshFileViewerZoomControllerProvider, runFileViewerZoomControllerAction, syncFileViewerZoomControllerState, } from './documentZoom.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 './documentDom.js';
+export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './export.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 './viewerOperations.js';
+export { createRendererRegistry } from './registry.js';
+export { coreBrowserRendererHandlers, createFileViewerCoreRendererRegistry, fileViewerCoreRendererDispatcher, fileViewerCoreRendererRegistry, fileViewerCoreRendererRegistryBridge, missingFileViewerCoreRendererHandlers, } from './renderers/index.js';
+export const renderFileViewerAudio = async (buffer, target, type) => {
+    const { default: renderAudio } = await import('./renderers/audio.js');
+    return renderAudio(buffer, target, type);
+};
+export const renderFileViewerArchive = async (buffer, target, type, context) => {
+    const { default: renderArchive } = await import('./renderers/archive.js');
+    return renderArchive(buffer, target, type, context);
+};
+export const renderFileViewerCad = async (buffer, target, type, context) => {
+    const { default: renderCad } = await import('./renderers/cad.js');
+    return renderCad(buffer, target, type, context);
+};
+export const renderFileViewerCode = async (buffer, target, type) => {
+    const { default: renderCode } = await import('./renderers/code.js');
+    return renderCode(buffer, target, type);
+};
+export const renderFileViewerDataAsset = async (buffer, target, type, context) => {
+    const { default: renderDataAsset } = await import('./renderers/data.js');
+    return renderDataAsset(buffer, target, type, context);
+};
+export const renderFileViewerDrawing = async (buffer, target, type, context) => {
+    const { default: renderDrawing } = await import('./renderers/drawing.js');
+    return renderDrawing(buffer, target, type, context);
+};
+export const renderFileViewerEda = async (buffer, target, type, context) => {
+    const { default: renderEda } = await import('./renderers/eda.js');
+    return renderEda(buffer, target, type, context);
+};
+export const renderFileViewerEmail = async (buffer, target, type, context) => {
+    const { default: renderEmail } = await import('./renderers/email.js');
+    return renderEmail(buffer, target, type, context);
+};
+export const renderFileViewerEpub = async (buffer, target) => {
+    const { default: renderEpub } = await import('./renderers/epub.js');
+    return renderEpub(buffer, target);
+};
+export const renderFileViewerGeo = async (buffer, target, type) => {
+    const { default: renderGeo } = await import('./renderers/geo.js');
+    return renderGeo(buffer, target, type);
+};
+export const renderFileViewerImage = async (buffer, target, type) => {
+    const { default: renderImage } = await import('./renderers/image.js');
+    return renderImage(buffer, target, type);
+};
+export const renderFileViewerMarkdown = async (buffer, target) => {
+    const { default: renderMarkdown } = await import('./renderers/markdown.js');
+    return renderMarkdown(buffer, target);
+};
+export const renderFileViewerModel = async (buffer, target, type, context) => {
+    const { default: renderModel } = await import('./renderers/model.js');
+    return renderModel(buffer, target, type, context);
+};
+export const renderFileViewerOfd = async (buffer, target, context) => {
+    const { default: renderOfd } = await import('./renderers/ofd.js');
+    return renderOfd(buffer, target, context);
+};
+export const renderFileViewerOpenDocument = async (buffer, target, type) => {
+    const { default: renderOpenDocument } = await import('./renderers/openDocument.js');
+    return renderOpenDocument(buffer, target, type);
+};
+export const renderFileViewerPdf = async (buffer, target, context) => {
+    const { default: renderPdf } = await import('./renderers/pdf.js');
+    return renderPdf(buffer, target, context);
+};
+export const renderFileViewerPptx = async (buffer, target, type, context) => {
+    const { default: renderPptx } = await import('./renderers/pptx.js');
+    return renderPptx(buffer, target, type, context);
+};
+export const renderFileViewerTypst = async (buffer, target, type, context) => {
+    const { default: renderTypst } = await import('./renderers/typst.js');
+    return renderTypst(buffer, target, type, context);
+};
+export const renderFileViewerUmd = async (buffer, target) => {
+    const { default: renderUmd } = await import('./renderers/umd.js');
+    return renderUmd(buffer, target);
+};
+export const renderFileViewerVideo = async (buffer, target, type, context) => {
+    const { default: renderVideo } = await import('./renderers/video.js');
+    return renderVideo(buffer, target, type, context);
+};
+export const renderFileViewerWordDoc = async (buffer, target, context) => {
+    const { default: renderWordDoc } = await import('./renderers/wordDoc.js');
+    return renderWordDoc(buffer, target, context);
+};
+export const renderFileViewerWordDocx = async (buffer, target, context) => {
+    const { default: renderWordDocx } = await import('./renderers/wordDocx.js');
+    return renderWordDocx(buffer, target, context);
+};
+export const renderFileViewerSpreadsheet = async (buffer, target, type, context) => {
+    const { default: renderSpreadsheet } = await import('./renderers/spreadsheet.js');
+    return renderSpreadsheet(buffer, target, type, context);
+};
+export { parseEdaFile, } from './renderers/edaParser.js';
+export { ADAPTER_PRINT_REQUIRED_EXTENSIONS, createUnsupportedAvailability, DEFAULT_OPERATION_AVAILABILITY, DOM_PRINTABLE_EXTENSIONS, getRendererAvailability, isDomPrintableExtension, isKnownNonPrintableExtension, needsDedicatedPrintAdapter, NON_PRINTABLE_EXTENSIONS, resolvePrintAvailability, } from './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, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, reportFileViewerLifecycleHookError, reportFileViewerOperationError, resolveFileViewerLifecycleFallbackSource, resolveFileViewerLifecycleHookErrorMessage, resolveFileViewerBeforeOperationErrorMessage, resolveFileViewerOperationAvailability, resolveFileViewerToolbarState, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from './operations.js';
+export { FALLBACK_FILE_VIEWER_LOADING_THEME, FILE_VIEWER_LOADING_THEME_MAP, applyFileViewerLoadingState, cloneFileViewerLoadingState, createFileViewerLoadingController, createFileViewerLoadingControllerActionHandlers, createFileViewerLoadingState, createFileViewerLoadingStyleVars, runFileViewerLoadingControllerAction, runFileViewerLoadingExtensionSync, resolveFileViewerLoadingTheme, syncFileViewerLoadingControllerState, } from './loading.js';
+export { createFileViewerLifecycleFacade, } from './lifecycleFacade.js';
+export { getFileViewerOptionsSearchParam, normalizeFileViewerTheme, parseFileViewerOptions, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, } from './options.js';
+export { resolveFileViewerPresentationState, } from './presentation.js';
+export { createFileViewerRendererDispatcher, } from './rendererDispatcher.js';
+export { buildFileRenderContextFromLoadContext, applyFileViewerRenderSurfaceState, clearFileViewerRenderSurface, createFileRenderHandlerRendererSession, createFileRenderHandlerRegistry, createFileRenderHandlerLoader, createFileViewerRenderSurfaceActionHandlers, createFileViewerRenderReadinessTarget, 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, removeFileViewerRenderTarget, reportFileViewerRenderSessionDisposeError, resetFileViewerRenderSurface, resolveFileViewerRenderSessionDisposeErrorMessage, runFileViewerRenderSurfaceClear, runFileViewerRenderSurfaceMount, renderFileViewerHandler, } from './rendererHandler.js';
+export { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, decodeFilename, getExtension, normalizeFileExtension, normalizeFilename, resolveFileViewerSourceFilename, normalizeSource, readFileViewerBuffer, readFileViewerDataUrl, readFileViewerText, wrapFileViewerFileRef, } from './source.js';
+export { DEFAULT_FILE_VIEWER_STATE_THEME, DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRIPTION, FILE_VIEWER_PREVIEW_MESSAGES, createFileViewerEmptyState, createFileViewerErrorState, createFileViewerPreviewLoadingState, createFileViewerReadyState, createFileViewerUnsupportedState, formatFileViewerErrorMessage, normalizeFileViewerErrorMessage, } from './state.js';
+export { buildFileViewerWatermarkBackgroundImage, buildFileViewerWatermarkInlineStyle, buildFileViewerWatermarkStyle, buildFileViewerWatermarkSvg, normalizeFileViewerWatermark, resolveFileViewerWatermarkPresentationState, } from './watermark.js';
+export { cancelFileViewerPreviewRequest, DEFAULT_FILE_VIEWER_STREAMING_PDF_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_LOAD_ERROR_LOGGER, DEFAULT_PDF_RANGE_CHUNK_SIZE, FILE_VIEWER_PREVIEW_LOAD_ERROR_PREFIXES, FILE_VIEWER_REMOTE_MISSING_DATA_ERROR_MESSAGE, applyFileViewerEmptyPreviewState, applyFileViewerPreviewFilenameState, applyFileViewerPreviewSourceUrlState, applyFileViewerReadPreviewState, applyFileViewerRenderReadinessState, applyFileViewerPreviewRequestResetState, commitFileViewerEmptyPreviewResetState, commitFileViewerLoadStartState, commitFileViewerPreviewRequestStartState, commitFileViewerRenderCompleteState, commitFileViewerRemoteDownloadState, createFileViewerEmptyPreviewState, createFileViewerLoadStartState, createFileViewerPreviewStateTarget, createFileViewerSourceLoadingActionHandlers, createFileViewerReadPreviewState, createFileViewerPreviewRequestResetState, createFileViewerRenderCompleteState, createFileViewerRequestController, createFileViewerRequestScope, createFileViewerStreamingPdfPlaceholderFile, finalizeFileViewerPreviewLoadState, hasFileViewerPreviewSource, isFileViewerAbortError, isSameOriginUrl, normalizeFileViewerSourceUrl, normalizePdfStreamingMode, resolveFileViewerFileRefSourcePlan, resolveFileViewerLoadStartMessage, resolveFileViewerMissingRemoteDataErrorMessage, resolveFileViewerPreviewLoadErrorMessage, resolveFileViewerPreviewRequestReason, resolveFileViewerRemoteSourcePlan, resolveFileViewerPageHref, reportFileViewerMissingRemoteData, reportFileViewerPreviewLoadError, runFileViewerLocalFilePreview, runFileViewerPreviewComponentUnmount, runFileViewerPreviewRequest, runFileViewerPreviewSourceChange, runFileViewerRemoteFilePreview, runFileViewerReadAndRenderFile, runFileViewerStreamingPdfPreview, shouldStreamPdfUrl, } from './sourceLoading.js';
+export { createViewer } from './viewer.js';
+export { WorkerRefImpl, createFileViewerWorkerController, refWorker, } from './worker.js';

package/dist/lifecycleFacade.d.ts

@@ -0,0 +1,46 @@
+import { type FileViewerActiveUnloadState, type FileViewerLifecycleActions, type FileViewerLifecycleComponentEmit } from './operations';
+import { type FileViewerLoadStartState, type FileViewerRenderCompleteState } from './sourceLoading';
+import type { FileViewerErrorMessageFormatter } from './state';
+import type { FileViewerFileRef, FileViewerLifecycleContext, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions } from './types';
+export interface BuildFileViewerLifecycleFacadeLoadStartStateInput {
+    version: number;
+    source: FileViewerLifecycleContext['source'];
+    file?: File | null;
+    sourceUrl?: string | null;
+}
+export interface BuildFileViewerLifecycleFacadeRenderCompleteStateInput {
+    version: number;
+    source: FileViewerLifecycleContext['source'];
+    file?: File | null;
+    sourceUrl?: string | null;
+}
+export interface CreateFileViewerLifecycleFacadeInput {
+    getOptions: () => FileViewerOptions | undefined;
+    getFilename: () => string;
+    getBufferSize: () => number | undefined;
+    getCurrentFile: () => File | null;
+    getCurrentVersion: () => number;
+    getFallbackFile: () => FileViewerFileRef | null | undefined;
+    getFallbackUrl: () => string | null | undefined;
+    emitLifecycle: FileViewerLifecycleComponentEmit;
+    emitOperationBefore: (context: FileViewerOperationContext) => void;
+    emitOperationCancel: (context: FileViewerOperationContext) => void;
+    formatErrorMessage: FileViewerErrorMessageFormatter;
+    handleLifecycleError: (error: unknown, context: FileViewerLifecycleContext) => void;
+    handleOperationError?: (error: unknown, context: FileViewerOperationContext) => void;
+    onOperationErrorMessage?: (message: string, context: FileViewerOperationContext) => void;
+}
+export interface FileViewerLifecycleFacade {
+    markLoadStarted(version: number, timestamp?: number): void;
+    clearLoadStarted(version: number): void;
+    notifyLifecycle: FileViewerLifecycleActions['notifyLifecycle'];
+    notifyActiveUnloadStart(reason?: FileViewerLifecycleContext['reason']): FileViewerLifecycleContext | null;
+    notifyActiveUnloadComplete(context: FileViewerLifecycleContext | null, reason?: FileViewerLifecycleContext['reason']): FileViewerActiveUnloadState;
+    setActiveDocumentContext(context: FileViewerLifecycleContext): void;
+    clearActiveDocumentContext(): void;
+    buildOperationContext(operation: FileViewerOperationType): FileViewerOperationContext;
+    buildLoadStartState(input: BuildFileViewerLifecycleFacadeLoadStartStateInput): FileViewerLoadStartState;
+    buildRenderCompleteState(input: BuildFileViewerLifecycleFacadeRenderCompleteStateInput): FileViewerRenderCompleteState;
+    runBeforeOperation(operation: FileViewerOperationType): Promise<boolean>;
+}
+export declare const createFileViewerLifecycleFacade: ({ getOptions, getFilename, getBufferSize, getCurrentFile, getCurrentVersion, getFallbackFile, getFallbackUrl, emitLifecycle, emitOperationBefore, emitOperationCancel, formatErrorMessage, handleLifecycleError, handleOperationError, onOperationErrorMessage, }: CreateFileViewerLifecycleFacadeInput) => FileViewerLifecycleFacade;

package/dist/lifecycleFacade.js

@@ -0,0 +1,68 @@
+import { buildFileViewerOperationContextFromLifecycleState, createFileViewerLifecycleActions, createFileViewerLifecycleStateController, emitFileViewerComponentLifecycleEvent, resolveFileViewerBeforeOperationErrorMessage, } from './operations.js';
+import { createFileViewerLoadStartState, createFileViewerRenderCompleteState, } from './sourceLoading.js';
+export const createFileViewerLifecycleFacade = ({ getOptions, getFilename, getBufferSize, getCurrentFile, getCurrentVersion, getFallbackFile, getFallbackUrl, emitLifecycle, emitOperationBefore, emitOperationCancel, formatErrorMessage, handleLifecycleError, handleOperationError, onOperationErrorMessage, }) => {
+    const lifecycleState = createFileViewerLifecycleStateController();
+    const lifecycleActions = createFileViewerLifecycleActions({
+        lifecycleState,
+        getOptions,
+        onLifecycleChange: (_event, context) => {
+            emitFileViewerComponentLifecycleEvent(emitLifecycle, context);
+        },
+        onLifecycleError: handleLifecycleError,
+        onOperationBefore: emitOperationBefore,
+        onOperationCancel: emitOperationCancel,
+        onOperationError: (error, context) => {
+            handleOperationError === null || handleOperationError === void 0 ? void 0 : handleOperationError(error, context);
+            onOperationErrorMessage === null || onOperationErrorMessage === void 0 ? void 0 : onOperationErrorMessage(resolveFileViewerBeforeOperationErrorMessage({
+                error,
+                formatErrorMessage,
+            }), context);
+        },
+    });
+    const buildOperationContext = (operation) => {
+        return buildFileViewerOperationContextFromLifecycleState({
+            operation,
+            lifecycleState,
+            version: getCurrentVersion(),
+            filename: getFilename(),
+            bufferSize: getBufferSize(),
+            currentFile: getCurrentFile(),
+            fallbackFile: getFallbackFile(),
+            fallbackUrl: getFallbackUrl(),
+        });
+    };
+    return {
+        markLoadStarted: lifecycleState.markLoadStarted,
+        clearLoadStarted: lifecycleState.clearLoadStarted,
+        notifyLifecycle: lifecycleActions.notifyLifecycle,
+        notifyActiveUnloadStart: lifecycleActions.notifyActiveUnloadStart,
+        notifyActiveUnloadComplete: lifecycleActions.notifyActiveUnloadComplete,
+        setActiveDocumentContext: lifecycleState.setActiveDocumentContext,
+        clearActiveDocumentContext: lifecycleState.clearActiveDocumentContext,
+        buildOperationContext,
+        buildLoadStartState({ version, source, file, sourceUrl, }) {
+            return createFileViewerLoadStartState({
+                version,
+                source,
+                file,
+                sourceUrl,
+                filename: getFilename(),
+                bufferSize: getBufferSize(),
+            });
+        },
+        buildRenderCompleteState({ version, source, file, sourceUrl, }) {
+            return createFileViewerRenderCompleteState({
+                version,
+                source,
+                file,
+                sourceUrl,
+                filename: getFilename(),
+                bufferSize: getBufferSize(),
+                lifecycleState,
+            });
+        },
+        runBeforeOperation(operation) {
+            return lifecycleActions.runBeforeOperation(buildOperationContext(operation));
+        },
+    };
+};

package/dist/loading.d.ts

@@ -0,0 +1,59 @@
+import type { FileViewerStateTheme } from './types';
+export type FileViewerLoadingTheme = FileViewerStateTheme;
+export interface FileViewerLoadingState {
+    loading: boolean;
+    error: string;
+    message: string;
+    theme: FileViewerLoadingTheme;
+    styleVars: Record<'--viewer-accent' | '--viewer-soft', string>;
+}
+export type MutableFileViewerLoadingState = FileViewerLoadingState;
+export interface FileViewerLoadingController {
+    readonly state: FileViewerLoadingState;
+    setExtension(nextExtend?: string): FileViewerLoadingState;
+    startLoading(nextMessage: string): FileViewerLoadingState;
+    setLoadingMessage(nextMessage: string): FileViewerLoadingState;
+    stopLoading(): FileViewerLoadingState;
+    showError(nextMessage: string): FileViewerLoadingState;
+    clearError(): FileViewerLoadingState;
+    resetLoading(): FileViewerLoadingState;
+    getState(): FileViewerLoadingState;
+}
+export interface FileViewerLoadingControllerActionHandlers {
+    setExtension(nextExtend?: string): FileViewerLoadingState;
+    startLoading(nextMessage: string): FileViewerLoadingState;
+    setLoadingMessage(nextMessage: string): FileViewerLoadingState;
+    stopLoading(): FileViewerLoadingState;
+    showError(nextMessage: string): FileViewerLoadingState;
+    clearError(): FileViewerLoadingState;
+    resetLoading(): FileViewerLoadingState;
+    syncLoadingState(): FileViewerLoadingState;
+}
+export interface RunFileViewerLoadingExtensionSyncInput<Target extends MutableFileViewerLoadingState = MutableFileViewerLoadingState> {
+    target: Target;
+    controller: Pick<FileViewerLoadingController, 'setExtension'>;
+    extension?: string;
+}
+export declare const FALLBACK_FILE_VIEWER_LOADING_THEME: FileViewerLoadingTheme;
+export declare const FILE_VIEWER_LOADING_THEME_MAP: Record<string, FileViewerLoadingTheme>;
+/**
+ * 根据扩展名返回统一的加载主题。
+ * 这样不同预览器可以复用同一套视觉语义，避免颜色、图标和文案各写一份。
+ */
+export declare const resolveFileViewerLoadingTheme: (extend?: string) => FileViewerLoadingTheme;
+export declare const createFileViewerLoadingStyleVars: (theme: FileViewerLoadingTheme) => {
+    '--viewer-accent': string;
+    '--viewer-soft': string;
+};
+export declare const createFileViewerLoadingState: (extend?: string) => FileViewerLoadingState;
+export declare const cloneFileViewerLoadingState: (state: FileViewerLoadingState) => FileViewerLoadingState;
+export declare const applyFileViewerLoadingState: <Target extends MutableFileViewerLoadingState>(target: Target, source: FileViewerLoadingState) => Target;
+export declare const syncFileViewerLoadingControllerState: <Target extends MutableFileViewerLoadingState>(target: Target, controller: Pick<FileViewerLoadingController, "getState">, source?: FileViewerLoadingState) => Target;
+export declare const runFileViewerLoadingControllerAction: <Target extends MutableFileViewerLoadingState>(target: Target, action: () => FileViewerLoadingState) => Target;
+export declare const runFileViewerLoadingExtensionSync: <Target extends MutableFileViewerLoadingState>({ target, controller, extension, }: RunFileViewerLoadingExtensionSyncInput<Target>) => Target;
+export declare const createFileViewerLoadingControllerActionHandlers: <Target extends MutableFileViewerLoadingState>(target: Target, controller: FileViewerLoadingController) => FileViewerLoadingControllerActionHandlers;
+/**
+ * 统一管理加载、错误、文案和主题色。
+ * wrapper 只负责把这个加载状态映射到各自框架的响应式系统。
+ */
+export declare const createFileViewerLoadingController: (extend?: string) => FileViewerLoadingController;