feat: typescript project references

.github/workflows/quality.yml

@@ -77,4 +77,4 @@ jobs:
         run: pnpm install --frozen-lockfile
 
       - name: Run TypeScript type check
-        run: pnpm run type-check
+        run: pnpm run type-check:full

.gitignore

@@ -12,3 +12,5 @@ server/dist
 public/dist
 .turbo
 test-results
+*.tsbuildinfo
+examples/*/build

CONTRIBUTING.md

@@ -65,6 +65,10 @@ To test the package that you're working on, run `pnpm test` in the package folde
 You do not need to rebuild your package to test it (only dependencies need to be built).
 Some packages like `ai` also have more details tests and watch mode, see their `package.json` for more information.
 
+#### Adding package dependencies
+
+Please run `pnpm update-references` in workspace root to update the `references` section in the `tsconfig.json` file.
+
 ### Submitting Pull Requests
 
 We greatly appreciate your pull requests. Here are the steps to submit them:

examples/ai-core/package.json

@@ -42,11 +42,12 @@
   "scripts": {
     "test:e2e:all": "vitest run src/e2e/*.test.ts",
     "test:file": "vitest run",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --build"
   },
   "devDependencies": {
     "@types/node": "20.17.24",
     "tsx": "4.19.2",
-    "typescript": "5.8.3"
+    "typescript": "5.8.3",
+    "@vercel/ai-tsconfig": "workspace:*"
   }
 }

examples/ai-core/tsconfig.json

@@ -12,7 +12,81 @@
     "moduleResolution": "Bundler",
     "rootDir": "./src",
     "outDir": "./build",
-    "skipLibCheck": true
+    "skipLibCheck": true,
+    "composite": true,
   },
-  "include": ["src/**/*.ts"]
+  "include": [
+    "src/**/*.ts"
+  ],
+  "references": [
+    {
+      "path": "../../packages/ai"
+    },
+    {
+      "path": "../../packages/amazon-bedrock"
+    },
+    {
+      "path": "../../packages/anthropic"
+    },
+    {
+      "path": "../../packages/azure"
+    },
+    {
+      "path": "../../packages/cerebras"
+    },
+    {
+      "path": "../../packages/cohere"
+    },
+    {
+      "path": "../../packages/deepinfra"
+    },
+    {
+      "path": "../../packages/deepseek"
+    },
+    {
+      "path": "../../packages/fal"
+    },
+    {
+      "path": "../../packages/fireworks"
+    },
+    {
+      "path": "../../packages/google"
+    },
+    {
+      "path": "../../packages/google-vertex"
+    },
+    {
+      "path": "../../packages/groq"
+    },
+    {
+      "path": "../../packages/luma"
+    },
+    {
+      "path": "../../packages/mistral"
+    },
+    {
+      "path": "../../packages/openai"
+    },
+    {
+      "path": "../../packages/openai-compatible"
+    },
+    {
+      "path": "../../packages/perplexity"
+    },
+    {
+      "path": "../../packages/provider"
+    },
+    {
+      "path": "../../packages/replicate"
+    },
+    {
+      "path": "../../packages/togetherai"
+    },
+    {
+      "path": "../../packages/valibot"
+    },
+    {
+      "path": "../../packages/xai"
+    }
+  ]
 }

examples/express/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "scripts": {
     "dev": "tsx src/server.ts",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --build"
   },
   "dependencies": {
     "@ai-sdk/openai": "2.0.0-canary.4",
@@ -16,6 +16,7 @@
     "@types/express": "5.0.0",
     "@types/node": "20.17.24",
     "tsx": "4.19.2",
-    "typescript": "5.8.3"
+    "typescript": "5.8.3",
+    "@vercel/ai-tsconfig": "workspace:*"
   }
 }

examples/express/tsconfig.json

@@ -12,7 +12,18 @@
     "moduleResolution": "Bundler",
     "rootDir": "./src",
     "outDir": "./build",
-    "skipLibCheck": true
+    "skipLibCheck": true,
+    "composite": true
   },
-  "include": ["src/**/*.ts"]
+  "include": [
+    "src/**/*.ts"
+  ],
+  "references": [
+    {
+      "path": "../../packages/ai"
+    },
+    {
+      "path": "../../packages/openai"
+    }
+  ]
 }

examples/fastify/package.json

@@ -10,11 +10,12 @@
   },
   "scripts": {
     "dev": "tsx src/server.ts",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --build"
   },
   "devDependencies": {
     "@types/node": "20.17.24",
     "tsx": "4.19.2",
-    "typescript": "5.8.3"
+    "typescript": "5.8.3",
+    "@vercel/ai-tsconfig": "workspace:*"
   }
 }

examples/fastify/tsconfig.json

@@ -12,7 +12,18 @@
     "moduleResolution": "Bundler",
     "rootDir": "./src",
     "outDir": "./build",
-    "skipLibCheck": true
+    "skipLibCheck": true,
+    "composite": true
   },
