Name: next-upgrade
Author: vercel-labs

升級 Next.js

將當前專案升級至最新的 Next.js 版本，遵循官方遷移指南。

偵測當前版本：讀取 package.json 以識別當前 Next.js 版本及相關依賴（React、React DOM 等）
取得最新升級指南：使用 WebFetch 取得官方升級文件：
- Codemods：https://nextjs.org/docs/app/guides/upgrading/codemods
- 版本特定指南（依需求調整版本）：
決定升級路徑：根據當前版本，判斷哪些遷移步驟適用。若為主要版本跳躍，請逐步升級（例如 13 → 14 → 15）。
先執行 codemods：Next.js 提供 codemods 來自動處理破壞性變更：
```
npx @next/codemod@latest <transform> <path>
```
常見轉換：
- next-async-request-api - 更新非同步 Request API（v15）
- next-request-geo-ip - 遷移 geo/ip 屬性（v15）
- next-dynamic-access-named-export - 轉換動態導入（v15）

更新依賴：同時升級 Next.js 與同儕依賴：

npm install next@latest react@latest react-dom@latest

檢視破壞性變更：查看升級指南中需要手動調整的部分：
- API 變更（例如 v15 的非同步參數）
- next.config.js 中的設定變更
- 已棄用功能的移除

更新 TypeScript 型別（如適用）：

npm install @types/react@latest @types/react-dom@latest

next-upgrade