@foxglove/tsconfig 3.0.0 → 3.2.0

package/README.md

@@ -18,7 +18,13 @@ yarn add -D @foxglove/tsconfig
 
 Choose the config that matches your environment:
 
-### Node.js applications and libraries
+### Node.js applications and published libraries
+
+Uses `module: "NodeNext"`, which enforces Node.js ESM rules.
+
+Use `node.json` for published libraries, even if your library will be used in bundled apps. Bundlers consume Node-style packages natively, just remember to avoid Node-specific APIs like `fs` or `process`.
+
+Relative imports must include explicit file extensions (e.g., `import { foo } from "./bar.ts"`).
 
 ```json
 {
@@ -31,30 +37,34 @@ Choose the config that matches your environment:
 }
 ```
 
-> **Note:** Uses `target: "ESNext"`. For older Node.js versions, set a lower target (e.g., `"ES2022"` for Node 18).
+> [!TIP]
+> `base.json` uses `target: "ESNext"`. For published libraries, you may wish to set a lower target (e.g., `"ES2022"` for Node 18).
 
-> **Cross-platform libraries:** Use `node.json` even if your library will be used in frontend apps. Bundlers consume Node-style packages natively—just avoid Node-specific APIs like `fs` or `process`.
+### Bundled applications (Webpack, Vite, esbuild, etc)
 
-### Frontend applications (Vite, Webpack, esbuild, etc)
+Uses `module: "Preserve"`, which enables optimizations for code consumed directly by a bundler.
 
-For bundled apps that run in the browser (not published as packages):
+Supports extensionless relative imports (e.g., `import { foo } from "./bar"`).
 
 ```json
 {
   "extends": "@foxglove/tsconfig/bundler.json",
-  "include": ["./src/**/*"]
+  "include": ["./src/**/*"],
+  "compilerOptions": {
+    "noEmit": true,
+    "lib": ["ESNext", "DOM"]
+  }
 }
 ```
 
 ### Base config
 
-Provides strict type-checking and modern defaults, but no `module`, `moduleResolution`, or `target` settings. Use this when `node.json` and `bundler.json` don't fit your environment:
+Provides strict type-checking and modern defaults, but no `module` or `moduleResolution` settings. Use this when `node.json` and `bundler.json` don't fit your environment:
 
 ```json
 {
   "extends": "@foxglove/tsconfig/base.json",
   "compilerOptions": {
-    "target": "...",
     "module": "...",
     "moduleResolution": "..."
   }

package/base.json

@@ -5,6 +5,9 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
   "compilerOptions": {
+    // Language
+    "target": "ESNext",
+
     // Type checking
     "strict": true,
     "noFallthroughCasesInSwitch": true,
@@ -28,7 +31,6 @@
     // Emit
     "declaration": true,
     "declarationMap": true,
-    "isolatedDeclarations": true,
     "newLine": "lf",
     "sourceMap": true,
 

package/bundler.json

@@ -6,8 +6,6 @@
   "compilerOptions": {
     // Bundler handles module resolution
     "module": "Preserve",
-    "moduleResolution": "Bundler",
-    "target": "ESNext",
-    "lib": ["ESNext", "DOM", "DOM.AsyncIterable", "DOM.Iterable"]
+    "moduleResolution": "Bundler"
   }
 }

package/node.json

@@ -6,7 +6,6 @@
   "compilerOptions": {
     // Node.js ESM
     "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "target": "ESNext"
+    "moduleResolution": "NodeNext"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxglove/tsconfig",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Base TypeScript configuration for Foxglove projects",
   "license": "MIT",
   "repository": {