Weekly GitHub Report for Mermaid: July 07, 2025 - July 14, 2025 (12:03:18)
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 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.
-
Bidirectional arrows (<<->>) render incorrectly with autonumber in sequence diagrams: This issue addresses a rendering problem in sequence diagrams when using the autonumber feature, where bidirectional arrows (<<->>) do not display correctly, missing the arrowhead at the start and placing the sequence number only at the beginning, which can lead to confusion in documenting two-way protocols or data flows. The expected behavior is for the diagram to show a line with arrowheads at both ends and the sequence number clearly associated with the entire bidirectional message.
- The comments discuss potential solutions to the rendering issue, including moving the sequence number to the right for all arrows or specifically for bidirectional ones. Suggestions include removing the circle around the number, placing the number in the middle of the arrow shaft, or offsetting it to avoid obscuring the arrowhead. Consistency across all arrow types is emphasized, and a demo or mockup is suggested to evaluate the proposed changes.
- Number of comments this week: 4
-
Dependency graph variations: This issue proposes the addition of new graph types to Mermaid.js, specifically a directed acyclic graph (DAG), a temporal dependency graph (TDG), and a combination of these, a temporal or time-structured DAG (TDAG). The proposal includes use cases such as charting the evolution of technologies in a company and creating "tech tree" diagrams similar to those found in video games, with suggestions for syntax and implementation.
- A user expressed gratitude for the suggestion and mentioned that it will be added to their list of considerations.
- Number of comments this week: 1
-
Are https://mermaid-live.nodejs.cn/ and https://mermaid.nodejs.cn“Mermaid 中文网” your official websites? Has anyone infringed on your rights?: This issue raises a concern about two websites, https://mermaid-live.nodejs.cn/ and https://mermaid.nodejs.cn, which are ranking higher than the official Mermaid website in search engine results and displaying mandatory advertisements. The user is questioning whether these sites are officially affiliated with the Mermaid project or if they are infringing on the project's rights.
- A commenter clarifies that these websites are not official but are translated versions of the documentation, which rank higher in China due to the preference for Chinese content. They suggest using the international version to avoid this issue.
- Number of comments this week: 1
-
Dates in excludes are ignored in Gantt diagrams when dateFormat is 'YYYY-MM-DD HH:mm:ss': This issue highlights a problem in Gantt diagrams where specific dates set to be excluded are ignored when the date format is 'YYYY-MM-DD HH:mm:ss'. The user provides a code example demonstrating the issue, where a date meant to be excluded still appears in the diagram.
- A user clarifies the code sample by providing the Gantt diagram code again, indicating that the issue persists with the specified date format and exclusion settings.
- Number of comments this week: 1
-
Multidirectional arrow styles render color incorrectly: This issue involves a problem with the rendering of multidirectional arrow styles in Flowcharts using the Mermaid library, where the "back" arrow does not inherit the correct color when styled with linkStyle. The problem specifically occurs on the mermaidchart.com platform and is observed in the Chrome browser, but not in Firefox.
- A comment notes that the issue is specific to Chrome and Edge browsers, while Firefox renders the arrows correctly. The problem is present in both regular and incognito modes on mermaidchart.com.
- Number of comments this week: 1
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 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.
- 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 visualization. - 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 a problem for users who want to maintain readability when the diagram becomes complex. The user notes 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 resort to using Markdown titles as a workaround.
- SVG rendering formatting issues with markdown input: This issue pertains to formatting problems encountered when rendering SVG diagrams that include markdown-formatted nodes, specifically within the Mermaid live editor. Users have reported that when opening the SVG in a new tab, additional height is added to the node, and when downloading the SVG, the text is cut off, although the height remains 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: 7
Summarized Issues:
- Rendering Issues in Diagrams: The rendering of bidirectional arrows in sequence diagrams and multidirectional arrows in flowcharts is problematic, with issues like missing arrowheads and incorrect color rendering. These issues affect the visual representation and clarity of diagrams, particularly in specific environments and browsers.
- Website Authenticity Concerns: There are concerns about the authenticity of two websites that rank higher in search engines and contain mandatory ads, potentially infringing on the official project's rights. This raises questions about their legitimacy as official sites for "Mermaid 中文网."
- Date Exclusion Bug in Gantt Diagrams: A bug in the Mermaid library prevents the exclusion of specific dates in Gantt diagrams when using the 'excludes' parameter with a certain date format. This issue affects the accuracy of timeline representations in project management.
- Deployment Issues in Magento Environment: Mermaid diagrams that render correctly in a local environment fail to do so in a Magento environment using .phtml files. This inconsistency occurs despite identical configurations and parsed outputs, complicating deployment processes.
- Subgraph Deduplication in ELK Layout: The ELK layout in the Mermaid tool fails to deduplicate subgraphs with identical nodes, leading to multiple instances of the same subgraph. This issue affects the efficiency and clarity of graph representations.
- Proposal for New Chart Design: A proposal suggests adding a chart design to visualize the status of binary and analog variables at the end of each scan cycle. This would aid in sequence logic for PLC programming and documentation, enhancing the tool's utility.
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:
- SVG Rendering Issues in Desktop Applications: Exported SVG diagrams from the Live editor or Playground fail to render correctly in desktop applications like Inkscape or PowerPoint. While these diagrams display properly in web browsers, the rendering issues hinder their use in presentations where zooming or editing is required.
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: 7
Key Open Pull Requests
1. Fix
not working in tooltips anymore: This pull request addresses the issue of <br> tags not functioning correctly in tooltips due to changes in Chrome 136 and Firefox 140, by implementing a fix that resolves the problem as outlined in issue #6631, and includes necessary tests, documentation updates, and changeset generation for changelog updates.
- URL: pull/6722
- Merged: No
2. Updated code to use class based approach for treemap: This pull request refactors the TreeMapDB implementation in the mermaid package by transitioning from a static object-based database to a class-based structure, addressing type incompatibility issues, and ensuring changes are documented in the changelog, although it still requires additional unit/e2e tests and documentation updates.
- URL: pull/6738
- Merged: No
3. 6730: Fix excluded dates ignored in YYYY-MM-DD HH:mm:ss date format in gantt diagram: This pull request addresses an issue in the Mermaid project where excluded dates, such as weekends or specific days, were not being correctly recognized when using the 'YYYY-MM-DD HH:mm:ss' date format in Gantt diagrams, and it includes a fix to ensure these dates are properly excluded, as well as updates to documentation and tests to support this change.
- URL: pull/6734
- Merged: No
Other Open Pull Requests
- Flowchart Enhancements: This topic includes pull requests that focus on improving the visual and functional aspects of flowcharts in the Mermaid project. One pull request introduces per-link curve styling, allowing users to apply different curve types to individual links, enhancing customization. Another pull request addresses visual gaps between connector lines and flowchart shapes, ensuring a seamless appearance in manual mode.
- Class Diagram Styling: This pull request enhances the visual styling of class diagram elements by allowing them to be styled based on UML stereotype annotations. This improvement increases the clarity and expressiveness of the diagrams by supporting annotations like
<<abstract>>,<<interface>>, and<<enumeration>>.
- Flowchart Direction Bug Fix: This pull request resolves a bug in the
flowDb.tsfile related to the interpretation of flowchart direction strings. By trimming the direction string, thesetDirectionmethod now correctly interpretsTDasTBwhen there is an extra space, addressing issue #6681.
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. Pre Release : This pull request, titled "Pre Release," involves multiple commits that primarily focus on enhancing the Mermaid project by adding support for examples in diagram definitions, updating titles and examples for diagrams, applying automated fixes, and making various chore-related updates such as moving examples to a different package, updating lockfiles, and adding visual testing for examples, ultimately culminating in the addition of metadata for diagrams.
- URL: pull/6728
- Merged: Yes
- Associated Commits: c0b14, 865c4, 5b7c1, 0c759, 34e61, 7e7a4, 78291, 9b77a, 695b5, a25ee, 4b896, 28bdb, febae, 5acbd, 43e66, cbb49, da693, 7c77c, b053a, 7733f, 2e5d9, 3e6f6, 94c09, 43ad4, f4339, d7207, f0067, 4936e, cf789, 844f8, d79b7, 8a84e, e6b63, 954f6, 10b7b, a58dd, 254e5, 4d832, 3ca31, 03c12, ed297, 6deb4, d8bd4
2. Pre Release : This pull request involves a pre-release update for the Mermaid project, which includes changes such as failing the build in continuous integration on type errors, updating the parser and validator to use a treemap, and merging related improvements from other pull requests.
- URL: pull/6726
- Merged: Yes
3. Testing auto label: This pull request, titled "Testing auto label," was not merged and includes a single commit labeled "Dummy Commit," which suggests it was likely created to test the automatic labeling functionality in the mermaid-js/mermaid project on GitHub.
- URL: pull/6735
- Merged: No
- Associated Commits: bbff9
Other Closed Pull Requests
- Continuous Integration (CI) Improvements: The pull request focuses on enhancing the CI process for the Mermaid project by ensuring that the build fails if any type errors are encountered. This change is part of a chore aimed at improving code quality and maintainability.
- Treemap Parser Refactoring: This pull request refactors the
Treemapparser by replacing theTreemapDoctype withTreemapthroughout the codebase. The refactoring ensures consistent naming and simplifies the parser's type system, including updates to the AST, validation logic, exports, and test cases.
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 |
|---|---|---|---|---|
| shubham-mermaid | 47 | 6 | 3 | 8 |
| sidharthv96 | 20 | 3 | 0 | 19 |
| darshanr0107 | 8 | 5 | 0 | 3 |
| jrobichaud | 8 | 1 | 0 | 2 |
| No author found | 9 | 0 | 0 | 0 |
| quilicicf | 4 | 1 | 0 | 3 |
| DanielLipowicz | 6 | 1 | 0 | 0 |
| IOrlandoni | 4 | 0 | 0 | 0 |
| knsv | 1 | 0 | 3 | 0 |
| SpecularAura | 3 | 1 | 0 | 0 |