Update docusaurus monorepo to v3.8.1

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
@docusaurus/core (source)	3.7.0 -> 3.8.1
@docusaurus/faster (source)	3.7.0 -> 3.8.1
@docusaurus/module-type-aliases (source)	3.7.0 -> 3.8.1
@docusaurus/preset-classic (source)	3.7.0 -> 3.8.1
@docusaurus/tsconfig (source)	3.7.0 -> 3.8.1
@docusaurus/types (source)	3.7.0 -> 3.8.1

---

Release Notes

facebook/docusaurus (@​docusaurus/core)

v3.8.1

Compare Source

🐛 Bug Fix

• docusaurus-theme-classic
  • #​11242 fix(theme): fix unability to navigate to category's page when browsing its children items (@​slorber)
• docusaurus-plugin-css-cascade-layers
  • #​11241 fix(css-cascade-layers): fix windows css cascade layers bug (@​slorber)
• docusaurus
  • #​11222 fix(bundler): fix docusaurus start using concatenateModules: true (@​slorber)
  • #​11217 fix: include Arc to supported Chromium Browsers (@​wellwelwel)
  • #​11205 fix(core): fix docusaurus start error for macOS users with no Chromium-based browser (@​slorber)
• docusaurus-types
  • #​11221 fix(types): fix future flags public types (@​slorber)

🏃‍♀️ Performance

• docusaurus-plugin-content-blog, docusaurus-plugin-sitemap, docusaurus-theme-classic, docusaurus-types, docusaurus-utils, docusaurus
  • #​11211 perf: avoid duplicated git log calls in loadContent() and postBuild() for untracked Git files (@​slorber)

🔧 Maintenance

• docusaurus-faster
  • #​11248 chore(faster): upgrade Rspack (@​slorber)
• docusaurus-plugin-content-docs
  • #​11230 refactor(docs): extract loadVersion() without changing the behavior (@​slorber)
• Other
  • #​11212 chore: upgrade to Node 22 by default (@​slorber)

Committers: 7

• Ben McCann (@​benmccann)
• Dave Meyer (@​dave-meyer)
• Léo Vincent (@​leovct)
• Noritaka Kobayashi (@​noritaka1166)
• Phil Parsons (@​p-m-p)
• Sébastien Lorber (@​slorber)
• Weslley Araújo (@​wellwelwel)

v3.8.0

Compare Source

🚀 New Feature

• docusaurus-plugin-css-cascade-layers, docusaurus-preset-classic, docusaurus-theme-classic, docusaurus-types, docusaurus
  • #​11142 feat(theme): new CSS cascade layers plugin + built-in v4.useCssCascadeLayers future flag (@​slorber)
• docusaurus
  • #​11156 feat(core): add internal flag to skip bundling (@​slorber)
  • #​11067 feat(core): enable Rspack parallelCodeSplitting (@​slorber)
• docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-search-algolia, docusaurus
  • #​11090 feat(theme): make it possible to provide your own page title formatter (@​slorber)
• docusaurus-plugin-content-pages
  • #​11088 feat(pages): Support frontMatter.slug like docs and blog plugins (@​slorber)
• docusaurus-faster, docusaurus
  • #​11006 feat(core): Add bundler tracing/profiling (@​slorber)
• docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
  • #​10987 feat(theme): Allow resetting colorMode to System/OS value (@​slorber)
• docusaurus-remark-plugin-npm2yarn
  • #​10953 feat(plugin-npm2yarn): Add Bun to default tabs conversions (@​jakeboone02)
• docusaurus-theme-classic, docusaurus-theme-common
  • #​10945 feat(theme): add theme layout stable CSS classes (@​slorber)
  • #​10846 feat(theme): code block showLineNumbers=start metastring (@​slorber)
• docusaurus-faster, docusaurus-plugin-content-docs, docusaurus-types, docusaurus
  • #​10931 feat(core): Docusaurus Faster - Rspack Persistent Cache (@​slorber)
• docusaurus-theme-classic
  • #​10852 feat(theme): add versions attribute to docsVersionDropdown navbar item (@​hrumhurum)
• docusaurus-types, docusaurus
  • #​10826 feat(core): Docusaurus Faster - SSG worker threads (@​slorber)
• docusaurus-plugin-sitemap, docusaurus-types, docusaurus
  • #​10850 feat(core): new postBuild({routesBuildMetadata}) API, deprecate head attribute + v4 future flag (@​slorber)

🐛 Bug Fix

• docusaurus-plugin-content-blog
  • #​11138 refactor(content-blog): replace reading-time with Intl.Segmenter API (@​shreedharbhat98)
