@file-viewer/renderer-epub 2.1.1 → 2.1.3

package/dist/epub.d.ts

@@ -1,2 +1,2 @@
-import type { FileViewerRenderedInstance } from '@file-viewer/core';
-export default function renderEpub(buffer: ArrayBuffer, target: HTMLDivElement): Promise<FileViewerRenderedInstance>;
+import { type FileRenderContext, type FileViewerRenderedInstance } from '@file-viewer/core';
+export default function renderEpub(buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext): Promise<FileViewerRenderedInstance>;

package/dist/epub.js

@@ -1,3 +1,4 @@
+import { createFileViewerTranslator, } from '@file-viewer/core';
 const epubStyle = `
 .epub-viewer{width:100%;height:100%;display:flex;flex-direction:column;overflow:hidden;background:#eef1f4;color:#172033;box-sizing:border-box}
 .epub-viewer *{box-sizing:border-box}
@@ -60,15 +61,15 @@ const normalizeLabel = (value, fallback) => {
     }
     return fallback;
 };
-const flattenToc = (items, depth = 0) => {
+const flattenToc = (items, fallbackLabel, depth = 0) => {
     if (!Array.isArray(items)) {
         return [];
     }
     return items.flatMap((item, index) => {
         const node = item;
         const href = typeof node.href === 'string' ? node.href : '';
-        const label = normalizeLabel(node.label || node.title, `章节 ${index + 1}`);
-        const subitems = flattenToc(node.subitems || node.children, depth + 1);
+        const label = normalizeLabel(node.label || node.title, fallbackLabel(index + 1));
+        const subitems = flattenToc(node.subitems || node.children, fallbackLabel, depth + 1);
         if (!href) {
             return subitems;
         }
@@ -96,13 +97,14 @@ const pickInitialHref = (items) => {
     });
     return (readable === null || readable === void 0 ? void 0 : readable.href) || ((_a = items[0]) === null || _a === void 0 ? void 0 : _a.href);
 };
-export default async function renderEpub(buffer, target) {
+export default async function renderEpub(buffer, target, context) {
+    const t = createFileViewerTranslator(context === null || context === void 0 ? void 0 : context.options);
     let book;
     let rendition;
     let disposed = false;
     let tocOpen = true;
     let status = 'loading';
-    let title = 'EPUB 电子书';
+    let title = t('epub.title');
     let author = '';
     let tocItems = [];
     let currentHref = '';
@@ -115,16 +117,16 @@ export default async function renderEpub(buffer, target) {
     const toolbar = createElement('div', 'epub-toolbar');
     const tocButton = createElement('button', 'epub-icon-button');
     tocButton.type = 'button';
-    tocButton.title = '目录';
+    tocButton.title = t('ebook.toc');
     tocButton.append(createElement('span'));
     const titleRoot = createElement('div', 'epub-title');
     const titleText = createElement('strong', undefined, title);
-    const subtitleText = createElement('span', undefined, '阅读中');
+    const subtitleText = createElement('span', undefined, t('ebook.reading'));
     titleRoot.append(titleText, subtitleText);
     const actions = createElement('div', 'epub-actions');
-    const prevButton = createElement('button', 'epub-button', '上一页');
-    const progressText = createElement('span', 'epub-progress', '阅读中');
-    const nextButton = createElement('button', 'epub-button', '下一页');
+    const prevButton = createElement('button', 'epub-button', t('epub.previousPage'));
+    const progressText = createElement('span', 'epub-progress', t('ebook.reading'));
+    const nextButton = createElement('button', 'epub-button', t('epub.nextPage'));
     prevButton.type = 'button';
     nextButton.type = 'button';
     actions.append(prevButton, progressText, nextButton);
@@ -132,13 +134,13 @@ export default async function renderEpub(buffer, target) {
     const body = createElement('div', 'epub-body');
     const toc = createElement('aside', 'epub-toc');
     const tocHead = createElement('div', 'epub-toc-head');
-    const tocCount = createElement('span', undefined, '0 项');
-    tocHead.append(createElement('strong', undefined, '目录'), tocCount);
+    const tocCount = createElement('span', undefined, t('ebook.itemCount', { count: 0 }));
+    tocHead.append(createElement('strong', undefined, t('ebook.toc')), tocCount);
     const tocList = createElement('div', 'epub-toc-list');
     toc.append(tocHead, tocList);
     const stageWrap = createElement('main', 'epub-stage-wrap');
     const stage = createElement('div', 'epub-stage');
-    const state = createElement('div', 'epub-state', '正在解析 EPUB...');
+    const state = createElement('div', 'epub-state', t('epub.loading'));
     stageWrap.append(stage, state);
     body.append(toc, stageWrap);
     root.append(toolbar, body);
@@ -162,7 +164,7 @@ export default async function renderEpub(buffer, target) {
         if (typeof progress === 'number') {
             return `${progress}%`;
         }
-        return currentChapter() || '阅读中';
+        return currentChapter() || t('ebook.reading');
     };
     const syncUi = () => {
         root.classList.toggle('epub-viewer--toc-hidden', !tocOpen);
@@ -175,7 +177,7 @@ export default async function renderEpub(buffer, target) {
         nextButton.disabled = status !== 'ready' || atEnd;
         state.hidden = status === 'ready';
         state.classList.toggle('error', status === 'error');
-        tocCount.textContent = `${tocItems.length} 项`;
+        tocCount.textContent = t('ebook.itemCount', { count: tocItems.length });
         Array.from(tocList.querySelectorAll('.epub-toc-item')).forEach(button => {
             button.classList.toggle('active', button.dataset.href === currentHref);
         });
@@ -238,7 +240,7 @@ export default async function renderEpub(buffer, target) {
     };
     const openBook = async () => {
         status = 'loading';
-        state.textContent = '正在解析 EPUB...';
+        state.textContent = t('epub.loading');
         syncUi();
         try {
             const { default: ePub } = await import('epubjs');
@@ -279,11 +281,11 @@ export default async function renderEpub(buffer, target) {
             title = normalizeLabel(metadata === null || metadata === void 0 ? void 0 : metadata.title, title);
             author = normalizeLabel(metadata === null || metadata === void 0 ? void 0 : metadata.creator, '');
             const navigation = await book.loaded.navigation.catch(() => undefined);
-            tocItems = flattenToc(navigation === null || navigation === void 0 ? void 0 : navigation.toc);
+            tocItems = flattenToc(navigation === null || navigation === void 0 ? void 0 : navigation.toc, index => t('epub.chapterFallback', { index }));
             renderToc();
             await rendition.display(pickInitialHref(tocItems));
             if (!await waitForReadableFrame()) {
-                throw new Error('EPUB 正文渲染未完成，请刷新后重试');
+                throw new Error(t('epub.renderIncomplete'));
             }
             if (disposed) {
                 return;

package/dist/index.js

@@ -6,8 +6,8 @@ if (!epubDefinition || !umdDefinition) {
 }
 export const ebookRendererDefinition = epubDefinition;
 export const umdRendererDefinition = umdDefinition;
-export const renderFileViewerEpub = (buffer, target) => import('./epub.js').then(({ default: renderEpub }) => renderEpub(buffer, target));
-export const renderFileViewerUmd = (buffer, target) => import('./umd.js').then(({ default: renderUmd }) => renderUmd(buffer, target));
+export const renderFileViewerEpub = (buffer, target, _type, context) => import('./epub.js').then(({ default: renderEpub }) => renderEpub(buffer, target, context));
+export const renderFileViewerUmd = (buffer, target, _type, context) => import('./umd.js').then(({ default: renderUmd }) => renderUmd(buffer, target, context));
 export const ebookRenderer = {
     id: 'file-viewer-renderer-epub',
     label: 'Flyfish File Viewer ebook renderer',

package/dist/umd.d.ts

@@ -1,2 +1,2 @@
-import type { FileViewerRenderedInstance } from '@file-viewer/core';
-export default function renderUmd(buffer: ArrayBuffer, target: HTMLDivElement): Promise<FileViewerRenderedInstance>;
+import type { FileRenderContext, FileViewerRenderedInstance } from '@file-viewer/core';
+export default function renderUmd(buffer: ArrayBuffer, target: HTMLDivElement, context?: FileRenderContext): Promise<FileViewerRenderedInstance>;

package/dist/umd.js

@@ -1,3 +1,4 @@
+import { createFileViewerTranslator } from '@file-viewer/core';
 import { parseUmdBook, } from './umd/parser';
 const umdStyle = `
 .umd-viewer{width:100%;height:100%;display:flex;flex-direction:column;overflow:hidden;background:#eef1f4;color:#172033;box-sizing:border-box}
@@ -58,22 +59,55 @@ const createButton = (label, className) => {
     button.textContent = label;
     return button;
 };
-const buildMetaLine = (book, chapter) => {
+const buildMetaLine = (book, readingText, chapter) => {
     if (!book) {
-        return (chapter === null || chapter === void 0 ? void 0 : chapter.title) || '阅读中';
+        return (chapter === null || chapter === void 0 ? void 0 : chapter.title) || readingText;
     }
     return [
         book.author,
         book.category,
         book.publishedAt,
-    ].filter(Boolean).join(' / ') || (chapter === null || chapter === void 0 ? void 0 : chapter.title) || '阅读中';
+    ].filter(Boolean).join(' / ') || (chapter === null || chapter === void 0 ? void 0 : chapter.title) || readingText;
+};
+const createUmdTextLocalizer = (t) => {
+    const localize = (value) => {
+        if (value === 'UMD 电子书') {
+            return t('umd.title');
+        }
+        const chapterMatch = /^章节\s+(\d+)$/.exec(value);
+        if (chapterMatch) {
+            return t('umd.chapterFallback', { index: chapterMatch[1] });
+        }
+        const galleryMatch = /^图集\s+(\d+)$/.exec(value);
+        if (galleryMatch) {
+            return t('umd.galleryFallback', { index: galleryMatch[1] });
+        }
+        if (value === 'UMD 正文长度小于声明长度，文件可能不完整') {
+            return t('umd.warningBodyTooShort');
+        }
+        if (value === 'UMD 文件结构不完整，读取时遇到意外结尾') {
+            return t('umd.error.unexpectedEnd');
+        }
+        if (value === '不是有效的 UMD 电子书文件') {
+            return t('umd.error.invalidFile');
+        }
+        return value;
+    };
+    return {
+        localize,
+        localizeJoinedWarnings(warnings) {
+            return warnings.filter(Boolean).map(localize).join('；');
+        },
+    };
 };
 const copyImageBytes = (image) => {
     const copy = new Uint8Array(image.bytes.byteLength);
     copy.set(image.bytes);
     return copy;
 };
-export default async function renderUmd(buffer, target) {
+export default async function renderUmd(buffer, target, context) {
+    const t = createFileViewerTranslator(context === null || context === void 0 ? void 0 : context.options);
+    const { localize, localizeJoinedWarnings } = createUmdTextLocalizer(t);
     const objectUrls = new Map();
     let book = null;
     let activeIndex = 0;
@@ -87,19 +121,19 @@ export default async function renderUmd(buffer, target) {
     const tocButton = document.createElement('button');
     tocButton.type = 'button';
     tocButton.className = 'umd-icon-button active';
-    tocButton.title = '目录';
+    tocButton.title = t('ebook.toc');
     tocButton.appendChild(document.createElement('span'));
     const title = document.createElement('div');
     title.className = 'umd-title';
-    const titleText = appendText(title, 'strong', 'UMD 电子书');
-    const metaText = appendText(title, 'span', '阅读中');
+    const titleText = appendText(title, 'strong', t('umd.title'));
+    const metaText = appendText(title, 'span', t('ebook.reading'));
     const actions = document.createElement('div');
     actions.className = 'umd-actions';
-    const prevButton = createButton('上一章', 'umd-button');
+    const prevButton = createButton(t('umd.previousChapter'), 'umd-button');
     const progress = document.createElement('span');
     progress.className = 'umd-progress';
     progress.textContent = '0/0';
-    const nextButton = createButton('下一章', 'umd-button');
+    const nextButton = createButton(t('umd.nextChapter'), 'umd-button');
     actions.append(prevButton, progress, nextButton);
     toolbar.append(tocButton, title, actions);
     const body = document.createElement('div');
@@ -108,8 +142,8 @@ export default async function renderUmd(buffer, target) {
     toc.className = 'umd-toc';
     const tocHead = document.createElement('div');
     tocHead.className = 'umd-toc-head';
-    appendText(tocHead, 'strong', '目录');
-    const tocCount = appendText(tocHead, 'span', '0 项');
+    appendText(tocHead, 'strong', t('ebook.toc'));
+    const tocCount = appendText(tocHead, 'span', t('ebook.itemCount', { count: 0 }));
     const tocList = document.createElement('div');
     tocList.className = 'umd-toc-list';
     toc.append(tocHead, tocList);
@@ -119,7 +153,7 @@ export default async function renderUmd(buffer, target) {
     stage.className = 'umd-stage';
     const state = document.createElement('div');
     state.className = 'umd-state';
-    state.textContent = '正在解析 UMD...';
+    state.textContent = t('umd.loading');
     stageWrap.append(stage, state);
     body.append(toc, stageWrap);
     root.append(toolbar, body);
@@ -144,14 +178,14 @@ export default async function renderUmd(buffer, target) {
     const updateChrome = () => {
         const chapter = getCurrentChapter();
         const total = (book === null || book === void 0 ? void 0 : book.chapters.length) || 0;
-        titleText.textContent = (book === null || book === void 0 ? void 0 : book.title) || 'UMD 电子书';
-        metaText.textContent = buildMetaLine(book, chapter);
+        titleText.textContent = (book === null || book === void 0 ? void 0 : book.title) ? localize(book.title) : t('umd.title');
+        metaText.textContent = localize(buildMetaLine(book, t('ebook.reading'), chapter));
         progress.textContent = total ? `${activeIndex + 1}/${total}` : '0/0';
         prevButton.disabled = !book || activeIndex <= 0;
         nextButton.disabled = !book || !total || activeIndex >= total - 1;
         tocButton.classList.toggle('active', tocOpen);
         root.classList.toggle('umd-viewer--toc-hidden', !tocOpen);
-        tocCount.textContent = `${total} 项`;
+        tocCount.textContent = t('ebook.itemCount', { count: total });
     };
     const scrollToTop = () => {
         stage.scrollTo({ top: 0 });
@@ -159,7 +193,7 @@ export default async function renderUmd(buffer, target) {
     const renderToc = () => {
         tocList.replaceChildren();
         book === null || book === void 0 ? void 0 : book.chapters.forEach((chapter, index) => {
-            const item = createButton(chapter.title, 'umd-toc-item');
+            const item = createButton(localize(chapter.title), 'umd-toc-item');
             item.classList.toggle('active', index === activeIndex);
             item.addEventListener('click', () => {
                 activeIndex = index;
@@ -175,7 +209,7 @@ export default async function renderUmd(buffer, target) {
             return;
         }
         const coverUrl = getImageUrl(book.cover);
-        const metaLine = buildMetaLine(book);
+        const metaLine = buildMetaLine(book, t('ebook.reading'));
         if (!coverUrl && !metaLine) {
             return;
         }
@@ -184,11 +218,11 @@ export default async function renderUmd(buffer, target) {
         if (coverUrl) {
             const image = document.createElement('img');
             image.src = coverUrl;
-            image.alt = book.title;
+            image.alt = localize(book.title);
             head.appendChild(image);
         }
         const info = document.createElement('div');
-        appendText(info, 'h1', book.title);
+        appendText(info, 'h1', localize(book.title));
         if (metaLine) {
             appendText(info, 'p', metaLine);
         }
@@ -203,7 +237,7 @@ export default async function renderUmd(buffer, target) {
         const section = document.createElement('section');
         section.className = 'umd-chapter';
         section.dataset.viewerAnchorId = chapter.id;
-        appendText(section, 'h2', chapter.title);
+        appendText(section, 'h2', localize(chapter.title));
         if (chapter.images.length) {
             const images = document.createElement('div');
             images.className = 'umd-image-list';
@@ -211,7 +245,7 @@ export default async function renderUmd(buffer, target) {
                 const figure = document.createElement('figure');
                 const img = document.createElement('img');
                 img.src = getImageUrl(image);
-                img.alt = chapter.title;
+                img.alt = localize(chapter.title);
                 figure.appendChild(img);
                 images.appendChild(figure);
             });
@@ -221,7 +255,7 @@ export default async function renderUmd(buffer, target) {
             appendText(section, 'div', chapter.content, 'umd-text');
         }
         else if (!chapter.images.length) {
-            appendText(section, 'div', '未解析到正文内容', 'umd-empty');
+            appendText(section, 'div', t('umd.emptyContent'), 'umd-empty');
         }
         return section;
     };
@@ -235,7 +269,7 @@ export default async function renderUmd(buffer, target) {
         if (chapter) {
             stage.appendChild(renderChapter(chapter));
         }
-        const warningText = (book === null || book === void 0 ? void 0 : book.warnings.filter(Boolean).join('；')) || '';
+        const warningText = book ? localizeJoinedWarnings(book.warnings) : '';
         if (warningText) {
             appendText(stage, 'div', warningText, 'umd-warning');
         }
@@ -280,7 +314,7 @@ export default async function renderUmd(buffer, target) {
     catch (error) {
         if (!disposed) {
             console.error(error);
-            renderError(error instanceof Error ? error.message : String(error));
+            renderError(error instanceof Error ? localize(error.message) : String(error));
         }
     }
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/renderer-epub",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "private": false,
   "type": "module",
   "description": "Standalone EPUB and UMD reader renderer plugin for Flyfish File Viewer powered by epubjs and pako.",
@@ -53,7 +53,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@file-viewer/core": "^2.1.1",
+    "@file-viewer/core": "^2.1.3",
     "epubjs": "^0.3.93",
     "pako": "^2.1.0"
   },