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

Files

T

History

oxc-guard 0389c4010e release(crates): oxc v0.146.0 (#25912 )

### 🚀 Features

- 83cb516 minifier: Improve negation of expressions in boolean context (#25755) (Armano)

### 🐛 Bug Fixes

- 134fb22 isolated-declarations: Preserve unresolved parameter types (#25909) (Dunqing)
- 526c2b3 codegen: Remove deprecated test APIs (#25889) (camc314)
- 344a9b2 codegen: Align enum template sourcemaps (#25872) (camc314)

### ⚡ Performance

- 5ef0c93 minifier: Unwrap all unary exprs without creating dummy expressions (#25891) (Armano)
- 8783524 packages/codegen: Remove loop from `growMappingBuffer` (#25886) (overlookmotel)
- b6b14c0 packages/codegen: Remove redundant branch (#25885) (overlookmotel)
- be6adf0 packages/sourcemap: Make `location` passed to `recordSourceMapping` always a number (#25884) (overlookmotel)
- f720f15 packages/codegen: Take named-mapping only code off hot path in `recordSourceMapping` (#25883) (overlookmotel)
- a734af5 packages/codegen: Remove redundant setting of `last` in `printImportAttributes` and `printIf` (#25882) (overlookmotel)
- c6e44c6 packages/codegen: Combine 2 writes in `printJSXElement` (#25881) (overlookmotel)
- 8801662 packages/codegen: Remove redundant mapping from `printParams` (#25880) (overlookmotel)

### 📚 Documentation

- 5ad330e packages/codegen: Reformat comments (#25876) (overlookmotel)

2026-08-19 08:29:51 +00:00

examples

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

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

src

fix(isolated-declarations): preserve unresolved parameter types (#25909 )

2026-08-19 07:36:24 +00:00

tests

fix(isolated-declarations): preserve unresolved parameter types (#25909 )

2026-08-19 07:36:24 +00:00

Cargo.toml

release(crates): oxc v0.146.0 (#25912 )

2026-08-19 08:29:51 +00:00

CHANGELOG.md

release(crates): oxc v0.146.0 (#25912 )

2026-08-19 08:29:51 +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 Isolated Declarations

TypeScript isolated declarations transformer for generating .d.ts files.

Overview

This crate implements TypeScript's isolated declarations feature, which generates TypeScript declaration files (.d.ts) from source code without requiring full type checking. This enables faster builds and better incremental compilation.

Key Features

Fast declaration generation: Generate .d.ts files without full type checking
TypeScript 5.5+ compatibility: Implements the latest isolated declarations specification
Incremental builds: Enables faster TypeScript compilation workflows
Comprehensive support: Handles classes, functions, interfaces, and complex types

Architecture

Isolated Declarations Concept

Isolated declarations allow generating TypeScript declaration files without full type inference by requiring that:

All exported functions have explicit return types
All exported variables have explicit types
Type information is locally available

Implementation Details

AST transformation: Convert implementation AST to declaration AST
Type extraction: Extract and preserve type information
Export analysis: Determine what needs to be included in declarations
Error reporting: Provide helpful diagnostics for missing type annotations

Benefits

Faster builds: No full type checking required
Incremental compilation: Each file can be processed independently
Parallel processing: Multiple files can be processed simultaneously
Simplified tooling: Easier to integrate into build systems

This implementation follows the TypeScript compiler's approach while leveraging oxc's performance-oriented architecture.