nargo-transformer
HXO 框架的变换追踪与 IR 操纵模块。
📖 简介
nargo-transformer 负责在编译过程中对中间表示 (IR) 进行变换,并提供全链路的变换追踪能力。它允许开发者记录每一步变换操作,为调试、性能分析和 SourceMap 的精准映射提供数据支持。
✨ 核心特性
- 变换追踪: 自动或手动记录每一次对 IR 的修改,包括操作名称、描述、时间戳及受影响的代码范围。
- 插件化接口: 通过
TransformPasstrait,支持以插件形式扩展编译器的变换能力。 - 透明性: 为复杂的编译流程提供透明的审计日志,方便排查变换过程中引入的问题。
🏗️ 核心逻辑
- Transformer: 变换管理器,负责持有变换日志并应用变换 Pass。
- Transformation: 单次变换的记录结构,包含元数据和位置信息。
- TransformPass: 变换插件接口,定义了统一的
transform逻辑。
🔗 相关项目
- nargo-ir: 此模块操纵的核心数据结构。
- nargo-optimizer: 使用此模块进行更高级的 IR 优化与追踪。