Repository navigation
Releases
@mermaid-js/[email protected]
Minor Changes
- #8779
eb56a54Thanks @sidharthv96! - feat: add swimlane diagram examples, so editors such as the Live Editor list the diagram
[email protected]
Minor Changes
-
#8164
592d0e4Thanks @filipsajdak! - feat: add the open-arrow and hollow-circle edge markers, so a notation can tell two kinds of flow apart by whether the head is filled -
#8165
5c8aa5dThanks @filipsajdak! - feat: add the BPMN element shapes - events, gateways, activities, data objects, data stores and text annotations - each reporting where a line meets what is drawn -
#8470
692d22aThanks @openmindednewby! - feat: flowchart edges accept astepnumber (e1@{ step: 1 }); a dot travels the edges in step order and loops, hidden underprefers-reduced-motion -
#8478
56aa105Thanks @openmindednewby! - feat: addflowchart.stepDurationto set how many seconds each step of the flowchart step animation lasts -
#8479
800f7efThanks @openmindednewby! - feat: highlight the flowchart edge whose step is playing, in sync with the step animation dot -
#8480
50d6294Thanks @openmindednewby! - feat: addflowchart.stepNumbersto show each step edge's number in a badge
Patch Changes
-
#8443
2ff8286Thanks @knsv-bot! - fix: agentflow renders thea[/…/]short form as an input instead of falling back to a task with a SHAPE_UNSUPPORTED warning -
#8661
b200b27Thanks @pbrolin47! - fix: Bump DOMPurify to 3.4.17 to address GHSA-55q2-fjhq-7xh7 and GHSA-6688-9rhm-gjv2 -
#8633
686f350Thanks @sidharthv96! - chore: Remove theuuiddependency and the unused legacy ER diagram renderer -
#8661
7eec083Thanks @pbrolin47! - fix: Stop an edge from a node inside a subgraph from crossing an edge from the subgraph itself to the same node with ELK 0.10+ (e.g.outer --> awithda --> a, orthree --> twowithtwo --> c2) -
#8532
42d3760Thanks @Devehab! - fix: upgrade bundled elkjs from 0.9.3 to 0.12.0, which is licensedEPL-2.0 OR GPL-3.0-or-later, so GPL-3.0 projects can ship mermaid with ELK -
#8162
d5ca27aThanks @filipsajdak! - fix(swimlanes): size a lane that holds a nested subgraph (TB drew it as an empty 0x0 box, and likewise an outer group holding lanes), and grow LR and RL lanes by the nested group's padding -
#8405
b4299f2Thanks @filipsajdak! - fix: do not draw a stray empty swimlane when a node is listed in two lanes, and warn about it and about a subgraph nested in a lane -
#8385
37d0aceThanks @filipsajdak! - fix(swimlanes): keep two arrowheads that land on one face of a node apart when a sibling edge is straightened -
#8385
38e810aThanks @filipsajdak! - fix(swimlanes): an edge routed round the outside of a diamond now arrives at one of its vertices instead of ending in empty space beside it -
#8385
25d7e31Thanks @filipsajdak! - fix(swimlanes): a second edge leaving a diamond on the same level as its target now leaves from a free vertex instead of running beside the first -
#8171
a4750b4Thanks @filipsajdak! - fix: dock a swimlane edge on the shape it points at, so a line reaches an event's ring instead of stopping at the room its caption reserves -
#8385
67315b9Thanks @filipsajdak! - fix: an edge label no longer pushes the nodes it joins a rank apart -
#8385
21a1f5cThanks @filipsajdak! - fix(swimlanes): stop the crossing cleanup from joining two routes at a corner so they read as one line -
#8385
e14bc3aThanks @filipsajdak! - fix(swimlanes): an edge no longer arrives at the vertex of a hexagon that another edge leaves from -
#8459
edd162fThanks @Yun-seoung! - fix: Allow flowchart edge IDs regardless of whitespace after the node shapeEdge IDs may no longer contain
[ ] ( ) { } |. -
#8402
4f2badeThanks @pcp-cmd! - fix: Render use case include and extend relationship labels with UML guillemets.
@mermaid-js/[email protected]
Minor Changes
-
#8164
592d0e4Thanks @filipsajdak! - feat: add the open-arrow and hollow-circle edge markers, so a notation can tell two kinds of flow apart by whether the head is filled -
#8165
5c8aa5dThanks @filipsajdak! - feat: add the BPMN element shapes - events, gateways, activities, data objects, data stores and text annotations - each reporting where a line meets what is drawn -
#8470
692d22aThanks @openmindednewby! - feat: flowchart edges accept astepnumber (e1@{ step: 1 }); a dot travels the edges in step order and loops, hidden underprefers-reduced-motion -
#8478
56aa105Thanks @openmindednewby! - feat: addflowchart.stepDurationto set how many seconds each step of the flowchart step animation lasts -
#8479
800f7efThanks @openmindednewby! - feat: highlight the flowchart edge whose step is playing, in sync with the step animation dot -
#8480
50d6294Thanks @openmindednewby! - feat: addflowchart.stepNumbersto show each step edge's number in a badge
Patch Changes
-
#8443
2ff8286Thanks @knsv-bot! - fix: agentflow renders thea[/…/]short form as an input instead of falling back to a task with a SHAPE_UNSUPPORTED warning -
#8661
b200b27Thanks @pbrolin47! - fix: Bump DOMPurify to 3.4.17 to address GHSA-55q2-fjhq-7xh7 and GHSA-6688-9rhm-gjv2 -
#8633
686f350Thanks @sidharthv96! - chore: Remove theuuiddependency and the unused legacy ER diagram renderer -
#8661
7eec083Thanks @pbrolin47! - fix: Stop an edge from a node inside a subgraph from crossing an edge from the subgraph itself to the same node with ELK 0.10+ (e.g.outer --> awithda --> a, orthree --> twowithtwo --> c2) -
#8532
42d3760Thanks @Devehab! - fix: upgrade bundled elkjs from 0.9.3 to 0.12.0, which is licensedEPL-2.0 OR GPL-3.0-or-later, so GPL-3.0 projects can ship mermaid with ELK -
#8162
d5ca27aThanks @filipsajdak! - fix(swimlanes): size a lane that holds a nested subgraph (TB drew it as an empty 0x0 box, and likewise an outer group holding lanes), and grow LR and RL lanes by the nested group's padding -
#8405
b4299f2Thanks @filipsajdak! - fix: do not draw a stray empty swimlane when a node is listed in two lanes, and warn about it and about a subgraph nested in a lane -
#8385
37d0aceThanks @filipsajdak! - fix(swimlanes): keep two arrowheads that land on one face of a node apart when a sibling edge is straightened -
#8385
38e810aThanks @filipsajdak! - fix(swimlanes): an edge routed round the outside of a diamond now arrives at one of its vertices instead of ending in empty space beside it -
#8385
25d7e31Thanks @filipsajdak! - fix(swimlanes): a second edge leaving a diamond on the same level as its target now leaves from a free vertex instead of running beside the first -
#8171
a4750b4Thanks @filipsajdak! - fix: dock a swimlane edge on the shape it points at, so a line reaches an event's ring instead of stopping at the room its caption reserves -
#8385
67315b9Thanks @filipsajdak! - fix: an edge label no longer pushes the nodes it joins a rank apart -
#8385
21a1f5cThanks @filipsajdak! - fix(swimlanes): stop the crossing cleanup from joining two routes at a corner so they read as one line -
#8385
e14bc3aThanks @filipsajdak! - fix(swimlanes): an edge no longer arrives at the vertex of a hexagon that another edge leaves from -
#8459
edd162fThanks @Yun-seoung! - fix: Allow flowchart edge IDs regardless of whitespace after the node shapeEdge IDs may no longer contain
[ ] ( ) { } |. -
#8402
4f2badeThanks @pcp-cmd! - fix: Render use case include and extend relationship labels with UML guillemets.
@mermaid-js/[email protected]
Patch Changes
-
#8661
b200b27Thanks @pbrolin47! - fix: Bump DOMPurify to 3.4.17 to address GHSA-55q2-fjhq-7xh7 and GHSA-6688-9rhm-gjv2 -
#8532
42d3760Thanks @Devehab! - fix: upgrade bundled elkjs from 0.9.3 to 0.12.0, which is licensedEPL-2.0 OR GPL-3.0-or-later, so GPL-3.0 projects can ship mermaid with ELK -
Updated dependencies [
2ff8286,592d0e4,5c8aa5d,b200b27,686f350,7eec083,42d3760,692d22a,56aa105,800f7ef,50d6294,d5ca27a,b4299f2,37d0ace,38e810a,25d7e31,a4750b4,67315b9,21a1f5c,e14bc3a,edd162f,4f2bade]:
[email protected]
Minor Changes
- #8394
6ac38cbThanks @jackroberts236! - feat: Add opt-in mindmap coloring by hierarchy depth usingmindmap.colorBy: depthand the existing theme palette.
Patch Changes
-
#8409
419ee68Thanks @ashishjain0512! - fix: size circle and double-circle nodes from their label instead ofminNodeWidth, and trim neo circle padding -
#8395
2fb3ff1Thanks @ashishjain0512! - fix: ELK no longer straightens an edge terminal when that would put a label over another edge, or an edge through a label -
#8394
cbf89abThanks @jackroberts236! - fix: Keep mindmap HTML labels readable in the neo look on themes that repaint node backgrounds -
#8390
430ac9bThanks @ashishjain0512! - fix: Centre mindmap node labels whenhtmlLabelsis false -
#8161
d7532edThanks @filipsajdak! - fix: scope a swimlane cluster's DOM id like every other cluster, so two diagrams on one page do not collide -
#8270
ad8d61aThanks @filipsajdak! - fix(rendering): clip an edge for the layout engine that drew it, so a diagram pinning its own engine (bpmn, swimlanes) still renders when the configured default is another one -
#8383
9d41c0fThanks @filipsajdak! - fix(swimlanes): split shared terminal lanes again after crossing cleanup, so an edge that detours around another lane no longer ends on the same attachment point as a neighbouring edge -
#8384
6c67397Thanks @filipsajdak! - fix(swimlanes): move a lane's title band clear of an edge that crosses it, in LR diagrams whose lanes carry no direction of their own and when the edge runs along the band's border -
#8366
40124c3Thanks @SwastikTripathi! - fix: swimlane nodes with no edges keep their source order inside a lane instead of being sorted by ID
@mermaid-js/[email protected]
Minor Changes
- #8394
6ac38cbThanks @jackroberts236! - feat: Add opt-in mindmap coloring by hierarchy depth usingmindmap.colorBy: depthand the existing theme palette.
Patch Changes
-
#8409
419ee68Thanks @ashishjain0512! - fix: size circle and double-circle nodes from their label instead ofminNodeWidth, and trim neo circle padding -
#8395
2fb3ff1Thanks @ashishjain0512! - fix: ELK no longer straightens an edge terminal when that would put a label over another edge, or an edge through a label -
#8394
cbf89abThanks @jackroberts236! - fix: Keep mindmap HTML labels readable in the neo look on themes that repaint node backgrounds -
#8390
430ac9bThanks @ashishjain0512! - fix: Centre mindmap node labels whenhtmlLabelsis false -
#8161
d7532edThanks @filipsajdak! - fix: scope a swimlane cluster's DOM id like every other cluster, so two diagrams on one page do not collide -
#8270
ad8d61aThanks @filipsajdak! - fix(rendering): clip an edge for the layout engine that drew it, so a diagram pinning its own engine (bpmn, swimlanes) still renders when the configured default is another one -
#8383
9d41c0fThanks @filipsajdak! - fix(swimlanes): split shared terminal lanes again after crossing cleanup, so an edge that detours around another lane no longer ends on the same attachment point as a neighbouring edge -
#8384
6c67397Thanks @filipsajdak! - fix(swimlanes): move a lane's title band clear of an edge that crosses it, in LR diagrams whose lanes carry no direction of their own and when the edge runs along the band's border -
#8366
40124c3Thanks @SwastikTripathi! - fix: swimlane nodes with no edges keep their source order inside a lane instead of being sorted by ID
[email protected]
Minor Changes
-
#8303
9140716Thanks @filipsajdak! - feat: add theelk.orientFeedbackEdgesoption, enabled by default. With the ELK layout, an edge from a node that a subgraph feeds back into that subgraph is now routed downstream instead of around the subgraph. This changes the layout of existing ELK diagrams that contain such edges; setelk.orientFeedbackEdges: falseto keep the previous routing. -
#8250
fd4f5f2Thanks @kartben! - feat: add abitOrderoption to packet diagrams. It defaults toascending, which is the current
behaviour, anddescendingmirrors every row so it reads from that row's highest bit down to its
lowest. Fields are still declared lowest bit first and keep their width, so switching a diagram
between the two conventions only means changingbitOrder.
Patch Changes
-
#8330
50c9e55Thanks @ashishjain0512! - fix: upgrade chevrotain to 13 so mermaid no longer pulls in vulnerable[email protected] -
#8259
4c90f5cThanks @afonsojanu! - fix(sequence): allow whitespace between an actor name and its@{ ... }config objectparticipant Bob@{ "type" : "database" }parsed fine, but adding a single space before the
config object (participant Bob @{ "type" : "database" }) failed with a confusing parse error,
even though the plain form without a config object tolerates trailing whitespace just fine. -
#8339
c7fa1a5Thanks @ashishjain0512! - fix: keep ELK class-diagram cardinalities off namespace frames -
#8334
d67331dThanks @ashishjain0512! - fix(class): place cardinality labels beside their relation ends on dagre's sides with ELK, centre dagre's end labels, and stop clipping their text -
#8344
99a050bThanks @pbrolin47! - fix: with the ELK layout, an edge label could sit up to 16px beside its edge instead of centred on it, when the edge's terminal jog was straightened after the label's position was computed. The label is now re-projected onto the straightened route -
#8276
3101c7dThanks @mir-ashiq! - fix(error): show the actual error message in the error diagramWhen a diagram fails to parse, the error diagram now draws the real error message below the
"Syntax error in text" headline, wrapped to at most four lines. Hosts that only show the SVG
(GitHub, GitLab, Obsidian, exported images) no longer hide what actually went wrong, e.g. that the
flowchart edge limit was exceeded andmaxEdgesneeds raising viamermaid.initialize. -
#8296
aa29345Thanks @pentaoa! - fix: preserve explicit source relations on event modeling reset frames -
#8297
967bbdeThanks @pentaoa! - fix: reject duplicate event modeling frame IDs before rendering -
#8337
147f343Thanks @knsv-bot! - fix: a flowchart that declares the same subgraph id more than once now renders as one merged subgraph with the ELK layout instead of producing NaN geometry. Classes andview: collapsedset on a repeated subgraph now apply to it, whichever declaration they follow. -
#8203
40ef7b4Thanks @MFA-G! - perf(frontmatter): replace the quadratic front matter regex on hot pathsfrontMatterRegexbacktracks polynomially on whitespace-heavy input, so a
diagram well inside the defaultmaxTextSizecould stall parsing for over a
second.detectTypeandextractFrontMatternow use a linear scanner that
matches the regex result exactly, leaving no document stripped differently. -
#8254
351d7d2Thanks @galshir! - fix: warn when a gantt task references an unknownafter/untiltask id, or when its end value is neither a valid date nor a valid duration -
#8249
b657a2cThanks @mir-ashiq! - fix(sequence): allow hyphenated actor and participant names when a config object is attached -
#8300
c38a565Thanks @filipsajdak! - fix: A partial override of an object-valued theme variable such asxyChart,radarorcynefinkeeps the values the theme generates for the keys it leaves out -
#8333
8afd83cThanks @ashishjain0512! - fix: upgrade the parser to langium 4.4 / chevrotain 13 so bundles no longer include[email protected] -
#8285
859f1f8Thanks @mir-ashiq! - fix(sequence): allow actor-menu keywords as participant ids in messagesA participant declared as
Link(orLinks,Properties,Details) could not be used as a
message endpoint: the lexer matched the name as thelinkstatement keyword and the parse failed.
Thelink,links,propertiesanddetailskeywords are now only recognized when an actor
follows them on the same line, so participant ids that happen to spell these words work in
messages, while the statements themselves keep parsing as before. -
#8282
b6d952dThanks @belomaxorka! - fix(sequence): allowLinkas a participant ID in messages and actor menusPreserve the ID's case and alias while keeping the
linkandlinksmenu commands supported. -
#8345
7917c1aThanks @knsv-bot! - fix: xychart measures text in SVG units so legends no longer clip on wide charts scaled to fit their container, and the chart title is dropped instead of overflowing when the chart is too short for it -
#8338
4a722fbThanks @ashishjain0512! - fix: Centre the xychart title over the plot area instead of the whole chart -
Updated dependencies [
8afd83c]:- @mermaid-js/[email protected]
@mermaid-js/[email protected]
Minor Changes
-
#8303
9140716Thanks @filipsajdak! - feat: add theelk.orientFeedbackEdgesoption, enabled by default. With the ELK layout, an edge from a node that a subgraph feeds back into that subgraph is now routed downstream instead of around the subgraph. This changes the layout of existing ELK diagrams that contain such edges; setelk.orientFeedbackEdges: falseto keep the previous routing. -
#8250
fd4f5f2Thanks @kartben! - feat: add abitOrderoption to packet diagrams. It defaults toascending, which is the current
behaviour, anddescendingmirrors every row so it reads from that row's highest bit down to its
lowest. Fields are still declared lowest bit first and keep their width, so switching a diagram
between the two conventions only means changingbitOrder.
Patch Changes
-
#8330
50c9e55Thanks @ashishjain0512! - fix: upgrade chevrotain to 13 so mermaid no longer pulls in vulnerable[email protected] -
#8259
4c90f5cThanks @afonsojanu! - fix(sequence): allow whitespace between an actor name and its@{ ... }config objectparticipant Bob@{ "type" : "database" }parsed fine, but adding a single space before the
config object (participant Bob @{ "type" : "database" }) failed with a confusing parse error,
even though the plain form without a config object tolerates trailing whitespace just fine. -
#8339
c7fa1a5Thanks @ashishjain0512! - fix: keep ELK class-diagram cardinalities off namespace frames -
#8334
d67331dThanks @ashishjain0512! - fix(class): place cardinality labels beside their relation ends on dagre's sides with ELK, centre dagre's end labels, and stop clipping their text -
#8344
99a050bThanks @pbrolin47! - fix: with the ELK layout, an edge label could sit up to 16px beside its edge instead of centred on it, when the edge's terminal jog was straightened after the label's position was computed. The label is now re-projected onto the straightened route -
#8276
3101c7dThanks @mir-ashiq! - fix(error): show the actual error message in the error diagramWhen a diagram fails to parse, the error diagram now draws the real error message below the
"Syntax error in text" headline, wrapped to at most four lines. Hosts that only show the SVG
(GitHub, GitLab, Obsidian, exported images) no longer hide what actually went wrong, e.g. that the
flowchart edge limit was exceeded andmaxEdgesneeds raising viamermaid.initialize. -
#8296
aa29345Thanks @pentaoa! - fix: preserve explicit source relations on event modeling reset frames -
#8297
967bbdeThanks @pentaoa! - fix: reject duplicate event modeling frame IDs before rendering -
#8337
147f343Thanks @knsv-bot! - fix: a flowchart that declares the same subgraph id more than once now renders as one merged subgraph with the ELK layout instead of producing NaN geometry. Classes andview: collapsedset on a repeated subgraph now apply to it, whichever declaration they follow. -
#8203
40ef7b4Thanks @MFA-G! - perf(frontmatter): replace the quadratic front matter regex on hot pathsfrontMatterRegexbacktracks polynomially on whitespace-heavy input, so a
diagram well inside the defaultmaxTextSizecould stall parsing for over a
second.detectTypeandextractFrontMatternow use a linear scanner that
matches the regex result exactly, leaving no document stripped differently. -
#8254
351d7d2Thanks @galshir! - fix: warn when a gantt task references an unknownafter/untiltask id, or when its end value is neither a valid date nor a valid duration -
#8249
b657a2cThanks @mir-ashiq! - fix(sequence): allow hyphenated actor and participant names when a config object is attached -
#8300
c38a565Thanks @filipsajdak! - fix: A partial override of an object-valued theme variable such asxyChart,radarorcynefinkeeps the values the theme generates for the keys it leaves out -
#8333
8afd83cThanks @ashishjain0512! - fix: upgrade the parser to langium 4.4 / chevrotain 13 so bundles no longer include[email protected] -
#8285
859f1f8Thanks @mir-ashiq! - fix(sequence): allow actor-menu keywords as participant ids in messagesA participant declared as
Link(orLinks,Properties,Details) could not be used as a
message endpoint: the lexer matched the name as thelinkstatement keyword and the parse failed.
Thelink,links,propertiesanddetailskeywords are now only recognized when an actor
follows them on the same line, so participant ids that happen to spell these words work in
messages, while the statements themselves keep parsing as before. -
#8282
b6d952dThanks @belomaxorka! - fix(sequence): allowLinkas a participant ID in messages and actor menusPreserve the ID's case and alias while keeping the
linkandlinksmenu commands supported. -
#8345
7917c1aThanks @knsv-bot! - fix: xychart measures text in SVG units so legends no longer clip on wide charts scaled to fit their container, and the chart title is dropped instead of overflowing when the chart is too short for it -
#8338
4a722fbThanks @ashishjain0512! - fix: Centre the xychart title over the plot area instead of the whole chart -
Updated dependencies [
8afd83c]:- @mermaid-js/[email protected]
@mermaid-js/[email protected]
Patch Changes
- #8333
8afd83cThanks @ashishjain0512! - fix: upgrade the parser to langium 4.4 / chevrotain 13 so bundles no longer include[email protected]
@mermaid-js/[email protected]
Patch Changes
-
#8334
d67331dThanks @ashishjain0512! - fix(class): place cardinality labels beside their relation ends on dagre's sides with ELK, centre dagre's end labels, and stop clipping their text -
Updated dependencies [
50c9e55,4c90f5c,c7fa1a5,d67331d,99a050b,9140716,3101c7d,aa29345,967bbde,147f343,40ef7b4,351d7d2,b657a2c,c38a565,fd4f5f2,8afd83c,859f1f8,b6d952d,7917c1a,4a722fb]: