@file-viewer/core 3.1.1 → 3.2.0

package/dist/rendering/handler.js

@@ -1,17 +1,12 @@
-// Rendering orchestration layer.
-//
-// This module adapts registry entries into disposable renderer sessions. It is
-// the only place that should bridge raw buffers, DOM targets, render contexts,
-// export adapters, and readiness state.
-import { DEFAULT_RENDERER_DEFINITIONS } from '../registry/formats.js';
-import { waitForFileViewerNextPaint } from '../output/export.js';
-import { createFileViewerRendererDispatcher } from './dispatcher.js';
-import { resolveFileViewerRendererRedirectId } 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';
+import { DEFAULT_RENDERER_DEFINITIONS } from "../registry/formats.js";
+import { waitForFileViewerNextPaint } from "../output/export.js";
+import { createFileViewerRendererDispatcher } from "./dispatcher.js";
+import { resolveFileViewerRendererRedirectId } 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';
 export const FILE_VIEWER_RENDER_SURFACE_BACKGROUND_PROPERTY = '--file-viewer-render-surface-background';
@@ -24,11 +19,6 @@ export const normalizeFileViewerRenderSurfaceBackground = (value) => {
     const normalized = value.trim();
     return normalized && normalized.toLowerCase() !== 'auto' ? normalized : null;
 };
