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

Files

T

History

overlookmotel c966acaac5 fix(parser): do not omit < token opening type argument list (#26328 )

Fix tokens produced when `<<` opens a type argument list. e.g.:

```typescript
type Bar = ReturnType<<T>(x: T) => number>;
```

Previously only 1 `<` token was produced between `ReturnType` and `T`. This PR corrects that so 2 `<` tokens are produced.

TS-ESLint get this wrong too - hence why this wasn't noticed before, as our conformance tests compare to TS-ESLint.

PR submitted to fix TS-ESLint: https://github.com/typescript-eslint/typescript-eslint/pull/12821

In meantime, this PR skips the erroneously failing ESTree tokens conformance tests. We can can re-enable those tests once the fix lands in TS-ESLint.

2026-09-04 12:08:49 +00:00

examples

refactor(diagnostics): update oxc-miette to v4 (#25395 )

2026-08-10 07:48:02 +00:00

src

fix(parser): do not omit < token opening type argument list (#26328 )

2026-09-04 12:08:49 +00:00

AGENTS.md

docs(parser): add AGENTS.md test guidance for agents (#23440 )

2026-06-15 10:53:59 +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.148.0 (#26198 )

2026-09-01 08:15:07 +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 Parser

High-performance JavaScript and TypeScript parser with comprehensive language support.

Overview

This crate provides a fast, spec-compliant parser for JavaScript and TypeScript that produces a complete Abstract Syntax Tree (AST). It supports all modern language features including JSX, TSX, and the latest ECMAScript proposals.

Key Features

Complete language support: JavaScript, TypeScript, JSX, and TSX
Latest ECMAScript: All stable ECMAScript features plus stage 3+ proposals
High performance: Significantly faster than traditional parsers
Error recovery: Continues parsing after errors to provide complete AST
Comprehensive AST: Detailed node information with accurate source positions

Architecture

Parser Design

Recursive descent: Traditional recursive descent parser architecture
Error recovery: Sophisticated error recovery for IDE-friendly parsing
Memory efficient: Uses arena allocation for optimal performance
Streaming: Processes source text in a single pass

Language Support

JavaScript: Full ECMAScript 2024+ support
TypeScript: Complete TypeScript syntax including decorators
JSX/TSX: React JSX and TypeScript JSX syntax
Proposals: Stage 3 decorators and other advancing proposals

AST Structure

The parser produces an AST that closely follows ECMAScript specifications:

Accurate positions: Every node has precise source location information
Complete information: Preserves all syntactic details including trivia
Type-safe: Leverages Rust's type system for correctness
Visitor-friendly: Designed for easy traversal and transformation

The parser is designed as the foundation for all other oxc tools, providing the high-quality AST needed for analysis, transformation, and code generation.