@herb-tools/core 0.4.3 → 0.6.0

package/dist/herb-core.cjs

@@ -1,55 +1,5 @@
 '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;
@@ -181,7 +131,7 @@ class Token {
 }
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-7/templates/javascript/packages/core/src/errors.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.6.0/templates/javascript/packages/core/src/errors.ts.erb
 class HerbError {
     type;
     message;
@@ -622,12 +572,6 @@ function fromSerializedError(error) {
     }
 }
 
-var name = "@herb-tools/core";
-var version = "0.4.3";
-var packageJSON = {
-	name: name,
-	version: version};
-
 function ensureString(object) {
     if (typeof object === "string") {
         return object;
@@ -643,139 +587,8 @@ function convertToUTF8(string) {
     return decoder.decode(new Uint8Array(bytes));
 }
 
-class Result {
-    source;
-    warnings;
-    errors;
-    constructor(source, warnings = [], errors = []) {
-        this.source = source;
-        this.warnings = warnings || [];
-        this.errors = errors || [];
-    }
-    /**
-     * Determines if the parsing was successful.
-     * @returns `true` if there are no errors, otherwise `false`.
-     */
-    get successful() {
-        return this.errors.length === 0;
-    }
-    /**
-     * Determines if the parsing failed.
-     * @returns `true` if there are errors, otherwise `false`.
-     */
-    get failed() {
-        return this.errors.length > 0;
-    }
-}
-
-class TokenList {
-    list;
-    static from(list) {
-        return new TokenList(list.map((token) => Token.from(token)));
-    }
-    constructor(list) {
-        this.list = list;
-    }
-    get length() {
-        return this.list.length;
-    }
-    get tokens() {
-        return this.list;
-    }
-    [Symbol.iterator]() {
-        return this.list[Symbol.iterator]();
-    }
-    at(index) {
-        return this.list.at(index);
-    }
-    forEach(callback) {
-        this.list.forEach(callback);
-    }
-    map(callback) {
-        return this.list.map(callback);
-    }
-    filter(predicate) {
-        return this.list.filter(predicate);
-    }
-    __getobj__() {
-        return this.list;
-    }
-    inspect() {
-        return this.list.map((token) => token.inspect()).join("\n") + "\n";
-    }
-    toString() {
-        return this.inspect();
-    }
-}
-
-class HerbWarning {
-    message;
-    location;
-    static from(warning) {
-        return new HerbWarning(warning.message, Location.from(warning.location));
-    }
-    constructor(message, location) {
-        this.message = message;
-        this.location = location;
-    }
-}
-
-/**
- * Represents the result of a lexical analysis, extending the base `Result` class.
- * It contains the token list, source code, warnings, and errors.
- */
-class LexResult extends Result {
-    /** The list of tokens generated from the source code. */
-    value;
-    /**
-     * Creates a `LexResult` instance from a serialized result.
-     * @param result - The serialized lexical result containing tokens, source, warnings, and errors.
-     * @returns A new `LexResult` instance.
-     */
-    static from(result) {
-        return new LexResult(TokenList.from(result.tokens || []), result.source, result.warnings.map((warning) => HerbWarning.from(warning)), result.errors.map((error) => HerbError.from(error)));
-    }
-    /**
-     * Constructs a new `LexResult`.
-     * @param value - The list of tokens.
-     * @param source - The source code that was lexed.
-     * @param warnings - An array of warnings encountered during lexing.
-     * @param errors - An array of errors encountered during lexing.
-     */
-    constructor(value, source, warnings = [], errors = []) {
-        super(source, warnings, errors);
-        this.value = value;
-    }
-    /**
-     * Determines if the lexing was successful.
-     * @returns `true` if there are no errors, otherwise `false`.
-     */
-    get successful() {
-        return this.errors.length === 0;
-    }
-    /**
-     * Determines if the lexing failed.
-     * @returns `true` if there are errors, otherwise `false`.
-     */
-    get failed() {
-        return this.errors.length > 0;
-    }
-    /**
-     * Converts the `LexResult` to a JSON representation.
-     * @returns An object containing the token list, source, warnings, and errors.
-     */
-    toJSON() {
-        return {
-            value: this.value,
-            source: this.source,
-            warnings: this.warnings,
-            errors: this.errors,
-        };
-    }
-}
-
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-7/templates/javascript/packages/core/src/nodes.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.6.0/templates/javascript/packages/core/src/nodes.ts.erb
 class Node {
     type;
     location;
@@ -880,7 +693,6 @@ class DocumentNode extends Node {
         output += `@ DocumentNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `└── children: ${this.inspectArray(this.children, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -924,7 +736,6 @@ class LiteralNode extends Node {
         output += `@ LiteralNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `└── content: ${this.content ? JSON.stringify(this.content) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -991,13 +802,13 @@ class HTMLOpenTagNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `└── is_void: ${typeof this.is_void === 'boolean' ? String(this.is_void) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
 class HTMLCloseTagNode extends Node {
     tag_opening;
     tag_name;
+    children;
     tag_closing;
     static from(data) {
         return new HTMLCloseTagNode({
@@ -1006,6 +817,7 @@ class HTMLCloseTagNode extends Node {
             errors: (data.errors || []).map(error => HerbError.from(error)),
             tag_opening: data.tag_opening ? Token.from(data.tag_opening) : null,
             tag_name: data.tag_name ? Token.from(data.tag_name) : null,
+            children: (data.children || []).map(node => fromSerializedNode(node)),
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
         });
     }
@@ -1013,13 +825,16 @@ class HTMLCloseTagNode extends Node {
         super(props.type, props.location, props.errors);
         this.tag_opening = props.tag_opening;
         this.tag_name = props.tag_name;
+        this.children = props.children;
         this.tag_closing = props.tag_closing;
     }
     accept(visitor) {
         visitor.visitHTMLCloseTagNode(this);
     }
     childNodes() {
-        return [];
+        return [
+            ...this.children,
+        ];
     }
     compactChildNodes() {
         return this.childNodes().filter(node => node !== null && node !== undefined);
@@ -1027,6 +842,7 @@ class HTMLCloseTagNode extends Node {
     recursiveErrors() {
         return [
             ...this.errors,
+            ...this.children.map(node => node.recursiveErrors()),
         ].flat();
     }
     toJSON() {
@@ -1035,6 +851,7 @@ class HTMLCloseTagNode extends Node {
             type: "AST_HTML_CLOSE_TAG_NODE",
             tag_opening: this.tag_opening ? this.tag_opening.toJSON() : null,
             tag_name: this.tag_name ? this.tag_name.toJSON() : null,
+            children: this.children.map(node => node.toJSON()),
             tag_closing: this.tag_closing ? this.tag_closing.toJSON() : null,
         };
     }
@@ -1044,75 +861,8 @@ class HTMLCloseTagNode extends Node {
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
         output += `├── tag_name: ${this.tag_name ? this.tag_name.treeInspect() : "∅"}\n`;
+        output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        // output += "\n";
-        return output;
-    }
-}
-class HTMLSelfCloseTagNode extends Node {
-    tag_opening;
-    tag_name;
-    attributes;
-    tag_closing;
-    is_void;
-    static from(data) {
-        return new HTMLSelfCloseTagNode({
-            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,
-            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,
-            is_void: data.is_void,
-        });
-    }
-    constructor(props) {
-        super(props.type, props.location, props.errors);
-        this.tag_opening = props.tag_opening;
-        this.tag_name = props.tag_name;
-        this.attributes = props.attributes;
-        this.tag_closing = props.tag_closing;
-        this.is_void = props.is_void;
-    }
-    accept(visitor) {
-        visitor.visitHTMLSelfCloseTagNode(this);
-    }
-    childNodes() {
-        return [
-            ...this.attributes,
-        ];
-    }
-    compactChildNodes() {
-        return this.childNodes().filter(node => node !== null && node !== undefined);
-    }
-    recursiveErrors() {
-        return [
-            ...this.errors,
-            ...this.attributes.map(node => node.recursiveErrors()),
-        ].flat();
-    }
-    toJSON() {
-        return {
-            ...super.toJSON(),
-            type: "AST_HTML_SELF_CLOSE_TAG_NODE",
-            tag_opening: this.tag_opening ? this.tag_opening.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,
-            is_void: this.is_void,
-        };
-    }
-    treeInspect() {
-        let output = "";
-        output += `@ HTMLSelfCloseTagNode ${this.location.treeInspectWithLabel()}\n`;
-        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 += `├── attributes: ${this.inspectArray(this.attributes, "│   ")}`;
-        output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        output += `└── is_void: ${typeof this.is_void === 'boolean' ? String(this.is_void) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1127,10 +877,10 @@ class HTMLElementNode extends Node {
             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,
+            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,
+            close_tag: data.close_tag ? fromSerializedNode((data.close_tag)) : null,
             is_void: data.is_void,
         });
     }
@@ -1183,7 +933,6 @@ class HTMLElementNode extends Node {
         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;
     }
 }
@@ -1245,29 +994,30 @@ class HTMLAttributeValueNode extends Node {
         output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `├── close_quote: ${this.close_quote ? this.close_quote.treeInspect() : "∅"}\n`;
         output += `└── quoted: ${typeof this.quoted === 'boolean' ? String(this.quoted) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
 class HTMLAttributeNameNode extends Node {
-    name;
+    children;
     static 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);
@@ -1275,21 +1025,21 @@ class HTMLAttributeNameNode extends Node {
     recursiveErrors() {
         return [
             ...this.errors,
+            ...this.children.map(node => node.recursiveErrors()),
         ].flat();
     }
     toJSON() {
         return {
             ...super.toJSON(),
             type: "AST_HTML_ATTRIBUTE_NAME_NODE",
-            name: this.name ? this.name.toJSON() : null,
+            children: this.children.map(node => node.toJSON()),
         };
     }
     treeInspect() {
         let output = "";
         output += `@ HTMLAttributeNameNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
-        output += `└── name: ${this.name ? this.name.treeInspect() : "∅"}\n`;
-        // output += "\n";
+        output += `└── children: ${this.inspectArray(this.children, "    ")}`;
         return output;
     }
 }
@@ -1302,9 +1052,9 @@ class HTMLAttributeNode extends Node {
             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) {
@@ -1348,7 +1098,6 @@ class HTMLAttributeNode extends Node {
         output += `├── name: ${this.inspectNode(this.name, "│   ")}`;
         output += `├── equals: ${this.equals ? this.equals.treeInspect() : "∅"}\n`;
         output += `└── value: ${this.inspectNode(this.value, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1392,7 +1141,6 @@ class HTMLTextNode extends Node {
         output += `@ HTMLTextNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `└── content: ${this.content ? JSON.stringify(this.content) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1449,7 +1197,6 @@ class HTMLCommentNode extends Node {
         output += `├── comment_start: ${this.comment_start ? this.comment_start.treeInspect() : "∅"}\n`;
         output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `└── comment_end: ${this.comment_end ? this.comment_end.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1506,7 +1253,118 @@ class HTMLDoctypeNode extends Node {
         output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
         output += `├── children: ${this.inspectArray(this.children, "│   ")}`;
         output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        // output += "\n";
+        return output;
+    }
+}
+class XMLDeclarationNode extends Node {
+    tag_opening;
+    children;
+    tag_closing;
+    static 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 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;
     }
 }
@@ -1550,7 +1408,6 @@ class WhitespaceNode extends Node {
         output += `@ WhitespaceNode ${this.location.treeInspectWithLabel()}\n`;
         output += `├── errors: ${this.inspectArray(this.errors, "│   ")}`;
         output += `└── value: ${this.value ? this.value.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1619,7 +1476,6 @@ class ERBContentNode extends Node {
         // no-op for analyzed_ruby
         output += `├── parsed: ${typeof this.parsed === 'boolean' ? String(this.parsed) : "∅"}\n`;
         output += `└── valid: ${typeof this.valid === 'boolean' ? String(this.valid) : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1673,7 +1529,6 @@ class ERBEndNode extends Node {
         output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -1735,7 +1590,6 @@ class ERBElseNode extends Node {
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `└── statements: ${this.inspectArray(this.statements, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1755,8 +1609,8 @@ class ERBIfNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            subsequent: data.subsequent ? fromSerializedNode(data.subsequent) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            subsequent: data.subsequent ? fromSerializedNode((data.subsequent)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -1811,7 +1665,6 @@ class ERBIfNode extends Node {
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `├── subsequent: ${this.inspectNode(this.subsequent, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1830,7 +1683,7 @@ class ERBBlockNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             body: (data.body || []).map(node => fromSerializedNode(node)),
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -1880,7 +1733,6 @@ class ERBBlockNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── body: ${this.inspectArray(this.body, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1942,7 +1794,6 @@ class ERBWhenNode extends Node {
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `└── statements: ${this.inspectArray(this.statements, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -1964,8 +1815,8 @@ class ERBCaseNode extends Node {
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             children: (data.children || []).map(node => fromSerializedNode(node)),
             conditions: (data.conditions || []).map(node => fromSerializedNode(node)),
-            else_clause: data.else_clause ? fromSerializedNode(data.else_clause) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            else_clause: data.else_clause ? fromSerializedNode((data.else_clause)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2025,7 +1876,6 @@ class ERBCaseNode extends Node {
         output += `├── conditions: ${this.inspectArray(this.conditions, "│   ")}`;
         output += `├── else_clause: ${this.inspectNode(this.else_clause, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2047,8 +1897,8 @@ class ERBCaseMatchNode extends Node {
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             children: (data.children || []).map(node => fromSerializedNode(node)),
             conditions: (data.conditions || []).map(node => fromSerializedNode(node)),
-            else_clause: data.else_clause ? fromSerializedNode(data.else_clause) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            else_clause: data.else_clause ? fromSerializedNode((data.else_clause)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2108,7 +1958,6 @@ class ERBCaseMatchNode extends Node {
         output += `├── conditions: ${this.inspectArray(this.conditions, "│   ")}`;
         output += `├── else_clause: ${this.inspectNode(this.else_clause, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2127,7 +1976,7 @@ class ERBWhileNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2177,7 +2026,6 @@ class ERBWhileNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2196,7 +2044,7 @@ class ERBUntilNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2246,7 +2094,6 @@ class ERBUntilNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2265,7 +2112,7 @@ class ERBForNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2315,7 +2162,6 @@ class ERBForNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2334,7 +2180,7 @@ class ERBRescueNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            subsequent: data.subsequent ? fromSerializedNode(data.subsequent) : null,
+            subsequent: data.subsequent ? fromSerializedNode((data.subsequent)) : null,
         });
     }
     constructor(props) {
@@ -2384,7 +2230,6 @@ class ERBRescueNode extends Node {
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `└── subsequent: ${this.inspectNode(this.subsequent, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2446,7 +2291,6 @@ class ERBEnsureNode extends Node {
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `└── statements: ${this.inspectArray(this.statements, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2468,10 +2312,10 @@ class ERBBeginNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            rescue_clause: data.rescue_clause ? fromSerializedNode(data.rescue_clause) : null,
-            else_clause: data.else_clause ? fromSerializedNode(data.else_clause) : null,
-            ensure_clause: data.ensure_clause ? fromSerializedNode(data.ensure_clause) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            rescue_clause: data.rescue_clause ? fromSerializedNode((data.rescue_clause)) : null,
+            else_clause: data.else_clause ? fromSerializedNode((data.else_clause)) : null,
+            ensure_clause: data.ensure_clause ? fromSerializedNode((data.ensure_clause)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2536,7 +2380,6 @@ class ERBBeginNode extends Node {
         output += `├── else_clause: ${this.inspectNode(this.else_clause, "│   ")}`;
         output += `├── ensure_clause: ${this.inspectNode(this.ensure_clause, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2556,8 +2399,8 @@ class ERBUnlessNode extends Node {
             content: data.content ? Token.from(data.content) : null,
             tag_closing: data.tag_closing ? Token.from(data.tag_closing) : null,
             statements: (data.statements || []).map(node => fromSerializedNode(node)),
-            else_clause: data.else_clause ? fromSerializedNode(data.else_clause) : null,
-            end_node: data.end_node ? fromSerializedNode(data.end_node) : null,
+            else_clause: data.else_clause ? fromSerializedNode((data.else_clause)) : null,
+            end_node: data.end_node ? fromSerializedNode((data.end_node)) : null,
         });
     }
     constructor(props) {
@@ -2612,7 +2455,6 @@ class ERBUnlessNode extends Node {
         output += `├── statements: ${this.inspectArray(this.statements, "│   ")}`;
         output += `├── else_clause: ${this.inspectNode(this.else_clause, "│   ")}`;
         output += `└── end_node: ${this.inspectNode(this.end_node, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2666,7 +2508,6 @@ class ERBYieldNode extends Node {
         output += `├── tag_opening: ${this.tag_opening ? this.tag_opening.treeInspect() : "∅"}\n`;
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `└── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
-        // output += "\n";
         return output;
     }
 }
@@ -2728,7 +2569,6 @@ class ERBInNode extends Node {
         output += `├── content: ${this.content ? this.content.treeInspect() : "∅"}\n`;
         output += `├── tag_closing: ${this.tag_closing ? this.tag_closing.treeInspect() : "∅"}\n`;
         output += `└── statements: ${this.inspectArray(this.statements, "    ")}`;
-        // output += "\n";
         return output;
     }
 }
@@ -2738,7 +2578,6 @@ function fromSerializedNode(node) {
         case "AST_LITERAL_NODE": return LiteralNode.from(node);
         case "AST_HTML_OPEN_TAG_NODE": return HTMLOpenTagNode.from(node);
         case "AST_HTML_CLOSE_TAG_NODE": return HTMLCloseTagNode.from(node);
-        case "AST_HTML_SELF_CLOSE_TAG_NODE": return HTMLSelfCloseTagNode.from(node);
         case "AST_HTML_ELEMENT_NODE": return HTMLElementNode.from(node);
         case "AST_HTML_ATTRIBUTE_VALUE_NODE": return HTMLAttributeValueNode.from(node);
         case "AST_HTML_ATTRIBUTE_NAME_NODE": return HTMLAttributeNameNode.from(node);
@@ -2746,6 +2585,8 @@ function fromSerializedNode(node) {
         case "AST_HTML_TEXT_NODE": return HTMLTextNode.from(node);
         case "AST_HTML_COMMENT_NODE": return HTMLCommentNode.from(node);
         case "AST_HTML_DOCTYPE_NODE": return HTMLDoctypeNode.from(node);
+        case "AST_XML_DECLARATION_NODE": return XMLDeclarationNode.from(node);
+        case "AST_CDATA_NODE": return CDATANode.from(node);
         case "AST_WHITESPACE_NODE": return WhitespaceNode.from(node);
         case "AST_ERB_CONTENT_NODE": return ERBContentNode.from(node);
         case "AST_ERB_END_NODE": return ERBEndNode.from(node);
@@ -2787,8 +2628,42 @@ const ERBNodeClasses = [
     ERBYieldNode,
     ERBInNode,
 ];
-function isERBNode(node) {
-    return node.constructor.name.startsWith("ERB");
+
+class Result {
+    source;
+    warnings;
+    errors;
+    constructor(source, warnings = [], errors = []) {
+        this.source = source;
+        this.warnings = warnings || [];
+        this.errors = errors || [];
+    }
+    /**
+     * Determines if the parsing was successful.
+     * @returns `true` if there are no errors, otherwise `false`.
+     */
+    get successful() {
+        return this.errors.length === 0;
+    }
+    /**
+     * Determines if the parsing failed.
+     * @returns `true` if there are errors, otherwise `false`.
+     */
+    get failed() {
+        return this.errors.length > 0;
+    }
+}
+
+class HerbWarning {
+    message;
+    location;
+    static from(warning) {
+        return new HerbWarning(warning.message, Location.from(warning.location));
+    }
+    constructor(message, location) {
+        this.message = message;
+        this.location = location;
+    }
 }
 
 /**
@@ -2858,125 +2733,1038 @@ class ParseResult extends Result {
     }
 }
 
+// NOTE: This file is generated by the templates/template.rb script and should not
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.6.0/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;
-    }
-    /**
-     * Loads the backend by resolving the backend promise.
-     * @returns A promise containing the resolved `HerbBackend` instance after loading it.
-     */
-    async load() {
-        const backend = await this.backendPromise();
-        this.backend = backend;
-        return this;
-    }
-    /**
-     * Lexes the given source string into a `LexResult`.
-     * @param source - The source code to lex.
-     * @returns A `LexResult` instance.
-     * @throws Error if the backend is not loaded.
-     */
-    lex(source) {
-        this.ensureBackend();
-        return LexResult.from(this.backend.lex(ensureString(source)));
-    }
-    /**
-     * Lexes a file.
-     * @param path - The file path to lex.
-     * @returns A `LexResult` instance.
-     * @throws Error if the backend is not loaded.
-     */
-    lexFile(path) {
-        this.ensureBackend();
-        return LexResult.from(this.backend.lexFile(ensureString(path)));
-    }
-    /**
-     * Parses the given source string into a `ParseResult`.
-     * @param source - The source code to parse.
-     * @returns A `ParseResult` instance.
-     * @throws Error if the backend is not loaded.
-     */
-    parse(source) {
-        this.ensureBackend();
-        return ParseResult.from(this.backend.parse(ensureString(source)));
-    }
-    /**
-     * Parses a file.
-     * @param path - The file path to parse.
-     * @returns A `ParseResult` instance.
-     * @throws Error if the backend is not loaded.
-     */
-    parseFile(path) {
-        this.ensureBackend();
-        return ParseResult.from(this.backend.parseFile(ensureString(path)));
-    }
-    /**
-     * Extracts embedded Ruby code from the given source.
-     * @param source - The source code to extract Ruby from.
-     * @returns The extracted Ruby code as a string.
-     * @throws Error if the backend is not loaded.
-     */
-    extractRuby(source) {
-        this.ensureBackend();
-        return this.backend.extractRuby(ensureString(source));
-    }
-    /**
-     * Extracts HTML from the given source.
-     * @param source - The source code to extract HTML from.
-     * @returns The extracted HTML as a string.
-     * @throws Error if the backend is not loaded.
-     */
-    extractHTML(source) {
-        this.ensureBackend();
-        return this.backend.extractHTML(ensureString(source));
-    }
-    /**
-     * Gets the Herb version information, including the core and backend versions.
-     * @returns A version string containing backend, core, and libherb versions.
-     * @throws Error if the backend is not loaded.
-     */
-    get version() {
-        this.ensureBackend();
-        const backend = this.backendVersion();
-        const core = `${packageJSON.name}@${packageJSON.version}`;
-        const libherb = this.backend.version();
-        return `${backend}, ${core}, ${libherb}`;
-    }
-    /**
-     * Ensures that the backend is loaded.
-     * @throws Error if the backend is not loaded.
-     */
-    ensureBackend() {
-        if (!this.isLoaded) {
-            throw new Error("Herb backend is not loaded. Call `await Herb.load()` first.");
-        }
-    }
-    /**
-     * Checks if the backend is loaded.
-     * @returns True if the backend is loaded, false otherwise.
-     */
-    get isLoaded() {
+/**
+ * Checks if a node is a DocumentNode
+ */
+function isDocumentNode(node) {
+    return node instanceof DocumentNode || node.type === "AST_DOCUMENT_NODE";
+}
+/**
+ * Checks if a node is a LiteralNode
+ */
+function isLiteralNode(node) {
+    return node instanceof LiteralNode || node.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";
+}
+/**
+ * Checks if a node is a HTMLCloseTagNode
+ */
+function isHTMLCloseTagNode(node) {
+    return node instanceof HTMLCloseTagNode || node.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";
+}
+/**
+ * Checks if a node is a HTMLAttributeValueNode
+ */
+function isHTMLAttributeValueNode(node) {
+    return node instanceof HTMLAttributeValueNode || node.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";
+}
+/**
+ * Checks if a node is a HTMLAttributeNode
+ */
+function isHTMLAttributeNode(node) {
+    return node instanceof HTMLAttributeNode || node.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";
+}
+/**
+ * Checks if a node is a HTMLCommentNode
+ */
+function isHTMLCommentNode(node) {
+    return node instanceof HTMLCommentNode || node.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";
+}
+/**
+ * Checks if a node is a XMLDeclarationNode
+ */
+function isXMLDeclarationNode(node) {
+    return node instanceof XMLDeclarationNode || node.type === "AST_XML_DECLARATION_NODE";
+}
+/**
+ * Checks if a node is a CDATANode
+ */
+function isCDATANode(node) {
+    return node instanceof CDATANode || node.type === "AST_CDATA_NODE";
+}
+/**
+ * Checks if a node is a WhitespaceNode
+ */
+function isWhitespaceNode(node) {
+    return node instanceof WhitespaceNode || node.type === "AST_WHITESPACE_NODE";
+}
+/**
+ * Checks if a node is a ERBContentNode
+ */
+function isERBContentNode(node) {
+    return node instanceof ERBContentNode || node.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";
+}
+/**
+ * Checks if a node is a ERBElseNode
+ */
+function isERBElseNode(node) {
+    return node instanceof ERBElseNode || node.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";
+}
+/**
+ * Checks if a node is a ERBBlockNode
+ */
+function isERBBlockNode(node) {
+    return node instanceof ERBBlockNode || node.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";
+}
+/**
+ * Checks if a node is a ERBCaseNode
+ */
+function isERBCaseNode(node) {
+    return node instanceof ERBCaseNode || node.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";
+}
+/**
+ * Checks if a node is a ERBWhileNode
+ */
+function isERBWhileNode(node) {
+    return node instanceof ERBWhileNode || node.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";
+}
+/**
+ * Checks if a node is a ERBForNode
+ */
+function isERBForNode(node) {
+    return node instanceof ERBForNode || node.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";
+}
+/**
+ * Checks if a node is a ERBEnsureNode
+ */
+function isERBEnsureNode(node) {
+    return node instanceof ERBEnsureNode || node.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";
+}
+/**
+ * Checks if a node is a ERBUnlessNode
+ */
+function isERBUnlessNode(node) {
+    return node instanceof ERBUnlessNode || node.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";
+}
+/**
+ * Checks if a node is a ERBInNode
+ */
+function isERBInNode(node) {
+    return node instanceof ERBInNode || node.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 (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));
+}
+
+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.0";
+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.
+     * @returns A promise containing the resolved `HerbBackend` instance after loading it.
+     */
+    async load() {
+        const backend = await this.backendPromise();
+        this.backend = backend;
+        return this;
+    }
+    /**
+     * Lexes the given source string into a `LexResult`.
+     * @param source - The source code to lex.
+     * @returns A `LexResult` instance.
+     * @throws Error if the backend is not loaded.
+     */
+    lex(source) {
+        this.ensureBackend();
+        return LexResult.from(this.backend.lex(ensureString(source)));
+    }
+    /**
+     * Lexes a file.
+     * @param path - The file path to lex.
+     * @returns A `LexResult` instance.
+     * @throws Error if the backend is not loaded.
+     */
+    lexFile(path) {
+        this.ensureBackend();
+        return LexResult.from(this.backend.lexFile(ensureString(path)));
+    }
+    /**
+     * 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, options) {
+        this.ensureBackend();
+        const mergedOptions = { ...DEFAULT_PARSER_OPTIONS, ...options };
+        return ParseResult.from(this.backend.parse(ensureString(source), mergedOptions));
+    }
+    /**
+     * Parses a file.
+     * @param path - The file path to parse.
+     * @returns A `ParseResult` instance.
+     * @throws Error if the backend is not loaded.
+     */
+    parseFile(path) {
+        this.ensureBackend();
+        return ParseResult.from(this.backend.parseFile(ensureString(path)));
+    }
+    /**
+     * Extracts embedded Ruby code from the given source.
+     * @param source - The source code to extract Ruby from.
+     * @returns The extracted Ruby code as a string.
+     * @throws Error if the backend is not loaded.
+     */
+    extractRuby(source) {
+        this.ensureBackend();
+        return this.backend.extractRuby(ensureString(source));
+    }
+    /**
+     * Extracts HTML from the given source.
+     * @param source - The source code to extract HTML from.
+     * @returns The extracted HTML as a string.
+     * @throws Error if the backend is not loaded.
+     */
+    extractHTML(source) {
+        this.ensureBackend();
+        return this.backend.extractHTML(ensureString(source));
+    }
+    /**
+     * Gets the Herb version information, including the core and backend versions.
+     * @returns A version string containing backend, core, and libherb versions.
+     * @throws Error if the backend is not loaded.
+     */
+    get version() {
+        this.ensureBackend();
+        const backend = this.backendVersion();
+        const core = `${packageJSON.name}@${packageJSON.version}`;
+        const libherb = this.backend.version();
+        return `${backend}, ${core}, ${libherb}`;
+    }
+    /**
+     * Ensures that the backend is loaded.
+     * @throws Error if the backend is not loaded.
+     */
+    ensureBackend() {
+        if (!this.isLoaded) {
+            throw new Error("Herb backend is not loaded. Call `await Herb.load()` first.");
+        }
+    }
+    /**
+     * Checks if the backend is loaded.
+     * @returns True if the backend is loaded, false otherwise.
+     */
+    get isLoaded() {
         return this.backend !== undefined;
     }
 }
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-7/templates/javascript/packages/core/src/visitor.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.6.0/templates/javascript/packages/core/src/visitor.ts.erb
 class Visitor {
     visit(node) {
         if (!node)
@@ -3001,9 +3789,6 @@ class Visitor {
     visitHTMLCloseTagNode(node) {
         this.visitChildNodes(node);
     }
-    visitHTMLSelfCloseTagNode(node) {
-        this.visitChildNodes(node);
-    }
     visitHTMLElementNode(node) {
         this.visitChildNodes(node);
     }
@@ -3025,6 +3810,12 @@ class Visitor {
     visitHTMLDoctypeNode(node) {
         this.visitChildNodes(node);
     }
+    visitXMLDeclarationNode(node) {
+        this.visitChildNodes(node);
+    }
+    visitCDATANode(node) {
+        this.visitChildNodes(node);
+    }
     visitWhitespaceNode(node) {
         this.visitChildNodes(node);
     }
@@ -3081,6 +3872,9 @@ class Visitor {
     }
 }
 
+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;
@@ -3108,7 +3902,6 @@ exports.HTMLCommentNode = HTMLCommentNode;
 exports.HTMLDoctypeNode = HTMLDoctypeNode;
 exports.HTMLElementNode = HTMLElementNode;
 exports.HTMLOpenTagNode = HTMLOpenTagNode;
-exports.HTMLSelfCloseTagNode = HTMLSelfCloseTagNode;
 exports.HTMLTextNode = HTMLTextNode;
 exports.HerbBackend = HerbBackend;
 exports.HerbError = HerbError;
@@ -3118,6 +3911,7 @@ exports.LiteralNode = LiteralNode;
 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;
@@ -3134,13 +3928,101 @@ exports.UnexpectedTokenError = UnexpectedTokenError;
 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.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.isToken = isToken;
+exports.isWhitespaceNode = isWhitespaceNode;
+exports.isXMLDeclarationNode = isXMLDeclarationNode;
 exports.toMonacoDiagnostic = toMonacoDiagnostic;
 //# sourceMappingURL=herb-core.cjs.map