Repository navigation
Remove the unused mermaid plugin and override vite to a patched release - #170
Merged
Merged
Conversation
No page contains a mermaid diagram. Removing mermaid and vitepress-plugin-mermaid drops katex and dompurify from the lockfile, which closes the open katex advisory (GHSA-238p-pmpm-9mq7). Dependabot's fix for it, a bump to mermaid 12, does not install because the plugin only supports mermaid 10 and 11. The config change is the withMermaid wrapper removed and the body dedented. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
VitePress 1.6.4 is the latest stable release and depends on vite ^5.4.14. The vite 5 line ends at 5.4.21. Eight open advisories are fixed only in vite 6.4.4, and the esbuild advisory only in esbuild 0.25.0, which vite 6 brings in. The override puts vite outside the range VitePress declares. @vitejs/plugin-vue 5.2.4 supports vite 6. Observed with vite 6.4.6: docs:build produces the same four pages, and the dev server serves the home and specification pages. Remove the override once the site moves to a VitePress release that depends on a patched vite. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
🔵 Needs a closer look
The Vite 6 override falls outside VitePress 1.6’s declared dependency range, and production hydration, navigation, and local search still need human runtime validation.
No open issues 🎉
What changed in this PR
This PR removes unused Mermaid support from the VitePress documentation site and updates build dependencies to address the reported KaTeX, Vite, and esbuild security alerts.
Changes:
- Remove Mermaid dependencies and the
withMermaidconfiguration wrapper. - Add a temporary Vite override to
^6.4.4while retaining VitePress 1.6.4. - Update the lockfile to remove Mermaid’s dependency tree and resolve Vite 6.4.6 with esbuild 0.25.12.
| File | Description |
|---|---|
package.json |
Removes Mermaid packages and adds the patched Vite override. |
package-lock.json |
Prunes unused dependencies, including KaTeX, and updates Vite and esbuild. |
.vitepress/config.mts |
Removes the Mermaid wrapper while preserving the site configuration. |
Review effort: Balanced
poita
approved these changes
Nov 20, 2026
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
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.
Closes the ten open Dependabot alerts. Two commits.
Remove the unused mermaid plugin
withMermaidwrapper in.vitepress/config.mtsand the two dev dependencies.mermaidandvitepress-plugin-mermaiddrops katex from the lockfile, which closes the katex alert (GHSA-238p-pmpm-9mq7).Override vite to a patched 6.4.x
^5.4.14. The vite 5 line ends at 5.4.21.overridesentry sets vite to^6.4.4. It resolves to vite 6.4.6 and esbuild 0.25.12.@vitejs/plugin-vue5.2.4 supports vite 6.Verification
npm run docs:buildproduces the same four pages as main. The built site goes from 5.0 MB to 1.5 MB.npm run check:schemapasses: 43 tests, 16 examples.vitepress devserves the home and specification pages.Not addressed
npm auditalso reports three moderate advisories in glob and minimatch, throughtypescript-json-schema0.68.0. npm's only suggested fix is a downgrade to 0.67.1. The core specification repository pins the same version.🤖 Generated with Claude Code