Weekly GitHub Report for Mermaid: June 09, 2025 - June 16, 2025 (12:04:47)
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 for Mermaid, introducing a new feature that adds support for Radar Charts, thanks to the contribution from @thomascizeron.
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.
-
mindmaps diagram to use the new way of rendering diagrams: This issue is about enhancing the rendering of mindmap diagrams by integrating layout algorithms, with a proof of concept already in place. The remaining tasks include improving edge intersection calculations, updating edge start positions, conducting visual tests with various algorithms, supporting different shapes, handling node dimensions, and adding unit tests.
- The comments indicate that a proof of concept has been established, and a branch has been pushed for further development and refactoring of the mindmap rendering process.
- 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.
- Tooltips for emoji in Diagram Syntax doc tree: This issue addresses the lack of clarity in the "Diagram Syntax" section of the documentation tree, where emojis are used next to diagram types without any explanation of their meanings. The proposal suggests adding tooltips to these emojis to help users understand the information they are intended to convey, enhancing the usability of the documentation for those who frequently use Mermaid diagrams.
- log scale for
xychart-beta: This issue proposes the addition of a string field namedscaleto thexychart-betafeature, which would default tolinearbut also acceptlogas an option, allowing for future extensions to other scales. The implementation of this feature would enable users to maintain version control of graph descriptions with true values while plotting the logged values, enhancing the flexibility and accuracy of data representation in charts. - Unable to Style Sequence Diagram Title: This issue pertains to the inability to modify the font size of the title in a sequence diagram created using Mermaid, which forces users to resort to using a Markdown title as a workaround. The user notes that while other graph types in Mermaid, such as QuadrantChartConfig, have attributes for title customization, these options are not yet available for sequence diagrams, leading to difficulties when the title becomes too small as more participants and interactions are added.
- SVG rendering formatting issues with markdown input: This issue pertains to formatting problems encountered when rendering SVG diagrams that include markdown formatting within nodes, specifically in the Mermaid live editor. Users have reported that additional height is added to nodes when opening the SVG in a new tab, and text is cut off when downloading the SVG, despite the node height remaining unchanged.
- Vite build error with mermaid version 10.9.0: This issue involves a build error encountered when using Vite with Mermaid version 10.9.0 in a Vue 3 application, where the developer successfully views graphs during development but encounters a "TypeError: Cannot set properties of undefined" upon building the project. The error seems to occur during the application startup, specifically when attempting to set properties on an undefined object, and the developer is seeking support to resolve this issue.
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: 9
Summarized Issues:
- Mermaid Diagram Feature Enhancements: Several issues propose enhancements to Mermaid diagrams, including the addition of new participant types and message styles in sequence diagrams, and the introduction of an "expand" type diagram feature. These enhancements aim to improve the expressiveness and functionality of Mermaid diagrams, making them more versatile and competitive with other diagramming tools.
- Rendering and Layout Issues in Mermaid: There are issues related to rendering and layout in Mermaid diagrams, such as a rendering problem in Safari affecting ER diagrams and a random node ordering issue with the ELK layout algorithm in flowcharts. These issues highlight the need for consistent rendering across different browsers and the importance of maintaining expected node sequences in layouts.
- Gantt Chart and Sequence Diagram Problems: Problems have been identified in the Gantt chart and sequence diagrams, including incorrect date formatting in Gantt charts and line break issues in sequence diagrams on Safari. These problems affect the usability and visual accuracy of the diagrams, necessitating fixes to ensure they function as intended across different environments.
- Mindmap and Architecture Diagram Enhancements: Enhancements are proposed for mindmap and architecture diagrams in Mermaid, focusing on integrating layout algorithms, expanding shape support, and incorporating visually rich symbols. These enhancements aim to improve the visual appeal and functionality of the diagrams, making them more suitable for technical documentation.
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:
- Public link access issues: The "Public link access" feature is not functioning as intended, as users are encountering a login screen instead of gaining unrestricted access. This issue contradicts the expected behavior of generating a proper public URL for easy access.
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: 6
Key Open Pull Requests
1. :rocket: feat: Added support for ipsep-cola layout algorithm: This pull request introduces a comprehensive implementation of the IPSEP-COLA layout algorithm for structured, layered graph drawing in the Mermaid project, enhancing diagram readability and organization by integrating Sugiyama-style hierarchy with COLA optimization, and providing advanced support for edge labels, self-loops, and group-aware positioning.
- URL: pull/6639
- Merged: No
- Associated Commits: 3a895, cfd25, 13f85, 99c82, a7e9f, a46de, 75f94, bb0aa, 70eed, 5e037, 20ddc, 1a5a8, b70ab, 2785c
2. fix: round up label width in ER diagram for Safari: This pull request addresses a rendering issue specific to Safari by rounding up the label width in ER diagrams to ensure consistent display across different browsers, particularly resolving the problem where subpixel rounding differs from Chromium-based browsers, as detailed in issue #6640.
- URL: pull/6641
- Merged: No
3. #6647 Make elk respect the order of nodes based from the code: This pull request addresses the issue of random node ordering when using the elk layout algorithm by setting the elk.layered.crossingMinimization.forceNodeModelOrder to true, ensuring that nodes are ordered based on the code, and includes necessary tests, documentation, and a changeset for the update.
- URL: pull/6648
- Merged: No
Other Open Pull Requests
- Pie Chart Validation Enhancements: This topic covers improvements to prevent pie chart crashes due to zero or negative values. The pull request implements validation checks during the Abstract Syntax Tree (AST) traversal to provide more informative error messages and includes unit tests and documentation updates.
- Sankey Diagram Link Thickness Fix: This pull request addresses an issue with the
showValuesoption in Sankey diagrams, where links were rendered with very thin or nearly invisible stroke widths. The solution involves adjusting the nodePadding logic insankeyRenderer.tsto ensure consistent link thickness, along with related commits and documentation updates.
- xyChart Component Update: The pull request focuses on removing the beta suffix from the xyChart component in the Mermaid project. It ensures compliance with contribution guidelines, adds necessary tests and documentation, and updates changelogs if applicable.
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: 0
As of our latest update, there are no closed pull requests for the project this week.
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 |
|---|---|---|---|---|
| rajat-ht | 7 | 1 | 0 | 11 |
| shubham-mermaid | 12 | 1 | 1 | 0 |
| sidharthv96 | 0 | 0 | 0 | 11 |
| knsv | 2 | 1 | 3 | 2 |
| kimulaco | 2 | 1 | 1 | 0 |
| shikaan | 2 | 1 | 1 | 0 |
| Tahseen23 | 2 | 1 | 0 | 0 |
| No author found | 3 | 0 | 0 | 0 |
| Badboyboom | 0 | 0 | 2 | 1 |
| darshanr0107 | 0 | 2 | 0 | 0 |