chore: docs, prettier fixes (#8400)

## Summary

Fixing a bunch of problems in the repo and the docs.

This PR was extracted from #7702.

Key changes:

- Bumped prettier repo-wise.
- Bump eslint-plugin-jsdoc since it was bugged with newer prettier.
- Updated the use of prettier in docs.
- Moves prettier and typescript to explicit dependencies of the docs.
- Fixed broken anchors in the docs.
- Bumped Reanimated and Worklets in docs be able to import
`DynamicColorIOS`.
- Ignored webpack-typescript related error.
- Bump docusarus deps to exact versions in docs.
- Fixed deprecated import uses in the docs.
- Made the docs throw on broken anchors.

## Test plan

CI.

The docs run fine locally.

Author: tjzel

apps/common-app/package.json

@@ -70,7 +70,7 @@
     "jest": "^29.6.3",
     "madge": "^5.0.1",
     "patch-package": "^8.0.0",
-    "prettier": "^3.3.3",
+    "prettier": "3.6.2",
     "react-native": "0.82.0",
     "react-native-monorepo-tools": "^1.2.1",
     "react-test-renderer": "19.1.1",

apps/fabric-example/package.json

@@ -15,7 +15,7 @@
     "react-native": "0.82.0"
   },
   "devDependencies": {
-    "prettier": "^3.3.3"
+    "prettier": "3.6.2"
   },
   "engines": {
     "node": ">=20.13.0"

apps/macos-example/package.json

@@ -24,7 +24,7 @@
     "@react-native/eslint-config": "0.75.4",
     "@react-native/metro-config": "0.75.4",
     "@react-native/typescript-config": "0.75.4",
-    "prettier": "^3.3.3"
+    "prettier": "3.6.2"
   },
   "engines": {
     "node": ">=20.13.0"

apps/next-example/package.json

@@ -30,7 +30,7 @@
     "cypress": "^13.2.0",
     "eslint": "^9.29.0",
     "next-compose-plugins": "^2.2.1",
-    "prettier": "^3.3.3",
+    "prettier": "3.6.2",
     "start-server-and-test": "^2.0.1"
   },
   "installConfig": {

apps/tvos-example/package.json

@@ -31,7 +31,7 @@
     "babel-jest": "^29.6.3",
     "eslint": "^9.29.0",
     "jest": "^29.6.3",
-    "prettier": "^3.3.3",
+    "prettier": "3.6.2",
     "react-test-renderer": "19.1.0",
     "typescript": "^5.8.3"
   },

apps/web-example/package.json

