fix(docusaurus): update and fix webpack issue (#1685)

* fix(docusaurus): update and fix webpack issue

* add @docusaurus/babel

Author: silviuaavram

babel.config.js

@@ -1,5 +1,19 @@
 const originalPreset = require('kcd-scripts/babel')
 const customPreset = api => {
+  // Docusaurus discovers this root babel.config.js (via getCustomBabelConfigFilePath)
+  // and passes it as configFile to its babel-loader, replacing its own preset.
+  // The kcd-scripts preset uses the classic JSX runtime, which breaks Docusaurus
+  // internals (e.g. TitleFormatterProvider) that import only named members from
+  // 'react' (no default React import). Defer to Docusaurus's own babel preset
+  // when invoked by Docusaurus (caller.name is 'client' or 'server').
+  const callerName = api.caller(caller => caller && caller.name)
+  if (callerName === 'client' || callerName === 'server') {
+    api.cache.using(() => callerName)
+    return {
+      presets: [require.resolve('@docusaurus/babel/preset')],
+      plugins: [require.resolve('babel-plugin-macros')],
+    }
+  }
   api.cache(true)
   const evaluatedPreset = originalPreset(api)
   const plugins = [

docusaurus/plugins/webpack5polyfills.js

@@ -12,6 +12,17 @@ module.exports = function () {
             module: false,
           },
         },
+        module: {
+          rules: [
+            // Some dependencies ship ESM that does directory-style imports
+            // (e.g. yaml's browser dist importing 'buffer'). Webpack 5 strict
+            // ESM resolution requires fully specified paths, so relax it.
+            {
+              test: /\.m?js$/,
+              resolve: {fullySpecified: false},
+            },
+          ],
+        },
         plugins: [new NodePolyfillPlugin()],
       }
     },

package.json

@@ -92,9 +92,10 @@
     "@babel/plugin-proposal-private-methods": "^7.18.6",
     "@babel/plugin-proposal-private-property-in-object": "^7.21.11",
     "@cypress/webpack-preprocessor": "^7.0.2",
-    "@docusaurus/core": "3.3.2",
-    "@docusaurus/module-type-aliases": "3.3.2",
-    "@docusaurus/preset-classic": "3.3.2",
+    "@docusaurus/core": "3.10.1",
+    "@docusaurus/babel": "3.10.1",
+    "@docusaurus/module-type-aliases": "3.10.1",
+    "@docusaurus/preset-classic": "3.10.1",
     "@mdx-js/react": "^3.0.1",
     "@rollup/plugin-babel": "^6.1.0",
     "@rollup/plugin-commonjs": "^29.0.0",