@stackra/typescript-config

Shared TypeScript configuration presets for all Stackra packages.

Install

pnpm add -D @stackra/typescript-config

Presets

Preset	Import	Use Case
base	@stackra/typescript-config/base	Foundation — all options, extended by other presets
bundler	@stackra/typescript-config/bundler	Config packages built with tsup (sets outDir/rootDir)
react-lib	@stackra/typescript-config/react-lib	React component libraries
nest-lib	@stackra/typescript-config/nest-lib	NestJS libraries (NodeNext resolution)
nest-app	@stackra/typescript-config/nest-app	NestJS applications
next	@stackra/typescript-config/next	Next.js applications
react-native-lib	@stackra/typescript-config/react-native-lib	React Native libraries
react-native-app	@stackra/typescript-config/react-native-app	React Native apps (extends expo)

Usage

Library package (container, http, redis, support)

// tsconfig.json
{
  "extends": "@stackra/typescript-config/base",
  "compilerOptions": {
    "outDir": "./dist",
    "rootDir": ".",
    "paths": { "@/*": ["./src/*"] },
  },
  "include": ["src/**/*", "__tests__/**/*"],
  "exclude": ["node_modules", "dist"],
}

Config package (eslint-config, prettier-config, tsup-config)

// tsconfig.json
{
  "extends": "@stackra/typescript-config/bundler",
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"],
}

Base Preset Reference

Every option in base.json explained:

Output Target

Option	Value	Why
target	ES2022	Top-level await, private fields, Array.at() — all @stackra packages target Node 22+

Module System

Option	Value	Why
module	ESNext	ESM-first output, optimized for tsup/vite/esbuild
moduleResolution	bundler	Understands package.json exports, no file extensions needed
moduleDetection	force	Every file is a module — prevents global scope pollution

Runtime Libraries

Option	Value	Why
lib	ES2022, DOM, DOM.Iterable	ES2022 APIs + DOM for React hooks and jsdom tests
types	["node"]	Node.js globals (process, Buffer, etc.) — without this: "Cannot find name 'process'"

Strict Type Checking

Option	Value	Why
strict	true	All strict checks: strictNullChecks, noImplicitAny, etc.
noUncheckedIndexedAccess	true	Array/object access returns T | undefined
noUnusedLocals	true	Flag unused variables (prefix with _ to ignore)
noUnusedParameters	true	Flag unused params (prefix with _ to ignore)
noImplicitReturns	true	Catch missing return statements
noFallthroughCasesInSwitch	true	Catch fall-through in switch

Declaration Output

Option	Value	Why
declaration	true	Generate .d.ts for consumers
declarationMap	true	.d.ts.map for IDE "Go to Definition" into source
sourceMap	true	.js.map for debugging

Interop

Option	Value	Why
esModuleInterop	true	Default imports from CJS modules
allowSyntheticDefaultImports	true	import x from 'cjs-module' works
isolatedModules	true	Each file compiled independently (required by tsup/esbuild)
resolveJsonModule	true	import pkg from './package.json' works
skipLibCheck	true	Skip type-checking node_modules — massive speed boost
forceConsistentCasingInFileNames	true	Catches path casing bugs on macOS/Windows

Decorators

Option	Value	Why
experimentalDecorators	true	@Injectable, @Inject, NestJS decorators
emitDecoratorMetadata	true	Runtime reflection for DI container

JSX

Option	Value	Why
jsx	react-jsx	Automatic JSX transform (React 17+) — no import React needed

Deprecation Handling

Option	Value	Why
ignoreDeprecations	6.0	Silences baseUrl/paths deprecation warning in TS 6+ (still needed for @ aliases)

License

MIT © Stackra L.L.C