docs: update zod typescript issue troubleshooting with new version (#8600)

[New version of zod solves zod
issues.](https://x.com/colinhacks/status/1966261915115782654). Updated
troubleshooting.

Author: nicoalbanese

content/docs/08-migration-guides/26-migration-guide-5-0.mdx

@@ -26,19 +26,20 @@ You need to update the following packages to the following versions in your `pac
 
 Additionally, you need to update the following peer dependencies:
 
-- `zod` package: `3.25.0` or later
+- `zod` package: `4.1.8` or later (recommended to avoid TypeScript performance issues)
 
 An example upgrade command would be:
 
 ```
-npm install ai @ai-sdk/react @ai-sdk/openai zod@3.25.0
+npm install ai @ai-sdk/react @ai-sdk/openai zod@^4.1.8
 ```
 
 <Note>
-  If you encounter TypeScript performance issues after upgrading, update your
-  `tsconfig.json` to use `moduleResolution: "nodenext"`. See the [TypeScript
-  performance troubleshooting
-  guide](/docs/troubleshooting/typescript-performance-zod) for more details.
+  If you encounter TypeScript performance issues after upgrading, ensure you're
+  using Zod 4.1.8 or later. If the issue persists, update your `tsconfig.json`
+  to use `moduleResolution: "nodenext"`. See the [TypeScript performance
+  troubleshooting guide](/docs/troubleshooting/typescript-performance-zod) for
+  more details.
 </Note>
 
 ## Codemods
@@ -3101,7 +3102,11 @@ import {
 
 ### TypeScript Performance Issues with Zod
 
-If you experience TypeScript server crashes, slow type checking, or errors like "Type instantiation is excessively deep and possibly infinite" when using Zod with AI SDK 5.0, update your `tsconfig.json` to use `moduleResolution: "nodenext"`:
+If you experience TypeScript server crashes, slow type checking, or errors like "Type instantiation is excessively deep and possibly infinite" when using Zod with AI SDK 5.0:
+
+1. **First, ensure you're using Zod 4.1.8 or later** - this version includes a fix for module resolution issues that cause TypeScript performance problems.
+
+2. If the issue persists, update your `tsconfig.json` to use `moduleResolution: "nodenext"`:
 
 ```json
 {

content/docs/09-troubleshooting/12-typescript-performance-zod.mdx

@@ -20,9 +20,19 @@ The AI SDK 5 has specific compatibility requirements with Zod versions. When imp
 
 ## Solution
 
-### Update TypeScript Configuration
+### Upgrade Zod to 4.1.8 or Later
 
-The recommended solution is to update your `tsconfig.json` to use `moduleResolution: "nodenext"`:
+The primary solution is to upgrade to Zod version 4.1.8 or later, which includes a fix for this module resolution issue:
+
+```bash
+pnpm add zod@^4.1.8
+```
+
+This version resolves the underlying problem where different module resolution settings were causing TypeScript to load the same Zod declarations twice, leading to expensive structural comparisons.
+
+### Alternative: Update TypeScript Configuration
+
+If upgrading Zod isn't possible, you can update your `tsconfig.json` to use `moduleResolution: "nodenext"`:
 
 ```json
 {
@@ -33,20 +43,4 @@ The recommended solution is to update your `tsconfig.json` to use `moduleResolut
 }
 ```
 
-This resolves the TypeScript performance issues while allowing you to continue using the standard Zod import:
-
-```typescript
-import { z } from 'zod'; // Works correctly with nodenext module resolution
-```
-
-### Alternative: Use the Zod Version-Specific Import Path
-
-If the above solution doesn't resolve the issue, you can try importing Zod using a version-specific import path:
-
-```typescript
-// ❌ Potentially problematic: Standard import may cause TypeScript issues
-import { z } from 'zod';
-
-// ✅ Alternative: version-specific import that may help with compatibility
-import { z } from 'zod/v4';
-```
+This resolves the TypeScript performance issues while allowing you to continue using the standard Zod import.