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.

1. [TYPE: BUG / ERROR] [STATUS: TRIAGE] step.js:52 Uncaught TypeError: require_dist is not a function: This issue describes an error encountered when importing the mermaid library in a Vite project, resulting in a "Uncaught TypeError: require_dist is not a function" message. The user reports this problem occurs simply by importing Mermaid, and no additional context or suggested solutions were initially provided.

   • The first comment suggests that downgrading to version 10.9.5 resolves the issue, while the second comment requests more information about the Mermaid and Vite versions and whether an ESM file is being used to further investigate the problem.
   • Number of comments this week: 2

2. [TYPE: BUG / ERROR] [STATUS: TRIAGE] [HOW] flowchart rendering optimization: This issue concerns optimizing the rendering of Mermaid flowcharts in a top-down layout, specifically addressing excessive padding that causes oversized graphs and difficulties in achieving a more compact, visually fitting diagram without zooming out. The user also highlights problems with the rendering order not matching the written script (WYSIWYG), and issues with connecting nodes that disrupt the layout, seeking ways to "pin" nodes and subgraphs to maintain structure.

   • The comments provide a suggestion to adjust CSS configuration parameters to reduce padding and spacing, but the user reports that these adjustments are insufficient and that linking nodes still disrupts the layout; there is also confusion about undocumented configuration options and a request for clearer documentation or visual aids to better understand parameter effects.
   • Number of comments this week: 2

3. [TYPE: ENHANCEMENT] [STATUS: TRIAGE] [GRAPH: GIT] [REQUIRED GROOMING] gitgraph: add squash: This issue requests the addition of a squash feature and custom commit icons, such as a hamburger icon to represent squash commits, in the gitgraph component of the project. The user also inquires about the possibility of supporting emojis as icons and suggests an automatic ID format for squash commits, while expressing unfamiliarity with front-end development and syntax proposals.

   • The maintainers welcomed the suggestion and asked for syntax proposals and preferences for icon support, while the user responded with tentative ideas for squash syntax and icon usage, expressed uncertainty about front-end implementation, and requested the issue to be reopened.
   • Number of comments this week: 2

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.

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

Summarized Issues:

• Rendering and Layout Issues: Several issues highlight problems with rendering and layout in Mermaid diagrams, including clipped text labels in Safari at non-default zoom levels and excessive padding causing oversized flowcharts. Users also report difficulties with inverse rendering order conflicting with WYSIWYG expectations and challenges in maintaining layout integrity when connecting nodes.
• issues/7323, issues/7328

• GitGraph Visualization Problems: There are issues with the Mermaid gitGraph feature where branches render too close together and tags rotate incorrectly without an option to disable tag rotation. Additionally, users request enhancements to support rebase and squash operations with custom commit icons to improve visualization.
• issues/7327, issues/7334

• Diagram Customization and Features: Users seek ways to customize diagram edges for smoother curves in Finite State Machine diagrams using ELK layout and propose new chart types like multi-level pie charts that can upgrade to ring charts for hierarchical data representation. These requests focus on improving visual appeal and expanding chart capabilities.
• issues/7324, issues/7325

• Import Errors: An error occurs when importing the mermaid library in a Vite project, resulting in a "Uncaught TypeError: require_dist is not a function" message, indicating issues with module compatibility or bundling.
• issues/7321

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

Summarized Issues:

• Parsing Errors in Mermaid Charts: Multiple issues involve parsing problems within Mermaid's chart rendering, such as the XY Chart parser causing browser crashes when handling multiline elements with closing braces. These parsing errors lead to significant disruptions, including browser tab hangs and fatal syntax errors during Markdown rendering.
• issues/7279

• Code Block Parsing in Static Site Generators: Mermaid version 11.12.2 incorrectly parses non-mermaid fenced code blocks in static site generator environments, resulting in fatal syntax errors that break normal Markdown rendering. This issue highlights problems with Mermaid's handling of fenced code blocks outside its intended context.
• issues/7330

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

Key Open Pull Requests

1. feature/7198 allow rows have different heights: This pull request extends the block diagram feature in Mermaid.js by introducing a new grammar option that allows individual rows to have different heights based on the largest block in each row, enabling varied row scaling while maintaining backward compatibility with equal scaling as the default behavior, and also includes bug fixes and code optimizations related to scaling and layout.

• URL: pull/7329

• Associated Commits: 10779, 1577b

2. chore: Update outdated GitHub Actions versions: This pull request updates the versions of GitHub Actions used in the workflow files, specifically upgrading actions/setup-node and actions/checkout from version v4 to v6 in the .github/workflows/validate-lockfile.yml file to ensure compatibility with the latest GitHub Actions and improve workflow stability.

• URL: pull/7326

• Associated Commits: 6f16a

3. fix: resolve text clipping at non-100% zoom/DPR: This pull request fixes text clipping issues in Mermaid flowchart nodes that occur at non-100% browser zoom levels or device pixel ratios by replacing a strict equality check with a tolerance-based comparison in the addHtmlSpan function to ensure proper text wrapping.

• URL: pull/7338

• Associated Commits: 5e2ca

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. Chore/7282 allow for port to be overriden in single place: This pull request enables the mermaid service port to be configured from a single .env file instead of being hardcoded to port 9000 in multiple places, facilitating easier local development when port 9000 is already in use by another service.

• URL: pull/7283

• Associated Commits: 92513, e9270, d7c42, bcf3d, ae2d8, 0b434, bdca4, 4c106, 38e8d, a5fe0, c2bec, 00b1e

• Associated Commits: 92513, e9270, d7c42, bcf3d, ae2d8, 0b434, bdca4, 4c106, 38e8d, a5fe0, c2bec, 00b1e

2. 7156:Support quoted string labels in architecture diagrams: This pull request fixes a parsing error in the architecture-beta diagrams of the Mermaid project by adding support for labels wrapped in quoted strings, thereby preventing syntax errors when such labels (e.g., ["Database"]) are used.

• URL: pull/7310

• Associated Commits: a9e4c, 3d386, d106d

• Associated Commits: a9e4c, 3d386, d106d

3. 7185 : Prevent unintended opacity on icon rect elements for AWS icons: This pull request fixes an issue where SVG icons containing rect elements, such as AWS CloudWatch, Route53, and EKS icons, had unintended semi-transparent backgrounds by refining the CSS selector to apply opacity only to rect elements within the .label class, thereby preventing unwanted opacity on the icon backgrounds.

• URL: pull/7265

• Associated Commits: 4046b, 20006

• Associated Commits: 4046b, 20006

Other Closed Pull Requests

• Label Rendering Refactor: This pull request extracts and refactors shared label rendering logic used across multiple diagram types in the Mermaid project. It creates a foundation for future markdown-specific rendering enhancements without introducing markdown behavior itself.
• pull/7275

• Parser Error Enhancements: This pull request enhances the MermaidParseError class by adding line and column numbers to all parser error messages across various diagram types. It improves the debugging experience with precise error location details and includes comprehensive tests to verify the new error formatting.
• pull/7333

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.