@rcrsr/rill 0.1.0

package/dist/parser/parser-variables.js

@@ -0,0 +1,146 @@
+/**
+ * Parser Extension: Variable Parsing
+ * Variables and access chains
+ */
+import { Parser } from './parser.js';
+import { TOKEN_TYPES } from '../types.js';
+import { check, advance, expect, makeSpan } from './state.js';
+import { isMethodCallWithArgs, VALID_TYPE_NAMES, parseTypeName, } from './helpers.js';
+// ============================================================
+// VARIABLE PARSING
+// ============================================================
+Parser.prototype.parseVariable = function () {
+    const start = this.state.tokens[this.state.pos].span.start;
+    if (check(this.state, TOKEN_TYPES.PIPE_VAR)) {
+        advance(this.state);
+        return this.makeVariableWithAccess(null, true, start);
+    }
+    const dollarToken = expect(this.state, TOKEN_TYPES.DOLLAR, 'Expected $');
+    if (dollarToken.value === '$@') {
+        return this.makeVariableWithAccess('@', false, start);
+    }
+    // Handle $ followed by access chain (no name): $[0], $.field
+    if (check(this.state, TOKEN_TYPES.LBRACKET) ||
+        check(this.state, TOKEN_TYPES.DOT) ||
+        check(this.state, TOKEN_TYPES.DOT_QUESTION)) {
+        return this.makeVariableWithAccess(null, true, start);
+    }
+    const nameToken = expect(this.state, TOKEN_TYPES.IDENTIFIER, 'Expected variable name');
+    return this.makeVariableWithAccess(nameToken.value, false, start);
+};
+Parser.prototype.makeVariableWithAccess = function (name, isPipeVar, start) {
+    const { accessChain, existenceCheck } = this.parseAccessChain();
+    let defaultValue = null;
+    if (check(this.state, TOKEN_TYPES.NULLISH_COALESCE) && !existenceCheck) {
+        advance(this.state);
+        defaultValue = this.parseDefaultValue();
+    }
+    return {
+        type: 'Variable',
+        name,
+        isPipeVar,
+        accessChain,
+        defaultValue,
+        existenceCheck,
+        span: makeSpan(start, start),
+    };
+};
+Parser.prototype.parseAccessChain = function () {
+    const accessChain = [];
+    let existenceCheck = null;
+    while (check(this.state, TOKEN_TYPES.DOT, TOKEN_TYPES.DOT_QUESTION, TOKEN_TYPES.LBRACKET)) {
+        if (check(this.state, TOKEN_TYPES.DOT) &&
+            isMethodCallWithArgs(this.state)) {
+            break;
+        }
+        if (check(this.state, TOKEN_TYPES.LBRACKET)) {
+            advance(this.state);
+            const expression = this.parsePipeChain();
+            expect(this.state, TOKEN_TYPES.RBRACKET, 'Expected ] after index expression');
+            accessChain.push({ accessKind: 'bracket', expression });
+            continue;
+        }
+        if (check(this.state, TOKEN_TYPES.DOT_QUESTION)) {
+            advance(this.state);
+            const finalAccess = this.parseFieldAccessElement();
+            if (!finalAccess) {
+                break;
+            }
+            let typeName = null;
+            if (check(this.state, TOKEN_TYPES.AMPERSAND)) {
+                advance(this.state);
+                typeName = parseTypeName(this.state, VALID_TYPE_NAMES);
+            }
+            existenceCheck = { finalAccess, typeName };
+            break;
+        }
+        advance(this.state);
+        const access = this.parseFieldAccessElement();
+        if (!access) {
+            break;
+        }
+        accessChain.push(access);
+    }
+    return { accessChain, existenceCheck };
+};
+Parser.prototype.parseFieldAccessElement = function () {
+    if (check(this.state, TOKEN_TYPES.DOLLAR)) {
+        advance(this.state);
+        const nameToken = expect(this.state, TOKEN_TYPES.IDENTIFIER, 'Expected variable name after .$');
+        return { kind: 'variable', variableName: nameToken.value };
+    }
+    if (check(this.state, TOKEN_TYPES.LPAREN)) {
+        return this.parseComputedOrAlternatives();
+    }
+    if (check(this.state, TOKEN_TYPES.LBRACE)) {
+        const block = this.parseBlock();
+        return { kind: 'block', block };
+    }
+    if (check(this.state, TOKEN_TYPES.IDENTIFIER)) {
+        return { kind: 'literal', field: advance(this.state).value };
+    }
+    return null;
+};
+Parser.prototype.parseComputedOrAlternatives = function () {
+    advance(this.state);
+    const alternatives = this.tryParseAlternatives();
+    if (alternatives) {
+        expect(this.state, TOKEN_TYPES.RPAREN, 'Expected ) after alternatives');
+        return { kind: 'alternatives', alternatives };
+    }
+    const expression = this.parsePipeChain();
+    expect(this.state, TOKEN_TYPES.RPAREN, 'Expected ) after expression');
+    return { kind: 'computed', expression };
+};
+Parser.prototype.tryParseAlternatives = function () {
+    const savedPos = this.state.pos;
+    const alternatives = [];
+    if (!check(this.state, TOKEN_TYPES.IDENTIFIER)) {
+        return null;
+    }
+    alternatives.push(advance(this.state).value);
+    if (!check(this.state, TOKEN_TYPES.OR)) {
+        this.state.pos = savedPos;
+        return null;
+    }
+    while (check(this.state, TOKEN_TYPES.OR)) {
+        advance(this.state);
+        if (!check(this.state, TOKEN_TYPES.IDENTIFIER)) {
+            this.state.pos = savedPos;
+            return null;
+        }
+        alternatives.push(advance(this.state).value);
+    }
+    if (!check(this.state, TOKEN_TYPES.RPAREN)) {
+        this.state.pos = savedPos;
+        return null;
+    }
+    return alternatives;
+};
+Parser.prototype.parseDefaultValue = function () {
+    if (check(this.state, TOKEN_TYPES.LBRACE)) {
+        return this.parseBlock();
+    }
+    return this.parsePipeChain();
+};
+//# sourceMappingURL=parser-variables.js.map

