@file-viewer/core 2.1.2 → 2.1.3

package/dist/index.d.ts

@@ -13,9 +13,11 @@ export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDo
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout';
 export type { ApplyPrintPageSizeOptions, BuildPrintPageStyleOptions, PrintPageSize, } from './output/printLayout';
 export { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, FILE_VIEWER_OPERATION_ACTION_ERROR_PREFIXES, createFileViewerOperationActionHandlers, createFileViewerOriginalSourceState, createFileViewerOriginalSourceStateFromNormalizedSource, createFileViewerPublicOperationActionHandlers, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, hasFileViewerOriginalSource, resolveFileViewerDisplayFilename, resolveFileViewerOperationActionErrorMessage, resolveFileViewerOperationFilename, resolveFileViewerOriginalFilename, } from './viewer/operations';
+export { FILE_VIEWER_BUILTIN_MESSAGES, FILE_VIEWER_DEFAULT_LOCALE, FILE_VIEWER_FALLBACK_LOCALE, createFileViewerTranslator, formatFileViewerMessage, normalizeFileViewerLocale, resolveFileViewerLocale, translateFileViewerMessage, } from './i18n/messages';
+export type { FileViewerI18nInput, FileViewerResolvedLocale, ResolveFileViewerI18nInput, } from './i18n/messages';
 export type { CreateFileViewerOperationActionHandlersInput, FileViewerOperationActionErrorFormatter, FileViewerFileOperationType, FileViewerOperationActionErrorContext, FileViewerOperationActionErrorPrefixes, FileViewerOperationActionHandlers, FileViewerPublicOperationActionHandlers, ResolveFileViewerOperationActionErrorMessageInput, } from './viewer/operations';
-export { clearFileViewerAutoRendererPresets, collectFileViewerRendererPlugins, createRendererRegistry, getFileViewerAutoRendererPresetVersion, installFileViewerRendererPlugins, listFileViewerAutoRendererPresets, registerFileViewerAutoRendererPreset, unregisterFileViewerAutoRendererPreset, } from './registry/registry';
-export type { RegisterFileViewerAutoRendererPresetOptions, } from './registry/registry';
+export { clearFileViewerAutoRendererPresets, collectFileViewerRendererPlugins, createRendererRegistry, findFileViewerAutoRendererPreset, getFileViewerAutoRendererPresetVersion, hasFileViewerRendererPresetName, installFileViewerRendererPlugins, listFileViewerAutoRendererPresetEntries, listFileViewerAutoRendererPresets, registerFileViewerAutoRendererPreset, resolveFileViewerRendererPresetInputs, unregisterFileViewerAutoRendererPreset, } from './registry/registry';
+export type { FileViewerAutoRendererPresetEntry, RegisterFileViewerAutoRendererPresetOptions, } from './registry/registry';
 export { CORE_LITE_RENDERER_IDS, coreBrowserRendererHandlers, coreLiteBrowserRendererHandlers, coreLiteRendererDefinitions, createFileViewerCoreRendererRegistry, fileViewerCoreRendererDispatcher, fileViewerCoreRendererRegistry, fileViewerCoreRendererRegistryBridge, missingFileViewerCoreRendererHandlers, } from './renderers/index';
 export type { CreateFileViewerCoreRendererRegistryOptions, } from './renderers/index';
 export declare const renderFileViewerAudio: (buffer: ArrayBuffer, target: HTMLDivElement, type?: string) => Promise<FileViewerRenderedInstance>;
@@ -79,4 +81,4 @@ export type { CreateFileViewerZoomControllerOptions, FileViewerZoomOperation, }
 export type { CreateViewerOptions } from './viewer/createViewer';
 export type { BuildExportHtmlDocumentOptions, BuildFileViewerRenderedHtmlDocumentOptions, } from './output/export';
 export type { CreateFileViewerWorkerControllerOptions, FileViewerWorkerContext, FileViewerWorkerController, FileViewerWorkerErrorHook, FileViewerWorkerEventHandler, FileViewerWorkerFactory, FileViewerWorkerMessageHook, WorkerProvider, WorkerRef, } from './platform/worker';
