@mermaid-js/parser@2.0.0 mermaid@12.0.0

high risk

mermaid-js/mermaidSep 10, 2026 → Sep 10, 20260 days between releases

What's New

Mermaid 12.0.0 introduces ELK layout engine and new themes, raising minimum browser to Safari 17.4+ and Node 22.12+.

Breaking Changes

  • Minimum browser version increased to Safari 17.4+.
  • ELK default layout changes diagram appearance (requires `layout: dagre` to revert).
  • Default theme changed to `redux-color` and look to `neo`.
  • Removed `defaultRenderer` option.
  • Removed internal layout exports.

New Features

  • UML use case diagrams support.
  • Agentflow-beta diagram type support.
  • Support for `unwrapGroupLabels` in `defaultMeasureLayout`.

Improvements

  • ELK layout engine is now bundled and the default algorithm.
  • Updated to Mermaid 12.0.0 dependencies.

Upgrade Notes

Existing flowcharts, state and class diagrams will re-lay out and recolour; add `layout: dagre`, `theme: default` and `look: classic` to your config to keep the old look.

The Two Releases

@mermaid-js/parser@2.0.0

@mermaid-js/parser@2.0.0

Sep 10, 2026· 1 month ago

The parser package is updated to version 2.0.0 to support the new features and syntax introduced in Mermaid 12.0.0, including the new diagram types and layout requirements.

Full release notes
mermaid@12.0.0

mermaid@12.0.0

Sep 10, 2026· 1 month ago

Mermaid 12.0.0 is a major release introducing the ELK layout engine as the default, updating the default visual theme to `redux-color`/`neo`, and adding two new diagram types: UML use case and agentflow-beta. It also raises the minimum supported browser and Node.js versions.

Full release notes