• docusaurus-plugin-content-blog
  • #​11138 refactor(content-blog): replace reading-time with Intl.Segmenter API (@​shreedharbhat98)
  • #​11068 fix(blog): fix blog Atom feed item url / XSL bug (@​slorber)
• docusaurus-plugin-content-docs
  • #​11179 fix(mdx-loader): remove opt-in for mdx dependency file (@​slorber)
  • #​10875 fix(docs): versioning CLI should copy localized translation file current.json to version-<v>.json (@​jkboxomine)
• create-docusaurus
  • #​11157 fix(create-docusaurus): Improve init template README, fix headings and remove $ in bash code blocks (@​arienshibani)
• docusaurus-theme-common
  • #​11153 fix(theme): restore former code block theme-common internal APIs (@​slorber)
  • #​11046 fix(theme): Fix code block magic comments with CRLF line breaks bug (@​coder-xiaomo)
  • #​10989 fix(theme): mobile drawer history blocker should be rendered conditionally (workaround) (@​slorber)
  • #​10954 fix(theme): fix useColorMode().colorMode leading to React hydration mismatches (@​slorber)
• docusaurus-theme-classic
  • #​11085 fix(theme): add missing rel="tag" attribute for docs/blog tags (@​slorber)
  • #​10999 fix(theme): CodeBlock should accept title of ReactNode type (@​lebalz)
  • #​10705 fix(theme): only render secondaryMenu if it should be shown (@​hidde)
  • #​10898 fix(theme): a11y fix on mobile DropdownNavbarItem (@​mxschmitt)
  • #​10909 fix(theme): apply docs sidebar_class_name in DocCard + better dogfooding (@​slorber)
  • #​10849 fix(theme): fix <DocCard> height inconsistency (@​hichemfantar)
  • #​10866 fix(theme): Hide code block buttons before React hydration (@​kennethormandy)
• docusaurus-theme-classic, docusaurus-theme-translations
  • #​11053 fix(theme): navbar mobile sidebar should allow clicking dropdown parent link (@​slorber)
• docusaurus-utils
  • #​11027 fix(cli): fix CLI write-translation bug (@​slorber)
• docusaurus-theme-translations
  • #​11030 fix(theme-translation): add missing Japanese translation for System Mode (@​tats-u)
  • #​10893 fix(theme-translations): Turkish exist language translate completed. (@​ramazansancar)
  • #​10884 fix(theme-translations): Add missing Polish (pl) theme translations (@​mariuszkrzaczkowski)
• docusaurus-plugin-ideal-image
  • #​11026 fix(ideal-image): fix waypoint initial scroll bug (@​slorber)
  • #​11014 fix(ideal-image): Internalize react-waypoint dependency, fix React 19 compatibility (@​slorber)
  • #​10910 fix(ideal-image): Add issuer to ideal-image Webpack loader (@​slorber)
• docusaurus-mdx-loader
  • #​11004 fix(mdx-loader): refactor and fix heading to toc html value serialization (@​slorber)
• docusaurus-module-type-aliases
  • #​10998 fix(module-type-aliases): pin react-helmet-async to @​slorber/react-helmet-async@​1.3.0 (@​cylewaitforit)
• docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
  • #​10987 feat(theme): Allow resetting colorMode to System/OS value (@​slorber)
• create-docusaurus, docusaurus-utils
  • #​10958 fix(create-docusaurus): fix CLI and remove shelljs escapeShellArg util (@​slorber)
• docusaurus-mdx-loader, docusaurus-plugin-content-docs
  • #​10934 fix(docs): fix mdx loader cache invalidation bug on versions changes (@​slorber)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages
  • #​10929 fix(plugins): add missing validateOptions types (@​slorber)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common
  • #​10888 fix(seo): docs breadcrumb structured data should use JSON-LD and filter unliked categories (@​johnnyreilly)
• docusaurus-theme-classic, docusaurus-theme-common
  • #​10886 fix(theme): collapse doc sidebar category on label click if active (@​slorber)
• docusaurus
  • #​10915 fix(core): use os.availableParallelism() for SSG worker threads count (@​slorber)
• docusaurus-plugin-content-docs, docusaurus-theme-classic
  • #​10847 fix(theme): Fix <DocCardList> usage on docs at root of a sidebar (@​slorber)
• docusaurus-plugin-svgr, docusaurus-types, docusaurus-utils, docusaurus
  • #​10820 fix(core): restore core svg file-loader (@​slorber)
• docusaurus-logger
  • #​10818 fix: perflogger mark detail bug (@​slorber)

🏃‍♀️ Performance

• docusaurus-utils, docusaurus
  • #​11178 perf(core): disable Rspack parallelCodeSplitting temporarily (@​slorber)
