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
  • 1.2. Other Noteworthy Updates
• II. Issues
  • 2.1. Top 5 Active Issues
  • 2.2. Top 5 Stale Issues
  • 2.3. Open Issues
  • 2.4. Closed Issues
  • 2.5. Issue Discussion Insights

• III. Pull Requests
  • 3.1. Open Pull Requests
  • 3.2. Closed Pull Requests
  • 3.3. Pull Request Discussion Insights

• IV. Contributors
  • 4.1. Contributors

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.

1. [TYPE: ENHANCEMENT] [STATUS: TRIAGE] Extend until keyword to support duration for backward scheduling in Gantt charts: This issue proposes extending the until keyword in Gantt charts to support duration-based backward scheduling, allowing users to specify a task duration along with an end date or milestone reference to automatically calculate the start date. This enhancement aims to simplify defining tasks that work backward from deadlines, such as code sprints or exam preparations, eliminating the need for manual start date calculations when deadlines shift.

   • The comments reveal that the feature was quickly implemented and merged, initially supporting only duration, until <taskId>. Users requested support for duration, until <endDate>, which was then added to keep the syntax consistent. The final implementation supports both task ID and end date references, and users expressed satisfaction with the new functionality.
   • Number of comments this week: 13

2. [TYPE: BUG / ERROR] [STATUS: APPROVED] [GRAPH: ARCHITECTURE] Crash with node name conflict while editing Architecture diagram: This issue describes a crash occurring in the Mermaid architecture-beta diagram feature when a junction is added to a group whose name prefix conflicts with a service name, causing the library to fail, particularly in the Mermaid Live Editor. The reporter suggests adding validation to the addJunction function similar to existing checks in addService to prevent this conflict and ensure only group-type nodes are accepted.

   • The comments confirm the issue and clarify the cause related to missing validation in addJunction. A contributor added the necessary validation checks and unit tests, successfully reproducing and fixing the problem, with the fix submitted in a pull request.
   • Number of comments this week: 4

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.

As of our latest update, there are no stale issues for the project this week.

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: 3

Summarized Issues:

• Philosophy of Science Conceptualization: This issue presents a detailed conceptual diagram that outlines the philosophy of science, including its object of study, nature as a second-order knowledge, main functions, dimensions of metascientific research, and distinctions from other disciplines. It aims to clarify the foundational aspects and scope of philosophy of science through a structured visual representation.
• issues/7401

• Gantt Chart Scheduling Enhancement: This issue proposes extending the until keyword in Gantt charts to support duration-based backward scheduling by allowing syntax that combines a duration with a reference task or end date. This enhancement would enable automatic calculation of task start dates from deadlines, improving scheduling flexibility.
• issues/7407

• Diagram Editor Crash Bug: This issue reports a crash in the Mermaid architecture-beta diagram editor caused by adding a junction to a group whose name prefix conflicts with a service name. The conflict leads to library failure, particularly during live preview sessions such as the Mermaid Live Editor.
• issues/7408

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: 0

Summarized Issues:

As of our latest update, there were no issues closed in the project this week.

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: 9

Key Open Pull Requests

1. feature/2645: add TreeView Diagram : This pull request builds upon a nearly complete TreeView diagram feature introduced earlier by adding comprehensive tests for the Langium parser, fixing parser bugs related to titles and accessibility, including new examples, updating demo pages to modern formats, and resolving merge conflicts to prepare the feature for integration.

• URL: pull/7396

• Associated Commits: 3b398, 99dde, bd824, f7ebf, 18f20, 99406, 85914, 7bae2, 353a2, 34f80, c1ec5, c8c66, 48ea9, 4135f, caf34, 387ba, a2acd, c6139, 4947e, 781da, 613e1, adf46, 4aa70, 251d4, 20939, fa86f, a5255, 0cfe0, b8519, 209d2, ae680, c11c2, ec4cc, 6eb0e, 293b3, b0752

2. Bug/5741 fix duplicate svg element ids: This pull request fixes the issue of duplicate SVG element IDs across multiple Mermaid diagrams on the same page by extending the existing namespacing approach to prefix all internally generated SVG element IDs with each diagram’s unique SVG container ID, thereby preventing ID collisions that caused broken event bindings, missing arrow markers, and corrupted styling, and includes comprehensive tests and updates across all diagram types to ensure consistent ID uniqueness.

• URL: pull/7410

