[eng/tools] Use TypeScript project references (#31213)

- Replaces "postinstall" step in each package, with one in tools folder
- Allows one call to `tsc --build` to compile all projects in the correct dependency order

.gitignore

@@ -128,6 +128,9 @@ eng/tools/**/dist
 !eng/tools/**/cmd/*.js
 !eng/tools/**/eslint.config.js
 
+# TypeScript cache
+*.tsbuildinfo
+
 # No package-lock.json files should be commited except the top-level.
 **/package-lock.json
 !/package-lock.json

eng/tools/package.json

@@ -7,5 +7,9 @@
     "@azure-tools/typespec-requirement": "file:typespec-requirement",
     "@azure-tools/typespec-validation": "file:typespec-validation"
   },
+  "scripts": {
+    "build": "tsc --build",
+    "postinstall": "npm run build"
+  },
   "private": true
 }

eng/tools/specs-model/package.json

@@ -7,8 +7,7 @@
     "get-specs-model": "cmd/get-specs-model.js"
   },
   "scripts": {
-    "build": "tsc",
-    "postinstall": "npm run build",
+    "build": "tsc --build",
     "test": "vitest",
     "test:ci": "vitest run --coverage --reporter=verbose",
     "lint": "eslint . -c eslint.config.js --report-unused-disable-directives --max-warnings 0",

eng/tools/suppressions/package.json

@@ -7,8 +7,7 @@
     "get-suppressions": "cmd/get-suppressions.js"
   },
   "scripts": {
-    "build": "tsc",
-    "postinstall": "npm run build",
+    "build": "tsc --build",
     "test": "vitest",
     "test:ci": "vitest run --coverage --reporter=verbose"
   },

eng/tools/tsconfig.json

@@ -5,6 +5,16 @@
     "module": "Node16",
 
     // override "importHelpers:true" in root tsconfig.json
-    "importHelpers": false
-  }
+    "importHelpers": false,
+
+    // required to use project references
+    "composite": true,
+  },
+  "references": [
+    { "path": "./specs-model" },
+    { "path": "./suppressions" },
+    { "path": "./tsp-client-tests" },
+    { "path": "./typespec-requirement" },
+    { "path": "./typespec-validation" }
+  ]
 }

eng/tools/tsp-client-tests/package.json

@@ -9,8 +9,7 @@
     "vitest": "^2.0.4"
   },
   "scripts": {
-    "build": "tsc",
-    "postinstall": "npm run build",
+    "build": "tsc --build",
     "test": "vitest",
     "test:ci": "vitest run --reporter=verbose"
   },

eng/tools/typespec-requirement/package.json

@@ -9,8 +9,7 @@
     "vitest": "^2.0.4"
   },
   "scripts": {
-    "build": "tsc",
-    "postinstall": "npm run build",
+    "build": "tsc --build",
     "test": "vitest",
     "test:ci": "vitest run --reporter=verbose"
   },

eng/tools/typespec-validation/package.json

@@ -19,8 +19,7 @@
     "vitest": "^2.0.4"
   },
   "scripts": {
-    "build": "tsc",
-    "postinstall": "cd ../suppressions && npm run build && cd ../typespec-validation && npm run build",
+    "build": "tsc --build",
     "test": "vitest",
     "test:ci": "vitest run --coverage --reporter=verbose"
   },

eng/tools/typespec-validation/tsconfig.json

@@ -2,5 +2,8 @@
   "extends": "../tsconfig.json",
   "compilerOptions": {
     "outDir": "./dist",
-  }
+  },
+  "references": [
+    { "path": "../suppressions" }
+  ]
 }