aspect-build/rules_ts

> [!NOTE]
> This repository uses the Aspect CLI for CI and local development.
> See the docs and install instructions to get started.
This is the canonical ruleset for using Bazel with TypeScript, based on
Many companies are successfully building with rulests. If you're getting value from the project, please let us know! Just comment on our Adoption Discussion.
rulests is just a part of what Aspect provides:
Need help? This ruleset has support provided by https://aspect.build/services.
See our other Bazel rules, especially those built for rulesjs, linked from
## Installation
Follow instructions from the release you wish to use:
## Examples
There are a number of examples in the examples/ folder and
larger examples in the bazel-examples repository using rulests such as
jest, react,
angular.
If you'd like an example added, you can fund a Feature Request.
## Usage
See the API documentation in the docs/ folder.
### From a BUILD file
The most common use is with the tsproject macro which invokes a
transpiler you configure to transform source files like .ts files into outputs such as .js and .js.map,
and the tsc CLI to type-check
the program and produce .d.ts files.
### In a macro
Many organizations set default values, so it's common to write a [macro] to wrap tsproject, then
ensure that your developers load your macro rather than loading from @aspectrulests directly.
[macro]: https://bazel.build/extending/macros
### BUILD file generation
Aspect provides a TypeScript BUILD file generator as part of the Aspect CLI.
Run aspect configure to create or update BUILD.bazel files as you edit TypeScript sources.
See .
### Advanced: custom rules
If you know how to write Bazel rules, you might find that tsproject doesn't do what you want.
One way to customize it is to peel off one layer of indirection, by calling the tsprojectrule
directly. This bypasses our default setting logic, and also the validation program which checks that
tsproject attributes are well-formed.