Zod 4.3.6'da Default Import Locale Dosyalarını Next.js Bundle'a Ekliyor

Next.js 16 projelerinde Zod kütüphanesini default import yöntemiyle kullanırken istemediğiniz locale dosyaları bundle'a sızıyor. Zod 4.3.6 ve 4.4.3 sürümlerinde bu sorun ortaya çıkıyor.

Bir geliştirici test etti: sadece bir email alanı ve Zod doğrulaması olan basit bir Next.js uygulamasında, default import (`import z from 'zod'`) kullanıldığında Japonca locale dosyaları ("無効な入力" - invalid input) istemeden client JavaScript'e dahil ediliyor. Bundle boyutu gzipped haliyle 36-43 KB artıyor.

Sorun sadece default import'ta değil. Zod 4.3.6 ve 4.4.3'te Turbopack ve Webpack her iki durumda da locale dosyalarını ekliyor. Zod 4.5.4 ve 4.6.7'de ise import yöntemi ne olursa olsun (`import { z }`, `import * as z`, ya da `import z`) bundle temiz kalıyor.

Eğer 4.3.6 veya 4.4.3 kullanıyorsanız, `next build` sonrasında terminalde `grep -rl "無効な入力".next/static/chunks` komutunu çalıştırarak locale dosyalarının sizin bundle'a girip girmediğini kontrol edebilirsiniz. Sonuç varsa, Zod'u 4.5.4 veya daha yeni bir sürüme güncellemek gerekiyor.

Bu tür istenmeyen bundle bloatı, özellikle performans kritik olan uygulamalarda fark yaratıyor. Kütüphane güncellemeleri sırasında bundle boyutunun değişip değişmediğini kontrol etmek iyi bir alışkanlık.