Weekly GitHub Report for Mermaid: June 23, 2025 - June 30, 2025 (23:05:57)
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.
-
Configuration is ignored in ES build: This issue describes a problem with the Mermaid library where the configuration is ignored when loading the library via a specific ES module URL, causing any configuration changes to have no effect. The issue is suspected to be a regression, as a similar problem was previously resolved in another issue.
- The comments discuss an alternative method to load the Mermaid library, but it is pointed out that the suggested method is neither a valid ES module nor a UMD module and does not match the defined entry point in the project's package configuration.
- Number of comments this week: 2
-
Accept CSS variables for theme: This issue proposes adding support for using CSS variables in themes within the Mermaid project, which would enhance visual consistency and adaptability of diagrams across different site themes, such as light and dark modes. The proposal suggests that by allowing Mermaid to reference existing CSS variables, diagrams could automatically adjust to theme changes, improving user experience and customization.
- A comment suggests using default values as fallbacks for CSS variables in Mermaid, noting that some derived values might not work as expected and emphasizing the need for testing this solution.
- Number of comments this week: 1
-
Suggestion to include EER diagram shapes into mermaid: This issue proposes the inclusion of Extended Entity Relationship (EER) diagram shapes into the Mermaid tool, suggesting support for elements like double-lined rectangles and diamonds to represent weak entities. The proposal highlights the need for these additional shapes to enhance the existing ER diagram capabilities in Mermaid.
- The comment section discusses the need to finalize the syntax for the proposed EER diagram shapes, considering the existing syntax in Mermaid. It is suggested that these additions will be an extension of the current ER diagram functionality, and further grooming is required to address aspects like attribute handling before implementation can begin.
- 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 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 and comprehension 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 logarithmic 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 using Mermaid, a popular diagramming tool, which forces users to resort to using Markdown titles as a workaround. The user notes that while other graph types in Mermaid, such as QuadrantChartConfig, have attributes for title customization, this feature is 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 addresses formatting problems that occur when rendering SVG diagrams with markdown input in the Mermaid live editor. Specifically, it highlights 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 Mermaid version 10.9.0 in a Vue 3 + Vite 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 has provided a code snippet illustrating their setup and the error context.
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: 8
Summarized Issues:
- Mermaid Diagram Enhancements and Bug Fixes: The Mermaid project is addressing several issues to enhance diagram capabilities and fix bugs. Enhancements include adding Extended Entity Relationship (EER) diagram shapes to support weak entities, while bug fixes involve resolving a TypeError with vertical markers in Gantt charts and correcting space rendering in math formulas.
- Class-Based Approach for Diagram Rendering: Updates to the packet and treemap diagrams involve implementing a new class-based approach to enhance parallel rendering. This approach ensures each diagram maintains its own data, preventing data spillover during parsing.
- Grammar and Rendering Issues in Mermaid: The Mermaid project is tackling issues related to grammar conflicts and rendering problems. Expanding the common grammar in Langium aims to resolve conflicts, while rendering issues in the Nuxt framework prevent diagrams from displaying correctly.
- Tooltip Rendering Consistency in State Diagrams: There is an inconsistency in tooltip rendering for clickable links in State Diagrams within the Mermaid project. The suggestion is to use the
mermaidTooltipclass to align with other diagrams like Flowchart and Class Diagram.
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:
-
Feature Proposal for Nested Component Groups in Mermaid: This issue involves a proposal to implement a feature that allows the creation of a group of components nested within another group in the Mermaid project. The proposal aims to enhance the organizational capabilities of diagrams by allowing more complex structures to be represented clearly.
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. Pre-Release: This pull request introduces a new diagram type, the nested treemap, to the Mermaid project, including updates to the treemap renderer for improved layout and padding, support for valueFormat directives, class support in the grammar, and comprehensive documentation and visual tests.
- URL: pull/6695
- 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, 878e7, 43092, dc3ed, b3724, 1fbe5, c5f89, 0623a, c7b96, e7970, 4ee12, 9b164, 037be, 11a86, c311c, 3dc06, caa04, 8980c, 148a4, d9396
2. 6576: State diagram edge label position : This pull request addresses an issue in the Mermaid project where the edge label in the state diagram was not positioned correctly relative to the edge, and includes commits for fixing the label position, adding a changeset, and refactoring the code.
- URL: pull/6683
- Merged: No
3. Update integrations-community.md: This pull request updates the integrations-community.md file by adding 'WP Documentation' to the integrations section and includes an automated fix applied by autofix.ci, as detailed in the two associated commits.
- URL: pull/6688
- Merged: No
Other Open Pull Requests
- Bug Fixes in mermaid-js Gantt Chart and Block Diagrams: The pull requests focus on resolving issues in the mermaid-js project, specifically addressing a bug in the Gantt chart where the full date was displayed instead of just the day, and fixing unexpected spaces in block diagrams by adjusting position calculations. These fixes ensure the correct date format is applied and improve the accuracy of block diagram rendering by adding error messages and necessary tests.
- Enhancements in Accessibility and Features: The pull requests aim to enhance the mermaid-js project by improving accessibility and adding new features, such as adding links to 20 different language translations in the README for better SEO and introducing a "start pro trial" button in the editor selection. These enhancements improve user access to translated content and offer new functionality, although the new feature lacks necessary tests and documentation.
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: 2
Key Closed Pull Requests
1. Added updated chatgpt plugin url and removed failing url: This pull request updates the URL for the ChatGPT plugin and removes a failing URL from Opera, as part of the maintenance and improvement of the Mermaid project, ensuring that the documentation and resources are current and functional.
- URL: pull/6698
- Merged: Yes
2. Added step to install pnpm: This pull request adds a step to install pnpm in the workflow of the Mermaid project, ensuring that contributors have read the contribution guidelines, although it lacks necessary unit/e2e tests, documentation updates, and changeset generation for changelog updates.
- URL: pull/6689
- Merged: Yes
- Associated Commits:
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 | 48 | 6 | 4 | 6 |
| sidharthv96 | 8 | 0 | 0 | 11 |
| No author found | 12 | 0 | 0 | 0 |
| knsv | 3 | 1 | 6 | 2 |
| quilicicf | 4 | 1 | 0 | 3 |
| DanielLipowicz | 6 | 1 | 0 | 0 |
| darshanr0107 | 1 | 5 | 0 | 0 |
| IOrlandoni | 4 | 1 | 0 | 0 |
| shikaan | 2 | 1 | 1 | 0 |
| Tahseen23 | 2 | 1 | 0 | 0 |
Access Last Week's Newsletter: