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.

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

Summarized Issues:

• Diagram Layout Optimization: This topic covers issues related to improving the visual layout and readability of diagrams by optimizing their structure. One issue requests a more compact, S-shaped layout for long flowcharts to enhance usability in editors like VS Code and Typora, while another suggests reducing arrow lengths in state diagrams to improve visual clarity.
• issues/7368, issues/7381

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

Summarized Issues:

• SVG Class Consistency: This issue requests adding a class with the name of the diagram type to every SVG element for all diagram types to ensure consistency and facilitate integration. Currently, only some diagrams include such a class, leading to inconsistency across different diagram types.
• issues/7353

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

Key Open Pull Requests

1. draft: showDataLabelOutsideBar option for xy chart: This pull request introduces a new option, showDataLabelOutsideBar, for XY charts in Mermaid to allow displaying data values outside of vertical and horizontal bars, addressing user requests and improving chart readability, along with updated documentation and tests to support this feature.

• URL: pull/7382

• Associated Commits: 1c08c, 530b6, cd0df, 6ce13, ca3ee, 2fea5, 60f52, c2bfe

2. chore: upgrade to Langium v4 and TypeScript v5.8: This pull request upgrades the @mermaid-js/parser package to Langium v4 and TypeScript v5.8, addressing breaking changes such as renaming grammars, updating generated type names, converting the EOL fragment into a rule, and replacing import assertions with import attributes, while preparing for a major version release (v1.0.0) and ensuring compatibility with the master branch.

• URL: pull/7377

• Associated Commits: 0b7c2, 77da2, af35b, 9fbd1, dab01, 47847

3. fix: add width buffer for CJK characters to prevent truncation in PNG…: This pull request fixes the issue of the last 1-2 Korean, Chinese, or Japanese characters being clipped when exporting diagrams to PNG by adding a 5% width buffer to account for SVG getBBox() underestimating CJK character widths during the canvas conversion, ensuring proper rendering of these characters in exported images.

• URL: pull/7367

• Associated Commits: 2a450, c8c74, 1ebbf, 5669e, c7dd8

Other Open Pull Requests

• "Neo" visual style enhancements: Multiple pull requests introduce and refine a new "neo" visual style for Mermaid diagrams, including modern visual enhancements such as gradient borders, drop shadows, increased label padding, customizable stroke widths, and six new themes optimized for this sleek style. These changes also include refactoring to improve line function offsets and SVG enhancements to support gradient and shadow effects, along with tests to ensure proper support.
• [pull/7366, pull/7376]

• Community integrations additions: Several pull requests add new tools to the community integrations section, including DrillSpark, an AI-powered tool for generating business process flowcharts from natural language, and Mermaid Studio, which is added alongside the official JetBrains Mermaid plugin in the AI section due to its suite of MCP tools for diagram generation. Another pull request adds Tachi Code to the list of supported browser extensions, expanding the ecosystem of supported tools.
• [pull/7370, pull/7373, pull/7374]

• Lexer rule fix for cardinality alias: One pull request fixes an issue where the 1 alias for "only one" cardinality was not recognized when directly followed by relationship operators like -- or ... This was addressed by adding a new lexer rule to correctly identify 1 in these contexts and adding relevant tests to cover these cases.
• [pull/7375]

• Documentation update: A pull request updates the title of the class diagram documentation to "Class diagrams RAG" to improve clarity and accuracy.
• [pull/7380]

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

Key Closed Pull Requests

1. chore: Update banner with promo: This pull request updates the project banner to feature a new promotion and includes fixes to the getHeaderLogoLink function along with an import update.

• URL: pull/7372

• Associated Commits: e97fb, efb3d, 885e2, ea17a

• Associated Commits: e97fb, efb3d, 885e2, ea17a

2. chore: Update mermaidchart.com to mermaid.ai: This pull request updates the domain reference from mermaidchart.com to mermaid.ai throughout the project.

• URL: pull/7371

• Associated Commits: 8714e, 1f866

• Associated Commits: 8714e, 1f866

3. chore: update Cypress browser image to chrome-127: This pull request updates the Cypress browser Docker image used in end-to-end testing workflows from version chrome-121 to the newer chrome-127 to ensure compatibility and leverage the latest browser features.

• URL: pull/7379

• Associated Commits: 15906, 176bd

• Associated Commits: 15906, 176bd

Other Closed Pull Requests

• Subscription Link Update: This pull request updates the call-to-action (CTA) link for the Editor selections in the Mermaid project to include a tier parameter in the checkout URL for the Mermaid Plus subscription. The change ensures that the subscription tier is correctly passed in the checkout process, improving the user experience for subscribing to Mermaid Plus.
• pull/7365

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