vocs 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # vocs
 
+## 1.3.1
+
+### Patch Changes
+
+- [#357](https://github.com/wevm/vocs/pull/357) [`dc417ac`](https://github.com/wevm/vocs/commit/dc417ac51d256459a40e1188120def0070a20a36) Thanks [@tmm](https://github.com/tmm)! - Added handling for "Failed to fetch dynamically imported module" errors, which can be caused by version skew.
+
 ## 1.3.0
 
 ### Minor Changes

package/_lib/app/index.client.js

@@ -5,6 +5,7 @@ import { hydrateRoot } from 'react-dom/client';
 import { createBrowserRouter, RouterProvider } from 'react-router';
 import { ConfigProvider, getConfig } from './hooks/useConfig.js';
 import { routes } from './routes.js';
+import { clearChunkReloadFlag } from './utils/chunkError.js';
 import { hydrateLazyRoutes } from './utils/hydrateLazyRoutes.js';
 import { removeTempStyles } from './utils/removeTempStyles.js';
 hydrate();
@@ -12,6 +13,7 @@ async function hydrate() {
     const basePath = getConfig().basePath;
     await hydrateLazyRoutes(routes, basePath);
     removeTempStyles();
+    clearChunkReloadFlag();
     const router = createBrowserRouter(routes, { basename: basePath });
     hydrateRoot(document.getElementById('app'), _jsx(ConfigProvider, { children: _jsx(NuqsAdapter, { children: _jsx(RouterProvider, { router: router }) }) }));
 }

package/_lib/app/index.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.client.js","sourceRoot":"","sources":["../../app/index.client.tsx"],"names":[],"mappings":";AAAA,OAAO,uBAAuB,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,EAAE,CAAA;AAET,KAAK,UAAU,OAAO;IACpB,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,QAAQ,CAAA;IAErC,MAAM,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACzC,gBAAgB,EAAE,CAAA;IAElB,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IAClE,WAAW,CACT,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAE,EAC/B,KAAC,cAAc,cACb,KAAC,WAAW,cACV,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,GAAI,GACtB,GACC,CAClB,CAAA;AACH,CAAC"}
+{"version":3,"file":"index.client.js","sourceRoot":"","sources":["../../app/index.client.tsx"],"names":[],"mappings":";AAAA,OAAO,uBAAuB,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,EAAE,CAAA;AAET,KAAK,UAAU,OAAO;IACpB,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,QAAQ,CAAA;IAErC,MAAM,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACzC,gBAAgB,EAAE,CAAA;IAClB,oBAAoB,EAAE,CAAA;IAEtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IAClE,WAAW,CACT,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAE,EAC/B,KAAC,cAAc,cACb,KAAC,WAAW,cACV,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,GAAI,GACtB,GACC,CAClB,CAAA;AACH,CAAC"}

package/_lib/app/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../app/routes.tsx"],"names":[],"mappings":"AAyCA,eAAO,MAAM,MAAM;;;;;;;;;;IA2BM,CAAA"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../app/routes.tsx"],"names":[],"mappings":"AA+CA,eAAO,MAAM,MAAM;;;;;;;;;;IAgCM,CAAA"}

package/_lib/app/routes.js

@@ -3,17 +3,24 @@ import { routes as routes_virtual } from 'virtual:routes';
 import { NotFound } from './components/NotFound.js';
 import { DocsLayout } from './layouts/DocsLayout.js';
 import { Root } from './root.js';
