Migration
Jumpu UI では破壊的変更のうち機械的に置換可能なものを @jumpu-ui/codemod として提供しています。破壊的変更はメジャーバージョンだけでなく、コンポーネントクラスの構造変更を伴う minor / patch でも発生する可能性があります。
実験的なツールです
@jumpu-ui/codemod は実験的なツールで、ソースファイルを直接書き換えます。バージョン管理下のクリーンな状態で実行し、差分を必ず確認してください。詳細は codemod CLI リファレンス を参照してください。
インストール済みのバージョンから最新まで、すべての適用対象を一気に処理するには次のコマンドを実行してください。
sh
npx @jumpu-ui/codemod upgrade内部で node_modules/@jumpu-ui/tailwindcss/package.json を読み、起点バージョンを自動検出します。検出できない場合（CDN 経由の利用など）はプロジェクト内の esm.sh の URL からバージョンを抽出するフォールバックが働きます。それでも検出できない場合は --from <version> フラグで明示してください。
いつ何を使うか
| したいこと | コマンド |
|---|---|
| 起点バージョンを検出して最新まで一気に移行 | npx @jumpu-ui/codemod upgrade |
| 起点を明示して upgrade | npx @jumpu-ui/codemod upgrade --from 2.0.1 |
| 特定の transform だけ実行 | npx @jumpu-ui/codemod upgrade --only <transform-id> |
| 利用可能な transform を一覧 | npx @jumpu-ui/codemod list |
CLI の詳細
コマンド一覧・オプション・破壊的変更の分類などは codemod CLI リファレンス を参照してください。バージョン別の破壊的変更の詳細は各マイグレーションガイドにあります。
- v2 → v3 マイグレーション
- v1 → v2 は v2 系の docs サイト を参照してください