TypeScript's command-line compiler tsc without type-checking. Benefits:
- Still checks and reports syntax errors.
- Exit code indicates syntax errors only; is not affected by type errors.
- Faster, since it skips typechecking and doesn't need to parse .d.ts files or perform import resolution.
Lots of TypeScript tools have an option to skip typechecking. (ts-node,
ts-loader, ts-jest, etc) I'm not aware of one that performs command-line
compilation like tsc.
Note: you must manually install typescript as a dependency. This package does not declare it as a dependency.
See also: ts-node-to
Usage
Run in the root of your project.
$ tsc-to
If you prefer a more explicit name:
$ tsc-transpile-only
Limitations & Behavior
At the moment, this tool does not accept any CLI options.
- CWD is used to discover tsconfig.json.
- Will only compile files referenced in tsconfig.json "includes", "files", and "excludes". Module resolution is skipped, so transitive dependencies are not compiled.
- Reports "options" and "syntactic" diagnostics in --pretty mode only. In the future I would like to add non-pretty and JSON outputs.
- Does not generate .d.ts files. Typechecking is required for that; use
tsc. - Logging is diagnostic and subject to change. I would like to make it more closely match
tsc's behavior in the future.
Questions or Issues?
File a Github issue.