@williamthorsen/tsconfig 0.0.0 → 0.1.0

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,69 @@
-Placeholder for `@williamthorsen/tsconfig` — awaiting first release.
+# @williamthorsen/tsconfig
+
+Shared TypeScript base config for Node-only projects. Composes [`@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.0 (2026-07-23)
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Publish a shared TypeScript config on a Node 24 floor (#108)
+
+  Introduces `@williamthorsen/tsconfig`, a published baseline that Node-only TypeScript projects can extend. It pairs the strictest available TypeScript settings with additional Node and build options. A consumer is left to declare its own ambient types, path aliases, JSX, and file globs.
+
+  `@williamthorsen/eslint-config-typescript` now requires Node 24 or later.
+<!-- /section:release-notes -->
+
+## Installation
+
+```shell
+pnpm add -D @williamthorsen/tsconfig
+```
+
+`@tsconfig/strictest` comes along as a dependency; it does not need to be installed separately.
+
+## Quick start
+
+```jsonc
+{
+  "extends": "@williamthorsen/tsconfig/tsconfig.base.json",
+  "compilerOptions": {
+    "types": ["node"],
+  },
+  "include": ["src/"],
+}
+```
+
+## What the base sets
+
+Everything from `@tsconfig/strictest`, plus the Node and build options strictest 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.0",
+  "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"
+  ],
+  "dependencies": {
+    "@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,23 @@
+// 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 setting deviates from a TypeScript default; a comment says why it can't be dropped.
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@tsconfig/strictest",
+  "compilerOptions": {
+    // 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",
+  },
+}