Documentation

Indent one level of 2 spaces

Create content of grammar.js file

Print rules for comments

Print word section, this section is needed for tree-sitter to do keyword extraction before any parsing/lexing, see https://tree-sitter.github.io/tree-sitter/creating-parsers#keyword-extraction TODO: currently, we just add every user defined token as well as the predefined Ident token to this list to be safe. Ideally, we should enumerate all defined tokens against all occurrences of keywords. Any tokens patterns that could accept a keyword will go into this list. This will require integration of a regex engine.

Prints the rules in the grammar with the entry point first.

Since Treesitter requires a unique entry point, this will build a "virtual" entry point which dispatches to each of the declared BNFC entry points via a choice list. Additionally, the virtual entry point can be marked optional (and is the only rule which can be).

Generate one tree-sitter rule for one terminal token.

Generates one tree-sitter rule for one non-terminal from CF.

Start a defined symbol block in tree-sitter grammar

Wrap list using tree-sitter fun if the list contains multiple items Returns the only item without wrapping otherwise

Helper for referring to non-terminal names in tree-sitter

Format right hand side into list of strings

Format string for cat name, prefix "_" if the name is for internal rules