@file-viewer/core 3.3.1 → 3.3.3

package/dist/registry/registry.js

@@ -1,5 +1,5 @@
-import { DEFAULT_RENDERER_DEFINITIONS } from './formats.js';
-import { getExtension, normalizeFileExtension, normalizeFilename } from '../source/index.js';
+import { DEFAULT_RENDERER_DEFINITIONS } from "./formats.js";
+import { getExtension, normalizeFileExtension, normalizeFilename } from "../source/index.js";
 const autoRendererBucketKey = '__flyfish_file_viewer_auto_renderer_presets__';
 const getAutoRendererBucket = () => {
     const host = globalThis;
@@ -217,7 +217,6 @@ const createRendererDefinitionInstallPlan = (registry, definitions) => {
         ...regularDefinitions,
         ...enhancerDefinitions,
     ];
-    // Validate the complete ownership transition before mutating the caller's registry.
     const validationRegistry = createRendererRegistry(registry.list());
     plannedDefinitions.forEach(definition => validationRegistry.register(definition));
     return { definitions: plannedDefinitions };
@@ -328,13 +327,6 @@ export const hasFileViewerRendererPresetName = (input) => {
     }
     return false;
 };
-/**
- * Normalizes `options.preset` / `options.presets` into renderer plugin inputs.
- *
- * Passing a preset object is the most portable integration style because it
- * works in any bundler. String selectors intentionally only resolve presets
- * that are already registered by a side-effect import or by build tooling.
- */
 export const resolveFileViewerRendererPresetInputs = (input) => {
     if (!input) {
         return [];

package/dist/renderers/image.d.ts

@@ -1,2 +1,2 @@
-import type { FileRenderContext, FileViewerRenderedInstance } from '../contracts/types.js';
+import type { FileRenderContext, FileViewerRenderedInstance } from "../contracts/types.js";
 export default function renderImage(buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext): Promise<FileViewerRenderedInstance>;

package/dist/renderers/image.js

@@ -1,8 +1,8 @@
-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';
+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";
 const imageMimeMap = {
     avif: 'image/avif',
     bmp: 'image/bmp',
@@ -201,8 +201,6 @@ export default async function renderImage(buffer, target, type, context) {
         applyImageZoom();
         zoomEmitter.emit();
     };
-    // Zoom subscribers may resize the parent toolbar. Keep geometry writes out
-    // of ResizeObserver delivery so ancestor notifications remain deliverable.
     const scheduleViewportUpdate = () => {
         if (destroyed || viewportResizeFrame !== null)
             return;

package/dist/renderers/index.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerBuiltinRendererPreset, FileRenderHandler, FileViewerRenderedInstance } from '../contracts/types.js';
+import type { FileViewerBuiltinRendererPreset, FileRenderHandler, FileViewerRenderedInstance } from "../contracts/types.js";
 type CoreBrowserRendererHandler = FileRenderHandler<FileViewerRenderedInstance, HTMLDivElement>;
 interface CoreBrowserRendererHandlerEntry {
     rendererId: string;
@@ -56,7 +56,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly packageName: "@file-viewer/renderer-ppt";
     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 knownLimits: readonly ["Host fonts and complex effects can differ from PowerPoint", "Macros are never executed"];
     readonly capabilities: {
         readonly download: true;
         readonly print: "adapter";
@@ -724,7 +724,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly status: "experimental";
     readonly packageName: "@file-viewer/renderer-design";
     readonly presets: readonly [];
-    readonly containerVersions: readonly ["IDML package", "@paged-media/introspect-wasm 0.70.2"];
+    readonly containerVersions: readonly ["IDML package", "@paged-media/introspect-wasm 0.73.4"];
     readonly knownLimits: readonly ["Pages are rendered locally by the CPU WASM engine in a module Worker; the browser never uploads the IDML package", "ZIP64, encrypted, multi-disk, overlapping, unsafe-path, unsupported-compression, and configured expansion-limit packages are rejected before the WASM engine opens them", "The current engine page tree lists TextFrame and Rectangle objects only even though other supported objects may still appear in rendered page pixels", "Each page render rebuilds the upstream document internally; interactive requests are latest-wins, preview is lazy, and print-all is bounded by the configured total RGBA working-set limit"];
     readonly capabilities: {
         readonly download: true;

package/dist/renderers/index.js

@@ -1,23 +1,17 @@
-// Browser renderer strategy registry.
-//
-// Each entry lazy-loads a concrete renderer only after its format is selected.
-// Keep renderer-specific dependencies inside the leaf renderer files so the
-// core shell and framework wrappers stay fast on first load.
-import { DEFAULT_RENDERER_DEFINITIONS } from '../registry/formats.js';
-import { createFileRenderHandlerRegistry } from '../rendering/handler.js';
-import { createFileViewerRendererDispatcher } from '../rendering/dispatcher.js';
-import { createFileViewerUnsupportedState } from '../viewer/state.js';
+import { DEFAULT_RENDERER_DEFINITIONS } from "../registry/formats.js";
+import { createFileRenderHandlerRegistry } from "../rendering/handler.js";
+import { createFileViewerRendererDispatcher } from "../rendering/dispatcher.js";
+import { createFileViewerUnsupportedState } from "../viewer/state.js";
 const createWrapper = (el) => ({
     $el: el,
     unmount() {
-        // DOM renderers clean themselves up through their own returned instance.
     },
 });
 export const coreBrowserRendererHandlers = [
     {
         rendererId: 'image',
         handler: async (buffer, target, type, context) => {
-            const { default: renderImage } = await import('./image.js');
+            const { default: renderImage } = await import("./image.js");
             return renderImage(buffer, target, type, context);
         },
     },

package/dist/rendering/dispatcher.d.ts

@@ -1,13 +1,8 @@
-import type { RendererRegistry } from '../contracts/types.js';
+import type { RendererRegistry } from "../contracts/types.js";
 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;
 }

package/dist/rendering/dispatcher.js

@@ -1,6 +1,6 @@
-import { DEFAULT_RENDERER_DEFINITIONS } from '../registry/formats.js';
-import { createRendererRegistry } from '../registry/registry.js';
-import { normalizeFileExtension } from '../source/index.js';
+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;

package/dist/rendering/handler.d.ts

@@ -1,6 +1,6 @@
-import type { FileViewerRendererDispatcher } from './dispatcher.js';
-import { type FileViewerMutableAccessor, type MutableFileViewerRenderReadinessState } from '../source/loading.js';
-import type { FileRenderExportAdapter, FileRenderThumbnailAdapter, FileRenderContext, FileRenderHandler, FileViewerLifecycleContext, FileViewerOptions, FileViewerStyleIsolation, RenderSurface, RendererDefinition, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession } from '../contracts/types.js';
+import type { FileViewerRendererDispatcher } from "./dispatcher.js";
+import { type FileViewerMutableAccessor, type MutableFileViewerRenderReadinessState } from "../source/loading.js";
+import type { FileRenderExportAdapter, FileRenderThumbnailAdapter, FileRenderContext, FileRenderHandler, FileViewerLifecycleContext, FileViewerOptions, FileViewerStyleIsolation, RenderSurface, RendererDefinition, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession } from "../contracts/types.js";
 export declare const FILE_VIEWER_RENDER_SESSION_DISPOSE_ERROR_MESSAGE = "\u9884\u89C8\u5185\u5BB9\u5378\u8F7D\u5931\u8D25";
 export interface ResolveFileViewerRenderSessionDisposeErrorMessageInput {
     message?: string;
@@ -21,7 +21,6 @@ export interface RenderFileViewerHandlerInput<Rendered = unknown, Target extends
 export interface CreateFileRenderHandlerLoaderOptions<Rendered = unknown, Target extends HTMLElement = HTMLElement> {
     handler: FileRenderHandler<Rendered, Target>;
     rendererId?: string;
-    /** Allows stream-preferred handlers to receive an empty buffer plus context.streamUrl. */
     allowUrlSource?: boolean;
     getTarget?: (context: RendererLoadContext) => Target;
     createContext?: (context: RendererLoadContext) => FileRenderContext;
@@ -61,10 +60,6 @@ export interface FileViewerStyleHandle {
     remove(): void;
 }
 export interface AppendFileViewerStyleOptions {
-    /**
-     * Constructable stylesheets are useful for long-lived ShadowRoots. Keep this
-     * opt-in so renderer styles still clean up naturally with their target node.
-     */
     adoptedStyleSheet?: boolean;
 }
 export interface ResetFileViewerRenderSurfaceInput<Session extends RendererSession = RendererSession> {
@@ -169,11 +164,6 @@ export interface CreateFileViewerRenderSurfaceActionHandlersInput<Session extend
 export declare const DEFAULT_FILE_VIEWER_RENDER_TARGET_CLASS = "file-render";
 export declare const FILE_VIEWER_RENDER_SURFACE_BACKGROUND_PROPERTY = "--file-viewer-render-surface-background";
 export declare const normalizeFileViewerRenderSurfaceBackground: (value: unknown) => string | 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 declare const syncFileViewerRenderSurfaceBackground: (target: HTMLElement | null | undefined, options?: Pick<FileViewerOptions, "ui"> | null) => string | null;
 export declare const isFileViewerShadowRoot: (value: unknown) => value is ShadowRoot;
 export declare const getFileViewerShadowRootForNode: (node: Node | null | undefined) => ShadowRoot | null;

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];

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,17 +155,10 @@ 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);
-    // HTML math labels are created by Mermaid before its SVG is returned. Reject
-    // loading elements even when their URL uses entities or a relative path.
     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);

package/dist/source/index.d.ts

@@ -1,6 +1,6 @@
-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';
+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 { DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING, createFileViewerTextDecoder, decodeFileViewerTextBuffer, isSingleByteFileViewerTextEncoding, 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.js';
-import { type FileViewerLifecycleStateController } from '../lifecycle/operations.js';
-import { type FileViewerErrorMessageFormatter } from '../viewer/state.js';
-import type { FileViewerI18nInput } from '../i18n/messages.js';
+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";

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, normalizeFileExtension, 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, 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 = '文件下载失败';
@@ -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, ':')
@@ -607,8 +606,6 @@ export const runFileViewerRemoteFilePreview = async ({ url, filename, type, vers
     });
     const sourceUrl = remoteSource.url;
     const controller = requestController.createAbortController();
-    // The streaming helper finalizes its own load state; probe/download paths
-    // are finalized here, including cancellation before a renderer is mounted.
     let streamFinalized = false;
     try {
         if (!remoteSource.streamPdf && shouldStreamRemoteUrl) {

package/dist/source/precheck.d.ts

@@ -1,14 +1,10 @@
-import type { FileViewerFileRef, FileViewerSource } from '../contracts/types.js';
+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,15 +1,6 @@
-/**
- * Single-byte legacy encodings supported by the browser TextDecoder API.
- * Each byte decodes to one UTF-16 code unit, so the virtual
- * large-text renderer can slice them at any byte offset.
- */
 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'>;
-/**
- * Encoding used by `auto` when the bytes carry no BOM, do not look like
- * UTF-16, and are not valid UTF-8. GB18030 keeps the historical behavior.
- */
 export declare const DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING: ResolvedFileViewerTextEncoding;
 export declare const isSingleByteFileViewerTextEncoding: (encoding: string | undefined) => encoding is FileViewerSingleByteTextEncoding;
 export interface DecodedFileViewerText {
@@ -21,15 +12,6 @@ export interface ResolvedFileViewerTextSource {
     bomLength: number;
 }
 export declare const isValidFileViewerUtf8: (bytes: Uint8Array) => boolean;
-/**
- * Picks the decoder for a text buffer.
- *
- * `encoding` other than `auto` is used as-is. In `auto` mode the order is:
- * BOM, UTF-16 byte structure, strict UTF-8, then `fallbackEncoding`. The
- * fallback defaults to GB18030; pass `windows-1252`, `windows-1251`, or
- * another supported label for Latin, Cyrillic, or Central European legacy
- * files, which are otherwise misread as CJK text.
- */
 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, fallbackEncoding?: FileViewerTextEncoding | string) => DecodedFileViewerText;

package/dist/source/textEncoding.js

@@ -1,7 +1,3 @@
-/**
- * Encoding used by `auto` when the bytes carry no BOM, do not look like
- * UTF-16, and are not valid UTF-8. GB18030 keeps the historical behavior.
- */
 export const DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING = 'gb18030';
 const SINGLE_BYTE_ENCODING_ALIASES = new Map([
     ['iso-8859-1', 'iso-8859-1'],
@@ -76,8 +72,6 @@ const normalizeFallbackEncoding = (fallbackEncoding) => {
 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];
@@ -158,15 +152,6 @@ const inferBomlessUtf16 = (bytes) => {
     }
     return null;
 };
-/**
- * Picks the decoder for a text buffer.
- *
- * `encoding` other than `auto` is used as-is. In `auto` mode the order is:
- * BOM, UTF-16 byte structure, strict UTF-8, then `fallbackEncoding`. The
- * fallback defaults to GB18030; pass `windows-1252`, `windows-1251`, or
- * another supported label for Latin, Cyrillic, or Central European legacy
- * files, which are otherwise misread as CJK text.
- */
 export const resolveFileViewerTextEncoding = (bytes, encoding = 'auto', fallbackEncoding = DEFAULT_FILE_VIEWER_TEXT_FALLBACK_ENCODING) => {
     const normalized = normalizeEncoding(encoding);
     if (normalized !== 'auto') {

package/dist/viewer/createViewer.d.ts

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

package/dist/viewer/createViewer.js

@@ -1,26 +1,20 @@
-// Imperative viewer composition root.
-//
-// `createViewer` wires source normalization, lifecycle hooks, renderer
-// sessions, document features, watermarking, and public operations into a
-// framework-neutral controller. Framework packages should wrap this API instead
-// of reimplementing the orchestration.
-import { createEmptyFileViewerSearchState, } from '../features/document/model.js';
-import { createFileViewerDocumentFeatureControllerActionHandlers, } from '../features/document/events.js';
-import { createFileViewerZoomController } from '../features/document/zoom.js';
-import { createFileViewerViewStateController } from '../features/document/viewState.js';
-import { createFileViewerFitController, hasFileViewerExplicitInitialViewState, } from '../features/document/fit.js';
-import { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, createFileViewerOriginalSourceStateFromNormalizedSource, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, resolveFileViewerDisplayFilename, resolveFileViewerOperationFilename, } from './operations.js';
-import { openFileViewerPrintMaskDesignerAsync } from '../features/printMaskLoader.js';
-import { applyFileViewerZoomAvailability, createUnsupportedAvailability, getRendererAvailability, } from '../registry/capabilities.js';
-import { buildFileViewerLifecycleContextFromNormalizedSource, buildFileViewerOperationContext, runFileViewerBeforeOperation, runFileViewerLifecycleHook, } from '../lifecycle/operations.js';
-import { collectFileViewerRendererPlugins, createRendererRegistry, getFileViewerAutoRendererPresetVersion, hasFileViewerRendererPresetName, installFileViewerRendererPlugins, listFileViewerAutoRendererPresets, resolveFileViewerRendererPresetInputs, resolveFileViewerRendererDefinition, } from '../registry/registry.js';
-import { createFileRenderHandlerLoader, applyFileViewerRenderSurfaceState, createFileViewerRenderSurfaceState, createFileViewerRenderSurface, removeFileViewerRenderTarget, syncFileViewerRenderSurfaceBackground, } from '../rendering/handler.js';
-import { createFileViewerCoreRendererRegistry } from '../renderers/index.js';
-import { createFileViewerRequestScope } from '../source/loading.js';
-import { normalizeSource } from '../source/index.js';
-import { buildFileViewerWatermarkInlineStyle } from '../features/watermark.js';
-import { createFileViewerSnapshotDownload } from '../output/snapshotDownload.js';
-import { createFileViewerErrorState, createFileViewerUnsupportedState } from './state.js';
+import { createEmptyFileViewerSearchState, } from "../features/document/model.js";
+import { createFileViewerDocumentFeatureControllerActionHandlers, } from "../features/document/events.js";
+import { createFileViewerZoomController } from "../features/document/zoom.js";
+import { createFileViewerViewStateController } from "../features/document/viewState.js";
+import { createFileViewerFitController, hasFileViewerExplicitInitialViewState, } from "../features/document/fit.js";
+import { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, createFileViewerOriginalSourceStateFromNormalizedSource, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, resolveFileViewerDisplayFilename, resolveFileViewerOperationFilename, } from "./operations.js";
+import { openFileViewerPrintMaskDesignerAsync } from "../features/printMaskLoader.js";
+import { applyFileViewerZoomAvailability, createUnsupportedAvailability, getRendererAvailability, } from "../registry/capabilities.js";
+import { buildFileViewerLifecycleContextFromNormalizedSource, buildFileViewerOperationContext, runFileViewerBeforeOperation, runFileViewerLifecycleHook, } from "../lifecycle/operations.js";
+import { collectFileViewerRendererPlugins, createRendererRegistry, getFileViewerAutoRendererPresetVersion, hasFileViewerRendererPresetName, installFileViewerRendererPlugins, listFileViewerAutoRendererPresets, resolveFileViewerRendererPresetInputs, resolveFileViewerRendererDefinition, } from "../registry/registry.js";
+import { createFileRenderHandlerLoader, applyFileViewerRenderSurfaceState, createFileViewerRenderSurfaceState, createFileViewerRenderSurface, removeFileViewerRenderTarget, syncFileViewerRenderSurfaceBackground, } from "../rendering/handler.js";
+import { createFileViewerCoreRendererRegistry } from "../renderers/index.js";
+import { createFileViewerRequestScope } from "../source/loading.js";
+import { normalizeSource } from "../source/index.js";
+import { buildFileViewerWatermarkInlineStyle } from "../features/watermark.js";
+import { createFileViewerSnapshotDownload } from "../output/snapshotDownload.js";
+import { createFileViewerErrorState, createFileViewerUnsupportedState } from "./state.js";
 const emitLifecycle = async (options, onEvent, phase, source, version, startedAt, reason) => {
     const now = Date.now();
     const context = buildFileViewerLifecycleContextFromNormalizedSource({
@@ -390,9 +384,6 @@ export const createViewer = (container, createOptions = {}) => {
             registry,
             options: {
                 ...inheritedOptions,
-                // The parent already resolved its renderer assembly into `registry`.
-                // Reuse that exact registry without reinstalling presets or mutating a
-                // shared registry while an attachment is open.
                 autoRenderers: false,
                 rendererMode: 'extend',
                 renderers: undefined,
@@ -686,8 +677,6 @@ export const createViewer = (container, createOptions = {}) => {
             zoomController.refreshProvider();
             viewStateController.refreshProvider();
             const finishStaleLoad = async () => {
-                // unload/replace may already have disposed this session. Clear only
-                // the session still owned by this load, preserving a replacement.
                 if (renderSurfaceState.session === session && currentRenderTarget === targetHost) {
                     await destroyCurrent('replace');
                 }

package/dist/viewer/loading.d.ts

@@ -1,5 +1,5 @@
-import { type FileViewerI18nInput } from '../i18n/messages.js';
-import type { FileViewerStateTheme } from '../contracts/types.js';
+import { type FileViewerI18nInput } from "../i18n/messages.js";
+import type { FileViewerStateTheme } from "../contracts/types.js";
 export type FileViewerLoadingTheme = FileViewerStateTheme;
 export interface FileViewerLoadingState {
     loading: boolean;
@@ -51,8 +51,4 @@ export declare const syncFileViewerLoadingControllerState: <Target extends Mutab
 export declare const runFileViewerLoadingControllerAction: <Target extends MutableFileViewerLoadingState>(target: Target, action: () => FileViewerLoadingState) => Target;
 export declare const runFileViewerLoadingExtensionSync: <Target extends MutableFileViewerLoadingState>({ target, controller, extension, }: RunFileViewerLoadingExtensionSyncInput<Target>) => Target;
 export declare const createFileViewerLoadingControllerActionHandlers: <Target extends MutableFileViewerLoadingState>(target: Target, controller: FileViewerLoadingController) => FileViewerLoadingControllerActionHandlers;
-/**
- * 统一管理加载、错误、文案和主题色。
- * wrapper 只负责把这个加载状态映射到各自框架的响应式系统。
- */
 export declare const createFileViewerLoadingController: (extend?: string, initialI18n?: FileViewerI18nInput) => FileViewerLoadingController;

package/dist/viewer/loading.js

@@ -1,4 +1,4 @@
-import { translateFileViewerMessage, } from '../i18n/messages.js';
+import { translateFileViewerMessage, } from "../i18n/messages.js";
 export const FALLBACK_FILE_VIEWER_LOADING_THEME = {
     accent: '#5f6f82',
     soft: 'rgba(95, 111, 130, 0.12)',
@@ -418,10 +418,6 @@ const FILE_VIEWER_LOADING_COPY_KEYS = {
     flac: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
     weba: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
 };
-/**
- * 根据扩展名返回统一的加载主题。
- * 这样不同预览器可以复用同一套视觉语义，避免颜色、图标和文案各写一份。
- */
 const localizeFileViewerLoadingTheme = (theme, extend = '', i18n) => {
     const normalized = extend.trim().toLowerCase();
     const keys = FILE_VIEWER_LOADING_COPY_KEYS[normalized] || {
@@ -511,10 +507,6 @@ export const createFileViewerLoadingControllerActionHandlers = (target, controll
         },
     };
 };
-/**
- * 统一管理加载、错误、文案和主题色。
- * wrapper 只负责把这个加载状态映射到各自框架的响应式系统。
- */
 export const createFileViewerLoadingController = (extend = '', initialI18n) => {
     let currentExtend = extend;
     let currentI18n = initialI18n;

package/dist/viewer/operations.d.ts

@@ -1,6 +1,6 @@
-import type { FileViewerErrorMessageFormatter } from './state.js';
-import { type FileViewerI18nInput } from '../i18n/messages.js';
-import type { FileRenderExportAdapter, FileViewerDownloadOptions, FileViewerExportHtmlOptions, FileViewerOperationType, FileViewerPrintOptions, NormalizedFileViewerSource } from '../contracts/types.js';
+import type { FileViewerErrorMessageFormatter } from "./state.js";
+import { type FileViewerI18nInput } from "../i18n/messages.js";
+import type { FileRenderExportAdapter, FileViewerDownloadOptions, FileViewerExportHtmlOptions, FileViewerOperationType, FileViewerPrintOptions, NormalizedFileViewerSource } from "../contracts/types.js";
 export interface FileViewerOriginalSourceState {
     buffer?: ArrayBuffer | null;
     file?: File | Blob | null;