package/dist/parser/parser-variables.js.map

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

package/dist/parser/parser.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Parser Class - Core
+ *
+ * Defines the Parser class structure. Methods are added via prototype
+ * extension from separate modules, using TypeScript declaration merging
+ * for type safety.
+ *
+ * This architecture eliminates circular dependencies while keeping
+ * the codebase modular and organized by concern.
+ */
+import type { ScriptNode, Token } from '../types.js';
+import { ParseError } from '../types.js';
+import { type ParserState } from './state.js';
+/**
+ * Parser class that converts tokens into an AST.
+ *
+ * Methods are organized across multiple files:
+ * - parser-script.ts: Script, statement, annotation parsing
+ * - parser-expr.ts: Expressions, precedence chain, pipe targets
+ * - parser-literals.ts: Literals, strings, tuples, dicts, closures
+ * - parser-variables.ts: Variables, access chains
+ * - parser-control.ts: Conditionals, loops, blocks
+ * - parser-functions.ts: Function calls, methods, type operations
+ * - parser-collect.ts: Collection operators (each, map, fold, filter)
+ * - parser-extract.ts: Extraction operators (destructure, slice, spread)
+ *
+ * @example
+ * ```typescript
+ * const parser = new Parser(tokens, { recoveryMode: false });
+ * const ast = parser.parse();
+ * ```
+ */
+export declare class Parser {
+    /** Parser state including tokens, position, and error collection */
+    state: ParserState;
+    constructor(tokens: Token[], options?: {
+        recoveryMode?: boolean;
+        source?: string;
+    });
+    /**
+     * Parse tokens into a complete AST.
+     */
+    parse(): ScriptNode;
+    /**
+     * Get collected errors (for recovery mode).
+     */
+    get errors(): ParseError[];
+}
+//# 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;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,YAAY,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,MAAM;IACjB,oEAAoE;IACpE,KAAK,EAAE,WAAW,CAAC;gBAGjB,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAQvD;;OAEG;IACH,KAAK,IAAI,UAAU;IAInB;;OAEG;IACH,IAAI,MAAM,IAAI,UAAU,EAAE,CAEzB;CACF"}

