@codecompose/typescript-config 2.3.0 → 3.0.1-0

package/README.md

@@ -4,14 +4,17 @@ Opinionated and reusable Typescript configurations, geared towards modern build
 
 - Only use the Typescript compiler for type-checking (*) 
 - Use your bundler to output code, sourcemaps, and type declarations where needed.
-- Use strict settings, including `noUncheckedIndexedAccess` and `erasableSyntaxOnly`.
+- Requires TypeScript 6.0 or later
+- Builds on TS6 strict defaults with additional strictness: `noUncheckedIndexedAccess`, `noImplicitOverride`, and `erasableSyntaxOnly`
 - Assume `src` and `dist` directories
 - Use of `~/` or `@/` as path alias for `src`
-- Leverages TS 5.5 feature `${configDir}` to remove all client configuration.
+- Uses `${configDir}` to remove all client configuration
 
 (*) Project references / shared monorepo packages also emit code.
 
-To use this successfully, you would need a modern bundler like [tsdown](https://tsdown.dev/). You can check out the [mono-ts](https://github.com/0x80/mono-ts) boilerplate for a working example of a modern monorepo setup with tsdown.
+To use this successfully, you would need a modern bundler like [tsdown](https://tsdown.dev/). You can check out the [typescript-monorepo](https://github.com/0x80/typescript-monorepo) boilerplate for a working example of a modern monorepo setup with tsdown.
+
+These configurations are also compatible with [TSGo](https://github.com/nicksrandall/tsgo), the native Go port of the TypeScript compiler.
 
 
 ## Install
@@ -71,9 +74,37 @@ If you publish your package, it is recommended to include the Typescript source
 
 To export source files next to your dist output, you define the `files` field in your package.json as `["src", "dist"]`.
 
-## Caveats
+## V3 — TypeScript 6
+
+V3 is a major release that requires TypeScript 6.0 or later.
+
+TypeScript 6 aligns its defaults with the strict-by-default philosophy that this package has always followed. As a result, the base config is now leaner — options that are now TS6 defaults (`strict`, `esModuleInterop`) have been removed, and `isolatedModules` was dropped since it is implied by `verbatimModuleSyntax`.
 
-Older tooling might not correctly interpret the use of `${configDir}`, which this package uses extensively, and was only introduced in TS v5.5.
+TS6 also defaults `types` to `[]`, meaning `@types/*` packages are no longer auto-included. If your project depends on ambient type packages, you need to explicitly add them to your tsconfig:
+
+```json
+{
+  "extends": "@codecompose/typescript-config/base",
+  "compilerOptions": {
+    "types": ["node"]
+  }
+}
+```
+
+This aligns with the strict-by-default philosophy — type dependencies should be explicit.
+
+For users upgrading from v2, see the migration guide below.
+
+## Migrating from v2
+
+- **TypeScript 6 is required** — there is no backward compatibility with TS5
+- **Removed `strict: true`** — now a TS6 default
+- **Removed `esModuleInterop: true`** — safe interop behavior is always on in TS6
+- **Removed `isolatedModules: true`** — implied by `verbatimModuleSyntax`
+- **Removed commented-out `baseUrl`** — deprecated in TS6
+- **Action required:** if you relied on auto-included `@types/*` packages, add `"types": ["node"]` (or whatever types you need) to your tsconfig
+
+## Caveats
 
 Next.js v15 requires you to explicitly configure "includes". If you give it just "src" it will inject its own types on startup. I assume this will improve in the future.
 

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@codecompose/typescript-config",
   "description": "Opinionated reusable TypeScript configurations",
-  "version": "2.3.0",
+  "version": "3.0.1-0",
   "license": "MIT",
   "author": "Thijs Koerselman",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/0x80/typescript-config"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -31,5 +35,9 @@
     "./shared-library": "./src/shared-library.json",
     "./shared-react-library": "./src/shared-react-library.json"
   },
-  "devDependencies": {}
-}
+  "peerDependencies": {
+    "typescript": ">=6.0.0"
+  },
+  "devDependencies": {},
+  "packageManager": "pnpm@9.8.0"
+}

package/src/base.json

@@ -3,18 +3,15 @@
   "display": "Base configuration",
   "compilerOptions": {
     /* Base Options: */
-    "esModuleInterop": true,
     "skipLibCheck": true,
     "target": "esnext",
     "lib": ["esnext"],
     "allowJs": true,
     "resolveJsonModule": true,
     "moduleDetection": "force",
-    "isolatedModules": true,
     "verbatimModuleSyntax": true,
 
     /* Strictness */
-    "strict": true,
     "noUncheckedIndexedAccess": true,
     "noImplicitOverride": true,
     "erasableSyntaxOnly": true,
@@ -24,7 +21,6 @@
     "tsBuildInfoFile": "${configDir}/tsconfig.tsbuildinfo",
     "module": "preserve",
     "outDir": "${configDir}/dist",
-    // "baseUrl": "${configDir}",
     "rootDir": "${configDir}/src",
     "paths": {
       "~/*": ["${configDir}/src/*"],