@@ -21,7 +21,7 @@
   "devDependencies": {
     "@expo/metro-runtime": "~6.1.1",
     "@stylexjs/babel-plugin": "^0.10.0",
-    "prettier": "^3.3.3",
+    "prettier": "3.6.2",
     "serve": "^14.2.3"
   },
   "installConfig": {

docs/docs-reanimated/docs/guides/troubleshooting.mdx

@@ -63,7 +63,7 @@ See [Couldn't determine the version of the native part of Reanimated](#couldnt-d
 
 ### Mismatch between C++ code version and JavaScript code version
 
-See [Mismatch between JavaScript part and native part of Reanimated](#mismatch-between-javascript-part-and-native-part-of-reanimated) and [Mismatch between JavaScript code version and Reanimated Babel plugin version](#mismatch-between-javascript-code-version-and-reanimated-babel-plugin-version).
+See [Mismatch between JavaScript part and native part of Reanimated](#mismatch-between-javascript-part-and-native-part-of-reanimated) and [Mismatch between JavaScript code version and Reanimated Babel plugin version](https://docs.swmansion.com/react-native-worklets/docs/guides/troubleshooting#mismatch-between-javascript-code-version-and-worklets-babel-plugin-version).
 
 ### C++ side failed to resolve Java code version
 
@@ -75,7 +75,7 @@ See [Mismatch between JavaScript part and native part of Reanimated](#mismatch-b
 
 **Problem:** This happens when Reanimated has different versions of its C++ and Java parts.
 
-**Solution:** See [Native side failed to resolve Java code version](#c-side-failed-to-resolve-javas-code-version).
+**Solution:** See [Native side failed to resolve Java code version](#c-side-failed-to-resolve-java-code-version).
 
 ### Java side failed to resolve C++ code version
 

docs/docs-reanimated/docs/guides/web-support.mdx

@@ -139,7 +139,7 @@ const dv = useDerivedValue(() => sv.value, [sv]);
 
 ## Solito / Next.js Compatibility
 
-There is an experimental SWC plugin in the works. However, given that this may not work properly, you can use the [Web without a Babel plugin](#web-without-a-babel-plugin) instructions above.
+There is an experimental SWC plugin in the works. However, given that this may not work properly, you can use the [Web without a Babel plugin](#web-without-the-babel-plugin) instructions above.
 
 ### Next.js Polyfill
 

docs/docs-reanimated/docusaurus.config.js

@@ -30,8 +30,14 @@ const config = {
     },
   ],
 
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'throw',
+    },
+  },
+
   onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'throw',
+  onBrokenAnchors: '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
@@ -213,6 +219,24 @@ const config = {
               alias: { 'react-native$': 'react-native-web' },
               extensions: ['.web.js', '...'],
             },
+            ignoreWarnings: [
+              (error) => {
+                /*
+                 * Ignore warning we can't fix:
+                 * "moduleName":"./node_modules/typescript/lib/typescript.js","loc":"50:2440-2459","message":"Critical dependency: the request of a dependency is an expression"
+                 */
+                if (
+                  error.message.includes(
+                    'Critical dependency: the request of a dependency is an expression'
+                  ) &&
+                  // @ts-expect-error Not exposed type.
+                  error?.module?.context?.includes('typescript/lib')
+                ) {
+                  return true;
+                }
+                return false;
+              },
+            ],
           };
         },
       };

docs/docs-reanimated/package.json

@@ -24,9 +24,9 @@
     "@babel/preset-react": "7.27.1",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/modifiers": "^9.0.0",
-    "@docusaurus/core": "^3.8.1",
-    "@docusaurus/plugin-debug": "^3.8.1",
-    "@docusaurus/preset-classic": "^3.8.1",
+    "@docusaurus/core": "3.9.1",
+    "@docusaurus/plugin-debug": "3.9.1",
+    "@docusaurus/preset-classic": "3.9.1",
     "@emotion/react": "11.14.0",
     "@emotion/styled": "11.14.0",
     "@mdx-js/react": "3.0.0",
@@ -41,6 +41,7 @@
     "babel-preset-react-native": "4.0.1",
     "clsx": "2.1.0",
     "glob": "10.4.2",
+    "prettier": "3.6.2",
     "prism-react-renderer": "2.1.0",
     "raf": "3.4.1",
     "raw-loader": "4.0.2",
@@ -49,24 +50,24 @@
     "react-dom": "^19.1.1",
     "react-native": "0.71.4",
     "react-native-gesture-handler": "^2.28.0",
-    "react-native-reanimated": "4.0.0",
+    "react-native-reanimated": "4.2.0-nightly-20251015-0297d2990",
     "react-native-svg": "15.12.0",
     "react-native-web": "^0.21.1",
-    "react-native-worklets": "0.4.0",
+    "react-native-worklets": "0.7.0-nightly-20251015-0297d2990",
     "source-map": "0.7.4",
     "source-map-loader": "4.0.1",
+    "typescript": "5.8.3",
     "usehooks-ts": "2.9.1"
   },
   "devDependencies": {
     "@babel/preset-flow": "7.25.9",
-    "@docusaurus/module-type-aliases": "^3.8.1",
-    "@docusaurus/tsconfig": "3.8.1",
-    "@docusaurus/types": "3.8.1",
+    "@docusaurus/module-type-aliases": "3.9.1",
+    "@docusaurus/tsconfig": "3.9.1",
+    "@docusaurus/types": "3.9.1",
     "copy-webpack-plugin": "11.0.0",
     "esbuild": "0.25.0",
     "esbuild-register": "3.5.0",
     "eslint-plugin-mdx": "2.2.0",
-    "prettier": "2.8.4",
     "webpack-cli": "5.0.1"
   },
   "browserslist": {