onion_frontend/
lib.rs

1//! Onion 语言前端主库。
2//!
3//! 本 crate 提供 Onion 语言的完整前端实现，包括：
4//! - 词法分析（lexer）
5//! - 语法分析（parser/ast）
6//! - 语义分析（analyzer）
7//! - 编译时求值与宏系统（comptime）
8//! - IR 生成与优化（ir_generator）
9//! - 诊断与错误报告（diagnostics）
10//! - 编译主流程（compile）
11//! - 实用工具（utils）
12//!
13//! # 主要模块
14//! - `ir_generator`：IR 生成与命名空间管理
15//! - `parser`：词法、语法、语义分析与源码管理
16//! - `diagnostics`：错误与警告收集、源码定位
17//! - `compile`：一站式编译入口，源码到字节码
18//! - `utils`：通用辅助工具（如循环检测等）
19//!
20//! # 用法示例
21//! ```ignore
22//! use onion_frontend::compile::build_code;
23//! use onion_frontend::parser::Source;
24//! let source = Source::from_file("main.onion").unwrap();
25//! let mut collector = ...;
26//! let ir_package = build_code(&mut collector, &source).unwrap();
27//! ```
28
29pub mod compile;
30pub mod diagnostics;
31pub mod ir_generator;
32pub mod parser;
33pub mod utils;