@file-viewer/renderer-archive 2.1.1 → 2.1.3

package/dist/archive.js

@@ -1,6 +1,6 @@
 import { resolveFileViewerArchiveWasmUrl, resolveFileViewerArchiveWorkerUrl, } from '@file-viewer/core/assets';
-import { disposeFileViewerRendered, } from '@file-viewer/core';
-import { createArchiveCacheKey, flattenArchiveObject, formatArchiveBytes, getArchiveEntryExtension, } from './archiveShared.js';
+import { createFileViewerTranslator, disposeFileViewerRendered, } from '@file-viewer/core';
+import { buildArchiveNestedRenderContext, createArchiveCacheKey, flattenArchiveObject, formatArchiveBytes, getArchiveEntryExtension, } from './archiveShared.js';
 import { readArchiveCache, writeArchiveCache } from './archiveCache.js';
 import { loadArchiveEntriesWithoutWorker } from './archiveFallback.js';
 const DEFAULT_MAX_ARCHIVE_SIZE = 320 * 1024 * 1024;
@@ -98,7 +98,7 @@ const getWorkerConstructor = (documentRef) => {
     const WorkerCtor = ((_a = documentRef.defaultView) === null || _a === void 0 ? void 0 : _a.Worker) ||
         (typeof Worker !== 'undefined' ? Worker : undefined);
     if (!WorkerCtor) {
-        throw new Error('当前浏览器不支持 Web Worker');
+        throw new Error('Web Worker is not supported by this browser.');
     }
     return WorkerCtor;
 };
