chore: typescript maintenance

- Combined the jsconfig files in to a single one.
- Disable declaration sourcemaps
- Correctly set module to NodeNext and resolve inconsistencies.
- Removes types from the repo and .gitignore them for the next commits
- Adds TSC run in CI
- Runs tsc in prepublishOnly, so we can still include .d.ts files in to the published NPM packages

Author: dirkdev98

.github/workflows/main-checks.yml

@@ -4,6 +4,35 @@ on:
     branches: [main]
 
 jobs:
+  types:
+    permissions:
+      contents: read
+    timeout-minutes: 15
+    strategy:
+      matrix:
+        node: [20]
+    runs-on: ubuntu-latest
+    env:
+      CI: true
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v3.7.0
+        with:
+          node-version: ${{ matrix.node }}
+          cache: "npm"
+
+      - name: Install dependencies
+        run: |
+          npm ci
+
+      - name: Generate and run types
+        run: |
+          npx compas generate --skip-tsc --skip-lint
+          npx compas run types
+
   test:
     permissions:
       contents: read

.github/workflows/pr-checks.yml

@@ -34,6 +34,35 @@ jobs:
           CI=false npx compas generate --skip-tsc
           npx compas lint
 
+  types:
+    permissions:
+      contents: read
+    timeout-minutes: 15
+    strategy:
+      matrix:
+        node: [20]
+    runs-on: ubuntu-latest
+    env:
+      CI: true
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v3.7.0
+        with:
+          node-version: ${{ matrix.node }}
+          cache: "npm"
+
+      - name: Install dependencies
+        run: |
+          npm ci
+
+      - name: Generate and run types
+        run: |
+          npx compas generate --skip-tsc --skip-lint
+          npx compas run types
+
   test:
     permissions:
       contents: read

.gitignore

@@ -44,6 +44,9 @@ coverage
 
 # Types
 **.d.ts.map
+**.d.ts
+!advanced-types.d.ts
+!common/types.d.ts
 
 # Examples
 # Ignore any generated output of examples

jsconfig.json

@@ -2,18 +2,20 @@
   "compilerOptions": {
     "target": "esnext",
     "lib": ["esnext"],
-    "noEmit": true,
-    "module": "esnext",
+    "module": "NodeNext",
     "checkJs": true,
     "maxNodeModuleJsDepth": 0,
     "baseUrl": "./",
-    "moduleResolution": "node",
     "strict": true,
-    "noImplicitAny": false
+    "noImplicitAny": false,
+    "declaration": true,
+    "noEmit": false,
+    "emitDeclarationOnly": true,
+    "extendedDiagnostics": true
   },
   "typeAcquisition": {
     "enable": true
   },
-  "include": ["**/*.js", "**/types/**/*.d.ts"],
-  "exclude": ["**/*.test.js", "**/*.bench.js"]
+  "include": ["packages/**/*"],
+  "exclude": ["packages/eslint-plugin/**/*", "**/*.test.js", "**/*.bench.js"]
 }

jsconfig.types.json

@@ -3,6 +3,8 @@
   "private": true,
   "type": "module",
   "scripts": {
+    "prepublishOnly": "compas run types",
+    "postpublish": "compas run types --script-args='clean'",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:serve": "vitepress serve docs"

package.json

@@ -1,17 +1,17 @@
 /**
- * @typedef {import("./src/generated/common/types").CliCommandDefinitionInput} CliCommandDefinitionInput
+ * @typedef {import("./src/generated/common/types.js").CliCommandDefinitionInput} CliCommandDefinitionInput
  */
 
 /**
- * @typedef {import("./src/generated/common/types").CliCompletion} CliCompletion
+ * @typedef {import("./src/generated/common/types.js").CliCompletion} CliCompletion
  */
 
 /**
- * @typedef {import("./src/cli/types").CliResult} CliResult
+ * @typedef {import("./src/cli/types.js").CliResult} CliResult
  */
 
 /**
- * @typedef {import("./src/cli/types").CliExecutorState} CliExecutorState
+ * @typedef {import("./src/cli/types.js").CliExecutorState} CliExecutorState
  */
 
 /**

packages/cli/index.d.ts

@@ -2,12 +2,15 @@
   "name": "@compas/cli",
   "version": "0.6.0",
   "description": "CLI containing utilities and simple script runner",
-  "main": "./index.js",
   "exports": {
-    ".": "./index.js",
+    ".": {
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      }
+    },
     "./package.json": "./package.json"
   },
-  "types": "./index.d.ts",
   "type": "module",
   "bin": {
     "compas": "src/compas/index.js"