ParseOutcome

struct ParseOutcome

The AST prefix, diagnostics, trivia, and metadata produced by one category parse.

failure is the hard category failure; diags also contains recoverable problems encountered while building items. Comments remain detached unless parse_file_docs_source runs the separate documentation attachment pass.

Properties

let items: [Item]

Successfully parsed root items in source order.

let failure: Fail?

The hard failure that prevented a complete category parse, when present.

let diags: [Fail]

Recoverable diagnostics accumulated while parsing.

let comments: [Comment]

Every line-comment span dropped by the scanner.

let metas: [NodeMeta]

Per-node meta in the canonical pre-order the bridge adapter walks (ADR 0043 option A); one entry per adapter-constructed node, synthesized nodes carrying the no-meta marker.

let docs: [DocumentedDecl]

Doc-comment attachments; empty unless parsed through parsefiledocs_source (Docs.tlk).