mirror of https://github.com/oxc-project/oxc.git synced 2026-09-14 19:36:11 +08:00

Files

T

History

overlookmotel 2c9a947363 feat(parser)!: reduce MAX_LEN to 256 bytes below u32::MAX (#26352 )

Technically a breaking change, but one that's extremely unlikely to affect any real-world applications.

On 64-bit systems, the maximum source text length was exactly `u32::MAX`.

Lower it by 256 bytes, for 2 reasons:

1. `oxc_lexer` will require source text to be followed by 64 bytes of padding. Reducing max source length ensures _padded_ length can always fit in a `u32`.
2. Counts of tokens, comments and errors are all bounded by source length plus a small constant. By reducing max source length, these can all be stored as `u32`s without any possibility of overflow.

`oxc_lexer` only needs 64 bytes of padding. Have gone with 256 to leave headroom in case later redesigns require more than 64. This avoids another breaking change later. We can always switch to 64 later on if we want, and this later relaxation would not be a breaking change.

All the changes to other crates in this PR are just updating comments which talk about max source length.

2026-09-05 15:33:52 +00:00

examples

fix(codegen): require sourcemap for example (#26047 )

2026-08-24 10:02:59 +00:00

src

feat(parser)!: reduce MAX_LEN to 256 bytes below u32::MAX (#26352 )

2026-09-05 15:33:52 +00:00

tests/integration

test(codegen): group unapplied annotation comment cases (#26295 )

2026-09-03 14:43:37 +00:00

Cargo.toml

release(crates): oxc v0.148.0 (#26198 )

2026-09-01 08:15:07 +00:00

CHANGELOG.md

release(crates): oxc v0.147.0 (#26046 )

2026-08-24 11:19:12 +00:00

README.md

docs(rust): Add comprehensive README.md documentation for all Rust crates (#12706 )

2025-08-01 18:13:46 +08:00

README.md

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.