refactor: update tsconfig to use TypeScript project references

.github/scripts/tsconfig.json

@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../../configs/tsconfig.base.json",
   "compilerOptions": {
     "composite": true,
     "allowJs": true

.github/workflows/ci.yml

@@ -140,8 +140,8 @@ jobs:
       - name: Lint publish code
         run: pnpm run publint
 
-      - name: Type-check test files
-        run: pnpm run typecheck:tests
+      - name: Type-check files
+        run: pnpm run typecheck
 
   test:
     name: 'Test (${{ matrix.TEST_SUITE.name }}): ${{ matrix.os }} (node@${{ matrix.NODE_VERSION }})'

benchmark/packages/adapter/tsconfig.json

@@ -1,5 +1,5 @@
 {
-  "extends": "../../../tsconfig.base.json",
+  "extends": "../../../configs/tsconfig.base.json",
   "include": ["src"],
   "compilerOptions": {
     "rootDir": "./src",

benchmark/packages/timer/tsconfig.json

@@ -1,5 +1,5 @@
 {
-  "extends": "../../../tsconfig.base.json",
+  "extends": "../../../configs/tsconfig.base.json",
   "include": ["src"],
   "compilerOptions": {
     "rootDir": "./src",

tsconfig.base.json → configs/tsconfig.base.json

@@ -1,9 +1,12 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
   "compilerOptions": {
+    "composite": true,
     "declaration": true,
     "emitDeclarationOnly": true,
     "strict": true,
+    "allowJs": true,
+    "forceConsistentCasingInFileNames": true,
     "moduleResolution": "nodenext",
     "target": "esnext",
     "module": "nodenext",
@@ -14,7 +17,8 @@
     "noUnusedLocals": true,
     "noUnusedParameters": true,
     "erasableSyntaxOnly": true,
-    "outDir": "${configDir}/node_modules/.cache/tsconfig/out",
+    // Emit declaration and cache files to a directory that would be ignored by tools like Git and ESLint.  
+    "outDir": "${configDir}/node_modules/.cache/ts_base/out",
     "types": ["node"]
   }
 }

configs/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "${configDir}/src",
+    "outDir": "${configDir}/dist",
+    // `._cache/` is ignored when publishing to NPM registry, so it's a safe place to put build artifacts that we don't want to publish.
+    // See https://docs.npmjs.com/cli/v10/configuring-npm/package-json#files
+    "tsBuildInfoFile": "${configDir}/dist/._cache/ts_build/build.tsbuildinfo"
+  },
+  "include": ["${configDir}/src"]
+}

packages/language-tools/tsconfig.json → configs/tsconfig.language-tools.json

@@ -1,15 +1,13 @@
 {
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.build.json",
   "compilerOptions": {
     "target": "ES2021",
     "lib": ["WebWorker", "ES2021"],
     "module": "commonjs",
     // TODO: when upgrading to TS 6, will need to be set to "bundler"
     "moduleResolution": "node",
-    "declaration": true,
-    "emitDeclarationOnly": true,
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
+    "verbatimModuleSyntax": false,
+    "erasableSyntaxOnly": false
   }
 }

configs/tsconfig.test.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "${configDir}",
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "allowImportingTsExtensions": true,
+    "outDir": "${configDir}/node_modules/.cache/ts_test/out"
+  },
+  "include": ["${configDir}/test/**/*"],
+  "exclude": ["${configDir}/test/fixtures/**/*"]
+}

knip.js

@@ -1,4 +1,6 @@
 // @ts-check
+const srcEntry = 'src/**/*.{js,ts,cts}';
+const dtsEntry = '*.d.ts';
 const testEntry = 'test/**/*.test.{js,ts}';
 
 /** @type {import('knip').KnipConfig} */
