@file-viewer/vite-plugin 3.0.2 → 3.1.0

package/README.en.md

@@ -147,6 +147,13 @@ This is useful when upload accept lists, sample matrices, or attachment allow-li
 
 When a file extension is in the supported matrix but the current project has not assembled its renderer, core now shows an install-oriented “renderer assembly required” state with the recommended preset / renderer package. For example, `.pdf` points to `@file-viewer/preset-office` or `@file-viewer/renderer-pdf`. Only truly unknown extensions show an unsupported-format state.
 
+## Nested Vite Projects
+
+From 3.0.3, a nested metadata-only project can use a resolvable Full dependency
+declared in an ancestor `package.json`. A nearer light component or preset keeps
+its own root asset layout. Explicit `copyAssets.baseDir` still takes precedence;
+`publicDir` and `build.outDir` stay relative to the Vite root, not the dependency owner.
+
 ## Current Boundary
 
 The plugin currently generates imports for extracted renderer packages: Word, Spreadsheet, PDF, OFD, Presentation, CAD, Draw.io/Excalidraw/Mermaid/PlantUML, 3D, Data, EDA, Typst, archives, email, EPUB, code/Markdown/Patch/Git Bundle, image, media, XMind, and Geo. Declare them explicitly with `formats`, or let `scan: true` discover source hints automatically; core-supported extensions such as `.zipx`, `.cbz`, `.tiff`, `.mjs`, `.gv`, `.patch`, `.bundle`, `.mermaid`, `.puml`, and `.mpeg` also resolve to their renderer packages. With `copyAssets:true`, the plugin detects installed capability packages. Full packages copy matching assets into dev `publicDir/file-viewer/` and production `outDir/file-viewer/`; standard packages/presets keep the existing root placement, including the Typst compiler / renderer WASM files and default fonts. `preset: 'auto' | 'lite' | 'office' | 'engineering' | 'all'` imports matching `@file-viewer/preset-*` packages; when `formats` are also present, the plugin adds extra renderers outside the preset.

package/README.md

@@ -147,6 +147,13 @@ export const fileViewerFormats = ['pdf', 'docx', 'xlsx']
 
 如果用户打开的是支持矩阵内的格式，但项目没有安装或装配对应 renderer，core 会显示“需要装配预览能力”，并提示推荐安装的 preset / renderer 包，例如 `.pdf` 会引导安装 `@file-viewer/preset-office` 或 `@file-viewer/renderer-pdf`。只有真正不在支持矩阵中的扩展名才显示“不支持在线预览”。
 
+## 嵌套 Vite 项目
+
+从 3.0.3 起，子目录只有项目元数据或 Vite 插件声明时，会沿祖先 `package.json`
+查找实际可解析的 Full 依赖。子项目明确声明轻量组件或 preset 时保留其根目录资产布局，
+不会继承父项目的 Full 布局。`copyAssets.baseDir` 仍具有最高优先级；`publicDir`
+和 `build.outDir` 均相对于 Vite root，不相对于依赖所在目录。
+
 ## 当前边界
 
 当前插件会为已经拆出的 renderer 包生成导入：Word、Spreadsheet、PDF、OFD、Presentation、CAD、Draw.io/Excalidraw/Mermaid/PlantUML、3D、Data、EDA、Typst、压缩包、邮件、EPUB、代码/Markdown/Patch/Git Bundle、图片、媒体、XMind 和 Geo。可以通过 `formats` 显式声明，也可以通过 `scan: true` 从源码 hint 自动发现；`.zipx`、`.cbz`、`.tiff`、`.mjs`、`.gv`、`.patch`、`.bundle`、`.mermaid`、`.puml`、`.mpeg` 等 core 支持的扩展也会映射到对应 renderer。开启 `copyAssets:true` 时会识别已安装能力；full 包把匹配资源复制到开发 `publicDir/file-viewer/` 与构建 `outDir/file-viewer/`，标准包/preset 维持根目录行为，包括 Typst compiler / renderer WASM 与默认字体目录。`preset: 'auto' | 'lite' | 'office' | 'engineering' | 'all'` 会导入对应 `@file-viewer/preset-*` 包；如果同时声明 `formats`，插件会在 preset 之外补充额外 renderer。

package/dist/index.js

@@ -465,6 +465,15 @@ const rendererModules = [
         rendererIds: ['data-asset'],
         chunkName: 'file-viewer-data'
     },
