@file-viewer/vite-plugin 2.1.22 → 2.1.24

package/README.en.md

@@ -91,8 +91,11 @@ const options = {
 | `scan` | `true` or `{ roots, extensions, maxFileSize }`; scans source hints and merges formats |
 | `inject` | Defaults to `true`; set `false` to import `virtual:file-viewer-renderers` manually |
 | `chunkStrategy` | `'renderer' | 'none'`; controls renderer-level chunk grouping |
+| `stabilizeInteropChunks` | Defaults to `true`; when the host project already defines a `manualChunks` function, keeps CodeMirror / Lezer / Sandpack in one chunk to avoid production TDZ initialization errors |
 | `missingRenderer` | `'error' | 'warn' | 'ignore'`; controls notices for planned renderer mappings |
 
+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.
+
 For strict registry control, disable injection and pass the virtual module explicitly:
 
 ```ts

package/README.md

@@ -91,8 +91,11 @@ const options = {
 | `scan` | `true` 或 `{ roots, extensions, maxFileSize }`，扫描源码 hint 并合并格式 |
 | `inject` | 默认 `true`；设为 `false` 后手动导入 `virtual:file-viewer-renderers` |
 | `chunkStrategy` | `'renderer' | 'none'`，控制是否注入 renderer 级 chunk 分组 |
+| `stabilizeInteropChunks` | 默认 `true`；当宿主项目已有 `manualChunks` 函数时，把 CodeMirror / Lezer / Sandpack 归到同一 chunk，避免生产构建 TDZ 初始化错误 |
 | `missingRenderer` | `'error' | 'warn' | 'ignore'`，控制尚未提取的 renderer 映射提示方式 |
 
+如果宿主项目按包名拆分 `node_modules`，`@codemirror/*`、`@lezer/*` 和 Sandpack 之间的循环依赖可能在生产构建中表现为 `codemirror-view.* Cannot access ... before initialization`。插件默认会包裹已有的 `manualChunks` 函数，只稳定这些已知互操作 chunk，保留其它自定义分组；确实需要完全接管时可设置 `stabilizeInteropChunks:false`。
+
 如果你需要严格控制 registry，可以关闭注入并手动传入：
 
 ```ts

package/dist/index.d.ts

@@ -75,6 +75,12 @@ export interface FileViewerRenderersPluginOptions {
      * Adds renderer-oriented manualChunks when the user did not define one.
      */
     chunkStrategy?: FileViewerChunkStrategy;
+    /**
+     * Wraps existing manualChunks functions with known circular-dependency-safe
+     * vendor groups. This keeps CodeMirror/Lezer/Sandpack in one chunk when host
+     * apps split node_modules by package name, avoiding production TDZ errors.
+     */
+    stabilizeInteropChunks?: boolean;
     /**
      * Copies known worker/WASM/vendor assets for selected renderer lines.
      */

package/dist/index.js

@@ -691,6 +691,52 @@ function hasManualChunks(config) {
     }
     return Boolean(output?.manualChunks);
 }
+function getManualChunksFunction(config) {
+    const output = config.build?.rollupOptions?.output;
+    if (Array.isArray(output)) {
+        return null;
+    }
+    return typeof output?.manualChunks === 'function'
+        ? output.manualChunks
+        : null;
+}
+function getNodeModulePackageName(id) {
+    const normalized = id.replace(/\\/g, '/');
+    const marker = '/node_modules/';
+    const index = normalized.lastIndexOf(marker);
+    if (index === -1) {
+        return null;
+    }
+    const parts = normalized.slice(index + marker.length).split('/');
+    if (!parts[0]) {
+        return null;
+    }
+    return parts[0].startsWith('@')
+        ? [parts[0], parts[1]].filter(Boolean).join('/')
+        : parts[0];
+}
+function getStableInteropChunkName(id) {
+    const packageName = getNodeModulePackageName(id);
+    if (!packageName) {
+        return undefined;
+    }
+    if (packageName === 'codemirror' ||
+        packageName === '@replit/codemirror-vim' ||
+        packageName.startsWith('@codemirror/') ||
+        packageName.startsWith('@lezer/') ||
+        packageName.startsWith('@codesandbox/sandpack') ||
+        packageName === '@codesandbox/nodebox' ||
+        packageName === '@marijn/find-cluster-break' ||
+        packageName === 'crelt' ||
+        packageName === 'style-mod' ||
+        packageName === 'w3c-keyname') {
+        return 'vendor-codemirror';
+    }
+    return undefined;
+}
+function createStableInteropManualChunks(manualChunks) {
+    return (id, meta) => getStableInteropChunkName(id) || manualChunks(id, meta);
+}
 function createOptimizeDepsExclude(config) {
     return unique([
         ...(config.optimizeDeps?.exclude || []),
@@ -1165,6 +1211,7 @@ export function fileViewerRenderers(options = {}) {
             const selectedPackages = collectSelectedPackages(selection, autoPresetIds);
             const dependencyAnchorPackages = collectDependencyAnchorPackages(selection, autoPresetIds);
             const optimizeDepsExclude = createOptimizeDepsExclude(userConfig);
+            const manualChunksFunction = getManualChunksFunction(userConfig);
             const nextConfig = {
                 optimizeDeps: {
                     exclude: optimizeDepsExclude,
@@ -1177,6 +1224,18 @@ export function fileViewerRenderers(options = {}) {
                     ]
                 }
             };
+            if (manualChunksFunction && options.stabilizeInteropChunks !== false) {
+                return {
+                    ...nextConfig,
+                    build: {
+                        rollupOptions: {
+                            output: {
+                                manualChunks: createStableInteropManualChunks(manualChunksFunction)
+                            }
+                        }
+                    }
+                };
+            }
             if ((options.chunkStrategy || 'renderer') === 'none' || hasManualChunks(userConfig)) {
                 return nextConfig;
             }

package/package.json

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