@jterrazz/typescript

Drop-in TypeScript build tooling with zero configuration.

Installation

npm install @jterrazz/typescript

Usage

1. Choose a TypeScript configuration

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

2. Use the CLI

npx typescript build       # Build application (ESM + types)
npx typescript bundle      # Bundle library (ESM + CJS + types)
npx typescript start       # Run the built application
npx typescript dev         # Build, run, and rebuild on changes
npx typescript docs        # Generate API reference + llms.txt

What you get

• Blazing fast — Powered by tsdown / Rolldown (Rust)
• Zero configuration — Works out of the box
• Multiple outputs — ESM + CommonJS + TypeScript declarations
• Source maps — Full debugging support
• API docs — Typedoc reference with LLM-friendly llms.txt output

Outputs

Command	Output	Description
typescript build	dist/index.js	ESM bundle
	dist/index.d.ts	TypeScript declarations
typescript bundle	dist/index.js	ESM bundle
	dist/index.cjs	CommonJS bundle
	dist/index.d.ts	TypeScript declarations
typescript start	—	Runs dist/index.js
typescript dev	dist/index.js	Watch + rebuild + run
typescript docs	.docs/	API reference + llms.txt

Project structure

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

API docs generation

typescript docs reads TSDoc from src/index.ts and generates:

• Typedoc markdown — Full API reference under .docs/
• llms.txt — Structured index following the llms.txt standard
• llms-full.txt — Complete reference in one file for LLM context windows

No typedoc.json needed. Pair with the shared CI workflow to auto-deploy:

# .github/workflows/docs.yaml
jobs:
    docs:
        uses: jterrazz/jterrazz-actions/.github/workflows/docs.yaml@main

How it works

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

Step	Tool	Language
Transpile	Oxc (via tsdown)	Rust
Bundle	Rolldown	Rust
Declarations	tsdown built-in	Rust
API docs	Typedoc	Node

License

MIT © Jean-Baptiste Terrazzoni