+    {
+        id: 'binary',
+        packageName: '@file-viewer/renderer-binary',
+        exportName: 'binaryRenderer',
+        formats: ['binary', 'binary-inspector', 'bin', 'hex', 'elf', 'exe', 'dll', 'class', 'macho'],
+        rendererIds: ['binary-inspector'],
+        chunkName: 'file-viewer-binary',
+        includeInPresetAll: false
+    },
     {
         id: 'eda',
         packageName: '@file-viewer/renderer-eda',
@@ -1483,6 +1492,21 @@ async function copyPdfCjkFontAssets(from, to) {
     await copyFile(license, join(to, 'OFL-1.1.txt'));
     return true;
 }
+function hasPdfCjkFontAssets(root, stylesheet, license) {
+    if (!root) {
+        return false;
+    }
+    const files = join(root, 'files');
+    try {
+        return (existsSync(join(root, stylesheet)) &&
+            existsSync(join(root, license)) &&
+            statSync(files).isDirectory() &&
+            readdirSync(files, { withFileTypes: true }).some((entry) => entry.isFile() && entry.name.endsWith('.woff2')));
+    }
+    catch {
+        return false;
+    }
+}
 async function copyKnownRendererAssets(targetRoot, rendererIds) {
     const selected = new Set(rendererIds);
     const results = [];
@@ -1551,25 +1575,24 @@ async function copyKnownRendererAssets(targetRoot, rendererIds) {
         '@file-viewer/renderer-pdf'
     ]);
     const pdfCjkFontTarget = join(targetRoot, 'vendor/pdf/fonts');
-    // The standard profile pack owns the CJK fallback font; presets that activate the pdf
-    // renderer without that pack declare the font package directly. renderer-pdf must not
-    // vendor a second copy, so when no source is installed the build warns instead of
-    // failing and PDF rendering keeps using embedded fonts.
-    const pdfCjkFontSourceAvailable = Boolean(standardPdfCjkFontRoot && existsSync(join(standardPdfCjkFontRoot, 'noto-sans-sc.css'))) ||
-        Boolean(stagedPdfCjkFontRoot && existsSync(join(stagedPdfCjkFontRoot, 'wght.css'))) ||
-        Boolean(dependencyPdfCjkFontRoot);
+    // The PDF renderer owns the runtime font dependency so direct renderer installs retain
+    // CJK fallback support. The standard profile pack is only a pre-staged copy source.
+    // A missing source means an incomplete install and must not silently drop the fallback.
+    const hasStandardPdfCjkFont = hasPdfCjkFontAssets(standardPdfCjkFontRoot, 'noto-sans-sc.css', 'OFL-1.1.txt');
+    const hasStagedPdfCjkFont = hasPdfCjkFontAssets(stagedPdfCjkFontRoot, 'wght.css', 'LICENSE');
+    const hasDependencyPdfCjkFont = hasPdfCjkFontAssets(dependencyPdfCjkFontRoot, 'wght.css', 'LICENSE');
+    const pdfCjkFontSourceAvailable = hasStandardPdfCjkFont || hasStagedPdfCjkFont || hasDependencyPdfCjkFont;
     await push('pdf', 'pdf-cjk-font-fallback', pdfCjkFontTarget, async () => {
-        if (standardPdfCjkFontRoot &&
-            existsSync(join(standardPdfCjkFontRoot, 'noto-sans-sc.css'))) {
+        if (hasStandardPdfCjkFont && standardPdfCjkFontRoot) {
             return copyDirectoryIfPresent(standardPdfCjkFontRoot, pdfCjkFontTarget);
         }
-        if (stagedPdfCjkFontRoot && existsSync(join(stagedPdfCjkFontRoot, 'wght.css'))) {
+        if (hasStagedPdfCjkFont && stagedPdfCjkFontRoot) {
             return copyPdfCjkFontAssets(stagedPdfCjkFontRoot, pdfCjkFontTarget);
         }
         return copyPdfCjkFontAssets(dependencyPdfCjkFontRoot, pdfCjkFontTarget);
     }, pdfCjkFontSourceAvailable
         ? undefined
-        : `install ${independentlyOwnedAssetRendererIds.get('pdf')} or @fontsource-variable/noto-sans-sc`, undefined, pdfCjkFontSourceAvailable ? undefined : false);
+        : `repair @file-viewer/renderer-pdf and its @fontsource-variable/noto-sans-sc dependency`, undefined, true);
     const pptxRoot = resolvePackageRoot('@file-viewer/pptx', [
         '@file-viewer/renderer-pptx',
         '@file-viewer/renderer-presentation'
@@ -2066,25 +2089,37 @@ function findNearestProjectPackageJson(projectRoot) {
     }
 }
 function resolveInstalledFullPackages(projectRoot) {
-    const packageJsonPath = findNearestProjectPackageJson(projectRoot);
-    if (!packageJsonPath) {
-        return [];
-    }
+    let packageJsonPath = findNearestProjectPackageJson(projectRoot);
+    const lightPackages = fileViewerFullPackages.map(packageName => packageName.replace(/-full$/, ''));
+    const projectPackageRequire = createRequire(join(resolve(projectRoot), 'package.json'));
     try {
-        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-        const declaredPackages = new Set([
-            ...Object.keys(packageJson.dependencies || {}),
-            ...Object.keys(packageJson.devDependencies || {}),
-            ...Object.keys(packageJson.optionalDependencies || {}),
-            ...Object.keys(packageJson.peerDependencies || {})
-        ]);
-        const projectPackageRequire = createRequire(packageJsonPath);
-        return fileViewerFullPackages.filter((packageName) => declaredPackages.has(packageName) &&
-            Boolean(tryResolvePackageJson(packageName, projectPackageRequire)));
+        while (packageJsonPath) {
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+            const declaredPackages = new Set([
+                ...Object.keys(packageJson.dependencies || {}),
+                ...Object.keys(packageJson.devDependencies || {}),
+                ...Object.keys(packageJson.optionalDependencies || {}),
+                ...Object.keys(packageJson.peerDependencies || {})
+            ]);
+            const declaresRuntime = [...declaredPackages].some(packageName => fileViewerFullPackages.some(fullPackage => fullPackage === packageName) ||
+                lightPackages.includes(packageName) ||
+                packageName.startsWith('@file-viewer/preset-') ||
+                packageName.startsWith('@file-viewer/renderer-'));
+            if (declaresRuntime) {
+                return fileViewerFullPackages.filter(packageName => declaredPackages.has(packageName) &&
+                    Boolean(tryResolvePackageJson(packageName, projectPackageRequire)));
+            }
+            // Vite roots can contain a metadata-only package.json while runtime
+            // dependencies live in an ancestor. A nearer light runtime is a boundary.
+            const directory = dirname(packageJsonPath);
+            const parent = dirname(directory);
+            packageJsonPath = parent === directory ? null : findNearestProjectPackageJson(parent);
+        }
     }
     catch {
         return [];
     }
+    return [];
 }
 function resolveInstalledAssetPackages(projectRoot) {
     const packageJsonPath = findNearestProjectPackageJson(projectRoot);
@@ -2341,7 +2376,7 @@ export function fileViewerRenderers(options = {}) {
             const projectRoot = resolve(process.cwd(), userConfig.root || '.');
             refreshSelection(projectRoot);
             refreshFullAssetRuntime(projectRoot, userConfig.base);
-            const dependencyAnchorPackages = collectDependencyAnchorPackages(selection, autoPresetIds);
+            const dependencyAnchorPackages = collectDependencyAnchorPackages(selection, installedFullPackages.length ? unique([...autoPresetIds, 'all']) : autoPresetIds);
             const resolvedDependencyAnchorPackages = runtimeAssetBase
                 ? unique([
                     ...dependencyAnchorPackages,
@@ -2525,7 +2560,7 @@ export function fileViewerRenderers(options = {}) {
             return [];
         },
         async closeBundle() {
-            if (!options.copyAssets || copyOptions(options.copyAssets).mode === 'dev') {
+            if (resolvedConfig?.command === 'serve' || !options.copyAssets || copyOptions(options.copyAssets).mode === 'dev') {
                 return;
             }
             const copyTarget = resolveFileViewerCopyAssetsTarget('build', options.copyAssets, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/vite-plugin",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "private": false,
   "type": "module",
   "description": "Vite plugin for File Viewer on-demand renderer assembly, chunk planning, and offline asset deployment.",
@@ -63,7 +63,7 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.5.0",
     "typescript": "^6.0.3",
     "vite": "^8.2.2"
   },
@@ -71,6 +71,8 @@
   "scripts": {
     "build": "tsc -b tsconfig.json",
     "type-check": "tsc -b tsconfig.json",
-    "verify:github-242": "node scripts/verify-github-242.mjs"
+    "verify:github-242": "pnpm build && node scripts/verify-github-242.mjs && node scripts/verify-github-242-copy.mjs",
+    "verify:github-257": "pnpm build && node scripts/verify-github-257.mjs",
+    "verify:github-257-browser": "npm exec --yes --package playwright@1.61.1 -- node scripts/verify-github-257-browser.mjs"
   }
 }