TypeStat

Converts JavaScript to TypeScript and TypeScript to better TypeScript. 🧫

<a href="#contributors" target="_blank"><img alt="👪 All Contributors: 14" src="https://img.shields.io/badge/%F0%9F%91%AA_all_contributors-14-21bb42.svg" /></a>


<a href="https://github.com/JoshuaKGoldberg/TypeStat/blob/main/.github/CODE_OF_CONDUCT.md" target="_blank"><img alt="🤝 Code of Conduct: Kept" src="https://img.shields.io/badge/%F0%9F%A4%9D_code_of_conduct-kept-21bb42" /></a>
<a href="https://codecov.io/gh/JoshuaKGoldberg/TypeStat" target="_blank"><img alt="🧪 Coverage" src="https://img.shields.io/codecov/c/github/JoshuaKGoldberg/TypeStat?label=%F0%9F%A7%AA%20coverage" /></a>
<a href="https://github.com/JoshuaKGoldberg/TypeStat/blob/main/LICENSE.md" target="_blank"><img alt="📝 License: MIT" src="https://img.shields.io/badge/%F0%9F%93%9D_license-MIT-21bb42.svg"></a>
<a href="http://npmjs.com/package/typestat"><img alt="📦 npm version" src="https://img.shields.io/npm/v/typestat?color=21bb42&label=%F0%9F%93%A6%20npm" /></a>
<img alt="💪 TypeScript: Strict" src="https://img.shields.io/badge/%F0%9F%92%AA_typescript-strict-21bb42.svg" />

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:

• ✨ Convert JavaScript files to TypeScript in a single bound!
• ✨ Add TypeScript types on files freshly converted from JavaScript to TypeScript!
• ✨ Infer types to fix --noImplicitAny and --noImplicitThis violations!
• ✨ Annotate missing nulls and undefineds to get you started with --strictNullChecks!

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

npx typestat

shell 👋 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

Beyang Liu 💻	Daniel Stiner 🐛	Deleted user 🚧	Emerson 💻	Girish Sontakke 💻	Guten 🐛	Ibrahim H. 💻
Josh Goldberg ✨ 🚧 🐛 🔧 💻 🚇 📖	Loren Van Spronsen 💻	Mark Molinaro 🐛 💻	Nigel Gilbert 🐛	Peter A. Jonsson 🐛 💻	orionna319 🐛	rubiesonthesky 🐛 🚧 🔧 💻 ⚠️

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