feat(typescript): add multiple tsconfigs (#60)

Co-authored-by: Brody McKee <mrmckeb@users.noreply.github.com>

Author: Ethan-Arrowood

README.md

@@ -202,10 +202,20 @@ module.exports = {
 
 ## TypeScript
 
+This style guide provides multiple TypeScript configs. These configs correlate to the LTS Node.js versions, providing the appropriate `lib`, `module`, `target`, and `moduleResolution` settings for each version. The following configs are available:
+
+| Node.js Version | TypeScript Config                       |
+| --------------- | --------------------------------------- |
+| v16             | `@vercel/style-guide/typescript/node16` |
+| v18             | `@vercel/style-guide/typescript/node18` |
+| v20             | `@vercel/style-guide/typescript/node20` |
+
 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`](./typescript/tsconfig.base.json) which only specifies a set of general rules. You should inherit from this file when setting custom `lib`, `module`, `target`, and `moduleResolution` settings.

package.json

@@ -11,11 +11,19 @@
     "url": "https://github.com/vercel/style-guide.git"
   },
   "license": "MPL-2.0",
+  "exports": {
+    "./eslint/*": "./eslint/*.js",
+    "./prettier": "./prettier/index.js",
+    "./typescript": "./typescript/tsconfig.base.json",
+    "./typescript/node16": "./typescript/tsconfig.node16.json",
+    "./typescript/node18": "./typescript/tsconfig.node18.json",
+    "./typescript/node20": "./typescript/tsconfig.node20.json"
+  },
   "main": "index.js",
   "files": [
     "eslint",
     "prettier",
-    "typescript.json"
+    "typescript"
   ],
   "scripts": {
     "eslint-check": "eslint --max-warnings=0 .",

typescript.json typescript/tsconfig.base.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Vercel Base",
+  "docs": "https://github.com/vercel/style-guide",
   "compilerOptions": {
     "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,

typescript/tsconfig.node16.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "display": "Vercel Node 16",
+  "docs": "https://github.com/vercel/style-guide",
+  "compilerOptions": {
+    "lib": ["es2021"],
+    "module": "node16",
+    "target": "es2021",
+    "moduleResolution": "node16"
+  }
+}

typescript/tsconfig.node18.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "display": "Vercel Node 18",
+  "docs": "https://github.com/vercel/style-guide",
+  "compilerOptions": {
+    "lib": ["es2023"],
+    "module": "node16",
+    "target": "es2023",
+    "moduleResolution": "node16"
+  }
+}

typescript/tsconfig.node20.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "display": "Vercel Node 20",
+  "docs": "https://github.com/vercel/style-guide",
+  "compilerOptions": {
+    "lib": ["es2023"],
+    "module": "node16",
+    "target": "es2023",
+    "moduleResolution": "node16"
+  }
+}