@@ -24,12 +26,14 @@ export default {
 			entry: ['.flue/agents/*.ts', '.flue/workflows/*/WORKFLOW.ts'],
 		},
 		'packages/*': {
-			entry: [testEntry],
+			entry: [srcEntry, dtsEntry, testEntry],
 		},
 		'packages/astro': {
 			entry: [
 				// Can't be detected automatically since it's only in package.json#files
 				'templates/**/*',
+				srcEntry,
+				dtsEntry,
 				testEntry,
 				'test/types/**/*',
 				'e2e/**/*.test.{js,ts}',
@@ -53,37 +57,30 @@ export default {
 				'rehype-toc',
 				'remark-code-titles',
 				'@types/http-cache-semantics',
-				// Dynamically imported by astro add cloudflare
-				'@astrojs/cloudflare',
 			],
 		},
 		'packages/db': {
-			entry: [testEntry, 'test/types/**/*'],
+			entry: [srcEntry, dtsEntry, testEntry, 'test/types/**/*'],
 		},
 		'packages/integrations/*': {
-			entry: [testEntry],
+			entry: [srcEntry, dtsEntry, testEntry],
 		},
 		'packages/integrations/cloudflare': {
-			entry: [testEntry],
+			entry: [srcEntry, dtsEntry, testEntry],
 			// False positive because of cloudflare:workers
 			ignoreDependencies: ['cloudflare'],
 		},
-		'packages/integrations/mdx': {
-			entry: [testEntry],
-			// Required but not imported directly
-			ignoreDependencies: ['@types/*'],
-		},
 		'packages/integrations/netlify': {
-			entry: [testEntry],
+			entry: [srcEntry, dtsEntry, testEntry],
 			ignore: ['test/hosted/**'],
 		},
 		'packages/integrations/solid': {
-			entry: [testEntry],
+			entry: [srcEntry, dtsEntry, testEntry],
 			// It's an optional peer dep (triggers a warning) but it's fine in this case
 			ignoreDependencies: ['solid-devtools'],
 		},
 		'packages/markdown/remark': {
-			entry: [testEntry],
+			entry: [srcEntry, dtsEntry, testEntry],
 			// package.json#imports are not resolved at the moment
 			ignore: ['src/import-plugin-browser.ts', 'src/shiki-engine-workerd.ts'],
 		},

package.json

@@ -38,7 +38,7 @@
     "test:e2e": "cd packages/astro && pnpm playwright install firefox && pnpm run test:e2e",
     "test:e2e:match": "cd packages/astro && pnpm playwright install firefox && pnpm run test:e2e:match",
     "test:e2e:hosts": "turbo run test:hosted",
-    "typecheck:tests": "pnpm -r run --sequential typecheck:tests",
+    "typecheck": "tsc -b",
     "benchmark": "astro-benchmark",
     "lint": "biome lint && knip && eslint . --report-unused-disable-directives-severity=warn --concurrency=auto",
     "lint:ci": "knip && pnpm run eslint:ci",

packages/astro-prism/package.json

@@ -14,7 +14,7 @@
   "homepage": "https://docs.astro.build/en/reference/api-reference/#prism-",
   "main": "dist/index.js",
   "scripts": {
-    "build": "astro-scripts build \"src/**/*.ts\" && tsc -p ./tsconfig.json",
+    "build": "astro-scripts build \"src/**/*.ts\" && tsc -b",
     "build:ci": "astro-scripts build \"src/**/*.ts\"",
     "dev": "astro-scripts dev \"src/**/*.ts\""
   },

packages/astro-prism/tsconfig.build.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../../configs/tsconfig.build.json"
+}

packages/astro-prism/tsconfig.json

@@ -1,8 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
-  "include": ["src"],
-  "compilerOptions": {
-    "rootDir": "./src",
-    "outDir": "./dist"
-  }
+  "extends": "../../configs/tsconfig.base.json",
+  "files": [],
+  "references": [{ "path": "./tsconfig.build.json" }]
 }

packages/astro-rss/package.json

