[WIP] Upgrade Docusaurus to v3.7.0 (#6851)

website/docusaurus.config.js

@@ -251,9 +251,7 @@ var siteSettings = {
           //showLastUpdateAuthor: false,
 
           sidebarCollapsible: true,
-          exclude: [
-            'hover-terms.md'
-          ]
+          exclude: ["hover-terms.md"],
         },
         blog: {
           blogTitle: "Developer Blog | dbt Developer Hub",
@@ -270,7 +268,6 @@ var siteSettings = {
   ],
   plugins: [
     [path.resolve("plugins/insertMetaTags"), { metatags }],
-    path.resolve("plugins/svg"),
     path.resolve("plugins/customWebpackConfig"),
     [
       path.resolve("plugins/buildGlobalData"),
@@ -313,6 +310,21 @@ var siteSettings = {
     { rel: "icon", href: "/img/favicon.png", type: "image/png" },
     { rel: "icon", href: "/img/favicon.svg", type: "image/svg+xml" },
   ],
+  future: {
+    // Enables all Docusaurus Faster features
+    // experimental_faster: true,
+    experimental_faster: {
+      swcJsLoader: true,
+      swcJsMinimizer: true,
+      swcHtmlMinimizer: true,
+      lightningCssMinimizer: true,
+      mdxCrossCompilerCache: true,
+      rspackBundler: true,
+
+      // Coming in v3.8.0
+      // ssgWorkerThreads: true,
+    },
+  },
 };
 
 // If versions json file found, add versions dropdown to nav

website/package.json

@@ -10,15 +10,16 @@
     "prepare": "cd .. && husky install"
   },
   "dependencies": {
-    "@docusaurus/core": "3.4.0",
-    "@docusaurus/plugin-ideal-image": "3.4.0",
-    "@docusaurus/preset-classic": "3.4.0",
-    "@docusaurus/theme-search-algolia": "3.4.0",
+    "@docusaurus/core": "3.7.0",
+    "@docusaurus/faster": "^3.7.0",
+    "@docusaurus/plugin-ideal-image": "3.7.0",
+    "@docusaurus/preset-classic": "3.7.0",
+    "@docusaurus/theme-search-algolia": "3.7.0",
     "@mdx-js/react": "^3.0.1",
     "@monaco-editor/react": "^4.4.6",
     "@stoplight/elements": "^7.5.8",
     "@svgr/webpack": "^6.0.0",
-    "axios": "^1.7.7",
+    "axios": "^1.7.9",
     "canvas-confetti": "^1.9.2",
     "classnames": "^2.3.1",
     "clsx": "^1.1.1",
@@ -32,7 +33,7 @@
     "js-yaml": "^4.1.0",
     "markdown-to-jsx": "^7.5.0",
     "mobx": "^6.3.9",
-    "node-polyfill-webpack-plugin": "^1.1.4",
+    "node-polyfill-webpack-plugin": "^3.0.0",
     "papaparse": "^5.3.2",
     "prism-react-renderer": "^2.3.1",
     "query-string": "^8.1.0",
@@ -42,7 +43,6 @@
     "react-is": "^18.1.0",
     "react-select": "^5.7.5",
     "react-tooltip": "^4.2.21",
-    "redoc": "^2.0.0-rc.57",
     "rehype-katex": "^7.0.1",
     "remark-math": "^3.0.1",
     "sanitize-html": "^2.8.0",
@@ -55,14 +55,15 @@
     "@dbt-labs/react-dbt-dag": "0.8.7"
   },
   "devDependencies": {
-    "@docusaurus/eslint-plugin": "3.4.0",
+    "@docusaurus/eslint-plugin": "3.7.0",
     "@swc/core": "^1.2.174",
     "@swc/jest": "^0.2.20",
     "@testing-library/jest-dom": "^6.4.6",
     "@testing-library/react": "^16.0.0",
     "@testing-library/user-event": "^14.5.2",
     "@typescript-eslint/eslint-plugin": "^5.54.0",
     "@typescript-eslint/parser": "^5.54.0",
+    "buffer": "^6.0.3",
     "css-loader": "^7.1.2",
     "cypress": "^13.11.0",
     "dotenv": "^10.0.0",

website/plugins/customWebpackConfig/index.js

@@ -1,34 +1,31 @@
-const webpack = require('webpack');
 const NodePolyfillPlugin = require("node-polyfill-webpack-plugin")
 
 // Adds custom configurations to webpack
 module.exports = function customWebpackConfigPlugin() {
   return {
-    name: 'docusaurus-custom-webpack-config-plugin',
-    configureWebpack() {   
-      return {        
-        resolve: {     
+    name: "docusaurus-custom-webpack-config-plugin",
+    configureWebpack(config, isServer, { currentBundler }) {
+      return {
+        resolve: {
           fallback: {
-            "fs": false,
-            "path": require.resolve("path-browserify"),
-            "http": require.resolve("stream-http"),
-            "tty": require.resolve("tty-browserify"),
-          }
+            fs: false,
+            path: require.resolve("path-browserify"),
+            http: require.resolve("stream-http"),
+            tty: require.resolve("tty-browserify"),
+          },
         },
         plugins: [
-          new webpack.DefinePlugin({
-            'process.versions.node': JSON.stringify(
-              process.versions.node || '0.0.0',
+          new currentBundler.instance.DefinePlugin({
+            "process.versions.node": JSON.stringify(
+              process.versions.node || "0.0.0"
             ),
           }),
           new NodePolyfillPlugin({}),
         ],
         module: {
-          rules: [
-            { test: /\.py$/, loader: 'raw-loader' }
-          ]
-        }
-      }
-    }
-  }
+          rules: [{ test: /\.py$/, loader: "raw-loader" }],
+        },
+      };
+    },
+  };
 }

website/src/theme/BlogPostPage/index.js

@@ -1,7 +1,10 @@
 import React, { useEffect } from 'react';
 import clsx from 'clsx';
 import {HtmlClassNameProvider, ThemeClassNames} from '@docusaurus/theme-common';
-import {BlogPostProvider, useBlogPost} from '@docusaurus/theme-common/internal';
+import {
+  BlogPostProvider,
+  useBlogPost,
+} from "@docusaurus/plugin-content-blog/client";
 import BlogLayout from '@theme/BlogLayout';
 import BlogPostItem from '@theme/BlogPostItem';
 import BlogPostPaginator from '@theme/BlogPostPaginator';

website/src/theme/DocCard/index.js

@@ -4,7 +4,7 @@ import Link from '@docusaurus/Link';
 import {
   findFirstSidebarItemLink,
   useDocById,
-} from '@docusaurus/theme-common/internal';
+} from "@docusaurus/plugin-content-docs/client";
 import {usePluralForm} from '@docusaurus/theme-common';
 import isInternalUrl from '@docusaurus/isInternalUrl';
 import {translate} from '@docusaurus/Translate';

website/src/theme/DocItem/Content/index.js

@@ -1,7 +1,7 @@
 import React from "react";
 import clsx from "clsx";
 import { ThemeClassNames } from "@docusaurus/theme-common";
-import { useDoc } from "@docusaurus/theme-common/internal";
+import { useDoc } from "@docusaurus/plugin-content-docs/client";
 import Heading from "@theme/Heading";
 import MDXContent from "@theme/MDXContent";
 /**

website/src/theme/DocItem/Layout/index.js

@@ -1,7 +1,7 @@
 import React, { useState, useEffect, useContext } from 'react';
 import clsx from 'clsx';
 import {useWindowSize} from '@docusaurus/theme-common';
-import {useDoc} from '@docusaurus/theme-common/internal';
+import { useDoc } from "@docusaurus/plugin-content-docs/client";
 import DocItemPaginator from '@theme/DocItem/Paginator';
 import DocVersionBanner from '@theme/DocVersionBanner';
 import DocVersionBadge from '@theme/DocVersionBadge';

website/src/theme/DocRoot/Layout/Main/index.js

@@ -1,9 +1,7 @@
 import React, { useState, useEffect, useContext } from "react";
 import clsx from "clsx";
-import {
-  useDocsSidebar,
-  useLocalPathname,
-} from "@docusaurus/theme-common/internal";
+import { useDocsSidebar } from "@docusaurus/plugin-content-docs/client";
+import { useLocalPathname } from "@docusaurus/theme-common/internal";
 import styles from "./styles.module.css";
 
 /* dbt Customizations: