Weekly GitHub Report for Mermaid: August 04, 2025 - August 11, 2025 (22:42:16)
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:
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.
-
Stronger inline or individual component editing for sequence diagrams: This issue addresses the need for stronger inline or individual component editing capabilities in sequence diagrams created with Mermaid.js, highlighting limitations in styling options such as adding customizable text under arrows, coloring individual arrows, and creating custom boxes around steps. The user shares their experience of quickly creating a sequence diagram but encountering restricted styling flexibility, and suggests improvements that would consolidate diagram editing within Mermaid.js without relying on external tools like draw.io.
- The comments show a willingness from the community to contribute to the development of these features, with encouragement to create sub-issues for each proposed enhancement. Clarifications were provided on how to properly create and link these sub-issues using the platform’s built-in tools, facilitating organized progress on the requested improvements.
- Number of comments this week: 3
-
Tooltip appears at the bottom of the page instead of near the hovered element: This issue describes a problem where tooltips in flowchart and class diagrams are incorrectly displayed at the bottom of the page instead of near the hovered elements. The reporter identifies that the tooltip element lacks necessary CSS positioning because styles are injected inside the SVG and do not apply to the tooltip appended directly to the body, and suggests applying the required styles directly to the tooltip element to fix the positioning.
- The comment expresses appreciation for the detailed analysis and the proposed solution, indicating positive reception to the suggested fix.
- Number of comments this week: 1
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.
- Tooltips for emoji in Diagram Syntax doc tree: This issue addresses the lack of explanatory tooltips for emoji used next to diagram type names in the "Diagram Syntax" section of the documentation, which currently leaves users unclear about the meaning of these icons. The proposal suggests adding tooltips to these emoji to improve user understanding and enhance the clarity of the documentation.
- log scale for
xychart-beta: This issue proposes adding ascalestring field to thexychart-betacomponent that defaults tolinearbut can also acceptlogas an option, enabling the plotting of logarithmic scales. This enhancement would allow users to maintain version control over graph descriptions with true (non-logged) values while visualizing the data on a log scale, with potential for future extension to other scale types. - 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.
- Vite build error with mermaid version 10.9.0: This issue describes a problem encountered when building a Vue 3 and Vite application that uses Mermaid version 10.9.0 to visualize graphs. While the development server runs without errors and displays the graphs correctly, the build process fails on application startup with a TypeError related to setting properties on an undefined object, specifically involving Mermaid's API initialization and rendering. Since there were fewer than 5 open issues, all of the open issues have been listed above.
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: 4
Summarized Issues:
- Character and Syntax Support Limitations: Several issues highlight limitations in Mermaid's current syntax and character support, such as the sankey diagram only supporting ASCII characters and the need for an inline JSON-like annotation syntax for sequence diagrams. These limitations restrict customization and proper rendering, causing conflicts with existing parsing rules and reducing usability.
- issues/6822, issues/6824, issues/6836
- UI Rendering and Layout Problems on Mobile: The mermaid.js.org website experiences layout issues on mobile devices due to the "taglines" banner causing page content to jump because of varying tagline lengths. This results in a poor reading experience and unstable page layout on smaller screens.
- issues/6825
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: 9
Summarized Issues:
- Diagram Styling and Text Customization: Several issues focus on improving the styling and textual elements of diagrams, including arrow colors, font, and color of text, as well as adding the ability to display additional text under arrows instead of notes. These enhancements aim to provide more control over the visual presentation and clarity of diagrams.
- [issues/6828, issues/6829, issues/6830]
- Sequence Diagram Features and Output Accuracy: There are requests and reports related to sequence diagrams, such as adding a feature to box a set of steps and addressing discrepancies between generated PNG images and expected diagram outputs. These issues highlight the need for better feature support and output fidelity in sequence diagrams.
- [issues/6831, issues/6832]
- Class Diagram Namespace Escaping: One issue reports that while individual classes can be escaped in classDiagram syntax, namespaces cannot be properly escaped, causing errors when using namespaced classes. This points to a limitation in handling namespaces within class diagrams.
- [issues/6815]
- Workflow and Conceptual Mapping: Issues include a detailed workflow diagram proposal for a rider app's support ticket system and a conceptual map outlining historical causes and consequences related to the American colonies' independence. These demonstrate the use of Mermaid for complex process and conceptual visualizations.
- [issues/6805, issues/6834]
- Unspecified or Closed Issue: One issue titled "Flow" is noted as closed but lacks further details or comments, providing no additional information on the topic or problem addressed.
- [issues/6840]
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: 5
Key Open Pull Requests
1. Pre Release: This pull request titled "Pre Release" includes multiple fixes and enhancements such as updating the hexagon shape, fixing connection gaps in flowchart shapes, improving edge label positioning in state diagrams, preventing pie chart crashes on zero or negative values, removing beta suffixes from diagrams, adding per-link curve styling in flowcharts, and various test case updates and documentation improvements, all aimed at preparing the project for a stable pre-release version.
- URL: pull/6835
- Merged: No
- Associated Commits: a2dbc, 0451e, 15e7c, 67288, 1176d, ac976, 34e7f, e5ea2, 3fea9, 14983, 500f9, 08928, cc211, 3ab09, 8b86d, c8478, 5cafe, 0823e, a14cd, 827a9, 40428, af3d5, 7ba33, 6b1b0, 47b4c, 54640, 37bfa, af585, 04612, 9cef4, f683b, 9faf2, cd282, 6039a, 00030, cfc25, 020c6, b94f1, 366d2, 94890, 1ceec, e073c, 8bb29, b7a59, 69484, 0cc0b, a476e, 43579, ebb66, 1a14e, 60834, 59861, e4b33, 1a9b9, e464d, ddcd8, aeb51, 4ab98, 29de4, 1dd11, b451c, c99bc, d93d9, f5445, 9258b, 165ff, 4b313, 07470, c4eb5, e6574, 22530, 356da, aa5d4, 3d319, 2fe30, 93227, 83b9a, 9da6f, ea605, 6979a, cfbce, 72c0d, 9dc98, a3d16, 98442, 8224a, 2c093, 53d27, 3920a, 42ac1, 24257, 33e08, 579c2, 6621f, e70be, bfa0e, 814b6, 939da, 4012c, 4254b, b9c33, 7f109, 6686e, 14143, 27185, 71b04, 8c0d1, ce7a4, fc07f, f9da4, 5f0c5, 38e6d, fce7c, 35a92, bb7cd, aea16, b3a12, e9ce8, 98bf9
2. 6088 fix for diamond intersections: This pull request addresses issue #6088 by implementing fixes and a generic solution for calculating intersections of diamond shapes using ELK, including updates to offset calculations and handling edge cases where the last point lies on the intersection.
- URL: pull/6837
- Merged: No
3. 6784: Fix edge ID styling mismatch with linkStyle color: This pull request fixes the edge ID styling mismatch by updating the edge rendering logic to ensure that when a class with a color property is applied to an edge via its ID, the color is also correctly applied to the edge label text, resolving issue #6784.
- URL: pull/6826
- Merged: No
Other Open Pull Requests
- Spell checking improvements: This pull request introduces a chore to run the cspell spell checker on markdown files during the lint-staged process to improve spelling accuracy. It addresses the limitation that eslint does not fully check markdown content and recommends using either eslint or cspell exclusively for such files.
- pull/6821
- Unicode support in Sankey diagrams: This pull request adds support for all Unicode characters, except control and special codes, in the Sankey diagram grammar. This enhancement enables the use of non-ASCII characters within Sankey diagrams.
- pull/6823
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. Extract tidy-tree layout into separate package: This pull request extracts the tidy-tree layout algorithm from the main codebase into a standalone package to improve modularity and maintainability.
- URL: pull/6807
- Merged: 2025-08-04T14:14:55Z
2. Saurabh/fix-node-border-style-for-hand-drawn-shapes: This pull request fixes the issue where the stroke-dasharray style for node borders was being ignored in hand-drawn shapes by adding a function to correctly retrieve and apply stroke dash styles from roughjs, handling both single and double value cases to ensure proper dashed lines are rendered.
- URL: pull/6838
- Merged: 2025-08-08T13:13:22Z
3. refactor: remove unnecessary Element check since DOMPurify 3.2.2: This pull request refactors the code by removing an unnecessary runtime check for the Element type in certain hooks, leveraging the narrowed type definitions introduced in DOMPurify version 3.2.2 to simplify and clean up the implementation.
- URL: pull/6839
- Merged: 2025-08-08T13:20:19Z
- Associated Commits: 7a153
Other Closed Pull Requests
- Class Diagram Language Enhancements: This pull request improves the class diagram language by adding support for
classLiteralNamein namespaces, allowing the use of backticks in namespace labels. It ensures valid syntax without errors and includes new test cases to demonstrate these changes. - pull/6820
- Block Diagram Rendering Fixes: This pull request updates the block diagram rendering logic to correctly interpret the
---syntax as a non-directional line. It prevents arrows from being incorrectly added, fixing the arrow direction issue described in issue #6611. - pull/6833
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.
| Contributor | Commits | Pull Requests | Issues | Comments |
|---|---|---|---|---|
| darshanr0107 | 47 | 4 | 0 | 0 |
| sidharthv96 | 30 | 0 | 0 | 18 |
| shubham-mermaid | 27 | 0 | 11 | 0 |
| omkarht | 28 | 1 | 2 | 0 |
| shubhamparikh2704 | 24 | 1 | 1 | 5 |
| Copilot | 0 | 0 | 0 | 10 |
| Prashant-7718 | 8 | 0 | 0 | 0 |
| knsv | 7 | 1 | 0 | 0 |
| MrCoder | 7 | 0 | 0 | 0 |
| aloisklink | 6 | 1 | 0 | 0 |
Access Last Week's Newsletter: