@tsconfig/node-lts

@tsconfig/node-lts provides a curated TypeScript configuration base specifically designed for Node.js LTS (Long Term Support) versions. It offers a standardized tsconfig.json setup that developers can extend in their projects, featuring optimized compiler options including ES2023 library support, Node16 module resolution, ES2022 target compilation, and strict type checking enabled.

Package Information

• Package Name: @tsconfig/node-lts
• Package Type: npm
• Language: JSON (TypeScript Configuration)
• Installation: npm install --save-dev @tsconfig/node-lts

Core Imports

This package is used through TypeScript configuration inheritance, not code imports:

{
  "extends": "@tsconfig/node-lts/tsconfig.json"
}

Basic Usage

1. Install the package as a dev dependency:

npm install --save-dev @tsconfig/node-lts

1. Create or update your project's tsconfig.json:

{
  "extends": "@tsconfig/node-lts/tsconfig.json",
  "compilerOptions": {
    // Your project-specific overrides
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

1. The configuration will automatically apply Node.js LTS-optimized settings to your TypeScript compilation.

Capabilities

TypeScript Configuration Extension

Provides a base TypeScript configuration optimized for Node.js LTS versions that can be extended in project tsconfig.json files.

{
  "$schema": "https://json.schemastore.org/tsconfig",
  "display": "Node LTS",
  "_version": "20.1.0",
  "compilerOptions": {
    "lib": ["es2023"],
    "module": "node16",
    "target": "es2022",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "moduleResolution": "node16"
  }
}

Compiler Options Configuration

The package configures the following TypeScript compiler options:

Library Support

{
  "lib": ["es2023"]
}

Enables ES2023 standard library definitions, providing access to the latest JavaScript features supported by Node.js LTS.

Module System Configuration

{
  "module": "node16",
  "moduleResolution": "node16"
}

• module: Sets module system to node16 for Node.js 16+ compatibility
• moduleResolution: Uses Node.js 16+ module resolution algorithm supporting both CommonJS and ESM

Compilation Target

{
  "target": "es2022"
}

Targets ES2022 JavaScript features, optimized for Node.js LTS runtime capabilities.

Type Checking Configuration

{
  "strict": true,
  "esModuleInterop": true,
  "skipLibCheck": true
}

• strict: Enables all strict type checking options for maximum type safety
• esModuleInterop: Allows default imports from CommonJS modules
• skipLibCheck: Skips type checking of declaration files for improved build performance

Schema Validation

{
  "$schema": "https://json.schemastore.org/tsconfig"
}

Provides JSON schema reference for IDE validation and IntelliSense support in TypeScript configuration files.

Version Tracking

{
  "_version": "20.1.0"
}

Internal version identifier for the configuration template.

Usage Examples

Basic Project Setup

{
  "extends": "@tsconfig/node-lts/tsconfig.json",
  "compilerOptions": {
    "outDir": "./build",
    "declaration": true
  },
  "include": ["src/**/*"]
}

Multiple Configuration Extension (TypeScript 5.0+)

{
  "extends": [
    "@tsconfig/strictest/tsconfig.json",
    "@tsconfig/node-lts/tsconfig.json"
  ],
  "compilerOptions": {
    "outDir": "./dist"
  }
}

Override Specific Options

{
  "extends": "@tsconfig/node-lts/tsconfig.json",
  "compilerOptions": {
    "target": "es2020",
    "moduleResolution": "node",
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}

Integration Points

TypeScript Compiler Integration

The configuration is consumed by:

• tsc command for compilation
• TypeScript language server for IDE support
• Build tools that process TypeScript (webpack, rollup, etc.)

IDE Support

Provides automatic configuration for:

• Visual Studio Code TypeScript support
• WebStorm/IntelliJ TypeScript service
• Other editors with TypeScript language server integration

Build System Compatibility

Compatible with popular Node.js build systems:

• Native TypeScript compiler
• ts-node for development
• Bundlers like webpack, rollup, esbuild
• Test runners like Jest, Vitest
• Development servers like nodemon with ts-node

Error Handling

Configuration Validation Errors

TypeScript will report configuration errors if:

• Invalid compiler options are specified
• Conflicting module system settings are used
• Incompatible target/lib combinations are set

Runtime Compatibility

The configuration ensures compatibility with Node.js LTS versions. Using features not supported by the target Node.js version may result in runtime errors despite successful compilation.

Advanced Usage

Custom Library Extensions

{
  "extends": "@tsconfig/node-lts/tsconfig.json",
  "compilerOptions": {
    "lib": ["es2023", "dom"]
  }
}

Path Mapping Configuration

{
  "extends": "@tsconfig/node-lts/tsconfig.json",
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@core/*": ["src/core/*"],
      "@utils/*": ["src/utils/*"]
    }
  }
}

Monorepo Configuration

{
  "extends": "@tsconfig/node-lts/tsconfig.json",
  "references": [
    { "path": "./packages/core" },
    { "path": "./packages/utils" }
  ]
}