@herb-tools/core 0.3.1 → 0.4.1

package/README.md

@@ -1,15 +1,27 @@
-## Herb Core
+# Herb Core
 
-##### Package: [`@herb-tools/core`](https://www.npmjs.com/package/@herb-tools/core)
+**Package**: [`@herb-tools/core`](https://www.npmjs.com/package/@herb-tools/core)
 
 ---
 
 Core module exporting shared interfaces, AST node definitions, and common utilities for Herb (no direct parsing functionality).
 
-## Building
+### Installation
 
-Run `nx build core` to build the library.
+:::code-group
+```shell [npm]
+npm add @herb-tools/core
+```
 
-## Running unit tests
+```shell [pnpm]
+pnpm add @herb-tools/core
+```
 
-Run `nx test core` to execute the unit tests via [Vitest](https://vitest.dev/).
+```shell [yarn]
+yarn add @herb-tools/core
+```
+
+```shell [bun]
+bun add @herb-tools/core
+```
+:::

package/dist/herb-core.browser.js

@@ -32,6 +32,22 @@ function ensureLibHerbBackend(object, libherbpath = "unknown") {
     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;
@@ -163,11 +179,16 @@ 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/templates/javascript/packages/core/src/errors.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-4/templates/javascript/packages/core/src/errors.ts.erb
 class HerbError {
     type;
     message;
     location;
+    severity = "error";
+    source = "parser";
+    get code() {
+        return this.type;
+    }
     static from(error) {
         return fromSerializedError(error);
     }
@@ -216,21 +237,15 @@ class UnexpectedError extends HerbError {
             found: this.found,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        // no-op for description
-        // no-op for expected
-        // no-op for found
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -267,29 +282,15 @@ class UnexpectedTokenError extends HerbError {
             found: this.found ? this.found.toJSON() : null,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        // no-op for expected_type
-        if (this.found) {
-            diagnostics.push({
-                line: this.found.location.start.line,
-                column: this.found.location.start.column,
-                endLine: this.found.location.end.line,
-                endColumn: this.found.location.end.column,
-                message: `found "${(this.found.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -321,28 +322,15 @@ class MissingOpeningTagError extends HerbError {
             closing_tag: this.closing_tag ? this.closing_tag.toJSON() : null,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        if (this.closing_tag) {
-            diagnostics.push({
-                line: this.closing_tag.location.start.line,
-                column: this.closing_tag.location.start.column,
-                endLine: this.closing_tag.location.end.line,
-                endColumn: this.closing_tag.location.end.column,
-                message: `closing_tag "${(this.closing_tag.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -373,28 +361,15 @@ class MissingClosingTagError extends HerbError {
             opening_tag: this.opening_tag ? this.opening_tag.toJSON() : null,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        if (this.opening_tag) {
-            diagnostics.push({
-                line: this.opening_tag.location.start.line,
-                column: this.opening_tag.location.start.column,
-                endLine: this.opening_tag.location.end.line,
-                endColumn: this.opening_tag.location.end.column,
-                message: `opening_tag "${(this.opening_tag.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -429,38 +404,15 @@ class TagNamesMismatchError extends HerbError {
             closing_tag: this.closing_tag ? this.closing_tag.toJSON() : null,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        if (this.opening_tag) {
-            diagnostics.push({
-                line: this.opening_tag.location.start.line,
-                column: this.opening_tag.location.start.column,
-                endLine: this.opening_tag.location.end.line,
-                endColumn: this.opening_tag.location.end.column,
-                message: `opening_tag "${(this.opening_tag.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        if (this.closing_tag) {
-            diagnostics.push({
-                line: this.closing_tag.location.start.line,
-                column: this.closing_tag.location.start.column,
-                endLine: this.closing_tag.location.end.line,
-                endColumn: this.closing_tag.location.end.column,
-                message: `closing_tag "${(this.closing_tag.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -496,38 +448,15 @@ class QuotesMismatchError extends HerbError {
             closing_quote: this.closing_quote ? this.closing_quote.toJSON() : null,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        if (this.opening_quote) {
-            diagnostics.push({
-                line: this.opening_quote.location.start.line,
-                column: this.opening_quote.location.start.column,
-                endLine: this.opening_quote.location.end.line,
-                endColumn: this.opening_quote.location.end.column,
-                message: `opening_quote "${(this.opening_quote.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        if (this.closing_quote) {
-            diagnostics.push({
-                line: this.closing_quote.location.start.line,
-                column: this.closing_quote.location.start.column,
-                endLine: this.closing_quote.location.end.line,
-                endColumn: this.closing_quote.location.end.column,
-                message: `closing_quote "${(this.closing_quote.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -567,30 +496,15 @@ class VoidElementClosingTagError extends HerbError {
             found: this.found,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        if (this.tag_name) {
-            diagnostics.push({
-                line: this.tag_name.location.start.line,
-                column: this.tag_name.location.start.column,
-                endLine: this.tag_name.location.end.line,
-                endColumn: this.tag_name.location.end.column,
-                message: `tag_name "${(this.tag_name.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        // no-op for expected
-        // no-op for found
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -623,28 +537,15 @@ class UnclosedElementError extends HerbError {
             opening_tag: this.opening_tag ? this.opening_tag.toJSON() : null,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        if (this.opening_tag) {
-            diagnostics.push({
-                line: this.opening_tag.location.start.line,
-                column: this.opening_tag.location.start.column,
-                endLine: this.opening_tag.location.end.line,
-                endColumn: this.opening_tag.location.end.column,
-                message: `opening_tag "${(this.opening_tag.value)}" is here`,
-                severity: 'info'
-            });
-        }
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -683,21 +584,15 @@ class RubyParseError extends HerbError {
             level: this.level,
         };
     }
-    toDiagnostics() {
-        const diagnostics = [
-            {
-                line: this.location.start.line,
-                column: this.location.start.column,
-                endLine: this.location.end.line,
-                endColumn: this.location.end.column,
-                message: this.message,
-                severity: 'error'
-            }
-        ];
-        // no-op for error_message
-        // no-op for diagnostic_id
-        // no-op for level
-        return diagnostics;
+    toMonacoDiagnostic() {
+        return {
+            line: this.location.start.line,
+            column: this.location.start.column,
+            endLine: this.location.end.line,
+            endColumn: this.location.end.column,
+            message: this.message,
+            severity: 'error'
+        };
     }
     treeInspect() {
         let output = "";
@@ -726,7 +621,7 @@ function fromSerializedError(error) {
 }
 
 var name = "@herb-tools/core";
-var version = "0.3.1";
+var version = "0.4.1";
 var packageJSON = {
 	name: name,
 	version: version};
@@ -782,6 +677,9 @@ class TokenList {
     get length() {
         return this.list.length;
     }
+    get tokens() {
+        return this.list;
+    }
     [Symbol.iterator]() {
         return this.list[Symbol.iterator]();
     }
@@ -875,7 +773,7 @@ class LexResult 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/templates/javascript/packages/core/src/nodes.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-4/templates/javascript/packages/core/src/nodes.ts.erb
 class Node {
     type;
     location;
@@ -2868,6 +2766,28 @@ function fromSerializedNode(node) {
             throw new Error(`Unknown node type: ${node.type}`);
     }
 }
+const ERBNodeClasses = [
+    ERBContentNode,
+    ERBEndNode,
+    ERBElseNode,
+    ERBIfNode,
+    ERBBlockNode,
+    ERBWhenNode,
+    ERBCaseNode,
+    ERBCaseMatchNode,
+    ERBWhileNode,
+    ERBUntilNode,
+    ERBForNode,
+    ERBRescueNode,
+    ERBEnsureNode,
+    ERBBeginNode,
+    ERBUnlessNode,
+    ERBYieldNode,
+    ERBInNode,
+];
+function isERBNode(node) {
+    return node.constructor.name.startsWith("ERB");
+}
 
 /**
  * Represents the result of a parsing operation, extending the base `Result` class.
@@ -2900,15 +2820,15 @@ class ParseResult extends Result {
      * @returns `true` if there are errors, otherwise `false`.
      */
     get failed() {
-        // TODO: this should probably be recursive as noted in the Ruby version
-        return this.errors.length > 0 || this.value.errors.length > 0;
+        // Consider errors on this result and recursively in the document tree
+        return this.recursiveErrors().length > 0;
     }
     /**
      * Determines if the parsing was successful.
      * @returns `true` if there are no errors, otherwise `false`.
      */
     get successful() {
-        return this.errors.length === 0;
+        return !this.failed;
     }
     /**
      * Returns a pretty-printed JSON string of the errors.
@@ -3054,7 +2974,7 @@ class HerbBackend {
 }
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release/templates/javascript/packages/core/src/visitor.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-4/templates/javascript/packages/core/src/visitor.ts.erb
 class Visitor {
     visit(node) {
         if (!node)
@@ -3159,5 +3079,5 @@ class Visitor {
     }
 }
 
-export { DocumentNode, ERBBeginNode, ERBBlockNode, ERBCaseMatchNode, ERBCaseNode, ERBContentNode, ERBElseNode, ERBEndNode, ERBEnsureNode, ERBForNode, ERBIfNode, ERBInNode, ERBRescueNode, ERBUnlessNode, ERBUntilNode, ERBWhenNode, ERBWhileNode, ERBYieldNode, HTMLAttributeNameNode, HTMLAttributeNode, HTMLAttributeValueNode, HTMLCloseTagNode, HTMLCommentNode, HTMLDoctypeNode, HTMLElementNode, HTMLOpenTagNode, HTMLSelfCloseTagNode, HTMLTextNode, HerbBackend, HerbError, HerbWarning, LexResult, LiteralNode, Location, MissingClosingTagError, MissingOpeningTagError, Node, ParseResult, Position, QuotesMismatchError, Range, Result, RubyParseError, TagNamesMismatchError, Token, TokenList, UnclosedElementError, UnexpectedError, UnexpectedTokenError, Visitor, VoidElementClosingTagError, WhitespaceNode, _TYPECHECK, convertToUTF8, ensureLibHerbBackend, ensureString, fromSerializedError, fromSerializedNode, isLibHerbBackend };
+export { DocumentNode, ERBBeginNode, ERBBlockNode, ERBCaseMatchNode, ERBCaseNode, ERBContentNode, ERBElseNode, ERBEndNode, ERBEnsureNode, ERBForNode, ERBIfNode, ERBInNode, ERBNodeClasses, ERBRescueNode, ERBUnlessNode, ERBUntilNode, ERBWhenNode, ERBWhileNode, ERBYieldNode, HTMLAttributeNameNode, HTMLAttributeNode, HTMLAttributeValueNode, HTMLCloseTagNode, HTMLCommentNode, HTMLDoctypeNode, HTMLElementNode, HTMLOpenTagNode, HTMLSelfCloseTagNode, HTMLTextNode, HerbBackend, HerbError, HerbWarning, LexResult, LiteralNode, Location, MissingClosingTagError, MissingOpeningTagError, Node, ParseResult, Position, QuotesMismatchError, Range, Result, RubyParseError, TagNamesMismatchError, Token, TokenList, UnclosedElementError, UnexpectedError, UnexpectedTokenError, Visitor, VoidElementClosingTagError, WhitespaceNode, _TYPECHECK, convertToUTF8, ensureLibHerbBackend, ensureString, fromSerializedError, fromSerializedNode, isERBNode, isLibHerbBackend, toMonacoDiagnostic };
 //# sourceMappingURL=herb-core.browser.js.map