@file-viewer/vite-plugin 2.1.29 → 2.2.0

package/README.en.md

@@ -1,13 +1,13 @@
 # @file-viewer/vite-plugin
 
-Vite plugin for Flyfish File Viewer on-demand renderer assembly. It can auto-discover installed `@file-viewer/preset-*` packages and inject them into the page, so Vue, React, Svelte, jQuery, and Vanilla JS components receive matching preview capability without application code passing `renderers` manually. It can also generate `virtual:file-viewer-renderers` from declared formats, import only matching renderer packages, and provide renderer-oriented chunk planning plus offline worker/WASM/font asset copying.
+Vite plugin for Flyfish File Viewer on-demand renderer assembly. It can auto-discover installed `@file-viewer/preset-*` and `@file-viewer/*-full` packages, so Vue, React, Svelte, jQuery, and Vanilla JS components receive matching preview capability without application code passing `renderers` manually. It can also generate `virtual:file-viewer-renderers` from declared formats, import only matching renderer packages, and provide renderer-oriented chunk planning plus offline worker/WASM/font asset copying.
 
 ## Fastest Start
 
-The fastest path is a standard component package, one preset, and one Vite plugin registration. The plugin auto-discovers installed `@file-viewer/preset-*` packages, so application code does not hand-write renderer imports and the plugin does not need `preset:'office'`. Installing the npm package alone does not make Vite run the plugin; register it once in `vite.config.ts`:
+For complete format support, the fastest path is one full package and one Vite plugin registration. Full packages already include `preset-all`; do not install another preset. `copyAssets:true` matches the installed full package and publishes its Worker, WASM, font, and vendor files under `file-viewer/` at the deployment base (`/file-viewer/` for a root deployment) in both dev and build:
 
 ```bash
-pnpm add @file-viewer/vue3 @file-viewer/preset-office
+pnpm add @file-viewer/vue3-full
 pnpm add -D @file-viewer/vite-plugin
 ```
 
@@ -24,15 +24,17 @@ export default defineConfig({
 })
 ```
 
-Components keep `autoRenderers:true` by default, so `@file-viewer/vue3`, `@file-viewer/react`, `@file-viewer/web`, `@file-viewer/svelte`, `@file-viewer/jquery`, `@file-viewer/vue2.7`, and `@file-viewer/vue2.6` automatically consume the injected preset / renderer registry.
+Installing a full package without publishing these assets leaves PDF Worker, CAD/Typst/Archive WASM, and other formats without runtime files. That is partial support, not a complete setup.
 
-Heavy users that want the fastest full-capability setup can install the full preset and keep the same Vite config:
+For a smaller install, use a standard component with one preset and keep the same Vite config. The plugin auto-discovers installed presets, so application code does not hand-write renderer imports and the plugin does not need `preset:'office'`:
 
 ```bash
-pnpm add @file-viewer/vue3 @file-viewer/preset-all
+pnpm add @file-viewer/vue3 @file-viewer/preset-office
 pnpm add -D @file-viewer/vite-plugin
 ```
 
+Components keep `autoRenderers:true` by default, so `@file-viewer/vue3`, `@file-viewer/react`, `@file-viewer/web`, `@file-viewer/svelte`, `@file-viewer/jquery`, `@file-viewer/vue2.7`, and `@file-viewer/vue2.6` automatically consume the injected preset / renderer registry.
+
 Available presets:
 
 - `@file-viewer/preset-lite`: text, Markdown, code, image, audio, and video.
@@ -44,7 +46,7 @@ Install individual renderer packages only for strict cuts, such as `@file-viewer
 
 ## vite.config.ts
 
