@jterrazz/typescript

Drop-in TypeScript build tooling with zero configuration.

About

Hey there – I'm Jean-Baptiste, just another developer doing weird things with code. All my projects live on jterrazz.com – complete with backstories and lessons learned. Feel free to poke around – you might just find something useful!

Installation

npm install @jterrazz/typescript

Usage

1. Choose a TypeScript configuration

// tsconfig.json - Pick one:
{ "extends": "@jterrazz/typescript/tsconfig/node" }  // Node.js projects
{ "extends": "@jterrazz/typescript/tsconfig/next" }  // Next.js projects
{ "extends": "@jterrazz/typescript/tsconfig/expo" }  // Expo/React Native

2. Use the CLI

npx typescript watch       # Watch mode (build + run on changes)
npx typescript build --app # Production build (ESM + types)
npx typescript build --lib # Library build (ESM + CJS + types)

What you get

• Blazing fast — Powered by Rolldown (Rust) and tsgo (Go)
• Zero configuration — Works out of the box
• Multiple outputs — ESM + CommonJS + TypeScript declarations
• Source maps — Full debugging support

Build outputs

| Command | Output | Description | | ------------------------ | ----------------- | ------------------------------- | | typescript watch | dist/index.js | ESM only, fast rebuilds (~20ms) | | typescript build --app | dist/index.js | ESM bundle | | | dist/index.d.ts | TypeScript declarations | | typescript build --lib | dist/index.js | ESM bundle | | | dist/index.cjs | CommonJS bundle | | | dist/index.d.ts | TypeScript declarations |

If src/instrumentation.ts exists, it will also generate corresponding instrumentation.* files.

Project structure

your-project/
├── src/
│   ├── index.ts           # Main entry point
│   └── instrumentation.ts # Optional instrumentation entry point
├── dist/                  # Generated files
└── tsconfig.json          # Extends this package

How it works

The package uses a fully compiled toolchain — no JavaScript in the hot path:

| Step | Tool | Language | | ------------ | ------------------------------------------------------- | -------- | | Transpile | Oxc (via Rolldown) | Rust | | Bundle | Rolldown | Rust | | Declarations | tsgo | Go |

License

MIT © Jean-Baptiste Terrazzoni