@file-viewer/core 2.1.1 → 2.1.3

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, installFileViewerRendererPlugins, } 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';
@@ -43,9 +43,19 @@ const createBaseRendererRegistry = (createOptions, options) => {
         builtinRenderers: options.builtinRenderers,
     }).registry;
 };
-const renderMissingRendererState = (container, type) => {
+const resolveAutoRenderersEnabled = (options) => {
+    const setting = options.autoRenderers;
+    if (typeof setting === 'boolean') {
+        return setting;
+    }
+    if ((setting === null || setting === void 0 ? void 0 : setting.enabled) !== undefined) {
+        return setting.enabled;
+    }
+    return (options.rendererMode || 'extend') !== 'replace';
+};
+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 = [
@@ -65,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);
@@ -76,8 +85,12 @@ 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);
+    let installedAutoRendererVersion = -1;
     let currentSource = null;
     const renderSurfaceState = createFileViewerRenderSurfaceState();
     const requestScope = createFileViewerRequestScope();
@@ -88,17 +101,42 @@ 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 needsAutoPresetBucket = nextAutoRenderersEnabled ||
+            hasFileViewerRendererPresetName(nextPresetInput) ||
+            hasFileViewerRendererPresetName(nextPresetsInput);
+        const nextAutoRendererVersion = needsAutoPresetBucket
+            ? getFileViewerAutoRendererPresetVersion()
+            : 0;
         if (nextMode === installedRendererMode &&
             nextRendererInput === installedRendererInput &&
-            nextBuiltinRenderers === installedBuiltinRenderers) {
+            nextPresetInput === installedPresetInput &&
+            nextPresetsInput === installedPresetsInput &&
+            nextBuiltinRenderers === installedBuiltinRenderers &&
+            nextAutoRenderersEnabled === installedAutoRenderersEnabled &&
+            nextAutoRendererVersion === installedAutoRendererVersion) {
             return;
         }
         registry = createBaseRendererRegistry(createOptions, options);
         installedRendererMode = nextMode;
         installedRendererInput = nextRendererInput;
+        installedPresetInput = nextPresetInput;
+        installedPresetsInput = nextPresetsInput;
         installedBuiltinRenderers = nextBuiltinRenderers;
-        const plugins = collectFileViewerRendererPlugins(nextRendererInput);
+        installedAutoRenderersEnabled = nextAutoRenderersEnabled;
+        installedAutoRendererVersion = nextAutoRendererVersion;
+        const rendererInputs = [];
+        if (nextAutoRenderersEnabled) {
+            rendererInputs.push(...listFileViewerAutoRendererPresets());
+        }
+        rendererInputs.push(...resolveFileViewerRendererPresetInputs(nextPresetInput), ...resolveFileViewerRendererPresetInputs(nextPresetsInput));
+        if (nextRendererInput) {
+            rendererInputs.push(nextRendererInput);
+        }
+        const plugins = collectFileViewerRendererPlugins(rendererInputs);
         if (!plugins.length) {
             return;
         }
@@ -228,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();

package/dist/viewer/loading.d.ts

