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] Class diagrams: Self referential multiplicity is displayed multiple times: This issue reports a bug in class diagrams where self-referential multiplicity is displayed multiple times instead of once, causing visual clutter. The problem occurs because the layout engine splits the self-referential edge into multiple segments, each incorrectly showing the multiplicity labels.

   • The comments confirm the issue is reproducible on the latest version and explain the root cause involving the layout engine splitting the edge into three segments, each duplicating the multiplicity labels. A fix has been proposed and merged that ensures multiplicities are rendered only once per relationship end while maintaining the relationship label centered, and users are encouraged to test the fix with their diagrams.
   • Number of comments this week: 2

2. [STATUS: TRIAGE] [docs] Documentation addition for class diagram hideEmptyMembersBox configuration option missing from formal configuration reference (Issue #7433, PR #7537): This issue requests an addition to the classDiagram.md documentation to include a formal configuration parameter table for the hideEmptyMembersBox option, detailing its type, default value, and description, as this information is currently missing from the file. The goal is to provide users with a clear reference within the class diagram documentation itself, similar to other diagram docs that have dedicated configuration tables.

   • The comments include a request for a maintainer to add specific labels to the issue and a volunteer expressing interest in working on the issue and asking to be assigned.
   • Number of comments this week: 2

3. [TYPE: BUG / ERROR] [STATUS: TRIAGE] Mindmap's root node and it's links look disconnected when using tidy-tree: This issue describes a visual problem in the Mermaid mindmap when using the tidy-tree layout with more than five nodes, where the links between the root node and its right-side subnodes appear disconnected depending on the root node's shape. The user notes that while the cloud-shaped root node maintains connected links, other shapes like rectangle, rounded rectangle, and circle cause the links to look disconnected, suggesting a potential problem with how the tidy-tree layout computes or routes these edges.

   • The comment investigates the problem and concludes that the issue is unlikely due to node shape differences alone, as both default and cloud shapes use the same edge attachment method; instead, it points to a probable bug in the tidy-tree edge routing or attachment path for root children on the right side, recommending further inspection of this routing logic.
   • Number of comments this week: 1

4. [STATUS: TRIAGE] [docs] Documentation addition for pie chart pieOuterStrokeWidth themeVariable missing from configuration table (Issue #7198, PR #7241) : This issue highlights a missing documentation entry for the pieOuterStrokeWidth theme variable in the pie chart configuration table, which is currently used in an example but lacks explanation regarding its purpose, accepted values, and default setting. The reporter requests that the configuration table in the pie.md file be updated to include this variable to improve clarity and usability for users.

   • A single comment requests that a maintainer add specific labels to the issue for categorization and tracking purposes.
   • Number of comments this week: 1

5. [STATUS: TRIAGE] [docs] Documentation addition for gitGraph branch ordering precedence rules being ambiguous when mixing ordered and unordered branches (Issue #7201, PR #7238): This issue addresses the ambiguity in the gitGraph documentation regarding the precedence rules for branch ordering when mixing ordered and unordered branches, where the current example contradicts the stated behavior. It requests an update to the documentation to clarify that branches are sorted by their effective order value, with unordered branches implicitly ordered by their position, and to include a clearer annotated example demonstrating the rendering sequence.

   • A user requested that a maintainer add specific labels to the issue to categorize it appropriately for documentation and fix queue tracking.
   • Number of comments this week: 1

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

Summarized Issues:

• Visual rendering bugs in diagrams: Several issues describe visual problems in Mermaid diagrams, including text concatenation when wrapping long text, duplicated multiplicity labels in class diagrams, disconnected edges in mindmap diagrams, and extra space added by vertical markers in gantt charts. These bugs affect the clarity and correctness of diagram displays, causing confusion or incorrect visual output.
• issues/7555, issues/7560, issues/7564, issues/7572, issues/7579

• Browser and environment compatibility issues: Some issues report problems specific to certain environments, such as scroll bounce effects on Chrome with trackpads caused by tabindex on SVG elements, and failure to render HTML labels correctly in the IntelliJ embedded Chromium environment. These environment-specific bugs disrupt user experience and require workarounds or detection mechanisms.
• issues/7559, issues/7565

• Documentation improvements and clarifications: Multiple issues highlight missing or unclear documentation, including absent explanations for theme variables, ambiguous branch ordering rules in gitGraph, missing version tags and parameter tables for animation and autonumber features, and lack of configuration parameter details for class diagram options. These documentation gaps hinder user understanding and proper usage of Mermaid features.
• issues/7573, issues/7574, issues/7575, issues/7576, issues/7577

• Feature integration and modularization: One issue proposes architectural changes to decouple Mermaid’s diagram logic from its core engine by modularizing into standalone packages, aiming to simplify contributions and improve maintainability. Another issue requests guidance on adding a new Usecase Diagram type to the Live Editor’s sample selection menu to improve discoverability.
• issues/7556, issues/7569

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:

• Scrolling and Focus Issues with SVG Elements: Adding tabindex="0" to SVG elements in Mermaid v11 causes an unwanted scroll bounce effect on Chrome when using a trackpad on macOS. This issue disrupts smooth scrolling because Chrome treats these focusable SVG elements as scroll containers, leading to a poor user experience.
• issues/7558

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

Key Open Pull Requests

1. Feature/flowchart edge classdef: This pull request adds support for applying classDef styles directly to edges in flowchart diagrams using a new inline @:::className syntax, enabling users to style multiple edges simultaneously while maintaining backward compatibility with edge IDs.

• URL: pull/7557

• Associated Commits: 282c6, 1dc98, 0375a, 02794

2. Fixed typo: This pull request fixes a typo by removing an unnecessary backslash in the version notation for Venn diagrams in the Mermaid project documentation.

• URL: pull/7563

• Associated Commits: 6b59e, 6807c, e57b7

3. fix #7091: Ensure only one word is allowed between 'state' and '{': This pull request fixes issue #7091 by adding a new parser rule that enforces only one word is allowed between the 'state' keyword and the '{' character in state diagrams, ensuring invalid syntax with multiple words is rejected with an appropriate error message.

• URL: pull/7570

• Associated Commits: 65e5b, dee89, 97582

Other Open Pull Requests

• Rendering improvements and bug fixes: Multiple pull requests enhance diagram rendering by improving native SVG output for ZenUML integration, which boosts print rendering and responsiveness while preventing editor freezes. Additionally, a bug fix addresses duplicated cardinality labels in self-referential class diagrams by refining label assignment and DOM hierarchy.
• pull/7567, pull/7578

• Documentation and integration updates: Pull requests add new community integrations and improve documentation accessibility by including the Termaid Python library and CLI tool on the integrations page and adding a sidebar link to the Wardley map beta documentation. These changes help users discover new tools and features more easily.
• pull/7562, pull/7582

• Diagram label adjustments: A pull request shortens node and relationship labels in the C4 Container demo to prevent text overlap by trimming long descriptions and removing unnecessary style overrides, improving diagram clarity and readability.
• pull/7583

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

• 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. fix: update @zenuml/core to v3.46.11 with native SVG renderer: This pull request updates the @zenuml/core dependency to version 3.46.11, introducing a native SVG renderer that improves print support by using SVG strokes instead of CSS borders, enables responsive diagram sizing respecting Mermaid's useMaxWidth setting, and enhances resilience against invalid ZenUML syntax to prevent editor freezes.

• URL: pull/7543

• Associated Commits: 23e99, 3f113, e9c42, db422, 3bf5c, 75858

• Associated Commits: 23e99, 3f113, e9c42, db422, 3bf5c, 75858

3. ci: add lint action for renovate config: This pull request adds a GitHub Action to lint the renovate.json configuration file to prevent broken renovate config changes from being merged, especially addressing the limitation that the existing renovatebot app does not validate PRs from forks.

• URL: pull/7495

• Associated Commits: 0f6b0

• Associated Commits: 0f6b0

Other Closed Pull Requests

• Renderer Improvements: This pull request proposes switching the Mermaid ZenUML renderer from using HTML inside foreignObject to native SVG output provided by @zenuml/core. The change aims to improve rendering within the SVG tree and maintain responsive and fixed-width sizing behavior, while also adding focused renderer tests and a local type override.
• pull/7566

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