//! # Benchmarks Module
//!
//! Performance benchmarks comparing llvm-native (native Rust re-implementation)
//! against upstream LLVM behavioral expectations.
//!
//! ## Modules
//!
//! * `bench_x86_vs_upstream` — X86-64 encoding, C lexing, AST construction,
//! IR generation, ELF emission, and end-to-end pipeline benchmarks with
//! throughput and latency measurements against documented performance targets.
//!
//! All benchmarks are clean-room: performance expectations are derived from
//! published LLVM documentation, Intel SDM, and black-box oracle interrogation.
//! No LLVM C++ source code was consulted for any benchmark target value.