vite-plugin-xu
Bir .xu tek dosyalı bileşenini gerçek bir ES modülüne derleyen, derleme zamanı Vite eklentisi.
@xuda/vite-plugin-xu, .xu tek dosyalı bileşenlerini derleme zamanında ES modüllerine derler
ve geliştirme sırasında bunları tam bileşen yeniden yükleme düzeyinde sıcak yeniler.
@xuda/vite-plugin-xu ve bağlı olduğu @xuda/compiler paketi, package.json dosyalarında
"private": true taşır. xuda-cli, create-xuda-cli ve @xuda/core'un aksine, ikisi de henüz
npm'de yayımlanmamıştır. Bu depodaki tek çalışan tüketici olan examples/hello, ona bir file:
bağımlılığı olarak ulaşır: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".
Kurulum
examples/hello, bu şekilde oluşturulmuş eksiksiz çalışan bir projedir: bir sayaç, koşullu bir bağlama
ve anahtarlı bir liste; bileşenin kendisinde hiçbir sinyal, .value ya da veri kaynağı katmanı
görünmeden, yalnızca düz fonksiyonlar ve bir reactive() deposu üzerinde düz değiştirmeyle yönlendirilir.
Eklenti mekanik olarak nedir
Tek bir transform kancası. Vite'in varsayılan load adımı dosyayı zaten okuduğu için kanca .xu
kaynağını metin olarak alır, @xuda/compiler derleyicisini çağırır ve üretilen modülü döndürür. Özel
bir çözümleyici ve sanal bir modül yoktur: .xu gerçek bir yola sahip gerçek bir dosya olarak kalır;
bu da yığın izlerini ve HMR grafiğini dürüst tutar.
enforce: 'pre' önemlidir: onsuz vite:esbuild dosyaya önce ulaşabilir ve <template> üzerinde
başarısız olabilir; bu, işlem hattı sırasının yanlış olması yerine dosyanın bozuk olduğu izlenimini
verir. Vite ayrıca JS olmayan içe aktarmalara ?import (ve bir HMR yeniden isteğinde ?t=…) ekler;
eklenti bunu dahil etme testinden önce ayıklar, yoksa dosya sessizce derlenmez ve tarayıcı, yazarın
hiç yazmadığı bir dosyada sözdizimi hatası bildirir.
HMR
Uygulanan düzey tam bileşen yeniden yüklemesidir: düzenlemede modül yeniden yürütülür, o bileşenin
bağlı her örneği yeni modülden bağlantısını koparıp yeniden bağlanır ve bileşen durumu sıfırlanır.
<script> içindeki bir reactive({ count: 0 }) yeniden 0 olur. Durumu korumak bilerek denenmez,
çünkü <script> düzenlendikten sonra eski reaktif nesnenin hangi yarısının hâlâ aynı anlama geldiğini
bilmenin güvenilir bir yolu yoktur.
Sunma modunda eklenti bir import.meta.hot.accept alt bilgisi ekler. __XUDA_HMR__, bir uygulama ilk
kez bağlandığında @xuda/core içindeki createApp tarafından kurulur; bu yüzden eklenti kullanıcı
koduna asla bir içe aktarma eklemez. Hiçbir bağlı uygulama güncellenen bileşeni üstlenmiyorsa (kimse
onu göstermiyordu ya da sayfa henüz açılmadı), güncelleme sessizce hiçbir şey yapmamak yerine tam
sayfa yeniden yüklemesine döner. Üretim derlemesi hiç HMR alt bilgisi almaz.
Seçenekler
xuda-cli'nin derlediği blok tabanlı lehçe için ve bu derleyicinin lehçesinin ondan nasıl farklı
olduğunu anlatan not için .xu dili sayfasına bakın.