@@ -157,7 +157,7 @@ const prepareWorkerUrl = async (candidate, objectUrls) => {
     }
     const response = await fetch(candidate.workerUrl, { cache: 'no-cache' });
     if (!response.ok) {
-        throw new Error(`无法读取 libarchive Worker: ${response.status}`);
+        throw new Error(`Unable to read libarchive Worker: ${response.status}`);
     }
     const source = await response.text();
     const workerUrl = URL.createObjectURL(new Blob([
@@ -174,7 +174,7 @@ const resolveWorkerCandidates = async (documentRef, options) => {
         : undefined;
     if (options === null || options === void 0 ? void 0 : options.workerUrl) {
         candidates.push({
-            label: '自定义 libarchive Worker',
+            label: 'custom libarchive Worker',
             workerUrl: resolveFileViewerArchiveWorkerUrl(options, baseUrl),
             wasmUrl,
         });
@@ -183,22 +183,19 @@ const resolveWorkerCandidates = async (documentRef, options) => {
     const publicWorkerUrl = resolveFileViewerArchiveWorkerUrl(undefined, baseUrl);
     if (await probeWorkerUrl(publicWorkerUrl)) {
         candidates.push({
-            label: '静态 libarchive Worker',
+            label: 'static libarchive Worker',
             workerUrl: publicWorkerUrl,
             wasmUrl,
         });
     }
     return candidates;
 };
-const buildNestedOptions = (context, archiveOptions) => ({
-    ...((context === null || context === void 0 ? void 0 : context.options) || {}),
-    archive: archiveOptions,
-});
 const renderNestedWithCoreFallback = async (buffer, type, target, context) => {
+    const t = createFileViewerTranslator(context === null || context === void 0 ? void 0 : context.options);
     const { fileViewerCoreRendererDispatcher } = await import('@file-viewer/core');
     const handler = fileViewerCoreRendererDispatcher.resolve(type);
     if (!handler) {
-        target.textContent = `不支持.${type}格式的在线预览，请下载后预览或转换为支持的格式`;
+        target.textContent = t('archive.error.nestedUnsupported', { type });
         return undefined;
     }
     return handler(buffer, target, type, {
@@ -223,8 +220,9 @@ export default async function renderArchive(buffer, target, _type, context) {
     let selectedEntry = null;
     let nestedRendered;
     let loading = false;
-    let loadingText = '正在读取压缩包目录...';
-    let loadingHint = '大文件会在 Worker 中解析，避免阻塞主线程。';
+    const t = createFileViewerTranslator(context === null || context === void 0 ? void 0 : context.options);
+    let loadingText = t('archive.loading.readingDirectory');
+    let loadingHint = t('archive.loading.readingDirectoryHint');
     let errorText = '';
     let archiveNotice = '';
     let encrypted = null;
@@ -241,15 +239,15 @@ export default async function renderArchive(buffer, target, _type, context) {
     const info = createElement(documentRef, 'div', 'archive-info');
     const search = createElement(documentRef, 'input', 'archive-search');
     search.type = 'search';
-    search.placeholder = '筛选压缩包内文件';
+    search.placeholder = t('archive.search.placeholder');
     const list = createElement(documentRef, 'div', 'archive-list');
     list.setAttribute('role', 'list');
     sidebar.append(head, warning, info, search, list);
     const preview = createElement(documentRef, 'main', 'archive-preview');
     const toolbar = createElement(documentRef, 'div', 'archive-preview-toolbar');
     const toolbarTitle = createElement(documentRef, 'div');
-    toolbarTitle.append(createElement(documentRef, 'span', undefined, '压缩包内预览'), createElement(documentRef, 'strong', undefined, '请选择一个文件'));
-    const downloadButton = createElement(documentRef, 'button', undefined, '下载文件');
+    toolbarTitle.append(createElement(documentRef, 'span', undefined, t('archive.preview.title')), createElement(documentRef, 'strong', undefined, t('archive.preview.chooseFile')));
+    const downloadButton = createElement(documentRef, 'button', undefined, t('archive.preview.downloadFile'));
     downloadButton.type = 'button';
     toolbar.append(toolbarTitle, downloadButton);
     const nestedTarget = createElement(documentRef, 'div', 'archive-nested-target');
@@ -266,7 +264,7 @@ export default async function renderArchive(buffer, target, _type, context) {
     state.append(stateContent);
     root.append(state);
     const error = createElement(documentRef, 'div', 'archive-error');
-    const errorTitle = createElement(documentRef, 'strong', undefined, '压缩包预览提示');
+    const errorTitle = createElement(documentRef, 'strong', undefined, t('archive.error.title'));
     const errorMessage = createElement(documentRef, 'p');
     error.append(errorTitle, errorMessage);
     root.append(error);
@@ -303,8 +301,12 @@ export default async function renderArchive(buffer, target, _type, context) {
     };
     const syncState = () => {
         const archiveStats = getArchiveStats();
-        stats.textContent = `${archiveStats.count} 个文件 · ${formatArchiveBytes(archiveStats.totalSize)} · ${archiveStats.previewableCount} 个可直接预览`;
-        warning.textContent = '检测到加密内容，当前在线预览不接收密码，建议下载后本地解压。';
+        stats.textContent = t('archive.stats.summary', {
+            count: archiveStats.count,
+            size: formatArchiveBytes(archiveStats.totalSize),
+            previewable: archiveStats.previewableCount,
+        });
+        warning.textContent = t('archive.warning.encrypted');
         warning.classList.toggle('archive-hidden', !encrypted);
         info.textContent = archiveNotice;
         info.classList.toggle('archive-hidden', !archiveNotice);
@@ -316,7 +318,7 @@ export default async function renderArchive(buffer, target, _type, context) {
         downloadButton.hidden = !selectedEntry;
         const activeTitle = toolbarTitle.querySelector('strong');
         if (activeTitle) {
-            activeTitle.textContent = (selectedEntry === null || selectedEntry === void 0 ? void 0 : selectedEntry.name) || '请选择一个文件';
+            activeTitle.textContent = (selectedEntry === null || selectedEntry === void 0 ? void 0 : selectedEntry.name) || t('archive.preview.chooseFile');
         }
     };
     const renderEmptyState = () => {
@@ -324,7 +326,7 @@ export default async function renderArchive(buffer, target, _type, context) {
             return;
         }
         const empty = createElement(documentRef, 'div', 'archive-empty');
-        empty.append(createElement(documentRef, 'strong', undefined, '选择左侧文件即可预览'), createElement(documentRef, 'p', undefined, '压缩包只读取目录；文件内容会在点击后按需解压，并在体积允许时缓存到 IndexedDB。'));
+        empty.append(createElement(documentRef, 'strong', undefined, t('archive.empty.title')), createElement(documentRef, 'p', undefined, t('archive.empty.message')));
         nestedTarget.replaceChildren(empty);
     };
     const renderEntryList = () => {
@@ -375,13 +377,13 @@ export default async function renderArchive(buffer, target, _type, context) {
                     return worker;
                 },
             });
-            setLoading(true, `正在初始化${candidate.label}...`, '如果当前服务器没有正确发布 Worker/WASM，会自动切换兼容模式。');
+            setLoading(true, t('archive.loading.initializingCandidate', { label: candidate.label }), t('archive.loading.initializingCandidateHint'));
             const archiveFile = createArchiveFile(documentRef, buffer, filename);
-            const archive = await withTimeout(Archive.open(archiveFile), workerTimeoutMs, `${candidate.label} 初始化超时`, targetWindow);
+            const archive = await withTimeout(Archive.open(archiveFile), workerTimeoutMs, t('archive.error.candidateInitTimeout', { label: candidate.label }), targetWindow);
             archiveReader = archive;
-            encrypted = await withTimeout(archive.hasEncryptedData(), workerTimeoutMs, `${candidate.label} 加密检测超时`, targetWindow).catch(() => null);
-            setLoading(true, '正在读取压缩包目录...', '目录读取完成后，点击内部文件才会按需解压。');
-            const fileTree = await withTimeout(archive.getFilesObject(), workerTimeoutMs, `${candidate.label} 读取目录超时`, targetWindow);
+            encrypted = await withTimeout(archive.hasEncryptedData(), workerTimeoutMs, t('archive.error.encryptedCheckTimeout', { label: candidate.label }), targetWindow).catch(() => null);
+            setLoading(true, t('archive.loading.readingDirectory'), t('archive.loading.directoryReadyHint'));
+            const fileTree = await withTimeout(archive.getFilesObject(), workerTimeoutMs, t('archive.error.candidateReadTimeout', { label: candidate.label }), targetWindow);
             entries = flattenArchiveObject(fileTree)
                 .sort((left, right) => left.path.localeCompare(right.path));
             syncState();
@@ -397,14 +399,14 @@ export default async function renderArchive(buffer, target, _type, context) {
         }
     };
     const tryOpenArchiveWithFallback = async () => {
-        setLoading(true, 'Worker 不可用，正在切换 ZIP/TAR 兼容模式...', '兼容模式无需额外静态 Worker，适合手机 WebView 或本地临时服务器。');
+        setLoading(true, t('archive.loading.workerFallback'), t('archive.loading.workerFallbackHint'));
         const fallbackEntries = await loadArchiveEntriesWithoutWorker(buffer, filename);
         if (!fallbackEntries) {
             return false;
         }
         entries = fallbackEntries.sort((left, right) => left.path.localeCompare(right.path));
         encrypted = null;
-        archiveNotice = '当前环境的 libarchive Worker 未能启动，已自动切换到 ZIP/TAR/GZIP 兼容模式。RAR、7z 等格式仍建议发布 vendor/libarchive/worker-bundle.js 与 libarchive.wasm。';
+        archiveNotice = t('archive.notice.workerFallback');
         syncState();
         renderEntryList();
         renderEmptyState();
@@ -412,10 +414,13 @@ export default async function renderArchive(buffer, target, _type, context) {
     };
     const openArchive = async () => {
         if (buffer.byteLength > maxArchiveSize) {
-            setError(`压缩包体积 ${formatArchiveBytes(buffer.byteLength)} 超过安全上限 ${formatArchiveBytes(maxArchiveSize)}，请下载后在本地解压。`);
+            setError(t('archive.error.tooLarge', {
+                size: formatArchiveBytes(buffer.byteLength),
+                limit: formatArchiveBytes(maxArchiveSize),
+            }));
             return;
         }
-        setLoading(true, '正在初始化压缩包解析 Worker...', '大文件会在 Worker 中解析，避免阻塞主线程。');
+        setLoading(true, t('archive.loading.initializingWorker'), t('archive.loading.initializingWorkerHint'));
         setError('');
         archiveNotice = '';
         try {
@@ -438,7 +443,7 @@ export default async function renderArchive(buffer, target, _type, context) {
             if (await tryOpenArchiveWithFallback()) {
                 return;
             }
-            throw new Error(errors.join('；') || '压缩包 Worker 初始化失败');
+            throw new Error(errors.join('; ') || t('archive.error.workerInitFailed'));
         }
         catch (nextError) {
             console.error(nextError);
@@ -452,11 +457,7 @@ export default async function renderArchive(buffer, target, _type, context) {
         await clearNestedPreview();
         const child = createElement(documentRef, 'div', 'archive-nested-content');
         nestedTarget.append(child);
-        const nestedContext = {
-            ...context,
-            filename: entry.name,
-            options: buildNestedOptions(context, archiveOptions),
-        };
+        const nestedContext = buildArchiveNestedRenderContext(context, entry, archiveOptions);
         nestedRendered = (context === null || context === void 0 ? void 0 : context.renderNestedBuffer)
             ? await context.renderNestedBuffer(entryBuffer, entry.extension, child, nestedContext)
             : await renderNestedWithCoreFallback(entryBuffer, entry.extension, child, nestedContext);
@@ -487,14 +488,18 @@ export default async function renderArchive(buffer, target, _type, context) {
         renderEntryList();
         syncState();
         if (entry.size > maxEntryPreviewSize) {
-            setError(`压缩包内文件 ${entry.name} 体积 ${formatArchiveBytes(entry.size)} 超过预览上限 ${formatArchiveBytes(maxEntryPreviewSize)}。`);
+            setError(t('archive.error.entryTooLarge', {
+                name: entry.name,
+                size: formatArchiveBytes(entry.size),
+                limit: formatArchiveBytes(maxEntryPreviewSize),
+            }));
             return;
         }
-        setLoading(true, `正在按需解压 ${entry.name}...`);
+        setLoading(true, t('archive.loading.extracting', { name: entry.name }));
         setError('');
         try {
             const entryBuffer = await extractEntryBuffer(entry);
-            setLoading(true, `正在渲染 ${entry.name}...`);
+            setLoading(true, t('archive.loading.rendering', { name: entry.name }));
             await renderEntryBuffer(entry, entryBuffer);
         }
         catch (nextError) {
@@ -506,7 +511,7 @@ export default async function renderArchive(buffer, target, _type, context) {
         }
     }
     const downloadEntry = async (entry) => {
-        setLoading(true, `正在导出 ${entry.name}...`);
+        setLoading(true, t('archive.loading.exporting', { name: entry.name }));
         try {
             const entryBuffer = await extractEntryBuffer(entry);
             const url = URL.createObjectURL(new Blob([entryBuffer]));

package/dist/archiveShared.d.ts

@@ -1,3 +1,4 @@
+import type { FileRenderContext, FileViewerArchiveOptions } from '@file-viewer/core';
 export declare const ARCHIVE_PREVIEWABLE_EXTENSIONS: readonly string[];
 export interface ArchiveEntryView {
     id: string;
@@ -22,3 +23,4 @@ export declare const isPreviewableArchiveEntry: (name: string) => boolean;
 export declare const formatArchiveBytes: (value: number) => string;
 export declare const flattenArchiveObject: (input: Record<string, unknown>, prefix?: string) => ArchiveEntryView[];
 export declare const createArchiveCacheKey: (archiveName: string, archiveSize: number, entry: ArchiveEntryView) => string;
+export declare const buildArchiveNestedRenderContext: (context: FileRenderContext | undefined, entry: Pick<ArchiveEntryView, "name">, archiveOptions: FileViewerArchiveOptions | undefined) => FileRenderContext;

package/dist/archiveShared.js

@@ -85,3 +85,17 @@ export const createArchiveCacheKey = (archiveName, archiveSize, entry) => {
         entry.lastModified || 0,
     ].join(':');
 };
+const buildNestedOptions = (context, archiveOptions) => ({
+    ...((context === null || context === void 0 ? void 0 : context.options) || {}),
+    archive: archiveOptions,
+});
+export const buildArchiveNestedRenderContext = (context, entry, archiveOptions) => ({
+    ...context,
+    filename: entry.name,
+    // Archive children are rendered from the extracted bytes. Never inherit
+    // the parent archive URL, otherwise streaming renderers such as PDF.js
+    // would try to parse the .zip/.rar source as the nested file.
+    url: undefined,
+    streamUrl: undefined,
+    options: buildNestedOptions(context, archiveOptions),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/renderer-archive",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "private": false,
   "type": "module",
   "description": "Standalone archive renderer plugin for Flyfish File Viewer with libarchive worker, ZIP/TAR fallback, IndexedDB cache, and nested previews.",
@@ -56,7 +56,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@file-viewer/core": "^2.1.1",
+    "@file-viewer/core": "^2.1.3",
     "jszip": "^3.10.1",
     "libarchive.js": "^2.0.2"
   },