Weekly GitHub Report for Mermaid: May 12, 2025 - May 19, 2025 (12:00:31)
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 project, introducing a new feature: the addition of a Radar Chart, 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.
As of our latest update, there are no active issues with ongoing comments this week.
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 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 Mermaid documentation.
- 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 is causing the title to become very small when additional participants and interactions are added. The user has noted that while other graph types in Mermaid have configurable title attributes, such as those in QuadrantChartConfig, this feature is not yet available for sequence diagrams, leading them to use a Markdown title as a workaround.
- 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 project. Users have reported that when these diagrams are rendered as SVGs, either by opening them in a new tab or downloading them, additional height is added to nodes or text is cut off, leading to inconsistent visual outputs.
- 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 the 'prototype' property, 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:
- ZenUML Syntax Error in Mermaid 11.6.0: Users are experiencing syntax errors when attempting to render diagrams using ZenUML syntax in Mermaid version 11.6.0. This suggests that ZenUML may not be recognized as a valid diagram type, prompting suggestions to check diagram registration and parser initialization or to mark the feature as experimental.
- LangGraph Rendering Failure: A user reported an error when trying to display a LangGraph using Mermaid due to an inability to reach the https://mermaid.ink/ API after one retry. Suggested solutions include checking the internet connection, increasing retry settings, or using a local rendering method with Pyppeteer.
- ER Diagram Tool Name Length Restriction: There is a problem in an ER diagram tool where entity names must be at least seven characters long, causing shorter names like "Order" or "Course" to be rejected. Users must add additional characters to meet this requirement.
- GitGraph Line Curving Issue in BT Orientation: In the Mermaid library, a bottom-to-top (BT) oriented gitGraph incorrectly curves lines from right to up instead of from bottom right to top left. This issue occurs particularly when reordering branches or cherry-picking and does not affect top-to-bottom (TB) or left-to-right (LR) orientations.
- Playground Feature Unavailability Offline: The Playground feature in the mermaid live editor is unavailable when used in a completely offline environment. Users are seeking a workaround for this limitation to continue using the feature without an internet connection.
- Flowchart Documentation Preview Errors: Two new documentation preview errors have been identified in the Flowchart syntax of the Mermaid project. These involve an inaccessible image URL in the
Image Shapeexample and a syntax error in theMarkdown Stringsexample, both preventing proper rendering in the 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: 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: 3
Key Open Pull Requests
1. Adding support for the new diagram type nested treemap: This pull request introduces a new diagram type called "nested treemap" to the Mermaid project, which visually represents hierarchical data using nested rectangles, and includes updates such as rendering improvements, documentation, and support for additional features like value formatting and accessibility.
- URL: pull/6590
- Merged: No
- Associated Commits: 40eb0, e0a07, 1bd13, ff48c, 3629e, 4f8f9, 680d6, f0c3d, 2746b, 2def5, df1e7, 3e07a, 66ce6, 44559, f3388, ed7ba, 64c4d, fe33d, db461, f970f, 41108, 63827
2. docs: fix Markdown links on the Questions or Suggestions page: This pull request aims to correct invalid Markdown syntax for links on the "Questions or Suggestions" page of the Mermaid.js documentation, ensuring that the "Add a new Issue" link is properly formatted and functional.
- URL: pull/6595
- Merged: No
3. Chore: Update tooltip: This pull request involves updates to the tooltip feature in the Mermaid project, with design decisions made by the Mermaid Chart growth team, and includes tasks such as reading the contribution guidelines, adding necessary tests and documentation, and generating a changeset if the changes affect package changelogs.
- URL: pull/6594
- Merged: No
- Associated Commits: 1f441
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: 1
Key Closed Pull Requests
1. Fix: Apply proper styling for Mermaid ER diagrams: This pull request addresses a styling issue in Mermaid ER diagrams by ensuring that stroke styles are correctly applied to specific path elements, while selectively filtering out stroke-related styles from the full node styles, and includes necessary documentation, tests, and a changeset for the fix.
- URL: pull/6588
- Merged: 2025-05-13T11:59:51Z
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 | 37 | 1 | 0 | 0 |
| sidharthv96 | 24 | 2 | 0 | 5 |
| knsv | 21 | 1 | 0 | 0 |
| NourBenz | 12 | 1 | 3 | 1 |
| nourhenta | 12 | 0 | 3 | 0 |
| CoyAce | 11 | 1 | 0 | 0 |
| Maia313 | 9 | 0 | 0 | 0 |
| generrosity | 5 | 0 | 3 | 0 |
| arpitjain099 | 4 | 1 | 1 | 1 |
| rajat-ht | 5 | 1 | 0 | 0 |