@file-viewer/core 2.1.2 → 2.1.3

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,3 +1,4 @@
+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<{
@@ -5,6 +6,11 @@ export declare const FILE_VIEWER_PREVIEW_MESSAGES: Readonly<{
     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 interface FileViewerRendererInstallHint {
@@ -18,10 +24,10 @@ export interface FileViewerRendererInstallHint {
     presetLabel: string;
 }
 export declare const resolveFileViewerRendererInstallHint: (extension?: string) => FileViewerRendererInstallHint | null;
-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 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;

package/dist/viewer/state.js

@@ -1,10 +1,16 @@
 import { normalizeFileExtension } from '../source/index.js';
 import { DEFAULT_RENDERER_DEFINITIONS } from '../registry/formats.js';
+import { resolveFileViewerLocale, translateFileViewerMessage, } from '../i18n/messages.js';
 export const FILE_VIEWER_PREVIEW_MESSAGES = Object.freeze({
     downloading: '正在下载文件资源...',
     streamingPdf: '正在建立 PDF 流式预览...',
     reading: '正在解析文件内容...',
 });
+export const resolveFileViewerPreviewMessages = (i18n) => Object.freeze({
+    downloading: translateFileViewerMessage(i18n, 'preview.downloading'),
+    streamingPdf: translateFileViewerMessage(i18n, 'preview.streamingPdf'),
+    reading: translateFileViewerMessage(i18n, 'preview.reading'),
+});
 export const DEFAULT_FILE_VIEWER_STATE_THEME = Object.freeze({
     accent: '#5f6f82',
     soft: 'rgba(95, 111, 130, 0.12)',
@@ -125,44 +131,56 @@ const createFileViewerStateDescriptor = ({ state, extension = '', title, message
     theme,
     recoverable,
 });
-export const createFileViewerPreviewLoadingState = (extension = '', message = FILE_VIEWER_PREVIEW_MESSAGES.reading, theme = DEFAULT_FILE_VIEWER_STATE_THEME) => createFileViewerStateDescriptor({
+export const createFileViewerPreviewLoadingState = (extension = '', message, theme = DEFAULT_FILE_VIEWER_STATE_THEME, i18n) => createFileViewerStateDescriptor({
     state: 'loading',
     extension,
     title: theme.label,
-    message,
+    message: message || translateFileViewerMessage(i18n, 'preview.reading'),
     description: theme.hint,
     theme,
     recoverable: false,
 });
-export const createFileViewerReadyState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME) => createFileViewerStateDescriptor({
+export const createFileViewerReadyState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME, i18n) => createFileViewerStateDescriptor({
     state: 'ready',
     extension,
-    title: '预览完成',
-    message: '文件内容已完成渲染。',
+    title: translateFileViewerMessage(i18n, 'state.ready.title'),
+    message: translateFileViewerMessage(i18n, 'state.ready.message'),
     theme,
     recoverable: false,
 });
-export const createFileViewerEmptyState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME) => createFileViewerStateDescriptor({
+export const createFileViewerEmptyState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME, i18n) => createFileViewerStateDescriptor({
     state: 'empty',
     extension,
-    title: '暂无文件',
-    message: '请选择文件或提供可访问的文件地址后开始预览。',
+    title: translateFileViewerMessage(i18n, 'state.empty.title'),
+    message: translateFileViewerMessage(i18n, 'state.empty.message'),
     theme,
     recoverable: true,
 });
-export const createFileViewerUnsupportedState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME) => {
+export const createFileViewerUnsupportedState = (extension = '', theme = DEFAULT_FILE_VIEWER_STATE_THEME, i18n) => {
     const label = extensionLabel(extension);
     const installHint = resolveFileViewerRendererInstallHint(extension);
     if (installHint) {
-        const rendererTip = installHint.rendererPackage
-            ? `；如果需要极致裁剪，也可以只安装 ${installHint.rendererPackage}`
+        const locale = resolveFileViewerLocale(i18n);
+        const localeRendererTip = installHint.rendererPackage
+            ? locale === 'zh-CN'
+                ? `；如果需要极致裁剪，也可以只安装 ${installHint.rendererPackage}`
+                : `; for a strict custom cut, install only ${installHint.rendererPackage}`
             : '';
         return createFileViewerStateDescriptor({
             state: 'unsupported',
             extension,
-            title: '需要装配预览能力',
-            message: `${label} 格式已在支持矩阵中，但当前项目尚未装配 ${installHint.rendererLabel} renderer。`,
-            description: `推荐安装 ${installHint.presetPackage} 并启用 @file-viewer/vite-plugin（preset: '${installHint.vitePreset}' 或 preset: 'auto'）${rendererTip}，也可以通过 options.renderers 手动传入对应 renderer。`,
+            title: translateFileViewerMessage(i18n, 'state.unsupported.install.title'),
+            message: translateFileViewerMessage(i18n, 'state.unsupported.install.message', {
+                extension: label,
+                rendererLabel: installHint.rendererLabel,
+            }),
+            description: translateFileViewerMessage(i18n, 'state.unsupported.install.description', {
+                extension: label,
+                rendererLabel: installHint.rendererLabel,
+                presetPackage: installHint.presetPackage,
+                vitePreset: installHint.vitePreset,
+                rendererTip: localeRendererTip,
+            }),
             theme,
             recoverable: true,
         });
@@ -170,9 +188,11 @@ export const createFileViewerUnsupportedState = (extension = '', theme = DEFAULT
     return createFileViewerStateDescriptor({
         state: 'unsupported',
         extension,
-        title: '暂不支持在线预览',
-        message: `不支持${label}格式的在线预览，请下载后预览或转换为支持的格式。`,
-        description: DEFAULT_FILE_VIEWER_UNSUPPORTED_DESCRIPTION,
+        title: translateFileViewerMessage(i18n, 'state.unsupported.title'),
+        message: translateFileViewerMessage(i18n, 'state.unsupported.message', {
+            extension: label,
+        }),
+        description: translateFileViewerMessage(i18n, 'state.unsupported.description'),
         theme,
         recoverable: true,
     });
@@ -186,10 +206,10 @@ export const normalizeFileViewerErrorMessage = (error) => {
 export const formatFileViewerErrorMessage = (prefix, error) => {
     return `${prefix}：${normalizeFileViewerErrorMessage(error)}`;
 };
-export const createFileViewerErrorState = (extension = '', error = '未知错误', theme = DEFAULT_FILE_VIEWER_STATE_THEME) => createFileViewerStateDescriptor({
+export const createFileViewerErrorState = (extension = '', error = '未知错误', theme = DEFAULT_FILE_VIEWER_STATE_THEME, i18n) => createFileViewerStateDescriptor({
     state: 'error',
     extension,
-    title: '预览失败',
+    title: translateFileViewerMessage(i18n, 'state.error.title'),
     message: normalizeFileViewerErrorMessage(error),
     theme,
     recoverable: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/core",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "private": false,
   "type": "module",
   "description": "Framework-neutral modular TypeScript core for Flyfish File Viewer renderer orchestration, lifecycle APIs, search, zoom, print, and export",