• docusaurus
  • #​11177 perf(core): fix bad value for mergeDuplicateChunks (typo) (@​slorber)
  • #​11170 perf(core): add default for DOCUSAURUS_SSG_WORKER_THREAD_RECYCLER_MAX_MEMORY (@​slorber)
  • #​11166 feat(core): expose opt-in env variable for SSG thread recycling (@​slorber)
  • #​11072 perf(core): remove bundler optimization.removeAvailableModules (@​slorber)
  • #​11067 feat(core): enable Rspack parallelCodeSplitting (@​slorber)
  • #​11037 refactor(core): remove clean-webpack-plugin (@​slorber)
  • #​11007 perf(core): Optimize docusaurus start/serve, fix openBrowser() perf issue on macOS (@​slorber)
• docusaurus-bundler, docusaurus-faster, docusaurus
  • #​11176 perf(bundler): fine-tuning of Webpack/Rspack optimizations (@​slorber)
• docusaurus-utils
  • #​11163 perf(utils): implement git command queue (@​slorber)
• docusaurus-logger, docusaurus
  • #​11162 perf(core): optimize SSG collected data memory and worker thread communication (@​slorber)
• docusaurus-bundler, docusaurus
  • #​10956 refactor: remove react-dev-utils (CRA) dependency, internalize code (@​slorber)
• docusaurus-theme-classic
  • #​10885 perf(theme): use SVG sprite for IconExternalLink (@​slorber)
• docusaurus-types, docusaurus
  • #​10826 feat(core): Docusaurus Faster - SSG worker threads (@​slorber)

💅 Polish

• docusaurus-theme-live-codeblock
  • #​11120 fix(theme): improve color contrast of live code block header (@​JackHowa)
• docusaurus-theme-translations
  • #​10825 fix(theme-translations): Add missing Polish (pl) theme translations (@​mariuszkrzaczkowski)
  • #​10816 chore(theme-translations): add missing zh theme translations (@​MisterFISHUP)

📝 Documentation

• #​11181 docs: adjust the Docusaurus release process documentation to our new simpler process (@​slorber)
• #​11180 docs(ideal-image): Add warning for pnpm 10+ and sharp install script (@​slorber)
• #​11137 docs(deploy): remove layer0 from deployment docs (@​PaiJi)
• #​10822 docs(website): Comparison with Rspress (@​DevJoaoLopes)

🤖 Dependencies

• #​11185 chore(deps): bump actions/dependency-review-action from 4.7.0 to 4.7.1 (@​dependabot[bot])
• #​11182 chore(deps): bump lockfile-lint-api from 5.9.1 to 5.9.2 (@​dependabot[bot])
• #​11174 chore(deps): bump actions/dependency-review-action from 4.6.0 to 4.7.0 (@​dependabot[bot])
• #​11135 chore(deps): bump http-proxy-middleware from 2.0.7 to 2.0.9 (@​dependabot[bot])
• #​11103 chore(deps): bump marocchino/sticky-pull-request-comment from 2.9.1 to 2.9.2 (@​dependabot[bot])
• #​11102 chore(deps): bump actions/setup-node from 4.3.0 to 4.4.0 (@​dependabot[bot])
• #​11070 chore(deps): bump estree-util-value-to-estree from 3.1.2 to 3.3.3 (@​dependabot[bot])
• #​11069 chore(deps): bump actions/dependency-review-action from 4.5.0 to 4.6.0 (@​dependabot[bot])
• #​11002 chore(deps): bump actions/setup-node from 4.2.0 to 4.3.0 (@​dependabot[bot])
• #​10990 chore(deps): bump @​babel/runtime-corejs3 from 7.25.9 to 7.26.10 (@​dependabot[bot])
• #​10970 chore(deps): bump axios from 1.7.7 to 1.8.2 (@​dependabot[bot])
• #​10978 chore(deps): bump prismjs from 1.29.0 to 1.30.0 (@​dependabot[bot])
• #​10957 chore(deps): bump http-proxy-middleware from 2.0.6 to 2.0.7 (@​dependabot[bot])
• #​10937 chore(deps): bump dompurify from 3.1.6 to 3.2.4 (@​dependabot[bot])
• #​10936 chore(deps): bump preactjs/compressed-size-action from 2.7.0 to 2.8.0 (@​dependabot[bot])
• #​10873 chore(deps): bump actions/setup-node from 4.1.0 to 4.2.0 (@​dependabot[bot])
• #​10853 chore(deps): bump marocchino/sticky-pull-request-comment from 2.9.0 to 2.9.1 (@​dependabot[bot])
• #​10851 chore(deps): bump katex from 0.16.11 to 0.16.21 (@​dependabot[bot])

🔧 Maintenance

• docusaurus-mdx-loader, docusaurus-utils
  • #​11168 chore: add Node 24 to CI + fix deprecation warnings (@​slorber)
