Weekly GitHub Report for Mermaid: March 10, 2025 - March 17, 2025
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/layout-elk@0.1.7
1.2 Version Information:
On November 27, 2024, a patch update was released for the Mermaid library, which included a fix for offset calculations related to the diamond shape when handling intersections, as contributed by @knsv.
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.
-
mermaid.parse always return false in Node.js but truthy value when parsing the same result in browser: This issue describes a problem where the
mermaid.parse
function returnsfalse
when executed in a Node.js environment, but returns a truthy value indicating a valid diagram type when the same code is run in a browser. The user is questioning whether the.parse
function requires a browser environment to function correctly, as the discrepancy in behavior suggests a dependency on browser-specific features.- The comments reveal that the issue is due to a missing dependency on
DOMPurify
in the Node.js environment, which is required by themermaid
library. Another user confirms experiencing the same problem, indicating it might be a common issue. - Number of comments this week: 2
- The comments reveal that the issue is due to a missing dependency on
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.
- vite build failure for 10.9.0: This issue involves a build failure in version 10.9.0 of a project using Vite with vite-react-swc, where the build process succeeds during development (
npm run dev
) but fails during the build and preview stages (npm run build & npm run preview
) due to a TypeError in the browser. The error message indicates an "Uncaught (in promise) TypeError: Cannot set properties of undefined (setting 'prototype')" which suggests a problem with the JavaScript code execution, and it is noted that version 9.4 does not exhibit this issue, although there are slight API differences. - Control brackets around loopText and friends: This issue proposes that the Mermaid project should provide a feature to control the addition of brackets around elements like loopText in sequence diagrams, allowing users to customize their appearance through CSS. The request highlights the need for flexibility in styling, such as hiding brackets to match user-specific design preferences, and includes an example of how this can be achieved with custom CSS.
- Lots of whitespace around C4 graph.: This issue involves excessive whitespace being generated around C4 context diagrams when using the Mermaid tool, which is not observed with other types of diagrams. The problem can be reproduced by exporting a diagram using the command
mmdc -o out.png -t neutral -i example.mmd
, and the user has provided a code sample and a screenshot to illustrate the issue. - Mermaid versions after v9.2.2 cannot be injected into Firefox addons: This issue involves a problem with injecting the
mermaid.min.js
script into Firefox browser extensions, where versions after v9.2.2 fail to inject due to a Content Security Policy (CSP) restriction that blocks a call toFunction()
. The problem does not occur in Chromium-based browsers, and the issue has persisted since the release of Mermaid v9.3.0, with the user unable to identify the specific change causing the failure. - support for Block diagrams to merge row blocks: This issue is a feature request for the Mermaid project, specifically seeking support for merging row blocks within block diagrams to enhance their visual representation. The user provides a code sample and screenshots to illustrate the desired outcome, highlighting the current limitations and expressing the need for this enhancement to improve diagram functionality.
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:
- Mermaid Diagram Customization: Users have requested enhancements to the Mermaid tool to allow for more customization options in diagrams. These requests include the ability to customize participant colors in sequence diagrams and assign custom IDs to edges for individual styling, which are currently limited or not possible.
- Mermaid Diagram Functionality Issues: There are several issues affecting the functionality of Mermaid diagrams, including problems with the
mermaid.parse
function in Node.js environments and text labels being truncated in diagrams. These issues suggest a need for better compatibility and rendering consistency across different environments and diagram elements.
- Entity-Relationship Diagram Enhancement: A feature request has been made to enhance the Entity-Relationship Diagram (ERD) functionality in Mermaid to support relationships involving more than two entities. This enhancement would allow for more complex and accurate representations of data relationships.
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: 2
Summarized Issues:
- Generic Type Display in Class Diagrams: The issue involves a problem where a generic type is correctly displayed in a class diagram unless the class is used as a base for another class. When inheritance occurs, the generic type information disappears from the interface name, indicating a need for consistent display of generic types regardless of inheritance.
- Arrowhead Color Consistency in Flowcharts: This issue addresses the need for the arrowhead color in flowchart diagrams to match the color of the edge. A code snippet demonstrates the current problem where the visual outcome does not meet the expected rendering, highlighting a discrepancy in color consistency.
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: 1
Key Open Pull Requests
1. Feature/818 add remove delay to until after and Fix/5867: This pull request introduces the ability to define task start and end dates relative to other tasks using "after" and "until" keywords, with the added functionality of incorporating delays, while also addressing and resolving a duration issue related to excluded dates, as detailed in issues #818 and #5867.
- URL: pull/6376
- 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: 3
Key Closed Pull Requests
1. Release/11.5.0: This pull request, titled "Release/11.5.0," involves updating the requirement and ER diagrams to use a new renderer, adding animation support for edges, fixing arrowhead color to match styled edges, and adding an outline to community integrations, while also addressing various design decisions, tasks, and changesets to ensure the updates are reflected in the project's changelogs.
- URL: pull/6373
- Merged: 2025-03-13T10:22:21Z
- Associated Commits: 6cc31, 28bab, e70b0, ba70f, 59352, 99360, e3452, fcb1d, c8697, e1aab, 3e323, ef9bb, 7809b, 0f08c, 5d3d1, 04800, 8fba9, 1d9c2, f7fe8, 9a90d, 127ba, 7f476, 7ba41, adec6, d9060, 64237, c432a, 7bbeb, 32a68, 46c16, ee6fb, f9ac9, 84b03, 28d7e, eb76d, ab5b7, f0e47, 54ee6, 54a0d, 304f1, c063b, 6ea13, e2e51, 963ef, e9e66, bde65, 1575a, 1c45d, 92efc, 90bbf, 61f3f, 809f4, fe833, f7648, 08168, 5120e, b07bb, 6a814, b09f2, 202ef, 2b899, 41d7a, 9ab27, 13063, 02f66, 4fbc1, 15ffe, c13d9, cd9ca, 232e6, 08ffb, 74a56, 38ca1, fa48f, 22bc2, cc237, 42dfa, 23bc2, c00f3, edc1a, ba534, 22091, 9681a, 74edf, 3162c, d27d4, ab6d9, feee5, 0e25f, 4202e, f8bf0, 7ed33, 3536c, 5f58d, dc513, 57470, 9a50b, 09e0d, f4e1f, 99385, 9b75a, b5587, b2fde, de3e3, 4e950, 8f3e1, b4043, e2de5, fdb8a, 5e9c8, 47d4d, 97788, 9609a, c296f, 52328, a3f35, b53cf, 8dd0e, f0050, d0768, baf3a, d155e, a0e54, 56d66, 9cad3, 4dbaa, 4a197, a79c0, d07f8, d83b1, f4548, ffa78, b2dfb, 6ca8f, 58175, ee05d, 7a4a5, af6e2, f408e, 81451, 34840, a19b4, ada42, c5843, 7a7e4, bc1f7, 39768, a758b, d8ebf, 54825, 62ede, ebfcf, b5c78, 9c6e5, 300fb, c688c, c53e0, f7c91, 6eb56, 52532, 97486, d1d5b, 1dca4, 46b8a, 34a12, 98fe7, ad2f1, 78c1d, dbf88, f43e3, 0518e, 2c22e, c01ae, 2fdd2, eb8e4, 1c8b9, a64b1, bc691, c6b71, c22b5, 726b4, 225e5, 162e9, c9b8f, de40d, 97b12, 9d06d, 374eb, ff001, 3be59, 60db0, 2ace9, 446f6, 33f9d, 00a8d, bc2bd, bb895, f6335, 4d25c, 1d6a5
2. Merge back v11.5.0 back to develop: This pull request involves merging the changes from the release branch v11.5.0 back into the develop branch, incorporating various updates such as the addition of new shapes and markers for entity-relationship diagrams, fixes for diagram rendering issues, updates to documentation and tests, and ensuring compatibility with different layout configurations.
- URL: pull/6375
- Merged: 2025-03-13T10:37:53Z
- Associated Commits: 10562, f2f1a, 983c2, d2892, d0dd4, cba47, 6247b, df110, 29c32, 0d664, 1d4ea, b5da9, 8b169, 49e23, 69e12, 5be5a, 723b8, 5d2b0, df22f, 1d68c, c7891, b67cd, 2771b, 39a6c, 8ace4, b49af, 87fa6, 1b340, 01e53, 5ae5a, 98547, 5a2a8, 295af, 40686, aeec4, 1a9a9, 58fa9, 8a8d1, 50979, 12739, b2210, 1341e, 38486, 292cd, 05bdf, f3995, 0c2e1, 41a73
3. 6369 mirror edge color on arrowhead: This pull request addresses the issue of ensuring that arrowhead colors match the edge colors in diagrams by implementing enhanced marker handling, dynamic marker creation, and improved reusability, while also ensuring consistent styling across all browsers by directly applying stroke and fill attributes to SVG elements, thereby resolving issue #6369.
- URL: pull/6371
- Merged: 2025-03-12T10:36:55Z
- 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 |
---|---|---|---|---|
sidharthv96 | 72 | 1 | 0 | 6 |
saurabhg772244 | 19 | 0 | 0 | 12 |
yari-dewalt | 17 | 0 | 0 | 0 |
aloisklink | 1 | 0 | 0 | 16 |
Shahir-47 | 17 | 0 | 0 | 0 |
udvale | 16 | 0 | 0 | 0 |
No author found | 13 | 0 | 0 | 0 |
pranavm2109 | 12 | 0 | 0 | 0 |
ashishjain0512 | 9 | 2 | 0 | 0 |
jeswr | 8 | 2 | 0 | 0 |