Weekly GitHub Report for Mermaid: May 19, 2025 - May 26, 2025 (12:00:38)
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 the Mermaid library, 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.
-
sarthgaerg: This issue appears to be a placeholder or test submission, as the title and description contain nonsensical text and lack specific details about a problem. The issue does not provide any screenshots, code samples, or suggested solutions, and it includes a link to a GitHub page for creating new issues.
- The comment section contains a single comment that includes a link to another GitHub page for creating new issues, suggesting that the interaction may be related to testing or redirecting to a different issue submission process.
- 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 clarity in the "Diagram Syntax" section of the documentation, where emojis are used next to diagram type names 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 unfamiliar with the icons.
- 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, a popular diagramming tool. The user has noted that while other graph types in Mermaid have configurable title attributes, such as those in QuadrantChartConfig, this feature is not 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 involves formatting problems with SVG rendering when markdown is used within nodes in a diagram, 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: 6
Summarized Issues:
- Support for Chinese Characters in Mermaid Diagrams: The request for adding support for Chinese characters in the titles of architecture diagrams in Mermaid is crucial, as the current lack of support results in syntax errors. This limitation hinders users who need to create diagrams with non-Latin scripts, affecting the tool's accessibility and usability for a global audience.
- Swimlanes Flowcharts in Mermaid.js: The proposal to add Swimlanes Flowcharts to Mermaid.js addresses the need for better business process modeling and systems design. Currently, the absence of native support for Swimlanes requires complex workarounds, limiting the tool's effectiveness in documenting cross-functional workflows.
- Arrow Rendering Issues in Diagrams: There are issues with arrow rendering in Mermaid diagrams, such as arrows appearing too short in timelines with numerous stacked fields and incorrect arrow directions in block diagrams. These rendering problems can lead to misinterpretations of the diagrams, affecting their clarity and accuracy.
- Incomplete or Placeholder Issues: Some issues on the Mermaid GitHub project appear to be placeholders or incomplete reports, lacking clear descriptions, steps to reproduce, and suggested solutions. These entries, which include minimal text or nonsensical descriptions, do not provide enough information for developers to address potential problems effectively.
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: 2
Summarized Issues:
- Security vulnerability in Mermaid project: The Mermaid project has a security vulnerability where backslashes in URLs are not properly escaped before other special characters, leading to malformed escape sequences. This issue poses potential security risks during downstream parsing or rendering.
- Unavailability of Playground feature offline: The Playground feature in the mermaid live editor is unavailable when used in a completely offline environment. Users are seeking possible workarounds to overcome this limitation.
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: 1
Key Open Pull Requests
1. Feat: Add editor popup modal: This pull request introduces a new editor popup modal feature to the Mermaid project, with several commits focusing on adding the modal, refining the UI design, and incorporating feedback, although it still requires additional unit/e2e tests and documentation updates before merging.
- URL: pull/6609
- Merged: No
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. fix: escape backslashes before parentheses in URL replacement logic: This pull request addresses a bug in the URL manipulation logic of the mermaid-js project by ensuring that backslashes are properly escaped before parentheses, thereby preventing malformed escape sequences and resolving issue #6565, as demonstrated by successful CodeQL analysis on a forked repository.
- URL: pull/6566
- Merged: 2025-05-20T06:53:41Z
2. Upgrade @zenuml/core to v3.31.1.: This pull request upgrades the @zenuml/core library to version 3.31.1, addressing issue #588 on the mermaid-cli repository and incorporating various improvements from the ZenUML core library, while also updating dependencies and a demo diagram, ensuring compliance with contribution guidelines, adding necessary tests and documentation, and generating a changeset for changelog updates.
- URL: pull/6581
- Merged: 2025-05-19T14:46:38Z
3. docs: fix Markdown links on the Questions or Suggestions page: This pull request addresses the issue of invalid Markdown syntax for a link on the "Questions or Suggestions" page of the Mermaid.js documentation by correcting the link format to ensure proper functionality and readability.
- URL: pull/6595
- Merged: 2025-05-22T07:04:14Z
Other Closed Pull Requests
- Tooltip Feature Updates in Mermaid Project: This pull request involves updates to the tooltip feature in the Mermaid project. The design decisions were made by the Mermaid Chart growth team, and the tasks included reading the contribution guidelines. However, it lacks necessary unit/e2e tests, documentation updates, and changeset generation for changelog entries.
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 |
|---|---|---|---|---|
| thomascizeron | 26 | 1 | 0 | 0 |
| rajat-ht | 12 | 2 | 0 | 11 |
| knsv | 21 | 1 | 0 | 0 |
| sidharthv96 | 3 | 0 | 0 | 16 |
| NourBenz | 10 | 1 | 3 | 0 |
| nourhenta | 12 | 0 | 2 | 0 |
| CoyAce | 11 | 1 | 0 | 0 |
| arpitjain099 | 4 | 1 | 1 | 1 |
| No author found | 5 | 0 | 0 | 0 |
| MrCoder | 3 | 1 | 0 | 0 |