mermaid-js/mermaid-cli 12.0.0

v12.0.0

on GitHub

Changes

⚠️ Breaking Changes

• Upgrade to Mermaid v12.0.0 @aloisklink (#1182)
  • Upgrading to Mermaid v12.0.0 changes default diagram themes and layouts. See the official Mermaid v12 release notes for details.
• feat!: change --iconPacks to load from node_modules @aloisklink (#1197)
  • --iconPacks now only looks for locally installed NPM icon packs installed with npm install .... If you want to dynamically download an icon pack from a CDN (not recommended), please use the --iconPacksAndUrls option and provide the full URL.
• feat!: replace --pdfFit with --pdf-paper-format @aloisklink (#1193)
  • The --pdfFit option has been removed. PDFs are now fitted by default. To go back to the old behaviour, use --pdf-paper-format=Letter.
• feat!: replace --width/--height with an improved --size @aloisklink (#1194)
  • --size not only sets the puppeteer viewport, but it also tries to make .png files with the given resolution
• Change --cssFile to use Mermaid's themeCSS @aloisklink (#1188)
• Require Puppeteer v25 or later @aloisklink (#1183)
• Require Node.JS v22.13 or later @aloisklink (#1181)

🚀 Features

• feat: support loading icons from file:// URIs @aloisklink (#1195)
• feat: add Recursive and OpenSans fonts @aloisklink (#1190)
• feat: embed fonts into SVG files @aloisklink (#1189)
  • Fonts are now embedded into SVG files by default, which increases the size of .svg files. To disable this, use --no-font-embed.

🐛 Bug Fixes

• fix: correct PDF export background colours @aloisklink (#1192)

🧰 Maintenance

• Require Node.JS v22.13 or later @aloisklink (#1181)

📦 Dependency updates

• build(deps): bump @babel/core from 7.28.4 to 7.29.7 @dependabot[bot] (#1196)
• chore: upgrade dependencies now that we only support Node.JS v22 @aloisklink (#1191)
• build(deps-dev): bump typescript-eslint from 8.69.0 to 8.70.0 @dependabot[bot] (#1184)
• Upgrade to Mermaid v12.0.0 @aloisklink (#1182)
• build(deps): bump the docker group with 3 updates @dependabot[bot] (#1187)
• Require Puppeteer v25 or later @aloisklink (#1183)
• build(deps): bump nanoid from 3.3.16 to 3.3.19 @dependabot[bot] (#1180)
• build(deps-dev): bump puppeteer from 25.9.0 to 25.10.0 @dependabot[bot] (#1177)
• build(deps): bump js-yaml from 4.1.1 to 4.3.2 @dependabot[bot] (#1174)
• build(deps): bump the codeql group with 3 updates @dependabot[bot] (#1179)
• build(deps-dev): bump jest from 30.4.2 to 30.5.1 @dependabot[bot] (#1172)
• build(deps-dev): bump globals from 17.11.0 to 17.12.0 @dependabot[bot] (#1170)
• build(deps-dev): bump typescript-eslint from 8.66.0 to 8.69.0 @dependabot[bot] (#1171)
• build(deps): bump docker/setup-qemu-action from 4.2.0 to 4.3.0 in the docker group @dependabot[bot] (#1173)

Full Changelog: 11.17.0...v12.0.0