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.

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 better understand the meaning of these icons, as their significance is currently unclear even to those who have used Mermaid diagrams multiple times.
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 true, non-logged values in the graph description. This enhancement aims to improve flexibility in data visualization by allowing users to version control charts with different scale types and potentially extend support to other scales in the future.
3. Unable to Style Sequence Diagram Title: This issue reports a problem with styling the title of a sequence diagram in Mermaid, specifically the inability to change the font size of the title directly within the diagram configuration. The user notes that while other diagram types in Mermaid support title attributes for customization, such as font size, this feature is not yet available for sequence diagrams, leading them to use a Markdown title as a workaround.
4. SVG rendering formatting issues with markdown input: This issue addresses problems with SVG rendering when nodes in a diagram use 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 in node dimensions and text display.
5. Vite build error with mermaid version 10.9.0: This issue describes a build error encountered when using Mermaid version 10.9.0 in a Vue 3 and Vite application. While the Mermaid graphs render correctly during development, the application fails to start after building, producing a "TypeError: Cannot set properties of undefined (setting 'prototype')" related to Mermaid's API initialization.

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

Summarized Issues:

• Rendering Issues with Diagrams: Several issues report problems with rendering elements in different Mermaid diagrams. The quadrant chart fails to render Chinese characters except for the title, and sequence diagrams do not correctly display self-call activations, leading to incomplete visual representations.
• issues/7120, issues/7137

• GitGraph Functionality Problems: Multiple issues highlight failures in the GitGraph diagram tool, including incorrect branch merging visualizations and non-functional configuration options like rotateCommitLabel, showBranches, and parallelCommits. These problems cause inaccurate or ignored settings in the commit label display and branch history.
• issues/7125, issues/7126, issues/7142

• Customization and Styling Limitations: There are concerns about Mermaid's styling capabilities, such as hardcoded inline styles with !important flags in class diagram labels that prevent external CSS customization and dynamic theme changes. Additionally, silent acceptance of semicolons instead of commas in style definitions leads to unexpected output without error messages.
• issues/7131, issues/7140

• Feature Enhancement Proposals: Several issues propose new features to improve Mermaid's diagrams, including adding vertical gaps in Timeline diagrams for better chronological representation, introducing UML CollaborationUse notation for class diagrams, and enabling hiding commits without specific IDs to improve diagram clarity.
• issues/7134, issues/7141, issues/7142

• Documentation and Example Accuracy: One issue points out that documentation examples for class diagram annotations no longer render correctly, causing confusion for users relying on official Mermaid.js website examples.
• issues/7143

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

Key Open Pull Requests

1. feat: Support handDrawn look for all diagrams: This pull request introduces support for a hand-drawn visual style across all diagram types in the Mermaid project, including capability detection, marking diagrams as handDrawn-capable, and comprehensive testing to ensure consistent implementation.

• URL: pull/7130

• Merged: No

• Associated Commits: 31345, 6f293, f4e2b, a2476, 33dfa, 55cea, ffa72, 0b4e6

2. Feature/7078 Allow decimal sequence numbers: This pull request adds support for decimal sequence numbers up to the hundredths place in sequence diagrams, updates the parser and increment logic to handle decimals accurately without floating-point errors, and adjusts font size dynamically for longer sequence numbers to improve display.

• URL: pull/7132

• Merged: No

• Associated Commits: 409a4, d2551, a1045, 5d56b, 31239, cd85e

3. feat : add alias support for new participant syntax: This pull request introduces support for combining UML stereotype configurations with descriptive aliases in sequence diagram participants, enabling syntax like participant API@{ "type" : "boundary" } as Public API to enhance both the visual representation and clarity of participants, along with corresponding parser grammar modifications and comprehensive tests.

• URL: pull/7136

• Merged: No

• Associated Commits: 9fdc4, 29ed5, 6bc66

Other Open Pull Requests

• Shape Implementation Reversion: This topic covers the reversion of the hexagon and roundedRect shape implementations to their original code, removing the previously introduced dependencies on simplified helper functions. The pull requests focus on restoring the initial shape code to maintain consistency and reduce complexity.
• pull/7139

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. add doc to use marmaid.js in GNU Octave: This pull request adds documentation on how to use mermaid.js within GNU Octave, resolving issue #7073 and ensuring compliance with contribution guidelines, including the addition of necessary tests and updates to changelogs.

• URL: pull/7128

• Merged: Yes

• Associated Commits: f2d78, 57530, 38c28, 7b076, c0e16, e4cf2, 0bd74, 54580, 5f96f

2. docs: improve README with local setup and usage instructions: This pull request aims to enhance the project's README by adding clear and detailed local setup and usage instructions to help new contributors get started more easily.

• URL: pull/7123

• Merged: No

• Associated Commits: 22bd1, 26e7c

3. Refactor GitHub Actions workflow for lockfile validation: This pull request refactors the GitHub Actions workflow for lockfile validation by removing the unnecessary Node.js setup step and updating the pnpm action version to streamline the process.

• URL: pull/7127

• Merged: Yes

• Associated Commits: 1e7b7

Other Closed Pull Requests

• Build optimization and variable namespace adjustment: This pull request optimizes the bundling process by removing the shipping of the package.json file inside Mermaid's JavaScript bundle and relocating all build-time injected variables to the injected. namespace to prevent conflicts. These changes help streamline the build output and avoid potential naming collisions during runtime.
• pull/7129

• Test description refactoring for ER diagrams: This pull request refactors the test descriptions to improve clarity for standalone numeric entities in the ER diagram within the Mermaid project. The improved descriptions make the tests easier to understand and maintain.
• pull/7135

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.