@herb-tools/core 0.3.1 → 0.4.0

package/dist/types/errors.d.ts

@@ -1,13 +1,6 @@
 import { Location, SerializedLocation } from "./location.js";
 import { Token, SerializedToken } from "./token.js";
-type HerbDiagnostic = {
-    line: number;
-    column: number;
-    endLine: number;
-    endColumn: number;
-    message: string;
-    severity: "error" | "warning" | "info";
-};
+import { Diagnostic, MonacoDiagnostic } from "./diagnostic.js";
 export type HerbErrorType = "UNEXPECTED_ERROR" | "UNEXPECTED_TOKEN_ERROR" | "MISSING_OPENING_TAG_ERROR" | "MISSING_CLOSING_TAG_ERROR" | "TAG_NAMES_MISMATCH_ERROR" | "QUOTES_MISMATCH_ERROR" | "VOID_ELEMENT_CLOSING_TAG_ERROR" | "UNCLOSED_ELEMENT_ERROR" | "RUBY_PARSE_ERROR";
 export type SerializedErrorType = string;
 export interface SerializedHerbError {
@@ -15,10 +8,13 @@ export interface SerializedHerbError {
     message: string;
     location: SerializedLocation;
 }
-export declare abstract class HerbError {
+export declare abstract class HerbError implements Diagnostic {
     readonly type: string;
     readonly message: string;
     readonly location: Location;
+    readonly severity: "error" | "warning" | "info" | "hint";
+    readonly source: string;
+    get code(): string;
     static from(error: SerializedHerbError): HerbError;
     constructor(type: string, message: string, location: Location);
     toJSON(): SerializedHerbError;
@@ -48,7 +44,7 @@ export declare class UnexpectedError extends HerbError {
     static from(data: SerializedUnexpectedError): UnexpectedError;
     constructor(props: UnexpectedErrorProps);
     toJSON(): SerializedUnexpectedError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export interface SerializedUnexpectedTokenError {
@@ -71,7 +67,7 @@ export declare class UnexpectedTokenError extends HerbError {
     static from(data: SerializedUnexpectedTokenError): UnexpectedTokenError;
     constructor(props: UnexpectedTokenErrorProps);
     toJSON(): SerializedUnexpectedTokenError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export interface SerializedMissingOpeningTagError {
@@ -91,7 +87,7 @@ export declare class MissingOpeningTagError extends HerbError {
     static from(data: SerializedMissingOpeningTagError): MissingOpeningTagError;
     constructor(props: MissingOpeningTagErrorProps);
     toJSON(): SerializedMissingOpeningTagError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export interface SerializedMissingClosingTagError {
@@ -111,7 +107,7 @@ export declare class MissingClosingTagError extends HerbError {
     static from(data: SerializedMissingClosingTagError): MissingClosingTagError;
     constructor(props: MissingClosingTagErrorProps);
     toJSON(): SerializedMissingClosingTagError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export interface SerializedTagNamesMismatchError {
@@ -134,7 +130,7 @@ export declare class TagNamesMismatchError extends HerbError {
     static from(data: SerializedTagNamesMismatchError): TagNamesMismatchError;
     constructor(props: TagNamesMismatchErrorProps);
     toJSON(): SerializedTagNamesMismatchError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export interface SerializedQuotesMismatchError {
@@ -157,7 +153,7 @@ export declare class QuotesMismatchError extends HerbError {
     static from(data: SerializedQuotesMismatchError): QuotesMismatchError;
     constructor(props: QuotesMismatchErrorProps);
     toJSON(): SerializedQuotesMismatchError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export interface SerializedVoidElementClosingTagError {
@@ -183,7 +179,7 @@ export declare class VoidElementClosingTagError extends HerbError {
     static from(data: SerializedVoidElementClosingTagError): VoidElementClosingTagError;
     constructor(props: VoidElementClosingTagErrorProps);
     toJSON(): SerializedVoidElementClosingTagError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export interface SerializedUnclosedElementError {
@@ -203,7 +199,7 @@ export declare class UnclosedElementError extends HerbError {
     static from(data: SerializedUnclosedElementError): UnclosedElementError;
     constructor(props: UnclosedElementErrorProps);
     toJSON(): SerializedUnclosedElementError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export interface SerializedRubyParseError {
@@ -229,8 +225,7 @@ export declare class RubyParseError extends HerbError {
     static from(data: SerializedRubyParseError): RubyParseError;
     constructor(props: RubyParseErrorProps);
     toJSON(): SerializedRubyParseError;
-    toDiagnostics(): HerbDiagnostic[];
+    toMonacoDiagnostic(): MonacoDiagnostic;
     treeInspect(): string;
 }
 export declare function fromSerializedError(error: SerializedHerbError): HerbError;
-export {};

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./backend.js";
+export * from "./diagnostic.js";
 export * from "./errors.js";
 export * from "./herb-backend.js";
 export * from "./lex-result.js";

package/dist/types/nodes.d.ts

@@ -15,7 +15,6 @@ export interface BaseNodeProps {
     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;
@@ -850,3 +849,8 @@ export declare class ERBInNode extends Node {
     treeInspect(): string;
 }
 export declare function fromSerializedNode(node: SerializedNode): Node;
+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 type ERBNodeType = Extract<NodeType, `AST_ERB_${string}`>;
+export type ERBNode = ERBContentNode | ERBEndNode | ERBElseNode | ERBIfNode | ERBBlockNode | ERBWhenNode | ERBCaseNode | ERBCaseMatchNode | ERBWhileNode | ERBUntilNode | ERBForNode | ERBRescueNode | ERBEnsureNode | ERBBeginNode | ERBUnlessNode | ERBYieldNode | ERBInNode;
+export declare const ERBNodeClasses: (typeof ERBContentNode | typeof ERBEndNode | typeof ERBElseNode | typeof ERBIfNode | typeof ERBBlockNode | typeof ERBWhenNode | typeof ERBCaseNode | typeof ERBCaseMatchNode | typeof ERBWhileNode | typeof ERBUntilNode | typeof ERBForNode | typeof ERBRescueNode | typeof ERBEnsureNode | typeof ERBBeginNode | typeof ERBUnlessNode | typeof ERBYieldNode | typeof ERBInNode)[];
+export declare function isERBNode(node: Node): node is ERBNode;

package/dist/types/token-list.d.ts

@@ -5,6 +5,7 @@ export declare class TokenList implements Iterable<Token> {
     static from(list: SerializedTokenList): TokenList;
     constructor(list: Token[]);
     get length(): number;
+    get tokens(): Token[];
     [Symbol.iterator](): Iterator<Token>;
     at(index: number): Token | undefined;
     forEach(callback: (token: Token, index: number, array: Token[]) => void): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herb-tools/core",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Core module exporting shared interfaces, AST node definitions, and common utilities for Herb",
   "type": "module",
   "license": "MIT",
@@ -31,7 +31,6 @@
     }
   },
   "dependencies": {},
-  "devDependencies": {},
   "files": [
     "package.json",
     "README.md",

package/src/diagnostic.ts

@@ -0,0 +1,78 @@
+import { Location, SerializedLocation } from "./location.js"
+
+export type DiagnosticSeverity = "error" | "warning" | "info" | "hint"
+
+/**
+ * Base interface for all diagnostic information in Herb tooling.
+ * This includes parser errors, lexer errors, lint offenses, and any other
+ * issues that need to be reported to users.
+ */
+export interface Diagnostic {
+  /**
+   * The diagnostic message describing the issue
+   */
+  message: string
+
+  /**
+   * The location in the source where this diagnostic applies
+   */
+  location: Location
+
+  /**
+   * The severity level of the diagnostic
+   */
+  severity: DiagnosticSeverity
+
+  /**
+   * Optional diagnostic code for categorization (e.g., "E0001", "W0042")
+   */
+  code?: string
+
+  /**
+   * Optional source that generated this diagnostic (e.g., "parser", "linter", "lexer")
+   */
+  source?: string
+}
+
+/**
+ * Serialized form of a Diagnostic for JSON representation
+ */
+export interface SerializedDiagnostic {
+  message: string
+  location: SerializedLocation
+  severity: DiagnosticSeverity
+  code?: string
+  source?: string
+}
+
+export type MonacoSeverity = "error" | "warning" | "info"
+
+/**
+ * Monaco/VSCode-compatible diagnostic format for editor integration
+ */
+export type MonacoDiagnostic = {
+  line: number
+  column: number
+  endLine: number
+  endColumn: number
+  message: string
+  severity: MonacoSeverity
+}
+
+/**
+ * Converts a Diagnostic to Monaco/VSCode-compatible MonacoDiagnostic format
+ */
+export function toMonacoDiagnostic(diagnostic: Diagnostic): MonacoDiagnostic {
+  const { message, location } = diagnostic
+
+  const severity: MonacoSeverity = 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
+  }
+}

package/src/errors.ts

@@ -3,15 +3,7 @@
 
 import { Location, SerializedLocation } from "./location.js"
 import { Token, SerializedToken } from "./token.js"
-
-type HerbDiagnostic = {
-  line: number
-  column: number
-  endLine: number
-  endColumn: number
-  message: string
-  severity: "error" | "warning" | "info"
-}
+import { Diagnostic, MonacoDiagnostic } from "./diagnostic.js"
 
 export type HerbErrorType =
   | "UNEXPECTED_ERROR"
@@ -32,10 +24,16 @@ export interface SerializedHerbError {
   location: SerializedLocation
 }
 
-export abstract class HerbError {
+export abstract class HerbError implements Diagnostic {
   readonly type: string
   readonly message: string
   readonly location: Location
+  readonly severity: "error" | "warning" | "info" | "hint" = "error"
+  readonly source: string = "parser"
+
+  get code(): string {
+    return this.type
+  }
 
   static from(error: SerializedHerbError): HerbError {
     return fromSerializedError(error)
@@ -114,23 +112,15 @@ export class UnexpectedError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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(): MonacoDiagnostic {
+    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(): string {
@@ -192,32 +182,15 @@ export class UnexpectedTokenError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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'
-      })
+  toMonacoDiagnostic(): MonacoDiagnostic {
+    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'
     }
-
-
-    return diagnostics
   }
 
   treeInspect(): string {
@@ -272,31 +245,15 @@ export class MissingOpeningTagError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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'
-      })
+  toMonacoDiagnostic(): MonacoDiagnostic {
+    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'
     }
-
-
-    return diagnostics
   }
 
   treeInspect(): string {
@@ -350,31 +307,15 @@ export class MissingClosingTagError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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'
-      })
+  toMonacoDiagnostic(): MonacoDiagnostic {
+    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'
     }
-
-
-    return diagnostics
   }
 
   treeInspect(): string {
@@ -434,42 +375,15 @@ export class TagNamesMismatchError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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'
-      })
+  toMonacoDiagnostic(): MonacoDiagnostic {
+    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'
     }
-
-
-    return diagnostics
   }
 
   treeInspect(): string {
@@ -530,42 +444,15 @@ export class QuotesMismatchError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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'
-      })
+  toMonacoDiagnostic(): MonacoDiagnostic {
+    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'
     }
-
-
-    return diagnostics
   }
 
   treeInspect(): string {
@@ -632,33 +519,15 @@ export class VoidElementClosingTagError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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'
-      })
+  toMonacoDiagnostic(): MonacoDiagnostic {
+    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'
     }
-
-    // no-op for expected
-    // no-op for found
-
-    return diagnostics
   }
 
   treeInspect(): string {
@@ -714,31 +583,15 @@ export class UnclosedElementError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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'
-      })
+  toMonacoDiagnostic(): MonacoDiagnostic {
+    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'
     }
-
-
-    return diagnostics
   }
 
   treeInspect(): string {
@@ -804,23 +657,15 @@ export class RubyParseError extends HerbError {
     };
   }
 
-  toDiagnostics(): HerbDiagnostic[] {
-    const diagnostics: HerbDiagnostic[] = [
-      {
-        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(): MonacoDiagnostic {
+    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(): string {

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from "./backend.js"
+export * from "./diagnostic.js"
 export * from "./errors.js"
 export * from "./herb-backend.js"
 export * from "./lex-result.js"