@goreal-ai/echo-pdk 0.1.0

package/dist/parser/lexer.js

@@ -0,0 +1,491 @@
+/**
+ * @fileoverview Echo DSL Lexer - Multi-Mode Tokenization
+ *
+ * This file implements the lexer (tokenizer) for Echo DSL using Chevrotain.
+ * Uses multi-mode lexing to handle context-sensitive token recognition.
+ *
+ * LEXER MODES:
+ * - DEFAULT_MODE: Normal text content, looking for directives and variables
+ * - DIRECTIVE_MODE: Inside [#IF ...], [#SECTION ...], etc.
+ * - VARIABLE_MODE: Inside {{ ... }}
+ *
+ * TOKEN STREAM EXAMPLE:
+ *
+ * Input: "Hello {{name}}! [#IF {{age}} #gt(18)]Adult[END IF]"
+ *
+ * Tokens:
+ *   TEXT("Hello ")
+ *   VARIABLE_OPEN("{{")
+ *   IDENTIFIER("name")
+ *   VARIABLE_CLOSE("}}")
+ *   TEXT("! ")
+ *   IF_OPEN("[#IF")
+ *   VARIABLE_OPEN("{{")
+ *   IDENTIFIER("age")
+ *   VARIABLE_CLOSE("}}")
+ *   OPERATOR("#gt")
+ *   LPAREN("(")
+ *   NUMBER("18")
+ *   RPAREN(")")
+ *   CLOSE_BRACKET("]")
+ *   TEXT("Adult")
+ *   END_IF("[END IF]")
+ */
+import { createToken, Lexer, } from 'chevrotain';
+// =============================================================================
+// TOKEN DEFINITIONS
+// =============================================================================
+// -----------------------------------------------------------------------------
+// Token Categories
+// These are abstract tokens that serve as parent categories.
+// Mode-specific variants extend these categories so the parser can match either.
+// -----------------------------------------------------------------------------
+/**
+ * Category for variable open tokens ({{)
+ */
+export const VariableOpen = createToken({
+    name: 'VariableOpen',
+    pattern: Lexer.NA, // Abstract - no pattern
+});
+/**
+ * Category for variable close tokens (}})
+ */
+export const VariableClose = createToken({
+    name: 'VariableClose',
+    pattern: Lexer.NA, // Abstract - no pattern
+});
+// -----------------------------------------------------------------------------
+// Directive Keywords (Complete - no mode switch needed)
+// -----------------------------------------------------------------------------
+/**
+ * [END IF] - End of conditional block
+ */
+export const EndIf = createToken({
+    name: 'EndIf',
+    pattern: /\[END IF\]/,
+});
+/**
+ * [END SECTION] - End of section definition
+ */
+export const EndSection = createToken({
+    name: 'EndSection',
+    pattern: /\[END SECTION\]/,
+});
+/**
+ * [ELSE] - Else branch (complete token)
+ */
+export const Else = createToken({
+    name: 'Else',
+    pattern: /\[ELSE\]/,
+});
+// -----------------------------------------------------------------------------
+// Directive Openers (Push to DIRECTIVE_MODE)
+// -----------------------------------------------------------------------------
+/**
+ * [#IF - Start of conditional (followed by condition)
+ */
+export const IfOpen = createToken({
+    name: 'IfOpen',
+    pattern: /\[#IF/,
+    push_mode: 'DIRECTIVE_MODE',
+});
+/**
+ * [ELSE IF - Else-if branch (followed by condition)
+ */
+export const ElseIf = createToken({
+    name: 'ElseIf',
+    pattern: /\[ELSE IF/,
+    push_mode: 'DIRECTIVE_MODE',
+});
+/**
+ * [#SECTION - Section definition (followed by name="value")
+ */
+export const SectionOpen = createToken({
+    name: 'SectionOpen',
+    pattern: /\[#SECTION/,
+    push_mode: 'DIRECTIVE_MODE',
+});
+/**
+ * [#IMPORT - Import directive (followed by path)
+ */
+export const Import = createToken({
+    name: 'Import',
+    pattern: /\[#IMPORT/,
+    push_mode: 'DIRECTIVE_MODE',
+});
+/**
+ * [#INCLUDE - Include directive (followed by section name)
+ */
+export const Include = createToken({
+    name: 'Include',
+    pattern: /\[#INCLUDE/,
+    push_mode: 'DIRECTIVE_MODE',
+});
+// -----------------------------------------------------------------------------
+// Variable Syntax - Mode-Specific Variants
+// -----------------------------------------------------------------------------
+/**
+ * {{ in DEFAULT_MODE - pushes to VARIABLE_MODE
+ * Extends VariableOpen category so parser can match it.
+ */
+const VariableOpenDefault = createToken({
+    name: 'VariableOpenDefault',
+    pattern: /\{\{/,
+    push_mode: 'VARIABLE_MODE',
+    categories: [VariableOpen],
+});
+/**
+ * {{ in DIRECTIVE_MODE - no mode change (conditions are inline)
+ * Extends VariableOpen category so parser can match it.
+ */
+const VariableOpenDirective = createToken({
+    name: 'VariableOpenDirective',
+    pattern: /\{\{/,
+    categories: [VariableOpen],
+});
+/**
+ * }} in VARIABLE_MODE - pops back to previous mode
+ * Extends VariableClose category so parser can match it.
+ */
+const VariableCloseVariable = createToken({
+    name: 'VariableCloseVariable',
+    pattern: /\}\}/,
+    pop_mode: true,
+    categories: [VariableClose],
+});
+/**
+ * }} in DIRECTIVE_MODE - no mode change
+ * Extends VariableClose category so parser can match it.
+ */
+const VariableCloseDirective = createToken({
+    name: 'VariableCloseDirective',
+    pattern: /\}\}/,
+    categories: [VariableClose],
+});
+// -----------------------------------------------------------------------------
+// Directive Mode Tokens
+// -----------------------------------------------------------------------------
+/**
+ * ] - End of directive (pops back to DEFAULT_MODE)
+ */
+export const CloseBracket = createToken({
+    name: 'CloseBracket',
+    pattern: /\]/,
+    pop_mode: true,
+});
+/**
+ * Operator - #equals, #contains, #ai_judge, etc.
+ */
+export const Operator = createToken({
+    name: 'Operator',
+    pattern: /#[a-zA-Z_][a-zA-Z0-9_]*/,
+});
+/**
+ * Identifier - variable names, section names, etc.
+ * Supports nested paths: user.name, items[0]
+ */
+export const Identifier = createToken({
+    name: 'Identifier',
+    pattern: /[a-zA-Z_][a-zA-Z0-9_]*(?:\.[a-zA-Z_][a-zA-Z0-9_]*|\[\d+\])*/,
+});
+/**
+ * String literal - "value" or 'value'
+ */
+export const StringLiteral = createToken({
+    name: 'StringLiteral',
+    pattern: /"[^"]*"|'[^']*'/,
+});
+/**
+ * Number literal - integers and decimals
+ */
+export const NumberLiteral = createToken({
+    name: 'NumberLiteral',
+    pattern: /-?\d+(?:\.\d+)?/,
+});
+/**
+ * ( - Left parenthesis for operator arguments
+ * Pushes to OPERATOR_ARG_MODE to capture free-form text
+ */
+export const LParen = createToken({
+    name: 'LParen',
+    pattern: /\(/,
+    push_mode: 'OPERATOR_ARG_MODE',
+});
+/**
+ * ) - Right parenthesis for operator arguments (in DIRECTIVE_MODE)
+ */
+export const RParen = createToken({
+    name: 'RParen',
+    pattern: /\)/,
+});
+/**
+ * ) - Right parenthesis that pops from OPERATOR_ARG_MODE
+ */
+const RParenOperatorArg = createToken({
+    name: 'RParenOperatorArg',
+    pattern: /\)/,
+    pop_mode: true,
+    categories: [RParen], // Extends RParen so parser sees it the same
+});
+/**
+ * Operator argument text - captures everything until closing paren.
+ * This allows natural text like "My Girlfriend" without quotes.
+ */
+export const OperatorArgText = createToken({
+    name: 'OperatorArgText',
+    pattern: /[^)]+/,
+});
+/**
+ * , - Comma separator in argument lists
+ */
+export const Comma = createToken({
+    name: 'Comma',
+    pattern: /,/,
+});
+/**
+ * = - Equals sign for attribute assignment (name="value")
+ */
+export const Equals = createToken({
+    name: 'Equals',
+    pattern: /=/,
+});
+/**
+ * ?? - Default value operator
+ */
+export const DefaultOp = createToken({
+    name: 'DefaultOp',
+    pattern: /\?\?/,
+});
+/**
+ * Whitespace - skipped in directive and variable modes
+ */
+export const WhiteSpace = createToken({
+    name: 'WhiteSpace',
+    pattern: /\s+/,
+    group: Lexer.SKIPPED,
+});
+// -----------------------------------------------------------------------------
+// Text Content
+// -----------------------------------------------------------------------------
+/**
+ * Text - Plain text content.
+ *
+ * Matches any character sequence that doesn't start a special Echo construct.
+ * The lexer must stop when encountering:
+ * - `{{` (variable start)
+ * - `[#` (directive start: [#IF, [#SECTION, [#IMPORT, [#INCLUDE)
+ * - `[E` (branch/end markers: [ELSE], [ELSE IF, [END IF], [END SECTION])
+ *
+ * REGEX BREAKDOWN: /(?:[^\[{]|\[(?![#E])|\{(?!\{))+/
+ *
+ *   (?:                    Non-capturing group containing three alternatives:
+ *   │
+ *   ├─ [^\[{]              Alt 1: Any character EXCEPT '[' or '{'
+ *   │                            These are safe - no special meaning
+ *   │
+ *   ├─ \[(?![#E])          Alt 2: A '[' NOT followed by '#' or 'E'
+ *   │   │                        Allows: [x, [1, [anything-else
+ *   │   └─ (?![#E])              Negative lookahead excludes:
+ *   │                              - [# (directives like [#IF)
+ *   │                              - [E (branches like [ELSE], [END IF])
+ *   │
+ *   └─ \{(?!\{)            Alt 3: A '{' NOT followed by another '{'
+ *       │                        Allows: single { in text
+ *       └─ (?!\{)                Negative lookahead excludes:
+ *                                  - {{ (variable start)
+ *   )+                     One or more matches (greedy)
+ *
+ * EXAMPLES:
+ *   "Hello world"     → matches entirely (no special chars)
+ *   "Hello {{name}}"  → matches "Hello " then stops at {{
+ *   "Price: $[100]"   → matches entirely ([1 is not [# or [E)
+ *   "Use {braces}"    → matches entirely (single { is allowed)
+ *   "[#IF ..."        → matches nothing (starts with [#)
+ */
+export const Text = createToken({
+    name: 'Text',
+    pattern: /(?:[^\[{]|\[(?![#E])|\{(?!\{))+/,
+    line_breaks: true,
+});
+// =============================================================================
+// TOKEN GROUPS
+// =============================================================================
+/**
+ * All tokens used in DEFAULT_MODE.
+ * Order matters - more specific patterns first.
+ */
+const defaultModeTokens = [
+    // Complete directive tokens (no mode change)
+    EndIf,
+    EndSection,
+    Else,
+    // Directive openers (push to DIRECTIVE_MODE)
+    IfOpen,
+    ElseIf,
+    SectionOpen,
+    Import,
+    Include,
+    // Variable (push to VARIABLE_MODE)
+    VariableOpenDefault,
+    // Plain text (catch-all - must be last)
+    Text,
+];
+/**
+ * Tokens used inside directives [#IF ...], [#SECTION ...], etc.
+ */
+const directiveModeTokens = [
+    // End directive (pop mode)
+    CloseBracket,
+    // Nested variable in conditions
+    VariableOpenDirective,
+    VariableCloseDirective,
+    // Operators and punctuation
+    Operator,
+    DefaultOp,
+    Equals,
+    LParen,
+    RParen,
+    Comma,
+    // Literals (before Identifier to catch numbers first)
+    StringLiteral,
+    NumberLiteral,
+    Identifier,
+    // Whitespace (skipped)
+    WhiteSpace,
+];
+/**
+ * Tokens used inside variables {{ ... }}
+ */
+const variableModeTokens = [
+    // End variable (pop mode)
+    VariableCloseVariable,
+    // Default operator
+    DefaultOp,
+    // Literals
+    StringLiteral,
+    NumberLiteral,
+    Identifier,
+    // Whitespace (skipped)
+    WhiteSpace,
+];
+/**
+ * Tokens used inside operator arguments ( ... )
+ * Captures free-form text until closing paren.
+ */
+const operatorArgModeTokens = [
+    // End of argument (pop mode)
+    RParenOperatorArg,
+    // Free-form text content
+    OperatorArgText,
+];
+// =============================================================================
+// MULTI-MODE LEXER DEFINITION
+// =============================================================================
+/**
+ * Multi-mode lexer configuration.
+ * Enables context-sensitive tokenization.
+ */
+const multiModeLexerDefinition = {
+    modes: {
+        DEFAULT_MODE: defaultModeTokens,
+        DIRECTIVE_MODE: directiveModeTokens,
+        VARIABLE_MODE: variableModeTokens,
+        OPERATOR_ARG_MODE: operatorArgModeTokens,
+    },
+    defaultMode: 'DEFAULT_MODE',
+};
+/**
+ * All unique tokens (for parser configuration).
+ * Includes category tokens and all mode-specific variants.
+ *
+ * IMPORTANT: Category tokens must come BEFORE their child tokens
+ * in this array for Chevrotain to properly recognize them.
+ */
+export const allTokens = [
+    // Categories first (abstract tokens)
+    VariableOpen,
+    VariableClose,
+    // Directive keywords
+    EndIf,
+    EndSection,
+    Else,
+    IfOpen,
+    ElseIf,
+    SectionOpen,
+    Import,
+    Include,
+    // Mode-specific variable tokens (extend categories)
+    VariableOpenDefault,
+    VariableOpenDirective,
+    VariableCloseVariable,
+    VariableCloseDirective,
+    // Operators and punctuation
+    Operator,
+    DefaultOp,
+    Equals,
+    CloseBracket,
+    LParen,
+    RParen,
+    RParenOperatorArg,
+    Comma,
+    // Operator argument mode tokens
+    OperatorArgText,
+    // Literals
+    StringLiteral,
+    NumberLiteral,
+    Identifier,
+    // Whitespace
+    WhiteSpace,
+    // Text
+    Text,
+];
+// =============================================================================
+// LEXER INSTANCE
+// =============================================================================
+/**
+ * The Echo multi-mode lexer instance.
+ * Uses different token sets depending on the current lexing context.
+ */
+export const EchoLexer = new Lexer(multiModeLexerDefinition, {
+    // Note: We disable ensureOptimizations because the Text token uses
+    // a complement set pattern which cannot be optimized by Chevrotain.
+    // The lexer still works correctly, just without first-char optimizations.
+    ensureOptimizations: false,
+    positionTracking: 'full', // Required for source locations
+});
+// =============================================================================
+// PUBLIC API
+// =============================================================================
+/**
+ * Tokenize an Echo template.
+ *
+ * @param template - The template string to tokenize
+ * @returns Lexer result with tokens and errors
+ *
+ * @example
+ * ```typescript
+ * const result = tokenize('Hello {{name}}!');
+ * if (result.errors.length > 0) {
+ *   console.error('Lexer errors:', result.errors);
+ * } else {
+ *   console.log('Tokens:', result.tokens);
+ * }
+ * ```
+ */
+export function tokenize(template) {
+    return EchoLexer.tokenize(template);
+}
+/**
+ * Format lexer errors for display.
+ *
+ * @param errors - Lexer errors from tokenize()
+ * @returns Formatted error messages
+ */
+export function formatLexerErrors(errors) {
+    return errors.map((error) => {
+        const line = error.line ?? 1;
+        const column = error.column ?? 1;
+        return `Lexer error at line ${line}, column ${column}: ${error.message}`;
+    });
+}
+//# sourceMappingURL=lexer.js.map

package/dist/parser/lexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.js","sourceRoot":"","sources":["../../src/parser/lexer.ts"],"names":[],"mappings":"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"}

package/dist/parser/parser.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Echo DSL Parser - AST Generation
+ *
+ * This file implements the parser for Echo DSL using Chevrotain.
+ * The parser converts a token stream into an Abstract Syntax Tree (AST).
+ *
+ * GRAMMAR (pseudo-BNF):
+ *
+ *   template     := (node)*
+ *   node         := text | variable | conditional | section | import | include
+ *   text         := TEXT
+ *   variable     := "{{" identifier ("??" defaultValue)? "}}"
+ *   conditional  := ifBlock (elseIfBlock)* (elseBlock)? endIf
+ *   ifBlock      := "[#IF" condition "]" (node)*
+ *   elseIfBlock  := "[ELSE IF" condition "]" (node)*
+ *   elseBlock    := "[ELSE]" (node)*
+ *   endIf        := "[END IF]"
+ *   condition    := "{{" identifier "}}" operator
+ *   operator     := "#" IDENTIFIER ("(" arguments ")")?
+ *   arguments    := value ("," value)*
+ *   value        := STRING | NUMBER | IDENTIFIER
+ *   section      := "[#SECTION" "name" "=" STRING "]" (node)* "[END SECTION]"
+ *   import       := "[#IMPORT" (STRING | path) "]"
+ *   include      := "[#INCLUDE" IDENTIFIER "]"
+ */
+import { type IToken } from 'chevrotain';
+import type { ParseResult, SourceLocation } from '../types.js';
+/**
+ * Extract source location from a token.
+ */
+export declare function getTokenLocation(token: IToken): SourceLocation;
+/**
+ * Parse an Echo template into an AST.
+ *
+ * @param template - The Echo template string
+ * @returns ParseResult with AST or errors
+ *
+ * @example
+ * ```typescript
+ * const result = parse('Hello {{name}}!');
+ * if (result.success) {
+ *   console.log('AST:', result.ast);
+ * } else {
+ *   console.error('Errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function parse(template: string): ParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAA2B,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAEV,WAAW,EACX,cAAc,EAIf,MAAM,aAAa,CAAC;AAsrBrB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAQ9D;AA2CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA6CnD"}