miden-assembly-syntax-cst 0.32.0

//! Lossless concrete syntax support for Miden Assembly.
//!
//! This crate provides a trivia-preserving lexer, a rowan-based concrete syntax tree, and a small
//! set of typed AST wrappers over that CST. The primary entry point for production use is
//! [`parse_source_file`], which accepts an [`Arc<SourceFile>`][miden_debug_types::SourceFile] and
//! retains source/span information for both diagnostics and downstream lowering.
#![no_std]

#[cfg(any(test, feature = "std"))]
#[cfg_attr(test, macro_use)]
extern crate std;

#[macro_use]
extern crate alloc;

pub mod ast;
pub mod lexer;
pub mod parser;
pub mod syntax;

pub use miden_utils_diagnostics::{self as diagnostics, Report};
pub use rowan;

pub use self::{
    ast::{Item, Operation},
    lexer::{Lexer, Token, tokenize, tokenize_text},
    parser::{Parse, parse_inline_masm, parse_source_file, parse_text},
    syntax::{MasmLanguage, SyntaxElement, SyntaxKind, SyntaxNode, SyntaxToken},
};

/// Maximum allowed nesting of control-flow blocks.
///
/// This limit prevents stack overflows while parsing or compiling maliciously deep block nesting,
/// while remaining far above typical program structure depth.
pub const MAX_CONTROL_FLOW_NESTING: usize = 256;