@herb-tools/core 0.1.1 → 0.3.0

package/dist/types/nodes.d.ts

@@ -1,10 +1,38 @@
-import { Node } from "./node.js";
+import { Location } from "./location.js";
 import { Token, SerializedToken } from "./token.js";
-import { HerbError } from "./error.js";
-import type { SerializedNode, BaseNodeProps } from "./node.js";
-export declare function fromSerializedNode(node: SerializedNode): Node;
+import { HerbError } from "./errors.js";
+import type { SerializedLocation } from "./location.js";
+import type { SerializedHerbError } from "./errors.js";
+import type { Visitor } from "./visitor.js";
 export type SerializedNodeType = string;
-export type NodeType = "AST_DOCUMENT_NODE" | "AST_LITERAL_NODE" | "AST_HTML_OPEN_TAG_NODE" | "AST_HTML_CLOSE_TAG_NODE" | "AST_HTML_SELF_CLOSE_TAG_NODE" | "AST_HTML_ELEMENT_NODE" | "AST_HTML_ATTRIBUTE_VALUE_NODE" | "AST_HTML_ATTRIBUTE_NAME_NODE" | "AST_HTML_ATTRIBUTE_NODE" | "AST_HTML_TEXT_NODE" | "AST_HTML_COMMENT_NODE" | "AST_HTML_DOCTYPE_NODE" | "AST_WHITESPACE_NODE" | "AST_ERB_CONTENT_NODE" | "AST_ERB_END_NODE" | "AST_ERB_ELSE_NODE" | "AST_ERB_IF_NODE" | "AST_ERB_BLOCK_NODE" | "AST_ERB_WHEN_NODE" | "AST_ERB_CASE_NODE" | "AST_ERB_WHILE_NODE" | "AST_ERB_UNTIL_NODE" | "AST_ERB_FOR_NODE" | "AST_ERB_RESCUE_NODE" | "AST_ERB_ENSURE_NODE" | "AST_ERB_BEGIN_NODE" | "AST_ERB_UNLESS_NODE";
+export interface SerializedNode {
+    type: SerializedNodeType;
+    location: SerializedLocation;
+    errors: SerializedHerbError[];
+}
+export interface BaseNodeProps {
+    type: NodeType;
+    location: Location;
+    errors: HerbError[];
+}
+export type NodeType = "AST_DOCUMENT_NODE" | "AST_LITERAL_NODE" | "AST_HTML_OPEN_TAG_NODE" | "AST_HTML_CLOSE_TAG_NODE" | "AST_HTML_SELF_CLOSE_TAG_NODE" | "AST_HTML_ELEMENT_NODE" | "AST_HTML_ATTRIBUTE_VALUE_NODE" | "AST_HTML_ATTRIBUTE_NAME_NODE" | "AST_HTML_ATTRIBUTE_NODE" | "AST_HTML_TEXT_NODE" | "AST_HTML_COMMENT_NODE" | "AST_HTML_DOCTYPE_NODE" | "AST_WHITESPACE_NODE" | "AST_ERB_CONTENT_NODE" | "AST_ERB_END_NODE" | "AST_ERB_ELSE_NODE" | "AST_ERB_IF_NODE" | "AST_ERB_BLOCK_NODE" | "AST_ERB_WHEN_NODE" | "AST_ERB_CASE_NODE" | "AST_ERB_CASE_MATCH_NODE" | "AST_ERB_WHILE_NODE" | "AST_ERB_UNTIL_NODE" | "AST_ERB_FOR_NODE" | "AST_ERB_RESCUE_NODE" | "AST_ERB_ENSURE_NODE" | "AST_ERB_BEGIN_NODE" | "AST_ERB_UNLESS_NODE" | "AST_ERB_YIELD_NODE" | "AST_ERB_IN_NODE";
+export declare abstract class Node implements BaseNodeProps {
+    readonly type: NodeType;
+    readonly location: Location;
+    readonly errors: HerbError[];
+    static from(node: SerializedNode): Node;
+    constructor(type: NodeType, location: Location, errors: HerbError[]);
+    toJSON(): SerializedNode;
+    inspect(): string;
+    get isSingleLine(): boolean;
+    abstract treeInspect(indent?: number): string;
+    abstract recursiveErrors(): HerbError[];
+    abstract accept(visitor: Visitor): void;
+    abstract childNodes(): (Node | null | undefined)[];
+    abstract compactChildNodes(): Node[];
+    protected inspectArray(array: (Node | HerbError)[] | null | undefined, prefix: string): string;
+    protected inspectNode(node: Node | HerbError | undefined | null, prefix: string, prefix2?: string, last?: boolean, trailingNewline?: boolean): string;
+}
 export interface SerializedDocumentNode extends SerializedNode {
     type: "AST_DOCUMENT_NODE";
     children: SerializedNode[];
@@ -16,7 +44,9 @@ export declare class DocumentNode extends Node {
     readonly children: Node[];
     static from(data: SerializedDocumentNode): DocumentNode;
     constructor(props: DocumentNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedDocumentNode;
     treeInspect(): string;
@@ -32,7 +62,9 @@ export declare class LiteralNode extends Node {
     readonly content: string;
     static from(data: SerializedLiteralNode): LiteralNode;
     constructor(props: LiteralNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedLiteralNode;
     treeInspect(): string;
@@ -60,7 +92,9 @@ export declare class HTMLOpenTagNode extends Node {
     readonly is_void: boolean;
     static from(data: SerializedHTMLOpenTagNode): HTMLOpenTagNode;
     constructor(props: HTMLOpenTagNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLOpenTagNode;
     treeInspect(): string;
@@ -82,7 +116,9 @@ export declare class HTMLCloseTagNode extends Node {
     readonly tag_closing: Token | null;
     static from(data: SerializedHTMLCloseTagNode): HTMLCloseTagNode;
     constructor(props: HTMLCloseTagNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLCloseTagNode;
     treeInspect(): string;
@@ -98,19 +134,21 @@ export interface SerializedHTMLSelfCloseTagNode extends SerializedNode {
 export interface HTMLSelfCloseTagNodeProps extends BaseNodeProps {
     tag_opening: Token | null;
     tag_name: Token | null;
-    attributes: Node[];
+    attributes: any[];
     tag_closing: Token | null;
     is_void: boolean;
 }
 export declare class HTMLSelfCloseTagNode extends Node {
     readonly tag_opening: Token | null;
     readonly tag_name: Token | null;
-    readonly attributes: Node[];
+    readonly attributes: any[];
     readonly tag_closing: Token | null;
     readonly is_void: boolean;
     static from(data: SerializedHTMLSelfCloseTagNode): HTMLSelfCloseTagNode;
     constructor(props: HTMLSelfCloseTagNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLSelfCloseTagNode;
     treeInspect(): string;
@@ -138,7 +176,9 @@ export declare class HTMLElementNode extends Node {
     readonly is_void: boolean;
     static from(data: SerializedHTMLElementNode): HTMLElementNode;
     constructor(props: HTMLElementNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLElementNode;
     treeInspect(): string;
@@ -163,7 +203,9 @@ export declare class HTMLAttributeValueNode extends Node {
     readonly quoted: boolean;
     static from(data: SerializedHTMLAttributeValueNode): HTMLAttributeValueNode;
     constructor(props: HTMLAttributeValueNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLAttributeValueNode;
     treeInspect(): string;
@@ -179,7 +221,9 @@ export declare class HTMLAttributeNameNode extends Node {
     readonly name: Token | null;
     static from(data: SerializedHTMLAttributeNameNode): HTMLAttributeNameNode;
     constructor(props: HTMLAttributeNameNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLAttributeNameNode;
     treeInspect(): string;
@@ -201,7 +245,9 @@ export declare class HTMLAttributeNode extends Node {
     readonly value: Node | null;
     static from(data: SerializedHTMLAttributeNode): HTMLAttributeNode;
     constructor(props: HTMLAttributeNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLAttributeNode;
     treeInspect(): string;
@@ -217,7 +263,9 @@ export declare class HTMLTextNode extends Node {
     readonly content: string;
     static from(data: SerializedHTMLTextNode): HTMLTextNode;
     constructor(props: HTMLTextNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLTextNode;
     treeInspect(): string;
@@ -239,7 +287,9 @@ export declare class HTMLCommentNode extends Node {
     readonly comment_end: Token | null;
     static from(data: SerializedHTMLCommentNode): HTMLCommentNode;
     constructor(props: HTMLCommentNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLCommentNode;
     treeInspect(): string;
@@ -261,7 +311,9 @@ export declare class HTMLDoctypeNode extends Node {
     readonly tag_closing: Token | null;
     static from(data: SerializedHTMLDoctypeNode): HTMLDoctypeNode;
     constructor(props: HTMLDoctypeNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedHTMLDoctypeNode;
     treeInspect(): string;
@@ -277,7 +329,9 @@ export declare class WhitespaceNode extends Node {
     readonly value: Token | null;
     static from(data: SerializedWhitespaceNode): WhitespaceNode;
     constructor(props: WhitespaceNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedWhitespaceNode;
     treeInspect(): string;
@@ -305,7 +359,9 @@ export declare class ERBContentNode extends Node {
     readonly valid: boolean;
     static from(data: SerializedERBContentNode): ERBContentNode;
     constructor(props: ERBContentNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBContentNode;
     treeInspect(): string;
@@ -327,7 +383,9 @@ export declare class ERBEndNode extends Node {
     readonly tag_closing: Token | null;
     static from(data: SerializedERBEndNode): ERBEndNode;
     constructor(props: ERBEndNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBEndNode;
     treeInspect(): string;
@@ -352,7 +410,9 @@ export declare class ERBElseNode extends Node {
     readonly statements: Node[];
     static from(data: SerializedERBElseNode): ERBElseNode;
     constructor(props: ERBElseNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBElseNode;
     treeInspect(): string;
@@ -383,7 +443,9 @@ export declare class ERBIfNode extends Node {
     readonly end_node: Node | null;
     static from(data: SerializedERBIfNode): ERBIfNode;
     constructor(props: ERBIfNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBIfNode;
     treeInspect(): string;
@@ -411,7 +473,9 @@ export declare class ERBBlockNode extends Node {
     readonly end_node: Node | null;
     static from(data: SerializedERBBlockNode): ERBBlockNode;
     constructor(props: ERBBlockNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBBlockNode;
     treeInspect(): string;
@@ -436,7 +500,9 @@ export declare class ERBWhenNode extends Node {
     readonly statements: Node[];
     static from(data: SerializedERBWhenNode): ERBWhenNode;
     constructor(props: ERBWhenNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBWhenNode;
     treeInspect(): string;
@@ -456,7 +522,7 @@ export interface ERBCaseNodeProps extends BaseNodeProps {
     content: Token | null;
     tag_closing: Token | null;
     children: Node[];
-    conditions: Node[];
+    conditions: any[];
     else_clause: Node | null;
     end_node: Node | null;
 }
@@ -465,16 +531,54 @@ export declare class ERBCaseNode extends Node {
     readonly content: Token | null;
     readonly tag_closing: Token | null;
     readonly children: Node[];
-    readonly conditions: Node[];
+    readonly conditions: any[];
     readonly else_clause: Node | null;
     readonly end_node: Node | null;
     static from(data: SerializedERBCaseNode): ERBCaseNode;
     constructor(props: ERBCaseNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBCaseNode;
     treeInspect(): string;
 }
+export interface SerializedERBCaseMatchNode extends SerializedNode {
+    type: "AST_ERB_CASE_MATCH_NODE";
+    tag_opening: SerializedToken | null;
+    content: SerializedToken | null;
+    tag_closing: SerializedToken | null;
+    children: SerializedNode[];
+    conditions: SerializedNode[];
+    else_clause: SerializedNode | null;
+    end_node: SerializedNode | null;
+}
+export interface ERBCaseMatchNodeProps extends BaseNodeProps {
+    tag_opening: Token | null;
+    content: Token | null;
+    tag_closing: Token | null;
+    children: Node[];
+    conditions: any[];
+    else_clause: Node | null;
+    end_node: Node | null;
+}
+export declare class ERBCaseMatchNode extends Node {
+    readonly tag_opening: Token | null;
+    readonly content: Token | null;
+    readonly tag_closing: Token | null;
+    readonly children: Node[];
+    readonly conditions: any[];
+    readonly else_clause: Node | null;
+    readonly end_node: Node | null;
+    static from(data: SerializedERBCaseMatchNode): ERBCaseMatchNode;
+    constructor(props: ERBCaseMatchNodeProps);
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
+    recursiveErrors(): HerbError[];
+    toJSON(): SerializedERBCaseMatchNode;
+    treeInspect(): string;
+}
 export interface SerializedERBWhileNode extends SerializedNode {
     type: "AST_ERB_WHILE_NODE";
     tag_opening: SerializedToken | null;
@@ -498,7 +602,9 @@ export declare class ERBWhileNode extends Node {
     readonly end_node: Node | null;
     static from(data: SerializedERBWhileNode): ERBWhileNode;
     constructor(props: ERBWhileNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBWhileNode;
     treeInspect(): string;
@@ -526,7 +632,9 @@ export declare class ERBUntilNode extends Node {
     readonly end_node: Node | null;
     static from(data: SerializedERBUntilNode): ERBUntilNode;
     constructor(props: ERBUntilNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBUntilNode;
     treeInspect(): string;
@@ -554,7 +662,9 @@ export declare class ERBForNode extends Node {
     readonly end_node: Node | null;
     static from(data: SerializedERBForNode): ERBForNode;
     constructor(props: ERBForNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBForNode;
     treeInspect(): string;
@@ -582,7 +692,9 @@ export declare class ERBRescueNode extends Node {
     readonly subsequent: Node | null;
     static from(data: SerializedERBRescueNode): ERBRescueNode;
     constructor(props: ERBRescueNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBRescueNode;
     treeInspect(): string;
@@ -607,7 +719,9 @@ export declare class ERBEnsureNode extends Node {
     readonly statements: Node[];
     static from(data: SerializedERBEnsureNode): ERBEnsureNode;
     constructor(props: ERBEnsureNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBEnsureNode;
     treeInspect(): string;
@@ -644,7 +758,9 @@ export declare class ERBBeginNode extends Node {
     readonly end_node: Node | null;
     static from(data: SerializedERBBeginNode): ERBBeginNode;
     constructor(props: ERBBeginNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBBeginNode;
     treeInspect(): string;
@@ -675,8 +791,62 @@ export declare class ERBUnlessNode extends Node {
     readonly end_node: Node | null;
     static from(data: SerializedERBUnlessNode): ERBUnlessNode;
     constructor(props: ERBUnlessNodeProps);
-    childNodes(): Node[];
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
     recursiveErrors(): HerbError[];
     toJSON(): SerializedERBUnlessNode;
     treeInspect(): string;
 }
+export interface SerializedERBYieldNode extends SerializedNode {
+    type: "AST_ERB_YIELD_NODE";
+    tag_opening: SerializedToken | null;
+    content: SerializedToken | null;
+    tag_closing: SerializedToken | null;
+}
+export interface ERBYieldNodeProps extends BaseNodeProps {
+    tag_opening: Token | null;
+    content: Token | null;
+    tag_closing: Token | null;
+}
+export declare class ERBYieldNode extends Node {
+    readonly tag_opening: Token | null;
+    readonly content: Token | null;
+    readonly tag_closing: Token | null;
+    static from(data: SerializedERBYieldNode): ERBYieldNode;
+    constructor(props: ERBYieldNodeProps);
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
+    recursiveErrors(): HerbError[];
+    toJSON(): SerializedERBYieldNode;
+    treeInspect(): string;
+}
+export interface SerializedERBInNode extends SerializedNode {
+    type: "AST_ERB_IN_NODE";
+    tag_opening: SerializedToken | null;
+    content: SerializedToken | null;
+    tag_closing: SerializedToken | null;
+    statements: SerializedNode[];
+}
+export interface ERBInNodeProps extends BaseNodeProps {
+    tag_opening: Token | null;
+    content: Token | null;
+    tag_closing: Token | null;
+    statements: Node[];
+}
+export declare class ERBInNode extends Node {
+    readonly tag_opening: Token | null;
+    readonly content: Token | null;
+    readonly tag_closing: Token | null;
+    readonly statements: Node[];
+    static from(data: SerializedERBInNode): ERBInNode;
+    constructor(props: ERBInNodeProps);
+    accept(visitor: Visitor): void;
+    childNodes(): (Node | null | undefined)[];
+    compactChildNodes(): Node[];
+    recursiveErrors(): HerbError[];
+    toJSON(): SerializedERBInNode;
+    treeInspect(): string;
+}
+export declare function fromSerializedNode(node: SerializedNode): Node;

package/dist/types/parse-result.d.ts

@@ -1,8 +1,8 @@
 import { Result } from "./result.js";
 import { DocumentNode } from "./nodes.js";
-import { HerbError } from "./error.js";
+import { HerbError } from "./errors.js";
 import { HerbWarning } from "./warning.js";
-import type { SerializedHerbError } from "./error.js";
+import type { SerializedHerbError } from "./errors.js";
 import type { SerializedHerbWarning } from "./warning.js";
 import type { SerializedDocumentNode } from "./nodes.js";
 import type { Visitor } from "./visitor.js";
@@ -37,12 +37,12 @@ export declare class ParseResult extends Result {
      * Determines if the parsing failed.
      * @returns `true` if there are errors, otherwise `false`.
      */
-    failed(): boolean;
+    get failed(): boolean;
     /**
      * Determines if the parsing was successful.
      * @returns `true` if there are no errors, otherwise `false`.
      */
-    success(): boolean;
+    get successful(): boolean;
     /**
      * Returns a pretty-printed JSON string of the errors.
      * @returns A string representation of the errors.

package/dist/types/result.d.ts

@@ -1,10 +1,18 @@
-import { HerbError } from "./error.js";
+import { HerbError } from "./errors.js";
 import { HerbWarning } from "./warning.js";
-export declare class Result {
+export declare abstract class Result {
     readonly source: string;
     readonly warnings: HerbWarning[];
     readonly errors: HerbError[];
     constructor(source: string, warnings?: HerbWarning[], errors?: HerbError[]);
-    success(): boolean;
-    failed(): boolean;
+    /**
+     * Determines if the parsing was successful.
+     * @returns `true` if there are no errors, otherwise `false`.
+     */
+    get successful(): boolean;
+    /**
+     * Determines if the parsing failed.
+     * @returns `true` if there are errors, otherwise `false`.
+     */
+    get failed(): boolean;
 }

package/dist/types/visitor.d.ts

@@ -1,11 +1,36 @@
-import { Node } from "./node.js";
-/**
- * Represents a visitor that can traverse nodes.
- */
+import { Node, DocumentNode, LiteralNode, HTMLOpenTagNode, HTMLCloseTagNode, HTMLSelfCloseTagNode, HTMLElementNode, HTMLAttributeValueNode, HTMLAttributeNameNode, HTMLAttributeNode, HTMLTextNode, HTMLCommentNode, HTMLDoctypeNode, WhitespaceNode, ERBContentNode, ERBEndNode, ERBElseNode, ERBIfNode, ERBBlockNode, ERBWhenNode, ERBCaseNode, ERBCaseMatchNode, ERBWhileNode, ERBUntilNode, ERBForNode, ERBRescueNode, ERBEnsureNode, ERBBeginNode, ERBUnlessNode, ERBYieldNode, ERBInNode } from "./nodes.js";
 export declare class Visitor {
-    /**
-     * Visits a node and performs an action.
-     * @param node - The node to visit.
-     */
-    visit(node: Node): void;
+    visit(node: Node | null | undefined): void;
+    visitAll(nodes: (Node | null | undefined)[]): void;
+    visitChildNodes(node: Node): void;
+    visitDocumentNode(node: DocumentNode): void;
+    visitLiteralNode(node: LiteralNode): void;
+    visitHTMLOpenTagNode(node: HTMLOpenTagNode): void;
+    visitHTMLCloseTagNode(node: HTMLCloseTagNode): void;
+    visitHTMLSelfCloseTagNode(node: HTMLSelfCloseTagNode): void;
+    visitHTMLElementNode(node: HTMLElementNode): void;
+    visitHTMLAttributeValueNode(node: HTMLAttributeValueNode): void;
+    visitHTMLAttributeNameNode(node: HTMLAttributeNameNode): void;
+    visitHTMLAttributeNode(node: HTMLAttributeNode): void;
+    visitHTMLTextNode(node: HTMLTextNode): void;
+    visitHTMLCommentNode(node: HTMLCommentNode): void;
+    visitHTMLDoctypeNode(node: HTMLDoctypeNode): void;
+    visitWhitespaceNode(node: WhitespaceNode): void;
+    visitERBContentNode(node: ERBContentNode): void;
+    visitERBEndNode(node: ERBEndNode): void;
+    visitERBElseNode(node: ERBElseNode): void;
+    visitERBIfNode(node: ERBIfNode): void;
+    visitERBBlockNode(node: ERBBlockNode): void;
+    visitERBWhenNode(node: ERBWhenNode): void;
+    visitERBCaseNode(node: ERBCaseNode): void;
+    visitERBCaseMatchNode(node: ERBCaseMatchNode): void;
+    visitERBWhileNode(node: ERBWhileNode): void;
+    visitERBUntilNode(node: ERBUntilNode): void;
+    visitERBForNode(node: ERBForNode): void;
+    visitERBRescueNode(node: ERBRescueNode): void;
+    visitERBEnsureNode(node: ERBEnsureNode): void;
+    visitERBBeginNode(node: ERBBeginNode): void;
+    visitERBUnlessNode(node: ERBUnlessNode): void;
+    visitERBYieldNode(node: ERBYieldNode): void;
+    visitERBInNode(node: ERBInNode): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herb-tools/core",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
   "license": "MIT",
   "homepage": "https://herb-tools.dev",
@@ -30,16 +30,7 @@
     }
   },
   "dependencies": {},
-  "devDependencies": {
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "rimraf": "^6.0.1",
-    "rollup": "^4.35.0",
-    "tslib": "^2.8.1",
-    "typescript": "^5.8.2",
-    "vitest": "^3.0.0"
-  },
+  "devDependencies": {},
   "files": [
     "package.json",
     "README.md",

package/src/errors.ts

@@ -3,7 +3,6 @@
 
 import { Location, SerializedLocation } from "./location.js"
 import { Token, SerializedToken } from "./token.js"
-import { HerbError, SerializedHerbError } from "./error.js"
 
 type HerbDiagnostic = {
   line: number
@@ -27,21 +26,40 @@ export type HerbErrorType =
 
 export type SerializedErrorType = string
 
-export function fromSerializedError(error: SerializedHerbError): HerbError {
-  switch (error.type) {
-    case "UNEXPECTED_ERROR": return UnexpectedError.from(error as SerializedUnexpectedError);
-    case "UNEXPECTED_TOKEN_ERROR": return UnexpectedTokenError.from(error as SerializedUnexpectedTokenError);
-    case "MISSING_OPENING_TAG_ERROR": return MissingOpeningTagError.from(error as SerializedMissingOpeningTagError);
-    case "MISSING_CLOSING_TAG_ERROR": return MissingClosingTagError.from(error as SerializedMissingClosingTagError);
-    case "TAG_NAMES_MISMATCH_ERROR": return TagNamesMismatchError.from(error as SerializedTagNamesMismatchError);
-    case "QUOTES_MISMATCH_ERROR": return QuotesMismatchError.from(error as SerializedQuotesMismatchError);
-    case "VOID_ELEMENT_CLOSING_TAG_ERROR": return VoidElementClosingTagError.from(error as SerializedVoidElementClosingTagError);
-    case "UNCLOSED_ELEMENT_ERROR": return UnclosedElementError.from(error as SerializedUnclosedElementError);
-    case "RUBY_PARSE_ERROR": return RubyParseError.from(error as SerializedRubyParseError);
+export interface SerializedHerbError {
+  type: string
+  message: string
+  location: SerializedLocation
+}
 
-    default:
-      throw new Error(`Unknown node type: ${error.type}`);
+export abstract class HerbError {
+  readonly type: string
+  readonly message: string
+  readonly location: Location
+
+  static from(error: SerializedHerbError): HerbError {
+    return fromSerializedError(error)
+  }
+
+  constructor(type: string, message: string, location: Location) {
+    this.type = type
+    this.message = message
+    this.location = location
+  }
+
+  toJSON(): SerializedHerbError {
+    return {
+      type: this.type,
+      message: this.message,
+      location: this.location.toJSON(),
+    }
+  }
+
+  inspect(): string {
+    return this.treeInspect(0)
   }
+
+  abstract treeInspect(indent?: number): string
 }
 
 export interface SerializedUnexpectedError {
@@ -818,3 +836,20 @@ export class RubyParseError extends HerbError {
   }
 }
 
+
+export function fromSerializedError(error: SerializedHerbError): HerbError {
+  switch (error.type) {
+    case "UNEXPECTED_ERROR": return UnexpectedError.from(error as SerializedUnexpectedError);
+    case "UNEXPECTED_TOKEN_ERROR": return UnexpectedTokenError.from(error as SerializedUnexpectedTokenError);
+    case "MISSING_OPENING_TAG_ERROR": return MissingOpeningTagError.from(error as SerializedMissingOpeningTagError);
+    case "MISSING_CLOSING_TAG_ERROR": return MissingClosingTagError.from(error as SerializedMissingClosingTagError);
+    case "TAG_NAMES_MISMATCH_ERROR": return TagNamesMismatchError.from(error as SerializedTagNamesMismatchError);
+    case "QUOTES_MISMATCH_ERROR": return QuotesMismatchError.from(error as SerializedQuotesMismatchError);
+    case "VOID_ELEMENT_CLOSING_TAG_ERROR": return VoidElementClosingTagError.from(error as SerializedVoidElementClosingTagError);
+    case "UNCLOSED_ELEMENT_ERROR": return UnclosedElementError.from(error as SerializedUnclosedElementError);
+    case "RUBY_PARSE_ERROR": return RubyParseError.from(error as SerializedRubyParseError);
+
+    default:
+      throw new Error(`Unknown node type: ${error.type}`);
+  }
+}

package/src/index.ts

@@ -1,4 +1,3 @@
-export * from "./ast.js"
 export * from "./backend.js"
 export * from "./errors.js"
 export * from "./herb-backend.js"
@@ -13,3 +12,4 @@ export * from "./token-list.js"
 export * from "./token.js"
 export * from "./util.js"
 export * from "./visitor.js"
+export * from "./warning.js"