chore: add syncpack to monorepo, align dependency semver ranges, add to CI/lints

.github/workflows/lint-autofix.yml

@@ -45,6 +45,9 @@ jobs:
       - name: AutoFix Spelling
         run: yarn lint:spelling:fix
 
+      - name: AutoFix Dependency versions
+        run: yarn lint:spelling:fix
+
       - name: Print Diff
         run: git diff
 

.syncpackrc.ts

@@ -0,0 +1,98 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import fs from 'fs-extra';
+import type {RcFile} from 'syncpack';
+
+const lernaJson = await fs.readJSON('./lerna.json');
+
+const CurrentDocusaurusVersion = lernaJson.version;
+
+export default {
+  source: [
+    'package.json',
+    'packages/*/package.json',
+    'website/package.json',
+    'argos/package.json',
+    'packages/create-docusaurus/templates/*/package.json',
+  ],
+
+  semverGroups: [
+    {
+      label: 'Use ~ for TypeScript monorepo root and init templates',
+      dependencies: ['typescript'],
+      range: '~',
+    },
+  ],
+
+  versionGroups: [
+    {
+      label: 'Ignore * deps in type-alias packages',
+      packages: [
+        '@docusaurus/module-type-aliases',
+        '@docusaurus/theme-common',
+        '@docusaurus/types',
+      ],
+      dependencies: [
+        'react',
+        'react-dom',
+        '@types/react',
+        '@types/react-router-config',
+        '@types/react-router-dom',
+      ],
+      isIgnored: true,
+    },
+
+    {
+      label: 'Ignore * internal peerDependencies',
+      packages: [
+        '@docusaurus/core',
+        '@docusaurus/bundler',
+        '@docusaurus/faster',
+
+        // TODO Docusaurus v4: refactor, these peerDeps shouldn't be needed
+        '@docusaurus/plugin-content-blog',
+        '@docusaurus/theme-common',
+      ],
+      dependencyTypes: ['peer'],
+      dependencies: [
+        '@docusaurus/faster',
+        '@docusaurus/plugin-content-docs',
+        '@docusaurus/types',
+      ],
+      isIgnored: true,
+    },
+
+    {
+      label: 'Ignore broad ESLint peerDep range in ESLint plugin',
+      packages: ['@docusaurus/eslint-plugin'],
+      dependencyTypes: ['peer'],
+      dependencies: ['eslint'],
+      isIgnored: true,
+    },
+
+    {
+      label: 'Ignore >= TS range in @docusaurus/tsconfig',
+      packages: ['@docusaurus/tsconfig'],
+      dependencyTypes: ['peer'],
+      isIgnored: true,
+    },
+
+    {
+      label: 'Internal @docusaurus/* monorepo packages use pinned version',
+      dependencies: [
+        '@docusaurus/**',
+
+        // This one is not a monorepo package
+        '!@docusaurus/responsive-loader',
+      ],
+      pinVersion: CurrentDocusaurusVersion,
+    },
+
+    // Default: all remaining dependencies — highest version wins (syncpack default)
+  ],
+} satisfies RcFile;

package.json

@@ -57,14 +57,16 @@
     "prepare": "husky install",
     "format": "prettier --write .",
     "format:diff": "prettier --list-different .",
-    "lint": "yarn lint:js && yarn lint:style && yarn lint:spelling",
-    "lint:ci": "yarn lint:js --quiet && yarn lint:style && yarn lint:spelling",
+    "lint": "yarn lint:js && yarn lint:style && yarn lint:spelling && yarn lint:syncpack",
+    "lint:ci": "yarn lint:js --quiet && yarn lint:style && yarn lint:spelling && yarn lint:syncpack",
     "lint:js": "eslint --cache --report-unused-disable-directives \"**/*.{js,jsx,ts,tsx,mjs}\"",
     "lint:js:fix": "yarn lint:js --fix",
     "lint:spelling": "cspell \"**\" --no-progress --show-context --show-suggestions",
     "lint:spelling:fix": "yarn rimraf project-words.txt && echo \"# Project Words - DO NOT TOUCH - This is updated through CI\" >> project-words.txt && yarn -s lint:spelling --words-only --unique --no-exit-code --no-summary \"**\" | cross-env LC_ALL=C sort --ignore-case >> project-words.txt",
     "lint:style": "stylelint \"**/*.css\"",
     "lint:style:fix": "yarn lint:style --fix",
