@4mbl/tsconfig 0.0.0-alpha.c07b435 → 0.0.0-alpha.c0e445a

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @4mbl/tsconfig Changelog
 
+## 5.0.0-beta.2
+
+### Major Changes
+
+- f95bc32: [base] Enable noPropertyAccessFromIndexSignature
+- f95bc32: [base] Disable allowUnreachableCode
+- f95bc32: [base] Enable exactOptionalPropertyTypes
+
+### Minor Changes
+
+- fe250ba: Add template for Bun.
+
+## 5.0.0-beta.1
+
+### Minor Changes
+
+- 1bd158c: [next] Include framework generated files in rootDir scope
+
+## 5.0.0-beta.0
+
+### Major Changes
+
+- e651e24: Enable `noUncheckedSideEffectImports` on all templates. This is the default in TypeScript 6/7, we set it explicitly to ensure consistent behavior for templates that already enabled it.
+- e651e24: Disable automatic type discovery to align with TypeScript 6/7 behavior. Node.js types are now explicitly enabled for Node.js related templates.
+- e651e24: All templates now have `rootDir` option set to './src' to align with TypeScript 6/7 behavior.
+- e651e24: Drop explicit "dom.iterable" from `lib` as it is included in "dom" by default in TypeScript 6/7.
+- e651e24: Remove explicit `target` from all templates to use the latest ECMAScript version in TypeScript 6/7. The ES version on `lib` is now "ESNext" all templates.
+
 ## 4.4.0
 
 ### Minor Changes

package/README.md

@@ -2,15 +2,16 @@
 
 > Strict TypeScript configuration for various environments.
 
