@igorskyflyer/tsconfig 1.0.2 → 2.0.0

package/README.md

@@ -27,13 +27,13 @@
 
 ## Features
 
-- 🔧 Strict `TypeScript` rules enabled by default
-- 📦 Separate configs for `Node` and `browser` environments
-- 🎯 `ES2024` target - `modern` and future-ready
-- 🗂️ Predefined `src/`, `dist/` and `test/` structure
-- 🔍 Catches `unused` locals, parameters and implicit `any`
-- 🗺️ `Source maps` and `declaration` maps included
-- ⚡ `Zero-config` setup - extend and go
+- 🔧 Very strict TypeScript configuration by default (`strict: true` + modern strict options)
+- 📦 Separate configs for Node.js and browser environments
+- 🎯 `ES2024` target - modern and future-ready (requires Node ≥ 24)
+- 🗺️ Full source maps + declaration maps for excellent debugging and type publishing
+- ⚡ `verbatimModuleSyntax` + `isolatedDeclarations` for clean, modern module handling
+- 🔍 Strong type safety with `exactOptionalPropertyTypes`, `noUncheckedIndexedAccess`, and more
+- 🧩 Clean, reusable base - designed to be extended with minimal effort
 
 <br>
 
@@ -42,23 +42,28 @@
 Install it by executing any of the following, depending on the preferred package manager:
 
 ```bash
-pnpm add -D @igorskyflyer/tsconfig
+bun add @igorskyflyer/tsconfig -D
 ```
 
 ```bash
-yarn add -D @igorskyflyer/tsconfig
+pnpm add @igorskyflyer/tsconfig -D
 ```
 
 ```bash
-npm i -D @igorskyflyer/tsconfig
+yarn add @igorskyflyer/tsconfig -D
+```
+
+```bash
+npm i @igorskyflyer/tsconfig -D
 ```
 
 <br>
 
-Then extend the preferred config in `tsconfig.json`:
+Then extend the preferred config in **tsconfig.json**:
 
-**Node (default):**
-```jsonc
+**Node (default)**
+`tsconfig.json`
+```json
 {
   "extends": "@igorskyflyer/tsconfig",
   "include": ["src/**/*"],
@@ -70,8 +75,11 @@ Then extend the preferred config in `tsconfig.json`:
 }
 ```
 
-**Node (explicit):**
-```jsonc
+<br>
+
+**Node (explicit)**
+`tsconfig.json`
+```json
 {
   "extends": "@igorskyflyer/tsconfig/node",
   "include": ["src/**/*"],
@@ -83,8 +91,11 @@ Then extend the preferred config in `tsconfig.json`:
 }
 ```
 
-**Browser:**
-```jsonc
+<br>
+
+**Browser**
+`tsconfig.json`
+```json
 {
   "extends": "@igorskyflyer/tsconfig/browser",
   "include": ["src/**/*"],
@@ -96,8 +107,11 @@ Then extend the preferred config in `tsconfig.json`:
 }
 ```
 
-**Base only:**
-```jsonc
+<br>
+
+**Base only**
+`tsconfig.json`
+```json
 {
   "extends": "@igorskyflyer/tsconfig/base",
   "include": ["src/**/*"],
@@ -120,21 +134,27 @@ Then extend the preferred config in `tsconfig.json`:
 All configs extend `base`, which defines the shared structure and strict rules.
 
 ### Base
+`tsconfig.json`
 ```jsonc
 {
   "compilerOptions": {
-    "declaration": true,      // generate .d.ts files
-    "declarationMap": true,   // generate .d.ts.map files
-    "sourceMap": true,        // generate .js.map files
-    "verbatimModuleSyntax": true, // enforce explicit import/export types
-    "strict": true,               // enable all strict checks
-    "noUnusedLocals": true,       // error on unused local variables
-    "noUnusedParameters": true,   // error on unused function parameters
-    "noImplicitAny": true,        // error on implicit 'any' types
-    "noImplicitReturns": true,    // error on missing return statements
-    "skipLibCheck": true,         // skip type-checking of .d.ts files
+    "declaration": true,                    // generate .d.ts files
+    "declarationMap": true,                 // generate .d.ts.map files
+    "sourceMap": true,                      // generate .js.map files
+    "verbatimModuleSyntax": true,           // enforce explicit import/export types
+    "isolatedDeclarations": true,           // require explicit types on all exports (faster .d.ts emit)
+    "strict": true,                         // enable all strict type checks
+    "exactOptionalPropertyTypes": true,     // treat optional properties strictly (undefined vs missing)
+    "noFallthroughCasesInSwitch": true,     // error on switch cases that fall through
+    "noUncheckedIndexedAccess": true,       // index signatures include undefined
+    "noPropertyAccessFromIndexSignature": true, // prevent property access outside index signatures
+    "noUnusedLocals": true,                 // error on unused local variables
+    "noUnusedParameters": true,             // error on unused function parameters
+    "noImplicitAny": true,                  // error on implicit 'any' types
+    "noImplicitReturns": true,              // error on functions missing return statements
+    "skipLibCheck": true,                   // skip type-checking of declaration files
     "forceConsistentCasingInFileNames": true, // enforce consistent file casing
-    "noEmitOnError": true         // skip emit if type errors exist
+    "noEmitOnError": true                   // don't emit files if there are type errors
   }
 }
 ```
@@ -142,12 +162,14 @@ All configs extend `base`, which defines the shared structure and strict rules.
 ### Node
 
 Extends `base` and adds `Node` environment targeting:
+`tsconfig.json`
 ```jsonc
 {
   "extends": "./tsconfig.base.json",
   "compilerOptions": {
     "target": "ES2024",          // modern JS output
     "lib": ["ES2024"],           // modern built-in types
+    "types": ["node"],           // Node.js global type definitions
     "module": "NodeNext",        // Node ESM-compatible modules
     "moduleResolution": "NodeNext" // Node ESM module resolution
   }
@@ -157,6 +179,7 @@ Extends `base` and adds `Node` environment targeting:
 ### Browser
 
 Extends `base` and adds `browser` environment targeting:
+`tsconfig.json`
 ```jsonc
 {
   "extends": "./tsconfig.base.json",
@@ -164,7 +187,12 @@ Extends `base` and adds `browser` environment targeting:
     "target": "ES2024",                        // modern JS output
     "lib": ["ES2024", "DOM", "DOM.Iterable"],  // modern + DOM types
     "module": "ESNext",                        // bundler-compatible modules
-    "moduleResolution": "Bundler"              // bundler module resolution
+    "moduleResolution": "Bundler",              // bundler module resolution
+    "allowImportingTsExtensions": true,        // allow explicit .ts extensions in imports
+    "erasableSyntaxOnly": true,                // ensure compatibility with type-stripping engines
+    "noEmit": true,                            // hand over file emission to the bundler
+    "declaration": false,                      // disable base declaration emit to prevent noEmit conflict
+    "declarationMap": false                    // disable base declaration maps
   }
 }
 ```
@@ -209,6 +237,10 @@ Licensed under the [**MIT license**](https://github.com/igorskyflyer/npm-tsconfi
 
 ## Related
 
+This package is part of the [**dotfiles**](https://github.com/igorskyflyer/dotfiles) DX config suite - a curated index of independently installable configuration packages for linting, formatting, editing, JS/TS, React, Vue and many more.
+
+### Other related packages
+
 [**@igorskyflyer/duoscribi**](https://www.npmjs.com/package/@igorskyflyer/duoscribi)
 
 > _✒ DúöScríbî allows you to convert letters with diacritics to regular letters. 🤓_

package/package.json

@@ -1,18 +1,40 @@
 {
   "name": "@igorskyflyer/tsconfig",
-  "version": "1.0.2",
-  "description": "🔧 Opinionated, reusable TSConfig base for modern TypeScript projects by igorskyflyer. 🧠",
+  "version": "2.0.0",
+  "description": "🔧 Opinionated, reusable TSConfig base for modern TypeScript projects. 🧠",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "exports": {
+    ".": "./tsconfig.json",
+    "./base": "./tsconfig.base.json",
+    "./node": "./tsconfig.node.json",
+    "./browser": "./tsconfig.browser.json"
+  },
   "files": [
     "tsconfig.base.json",
     "tsconfig.browser.json",
     "tsconfig.json",
     "tsconfig.node.json"
   ],
-  "exports": {
-    ".": "./tsconfig.json",
-    "./base": "./tsconfig.base.json",
-    "./node": "./tsconfig.node.json",
-    "./browser": "./tsconfig.browser.json"
+  "peerDependencies": {
+    "typescript": ">=6.0.0",
+    "@types/node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "private": false,
+  "license": "MIT",
+  "author": "Igor Dimitrijević <support@igorskyflyer.me> (https://github.com/igorskyflyer)",
+  "funding": "https://ko-fi.com/igorskyflyer",
+  "homepage": "https://github.com/igorskyflyer/npm-tsconfig",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/igorskyflyer/npm-tsconfig.git"
+  },
+  "bugs": {
+    "url": "https://github.com/igorskyflyer/npm-tsconfig/issues"
   },
   "keywords": [
     "tsconfig",
@@ -29,23 +51,6 @@
     "igor dimitrijević",
     "igorskyflyer"
   ],
-  "license": "MIT",
-  "author": "Igor Dimitrijević <support@igorskyflyer.me> (https://github.com/igorskyflyer)",
-  "funding": "https://ko-fi.com/igorskyflyer",
-  "homepage": "https://github.com/igorskyflyer/npm-tsconfig",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/igorskyflyer/npm-tsconfig.git"
-  },
-  "bugs": {
-    "url": "https://github.com/igorskyflyer/npm-tsconfig/issues"
-  },
-  "peerDependencies": {
-    "typescript": ">=5.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "scripts": {
     "pub": "git push origin main --tags"
   }

package/tsconfig.base.json

@@ -12,6 +12,11 @@
     "noImplicitReturns": true,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
-    "noEmitOnError": true
+    "noEmitOnError": true,
+    "exactOptionalPropertyTypes": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "isolatedDeclarations": true
   }
 }

package/tsconfig.browser.json

@@ -9,6 +9,11 @@
       "DOM.Iterable"
     ],
     "module": "ESNext",
-    "moduleResolution": "Bundler"
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "erasableSyntaxOnly": true,
+    "noEmit": true,
+    "declaration": false,
+    "declarationMap": false
   }
 }

package/tsconfig.node.json

@@ -6,6 +6,9 @@
     "lib": [
       "ES2024"
     ],
+    "types": [
+      "node"
+    ],
     "module": "NodeNext",
     "moduleResolution": "NodeNext"
   }