Weekly GitHub Report for Mermaid

Thank you for subscribing to our weekly newsletter! Each week, we deliver a comprehensive summary of your GitHub project's latest activity right to your inbox, including an overview of your project's issues, pull requests, contributors, and commit activity.

Table of Contents

• I. News
  • 1.1. Recent Version Releases
  • 1.2. Other Noteworthy Updates
• II. Issues
  • 2.1. Top 5 Active Issues
  • 2.2. Top 5 Stale Issues
  • 2.3. Open Issues
  • 2.4. Closed Issues
  • 2.5. Issue Discussion Insights

• III. Pull Requests
  • 3.1. Open Pull Requests
  • 3.2. Closed Pull Requests
  • 3.3. Pull Request Discussion Insights

• IV. Contributors
  • 4.1. Contributors

I. News

1.1 Recent Version Releases:

The current version of this repository is @mermaid-js/parser@0.4.0

1.2 Version Information:

On March 25, 2025, a minor update was released introducing a new Radar Chart feature, enhancing the charting capabilities of the platform. This addition reflects ongoing efforts to expand visualization options.

II. Issues

2.1 Top 5 Active Issues:

We consider active issues to be issues that that have been commented on most frequently within the last week. Bot comments are omitted.

As of our latest update, there are no active issues with ongoing comments this week.

2.2 Top 5 Stale Issues:

We consider stale issues to be issues that has had no activity within the last 30 days. The team should work together to get these issues resolved and closed as soon as possible.

As of our latest update, there are no stale issues for the project this week.

2.3 Open Issues

This section lists, groups, and then summarizes issues that were created within the last week in the repository.

Issues Opened This Week: 6

Summarized Issues:

• Diagram Features and Enhancements: Several issues focus on adding new diagram types and improving existing diagram functionalities. These include the proposal of a detailed flowchart for flowmeter maintenance, the introduction of a Cynefin framework diagram type with a text-based DSL, and the addition of syntax for annotating data points in xychart line plots to enhance visualization capabilities.
• [issues/7525, issues/7534, issues/7549]

• Rendering and Syntax Errors: There are problems related to rendering diagrams correctly due to syntax errors caused by special characters in node names and bugs in sequence diagram text display. These issues prevent diagrams from rendering as expected and cause text elements to disappear under certain configurations.
• [issues/7528, issues/7546]

• Script and Formatting Issues: One issue highlights problems running the run script on Windows with WSL due to carriage return characters and missing newline formatting in the help output. These script-related errors affect usability and output readability.
• [issues/7532]

2.4 Closed Issues

This section lists, groups, and then summarizes issues that were closed within the last week in the repository. This section also links the associated pull requests if applicable.

Issues Closed This Week: 0

Summarized Issues:

As of our latest update, there were no issues closed in the project this week.

2.5 Issue Discussion Insights

This section will analyze the tone and sentiment of discussions within this project's open and closed issues that occurred within the past week. It aims to identify potentially heated exchanges and to maintain a constructive project environment.

Based on our analysis, there are no instances of toxic discussions in the project's open or closed issues from the past week.

III. Pull Requests

3.1 Open Pull Requests

This section provides a summary of pull requests that were opened in the repository over the past week. The top three pull requests with the highest number of commits are highlighted as 'key' pull requests. Other pull requests are grouped based on similar characteristics for easier analysis. Up to 25 pull requests are displayed in this section, while any remaining pull requests beyond this limit are omitted for brevity.

Pull Requests Opened This Week: 19

Key Open Pull Requests

1. Release candidate 11.14.0: This pull request introduces Mermaid version 11.14.0 as a release candidate, featuring the addition of Wardley Maps as a new beta diagram type with comprehensive support including parser, renderer, tests, and documentation, implements a "neo look" styling for state and sequence diagrams, extends recognized diagram keys with treeView, and includes numerous bug fixes, diagram improvements, and documentation updates across various diagram types.

• URL: pull/7526

