Weekly GitHub Report for Mermaid: June 16, 2025 - June 23, 2025 (12:04:17)
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.
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, 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 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 causing the title to become very small when additional participants and interactions are added. 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 a Markdown title as a workaround.
- 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 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 appears to be related to the initialization and rendering of Mermaid graphs, as indicated by the provided code snippet and the error message occurring at specific lines in the JavaScript files.
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:
- Class Diagram Display Issues: The Mermaid project has a configuration option
hideEmptyMembersBoxthat should remove empty members or methods boxes from class diagrams. However, the diagrams still display an empty box if either attributes or operations are provided without the other, indicating a need for further refinement in the feature's implementation.
- Rendering and Syntax Errors: In Mermaid version 11.6.0, there are issues with rendering flowcharts and diagrams due to syntax errors. These problems manifest as a "Cannot read properties of undefined" error in VSCode and GitHub, and a failure to display diagrams in older Safari versions, suggesting compatibility and syntax handling issues in the library.
- Text Overflow in Notes: There is a problem in the Mermaid project where text overflows outside of a note, as seen in the
oldshapes.spec.tsfile with thehtmlLabels:falsetest. This issue is documented with a screenshot, highlighting a need for better text handling within notes.
- Workflow and Code Coverage Issues: The Mermaid project faces challenges with its workflow and code coverage tooling. A workflow needs to be created to validate the
pnpm-lock.yamlfile to ensure it does not contain unwanted fields and paths, while the code coverage tool fails to display accurate metrics for pull requests, indicating a need for improved validation and reporting processes.
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:
- Lack of Description and Details in Issues: Many issues are closed due to insufficient information, which hinders the ability to address the problem effectively. Contributors are encouraged to provide more details and steps to reproduce the issue to facilitate a resolution.
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. Added workflow file for validating pnpm-lock file: This pull request introduces a GitHub Action workflow designed to enforce best practices for the pnpm-lock.yaml file by implementing automated checks on every pull request to prevent local or non-registry tarball references, ensure build-only or dev-only paths are not locked, and guard against lockfile changes that are not accompanied by corresponding package.json updates.
- URL: pull/6670
- Merged: No
2. #4743: HTML formatting in timeline diagrams: This pull request addresses the issue of HTML formatting in timeline diagrams by enabling support for HTML tags, which were previously rendered as plain text or caused rendering issues, thereby aligning the functionality with that of Flow Chart and Class diagram labels, and includes necessary tests and documentation updates.
- URL: pull/6663
- Merged: No
3. docs(flowchart): add inheritDir config option and usage example: This pull request updates the documentation for flowcharts in the Mermaid project to include details and a usage example for the new inheritDir configuration option, which modifies the default behavior of subgraphs, and complements the implementation introduced in a previous pull request (#6470).
- URL: pull/6665
- 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: 7
Key Closed Pull Requests
1. Pre-Release: This pull request, titled "Pre-Release," was successfully merged and includes a series of commits primarily focused on adding custom icons, implementing features in the live editor, listing currently used variable names, and addressing various spelling corrections, along with other enhancements and fixes such as theming diagrams, updating dependencies, and improving documentation within the mermaid-js project, as detailed in the commits linked in the pull request.
- URL: pull/6658
- Merged: Yes
- Associated Commits: 0cf0b, 607e9, 78cf1, cd956, 9c46e, 7d131, 34bf5, cb751, de9eb, f5fa0, 5919d, 00e9e, 9133f, a79a5, e2bf9, c7714, fc3d4, 0c2d2, c4c55, 206cc, 2215b, 2bb77, 0507f, d6e15, 4b12e, 4ed47, b9c47, a6c9a, 0103d, 7caf3, 08951, 5f35d, 08085, 78ded, 075f0, 0474a, 20098, 1ca6f, 8564e, 92132, c8257, 82646, ccdd0, bf832, 4bfd0, 6a0fb, cba4d, 16167, c81f6, 3980c, a823b, a578c, 308e2, a3753, e0818, 2aeb4, 87396, cbabc, 56641, 2601e, aa9df, 79f01, 7e3d5, 58ec4, b8088, 8fed1, 1fbe1, 101dc, 34d91, 1de7d, 36e6e, 586b5, 2a12a, 04448, cd2ab, a9f3b, b1e1a, 598c7, dec82, f9fba, af7a5, e46c7, a7d76, 90c09, 02b99, de416, 2a6da, ae564, d8efe, 2bdec, 5267f, a463d, 866b2, ff217, 4d2e4, 6dad2, e0f3f, 33429, 8ce1f, fbdbd, beb80, 054f5, 79b47, 8a341, b3ff8, d72ee, 8c4fc, 24aec, db389, da610, 8c52e, 4a639, bd8b9, f6862, c6e64, 5a8f3, 86a0a, e561a, c81a7, c3c60, e97f2, 549dc, 37539, a037c, 91a75, d2c53, 8800d, a92ae, 9d838, 7a6f1, 68670, 5b222, 1fda7, 26e3b, e8124, 59b40, 53e89, b0b76, 6a6c9, 8d733, f8c6a, 2924b, 5a7e7, 64623, 5ea70, 86748, 40770, 2b289, 05b56, a703a, d0520, 7c42d, 2afa9, e8ee4, 1c1d7, e7b39, 2483e, 566b3, 7b3fd, c1727, 640a6, 221aa, 08b65, cf8fc, c8daf, 47553, b8214, d4e73, 9988a, 8d4c5, 97b79, 90804, ed67c, 65f77, f8c54, 67806, c61b8, 37955, 83543, 444d3, 249f2, 2b41b, 74ef4, 87382, c364f, 5e287, 81984, 56070, 8d9f0, d396c, a5663, 8af63, 1f897, 2a101, 10505, c6d85, ce1bf, d732f, c370e, e2e22, b0731, 31ba6, bbe34, 7e245, 4fd64, 6b886, fa22e, 17a15, 1b044, 107b6, 941bc, d463f, 0d047, 071df, 7b307, 80351, 9d6b9, 28131, e7914, 82874, 96bd7, cac17, b1cf2, e46fd, f20c6, bca6e, cadcd, 942ae, 015af, d0f1d, 6485d, 2ea66, ec078, 6f5d8, e6be1, 80904, d629c, 7075f, 81869, ca80f, 8a703, efa11, da987, e2ef4, 84802, 8049b, d628a, 797ba
2. chore: migrate to es-toolkit/compat from lodash: This pull request involves migrating from lodash-es to es-toolkit/compat to address performance and maintenance concerns by replacing all lodash methods with equivalent methods from es-toolkit, which is actively maintained and optimized for modern JavaScript usage, ensuring no side effects or regressions while resolving issue #6281.
- URL: pull/6661
- Merged: No
3. Add vitepress plugin link: This pull request adds a link to a VitePress plugin in the documentation, includes necessary unit and end-to-end tests, updates the documentation with the appropriate release version, and ensures that changes are reflected in the changelogs, as indicated by the commits and adherence to contribution guidelines.
- URL: pull/6659
- Merged: Yes
Other Closed Pull Requests
- Test Coverage Enhancements: Two pull requests focus on improving test coverage for the project. The first aims to enhance test coverage by implementing necessary unit and end-to-end tests, updating documentation, and ensuring compliance with contribution guidelines, although it was ultimately not merged. The second fixes test coverage by adding configuration to include layout tests, ensuring adherence to contribution guidelines, adding necessary tests and documentation, and considering changeset generation for changelog updates.
- Performance Optimization in Diagram Editor: A pull request addresses a performance issue in the Mermaid diagram editor by optimizing the regex used in the Jison lexer for sequence diagrams. This optimization prevents catastrophic backtracking, which was causing the application to become unresponsive when processing invalidly formatted diagrams.
- Documentation Update: A pull request involves removing references to CodeParrot from the README of the mermaid-js/mermaid project. This change was made because CodeParrot is considered an abandoned product that was previously promoted excessively by its author.
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.
- Kill the bird
- Toxicity Score: 0.55 (Negative tone, potential for defensive responses, critical language.)
- This GitHub conversation involves a user expressing strong dissatisfaction with a product, describing the author's actions in a negative light, which could potentially trigger defensive responses from others. The tone is critical and dismissive, with a focus on the perceived abandonment and misuse of the product.
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 | 30 | 5 | 4 | 3 |
| sidharthv96 | 5 | 0 | 0 | 4 |
| knsv | 2 | 1 | 3 | 2 |
| No author found | 7 | 0 | 0 | 0 |
| shikaan | 2 | 1 | 1 | 0 |
| darshanr0107 | 1 | 3 | 0 | 0 |
| Tahseen23 | 2 | 1 | 0 | 0 |
| IOrlandoni | 1 | 1 | 0 | 0 |
| Caranell | 1 | 1 | 0 | 0 |
| evan-moon-toss | 2 | 0 | 0 | 0 |