a boolean value indicating whether to evaluate the provided template.
the AstNode corresponding to the appended content
Optional
property: Properties<T>the value property name (string) corresponding to the appended content,
if e.g. the content corresponds to some string
or number
property of astNode
, is optional
a tag function behaving as described above, which in turn returns a CompositeGeneratorNode.
Rest
...substitutions: unknown[]Convenience function for creating a CompositeGeneratorNode being configured with the
provided tracing information in form of {astNode, property, index}
and appending content
in form of a template, if condition
is equal to true
.
If condition
is satisfied, this function returns a tag function that takes the desired template
and does the processing by delegating to expandToNode and traceToNode and
finally returning the resulting generator node. Otherwise, the returned function just returns undefined
.
a boolean value indicating whether to evaluate the provided template.
the AstNode corresponding to the appended content
the value property name (string) corresponding to the appended content,
if e.g. the content corresponds to some string
or number
property of astNode
the index of the value within a list property corresponding to the appended content, if the property contains a list of elements, is ignored otherwise
a tag function behaving as described above, which in turn returns a CompositeGeneratorNode.
Rest
...substitutions: unknown[]Convenience function for creating a CompositeGeneratorNode being configured with the
provided tracing information in form of concrete coordinates and appending content in form
of a template, if condition
is equal to true
. Complete coordinates are provided by
the AstNodes' corresponding AstNode.$cstNodes.
This function returns a tag function that takes the desired template and does the processing by delegating to expandToNode and traceToNode and finally returning the resulting generator node.
If sourceRegion
is a function supplying the corresponding region, it's only called if condition
is satisfied.
a boolean value indicating whether to evaluate the provided template.
a text region within some file in form of concrete coordinates or a supplier function,
if undefined
no tracing will happen
a tag function behaving as described above, which in turn returns a CompositeGeneratorNode.
Rest
...substitutions: unknown[]Convenience function for creating a CompositeGeneratorNode being configured with the
provided tracing information in form of a list of concrete coordinates and appending content
in form of a template, if condition
is equal to true
. Complete coordinates are provided
by the AstNodes' corresponding AstNode.$cstNodes.
This function returns a tag function that takes the desired template and does the processing by delegating to expandToNode and traceToNode and finally returning the resulting generator node.
The list of regions in sourceRegions
will later be reduced to the smallest encompassing region
of all the contained source regions.
If sourceRegions
is a function supplying the corresponding regions, it's only called if condition
is satisfied.
a boolean value indicating whether to evaluate the provided template.
a list of text regions within some file in form of concrete coordinates, if empty no tracing will happen
a tag function behaving as described above, which in turn returns a CompositeGeneratorNode.
Rest
...substitutions: unknown[]
Convenience function for creating a CompositeGeneratorNode being configured with the provided tracing information in form of
{astNode, property?, index: undefined}
and appending content in form of a template, ifcondition
is equal totrue
.If
condition
is satisfied, this function returns a tag function that takes the desired template and does the processing by delegating to expandToNode and traceToNode and finally returning the resulting generator node. Otherwise, the returned function just returnsundefined
.