-export type { FileViewerAiOptions, FileViewerArchiveOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfOptions, FileViewerPrintOptions, FileViewerPublicApi, FileViewerRenderedInstance, FileViewerRendererMode, FileViewerRendererPluginAssetKind, FileViewerRendererPluginAssetManifest, FileViewerRendererPluginAssetEntry, FileViewerRenderStateKind, FileViewerRendererCategory, FileViewerRendererHandlerRegistration, FileViewerRendererInstallContext, FileViewerRendererPlugin, FileViewerRendererPluginInput, FileViewerRendererPreset, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerTypstOptions, FileViewerWatermarkOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';
+export type { FileViewerAiOptions, FileViewerArchiveOptions, FileViewerBeforeOperation, FileViewerCadDwfLineWeightMode, FileViewerCadOptions, FileViewerCadRenderer, FileViewerComponentEmits, FileViewerComponentEventMap, FileViewerComponentProps, FileViewerDocumentAnchor, FileViewerDocumentChunk, FileViewerDownloadOptions, FileViewerDocxOptions, FileViewerDrawingOptions, FileViewerEvent, FileViewerEventHandler, FileViewerEventType, FileViewerExportHtmlOptions, FileViewerFileRef, FileRenderContext, FileRenderExportAdapter, FileRenderExportMode, FileRenderExportOptions, FileRenderHandler, FileRenderHandlerComposite, FileViewerBuiltinRendererPreset, FileViewerInstance, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerI18nOptions, FileViewerLocale, FileViewerMessageKey, FileViewerMessageParams, FileViewerMessageResolver, FileViewerMessages, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerPdfOptions, FileViewerPrintOptions, FileViewerPublicApi, FileViewerRenderedInstance, FileViewerRendererMode, FileViewerRendererPluginAssetKind, FileViewerRendererPluginAssetManifest, FileViewerRendererPluginAssetEntry, FileViewerRenderStateKind, FileViewerRendererCategory, FileViewerRendererHandlerRegistration, FileViewerRendererInstallContext, FileViewerRendererPlugin, FileViewerRendererPluginInput, FileViewerRendererPresetInput, FileViewerRendererPresetName, FileViewerRendererPreset, FileViewerSearchMatch, FileViewerSearchOptions, FileViewerSearchProvider, FileViewerSearchState, FileViewerSource, FileViewerSourceKind, FileViewerSpreadsheetOptions, FileViewerStateDescriptor, FileViewerStateTheme, FileViewerThemeMode, FileViewerToolbarActionMap, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerTypstOptions, FileViewerWatermarkOptions, FileViewerZoomProvider, FileViewerZoomState, NormalizedFileViewerSource, RendererCapability, RendererDefinition, RendererPlugin, RendererLoadContext, RendererLoader, RendererRegistry, RendererSession, RenderSurface, ViewerCapabilityState, ViewerLifecycleContext, ViewerOperationContext, } from './contracts/types';

package/dist/index.js

@@ -8,7 +8,8 @@ export { DEFAULT_FILE_VIEWER_ANCHOR_EXCLUDE_SELECTOR, DEFAULT_FILE_VIEWER_ANCHOR
 export { buildFileViewerRenderedHtmlDocument, buildExportHtmlDocument, collectDocumentStyles, prepareFileViewerRenderedContentForSnapshot, replaceFileViewerCanvasWithImages, resolveFileViewerPrintStyle, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerImages, waitForFileViewerNextPaint, waitForFileViewerPrintWindowReady, } from './output/export.js';
 export { applyPrintPageSize, buildPrintPageStyle, formatCssPixels, getElementPrintPageSize, } from './output/printLayout.js';
 export { DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME, DEFAULT_FILE_VIEWER_EXPORT_FILENAME, DEFAULT_FILE_VIEWER_PREVIEW_TITLE, FILE_VIEWER_OPERATION_ACTION_ERROR_PREFIXES, createFileViewerOperationActionHandlers, createFileViewerOriginalSourceState, createFileViewerOriginalSourceStateFromNormalizedSource, createFileViewerPublicOperationActionHandlers, executeFileViewerDownloadOperation, executeFileViewerExportHtmlOperation, executeFileViewerPrintOperation, hasFileViewerOriginalSource, resolveFileViewerDisplayFilename, resolveFileViewerOperationActionErrorMessage, resolveFileViewerOperationFilename, resolveFileViewerOriginalFilename, } from './viewer/operations.js';
-export { clearFileViewerAutoRendererPresets, collectFileViewerRendererPlugins, createRendererRegistry, getFileViewerAutoRendererPresetVersion, installFileViewerRendererPlugins, listFileViewerAutoRendererPresets, registerFileViewerAutoRendererPreset, unregisterFileViewerAutoRendererPreset, } from './registry/registry.js';
+export { FILE_VIEWER_BUILTIN_MESSAGES, FILE_VIEWER_DEFAULT_LOCALE, FILE_VIEWER_FALLBACK_LOCALE, createFileViewerTranslator, formatFileViewerMessage, normalizeFileViewerLocale, resolveFileViewerLocale, translateFileViewerMessage, } from './i18n/messages.js';
+export { clearFileViewerAutoRendererPresets, collectFileViewerRendererPlugins, createRendererRegistry, findFileViewerAutoRendererPreset, getFileViewerAutoRendererPresetVersion, hasFileViewerRendererPresetName, installFileViewerRendererPlugins, listFileViewerAutoRendererPresetEntries, listFileViewerAutoRendererPresets, registerFileViewerAutoRendererPreset, resolveFileViewerRendererPresetInputs, unregisterFileViewerAutoRendererPreset, } from './registry/registry.js';
 export { CORE_LITE_RENDERER_IDS, coreBrowserRendererHandlers, coreLiteBrowserRendererHandlers, coreLiteRendererDefinitions, createFileViewerCoreRendererRegistry, fileViewerCoreRendererDispatcher, fileViewerCoreRendererRegistry, fileViewerCoreRendererRegistryBridge, missingFileViewerCoreRendererHandlers, } from './renderers/index.js';
 export const renderFileViewerAudio = async (buffer, target, type) => {
     void buffer;

package/dist/lifecycle/facade.js

@@ -16,6 +16,7 @@ export const createFileViewerLifecycleFacade = ({ getOptions, getFilename, getBu
             onOperationErrorMessage === null || onOperationErrorMessage === void 0 ? void 0 : onOperationErrorMessage(resolveFileViewerBeforeOperationErrorMessage({
                 error,
                 formatErrorMessage,
+                i18n: getOptions(),
             }), context);
         },
     });
@@ -29,6 +30,7 @@ export const createFileViewerLifecycleFacade = ({ getOptions, getFilename, getBu
             currentFile: getCurrentFile(),
             fallbackFile: getFallbackFile(),
             fallbackUrl: getFallbackUrl(),
+            i18n: getOptions(),
         });
     };
     return {
@@ -48,6 +50,7 @@ export const createFileViewerLifecycleFacade = ({ getOptions, getFilename, getBu
                 sourceUrl,
                 filename: getFilename(),
                 bufferSize: getBufferSize(),
+                i18n: getOptions(),
             });
         },
         buildRenderCompleteState({ version, source, file, sourceUrl, }) {

package/dist/lifecycle/operations.d.ts

@@ -1,3 +1,4 @@
+import { type FileViewerI18nInput } from '../i18n/messages';
 import type { FileViewerErrorMessageFormatter } from '../viewer/state';
 import { type FileViewerOriginalSourceState } from '../viewer/operations';
 import type { FileRenderExportAdapter, FileViewerBeforeOperation, FileViewerFileRef, FileViewerLifecycleContext, FileViewerLifecycleHooks, FileViewerLifecyclePhase, FileViewerOperationAvailability, FileViewerOperationContext, FileViewerOperationType, FileViewerOptions, FileViewerSourceKind, FileViewerToolbarOptions, FileViewerToolbarPosition, FileViewerPublicApi, FileViewerZoomState, NormalizedFileViewerSource } from '../contracts/types';
@@ -95,6 +96,7 @@ export interface ResolveFileViewerBeforeOperationErrorMessageInput {
     error: unknown;
     formatErrorMessage: FileViewerErrorMessageFormatter;
     prefix?: string;
+    i18n?: FileViewerI18nInput;
 }
 export interface ResolveFileViewerLifecycleHookErrorMessageInput {
     context: Pick<FileViewerLifecycleContext, 'phase'>;
@@ -220,6 +222,7 @@ export interface BuildFileViewerOperationContextFromLifecycleStateInput {
     fallbackUrl?: string | null;
     timestamp?: number;
     lifecycleTimestamp?: number;
+    i18n?: FileViewerI18nInput;
 }
 export interface RunFileViewerActiveUnloadStartInput {
     lifecycleState: Pick<FileViewerLifecycleStateController, 'getActiveDocumentContext' | 'buildActiveUnloadContext'>;
@@ -241,10 +244,10 @@ export declare const buildFileViewerLifecycleContext: <Source extends string = F
 export declare const buildFileViewerLifecycleContextFromNormalizedSource: ({ phase, source, version, startedAt, timestamp, reason, }: BuildFileViewerLifecycleContextFromNormalizedSourceInput) => FileViewerLifecycleContext;
 export declare const resolveFileViewerLifecycleFallbackSource: ({ file, url, }?: ResolveFileViewerLifecycleFallbackSourceInput) => ResolvedFileViewerLifecycleFallbackSource;
 export declare const createFileViewerLifecycleStateController: () => FileViewerLifecycleStateController;
-export declare const buildFileViewerOperationContext: <Source extends string = FileViewerSourceKind>(operation: FileViewerOperationType, lifecycleContext: BuiltFileViewerLifecycleContext<Source>, timestamp?: number) => BuiltFileViewerOperationContext<Source>;
-export declare const buildFileViewerOperationContextFromLifecycleState: ({ operation, lifecycleState, version, filename, bufferSize, currentFile, fallbackFile, fallbackUrl, timestamp, lifecycleTimestamp, }: BuildFileViewerOperationContextFromLifecycleStateInput) => FileViewerOperationContext;
+export declare const buildFileViewerOperationContext: <Source extends string = FileViewerSourceKind>(operation: FileViewerOperationType, lifecycleContext: BuiltFileViewerLifecycleContext<Source>, timestamp?: number, i18n?: FileViewerI18nInput) => BuiltFileViewerOperationContext<Source>;
+export declare const buildFileViewerOperationContextFromLifecycleState: ({ operation, lifecycleState, version, filename, bufferSize, currentFile, fallbackFile, fallbackUrl, timestamp, lifecycleTimestamp, i18n, }: BuildFileViewerOperationContextFromLifecycleStateInput) => FileViewerOperationContext;
 export declare const emitFileViewerComponentLifecycleEvent: (emit: FileViewerLifecycleComponentEmit, context: FileViewerLifecycleContext) => void;
-export declare const resolveFileViewerBeforeOperationErrorMessage: ({ error, formatErrorMessage, prefix, }: ResolveFileViewerBeforeOperationErrorMessageInput) => string;
+export declare const resolveFileViewerBeforeOperationErrorMessage: ({ error, formatErrorMessage, prefix, i18n, }: ResolveFileViewerBeforeOperationErrorMessageInput) => string;
 export declare const resolveFileViewerLifecycleHookErrorMessage: ({ context, prefix, }: ResolveFileViewerLifecycleHookErrorMessageInput) => string;
 export declare const DEFAULT_FILE_VIEWER_LIFECYCLE_HOOK_ERROR_LOGGER: FileViewerLifecycleHookErrorLogger;
 export declare const reportFileViewerLifecycleHookError: ({ error, context, onLogError, prefix, }: ReportFileViewerLifecycleHookErrorInput) => string;

package/dist/lifecycle/operations.js

@@ -5,6 +5,7 @@
 // operation execution remains in `viewer/operations`.
 import { resolvePrintAvailability } from '../registry/capabilities.js';
 import { getExtension, normalizeFilename } from '../source/index.js';
+import { translateFileViewerMessage, } from '../i18n/messages.js';
 import { createFileViewerOriginalSourceState, hasFileViewerOriginalSource, } from '../viewer/operations.js';
 export const FILE_VIEWER_LIFECYCLE_HOOKS = {
     'load-start': 'onLoadStart',
@@ -105,16 +106,24 @@ export const createFileViewerLifecycleStateController = () => {
         },
     };
 };
-export const buildFileViewerOperationContext = (operation, lifecycleContext, timestamp = Date.now()) => {
+export const buildFileViewerOperationContext = (operation, lifecycleContext, timestamp = Date.now(), i18n) => {
     const { phase: _phase, ...context } = lifecycleContext;
+    const labelKey = {
+        download: 'operation.download',
+        print: 'operation.print',
+        'export-html': 'operation.exportHtml',
+        'zoom-in': 'operation.zoomIn',
+        'zoom-out': 'operation.zoomOut',
+        'zoom-reset': 'operation.zoomReset',
+    };
     return {
         ...context,
         operation,
-        label: FILE_VIEWER_OPERATION_LABELS[operation],
+        label: translateFileViewerMessage(i18n, labelKey[operation]),
         timestamp,
     };
 };
-export const buildFileViewerOperationContextFromLifecycleState = ({ operation, lifecycleState, version, filename, bufferSize, currentFile, fallbackFile, fallbackUrl, timestamp, lifecycleTimestamp, }) => {
+export const buildFileViewerOperationContextFromLifecycleState = ({ operation, lifecycleState, version, filename, bufferSize, currentFile, fallbackFile, fallbackUrl, timestamp, lifecycleTimestamp, i18n, }) => {
     const activeContext = lifecycleState.getActiveDocumentContext();
     const fallbackSource = resolveFileViewerLifecycleFallbackSource({
         file: fallbackFile,
@@ -131,7 +140,7 @@ export const buildFileViewerOperationContextFromLifecycleState = ({ operation, l
         startedAt: lifecycleState.getLoadStartedAt(version),
         timestamp: lifecycleTimestamp,
     });
-    return buildFileViewerOperationContext(operation, baseContext, timestamp);
+    return buildFileViewerOperationContext(operation, baseContext, timestamp, i18n);
 };
 export const emitFileViewerComponentLifecycleEvent = (emit, context) => {
     if (context.phase === 'load-start') {
@@ -148,8 +157,8 @@ export const emitFileViewerComponentLifecycleEvent = (emit, context) => {
     }
     emit('unload-complete', context);
 };
-export const resolveFileViewerBeforeOperationErrorMessage = ({ error, formatErrorMessage, prefix = FILE_VIEWER_BEFORE_OPERATION_ERROR_PREFIX, }) => {
-    return formatErrorMessage(prefix, error);
+export const resolveFileViewerBeforeOperationErrorMessage = ({ error, formatErrorMessage, prefix, i18n, }) => {
+    return formatErrorMessage(prefix || translateFileViewerMessage(i18n, 'error.beforeOperation'), error);
 };
 export const resolveFileViewerLifecycleHookErrorMessage = ({ context, prefix = FILE_VIEWER_LIFECYCLE_HOOK_ERROR_MESSAGE_PREFIX, }) => {
     return `${prefix} ${context.phase} hook failed`;

package/dist/registry/registry.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerRendererHandlerRegistration, FileViewerRendererPluginInput, FileViewerRendererPlugin, RendererDefinition, RendererRegistry } from '../contracts/types';
+import type { FileViewerRendererHandlerRegistration, FileViewerRendererPluginInput, FileViewerRendererPlugin, FileViewerRendererPresetInput, FileViewerRendererPresetName, RendererDefinition, RendererRegistry } from '../contracts/types';
 export interface RegisterFileViewerAutoRendererPresetOptions {
     /**
      * Stable key used to replace an existing auto preset registration.
@@ -10,6 +10,11 @@ export interface RegisterFileViewerAutoRendererPresetOptions {
      */
     packageName?: string;
 }
+export interface FileViewerAutoRendererPresetEntry<Handler = unknown> {
+    id: string;
+    packageName?: string;
+    input: FileViewerRendererPluginInput<Handler>;
+}
 export declare const createRendererRegistry: (initialDefinitions?: readonly RendererDefinition[]) => RendererRegistry;
 export interface InstallFileViewerRendererPluginsOptions<Handler = unknown> {
     registry: RendererRegistry;
@@ -21,5 +26,20 @@ export declare const registerFileViewerAutoRendererPreset: <Handler = unknown>(i
 export declare const unregisterFileViewerAutoRendererPreset: (id: string) => boolean;
 export declare const clearFileViewerAutoRendererPresets: () => void;
 export declare const listFileViewerAutoRendererPresets: <Handler = unknown>() => FileViewerRendererPluginInput<Handler>[];
+export declare const listFileViewerAutoRendererPresetEntries: <Handler = unknown>() => {
+    input: FileViewerRendererPluginInput<Handler>;
+    id: string;
+    packageName?: string;
+}[];
+export declare const findFileViewerAutoRendererPreset: <Handler = unknown>(id: FileViewerRendererPresetName | string) => FileViewerRendererPluginInput<Handler> | undefined;
 export declare const getFileViewerAutoRendererPresetVersion: () => number;
+export declare const hasFileViewerRendererPresetName: (input?: FileViewerRendererPresetInput | null) => boolean;
+/**
+ * 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 declare const resolveFileViewerRendererPresetInputs: <Handler = unknown>(input?: FileViewerRendererPresetInput<Handler> | null) => FileViewerRendererPluginInput<Handler>[];
 export declare const installFileViewerRendererPlugins: <Handler = unknown>({ registry, plugins, registerHandler, }: InstallFileViewerRendererPluginsOptions<Handler>) => Promise<RendererRegistry>;

package/dist/registry/registry.js

@@ -136,7 +136,56 @@ export const clearFileViewerAutoRendererPresets = () => {
     bucket.version += 1;
 };
 export const listFileViewerAutoRendererPresets = () => Array.from(getAutoRendererBucket().presets.values()).map(entry => entry.input);
+export const listFileViewerAutoRendererPresetEntries = () => Array.from(getAutoRendererBucket().presets.values()).map(entry => ({
+    ...entry,
+    input: entry.input,
+}));
+export const findFileViewerAutoRendererPreset = (id) => {
+    var _a;
+    const bucket = getAutoRendererBucket();
+    const direct = bucket.presets.get(id);
+    if (direct) {
+        return direct.input;
+    }
+    const packageSuffix = id.startsWith('@file-viewer/preset-')
+        ? id
+        : `@file-viewer/preset-${id}`;
+    return (_a = Array.from(bucket.presets.values()).find(entry => entry.packageName === packageSuffix ||
+        entry.id === packageSuffix)) === null || _a === void 0 ? void 0 : _a.input;
+};
 export const getFileViewerAutoRendererPresetVersion = () => getAutoRendererBucket().version;
+export const hasFileViewerRendererPresetName = (input) => {
+    if (!input) {
+        return false;
+    }
+    if (typeof input === 'string') {
+        return true;
+    }
+    if (Array.isArray(input)) {
+        return input.some(item => hasFileViewerRendererPresetName(item));
+    }
+    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 [];
+    }
+    if (typeof input === 'string') {
+        const preset = findFileViewerAutoRendererPreset(input);
+        return preset ? [preset] : [];
+    }
+    if (Array.isArray(input)) {
+        return input.flatMap(item => resolveFileViewerRendererPresetInputs(item));
+    }
+    return [input];
+};
 export const installFileViewerRendererPlugins = async ({ registry, plugins, registerHandler, }) => {
     var _a, _b, _c;
     for (const plugin of plugins) {

package/dist/source/loading.d.ts

@@ -1,6 +1,7 @@
 import type { FileViewerFileRef, FileViewerLifecycleContext, FileViewerPdfOptions } from '../contracts/types';
 import { type FileViewerLifecycleStateController } from '../lifecycle/operations';
 import { type FileViewerErrorMessageFormatter } from '../viewer/state';
+import type { FileViewerI18nInput } from '../i18n/messages';
 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";
@@ -16,9 +17,11 @@ export interface ResolveFileViewerPreviewLoadErrorMessageInput {
     error: unknown;
     formatErrorMessage: FileViewerErrorMessageFormatter;
     prefixes?: FileViewerPreviewLoadErrorPrefixes;
+    i18n?: FileViewerI18nInput;
 }
 export interface ResolveFileViewerMissingRemoteDataErrorMessageInput {
     message?: string;
+    i18n?: FileViewerI18nInput;
 }
 export type FileViewerPreviewLoadErrorLogger = (error: unknown) => void;
 export interface ReportFileViewerPreviewLoadErrorInput extends ResolveFileViewerPreviewLoadErrorMessageInput {
@@ -128,6 +131,7 @@ export interface CreateFileViewerLoadStartStateInput {
     sourceUrl?: string | null;
     bufferSize?: number;
     loadingMessage?: string;
+    i18n?: FileViewerI18nInput;
     timestamp?: number;
 }
 export interface CommitFileViewerLoadStartStateInput {
@@ -211,6 +215,7 @@ export interface RunFileViewerStreamingPdfPreviewInput<Session = unknown> {
         sourceUrl?: string | null;
     }) => FileViewerRenderCompleteState;
     loadingMessage?: string;
+    i18n?: FileViewerI18nInput;
     onStartLoading?: (message: string) => void;
     onSession?: (session: Session | null) => void;
     onActiveDocumentContext?: (context: FileViewerLifecycleContext) => void;
@@ -289,8 +294,8 @@ export interface FileViewerRemoteFileDownloadInput {
     signal?: AbortSignal;
 }
 export type FileViewerRemoteFilePreviewErrorKind = 'stream' | 'load';
-export declare const resolveFileViewerPreviewLoadErrorMessage: ({ kind, error, formatErrorMessage, prefixes, }: ResolveFileViewerPreviewLoadErrorMessageInput) => string;
-export declare const resolveFileViewerMissingRemoteDataErrorMessage: ({ message, }?: ResolveFileViewerMissingRemoteDataErrorMessageInput) => string;
+export declare const resolveFileViewerPreviewLoadErrorMessage: ({ kind, error, formatErrorMessage, prefixes, i18n, }: ResolveFileViewerPreviewLoadErrorMessageInput) => string;
+export declare const resolveFileViewerMissingRemoteDataErrorMessage: ({ message, i18n, }?: ResolveFileViewerMissingRemoteDataErrorMessageInput) => string;
 export declare const DEFAULT_FILE_VIEWER_PREVIEW_LOAD_ERROR_LOGGER: FileViewerPreviewLoadErrorLogger;
 export declare const reportFileViewerPreviewLoadError: ({ onLogError, onErrorMessage, ...messageInput }: ReportFileViewerPreviewLoadErrorInput) => string;
 export declare const reportFileViewerMissingRemoteData: ({ onErrorMessage, ...messageInput }?: ReportFileViewerMissingRemoteDataInput) => string;
@@ -316,6 +321,7 @@ export interface RunFileViewerRemoteFilePreviewInput<Session = unknown> {
         file?: File | null;
         sourceUrl?: string | null;
     }) => FileViewerRenderCompleteState;
+    i18n?: FileViewerI18nInput;
     onMarkLoadStarted?: (version: number) => void;
     onStartLoading?: (message: string) => void;
     onSetLoadingMessage?: (message: string) => void;
@@ -443,6 +449,7 @@ export interface CreateFileViewerSourceLoadingActionHandlersInput<Session = unkn
     getUrl: () => string | null | undefined;
     getCurrentFilename?: () => string | undefined;
     getPdfStreaming?: () => FileViewerPdfOptions['streaming'] | undefined;
+    getI18n?: () => FileViewerI18nInput;
     getPageHref?: () => string | undefined;
     previewTarget: MutableFileViewerPreviewState;
     requestController: FileViewerRequestController;
@@ -505,14 +512,14 @@ export declare const applyFileViewerPreviewFilenameState: <Target extends Mutabl
 export declare const applyFileViewerRenderReadinessState: <Target extends MutableFileViewerRenderReadinessState>(target: Target, state: Partial<FileViewerRenderReadinessState>) => Target;
 export declare const commitFileViewerRenderCompleteState: <Session = unknown>({ version, session, buildState, readinessTarget, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, }: CommitFileViewerRenderCompleteStateInput<Session>) => FileViewerRenderCompleteState;
 export declare const runFileViewerReadAndRenderFile: <Session = unknown>({ file, version, sourceUrl, source, fallbackFilename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, }: RunFileViewerReadAndRenderFileInput<Session>) => Promise<FileViewerReadAndRenderFileState<Session>>;
-export declare const runFileViewerStreamingPdfPreview: <Session = unknown>({ url, version, filename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, loadingMessage, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }: RunFileViewerStreamingPdfPreviewInput<Session>) => Promise<FileViewerStreamingPdfPreviewState<Session>>;
+export declare const runFileViewerStreamingPdfPreview: <Session = unknown>({ url, version, filename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, loadingMessage, i18n, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }: RunFileViewerStreamingPdfPreviewInput<Session>) => Promise<FileViewerStreamingPdfPreviewState<Session>>;
 export declare const runFileViewerLocalFilePreview: <Session = unknown>({ source, version, currentFilename, fallbackFilename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, onMarkLoadStarted, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }: RunFileViewerLocalFilePreviewInput<Session>) => Promise<FileViewerLocalFilePreviewState<Session>>;
-export declare const runFileViewerRemoteFilePreview: <Session = unknown>({ url, version, pageHref, streaming, previewTarget, requestController, isCurrent, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, onMarkLoadStarted, onStartLoading, onSetLoadingMessage, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onMissingData, onError, }: RunFileViewerRemoteFilePreviewInput<Session>) => Promise<FileViewerRemoteFilePreviewState<Session>>;
-export declare const createFileViewerSourceLoadingActionHandlers: <Session = unknown>({ getFile, getUrl, getCurrentFilename, getPdfStreaming, getPageHref, previewTarget, requestController, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, formatErrorMessage, onMarkLoadStarted, onClearLoadStarted, onStartLoading, onSetLoadingMessage, onStopLoading, onShowError, onClearError, onResetLoading, onClearRenderedContent, onSession, onActiveDocumentContext, onLifecycle, }: CreateFileViewerSourceLoadingActionHandlersInput<Session>) => FileViewerSourceLoadingActionHandlers<Session>;
+export declare const runFileViewerRemoteFilePreview: <Session = unknown>({ url, version, pageHref, streaming, previewTarget, requestController, isCurrent, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, i18n, onMarkLoadStarted, onStartLoading, onSetLoadingMessage, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onMissingData, onError, }: RunFileViewerRemoteFilePreviewInput<Session>) => Promise<FileViewerRemoteFilePreviewState<Session>>;
+export declare const createFileViewerSourceLoadingActionHandlers: <Session = unknown>({ getFile, getUrl, getCurrentFilename, getPdfStreaming, getI18n, getPageHref, previewTarget, requestController, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, formatErrorMessage, onMarkLoadStarted, onClearLoadStarted, onStartLoading, onSetLoadingMessage, onStopLoading, onShowError, onClearError, onResetLoading, onClearRenderedContent, onSession, onActiveDocumentContext, onLifecycle, }: CreateFileViewerSourceLoadingActionHandlersInput<Session>) => FileViewerSourceLoadingActionHandlers<Session>;
 export declare const finalizeFileViewerPreviewLoadState: ({ version, isCurrent, onClearLoadStarted, onStopLoading, }: FinalizeFileViewerPreviewLoadStateInput) => void;
-export declare const resolveFileViewerLoadStartMessage: (source: FileViewerLifecycleContext["source"]) => "正在下载文件资源..." | "正在解析文件内容...";
+export declare const resolveFileViewerLoadStartMessage: (source: FileViewerLifecycleContext["source"], i18n?: FileViewerI18nInput) => string;
 export declare const commitFileViewerLoadStartState: ({ version, filename, fallbackFilename, filenameTarget, buildState, onMarkLoadStarted, onLifecycle, onStartLoading, }: CommitFileViewerLoadStartStateInput) => FileViewerLoadStartState;
-export declare const createFileViewerLoadStartState: ({ version, source, filename, file, sourceUrl, bufferSize, loadingMessage, timestamp, }: CreateFileViewerLoadStartStateInput) => FileViewerLoadStartState;
+export declare const createFileViewerLoadStartState: ({ version, source, filename, file, sourceUrl, bufferSize, loadingMessage, i18n, timestamp, }: CreateFileViewerLoadStartStateInput) => FileViewerLoadStartState;
 export declare const createFileViewerRenderCompleteState: ({ version, source, filename, file, sourceUrl, bufferSize, startedAt, timestamp, lifecycleState, }: CreateFileViewerRenderCompleteStateInput) => FileViewerRenderCompleteState;
 export declare const resolveFileViewerFileRefSourcePlan: ({ source, currentFilename, fallbackFilename, }: ResolveFileViewerFileRefSourcePlanInput) => FileViewerFileRefSourcePlan;
 export declare const normalizePdfStreamingMode: (mode: FileViewerPdfOptions["streaming"]) => true | false | "same-origin";
@@ -535,6 +542,7 @@ export interface CommitFileViewerRemoteDownloadStateInput {
     currentFilename?: string;
     fallbackFilename?: string;
     isCurrent: (version: number) => boolean;
+    i18n?: FileViewerI18nInput;
     onMissingData?: () => void;
     onSetLoadingMessage?: (message: string) => void;
 }
@@ -562,5 +570,5 @@ export declare const resolveFileViewerRemoteSourcePlan: ({ filename, fallbackFil
     streaming?: FileViewerPdfOptions["streaming"];
     url: string;
 }) => FileViewerRemoteSourcePlan;
-export declare const commitFileViewerRemoteDownloadState: ({ version, data, currentFilename, fallbackFilename, isCurrent, onMissingData, onSetLoadingMessage, }: CommitFileViewerRemoteDownloadStateInput) => FileViewerRemoteDownloadState;
+export declare const commitFileViewerRemoteDownloadState: ({ version, data, currentFilename, fallbackFilename, isCurrent, i18n, onMissingData, onSetLoadingMessage, }: CommitFileViewerRemoteDownloadStateInput) => FileViewerRemoteDownloadState;
 export declare const createFileViewerStreamingPdfPlaceholderFile: (filename?: string) => File;

package/dist/source/loading.js

@@ -1,5 +1,6 @@
 import { buildFileViewerLifecycleContext, } from '../lifecycle/operations.js';
-import { FILE_VIEWER_PREVIEW_MESSAGES, } from '../viewer/state.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';
@@ -9,11 +10,16 @@ export const FILE_VIEWER_PREVIEW_LOAD_ERROR_PREFIXES = {
     load: '加载文件异常',
     stream: '加载 PDF 流式预览异常',
 };
-export const resolveFileViewerPreviewLoadErrorMessage = ({ kind, error, formatErrorMessage, prefixes, }) => {
+export const resolveFileViewerPreviewLoadErrorMessage = ({ kind, error, formatErrorMessage, prefixes, i18n, }) => {
     var _a;
-    return formatErrorMessage((_a = prefixes === null || prefixes === void 0 ? void 0 : prefixes[kind]) !== null && _a !== void 0 ? _a : FILE_VIEWER_PREVIEW_LOAD_ERROR_PREFIXES[kind], error);
-};
-export const resolveFileViewerMissingRemoteDataErrorMessage = ({ message = FILE_VIEWER_REMOTE_MISSING_DATA_ERROR_MESSAGE, } = {}) => message;
+    const fallbackPrefix = kind === 'local'
+        ? translateFileViewerMessage(i18n, 'error.localRead')
+        : kind === 'stream'
+            ? translateFileViewerMessage(i18n, 'error.stream')
+            : translateFileViewerMessage(i18n, 'error.load');
+    return formatErrorMessage((_a = prefixes === null || prefixes === void 0 ? void 0 : prefixes[kind]) !== null && _a !== void 0 ? _a : fallbackPrefix, error);
+};
+export const resolveFileViewerMissingRemoteDataErrorMessage = ({ message, i18n, } = {}) => message || translateFileViewerMessage(i18n, 'error.remoteDownload');
 export const DEFAULT_FILE_VIEWER_PREVIEW_LOAD_ERROR_LOGGER = error => {
     if (typeof console !== 'undefined' && typeof console.error === 'function') {
         console.error(error);
@@ -327,9 +333,9 @@ export const runFileViewerReadAndRenderFile = async ({ file, version, sourceUrl,
         complete,
     };
 };
-export const runFileViewerStreamingPdfPreview = async ({ url, version, filename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, loadingMessage = FILE_VIEWER_PREVIEW_MESSAGES.streamingPdf, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }) => {
+export const runFileViewerStreamingPdfPreview = async ({ url, version, filename, previewTarget, isCurrent, mountRenderedContent, destroyRenderSession, buildRenderCompleteState, loadingMessage, i18n, onStartLoading, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onError, }) => {
     let placeholderFile = null;
-    onStartLoading === null || onStartLoading === void 0 ? void 0 : onStartLoading(loadingMessage);
+    onStartLoading === null || onStartLoading === void 0 ? void 0 : onStartLoading(loadingMessage || resolveFileViewerPreviewMessages(i18n).streamingPdf);
     try {
         placeholderFile = createFileViewerStreamingPdfPlaceholderFile(filename);
         applyFileViewerPreviewSourceUrlState(previewTarget, url);
@@ -474,7 +480,7 @@ export const runFileViewerLocalFilePreview = async ({ source, version, currentFi
         });
     }
 };
-export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, streaming, previewTarget, requestController, isCurrent, downloadFile, mountRenderedContent, destroyRenderSession, buildLoadStartState, buildRenderCompleteState, onMarkLoadStarted, onStartLoading, onSetLoadingMessage, onSession, onActiveDocumentContext, onLifecycle, onClearLoadStarted, onStopLoading, onMissingData, onError, }) => {
+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({
         pageHref,
         streaming,
@@ -507,6 +513,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
                 source: 'url',
                 sourceUrl: url,
             }),
+            i18n,
             onStartLoading,
             onSession,
             onActiveDocumentContext,
@@ -555,6 +562,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
             data,
             currentFilename: remoteSource.filename,
             isCurrent,
+            i18n,
             onMissingData,
             onSetLoadingMessage,
         });
@@ -648,7 +656,7 @@ export const runFileViewerRemoteFilePreview = async ({ url, version, pageHref, s
         });
     }
 };
-export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, getCurrentFilename, getPdfStreaming, 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, getPdfStreaming, 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;
@@ -682,6 +690,7 @@ export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, g
                     kind: 'local',
                     error,
                     formatErrorMessage,
+                    i18n: getI18n === null || getI18n === void 0 ? void 0 : getI18n(),
                     onErrorMessage: onShowError,
                 });
             },
@@ -693,6 +702,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(),
+            i18n: getI18n === null || getI18n === void 0 ? void 0 : getI18n(),
             previewTarget,
             requestController,
             isCurrent: isCurrentRequest,
@@ -720,6 +730,7 @@ export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, g
             onStopLoading,
             onMissingData: () => {
                 reportFileViewerMissingRemoteData({
+                    i18n: getI18n === null || getI18n === void 0 ? void 0 : getI18n(),
                     onErrorMessage: onShowError,
                 });
             },
@@ -728,6 +739,7 @@ export const createFileViewerSourceLoadingActionHandlers = ({ getFile, getUrl, g
                     kind,
                     error,
                     formatErrorMessage,
+                    i18n: getI18n === null || getI18n === void 0 ? void 0 : getI18n(),
                     onErrorMessage: onShowError,
                 });
             },
@@ -778,10 +790,11 @@ export const finalizeFileViewerPreviewLoadState = ({ version, isCurrent, onClear
         onStopLoading === null || onStopLoading === void 0 ? void 0 : onStopLoading();
     }
 };
-export const resolveFileViewerLoadStartMessage = (source) => {
+export const resolveFileViewerLoadStartMessage = (source, i18n) => {
+    const messages = resolveFileViewerPreviewMessages(i18n);
     return source === 'url'
-        ? FILE_VIEWER_PREVIEW_MESSAGES.downloading
-        : FILE_VIEWER_PREVIEW_MESSAGES.reading;
+        ? messages.downloading
+        : messages.reading;
 };
 export const commitFileViewerLoadStartState = ({ version, filename, fallbackFilename, filenameTarget, buildState, onMarkLoadStarted, onLifecycle, onStartLoading, }) => {
     if (filenameTarget) {
@@ -793,9 +806,9 @@ export const commitFileViewerLoadStartState = ({ version, filename, fallbackFile
     onStartLoading === null || onStartLoading === void 0 ? void 0 : onStartLoading(loadStartState.loadingMessage);
     return loadStartState;
 };
-export const createFileViewerLoadStartState = ({ version, source, filename, file, sourceUrl, bufferSize, loadingMessage, timestamp, }) => {
+export const createFileViewerLoadStartState = ({ version, source, filename, file, sourceUrl, bufferSize, loadingMessage, i18n, timestamp, }) => {
     return {
-        loadingMessage: loadingMessage || resolveFileViewerLoadStartMessage(source),
+        loadingMessage: loadingMessage || resolveFileViewerLoadStartMessage(source, i18n),
         lifecycleContext: buildFileViewerLifecycleContext({
             phase: 'load-start',
             version,
@@ -883,7 +896,7 @@ export const resolveFileViewerRemoteSourcePlan = ({ filename, fallbackFilename =
             : false,
     };
 };
-export const commitFileViewerRemoteDownloadState = ({ version, data, currentFilename, fallbackFilename, isCurrent, onMissingData, onSetLoadingMessage, }) => {
+export const commitFileViewerRemoteDownloadState = ({ version, data, currentFilename, fallbackFilename, isCurrent, i18n, onMissingData, onSetLoadingMessage, }) => {
     if (!isCurrent(version)) {
         return {
             stale: true,
@@ -899,7 +912,7 @@ export const commitFileViewerRemoteDownloadState = ({ version, data, currentFile
             source: null,
         };
     }
-    onSetLoadingMessage === null || onSetLoadingMessage === void 0 ? void 0 : onSetLoadingMessage(FILE_VIEWER_PREVIEW_MESSAGES.reading);
+    onSetLoadingMessage === null || onSetLoadingMessage === void 0 ? void 0 : onSetLoadingMessage(resolveFileViewerPreviewMessages(i18n).reading);
     return {
         stale: false,
         missing: false,

package/dist/viewer/createViewer.js

@@ -10,7 +10,7 @@ import { createFileViewerZoomController } from '../features/document/zoom.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 { getRendererAvailability, createUnsupportedAvailability } from '../registry/capabilities.js';
 import { buildFileViewerLifecycleContextFromNormalizedSource, buildFileViewerOperationContext, runFileViewerBeforeOperation, runFileViewerLifecycleHook, } from '../lifecycle/operations.js';
-import { collectFileViewerRendererPlugins, createRendererRegistry, getFileViewerAutoRendererPresetVersion, installFileViewerRendererPlugins, listFileViewerAutoRendererPresets, } from '../registry/registry.js';
+import { collectFileViewerRendererPlugins, createRendererRegistry, getFileViewerAutoRendererPresetVersion, hasFileViewerRendererPresetName, installFileViewerRendererPlugins, listFileViewerAutoRendererPresets, resolveFileViewerRendererPresetInputs, } from '../registry/registry.js';
 import { createFileRenderHandlerLoader, applyFileViewerRenderSurfaceState, createFileViewerRenderSurfaceState, } from '../rendering/handler.js';
 import { createFileViewerCoreRendererRegistry } from '../renderers/index.js';
 import { createFileViewerRequestScope } from '../source/loading.js';
@@ -53,9 +53,9 @@ const resolveAutoRenderersEnabled = (options) => {
     }
     return (options.rendererMode || 'extend') !== 'replace';
 };
-const renderMissingRendererState = (container, type) => {
+const renderMissingRendererState = (container, type, options) => {
     const documentRef = container.ownerDocument;
-    const state = createFileViewerUnsupportedState(type);
+    const state = createFileViewerUnsupportedState(type, undefined, options);
     const wrapper = documentRef.createElement('div');
     wrapper.className = 'file-viewer-missing-renderer';
     wrapper.style.cssText = [
@@ -75,8 +75,7 @@ const renderMissingRendererState = (container, type) => {
     title.textContent = state.message;
     title.style.cssText = 'display:block;margin-bottom:8px;color:#172033;font-size:16px;';
     const description = documentRef.createElement('p');
-    description.textContent = state.description ||
-        '当前内置 renderer 配置没有加载该格式。请安装并传入对应 @file-viewer/renderer-* 包，或使用 @file-viewer/preset-all。';
+    description.textContent = state.description || state.title;
     description.style.cssText = 'max-width:520px;margin:0;';
     content.append(title, description);
     wrapper.append(content);
@@ -86,6 +85,8 @@ export const createViewer = (container, createOptions = {}) => {
     let options = createOptions.options || {};
     let registry = createBaseRendererRegistry(createOptions, options);
     let installedRendererInput = undefined;
+    let installedPresetInput = undefined;
+    let installedPresetsInput = undefined;
     let installedRendererMode = options.rendererMode || 'extend';
     let installedBuiltinRenderers = options.builtinRenderers || 'all';
     let installedAutoRenderersEnabled = resolveAutoRenderersEnabled(options);
@@ -100,13 +101,20 @@ export const createViewer = (container, createOptions = {}) => {
     const ensureRendererPluginsInstalled = async () => {
         const nextMode = options.rendererMode || 'extend';
         const nextRendererInput = options.renderers;
+        const nextPresetInput = options.preset;
+        const nextPresetsInput = options.presets;
         const nextBuiltinRenderers = options.builtinRenderers || 'all';
         const nextAutoRenderersEnabled = resolveAutoRenderersEnabled(options);
-        const nextAutoRendererVersion = nextAutoRenderersEnabled
+        const needsAutoPresetBucket = nextAutoRenderersEnabled ||
+            hasFileViewerRendererPresetName(nextPresetInput) ||
+            hasFileViewerRendererPresetName(nextPresetsInput);
+        const nextAutoRendererVersion = needsAutoPresetBucket
             ? getFileViewerAutoRendererPresetVersion()
             : 0;
         if (nextMode === installedRendererMode &&
             nextRendererInput === installedRendererInput &&
+            nextPresetInput === installedPresetInput &&
+            nextPresetsInput === installedPresetsInput &&
             nextBuiltinRenderers === installedBuiltinRenderers &&
             nextAutoRenderersEnabled === installedAutoRenderersEnabled &&
             nextAutoRendererVersion === installedAutoRendererVersion) {
@@ -115,6 +123,8 @@ export const createViewer = (container, createOptions = {}) => {
         registry = createBaseRendererRegistry(createOptions, options);
         installedRendererMode = nextMode;
         installedRendererInput = nextRendererInput;
+        installedPresetInput = nextPresetInput;
+        installedPresetsInput = nextPresetsInput;
         installedBuiltinRenderers = nextBuiltinRenderers;
         installedAutoRenderersEnabled = nextAutoRenderersEnabled;
         installedAutoRendererVersion = nextAutoRendererVersion;
@@ -122,6 +132,7 @@ export const createViewer = (container, createOptions = {}) => {
         if (nextAutoRenderersEnabled) {
             rendererInputs.push(...listFileViewerAutoRendererPresets());
         }
+        rendererInputs.push(...resolveFileViewerRendererPresetInputs(nextPresetInput), ...resolveFileViewerRendererPresetInputs(nextPresetsInput));
         if (nextRendererInput) {
             rendererInputs.push(nextRendererInput);
         }
@@ -255,7 +266,7 @@ export const createViewer = (container, createOptions = {}) => {
             const startedAt = Date.now();
             await emitLifecycle(options, createOptions.onEvent, 'load-start', normalized, version, startedAt);
             if (!(renderer === null || renderer === void 0 ? void 0 : renderer.load)) {
-                renderMissingRendererState(container, normalized.extension);
+                renderMissingRendererState(container, normalized.extension, options);
                 applyFileViewerRenderSurfaceState(renderSurfaceState, { session: null });
                 emitOperationAvailabilityChange();
                 emitZoomChange();