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 that introduced the addition of a Radar Chart, enhancing the charting capabilities of the platform. This update 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.

1. [docs] Document validation error for invalid duration tokens in Gantt diagrams: This issue addresses the need to update the documentation for Gantt diagrams to reflect a new validation error that occurs when invalid duration tokens with trailing characters are parsed, replacing the previous behavior where such tasks were simply ignored. The update should be made in the gantt.md file to clearly explain this change in behavior following a recent pull request.

   • A user requested to be assigned the issue, noting that their colleagues are working on the related pull request to fix the problem.
   • Number of comments this week: 1

Since there were fewer than 5 open issues, all of the open issues have been listed above.

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.

1. Tooltips for emoji in Diagram Syntax doc tree: This issue proposes adding tooltips to the emoji displayed next to the names of various diagram types in the "Diagram Syntax" section of the documentation tree. The goal is to help users understand the meaning of these icons, as currently there is no reference explaining their significance, which can cause confusion even for experienced users.
2. log scale for xychart-beta: This issue proposes adding a scale string field to the xychart-beta component that defaults to linear but can also accept log as an option, enabling the plotting of logarithmic scales while maintaining version control of the original non-logged data. The enhancement aims to support future extensions to other scale types and includes an example demonstrating how to specify the log scale for chart axes and data series.
3. Unable to Style Sequence Diagram Title: This issue reports the inability to modify the font size of the title in a sequence diagram created with Mermaid, with the user currently resorting to using a Markdown title as a workaround. The user notes that while other diagram types in Mermaid, such as QuadrantChartConfig, support title styling attributes, this functionality is not yet available for sequence diagrams, leading to very small and unreadable titles when the diagram grows complex.
4. SVG rendering formatting issues with markdown input: This issue addresses problems with SVG rendering when nodes in a Mermaid diagram contain markdown formatting, resulting in inconsistent visual output such as added height or text being cut off in the SVG files. Specifically, these formatting issues occur when opening the SVG in a new tab or downloading it from the editor, causing discrepancies between the expected and actual appearance of the diagram nodes.
5. Vite build error with mermaid version 10.9.0: This issue describes a problem encountered when building a Vue 3 and Vite application that uses Mermaid version 10.9.0 to visualize graphs. While the development server runs without errors and displays the graphs correctly, the build process results in a runtime error related to setting properties on an undefined object, causing the application to fail on startup.

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: 7

Summarized Issues:

• Documentation inaccuracies and updates: Several issues highlight problems with Mermaid's documentation, including unclear or inaccurate explanations of directive behaviors and the need to update documentation to reflect new validation error handling. Users report difficulties reproducing expected behaviors and discrepancies between documentation and actual functionality, indicating a need for clearer and more accurate documentation.
• issues/7210, issues/7212

• Diagram rendering and layout bugs: Multiple issues describe rendering problems in different Mermaid diagram types, such as unexpected edge curvature in ELK layouts, improper block expansion in block-beta diagrams, and unreadable text in TreeMap titles on dark backgrounds. These bugs cause visual inconsistencies and usability problems, suggesting the need for improved layout algorithms and theming support.
• issues/7213, issues/7214, issues/7218

• Graph structure and behavior inconsistencies: Users report issues with graph structure capabilities, such as the inability to create edges from outer parent groups in nested group diagrams and discrepancies in rendering outputs between different Mermaid environments despite identical input code. These inconsistencies affect the reliability and predictability of Mermaid diagrams.
• issues/7211, issues/7220

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: 5

Key Open Pull Requests

1. Bug/treemap block colours mixed with parent container: This pull request fixes the issue where treemap child blocks were rendering with mixed colors from the parent container by updating the color rendering logic to ensure child blocks display the exact class-defined colors without blending, including adjustments to fill and style attributes and corresponding unit tests.

• URL: pull/7209

• Merged: No

• Associated Commits: 2cbe0, 06659, 2a511

2. Update pricing tier in Editor selection modal: This pull request proposes updating the pricing tier information displayed in the editor selection modal of the Mermaid project.

• URL: pull/7216

• Merged: No

• Associated Commits: 0b1ee, ccfd4

3. 7210 : fix for gitgraph showBranches and showCommitLabel directives: This pull request addresses a fix for the gitgraph directives showBranches and showCommitLabel to improve their functionality within the Mermaid project.

• URL: pull/7217

• Merged: No

• Associated Commits: bbb9c, e0317

Other Open Pull Requests

• Documentation updates: This topic includes pull requests that update existing documentation files and add new markdown files to the project. These changes improve the clarity and breadth of the project's documentation resources.
• pull/7221

• C4 Dynamic diagram fixes: These pull requests address issues in handling C4 Dynamic diagrams by preventing the incorrect merging of multiple interactions between the same components. The fix involves recognizing duplicate relations properly by avoiding merging relations in the database due to missing c4Type parsing.
• pull/7219

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: 1

Key Closed Pull Requests

1. Add HackMD integration to community integrations list: This pull request adds the HackMD.io integration to the community integrations list in the Mermaid project, enabling native support as documented in the HackMD documentation.

• URL: pull/7204

• Merged: Yes

• Associated Commits: 6bf2b, b4b90

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.