-* [Usage](#usage)
-* [Available templates](#available-templates)
-  * [Base (tsconfig)](#base-tsconfig)
-  * [Node (tsconfig)](#node-tsconfig)
-  * [Node-TS (tsconfig)](#node-ts-tsconfig)
-  * [Browser (tsconfig)](#browser-tsconfig)
-  * [Next (tsconfig)](#next-tsconfig)
-  * [Vite React (app | node)](#vite-react-app--node)
-* [Versioning](#versioning)
+- [Usage](#usage)
+- [Available templates](#available-templates)
+  - [Base (tsconfig)](#base-tsconfig)
+  - [Node (tsconfig)](#node-tsconfig)
+  - [Node-TS (tsconfig)](#node-ts-tsconfig)
+  - [Bun (tsconfig)](#bun-tsconfig)
+  - [Browser (tsconfig)](#browser-tsconfig)
+  - [Next (tsconfig)](#next-tsconfig)
+  - [Vite React (app | node)](#vite-react-app--node)
+- [Versioning](#versioning)
 
 ---
 
@@ -22,11 +23,21 @@ Install the [`@4mbl/tsconfig`](https://www.npmjs.com/package/@4mbl/tsconfig) npm
 npm install -D @4mbl/tsconfig
 ```
 
+Install the type definitions required by your environment:
+
+```shell
+# When using /node, /node-ts, /next, or /vite-react/node template
+npm install -D @types/node
+
+# When using /bun template
+bun add -D @types/bun
+```
+
 Create a `tsconfig.json` file in the root of your project and extend the desired `tsconfig` template.
 
 ```jsonc
 {
-  "extends": "@4mbl/tsconfig/node"
+  "extends": "@4mbl/tsconfig/node",
   // your custom configuration...
 }
 ```
@@ -47,6 +58,10 @@ Extends the base template with configuration specific to Node.js.
 
 Extends the node template with configuration for TypeScript-only projects.
 
+### Bun (<kbd>[tsconfig](https://unpkg.com/@4mbl/tsconfig@latest/bun.json)</kbd>)
+
+Extends the base template with configuration specific to Bun.
+
 ### Browser (<kbd>[tsconfig](https://unpkg.com/@4mbl/tsconfig@latest/browser.json)</kbd>)
 
 Extends the base template with configuration specific to browser and React applications.
@@ -62,11 +77,11 @@ Extends the base template with configuration from the Next.js app template.
   "extends": "@4mbl/tsconfig/next",
   "compilerOptions": {
     "paths": {
-      "@/*": ["./src/*"]
-    }
+      "@/*": ["./src/*"],
+    },
   },
   "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
+  "exclude": ["node_modules"],
 }
 ```
 
@@ -83,8 +98,8 @@ Vite uses seperate `tsconfig` files for the application and the node environment
   "files": [],
   "references": [
     { "path": "./tsconfig.app.json" },
-    { "path": "./tsconfig.node.json" }
-  ]
+    { "path": "./tsconfig.node.json" },
+  ],
 }
 ```
 
@@ -92,7 +107,7 @@ Vite uses seperate `tsconfig` files for the application and the node environment
 
 ```jsonc
 {
-  "extends": "@4mbl/tsconfig/vite-react/app"
+  "extends": "@4mbl/tsconfig/vite-react/app",
 }
 ```
 
@@ -100,7 +115,7 @@ Vite uses seperate `tsconfig` files for the application and the node environment
 
 ```jsonc
 {
-  "extends": "@4mbl/tsconfig/vite-react/node"
+  "extends": "@4mbl/tsconfig/vite-react/node",
 }
 ```
 

package/dist/base.json

@@ -3,7 +3,8 @@
   "display": "Base",
   "compilerOptions": {
     /* Base Options */
-    "lib": ["ESNext"],
+    "rootDir": "${configDir}/src",
+    "lib": ["esnext"],
     "allowJs": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,
@@ -11,9 +12,12 @@
     "paths": {
       "@/*": ["${configDir}/src/*"]
     },
+    "types": [],
 
     /* Output */
-    "target": "ES6",
+    //* "target" is omitted here intentionally, typescript
+    //* defaults to current year's ecmascript standard
+
     "outDir": "${configDir}/dist",
     "sourceMap": true,
     "declarationMap": true,
@@ -28,15 +32,19 @@
     "strict": true,
     "checkJs": true,
     "erasableSyntaxOnly": true,
-    "forceConsistentCasingInFileNames": true,
     "allowSyntheticDefaultImports": true,
+    "allowUnreachableCode": false,
+    "exactOptionalPropertyTypes": true,
+    "forceConsistentCasingInFileNames": true,
     "noFallthroughCasesInSwitch": true,
     "noImplicitAny": true,
     "noImplicitOverride": true,
     "noImplicitReturns": false,
+    "noPropertyAccessFromIndexSignature": true,
+    "noUncheckedIndexedAccess": true,
+    "noUncheckedSideEffectImports": true,
     "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noUncheckedIndexedAccess": true
+    "noUnusedParameters": true
   },
   "include": ["${configDir}/src/**/*"],
   "exclude": ["${configDir}/node_modules"]

package/dist/browser.json

@@ -3,11 +3,12 @@
   "display": "Browser",
   "extends": "./base.json",
   "compilerOptions": {
-    "lib": ["DOM", "DOM.Iterable", "ESNext"],
+    "lib": ["esnext", "dom"],
     "jsx": "react-jsx",
     "module": "ESNext",
     "moduleResolution": "Bundler",
     "paths": { "*": ["${configDir}/src/*"] },
+    "types": [],
     "noEmit": true,
     "sourceMap": true
   }

package/dist/bun.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Bun",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "moduleResolution": "bundler",
+    "module": "preserve",
+    "paths": { "*": ["${configDir}/src/*"] },
+    "types": ["bun"],
+
+    "noEmit": true,
+    "allowImportingTsExtensions": true
+  }
+}

package/dist/next.json

@@ -3,8 +3,8 @@
   "display": "Next.js",
   "extends": "./base.json",
   "compilerOptions": {
-    "target": "ES2017",
-    "lib": ["dom", "dom.iterable", "esnext"],
+    "rootDir": "${configDir}",
+    "lib": ["esnext", "dom"],
     "allowJs": true,
     "skipLibCheck": true,
     "strict": true,
@@ -23,7 +23,8 @@
     ],
     "paths": {
       "@/*": ["${configDir}/src/*"]
-    }
+    },
+    "types": ["node"]
   },
   "include": [
     "${configDir}/next-env.d.ts",

package/dist/node-ts.json

@@ -4,10 +4,10 @@
   "extends": "./base.json",
   "compilerOptions": {
     // same options as node template
-    "target": "ESNext",
     "moduleResolution": "NodeNext",
     "module": "NodeNext",
     "paths": { "*": ["${configDir}/src/*"] },
+    "types": ["node"],
 
     // options for typescript-only
     // https://nodejs.org/api/typescript.html#type-stripping

package/dist/node.json

@@ -3,9 +3,9 @@
   "display": "Node",
   "extends": "./base.json",
   "compilerOptions": {
-    "target": "ESNext",
     "moduleResolution": "NodeNext",
     "module": "NodeNext",
-    "paths": { "*": ["${configDir}/src/*"] }
+    "paths": { "*": ["${configDir}/src/*"] },
+    "types": ["node"]
   }
 }

package/dist/vite-react/app.json

@@ -4,19 +4,16 @@
   "extends": "../base.json",
   "compilerOptions": {
     "tsBuildInfoFile": "${configDir}/node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "target": "ES2022",
     "useDefineForClassFields": true,
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "lib": ["esnext", "dom"],
     "module": "ESNext",
+    "types": [],
 
     /* Bundler mode */
     "moduleResolution": "bundler",
     "allowImportingTsExtensions": true,
     "noEmit": true,
-    "jsx": "react-jsx",
-
-    /* Linting */
-    "noUncheckedSideEffectImports": true
+    "jsx": "react-jsx"
   },
   "include": ["${configDir}/src"]
 }

package/dist/vite-react/node.json

@@ -4,17 +4,14 @@
   "extends": "../base.json",
   "compilerOptions": {
     "tsBuildInfoFile": "${configDir}/node_modules/.tmp/tsconfig.node.tsbuildinfo",
-    "target": "ES2023",
-    "lib": ["ES2023"],
+    "lib": ["esnext"],
     "module": "ESNext",
+    "types": ["node"],
 
     /* Bundler mode */
     "moduleResolution": "bundler",
     "allowImportingTsExtensions": true,
-    "noEmit": true,
-
-    /* Linting */
-    "noUncheckedSideEffectImports": true
+    "noEmit": true
   },
   "include": ["${configDir}/vite.config.ts"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4mbl/tsconfig",
-  "version": "0.0.0-alpha.c07b435",
+  "version": "0.0.0-alpha.c0e445a",
   "description": "Strict TypeScript configuration for various environments.",
   "type": "module",
   "author": "4mbl",
@@ -8,6 +8,7 @@
   "homepage": "https://github.com/4mbl/config/tree/main/packages/tsconfig#readme",
   "exports": {
     "./browser": "./dist/browser.json",
+    "./bun": "./dist/bun.json",
     "./next": "./dist/next.json",
     "./node-ts": "./dist/node-ts.json",
     "./node": "./dist/node.json",
@@ -30,7 +31,7 @@
     "tsconfig"
   ],
   "peerDependencies": {
-    "typescript": ">=5.8.0"
+    "typescript": ">=6.0.0"
   },
   "peerDependenciesMeta": {
     "typescript": {