+    "lint:syncpack": "syncpack lint",
+    "lint:syncpack:fix": "syncpack fix",
     "lerna": "lerna",
     "test": "jest",
     "test:build:website": "./admin/scripts/test-release.sh",
@@ -78,7 +80,7 @@
     "@ai-sdk/react": "^2.0.30",
     "@crowdin/cli": "^3.13.0",
     "@prettier/plugin-xml": "^2.2.0",
-    "@swc/core": "^1.7.14",
+    "@swc/core": "^1.7.39",
     "@swc/jest": "^0.2.39",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
@@ -121,14 +123,15 @@
     "pkg-pr-new": "^0.0.66",
     "postinstall-postinstall": "^2.1.0",
     "prettier": "^2.8.8",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
     "rimraf": "^3.0.2",
     "sharp": "^0.32.3",
     "strip-ansi": "^6.0.1",
     "stylelint": "^14.16.1",
     "stylelint-config-prettier": "^9.0.5",
     "stylelint-config-standard": "^29.0.0",
+    "syncpack": "^14.3.0",
     "typescript": "~6.0.2"
   },
   "resolutions": {

packages/create-docusaurus/templates/classic-typescript/package.json

@@ -21,14 +21,14 @@
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
     "prism-react-renderer": "^2.3.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.9.2",
     "@docusaurus/tsconfig": "3.9.2",
     "@docusaurus/types": "3.9.2",
-    "@types/react": "^19.0.0",
+    "@types/react": "^19.2.10",
     "typescript": "~6.0.2"
   },
   "browserslist": {

packages/create-docusaurus/templates/classic/package.json

@@ -20,8 +20,8 @@
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
     "prism-react-renderer": "^2.3.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.9.2",

packages/docusaurus-babel/package.json

@@ -40,7 +40,7 @@
     "@docusaurus/logger": "3.9.2",
     "@docusaurus/utils": "3.9.2",
     "babel-plugin-dynamic-import-node": "^2.3.3",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "tslib": "^2.6.0"
   },
   "engines": {

packages/docusaurus-mdx-loader/package.json

@@ -26,7 +26,7 @@
     "escape-html": "^1.0.3",
     "estree-util-value-to-estree": "^3.0.1",
     "file-loader": "^6.2.0",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "image-size": "^2.0.2",
     "mdast-util-mdx": "^3.0.0",
     "mdast-util-to-string": "^4.0.0",

packages/docusaurus-plugin-client-redirects/package.json

@@ -24,7 +24,7 @@
     "@docusaurus/utils-common": "3.9.2",
     "@docusaurus/utils-validation": "3.9.2",
     "eta": "^2.2.0",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "lodash": "^4.17.21",
     "tslib": "^2.6.0"
   },

packages/docusaurus-plugin-content-blog/package.json

@@ -42,7 +42,7 @@
     "cheerio": "^1.2.0",
     "combine-promises": "^1.1.0",
     "feed": "^4.2.2",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "lodash": "^4.17.21",
     "schema-dts": "^1.1.2",
     "srcset": "^4.0.0",

packages/docusaurus-plugin-content-docs/package.json

@@ -46,7 +46,7 @@
     "@docusaurus/utils-validation": "3.9.2",
     "@types/react-router-config": "^5.0.7",
     "combine-promises": "^1.1.0",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "js-yaml": "^4.1.0",
     "lodash": "^4.17.21",
     "schema-dts": "^1.1.2",

packages/docusaurus-plugin-content-pages/package.json

@@ -23,7 +23,7 @@
     "@docusaurus/types": "3.9.2",
     "@docusaurus/utils": "3.9.2",
     "@docusaurus/utils-validation": "3.9.2",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "tslib": "^2.6.0",
     "webpack": "^5.106.0"
   },

packages/docusaurus-plugin-debug/package.json

@@ -23,7 +23,7 @@
     "@docusaurus/core": "3.9.2",
     "@docusaurus/types": "3.9.2",
     "@docusaurus/utils": "3.9.2",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "react-json-view-lite": "^2.3.0",
     "tslib": "^2.6.0"
   },

packages/docusaurus-plugin-ideal-image/package.json

@@ -32,10 +32,10 @@
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.9.2",
-    "fs-extra": "^11.1.0"
+    "fs-extra": "^11.2.0"
   },
   "peerDependencies": {
-    "jimp": "*",
+    "jimp": "^1.6.1",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
   },

packages/docusaurus-plugin-pwa/package.json

