Install

npm i @ecubelabs/tsconfig

Usage

TypeScript 6.0 note — @types/* are no longer auto-included

Starting with TypeScript 6.0, the compiler no longer auto-includes every @types/* package found in node_modules/@types for the global scope. If your code relies on ambient globals (e.g. process/Buffer from @types/node, Jest/Vitest globals), you must now list them explicitly in your own tsconfig.json:

"types": ["node"]

This applies to every preset (legacy and modern) — the base configs intentionally do not set types, since the right value is per-consumer.

React (Modern Resolution, Bundler) tsconfig.json

TypeScript 6.0-clean React preset for bundler-driven apps (Webpack, etc.). Same intent as react.json, but modernized: target: ES2020 (up from es5), module: "esnext", and moduleResolution: "bundler" (honors exports/imports in dependencies). Keeps esModuleInterop, allowSyntheticDefaultImports, jsx, and experimentalDecorators. Requires typescript>=5.9; required under >=6.0 because react.json uses options (target: es5, moduleResolution: node10) that 6.0 rejects.

"extends": "@ecubelabs/tsconfig/react-modern.json"

Node Modern Resolution presets (CommonJS runtime)

These presets keep the CommonJS emit/runtime exactly as the legacy node* presets, but modernize only the module resolution (module: "node20", no moduleResolution → auto node16). This honors the exports/imports fields in dependencies' package.json, fixing resolution failures with modern packages — without any source/ESM migration. They keep experimentalDecorators + emitDecoratorMetadata (TypeORM) and skipLibCheck, and are TypeScript 6.0-clean (the legacy node* presets use moduleResolution: node10, which 6.0 rejects).

Do not add "type": "module" to your package.json; that keeps the emit as CommonJS.

Switching to modern resolution also implicitly enables esModuleInterop, allowSyntheticDefaultImports, and moduleDetection: "force". This is non-breaking (emit stays CJS) but changes resolution/interop behavior, so run tsc --noEmit once to verify after switching. Requires typescript>=5.9.

Node 22 (Modern) tsconfig.json

"extends": "@ecubelabs/tsconfig/node22-modern.json"

Node 20 (Modern) tsconfig.json

"extends": "@ecubelabs/tsconfig/node20-modern.json"

Node 22 tsconfig.json

Add to your tsconfig.json This tsconfig requires typescript>=5.7

"extends": "@ecubelabs/tsconfig/node22.json"

Node 20 tsconfig.json

Add to your tsconfig.json This tsconfig requires typescript>=5

"extends": "@ecubelabs/tsconfig/node20.json"

Node 18 tsconfig.json

Add to your tsconfig.json

"extends": "@ecubelabs/tsconfig/node18.json"

Node 16 tsconfig.json

Add to your tsconfig.json

"extends": "@ecubelabs/tsconfig/node16.json"

Node 14 tsconfig.json

Add to your tsconfig.json

"extends": "@ecubelabs/tsconfig/node14.json"

Node 12 tsconfig.json

Add to your tsconfig.json

"extends": "@ecubelabs/tsconfig/node12.json"

Node 10 tsconfig.json

Add to your tsconfig.json

"extends": "@ecubelabs/tsconfig/node10.json"