• docusaurus-plugin-content-blog
  • #​11116 test(blog): Add unit tests for calculating blog posts reading time (@​shreedharbhat98)
• docusaurus-mdx-loader, docusaurus-theme-common, docusaurus-theme-live-codeblock
  • #​11077 refactor(live-codeblock): refactor live code block theme components (@​slorber)
• Other
  • #​11075 fix(c): fix yarn lint:spelling:fix script (@​slorber)
• docusaurus-faster
  • #​11073 chore: upgrade Rspack 1.3.3 (@​slorber)
  • #​10870 chore(deps): bump @​rspack/core in Faster from 1.2.0-alpha.0 to 1.2.2 (@​tats-u)
• docusaurus-theme-mermaid
  • #​11066 chore: upgrade mermaid, fix diagram labels bug (@​slorber)
• docusaurus-mdx-loader
  • #​11065 chore: upgrade image-size deps to v2 (@​slorber)
• docusaurus-theme-classic, docusaurus-theme-common
  • #​11062 refactor(theme): introduce CodeBlockContextProvider + split into smaller components (@​slorber)
  • #​11059 refactor(theme): CodeBlock, centralize metadata parsing + refactor theme component (@​slorber)
• docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-common
  • #​11058 refactor(theme): refactor CodeBlock parseLines logic + use inline snapshots to ease review (@​slorber)
• docusaurus-faster, docusaurus
  • #​11039 chore: use rspack 1.3.0 (@​slorber)
• docusaurus-plugin-ideal-image
  • #​11010 refactor(ideal-image-plugin): internalize legacy component code (@​slorber)
• docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-mermaid, docusaurus-theme-search-algolia
  • #​10969 chore: add eslint-plugin-react-compiler (@​slorber)
• docusaurus-cssnano-preset, docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-remark-plugin-npm2yarn, eslint-plugin, stylelint-copyright
  • #​10966 chore: upgrade monorepo to TS 5.8 (@​slorber)
• docusaurus-bundler, docusaurus
  • #​10956 refactor: remove react-dev-utils (CRA) dependency, internalize code (@​slorber)
• create-docusaurus, docusaurus-plugin-content-docs, docusaurus-utils, docusaurus
  • #​10358 refactor: replace unmaintained shelljs dependency by execa (@​OzakIOne)
• docusaurus-theme-search-algolia
  • #​10941 chore(algolia): bump docsearch dependency to v3.9 (@​slorber)
• docusaurus-plugin-debug
  • #​10903 chore(plugin-debug): upgrade react-json-view-lite to v2.3.0 for react 19 (@​reece-white)
  • #​10819 chore(plugin-debug): upgrade react-json-view-lite to v2, prepare for React 19 (@​slorber)
• create-docusaurus
  • #​10871 refactor(create-docusaurus): add future.v4 flag to init templates (@​slorber)

Committers: 38

• Arien Shibani (@​arienshibani)
• Balthasar Hofer (@​lebalz)
• Ben McCann (@​benmccann)
• Daniel Kuschny (@​Danielku15)
• David King Roderos (@​dkroderos)
• FISH UP (@​MisterFISHUP)
• Hichem Fantar (@​hichemfantar)
• Hidde de Vries (@​hidde)
• Jack Howard (@​JackHowa)
• Jake Boone (@​jakeboone02)
• JiPai (@​PaiJi)
• John Reilly (@​johnnyreilly)
• Joshua Chen (@​Josh-Cena)
• João Victor Lopes (@​DevJoaoLopes)
• Justin D Mathew (@​JDMathew)
• Kenneth Ormandy (@​kennethormandy)
• Mariusz Krzaczkowski (@​mariuszkrzaczkowski)
• Massoud Maboudi (@​massoudmaboudi)
• Max Schmitt (@​mxschmitt)
• Milica (@​mmaksimovic)
• Oleksiy Gapotchenko (@​hrumhurum)
• Ramazan Sancar (@​ramazansancar)
• Shreedhar Bhat (@​shreedharbhat98)
• Stephen Glass (@​stephenglass)
• Sébastien Lorber (@​slorber)
• Taras (@​taraspos)
• Tatsunori Uchino (@​tats-u)
• Waldir Pimenta (@​waldyrious)
• Yangshun Tay (@​yangshun)
• Yoshiaki Yoshida (@​kakakakakku)
• @​cylewaitforit
• @​jkboxomine
• @​reece-white
• kilavvy (@​kilavvy)
• ozaki (@​OzakIOne)
• pedenys (@​pedenys)
• マルコメ (@​Marukome0743)
• 程序员小墨 (@​coder-xiaomo)

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about these updates again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.