The JavaScript Oxidation Compiler (oxc)

The Oxidation Compiler is building a set of tools for the JavaScript / TypeScript language.

These tools include:

• Parser - Done
• Linter - Work in progress
• Formatter
• Transpiler
• Minifier

Goals

The goal of this project is to:

• Create a really fast native program by using the Rust programming language
• Provide the basic building blocks for creating your own tools by having good API designs
• Provide good documentation on learning Rust and compiler techniques

Performance issues are considered as bugs in this project.

Contributing

This project is an invitation for you to come and learn Rust with us.

Contributions are welcome and highly appreciated. To get started, check out CONTRIBUTING.md.

If you do not have the time to contribute code, you can still participate by:

• star and watch this project
• join us on Discord
• follow me on twitter
• provide your wisdom in discussions

Milestone

Oxc has a fully working parser and a prototype for the linter right now.

The current objectives are:

• A MVP (Most Viable Product) for the linter.
• Improve the parser for real usage. Areas include:
  • Performance
  • API
  • Pass more conformance tests

Linter

The linter is fast to the extent that it feels broken.

With a few rules implemented, testing in the VSCode repo:

vscode  main ❯ npx oxidation-compiler@latest lint src
Checked 3479 files in 335ms using 12 cores.
Found 17 errors.

And also in a large monorepo:

Checked 73660 files in 7415ms using 12 cores.
Found 470 errors.

On my Intel i7 6-core, the linter is around 84 times faster than ESLint. But we'll get slightly slower as we add more features.

See benchmark for details.

Try it out yourself!

The linter is already usable and it can potentially catch a few mistakes for you:

npx oxidation-compiler@latest lint path

All feedbacks are welcome.

Parser Conformance

The cargo coverage command currently reports the following summary

Test262 Summary:
AST Parsed     : 43934/43934 (100.00%)

Babel Summary:
AST Parsed     : 2045/2057 (99.42%)

TypeScript Summary:
AST Parsed     : 4291/4861 (88.27%)

(The parser is failing some of the TypeScript recoverable parser tests.)

Learning Resources

• My small tutorial on how to write a JavaScript Parser in Rust
• Crafting Interpreters
• [Create an issue and nsert your inspirational learning resources here]

Credits

This project is incubated from the help of these great mentors and their projects:

• Rome Tools - @MichaReiser, @ematipico
• Ruff - @charliermarsh
• quick-lint-js - @strager
• elm-review - @jfmengels
• @domonji for contribution to the TypeScript parser

License

MIT

Third Party Licenses

Licenses are list in THIRD-PARTY-LICENSE

This project partially copies code from the following projects:

Project	License
eslint/eslint	MIT
typescript-eslint/typescript-eslint	MIT
microsoft/TypeScript	Apache 2.0
rome/tools	MIT
mozilla-spidermonkey/jsparagus	MIT Apache 2.0
acorn	MIT
sindresorhus/globals	MIT