@mermaid-js/parser

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.

Changelog

0.3.0 (2014-12-22)

Full Changelog

Closed issues:

• Consider shipping a standalone executable #65
• Trailing whitespace at the end of lines is not ignored #55
• How do I do comments? #47
• This characters failed the lexical parsing #46
• tutorial for creating new type of graph/layout #44
• Improve readability with new line as terminator and whitespace #38
• Use classes instead of inline style for easy styling #24

Merged pull requests:

• Adds Command Line Interface for generating PNGs from mermaid description files #69 (fardog)
• Allow special symbols for direction along with acronyms #66 (vijay40)