1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
//! Lossless concrete syntax tree (CST) for Beancount.
//!
//! Phase 1 of the parser-CST migration tracked in #1262. Sits inside
//! `rustledger-parser` (no new crate) — phases 2-5 will move the
//! existing AST-style parser internals to delegate to this module
//! and eventually delete the old code paths.
//!
//! # Phase 1 surface
//!
//! - [`SyntaxKind`]: every token and node kind that can appear in the
//! tree. `num_enum::TryFromPrimitive` for the u16 → enum conversion.
//! - [`BeancountLanguage`]: the rowan `Language` impl + type aliases
//! ([`SyntaxNode`], [`SyntaxToken`], [`SyntaxElement`]).
//! - [`lossless_kind_tokens`]: drive the lossless lexer (`tokenize_lossless`)
//! and recover the leading BOM byte-by-byte.
//! - [`parse_flat`]: produce a flat `SOURCE_FILE` tree that round-trips
//! byte-identically against the source.
//!
//! # Trivia attachment policy (phase 2.0)
//!
//! Phase 1 emits a flat tree, where trivia attachment is a non-
//! question. Phase 2.1+ introduces structural nodes (`DIRECTIVE`,
//! then `POSTING` / `AMOUNT` / `COST_SPEC` / `META_ENTRY` / ...)
//! that wrap token runs. Phase 2.0 pins **the
//! Directive-Terminator Rule**: every directive owns its content
//! tokens PLUS its terminating `NEWLINE`.
//!
//! Short version:
//!
//! - **Same-line trailing** trivia (whitespace + EOL comment
//! before the terminator) lives INSIDE the directive.
//! - **Inter-directive leading** trivia (blank lines, mid-file
//! comment blocks) lives INSIDE the NEXT directive.
//! - **File-leading** trivia (before the first content token) is
//! a direct child of `SOURCE_FILE`.
//! - **File-trailing** trivia (after the file-final directive's
//! terminator) is also a direct child of `SOURCE_FILE`.
//!
//! Fully symmetric: every directive has the same children shape
//! (optional leading + content + optional same-line trailing +
//! terminator `NEWLINE`). No EOF special case.
//!
//! Phase 2.0 ships NO production helper — the policy is enforced
//! via tree-shape regression tests in `cst::trivia` (private
//! submodule). Phase 2.1's structured parser writes its own
//! streaming, state-aware predicate that produces trees matching
//! those shapes. If the parser drifts, the regression tests fire.
//! See the `trivia` module rustdoc for the full spec, rationale,
//! and recursive-application notes for phase 2.1's grammar.
pub
pub use parse_via_cst;
// Formatter exports do NOT re-export through `cst` — the sole
// import path for the formatter is `rustledger_parser::format`
// (the crate-root sub-module that re-exports the six symbols
// directly from `crate::cst::format`). Round-6 sealed the
// `cst::format` path so there is exactly one import shape per
// formatter symbol from outside the crate.
pub use lossless_kind_tokens;
pub use ;
pub use ;