Skip to content

Pin @mdit/plugin-tex to ~1.0.2 to fix docs build npm install ERESOLVE - #43

Draft
kescobo with Copilot wants to merge 3 commits into
mainfrom
copilot/fix-failing-github-actions-job
Draft

kescobo with Copilot wants to merge 3 commits into
mainfrom
copilot/fix-failing-github-actions-job

Conversation

Copilot AI commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

The build job in the docs deploy workflow fails during npm install (run via DocumenterVitepress) with an ERESOLVE peer dependency conflict. ^1.0.2 now resolves @mdit/plugin-tex to 1.1.0, which needs markdown-it@^15, while docs/package.json pins markdown-it@^14.1.0.

  • docs/package.json: Change @mdit/plugin-tex from ^1.0.2 to ~1.0.2. That keeps it on the 1.0.x line, which peers on markdown-it@^14.2.0 and is satisfied by the installed 14.3.0.
-    "@mdit/plugin-tex": "^1.0.2",
+    "@mdit/plugin-tex": "~1.0.2",

Upgrading markdown-it to ^15 would let the plugin float, but I haven't tried it. vitepress@1.6.3 depends on markdown-it 14, so this change takes the lower-risk path of pinning the plugin.

Co-authored-by: kescobo <3502975+kescobo@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix failing GitHub Actions job 'build' Pin @mdit/plugin-tex to ~1.0.2 to fix docs build npm install ERESOLVE Oct 6, 2026
Copilot AI requested a review from kescobo October 6, 2026 12:05
@kescobo

kescobo commented Oct 6, 2026

Copy link
Copy Markdown
Member

@copilot This seems brittle, I think we should work with the version of DocumenterVitepress rather than messing with the internals

Co-authored-by: kescobo <3502975+kescobo@users.noreply.github.com>

Copilot AI commented Oct 6, 2026

Copy link
Copy Markdown
Contributor Author

@copilot This seems brittle, I think we should work with the version of DocumenterVitepress rather than messing with the internals

Agreed. In 7208ced I dropped the pin and replaced docs/package.json with the template DocumenterVitepress v0.3.7 ships (the version compat = "0.3" resolves to). That template uses @mdit/plugin-tex ^0.24 plus @mdit/plugin-mathjax, which don't hit the markdown-it 15 conflict. A local npm install resolves cleanly. I haven't run the full docs build in CI.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants