@herb-tools/core 0.5.0 → 0.6.1

package/dist/herb-core.umd.js

@@ -4,56 +4,6 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.Herb = {}));
 })(this, (function (exports) { 'use strict';
 
-    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;
@@ -185,7 +135,7 @@
     }
 
     // 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;
@@ -626,12 +576,6 @@
         }
     }
 
-    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;
@@ -647,139 +591,8 @@
         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;
@@ -787,6 +600,9 @@
         static from(node) {
             return fromSerializedNode(node);
         }
+        static get type() {
+            throw new Error("AST_NODE");
+        }
         constructor(type, location, errors) {
             this.type = type;
             this.location = location;
@@ -802,6 +618,12 @@
         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;
         }
@@ -843,6 +665,9 @@
     }
     class DocumentNode extends Node {
         children;
+        static get type() {
+            return "AST_DOCUMENT_NODE";
+        }
         static from(data) {
             return new DocumentNode({
                 type: data.type,
@@ -884,12 +709,14 @@
             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,
@@ -928,7 +755,6 @@
             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;
         }
     }
@@ -938,6 +764,9 @@
         tag_closing;
         children;
         is_void;
+        static get type() {
+            return "AST_HTML_OPEN_TAG_NODE";
+        }
         static from(data) {
             return new HTMLOpenTagNode({
                 type: data.type,
@@ -995,14 +824,17 @@
             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,
@@ -1010,6 +842,7 @@
                 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,
             });
         }
@@ -1017,13 +850,16 @@
             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);
@@ -1031,6 +867,7 @@
         recursiveErrors() {
             return [
                 ...this.errors,
+                ...this.children.map(node => node.recursiveErrors()),
             ].flat();
         }
         toJSON() {
@@ -1039,6 +876,7 @@
                 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,
             };
         }
@@ -1048,43 +886,48 @@
             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() {
@@ -1093,111 +936,44 @@
         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)),
@@ -1249,29 +1025,33 @@
             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);
@@ -1279,21 +1059,21 @@
         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;
         }
     }
@@ -1301,14 +1081,17 @@
         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) {
@@ -1352,12 +1135,14 @@
             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,
@@ -1396,7 +1181,6 @@
             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;
         }
     }
@@ -1404,6 +1188,9 @@
         comment_start;
         children;
         comment_end;
+        static get type() {
+            return "AST_HTML_COMMENT_NODE";
+        }
         static from(data) {
             return new HTMLCommentNode({
                 type: data.type,
@@ -1453,7 +1240,6 @@
             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;
         }
     }
@@ -1461,6 +1247,9 @@
         tag_opening;
         children;
         tag_closing;
+        static get type() {
+            return "AST_HTML_DOCTYPE_NODE";
+        }
         static from(data) {
             return new HTMLDoctypeNode({
                 type: data.type,
@@ -1510,12 +1299,132 @@
             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,
@@ -1554,7 +1463,6 @@
             output += `@ WhitespaceNode ${this.location.treeInspectWithLabel()}\n`;
             output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
             output += `└── value: ${this.value ? this.value.treeInspect() : "∅"}\n`;
-            // output += "\n";
             return output;
         }
     }
@@ -1565,6 +1473,9 @@
         // no-op for analyzed_ruby
         parsed;
         valid;
+        static get type() {
+            return "AST_ERB_CONTENT_NODE";
+        }
         static from(data) {
             return new ERBContentNode({
                 type: data.type,
@@ -1623,7 +1534,6 @@
             // 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;
         }
     }
@@ -1631,6 +1541,9 @@
         tag_opening;
         content;
         tag_closing;
+        static get type() {
+            return "AST_ERB_END_NODE";
+        }
         static from(data) {
             return new ERBEndNode({
                 type: data.type,
@@ -1677,7 +1590,6 @@
             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;
         }
     }
@@ -1686,6 +1598,9 @@
         content;
         tag_closing;
         statements;
+        static get type() {
+            return "AST_ERB_ELSE_NODE";
+        }
         static from(data) {
             return new ERBElseNode({
                 type: data.type,
@@ -1739,7 +1654,6 @@
             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;
         }
     }
@@ -1750,6 +1664,9 @@
         statements;
         subsequent;
         end_node;
+        static get type() {
+            return "AST_ERB_IF_NODE";
+        }
         static from(data) {
             return new ERBIfNode({
                 type: data.type,
@@ -1759,8 +1676,8 @@
                 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) {
@@ -1815,7 +1732,6 @@
             output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
             output += `├── subsequent: ${this.inspectNode(this.subsequent, "│   ")}`;
             output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-            // output += "\n";
             return output;
         }
     }
@@ -1825,6 +1741,9 @@
         tag_closing;
         body;
         end_node;
+        static get type() {
+            return "AST_ERB_BLOCK_NODE";
+        }
         static from(data) {
             return new ERBBlockNode({
                 type: data.type,
@@ -1834,7 +1753,7 @@
                 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) {
@@ -1884,7 +1803,6 @@
             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;
         }
     }
@@ -1893,6 +1811,9 @@
         content;
         tag_closing;
         statements;
+        static get type() {
+            return "AST_ERB_WHEN_NODE";
+        }
         static from(data) {
             return new ERBWhenNode({
                 type: data.type,
@@ -1946,7 +1867,6 @@
             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;
         }
     }
@@ -1958,6 +1878,9 @@
         conditions;
         else_clause;
         end_node;
+        static get type() {
+            return "AST_ERB_CASE_NODE";
+        }
         static from(data) {
             return new ERBCaseNode({
                 type: data.type,
@@ -1968,8 +1891,8 @@
                 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) {
@@ -2029,7 +1952,6 @@
             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;
         }
     }
@@ -2041,6 +1963,9 @@
         conditions;
         else_clause;
         end_node;
+        static get type() {
+            return "AST_ERB_CASE_MATCH_NODE";
+        }
         static from(data) {
             return new ERBCaseMatchNode({
                 type: data.type,
@@ -2051,8 +1976,8 @@
                 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) {
@@ -2112,7 +2037,6 @@
             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;
         }
     }
@@ -2122,6 +2046,9 @@
         tag_closing;
         statements;
         end_node;
+        static get type() {
+            return "AST_ERB_WHILE_NODE";
+        }
         static from(data) {
             return new ERBWhileNode({
                 type: data.type,
@@ -2131,7 +2058,7 @@
                 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) {
@@ -2181,7 +2108,6 @@
             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;
         }
     }
@@ -2191,6 +2117,9 @@
         tag_closing;
         statements;
         end_node;
+        static get type() {
+            return "AST_ERB_UNTIL_NODE";
+        }
         static from(data) {
             return new ERBUntilNode({
                 type: data.type,
@@ -2200,7 +2129,7 @@
                 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) {
@@ -2250,7 +2179,6 @@
             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;
         }
     }
@@ -2260,6 +2188,9 @@
         tag_closing;
         statements;
         end_node;
+        static get type() {
+            return "AST_ERB_FOR_NODE";
+        }
         static from(data) {
             return new ERBForNode({
                 type: data.type,
@@ -2269,7 +2200,7 @@
                 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) {
@@ -2319,7 +2250,6 @@
             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;
         }
     }
@@ -2329,6 +2259,9 @@
         tag_closing;
         statements;
         subsequent;
+        static get type() {
+            return "AST_ERB_RESCUE_NODE";
+        }
         static from(data) {
             return new ERBRescueNode({
                 type: data.type,
@@ -2338,7 +2271,7 @@
                 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) {
@@ -2388,7 +2321,6 @@
             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;
         }
     }
@@ -2397,6 +2329,9 @@
         content;
         tag_closing;
         statements;
+        static get type() {
+            return "AST_ERB_ENSURE_NODE";
+        }
         static from(data) {
             return new ERBEnsureNode({
                 type: data.type,
@@ -2450,7 +2385,6 @@
             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;
         }
     }
@@ -2463,6 +2397,9 @@
         else_clause;
         ensure_clause;
         end_node;
+        static get type() {
+            return "AST_ERB_BEGIN_NODE";
+        }
         static from(data) {
             return new ERBBeginNode({
                 type: data.type,
@@ -2472,10 +2409,10 @@
                 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) {
@@ -2540,7 +2477,6 @@
             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;
         }
     }
@@ -2551,6 +2487,9 @@
         statements;
         else_clause;
         end_node;
+        static get type() {
+            return "AST_ERB_UNLESS_NODE";
+        }
         static from(data) {
             return new ERBUnlessNode({
                 type: data.type,
@@ -2560,8 +2499,8 @@
                 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) {
@@ -2616,7 +2555,6 @@
             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;
         }
     }
@@ -2624,6 +2562,9 @@
         tag_opening;
         content;
         tag_closing;
+        static get type() {
+            return "AST_ERB_YIELD_NODE";
+        }
         static from(data) {
             return new ERBYieldNode({
                 type: data.type,
@@ -2670,7 +2611,6 @@
             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;
         }
     }
@@ -2679,6 +2619,9 @@
         content;
         tag_closing;
         statements;
+        static get type() {
+            return "AST_ERB_IN_NODE";
+        }
         static from(data) {
             return new ERBInNode({
                 type: data.type,
@@ -2732,7 +2675,6 @@
             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;
         }
     }
@@ -2742,7 +2684,6 @@
             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);
@@ -2750,6 +2691,8 @@
             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);
@@ -2791,8 +2734,42 @@
         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;
+        }
     }
 
     /**
@@ -2862,23 +2839,1017 @@
         }
     }
 
+    // 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.
@@ -2912,12 +3883,14 @@
         /**
          * 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.
@@ -2980,7 +3953,7 @@
     }
 
     // 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)
@@ -3005,9 +3978,6 @@
         visitHTMLCloseTagNode(node) {
             this.visitChildNodes(node);
         }
-        visitHTMLSelfCloseTagNode(node) {
-            this.visitChildNodes(node);
-        }
         visitHTMLElementNode(node) {
             this.visitChildNodes(node);
         }
@@ -3029,6 +3999,12 @@
         visitHTMLDoctypeNode(node) {
             this.visitChildNodes(node);
         }
+        visitXMLDeclarationNode(node) {
+            this.visitChildNodes(node);
+        }
+        visitCDATANode(node) {
+            this.visitChildNodes(node);
+        }
         visitWhitespaceNode(node) {
             this.visitChildNodes(node);
         }
@@ -3085,6 +4061,9 @@
         }
     }
 
+    exports.AST_TYPE_GUARDS = AST_TYPE_GUARDS;
+    exports.CDATANode = CDATANode;
+    exports.DEFAULT_PARSER_OPTIONS = DEFAULT_PARSER_OPTIONS;
     exports.DocumentNode = DocumentNode;
     exports.ERBBeginNode = ERBBeginNode;
     exports.ERBBlockNode = ERBBlockNode;
@@ -3112,7 +4091,6 @@
     exports.HTMLDoctypeNode = HTMLDoctypeNode;
     exports.HTMLElementNode = HTMLElementNode;
     exports.HTMLOpenTagNode = HTMLOpenTagNode;
-    exports.HTMLSelfCloseTagNode = HTMLSelfCloseTagNode;
     exports.HTMLTextNode = HTMLTextNode;
     exports.HerbBackend = HerbBackend;
     exports.HerbError = HerbError;
@@ -3122,6 +4100,7 @@
     exports.Location = Location;
     exports.MissingClosingTagError = MissingClosingTagError;
     exports.MissingOpeningTagError = MissingOpeningTagError;
+    exports.NODE_TYPE_GUARDS = NODE_TYPE_GUARDS;
     exports.Node = Node;
     exports.ParseResult = ParseResult;
     exports.Position = Position;
@@ -3138,14 +4117,110 @@
     exports.Visitor = Visitor;
     exports.VoidElementClosingTagError = VoidElementClosingTagError;
     exports.WhitespaceNode = WhitespaceNode;
+    exports.XMLDeclarationNode = XMLDeclarationNode;
     exports._TYPECHECK = _TYPECHECK;
+    exports.areAllOfType = areAllOfType;
     exports.convertToUTF8 = convertToUTF8;
     exports.ensureLibHerbBackend = ensureLibHerbBackend;
     exports.ensureString = ensureString;
+    exports.filterCDATANodes = filterCDATANodes;
+    exports.filterDocumentNodes = filterDocumentNodes;
+    exports.filterERBBeginNodes = filterERBBeginNodes;
+    exports.filterERBBlockNodes = filterERBBlockNodes;
+    exports.filterERBCaseMatchNodes = filterERBCaseMatchNodes;
+    exports.filterERBCaseNodes = filterERBCaseNodes;
+    exports.filterERBContentNodes = filterERBContentNodes;
+    exports.filterERBElseNodes = filterERBElseNodes;
+    exports.filterERBEndNodes = filterERBEndNodes;
+    exports.filterERBEnsureNodes = filterERBEnsureNodes;
+    exports.filterERBForNodes = filterERBForNodes;
+    exports.filterERBIfNodes = filterERBIfNodes;
+    exports.filterERBInNodes = filterERBInNodes;
+    exports.filterERBRescueNodes = filterERBRescueNodes;
+    exports.filterERBUnlessNodes = filterERBUnlessNodes;
+    exports.filterERBUntilNodes = filterERBUntilNodes;
+    exports.filterERBWhenNodes = filterERBWhenNodes;
+    exports.filterERBWhileNodes = filterERBWhileNodes;
+    exports.filterERBYieldNodes = filterERBYieldNodes;
+    exports.filterHTMLAttributeNameNodes = filterHTMLAttributeNameNodes;
+    exports.filterHTMLAttributeNodes = filterHTMLAttributeNodes;
+    exports.filterHTMLAttributeValueNodes = filterHTMLAttributeValueNodes;
+    exports.filterHTMLCloseTagNodes = filterHTMLCloseTagNodes;
+    exports.filterHTMLCommentNodes = filterHTMLCommentNodes;
+    exports.filterHTMLDoctypeNodes = filterHTMLDoctypeNodes;
+    exports.filterHTMLElementNodes = filterHTMLElementNodes;
+    exports.filterHTMLOpenTagNodes = filterHTMLOpenTagNodes;
+    exports.filterHTMLTextNodes = filterHTMLTextNodes;
+    exports.filterLiteralNodes = filterLiteralNodes;
+    exports.filterNodes = filterNodes;
+    exports.filterWhitespaceNodes = filterWhitespaceNodes;
+    exports.filterXMLDeclarationNodes = filterXMLDeclarationNodes;
     exports.fromSerializedError = fromSerializedError;
     exports.fromSerializedNode = fromSerializedNode;
+    exports.getCombinedAttributeName = getCombinedAttributeName;
+    exports.getCombinedStringFromNodes = getCombinedStringFromNodes;
+    exports.getNodesAfterLocation = getNodesAfterLocation;
+    exports.getNodesAfterPosition = getNodesAfterPosition;
+    exports.getNodesBeforeLocation = getNodesBeforeLocation;
+    exports.getNodesBeforePosition = getNodesBeforePosition;
+    exports.getStaticAttributeName = getStaticAttributeName;
+    exports.getStaticContentFromNodes = getStaticContentFromNodes;
+    exports.getStaticStringFromNodes = getStaticStringFromNodes;
+    exports.getTagName = getTagName;
+    exports.getValidatableStaticContent = getValidatableStaticContent;
+    exports.hasChildren = hasChildren;
+    exports.hasDynamicAttributeName = hasDynamicAttributeName;
+    exports.hasERBContent = hasERBContent;
+    exports.hasERBOutput = hasERBOutput;
+    exports.hasStaticAttributeName = hasStaticAttributeName;
+    exports.hasStaticContent = hasStaticContent;
+    exports.isAnyOf = isAnyOf;
+    exports.isCDATANode = isCDATANode;
+    exports.isCommentNode = isCommentNode;
+    exports.isDocumentNode = isDocumentNode;
+    exports.isERBBeginNode = isERBBeginNode;
+    exports.isERBBlockNode = isERBBlockNode;
+    exports.isERBCaseMatchNode = isERBCaseMatchNode;
+    exports.isERBCaseNode = isERBCaseNode;
+    exports.isERBContentNode = isERBContentNode;
+    exports.isERBControlFlowNode = isERBControlFlowNode;
+    exports.isERBElseNode = isERBElseNode;
+    exports.isERBEndNode = isERBEndNode;
+    exports.isERBEnsureNode = isERBEnsureNode;
+    exports.isERBForNode = isERBForNode;
+    exports.isERBIfNode = isERBIfNode;
+    exports.isERBInNode = isERBInNode;
     exports.isERBNode = isERBNode;
+    exports.isERBOutputNode = isERBOutputNode;
+    exports.isERBRescueNode = isERBRescueNode;
+    exports.isERBUnlessNode = isERBUnlessNode;
+    exports.isERBUntilNode = isERBUntilNode;
+    exports.isERBWhenNode = isERBWhenNode;
+    exports.isERBWhileNode = isERBWhileNode;
+    exports.isERBYieldNode = isERBYieldNode;
+    exports.isEffectivelyStatic = isEffectivelyStatic;
+    exports.isHTMLAttributeNameNode = isHTMLAttributeNameNode;
+    exports.isHTMLAttributeNode = isHTMLAttributeNode;
+    exports.isHTMLAttributeValueNode = isHTMLAttributeValueNode;
+    exports.isHTMLCloseTagNode = isHTMLCloseTagNode;
+    exports.isHTMLCommentNode = isHTMLCommentNode;
+    exports.isHTMLDoctypeNode = isHTMLDoctypeNode;
+    exports.isHTMLElementNode = isHTMLElementNode;
+    exports.isHTMLNode = isHTMLNode;
+    exports.isHTMLOpenTagNode = isHTMLOpenTagNode;
+    exports.isHTMLTextNode = isHTMLTextNode;
     exports.isLibHerbBackend = isLibHerbBackend;
+    exports.isLiteralNode = isLiteralNode;
+    exports.isNode = isNode;
+    exports.isNoneOf = isNoneOf;
+    exports.isParseResult = isParseResult;
+    exports.isPositionAfter = isPositionAfter;
+    exports.isPositionEqual = isPositionEqual;
+    exports.isToken = isToken;
+    exports.isWhitespaceNode = isWhitespaceNode;
+    exports.isXMLDeclarationNode = isXMLDeclarationNode;
+    exports.splitNodesAroundLocation = splitNodesAroundLocation;
+    exports.splitNodesAroundPosition = splitNodesAroundPosition;
     exports.toMonacoDiagnostic = toMonacoDiagnostic;
 
 }));