• Associated Commits: 0fe25, 0f281, c2a2b, d2205, 72455, 2773d, c41bf, 10002, f0b57, ee5e9, 9beed, 04e43, f43a6, b8ab2, e5d07, 52559, 69800, 291fe, e0b67, 8f478, 98636, 3142c, 7fb25, 28733, 58b58, 79a19, 36a9e, 9090c, b632b, 1c371, 14a60, 1326f

3. feat(timeline): implement neo look: This pull request implements Neo look support for Timeline Diagrams by extending modern styling and theming capabilities to timeline visualizations, ensuring compatibility with multiple themes and providing comprehensive end-to-end testing for consistent and enhanced visual presentation.

• URL: pull/7406

• Associated Commits: 8b909, 6d13d, 80ad8

Other Open Pull Requests

• Gantt task scheduling enhancement: This pull request introduces a new feature for Gantt tasks that allows users to specify tasks using a "duration, until " syntax. Mermaid automatically calculates the start date by subtracting the duration from the resolved end date or referenced task, simplifying task scheduling without requiring explicit start dates.
• pull/7409

• Treemap theme-aware text color fixes: These pull requests fix the treemap diagram's title, labels, and values by replacing hardcoded black text colors with theme-aware variables like titleColor and textColor. This ensures readability across different themes, including dark backgrounds, while still allowing user-provided style overrides to take precedence.
• pull/7403, pull/7404

• Documentation updates and integrations: These pull requests add Mermaid Studio, a free browser-based Mermaid editor with live preview and export options, to the community integrations list under Productivity tools. Additionally, documentation is updated to include links to the Langium parser information and playground to assist contributors with helpful resources.
• pull/7400, pull/7402

• Validation improvements in addJunction function: This pull request adds validation checks to the addJunction function to prevent crashes caused by invalid parent assignments, such as duplicate IDs, self-references, non-existent parents, or incorrect parent types. It aligns the function's behavior with existing validations in addService and addGroup and includes comprehensive unit and integration tests covering these cases.
• pull/7411

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: 4

Key Closed Pull Requests

1. Merge master back into the develop branch: This pull request merges the master branch back into the develop branch to resolve merge conflicts arising from a previous hotfix release, ensuring that fixes and updates already applied to master are incorporated into develop.

• URL: pull/7398

• Associated Commits: c0b17, de7ed, 4bcb8, e72b2, 939af, bd85b, 019ee, 0b1ee, ccfd4, 1efbd, f8bb5, cd93f, 751bd, 0a715, 53ea0, f6255, 57645, e9cf6, 7156a, bcf6b, a006b, fc3b8, ddc8b, 36c22, 7d4bb, 156dc, 72433, 16bc9, 426a6, 5ff43, 029b7, 2b12b

• Associated Commits: c0b17, de7ed, 4bcb8, e72b2, 939af, bd85b, 019ee, 0b1ee, ccfd4, 1efbd, f8bb5, cd93f, 751bd, 0a715, 53ea0, f6255, 57645, e9cf6, 7156a, bcf6b, a006b, fc3b8, ddc8b, 36c22, 7d4bb, 156dc, 72433, 16bc9, 426a6, 5ff43, 029b7, 2b12b

2. chore: upgrade to Langium v4 and TypeScript v5.8: This pull request upgrades the @mermaid-js/parser package to Langium v4 and TypeScript v5.8, addressing breaking changes such as renaming grammars, updating test type names, converting the EOL fragment into a rule, and replacing import assertions with attributes, while preparing for a major version release (v1.0.0) and ensuring compatibility with the master branch.

• URL: pull/7377

• Associated Commits: 0b7c2, 77da2, af35b, 9fbd1, dab01, 47847

• Associated Commits: 0b7c2, 77da2, af35b, 9fbd1, dab01, 47847

3. chore: Update banner with coupon: This pull request updates the promotional banner logic in the TopBar.vue component for the Mermaid Advanced Editor campaign by simplifying tagline variants, adding support for custom URL parameters like coupon codes, and enhancing the checkout URL to improve tracking and user experience.

• URL: pull/7399

• Associated Commits: a4acd, 547e6

• Associated Commits: a4acd, 547e6

Other Closed Pull Requests

• Automation Template Integration: This pull request introduces a Claude Code automation template configuration to the mermaid-js project, incorporating session hooks, pre-push checks, CI verification, and GitHub workflows. The changes adapt the alexander-turner/claude-automation-template to align with mermaid's existing toolchain and monorepo structure.
• pull/7412

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.

Access Last Week's Newsletter:

• Link