+import { maybeHandleChunkError } from './utils/chunkError.js';
 const notFoundRoute = (() => {
     const virtualRoute = routes_virtual.find(({ path }) => path === '*');
     if (virtualRoute)
         return {
             path: virtualRoute.path,
             lazy: async () => {
-                const { frontmatter, ...route } = await virtualRoute.lazy();
-                return {
-                    ...route,
-                    element: (_jsx(Root, { frontmatter: frontmatter, path: virtualRoute.path, children: _jsx(DocsLayout, { children: _jsx(route.default, {}) }) })),
-                };
+                try {
+                    const { frontmatter, ...route } = await virtualRoute.lazy();
+                    return {
+                        ...route,
+                        element: (_jsx(Root, { frontmatter: frontmatter, path: virtualRoute.path, children: _jsx(DocsLayout, { children: _jsx(route.default, {}) }) })),
+                    };
+                }
+                catch (error) {
+                    maybeHandleChunkError(error);
+                    throw error;
+                }
             },
         };
     return {
@@ -28,11 +35,17 @@ export const routes = [
         .map((route_virtual) => ({
         path: route_virtual.path,
         lazy: async () => {
-            const { frontmatter, ...route } = await route_virtual.lazy();
-            return {
-                ...route,
-                element: (_jsx(Root, { content: decodeURIComponent(route_virtual.content ?? ''), filePath: route_virtual.filePath, frontmatter: frontmatter, lastUpdatedAt: route_virtual.lastUpdatedAt, path: route_virtual.path, children: _jsx(DocsLayout, { children: _jsx(route.default, {}) }) })),
-            };
+            try {
+                const { frontmatter, ...route } = await route_virtual.lazy();
+                return {
+                    ...route,
+                    element: (_jsx(Root, { content: decodeURIComponent(route_virtual.content ?? ''), filePath: route_virtual.filePath, frontmatter: frontmatter, lastUpdatedAt: route_virtual.lastUpdatedAt, path: route_virtual.path, children: _jsx(DocsLayout, { children: _jsx(route.default, {}) }) })),
+                };
+            }
+            catch (error) {
+                maybeHandleChunkError(error);
+                throw error;
+            }
         },
     })),
     notFoundRoute,

package/_lib/app/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../app/routes.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGzD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE;IAC1B,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAA;IACpE,IAAI,YAAY;QACd,OAAO;YACL,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAA;gBAE3D,OAAO;oBACL,GAAG,KAAK;oBACR,OAAO,EAAE,CACP,KAAC,IAAI,IAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,YACrD,KAAC,UAAU,cACT,KAAC,KAAK,CAAC,OAAO,KAAG,GACN,GACR,CACR;iBACoB,CAAA;YACzB,CAAC;SACF,CAAA;IAEH,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,MAAM;QACjB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CACP,KAAC,IAAI,IAAC,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAC,GAAG,YAChD,KAAC,UAAU,cACT,KAAC,QAAQ,KAAG,GACD,GACR,CACR;KACF,CAAA;AACH,CAAC,CAAC,EAAE,CAAA;AAEJ,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,cAAc;SACd,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC;SAClC,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAA;YAE5D,OAAO;gBACL,GAAG,KAAK;gBACR,OAAO,EAAE,CACP,KAAC,IAAI,IACH,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,EACxD,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAChC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,CAAC,aAAa,EAC1C,IAAI,EAAE,aAAa,CAAC,IAAI,YAExB,KAAC,UAAU,cACT,KAAC,KAAK,CAAC,OAAO,KAAG,GACN,GACR,CACR;aACoB,CAAA;QACzB,CAAC;KACF,CAAC,CAAC;IACL,aAAa;CACU,CAAA"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../app/routes.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGzD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE;IAC1B,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAA;IACpE,IAAI,YAAY;QACd,OAAO;YACL,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,IAAI,CAAC;oBACH,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAA;oBAE3D,OAAO;wBACL,GAAG,KAAK;wBACR,OAAO,EAAE,CACP,KAAC,IAAI,IAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,YACrD,KAAC,UAAU,cACT,KAAC,KAAK,CAAC,OAAO,KAAG,GACN,GACR,CACR;qBACoB,CAAA;gBACzB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,qBAAqB,CAAC,KAAc,CAAC,CAAA;oBACrC,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC;SACF,CAAA;IAEH,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,MAAM;QACjB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CACP,KAAC,IAAI,IAAC,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAC,GAAG,YAChD,KAAC,UAAU,cACT,KAAC,QAAQ,KAAG,GACD,GACR,CACR;KACF,CAAA;AACH,CAAC,CAAC,EAAE,CAAA;AAEJ,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,cAAc;SACd,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC;SAClC,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAA;gBAE5D,OAAO;oBACL,GAAG,KAAK;oBACR,OAAO,EAAE,CACP,KAAC,IAAI,IACH,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,EACxD,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAChC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,CAAC,aAAa,EAC1C,IAAI,EAAE,aAAa,CAAC,IAAI,YAExB,KAAC,UAAU,cACT,KAAC,KAAK,CAAC,OAAO,KAAG,GACN,GACR,CACR;iBACoB,CAAA;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,qBAAqB,CAAC,KAAc,CAAC,CAAA;gBACrC,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IACL,aAAa;CACU,CAAA"}

package/_lib/app/utils/chunkError.d.ts

@@ -0,0 +1,4 @@
+export declare function isChunkError(error: Error): boolean;
+export declare function maybeHandleChunkError(error: Error): void;
+export declare function clearChunkReloadFlag(): void;
+//# sourceMappingURL=chunkError.d.js.map

package/_lib/app/utils/chunkError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkError.d.ts","sourceRoot":"","sources":["../../../app/utils/chunkError.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,WASxC;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,QAQjD;AAED,wBAAgB,oBAAoB,SAEnC"}

package/_lib/app/utils/chunkError.js

@@ -0,0 +1,26 @@
+export function isChunkError(error) {
+    if (!error)
+        return false;
+    if (!error.message)
+        return false;
+    const message = error.message.toLowerCase();
+    return (message.includes('failed to fetch dynamically imported module') || // Chrome
+        message.includes('error loading dynamically imported module') || // Firefox/Safari
+        message.includes('dynamically imported module') // fallback
+    );
+}
+export function maybeHandleChunkError(error) {
+    if (!isChunkError(error))
+        return;
+    if (sessionStorage.getItem(reloadKey)) {
+        sessionStorage.removeItem(reloadKey);
+        return;
+    }
+    sessionStorage.setItem(reloadKey, 'true');
+    window.location.reload();
+}
+export function clearChunkReloadFlag() {
+    sessionStorage.removeItem(reloadKey);
+}
+const reloadKey = 'vocs.reload';
+//# sourceMappingURL=chunkError.js.map

package/_lib/app/utils/chunkError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkError.js","sourceRoot":"","sources":["../../../app/utils/chunkError.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAChC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;IAC3C,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,6CAA6C,CAAC,IAAI,SAAS;QAC5E,OAAO,CAAC,QAAQ,CAAC,2CAA2C,CAAC,IAAI,iBAAiB;QAClF,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC,WAAW;KAC5D,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAY;IAChD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,OAAM;IAChC,IAAI,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QACpC,OAAM;IACR,CAAC;IACD,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACzC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;AACtC,CAAC;AAED,MAAM,SAAS,GAAG,aAAa,CAAA"}

package/_lib/app/utils/hydrateLazyRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydrateLazyRoutes.d.ts","sourceRoot":"","sources":["../../../app/utils/hydrateLazyRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAE5D,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,iBAiB1F"}
+{"version":3,"file":"hydrateLazyRoutes.d.ts","sourceRoot":"","sources":["../../../app/utils/hydrateLazyRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAI5D,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,iBAsB1F"}

package/_lib/app/utils/hydrateLazyRoutes.js

@@ -1,17 +1,23 @@
 import { matchRoutes } from 'react-router';
+import { maybeHandleChunkError } from './chunkError.js';
 export async function hydrateLazyRoutes(routes, basePath) {
     // Determine if any of the initial routes are lazy
     const lazyMatches = matchRoutes(routes, window.location, basePath)?.filter((m) => m.route.lazy);
     // Load the lazy matches and update the routes before creating your router
     // so we can hydrate the SSR-rendered content synchronously
-    if (lazyMatches && lazyMatches?.length > 0) {
-        await Promise.all(lazyMatches.map(async (m) => {
-            const routeModule = typeof m.route.lazy === 'function' ? await m.route.lazy() : m.route.lazy;
-            Object.assign(m.route, {
-                ...routeModule,
-                lazy: undefined,
-            });
-        }));
-    }
+    if (lazyMatches && lazyMatches?.length > 0)
+        try {
+            await Promise.all(lazyMatches.map(async (m) => {
+                const routeModule = typeof m.route.lazy === 'function' ? await m.route.lazy() : m.route.lazy;
+                Object.assign(m.route, {
+                    ...routeModule,
+                    lazy: undefined,
+                });
+            }));
+        }
+        catch (error) {
+            maybeHandleChunkError(error);
+            throw error;
+        }
 }
 //# sourceMappingURL=hydrateLazyRoutes.js.map

package/_lib/app/utils/hydrateLazyRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"hydrateLazyRoutes.js","sourceRoot":"","sources":["../../../app/utils/hydrateLazyRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAA;AAE5D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAqB,EAAE,QAA4B;IACzF,kDAAkD;IAClD,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAE/F,0EAA0E;IAC1E,2DAA2D;IAC3D,IAAI,WAAW,IAAI,WAAW,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,CAAC,GAAG,CACf,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;YAC5F,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE;gBACrB,GAAG,WAAW;gBACd,IAAI,EAAE,SAAS;aAChB,CAAC,CAAA;QACJ,CAAC,CAAC,CACH,CAAA;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"hydrateLazyRoutes.js","sourceRoot":"","sources":["../../../app/utils/hydrateLazyRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAA;AAE5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAqB,EAAE,QAA4B;IACzF,kDAAkD;IAClD,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAE/F,0EAA0E;IAC1E,2DAA2D;IAC3D,IAAI,WAAW,IAAI,WAAW,EAAE,MAAM,GAAG,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,GAAG,CACf,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBAC1B,MAAM,WAAW,GACf,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;gBAC1E,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE;oBACrB,GAAG,WAAW;oBACd,IAAI,EAAE,SAAS;iBAChB,CAAC,CAAA;YACJ,CAAC,CAAC,CACH,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAc,CAAC,CAAA;YACrC,MAAM,KAAK,CAAA;QACb,CAAC;AACL,CAAC"}

package/_lib/cli/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "1.3.0";
+export declare const version = "1.3.1";
 //# sourceMappingURL=version.d.js.map

package/_lib/cli/version.js

@@ -1,2 +1,2 @@
-export const version = '1.3.0';
+export const version = '1.3.1';
 //# sourceMappingURL=version.js.map

package/app/index.client.tsx

@@ -5,6 +5,7 @@ import { hydrateRoot } from 'react-dom/client'
 import { createBrowserRouter, RouterProvider } from 'react-router'
 import { ConfigProvider, getConfig } from './hooks/useConfig.js'
 import { routes } from './routes.js'
+import { clearChunkReloadFlag } from './utils/chunkError.js'
 import { hydrateLazyRoutes } from './utils/hydrateLazyRoutes.js'
 import { removeTempStyles } from './utils/removeTempStyles.js'
 
@@ -15,6 +16,7 @@ async function hydrate() {
 
   await hydrateLazyRoutes(routes, basePath)
   removeTempStyles()
+  clearChunkReloadFlag()
 
   const router = createBrowserRouter(routes, { basename: basePath })
   hydrateRoot(

package/app/routes.tsx

@@ -4,6 +4,7 @@ import type { RouteObject } from 'react-router'
 import { NotFound } from './components/NotFound.js'
 import { DocsLayout } from './layouts/DocsLayout.js'
 import { Root } from './root.js'
+import { maybeHandleChunkError } from './utils/chunkError.js'
 
 const notFoundRoute = (() => {
   const virtualRoute = routes_virtual.find(({ path }) => path === '*')
@@ -11,18 +12,23 @@ const notFoundRoute = (() => {
     return {
       path: virtualRoute.path,
       lazy: async () => {
-        const { frontmatter, ...route } = await virtualRoute.lazy()
+        try {
+          const { frontmatter, ...route } = await virtualRoute.lazy()
 
-        return {
-          ...route,
-          element: (
-            <Root frontmatter={frontmatter} path={virtualRoute.path}>
-              <DocsLayout>
-                <route.default />
-              </DocsLayout>
-            </Root>
-          ),
-        } satisfies RouteObject
+          return {
+            ...route,
+            element: (
+              <Root frontmatter={frontmatter} path={virtualRoute.path}>
+                <DocsLayout>
+                  <route.default />
+                </DocsLayout>
+              </Root>
+            ),
+          } satisfies RouteObject
+        } catch (error) {
+          maybeHandleChunkError(error as Error)
+          throw error
+        }
       },
     }
 
@@ -45,24 +51,29 @@ export const routes = [
     .map((route_virtual) => ({
       path: route_virtual.path,
       lazy: async () => {
-        const { frontmatter, ...route } = await route_virtual.lazy()
+        try {
+          const { frontmatter, ...route } = await route_virtual.lazy()
 
-        return {
-          ...route,
-          element: (
-            <Root
-              content={decodeURIComponent(route_virtual.content ?? '')}
-              filePath={route_virtual.filePath}
-              frontmatter={frontmatter}
-              lastUpdatedAt={route_virtual.lastUpdatedAt}
-              path={route_virtual.path}
-            >
-              <DocsLayout>
-                <route.default />
-              </DocsLayout>
-            </Root>
-          ),
-        } satisfies RouteObject
+          return {
+            ...route,
+            element: (
+              <Root
+                content={decodeURIComponent(route_virtual.content ?? '')}
+                filePath={route_virtual.filePath}
+                frontmatter={frontmatter}
+                lastUpdatedAt={route_virtual.lastUpdatedAt}
+                path={route_virtual.path}
+              >
+                <DocsLayout>
+                  <route.default />
+                </DocsLayout>
+              </Root>
+            ),
+          } satisfies RouteObject
+        } catch (error) {
+          maybeHandleChunkError(error as Error)
+          throw error
+        }
       },
     })),
   notFoundRoute,

package/app/utils/chunkError.ts

@@ -0,0 +1,26 @@
+export function isChunkError(error: Error) {
+  if (!error) return false
+  if (!error.message) return false
+  const message = error.message.toLowerCase()
+  return (
+    message.includes('failed to fetch dynamically imported module') || // Chrome
+    message.includes('error loading dynamically imported module') || // Firefox/Safari
+    message.includes('dynamically imported module') // fallback
+  )
+}
+
+export function maybeHandleChunkError(error: Error) {
+  if (!isChunkError(error)) return
+  if (sessionStorage.getItem(reloadKey)) {
+    sessionStorage.removeItem(reloadKey)
+    return
+  }
+  sessionStorage.setItem(reloadKey, 'true')
+  window.location.reload()
+}
+
+export function clearChunkReloadFlag() {
+  sessionStorage.removeItem(reloadKey)
+}
+
+const reloadKey = 'vocs.reload'

package/app/utils/hydrateLazyRoutes.ts

@@ -1,20 +1,27 @@
 import { matchRoutes, type RouteObject } from 'react-router'
 
+import { maybeHandleChunkError } from './chunkError.js'
+
 export async function hydrateLazyRoutes(routes: RouteObject[], basePath: string | undefined) {
   // Determine if any of the initial routes are lazy
   const lazyMatches = matchRoutes(routes, window.location, basePath)?.filter((m) => m.route.lazy)
 
   // Load the lazy matches and update the routes before creating your router
   // so we can hydrate the SSR-rendered content synchronously
-  if (lazyMatches && lazyMatches?.length > 0) {
-    await Promise.all(
-      lazyMatches.map(async (m) => {
-        const routeModule = typeof m.route.lazy === 'function' ? await m.route.lazy() : m.route.lazy
-        Object.assign(m.route, {
-          ...routeModule,
-          lazy: undefined,
-        })
-      }),
-    )
-  }
+  if (lazyMatches && lazyMatches?.length > 0)
+    try {
+      await Promise.all(
+        lazyMatches.map(async (m) => {
+          const routeModule =
+            typeof m.route.lazy === 'function' ? await m.route.lazy() : m.route.lazy
+          Object.assign(m.route, {
+            ...routeModule,
+            lazy: undefined,
+          })
+        }),
+      )
+    } catch (error) {
+      maybeHandleChunkError(error as Error)
+      throw error
+    }
 }

package/cli/version.ts

@@ -1 +1 @@
-export const version = '1.3.0'
+export const version = '1.3.1'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vocs",
   "description": "React Documentation Generator, powered by Vite.",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "type": "module",
   "bin": {
     "vocs": "./_lib/cli/index.js"