-  "include": ["src/**/*.ts"]
+  "include": [
+    "src/**/*.ts"
+  ],
+  "references": [
+    {
+      "path": "../../packages/ai"
+    },
+    {
+      "path": "../../packages/openai"
+    }
+  ]
 }

examples/hono/package.json

@@ -12,11 +12,12 @@
   "scripts": {
     "dev": "tsx watch src/server.ts",
     "curl": "curl -i -X POST http://localhost:8080",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --build"
   },
   "devDependencies": {
     "@types/node": "20.17.24",
     "tsx": "4.19.2",
-    "typescript": "5.8.3"
+    "typescript": "5.8.3",
+    "@vercel/ai-tsconfig": "workspace:*"
   }
 }

examples/hono/tsconfig.json

@@ -12,7 +12,18 @@
     "moduleResolution": "Bundler",
     "rootDir": "./src",
     "outDir": "./build",
-    "skipLibCheck": true
+    "skipLibCheck": true,
+    "composite": true
   },
-  "include": ["src/**/*.ts"]
+  "include": [
+    "src/**/*.ts"
+  ],
+  "references": [
+    {
+      "path": "../../packages/ai"
+    },
+    {
+      "path": "../../packages/openai"
+    }
+  ]
 }

examples/mcp/package.json

@@ -9,7 +9,7 @@
     "stdio:client": "tsx src/stdio/client.ts",
     "custom-transport:build": "tsc src/custom-transport/server.ts --outDir src/custom-transport/dist --target es2023 --module nodenext",
     "custom-transport:client": "tsx src/custom-transport/client.ts",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --build"
   },
   "dependencies": {
     "@ai-sdk/openai": "2.0.0-canary.4",
@@ -23,6 +23,7 @@
     "@types/express": "5.0.0",
     "@types/node": "20.17.24",
     "tsx": "4.19.2",
-    "typescript": "5.8.3"
+    "typescript": "5.8.3",
+    "@vercel/ai-tsconfig": "workspace:*"
   }
 }

examples/mcp/tsconfig.json

@@ -12,7 +12,17 @@
     "moduleResolution": "Bundler",
     "rootDir": "./src",
     "outDir": "./build",
-    "skipLibCheck": true
+    "composite": true
   },
-  "include": ["src/**/*.ts"]
+  "include": [
+    "src/**/*.ts"
+  ],
+  "references": [
+    {
+      "path": "../../packages/ai"
+    },
+    {
+      "path": "../../packages/openai"
+    }
+  ]
 }

examples/nest/package.json

@@ -44,7 +44,8 @@
     "ts-loader": "^9.4.3",
     "ts-node": "^10.9.1",
     "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.1.3"
+    "typescript": "^5.1.3",
+    "@vercel/ai-tsconfig": "workspace:*"
   },
   "jest": {
     "moduleFileExtensions": [

examples/nest/tsconfig.json

@@ -16,6 +16,15 @@
     "noImplicitAny": false,
     "strictBindCallApply": false,
     "forceConsistentCasingInFileNames": false,
-    "noFallthroughCasesInSwitch": false
-  }
+    "noFallthroughCasesInSwitch": false,
+    "composite": true
+  },
+  "references": [
+    {
+      "path": "../../packages/ai"
+    },
+    {
+      "path": "../../packages/openai"
+    }
+  ]
 }

examples/next-fastapi/package.json

@@ -28,6 +28,7 @@
     "eslint-config-next": "14.2.3",
     "postcss": "^8.4.49",
     "tailwindcss": "^3.4.15",
-    "typescript": "5.8.3"
+    "typescript": "5.8.3",
+    "@vercel/ai-tsconfig": "workspace:*"
   }
 }

examples/next-fastapi/tsconfig.json

@@ -1,12 +1,15 @@
 {
   "compilerOptions": {
     "target": "ESNext",
-    "lib": ["dom", "dom.iterable", "esnext"],
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
     "allowJs": true,
     "skipLibCheck": true,
     "strict": true,
     "forceConsistentCasingInFileNames": true,
-    "noEmit": true,
     "esModuleInterop": true,
     "module": "esnext",
     "moduleResolution": "Bundler",
@@ -20,9 +23,31 @@
       }
     ],
     "paths": {
-      "@/*": ["./*"]
-    }
+      "@/*": [
+        "./*"
+      ]
+    },
+    "composite": true,
+    "noEmit": true
   },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ],
+  "references": [
+    {
+      "path": "../../packages/ai"
+    },
+    {
+      "path": "../../packages/react"
+    },
+    {
+      "path": "../../packages/ai"
+    }
+  ]
 }

examples/next-google-vertex/package.json

@@ -23,6 +23,7 @@
     "eslint-config-vercel-ai": "workspace:*",
     "postcss": "^8.4.49",
     "tailwindcss": "^3.4.15",
-    "typescript": "5.8.3"
+    "typescript": "5.8.3",
+    "@vercel/ai-tsconfig": "workspace:*"
   }
 }