@herb-tools/core 0.5.0 → 0.6.1

package/dist/herb-core.esm.js

@@ -1,53 +1,3 @@
-const expectedFunctions = [
-    "parse",
-    "lex",
-    "parseFile",
-    "lexFile",
-    "extractRuby",
-    "extractHTML",
-    "version",
-];
-// NOTE: This function should never be called and is only for type checking
-// so we can make sure `expectedFunctions` matches the functions defined
-// in `LibHerbBackendFunctions` and the other way around.
-//
-function _TYPECHECK() {
-    const checkFunctionsExist = true;
-    const checkInterfaceComplete = true;
-    return { checkFunctionsExist, checkInterfaceComplete };
-}
-function isLibHerbBackend(object, libherbpath = "unknown") {
-    for (const expectedFunction of expectedFunctions) {
-        if (object[expectedFunction] === undefined) {
-            throw new Error(`Libherb at "${libherbpath}" doesn't expose function "${expectedFunction}".`);
-        }
-        if (typeof object[expectedFunction] !== "function") {
-            throw new Error(`Libherb at "${libherbpath}" has "${expectedFunction}" but it's not a function.`);
-        }
-    }
-    return true;
-}
-function ensureLibHerbBackend(object, libherbpath = "unknown") {
-    isLibHerbBackend(object, libherbpath);
-    return object;
-}
-
-/**
- * Converts a Diagnostic to Monaco/VSCode-compatible MonacoDiagnostic format
- */
-function toMonacoDiagnostic(diagnostic) {
-    const { message, location } = diagnostic;
-    const severity = diagnostic.severity === "hint" ? "info" : diagnostic.severity;
-    return {
-        line: location.start.line,
-        column: location.start.column,
-        endLine: location.end.line,
-        endColumn: location.end.column,
-        message,
-        severity
-    };
-}
-
 class Position {
     line;
     column;
@@ -179,7 +129,7 @@ class Token {
 }
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-0.5.0/templates/javascript/packages/core/src/errors.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.6.1/templates/javascript/packages/core/src/errors.ts.erb
 class HerbError {
     type;
     message;
@@ -620,12 +570,6 @@ function fromSerializedError(error) {
     }
 }
 
-var name = "@herb-tools/core";
-var version = "0.5.0";
-var packageJSON = {
-	name: name,
-	version: version};
-
 function ensureString(object) {
     if (typeof object === "string") {
         return object;
@@ -641,139 +585,8 @@ function convertToUTF8(string) {
     return decoder.decode(new Uint8Array(bytes));
 }
 
-class Result {
-    source;
-    warnings;
-    errors;
-    constructor(source, warnings = [], errors = []) {
-        this.source = source;
-        this.warnings = warnings || [];
-        this.errors = errors || [];
-    }
-    /**
-     * Determines if the parsing was successful.
-     * @returns `true` if there are no errors, otherwise `false`.
-     */
-    get successful() {
-        return this.errors.length === 0;
-    }
-    /**
-     * Determines if the parsing failed.
-     * @returns `true` if there are errors, otherwise `false`.
-     */
-    get failed() {
-        return this.errors.length > 0;
-    }
-}
-
-class TokenList {
-    list;
-    static from(list) {
-        return new TokenList(list.map((token) => Token.from(token)));
-    }
-    constructor(list) {
-        this.list = list;
-    }
-    get length() {
-        return this.list.length;
-    }
-    get tokens() {
-        return this.list;
-    }
-    [Symbol.iterator]() {
-        return this.list[Symbol.iterator]();
-    }
-    at(index) {
-        return this.list.at(index);
-    }
-    forEach(callback) {
-        this.list.forEach(callback);
-    }
-    map(callback) {
-        return this.list.map(callback);
-    }
-    filter(predicate) {
-        return this.list.filter(predicate);
-    }
-    __getobj__() {
-        return this.list;
-    }
-    inspect() {
-        return this.list.map((token) => token.inspect()).join("\n") + "\n";
-    }
-    toString() {
-        return this.inspect();
-    }
-}
-
-class HerbWarning {
-    message;
-    location;
-    static from(warning) {
-        return new HerbWarning(warning.message, Location.from(warning.location));
-    }
-    constructor(message, location) {
-        this.message = message;
-        this.location = location;
-    }
-}
-
-/**
- * Represents the result of a lexical analysis, extending the base `Result` class.
- * It contains the token list, source code, warnings, and errors.
- */
-class LexResult extends Result {
-    /** The list of tokens generated from the source code. */
-    value;
-    /**
-     * Creates a `LexResult` instance from a serialized result.
-     * @param result - The serialized lexical result containing tokens, source, warnings, and errors.
-     * @returns A new `LexResult` instance.
-     */
-    static from(result) {
-        return new LexResult(TokenList.from(result.tokens || []), result.source, result.warnings.map((warning) => HerbWarning.from(warning)), result.errors.map((error) => HerbError.from(error)));
-    }
-    /**
-     * Constructs a new `LexResult`.
-     * @param value - The list of tokens.
-     * @param source - The source code that was lexed.
-     * @param warnings - An array of warnings encountered during lexing.
-     * @param errors - An array of errors encountered during lexing.
-     */
-    constructor(value, source, warnings = [], errors = []) {
-        super(source, warnings, errors);
-        this.value = value;
-    }
-    /**
-     * Determines if the lexing was successful.
-     * @returns `true` if there are no errors, otherwise `false`.
-     */
-    get successful() {
-        return this.errors.length === 0;
-    }
-    /**
-     * Determines if the lexing failed.
-     * @returns `true` if there are errors, otherwise `false`.
-     */
-    get failed() {
-        return this.errors.length > 0;
-    }
-    /**
-     * Converts the `LexResult` to a JSON representation.
-     * @returns An object containing the token list, source, warnings, and errors.
-     */
-    toJSON() {
-        return {
-            value: this.value,
-            source: this.source,
-            warnings: this.warnings,
-            errors: this.errors,
-        };
-    }
-}
-
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-0.5.0/templates/javascript/packages/core/src/nodes.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.6.1/templates/javascript/packages/core/src/nodes.ts.erb
 class Node {
     type;
     location;
@@ -781,6 +594,9 @@ class Node {
     static from(node) {
         return fromSerializedNode(node);
     }
+    static get type() {
+        throw new Error("AST_NODE");
+    }
     constructor(type, location, errors) {
         this.type = type;
         this.location = location;
@@ -796,6 +612,12 @@ class Node {
     inspect() {
         return this.treeInspect(0);
     }
+    is(nodeClass) {
+        return this.type === nodeClass.type;
+    }
+    isOfType(type) {
+        return this.type === type;
+    }
     get isSingleLine() {
         return this.location.start.line === this.location.end.line;
     }
@@ -837,6 +659,9 @@ class Node {
 }
 class DocumentNode extends Node {
     children;
+    static get type() {
+        return "AST_DOCUMENT_NODE";
+    }
     static from(data) {
         return new DocumentNode({
             type: data.type,
@@ -878,12 +703,14 @@ class DocumentNode extends Node {
         output += `@ DocumentNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `└── children: ${this.inspectArray(this.children, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
 class LiteralNode extends Node {
     content;
+    static get type() {
+        return "AST_LITERAL_NODE";
+    }
     static from(data) {
         return new LiteralNode({
             type: data.type,
@@ -922,7 +749,6 @@ class LiteralNode extends Node {
         output += `@ LiteralNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `└── content: ${this.content ? JSON.stringify(this.content) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -932,6 +758,9 @@ class HTMLOpenTagNode extends Node {
     tag_closing;
     children;
     is_void;
+    static get type() {
+        return "AST_HTML_OPEN_TAG_NODE";
+    }
     static from(data) {
         return new HTMLOpenTagNode({
             type: data.type,
@@ -989,14 +818,17 @@ class HTMLOpenTagNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `└── is_void: ${typeof this.is_void === 'boolean' ? String(this.is_void) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
 class HTMLCloseTagNode extends Node {
     tag_opening;
     tag_name;
+    children;
     tag_closing;
+    static get type() {
+        return "AST_HTML_CLOSE_TAG_NODE";
+    }
     static from(data) {
         return new HTMLCloseTagNode({
             type: data.type,
@@ -1004,6 +836,7 @@ class HTMLCloseTagNode extends Node {
             errors: (data.errors || []).map(error => HerbError.from(error)),
             tag_opening: data.tag_opening ? Token.from(data.tag_opening) : null,
             tag_name: data.tag_name ? Token.from(data.tag_name) : null,
+            children: (data.children || []).map(node => fromSerializedNode(node)),
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
         });
     }
@@ -1011,13 +844,16 @@ class HTMLCloseTagNode extends Node {
         super(props.type, props.location, props.errors);
         this.tag_opening = props.tag_opening;
         this.tag_name = props.tag_name;
+        this.children = props.children;
         this.tag_closing = props.tag_closing;
     }
     accept(visitor) {
         visitor.visitHTMLCloseTagNode(this);
     }
     childNodes() {
-        return [];
+        return [
+            ...this.children,
+        ];
     }
     compactChildNodes() {
         return this.childNodes().filter(node => node !== null && node !== undefined);
@@ -1025,6 +861,7 @@ class HTMLCloseTagNode extends Node {
     recursiveErrors() {
         return [
             ...this.errors,
+            ...this.children.map(node => node.recursiveErrors()),
         ].flat();
     }
     toJSON() {
@@ -1033,6 +870,7 @@ class HTMLCloseTagNode extends Node {
             type: "AST_HTML_CLOSE_TAG_NODE",
             tag_opening: this.tag_opening ? this.tag_opening.toJSON() : null,
             tag_name: this.tag_name ? this.tag_name.toJSON() : null,
+            children: this.children.map(node => node.toJSON()),
             tag_closing: this.tag_closing ? this.tag_closing.toJSON() : null,
         };
     }
@@ -1042,43 +880,48 @@ class HTMLCloseTagNode extends Node {
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
         output += `├── tag_name: ${this.tag_name ? this.tag_name.treeInspect() : "∅"}\n`;
+        output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
-class HTMLSelfCloseTagNode extends Node {
-    tag_opening;
+class HTMLElementNode extends Node {
+    open_tag;
     tag_name;
-    attributes;
-    tag_closing;
+    body;
+    close_tag;
     is_void;
+    static get type() {
+        return "AST_HTML_ELEMENT_NODE";
+    }
     static from(data) {
-        return new HTMLSelfCloseTagNode({
+        return new HTMLElementNode({
             type: data.type,
             location: Location.from(data.location),
             errors: (data.errors || []).map(error => HerbError.from(error)),
-            tag_opening: data.tag_opening ? Token.from(data.tag_opening) : null,
+            open_tag: data.open_tag ? fromSerializedNode((data.open_tag)) : null,
             tag_name: data.tag_name ? Token.from(data.tag_name) : null,
-            attributes: (data.attributes || []).map(node => fromSerializedNode(node)),
-            tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
+            body: (data.body || []).map(node => fromSerializedNode(node)),
+            close_tag: data.close_tag ? fromSerializedNode((data.close_tag)) : null,
             is_void: data.is_void,
         });
     }
     constructor(props) {
         super(props.type, props.location, props.errors);
-        this.tag_opening = props.tag_opening;
+        this.open_tag = props.open_tag;
         this.tag_name = props.tag_name;
-        this.attributes = props.attributes;
-        this.tag_closing = props.tag_closing;
+        this.body = props.body;
+        this.close_tag = props.close_tag;
         this.is_void = props.is_void;
     }
     accept(visitor) {
-        visitor.visitHTMLSelfCloseTagNode(this);
+        visitor.visitHTMLElementNode(this);
     }
     childNodes() {
         return [
-            ...this.attributes,
+            this.open_tag,
+            ...this.body,
+            this.close_tag,
         ];
     }
     compactChildNodes() {
@@ -1087,111 +930,44 @@ class HTMLSelfCloseTagNode extends Node {
     recursiveErrors() {
         return [
             ...this.errors,
-            ...this.attributes.map(node => node.recursiveErrors()),
+            this.open_tag ? this.open_tag.recursiveErrors() : [],
+            ...this.body.map(node => node.recursiveErrors()),
+            this.close_tag ? this.close_tag.recursiveErrors() : [],
         ].flat();
     }
     toJSON() {
         return {
             ...super.toJSON(),
-            type: "AST_HTML_SELF_CLOSE_TAG_NODE",
-            tag_opening: this.tag_opening ? this.tag_opening.toJSON() : null,
+            type: "AST_HTML_ELEMENT_NODE",
+            open_tag: this.open_tag ? this.open_tag.toJSON() : null,
             tag_name: this.tag_name ? this.tag_name.toJSON() : null,
-            attributes: this.attributes.map(node => node.toJSON()),
-            tag_closing: this.tag_closing ? this.tag_closing.toJSON() : null,
+            body: this.body.map(node => node.toJSON()),
+            close_tag: this.close_tag ? this.close_tag.toJSON() : null,
             is_void: this.is_void,
         };
     }
     treeInspect() {
         let output = "";
-        output += `@ HTMLSelfCloseTagNode ${this.location.treeInspectWithLabel()}\n`;
+        output += `@ HTMLElementNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
-        output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
+        output += `├── open_tag: ${this.inspectNode(this.open_tag, "│   ")}`;
         output += `├── tag_name: ${this.tag_name ? this.tag_name.treeInspect() : "∅"}\n`;
-        output += `├── attributes: ${this.inspectArray(this.attributes, "│   ")}`;
-        output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
+        output += `├── body: ${this.inspectArray(this.body, "│   ")}`;
+        output += `├── close_tag: ${this.inspectNode(this.close_tag, "│   ")}`;
         output += `└── is_void: ${typeof this.is_void === 'boolean' ? String(this.is_void) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
-class HTMLElementNode extends Node {
-    open_tag;
-    tag_name;
-    body;
-    close_tag;
-    is_void;
+class HTMLAttributeValueNode extends Node {
+    open_quote;
+    children;
+    close_quote;
+    quoted;
+    static get type() {
+        return "AST_HTML_ATTRIBUTE_VALUE_NODE";
+    }
     static from(data) {
-        return new HTMLElementNode({
-            type: data.type,
-            location: Location.from(data.location),
-            errors: (data.errors || []).map(error => HerbError.from(error)),
-            open_tag: data.open_tag ? fromSerializedNode(data.open_tag) : null,
-            tag_name: data.tag_name ? Token.from(data.tag_name) : null,
-            body: (data.body || []).map(node => fromSerializedNode(node)),
-            close_tag: data.close_tag ? fromSerializedNode(data.close_tag) : null,
-            is_void: data.is_void,
-        });
-    }
-    constructor(props) {
-        super(props.type, props.location, props.errors);
-        this.open_tag = props.open_tag;
-        this.tag_name = props.tag_name;
-        this.body = props.body;
-        this.close_tag = props.close_tag;
-        this.is_void = props.is_void;
-    }
-    accept(visitor) {
-        visitor.visitHTMLElementNode(this);
-    }
-    childNodes() {
-        return [
-            this.open_tag,
-            ...this.body,
-            this.close_tag,
-        ];
-    }
-    compactChildNodes() {
-        return this.childNodes().filter(node => node !== null && node !== undefined);
-    }
-    recursiveErrors() {
-        return [
-            ...this.errors,
-            this.open_tag ? this.open_tag.recursiveErrors() : [],
-            ...this.body.map(node => node.recursiveErrors()),
-            this.close_tag ? this.close_tag.recursiveErrors() : [],
-        ].flat();
-    }
-    toJSON() {
-        return {
-            ...super.toJSON(),
-            type: "AST_HTML_ELEMENT_NODE",
-            open_tag: this.open_tag ? this.open_tag.toJSON() : null,
-            tag_name: this.tag_name ? this.tag_name.toJSON() : null,
-            body: this.body.map(node => node.toJSON()),
-            close_tag: this.close_tag ? this.close_tag.toJSON() : null,
-            is_void: this.is_void,
-        };
-    }
-    treeInspect() {
-        let output = "";
-        output += `@ HTMLElementNode ${this.location.treeInspectWithLabel()}\n`;
-        output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
-        output += `├── open_tag: ${this.inspectNode(this.open_tag, "│   ")}`;
-        output += `├── tag_name: ${this.tag_name ? this.tag_name.treeInspect() : "∅"}\n`;
-        output += `├── body: ${this.inspectArray(this.body, "│   ")}`;
-        output += `├── close_tag: ${this.inspectNode(this.close_tag, "│   ")}`;
-        output += `└── is_void: ${typeof this.is_void === 'boolean' ? String(this.is_void) : "∅"}\n`;
-        // output += "\n";
-        return output;
-    }
-}
-class HTMLAttributeValueNode extends Node {
-    open_quote;
-    children;
-    close_quote;
-    quoted;
-    static from(data) {
-        return new HTMLAttributeValueNode({
+        return new HTMLAttributeValueNode({
             type: data.type,
             location: Location.from(data.location),
             errors: (data.errors || []).map(error => HerbError.from(error)),
@@ -1243,29 +1019,33 @@ class HTMLAttributeValueNode extends Node {
         output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `├── close_quote: ${this.close_quote ? this.close_quote.treeInspect() : "∅"}\n`;
         output += `└── quoted: ${typeof this.quoted === 'boolean' ? String(this.quoted) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
 class HTMLAttributeNameNode extends Node {
-    name;
+    children;
+    static get type() {
+        return "AST_HTML_ATTRIBUTE_NAME_NODE";
+    }
     static from(data) {
         return new HTMLAttributeNameNode({
             type: data.type,
             location: Location.from(data.location),
             errors: (data.errors || []).map(error => HerbError.from(error)),
-            name: data.name ? Token.from(data.name) : null,
+            children: (data.children || []).map(node => fromSerializedNode(node)),
         });
     }
     constructor(props) {
         super(props.type, props.location, props.errors);
-        this.name = props.name;
+        this.children = props.children;
     }
     accept(visitor) {
         visitor.visitHTMLAttributeNameNode(this);
     }
     childNodes() {
-        return [];
+        return [
+            ...this.children,
+        ];
     }
     compactChildNodes() {
         return this.childNodes().filter(node => node !== null && node !== undefined);
@@ -1273,21 +1053,21 @@ class HTMLAttributeNameNode extends Node {
     recursiveErrors() {
         return [
             ...this.errors,
+            ...this.children.map(node => node.recursiveErrors()),
         ].flat();
     }
     toJSON() {
         return {
             ...super.toJSON(),
             type: "AST_HTML_ATTRIBUTE_NAME_NODE",
-            name: this.name ? this.name.toJSON() : null,
+            children: this.children.map(node => node.toJSON()),
         };
     }
     treeInspect() {
         let output = "";
         output += `@ HTMLAttributeNameNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
-        output += `└── name: ${this.name ? this.name.treeInspect() : "∅"}\n`;
-        // output += "\n";
+        output += `└── children: ${this.inspectArray(this.children, "    ")}`;
         return output;
     }
 }
@@ -1295,14 +1075,17 @@ class HTMLAttributeNode extends Node {
     name;
     equals;
     value;
+    static get type() {
+        return "AST_HTML_ATTRIBUTE_NODE";
+    }
     static from(data) {
         return new HTMLAttributeNode({
             type: data.type,
             location: Location.from(data.location),
             errors: (data.errors || []).map(error => HerbError.from(error)),
-            name: data.name ? fromSerializedNode(data.name) : null,
+            name: data.name ? fromSerializedNode((data.name)) : null,
             equals: data.equals ? Token.from(data.equals) : null,
-            value: data.value ? fromSerializedNode(data.value) : null,
+            value: data.value ? fromSerializedNode((data.value)) : null,
         });
     }
     constructor(props) {
@@ -1346,12 +1129,14 @@ class HTMLAttributeNode extends Node {
         output += `├── name: ${this.inspectNode(this.name, "│   ")}`;
         output += `├── equals: ${this.equals ? this.equals.treeInspect() : "∅"}\n`;
         output += `└── value: ${this.inspectNode(this.value, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
 class HTMLTextNode extends Node {
     content;
+    static get type() {
+        return "AST_HTML_TEXT_NODE";
+    }
     static from(data) {
         return new HTMLTextNode({
             type: data.type,
@@ -1390,7 +1175,6 @@ class HTMLTextNode extends Node {
         output += `@ HTMLTextNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `└── content: ${this.content ? JSON.stringify(this.content) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1398,6 +1182,9 @@ class HTMLCommentNode extends Node {
     comment_start;
     children;
     comment_end;
+    static get type() {
+        return "AST_HTML_COMMENT_NODE";
+    }
     static from(data) {
         return new HTMLCommentNode({
             type: data.type,
@@ -1447,7 +1234,6 @@ class HTMLCommentNode extends Node {
         output += `├── comment_start: ${this.comment_start ? this.comment_start.treeInspect() : "∅"}\n`;
         output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `└── comment_end: ${this.comment_end ? this.comment_end.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1455,6 +1241,9 @@ class HTMLDoctypeNode extends Node {
     tag_opening;
     children;
     tag_closing;
+    static get type() {
+        return "AST_HTML_DOCTYPE_NODE";
+    }
     static from(data) {
         return new HTMLDoctypeNode({
             type: data.type,
@@ -1504,12 +1293,132 @@ class HTMLDoctypeNode extends Node {
         output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
         output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        // output += "\n";
+        return output;
+    }
+}
+class XMLDeclarationNode extends Node {
+    tag_opening;
+    children;
+    tag_closing;
+    static get type() {
+        return "AST_XML_DECLARATION_NODE";
+    }
+    static from(data) {
+        return new XMLDeclarationNode({
+            type: data.type,
+            location: Location.from(data.location),
+            errors: (data.errors || []).map(error => HerbError.from(error)),
+            tag_opening: data.tag_opening ? Token.from(data.tag_opening) : null,
+            children: (data.children || []).map(node => fromSerializedNode(node)),
+            tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
+        });
+    }
+    constructor(props) {
+        super(props.type, props.location, props.errors);
+        this.tag_opening = props.tag_opening;
+        this.children = props.children;
+        this.tag_closing = props.tag_closing;
+    }
+    accept(visitor) {
+        visitor.visitXMLDeclarationNode(this);
+    }
+    childNodes() {
+        return [
+            ...this.children,
+        ];
+    }
+    compactChildNodes() {
+        return this.childNodes().filter(node => node !== null && node !== undefined);
+    }
+    recursiveErrors() {
+        return [
+            ...this.errors,
+            ...this.children.map(node => node.recursiveErrors()),
+        ].flat();
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            type: "AST_XML_DECLARATION_NODE",
+            tag_opening: this.tag_opening ? this.tag_opening.toJSON() : null,
+            children: this.children.map(node => node.toJSON()),
+            tag_closing: this.tag_closing ? this.tag_closing.toJSON() : null,
+        };
+    }
+    treeInspect() {
+        let output = "";
+        output += `@ XMLDeclarationNode ${this.location.treeInspectWithLabel()}\n`;
+        output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
+        output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
+        output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
+        output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
+        return output;
+    }
+}
+class CDATANode extends Node {
+    tag_opening;
+    children;
+    tag_closing;
+    static get type() {
+        return "AST_CDATA_NODE";
+    }
+    static from(data) {
+        return new CDATANode({
+            type: data.type,
+            location: Location.from(data.location),
+            errors: (data.errors || []).map(error => HerbError.from(error)),
+            tag_opening: data.tag_opening ? Token.from(data.tag_opening) : null,
+            children: (data.children || []).map(node => fromSerializedNode(node)),
+            tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
+        });
+    }
+    constructor(props) {
+        super(props.type, props.location, props.errors);
+        this.tag_opening = props.tag_opening;
+        this.children = props.children;
+        this.tag_closing = props.tag_closing;
+    }
+    accept(visitor) {
+        visitor.visitCDATANode(this);
+    }
+    childNodes() {
+        return [
+            ...this.children,
+        ];
+    }
+    compactChildNodes() {
+        return this.childNodes().filter(node => node !== null && node !== undefined);
+    }
+    recursiveErrors() {
+        return [
+            ...this.errors,
+            ...this.children.map(node => node.recursiveErrors()),
+        ].flat();
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            type: "AST_CDATA_NODE",
+            tag_opening: this.tag_opening ? this.tag_opening.toJSON() : null,
+            children: this.children.map(node => node.toJSON()),
+            tag_closing: this.tag_closing ? this.tag_closing.toJSON() : null,
+        };
+    }
+    treeInspect() {
+        let output = "";
+        output += `@ CDATANode ${this.location.treeInspectWithLabel()}\n`;
+        output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
+        output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
+        output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
+        output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         return output;
     }
 }
 class WhitespaceNode extends Node {
     value;
+    static get type() {
+        return "AST_WHITESPACE_NODE";
+    }
     static from(data) {
         return new WhitespaceNode({
             type: data.type,
@@ -1548,7 +1457,6 @@ class WhitespaceNode extends Node {
         output += `@ WhitespaceNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `└── value: ${this.value ? this.value.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1559,6 +1467,9 @@ class ERBContentNode extends Node {
     // no-op for analyzed_ruby
     parsed;
     valid;
+    static get type() {
+        return "AST_ERB_CONTENT_NODE";
+    }
     static from(data) {
         return new ERBContentNode({
             type: data.type,
@@ -1617,7 +1528,6 @@ class ERBContentNode extends Node {
         // no-op for analyzed_ruby
         output += `├── parsed: ${typeof this.parsed === 'boolean' ? String(this.parsed) : "∅"}\n`;
         output += `└── valid: ${typeof this.valid === 'boolean' ? String(this.valid) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1625,6 +1535,9 @@ class ERBEndNode extends Node {
     tag_opening;
     content;
     tag_closing;
+    static get type() {
+        return "AST_ERB_END_NODE";
+    }
     static from(data) {
         return new ERBEndNode({
             type: data.type,
@@ -1671,7 +1584,6 @@ class ERBEndNode extends Node {
         output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1680,6 +1592,9 @@ class ERBElseNode extends Node {
     content;
     tag_closing;
     statements;
+    static get type() {
+        return "AST_ERB_ELSE_NODE";
+    }
     static from(data) {
         return new ERBElseNode({
             type: data.type,
@@ -1733,7 +1648,6 @@ class ERBElseNode extends Node {
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `└── statements: ${this.inspectArray(this.statements, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1744,6 +1658,9 @@ class ERBIfNode extends Node {
     statements;
     subsequent;
     end_node;
+    static get type() {
+        return "AST_ERB_IF_NODE";
+    }
     static from(data) {
         return new ERBIfNode({
             type: data.type,
@@ -1753,8 +1670,8 @@ class ERBIfNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            subsequent: data.subsequent ? fromSerializedNode(data.subsequent) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            subsequent: data.subsequent ? fromSerializedNode((data.subsequent)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -1809,7 +1726,6 @@ class ERBIfNode extends Node {
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `├── subsequent: ${this.inspectNode(this.subsequent, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1819,6 +1735,9 @@ class ERBBlockNode extends Node {
     tag_closing;
     body;
     end_node;
+    static get type() {
+        return "AST_ERB_BLOCK_NODE";
+    }
     static from(data) {
         return new ERBBlockNode({
             type: data.type,
@@ -1828,7 +1747,7 @@ class ERBBlockNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             body: (data.body || []).map(node => fromSerializedNode(node)),
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -1878,7 +1797,6 @@ class ERBBlockNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── body: ${this.inspectArray(this.body, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1887,6 +1805,9 @@ class ERBWhenNode extends Node {
     content;
     tag_closing;
     statements;
+    static get type() {
+        return "AST_ERB_WHEN_NODE";
+    }
     static from(data) {
         return new ERBWhenNode({
             type: data.type,
@@ -1940,7 +1861,6 @@ class ERBWhenNode extends Node {
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `└── statements: ${this.inspectArray(this.statements, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1952,6 +1872,9 @@ class ERBCaseNode extends Node {
     conditions;
     else_clause;
     end_node;
+    static get type() {
+        return "AST_ERB_CASE_NODE";
+    }
     static from(data) {
         return new ERBCaseNode({
             type: data.type,
@@ -1962,8 +1885,8 @@ class ERBCaseNode extends Node {
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             children: (data.children || []).map(node => fromSerializedNode(node)),
             conditions: (data.conditions || []).map(node => fromSerializedNode(node)),
-            else_clause: data.else_clause ? fromSerializedNode(data.else_clause) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            else_clause: data.else_clause ? fromSerializedNode((data.else_clause)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2023,7 +1946,6 @@ class ERBCaseNode extends Node {
         output += `├── conditions: ${this.inspectArray(this.conditions, "│   ")}`;
         output += `├── else_clause: ${this.inspectNode(this.else_clause, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2035,6 +1957,9 @@ class ERBCaseMatchNode extends Node {
     conditions;
     else_clause;
     end_node;
+    static get type() {
+        return "AST_ERB_CASE_MATCH_NODE";
+    }
     static from(data) {
         return new ERBCaseMatchNode({
             type: data.type,
@@ -2045,8 +1970,8 @@ class ERBCaseMatchNode extends Node {
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             children: (data.children || []).map(node => fromSerializedNode(node)),
             conditions: (data.conditions || []).map(node => fromSerializedNode(node)),
-            else_clause: data.else_clause ? fromSerializedNode(data.else_clause) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            else_clause: data.else_clause ? fromSerializedNode((data.else_clause)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2106,7 +2031,6 @@ class ERBCaseMatchNode extends Node {
         output += `├── conditions: ${this.inspectArray(this.conditions, "│   ")}`;
         output += `├── else_clause: ${this.inspectNode(this.else_clause, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2116,6 +2040,9 @@ class ERBWhileNode extends Node {
     tag_closing;
     statements;
     end_node;
+    static get type() {
+        return "AST_ERB_WHILE_NODE";
+    }
     static from(data) {
         return new ERBWhileNode({
             type: data.type,
@@ -2125,7 +2052,7 @@ class ERBWhileNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2175,7 +2102,6 @@ class ERBWhileNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2185,6 +2111,9 @@ class ERBUntilNode extends Node {
     tag_closing;
     statements;
     end_node;
+    static get type() {
+        return "AST_ERB_UNTIL_NODE";
+    }
     static from(data) {
         return new ERBUntilNode({
             type: data.type,
@@ -2194,7 +2123,7 @@ class ERBUntilNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2244,7 +2173,6 @@ class ERBUntilNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2254,6 +2182,9 @@ class ERBForNode extends Node {
     tag_closing;
     statements;
     end_node;
+    static get type() {
+        return "AST_ERB_FOR_NODE";
+    }
     static from(data) {
         return new ERBForNode({
             type: data.type,
@@ -2263,7 +2194,7 @@ class ERBForNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2313,7 +2244,6 @@ class ERBForNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2323,6 +2253,9 @@ class ERBRescueNode extends Node {
     tag_closing;
     statements;
     subsequent;
+    static get type() {
+        return "AST_ERB_RESCUE_NODE";
+    }
     static from(data) {
         return new ERBRescueNode({
             type: data.type,
@@ -2332,7 +2265,7 @@ class ERBRescueNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            subsequent: data.subsequent ? fromSerializedNode(data.subsequent) : null,
+            subsequent: data.subsequent ? fromSerializedNode((data.subsequent)) : null,
         });
     }
     constructor(props) {
@@ -2382,7 +2315,6 @@ class ERBRescueNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `└── subsequent: ${this.inspectNode(this.subsequent, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2391,6 +2323,9 @@ class ERBEnsureNode extends Node {
     content;
     tag_closing;
     statements;
+    static get type() {
+        return "AST_ERB_ENSURE_NODE";
+    }
     static from(data) {
         return new ERBEnsureNode({
             type: data.type,
@@ -2444,7 +2379,6 @@ class ERBEnsureNode extends Node {
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `└── statements: ${this.inspectArray(this.statements, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2457,6 +2391,9 @@ class ERBBeginNode extends Node {
     else_clause;
     ensure_clause;
     end_node;
+    static get type() {
+        return "AST_ERB_BEGIN_NODE";
+    }
     static from(data) {
         return new ERBBeginNode({
             type: data.type,
@@ -2466,10 +2403,10 @@ class ERBBeginNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            rescue_clause: data.rescue_clause ? fromSerializedNode(data.rescue_clause) : null,
-            else_clause: data.else_clause ? fromSerializedNode(data.else_clause) : null,
-            ensure_clause: data.ensure_clause ? fromSerializedNode(data.ensure_clause) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            rescue_clause: data.rescue_clause ? fromSerializedNode((data.rescue_clause)) : null,
+            else_clause: data.else_clause ? fromSerializedNode((data.else_clause)) : null,
+            ensure_clause: data.ensure_clause ? fromSerializedNode((data.ensure_clause)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2534,7 +2471,6 @@ class ERBBeginNode extends Node {
         output += `├── else_clause: ${this.inspectNode(this.else_clause, "│   ")}`;
         output += `├── ensure_clause: ${this.inspectNode(this.ensure_clause, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2545,6 +2481,9 @@ class ERBUnlessNode extends Node {
     statements;
     else_clause;
     end_node;
+    static get type() {
+        return "AST_ERB_UNLESS_NODE";
+    }
     static from(data) {
         return new ERBUnlessNode({
             type: data.type,
@@ -2554,8 +2493,8 @@ class ERBUnlessNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            else_clause: data.else_clause ? fromSerializedNode(data.else_clause) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            else_clause: data.else_clause ? fromSerializedNode((data.else_clause)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2610,7 +2549,6 @@ class ERBUnlessNode extends Node {
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `├── else_clause: ${this.inspectNode(this.else_clause, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2618,6 +2556,9 @@ class ERBYieldNode extends Node {
     tag_opening;
     content;
     tag_closing;
+    static get type() {
+        return "AST_ERB_YIELD_NODE";
+    }
     static from(data) {
         return new ERBYieldNode({
             type: data.type,
@@ -2664,7 +2605,6 @@ class ERBYieldNode extends Node {
         output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -2673,6 +2613,9 @@ class ERBInNode extends Node {
     content;
     tag_closing;
     statements;
+    static get type() {
+        return "AST_ERB_IN_NODE";
+    }
     static from(data) {
         return new ERBInNode({
             type: data.type,
@@ -2726,7 +2669,6 @@ class ERBInNode extends Node {
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `└── statements: ${this.inspectArray(this.statements, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2736,7 +2678,6 @@ function fromSerializedNode(node) {
         case "AST_LITERAL_NODE": return LiteralNode.from(node);
         case "AST_HTML_OPEN_TAG_NODE": return HTMLOpenTagNode.from(node);
         case "AST_HTML_CLOSE_TAG_NODE": return HTMLCloseTagNode.from(node);
-        case "AST_HTML_SELF_CLOSE_TAG_NODE": return HTMLSelfCloseTagNode.from(node);
         case "AST_HTML_ELEMENT_NODE": return HTMLElementNode.from(node);
         case "AST_HTML_ATTRIBUTE_VALUE_NODE": return HTMLAttributeValueNode.from(node);
         case "AST_HTML_ATTRIBUTE_NAME_NODE": return HTMLAttributeNameNode.from(node);
@@ -2744,6 +2685,8 @@ function fromSerializedNode(node) {
         case "AST_HTML_TEXT_NODE": return HTMLTextNode.from(node);
         case "AST_HTML_COMMENT_NODE": return HTMLCommentNode.from(node);
         case "AST_HTML_DOCTYPE_NODE": return HTMLDoctypeNode.from(node);
+        case "AST_XML_DECLARATION_NODE": return XMLDeclarationNode.from(node);
+        case "AST_CDATA_NODE": return CDATANode.from(node);
         case "AST_WHITESPACE_NODE": return WhitespaceNode.from(node);
         case "AST_ERB_CONTENT_NODE": return ERBContentNode.from(node);
         case "AST_ERB_END_NODE": return ERBEndNode.from(node);
@@ -2785,8 +2728,42 @@ const ERBNodeClasses = [
     ERBYieldNode,
     ERBInNode,
 ];
-function isERBNode(node) {
-    return node.constructor.name.startsWith("ERB");
+
+class Result {
+    source;
+    warnings;
+    errors;
+    constructor(source, warnings = [], errors = []) {
+        this.source = source;
+        this.warnings = warnings || [];
+        this.errors = errors || [];
+    }
+    /**
+     * Determines if the parsing was successful.
+     * @returns `true` if there are no errors, otherwise `false`.
+     */
+    get successful() {
+        return this.errors.length === 0;
+    }
+    /**
+     * Determines if the parsing failed.
+     * @returns `true` if there are errors, otherwise `false`.
+     */
+    get failed() {
+        return this.errors.length > 0;
+    }
+}
+
+class HerbWarning {
+    message;
+    location;
+    static from(warning) {
+        return new HerbWarning(warning.message, Location.from(warning.location));
+    }
+    constructor(message, location) {
+        this.message = message;
+        this.location = location;
+    }
 }
 
 /**
@@ -2856,23 +2833,1017 @@ class ParseResult extends Result {
     }
 }
 
+// NOTE: This file is generated by the templates/template.rb script and should not
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.6.1/templates/javascript/packages/core/src/node-type-guards.ts.erb
 /**
- * The main Herb parser interface, providing methods to lex and parse input.
+ * Type guard functions for AST nodes.
+ * These functions provide type checking by combining both instanceof
+ * checks and type string comparisons for maximum reliability across different
+ * runtime scenarios (e.g., serialized/deserialized nodes).
  */
-class HerbBackend {
-    /** The backend instance handling lexing and parsing. */
-    backend = undefined;
-    backendPromise;
-    /**
-     * Creates a new Herb instance.
-     * @param backendPromise - A promise resolving to a `LibHerbBackend` implementation for lexing and parsing.
-     * @throws Error if no valid backend is provided.
-     */
-    constructor(backendPromise) {
-        if (!backendPromise) {
-            throw new Error("No LibHerb backend provided");
-        }
-        this.backendPromise = backendPromise;
+/**
+ * Checks if a node is a DocumentNode
+ */
+function isDocumentNode(node) {
+    return node instanceof DocumentNode || node.type === "AST_DOCUMENT_NODE" || node.constructor.type === "AST_DOCUMENT_NODE";
+}
+/**
+ * Checks if a node is a LiteralNode
+ */
+function isLiteralNode(node) {
+    return node instanceof LiteralNode || node.type === "AST_LITERAL_NODE" || node.constructor.type === "AST_LITERAL_NODE";
+}
+/**
+ * Checks if a node is a HTMLOpenTagNode
+ */
+function isHTMLOpenTagNode(node) {
+    return node instanceof HTMLOpenTagNode || node.type === "AST_HTML_OPEN_TAG_NODE" || node.constructor.type === "AST_HTML_OPEN_TAG_NODE";
+}
+/**
+ * Checks if a node is a HTMLCloseTagNode
+ */
+function isHTMLCloseTagNode(node) {
+    return node instanceof HTMLCloseTagNode || node.type === "AST_HTML_CLOSE_TAG_NODE" || node.constructor.type === "AST_HTML_CLOSE_TAG_NODE";
+}
+/**
+ * Checks if a node is a HTMLElementNode
+ */
+function isHTMLElementNode(node) {
+    return node instanceof HTMLElementNode || node.type === "AST_HTML_ELEMENT_NODE" || node.constructor.type === "AST_HTML_ELEMENT_NODE";
+}
+/**
+ * Checks if a node is a HTMLAttributeValueNode
+ */
+function isHTMLAttributeValueNode(node) {
+    return node instanceof HTMLAttributeValueNode || node.type === "AST_HTML_ATTRIBUTE_VALUE_NODE" || node.constructor.type === "AST_HTML_ATTRIBUTE_VALUE_NODE";
+}
+/**
+ * Checks if a node is a HTMLAttributeNameNode
+ */
+function isHTMLAttributeNameNode(node) {
+    return node instanceof HTMLAttributeNameNode || node.type === "AST_HTML_ATTRIBUTE_NAME_NODE" || node.constructor.type === "AST_HTML_ATTRIBUTE_NAME_NODE";
+}
+/**
+ * Checks if a node is a HTMLAttributeNode
+ */
+function isHTMLAttributeNode(node) {
+    return node instanceof HTMLAttributeNode || node.type === "AST_HTML_ATTRIBUTE_NODE" || node.constructor.type === "AST_HTML_ATTRIBUTE_NODE";
+}
+/**
+ * Checks if a node is a HTMLTextNode
+ */
+function isHTMLTextNode(node) {
+    return node instanceof HTMLTextNode || node.type === "AST_HTML_TEXT_NODE" || node.constructor.type === "AST_HTML_TEXT_NODE";
+}
+/**
+ * Checks if a node is a HTMLCommentNode
+ */
+function isHTMLCommentNode(node) {
+    return node instanceof HTMLCommentNode || node.type === "AST_HTML_COMMENT_NODE" || node.constructor.type === "AST_HTML_COMMENT_NODE";
+}
+/**
+ * Checks if a node is a HTMLDoctypeNode
+ */
+function isHTMLDoctypeNode(node) {
+    return node instanceof HTMLDoctypeNode || node.type === "AST_HTML_DOCTYPE_NODE" || node.constructor.type === "AST_HTML_DOCTYPE_NODE";
+}
+/**
+ * Checks if a node is a XMLDeclarationNode
+ */
+function isXMLDeclarationNode(node) {
+    return node instanceof XMLDeclarationNode || node.type === "AST_XML_DECLARATION_NODE" || node.constructor.type === "AST_XML_DECLARATION_NODE";
+}
+/**
+ * Checks if a node is a CDATANode
+ */
+function isCDATANode(node) {
+    return node instanceof CDATANode || node.type === "AST_CDATA_NODE" || node.constructor.type === "AST_CDATA_NODE";
+}
+/**
+ * Checks if a node is a WhitespaceNode
+ */
+function isWhitespaceNode(node) {
+    return node instanceof WhitespaceNode || node.type === "AST_WHITESPACE_NODE" || node.constructor.type === "AST_WHITESPACE_NODE";
+}
+/**
+ * Checks if a node is a ERBContentNode
+ */
+function isERBContentNode(node) {
+    return node instanceof ERBContentNode || node.type === "AST_ERB_CONTENT_NODE" || node.constructor.type === "AST_ERB_CONTENT_NODE";
+}
+/**
+ * Checks if a node is a ERBEndNode
+ */
+function isERBEndNode(node) {
+    return node instanceof ERBEndNode || node.type === "AST_ERB_END_NODE" || node.constructor.type === "AST_ERB_END_NODE";
+}
+/**
+ * Checks if a node is a ERBElseNode
+ */
+function isERBElseNode(node) {
+    return node instanceof ERBElseNode || node.type === "AST_ERB_ELSE_NODE" || node.constructor.type === "AST_ERB_ELSE_NODE";
+}
+/**
+ * Checks if a node is a ERBIfNode
+ */
+function isERBIfNode(node) {
+    return node instanceof ERBIfNode || node.type === "AST_ERB_IF_NODE" || node.constructor.type === "AST_ERB_IF_NODE";
+}
+/**
+ * Checks if a node is a ERBBlockNode
+ */
+function isERBBlockNode(node) {
+    return node instanceof ERBBlockNode || node.type === "AST_ERB_BLOCK_NODE" || node.constructor.type === "AST_ERB_BLOCK_NODE";
+}
+/**
+ * Checks if a node is a ERBWhenNode
+ */
+function isERBWhenNode(node) {
+    return node instanceof ERBWhenNode || node.type === "AST_ERB_WHEN_NODE" || node.constructor.type === "AST_ERB_WHEN_NODE";
+}
+/**
+ * Checks if a node is a ERBCaseNode
+ */
+function isERBCaseNode(node) {
+    return node instanceof ERBCaseNode || node.type === "AST_ERB_CASE_NODE" || node.constructor.type === "AST_ERB_CASE_NODE";
+}
+/**
+ * Checks if a node is a ERBCaseMatchNode
+ */
+function isERBCaseMatchNode(node) {
+    return node instanceof ERBCaseMatchNode || node.type === "AST_ERB_CASE_MATCH_NODE" || node.constructor.type === "AST_ERB_CASE_MATCH_NODE";
+}
+/**
+ * Checks if a node is a ERBWhileNode
+ */
+function isERBWhileNode(node) {
+    return node instanceof ERBWhileNode || node.type === "AST_ERB_WHILE_NODE" || node.constructor.type === "AST_ERB_WHILE_NODE";
+}
+/**
+ * Checks if a node is a ERBUntilNode
+ */
+function isERBUntilNode(node) {
+    return node instanceof ERBUntilNode || node.type === "AST_ERB_UNTIL_NODE" || node.constructor.type === "AST_ERB_UNTIL_NODE";
+}
+/**
+ * Checks if a node is a ERBForNode
+ */
+function isERBForNode(node) {
+    return node instanceof ERBForNode || node.type === "AST_ERB_FOR_NODE" || node.constructor.type === "AST_ERB_FOR_NODE";
+}
+/**
+ * Checks if a node is a ERBRescueNode
+ */
+function isERBRescueNode(node) {
+    return node instanceof ERBRescueNode || node.type === "AST_ERB_RESCUE_NODE" || node.constructor.type === "AST_ERB_RESCUE_NODE";
+}
+/**
+ * Checks if a node is a ERBEnsureNode
+ */
+function isERBEnsureNode(node) {
+    return node instanceof ERBEnsureNode || node.type === "AST_ERB_ENSURE_NODE" || node.constructor.type === "AST_ERB_ENSURE_NODE";
+}
+/**
+ * Checks if a node is a ERBBeginNode
+ */
+function isERBBeginNode(node) {
+    return node instanceof ERBBeginNode || node.type === "AST_ERB_BEGIN_NODE" || node.constructor.type === "AST_ERB_BEGIN_NODE";
+}
+/**
+ * Checks if a node is a ERBUnlessNode
+ */
+function isERBUnlessNode(node) {
+    return node instanceof ERBUnlessNode || node.type === "AST_ERB_UNLESS_NODE" || node.constructor.type === "AST_ERB_UNLESS_NODE";
+}
+/**
+ * Checks if a node is a ERBYieldNode
+ */
+function isERBYieldNode(node) {
+    return node instanceof ERBYieldNode || node.type === "AST_ERB_YIELD_NODE" || node.constructor.type === "AST_ERB_YIELD_NODE";
+}
+/**
+ * Checks if a node is a ERBInNode
+ */
+function isERBInNode(node) {
+    return node instanceof ERBInNode || node.type === "AST_ERB_IN_NODE" || node.constructor.type === "AST_ERB_IN_NODE";
+}
+/**
+ * Convenience type guards for common node categories
+ */
+/**
+ * Checks if a node is any HTML node type
+ */
+function isHTMLNode(node) {
+    return isHTMLOpenTagNode(node) ||
+        isHTMLCloseTagNode(node) ||
+        isHTMLElementNode(node) ||
+        isHTMLAttributeValueNode(node) ||
+        isHTMLAttributeNameNode(node) ||
+        isHTMLAttributeNode(node) ||
+        isHTMLTextNode(node) ||
+        isHTMLCommentNode(node) ||
+        isHTMLDoctypeNode(node);
+}
+/**
+ * Checks if a node is any ERB node type
+ */
+function isERBNode(node) {
+    return isERBContentNode(node) ||
+        isERBEndNode(node) ||
+        isERBElseNode(node) ||
+        isERBIfNode(node) ||
+        isERBBlockNode(node) ||
+        isERBWhenNode(node) ||
+        isERBCaseNode(node) ||
+        isERBCaseMatchNode(node) ||
+        isERBWhileNode(node) ||
+        isERBUntilNode(node) ||
+        isERBForNode(node) ||
+        isERBRescueNode(node) ||
+        isERBEnsureNode(node) ||
+        isERBBeginNode(node) ||
+        isERBUnlessNode(node) ||
+        isERBYieldNode(node) ||
+        isERBInNode(node);
+}
+/**
+ * Map of node classes to their corresponding type guard functions
+ *
+ * @example
+ * const guard = NODE_TYPE_GUARDS[HTMLTextNode]
+ *
+ * if (guard(node)) {
+ *   // node is HTMLTextNode
+ * }
+ */
+const NODE_TYPE_GUARDS = new Map([
+    [DocumentNode, isDocumentNode],
+    [LiteralNode, isLiteralNode],
+    [HTMLOpenTagNode, isHTMLOpenTagNode],
+    [HTMLCloseTagNode, isHTMLCloseTagNode],
+    [HTMLElementNode, isHTMLElementNode],
+    [HTMLAttributeValueNode, isHTMLAttributeValueNode],
+    [HTMLAttributeNameNode, isHTMLAttributeNameNode],
+    [HTMLAttributeNode, isHTMLAttributeNode],
+    [HTMLTextNode, isHTMLTextNode],
+    [HTMLCommentNode, isHTMLCommentNode],
+    [HTMLDoctypeNode, isHTMLDoctypeNode],
+    [XMLDeclarationNode, isXMLDeclarationNode],
+    [CDATANode, isCDATANode],
+    [WhitespaceNode, isWhitespaceNode],
+    [ERBContentNode, isERBContentNode],
+    [ERBEndNode, isERBEndNode],
+    [ERBElseNode, isERBElseNode],
+    [ERBIfNode, isERBIfNode],
+    [ERBBlockNode, isERBBlockNode],
+    [ERBWhenNode, isERBWhenNode],
+    [ERBCaseNode, isERBCaseNode],
+    [ERBCaseMatchNode, isERBCaseMatchNode],
+    [ERBWhileNode, isERBWhileNode],
+    [ERBUntilNode, isERBUntilNode],
+    [ERBForNode, isERBForNode],
+    [ERBRescueNode, isERBRescueNode],
+    [ERBEnsureNode, isERBEnsureNode],
+    [ERBBeginNode, isERBBeginNode],
+    [ERBUnlessNode, isERBUnlessNode],
+    [ERBYieldNode, isERBYieldNode],
+    [ERBInNode, isERBInNode],
+]);
+/**
+ * Map of AST node type strings to their corresponding type guard functions
+ *
+ * @example
+ * const guard = AST_TYPE_GUARDS["AST_HTML_TEXT_NODE"]
+ *
+ * if (guard(node)) {
+ *   // node is HTMLTextNode
+ * }
+ */
+const AST_TYPE_GUARDS = new Map([
+    ["AST_DOCUMENT_NODE", isDocumentNode],
+    ["AST_LITERAL_NODE", isLiteralNode],
+    ["AST_HTML_OPEN_TAG_NODE", isHTMLOpenTagNode],
+    ["AST_HTML_CLOSE_TAG_NODE", isHTMLCloseTagNode],
+    ["AST_HTML_ELEMENT_NODE", isHTMLElementNode],
+    ["AST_HTML_ATTRIBUTE_VALUE_NODE", isHTMLAttributeValueNode],
+    ["AST_HTML_ATTRIBUTE_NAME_NODE", isHTMLAttributeNameNode],
+    ["AST_HTML_ATTRIBUTE_NODE", isHTMLAttributeNode],
+    ["AST_HTML_TEXT_NODE", isHTMLTextNode],
+    ["AST_HTML_COMMENT_NODE", isHTMLCommentNode],
+    ["AST_HTML_DOCTYPE_NODE", isHTMLDoctypeNode],
+    ["AST_XML_DECLARATION_NODE", isXMLDeclarationNode],
+    ["AST_CDATA_NODE", isCDATANode],
+    ["AST_WHITESPACE_NODE", isWhitespaceNode],
+    ["AST_ERB_CONTENT_NODE", isERBContentNode],
+    ["AST_ERB_END_NODE", isERBEndNode],
+    ["AST_ERB_ELSE_NODE", isERBElseNode],
+    ["AST_ERB_IF_NODE", isERBIfNode],
+    ["AST_ERB_BLOCK_NODE", isERBBlockNode],
+    ["AST_ERB_WHEN_NODE", isERBWhenNode],
+    ["AST_ERB_CASE_NODE", isERBCaseNode],
+    ["AST_ERB_CASE_MATCH_NODE", isERBCaseMatchNode],
+    ["AST_ERB_WHILE_NODE", isERBWhileNode],
+    ["AST_ERB_UNTIL_NODE", isERBUntilNode],
+    ["AST_ERB_FOR_NODE", isERBForNode],
+    ["AST_ERB_RESCUE_NODE", isERBRescueNode],
+    ["AST_ERB_ENSURE_NODE", isERBEnsureNode],
+    ["AST_ERB_BEGIN_NODE", isERBBeginNode],
+    ["AST_ERB_UNLESS_NODE", isERBUnlessNode],
+    ["AST_ERB_YIELD_NODE", isERBYieldNode],
+    ["AST_ERB_IN_NODE", isERBInNode],
+]);
+/**
+ * Checks if a node matches any of the provided type identifiers with proper type narrowing
+ * Supports AST type strings, node classes, or type guard functions
+ *
+ * @example
+ * if (isAnyOf(node, "AST_HTML_TEXT_NODE", "AST_LITERAL_NODE")) {
+ *   // node is narrowed to HTMLTextNode | LiteralNode
+ * }
+ *
+ * @example
+ * if (isAnyOf(node, HTMLTextNode, LiteralNode)) {
+ *   // node is narrowed to HTMLTextNode | LiteralNode
+ * }
+ */
+function isAnyOf(node, ...types) {
+    return types.some(type => {
+        if (typeof type === 'string') {
+            return isNode(node, type);
+        }
+        else if (typeof type === 'function' && type.prototype && type.prototype.constructor === type && NODE_TYPE_GUARDS.has(type)) {
+            return isNode(node, type);
+        }
+        else if (typeof type === 'function') {
+            return type(node);
+        }
+        else {
+            return false;
+        }
+    });
+}
+/**
+ * Checks if a node does NOT match any of the provided type identifiers
+ * Supports AST type strings, node classes, or type guard functions
+ * This is the logical inverse of isAnyOf
+ *
+ * @example
+ * if (isNoneOf(node, "AST_HTML_TEXT_NODE", "AST_LITERAL_NODE")) {
+ *   // node is neither HTMLTextNode nor LiteralNode
+ * }
+ *
+ * @example
+ * if (isNoneOf(node, HTMLTextNode, LiteralNode)) {
+ *   // node is neither HTMLTextNode nor LiteralNode
+ * }
+ *
+ * @example
+ * if (isNoneOf(node, isHTMLTextNode, isLiteralNode)) {
+ *   // node is neither HTMLTextNode nor LiteralNode
+ * }
+ */
+function isNoneOf(node, ...types) {
+    return !isAnyOf(node, ...types);
+}
+function areAllOfType(nodes, ...types) {
+    return nodes.every(node => isAnyOf(node, ...types));
+}
+function filterNodes(nodes, ...types) {
+    if (!nodes)
+        return [];
+    return nodes.filter(node => isAnyOf(node, ...types));
+}
+function isNode(node, type) {
+    if (!node)
+        return false;
+    if (typeof type === 'string') {
+        const guard = AST_TYPE_GUARDS.get(type);
+        return guard ? guard(node) : false;
+    }
+    else if (typeof type === 'function') {
+        const guard = NODE_TYPE_GUARDS.get(type);
+        return guard ? guard(node) : false;
+    }
+    else {
+        return false;
+    }
+}
+function isToken(object) {
+    return (object instanceof Token) || (object?.constructor?.name === "Token" && "value" in object) || object.type?.startsWith('TOKEN_');
+}
+function isParseResult(object) {
+    return (object instanceof ParseResult) || (object?.constructor?.name === "ParseResult" && "value" in object);
+}
+/**
+ * Checks if a node has children (contains other nodes)
+ */
+function hasChildren(node) {
+    return isDocumentNode(node) ||
+        isHTMLOpenTagNode(node) ||
+        isHTMLCloseTagNode(node) ||
+        isHTMLElementNode(node) ||
+        isHTMLAttributeValueNode(node) ||
+        isHTMLAttributeNameNode(node) ||
+        isHTMLCommentNode(node) ||
+        isHTMLDoctypeNode(node) ||
+        isERBElseNode(node) ||
+        isERBIfNode(node) ||
+        isERBBlockNode(node) ||
+        isERBWhenNode(node) ||
+        isERBCaseNode(node) ||
+        isERBCaseMatchNode(node) ||
+        isERBWhileNode(node) ||
+        isERBUntilNode(node) ||
+        isERBForNode(node) ||
+        isERBRescueNode(node) ||
+        isERBEnsureNode(node) ||
+        isERBBeginNode(node) ||
+        isERBUnlessNode(node) ||
+        isERBInNode(node);
+}
+/**
+ * Filter functions for extracting specific node types from arrays
+ */
+/**
+ * Filters an array of nodes to only include DocumentNode nodes
+ */
+function filterDocumentNodes(nodes) {
+    return nodes.filter(isDocumentNode);
+}
+/**
+ * Filters an array of nodes to only include LiteralNode nodes
+ */
+function filterLiteralNodes(nodes) {
+    return nodes.filter(isLiteralNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLOpenTagNode nodes
+ */
+function filterHTMLOpenTagNodes(nodes) {
+    return nodes.filter(isHTMLOpenTagNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLCloseTagNode nodes
+ */
+function filterHTMLCloseTagNodes(nodes) {
+    return nodes.filter(isHTMLCloseTagNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLElementNode nodes
+ */
+function filterHTMLElementNodes(nodes) {
+    return nodes.filter(isHTMLElementNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLAttributeValueNode nodes
+ */
+function filterHTMLAttributeValueNodes(nodes) {
+    return nodes.filter(isHTMLAttributeValueNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLAttributeNameNode nodes
+ */
+function filterHTMLAttributeNameNodes(nodes) {
+    return nodes.filter(isHTMLAttributeNameNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLAttributeNode nodes
+ */
+function filterHTMLAttributeNodes(nodes) {
+    return nodes.filter(isHTMLAttributeNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLTextNode nodes
+ */
+function filterHTMLTextNodes(nodes) {
+    return nodes.filter(isHTMLTextNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLCommentNode nodes
+ */
+function filterHTMLCommentNodes(nodes) {
+    return nodes.filter(isHTMLCommentNode);
+}
+/**
+ * Filters an array of nodes to only include HTMLDoctypeNode nodes
+ */
+function filterHTMLDoctypeNodes(nodes) {
+    return nodes.filter(isHTMLDoctypeNode);
+}
+/**
+ * Filters an array of nodes to only include XMLDeclarationNode nodes
+ */
+function filterXMLDeclarationNodes(nodes) {
+    return nodes.filter(isXMLDeclarationNode);
+}
+/**
+ * Filters an array of nodes to only include CDATANode nodes
+ */
+function filterCDATANodes(nodes) {
+    return nodes.filter(isCDATANode);
+}
+/**
+ * Filters an array of nodes to only include WhitespaceNode nodes
+ */
+function filterWhitespaceNodes(nodes) {
+    return nodes.filter(isWhitespaceNode);
+}
+/**
+ * Filters an array of nodes to only include ERBContentNode nodes
+ */
+function filterERBContentNodes(nodes) {
+    return nodes.filter(isERBContentNode);
+}
+/**
+ * Filters an array of nodes to only include ERBEndNode nodes
+ */
+function filterERBEndNodes(nodes) {
+    return nodes.filter(isERBEndNode);
+}
+/**
+ * Filters an array of nodes to only include ERBElseNode nodes
+ */
+function filterERBElseNodes(nodes) {
+    return nodes.filter(isERBElseNode);
+}
+/**
+ * Filters an array of nodes to only include ERBIfNode nodes
+ */
+function filterERBIfNodes(nodes) {
+    return nodes.filter(isERBIfNode);
+}
+/**
+ * Filters an array of nodes to only include ERBBlockNode nodes
+ */
+function filterERBBlockNodes(nodes) {
+    return nodes.filter(isERBBlockNode);
+}
+/**
+ * Filters an array of nodes to only include ERBWhenNode nodes
+ */
+function filterERBWhenNodes(nodes) {
+    return nodes.filter(isERBWhenNode);
+}
+/**
+ * Filters an array of nodes to only include ERBCaseNode nodes
+ */
+function filterERBCaseNodes(nodes) {
+    return nodes.filter(isERBCaseNode);
+}
+/**
+ * Filters an array of nodes to only include ERBCaseMatchNode nodes
+ */
+function filterERBCaseMatchNodes(nodes) {
+    return nodes.filter(isERBCaseMatchNode);
+}
+/**
+ * Filters an array of nodes to only include ERBWhileNode nodes
+ */
+function filterERBWhileNodes(nodes) {
+    return nodes.filter(isERBWhileNode);
+}
+/**
+ * Filters an array of nodes to only include ERBUntilNode nodes
+ */
+function filterERBUntilNodes(nodes) {
+    return nodes.filter(isERBUntilNode);
+}
+/**
+ * Filters an array of nodes to only include ERBForNode nodes
+ */
+function filterERBForNodes(nodes) {
+    return nodes.filter(isERBForNode);
+}
+/**
+ * Filters an array of nodes to only include ERBRescueNode nodes
+ */
+function filterERBRescueNodes(nodes) {
+    return nodes.filter(isERBRescueNode);
+}
+/**
+ * Filters an array of nodes to only include ERBEnsureNode nodes
+ */
+function filterERBEnsureNodes(nodes) {
+    return nodes.filter(isERBEnsureNode);
+}
+/**
+ * Filters an array of nodes to only include ERBBeginNode nodes
+ */
+function filterERBBeginNodes(nodes) {
+    return nodes.filter(isERBBeginNode);
+}
+/**
+ * Filters an array of nodes to only include ERBUnlessNode nodes
+ */
+function filterERBUnlessNodes(nodes) {
+    return nodes.filter(isERBUnlessNode);
+}
+/**
+ * Filters an array of nodes to only include ERBYieldNode nodes
+ */
+function filterERBYieldNodes(nodes) {
+    return nodes.filter(isERBYieldNode);
+}
+/**
+ * Filters an array of nodes to only include ERBInNode nodes
+ */
+function filterERBInNodes(nodes) {
+    return nodes.filter(isERBInNode);
+}
+
+/**
+ * Checks if a node is an ERB output node (generates content: <%= %> or <%== %>)
+ */
+function isERBOutputNode(node) {
+    return isNode(node, ERBContentNode) && ["<%=", "<%=="].includes(node.tag_opening?.value);
+}
+/**
+ * Checks if a node is a non-output ERB node (control flow: <% %>)
+ */
+function isERBControlFlowNode(node) {
+    return isAnyOf(node, ERBIfNode, ERBUnlessNode, ERBBlockNode, ERBCaseNode, ERBCaseMatchNode, ERBWhileNode, ERBForNode, ERBBeginNode);
+}
+/**
+ * Checks if an array of nodes contains any ERB content nodes
+ */
+function hasERBContent(nodes) {
+    return nodes.some(isERBContentNode);
+}
+/**
+ * Checks if an array of nodes contains any ERB output nodes (dynamic content)
+ */
+function hasERBOutput(nodes) {
+    return nodes.some(isERBOutputNode);
+}
+/**
+ * Extracts a static string from an array of literal nodes
+ * Returns null if any node is not a literal node
+ */
+function getStaticStringFromNodes(nodes) {
+    if (!areAllOfType(nodes, LiteralNode)) {
+        return null;
+    }
+    return nodes.map(node => node.content).join("");
+}
+/**
+ * Extracts static content from nodes, including mixed literal/ERB content
+ * Returns the concatenated literal content, or null if no literal nodes exist
+ */
+function getStaticContentFromNodes(nodes) {
+    const literalNodes = filterLiteralNodes(nodes);
+    if (literalNodes.length === 0) {
+        return null;
+    }
+    return literalNodes.map(node => node.content).join("");
+}
+/**
+ * Checks if nodes contain any literal content (for static validation)
+ */
+function hasStaticContent(nodes) {
+    return nodes.some(isLiteralNode);
+}
+/**
+ * Checks if nodes are effectively static (only literals and non-output ERB)
+ * Non-output ERB like <% if %> doesn't affect static validation
+ */
+function isEffectivelyStatic(nodes) {
+    return !hasERBOutput(nodes);
+}
+/**
+ * Gets static-validatable content from nodes (ignores control ERB, includes literals)
+ * Returns concatenated literal content for validation, or null if contains output ERB
+ */
+function getValidatableStaticContent(nodes) {
+    if (hasERBOutput(nodes)) {
+        return null;
+    }
+    return filterLiteralNodes(nodes).map(node => node.content).join("");
+}
+/**
+ * Extracts a combined string from nodes, including ERB content
+ * For ERB nodes, includes the full tag syntax (e.g., "<%= foo %>")
+ * This is useful for debugging or displaying the full attribute name
+ */
+function getCombinedStringFromNodes(nodes) {
+    return nodes.map(node => {
+        if (isLiteralNode(node)) {
+            return node.content;
+        }
+        else if (isERBContentNode(node)) {
+            const opening = node.tag_opening?.value || "";
+            const content = node.content?.value || "";
+            const closing = node.tag_closing?.value || "";
+            return `${opening}${content}${closing}`;
+        }
+        else {
+            // For other node types, return a placeholder or empty string
+            return `[${node.type}]`;
+        }
+    }).join("");
+}
+/**
+ * Checks if an HTML attribute name node has a static (literal-only) name
+ */
+function hasStaticAttributeName(attributeNameNode) {
+    if (!attributeNameNode.children) {
+        return false;
+    }
+    return areAllOfType(attributeNameNode.children, LiteralNode);
+}
+/**
+ * Checks if an HTML attribute name node has dynamic content (contains ERB)
+ */
+function hasDynamicAttributeName(attributeNameNode) {
+    if (!attributeNameNode.children) {
+        return false;
+    }
+    return hasERBContent(attributeNameNode.children);
+}
+/**
+ * Gets the static string value of an HTML attribute name node
+ * Returns null if the attribute name contains dynamic content (ERB)
+ */
+function getStaticAttributeName(attributeNameNode) {
+    if (!attributeNameNode.children) {
+        return null;
+    }
+    return getStaticStringFromNodes(attributeNameNode.children);
+}
+/**
+ * Gets the combined string representation of an HTML attribute name node
+ * This includes both static and dynamic content, useful for debugging
+ */
+function getCombinedAttributeName(attributeNameNode) {
+    if (!attributeNameNode.children) {
+        return "";
+    }
+    return getCombinedStringFromNodes(attributeNameNode.children);
+}
+/**
+ * Gets the tag name of an HTML element node
+ */
+function getTagName(node) {
+    return node.tag_name?.value ?? "";
+}
+/**
+ * Check if a node is a comment (HTML comment or ERB comment)
+ */
+function isCommentNode(node) {
+    return isNode(node, HTMLCommentNode) || (isERBNode(node) && !isERBControlFlowNode(node));
+}
+/**
+ * Compares two positions to determine if the first comes before the second
+ * Returns true if pos1 comes before pos2 in source order
+ * @param inclusive - If true, returns true when positions are equal
+ */
+function isPositionBefore(position1, position2, inclusive = false) {
+    if (position1.line < position2.line)
+        return true;
+    if (position1.line > position2.line)
+        return false;
+    return inclusive ? position1.column <= position2.column : position1.column < position2.column;
+}
+/**
+ * Compares two positions to determine if they are equal
+ * Returns true if pos1 and pos2 are at the same location
+ */
+function isPositionEqual(position1, position2) {
+    return position1.line === position2.line && position1.column === position2.column;
+}
+/**
+ * Compares two positions to determine if the first comes after the second
+ * Returns true if pos1 comes after pos2 in source order
+ * @param inclusive - If true, returns true when positions are equal
+ */
+function isPositionAfter(position1, position2, inclusive = false) {
+    if (position1.line > position2.line)
+        return true;
+    if (position1.line < position2.line)
+        return false;
+    return inclusive ? position1.column >= position2.column : position1.column > position2.column;
+}
+/**
+ * Gets nodes that appear before the specified location in source order
+ * Uses line and column positions to determine ordering
+ */
+function getNodesBeforeLocation(nodes, location) {
+    return nodes.filter(node => node.location && isPositionBefore(node.location.end, location.start));
+}
+/**
+ * Gets nodes that appear after the specified location in source order
+ * Uses line and column positions to determine ordering
+ */
+function getNodesAfterLocation(nodes, location) {
+    return nodes.filter(node => node.location && isPositionAfter(node.location.start, location.end));
+}
+/**
+ * Splits nodes into before and after the specified location
+ * Returns an object with `before` and `after` arrays
+ */
+function splitNodesAroundLocation(nodes, location) {
+    return {
+        before: getNodesBeforeLocation(nodes, location),
+        after: getNodesAfterLocation(nodes, location)
+    };
+}
+/**
+ * Splits nodes at a specific position
+ * Returns nodes that end before the position and nodes that start after the position
+ * More precise than splitNodesAroundLocation as it uses a single position point
+ * Uses the same defaults as the individual functions: before=exclusive, after=inclusive
+ */
+function splitNodesAroundPosition(nodes, position) {
+    return {
+        before: getNodesBeforePosition(nodes, position), // uses default: inclusive = false
+        after: getNodesAfterPosition(nodes, position) // uses default: inclusive = true
+    };
+}
+/**
+ * Gets nodes that end before the specified position
+ * @param inclusive - If true, includes nodes that end exactly at the position (default: false, matching half-open interval semantics)
+ */
+function getNodesBeforePosition(nodes, position, inclusive = false) {
+    return nodes.filter(node => node.location && isPositionBefore(node.location.end, position, inclusive));
+}
+/**
+ * Gets nodes that start after the specified position
+ * @param inclusive - If true, includes nodes that start exactly at the position (default: true, matching typical boundary behavior)
+ */
+function getNodesAfterPosition(nodes, position, inclusive = true) {
+    return nodes.filter(node => node.location && isPositionAfter(node.location.start, position, inclusive));
+}
+
+const expectedFunctions = [
+    "parse",
+    "lex",
+    "parseFile",
+    "lexFile",
+    "extractRuby",
+    "extractHTML",
+    "version",
+];
+// NOTE: This function should never be called and is only for type checking
+// so we can make sure `expectedFunctions` matches the functions defined
+// in `LibHerbBackendFunctions` and the other way around.
+//
+function _TYPECHECK() {
+    const checkFunctionsExist = true;
+    const checkInterfaceComplete = true;
+    return { checkFunctionsExist, checkInterfaceComplete };
+}
+function isLibHerbBackend(object, libherbpath = "unknown") {
+    for (const expectedFunction of expectedFunctions) {
+        if (object[expectedFunction] === undefined) {
+            throw new Error(`Libherb at "${libherbpath}" doesn't expose function "${expectedFunction}".`);
+        }
+        if (typeof object[expectedFunction] !== "function") {
+            throw new Error(`Libherb at "${libherbpath}" has "${expectedFunction}" but it's not a function.`);
+        }
+    }
+    return true;
+}
+function ensureLibHerbBackend(object, libherbpath = "unknown") {
+    isLibHerbBackend(object, libherbpath);
+    return object;
+}
+
+/**
+ * Converts a Diagnostic to Monaco/VSCode-compatible MonacoDiagnostic format
+ */
+function toMonacoDiagnostic(diagnostic) {
+    const { message, location } = diagnostic;
+    const severity = diagnostic.severity === "hint" ? "info" : diagnostic.severity;
+    return {
+        line: location.start.line,
+        column: location.start.column,
+        endLine: location.end.line,
+        endColumn: location.end.column,
+        message,
+        severity
+    };
+}
+
+var name = "@herb-tools/core";
+var version = "0.6.1";
+var packageJSON = {
+	name: name,
+	version: version};
+
+class TokenList {
+    list;
+    static from(list) {
+        return new TokenList(list.map((token) => Token.from(token)));
+    }
+    constructor(list) {
+        this.list = list;
+    }
+    get length() {
+        return this.list.length;
+    }
+    get tokens() {
+        return this.list;
+    }
+    [Symbol.iterator]() {
+        return this.list[Symbol.iterator]();
+    }
+    at(index) {
+        return this.list.at(index);
+    }
+    forEach(callback) {
+        this.list.forEach(callback);
+    }
+    map(callback) {
+        return this.list.map(callback);
+    }
+    filter(predicate) {
+        return this.list.filter(predicate);
+    }
+    __getobj__() {
+        return this.list;
+    }
+    inspect() {
+        return this.list.map((token) => token.inspect()).join("\n") + "\n";
+    }
+    toString() {
+        return this.inspect();
+    }
+}
+
+/**
+ * Represents the result of a lexical analysis, extending the base `Result` class.
+ * It contains the token list, source code, warnings, and errors.
+ */
+class LexResult extends Result {
+    /** The list of tokens generated from the source code. */
+    value;
+    /**
+     * Creates a `LexResult` instance from a serialized result.
+     * @param result - The serialized lexical result containing tokens, source, warnings, and errors.
+     * @returns A new `LexResult` instance.
+     */
+    static from(result) {
+        return new LexResult(TokenList.from(result.tokens || []), result.source, result.warnings.map((warning) => HerbWarning.from(warning)), result.errors.map((error) => HerbError.from(error)));
+    }
+    /**
+     * Constructs a new `LexResult`.
+     * @param value - The list of tokens.
+     * @param source - The source code that was lexed.
+     * @param warnings - An array of warnings encountered during lexing.
+     * @param errors - An array of errors encountered during lexing.
+     */
+    constructor(value, source, warnings = [], errors = []) {
+        super(source, warnings, errors);
+        this.value = value;
+    }
+    /**
+     * Determines if the lexing was successful.
+     * @returns `true` if there are no errors, otherwise `false`.
+     */
+    get successful() {
+        return this.errors.length === 0;
+    }
+    /**
+     * Determines if the lexing failed.
+     * @returns `true` if there are errors, otherwise `false`.
+     */
+    get failed() {
+        return this.errors.length > 0;
+    }
+    /**
+     * Converts the `LexResult` to a JSON representation.
+     * @returns An object containing the token list, source, warnings, and errors.
+     */
+    toJSON() {
+        return {
+            value: this.value,
+            source: this.source,
+            warnings: this.warnings,
+            errors: this.errors,
+        };
+    }
+}
+
+const DEFAULT_PARSER_OPTIONS = {
+    track_whitespace: false,
+};
+
+/**
+ * The main Herb parser interface, providing methods to lex and parse input.
+ */
+class HerbBackend {
+    /** The backend instance handling lexing and parsing. */
+    backend = undefined;
+    backendPromise;
+    /**
+     * Creates a new Herb instance.
+     * @param backendPromise - A promise resolving to a `LibHerbBackend` implementation for lexing and parsing.
+     * @throws Error if no valid backend is provided.
+     */
+    constructor(backendPromise) {
+        if (!backendPromise) {
+            throw new Error("No LibHerb backend provided");
+        }
+        this.backendPromise = backendPromise;
     }
     /**
      * Loads the backend by resolving the backend promise.
@@ -2906,12 +3877,14 @@ class HerbBackend {
     /**
      * Parses the given source string into a `ParseResult`.
      * @param source - The source code to parse.
+     * @param options - Optional parsing options.
      * @returns A `ParseResult` instance.
      * @throws Error if the backend is not loaded.
      */
-    parse(source) {
+    parse(source, options) {
         this.ensureBackend();
-        return ParseResult.from(this.backend.parse(ensureString(source)));
+        const mergedOptions = { ...DEFAULT_PARSER_OPTIONS, ...options };
+        return ParseResult.from(this.backend.parse(ensureString(source), mergedOptions));
     }
     /**
      * Parses a file.
@@ -2974,7 +3947,7 @@ class HerbBackend {
 }
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-0.5.0/templates/javascript/packages/core/src/visitor.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.6.1/templates/javascript/packages/core/src/visitor.ts.erb
 class Visitor {
     visit(node) {
         if (!node)
@@ -2999,9 +3972,6 @@ class Visitor {
     visitHTMLCloseTagNode(node) {
         this.visitChildNodes(node);
     }
-    visitHTMLSelfCloseTagNode(node) {
-        this.visitChildNodes(node);
-    }
     visitHTMLElementNode(node) {
         this.visitChildNodes(node);
     }
@@ -3023,6 +3993,12 @@ class Visitor {
     visitHTMLDoctypeNode(node) {
         this.visitChildNodes(node);
     }
+    visitXMLDeclarationNode(node) {
+        this.visitChildNodes(node);
+    }
+    visitCDATANode(node) {
+        this.visitChildNodes(node);
+    }
     visitWhitespaceNode(node) {
         this.visitChildNodes(node);
     }
@@ -3079,5 +4055,5 @@ class Visitor {
     }
 }
 
-export { DocumentNode, ERBBeginNode, ERBBlockNode, ERBCaseMatchNode, ERBCaseNode, ERBContentNode, ERBElseNode, ERBEndNode, ERBEnsureNode, ERBForNode, ERBIfNode, ERBInNode, ERBNodeClasses, ERBRescueNode, ERBUnlessNode, ERBUntilNode, ERBWhenNode, ERBWhileNode, ERBYieldNode, HTMLAttributeNameNode, HTMLAttributeNode, HTMLAttributeValueNode, HTMLCloseTagNode, HTMLCommentNode, HTMLDoctypeNode, HTMLElementNode, HTMLOpenTagNode, HTMLSelfCloseTagNode, HTMLTextNode, HerbBackend, HerbError, HerbWarning, LexResult, LiteralNode, Location, MissingClosingTagError, MissingOpeningTagError, Node, ParseResult, Position, QuotesMismatchError, Range, Result, RubyParseError, TagNamesMismatchError, Token, TokenList, UnclosedElementError, UnexpectedError, UnexpectedTokenError, Visitor, VoidElementClosingTagError, WhitespaceNode, _TYPECHECK, convertToUTF8, ensureLibHerbBackend, ensureString, fromSerializedError, fromSerializedNode, isERBNode, isLibHerbBackend, toMonacoDiagnostic };
+export { AST_TYPE_GUARDS, CDATANode, DEFAULT_PARSER_OPTIONS, DocumentNode, ERBBeginNode, ERBBlockNode, ERBCaseMatchNode, ERBCaseNode, ERBContentNode, ERBElseNode, ERBEndNode, ERBEnsureNode, ERBForNode, ERBIfNode, ERBInNode, ERBNodeClasses, ERBRescueNode, ERBUnlessNode, ERBUntilNode, ERBWhenNode, ERBWhileNode, ERBYieldNode, HTMLAttributeNameNode, HTMLAttributeNode, HTMLAttributeValueNode, HTMLCloseTagNode, HTMLCommentNode, HTMLDoctypeNode, HTMLElementNode, HTMLOpenTagNode, HTMLTextNode, HerbBackend, HerbError, HerbWarning, LexResult, LiteralNode, Location, MissingClosingTagError, MissingOpeningTagError, NODE_TYPE_GUARDS, Node, ParseResult, Position, QuotesMismatchError, Range, Result, RubyParseError, TagNamesMismatchError, Token, TokenList, UnclosedElementError, UnexpectedError, UnexpectedTokenError, Visitor, VoidElementClosingTagError, WhitespaceNode, XMLDeclarationNode, _TYPECHECK, areAllOfType, convertToUTF8, ensureLibHerbBackend, ensureString, filterCDATANodes, filterDocumentNodes, filterERBBeginNodes, filterERBBlockNodes, filterERBCaseMatchNodes, filterERBCaseNodes, filterERBContentNodes, filterERBElseNodes, filterERBEndNodes, filterERBEnsureNodes, filterERBForNodes, filterERBIfNodes, filterERBInNodes, filterERBRescueNodes, filterERBUnlessNodes, filterERBUntilNodes, filterERBWhenNodes, filterERBWhileNodes, filterERBYieldNodes, filterHTMLAttributeNameNodes, filterHTMLAttributeNodes, filterHTMLAttributeValueNodes, filterHTMLCloseTagNodes, filterHTMLCommentNodes, filterHTMLDoctypeNodes, filterHTMLElementNodes, filterHTMLOpenTagNodes, filterHTMLTextNodes, filterLiteralNodes, filterNodes, filterWhitespaceNodes, filterXMLDeclarationNodes, fromSerializedError, fromSerializedNode, getCombinedAttributeName, getCombinedStringFromNodes, getNodesAfterLocation, getNodesAfterPosition, getNodesBeforeLocation, getNodesBeforePosition, getStaticAttributeName, getStaticContentFromNodes, getStaticStringFromNodes, getTagName, getValidatableStaticContent, hasChildren, hasDynamicAttributeName, hasERBContent, hasERBOutput, hasStaticAttributeName, hasStaticContent, isAnyOf, isCDATANode, isCommentNode, isDocumentNode, isERBBeginNode, isERBBlockNode, isERBCaseMatchNode, isERBCaseNode, isERBContentNode, isERBControlFlowNode, isERBElseNode, isERBEndNode, isERBEnsureNode, isERBForNode, isERBIfNode, isERBInNode, isERBNode, isERBOutputNode, isERBRescueNode, isERBUnlessNode, isERBUntilNode, isERBWhenNode, isERBWhileNode, isERBYieldNode, isEffectivelyStatic, isHTMLAttributeNameNode, isHTMLAttributeNode, isHTMLAttributeValueNode, isHTMLCloseTagNode, isHTMLCommentNode, isHTMLDoctypeNode, isHTMLElementNode, isHTMLNode, isHTMLOpenTagNode, isHTMLTextNode, isLibHerbBackend, isLiteralNode, isNode, isNoneOf, isParseResult, isPositionAfter, isPositionEqual, isToken, isWhitespaceNode, isXMLDeclarationNode, splitNodesAroundLocation, splitNodesAroundPosition, toMonacoDiagnostic };
 //# sourceMappingURL=herb-core.esm.js.map