@file-viewer/core 3.2.2 → 3.3.0

package/dist/index.js

@@ -167,11 +167,12 @@ export const parseEdaFile = async (buffer, 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, 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, DEFAULT_FILE_VIEWER_TOOLBAR_ORDER, FILE_VIEWER_LIFECYCLE_HOOK_ERROR_MESSAGE_PREFIX, FILE_VIEWER_OPERATION_LABELS, buildFileViewerLifecycleContext, buildFileViewerLifecycleContextFromNormalizedSource, buildFileViewerOperationContext, buildFileViewerOperationContextFromLifecycleState, cloneFileViewerOperationAvailability, createFileViewerLifecycleActions, createFileViewerLifecycleStateController, createFileViewerPublicApi, createFileViewerToolbarActions, createFileViewerToolbarControllerActionHandlers, createFileViewerToolbarZoomSyncSnapshot, DEFAULT_FILE_VIEWER_LIFECYCLE_HOOK_ERROR_LOGGER, DEFAULT_FILE_VIEWER_OPERATION_ERROR_LOGGER, dispatchFileViewerLifecycleEvent, dispatchFileViewerOperationContextEvent, dispatchFileViewerOperationAvailabilityChange, dispatchFileViewerZoomChange, emitFileViewerComponentLifecycleEvent, getFileViewerBeforeOperationHooks, getFileViewerLifecycleHookName, hasVisibleFileViewerToolbarActions, isFileViewerToolbarOperationPermitted, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, reportFileViewerLifecycleHookError, reportFileViewerOperationError, resolveFileViewerLifecycleFallbackSource, resolveFileViewerLifecycleHookErrorMessage, resolveFileViewerBeforeOperationErrorMessage, resolveFileViewerOperationAvailability, resolveFileViewerToolbarOrder, resolveFileViewerToolbarState, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from "./lifecycle/operations.js";
+export { FILE_VIEWER_LIFECYCLE_HOOKS, FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, DEFAULT_FILE_VIEWER_TOOLBAR_ORDER, FILE_VIEWER_LIFECYCLE_HOOK_ERROR_MESSAGE_PREFIX, FILE_VIEWER_OPERATION_LABELS, buildFileViewerLifecycleContext, buildFileViewerLifecycleContextFromNormalizedSource, buildFileViewerOperationContext, buildFileViewerOperationContextFromLifecycleState, cloneFileViewerOperationAvailability, createFileViewerLifecycleActions, createFileViewerLifecycleStateController, createFileViewerPublicApi, createFileViewerToolbarActions, createFileViewerToolbarControllerActionHandlers, createFileViewerToolbarZoomSyncSnapshot, DEFAULT_FILE_VIEWER_LIFECYCLE_HOOK_ERROR_LOGGER, DEFAULT_FILE_VIEWER_OPERATION_ERROR_LOGGER, dispatchFileViewerLifecycleEvent, dispatchFileViewerOperationContextEvent, dispatchFileViewerOperationAvailabilityChange, dispatchFileViewerZoomChange, emitFileViewerComponentLifecycleEvent, getFileViewerBeforeOperationHooks, getFileViewerLifecycleHookName, hasVisibleFileViewerToolbarActions, isFileViewerToolbarOperationPermitted, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, reportFileViewerLifecycleHookError, reportFileViewerOperationError, resolveFileViewerLifecycleFallbackSource, resolveFileViewerLifecycleHookErrorMessage, resolveFileViewerBeforeOperationErrorMessage, resolveFileViewerOperationAvailability, resolveFileViewerToolbarZoomButtons, resolveFileViewerToolbarOrder, resolveFileViewerToolbarState, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, runFileViewerActiveUnloadComplete, runFileViewerActiveUnloadStart, runFileViewerBeforeOperation, runFileViewerLifecycleHook, runFileViewerToolbarAvailabilitySync, runFileViewerToolbarZoomSync, serializeFileViewerContext, } from "./lifecycle/operations.js";
 export { FALLBACK_FILE_VIEWER_LOADING_THEME, FILE_VIEWER_LOADING_THEME_MAP, applyFileViewerLoadingState, cloneFileViewerLoadingState, createFileViewerLoadingController, createFileViewerLoadingControllerActionHandlers, createFileViewerLoadingState, createFileViewerLoadingStyleVars, runFileViewerLoadingControllerAction, runFileViewerLoadingExtensionSync, resolveFileViewerLoadingTheme, syncFileViewerLoadingControllerState, } from "./viewer/loading.js";
 export { createFileViewerLifecycleFacade, } from "./lifecycle/facade.js";
 export { getFileViewerOptionsSearchParam, normalizeFileViewerUiDensity, normalizeFileViewerTheme, parseFileViewerOptions, resolveFileViewerColorScheme, resolveFileViewerUiDensity, sanitizeFileViewerOptions, serializeFileViewerOptions, setFileViewerOptionsSearchParam, toggleFileViewerColorScheme, } from "./config/options.js";
 export { resolveFileViewerPresentationState, } from "./presentation/state.js";
+export { observeFileViewerColorScheme } from "./presentation/colorScheme.js";
 export { createFileViewerRendererDispatcher, } from "./rendering/dispatcher.js";
 export { appendFileViewerStyle, buildFileRenderContextFromLoadContext, applyFileViewerRenderSurfaceState, clearFileViewerRenderSurface, createFileRenderHandlerRendererSession, createFileRenderHandlerRegistry, createFileRenderHandlerLoader, createFileViewerRenderSurfaceActionHandlers, createFileViewerRenderReadinessTarget, createFileViewerRenderSurface, createFileViewerRenderSurfaceState, createFileViewerRenderSurfaceStateTarget, createFileViewerRenderTarget, DEFAULT_FILE_VIEWER_RENDER_TARGET_CLASS, FILE_VIEWER_RENDER_SURFACE_BACKGROUND_PROPERTY, DEFAULT_FILE_VIEWER_RENDER_SESSION_DISPOSE_ERROR_LOGGER, FILE_VIEWER_RENDER_SESSION_DISPOSE_ERROR_MESSAGE, disposeActiveFileViewerRendererSession, disposeFileViewerRendered, disposeFileViewerRendererSession, getFileViewerShadowRootForNode, isFileViewerShadowRoot, normalizeFileViewerStyleIsolation, normalizeFileViewerRenderSurfaceBackground, removeFileViewerRenderTarget, reportFileViewerRenderSessionDisposeError, resetFileViewerRenderSurface, resolveFileViewerStyleIsolation, resolveFileViewerRenderSessionDisposeErrorMessage, runFileViewerRenderSurfaceClear, runFileViewerRenderSurfaceMount, syncFileViewerRenderSurfaceBackground, renderFileViewerHandler, } from "./rendering/handler.js";
 export { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING, createFileViewerTextDecoder, decodeFileViewerTextBuffer, decodeFilename, getExtension, normalizeFileExtension, normalizeFilename, isSingleByteFileViewerTextEncoding, isValidFileViewerUtf8, resolveFileViewerTextEncoding, resolveFileViewerSourceFilename, normalizeSource, readFileViewerBuffer, readFileViewerDataUrl, readFileViewerText, wrapFileViewerFileRef, } from "./source/index.js";
@@ -183,3 +184,4 @@ export { cancelFileViewerPreviewRequest, DEFAULT_FILE_VIEWER_STREAMING_PDF_FILEN
 export { createViewer } from "./viewer/createViewer.js";
 export { WorkerRefImpl, createFileViewerWorkerController, refWorker, } from "./platform/worker.js";
 export { resolveFileViewerCopiedAssetUrl } from "./platform/copiedAssets.js";
+export { installFileViewerImageHandTool } from "./features/document/imageHandTool.js";

package/dist/lifecycle/operations.d.ts

@@ -282,6 +282,7 @@ export declare const resolveFileViewerOperationAvailability: ({ extension, hasOr
 export declare const cloneFileViewerOperationAvailability: (availability: FileViewerOperationAvailability) => FileViewerOperationAvailability;
 export declare const resolveVisibleFileViewerToolbar: (toolbar: FileViewerToolbarOptions, availability: FileViewerOperationAvailability, searchEnabled?: boolean) => FileViewerToolbarOptions;
 export declare const hasVisibleFileViewerToolbarActions: (toolbar: FileViewerToolbarOptions) => boolean;
+export declare const resolveFileViewerToolbarZoomButtons: ({ toolbar, zoomState, renderedReady, hasError, }: Pick<ResolveFileViewerToolbarStateInput, "toolbar" | "zoomState" | "renderedReady" | "hasError">) => Pick<FileViewerOperationAvailability, "zoomIn" | "zoomOut" | "zoomReset">;
 export declare const isFileViewerZoomButtonDisabled: ({ toolbarDisabled, availability, zoomState, action, }: {
     toolbarDisabled?: boolean;
     availability: FileViewerOperationAvailability;

package/dist/lifecycle/operations.js

@@ -571,6 +571,15 @@ export const hasVisibleFileViewerToolbarActions = (toolbar) => {
         toolbar.search ||
         toolbar.theme);
 };
+export const resolveFileViewerToolbarZoomButtons = ({ toolbar, zoomState, renderedReady, hasError = false, }) => {
+    const visible = !!toolbar.zoom && renderedReady && !hasError &&
+        (zoomState.canZoomIn || zoomState.canZoomOut || zoomState.canReset);
+    return {
+        zoomIn: visible && isFileViewerToolbarOperationVisible(toolbar, 'zoom-in'),
+        zoomOut: visible && isFileViewerToolbarOperationVisible(toolbar, 'zoom-out'),
+        zoomReset: visible && isFileViewerToolbarOperationVisible(toolbar, 'zoom-reset'),
+    };
+};
 export const isFileViewerZoomButtonDisabled = ({ toolbarDisabled = false, availability, zoomState, action, }) => {
     const operation = FILE_VIEWER_ZOOM_BUTTON_OPERATIONS[action];
     const operationAllowed = operation === 'zoom-in'
@@ -586,6 +595,8 @@ export const isFileViewerToolbarDisabled = ({ loading = false, hasError = false,
 export const resolveFileViewerToolbarState = ({ toolbar, options, searchAvailable = true, loading = false, ...availabilityInput }) => {
     const operationAvailability = applyToolbarPermissionsToAvailability(resolveFileViewerOperationAvailability(availabilityInput), options === null || options === void 0 ? void 0 : options.toolbar);
     const visibleToolbar = resolveVisibleFileViewerToolbar(toolbar, operationAvailability, (options === null || options === void 0 ? void 0 : options.search) !== false && searchAvailable);
+    const zoomButtons = resolveFileViewerToolbarZoomButtons({ toolbar, ...availabilityInput });
+    visibleToolbar.zoom = zoomButtons.zoomIn || zoomButtons.zoomOut || zoomButtons.zoomReset;
     return {
         operationAvailability,
         visibleToolbar,

package/dist/platform/assets.d.ts

@@ -9,7 +9,7 @@ export declare const DEFAULT_FILE_VIEWER_CHM_WASM_PATH = "vendor/chm/chm_wasm_bg
 export declare const DEFAULT_FILE_VIEWER_CHM_WASM_PACKAGE_PATH = "@file-viewer/renderer-chm/wasm/chm_wasm_bg.wasm";
 export declare const DEFAULT_FILE_VIEWER_DOCX_WORKER_PATH = "vendor/docx/docx.worker.js";
 export declare const DEFAULT_FILE_VIEWER_DOCX_WORKER_JSZIP_PATH = "vendor/docx/jszip.min.js";
-export declare const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = "0.3.36";
+export declare const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = "0.3.39";
 export declare const DEFAULT_FILE_VIEWER_PRESENTATION_WORKER_PATH = "vendor/pptx/pptx.worker.js";
 export declare const DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH = "vendor/ppt";
 export declare const DEFAULT_FILE_VIEWER_PPT_RUNTIME_VERSION = "0.3.6";

package/dist/platform/assets.js

@@ -8,7 +8,7 @@ export const DEFAULT_FILE_VIEWER_CHM_WASM_PATH = 'vendor/chm/chm_wasm_bg.wasm';
 export const DEFAULT_FILE_VIEWER_CHM_WASM_PACKAGE_PATH = '@file-viewer/renderer-chm/wasm/chm_wasm_bg.wasm';
 export const DEFAULT_FILE_VIEWER_DOCX_WORKER_PATH = 'vendor/docx/docx.worker.js';
 export const DEFAULT_FILE_VIEWER_DOCX_WORKER_JSZIP_PATH = 'vendor/docx/jszip.min.js';
-export const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = '0.3.36';
+export const DEFAULT_FILE_VIEWER_DOCX_RUNTIME_VERSION = '0.3.39';
 export const DEFAULT_FILE_VIEWER_PRESENTATION_WORKER_PATH = 'vendor/pptx/pptx.worker.js';
 export const DEFAULT_FILE_VIEWER_PPT_RUNTIME_PATH = 'vendor/ppt';
 export const DEFAULT_FILE_VIEWER_PPT_RUNTIME_VERSION = '0.3.6';

package/dist/presentation/colorScheme.d.ts

@@ -0,0 +1,2 @@
+import type { FileViewerResolvedThemeMode, FileViewerThemeMode } from "../contracts/types.js";
+export declare const observeFileViewerColorScheme: (target: HTMLElement, fallback: FileViewerThemeMode | undefined, apply: (theme: FileViewerResolvedThemeMode) => void) => () => void;

package/dist/presentation/colorScheme.js

@@ -0,0 +1,39 @@
+import { resolveFileViewerColorScheme } from "../config/options.js";
+export const observeFileViewerColorScheme = (target, fallback, apply) => {
+    var _a;
+    const view = target.ownerDocument.defaultView;
+    const media = (_a = view === null || view === void 0 ? void 0 : view.matchMedia) === null || _a === void 0 ? void 0 : _a.call(view, '(prefers-color-scheme: dark)');
+    const ancestors = [];
+    let element = target;
+    while (element) {
+        ancestors.push(element);
+        const root = element.getRootNode();
+        element = element.parentElement || root.host || null;
+    }
+    let current;
+    const update = () => {
+        var _a;
+        const inherited = ancestors
+            .map((node) => node.getAttribute('data-viewer-theme'))
+            .find((value) => value === 'light' || value === 'dark' || value === 'system');
+        const next = resolveFileViewerColorScheme(inherited || fallback, (_a = media === null || media === void 0 ? void 0 : media.matches) !== null && _a !== void 0 ? _a : false);
+        if (next !== current) {
+            current = next;
+            apply(next);
+        }
+    };
+    const observer = (view === null || view === void 0 ? void 0 : view.MutationObserver) ? new view.MutationObserver(update) : undefined;
+    ancestors.forEach((node) => observer === null || observer === void 0 ? void 0 : observer.observe(node, { attributes: true, attributeFilter: ['data-viewer-theme'] }));
+    if (media === null || media === void 0 ? void 0 : media.addEventListener)
+        media.addEventListener('change', update);
+    else
+        media === null || media === void 0 ? void 0 : media.addListener(update);
+    update();
+    return () => {
+        observer === null || observer === void 0 ? void 0 : observer.disconnect();
+        if (media === null || media === void 0 ? void 0 : media.removeEventListener)
+            media.removeEventListener('change', update);
+        else
+            media === null || media === void 0 ? void 0 : media.removeListener(update);
+    };
+};

package/dist/renderers/image.js

@@ -1,4 +1,5 @@
 import { registerFileViewerZoomProvider, unregisterFileViewerZoomProvider, } from "../features/document/dom/index.js";
+import { installFileViewerImageHandTool } from "../features/document/imageHandTool.js";
 import { resolveFileViewerFitScale, } from "../features/document/fit.js";
 import { createFileViewerTranslator } from "../i18n/messages.js";
 import { createFileViewerZoomChangeEmitter as createZoomChangeEmitter } from "../features/document/zoom.js";
@@ -20,7 +21,7 @@ const imageMimeMap = {
 };
 const imageStyle = `
 .image-viewer{position:relative;width:100%;height:100%;overflow:auto;background:var(--file-viewer-render-surface-background,#eef1f4);box-sizing:border-box}
-.image-stage{min-width:100%;min-height:100%;display:flex;align-items:center;justify-content:center;padding:24px;box-sizing:border-box}
+.image-stage{width:max-content;min-width:100%;min-height:100%;display:flex;align-items:center;justify-content:center;padding:24px;box-sizing:border-box}
 .image-stage img{display:block;width:auto;max-width:none;margin:0 auto;border:0;box-shadow:0 18px 48px rgba(15,23,42,.16);background:#fff;cursor:zoom-in}
 .image-stage img:focus-visible{outline:3px solid #2563eb;outline-offset:4px}
 .image-lightbox{position:absolute;inset:0;z-index:40;display:flex;align-items:center;justify-content:center;padding:40px;background:rgba(15,23,42,.9);box-sizing:border-box;opacity:0;visibility:hidden;pointer-events:none;transition:opacity .18s ease,visibility 0s linear .18s}
@@ -127,7 +128,7 @@ const createLightbox = (documentRef, src, t) => {
     };
 };
 export default async function renderImage(buffer, target, type, context) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     const t = createFileViewerTranslator(context === null || context === void 0 ? void 0 : context.options);
     const documentRef = target.ownerDocument || document;
     const targetWindow = documentRef.defaultView;
@@ -155,6 +156,8 @@ export default async function renderImage(buffer, target, type, context) {
     image.setAttribute('aria-haspopup', 'dialog');
     stage.append(image);
     root.append(stage);
+    const disposeHandTool = ((_c = (_b = context === null || context === void 0 ? void 0 : context.options) === null || _b === void 0 ? void 0 : _b.image) === null || _c === void 0 ? void 0 : _c.handTool) === true
+        ? installFileViewerImageHandTool(root, context.signal) : () => { };
     const lightbox = createLightbox(documentRef, src, t);
     const openLightbox = () => lightbox.open(image);
     const openLightboxFromKeyboard = (event) => {
@@ -290,7 +293,7 @@ export default async function renderImage(buffer, target, type, context) {
         subscribe: zoomEmitter.subscribe,
     });
     target.replaceChildren(createStyle(documentRef), root);
-    (((_b = context === null || context === void 0 ? void 0 : context.surface) === null || _b === void 0 ? void 0 : _b.shadowRoot) || target).append(lightbox.element);
+    (((_d = context === null || context === void 0 ? void 0 : context.surface) === null || _d === void 0 ? void 0 : _d.shadowRoot) || target).append(lightbox.element);
     updateViewportSize();
     return {
         $el: target,
@@ -303,6 +306,7 @@ export default async function renderImage(buffer, target, type, context) {
             }
             (_a = context === null || context === void 0 ? void 0 : context.registerThumbnailAdapter) === null || _a === void 0 ? void 0 : _a.call(context, null);
             unregisterFileViewerZoomProvider(root);
+            disposeHandTool();
             resizeObserver.disconnect();
             image.removeEventListener('load', updateViewportSize);
             image.removeEventListener('click', openLightbox);

package/dist/source/loading.d.ts

@@ -314,6 +314,8 @@ export declare const reportFileViewerPreviewLoadError: ({ onLogError, onErrorMes
 export declare const reportFileViewerMissingRemoteData: ({ onErrorMessage, ...messageInput }?: ReportFileViewerMissingRemoteDataInput) => string;
 export interface RunFileViewerRemoteFilePreviewInput<Session = unknown> {
     url: string;
+    filename?: string;
+    type?: string;
     version: number;
     pageHref?: string;
     streaming?: FileViewerPdfOptions['streaming'];
@@ -471,6 +473,8 @@ export interface CreateFileViewerSourceLoadingActionHandlersInput<Session = unkn
     getFile: () => FileViewerFileRef | null | undefined;
     getUrl: () => string | null | undefined;
     getCurrentFilename?: () => string | undefined;
+    getSourceFilename?: () => string | undefined;
+    getSourceType?: () => string | undefined;
     shouldStreamLocalFile?: (input: {
         file: File;
         filename: string;
@@ -550,8 +554,8 @@ export declare const commitFileViewerRenderCompleteState: <Session = unknown>({
 export declare const runFileViewerReadAndRenderFile: <Session = unknown>({ file, version, signal, sourceUrl, source, fallbackFilename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, }: RunFileViewerReadAndRenderFileInput<Session>) => Promise<FileViewerReadAndRenderFileState<Session>>;
 export declare const runFileViewerStreamingPdfPreview: <Session = unknown>({ url, version, filename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, loadingMessage, signal, typeOverride, i18n, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }: RunFileViewerStreamingPdfPreviewInput<Session>) => Promise<FileViewerStreamingPdfPreviewState<Session>>;
 export declare const runFileViewerLocalFilePreview: <Session = unknown>({ source, version, currentFilename, fallbackFilename, shouldStreamLocalFile, requestController, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, onMarkLoadStarted, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }: RunFileViewerLocalFilePreviewInput<Session>) => Promise<FileViewerLocalFilePreviewState<Session>>;
-export declare const runFileViewerRemoteFilePreview: <Session = unknown>({ url, version, pageHref, streaming, shouldStreamRemoteUrl, previewTarget, requestController, isCurrent, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, i18n, onMarkLoadStarted, onStartLoading, onSetLoadingMessage, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onMissingData, onError, }: RunFileViewerRemoteFilePreviewInput<Session>) => Promise<FileViewerRemoteFilePreviewState<Session>>;
-export declare const createFileViewerSourceLoadingActionHandlers: <Session = unknown>({ getFile, getUrl, getCurrentFilename, shouldStreamLocalFile, getPdfStreaming, shouldStreamRemoteUrl, getI18n, getPageHref, previewTarget, requestController, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, formatErrorMessage, onMarkLoadStarted, onClearLoadStarted, onStartLoading, onSetLoadingMessage, onStopLoading, onShowError, onClearError, onResetLoading, onClearRenderedContent, onSession, onActiveDocumentContext, onLifecycle, }: CreateFileViewerSourceLoadingActionHandlersInput<Session>) => FileViewerSourceLoadingActionHandlers<Session>;
+export declare const runFileViewerRemoteFilePreview: <Session = unknown>({ url, filename, type, version, pageHref, streaming, shouldStreamRemoteUrl, previewTarget, requestController, isCurrent, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, i18n, onMarkLoadStarted, onStartLoading, onSetLoadingMessage, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onMissingData, onError, }: RunFileViewerRemoteFilePreviewInput<Session>) => Promise<FileViewerRemoteFilePreviewState<Session>>;
+export declare const createFileViewerSourceLoadingActionHandlers: <Session = unknown>({ getFile, getUrl, getCurrentFilename, getSourceFilename, getSourceType, shouldStreamLocalFile, getPdfStreaming, shouldStreamRemoteUrl, getI18n, getPageHref, previewTarget, requestController, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, formatErrorMessage, onMarkLoadStarted, onClearLoadStarted, onStartLoading, onSetLoadingMessage, onStopLoading, onShowError, onClearError, onResetLoading, onClearRenderedContent, onSession, onActiveDocumentContext, onLifecycle, }: CreateFileViewerSourceLoadingActionHandlersInput<Session>) => FileViewerSourceLoadingActionHandlers<Session>;
 export declare const finalizeFileViewerPreviewLoadState: ({ version, isCurrent, onClearLoadStarted, onStopLoading, }: FinalizeFileViewerPreviewLoadStateInput) => void;
 export declare const resolveFileViewerLoadStartMessage: (source: FileViewerLifecycleContext["source"], i18n?: FileViewerI18nInput) => string;
 export declare const commitFileViewerLoadStartState: ({ version, filename, fallbackFilename, filenameTarget, buildState, onMarkLoadStarted, onLifecycle, onStartLoading, }: CommitFileViewerLoadStartStateInput) => FileViewerLoadStartState;
@@ -601,8 +605,9 @@ export interface FileViewerLocationLike {
     href?: string | null;
 }
 export declare const resolveFileViewerPageHref: (locationLike?: FileViewerLocationLike) => string | undefined;
-export declare const resolveFileViewerRemoteSourcePlan: ({ filename, fallbackFilename, pageHref, streaming, shouldStreamRemoteUrl, url, }: {
+export declare const resolveFileViewerRemoteSourcePlan: ({ filename, type, fallbackFilename, pageHref, streaming, shouldStreamRemoteUrl, url, }: {
     filename?: string;
+    type?: string;
     fallbackFilename?: string;
     pageHref?: string;
     streaming?: FileViewerPdfOptions["streaming"];

package/dist/source/loading.js

@@ -1,7 +1,7 @@
 import { buildFileViewerLifecycleContext, } from "../lifecycle/operations.js";
 import { resolveFileViewerPreviewMessages, } from "../viewer/state.js";
 import { translateFileViewerMessage } from "../i18n/messages.js";
-import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, getExtension, normalizeFilename, readFileViewerBuffer, resolveFileViewerSourceFilename, wrapFileViewerFileRef, } from "./index.js";
+import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, getExtension, normalizeFilename, normalizeFileExtension, readFileViewerBuffer, resolveFileViewerSourceFilename, wrapFileViewerFileRef, } from "./index.js";
 export const DEFAULT_PDF_RANGE_CHUNK_SIZE = 64 * 1024;
 export const DEFAULT_FILE_VIEWER_STREAMING_PDF_FILENAME = 'preview.pdf';
 export const FILE_VIEWER_REMOTE_MISSING_DATA_ERROR_MESSAGE = '文件下载失败';
@@ -596,8 +596,10 @@ export const runFileViewerLocalFilePreview = async ({ source, version, currentFi
         });
     }
 };
-export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, streaming, shouldStreamRemoteUrl, previewTarget, requestController, isCurrent, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, i18n, onMarkLoadStarted, onStartLoading, onSetLoadingMessage, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onMissingData, onError, }) => {
+export const runFileViewerRemoteFilePreview = async ({ url, filename, type, version, pageHref, streaming, shouldStreamRemoteUrl, previewTarget, requestController, isCurrent, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, i18n, onMarkLoadStarted, onStartLoading, onSetLoadingMessage, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onMissingData, onError, }) => {
     let remoteSource = resolveFileViewerRemoteSourcePlan({
+        filename,
+        type,
         pageHref,
         streaming,
         url,
@@ -664,7 +666,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
                     ? undefined
                     : resolveFileViewerPreviewMessages(i18n).downloading,
                 signal: controller === null || controller === void 0 ? void 0 : controller.signal,
-                typeOverride: remoteSource.streamType,
+                typeOverride: remoteSource.streamPdf ? 'pdf' : remoteSource.streamType,
                 onStartLoading,
                 onSession,
                 onActiveDocumentContext,
@@ -808,7 +810,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
         }
     }
 };
-export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, getCurrentFilename, shouldStreamLocalFile, getPdfStreaming, shouldStreamRemoteUrl, getI18n, getPageHref, previewTarget, requestController, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, formatErrorMessage, onMarkLoadStarted, onClearLoadStarted, onStartLoading, onSetLoadingMessage, onStopLoading, onShowError, onClearError, onResetLoading, onClearRenderedContent, onSession, onActiveDocumentContext, onLifecycle, }) => {
+export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, getCurrentFilename, getSourceFilename, getSourceType, shouldStreamLocalFile, getPdfStreaming, shouldStreamRemoteUrl, getI18n, getPageHref, previewTarget, requestController, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, formatErrorMessage, onMarkLoadStarted, onClearLoadStarted, onStartLoading, onSetLoadingMessage, onStopLoading, onShowError, onClearError, onResetLoading, onClearRenderedContent, onSession, onActiveDocumentContext, onLifecycle, }) => {
     const isCurrentRequest = (version) => requestController.isCurrent(version);
     const previewLocalFile = async (source, version) => {
         var _a;
@@ -853,6 +855,8 @@ export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, g
     const previewRemoteFile = async (url, version) => {
         return await runFileViewerRemoteFilePreview({
             url,
+            filename: getSourceFilename === null || getSourceFilename === void 0 ? void 0 : getSourceFilename(),
+            type: getSourceType === null || getSourceType === void 0 ? void 0 : getSourceType(),
             version,
             pageHref: getPageHref === null || getPageHref === void 0 ? void 0 : getPageHref(),
             streaming: getPdfStreaming === null || getPdfStreaming === void 0 ? void 0 : getPdfStreaming(),
@@ -1034,18 +1038,16 @@ export const shouldStreamPdfUrl = ({ extension, pageHref, streaming, url, }) =>
 export const resolveFileViewerPageHref = (locationLike) => {
     return (locationLike === null || locationLike === void 0 ? void 0 : locationLike.href) || undefined;
 };
-export const resolveFileViewerRemoteSourcePlan = ({ filename, fallbackFilename = DEFAULT_FILE_VIEWER_SOURCE_FILENAME, pageHref, streaming, shouldStreamRemoteUrl, url, }) => {
+export const resolveFileViewerRemoteSourcePlan = ({ filename, type, fallbackFilename = DEFAULT_FILE_VIEWER_SOURCE_FILENAME, pageHref, streaming, shouldStreamRemoteUrl, url, }) => {
     const sourceUrl = normalizeFileViewerSourceUrl(url) || url;
     const nextFilename = normalizeFilename(filename || url, fallbackFilename);
-    const extension = getExtension(nextFilename);
-    const streamPdf = pageHref
-        ? shouldStreamPdfUrl({
-            extension,
-            pageHref,
-            streaming,
-            url: sourceUrl,
-        })
-        : false;
+    const extension = normalizeFileExtension(type || getExtension(nextFilename));
+    const streamPdf = shouldStreamPdfUrl({
+        extension,
+        pageHref: pageHref || '',
+        streaming,
+        url: sourceUrl,
+    });
     const streamDecision = !streamPdf
         ? shouldStreamRemoteUrl === null || shouldStreamRemoteUrl === void 0 ? void 0 : shouldStreamRemoteUrl({
             url: sourceUrl,

package/dist/viewer/createViewer.js

@@ -259,6 +259,7 @@ export const createViewer = (container, createOptions = {}) => {
             surface.container.style.height = '100%';
         }
         syncFileViewerRenderSurfaceBackground(target, options);
+        target.setAttribute('data-viewer-theme', options.theme || 'system');
         currentRenderTarget = target;
         return surface;
     };
@@ -722,6 +723,7 @@ export const createViewer = (container, createOptions = {}) => {
                 ...nextOptions,
             };
             syncFileViewerRenderSurfaceBackground(currentRenderTarget, options);
+            currentRenderTarget === null || currentRenderTarget === void 0 ? void 0 : currentRenderTarget.setAttribute('data-viewer-theme', options.theme || 'system');
             syncWatermarkOverlay();
             if ('fit' in nextOptions && nextOptions.fit !== previousFit) {
                 fitController.resetAutoFit();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/core",
-  "version": "3.2.2",
+  "version": "3.3.0",
   "private": false,
   "type": "module",
   "description": "Framework-neutral modular TypeScript core for File Viewer renderer orchestration, lifecycle APIs, search, zoom, print, and export",
@@ -84,6 +84,8 @@
     "dist/browser.js",
     "dist/browser/controller.d.ts",
     "dist/browser/controller.js",
+    "dist/browser/toolbar-focus.d.ts",
+    "dist/browser/toolbar-focus.js",
     "dist/config/options.d.ts",
     "dist/config/options.js",
     "dist/contracts/types.d.ts",
@@ -106,6 +108,8 @@
     "dist/features/document/events.js",
     "dist/features/document/fit.d.ts",
     "dist/features/document/fit.js",
+    "dist/features/document/imageHandTool.d.ts",
+    "dist/features/document/imageHandTool.js",
     "dist/features/document/model.d.ts",
     "dist/features/document/model.js",
     "dist/features/document/search.d.ts",
@@ -152,6 +156,8 @@
     "dist/platform/copiedAssets.js",
     "dist/platform/worker.d.ts",
     "dist/platform/worker.js",
+    "dist/presentation/colorScheme.d.ts",
+    "dist/presentation/colorScheme.js",
     "dist/presentation/state.d.ts",
     "dist/presentation/state.js",
     "dist/print-mask.d.ts",
@@ -196,10 +202,11 @@
     "print-mask.d.ts",
     "print-mask.js",
     "README.en.md",
-    "README.md"
+    "README.md",
+    "README.zh-CN.md"
   ],
   "dependencies": {
-    "dompurify": "3.4.16"
+    "dompurify": "3.4.17"
   },
   "license": "Apache-2.0",
   "fileViewer": {