Struct Parser 

pub struct Parser { /* private fields */ }

Implementations

impl Parser

pub fn new(raw_tokens: Vec<Token>) -> Parser

pub fn with_source(self, source: &str, filename: &str) -> Parser

§Fase 28.d — Fluent attach of source text + filename for rustc-style source-context blocks on emitted ParseErrors. Returns self so it chains with .parse_with_recovery():

let result = Parser::new(tokens)
    .with_source(src, "foo.axon")
    .parse_with_recovery();

No-op of any other behaviour — pure metadata attach.

pub fn parse(&mut self) -> Result<Program, ParseError>

pub fn parse_with_recovery(&mut self) -> ParseResult

Recovery-mode parse. Collects every parse error in source order; the existing parse() API remains fail-fast (D9).

Recovery contract (D2)

On ParseError:

1. Push the error onto errors.
2. If the cursor is already on a top-level declaration keyword (and brace-depth ≤ 0), do not consume — the caller should retry the declaration parse from here. Otherwise advance one token to make progress, then walk to the next sync point.
3. Resume the outer loop.

Sync points: top-level declaration keyword at brace-depth ≤ 0, or EOF. Negative depths are treated identically to ≤ 0 — the walker keeps walking through over-balanced } rather than pretending a closing brace is itself a sync point (which would emit a ghost “Unexpected token at top level” error in the outer loop).