mirror of
https://github.com/mermaid-js/mermaid.git
synced 2025-09-10 19:09:44 +02:00
1bb09cc9a8
* master: Correct casing for hand drawn Updates to information about the new syntax Updating syntax reference with code showing how to select layout and look. [autofix.ci] apply automated fixes Version Packages (#5749) Bump mermaid minor Revert mermaid version add latest blog posts Version Packages (#5748) Test changeset (#5746) Version Packages Release parser, v0.1.0, test changeset
Mermaid Parser
Mermaid parser package
How the package works
The package exports a parse function that has two parameters:
declare function parse<T extends DiagramAST>(
diagramType: keyof typeof initializers,
text: string
): T;
How does a Langium-based parser work?
sequenceDiagram
actor Package
participant Module
participant TokenBuilder
participant Lexer
participant Parser
participant ValueConverter
Package ->> Module: Create services
Module ->> TokenBuilder: Override or/and<br>reorder rules
TokenBuilder ->> Lexer: Read the string and transform<br>it into a token stream
Lexer ->> Parser: Parse token<br>stream into AST
Parser ->> ValueConverter: Clean/modify tokenized<br>rules returned value
ValueConverter -->> Package: Return AST
-
When to override
TokenBuilder?- To override keyword rules.
- To override terminal rules that need a custom function.
- To manually reorder the list of rules.
-
When to override
Lexer?- To modify input before tokenizing.
- To insert/modify tokens that cannot or have not been parsed.
-
When to override
LangiumParser?- To insert or modify attributes that can't be parsed.
-
When to override
ValueConverter?- To modify the returned value from the parser.