-Prefer preset auto assembly for normal products. With no explicit `preset` option, or only `copyAssets:true`, the plugin auto-discovers installed `@file-viewer/preset-*` packages:
+Prefer full/preset auto assembly for normal products. With only `copyAssets:true`, the plugin auto-discovers installed `@file-viewer/*-full` or `@file-viewer/preset-*` packages:
 
 ```ts
 fileViewerRenderers({
@@ -83,7 +85,7 @@ const options = {
 
 | Option | Description |
 | --- | --- |
-| `copyAssets` | `true` or `{ publicDir, outDir, mode }`; copies matched renderer Worker, WASM, font, and vendor assets |
+| `copyAssets` | `true` or `{ publicDir, outDir, mode, baseDir }`; copies matching Worker, WASM, font, and vendor assets. Installed full packages default to `<deployment-base>/file-viewer/`, which is required for complete full support; standard packages/presets keep the existing root behavior |
 | `preset` | `'auto' | 'lite' | 'office' | 'engineering' | 'all'`; with no explicit formats, installed presets are discovered automatically |
 | `autoPresets` | `true` or a preset list; useful with `scan:true` when installed presets should stay active |
 | `formats` | File extensions or format tokens, for example `['pdf', 'docx', 'dwg']` |
@@ -96,6 +98,8 @@ const options = {
 
 When host apps split `node_modules` by package name, circular dependencies between `@codemirror/*`, `@lezer/*`, and Sandpack can show up in production as `codemirror-view.* Cannot access ... before initialization`. The plugin wraps existing `manualChunks` functions by default, stabilizes only those known interop chunks, and preserves the rest of the app's custom grouping. Set `stabilizeInteropChunks:false` only when the host build needs total control.
 
+`copyAssets.baseDir` overrides automatic placement. It must be relative and cannot contain `..`; an empty string explicitly selects the root. The plugin now aligns the shared runtime asset base for standard packages, presets, and full packages; full packages also keep `setDefaultFullAssetBaseUrl()` synchronized. Only integrations that set `inject:false` and do not import the virtual module must call `setDefaultFileViewerAssetBaseUrl()` themselves (plus `setDefaultFullAssetBaseUrl()` for a full package). With Vite `base:'/app/'`, full-package dev URLs start with `/app/file-viewer/...`, while production files remain under `outDir/file-viewer/`.
+
 For strict registry control, disable injection and pass the virtual module explicitly:
 
 ```ts
@@ -145,7 +149,7 @@ When a file extension is in the supported matrix but the current project has not
 
 ## 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 also copies the Typst compiler / renderer WASM files and the `wasm/typst/fonts/` default-font directory. `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.
+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.
 
 ## Documentation
 

package/README.md

@@ -1,13 +1,13 @@
 # @file-viewer/vite-plugin
 
-Flyfish File Viewer 的 Vite 按需 renderer 自动装配插件。它可以自动发现已安装的 `@file-viewer/preset-*` 包并注入到页面，让 Vue、React、Svelte、jQuery 和 Vanilla JS 组件无需手动传 `renderers` 就获得对应预览能力；也可以根据业务声明的文件格式生成 `virtual:file-viewer-renderers`，只 import 命中的 renderer 包，并提供 chunk 分组和离线 worker/WASM/字体资源复制能力。
+Flyfish File Viewer 的 Vite 按需 renderer 自动装配插件。它可以自动发现已安装的 `@file-viewer/preset-*` 和 `@file-viewer/*-full` 包，让 Vue、React、Svelte、jQuery 和 Vanilla JS 组件无需手动传 `renderers` 就获得对应预览能力；也可以根据业务声明的文件格式生成 `virtual:file-viewer-renderers`，只 import 命中的 renderer 包，并提供 chunk 分组和离线 worker/WASM/字体资源复制能力。
 
 ## 最快开始
 
-最快接入路径是“标准组件包 + 一个 preset + 注册一次 Vite 插件”。插件会自动发现当前项目已安装的 `@file-viewer/preset-*`，无需手写 renderer import，也无需给插件显式写 `preset:'office'`。注意：只安装 npm 包不会让 Vite 自动运行插件，仍需要在 `vite.config.ts` 中注册一次：
+需要完整格式支持时，最快路径是“full 包 + 注册一次 Vite 插件”。full 已内置 `preset-all`，不要再安装 preset；`copyAssets:true` 会在开发和构建时自动匹配 full 包，并把 Worker、WASM、字体和 vendor 文件发布到部署基址下的 `file-viewer/`（根部署即 `/file-viewer/`）：
 
 ```bash
-pnpm add @file-viewer/vue3 @file-viewer/preset-office
+pnpm add @file-viewer/vue3-full
 pnpm add -D @file-viewer/vite-plugin
 ```
 
@@ -24,15 +24,17 @@ export default defineConfig({
 })
 ```
 
-组件默认 `autoRenderers:true`，会读取 Vite 插件注入的 preset / renderer registry。常规业务代码只要使用 `@file-viewer/vue3`、`@file-viewer/react`、`@file-viewer/web`、`@file-viewer/svelte`、`@file-viewer/jquery`、`@file-viewer/vue2.7` 或 `@file-viewer/vue2.6` 即可获得对应能力。
+只安装 full 包而不启用资源复制，PDF Worker、CAD/Typst/Archive WASM 等格式会缺少运行文件，只能获得部分格式支持。
 
-重度用户需要最快拥有全部预览能力时，直接安装全量 preset，Vite 配置保持不变：
+需要更小体积时，改用“标准组件包 + 一个 preset”，Vite 配置保持不变。插件会自动发现已安装的 preset，无需手写 renderer import，也无需显式写 `preset:'office'`：
 
 ```bash
-pnpm add @file-viewer/vue3 @file-viewer/preset-all
+pnpm add @file-viewer/vue3 @file-viewer/preset-office
 pnpm add -D @file-viewer/vite-plugin
 ```
 
+组件默认 `autoRenderers:true`，会读取 Vite 插件注入的 preset / renderer registry。常规业务代码只要使用 `@file-viewer/vue3`、`@file-viewer/react`、`@file-viewer/web`、`@file-viewer/svelte`、`@file-viewer/jquery`、`@file-viewer/vue2.7` 或 `@file-viewer/vue2.6` 即可获得对应能力。
+
 可选 preset：
 
 - `@file-viewer/preset-lite`: 文本、Markdown、代码、图片、音频、视频。
@@ -44,7 +46,7 @@ pnpm add -D @file-viewer/vite-plugin
 
 ## vite.config.ts
 
-推荐默认使用 preset 自动装配。无参或只传 `copyAssets:true` 时，插件会自动发现已安装的 `@file-viewer/preset-*`，无需写 `preset:'office'`：
+推荐默认使用 full/preset 自动装配。只传 `copyAssets:true` 时，插件会自动发现已安装的 `@file-viewer/*-full` 或 `@file-viewer/preset-*`，无需写 `preset:'all'`：
 
 ```ts
 fileViewerRenderers({
@@ -83,7 +85,7 @@ const options = {
 
 | 选项 | 说明 |
 | --- | --- |
-| `copyAssets` | `true` 或 `{ publicDir, outDir, mode }`，复制匹配 renderer 的 Worker、WASM、字体和 vendor 资源 |
+| `copyAssets` | `true` 或 `{ publicDir, outDir, mode, baseDir }`；复制匹配的 Worker、WASM、字体和 vendor 资源。检测到 full 时默认发布到 `<部署基址>/file-viewer/`，这是 full 完整格式支持的必需项；标准包/preset 保持原有根目录行为 |
 | `preset` | `'auto' | 'lite' | 'office' | 'engineering' | 'all'`；默认无显式格式时自动发现已安装 preset |
 | `autoPresets` | `true` 或 preset 列表；常用于 `scan:true` 时继续自动激活已安装 preset |
 | `formats` | 文件扩展名或格式 token，例如 `['pdf', 'docx', 'dwg']` |
@@ -96,6 +98,8 @@ const options = {
 
 如果宿主项目按包名拆分 `node_modules`，`@codemirror/*`、`@lezer/*` 和 Sandpack 之间的循环依赖可能在生产构建中表现为 `codemirror-view.* Cannot access ... before initialization`。插件默认会包裹已有的 `manualChunks` 函数，只稳定这些已知互操作 chunk，保留其它自定义分组；确实需要完全接管时可设置 `stabilizeInteropChunks:false`。
 
+`copyAssets.baseDir` 可以覆盖自动目录：必须是相对路径，不能包含 `..`；传空字符串表示显式复制到根目录。插件会为标准包、preset 和 full 包同步统一运行时资源根；full 包仍同时同步 `setDefaultFullAssetBaseUrl()`。只有设置 `inject:false` 且不手动导入虚拟模块时，业务才需要调用 `setDefaultFileViewerAssetBaseUrl()`（full 包同时调用 `setDefaultFullAssetBaseUrl()`）。Vite 配置了 `base:'/app/'` 时，full 包开发 URL 为 `/app/file-viewer/...`，构建文件仍位于 `outDir/file-viewer/`。
+
 如果你需要严格控制 registry，可以关闭注入并手动传入：
 
 ```ts
@@ -145,7 +149,7 @@ export const fileViewerFormats = ['pdf', 'docx', 'xlsx']
 
 ## 当前边界
 
-当前插件会为已经拆出的 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` 时会同时复制 Typst compiler / renderer WASM 与 `wasm/typst/fonts/` 默认字体目录。`preset: 'auto' | 'lite' | 'office' | 'engineering' | 'all'` 会导入对应 `@file-viewer/preset-*` 包；如果同时声明 `formats`，插件会在 preset 之外补充额外 renderer。
+当前插件会为已经拆出的 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.d.ts

@@ -31,6 +31,14 @@ export interface FileViewerCopyAssetsOptions {
      * Directory used after production build. Defaults to build.outDir.
      */
     outDir?: string;
+    /**
+     * Directory below publicDir/outDir where assets are published. When omitted,
+     * projects with an installed @file-viewer/*-full package use `file-viewer`;
+     * other projects keep the existing output-root layout. Use an empty string
+     * to explicitly publish at the output root. The injected runtime module
+     * keeps every renderer's default asset base aligned with this directory.
+     */
+    baseDir?: string;
     /**
      * Copy during dev server startup, build closeBundle, or both.
      */
@@ -100,6 +108,26 @@ interface MissingRendererNotice {
 }
 export declare function extractFileViewerRendererHintTokens(source: string): string[];
 export declare function collectFileViewerRendererScanTokens(projectRoot: string, scan: FileViewerRenderersPluginOptions['scan']): string[];
+export interface FileViewerCopyAssetsTargetConfig {
+    /** Vite project root. Defaults to process.cwd(). */
+    projectRoot?: string;
+    /** Resolved Vite publicDir. Defaults to `public`. */
+    publicDir?: string;
+    /** Resolved Vite build.outDir. Defaults to `dist`. */
+    outDir?: string;
+}
+export interface FileViewerCopyAssetsTarget {
+    mode: 'dev' | 'build';
+    outputRoot: string;
+    targetRoot: string;
+    baseDir: string;
+    installedFullPackages: string[];
+}
+/**
+ * Resolves the exact directory used by copyAssets without running a Vite build.
+ * This is exported so integrations can validate their deployment contract.
+ */
+export declare function resolveFileViewerCopyAssetsTarget(mode: 'dev' | 'build', value?: true | FileViewerCopyAssetsOptions, config?: FileViewerCopyAssetsTargetConfig): FileViewerCopyAssetsTarget;
 export declare function fileViewerRenderers(options?: FileViewerRenderersPluginOptions): Plugin;
 export declare function createFileViewerManualChunks(options?: FileViewerRenderersPluginOptions): (id: string) => string | undefined;
 export declare function resolveFileViewerRendererSelection(options?: FileViewerRenderersPluginOptions, projectRoot?: string): {

package/dist/index.js

@@ -1,9 +1,19 @@
 import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { copyFile, cp, mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { copyFile, cp, mkdir, readFile, realpath, rm, stat, writeFile } from 'node:fs/promises';
 import { createRequire } from 'node:module';
-import { dirname, extname, isAbsolute, join, resolve, sep } from 'node:path';
+import { dirname, extname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 const virtualModuleId = 'virtual:file-viewer-renderers';
 const resolvedVirtualModuleId = `\0${virtualModuleId}`;
+const packagedPptFallbackModuleId = 'virtual:file-viewer-packaged-ppt-fallback';
+const resolvedPackagedPptFallbackModuleId = `\0${packagedPptFallbackModuleId}`;
+const isPresentationRendererImporter = (importer) => {
+    if (!importer)
+        return false;
+    const normalized = importer.replace(/\\/g, '/');
+    return (normalized.includes('/@file-viewer/renderer-presentation/') ||
+        normalized.includes('/@file-viewer+renderer-presentation@') ||
+        normalized.includes('/packages/renderers/presentation/'));
+};
 const pluginRequire = createRequire(import.meta.url);
 let workspacePackageJsonCache = null;
 const rendererModules = [
@@ -43,8 +53,17 @@ const rendererModules = [
         id: 'presentation',
         packageName: '@file-viewer/renderer-presentation',
         exportName: 'presentationRenderer',
-        formats: ['presentation', 'pptx', 'pptm', 'potx', 'potm', 'ppsx', 'ppsm'],
-        rendererIds: ['office-presentation'],
+        formats: [
+            'presentation',
+            'ppt',
+            'pptx',
+            'pptm',
+            'potx',
+            'potm',
+            'ppsx',
+            'ppsm'
+        ],
+        rendererIds: ['office-presentation-binary', 'office-presentation'],
         chunkName: 'file-viewer-presentation'
     },
     {
@@ -384,27 +403,32 @@ const presetModules = {
         chunkName: 'file-viewer-preset-engineering'
     }
 };
+const fileViewerFullPackages = [
+    '@file-viewer/react-full',
+    '@file-viewer/react-legacy-full',
+    '@file-viewer/vue3-full',
+    '@file-viewer/vue2.7-full',
+    '@file-viewer/vue2.6-full',
+    '@file-viewer/web-full',
+    '@file-viewer/jquery-full',
+    '@file-viewer/svelte-full'
+];
 // Vite dep optimization rewrites import.meta.url into node_modules/.vite/deps
 // and can trigger full-preset dev-server re-optimization reloads. Keep File
 // Viewer packages out of dep optimization while still optimizing their
 // CommonJS/UMD helper dependencies below.
 const fileViewerOptimizationExcludedPackages = [
     '@file-viewer/core',
+    '@file-viewer/ppt',
     '@file-viewer/pptx',
     ...rendererModules.map((descriptor) => descriptor.packageName),
     ...Object.values(presetModules).map((preset) => preset.packageName),
-    '@file-viewer/react-full',
-    '@file-viewer/react-legacy-full',
-    '@file-viewer/vue3-full',
-    '@file-viewer/vue2.7-full',
-    '@file-viewer/vue2.6-full',
-    '@file-viewer/web-full',
-    '@file-viewer/jquery-full',
-    '@file-viewer/svelte-full'
+    ...fileViewerFullPackages
 ];
 const cjsInteropPackages = [
     '@file-viewer/docx',
     '@xmldom/xmldom',
+    'occt-import-js',
     'jszip'
 ];
 const defaultScanRoots = ['src', 'app', 'pages', 'components'];
@@ -453,6 +477,7 @@ const mimeFormatHints = {
     'application/vnd.rar': ['rar'],
     'text/markdown': ['md'],
     'text/csv': ['csv'],
+    'text/tab-separated-values': ['tsv'],
     'text/html': ['html'],
     'text/css': ['css'],
     'text/plain': ['txt'],
@@ -632,7 +657,7 @@ function expandDescriptorRendererIds(ids) {
         return descriptor ? [...descriptor.rendererIds] : [id];
     }));
 }
-function renderVirtualModule(selection, formats, autoPresetIds = []) {
+function renderVirtualModule(selection, formats, autoPresetIds = [], runtimeAssetBase = null, configureFullAssetBase = false) {
     const presetModule = selection.preset ? presetModules[selection.preset] : null;
     const autoPresetModules = autoPresetIds
         .filter((id) => id !== selection.preset)
@@ -672,15 +697,52 @@ function renderVirtualModule(selection, formats, autoPresetIds = []) {
             : !selection.preset && autoPresetModules.length === 1
                 ? autoPresetModules[0].id
                 : '@file-viewer/vite-plugin:configured';
+    const runtimeAssetBaseImport = runtimeAssetBase
+        ? runtimeAssetBase.kind === 'deployment'
+            ? `import { resolveFileViewerRuntimeAssetBaseUrl, setDefaultFileViewerAssetBaseUrl } from '@file-viewer/core/assets';`
+            : `import { setDefaultFileViewerAssetBaseUrl } from '@file-viewer/core/assets';`
+        : null;
+    const fullAssetBaseImport = runtimeAssetBase && configureFullAssetBase
+        ? `import { setDefaultFullAssetBaseUrl } from '@file-viewer/preset-all';`
+        : null;
+    const autoRegistrationImport = rendererNames.length
+        ? `import { registerFileViewerAutoRendererPreset } from '@file-viewer/core';`
+        : null;
+    const runtimeAssetBaseSetup = !runtimeAssetBase
+        ? []
+        : runtimeAssetBase.kind === 'literal'
+            ? [
+                `setDefaultFileViewerAssetBaseUrl(${JSON.stringify(runtimeAssetBase.url)});`,
+                ...(configureFullAssetBase
+                    ? [`setDefaultFullAssetBaseUrl(${JSON.stringify(runtimeAssetBase.url)});`]
+                    : []),
+                ''
+            ]
+            : [
+                "const fileViewerDeploymentBaseUrl = typeof document === 'undefined'",
+                "  ? '/'",
+                '  : resolveFileViewerRuntimeAssetBaseUrl(document);',
+                "const fileViewerRuntimeAssetBaseUrl = typeof document === 'undefined'",
+                `  ? '/' + ${JSON.stringify(runtimeAssetBase.encodedBaseDir)}`,
+                `  : new URL(${JSON.stringify(runtimeAssetBase.encodedBaseDir)}, fileViewerDeploymentBaseUrl.endsWith('/') ? fileViewerDeploymentBaseUrl : fileViewerDeploymentBaseUrl + '/').href;`,
+                'setDefaultFileViewerAssetBaseUrl(fileViewerRuntimeAssetBaseUrl);',
+                ...(configureFullAssetBase
+                    ? ['setDefaultFullAssetBaseUrl(fileViewerRuntimeAssetBaseUrl);']
+                    : []),
+                ''
+            ];
     return [
-        `import { registerFileViewerAutoRendererPreset } from '@file-viewer/core';`,
+        ...[autoRegistrationImport, runtimeAssetBaseImport, fullAssetBaseImport].filter(Boolean),
         ...[presetImport].filter(Boolean),
         ...autoPresetImports,
         ...rendererImports,
         '',
+        ...runtimeAssetBaseSetup,
         `export const configuredFileViewerRenderers = [${rendererNames.join(', ')}];`,
         `export const fileViewerRendererPlan = ${JSON.stringify(plan, null, 2)};`,
-        `registerFileViewerAutoRendererPreset(configuredFileViewerRenderers, { id: ${JSON.stringify(autoRegistrationId)} });`,
+        ...(rendererNames.length
+            ? [`registerFileViewerAutoRendererPreset(configuredFileViewerRenderers, { id: ${JSON.stringify(autoRegistrationId)} });`]
+            : []),
         'export default configuredFileViewerRenderers;',
         ''
     ].join('\n');
@@ -954,16 +1016,19 @@ function readPackageVersion(packageRoot) {
         return null;
     }
 }
-function assertOwnedPackageVersion(packageName, packageRoot, ownerPackageName) {
+function assertOwnedPackageVersion(packageName, packageRoot, ownerPackageName, anchorPackages = []) {
     if (!packageRoot) {
         return null;
     }
-    const ownerPackageJsonPath = resolvePackageJson(ownerPackageName);
+    const ownerPackageJsonPath = resolvePackageJson(ownerPackageName, anchorPackages);
     if (!ownerPackageJsonPath) {
         return readPackageVersion(packageRoot);
     }
     const ownerPackageJson = JSON.parse(readFileSync(ownerPackageJsonPath, 'utf8'));
-    const expectedVersion = ownerPackageJson.dependencies?.[packageName];
+    const configuredVersion = ownerPackageJson.dependencies?.[packageName];
+    const expectedVersion = configuredVersion?.startsWith('workspace:')
+        ? configuredVersion.slice('workspace:'.length)
+        : configuredVersion;
     const actualVersion = readPackageVersion(packageRoot);
     if (expectedVersion &&
         /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(expectedVersion) &&
@@ -1167,11 +1232,65 @@ async function copyKnownRendererAssets(targetRoot, rendererIds) {
     await push('pdf', 'pdf-cjk-font-fallback', join(targetRoot, 'vendor/pdf/fonts'), () => copyPdfCjkFontAssets(pdfCjkFontRoot, join(targetRoot, 'vendor/pdf/fonts')));
     const pptxRoot = resolvePackageRoot('@file-viewer/pptx', ['@file-viewer/renderer-presentation']);
     await push('office-presentation', 'pptx-worker', join(targetRoot, 'vendor/pptx/pptx.worker.js'), () => copyFileIfPresent(pptxRoot ? join(pptxRoot, 'dist/worker/pptx.worker.js') : null, join(targetRoot, 'vendor/pptx/pptx.worker.js')));
+    const pptRoot = resolvePackageRoot('@file-viewer/ppt', ['@file-viewer/renderer-presentation']);
+    const pptVersion = readPackageVersion(pptRoot);
+    const pptSource = pptRoot
+        ? { sourcePackage: '@file-viewer/ppt', sourceVersion: pptVersion || undefined }
+        : undefined;
+    for (const [id, filename] of [
+        ['ppt-module', 'index.mjs'],
+        ['ppt-worker', 'worker.mjs'],
+        ['ppt-frame-cache', 'frame-cache.mjs'],
+        ['ppt-wasm', 'ppt-native.wasm'],
+        ['ppt-cjk-font', 'ppt-font-cjk.otf'],
+        ['ppt-manifest', 'manifest.json'],
+        ['ppt-package', 'package.json'],
+        ['ppt-license', 'LICENSE'],
+        ['ppt-notice', 'NOTICE']
+    ]) {
+        await push('office-presentation-binary', id, join(targetRoot, `vendor/ppt/${filename}`), () => copyFileIfPresent(pptRoot ? join(pptRoot, filename) : null, join(targetRoot, `vendor/ppt/${filename}`)), undefined, pptSource);
+    }
     const docxRoot = resolvePackageRoot('@file-viewer/docx', ['@file-viewer/renderer-word']);
     await push('office-word-openxml', 'docx-worker', join(targetRoot, 'vendor/docx/docx.worker.js'), () => copyFileIfPresent(docxRoot ? join(docxRoot, 'dist/docx-preview.worker.js') : null, join(targetRoot, 'vendor/docx/docx.worker.js')));
     await push('office-word-openxml', 'docx-worker-jszip', join(targetRoot, 'vendor/docx/jszip.min.js'), () => copyFileIfPresent(docxRoot ? join(docxRoot, 'dist/jszip.min.js') : null, join(targetRoot, 'vendor/docx/jszip.min.js')));
+    const spreadsheetRoot = resolvePackageRoot('@file-viewer/renderer-spreadsheet', [
+        '@file-viewer/renderer-spreadsheet',
+        '@file-viewer/preset-office',
+        '@file-viewer/preset-all'
+    ]);
+    const spreadsheetVersion = readPackageVersion(spreadsheetRoot);
+    await push('spreadsheet-openxml', 'spreadsheet-worker', join(targetRoot, 'vendor/xlsx/sheet.worker.js'), () => copyFileIfPresent(spreadsheetRoot ? join(spreadsheetRoot, 'dist/worker/sheet.worker.js') : null, join(targetRoot, 'vendor/xlsx/sheet.worker.js')), undefined, spreadsheetRoot
+        ? {
+            sourcePackage: '@file-viewer/renderer-spreadsheet',
+            sourceVersion: spreadsheetVersion || undefined
+        }
+        : undefined);
     const cadRoot = resolvePackageRoot('@flyfish-dev/cad-viewer', ['@file-viewer/renderer-cad']);
     await push('cad', 'cad-wasm-directory', join(targetRoot, 'wasm/cad'), () => copyDirectoryIfPresent(cadRoot ? join(cadRoot, 'dist/wasm') : null, join(targetRoot, 'wasm/cad')));
+    const modelDependencyAnchors = [
+        '@file-viewer/renderer-3d',
+        '@file-viewer/geometry-engine'
+    ];
+    const occtRoot = resolvePackageRoot('occt-import-js', modelDependencyAnchors);
+    const geometryEngineRoot = resolvePackageRoot('@file-viewer/geometry-engine', [
+        '@file-viewer/renderer-3d'
+    ]);
+    const occtVersion = assertOwnedPackageVersion('occt-import-js', occtRoot, '@file-viewer/geometry-engine', modelDependencyAnchors);
+    const occtSource = occtRoot
+        ? { sourcePackage: 'occt-import-js', sourceVersion: occtVersion || undefined }
+        : undefined;
+    await push('model', 'model-occt-worker', join(targetRoot, 'wasm/model/occt-worker.js'), () => copyFileIfPresent(geometryEngineRoot ? join(geometryEngineRoot, 'assets/occt-worker.js') : null, join(targetRoot, 'wasm/model/occt-worker.js')));
+    for (const [id, filename] of [
+        ['model-occt-runtime', 'occt-import-js.js'],
+        ['model-occt-wasm', 'occt-import-js.wasm'],
+        ['model-occt-license', 'license.occt.txt'],
+        ['model-occt-import-license', 'license.occt-import-js.txt']
+    ]) {
+        const targetFilename = filename.startsWith('license.')
+            ? filename.replace(/^license\./, 'LICENSE.')
+            : filename;
+        await push('model', id, join(targetRoot, `wasm/model/${targetFilename}`), () => copyFileIfPresent(occtRoot ? join(occtRoot, `dist/${filename}`) : null, join(targetRoot, `wasm/model/${targetFilename}`)), undefined, occtSource);
+    }
     const typstCompilerRoot = resolvePackageRoot('@myriaddreamin/typst-ts-web-compiler', [
         '@file-viewer/renderer-typst'
     ]);
@@ -1199,14 +1318,343 @@ async function copyKnownRendererAssets(targetRoot, rendererIds) {
     }, null, 2)}\n`);
     return results;
 }
-function resolveTargetDir(value, fallback, projectRoot) {
-    const target = value || fallback;
-    return isAbsolute(target) ? target : resolve(projectRoot || process.cwd(), target);
+function matchesBundledAssetKind(kind, info) {
+    return kind === 'directory' || kind === 'wasm-directory'
+        ? info.isDirectory()
+        : info.isFile();
+}
+function isBundledFullAssetPayload(payloadRoot) {
+    return Boolean(payloadRoot &&
+        existsSync(payloadRoot) &&
+        statSync(payloadRoot).isDirectory() &&
+        existsSync(join(payloadRoot, 'flyfish-viewer-assets.json')));
+}
+function resolveBundledFullAssetSource(installedFullPackages) {
+    const copyAssetsPackageRoot = resolvePackageRoot('file-viewer-copy-assets', installedFullPackages);
+    const copyAssetsPayloadRoot = copyAssetsPackageRoot
+        ? join(copyAssetsPackageRoot, 'viewer')
+        : null;
+    if (copyAssetsPackageRoot && copyAssetsPayloadRoot && isBundledFullAssetPayload(copyAssetsPayloadRoot)) {
+        installedFullPackages.forEach((ownerPackageName) => {
+            assertOwnedPackageVersion('file-viewer-copy-assets', copyAssetsPackageRoot, ownerPackageName);
+        });
+        const sourceVersion = readPackageVersion(copyAssetsPackageRoot);
+        if (sourceVersion) {
+            return {
+                packageName: 'file-viewer-copy-assets',
+                packageRoot: copyAssetsPackageRoot,
+                payloadRoot: copyAssetsPayloadRoot,
+                sourceVersion
+            };
+        }
+    }
+    if (installedFullPackages.includes('@file-viewer/web-full')) {
+        const webFullPackageRoot = resolvePackageRoot('@file-viewer/web-full', installedFullPackages);
+        const webFullPayloadRoot = webFullPackageRoot
+            ? join(webFullPackageRoot, 'dist')
+            : null;
+        const sourceVersion = readPackageVersion(webFullPackageRoot);
+        if (webFullPackageRoot &&
+            webFullPayloadRoot &&
+            sourceVersion &&
+            isBundledFullAssetPayload(webFullPayloadRoot)) {
+            return {
+                packageName: '@file-viewer/web-full',
+                packageRoot: webFullPackageRoot,
+                payloadRoot: webFullPayloadRoot,
+                sourceVersion
+            };
+        }
+    }
+    // Source workspaces may not have staged file-viewer-copy-assets/viewer yet.
+    // @file-viewer/web keeps the same tracked payload for local development.
+    const webPackageRoot = resolvePackageRoot('@file-viewer/web', installedFullPackages);
+    const webPayloadRoot = webPackageRoot ? join(webPackageRoot, 'viewer') : null;
+    const sourceVersion = readPackageVersion(webPackageRoot);
+    if (webPackageRoot &&
+        webPayloadRoot &&
+        sourceVersion &&
+        isBundledFullAssetPayload(webPayloadRoot)) {
+        return {
+            packageName: '@file-viewer/web',
+            packageRoot: webPackageRoot,
+            payloadRoot: webPayloadRoot,
+            sourceVersion
+        };
+    }
+    return null;
+}
+function assertBundledFullAssetSourceVersion(source, installedFullPackages) {
+    const payloadManifestPath = join(source.payloadRoot, 'flyfish-viewer-manifest.json');
+    if (!existsSync(payloadManifestPath)) {
+        throw new Error(`[file-viewer:vite-plugin] Missing version manifest in ${source.packageName} payload: ${payloadManifestPath}.`);
+    }
+    const payloadManifest = JSON.parse(readFileSync(payloadManifestPath, 'utf8'));
+    if (!payloadManifest.version || payloadManifest.version !== source.sourceVersion) {
+        throw new Error(`[file-viewer:vite-plugin] ${source.packageName}@${source.sourceVersion} contains ` +
+            `viewer assets for ${payloadManifest.version || 'an unknown version'}.`);
+    }
+    installedFullPackages.forEach((packageName) => {
+        const packageRoot = resolvePackageRoot(packageName, installedFullPackages);
+        const packageVersion = readPackageVersion(packageRoot);
+        if (packageVersion && packageVersion !== payloadManifest.version) {
+            throw new Error(`[file-viewer:vite-plugin] ${packageName}@${packageVersion} cannot use ` +
+                `${source.packageName} viewer assets at ${payloadManifest.version}.`);
+        }
+    });
+}
+async function copyBundledFullRendererAssets(targetRoot, rendererIds, installedFullPackages) {
+    const source = resolveBundledFullAssetSource(installedFullPackages);
+    if (!source) {
+        return null;
+    }
+    assertBundledFullAssetSourceVersion(source, installedFullPackages);
+    const sourceManifestPath = join(source.payloadRoot, 'flyfish-viewer-assets.json');
+    const manifest = JSON.parse(readFileSync(sourceManifestPath, 'utf8'));
+    if (manifest.schemaVersion !== 1 || !Array.isArray(manifest.rendererAssetManifests)) {
+        throw new Error(`[file-viewer:vite-plugin] Unsupported full asset manifest in ${sourceManifestPath}.`);
+    }
+    await mkdir(targetRoot, { recursive: true });
+    await cp(source.payloadRoot, targetRoot, { recursive: true, force: true });
+    const results = [];
+    for (const asset of manifest.rendererAssetManifests.flatMap((rendererManifest) => rendererManifest.assets)) {
+        if (asset.target !== 'public' || !asset.defaultPath) {
+            continue;
+        }
+        const relativePath = asset.defaultPath.replace(/\\/g, '/').replace(/^\/+/, '');
+        const destination = resolve(targetRoot, ...relativePath.split('/'));
+        let copied = false;
+        let reason;
+        if (!isPathWithin(targetRoot, destination)) {
+            reason = 'asset manifest path escapes the copy target';
+        }
+        else {
+            try {
+                copied = matchesBundledAssetKind(asset.kind, await stat(destination));
+                if (!copied) {
+                    reason = `copied path does not match asset kind ${asset.kind}`;
+                }
+            }
+            catch {
+                reason = 'bundled full asset not found after copy';
+            }
+        }
+        results.push({
+            rendererId: asset.rendererId,
+            id: asset.id,
+            to: destination,
+            copied,
+            required: asset.required,
+            reason,
+            sourcePackage: source.packageName,
+            sourceVersion: source.sourceVersion
+        });
+    }
+    await writeFile(join(targetRoot, 'flyfish-viewer-assets.json'), `${JSON.stringify({
+        ...manifest,
+        generatedBy: '@file-viewer/vite-plugin',
+        copiedAt: new Date().toISOString(),
+        rendererIds,
+        assets: results
+    }, null, 2)}\n`);
+    return results;
+}
+async function copyRendererAssets(target, rendererIds) {
+    if (target.installedFullPackages.length) {
+        const bundledResults = await copyBundledFullRendererAssets(target.targetRoot, rendererIds, target.installedFullPackages);
+        if (bundledResults) {
+            return bundledResults;
+        }
+    }
+    const results = await copyKnownRendererAssets(target.targetRoot, rendererIds);
+    if (target.installedFullPackages.length) {
+        results.push({
+            rendererId: 'full',
+            id: 'full-asset-payload',
+            to: target.targetRoot,
+            copied: false,
+            required: true,
+            reason: 'no version-matched full viewer payload was found in file-viewer-copy-assets, @file-viewer/web-full, or @file-viewer/web'
+        });
+    }
+    return results;
 }
 function copyOptions(value) {
     return typeof value === 'object' ? value : {};
 }
-function collectAssetRendererIds(selection, autoPresetIds = []) {
+function findNearestProjectPackageJson(projectRoot) {
+    let current = resolve(projectRoot);
+    while (true) {
+        const packageJsonPath = join(current, 'package.json');
+        if (existsSync(packageJsonPath) && statSyncSafe(packageJsonPath)?.isFile()) {
+            return packageJsonPath;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+function resolveInstalledFullPackages(projectRoot) {
+    const packageJsonPath = findNearestProjectPackageJson(projectRoot);
+    if (!packageJsonPath) {
+        return [];
+    }
+    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)));
+    }
+    catch {
+        return [];
+    }
+}
+function normalizeCopyAssetsBaseDir(value) {
+    const normalized = value.trim().replace(/\\/g, '/');
+    if (!normalized) {
+        return '';
+    }
+    if (normalized.startsWith('/') ||
+        isAbsolute(value) ||
+        /^[A-Za-z]:\//.test(normalized) ||
+        normalized.includes('\0')) {
+        throw new Error(`[file-viewer:vite-plugin] copyAssets.baseDir must be a relative directory, received ${JSON.stringify(value)}.`);
+    }
+    const segments = normalized.split('/').filter(Boolean);
+    const decodedSegments = [];
+    for (const segment of segments) {
+        let decodedSegment = segment;
+        try {
+            decodedSegment = decodeURIComponent(segment);
+        }
+        catch {
+            throw new Error(`[file-viewer:vite-plugin] copyAssets.baseDir contains invalid URL encoding: ${JSON.stringify(value)}.`);
+        }
+        if (decodedSegment === '.' ||
+            decodedSegment === '..' ||
+            decodedSegment.includes('/') ||
+            decodedSegment.includes('\\') ||
+            decodedSegment.includes('\0')) {
+            throw new Error(`[file-viewer:vite-plugin] copyAssets.baseDir cannot escape its output directory: ${JSON.stringify(value)}.`);
+        }
+        decodedSegments.push(decodedSegment);
+    }
+    return decodedSegments.join('/');
+}
+function isPathWithin(parent, candidate) {
+    const relativePath = relative(parent, candidate);
+    return relativePath === '' || (relativePath !== '..' &&
+        !relativePath.startsWith(`..${sep}`) &&
+        !isAbsolute(relativePath));
+}
+function resolveOutputRoot(value, fallback, projectRoot) {
+    const output = value || fallback;
+    return isAbsolute(output) ? resolve(output) : resolve(projectRoot, output);
+}
+/**
+ * Resolves the exact directory used by copyAssets without running a Vite build.
+ * This is exported so integrations can validate their deployment contract.
+ */
+export function resolveFileViewerCopyAssetsTarget(mode, value = true, config = {}) {
+    const projectRoot = resolve(config.projectRoot || process.cwd());
+    const options = copyOptions(value);
+    const installedFullPackages = resolveInstalledFullPackages(projectRoot);
+    const baseDir = normalizeCopyAssetsBaseDir(typeof options.baseDir === 'string'
+        ? options.baseDir
+        : installedFullPackages.length
+            ? 'file-viewer'
+            : '');
+    const outputRoot = resolveOutputRoot(mode === 'dev' ? options.publicDir : options.outDir, mode === 'dev' ? config.publicDir || 'public' : config.outDir || 'dist', projectRoot);
+    const targetRoot = baseDir
+        ? resolve(outputRoot, ...baseDir.split('/'))
+        : outputRoot;
+    if (!isPathWithin(outputRoot, targetRoot)) {
+        throw new Error(`[file-viewer:vite-plugin] Refusing to copy assets outside ${outputRoot}: ${targetRoot}.`);
+    }
+    return {
+        mode,
+        outputRoot,
+        targetRoot,
+        baseDir,
+        installedFullPackages: [...installedFullPackages]
+    };
+}
+function normalizeViteDevBasePath(base) {
+    let pathname = base;
+    if (/^[A-Za-z][A-Za-z\d+.-]*:\/\//.test(base)) {
+        try {
+            pathname = new URL(base).pathname;
+        }
+        catch {
+            return '/';
+        }
+    }
+    if (!pathname.startsWith('/')) {
+        return '/';
+    }
+    return pathname.endsWith('/') ? pathname : `${pathname}/`;
+}
+function resolveViteFullAssetBase(base, baseDir) {
+    const encodedBaseDir = baseDir
+        .split('/')
+        .filter(Boolean)
+        .map((segment) => encodeURIComponent(segment))
+        .join('/');
+    const encodedBaseDirWithSlash = encodedBaseDir ? `${encodedBaseDir}/` : '';
+    const resolvedBase = base === undefined ? '/' : base.trim();
+    const isAbsoluteBase = resolvedBase.startsWith('/') || /^[A-Za-z][A-Za-z\d+.-]*:\/\//.test(resolvedBase);
+    if (!isAbsoluteBase) {
+        return { kind: 'deployment', encodedBaseDir: encodedBaseDirWithSlash };
+    }
+    const normalizedBase = resolvedBase.endsWith('/') ? resolvedBase : `${resolvedBase}/`;
+    return { kind: 'literal', url: `${normalizedBase}${encodedBaseDirWithSlash}` };
+}
+function resolveDevAssetRequestPath(targetRoot, baseDir, requestPathname, viteBasePath) {
+    let requestRelativePath;
+    try {
+        // Depending on the Vite major and middleware ordering, configureServer can
+        // observe either the original base-prefixed URL or the pathname after
+        // Vite's base middleware has stripped it. Accept both shapes, then keep the
+        // strict viewer-asset allowlist and target-root boundary checks below.
+        const encodedRelativePath = viteBasePath === '/' || requestPathname.startsWith(viteBasePath)
+            ? requestPathname.slice(viteBasePath === '/' ? 1 : viteBasePath.length)
+            : requestPathname.replace(/^\/+/, '');
+        requestRelativePath = decodeURIComponent(encodedRelativePath);
+    }
+    catch {
+        return null;
+    }
+    requestRelativePath = requestRelativePath.replace(/\\/g, '/');
+    if (requestRelativePath.includes('\0')) {
+        return null;
+    }
+    const basePrefix = baseDir ? `${baseDir}/` : '';
+    if (basePrefix && !requestRelativePath.startsWith(basePrefix)) {
+        return null;
+    }
+    const assetRelativePath = requestRelativePath.slice(basePrefix.length);
+    const isViewerManifest = assetRelativePath === 'flyfish-viewer-assets.json' ||
+        assetRelativePath === 'flyfish-viewer-manifest.json';
+    if (!isViewerManifest &&
+        !assetRelativePath.startsWith('vendor/') &&
+        !assetRelativePath.startsWith('wasm/')) {
+        return null;
+    }
+    const assetPath = resolve(targetRoot, ...assetRelativePath.split('/'));
+    return isPathWithin(targetRoot, assetPath) ? assetPath : null;
+}
+function collectAssetRendererIds(selection, autoPresetIds = [], includeFullPreset = false) {
+    if (includeFullPreset) {
+        return expandDescriptorRendererIds(presetModules.all.rendererIds);
+    }
     const presetIds = [
         ...(selection.preset ? expandDescriptorRendererIds(presetModules[selection.preset].rendererIds) : []),
         ...autoPresetIds.flatMap((presetId) => expandDescriptorRendererIds(presetModules[presetId].rendererIds))
@@ -1217,14 +1665,15 @@ function collectAssetRendererIds(selection, autoPresetIds = []) {
     ]);
 }
 function reportAssetCopy(results, targetRoot, mode) {
-    const failedRequired = results.filter((result) => !result.copied && [
+    const failedRequired = results.filter((result) => !result.copied && (result.required ?? [
         'pdf',
         'office-word-openxml',
+        'office-presentation-binary',
         'office-presentation',
         'archive',
         'cad',
         'typst'
-    ].includes(result.rendererId));
+    ].includes(result.rendererId)));
     if (!results.length) {
         return;
     }
@@ -1258,6 +1707,8 @@ export function fileViewerRenderers(options = {}) {
     });
     let autoPresetIds = resolveAutoPresetIds(options);
     let resolvedConfig = null;
+    let installedFullPackages = [];
+    let runtimeAssetBase = null;
     const refreshSelection = (projectRoot) => {
         if (projectRoot) {
             scanFormats = collectFileViewerRendererScanTokens(projectRoot, options.scan);
@@ -1269,6 +1720,18 @@ export function fileViewerRenderers(options = {}) {
         });
         autoPresetIds = resolveAutoPresetIds(options);
     };
+    const refreshFullAssetRuntime = (projectRoot, viteBase) => {
+        if (!options.copyAssets) {
+            installedFullPackages = [];
+            runtimeAssetBase = null;
+            return;
+        }
+        const target = resolveFileViewerCopyAssetsTarget('dev', options.copyAssets, {
+            projectRoot
+        });
+        installedFullPackages = target.installedFullPackages;
+        runtimeAssetBase = resolveViteFullAssetBase(viteBase, target.baseDir);
+    };
     const hasConfiguredRenderers = () => Boolean(selection.preset || selection.descriptors.length || autoPresetIds.length);
     return {
         name: 'file-viewer-renderers',
@@ -1276,19 +1739,27 @@ export function fileViewerRenderers(options = {}) {
         config(userConfig) {
             const projectRoot = resolve(process.cwd(), userConfig.root || '.');
             refreshSelection(projectRoot);
-            const selectedPackages = collectSelectedPackages(selection, autoPresetIds);
+            refreshFullAssetRuntime(projectRoot, userConfig.base);
             const dependencyAnchorPackages = collectDependencyAnchorPackages(selection, autoPresetIds);
+            const resolvedDependencyAnchorPackages = runtimeAssetBase
+                ? unique([
+                    ...dependencyAnchorPackages,
+                    '@file-viewer/core',
+                    ...installedFullPackages,
+                    ...(installedFullPackages.length ? ['@file-viewer/preset-all'] : [])
+                ])
+                : dependencyAnchorPackages;
             const optimizeDepsExclude = createOptimizeDepsExclude(userConfig);
             const manualChunksFunction = getManualChunksFunction(userConfig);
             const nextConfig = {
                 optimizeDeps: {
                     exclude: optimizeDepsExclude,
-                    include: createOptimizeDepsInclude(userConfig, optimizeDepsExclude, dependencyAnchorPackages)
+                    include: createOptimizeDepsInclude(userConfig, optimizeDepsExclude, resolvedDependencyAnchorPackages)
                 },
                 resolve: {
                     alias: [
                         ...normalizeViteAlias(userConfig.resolve?.alias),
-                        ...createFileViewerResolveAliases(dependencyAnchorPackages)
+                        ...createFileViewerResolveAliases(resolvedDependencyAnchorPackages)
                     ]
                 }
             };
@@ -1321,6 +1792,7 @@ export function fileViewerRenderers(options = {}) {
         configResolved(config) {
             resolvedConfig = config;
             refreshSelection(config.root);
+            refreshFullAssetRuntime(config.root, config.base);
         },
         buildStart() {
             assertMissingRendererPolicy(selection, missingMode);
@@ -1340,58 +1812,68 @@ export function fileViewerRenderers(options = {}) {
             if (!options.copyAssets || copyOptions(options.copyAssets).mode === 'build') {
                 return;
             }
-            const targetRoot = resolveTargetDir(copyOptions(options.copyAssets).publicDir, resolvedConfig?.publicDir || 'public', resolvedConfig?.root);
-            const results = await copyKnownRendererAssets(targetRoot, collectAssetRendererIds(selection, autoPresetIds));
+            const copyTarget = resolveFileViewerCopyAssetsTarget('dev', options.copyAssets, {
+                projectRoot: resolvedConfig?.root,
+                publicDir: resolvedConfig?.publicDir || 'public',
+                outDir: resolvedConfig?.build.outDir || 'dist'
+            });
+            const { targetRoot } = copyTarget;
+            const results = await copyRendererAssets(copyTarget, collectAssetRendererIds(selection, autoPresetIds, copyTarget.installedFullPackages.length > 0));
             reportAssetCopy(results, targetRoot, missingMode);
-            const base = resolvedConfig?.base || '/';
-            if (base.startsWith('/') && base !== '/') {
-                const normalizedBase = base.endsWith('/') ? base : `${base}/`;
-                server.middlewares.use(async (request, response, next) => {
+            const viteBasePath = normalizeViteDevBasePath(resolvedConfig?.base || '/');
+            if (server?.middlewares?.use) {
+                const realTargetRoot = await realpath(targetRoot).catch(() => targetRoot);
+                server.middlewares.use(async function fileViewerAssetMiddleware(request, response, next) {
                     const requestUrl = request.url || '';
                     const queryIndex = requestUrl.indexOf('?');
                     const pathname = queryIndex >= 0 ? requestUrl.slice(0, queryIndex) : requestUrl;
-                    if (pathname.startsWith(normalizedBase)) {
-                        let relativePath = pathname.slice(normalizedBase.length);
+                    const assetPath = resolveDevAssetRequestPath(targetRoot, copyTarget.baseDir, pathname, viteBasePath);
+                    if (assetPath) {
                         try {
-                            relativePath = decodeURIComponent(relativePath);
-                        }
-                        catch {
-                            next();
-                            return;
-                        }
-                        if (relativePath.startsWith('vendor/') || relativePath.startsWith('wasm/')) {
-                            const assetPath = resolve(targetRoot, relativePath);
-                            if (assetPath.startsWith(`${targetRoot}${sep}`)) {
-                                try {
-                                    const info = await stat(assetPath);
-                                    if (info.isFile()) {
-                                        const contentTypes = {
-                                            '.bcmap': 'application/octet-stream',
-                                            '.css': 'text/css; charset=utf-8',
-                                            '.js': 'text/javascript; charset=utf-8',
-                                            '.json': 'application/json; charset=utf-8',
-                                            '.mjs': 'text/javascript; charset=utf-8',
-                                            '.ttf': 'font/ttf',
-                                            '.wasm': 'application/wasm',
-                                            '.woff': 'font/woff',
-                                            '.woff2': 'font/woff2'
-                                        };
-                                        response.statusCode = 200;
-                                        response.setHeader('Content-Type', contentTypes[extname(assetPath).toLowerCase()] || 'application/octet-stream');
-                                        if (request.method === 'HEAD') {
-                                            response.end();
-                                        }
-                                        else {
-                                            response.end(await readFile(assetPath));
-                                        }
-                                        return;
+                            const resolvedAssetPath = await realpath(assetPath);
+                            if (isPathWithin(realTargetRoot, resolvedAssetPath)) {
+                                const info = await stat(resolvedAssetPath);
+                                if (info.isFile()) {
+                                    const contentTypes = {
+                                        '.avif': 'image/avif',
+                                        '.bcmap': 'application/octet-stream',
+                                        '.css': 'text/css; charset=utf-8',
+                                        '.gif': 'image/gif',
+                                        '.ico': 'image/x-icon',
+                                        '.jpeg': 'image/jpeg',
+                                        '.jpg': 'image/jpeg',
+                                        '.js': 'text/javascript; charset=utf-8',
+                                        '.json': 'application/json; charset=utf-8',
+                                        '.map': 'application/json; charset=utf-8',
+                                        '.md': 'text/markdown; charset=utf-8',
+                                        '.mjs': 'text/javascript; charset=utf-8',
+                                        '.otf': 'font/otf',
+                                        '.pfb': 'application/x-font-type1',
+                                        '.png': 'image/png',
+                                        '.svg': 'image/svg+xml',
+                                        '.ttf': 'font/ttf',
+                                        '.txt': 'text/plain; charset=utf-8',
+                                        '.wasm': 'application/wasm',
+                                        '.webp': 'image/webp',
+                                        '.woff': 'font/woff',
+                                        '.woff2': 'font/woff2',
+                                        '.xml': 'application/xml; charset=utf-8'
+                                    };
+                                    response.statusCode = 200;
+                                    response.setHeader('Content-Type', contentTypes[extname(resolvedAssetPath).toLowerCase()] || 'application/octet-stream');
+                                    if (request.method === 'HEAD') {
+                                        response.end();
                                     }
-                                }
-                                catch {
-                                    // Let Vite return its normal 404/fallback response.
+                                    else {
+                                        response.end(await readFile(resolvedAssetPath));
+                                    }
+                                    return;
                                 }
                             }
                         }
+                        catch {
+                            // Let Vite return its normal 404/fallback response.
+                        }
                     }
                     next();
                 });
@@ -1400,7 +1882,7 @@ export function fileViewerRenderers(options = {}) {
         transformIndexHtml: {
             order: 'pre',
             handler() {
-                if (options.inject === false || !hasConfiguredRenderers()) {
+                if (options.inject === false || (!hasConfiguredRenderers() && !runtimeAssetBase)) {
                     return undefined;
                 }
                 return [
@@ -1439,20 +1921,37 @@ export function fileViewerRenderers(options = {}) {
             if (!options.copyAssets || copyOptions(options.copyAssets).mode === 'dev') {
                 return;
             }
-            const outDir = resolvedConfig?.build.outDir || 'dist';
-            const targetRoot = resolveTargetDir(copyOptions(options.copyAssets).outDir, outDir, resolvedConfig?.root);
-            const results = await copyKnownRendererAssets(targetRoot, collectAssetRendererIds(selection, autoPresetIds));
+            const copyTarget = resolveFileViewerCopyAssetsTarget('build', options.copyAssets, {
+                projectRoot: resolvedConfig?.root,
+                publicDir: resolvedConfig?.publicDir || 'public',
+                outDir: resolvedConfig?.build.outDir || 'dist'
+            });
+            const { targetRoot } = copyTarget;
+            const results = await copyRendererAssets(copyTarget, collectAssetRendererIds(selection, autoPresetIds, copyTarget.installedFullPackages.length > 0));
             reportAssetCopy(results, targetRoot, missingMode);
         },
-        resolveId(id) {
+        resolveId(id, importer) {
+            if (id === '@file-viewer/ppt' &&
+                options.copyAssets &&
+                installedFullPackages.length > 0 &&
+                isPresentationRendererImporter(importer)) {
+                return resolvedPackagedPptFallbackModuleId;
+            }
             if (id === moduleId || id === virtualModuleId || id === injectedModulePath) {
                 return id === virtualModuleId ? resolvedVirtualModuleId : resolvedModuleId;
             }
             return undefined;
         },
         load(id) {
+            if (id === resolvedPackagedPptFallbackModuleId) {
+                return `
+export async function createPptViewer() {
+  throw new Error('Packaged PPT runtime URL was not initialized.')
+}
+`;
+            }
             if (id === resolvedModuleId || id === resolvedVirtualModuleId) {
-                return renderVirtualModule(selection, requestedFormats, autoPresetIds);
+                return renderVirtualModule(selection, requestedFormats, autoPresetIds, runtimeAssetBase, installedFullPackages.length > 0);
             }
             return undefined;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/vite-plugin",
-  "version": "2.1.29",
+  "version": "2.2.0",
   "private": false,
   "type": "module",
   "description": "Vite plugin for Flyfish File Viewer on-demand renderer assembly, chunk planning, and offline asset deployment.",