@@ -21,11 +21,10 @@
     "dist"
   ],
   "scripts": {
-    "build": "astro-scripts build \"src/**/*.ts\" && tsc",
+    "build": "astro-scripts build \"src/**/*.ts\" && tsc -b",
     "build:ci": "astro-scripts build \"src/**/*.ts\"",
     "dev": "astro-scripts dev \"src/**/*.ts\"",
-    "test": "astro-scripts test \"test/**/*.test.ts\"",
-    "typecheck:tests": "tsc --build tsconfig.test.json"
+    "test": "astro-scripts test \"test/**/*.test.ts\""
   },
   "devDependencies": {
     "@types/xml2js": "^0.4.14",

packages/astro-rss/tsconfig.build.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../../configs/tsconfig.build.json"
+}

packages/astro-rss/tsconfig.json

@@ -1,8 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
-  "include": ["src"],
-  "compilerOptions": {
-    "rootDir": "./src",
-    "outDir": "./dist"
-  }
+  "extends": "../../configs/tsconfig.base.json",
+  "files": [],
+  "references": [{ "path": "./tsconfig.build.json" }, { "path": "./tsconfig.test.json" }]
 }

packages/astro-rss/tsconfig.test.json

@@ -1,12 +1,4 @@
 {
-  "extends": "../../tsconfig.base.json",
-  "include": ["test/**/*.ts"],
-  "exclude": ["test/fixtures/**"],
-  "compilerOptions": {
-    "allowJs": true,
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "rewriteRelativeImportExtensions": true
-  },
-  "references": [{ "path": "../astro/tsconfig.test.json" }]
+  "extends": "../../configs/tsconfig.test.json",
+  "references": [{ "path": "./tsconfig.build.json" }]
 }

packages/astro/components/tsconfig.json

@@ -1,9 +1,8 @@
 {
-  "extends": "../../../tsconfig.base.json",
+  "extends": "../../../configs/tsconfig.base.json",
   "compilerOptions": {
-    "allowJs": true,
     "emitDeclarationOnly": false,
-    "noEmit": true,
     "jsx": "preserve"
-  }
+  },
+  "references": [{ "path": "../tsconfig.build.json" }]
 }

packages/astro/package.json

