Printer

A code printer that converts AST nodes back into formatted Loreline source code. Handles indentation, newlines, and pretty-printing of all node types. Respects AST style metadata (BlockStyle, ConditionStyle, Quotes, operator forms).

Instance Members #

Set to false to ignore comments.

Resets the printer to its initial state.

Increases the current indentation level by one.

Decreases the current indentation level by one.

Writes a string to the output buffer, handling indentation if at start of line.

Writes a line break to the output.

Adds a newline to the output, limiting consecutive blank lines to 1.

Adds indentation at the current level to the output.

Alias for newline().

Returns the current content of the output buffer.

Renders a string literal as it would appear in source code, but without comments and with real newlines replaced by \n escapes. Preserves original quoting style. Used for the reference text after // in translation files.

Renders a string literal as plain text (no surrounding quotes, no comments), with real newlines replaced by \n escapes. Used for translation placeholder text.

Main entry point for printing an AST node to source code.

Creates a new code printer with customizable formatting options.

Private Members #

Dispatches a node to its appropriate printing function based on type.

Prints any leading comments attached to a node.

Prints any trailing comments attached to a node.

Prints an import statement.

Prints a complete Loreline script node.

Prints a state declaration node.

Prints a character declaration node.

Prints a beat declaration node.

Prints a function declaration node.

Prints a text statement node.

Prints a dialogue statement node.

Prints a choice statement node.

Prints an import statement node.

Prints a choice option node.

Prints an if statement node, handling both simple if and if-else structures.

Prints a transition node.

Prints an insertion node.

Prints a dynamic beat call statement node.

Prints the dynamic target expression and/or argument list of a transition or insertion, comma separated, with comments suppressed (they should be attached to the parent node).

Prints a string literal node, handling both plain strings and strings with quotes.

Writes a Raw text part for an unquoted string literal. Escape sequences are preserved as-is from the AST (already in correct form for unquoted context). Handles multiline continuation by stripping source indentation and re-indenting at current level.

Writes a Raw text part for a double-quoted string literal. Escape sequences are preserved as-is from the AST (already in correct form for quoted context). Content inside quotes is written verbatim, no indentation is added for continuation lines.

Writes raw text, handling embedded real newlines.

Prints a literal value node (numbers, booleans, arrays, objects).

Prints a field access expression (object.field).

Prints an array access expression (array[index]).

Prints a function call expression.

Prints a binary operation expression (a + b, a && b, etc). Handles operator precedence with parentheses when needed.

Prints a unary operation expression (!x, -x).

Prints a ternary expression (condition ? trueExpr : falseExpr).

Prints an assignment expression (a = b, a += b).

Prints an in-line expression optionally wrapped in parentheses. Comments on the expression are suppressed (they should be attached to the parent node).

Checks if an expression can be printed as simple interpolation ($var, $var.field, $var[idx], $var.call()). Simple interpolation is a chain of NAccess, NArrayAccess, and NCall rooted at a plain NAccess (no target).

Checks if a string literal contains real newlines in its raw parts. Real newlines indicate multiline text from the source (as opposed to escape sequences).

Converts a token type to its corresponding operator string representation.