-
new NodeProp({deserialize?: fn(str: string) → T} = {})
Create a new node prop type. You can optionally pass a deserialize function.
-
static string() → NodeProp<string>
Create a string-valued node prop whose deserialize function is the identity function.
-
static flag() → NodeProp<boolean>
Creates a boolean-valued node prop whose deserialize function returns true for any input.
-
static error: NodeProp<boolean>
The special node type that the parser uses to represent parse errors has this flag set. (You shouldn't use it for custom nodes that represent erroneous content.)
-
static skipped: NodeProp<boolean>
Nodes that were produced by skipped expressions (such as comments) have this prop set to true.
-
static delim: NodeProp<string>
Prop that is used to describe a rule's delimiters. For example, a parenthesized expression node would set this to the string "( )" (the open and close strings separated by a space). This is added by the parser generator's @detectDelim feature, but you can also manually add them.
-
static lang: NodeProp<string>
The top node for a grammar usually has a lang prop set to a string identifying the grammar, to provide context for the nodes inside of it.
-
static repeated: NodeProp<boolean>
A prop that indicates whether a node represents a repeated expression. Abstractions like Subtree hide such nodes, so you usually won't see them, but if you directly rummage through a tree's children, you'll find repeat nodes that wrap repeated content into balanced trees.
-
deserialize(str: string) → T
A method that deserializes a value of this prop from a string. Can be used to allow a prop to be directly written in a grammar file. Defaults to raising an error.
-
set(propObj: any[], value: T) → any[]
Store a value for this prop in the given object. This can be useful when building up a prop object to pass to the NodeType constructor. Returns its first argument.
-
add(f: fn(type: NodeType) → undefined | T) → NodePropSource
This is meant to be used with NodeGroup.extend or Parser.withProps to compute prop values for each node type in the group. Takes a function that returns undefined if the node type doesn't get this prop, or the prop's value if it does.