-/**
- * Keeps the public UI option and the renderer-facing CSS custom property in
- * sync. Custom properties inherit through Shadow DOM, so setting this on the
- * render host covers both scoped and shadow-isolated renderer targets.
- */
 export const syncFileViewerRenderSurfaceBackground = (target, options) => {
     var _a;
     if (!target) {
@@ -161,8 +151,6 @@ export const appendFileViewerStyle = (target, css, options = {}) => {
     const shadowRoot = getFileViewerShadowRootForNode(target);
     const StyleSheet = shadowRoot ? getConstructableStyleSheet(shadowRoot) : null;
     if (options.adoptedStyleSheet && shadowRoot && StyleSheet) {
-        // Use the target document's constructor. A stylesheet constructed in the
-        // parent window cannot be adopted by a ShadowRoot owned by an iframe.
         const sheet = new StyleSheet();
         sheet.replaceSync(css);
         shadowRoot.adoptedStyleSheets = [...shadowRoot.adoptedStyleSheets, sheet];
@@ -348,7 +336,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, onStartFitObserver, onStartViewStateObserver, onApplyInitialFit, onRefreshDocumentIndex, onRefreshZoomProvider, onRefreshViewStateProvider, }) => {
+export const runFileViewerRenderSurfaceMount = async ({ buffer, file, version, sourceUrl, streamUrl, signal, typeOverride, getContainer, surfaceState, readinessState, isCurrent, clearRenderedContent, render, waitForContainer, waitForPaint = waitForFileViewerNextPaint, disposeSession = disposeFileViewerRendererSession, onStartZoomObserver, onStartFitObserver, onStartViewStateObserver, onApplyInitialFit, onRefreshDocumentIndex, onRefreshZoomProvider, onRefreshViewStateProvider, }) => {
     if (!getContainer()) {
         await (waitForContainer === null || waitForContainer === void 0 ? void 0 : waitForContainer());
     }
@@ -380,11 +368,12 @@ export const runFileViewerRenderSurfaceMount = async ({ buffer, file, version, s
             buffer,
             file,
             version,
-            type: getExtension(file.name),
+            type: typeOverride || getExtension(file.name),
             target,
             filename: file.name,
             sourceUrl,
             streamUrl,
+            signal,
             onProgressiveRender,
             registerExportAdapter,
             surfaceState,
@@ -446,13 +435,15 @@ export const createFileViewerRenderSurfaceActionHandlers = ({ getContainer, surf
             onClearViewStateProvider,
         });
     };
-    const mountRenderedContent = async (buffer, file, version, sourceUrl, streamUrl) => {
+    const mountRenderedContent = async (buffer, file, version, sourceUrl, streamUrl, signal, typeOverride) => {
         return await runFileViewerRenderSurfaceMount({
             buffer,
             file,
             version,
             sourceUrl,
             streamUrl,
+            signal,
+            typeOverride,
             getContainer,
             surfaceState,
             readinessState,
@@ -482,6 +473,7 @@ export const buildFileRenderContextFromLoadContext = ({ source, surface, options
     filename: source.filename,
     url: source.url,
     streamUrl: source.url,
+    sourceFile: source.file,
     signal,
     options,
     surface,
@@ -525,15 +517,16 @@ export const renderFileViewerHandler = async ({ dispatcher, buffer, target, type
         return await redirectedHandler(buffer, target, redirectedType, context);
     }
 };
-export const createFileRenderHandlerLoader = ({ handler, rendererId, getTarget = context => context.surface.container, createContext = buildFileRenderContextFromLoadContext, destroy, }) => {
+export const createFileRenderHandlerLoader = ({ handler, rendererId, allowUrlSource = false, getTarget = context => context.surface.container, createContext = buildFileRenderContextFromLoadContext, destroy, }) => {
     return async (context) => {
         const { source } = context;
-        if (!source.buffer) {
+        if (!source.buffer && !(allowUrlSource && (source.url || source.file))) {
             throw new Error('FileRenderHandler renderer requires an ArrayBuffer source.');
         }
+        const buffer = source.buffer || new ArrayBuffer(0);
         const target = getTarget(context);
         const renderContext = createContext(context);
-        const rendered = await handler(source.buffer, target, source.extension, renderContext);
+        const rendered = await handler(buffer, target, source.extension, renderContext);
         const existingProvider = findFileViewerViewStateProvider(target);
         const genericViewStateProvider = existingProvider
             ? null

package/dist/security/svgResources.d.ts

@@ -1,13 +1,3 @@
-/**
- * Keep ordinary SVG styles while preventing imports and resource requests.
- * Obfuscated URL tokens fail closed instead of depending on parser quirks.
- */
 export declare const sanitizeFileViewerSvgCss: (value: string) => string;
-/** Remove executable attributes and every SVG resource URL that can load data remotely. */
 export declare const sanitizeFileViewerSvgResources: (root: ParentNode) => void;
-/**
- * Mermaid 11 resolves image-node URLs with `new Image()` while rendering,
- * before its SVG can be sanitized. Reject image metadata and explicit remote
- * URLs before calling Mermaid so an untrusted diagram cannot initiate I/O.
- */
 export declare const assertFileViewerMermaidSourceHasNoExternalResources: (source: string) => void;

package/dist/security/svgResources.js

@@ -44,10 +44,6 @@ const isSafeSvgCssUrl = (value) => {
         /^blob:/i.test(normalized) ||
         SAFE_EMBEDDED_IMAGE_DATA_URL.test(normalized);
 };
-/**
- * Keep ordinary SVG styles while preventing imports and resource requests.
- * Obfuscated URL tokens fail closed instead of depending on parser quirks.
- */
 export const sanitizeFileViewerSvgCss = (value) => {
     const normalizedCharacters = [];
     for (const character of value) {
@@ -93,7 +89,6 @@ export const sanitizeFileViewerSvgCss = (value) => {
     chunks.push(normalized.slice(segmentStart));
     return chunks.join('');
 };
-/** Remove executable attributes and every SVG resource URL that can load data remotely. */
 export const sanitizeFileViewerSvgResources = (root) => {
     root.querySelectorAll('*').forEach(element => {
         for (const attribute of Array.from(element.attributes)) {
@@ -160,18 +155,14 @@ const canonicalizeMermaidSourceForResourceScan = (source) => {
     }
     return output;
 };
-/**
- * Mermaid 11 resolves image-node URLs with `new Image()` while rendering,
- * before its SVG can be sanitized. Reject image metadata and explicit remote
- * URLs before calling Mermaid so an untrusted diagram cannot initiate I/O.
- */
 export const assertFileViewerMermaidSourceHasNoExternalResources = (source) => {
     const normalized = canonicalizeMermaidSourceForResourceScan(String(source || ''));
     const compact = normalized.replace(/[\t\r\n ]+/g, '');
     const hasImageMetadata = /(?:^|[,{])\s*(?:img|["']img["'])\s*:/im.test(normalized);
+    const hasLoadingElement = /<\s*(?:img|image|iframe|object|embed|video|audio|source|link|script|style)\b/i.test(normalized);
     const hasRemoteUrl = /(?:https?|ftp):\/\//i.test(compact) ||
         /(?:^|[\s"'(=:,])(?:\/\/|\\\\)[A-Za-z0-9]/m.test(normalized);
-    if (hasImageMetadata || hasRemoteUrl) {
+    if (hasImageMetadata || hasLoadingElement || hasRemoteUrl) {
         throw new Error('Mermaid diagrams may not load external image resources.');
     }
 };

package/dist/source/index.d.ts

@@ -1,6 +1,6 @@
-import type { FileViewerFileRef, FileViewerSource, NormalizedFileViewerSource } from '../contracts/types';
-export { createFileViewerTextDecoder, decodeFileViewerTextBuffer, isValidFileViewerUtf8, resolveFileViewerTextEncoding, } from './textEncoding';
-export type { DecodedFileViewerText, FileViewerTextEncoding, ResolvedFileViewerTextEncoding, ResolvedFileViewerTextSource, } from './textEncoding';
+import type { FileViewerFileRef, FileViewerSource, NormalizedFileViewerSource } from "../contracts/types.js";
+export { DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING, createFileViewerTextDecoder, decodeFileViewerTextBuffer, isSingleByteFileViewerTextEncoding, isValidFileViewerUtf8, resolveFileViewerTextEncoding, } from "./textEncoding.js";
+export type { DecodedFileViewerText, FileViewerSingleByteTextEncoding, FileViewerTextEncoding, ResolvedFileViewerTextEncoding, ResolvedFileViewerTextSource, } from "./textEncoding.js";
 export type FileViewerReadResult = string | ArrayBuffer | undefined | null;
 export declare const DEFAULT_FILE_VIEWER_SOURCE_FILENAME = "preview.bin";
 export declare const normalizeFileExtension: (extension: string) => string;

package/dist/source/index.js

@@ -1,4 +1,4 @@
-export { createFileViewerTextDecoder, decodeFileViewerTextBuffer, isValidFileViewerUtf8, resolveFileViewerTextEncoding, } from './textEncoding.js';
+export { DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING, createFileViewerTextDecoder, decodeFileViewerTextBuffer, isSingleByteFileViewerTextEncoding, isValidFileViewerUtf8, resolveFileViewerTextEncoding, } from "./textEncoding.js";
 export const DEFAULT_FILE_VIEWER_SOURCE_FILENAME = 'preview.bin';
 export const normalizeFileExtension = (extension) => {
     return extension.trim().replace(/^\./, '').toLowerCase();

package/dist/source/loading.d.ts

@@ -1,7 +1,7 @@
-import type { FileViewerFileRef, FileViewerLifecycleContext, FileViewerPdfOptions } from '../contracts/types';
-import { type FileViewerLifecycleStateController } from '../lifecycle/operations';
-import { type FileViewerErrorMessageFormatter } from '../viewer/state';
-import type { FileViewerI18nInput } from '../i18n/messages';
+import type { FileViewerFileRef, FileViewerLifecycleContext, FileViewerPdfOptions } from "../contracts/types.js";
+import { type FileViewerLifecycleStateController } from "../lifecycle/operations.js";
+import { type FileViewerErrorMessageFormatter } from "../viewer/state.js";
+import type { FileViewerI18nInput } from "../i18n/messages.js";
 export declare const DEFAULT_PDF_RANGE_CHUNK_SIZE: number;
 export declare const DEFAULT_FILE_VIEWER_STREAMING_PDF_FILENAME = "preview.pdf";
 export declare const FILE_VIEWER_REMOTE_MISSING_DATA_ERROR_MESSAGE = "\u6587\u4EF6\u4E0B\u8F7D\u5931\u8D25";
@@ -131,6 +131,8 @@ export interface CreateFileViewerLoadStartStateInput {
     sourceUrl?: string | null;
     bufferSize?: number;
     loadingMessage?: string;
+    signal?: AbortSignal;
+    typeOverride?: string;
     i18n?: FileViewerI18nInput;
     timestamp?: number;
 }
@@ -172,12 +174,13 @@ export interface CommitFileViewerRenderCompleteStateInput<Session = unknown> {
 export interface RunFileViewerReadAndRenderFileInput<Session = unknown> {
     file: File;
     version: number;
+    signal?: AbortSignal;
     source?: FileViewerLifecycleContext['source'];
     sourceUrl?: string;
     fallbackFilename?: string;
     previewTarget: MutableFileViewerReadPreviewState & MutableFileViewerRenderReadinessState;
     isCurrent: (version: number) => boolean;
-    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string) => Promise<Session | undefined>;
+    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string, streamUrl?: string, signal?: AbortSignal, typeOverride?: string) => Promise<Session | undefined>;
     destroyRenderSession?: (session?: Session | null) => void;
     buildRenderCompleteState: (input: {
         version: number;
@@ -201,13 +204,14 @@ export type FileViewerReadAndRenderFileState<Session = unknown> = {
     readonly session: Session | undefined;
     readonly complete: FileViewerRenderCompleteState;
 };
+export type FileViewerStreamSourceDecision = boolean | string;
 export interface RunFileViewerStreamingPdfPreviewInput<Session = unknown> {
     url: string;
     version: number;
     filename?: string;
     previewTarget: MutableFileViewerPreviewSourceUrlState & MutableFileViewerRenderReadinessState;
     isCurrent: (version: number) => boolean;
-    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string, streamUrl?: string) => Promise<Session | undefined>;
+    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string, streamUrl?: string, signal?: AbortSignal, typeOverride?: string) => Promise<Session | undefined>;
     destroyRenderSession?: (session?: Session | null) => void;
     buildRenderCompleteState: (input: {
         version: number;
@@ -215,6 +219,8 @@ export interface RunFileViewerStreamingPdfPreviewInput<Session = unknown> {
         sourceUrl?: string | null;
     }) => FileViewerRenderCompleteState;
     loadingMessage?: string;
+    signal?: AbortSignal;
+    typeOverride?: string;
     i18n?: FileViewerI18nInput;
     onStartLoading?: (message: string) => void;
     onSession?: (session: Session | null) => void;
@@ -248,9 +254,16 @@ export interface RunFileViewerLocalFilePreviewInput<Session = unknown> {
     version: number;
     currentFilename?: string;
     fallbackFilename?: string;
+    shouldStreamLocalFile?: (input: {
+        file: File;
+        filename: string;
+        extension: string;
+        signal?: AbortSignal;
+    }) => FileViewerStreamSourceDecision | Promise<FileViewerStreamSourceDecision>;
+    requestController?: Pick<FileViewerRequestController, 'createAbortController' | 'clearAbortController'>;
     previewTarget: MutableFileViewerPreviewState;
     isCurrent: (version: number) => boolean;
-    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string) => Promise<Session | undefined>;
+    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string, streamUrl?: string, signal?: AbortSignal, typeOverride?: string) => Promise<Session | undefined>;
     destroyRenderSession?: (session?: Session | null) => void;
     buildLoadStartState: (input: {
         version: number;
@@ -304,11 +317,18 @@ export interface RunFileViewerRemoteFilePreviewInput<Session = unknown> {
     version: number;
     pageHref?: string;
     streaming?: FileViewerPdfOptions['streaming'];
+    shouldStreamRemoteUrl?: (input: {
+        url: string;
+        filename: string;
+        extension: string;
+        pageHref?: string;
+        signal?: AbortSignal;
+    }) => FileViewerStreamSourceDecision | Promise<FileViewerStreamSourceDecision>;
     previewTarget: MutableFileViewerPreviewState;
     requestController: Pick<FileViewerRequestController, 'createAbortController' | 'clearAbortController'>;
     isCurrent: (version: number) => boolean;
     downloadFile: (input: FileViewerRemoteFileDownloadInput) => Promise<FileViewerFileRef | null | undefined>;
-    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string, streamUrl?: string) => Promise<Session | undefined>;
+    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string, streamUrl?: string, signal?: AbortSignal, typeOverride?: string) => Promise<Session | undefined>;
     destroyRenderSession?: (session?: Session | null) => void;
     buildLoadStartState: (input: {
         version: number;
@@ -451,13 +471,26 @@ export interface CreateFileViewerSourceLoadingActionHandlersInput<Session = unkn
     getFile: () => FileViewerFileRef | null | undefined;
     getUrl: () => string | null | undefined;
     getCurrentFilename?: () => string | undefined;
+    shouldStreamLocalFile?: (input: {
+        file: File;
+        filename: string;
+        extension: string;
+        signal?: AbortSignal;
+    }) => FileViewerStreamSourceDecision | Promise<FileViewerStreamSourceDecision>;
     getPdfStreaming?: () => FileViewerPdfOptions['streaming'] | undefined;
+    shouldStreamRemoteUrl?: (input: {
+        url: string;
+        filename: string;
+        extension: string;
+        pageHref?: string;
+        signal?: AbortSignal;
+    }) => FileViewerStreamSourceDecision | Promise<FileViewerStreamSourceDecision>;
     getI18n?: () => FileViewerI18nInput;
     getPageHref?: () => string | undefined;
     previewTarget: MutableFileViewerPreviewState;
     requestController: FileViewerRequestController;
     downloadFile: (input: FileViewerRemoteFileDownloadInput) => Promise<FileViewerFileRef | null | undefined>;
-    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string, streamUrl?: string) => Promise<Session | undefined>;
+    mountRenderedContent: (buffer: ArrayBuffer, file: File, version: number, sourceUrl?: string, streamUrl?: string, signal?: AbortSignal, typeOverride?: string) => Promise<Session | undefined>;
     destroyRenderSession?: (session?: Session | null) => void;
     buildLoadStartState: (input: {
         version: number;
@@ -514,11 +547,11 @@ export declare const applyFileViewerPreviewSourceUrlState: <Target extends Mutab
 export declare const applyFileViewerPreviewFilenameState: <Target extends MutableFileViewerPreviewFilenameState>(target: Target, filename?: string, fallbackFilename?: string) => Target;
 export declare const applyFileViewerRenderReadinessState: <Target extends MutableFileViewerRenderReadinessState>(target: Target, state: Partial<FileViewerRenderReadinessState>) => Target;
 export declare const commitFileViewerRenderCompleteState: <Session = unknown>({ version, session, buildState, readinessTarget, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, }: CommitFileViewerRenderCompleteStateInput<Session>) => FileViewerRenderCompleteState;
-export declare const runFileViewerReadAndRenderFile: <Session = unknown>({ file, version, 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, i18n, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }: RunFileViewerStreamingPdfPreviewInput<Session>) => Promise<FileViewerStreamingPdfPreviewState<Session>>;
-export declare const runFileViewerLocalFilePreview: <Session = unknown>({ source, version, currentFilename, fallbackFilename, 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, 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, getPdfStreaming, 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 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 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;
@@ -538,6 +571,8 @@ export interface FileViewerRemoteSourcePlan {
     readonly filename: string;
     readonly extension: string;
     readonly streamPdf: boolean;
+    readonly streamRenderer: boolean;
+    readonly streamType?: string;
 }
 export interface CommitFileViewerRemoteDownloadStateInput {
     version: number;
@@ -566,11 +601,17 @@ export interface FileViewerLocationLike {
     href?: string | null;
 }
 export declare const resolveFileViewerPageHref: (locationLike?: FileViewerLocationLike) => string | undefined;
-export declare const resolveFileViewerRemoteSourcePlan: ({ filename, fallbackFilename, pageHref, streaming, url, }: {
+export declare const resolveFileViewerRemoteSourcePlan: ({ filename, fallbackFilename, pageHref, streaming, shouldStreamRemoteUrl, url, }: {
     filename?: string;
     fallbackFilename?: string;
     pageHref?: string;
     streaming?: FileViewerPdfOptions["streaming"];
+    shouldStreamRemoteUrl?: (input: {
+        url: string;
+        filename: string;
+        extension: string;
+        pageHref?: string;
+    }) => FileViewerStreamSourceDecision;
     url: string;
 }) => FileViewerRemoteSourcePlan;
 export declare const commitFileViewerRemoteDownloadState: ({ version, data, currentFilename, fallbackFilename, isCurrent, i18n, onMissingData, onSetLoadingMessage, }: CommitFileViewerRemoteDownloadStateInput) => FileViewerRemoteDownloadState;