@@ -1,3 +1,4 @@
+import { type FileViewerI18nInput } from '../i18n/messages';
 import type { FileViewerStateTheme } from '../contracts/types';
 export type FileViewerLoadingTheme = FileViewerStateTheme;
 export interface FileViewerLoadingState {
@@ -11,6 +12,7 @@ export type MutableFileViewerLoadingState = FileViewerLoadingState;
 export interface FileViewerLoadingController {
     readonly state: FileViewerLoadingState;
     setExtension(nextExtend?: string): FileViewerLoadingState;
+    setI18n(nextI18n?: FileViewerI18nInput): FileViewerLoadingState;
     startLoading(nextMessage: string): FileViewerLoadingState;
     setLoadingMessage(nextMessage: string): FileViewerLoadingState;
     stopLoading(): FileViewerLoadingState;
@@ -21,6 +23,7 @@ export interface FileViewerLoadingController {
 }
 export interface FileViewerLoadingControllerActionHandlers {
     setExtension(nextExtend?: string): FileViewerLoadingState;
+    setI18n(nextI18n?: FileViewerI18nInput): FileViewerLoadingState;
     startLoading(nextMessage: string): FileViewerLoadingState;
     setLoadingMessage(nextMessage: string): FileViewerLoadingState;
     stopLoading(): FileViewerLoadingState;
@@ -36,16 +39,12 @@ export interface RunFileViewerLoadingExtensionSyncInput<Target extends MutableFi
 }
 export declare const FALLBACK_FILE_VIEWER_LOADING_THEME: FileViewerLoadingTheme;
 export declare const FILE_VIEWER_LOADING_THEME_MAP: Record<string, FileViewerLoadingTheme>;
-/**
- * 根据扩展名返回统一的加载主题。
- * 这样不同预览器可以复用同一套视觉语义，避免颜色、图标和文案各写一份。
- */
-export declare const resolveFileViewerLoadingTheme: (extend?: string) => FileViewerLoadingTheme;
+export declare const resolveFileViewerLoadingTheme: (extend?: string, i18n?: FileViewerI18nInput) => FileViewerLoadingTheme;
 export declare const createFileViewerLoadingStyleVars: (theme: FileViewerLoadingTheme) => {
     '--viewer-accent': string;
     '--viewer-soft': string;
 };
-export declare const createFileViewerLoadingState: (extend?: string) => FileViewerLoadingState;
+export declare const createFileViewerLoadingState: (extend?: string, i18n?: FileViewerI18nInput) => FileViewerLoadingState;
 export declare const cloneFileViewerLoadingState: (state: FileViewerLoadingState) => FileViewerLoadingState;
 export declare const applyFileViewerLoadingState: <Target extends MutableFileViewerLoadingState>(target: Target, source: FileViewerLoadingState) => Target;
 export declare const syncFileViewerLoadingControllerState: <Target extends MutableFileViewerLoadingState>(target: Target, controller: Pick<FileViewerLoadingController, "getState">, source?: FileViewerLoadingState) => Target;
@@ -56,4 +55,4 @@ export declare const createFileViewerLoadingControllerActionHandlers: <Target ex
  * 统一管理加载、错误、文案和主题色。
  * wrapper 只负责把这个加载状态映射到各自框架的响应式系统。
  */
-export declare const createFileViewerLoadingController: (extend?: string) => FileViewerLoadingController;
+export declare const createFileViewerLoadingController: (extend?: string, initialI18n?: FileViewerI18nInput) => FileViewerLoadingController;

package/dist/viewer/loading.js

@@ -1,3 +1,4 @@
+import { translateFileViewerMessage, } from '../i18n/messages.js';
 export const FALLBACK_FILE_VIEWER_LOADING_THEME = {
     accent: '#5f6f82',
     soft: 'rgba(95, 111, 130, 0.12)',
@@ -357,20 +358,84 @@ export const FILE_VIEWER_LOADING_THEME_MAP = {
         hint: '正在准备媒体资源和播放组件。'
     }
 };
+const FILE_VIEWER_LOADING_COPY_KEYS = {
+    doc: { label: 'loading.word.label', hint: 'loading.word.hint' },
+    docx: { label: 'loading.word.label', hint: 'loading.wordWorker.hint' },
+    xls: { label: 'loading.sheet.label', hint: 'loading.sheet.hint' },
+    xlsx: { label: 'loading.sheet.label', hint: 'loading.sheet.hint' },
+    csv: { label: 'loading.csv.label', hint: 'loading.csv.hint' },
+    ppt: { label: 'loading.presentation.label', hint: 'loading.presentation.hint' },
+    pptx: { label: 'loading.presentation.label', hint: 'loading.presentation.hint' },
+    pdf: { label: 'loading.pdf.label', hint: 'loading.pdf.hint' },
+    ofd: { label: 'loading.ofd.label', hint: 'loading.ofd.hint' },
+    zip: { label: 'loading.archive.label', hint: 'loading.archive.hint' },
+    rar: { label: 'loading.archive.label', hint: 'loading.archive.hint' },
+    '7z': { label: 'loading.archive.label', hint: 'loading.archive.hint' },
+    tar: { label: 'loading.archive.label', hint: 'loading.archive.hint' },
+    gz: { label: 'loading.archive.label', hint: 'loading.archive.hint' },
+    eml: { label: 'loading.email.label', hint: 'loading.email.hint' },
+    msg: { label: 'loading.email.label', hint: 'loading.msg.hint' },
+    olb: { label: 'loading.eda.label', hint: 'loading.eda.hint' },
+    dra: { label: 'loading.eda.label', hint: 'loading.eda.hint' },
+    dxf: { label: 'loading.cad.label', hint: 'loading.cad.hint' },
+    dwg: { label: 'loading.cad.label', hint: 'loading.dwg.hint' },
+    dwf: { label: 'loading.cad.label', hint: 'loading.dwf.hint' },
+    dwfx: { label: 'loading.cad.label', hint: 'loading.dwfx.hint' },
+    xps: { label: 'loading.cad.label', hint: 'loading.xps.hint' },
+    drawio: { label: 'loading.drawio.label', hint: 'loading.drawio.hint' },
+    dio: { label: 'loading.drawio.label', hint: 'loading.drawio.hint' },
+    excalidraw: { label: 'loading.excalidraw.label', hint: 'loading.excalidraw.hint' },
+    epub: { label: 'loading.epub.label', hint: 'loading.epub.hint' },
+    umd: { label: 'loading.umd.label', hint: 'loading.umd.hint' },
+    png: { label: 'loading.image.label', hint: 'loading.image.hint' },
+    jpg: { label: 'loading.image.label', hint: 'loading.image.hint' },
+    jpeg: { label: 'loading.image.label', hint: 'loading.image.hint' },
+    gif: { label: 'loading.image.label', hint: 'loading.image.hint' },
+    webp: { label: 'loading.image.label', hint: 'loading.image.hint' },
+    svg: { label: 'loading.image.label', hint: 'loading.image.hint' },
+    bmp: { label: 'loading.image.label', hint: 'loading.image.hint' },
+    mp4: { label: 'loading.video.label', hint: 'loading.video.hint' },
+    mov: { label: 'loading.video.label', hint: 'loading.video.hint' },
+    avi: { label: 'loading.video.label', hint: 'loading.video.hint' },
+    webm: { label: 'loading.video.label', hint: 'loading.video.hint' },
+    m4v: { label: 'loading.video.label', hint: 'loading.video.hint' },
+    mp3: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    mpeg: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    wav: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    ogg: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    oga: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    opus: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    m4a: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    aac: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    flac: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+    weba: { label: 'loading.audio.label', hint: 'loading.audio.hint' },
+};
 /**
  * 根据扩展名返回统一的加载主题。
  * 这样不同预览器可以复用同一套视觉语义，避免颜色、图标和文案各写一份。
  */
-export const resolveFileViewerLoadingTheme = (extend = '') => {
+const localizeFileViewerLoadingTheme = (theme, extend = '', i18n) => {
     const normalized = extend.trim().toLowerCase();
-    return FILE_VIEWER_LOADING_THEME_MAP[normalized] || FALLBACK_FILE_VIEWER_LOADING_THEME;
+    const keys = FILE_VIEWER_LOADING_COPY_KEYS[normalized] || {
+        label: 'loading.generic.label',
+        hint: 'loading.generic.hint',
+    };
+    return {
+        ...theme,
+        label: translateFileViewerMessage(i18n, keys.label),
+        hint: translateFileViewerMessage(i18n, keys.hint),
+    };
+};
+export const resolveFileViewerLoadingTheme = (extend = '', i18n) => {
+    const normalized = extend.trim().toLowerCase();
+    return localizeFileViewerLoadingTheme(FILE_VIEWER_LOADING_THEME_MAP[normalized] || FALLBACK_FILE_VIEWER_LOADING_THEME, normalized, i18n);
 };
 export const createFileViewerLoadingStyleVars = (theme) => ({
     '--viewer-accent': theme.accent,
     '--viewer-soft': theme.soft,
 });
-export const createFileViewerLoadingState = (extend = '') => {
-    const theme = resolveFileViewerLoadingTheme(extend);
+export const createFileViewerLoadingState = (extend = '', i18n) => {
+    const theme = resolveFileViewerLoadingTheme(extend, i18n);
     return {
         loading: false,
         error: '',
@@ -412,6 +477,9 @@ export const createFileViewerLoadingControllerActionHandlers = (target, controll
                 extension: nextExtend,
             });
         },
+        setI18n(nextI18n) {
+            return runFileViewerLoadingControllerAction(target, () => controller.setI18n(nextI18n));
+        },
         startLoading(nextMessage) {
             return runFileViewerLoadingControllerAction(target, () => controller.startLoading(nextMessage));
         },
@@ -439,10 +507,13 @@ export const createFileViewerLoadingControllerActionHandlers = (target, controll
  * 统一管理加载、错误、文案和主题色。
  * wrapper 只负责把这个加载状态映射到各自框架的响应式系统。
  */
-export const createFileViewerLoadingController = (extend = '') => {
-    const state = createFileViewerLoadingState(extend);
+export const createFileViewerLoadingController = (extend = '', initialI18n) => {
+    let currentExtend = extend;
+    let currentI18n = initialI18n;
+    const state = createFileViewerLoadingState(extend, initialI18n);
     const updateTheme = (nextExtend) => {
-        state.theme = resolveFileViewerLoadingTheme(nextExtend);
+        currentExtend = nextExtend;
+        state.theme = resolveFileViewerLoadingTheme(nextExtend, currentI18n);
         state.styleVars = createFileViewerLoadingStyleVars(state.theme);
     };
     return {
@@ -451,6 +522,11 @@ export const createFileViewerLoadingController = (extend = '') => {
             updateTheme(nextExtend);
             return cloneFileViewerLoadingState(state);
         },
+        setI18n(nextI18n) {
+            currentI18n = nextI18n;
+            updateTheme(currentExtend);
+            return cloneFileViewerLoadingState(state);
+        },
         startLoading(nextMessage) {
             state.loading = true;
             state.message = nextMessage;

package/dist/viewer/operations.d.ts

@@ -1,4 +1,5 @@
 import type { FileViewerErrorMessageFormatter } from './state';
+import { type FileViewerI18nInput } from '../i18n/messages';
 import type { FileRenderExportAdapter, FileViewerDownloadOptions, FileViewerExportHtmlOptions, FileViewerOperationType, FileViewerPrintOptions, NormalizedFileViewerSource } from '../contracts/types';
 export interface FileViewerOriginalSourceState {
     buffer?: ArrayBuffer | null;
@@ -18,6 +19,7 @@ export interface ResolveFileViewerOperationFilenameInput {
 }
 export interface FileViewerOperationExecutorBase {
     beforeOperation?: (operation: FileViewerOperationType) => boolean | Promise<boolean>;
+    i18n?: FileViewerI18nInput;
 }
 export interface ExecuteFileViewerDownloadOperationInput extends FileViewerOperationExecutorBase, FileViewerDownloadOptions {
     source: FileViewerOriginalSourceState;
@@ -48,11 +50,13 @@ export interface ResolveFileViewerOperationActionErrorMessageInput {
     context: FileViewerOperationActionErrorContext;
     formatErrorMessage: FileViewerOperationActionErrorFormatter;
     prefixes?: FileViewerOperationActionErrorPrefixes;
+    i18n?: FileViewerI18nInput;
 }
 export interface CreateFileViewerOperationActionHandlersInput extends FileViewerOperationExecutorBase {
     getBuffer?: () => ArrayBuffer | null | undefined;
     getFile?: () => File | Blob | null | undefined;
     getUrl?: () => string | null | undefined;
+    getI18n?: () => FileViewerI18nInput;
     getFilename: () => string | null | undefined;
     getMimeType?: () => string | null | undefined;
     getRenderedSource: () => HTMLElement | null | undefined;
@@ -79,10 +83,10 @@ export declare const resolveFileViewerDisplayFilename: (source?: Pick<Normalized
 export declare const createFileViewerOriginalSourceStateFromNormalizedSource: (source?: NormalizedFileViewerSource | null, fallbackFilename?: string) => FileViewerOriginalSourceState;
 export declare const resolveFileViewerOriginalFilename: (source: FileViewerOriginalSourceState, fallback?: string) => string;
 export declare const resolveFileViewerOperationFilename: ({ filename, source, fallback, }: ResolveFileViewerOperationFilenameInput) => string;
-export declare const resolveFileViewerOperationActionErrorMessage: ({ context, formatErrorMessage, prefixes, }: ResolveFileViewerOperationActionErrorMessageInput) => string;
+export declare const resolveFileViewerOperationActionErrorMessage: ({ context, formatErrorMessage, prefixes, i18n, }: ResolveFileViewerOperationActionErrorMessageInput) => string;
 export declare const hasFileViewerOriginalSource: (source: FileViewerOriginalSourceState) => boolean;
-export declare const executeFileViewerDownloadOperation: ({ source, filename, beforeOperation, throwOnMissingSource, }: ExecuteFileViewerDownloadOperationInput) => Promise<boolean>;
-export declare const executeFileViewerExportHtmlOperation: ({ download, filename, beforeOperation, ...input }: ExecuteFileViewerExportHtmlOperationInput) => Promise<string>;
-export declare const executeFileViewerPrintOperation: ({ autoPrint, beforeOperation, openWindow, printAvailable, printWindow, ...input }: ExecuteFileViewerPrintOperationInput) => Promise<boolean>;
-export declare const createFileViewerOperationActionHandlers: ({ getBuffer, getFile, getUrl, getFilename, getMimeType, getRenderedSource, getAdapter, getWatermarkInlineStyle, getPrintAvailable, beforeOperation, errorPrefixes, formatErrorMessage, onError, onErrorMessage, }: CreateFileViewerOperationActionHandlersInput) => FileViewerOperationActionHandlers;
+export declare const executeFileViewerDownloadOperation: ({ source, filename, beforeOperation, i18n, throwOnMissingSource, }: ExecuteFileViewerDownloadOperationInput) => Promise<boolean>;
+export declare const executeFileViewerExportHtmlOperation: ({ download, filename, beforeOperation, i18n, ...input }: ExecuteFileViewerExportHtmlOperationInput) => Promise<string>;
+export declare const executeFileViewerPrintOperation: ({ autoPrint, beforeOperation, i18n, openWindow, printAvailable, printWindow, ...input }: ExecuteFileViewerPrintOperationInput) => Promise<boolean>;
+export declare const createFileViewerOperationActionHandlers: ({ getBuffer, getFile, getUrl, getI18n, getFilename, getMimeType, getRenderedSource, getAdapter, getWatermarkInlineStyle, getPrintAvailable, beforeOperation, i18n, errorPrefixes, formatErrorMessage, onError, onErrorMessage, }: CreateFileViewerOperationActionHandlersInput) => FileViewerOperationActionHandlers;
 export declare const createFileViewerPublicOperationActionHandlers: (input: CreateFileViewerOperationActionHandlersInput) => FileViewerPublicOperationActionHandlers;

package/dist/viewer/operations.js

@@ -1,5 +1,6 @@
 import { buildFileViewerRenderedHtmlDocument, triggerFileViewerBlobDownload, triggerFileViewerUrlDownload, waitForFileViewerPrintWindowReady, } from '../output/export.js';
 import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME } from '../source/index.js';
+import { translateFileViewerMessage, } from '../i18n/messages.js';
 export const DEFAULT_FILE_VIEWER_PREVIEW_TITLE = 'file-viewer-preview';
 export const DEFAULT_FILE_VIEWER_EXPORT_FILENAME = 'preview';
 export const DEFAULT_FILE_VIEWER_DOWNLOAD_FILENAME = DEFAULT_FILE_VIEWER_SOURCE_FILENAME;
@@ -8,6 +9,11 @@ export const FILE_VIEWER_OPERATION_ACTION_ERROR_PREFIXES = {
     print: '打印失败',
     'export-html': '导出 HTML 失败',
 };
+const FILE_VIEWER_OPERATION_ACTION_ERROR_MESSAGE_KEYS = {
+    download: 'error.download',
+    print: 'error.print',
+    'export-html': 'error.exportHtml',
+};
 const getBlobFilename = (file) => {
     return file && 'name' in file && typeof file.name === 'string' ? file.name : '';
 };
@@ -42,9 +48,9 @@ export const resolveFileViewerOriginalFilename = (source, fallback = 'preview')
 export const resolveFileViewerOperationFilename = ({ filename, source, fallback = DEFAULT_FILE_VIEWER_PREVIEW_TITLE, }) => {
     return filename || (source ? resolveFileViewerOriginalFilename(source, '') : '') || fallback;
 };
-export const resolveFileViewerOperationActionErrorMessage = ({ context, formatErrorMessage, prefixes, }) => {
+export const resolveFileViewerOperationActionErrorMessage = ({ context, formatErrorMessage, prefixes, i18n, }) => {
     var _a;
-    return formatErrorMessage((_a = prefixes === null || prefixes === void 0 ? void 0 : prefixes[context.operation]) !== null && _a !== void 0 ? _a : FILE_VIEWER_OPERATION_ACTION_ERROR_PREFIXES[context.operation], context.error);
+    return formatErrorMessage((_a = prefixes === null || prefixes === void 0 ? void 0 : prefixes[context.operation]) !== null && _a !== void 0 ? _a : translateFileViewerMessage(i18n, FILE_VIEWER_OPERATION_ACTION_ERROR_MESSAGE_KEYS[context.operation]), context.error);
 };
 export const hasFileViewerOriginalSource = (source) => {
     return !!source.buffer || !!source.file || !!source.url;
@@ -55,9 +61,9 @@ const runBeforeOperation = async (beforeOperation, operation) => {
     }
     return await beforeOperation(operation);
 };
-const buildRenderedHtmlDocumentFromOperation = async (mode, { source, title, filename, adapter = null, watermarkInlineStyle, }) => {
+const buildRenderedHtmlDocumentFromOperation = async (mode, { source, title, filename, adapter = null, watermarkInlineStyle, i18n, }) => {
     if (!source) {
-        throw new Error('当前没有可导出的预览内容');
+        throw new Error(translateFileViewerMessage(i18n, 'error.noExportContent'));
     }
     return buildFileViewerRenderedHtmlDocument({
         source,
@@ -70,11 +76,11 @@ const buildRenderedHtmlDocumentFromOperation = async (mode, { source, title, fil
         watermarkInlineStyle,
     });
 };
-export const executeFileViewerDownloadOperation = async ({ source, filename, beforeOperation, throwOnMissingSource = true, }) => {
+export const executeFileViewerDownloadOperation = async ({ source, filename, beforeOperation, i18n, throwOnMissingSource = true, }) => {
     var _a;
     if (!hasFileViewerOriginalSource(source)) {
         if (throwOnMissingSource) {
-            throw new Error('当前没有可下载的源文件');
+            throw new Error(translateFileViewerMessage(i18n, 'error.noDownloadSource'));
         }
         return false;
     }
@@ -97,13 +103,14 @@ export const executeFileViewerDownloadOperation = async ({ source, filename, bef
     triggerFileViewerUrlDownload(source.url, resolvedFilename);
     return true;
 };
-export const executeFileViewerExportHtmlOperation = async ({ download = true, filename, beforeOperation, ...input }) => {
+export const executeFileViewerExportHtmlOperation = async ({ download = true, filename, beforeOperation, i18n, ...input }) => {
     if (!await runBeforeOperation(beforeOperation, 'export-html')) {
         return '';
     }
     const html = await buildRenderedHtmlDocumentFromOperation('export', {
         ...input,
         filename,
+        i18n,
     });
     if (download !== false) {
         const baseName = resolveFileViewerOperationFilename({
@@ -114,19 +121,19 @@ export const executeFileViewerExportHtmlOperation = async ({ download = true, fi
     }
     return html;
 };
-export const executeFileViewerPrintOperation = async ({ autoPrint = true, beforeOperation, openWindow, printAvailable = true, printWindow, ...input }) => {
+export const executeFileViewerPrintOperation = async ({ autoPrint = true, beforeOperation, i18n, openWindow, printAvailable = true, printWindow, ...input }) => {
     if (!printAvailable) {
-        throw new Error('当前文件类型不支持完整打印，请下载原文件后在本地应用中打印');
+        throw new Error(translateFileViewerMessage(i18n, 'error.printUnavailable'));
     }
     if (!await runBeforeOperation(beforeOperation, 'print')) {
         return false;
     }
-    const html = await buildRenderedHtmlDocumentFromOperation('print', input);
+    const html = await buildRenderedHtmlDocumentFromOperation('print', { ...input, i18n });
     const targetWindow = printWindow ||
         (openWindow === null || openWindow === void 0 ? void 0 : openWindow()) ||
         (typeof window !== 'undefined' ? window.open('', '_blank') : null);
     if (!targetWindow) {
-        throw new Error('浏览器拦截了打印窗口');
+        throw new Error(translateFileViewerMessage(i18n, 'error.printWindowBlocked'));
     }
     targetWindow.document.open();
     targetWindow.document.write(html);
@@ -138,7 +145,8 @@ export const executeFileViewerPrintOperation = async ({ autoPrint = true, before
     }
     return true;
 };
-const handleFileViewerOperationActionError = (operation, error, { errorPrefixes, formatErrorMessage, onError, onErrorMessage, }) => {
+const handleFileViewerOperationActionError = (operation, error, { errorPrefixes, formatErrorMessage, getI18n, i18n, onError, onErrorMessage, }) => {
+    var _a;
     const context = { operation, error };
     onError === null || onError === void 0 ? void 0 : onError(context);
     if (formatErrorMessage && onErrorMessage) {
@@ -146,10 +154,12 @@ const handleFileViewerOperationActionError = (operation, error, { errorPrefixes,
             context,
             formatErrorMessage,
             prefixes: errorPrefixes,
+            i18n: (_a = getI18n === null || getI18n === void 0 ? void 0 : getI18n()) !== null && _a !== void 0 ? _a : i18n,
         }), context);
     }
 };
-export const createFileViewerOperationActionHandlers = ({ getBuffer, getFile, getUrl, getFilename, getMimeType, getRenderedSource, getAdapter, getWatermarkInlineStyle, getPrintAvailable, beforeOperation, errorPrefixes, formatErrorMessage, onError, onErrorMessage, }) => {
+export const createFileViewerOperationActionHandlers = ({ getBuffer, getFile, getUrl, getI18n, getFilename, getMimeType, getRenderedSource, getAdapter, getWatermarkInlineStyle, getPrintAvailable, beforeOperation, i18n, errorPrefixes, formatErrorMessage, onError, onErrorMessage, }) => {
+    const resolveI18n = () => { var _a; return (_a = getI18n === null || getI18n === void 0 ? void 0 : getI18n()) !== null && _a !== void 0 ? _a : i18n; };
     const getOriginalSource = () => {
         var _a, _b, _c, _d;
         const file = (_a = getFile === null || getFile === void 0 ? void 0 : getFile()) !== null && _a !== void 0 ? _a : null;
@@ -171,6 +181,7 @@ export const createFileViewerOperationActionHandlers = ({ getBuffer, getFile, ge
             filename,
             watermarkInlineStyle: (_b = getWatermarkInlineStyle === null || getWatermarkInlineStyle === void 0 ? void 0 : getWatermarkInlineStyle()) !== null && _b !== void 0 ? _b : undefined,
             beforeOperation,
+            i18n: resolveI18n(),
         };
     };
     return {
@@ -179,6 +190,7 @@ export const createFileViewerOperationActionHandlers = ({ getBuffer, getFile, ge
                 return await executeFileViewerDownloadOperation({
                     source: getOriginalSource(),
                     beforeOperation,
+                    i18n: resolveI18n(),
                     throwOnMissingSource: false,
                 });
             }
@@ -186,6 +198,8 @@ export const createFileViewerOperationActionHandlers = ({ getBuffer, getFile, ge
                 handleFileViewerOperationActionError('download', error, {
                     errorPrefixes,
                     formatErrorMessage,
+                    getI18n,
+                    i18n,
                     onError,
                     onErrorMessage,
                 });
@@ -200,6 +214,8 @@ export const createFileViewerOperationActionHandlers = ({ getBuffer, getFile, ge
                 handleFileViewerOperationActionError('export-html', error, {
                     errorPrefixes,
                     formatErrorMessage,
+                    getI18n,
+                    i18n,
                     onError,
                     onErrorMessage,
                 });
@@ -218,6 +234,8 @@ export const createFileViewerOperationActionHandlers = ({ getBuffer, getFile, ge
                 handleFileViewerOperationActionError('print', error, {
                     errorPrefixes,
                     formatErrorMessage,
+                    getI18n,
+                    i18n,
                     onError,
                     onErrorMessage,
                 });

package/dist/viewer/state.d.ts

@@ -1,16 +1,33 @@
-import type { FileViewerStateDescriptor, FileViewerStateTheme } from '../contracts/types';
+import { type FileViewerI18nInput } from '../i18n/messages';
+import type { FileViewerRendererCategory, FileViewerStateDescriptor, FileViewerStateTheme } from '../contracts/types';
 export type FileViewerErrorMessageFormatter = (prefix: string, error: unknown) => string;
 export declare const FILE_VIEWER_PREVIEW_MESSAGES: Readonly<{
     downloading: "正在下载文件资源...";
     streamingPdf: "正在建立 PDF 流式预览...";
     reading: "正在解析文件内容...";
 }>;
+export declare const resolveFileViewerPreviewMessages: (i18n?: FileViewerI18nInput) => Readonly<{
+    downloading: string;
+    streamingPdf: string;
+    reading: string;
+}>;
 export declare const DEFAULT_FILE_VIEWER_STATE_THEME: FileViewerStateTheme;
 export declare const DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRIPTION = "\u652F\u6301 Office\u3001PDF\u3001OFD\u3001Typst\u3001\u538B\u7F29\u5305\u3001\u90AE\u4EF6\u3001OLB/DRA\u3001CAD\u3001\u5730\u7406\u6570\u636E\u30013D \u6A21\u578B\u3001Excalidraw\u3001draw.io\u3001EPUB\u3001UMD\u3001Markdown\u3001\u4EE3\u7801/\u6587\u672C\u3001\u56FE\u7247\u3001\u97F3\u89C6\u9891\u3001\u5B57\u4F53\u548C\u6570\u636E\u8D44\u4EA7\u7684\u5728\u7EBF\u9884\u89C8";
-export declare const createFileViewerPreviewLoadingState: (extension?: string, message?: "正在解析文件内容...", theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
-export declare const createFileViewerReadyState: (extension?: string, theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
-export declare const createFileViewerEmptyState: (extension?: string, theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
-export declare const createFileViewerUnsupportedState: (extension?: string, theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
+export interface FileViewerRendererInstallHint {
+    extension: string;
+    rendererId: string;
+    rendererLabel: string;
+    rendererCategory: FileViewerRendererCategory;
+    rendererPackage?: string;
+    presetPackage: string;
+    vitePreset: string;
+    presetLabel: string;
+}
+export declare const resolveFileViewerRendererInstallHint: (extension?: string) => FileViewerRendererInstallHint | null;
+export declare const createFileViewerPreviewLoadingState: (extension?: string, message?: string, theme?: FileViewerStateTheme, i18n?: FileViewerI18nInput) => FileViewerStateDescriptor;
+export declare const createFileViewerReadyState: (extension?: string, theme?: FileViewerStateTheme, i18n?: FileViewerI18nInput) => FileViewerStateDescriptor;
+export declare const createFileViewerEmptyState: (extension?: string, theme?: FileViewerStateTheme, i18n?: FileViewerI18nInput) => FileViewerStateDescriptor;
+export declare const createFileViewerUnsupportedState: (extension?: string, theme?: FileViewerStateTheme, i18n?: FileViewerI18nInput) => FileViewerStateDescriptor;
 export declare const normalizeFileViewerErrorMessage: (error: unknown) => string;
 export declare const formatFileViewerErrorMessage: FileViewerErrorMessageFormatter;
-export declare const createFileViewerErrorState: (extension?: string, error?: unknown, theme?: FileViewerStateTheme) => FileViewerStateDescriptor;
+export declare const createFileViewerErrorState: (extension?: string, error?: unknown, theme?: FileViewerStateTheme, i18n?: FileViewerI18nInput) => FileViewerStateDescriptor;