@williamthorsen/tsconfig 0.0.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright (c) 2023-2026 William Thorsen
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+The software is provided "as is" and the author disclaims all warranties with regard to this software including all implied warranties of merchantability and fitness. In no event shall the author be liable for any special, direct, indirect, or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.

package/README.md

@@ -1 +1,65 @@
-Placeholder for `@williamthorsen/tsconfig` — awaiting first release.
+# @williamthorsen/tsconfig
+
+Shared TypeScript base config for Node-only projects. Inlines the settings of [`@tsconfig/strictest`](https://www.npmjs.com/package/@tsconfig/strictest) and adds the Node and build options it leaves out, so a consuming repo declares only what is genuinely its own.
+
+<!-- section:release-notes -->
+## Release notes — v0.1.1 (2026-08-01)
+
+### 🐛 Bug fixes
+
+- Inline @tsconfig/strictest instead of extending it (#129)
+
+  Fixes an issue where, under pnpm, tools that resolve tsconfig files without following symlinks failed to find `@tsconfig/strictest`, breaking lint runs and builds in projects that declare only `@williamthorsen/tsconfig`. Consuming projects no longer need to add `@tsconfig/strictest` to their own `package.json` as a workaround.
+<!-- /section:release-notes -->
+
+## Installation
+
+```shell
+pnpm add -D @williamthorsen/tsconfig
+```
+
+## Quick start
+
+```jsonc
+{
+  "extends": "@williamthorsen/tsconfig/tsconfig.base.json",
+  "compilerOptions": {
+    "types": ["node"],
+  },
+  "include": ["src/"],
+}
+```
+
+## What the base sets
+
+Everything `@tsconfig/strictest` sets, plus the Node and build options it omits:
+
+| Option                       | Value        |
+| ---------------------------- | ------------ |
+| `allowImportingTsExtensions` | `true`       |
+| `lib`                        | `["ES2025"]` |
+| `module`                     | `"NodeNext"` |
+| `moduleDetection`            | `"force"`    |
+| `noEmit`                     | `true`       |
+| `removeComments`             | `true`       |
+| `target`                     | `"ES2025"`   |
+
+`target` and `lib` are pinned to a Node 24 floor.
+
+## What the consumer owns
+
+The base deliberately declares none of these:
+
+- **`types`** — the ambient type packages in scope. Most Node projects want `["node"]`; declaring it narrows the default, which would otherwise pull in every `@types/*` package installed.
+- **`paths`** — TypeScript resolves `baseUrl`-less `paths` relative to the file that _declares_ them, so a path alias set in this package would resolve inside `node_modules`. Aliases must be declared by the config that owns the source tree.
+- **`jsx`** — meaningless for the many consumers with no JSX at all.
+
+`include` and `exclude` are likewise the consumer's, since only it knows its own layout.
+
+## Emitting
+
+The base sets `noEmit: true`, on the assumption that a separate build step owns emit. A consumer that builds with this config directly must override `noEmit` — and, if it keeps `allowImportingTsExtensions`, pair that with `rewriteRelativeImportExtensions` so `./foo.ts` specifiers survive the rewrite.
+
+## License
+
+ISC

package/package.json

@@ -1,4 +1,44 @@
 {
   "name": "@williamthorsen/tsconfig",
-  "version": "0.0.0"
-}
+  "version": "0.1.1",
+  "description": "Shared TypeScript base config for Node-only projects",
+  "keywords": [
+    "tsconfig",
+    "typescript"
+  ],
+  "homepage": "https://github.com/williamthorsen/eslint-config/tree/main/packages/tsconfig#readme",
+  "bugs": {
+    "url": "https://github.com/williamthorsen/eslint-config/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/williamthorsen/eslint-config.git",
+    "directory": "packages/tsconfig"
+  },
+  "license": "ISC",
+  "author": "William Thorsen <william@thorsen.dev> (https://github.com/williamthorsen)",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    "./tsconfig.base.json": "./tsconfig.base.json"
+  },
+  "files": [
+    "tsconfig.base.json"
+  ],
+  "devDependencies": {
+    "@tsconfig/strictest": "2.0.8"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": ":",
+    "check": "nmr lint:strict",
+    "test": ":",
+    "test:coverage": ":"
+  }
+}

package/tsconfig.base.json

@@ -0,0 +1,43 @@
+// Base TSConfig for Node-only TypeScript: `@tsconfig/strictest` plus the Node/build options it omits.
+// Consumers set `types`, `paths`, `jsx`, and `include`. Node 24 floor.
+//
+// Every Node/build setting deviates from a TypeScript default; a comment says why it can't be dropped.
+// The inlined strictest settings carry no such comments: their rationale belongs to upstream.
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    // Inlined from `@tsconfig/strictest`, in upstream's order. Not reached through `extends`, because
+    // resolvers that don't realpath pnpm symlinks can't follow the second hop. The root test
+    // `__tests__/tsconfig-base.app.test.ts` asserts this block still matches the installed devDependency.
+    "strict": true,
+    "allowUnusedLabels": false,
+    "allowUnreachableCode": false,
+    "exactOptionalPropertyTypes": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noUncheckedIndexedAccess": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+
+    "isolatedModules": true,
+
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+
+    // Permit `./foo.ts` specifiers; the build step rewrites them on emit.
+    "allowImportingTsExtensions": true,
+    // Without this, `lib` follows `target` into the `.full` variant, admitting DOM globals.
+    "lib": ["ES2025"],
+    // Default is `ES2022` with `Bundler` resolution — wrong for published Node packages.
+    "module": "NodeNext",
+    // Files with no import or export would otherwise be scripts sharing global scope.
+    "moduleDetection": "force",
+    // Typecheck-only base; build steps override emit settings.
+    "noEmit": true,
+    // Inert until a build step clears `noEmit`; keeps published output comment-free.
+    "removeComments": true,
+    "target": "ES2025",
+  },
+}