• Associated Commits: b8c86, 2ddab, cb7b6, dd44d, f0e72, 72965, 163dd, c30bc, bab07, 2138c, 79179, d3199, 32dac, 2ced2, a8e3f, 17394, 002ce, 47c34, a40ad, 44911, 1acd1, 6fe6c, 34226, 61705, ea81b, 4fd4f, df6c9, aa4f2, 8fe30, 398fa, f1df4, 7731a, 0c50f, 365c2, 85487, c541a, 9a365, 84e7a, 975ce, f37d5, 62ef5, 70c88, 3819a, 69bcf, cbbd3, 34496, 35c27, 4380d, 576ab, 3c4e2, 7c97d, 4bc60, c57b6, adcf7, 397e9, f57ac, 73bb8, 48362, e7aca, 8949e, 375bf, 81cec, b26af, 12a3c, 714c7, 862d4, e37f4, b336c, 890eb, c2271, 72408, 590ac, 5ffbf, 36509, bd83d, 6f3ef, 470f1, 16834, 9fce7, e283a, a3df7, bc60c, 30d18, 08db6, 23246, b69ea, e7bfa, 164d6, 53712, d1798, d90ba, 784f5, cc1ce, 73bf0, 1d20c, aecef, c2950, 19628, 79f26, 8cbfd, 304bd, dbce8, cba07, df1a2, 93d66, 3f4df, b6817, be536, 79ec2, 60cd3, b8990, f601b, 277c4, 83064, 89760, b1efc, d8a55, a8467, b2063, 90324, 436c7, d36b3, d8dbe, 98839, 8b34b, 3f63e, 00aef, e9d4c, 503a7, f41df, 5f6d5, 19d85, ea931

2. feat: complete usecase diagram integration & validation: This pull request implements a complete integration and validation of a dedicated Use Case Diagram renderer for Mermaid, including a text-based parser, UML 2.x-compliant syntax and relationship validation, a D3-based SVG renderer with improved curved routing for internal relationships, configuration and theming support, IntelliSense editor integration, and automated style tests, thereby resolving related issues and enhancing diagram accuracy and readability.

• URL: pull/7530

• Associated Commits: c5440, eb950, fe4e1, 43f39, d13b9, b5203, 8aed9, caab9, 01bd2, e6715, 6e322, b35e5, a01ed, 3f0e7, ecf5c, 1da22, b4d2e, 6d7fe, 154e3, 2bcc2, b11e1, 4134a, 34ec5, 7b157, 30c4d, 79c40, 8a52b, 7b6ea, bf42c

3. feat(treeView): enhance treeView-beta with icons, bare labels, annotations & highlights: This pull request enhances the treeView-beta feature in the Mermaid project by adding support for bare (unquoted) labels, over 30 auto-detected file-type SVG icons, directory detection via trailing slashes, CSS class annotations, inline descriptions aligned across nodes, icon suppression options, and a global configuration to toggle icons, while maintaining backward compatibility and improving parsing and rendering through structured grammar terminals and a two-pass layout algorithm.

• URL: pull/7527

• Associated Commits: b4d04, bd732, baeb8, a4fcb, b707b, dbfde, 2f384

Other Open Pull Requests

• @zenuml/core dependency updates and SVG renderer improvements: These pull requests update the @zenuml/core dependency to versions 3.46.3 and 3.46.11, adapting the Mermaid ZenUML renderer to the latest SVG renderer API and introducing a native SVG renderer that improves print support and responsive diagram sizing. They also enhance resilience against invalid ZenUML syntax to prevent editor freezes and adjust release settings for immediate downstream version bumps.
  [pull/7536, pull/7543]

• xychart component enhancements and fixes: Multiple pull requests improve the xychart component by fixing label clipping near the x-axis, adding per-point text labels with collision checks, and implementing collision detection to flip labels on steep slopes. These changes ensure better label placement, readability, and backward compatibility for various use cases.
  [pull/7552, pull/7550, pull/7551]

• Sequence diagram styling support: A pull request adds support for style and classDef syntax to sequence diagram actor boxes, enabling custom CSS styling similar to flowcharts. This fulfills the most upvoted feature request and sets the foundation for further styling enhancements in sequence diagrams.
  [pull/7542]

• New arrow type introduction: A pull request introduces a new "open" arrow type represented by ~ to allow connectors without arrowheads, clarifying directional versus non-directional links and resolving ambiguities in node chains with mixed arrow types or specific layout needs.
  [pull/7522]

• Cynefin framework diagram type addition: This pull request adds a new Cynefin framework diagram type featuring five fixed complexity domains with organic boundaries, metadata, badges, transition arrows, theme integration, accessibility support, and a Langium-based grammar. It provides the first standard text-based DSL for Cynefin diagrams in Mermaid.
  [pull/7535]

• Gantt chart improvements: A pull request fixes font size handling, enables automatic scaling of bar height, and allows the Gantt chart to utilize theme variables for enhanced customization.
  [pull/7537]

