Tsx-Strict

Type-safe TSX runner with automatic type-checking

tsx-strict is a CLI tool that runs TypeScript files with TSX while providing real-time type checking. It combines the speed of tsx with the safety of TypeScript's compiler, ensuring your code is both executable and type-safe.

Features

• Real-time type checking: Runs TypeScript compiler alongside tsx for immediate feedback
• Watch mode: Automatically restarts on file changes
• Intelligent process management: Kills previous processes when recompilation starts
• Customizable compiler: Support for different TypeScript compiler versions
• Silent mode: Suppress output when needed
• Memory management: Configure Node.js memory limits

Installation

pnpm install -g tsx-strict

Or use with npx:

npx tsx-strict your-file.ts

Usage

Basic Usage

tsx-strict app.ts

Watch Mode

tsx-strict --watch app.ts

Skip Type Checking

tsx-strict --no-type-check app.ts

CLI Options

| Option | Description | Default | | ---------------------- | ---------------------------------------- | -------------------- | | -w, --watch | Enable watch mode | false | | --no-clear | Do not clear screen | false | | --compiler | Compiler path | typescript/bin/tsc | | --tsc-args <args...> | Additional TypeScript compiler arguments | [] | | --tsx-args <args...> | Additional tsx arguments | [] | | --silent | Suppress output | false | | --no-type-check | Skip type checking (run tsx directly) | false |

Examples

Basic TypeScript File

tsx-strict src/index.ts

Watch Mode with Custom TSC Arguments

tsx-strict --watch --tsc-args "--strict --exactOptionalPropertyTypes" src/app.ts

Silent Mode

tsx-strict --silent --no-clear src/worker.ts

Skip Type Checking for Quick Execution

tsx-strict --no-type-check src/script.ts

How It Works

tsx-strict runs two processes simultaneously:

1. TypeScript Compiler (tsc): Performs type checking with --noEmit flag
2. tsx Runner: Executes the TypeScript file when compilation succeeds

The tool intelligently manages these processes, restarting tsx only when type checking passes and killing previous instances to prevent resource conflicts.

Requirements

• Node.js >= 20.0.0
• tsx ^4.20.5 (peer dependency)

API

You can also use tsx-strict programmatically:

import { runTsxStrict } from "tsx-strict";

await runTsxStrict("src/app.ts", {
    watch: true,
    silent: false,
    noClear: false,
    compiler: "typescript/bin/tsc",
    tscArgs: ["--strict"],
    tsxArgs: [],
    noTypeCheck: false,
});

Error Handling

tsx-strict provides clear error messages and exits gracefully on compilation errors. Type errors are displayed in real-time, and the tsx process only runs when compilation is successful.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Repository

https://github.com/uanela/tsx-strict

Issues

Report issues at: https://github.com/uanela/tsx-strict/issues