fix(docs): align docusaurus packages to 3.10.2 to fix docs build - #2079
Merged
Conversation
@docusaurus/core was bumped to 3.10.2 while preset-classic, plugin-content-docs, theme-live-codeblock and module-type-aliases stayed on 3.9.x/3.10.0, breaking the docs build with "Cannot read properties of undefined (reading 'mdxCrossCompilerCache')" since Docusaurus's internal packages only work when all on the same version. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The docs deploy started failing after merging the
@docusaurus/coreand@docusaurus/tsconfigdependabot bumps to 3.10.2 (following the earlier webpack 5.98.0 → 5.109.0 bump, which itself broke the docs build against the oldwebpackbar@^6bundled by@docusaurus/core@3.9.2).@docusaurus/preset-classic,@docusaurus/plugin-content-docs, and@docusaurus/theme-live-codeblockwere left on^3.9.2, and@docusaurus/module-type-aliaseson^3.10.0, whilecore/tsconfig/typesmoved to3.10.2. Docusaurus's@docusaurus/*packages share internal (non-public) APIs across each other and only work correctly when all on the same version. The split leftpreset-classic@3.9.2pulling in the old@docusaurus/plugin-content-pages@3.9.2, which crashed against the newcore@3.10.2's plugin-init context shape:Change
Bump the remaining
@docusaurus/*packages indocumentation/package.jsonto^3.10.2so every Docusaurus package is on the same version:@docusaurus/plugin-content-docs:^3.9.2→^3.10.2@docusaurus/preset-classic:^3.9.2→^3.10.2@docusaurus/theme-live-codeblock:^3.9.2→^3.10.2@docusaurus/module-type-aliases:^3.10.0→^3.10.2Root
package-lock.jsonregenerated withnpm installto match.Verification
npm run build -w documentation: succeeds (only a pre-existing, unrelated broken-link warning on an API doc anchor, not introduced by this change)npm run typecheck -w documentation(tsc): clean[webpackbar]compiles both Client and Server successfully, confirming the newerwebpackbar(pulled in transitively via the now-aligned 3.10.2 packages) also resolves the earlier webpackProgressPluginschema validation error from the webpack 5.109.0 bump.