• Block arrows multi-column rendering fix: This pull request fixes the issue where block arrows did not span multiple columns correctly when the widthInColumns property is set, ensuring proper rendering across columns.
  [pull/7523]

• Run script and help output fixes: A pull request addresses an edge case error in the run script by enforcing LF line endings via .gitattributes and corrects the formatting of the run help command output by adding a missing newline.
  [pull/7531]

• Non-deterministic ID generator bug fix: This pull request fixes a rare bug by combining the current timestamp with a small counter to prevent duplicate IDs generated within the same millisecond, while preserving existing deterministic ID generation behavior and backward compatibility.
  [pull/7540]

• GitHub Actions security and maintainability improvements: A pull request pins all GitHub Actions to immutable commit SHAs, extracts expressions into environment variables for safer referencing, and adds version comments for clarity without changing workflow logic or permissions.
  [pull/7541]

• Sankey diagram special character parsing tests: This pull request adds explicit test cases verifying correct parsing of special characters in Sankey diagram node names, confirming resolution of issue #7528 and ensuring support in both 'sankey' and 'sankey-beta' syntaxes.
  [pull/7545]

• Flowchart click event binding warning: A pull request adds a warning log message in the flowchart module to inform users when click event bindings fail due to the securityLevel not being set to "loose", improving debugging by clearly indicating the cause and affected node.
  [pull/7553]

• Class diagram extensionStart marker dimension fix: This pull request corrects the dimensions of the extensionStart marker in class diagrams, adjusting markerWidth from 190 to 20 and markerHeight from 240 to 28 to ensure proper rendering on mobile devices and iOS Safari.
  [pull/7538]

3.2 Closed Pull Requests

This section provides a summary of pull requests that were closed in the repository over the past week. The top three pull requests with the highest number of commits are highlighted as 'key' pull requests. Other pull requests are grouped based on similar characteristics for easier analysis. Up to 25 pull requests are displayed in this section, while any remaining pull requests beyond this limit are omitted for brevity.

Pull Requests Closed This Week: 5

Key Closed Pull Requests

1. replace Arial with Arimo in font-family settings across styles and themes: This pull request proposes replacing the Arial font with Arimo in font-family settings across styles and themes to resolve licensing issues and enable font embedding in exports.

• URL: pull/7524

• Associated Commits: f1c57

• Associated Commits: f1c57

2. fix: pin 2 unpinned action(s),extract 2 unsafe expression(s) to env vars: This pull request addresses security vulnerabilities in the GitHub Actions workflows by automatically pinning two previously unpinned third-party actions to specific commit SHAs and extracting two unsafe expressions into environment variables to prevent code injection and supply chain attacks.

• URL: pull/7529

• Associated Commits: 9bcd7

• Associated Commits: 9bcd7

3. feat: add Wardley Map diagram type: This pull request proposes adding a comprehensive Wardley Map diagram type to the Mermaid project, fully implementing the Wardley mapping standard with features such as multiple component types and modifiers, diverse edge types, evolution tracking, pipelines, annotations, area overlays, submaps, accelerators, customizable axis labels, full theme integration, schema-driven configuration, accessibility support, and extensive testing, thereby addressing a long-standing feature request.

• URL: pull/7533

• Associated Commits: 30c8f

• Associated Commits: 30c8f

Other Closed Pull Requests

• Per-point text labels in xy charts: These pull requests introduce and document a new feature that allows adding per-point text labels to line charts within xy charts. The feature extends the syntax to include optional quoted string labels after numeric values, rendering these labels adjacent to data points with the line's stroke color, while maintaining full backward compatibility and including comprehensive tests and documentation.
• pull/7547, pull/7548

3.3 Pull Request Discussion Insights

This section will analyze the tone and sentiment of discussions within this project's open and closed pull requests that occurred within the past week. It aims to identify potentially heated exchanges and to maintain a constructive project environment.

Based on our analysis, there are no instances of toxic discussions in the project's open or closed pull requests from the past week.

IV. Contributors

4.1 Contributors

Active Contributors:

We consider an active contributor in this project to be any contributor who has made at least 1 commit, opened at least 1 issue, created at least 1 pull request, or made more than 2 comments in the last month.

If there are more than 10 active contributors, the list is truncated to the top 10 based on contribution metrics for better clarity.

Access Last Week's Newsletter:

• Link