@file-viewer/core 2.1.1 → 2.1.3

package/dist/viewer/state.js

@@ -1,9 +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)',
@@ -16,6 +23,105 @@ const extensionLabel = (extension) => {
     const normalized = normalizeFileExtension(extension);
     return normalized ? `.${normalized}` : '当前';
 };
+const rendererPackageById = {
+    'office-word-openxml': '@file-viewer/renderer-word',
+    'office-word-binary': '@file-viewer/renderer-word',
+    'office-presentation': '@file-viewer/renderer-presentation',
+    'open-document': '@file-viewer/renderer-word',
+    'spreadsheet-openxml': '@file-viewer/renderer-spreadsheet',
+    pdf: '@file-viewer/renderer-pdf',
+    ofd: '@file-viewer/renderer-ofd',
+    typst: '@file-viewer/renderer-typst',
+    archive: '@file-viewer/renderer-archive',
+    email: '@file-viewer/renderer-email',
+    eda: '@file-viewer/renderer-eda',
+    cad: '@file-viewer/renderer-cad',
+    model: '@file-viewer/renderer-3d',
+    geo: '@file-viewer/renderer-geo',
+    drawing: '@file-viewer/renderer-drawing',
+    mindmap: '@file-viewer/renderer-mindmap',
+    epub: '@file-viewer/renderer-epub',
+    umd: '@file-viewer/renderer-epub',
+    image: '@file-viewer/renderer-image',
+    markdown: '@file-viewer/renderer-text',
+    code: '@file-viewer/renderer-text',
+    video: '@file-viewer/renderer-media',
+    audio: '@file-viewer/renderer-media',
+    'data-asset': '@file-viewer/renderer-data',
+};
+const officeRendererIds = new Set([
+    'office-word-openxml',
+    'office-word-binary',
+    'office-presentation',
+    'open-document',
+    'spreadsheet-openxml',
+    'pdf',
+    'ofd',
+]);
+const liteRendererIds = new Set([
+    'image',
+    'markdown',
+    'code',
+    'video',
+    'audio',
+]);
+const engineeringRendererIds = new Set([
+    'typst',
+    'archive',
+    'eda',
+    'cad',
+    'model',
+    'geo',
+    'drawing',
+    'mindmap',
+    'data-asset',
+]);
+const resolvePresetHint = (definition) => {
+    if (officeRendererIds.has(definition.id)) {
+        return {
+            packageName: '@file-viewer/preset-office',
+            vitePreset: 'office',
+            label: 'Office preset',
+        };
+    }
+    if (engineeringRendererIds.has(definition.id)) {
+        return {
+            packageName: '@file-viewer/preset-engineering',
+            vitePreset: 'engineering',
+            label: 'Engineering preset',
+        };
+    }
+    if (liteRendererIds.has(definition.id)) {
+        return {
+            packageName: '@file-viewer/preset-lite',
+            vitePreset: 'lite',
+            label: 'Lite preset',
+        };
+    }
+    return {
+        packageName: '@file-viewer/preset-all',
+        vitePreset: 'all',
+        label: 'Full preset',
+    };
+};
+export const resolveFileViewerRendererInstallHint = (extension = '') => {
+    const normalized = normalizeFileExtension(extension);
+    const definition = DEFAULT_RENDERER_DEFINITIONS.find(item => item.extensions.map(normalizeFileExtension).includes(normalized));
+    if (!definition) {
+        return null;
+    }
+    const preset = resolvePresetHint(definition);
+    return {
+        extension: normalized,
+        rendererId: definition.id,
+        rendererLabel: definition.label,
+        rendererCategory: definition.category,
+        rendererPackage: rendererPackageById[definition.id],
+        presetPackage: preset.packageName,
+        vitePreset: preset.vitePreset,
+        presetLabel: preset.label,
+    };
+};
 const createFileViewerStateDescriptor = ({ state, extension = '', title, message, description, theme = DEFAULT_FILE_VIEWER_STATE_THEME, recoverable, }) => ({
     state,
     extension: normalizeFileExtension(extension),
@@ -25,39 +131,68 @@ 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 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: 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,
+        });
+    }
     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,
     });
@@ -71,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.1",
+  "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",