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 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: OTHER] [STATUS: APPROVED] [STATUS: TRIAGE] [AREA: DEVELOPMENT] [AREA: DEVOPS] [P1] Decrease the number of e2e-tests that run for each PR.: This issue addresses the problem of running the full end-to-end test suite on every pull request, which leads to excessive consumption of Argos screenshot credits and longer continuous integration times, negatively impacting developer experience. The proposed solution is to detect which specific diagram(s) a pull request modifies and run only the relevant end-to-end tests, falling back to the full suite only if shared or common code is affected, thereby optimizing resource usage and speeding up feedback.

   • The comments show a user requesting to take ownership of the issue after discussing it with a colleague, and the request is promptly approved.
   • Number of comments this week: 2

2. [TYPE: BUG / ERROR] [STATUS: APPROVED] [GRAPH: FLOW] Internal error on subgraph with numeric identifier: This issue describes a TypeError occurring when rendering a Mermaid diagram that contains a subgraph with a numeric identifier, specifically causing the error "Cannot set properties of undefined (setting 'rank')". The problem does not occur when the numeric identifier is replaced with a letter, indicating a bug related to the handling of numeric subgraph identifiers in the rendering process.

   • The comments clarify that the error is specific to the dagre layout and does not occur when using the elk layout, suggesting a layout-specific rendering bug; the issue has been acknowledged and approved by the maintainers.
   • 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: 16

Summarized Issues:

• Rendering and Syntax Issues: Several issues describe rendering problems caused by syntax errors or unsupported features in Mermaid diagrams. These include syntax errors with unquoted special characters in flowcharts, internal errors from numeric subgraph IDs, incorrect keyword usage for Sankey diagrams, and visible multi-line comment blocks in ZenUML diagrams, all leading to failed or incorrect diagram rendering.
• issues/7590, issues/7609, issues/7613, issues/7614

• Color and Style Rendering Problems: Some issues highlight problems with color and style application in Mermaid diagrams. ClassDef colors are ignored on certain shapes due to CSS selector limitations, and mindmap icons fail to render because required fonts or CSS are not loaded, resulting in default or missing visuals without warnings.
• issues/7596, issues/7615

• Chart Layout and Usability Issues: Multiple issues report layout and usability problems in charts, such as overlapping long x-axis labels, axis tick lines rendering outside boundaries in sparklines, inconsistent multiline section titles in Gantt charts, and cramped layouts in compact Gantt display mode, all reducing readability and visual clarity.
• issues/7599, issues/7600, issues/7602, issues/7603

• Feature Requests for Diagram Interaction and Annotation: There are requests to improve user interaction with diagrams by adding annotation overlays for sketching and exporting annotated images, interactive tooltips for packet diagrams showing detailed field info, and enhanced features for pie and quadrant charts to improve visual appeal and interactivity.
• issues/7605, issues/7606, issues/7607, issues/7608

• Testing and CI Optimization: One issue proposes optimizing continuous integration testing by selectively running end-to-end tests only for affected diagrams in pull requests, aiming to conserve Argos credits and reduce build times while maintaining test coverage.
• issues/7593

• Diagram Type Rendering Inconsistencies: An issue describes inconsistent or missing rendering of the info diagram type when used in standalone HTML pages initialized via ESM, causing unclear or no visible output and differing behavior between variants.
• issues/7601

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

Key Open Pull Requests

1. feat: add nested namespace support for class diagrams: This pull request restores and properly implements nested namespace support for class diagrams in Mermaid, addressing regressions between versions 11.3.0 and 11.4.x by enabling both dot notation and syntactic nesting to create hierarchical namespace clusters, improving rendering in both v2 and v3 diagram engines, adding support for custom namespace labels, and including comprehensive tests and documentation.

• URL: pull/7604

• Associated Commits: 63354, bf950, ac9f2, e002c

