Weekly GitHub Report for Mermaid: September 15, 2025 - September 22, 2025 (12:07:24)
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 that introduced the addition of a Radar Chart, enhancing the charting capabilities of the platform. This update 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.
-
Gantt chart task labels not wrapping or truncated inside task bars: This issue addresses a problem in Gantt charts where task labels that are longer than their corresponding task bars overflow and render outside the bars, causing visual misalignment and readability issues. The user reports that the current implementation neither wraps nor truncates these long labels within the task bars, and this behavior persists in Mermaid version 11.12.0.
- The discussion clarifies that the overflow occurs due to the text width exceeding the task bar width in the rendering code, and possible solutions suggested include truncating the text with an ellipsis or wrapping the text using multi-line formatting to keep labels contained within the bars and maintain the chart’s layout.
- Number of comments this week: 2
-
Several arcs missing in rendered subgraph: This issue reports that several arcs in a Mermaid subgraph are missing when rendered using certain Mermaid renderers, specifically when using the default "Hierarchical" layout on a webpage with Mermaid version 11.11.0. The missing arcs are all self-referential arcs from a node back to itself, and the problem does not occur when using the "Adaptive" layout or in VSCode's Markdown Preview Mermaid Support, though some other rendering issues remain.
- The comment suggests this might be related to a previously reported problem involving duplicate arcs, but confirms that the missing arcs are genuinely absent rather than just overlapping or hidden. The user tested by changing arc labels to longer text, which did not appear, reinforcing that the arcs are truly missing in the render.
- Number of comments this week: 1
-
Syntax error when renaming main branch: This issue reports a syntax error encountered when renaming the main branch in a git graph diagram using the Mermaid online editor. The user found that changing the main branch name from "main" to "test" caused an error related to checking out a branch that was not yet created, while reverting to "main" allowed the graph to render successfully.
- The comment clarifies that if the main branch is renamed to "test," then "main" should no longer be used as a valid branch name for checkout, and provides an example configuration and diagram that works correctly with the renamed branch.
- 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 proposes adding tooltips to the emoji displayed next to the names of various diagram types in the "Diagram Syntax" section of the documentation tree. The goal is to help users better understand the meaning of these icons, as currently there is no reference explaining their significance, which can lead to confusion even for experienced users.
- log scale for
xychart-beta: This issue proposes adding ascalestring field to thexychart-betacomponent that defaults tolinearbut can also acceptlogas an option, enabling logarithmic scaling for charts. This enhancement aims to allow users to version control graph data with true values while displaying the data on a logarithmic scale, with potential for future extension to other scale types. - Unable to Style Sequence Diagram Title: This issue reports the inability to modify the font size of the title in sequence diagrams created with Mermaid, forcing users to resort to using Markdown titles as a workaround. The user notes that while other diagram types in Mermaid, such as QuadrantChartConfig, support title styling attributes, this functionality is currently missing for sequence diagrams, resulting in titles that appear very small and difficult to read.
- 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 between the expected and actual appearance of the diagram.
- 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, 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 methods.
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: 5
Summarized Issues:
- Label and Text Rendering Issues: Task labels that exceed the length of their corresponding bars in Gantt charts overflow instead of wrapping or truncating, causing visual misalignment and readability problems. Additionally, Mermaid flowcharts currently do not support rendering clickable links to other markdown files, limiting interactivity and navigation within diagrams.
- issues/6946, issues/6967
- Participant Configuration Conflicts: Users face a parse error when trying to assign both an alias and a UML-style participant type to the same participant via JSON configuration in sequence diagrams, despite documentation suggesting this should be supported. This indicates a conflict or bug in how Mermaid processes participant configurations.
- issues/6953
- Rendering Bugs with Multiple Arcs: Several self-referential arcs from the same node are missing in Mermaid subgraphs when rendered with certain renderers and layouts, although they appear correctly in others like VSCode's Markdown Preview. This points to a rendering bug related to handling multiple loops on a single node.
- issues/6960
- Branch Renaming Syntax Errors: Renaming the main branch from "main" to another name causes syntax errors in the Mermaid online editor, as the graph rendering fails due to attempts to checkout a branch that does not exist under the new name. This issue prevents successful rendering after branch renaming.
- issues/6966
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:
- Documentation clarity and accuracy: The Architecture Diagram documentation incorrectly implies that the extensive iconify.design icon set is available by default, which has led to user confusion. This issue arose from a recent wording change aimed at avoiding the use of "here" in hyperlinks, but it inadvertently caused misunderstanding about icon availability.
- issues/6957
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: 4
Key Open Pull Requests
1. 6806: Adding support for the new Usecase diagram type: This pull request adds support for a new Usecase diagram type to the Mermaid project, including implementation of the diagram, updated parser tests, improved error handling, example diagrams, and related tooling enhancements.
- URL: pull/6947
- Merged: No
2. Fix htmlLabels resolution for flowchart diagrams: This pull request fixes the resolution of htmlLabels in flowchart diagrams by updating the initialization logic in flowDiagram.ts to ensure that the config.flowchart.htmlLabels setting correctly takes precedence over the global config.htmlLabels, accompanied by added unit and visual tests to verify the changes.
- URL: pull/6963
- Merged: No
3. Warn users when click event callbacks are not allowed due to non-loose security level: This pull request introduces a warning to users when click event callbacks are disabled due to the security level being set to a value other than "Loose," ensuring users are informed about the limitation in such security contexts.
- URL: pull/6964
- Merged: No
Other Open Pull Requests
- Integration Renaming and Documentation Update: This pull request renames the integration from "integrations-create" to "integrations-under the sea" and adds a Mermaid diagram to visually illustrate the changes. The update improves clarity and provides a graphical representation of the integration modifications for better understanding.
- pull/6962
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: 11
Key Closed Pull Requests
1. Pre Release: This pull request titled "Pre Release" for the mermaid-js/mermaid project includes numerous fixes, refactors, dependency updates, and improvements such as resolving edge label color mismatches, fixing rendering issues with subgraphs and Gantt charts, updating layout handling for edges, addressing build and TypeScript errors, and enhancing documentation and testing, all culminating in a merged pre-release preparation.
- URL: pull/6956
- Merged: Yes
- Associated Commits: 4c3de, c7f2f, b7c03, 83145, 93df1, 1d368, 81b0f, 227ce, 11abf, a716a, 9ec98, efd94, 70917, e863a, 2e1d1, 164e4, 681d8, 38f4e, e0bd5, 7109e, f81e6, 0dd46, 38404, d2773, 8b9bb, 65ca3, 040af, 6874a, 62915, 25fa2, 32eda, e7811, b511a, edb0e, 7986b, 027d7, fd185, baf40, 70cbb, 80bce, f759f, b37eb, 16678, cf08b, 764b3, 5e3b5, b36ed, 32106, 8d4ff, 1c2a0, a459c, 525a7, d318f, 8b209, 6d221, 08160, ca5b3, a44e3, 799d2, 181af, dc11b, 994f7, 216be, 11a35, 16569, 78901, 18e9c, ddc1c, f25df, 2a2c4, 9e72b, 59c8b, 61951, 0de0b
2. chore(deps): update @argos-ci/cypress from ^5.0.2 to ^6.1.0: This pull request attempts to update the @argos-ci/cypress dependency from version ^5.0.2 to ^6.1.0 to enable automatic detection of the ARGOS_TOKEN, but it was ultimately not merged and the dependency was downgraded back to the original version.
- URL: pull/6954
- Merged: No
3. Fixed issue State Diagram border rendering as lots of segments: This pull request addresses and fixes the issue where the State Diagram border was rendering as multiple segments by selecting all state node groups and applying styling specifically to the rounded rectangle elements within them.
- URL: pull/6951
- Merged: No
Other Closed Pull Requests
- Mindmap rendering and layout fixes: Multiple pull requests address issues with mindmap rendering in the documentation and apply the tidytree layout to improve visual structure. These fixes resolve rendering problems and enhance the clarity of mindmaps in the Mermaid project.
- pull/6950, pull/6944
- Documentation improvements and updates: Several pull requests improve the documentation by adding new blog posts, correcting phrasing about architecture icon installation, and reverting misleading changes while maintaining better hyperlink practices. These updates ensure clearer and more accurate documentation for users.
- pull/6948, pull/6958
- Codebase cleanup: One pull request removes a duplicate changeset file to keep the project organized and maintain a cleaner codebase. This helps prevent confusion and potential conflicts in future development.
- pull/6959
- Gantt chart rendering fix: A pull request fixes a crash caused by an Invalid array length RangeError during axis and tick calculations in Gantt chart rendering, affecting both Obsidian and browser environments. This resolves stability issues in chart rendering.
- pull/6945
- License metadata correction: One pull request adds the MIT license documentation to the
examplespackage metadata to ensure the published package correctly reflects the license on npmjs.com. This corrects the previous display of the license as "none" despite its inclusion. - pull/6949
- Dependency update: A pull request updates the Argos dependency to version 6.1.0 in the Mermaid project, ensuring the project uses the latest version of this dependency.
- pull/6955
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 | 62 | 5 | 0 | 0 |
| shubhamparikh2704 | 40 | 4 | 1 | 3 |
| sidharthv96 | 15 | 1 | 0 | 0 |
| omkarht | 14 | 1 | 0 | 0 |
| knsv | 13 | 0 | 0 | 0 |
| shanti2530 | 4 | 0 | 0 | 0 |
| sprawler1414 | 3 | 1 | 0 | 0 |
| aloisklink | 3 | 0 | 0 | 0 |
| rajat-ht | 2 | 0 | 1 | 0 |
| Paddu08 | 2 | 1 | 0 | 0 |