@@ -112,7 +112,7 @@
   ],
   "scripts": {
     "prebuild": "astro-scripts prebuild --to-string \"src/runtime/server/astro-island.ts\" \"src/runtime/client/{idle,load,media,only,visible}.ts\"",
-    "build": "pnpm run prebuild && astro-scripts build \"src/**/*.{ts,js}\" --copy-wasm && tsc && astro-check -- -- --root ./components",
+    "build": "pnpm run prebuild && astro-scripts build \"src/**/*.{ts,js}\" --copy-wasm && tsc -b && astro-check -- -- --root ./components",
     "build:ci": "pnpm run prebuild && astro-scripts build \"src/**/*.{ts,js}\" --copy-wasm",
     "dev": "astro-scripts dev --copy-wasm --prebuild \"src/runtime/server/astro-island.ts\" --prebuild \"src/runtime/client/{idle,load,media,only,visible}.ts\" \"src/**/*.{ts,js}\"",
     "test": "pnpm run test:unit && pnpm run test:integration && pnpm run test:types",
@@ -123,7 +123,6 @@
     "test:e2e:chrome": "playwright test",
     "test:e2e:firefox": "playwright test --config playwright.firefox.config.js",
     "test:types": "tsc --build test/types/tsconfig.json",
-    "typecheck:tests": "tsc --build tsconfig.test.json",
     "test:unit": "astro-scripts test \"test/units/**/*.test.ts\" --strip-types --teardown ./test/units/teardown.ts",
     "test:integration": "pnpm run test:integration:js && pnpm run test:integration:ts",
     "test:integration:js": "astro-scripts test \"test/*.test.js\"",

packages/astro/src/cli/check/index.ts

@@ -3,7 +3,7 @@ import { ensureProcessNodeEnv } from '../../core/util.js';
 import { createLoggerFromFlags, type Flags, flagsToAstroInlineConfig } from '../flags.js';
 import { getPackage } from '../install-package.js';
 
-export async function check(flags: Flags) {
+export async function check(flags: Flags): Promise<boolean | void> {
 	ensureProcessNodeEnv('production');
 	const logger = createLoggerFromFlags(flags);
 	const getPackageOpts = {

packages/astro/test/cli.test.ts

@@ -29,7 +29,7 @@ describe('astro cli', () => {
 		});
 		const logs: LogEntry[] = [];
 
-		const checkServer = await fixture.check({
+		const checkServer: boolean | void = await fixture.check({
 			_: [],
 			flags: { watch: true },
 			logging: {

packages/astro/test/types/tsconfig.json

@@ -1,8 +1,6 @@
 {
-  "extends": "../../../../tsconfig.base.json",
+  "extends": "../../../../configs/tsconfig.base.json",
   "compilerOptions": {
-    "composite": true,
-    "allowJs": true,
     "emitDeclarationOnly": false
   }
 }

packages/astro/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../configs/tsconfig.build.json",
+  "compilerOptions": {
+    "jsx": "preserve"
+  },
+  "include": ["./src", "./dev-only.d.ts"],
+  "references": [
+    { "path": "../internal-helpers/tsconfig.json" },
+    { "path": "../telemetry/tsconfig.json" },
+    { "path": "../markdown/remark/tsconfig.json" }
+  ]
+}

packages/astro/tsconfig.json

@@ -1,15 +1,9 @@
 {
-  "extends": "../../tsconfig.base.json",
-  "include": ["src", "dev-only.d.ts"],
-  "exclude": ["dist"],
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "./src",
-    "allowJs": true,
-    "declarationDir": "./dist",
-    "outDir": "./dist",
-    "jsx": "preserve",
-    "tsBuildInfoFile": "${configDir}/dist/._cache/tsconfig/tsbuildinfo.json",
-    "erasableSyntaxOnly": true
-  }
+  "extends": "../../configs/tsconfig.base.json",
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.build.json" },
+    { "path": "./tsconfig.test.json" },
+    { "path": "./components/tsconfig.json" }
+  ]
 }

packages/astro/tsconfig.test.json

@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": "../../configs/tsconfig.test.json",
   "include": ["test/units/**/*.ts", "test/*.ts", "e2e/*.ts", "package.json"],
   "exclude": ["test/units/_temp-fixtures/**", "test/fixtures/**", "e2e/fixtures/**"],
   "files": [
@@ -9,19 +9,7 @@
     "./test/fixtures/before-hydration/deps.mjs"
   ],
   "compilerOptions": {
-    "types": ["vite/client", "node"],
-    "composite": true,
-    "allowJs": true,
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "rewriteRelativeImportExtensions": true
+    "types": ["vite/client", "node"]
   },
-  "references": [
-    {
-      "path": "./tsconfig.json"
-    },
-    {
-      "path": "../../scripts/tsconfig.json"
-    }
-  ]
+  "references": [{ "path": "./tsconfig.build.json" }, { "path": "../../scripts/tsconfig.json" }]
 }

packages/create-astro/package.json

@@ -19,11 +19,10 @@
     "create-astro": "./create-astro.mjs"
   },
   "scripts": {
-    "build": "astro-scripts build \"src/index.ts\" --bundle && tsc",
+    "build": "astro-scripts build \"src/index.ts\" --bundle && tsc -b",
     "build:ci": "astro-scripts build \"src/index.ts\" --bundle",
     "dev": "astro-scripts dev \"src/**/*.ts\"",
-    "test": "astro-scripts test \"test/**/*.test.ts\"",
-    "typecheck:tests": "tsc --build tsconfig.test.json"
+    "test": "astro-scripts test \"test/**/*.test.ts\""
   },
   "files": [
     "dist",

packages/create-astro/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "../../configs/tsconfig.build.json",
+  "references": [{ "path": "../internal-helpers/tsconfig.json" }]
+}