@@ -30,7 +30,7 @@
     "@docusaurus/types": "3.9.2",
     "@docusaurus/utils": "3.9.2",
     "@docusaurus/utils-validation": "3.9.2",
-    "babel-loader": "^9.2.1",
+    "babel-loader": "^10.1.1",
     "clsx": "^2.0.0",
     "core-js": "^3.31.1",
     "tslib": "^2.6.0",
@@ -42,7 +42,7 @@
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.9.2",
-    "fs-extra": "^11.1.0"
+    "fs-extra": "^11.2.0"
   },
   "peerDependencies": {
     "react": "^19.2.0",

packages/docusaurus-plugin-sitemap/package.json

@@ -24,7 +24,7 @@
     "@docusaurus/utils": "3.9.2",
     "@docusaurus/utils-common": "3.9.2",
     "@docusaurus/utils-validation": "3.9.2",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "sitemap": "^7.1.1",
     "tslib": "^2.6.0"
   },

packages/docusaurus-plugin-svgr/package.json

@@ -22,7 +22,7 @@
     "@docusaurus/types": "3.9.2",
     "@docusaurus/utils": "3.9.2",
     "@docusaurus/utils-validation": "3.9.2",
-    "@svgr/core": "8.1.0",
+    "@svgr/core": "^8.1.0",
     "@svgr/webpack": "^8.1.0",
     "tslib": "^2.6.0",
     "webpack": "^5.106.0"

packages/docusaurus-theme-classic/package.json

@@ -51,7 +51,7 @@
     "@types/nprogress": "^0.2.0",
     "@types/prismjs": "^1.26.0",
     "@types/rtlcss": "^3.5.1",
-    "fs-extra": "^11.1.1"
+    "fs-extra": "^11.2.0"
   },
   "peerDependencies": {
     "react": "^19.2.0",

packages/docusaurus-theme-common/package.json

@@ -47,7 +47,7 @@
     "@docusaurus/core": "3.9.2",
     "@docusaurus/types": "3.9.2",
     "@total-typescript/shoehorn": "^0.1.2",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "lodash": "^4.17.21"
   },
   "peerDependencies": {

packages/docusaurus-theme-live-codeblock/package.json

@@ -41,7 +41,7 @@
     "@docusaurus/utils-validation": "3.9.2",
     "@philpl/buble": "^0.19.7",
     "clsx": "^2.0.0",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "react-live": "^4.1.6",
     "tslib": "^2.6.0"
   },

packages/docusaurus-theme-search-algolia/package.json

@@ -46,7 +46,7 @@
     "algoliasearch-helper": "^3.26.0",
     "clsx": "^2.0.0",
     "eta": "^2.2.0",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "lodash": "^4.17.21",
     "tslib": "^2.6.0",
     "utility-types": "^3.10.0"

packages/docusaurus-theme-translations/package.json

@@ -19,7 +19,7 @@
     "update": "node ./update.mjs"
   },
   "dependencies": {
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "tslib": "^2.6.0"
   },
   "devDependencies": {

packages/docusaurus-utils/package.json

@@ -24,7 +24,7 @@
     "escape-string-regexp": "^4.0.0",
     "execa": "^5.1.1",
     "file-loader": "^6.2.0",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "github-slugger": "^1.5.0",
     "globby": "^11.1.0",
     "gray-matter": "^4.0.3",

packages/docusaurus/package.json

@@ -52,7 +52,7 @@
     "eta": "^2.2.0",
     "eval": "^0.1.8",
     "execa": "^5.1.1",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "html-tags": "^3.3.1",
     "html-webpack-plugin": "^5.6.6",
     "leven": "^3.1.0",

website/package.json

@@ -57,7 +57,7 @@
     "clsx": "^2.0.0",
     "color": "^4.2.3",
     "execa": "^5.1.1",
-    "fs-extra": "^11.1.1",
+    "fs-extra": "^11.2.0",
     "netlify-plugin-cache": "^1.0.3",
     "raw-loader": "^4.0.2",
     "react": "^19.2.0",
@@ -88,7 +88,7 @@
     "@docusaurus/eslint-plugin": "3.9.2",
     "@docusaurus/tsconfig": "3.9.2",
     "@types/color": "^3.0.4",
-    "@types/jest": "^29.5.3",
+    "@types/jest": "^30.0.0",
     "cross-env": "^7.0.3",
     "rimraf": "^3.0.2",
     "search-insights": "^2.8.2"