Usage

TypeStat is a CLI utility that modifies TypeScript types in existing code. The built-in mutators will only ever add or remove types and will never change your runtime behavior. TypeStat can:

⚡ To start, the typestat command will launch an interactive guide to setting up a configuration file. ⚡

npx typestat

👋 Welcome to TypeStat! 👋
This will create a new typestat.json for you.
...

After, use typestat --config typestat.json to convert your files.

Configuration

To get a deeper understanding of TypeStat, read the following docs pages in order:

1. Usage.md for an explanation of how TypeStat works
2. Fixes.md for the type of fixes TypeStat will generate mutations for
3. Cleanups.md for the post-fix cleaning TypeStat may apply to files
4. Types.md for configuring how to work with types in mutations
5. Filters.md for using tsquery to ignore sections of source files
6. Custom Mutators.md for including or creating custom mutators

Development

See .github/CONTRIBUTING.md, then .github/DEVELOPMENT.md for general tooling documentation. For understanding the project, see ./docs in general, and especially ./docs/Architecture.md. Thanks! 💖

Contributors

💙 This package is based on @JoshuaKGoldberg's TypeStat.