package/dist/parser/parser.js

@@ -0,0 +1,54 @@
+/**
+ * Parser Class - Core
+ *
+ * Defines the Parser class structure. Methods are added via prototype
+ * extension from separate modules, using TypeScript declaration merging
+ * for type safety.
+ *
+ * This architecture eliminates circular dependencies while keeping
+ * the codebase modular and organized by concern.
+ */
+import { ParseError } from '../types.js';
+import { createParserState } from './state.js';
+/**
+ * Parser class that converts tokens into an AST.
+ *
+ * Methods are organized across multiple files:
+ * - parser-script.ts: Script, statement, annotation parsing
+ * - parser-expr.ts: Expressions, precedence chain, pipe targets
+ * - parser-literals.ts: Literals, strings, tuples, dicts, closures
+ * - parser-variables.ts: Variables, access chains
+ * - parser-control.ts: Conditionals, loops, blocks
+ * - parser-functions.ts: Function calls, methods, type operations
+ * - parser-collect.ts: Collection operators (each, map, fold, filter)
+ * - parser-extract.ts: Extraction operators (destructure, slice, spread)
+ *
+ * @example
+ * ```typescript
+ * const parser = new Parser(tokens, { recoveryMode: false });
+ * const ast = parser.parse();
+ * ```
+ */
+export class Parser {
+    /** Parser state including tokens, position, and error collection */
+    state;
+    constructor(tokens, options) {
+        this.state = createParserState(tokens, {
+            recoveryMode: options?.recoveryMode ?? false,
+            source: options?.source ?? '',
+        });
+    }
+    /**
+     * Parse tokens into a complete AST.
+     */
+    parse() {
+        return this.parseScript();
+    }
+    /**
+     * Get collected errors (for recovery mode).
+     */
+    get errors() {
+        return this.state.errors;
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/parser/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAoB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,MAAM;IACjB,oEAAoE;IACpE,KAAK,CAAc;IAEnB,YACE,MAAe,EACf,OAAqD;QAErD,IAAI,CAAC,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE;YACrC,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,KAAK;YAC5C,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF"}

package/dist/parser/script.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Script Structure Parsing
+ * Script, frontmatter, statements, and annotations
+ */
+import type { AnnotatedStatementNode, ScriptNode, StatementNode } from '../types.js';
+import { type ParserState } from './state.js';
+export declare function parseScript(state: ParserState): ScriptNode;
+/**
+ * Parse a statement: optionally annotated pipe chain expression.
+ * Annotations prefix statements with ^(key: value, ...) syntax.
+ * Termination (capture/break/return) is now part of PipeChainNode.
+ */
+export declare function parseStatement(state: ParserState): StatementNode | AnnotatedStatementNode;
+//# sourceMappingURL=script.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../src/parser/script.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,sBAAsB,EAKtB,UAAU,EAEV,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,WAAW,EAQjB,MAAM,YAAY,CAAC;AAQpB,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAiD1D;AA6DD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,GACjB,aAAa,GAAG,sBAAsB,CAexC"}

package/dist/parser/script.js

@@ -0,0 +1,196 @@
+/**
+ * Script Structure Parsing
+ * Script, frontmatter, statements, and annotations
+ */
+import { ParseError, TOKEN_TYPES } from '../types.js';
+import { check, advance, expect, current, isAtEnd, skipNewlines, makeSpan, } from './state.js';
+import { parseExpression } from './expressions.js';
+import { setParseStatement } from './control-flow.js';
+// ============================================================
+// SCRIPT PARSING
+// ============================================================
+export function parseScript(state) {
+    const start = current(state).span.start;
+    skipNewlines(state);
+    // Optional frontmatter
+    let frontmatter = null;
+    if (check(state, TOKEN_TYPES.FRONTMATTER_DELIM)) {
+        frontmatter = parseFrontmatter(state);
+    }
+    skipNewlines(state);
+    // Statements
+    const statements = [];
+    while (!isAtEnd(state)) {
+        skipNewlines(state);
+        if (isAtEnd(state))
+            break;
+        if (state.recoveryMode) {
+            // Recovery mode: catch errors and create ErrorNode
+            const stmtStart = current(state).span.start;
+            try {
+                statements.push(parseStatement(state));
+            }
+            catch (err) {
+                if (err instanceof ParseError) {
+                    state.errors.push(err);
+                    // Create ErrorNode and skip to next statement boundary
+                    const errorNode = recoverToNextStatement(state, stmtStart, err.message);
+                    statements.push(errorNode);
+                }
+                else {
+                    throw err; // Re-throw non-parse errors
+                }
+            }
+        }
+        else {
+            // Normal mode: let errors propagate
+            statements.push(parseStatement(state));
+        }
+        skipNewlines(state);
+    }
+    return {
+        type: 'Script',
+        frontmatter,
+        statements,
+        span: makeSpan(start, current(state).span.end),
+    };
+}
+/**
+ * Recovery helper: skip tokens until we find a likely statement boundary.
+ * Returns an ErrorNode containing the skipped content.
+ * @internal
+ */
+function recoverToNextStatement(state, startLocation, message) {
+    const startOffset = startLocation.offset;
+    let endOffset = startOffset;
+    // Skip tokens until we hit a newline or EOF (statement boundary)
+    while (!isAtEnd(state) && !check(state, TOKEN_TYPES.NEWLINE)) {
+        endOffset = current(state).span.end.offset;
+        advance(state);
+    }
+    // Extract the skipped text from source
+    const text = state.source.slice(startOffset, endOffset);
+    return {
+        type: 'Error',
+        message,
+        text,
+        span: makeSpan(startLocation, current(state).span.start),
+    };
+}
+// ============================================================
+// FRONTMATTER PARSING
+// ============================================================
+function parseFrontmatter(state) {
+    const start = current(state).span.start;
+    expect(state, TOKEN_TYPES.FRONTMATTER_DELIM, 'Expected ---');
+    skipNewlines(state);
+    // Collect all content until next ---
+    let content = '';
+    while (!check(state, TOKEN_TYPES.FRONTMATTER_DELIM) && !isAtEnd(state)) {
+        const token = advance(state);
+        content += token.value;
+    }
+    expect(state, TOKEN_TYPES.FRONTMATTER_DELIM, 'Expected closing ---');
+    return {
+        type: 'Frontmatter',
+        content: content.trim(),
+        span: makeSpan(start, current(state).span.end),
+    };
+}
+// ============================================================
+// STATEMENT PARSING
+// ============================================================
+/**
+ * Parse a statement: optionally annotated pipe chain expression.
+ * Annotations prefix statements with ^(key: value, ...) syntax.
+ * Termination (capture/break/return) is now part of PipeChainNode.
+ */
+export function parseStatement(state) {
+    const start = current(state).span.start;
+    // Check for annotation prefix: ^(...)
+    if (check(state, TOKEN_TYPES.CARET)) {
+        return parseAnnotatedStatement(state);
+    }
+    const expression = parseExpression(state);
+    return {
+        type: 'Statement',
+        expression,
+        span: makeSpan(start, current(state).span.end),
+    };
+}
+// ============================================================
+// ANNOTATION PARSING
+// ============================================================
+/**
+ * Parse an annotated statement: ^(key: value, ...) statement
+ * Annotations modify operational parameters for statements.
+ */
+function parseAnnotatedStatement(state) {
+    const start = current(state).span.start;
+    expect(state, TOKEN_TYPES.CARET, 'Expected ^');
+    expect(state, TOKEN_TYPES.LPAREN, 'Expected (');
+    const annotations = parseAnnotationArgs(state);
+    expect(state, TOKEN_TYPES.RPAREN, 'Expected )');
+    // Parse the inner statement (which could also be annotated)
+    const statement = parseStatement(state);
+    // If inner is annotated, wrap it; otherwise use directly
+    const innerStatement = statement.type === 'AnnotatedStatement'
+        ? {
+            type: 'Statement',
+            expression: statement.statement.expression,
+            span: statement.span,
+        }
+        : statement;
+    return {
+        type: 'AnnotatedStatement',
+        annotations,
+        statement: innerStatement,
+        span: makeSpan(start, current(state).span.end),
+    };
+}
+/**
+ * Parse annotation arguments: key: value, *spread, ...
+ */
+function parseAnnotationArgs(state) {
+    const args = [];
+    if (check(state, TOKEN_TYPES.RPAREN)) {
+        return args; // Empty annotation list
+    }
+    args.push(parseAnnotationArg(state));
+    while (check(state, TOKEN_TYPES.COMMA)) {
+        advance(state); // consume comma
+        if (check(state, TOKEN_TYPES.RPAREN))
+            break; // trailing comma
+        args.push(parseAnnotationArg(state));
+    }
+    return args;
+}
+/**
+ * Parse a single annotation argument: named (key: value) or spread (*expr)
+ */
+function parseAnnotationArg(state) {
+    const start = current(state).span.start;
+    // Spread argument: *expr
+    if (check(state, TOKEN_TYPES.STAR)) {
+        advance(state); // consume *
+        const expression = parseExpression(state);
+        return {
+            type: 'SpreadArg',
+            expression,
+            span: makeSpan(start, current(state).span.end),
+        };
+    }
+    // Named argument: key: value
+    const nameToken = expect(state, TOKEN_TYPES.IDENTIFIER, 'Expected annotation name');
+    expect(state, TOKEN_TYPES.COLON, 'Expected :');
+    const value = parseExpression(state);
+    return {
+        type: 'NamedArg',
+        name: nameToken.value,
+        value,
+        span: makeSpan(start, current(state).span.end),
+    };
+}
+// Wire up the circular dependency
+setParseStatement(parseStatement);
+//# sourceMappingURL=script.js.map

package/dist/parser/script.js.map

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

package/dist/parser/state.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Parser State
+ * Core state management and token navigation utilities
+ */
+import type { SourceLocation, SourceSpan, Token } from '../types.js';
+import { ParseError } from '../types.js';
+export interface ParserState {
+    readonly tokens: Token[];
+    pos: number;
+    /** Recovery mode: collect errors instead of throwing */
+    readonly recoveryMode: boolean;
+    /** Errors collected during recovery mode parsing */
+    readonly errors: ParseError[];
+    /** Original source text (for error recovery) */
+    readonly source: string;
+}
+export interface ParserStateOptions {
+    /** Enable recovery mode for IDE/tooling scenarios */
+    recoveryMode?: boolean;
+    /** Original source text (required for recovery mode) */
+    source?: string;
+}
+export declare function createParserState(tokens: Token[], options?: ParserStateOptions): ParserState;
+/** @internal */
+export declare function current(state: ParserState): Token;
+/** @internal */
+export declare function peek(state: ParserState, offset?: number): Token;
+/** @internal */
+export declare function isAtEnd(state: ParserState): boolean;
+/** @internal */
+export declare function check(state: ParserState, ...types: string[]): boolean;
+/** @internal */
+export declare function advance(state: ParserState): Token;
+/** @internal */
+export declare function expect(state: ParserState, type: string, message: string): Token;
+/** @internal */
+export declare function skipNewlines(state: ParserState): void;
+/** @internal */
+export declare function makeSpan(start: SourceLocation, end: SourceLocation): SourceSpan;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/parser/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AAMtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAQb;AAMD,gBAAgB;AAChB,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAMjD;AAED,gBAAgB;AAChB,wBAAgB,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,SAAI,GAAG,KAAK,CAO1D;AAED,gBAAgB;AAChB,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEnD;AAED,gBAAgB;AAChB,wBAAgB,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAErE;AAED,gBAAgB;AAChB,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAIjD;AAED,gBAAgB;AAChB,wBAAgB,MAAM,CACpB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,KAAK,CAMP;AAED,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAErD;AAqED,gBAAgB;AAChB,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,cAAc,GAClB,UAAU,CAEZ"}

package/dist/parser/state.js

@@ -0,0 +1,129 @@
+/**
+ * Parser State
+ * Core state management and token navigation utilities
+ */
+import { ParseError, TOKEN_TYPES } from '../types.js';
+export function createParserState(tokens, options = {}) {
+    return {
+        tokens,
+        pos: 0,
+        recoveryMode: options.recoveryMode ?? false,
+        errors: [],
+        source: options.source ?? '',
+    };
+}
+// ============================================================
+// TOKEN NAVIGATION
+// ============================================================
+/** @internal */
+export function current(state) {
+    const token = state.tokens[state.pos];
+    if (token)
+        return token;
+    const last = state.tokens[state.tokens.length - 1];
+    if (last)
+        return last;
+    throw new Error('No tokens available');
+}
+/** @internal */
+export function peek(state, offset = 0) {
+    const idx = state.pos + offset;
+    const token = state.tokens[idx];
+    if (token)
+        return token;
+    const last = state.tokens[state.tokens.length - 1];
+    if (last)
+        return last;
+    throw new Error('No tokens available');
+}
+/** @internal */
+export function isAtEnd(state) {
+    return current(state).type === TOKEN_TYPES.EOF;
+}
+/** @internal */
+export function check(state, ...types) {
+    return types.includes(current(state).type);
+}
+/** @internal */
+export function advance(state) {
+    const token = current(state);
+    if (!isAtEnd(state))
+        state.pos++;
+    return token;
+}
+/** @internal */
+export function expect(state, type, message) {
+    if (check(state, type))
+        return advance(state);
+    const token = current(state);
+    const hint = generateHint(type, token);
+    const fullMessage = hint ? `${message}. ${hint}` : message;
+    throw new ParseError(fullMessage, token.span.start);
+}
+/** @internal */
+export function skipNewlines(state) {
+    while (check(state, TOKEN_TYPES.NEWLINE))
+        advance(state);
+}
+// ============================================================
+// ERROR HINTS
+// ============================================================
+/**
+ * Generate contextual hints for common parse errors.
+ * @internal
+ */
+function generateHint(expectedType, actualToken) {
+    const actual = actualToken.type;
+    const value = actualToken.value;
+    // Hint for unclosed brackets/braces/parens
+    if (expectedType === TOKEN_TYPES.RPAREN && actual === TOKEN_TYPES.EOF) {
+        return 'Hint: Check for unclosed parenthesis';
+    }
+    if (expectedType === TOKEN_TYPES.RBRACE && actual === TOKEN_TYPES.EOF) {
+        return 'Hint: Check for unclosed brace';
+    }
+    if (expectedType === TOKEN_TYPES.RBRACKET && actual === TOKEN_TYPES.EOF) {
+        return 'Hint: Check for unclosed bracket';
+    }
+    // Hint for keyword typos
+    if (actual === TOKEN_TYPES.IDENTIFIER) {
+        const typoHints = {
+            tru: 'true',
+            fals: 'false',
+            flase: 'false',
+            ture: 'true',
+            retrn: 'return',
+            retrun: 'return',
+            brek: 'break',
+            braek: 'break',
+            eahc: 'each',
+            ech: 'each',
+            fitler: 'filter',
+            fliter: 'filter',
+            fild: 'fold',
+            mp: 'map',
+        };
+        const suggestion = typoHints[value.toLowerCase()];
+        if (suggestion) {
+            return `Hint: Did you mean '${suggestion}'?`;
+        }
+    }
+    // Hint for missing arrow
+    if (expectedType === TOKEN_TYPES.ARROW &&
+        (actual === TOKEN_TYPES.IDENTIFIER || actual === TOKEN_TYPES.DOLLAR)) {
+        return "Hint: Missing '->' before pipe target";
+    }
+    // Hint for using = instead of ->
+    if (expectedType === TOKEN_TYPES.ARROW && actual === TOKEN_TYPES.ASSIGN) {
+        return "Hint: Use '->' for assignment, not '='";
+    }
+    return null;
+}
+// ============================================================
+// SPAN UTILITIES
+// ============================================================
+/** @internal */
+export function makeSpan(start, end) {
+    return { start, end };
+}
+//# sourceMappingURL=state.js.map