# OXC for TSRX

> Rust-native parsing, linting, formatting, and editor support for .tsrx source through canonical OXC. No fork, no patches, one parse.

## Guide

- [Introduction](/guide/introduction.md): What OXC for TSRX is, how it works in plain terms, and what it promises.
- [Getting Started](/guide/getting-started.md): Install @tsrx/oxc, then parse, lint, format, and edit your first TSRX file.
- [Walkthrough (Vite+)](/integrations/vite-plus.md): From an empty folder to a .tsrx file caught by a lint rule you wrote, with your editor flagging the same thing.
- [TSRX Syntax Support](/guide/tsrx-syntax.md): The TSRX grammar slice the native overlay recognizes today, and how unsupported grammar fails.
- [Linting](/guide/linting.md): How @tsrx/oxc runs real OXC lint rules on .tsrx files and reports errors at your actual code.
- [Formatting](/guide/formatting.md): How @tsrx/oxc formats .tsrx files with real Oxfmt layout and converts the result back to TSRX.
- [Parsing](/guide/parsing.md): Parse .tsrx and ordinary JS/TS into a real AST with @tsrx/oxc/parser, the oxc-parser style API with TSRX support.

## Integrations

- [Configuration](/integrations/configuration.md)
- [Editor](/integrations/editor.md): Native formatting, lint diagnostics, and validated quick fixes for TSRX in Visual Studio Code.
- [Custom JS Plugins](/integrations/custom-js-plugins.md): Write a custom lint rule with the oxlint that @tsrx/oxc installs and run it on .tsrx files, with positions in your authored source.

## Architecture

- [Rust/OXC Core](/architecture/rust-oxc-core.md)
- [Provider Protocol](/architecture/provider-protocol.md): A proposed static package.json block that would let a host find a language provider from the install alone, with the calling convention a host would follow. Implemented in this repository only.

## Reference

- [CLI](/reference/cli.md): Every flag the @tsrx/oxc CLI accepts (oxc-tsrx and oxc-tsrx-fmt), with exit codes and environment variables.
- [Benchmarks](/reference/benchmarks.md): The frozen release performance gates, generated from aggregate-selected reports.
- [Platform Support](/reference/platform-support.md): The eight platforms @tsrx/oxc publishes, which of them a real run exercises on every pull request, and which of them are only built.
- [Limitations](/reference/limitations.md): What OXC for TSRX does not support yet, and why each gap fails loudly instead of quietly.