v4.2.4リリース:ViteエイリアスとCSSインポート解決のバグ修正
Tailwind CSS v4.2.4では、@tailwindcss/viteにおいてViteエイリアスを使用した場合に@importおよび@pluginのパス解決が失敗する不具合が修正されました。
背景
Viteはモジュール解決にエイリアス機能を提供しており、たとえば~/stylesのような短縮パスを実際のファイルパスに紐付けることができます。@tailwindcss/viteプラグインを通じてCSSを処理する際、@importや@pluginディレクティブでこれらのエイリアスを含むパスを指定すると、Tailwindのモジュール解決がViteのエイリアス変換を経由せずに実行されてしまい、パスが解決できずにビルドエラーとなっていました。
この問題は#19947で修正されています。
技術的な変更
v4.2.4の実質的な変更はCHANGELOG上の1行に集約されており、コードの修正は@tailwindcss/viteパッケージ側(#19947)で行われています。今回のPRはそのリリース作業として、tailwindcss・@tailwindcss/vite・@tailwindcss/cli・@tailwindcss/postcss・@tailwindcss/node・@tailwindcss/browser・@tailwindcss/upgrade・@tailwindcss/webpack・@tailwindcss/standalone、およびRustバインディングの@tailwindcss/oxide(15プラットフォーム向けネイティブバイナリを含む)の全パッケージバージョンを4.2.3から4.2.4へ一括更新しています。
CHANGELOGのリンクセクションでは、[unreleased]の比較ベースがv4.2.3...HEADからv4.2.4...HEADに更新され、[4.2.4]エントリとしてv4.2.3...v4.2.4の差分リンクが追記されました。
まとめ
v4.2.4は、Viteエイリアスを利用する環境での@import・@plugin解決の不具合に対応したパッチリリースです。@tailwindcss/viteを使いViteのエイリアス機能と組み合わせているプロジェクトでは、このバージョンへのアップデートにより問題が解消されます。