@mermaid-js/layout-tidy-tree@1.0.0 @mermaid-js/layout-elk@1.0.0

high risk

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

What's New

Switches layout engine to ELK with new presets and rendering updates

Breaking Changes

  • Existing ELK diagrams with crossing edges will render differently
  • Subgraphs render tighter and more evenly
  • Requires ES2024, Safari 17.4+, and Node.js v22.12+

New Features

  • New `elk.preset` option allows selecting named layout combinations
  • New `elk.lineHops` option controls how crossing edges are drawn

Improvements

  • Switches to a built-in ELK implementation, reducing the ESM payload from ~1.58 MB to 728 kB

Bug Fixes

  • Fixes subgraph frame padding to be even and resolves edge routing issues with non-rectangular shapes

Upgrade Notes

Ensure your environment supports ES2024, Safari 17.4+, and Node.js v22.12+. Review `elk.preset` and `elk.lineHops` options as rendering behavior for crossing edges and subgraphs has changed.

The Two Releases

@mermaid-js/layout-tidy-tree@1.0.0

@mermaid-js/layout-tidy-tree@1.0.0

Sep 10, 2026· 1 month ago

Upgrades the tidy-tree layout engine to require ES2024, Safari 17.4+, and Node.js v22.12+. This change ensures compatibility with modern browsers and dependencies.

Full release notes
@mermaid-js/layout-elk@1.0.0

@mermaid-js/layout-elk@1.0.0

Sep 10, 2026· 1 month ago

Introduces new configuration presets (`elk.preset`) and line hop rendering options for ELK layouts, switches to a built-in ELK implementation to reduce bundle size, and fixes various subgraph and edge routing issues.

Full release notes