chore: Update Docusaurus to 3.7.0 (#36)

* Add script for updating docusaurus

* Bump docusaurus version

* Add readme section for updating docusaurus

* fix JSX import in React 19

* Fix formatting

* Comment out broken anchors

Author: Krzemien97

README.md

@@ -68,6 +68,21 @@ yarn start
 A new browser tab will open at http://localhost:3000, reflecting any changes
 made to the files.
 
+### Updating docusaurus
+
+To update Docusaurus correctly, execute the following command:
+
+```
+yarn upgrade @docusaurus -L
+```
+
+Next, remove the `yarn.lock` file along with the `node_modules` and `build` directories. After deletion, regenerate the necessary files with updated dependency versions by running:
+
+```
+yarn install
+```
+
+
 ## Editing the documentation
 
 ### Creating documents

docs/leo-rover/integrations/legacy/arbotix.mdx

@@ -297,8 +297,8 @@ rostopic pub /dynamixel1/command std_msg/Float64 -- 0.0
 
 :::info
 
-The maximum angle range for a Dynamixel servo is [-150, 150] degrees which is equal
-to approximately [-2.62, 2.62] in radians
+The maximum angle range for a Dynamixel servo is [-150, 150] degrees which is
+equal to approximately [-2.62, 2.62] in radians
 
 :::
 

docs/rapha-rover/specification/ros-api.mdx

@@ -533,16 +533,17 @@ string status_message
   https://docs.ros2.org/latest/api/tf2_msgs/msg/TFMessage.html
 [rapha_interfaces/msg/BatteryMode]: #msg-battery-mode
 [rapha_interfaces/msg/BatteryState]: #msg-battery-state
-[rapha_interfaces/msg/ImuDiagnostics]: #msg-imu-diagnostics
-[rapha_interfaces/msg/Led]: #msg-led
-[rapha_interfaces/msg/LedColor]: #msg-led-color
-[rapha_interfaces/msg/LedPanel]: #msg-led-panel
-[rapha_interfaces/msg/LedPanelState]: #msg-led-panel-state
+
+{/* [rapha_interfaces/msg/ImuDiagnostics]: #msg-imu-diagnostics */}
+[rapha_interfaces/msg/Led]: #msg-led [rapha_interfaces/msg/LedColor]:
+#msg-led-color [rapha_interfaces/msg/LedPanel]: #msg-led-panel
+{/* [rapha_interfaces/msg/LedPanelState]: #msg-led-panel-state */}
 [rapha_interfaces/msg/LedState]: #msg-led-state
-[rapha_interfaces/msg/LedStripState]: #msg-led-strip-state
-[rapha_interfaces/msg/MotorDiagnostics]: #msg-motor-diagnostics
-[rapha_interfaces/msg/PowerSystemState]: #msg-power-system-state
-[rapha_interfaces/msg/SteeringMode]: #msg-steering-mode
-[rapha_interfaces/srv/SetBatteryModes]: #srv-set-battery-modes
-[rapha_interfaces/srv/SetLeds]: #srv-set-leds
-[rapha_interfaces/srv/SetSteeringMode]: #srv-set-steering-mode
+
+{/* [rapha_interfaces/msg/LedStripState]: #msg-led-strip-state */}
+{/* [rapha_interfaces/msg/MotorDiagnostics]: #msg-motor-diagnostics */}
+{/* [rapha_interfaces/msg/PowerSystemState]: #msg-power-system-state */}
+{/* [rapha_interfaces/msg/SteeringMode]: #msg-steering-mode */}
+{/* [rapha_interfaces/srv/SetBatteryModes]: #srv-set-battery-modes */}
+{/* [rapha_interfaces/srv/SetLeds]: #srv-set-leds */}
+{/* [rapha_interfaces/srv/SetSteeringMode]: #srv-set-steering-mode */}

package.json

@@ -18,26 +18,26 @@
     "spellcheck": "cspell \"**/*.mdx\""
   },
   "dependencies": {
-    "@docusaurus/core": "3.5.2",
-    "@docusaurus/plugin-client-redirects": "3.5.2",
-    "@docusaurus/preset-classic": "3.5.2",
-    "@mdx-js/react": "^3.0.1",
+    "@docusaurus/core": "3.7.0",
+    "@docusaurus/plugin-client-redirects": "3.7.0",
+    "@docusaurus/preset-classic": "3.7.0",
+    "@mdx-js/react": "^3.1.0",
     "clsx": "^2.1.0",
     "medium-zoom": "^1.1.0",
-    "prism-react-renderer": "^2.3.1",
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0",
+    "prism-react-renderer": "^2.4.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "react-lite-youtube-embed": "^2.4.0",
-    "rehype-katex": "7",
+    "rehype-katex": "7.0.1",
     "remark-math": "6"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.5.2",
-    "@docusaurus/tsconfig": "3.5.2",
-    "@docusaurus/types": "3.5.2",
-    "cspell": "^8.8.4",
-    "prettier": "^3.3.1",
-    "typescript": "^5.4.5"
+    "@docusaurus/module-type-aliases": "3.7.0",
+    "@docusaurus/tsconfig": "3.7.0",
+    "@docusaurus/types": "3.7.0",
+    "cspell": "^8.17.3",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.3"
   },
   "browserslist": {
     "production": [

src/components/ImageZoom/index.tsx

@@ -1,4 +1,4 @@
-import { useRef, ComponentProps, RefCallback } from 'react';
+import { useRef, ComponentProps, RefCallback, JSX } from 'react';
 import mediumZoom, { Zoom } from 'medium-zoom';
 import styles from './styles.module.css';
 

src/data/features.tsx

@@ -1,3 +1,5 @@
+import { JSX } from 'react';
+
 export type FeatureItem = {
   name: string;
   image: {

src/pages/index.tsx

@@ -8,6 +8,7 @@ import Link from '@docusaurus/Link';
 import ThemedImage from '@theme/ThemedImage';
 
 import styles from './index.module.css';
+import { JSX } from 'react';
 
 function HomepageHeader() {
   const { siteConfig } = useDocusaurusContext();