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

Files

T

History

camc314 b846abc2a4 fix(isolated-declarations): handle ambient expando properties (#25655 )

## Summary

- treat value declarations in ambient namespaces as implicitly exported for expando-function validation
- preserve local versus exported namespace visibility to match TypeScript declaration merging
- add regression coverage for accepted ambient value declarations and rejected local or type-only declarations

## TypeScript compatibility

The regression fixture was checked with TypeScript 6.0.3. TypeScript and Oxc produce TS9023 only for the exported-function/local-namespace mismatch and the type-only namespace property.

Closes #24975

2026-08-17 02:25:03 +00:00

examples

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

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

src

fix(isolated-declarations): handle ambient expando properties (#25655 )

2026-08-17 02:25:03 +00:00

tests

fix(isolated-declarations): handle ambient expando properties (#25655 )

2026-08-17 02:25:03 +00:00

Cargo.toml

release(crates): oxc v0.144.0 (#25474 )

2026-08-10 09:57:10 +00:00

CHANGELOG.md

release(crates): oxc v0.144.0 (#25474 )

2026-08-10 09:57:10 +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.