@file-viewer/core 2.2.9 → 2.3.0

package/dist/renderers/index.d.ts

@@ -13,6 +13,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "office";
     readonly extensions: readonly ["docx", "docm", "dotx", "dotm"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-word";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["OOXML Transitional", "OOXML Strict"];
+    readonly knownLimits: readonly ["VBA is never executed"];
     readonly capabilities: {
         readonly download: true;
         readonly print: "adapter";
@@ -26,6 +32,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "office";
     readonly extensions: readonly ["doc", "dot"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-word";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["Word 97-2003 Binary"];
+    readonly knownLimits: readonly ["Macros are never executed"];
     readonly capabilities: {
         readonly download: true;
         readonly print: "adapter";
@@ -37,8 +49,14 @@ export declare const coreLiteRendererDefinitions: ({
     readonly id: "office-presentation-binary";
     readonly label: "PowerPoint 97–2003";
     readonly category: "office";
-    readonly extensions: readonly ["ppt"];
+    readonly extensions: readonly ["ppt", "pot"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-presentation";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["PowerPoint 97-2003 Binary"];
+    readonly knownLimits: readonly ["Embedded engine watermark is retained", "Macros are never executed"];
     readonly capabilities: {
         readonly download: true;
         readonly print: "adapter";
@@ -52,6 +70,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "office";
     readonly extensions: readonly ["pptx", "pptm", "potx", "potm", "ppsx", "ppsm"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-presentation";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["OOXML Transitional", "OOXML Strict"];
+    readonly knownLimits: readonly ["Macros and external programs are never executed"];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -65,6 +89,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "office";
     readonly extensions: readonly ["rtf", "odt", "odp"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-word";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["RTF", "OpenDocument"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -76,8 +106,109 @@ export declare const coreLiteRendererDefinitions: ({
     readonly id: "spreadsheet-openxml";
     readonly label: "Spreadsheet";
     readonly category: "office";
-    readonly extensions: readonly ["xlsx", "xltx", "xlsm", "xlsb", "xls", "xlt", "xltm", "csv", "tsv", "ods", "fods", "numbers"];
+    readonly extensions: readonly ["xlsx", "xltx", "xlsm", "xlsb", "xls", "xlt", "xla", "xlam", "xltm", "csv", "tsv", "ods", "fods"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-spreadsheet";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["OOXML", "BIFF", "OpenDocument", "Delimited text"];
+    readonly knownLimits: readonly ["VBA and add-in code are never executed", "Formula results are read from the saved workbook cache"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: false;
+        readonly exportHtml: false;
+        readonly zoom: "provider";
+        readonly search: true;
+    };
+} | {
+    readonly id: "apple-pages";
+    readonly label: "Apple Pages";
+    readonly category: "office";
+    readonly extensions: readonly ["pages"];
+    readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-iwork";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["iWork '09 index.xml(.gz)", "iWork 2013+ IWA"];
+    readonly knownLimits: readonly ["Static preview only", "Encrypted iwpv2 files are detected but not decrypted"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: "adapter";
+        readonly exportHtml: "adapter";
+        readonly zoom: "provider";
+        readonly search: true;
+    };
+} | {
+    readonly id: "apple-numbers";
+    readonly label: "Apple Numbers";
+    readonly category: "office";
+    readonly extensions: readonly ["numbers"];
+    readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-iwork";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["iWork '09 index.xml", "iWork 2013+ IWA"];
+    readonly knownLimits: readonly ["Formula results are read from the saved document cache", "Encrypted iwpv2 files are detected but not decrypted"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: "adapter";
+        readonly exportHtml: "adapter";
+        readonly zoom: "provider";
+        readonly search: true;
+    };
+} | {
+    readonly id: "apple-keynote";
+    readonly label: "Apple Keynote";
+    readonly category: "office";
+    readonly extensions: readonly ["key"];
+    readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-iwork";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["iWork '09 index.apxl", "iWork 2013+ IWA"];
+    readonly knownLimits: readonly ["Animations, transitions and video playback are not executed", "Encrypted iwpv2 files are detected but not decrypted"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: "adapter";
+        readonly exportHtml: "adapter";
+        readonly zoom: "provider";
+        readonly search: true;
+    };
+} | {
+    readonly id: "office-wordperfect";
+    readonly label: "WordPerfect";
+    readonly category: "office";
+    readonly extensions: readonly ["wpd", "wp", "wp5", "wp6"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-wordperfect";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["WordPerfect 4.2", "WordPerfect 5.x", "WordPerfect 6+"];
+    readonly knownLimits: readonly ["Macros are never executed", ".wp5 and .wp6 are routing aliases for genuine WP5/WP6 payloads, not separate container formats", "Pagination and unsupported embedded objects are presented as structured static preview"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: "adapter";
+        readonly exportHtml: "adapter";
+        readonly zoom: "provider";
+        readonly search: true;
+    };
+} | {
+    readonly id: "spreadsheet-dbf";
+    readonly label: "dBASE Table";
+    readonly category: "office";
+    readonly extensions: readonly ["dbf"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-spreadsheet";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["dBASE III/IV", "Visual FoxPro"];
+    readonly knownLimits: readonly ["Missing DBT/FPT memo sidecars are reported as incomplete"];
     readonly capabilities: {
         readonly download: true;
         readonly print: false;
@@ -91,6 +222,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "document";
     readonly extensions: readonly ["pdf"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-pdf";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["PDF"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: "adapter";
@@ -104,6 +241,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "document";
     readonly extensions: readonly ["ofd"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-ofd";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["OFD"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -111,12 +254,37 @@ export declare const coreLiteRendererDefinitions: ({
         readonly zoom: "provider";
         readonly search: true;
     };
+} | {
+    readonly id: "office-hangul";
+    readonly label: "Hancom Hangul";
+    readonly category: "office";
+    readonly extensions: readonly ["hwp", "hwpx"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-hangul";
+    readonly presets: readonly ["office", "all"];
+    readonly containerVersions: readonly ["HWP v5 CFB", "HWPX ZIP/XML"];
+    readonly knownLimits: readonly ["Encrypted, DRM-protected and distribution documents are detected but not decrypted", "Charts, OLE objects and advanced drawing effects remain limited in the static structured preview", "HWP v5 pagination is approximated when the binary producer omits usable page geometry"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: "adapter";
+        readonly exportHtml: "adapter";
+        readonly zoom: "provider";
+        readonly search: true;
+    };
 } | {
     readonly id: "typst";
     readonly label: "Typst";
     readonly category: "document";
     readonly extensions: readonly ["typ", "typst"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-typst";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["Typst source"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: "adapter";
@@ -130,6 +298,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "archive";
     readonly extensions: readonly ["zip", "zipx", "7z", "rar", "tar", "gz", "gzip", "tgz", "bz2", "bzip2", "tbz", "tbz2", "xz", "txz", "lzma", "zst", "tzst", "cab", "ar", "cpio", "iso", "xar", "lha", "lzh", "jar", "war", "ear", "apk", "cbz", "cbr"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-archive";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["libarchive-supported containers"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: false;
@@ -143,6 +317,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "email";
     readonly extensions: readonly ["eml", "msg", "mbox"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-email";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["MIME", "Outlook MSG", "mbox"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: false;
@@ -156,6 +336,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "eda";
     readonly extensions: readonly ["olb", "dra", "gds", "oas", "oasis"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-eda";
+    readonly presets: readonly ["engineering", "all"];
+    readonly containerVersions: readonly ["OrCAD", "GDSII", "OASIS"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -169,6 +355,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "cad";
     readonly extensions: readonly ["dxf", "dwg", "dwf", "dwfx", "xps"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-cad";
+    readonly presets: readonly ["engineering", "all"];
+    readonly containerVersions: readonly ["DWG", "DXF", "DWF", "DWFX/XPS"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -182,6 +374,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "model";
     readonly extensions: readonly ["glb", "gltf", "obj", "stl", "ply", "fbx", "dae", "3ds", "3mf", "amf", "usd", "usda", "usdc", "usdz", "kmz", "step", "stp", "iges", "igs", "ifc", "3dm", "brep", "pcd", "wrl", "vrml", "xyz", "vtk", "vtp"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-3d";
+    readonly presets: readonly ["engineering", "all"];
+    readonly containerVersions: readonly ["Mesh", "CAD exchange", "scene"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: false;
@@ -195,6 +393,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "geo";
     readonly extensions: readonly ["geojson", "kml", "gpx", "shp"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-geo";
+    readonly presets: readonly ["engineering", "all"];
+    readonly containerVersions: readonly ["GeoJSON", "KML", "GPX", "Shapefile"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -208,6 +412,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "drawing";
     readonly extensions: readonly ["excalidraw", "drawio", "dio", "mermaid", "mmd", "plantuml", "puml"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-drawing";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["Draw.io", "Excalidraw", "Mermaid", "PlantUML"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -221,6 +431,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "mindmap";
     readonly extensions: readonly ["xmind"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-mindmap";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["XMind"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -234,6 +450,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "ebook";
     readonly extensions: readonly ["epub"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-epub";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["EPUB 2", "EPUB 3"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: false;
@@ -241,12 +463,37 @@ export declare const coreLiteRendererDefinitions: ({
         readonly zoom: false;
         readonly search: "provider";
     };
+} | {
+    readonly id: "ebook-fb2";
+    readonly label: "FictionBook";
+    readonly category: "ebook";
+    readonly extensions: readonly ["fb2"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-epub";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["FictionBook 2 XML"];
+    readonly knownLimits: readonly ["External network resources are not loaded"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: true;
+        readonly exportHtml: true;
+        readonly zoom: false;
+        readonly search: true;
+    };
 } | {
     readonly id: "umd";
     readonly label: "UMD";
     readonly category: "ebook";
     readonly extensions: readonly ["umd"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-epub";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["UMD"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -260,6 +507,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "image";
     readonly extensions: readonly ["gif", "jpg", "jpeg", "bmp", "tiff", "tif", "png", "svg", "webp", "avif", "ico", "heic", "heif", "jxl"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-image";
+    readonly presets: readonly ["lite", "all"];
+    readonly containerVersions: readonly ["Raster", "SVG"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -273,6 +526,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "markdown";
     readonly extensions: readonly ["md", "markdown"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-text";
+    readonly presets: readonly ["lite", "all"];
+    readonly containerVersions: readonly ["CommonMark/GFM"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -286,6 +545,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "code";
     readonly extensions: readonly ["txt", "json", "js", "mjs", "cjs", "css", "java", "py", "html", "htm", "jsx", "ts", "tsx", "xml", "log", "vue", "yaml", "yml", "ini", "sh", "bash", "sql", "go", "rs", "php", "c", "cpp", "cc", "h", "hpp", "cs", "diff", "patch", "bundle", "bdl", "jsonc", "json5", "ipynb", "toml", "proto", "hcl", "tex", "gv", "http", "react", "rb", "swift", "kt"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-text";
+    readonly presets: readonly ["lite", "all"];
+    readonly containerVersions: readonly ["Plain text", "source code", "Git bundle"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: true;
@@ -299,6 +564,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "media";
     readonly extensions: readonly ["mp4", "webm", "m3u8"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-media";
+    readonly presets: readonly ["lite", "all"];
+    readonly containerVersions: readonly ["Browser media"];
+    readonly knownLimits: readonly ["Codec support follows the browser"];
     readonly capabilities: {
         readonly download: true;
         readonly print: false;
@@ -312,6 +583,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "media";
     readonly extensions: readonly ["mp3", "mpeg", "wav", "ogg", "oga", "opus", "m4a", "aac", "flac", "weba", "midi", "mid"];
     readonly async: true;
+    readonly supportLevel: "high-fidelity";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-media";
+    readonly presets: readonly ["lite", "all"];
+    readonly containerVersions: readonly ["Browser media", "MIDI"];
+    readonly knownLimits: readonly ["Codec support follows the browser"];
     readonly capabilities: {
         readonly download: true;
         readonly print: false;
@@ -325,6 +602,12 @@ export declare const coreLiteRendererDefinitions: ({
     readonly category: "asset";
     readonly extensions: readonly ["ttf", "otf", "woff", "woff2", "psd", "ai", "eps", "sqlite", "wasm", "parquet", "avro", "webarchive"];
     readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-data";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["Font", "design", "database", "binary data"];
+    readonly knownLimits: readonly [];
     readonly capabilities: {
         readonly download: true;
         readonly print: false;

package/dist/rendering/dispatcher.d.ts

@@ -3,6 +3,15 @@ export interface FileViewerRendererHandlerEntry<Handler> {
     rendererId: string;
     handler: Handler;
 }
+/**
+ * Content-signature aware renderers can throw this shape when the filename
+ * extension points at the wrong container. The orchestration layer follows the
+ * redirect once, using the handler registered for the detected renderer id.
+ */
+export interface FileViewerRendererRedirectError extends Error {
+    actualRendererId: string;
+}
+export declare const resolveFileViewerRendererRedirectId: (error: unknown) => string | undefined;
 export interface CreateFileViewerRendererDispatcherOptions<Handler> {
     registry?: RendererRegistry;
     handlers: Iterable<FileViewerRendererHandlerEntry<Handler>>;

package/dist/rendering/dispatcher.js

@@ -1,6 +1,13 @@
 import { DEFAULT_RENDERER_DEFINITIONS } from '../registry/formats.js';
 import { createRendererRegistry } from '../registry/registry.js';
 import { normalizeFileExtension } from '../source/index.js';
+export const resolveFileViewerRendererRedirectId = (error) => {
+    if (!error || typeof error !== 'object' || !('actualRendererId' in error)) {
+        return undefined;
+    }
+    const rendererId = String(error.actualRendererId || '').trim();
+    return rendererId || undefined;
+};
 export const createFileViewerRendererDispatcher = ({ registry = createRendererRegistry(DEFAULT_RENDERER_DEFINITIONS), handlers, fallbackHandler, fallbackKey = 'error', }) => {
     const handlersByRendererId = Array.from(handlers).reduce((result, entry) => {
         result.set(entry.rendererId, entry.handler);

package/dist/rendering/handler.d.ts

@@ -11,7 +11,7 @@ export interface ReportFileViewerRenderSessionDisposeErrorInput extends ResolveF
     onLogError?: FileViewerRenderSessionDisposeErrorLogger | null;
 }
 export interface RenderFileViewerHandlerInput<Rendered = unknown, Target extends HTMLElement = HTMLElement> {
-    dispatcher: Pick<FileViewerRendererDispatcher<FileRenderHandler<Rendered, Target>>, 'resolve'>;
+    dispatcher: Pick<FileViewerRendererDispatcher<FileRenderHandler<Rendered, Target>>, 'resolve' | 'handlersByRendererId'>;
     buffer: ArrayBuffer;
     target: Target;
     type?: string;

package/dist/rendering/handler.js

@@ -6,6 +6,7 @@
 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';
@@ -489,6 +490,7 @@ export const buildFileRenderContextFromLoadContext = ({ source, surface, options
     ...renderContext,
 });
 export const renderFileViewerHandler = async ({ dispatcher, buffer, target, type = '', context, throwOnMissingHandler = false, }) => {
+    var _a, _b, _c;
     const normalizedType = normalizeFileExtension(type);
     const handler = dispatcher.resolve(normalizedType);
     if (!handler) {
@@ -497,7 +499,31 @@ export const renderFileViewerHandler = async ({ dispatcher, buffer, target, type
         }
         return undefined;
     }
-    return handler(buffer, target, normalizedType, context);
+    try {
+        return await handler(buffer, target, normalizedType, context);
+    }
+    catch (error) {
+        const redirectedRendererId = resolveFileViewerRendererRedirectId(error);
+        const redirectedHandler = redirectedRendererId
+            ? dispatcher.handlersByRendererId.get(redirectedRendererId)
+            : undefined;
+        if (!redirectedHandler || redirectedHandler === handler) {
+            throw error;
+        }
+        const redirectedType = ((_a = DEFAULT_RENDERER_DEFINITIONS
+            .find(definition => definition.id === redirectedRendererId)) === null || _a === void 0 ? void 0 : _a.extensions[0]) || normalizedType;
+        (_c = (_b = context === null || context === void 0 ? void 0 : context.options) === null || _b === void 0 ? void 0 : _b.onDiagnostic) === null || _c === void 0 ? void 0 : _c.call(_b, {
+            code: 'renderer-content-signature-redirect',
+            level: 'warning',
+            message: `File extension .${normalizedType} contains the ${redirectedRendererId} container and was routed as .${redirectedType}.`,
+            detail: {
+                declaredExtension: normalizedType,
+                detectedRendererId: redirectedRendererId,
+                routedExtension: redirectedType,
+            },
+        });
+        return await redirectedHandler(buffer, target, redirectedType, context);
+    }
 };
 export const createFileRenderHandlerLoader = ({ handler, rendererId, getTarget = context => context.surface.container, createContext = buildFileRenderContextFromLoadContext, destroy, }) => {
     return async (context) => {
@@ -552,7 +578,14 @@ export const createFileRenderHandlerRegistry = ({ definitions = DEFAULT_RENDERER
         return {
             ...definition,
             load: createFileRenderHandlerLoader({
-                handler,
+                handler: (buffer, target, type, context) => renderFileViewerHandler({
+                    dispatcher,
+                    buffer,
+                    target,
+                    type,
+                    context,
+                    throwOnMissingHandler: true,
+                }),
                 rendererId: definition.id,
                 getTarget,
                 createContext,

package/dist/source/index.d.ts

@@ -1,4 +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';
 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,3 +1,4 @@
+export { createFileViewerTextDecoder, decodeFileViewerTextBuffer, 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/textEncoding.d.ts

@@ -0,0 +1,14 @@
+export type FileViewerTextEncoding = 'auto' | 'utf-8' | 'utf-16le' | 'utf-16be' | 'gbk' | 'gb18030';
+export type ResolvedFileViewerTextEncoding = Exclude<FileViewerTextEncoding, 'auto' | 'gbk'>;
+export interface DecodedFileViewerText {
+    text: string;
+    encoding: ResolvedFileViewerTextEncoding;
+}
+export interface ResolvedFileViewerTextSource {
+    encoding: ResolvedFileViewerTextEncoding;
+    bomLength: number;
+}
+export declare const isValidFileViewerUtf8: (bytes: Uint8Array) => boolean;
+export declare const resolveFileViewerTextEncoding: (bytes: Uint8Array, encoding?: FileViewerTextEncoding | string) => ResolvedFileViewerTextSource;
+export declare const createFileViewerTextDecoder: (encoding: ResolvedFileViewerTextEncoding) => TextDecoder;
+export declare const decodeFileViewerTextBuffer: (data: ArrayBuffer, encoding?: FileViewerTextEncoding | string) => DecodedFileViewerText;