2. fix(mindmap): correct root edge attachment in tidy-tree layout: This pull request fixes a visual disconnection issue in mindmap diagrams using the tidy-tree layout by correcting the root-to-child edge attachments to skip intermediate routing points for edges connected to the root node, ensuring direct paths and proper alignment.

• URL: pull/7591

• Associated Commits: 35232, bbeaa, 6e590

3. feat: add sandboxLinkBaseUrl for relative links in sandbox mode: This pull request introduces an opt-in configuration option sandboxLinkBaseUrl that enables Mermaid to correctly resolve relative links within sandboxed data: iframes by rewriting clickable anchor links in the live SVG DOM before serialization, thereby preserving link functionality when using securityLevel: 'sandbox'.

• URL: pull/7595

• Associated Commits: faa06, 6cfd2

Other Open Pull Requests

• Parser and Lexer Improvements: Multiple pull requests focus on refining parsers and lexers to handle complex syntax correctly. These include fixing numeric token handling in the ER parser to support left-side numeric entity identifiers, enhancing the class diagram parser to manage nested generic types with depth tracking, and updating lexer rules to support dashed CSS properties and functions in style components, improving overall parsing accuracy and style handling.
• pull/7598, pull/7610, pull/7611

• Testing and CI Enhancements: One pull request introduces a feature-flagged continuous integration improvement that enables diagram-scoped end-to-end test selection. This is achieved by adding Node.js scripts to detect changed files and run only relevant Cypress test specs in parallel with caching, optimizing test execution without affecting existing workflows.
• pull/7619

• Diagram Feature Enhancements: Several pull requests add new features to diagram rendering and validation. These include support for toggling endianness in packet rendering to switch between big and little endian formats, and the introduction of a Langium semantic validator for Event Modeling diagrams that enforces strict directional connection rules between entity types according to methodology standards.
• pull/7585, pull/7588

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

Key Closed Pull Requests

1. fix(block-beta): normalize width before comparison in getMaxChildSize: This pull request fixes a bug in the getMaxChildSize function by normalizing child element widths before comparing them to the maximum width, ensuring consistent per-column width comparisons and preventing incorrect shrinking of maxWidth when handling elements spanning multiple columns.

• URL: pull/7589

• Associated Commits: a6da3, 7fb95, 65898, 411be, 368d5

• Associated Commits: a6da3, 7fb95, 65898, 411be, 368d5

2. chore: drop lodash-es in favour of es-toolkit: This pull request removes the lodash-es dependency from the project and replaces it with the more modern and performance-optimized es-toolkit, ensuring full compatibility while improving bundle size and maintaining all existing tests and documentation.

• URL: pull/7587

• Associated Commits: a391d, 01b85, 5e7eb, 93266

• Associated Commits: a391d, 01b85, 5e7eb, 93266

3. Fixed typo: This pull request fixes a typo by removing an unnecessary backslash in the Venn diagrams version string within the Mermaid project documentation.

• URL: pull/7563

• Associated Commits: 6b59e, 6807c, e57b7

• Associated Commits: 6b59e, 6807c, e57b7

Other Closed Pull Requests

• New Diagram Types and Rendering Enhancements: This topic covers the introduction of a new beta railroad diagram type in Mermaid, which implements a three-phase rendering pipeline to parse a functional expression language and generate scalable SVG railroad track visuals. The design separates grammar structure from visual layout and supports diverse diagrammatic representations beyond traditional grammar formalisms.
• pull/7612

• Documentation and UI Improvements: This topic includes enhancements to user accessibility by adding a visible link in the sidebar to the newly released Wardley map beta documentation. These changes improve navigation and promote awareness of new features within the Mermaid project.
• pull/7582

• Security and Link Resolution Configurations: This topic involves adding an opt-in sandboxLinkBaseUrl configuration to Mermaid to enable correct resolution of relative links within sandboxed data: iframes when using securityLevel: 'sandbox'. The feature ensures clickable anchor links are properly rewritten before SVG embedding without affecting internal SVG references.
• pull/7594

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