oxc_codegen
| Crates.io | oxc_codegen |
| lib.rs | oxc_codegen |
| version | 0.83.0 |
| created_at | 2023-11-06 11:23:33.990162+00 |
| updated_at | 2025-08-29 06:53:42.216548+00 |
| description | A collection of JavaScript tools written in Rust. |
| homepage | https://oxc.rs |
| repository | https://github.com/oxc-project/oxc |
| max_upload_size | |
| id | 1026830 |
| size | 270,043 |
Boshen (Boshen)
documentation
README
Oxc Codegen
High-performance code generation from AST back to JavaScript/TypeScript source code.
Overview
This crate converts AST nodes back into source code strings, supporting JavaScript, TypeScript, and JSX. It's designed for speed and correctness, producing clean, readable output.
Key Features
- Fast code generation: Optimized for performance with minimal allocations
- Source map support: Generate accurate source maps during output
- Configurable formatting: Control whitespace, semicolons, and other formatting options
- Comment preservation: Maintain comments during code generation
- Binary expression optimization: Intelligent parentheses insertion
Architecture
Code Generation Pipeline
- AST Traversal: Walk through AST nodes systematically
- Token Generation: Convert nodes to appropriate tokens/strings
- Formatting: Apply whitespace, indentation, and style rules
- Source Mapping: Track original source positions if enabled
Design Principles
- Correctness: Generated code must be functionally equivalent to original
- Performance: Minimize string allocations and copying
- Readability: Produce clean, well-formatted output
- Fidelity: Preserve semantic meaning and behavior
The codegen is adapted from esbuild's approach, optimized for Rust and oxc's AST structure.