feat(typescript): add tsconfigs for node versions

README.md

@@ -202,10 +202,23 @@ module.exports = {
 
 ## TypeScript
 
+This guide provides multiple TypeScript configuration options. These configs correlate to the major Node.js versions and configure the appropriate `lib`, `module`, `target`, and `moduleResolution` settings. The table below specifies the config name with the Node.js version.
+
+| Node.js Version | TypeScript Config       |
+| --------------- | ----------------------- |
+| v16             | `typescript/node16`     |
+| v18             | `typescript/node18`     |
+| v20             | `typescript/node20`     |
+| v20 (ESM)       | `typescript/node20-esm` |
+
+> When using `node20-esm`, don't forget to set `{ "type": "module" }` in your `package.json`
+
 To use the shared TypeScript config, set the following in `tsconfig.json`.
 
 ```json
 {
-  "extends": "@vercel/style-guide/typescript"
+  "extends": "@vercel/style-guide/typescript/node16"
 }
 ```
+
+The base TypeScript config is also available as `@vercel/style-guide/typescript` which only specifies a set of general rules such as `esModuleInterop`, `strict`, and `noUncheckedIndexedAccess`.

package.json

@@ -12,9 +12,11 @@
   },
   "license": "MPL-2.0",
   "exports": {
-    "typescript/base": "./typescript/tsconfig.base.json",
-    "typescript/node": "./typescript/tsconfig.node.json",
-    "typescript/web": "./typescript/tsconfig.web.json"
+    "./typescript": "./typescript/tsconfig.base.json",
+    "./typescript/node16": "./typescript/tsconfig.node16.json",
+    "./typescript/node18": "./typescript/tsconfig.node18.json",
+    "./typescript/node20": "./typescript/tsconfig.node20.json",
+    "./typescript/node20-esm": "./typescript/tsconfig.node20-esm.json"
   },
   "main": "index.js",
   "files": [

typescript/tsconfig.web.json → typescript/tsconfig.node16.json

@@ -2,7 +2,9 @@
   "$schema": "https://json.schemastore.org/tsconfig",
   "extends": "./tsconfig.base.json",
   "compilerOptions": {
-    "module": "commonjs",
-    "target": "ES2015"
+    "lib": ["ES2021"],
+    "module": "node16",
+    "target": "ES2021",
+    "moduleResolution": "node16"
   }
 }

typescript/tsconfig.node18.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["ES2023"],
+    "module": "node16",
+    "target": "ES2022",
+    "moduleResolution": "node16"
+  }
+}

typescript/tsconfig.node20-esm.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["ES2023"],
+    "module": "NodeNext",
+    "target": "ES2022",
+    "moduleResolution": "NodeNext"
+  }
+}

typescript/tsconfig.node20.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["ES2023"],
+    "module": "node16",
+    "target": "ES2022",
+    "moduleResolution": "node16"
+  }
+}