@docusaurus/core 3.3.0 → 3.3.2

package/lib/client/clientEntry.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import React from 'react';
+import React, { startTransition } from 'react';
 import ReactDOM from 'react-dom/client';
 import { BrowserRouter } from 'react-router-dom';
 import { HelmetProvider } from 'react-helmet-async';
@@ -27,21 +27,24 @@ if (ExecutionEnvironment.canUseDOM) {
         console.error('Docusaurus React Root onRecoverableError:', error, errorInfo);
     };
     const renderApp = () => {
+        if (window.docusaurusRoot) {
+            window.docusaurusRoot.render(app);
+            return;
+        }
         if (hydrate) {
-            React.startTransition(() => {
-                ReactDOM.hydrateRoot(container, app, {
-                    onRecoverableError,
-                });
+            window.docusaurusRoot = ReactDOM.hydrateRoot(container, app, {
+                onRecoverableError,
             });
         }
         else {
             const root = ReactDOM.createRoot(container, { onRecoverableError });
-            React.startTransition(() => {
-                root.render(app);
-            });
+            root.render(app);
+            window.docusaurusRoot = root;
         }
     };
-    preload(window.location.pathname).then(renderApp);
+    preload(window.location.pathname).then(() => {
+        startTransition(renderApp);
+    });
     // Webpack Hot Module Replacement API
     if (module.hot) {
         // Self-accepting method/ trick

package/lib/client/docusaurus.d.ts

@@ -16,7 +16,7 @@ declare global {
     }
 }
 declare const _default: Readonly<{
-    prefetch(routePath: string): false | Promise<void[]>;
-    preload(routePath: string): false | Promise<void[]>;
+    prefetch: (url: string) => false | Promise<void[]>;
+    preload: (url: string) => false | Promise<void[]>;
 }>;
 export default _default;

package/lib/client/docusaurus.js

@@ -24,37 +24,39 @@ const getChunkNamesToLoad = (path) => Object.entries(routesChunkNames)
 // output: /blog/2018/12/14/Happy-First-Birthday-Slash
 ([routeNameWithHash]) => routeNameWithHash.replace(/-[^-]+$/, '') === path)
     .flatMap(([, routeChunks]) => Object.values(flat(routeChunks)));
-const docusaurus = {
-    prefetch(routePath) {
-        if (!canPrefetch(routePath)) {
-            return false;
-        }
-        fetched.add(routePath);
-        // Find all webpack chunk names needed.
-        const matches = matchRoutes(routes, routePath);
-        const chunkNamesNeeded = matches.flatMap((match) => getChunkNamesToLoad(match.route.path));
-        // Prefetch all webpack chunk assets file needed.
-        return Promise.all(chunkNamesNeeded.map((chunkName) => {
-            // "__webpack_require__.gca" is injected by ChunkAssetPlugin. Pass it
-            // the name of the chunk you want to load and it will return its URL.
-            // eslint-disable-next-line camelcase
-            const chunkAsset = __webpack_require__.gca(chunkName);
-            // In some cases, webpack might decide to optimize further, leading to
-            // the chunk assets being merged to another chunk. In this case, we can
-            // safely filter it out and don't need to load it.
-            if (chunkAsset && !chunkAsset.includes('undefined')) {
-                return prefetchHelper(chunkAsset);
-            }
-            return Promise.resolve();
-        }));
-    },
-    preload(routePath) {
-        if (!canPreload(routePath)) {
-            return false;
+const prefetch = (routePath) => {
+    if (!canPrefetch(routePath)) {
+        return false;
+    }
+    fetched.add(routePath);
+    // Find all webpack chunk names needed.
+    const matches = matchRoutes(routes, routePath);
+    const chunkNamesNeeded = matches.flatMap((match) => getChunkNamesToLoad(match.route.path));
+    // Prefetch all webpack chunk assets file needed.
+    return Promise.all(chunkNamesNeeded.map((chunkName) => {
+        // "__webpack_require__.gca" is injected by ChunkAssetPlugin. Pass it
+        // the name of the chunk you want to load and it will return its URL.
+        // eslint-disable-next-line camelcase
+        const chunkAsset = __webpack_require__.gca(chunkName);
+        // In some cases, webpack might decide to optimize further, leading to
+        // the chunk assets being merged to another chunk. In this case, we can
+        // safely filter it out and don't need to load it.
+        if (chunkAsset && !chunkAsset.includes('undefined')) {
+            return prefetchHelper(chunkAsset);
         }
-        loaded.add(routePath);
-        return preloadHelper(routePath);
-    },
+        return Promise.resolve();
+    }));
+};
+const preload = (routePath) => {
+    if (!canPreload(routePath)) {
+        return false;
+    }
+    loaded.add(routePath);
+    return preloadHelper(routePath);
+};
+const docusaurus = {
+    prefetch,
+    preload,
 };
 // This object is directly mounted onto window, better freeze it
 export default Object.freeze(docusaurus);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -43,12 +43,12 @@
     "@babel/runtime": "^7.22.6",
     "@babel/runtime-corejs3": "^7.22.6",
     "@babel/traverse": "^7.22.8",
-    "@docusaurus/cssnano-preset": "3.3.0",
-    "@docusaurus/logger": "3.3.0",
-    "@docusaurus/mdx-loader": "3.3.0",
-    "@docusaurus/utils": "3.3.0",
-    "@docusaurus/utils-common": "3.3.0",
-    "@docusaurus/utils-validation": "3.3.0",
+    "@docusaurus/cssnano-preset": "3.3.2",
+    "@docusaurus/logger": "3.3.2",
+    "@docusaurus/mdx-loader": "3.3.2",
+    "@docusaurus/utils": "3.3.2",
+    "@docusaurus/utils-common": "3.3.2",
+    "@docusaurus/utils-validation": "3.3.2",
     "autoprefixer": "^10.4.14",
     "babel-loader": "^9.1.3",
     "babel-plugin-dynamic-import-node": "^2.3.3",
@@ -103,8 +103,8 @@
     "webpackbar": "^5.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.3.0",
-    "@docusaurus/types": "3.3.0",
+    "@docusaurus/module-type-aliases": "3.3.2",
+    "@docusaurus/types": "3.3.2",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/detect-port": "^1.3.3",
     "@types/react-dom": "^18.2.7",
@@ -124,5 +124,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "2ec4e078b5ca0c57f2cc04f2fe564d524bb5e858"
+  "gitHead": "bc638d674bfbde1e254ef306697f47e764b5e107"
 }