@file-viewer/core 3.1.1 → 3.2.0

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 { 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";
 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 = '文件下载失败';
@@ -117,7 +117,6 @@ const encodeFileViewerUrlPathSegment = (segment) => {
         decoded = decodeURIComponent(segment);
     }
     catch {
-        // Invalid percent escapes are treated as literal filename characters.
     }
     return encodeURIComponent(decoded)
         .replace(/%3A/gi, ':')
@@ -360,9 +359,9 @@ export const commitFileViewerRenderCompleteState = ({ version, session, buildSta
     onClearLoadStarted === null || onClearLoadStarted === void 0 ? void 0 : onClearLoadStarted(version);
     return completeState;
 };
-export const runFileViewerReadAndRenderFile = async ({ file, version, sourceUrl, source = sourceUrl ? 'url' : 'file', fallbackFilename = '', previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, }) => {
+export const runFileViewerReadAndRenderFile = async ({ file, version, signal, sourceUrl, source = sourceUrl ? 'url' : 'file', fallbackFilename = '', previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, }) => {
     const buffer = await readFileViewerBuffer(file);
-    if (!isCurrent(version)) {
+    if (!isCurrent(version) || (signal === null || signal === void 0 ? void 0 : signal.aborted)) {
         return {
             stale: true,
             buffer,
@@ -377,7 +376,7 @@ export const runFileViewerReadAndRenderFile = async ({ file, version, sourceUrl,
         fallbackFilename,
     }));
     const session = await mountRenderedContent(buffer, file, version, sourceUrl);
-    if (!isCurrent(version)) {
+    if (!isCurrent(version) || (signal === null || signal === void 0 ? void 0 : signal.aborted)) {
         destroyRenderSession === null || destroyRenderSession === void 0 ? void 0 : destroyRenderSession(session);
         return {
             stale: true,
@@ -408,15 +407,15 @@ export const runFileViewerReadAndRenderFile = async ({ file, version, sourceUrl,
         complete,
     };
 };
-export const runFileViewerStreamingPdfPreview = async ({ url, version, filename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, loadingMessage, i18n, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }) => {
+export const runFileViewerStreamingPdfPreview = async ({ url, version, filename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, loadingMessage, signal, typeOverride, i18n, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }) => {
     let placeholderFile = null;
     onStartLoading === null || onStartLoading === void 0 ? void 0 : onStartLoading(loadingMessage || resolveFileViewerPreviewMessages(i18n).streamingPdf);
     try {
         placeholderFile = createFileViewerStreamingPdfPlaceholderFile(filename);
         applyFileViewerPreviewSourceUrlState(previewTarget, url);
-        const session = await mountRenderedContent(new ArrayBuffer(0), placeholderFile, version, url, url);
-        if (!isCurrent(version)) {
-            destroyRenderSession === null || destroyRenderSession === void 0 ? void 0 : destroyRenderSession(session);
+        const session = await mountRenderedContent(new ArrayBuffer(0), placeholderFile, version, url, url, signal, typeOverride);
+        if (!isCurrent(version) || (signal === null || signal === void 0 ? void 0 : signal.aborted)) {
+            await (destroyRenderSession === null || destroyRenderSession === void 0 ? void 0 : destroyRenderSession(session));
             return {
                 status: 'stale',
                 placeholderFile,
@@ -448,7 +447,7 @@ export const runFileViewerStreamingPdfPreview = async ({ url, version, filename,
         };
     }
     catch (error) {
-        if (!isCurrent(version)) {
+        if (!isCurrent(version) || (signal === null || signal === void 0 ? void 0 : signal.aborted) || isFileViewerAbortError(error)) {
             return {
                 status: 'stale',
                 placeholderFile,
@@ -475,7 +474,7 @@ export const runFileViewerStreamingPdfPreview = async ({ url, version, filename,
         });
     }
 };
-export const runFileViewerLocalFilePreview = async ({ source, version, currentFilename, fallbackFilename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, onMarkLoadStarted, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }) => {
+export const runFileViewerLocalFilePreview = async ({ source, version, currentFilename, fallbackFilename, shouldStreamLocalFile, requestController, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, onMarkLoadStarted, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }) => {
     const localSource = resolveFileViewerFileRefSourcePlan({
         source,
         currentFilename,
@@ -495,14 +494,55 @@ export const runFileViewerLocalFilePreview = async ({ source, version, currentFi
         onLifecycle,
         onStartLoading,
     });
+    const controller = (requestController === null || requestController === void 0 ? void 0 : requestController.createAbortController()) || null;
     try {
+        const streamDecision = await (shouldStreamLocalFile === null || shouldStreamLocalFile === void 0 ? void 0 : shouldStreamLocalFile({
+            file,
+            filename: localSource.filename,
+            extension: getExtension(localSource.filename),
+            signal: controller === null || controller === void 0 ? void 0 : controller.signal,
+        }));
+        if (!isCurrent(version) || (controller === null || controller === void 0 ? void 0 : controller.signal.aborted)) {
+            return { status: 'stale', source: localSource, read: null, error: null };
+        }
+        if (streamDecision) {
+            const buffer = new ArrayBuffer(0);
+            const typeOverride = typeof streamDecision === 'string' ? streamDecision : undefined;
+            applyFileViewerReadPreviewState(previewTarget, createFileViewerReadPreviewState({
+                file,
+                buffer,
+                fallbackFilename: localSource.filename,
+            }));
+            const session = await mountRenderedContent(buffer, file, version, undefined, undefined, controller === null || controller === void 0 ? void 0 : controller.signal, typeOverride);
+            if (!isCurrent(version) || (controller === null || controller === void 0 ? void 0 : controller.signal.aborted)) {
+                destroyRenderSession === null || destroyRenderSession === void 0 ? void 0 : destroyRenderSession(session);
+                return { status: 'stale', source: localSource, read: null, error: null };
+            }
+            const complete = commitFileViewerRenderCompleteState({
+                version,
+                session,
+                readinessTarget: previewTarget,
+                buildState: () => buildRenderCompleteState({ version, source: 'file', file }),
+                onSession,
+                onActiveDocumentContext,
+                onLifecycle,
+                onClearLoadStarted,
+            });
+            return {
+                status: 'ready',
+                source: localSource,
+                read: { stale: false, buffer, session, complete },
+                error: null,
+            };
+        }
         const read = await runFileViewerReadAndRenderFile({
             file,
             version,
+            signal: controller === null || controller === void 0 ? void 0 : controller.signal,
             source: 'file',
             previewTarget,
             isCurrent,
-            mountRenderedContent,
+            mountRenderedContent: (buffer, file, version, sourceUrl) => mountRenderedContent(buffer, file, version, sourceUrl, undefined, controller === null || controller === void 0 ? void 0 : controller.signal),
             destroyRenderSession,
             buildRenderCompleteState: input => buildRenderCompleteState({
                 version: input.version,
@@ -530,7 +570,7 @@ export const runFileViewerLocalFilePreview = async ({ source, version, currentFi
         };
     }
     catch (error) {
-        if (!isCurrent(version)) {
+        if (!isCurrent(version) || (controller === null || controller === void 0 ? void 0 : controller.signal.aborted)) {
             return {
                 status: 'stale',
                 source: localSource,
@@ -547,6 +587,7 @@ export const runFileViewerLocalFilePreview = async ({ source, version, currentFi
         };
     }
     finally {
+        requestController === null || requestController === void 0 ? void 0 : requestController.clearAbortController(controller);
         finalizeFileViewerPreviewLoadState({
             version,
             isCurrent,
@@ -555,52 +596,106 @@ export const runFileViewerLocalFilePreview = async ({ source, version, currentFi
         });
     }
 };
-export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, streaming, previewTarget, requestController, isCurrent, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, i18n, onMarkLoadStarted, onStartLoading, onSetLoadingMessage, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onMissingData, onError, }) => {
-    const remoteSource = resolveFileViewerRemoteSourcePlan({
+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, }) => {
+    let remoteSource = resolveFileViewerRemoteSourcePlan({
         pageHref,
         streaming,
         url,
     });
     const sourceUrl = remoteSource.url;
-    commitFileViewerLoadStartState({
-        version,
-        filename: remoteSource.filename,
-        filenameTarget: previewTarget,
-        buildState: () => buildLoadStartState({
-            version,
-            source: 'url',
-            sourceUrl,
-        }),
-        onMarkLoadStarted,
-        onLifecycle,
-        onStartLoading,
-    });
-    if (remoteSource.streamPdf) {
-        const stream = await runFileViewerStreamingPdfPreview({
-            url: sourceUrl,
+    const controller = requestController.createAbortController();
+    let streamFinalized = false;
+    try {
+        if (!remoteSource.streamPdf && shouldStreamRemoteUrl) {
+            const streamDecision = await shouldStreamRemoteUrl({
+                url: sourceUrl,
+                filename: remoteSource.filename,
+                extension: remoteSource.extension,
+                pageHref,
+                signal: controller === null || controller === void 0 ? void 0 : controller.signal,
+            });
+            if (streamDecision) {
+                remoteSource = {
+                    ...remoteSource,
+                    streamRenderer: true,
+                    streamType: typeof streamDecision === 'string' ? streamDecision : remoteSource.extension,
+                };
+            }
+        }
+        if (!isCurrent(version) || (controller === null || controller === void 0 ? void 0 : controller.signal.aborted)) {
+            return {
+                status: 'stale',
+                remoteSource,
+                download: null,
+                read: null,
+                stream: null,
+                error: null,
+            };
+        }
+        commitFileViewerLoadStartState({
             version,
             filename: remoteSource.filename,
-            previewTarget,
-            isCurrent,
-            mountRenderedContent,
-            destroyRenderSession,
-            buildRenderCompleteState: input => buildRenderCompleteState({
-                version: input.version,
+            filenameTarget: previewTarget,
+            buildState: () => buildLoadStartState({
+                version,
                 source: 'url',
                 sourceUrl,
             }),
-            i18n,
-            onStartLoading,
-            onSession,
-            onActiveDocumentContext,
+            onMarkLoadStarted,
             onLifecycle,
-            onClearLoadStarted,
-            onStopLoading,
-            onError: error => onError === null || onError === void 0 ? void 0 : onError(error, 'stream'),
+            onStartLoading,
         });
-        if (stream.status === 'ready') {
+        if (remoteSource.streamPdf || remoteSource.streamRenderer) {
+            const stream = await runFileViewerStreamingPdfPreview({
+                url: sourceUrl,
+                version,
+                filename: remoteSource.filename,
+                previewTarget,
+                isCurrent,
+                mountRenderedContent,
+                destroyRenderSession,
+                buildRenderCompleteState: (input) => buildRenderCompleteState({
+                    version: input.version,
+                    source: 'url',
+                    sourceUrl,
+                }),
+                i18n,
+                loadingMessage: remoteSource.streamPdf
+                    ? undefined
+                    : resolveFileViewerPreviewMessages(i18n).downloading,
+                signal: controller === null || controller === void 0 ? void 0 : controller.signal,
+                typeOverride: remoteSource.streamType,
+                onStartLoading,
+                onSession,
+                onActiveDocumentContext,
+                onLifecycle,
+                onClearLoadStarted,
+                onStopLoading,
+                onError: (error) => onError === null || onError === void 0 ? void 0 : onError(error, 'stream'),
+            });
+            streamFinalized = true;
+            if (stream.status === 'ready') {
+                return {
+                    status: 'stream',
+                    remoteSource,
+                    download: null,
+                    read: null,
+                    stream,
+                    error: null,
+                };
+            }
+            if (stream.status === 'error') {
+                return {
+                    status: 'error',
+                    remoteSource,
+                    download: null,
+                    read: null,
+                    stream,
+                    error: stream.error,
+                };
+            }
             return {
-                status: 'stream',
+                status: 'stale',
                 remoteSource,
                 download: null,
                 read: null,
@@ -608,27 +703,6 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
                 error: null,
             };
         }
-        if (stream.status === 'error') {
-            return {
-                status: 'error',
-                remoteSource,
-                download: null,
-                read: null,
-                stream,
-                error: stream.error,
-            };
-        }
-        return {
-            status: 'stale',
-            remoteSource,
-            download: null,
-            read: null,
-            stream,
-            error: null,
-        };
-    }
-    const controller = requestController.createAbortController();
-    try {
         const data = await downloadFile({
             url: sourceUrl,
             signal: controller === null || controller === void 0 ? void 0 : controller.signal,
@@ -671,7 +745,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
             isCurrent,
             mountRenderedContent,
             destroyRenderSession,
-            buildRenderCompleteState: input => buildRenderCompleteState({
+            buildRenderCompleteState: (input) => buildRenderCompleteState({
                 version: input.version,
                 source: 'url',
                 file: input.file,
@@ -724,15 +798,17 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
     }
     finally {
         requestController.clearAbortController(controller);
-        finalizeFileViewerPreviewLoadState({
-            version,
-            isCurrent,
-            onClearLoadStarted,
-            onStopLoading,
-        });
+        if (!streamFinalized) {
+            finalizeFileViewerPreviewLoadState({
+                version,
+                isCurrent,
+                onClearLoadStarted,
+                onStopLoading,
+            });
+        }
     }
 };
-export const createFileViewerSourceLoadingActionHandlers = ({ 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, }) => {
+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, }) => {
     const isCurrentRequest = (version) => requestController.isCurrent(version);
     const previewLocalFile = async (source, version) => {
         var _a;
@@ -740,6 +816,8 @@ export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, g
             source,
             version,
             currentFilename: (_a = getCurrentFilename === null || getCurrentFilename === void 0 ? void 0 : getCurrentFilename()) !== null && _a !== void 0 ? _a : previewTarget.filename,
+            shouldStreamLocalFile,
+            requestController,
             previewTarget,
             isCurrent: isCurrentRequest,
             mountRenderedContent,
@@ -778,6 +856,7 @@ export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, g
             version,
             pageHref: getPageHref === null || getPageHref === void 0 ? void 0 : getPageHref(),
             streaming: getPdfStreaming === null || getPdfStreaming === void 0 ? void 0 : getPdfStreaming(),
+            shouldStreamRemoteUrl,
             i18n: getI18n === null || getI18n === void 0 ? void 0 : getI18n(),
             previewTarget,
             requestController,
@@ -955,22 +1034,33 @@ 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, url, }) => {
+export const resolveFileViewerRemoteSourcePlan = ({ filename, 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 streamDecision = !streamPdf
+        ? shouldStreamRemoteUrl === null || shouldStreamRemoteUrl === void 0 ? void 0 : shouldStreamRemoteUrl({
+            url: sourceUrl,
+            filename: nextFilename,
+            extension,
+            pageHref,
+        })
+        : false;
     return {
         url: sourceUrl,
         filename: nextFilename,
         extension,
-        streamPdf: pageHref
-            ? shouldStreamPdfUrl({
-                extension,
-                pageHref,
-                streaming,
-                url: sourceUrl,
-            })
-            : false,
+        streamPdf,
+        streamRenderer: streamDecision === true || typeof streamDecision === 'string',
+        streamType: typeof streamDecision === 'string' ? streamDecision : undefined,
     };
 };
 export const commitFileViewerRemoteDownloadState = ({ version, data, currentFilename, fallbackFilename, isCurrent, i18n, onMissingData, onSetLoadingMessage, }) => {

package/dist/source/precheck.d.ts

@@ -1,14 +1,10 @@
-import type { FileViewerFileRef, FileViewerSource } from '../contracts/types';
+import type { FileViewerFileRef, FileViewerSource } from "../contracts/types.js";
 export type FileViewerPrecheckStatus = 'ready' | 'invalid' | 'unsupported';
 export type FileViewerPrecheckReason = 'content-valid' | 'content-not-inspected' | 'content-inconclusive' | 'empty-structured-file' | 'signature-mismatch' | 'invalid-package' | 'missing-package-part' | 'unsupported-extension';
 export interface FileViewerPrecheckOptions {
-    /** Filename used when a Blob or ArrayBuffer has no name. */
     filename?: string;
-    /** Explicit extension, with or without a leading dot. */
     type?: string;
-    /** Restricts the result to the renderers installed by the host application. */
     supportedExtensions?: Iterable<string>;
-    /** Maximum ZIP central-directory bytes read from a Blob. Defaults to 8 MiB. */
     maxPackageMetadataBytes?: number;
 }
 export interface FileViewerPrecheckResult {
@@ -17,7 +13,6 @@ export interface FileViewerPrecheckResult {
     rendererId: string | null;
     supported: boolean;
     inspected: boolean;
-    /** `null` means the extension is supported but no structural validator exists. */
     valid: boolean | null;
     previewable: boolean;
     status: FileViewerPrecheckStatus;
@@ -25,12 +20,5 @@ export interface FileViewerPrecheckResult {
     missingParts: string[];
 }
 type FileViewerPrecheckInput = FileViewerSource | FileViewerFileRef;
-/**
- * Performs a cheap, renderer-free capability and structure check.
- *
- * This intentionally does not promise rendering fidelity. A `ready` result
- * means the extension is available and any known container/signature checks
- * passed; the real renderer remains the final authority for malformed content.
- */
 export declare const precheckFileViewerSource: (input: FileViewerPrecheckInput, options?: FileViewerPrecheckOptions) => Promise<FileViewerPrecheckResult>;
 export {};

package/dist/source/precheck.js

@@ -1,5 +1,5 @@
-import { DEFAULT_RENDERER_DEFINITIONS, DEFAULT_SUPPORTED_EXTENSIONS } from '../registry/formats.js';
-import { getExtension, normalizeFileExtension, normalizeFilename, normalizeSource, } from './index.js';
+import { DEFAULT_RENDERER_DEFINITIONS, DEFAULT_SUPPORTED_EXTENSIONS } from "../registry/formats.js";
+import { getExtension, normalizeFileExtension, normalizeFilename, normalizeSource, } from "./index.js";
 const DEFAULT_MAX_PACKAGE_METADATA_BYTES = 8 * 1024 * 1024;
 const ZIP_LOCAL_SIGNATURE = 0x04034b50;
 const ZIP_CENTRAL_SIGNATURE = 0x02014b50;
@@ -203,13 +203,6 @@ const inspectStructuredContent = async (source, extension, maxPackageMetadataByt
     }
     return { inspected: false, valid: null, reason: 'content-not-inspected' };
 };
-/**
- * Performs a cheap, renderer-free capability and structure check.
- *
- * This intentionally does not promise rendering fidelity. A `ready` result
- * means the extension is available and any known container/signature checks
- * passed; the real renderer remains the final authority for malformed content.
- */
 export const precheckFileViewerSource = async (input, options = {}) => {
     var _a;
     const source = toSource(input, options);

package/dist/source/textEncoding.d.ts

@@ -1,5 +1,8 @@
-export type FileViewerTextEncoding = 'auto' | 'utf-8' | 'utf-16le' | 'utf-16be' | 'gbk' | 'gb18030';
+export type FileViewerSingleByteTextEncoding = 'iso-8859-1' | 'iso-8859-2' | 'iso-8859-15' | 'windows-1250' | 'windows-1251' | 'windows-1252';
+export type FileViewerTextEncoding = 'auto' | 'utf-8' | 'utf-16le' | 'utf-16be' | 'gbk' | 'gb18030' | FileViewerSingleByteTextEncoding;
 export type ResolvedFileViewerTextEncoding = Exclude<FileViewerTextEncoding, 'auto' | 'gbk'>;
+export declare const DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING: ResolvedFileViewerTextEncoding;
+export declare const isSingleByteFileViewerTextEncoding: (encoding: string | undefined) => encoding is FileViewerSingleByteTextEncoding;
 export interface DecodedFileViewerText {
     text: string;
     encoding: ResolvedFileViewerTextEncoding;
@@ -9,6 +12,6 @@ export interface ResolvedFileViewerTextSource {
     bomLength: number;
 }
 export declare const isValidFileViewerUtf8: (bytes: Uint8Array) => boolean;
-export declare const resolveFileViewerTextEncoding: (bytes: Uint8Array, encoding?: FileViewerTextEncoding | string) => ResolvedFileViewerTextSource;
+export declare const resolveFileViewerTextEncoding: (bytes: Uint8Array, encoding?: FileViewerTextEncoding | string, fallbackEncoding?: FileViewerTextEncoding | string) => ResolvedFileViewerTextSource;
 export declare const createFileViewerTextDecoder: (encoding: ResolvedFileViewerTextEncoding) => TextDecoder;
-export declare const decodeFileViewerTextBuffer: (data: ArrayBuffer, encoding?: FileViewerTextEncoding | string) => DecodedFileViewerText;
+export declare const decodeFileViewerTextBuffer: (data: ArrayBuffer, encoding?: FileViewerTextEncoding | string, fallbackEncoding?: FileViewerTextEncoding | string) => DecodedFileViewerText;

package/dist/source/textEncoding.js

@@ -1,5 +1,44 @@
+export const DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING = 'gb18030';
+const SINGLE_BYTE_ENCODING_ALIASES = new Map([
+    ['iso-8859-1', 'iso-8859-1'],
+    ['iso8859-1', 'iso-8859-1'],
+    ['iso88591', 'iso-8859-1'],
+    ['latin1', 'iso-8859-1'],
+    ['latin-1', 'iso-8859-1'],
+    ['l1', 'iso-8859-1'],
+    ['cp819', 'iso-8859-1'],
+    ['ibm819', 'iso-8859-1'],
+    ['iso-8859-2', 'iso-8859-2'],
+    ['iso8859-2', 'iso-8859-2'],
+    ['iso88592', 'iso-8859-2'],
+    ['latin2', 'iso-8859-2'],
+    ['latin-2', 'iso-8859-2'],
+    ['l2', 'iso-8859-2'],
+    ['iso-8859-15', 'iso-8859-15'],
+    ['iso8859-15', 'iso-8859-15'],
+    ['iso885915', 'iso-8859-15'],
+    ['latin9', 'iso-8859-15'],
+    ['latin-9', 'iso-8859-15'],
+    ['l9', 'iso-8859-15'],
+    ['windows-1250', 'windows-1250'],
+    ['windows1250', 'windows-1250'],
+    ['cp1250', 'windows-1250'],
+    ['x-cp1250', 'windows-1250'],
+    ['windows-1251', 'windows-1251'],
+    ['windows1251', 'windows-1251'],
+    ['cp1251', 'windows-1251'],
+    ['x-cp1251', 'windows-1251'],
+    ['windows-1252', 'windows-1252'],
+    ['windows1252', 'windows-1252'],
+    ['cp1252', 'windows-1252'],
+    ['x-cp1252', 'windows-1252']
+]);
+const SINGLE_BYTE_ENCODINGS = new Set(SINGLE_BYTE_ENCODING_ALIASES.values());
+export const isSingleByteFileViewerTextEncoding = (encoding) => {
+    return encoding !== undefined && SINGLE_BYTE_ENCODINGS.has(encoding);
+};
 const normalizeEncoding = (encoding) => {
-    const normalized = String(encoding || 'auto').trim().toLowerCase().replace('_', '-');
+    const normalized = String(encoding || 'auto').trim().toLowerCase().replace(/_/g, '-');
     if (normalized === 'utf8' || normalized === 'utf-8') {
         return 'utf-8';
     }
@@ -15,13 +54,24 @@ const normalizeEncoding = (encoding) => {
     if (normalized === 'gb18030') {
         return 'gb18030';
     }
+    const singleByte = SINGLE_BYTE_ENCODING_ALIASES.get(normalized);
+    if (singleByte) {
+        return singleByte;
+    }
     return 'auto';
 };
+const toResolvedEncoding = (encoding) => {
+    return encoding === 'gbk' ? 'gb18030' : encoding;
+};
+const normalizeFallbackEncoding = (fallbackEncoding) => {
+    const normalized = normalizeEncoding(fallbackEncoding);
+    return normalized === 'auto'
+        ? DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING
+        : toResolvedEncoding(normalized);
+};
 const isContinuationByte = (value) => {
     return value !== undefined && value >= 0x80 && value <= 0xbf;
 };
-// Validate bytes directly because older WebViews can accept the fatal option
-// while still replacing malformed input. That would hide the GB18030 fallback.
 export const isValidFileViewerUtf8 = (bytes) => {
     for (let index = 0; index < bytes.length;) {
         const first = bytes[index];
@@ -102,11 +152,11 @@ const inferBomlessUtf16 = (bytes) => {
     }
     return null;
 };
-export const resolveFileViewerTextEncoding = (bytes, encoding = 'auto') => {
+export const resolveFileViewerTextEncoding = (bytes, encoding = 'auto', fallbackEncoding = DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING) => {
     const normalized = normalizeEncoding(encoding);
     if (normalized !== 'auto') {
         return {
-            encoding: normalized === 'gbk' ? 'gb18030' : normalized,
+            encoding: toResolvedEncoding(normalized),
             bomLength: normalized === 'utf-8' && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf
                 ? 3
                 : (normalized === 'utf-16le' && bytes[0] === 0xff && bytes[1] === 0xfe) ||
@@ -130,7 +180,7 @@ export const resolveFileViewerTextEncoding = (bytes, encoding = 'auto') => {
     }
     return isValidFileViewerUtf8(bytes)
         ? { encoding: 'utf-8', bomLength: 0 }
-        : { encoding: 'gb18030', bomLength: 0 };
+        : { encoding: normalizeFallbackEncoding(fallbackEncoding), bomLength: 0 };
 };
 export const createFileViewerTextDecoder = (encoding) => {
     if (typeof TextDecoder === 'undefined') {
@@ -146,9 +196,9 @@ export const createFileViewerTextDecoder = (encoding) => {
         throw error;
     }
 };
-export const decodeFileViewerTextBuffer = (data, encoding = 'auto') => {
+export const decodeFileViewerTextBuffer = (data, encoding = 'auto', fallbackEncoding = DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING) => {
     const bytes = new Uint8Array(data);
-    const resolved = resolveFileViewerTextEncoding(bytes, encoding);
+    const resolved = resolveFileViewerTextEncoding(bytes, encoding, fallbackEncoding);
     return {
         text: createFileViewerTextDecoder(resolved.encoding).decode(bytes.subarray(resolved.bomLength)),
         encoding: resolved.encoding

package/dist/viewer/createViewer.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerEventHandler, FileViewerInstance, FileViewerOptions, FileViewerRenderPurpose, RendererRegistry } from '../contracts/types';
+import type { FileViewerEventHandler, FileViewerInstance, FileViewerOptions, FileViewerRenderPurpose, RendererRegistry } from "../contracts/types.js";
 export interface CreateViewerOptions {
     registry?: RendererRegistry;
     options?: FileViewerOptions;