@stackables/bridge-compiler 0.0.1

package/build/parser/lexer.js

@@ -0,0 +1,160 @@
+/**
+ * Chevrotain Lexer for the Bridge DSL.
+ *
+ * Tokenizes .bridge source text into a stream consumed by the CstParser.
+ * Comments and whitespace are automatically skipped (placed on hidden channels).
+ */
+import { createToken, Lexer } from "chevrotain";
+// ── Whitespace & comments ──────────────────────────────────────────────────
+export const Newline = createToken({
+    name: "Newline",
+    pattern: /\r?\n/,
+    group: Lexer.SKIPPED,
+});
+export const WS = createToken({
+    name: "WS",
+    pattern: /[ \t]+/,
+    group: Lexer.SKIPPED,
+});
+export const Comment = createToken({
+    name: "Comment",
+    pattern: /#[^\r\n]*/,
+    group: Lexer.SKIPPED,
+});
+// ── Identifiers (defined first — keywords reference via longer_alt) ────────
+export const Identifier = createToken({
+    name: "Identifier",
+    pattern: /[a-zA-Z_][\w-]*/,
+});
+// ── Keywords ───────────────────────────────────────────────────────────────
+export const VersionKw = createToken({ name: "VersionKw", pattern: /version/i, longer_alt: Identifier });
+export const ToolKw = createToken({ name: "ToolKw", pattern: /tool/i, longer_alt: Identifier });
+export const BridgeKw = createToken({ name: "BridgeKw", pattern: /bridge/i, longer_alt: Identifier });
+export const DefineKw = createToken({ name: "DefineKw", pattern: /define/i, longer_alt: Identifier });
+export const ConstKw = createToken({ name: "ConstKw", pattern: /const/i, longer_alt: Identifier });
+export const WithKw = createToken({ name: "WithKw", pattern: /with/i, longer_alt: Identifier });
+export const AsKw = createToken({ name: "AsKw", pattern: /as/i, longer_alt: Identifier });
+export const FromKw = createToken({ name: "FromKw", pattern: /from/i, longer_alt: Identifier });
+export const InputKw = createToken({ name: "InputKw", pattern: /input/i, longer_alt: Identifier });
+export const OutputKw = createToken({ name: "OutputKw", pattern: /output/i, longer_alt: Identifier });
+export const ContextKw = createToken({ name: "ContextKw", pattern: /context/i, longer_alt: Identifier });
+export const OnKw = createToken({ name: "OnKw", pattern: /on/i, longer_alt: Identifier });
+export const ErrorKw = createToken({ name: "ErrorKw", pattern: /error/i, longer_alt: Identifier });
+export const ForceKw = createToken({ name: "ForceKw", pattern: /force/i, longer_alt: Identifier });
+export const AliasKw = createToken({ name: "AliasKw", pattern: /alias/i, longer_alt: Identifier });
+export const CatchKw = createToken({ name: "CatchKw", pattern: /catch/i, longer_alt: Identifier });
+export const AndKw = createToken({ name: "AndKw", pattern: /and/, longer_alt: Identifier });
+export const OrKw = createToken({ name: "OrKw", pattern: /or/, longer_alt: Identifier });
+export const NotKw = createToken({ name: "NotKw", pattern: /not/, longer_alt: Identifier });
+export const ThrowKw = createToken({ name: "ThrowKw", pattern: /throw/, longer_alt: Identifier });
+export const PanicKw = createToken({ name: "PanicKw", pattern: /panic/, longer_alt: Identifier });
+export const ContinueKw = createToken({ name: "ContinueKw", pattern: /continue/, longer_alt: Identifier });
+export const BreakKw = createToken({ name: "BreakKw", pattern: /break/, longer_alt: Identifier });
+// ── Operators & punctuation ────────────────────────────────────────────────
+export const Arrow = createToken({ name: "Arrow", pattern: /<-/ });
+export const NullCoalesce = createToken({ name: "NullCoalesce", pattern: /\|\|/ });
+export const ErrorCoalesce = createToken({ name: "ErrorCoalesce", pattern: /\?\?/ });
+export const SafeNav = createToken({ name: "SafeNav", pattern: /\?\./ });
+export const QuestionMark = createToken({ name: "QuestionMark", pattern: /\?/ });
+export const GreaterEqual = createToken({ name: "GreaterEqual", pattern: />=/ });
+export const LessEqual = createToken({ name: "LessEqual", pattern: /<=/ });
+export const DoubleEquals = createToken({ name: "DoubleEquals", pattern: /==/ });
+export const NotEquals = createToken({ name: "NotEquals", pattern: /!=/ });
+export const GreaterThan = createToken({ name: "GreaterThan", pattern: />/ });
+export const LessThan = createToken({ name: "LessThan", pattern: /</ });
+export const Star = createToken({ name: "Star", pattern: /\*/ });
+export const Plus = createToken({ name: "Plus", pattern: /\+/ });
+export const LParen = createToken({ name: "LParen", pattern: /\(/ });
+export const RParen = createToken({ name: "RParen", pattern: /\)/ });
+export const LCurly = createToken({ name: "LCurly", pattern: /\{/ });
+export const RCurly = createToken({ name: "RCurly", pattern: /\}/ });
+export const LSquare = createToken({ name: "LSquare", pattern: /\[/ });
+export const RSquare = createToken({ name: "RSquare", pattern: /\]/ });
+export const Equals = createToken({ name: "Equals", pattern: /=/ });
+export const Dot = createToken({ name: "Dot", pattern: /\./ });
+export const Colon = createToken({ name: "Colon", pattern: /:/ });
+export const Comma = createToken({ name: "Comma", pattern: /,/ });
+// ── Literals ───────────────────────────────────────────────────────────────
+export const StringLiteral = createToken({
+    name: "StringLiteral",
+    pattern: /"(?:[^"\\]|\\.)*"/,
+});
+export const NumberLiteral = createToken({
+    name: "NumberLiteral",
+    pattern: /-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?/,
+});
+export const TrueLiteral = createToken({ name: "TrueLiteral", pattern: /true/, longer_alt: Identifier });
+export const FalseLiteral = createToken({ name: "FalseLiteral", pattern: /false/, longer_alt: Identifier });
+export const NullLiteral = createToken({ name: "NullLiteral", pattern: /null/, longer_alt: Identifier });
+export const PathToken = createToken({
+    name: "PathToken",
+    pattern: /\/[\w./-]+/,
+});
+export const Slash = createToken({ name: "Slash", pattern: /\// });
+export const Minus = createToken({ name: "Minus", pattern: /-/ });
+// ── Token ordering ─────────────────────────────────────────────────────────
+export const allTokens = [
+    WS,
+    Comment,
+    Newline,
+    Arrow,
+    NullCoalesce,
+    ErrorCoalesce,
+    SafeNav,
+    QuestionMark,
+    GreaterEqual,
+    LessEqual,
+    DoubleEquals,
+    NotEquals,
+    GreaterThan,
+    LessThan,
+    Star,
+    Plus,
+    LParen,
+    RParen,
+    LCurly,
+    RCurly,
+    LSquare,
+    RSquare,
+    Equals,
+    Dot,
+    Colon,
+    Comma,
+    StringLiteral,
+    // Keywords before Identifier (longer_alt prevents prefix stealing)
+    VersionKw,
+    ToolKw,
+    BridgeKw,
+    DefineKw,
+    ConstKw,
+    WithKw,
+    AsKw,
+    FromKw,
+    InputKw,
+    OutputKw,
+    ContextKw,
+    OnKw,
+    ErrorKw,
+    ForceKw,
+    AliasKw,
+    CatchKw,
+    AndKw,
+    OrKw,
+    NotKw,
+    ThrowKw,
+    PanicKw,
+    ContinueKw,
+    BreakKw,
+    TrueLiteral,
+    FalseLiteral,
+    NullLiteral,
+    PathToken,
+    Slash,
+    NumberLiteral,
+    Minus,
+    Identifier,
+];
+export const BridgeLexer = new Lexer(allTokens, {
+    ensureOptimizations: true,
+    positionTracking: "full",
+});

package/build/parser/parser.d.ts

@@ -0,0 +1,29 @@
+import type { Instruction } from "@stackables/bridge-core";
+export declare function parseBridgeChevrotain(text: string): Instruction[];
+export type BridgeDiagnostic = {
+    message: string;
+    severity: "error" | "warning";
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+};
+export type BridgeParseResult = {
+    instructions: Instruction[];
+    diagnostics: BridgeDiagnostic[];
+    /** 1-based start line for each top-level instruction */
+    startLines: Map<Instruction, number>;
+};
+/**
+ * Parse a Bridge DSL text and return both the AST and all diagnostics.
+ * Uses Chevrotain's error recovery — always returns a (possibly partial) AST
+ * even when the file has errors. Designed for LSP/IDE use.
+ */
+export declare function parseBridgeDiagnostics(text: string): BridgeParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/build/parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser/parser.ts"],"names":[],"mappings":"AAmEA,OAAO,KAAK,EAMV,WAAW,EAMZ,MAAM,yBAAyB,CAAC;AAimCjC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAEjE;AAID,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE;QACL,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,wDAAwD;IACxD,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA8DtE"}