chore: upgrade docusaurus from 3.2.1 to 3.7.0 (#52 by @markrickert)

To do this upgrade, I generated a brand new docusarus project with their
cli tool, copied over all the relevant content to this new instance &
ensured everything worked.

Then deleted the primary instance’s files, copied over the upgraded
instance’s files, and compared the git diffs. Turns out that there
weren’t that many changes needed.

The babel customization file didn’t need to be there (it’s on by
default) and many of the packages listed in the package.json are no
longer needed.

Co-authored-by: Jamon Holmgren <[email protected]>

Author: markrickert

babel.config.js

@@ -1,21 +1,19 @@
 // @ts-check
 // Note: type annotations allow type checking and IDEs autocompletion
 
-import {Options} from '@docusaurus/preset-classic';
-import {irCode} from './src/themes/ir-code';
-import type {Config} from '@docusaurus/types';
-import type * as Preset from '@docusaurus/preset-classic';
+import { irCode } from './src/themes/ir-code';
+import type { Config } from '@docusaurus/types';
+import type { Options, ThemeConfig } from '@docusaurus/preset-classic';
 import sidebars from './sidebars';
 
-
 const lightCodeTheme = irCode.light;
 const darkCodeTheme = irCode.dark;
 
-const navbarItems = Object.keys(sidebars).map((sidebarId):{
-  type:string,
-  sidebarId:string,
-  position:'left' | 'right',
-  label: string,
+const navbarItems = Object.keys(sidebars).map((sidebarId): {
+  type: string;
+  sidebarId: string;
+  position: 'left' | 'right';
+  label: string;
 } => {
   return {
     type: 'docSidebar',
@@ -25,10 +23,7 @@ const navbarItems = Object.keys(sidebars).map((sidebarId):{
   };
 });
 
-
-
-
-const config:Config = {
+const config: Config = {
   title: 'Open Source at Infinite Red',
   tagline: 'Tools to supercharge your React Native development!',
   favicon: 'img/favicon.ico',
@@ -48,9 +43,9 @@ const config:Config = {
   onBrokenLinks: 'throw',
   onBrokenMarkdownLinks: 'throw',
 
-  // Even if you don't use internalization, you can use this field to set useful
-  // metadata like html lang. For example, if your site is Chinese, you may want
-  // to replace "en" with "zh-Hans".
+  // Even if you don't use internationalization, you can use this field to set
+  // useful metadata like html lang. For example, if your site is Chinese, you
+  // may want to replace 'en' with 'zh-Hans'.
   i18n: {
     defaultLocale: 'en',
     locales: ['en'],
@@ -63,7 +58,7 @@ const config:Config = {
   presets: [
     [
       'classic',
-      ({
+      {
         docs: {
           sidebarPath: require.resolve('./sidebars.js'),
           routeBasePath: '/',
@@ -75,8 +70,8 @@ const config:Config = {
           trackingID: 'G-H431N07LX7',
           anonymizeIP: true,
         },
-      }) satisfies Options,
-    ] ,
+      } satisfies Options,
+    ],
   ],
 
   themeConfig:

docusaurus.config.ts

@@ -17,31 +17,20 @@
     "postinstall": "node ./scripts/generate-slug.ts"
   },
   "dependencies": {
-    "@docusaurus/core": "3.2.1",
-    "@docusaurus/preset-classic": "3.2.1",
-    "@docusaurus/remark-plugin-npm2yarn": "3.2.1",
+    "@docusaurus/core": "3.7.0",
+    "@docusaurus/preset-classic": "3.7.0",
     "@mdx-js/react": "^3.0.0",
-    "brfs": "^2.0.2",
-    "browserify-fs": "^1.0.0",
-    "buffer": "^6.0.3",
-    "clsx": "^1.2.1",
-    "https-browserify": "^1.0.0",
-    "os-browserify": "^0.3.0",
-    "path-browserify": "^1.0.1",
-    "prism-react-renderer": "^2.3.1",
-    "process": "^0.11.10",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "stream-browserify": "^3.0.0",
-    "stream-http": "^3.2.0",
-    "util": "^0.12.5"
+    "clsx": "^2.0.0",
+    "prism-react-renderer": "^2.3.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.1.1",
-    "@docusaurus/tsconfig": "^3.0.0",
-    "@docusaurus/types": "3.1.1",
-    "@types/react": "^18.2.29",
-    "typescript": "^5.2.2"
+    "@docusaurus/module-type-aliases": "3.7.0",
+    "@docusaurus/tsconfig": "3.7.0",
+    "@docusaurus/types": "3.7.0",
+    "@types/react": "^19.0.0",
+    "typescript": "~5.6.2"
   },
   "browserslist": {
     "production": [
@@ -50,9 +39,9 @@
       "not op_mini all"
     ],
     "development": [
-      "last 1 chrome version",
-      "last 1 firefox version",
-      "last 1 safari version"
+      "last 3 chrome version",
+      "last 3 firefox version",
+      "last 5 safari version"
     ]
   },
   "engines": {

package.json

@@ -4,6 +4,7 @@
   "compilerOptions": {
     "baseUrl": ".",
     "jsx": "react",
-    "resolveJsonModule": true,
-  }
+    "resolveJsonModule": true
+  },
+  "exclude": [".docusaurus", "build"]
 }