Prisma v8.0.0-rc.17: Mimari Sürüm Analizi

Yönetici Özeti ve Mimari Önem

Prisma v8.0.0-rc.17, iddialı PSL mixins projesinin ilk yürütme dilimi olarak görev yapan Prisma Şema Dili (PSL) ayrıştırıcı altyapısının evriminde temel bir kilometre taşını işaret eder. Modern veritabanı mimarları giderek daha modüler şema tanımları talep ettiğinden, veritabanı araçları ayrıştırma performansından veya tanılama hassasiyetinden ödün vermeden kodun yeniden kullanımını ve kompozisyon desenlerini destekleyecek şekilde evrimleşmelidir. Bu sürüm, PSL sembol tablosunun bildirim üyelerini nasıl ortaya çıkardığını yeniden düzenleyerek üye çözümlemesini, bunu bireysel tüketici düğümlerine devretmek yerine doğrudan sembol oluşturma aşamasında merkezileştirir.

Mimari açıdan bu güncelleme, bağlayıcı, blok belirtimi yorumlayıcıları, veritabanına özgü SQL sözleşmesi yorumlayıcıları, eski Prisma motoru yorumlayıcıları ve dil sunucusu dil özellikleri dahil olmak üzere aşağı akış tüketicilerini doğrudan sözdizimi düğümü geçişinden ayırır. buildSymbolTable'ı blok üyeleri için tek yetkili gerçeklik kaynağı olarak kurarak, Prisma çekirdek ekibi, sembol çözümlemesi sırasında mixin üyelerini sorunsuz bir şekilde enjekte etmek için gereken altyapıyı oluşturmuştur. Bu yapısal hizalama, tüm aşağı akış sistemlerinin her tüketici etki alanında özel modifikasyonlar gerektirmeden mixin yeteneklerini doğal olarak devralmasını sağlar.

Temel İyileştirmeler ve Geliştirici Ergonomisi

v8.0.0-rc.17'deki birincil dahili iyileştirme, BlockSymbol TypeScript arayüzünün genişletilmesi etrafında döner. Sembol arayüzü artık ilk blok oluşturma aşamasında kaynak sırasına göre belirlenmiş bir şekilde doldurulan entries ve attributes dizilerini yerel olarak gösterir. Çok önemli bir şekilde, entries, tekrarlanan anahtarları meşru bir şekilde gerektiren harita modlu blokları barındırarak, benzersiz bir anahtar-değer kayıt haritası yerine sıralı bir liste olarak uygulanır. Bu tasarım seçimi, tüketicilerin blok gövdelerini nasıl sorguladığını kolaylaştırırken kritik yapısal semantiği korur.

Kod tabanı genelinde, daha önce symbol.node aracılığıyla yapılandırma değerlerini okuyan 23 farklı üretim noktası, yalnızca sembolün özel kayıtlarından okuyacak şekilde yeniden düzenlendi. Dahası, PSL ayrıştırıcı bağlayıcısı içindeki bindAttributes ve SQL yazma yorumlayıcısındaki model özniteliği işleme döngüsü gibi karmaşık alt sistemlerdeki dizin tabanlı eşleştirme güvenlik açıkları sistematik olarak ortadan kaldırıldı. Çözümlenmiş özniteliklerin kaynak sözdizimi düğümlerine doğrudan güvenli bir şekilde başvurmasını sağlayarak motor, kırılgan paralel dizi geçişlerini ortadan kaldırır ve dahili kod sürdürülebilirliğini ve ayrıştırıcı sağlamlığını önemli ölçüde artırır.

Mimari Karşılaştırma Matrisi

Mimari Boyut	Önceki Temel Çizgi (rc.17 Öncesi)	Prisma v8.0.0-rc.17	Performans ve Mimari Etki
Üye Çözümlemesi	symbol.node aracılığıyla tüketicilere dağıtılmış	buildSymbolTable içinde merkezileştirilmiş	Gereksiz ağaç ayrıştırmasını ortadan kaldırır; tek bir gerçeklik kaynağı oluşturur.
Girdi Depolama Formatı	Örtük AST düğüm eşlemesi	Deterministik, kaynak sıralı liste (entries)	Harita modlu şema blokları tarafından yerel olarak gereksirilen tekrarlanan anahtarları destekler.
AST Geçiş Gecikmesi	Yüksek (dizinlere göre sık paralel dizi yürüyüşleri)	Optimize edilmiş (çözümlenmiş semboller aracılığıyla doğrudan başvuru)	Şema bağlama ve LSP otomatik tamamlama geçişleri sırasında CPU yükünü azaltır.
Bellek Ayak İzi	Eski yorumlayıcılar arasında parçalanmış tahsisler	Birleştirilmiş sembol başvuru modeli	Yinelenen düğüm tahsislerini önler ve genel yığın baskısını azaltır.
Mixins Hazırlığı	Kompozisyonel yeniden kullanıma hazırlanmamış	Sembol genişletilmesi yoluyla tamamen mimari olarak tasarlanmış	Aşağı akışları bozmadan gelecekteki PSL mixin özelliklerini etkinleştirir.

Kritik Değişiklikler ve Geçiş Uyarıları

Prisma v8.0.0-rc.17, çalışma zamanı şema ayrıştırma davranışı ve çıktı üretimi açısından tamamen geriye dönük uyumludur; bu sürümde hiçbir genel API sözleşmesi veya tüketici odaklı şema sözdizimi kuralı değiştirilmemiştir. Tüm dahili değişiklikler kesinlikle yapısal olup güncellemeleri @internal/psl-parser, SQL yazma sözleşmeleri, dil sunucusu protokolleri ve eski çalışma zamanı yorumlayıcılarındaki dahili paket sınırlarıyla sınırlandırır.

Aşağı akış araçlarını veya özel AST ziyaretçilerini koruyan dahili geliştiriciler ve katkıda bulunanlar, ham sözdizimi düğümleri (symbol.node.entries() veya benzer kalıplar) aracılığıyla blok girdilerine veya özniteliklerine doğrudan erişmenin artık kullanım dışı bırakıldığını ve desteklenmediğini unutmamalıdır. Gerilemeyi önlemek için özel düzenli ifade lint kuralları (rg) aracılığıyla statik analiz kontrolleri oluşturulmuştur. Tüketiciler üyeleri yalnızca standartlaştırılmış BlockSymbol özellikleri aracılığıyla sorgulamalıdır.

Adım Adım Yükseltme Kılavuzu

Değişiklikler Prisma'nın ayrıştırıcı mimarisine dahil olduğundan, Prisma v8.0.0-rc.17'ye yükseltmek standart uygulama geliştiricileri için basittir. Özel dahili eklentiler geliştiriyorsanız veya doğrudan dahili PSL ayrıştırıcı paketleriyle etkileşim kuruyorsanız şu adımları izleyin:

1. Bağımlılık Sürümlerini Güncelleyin İlgili Prisma paketlerinde v8.0.0-rc.17 sürümünü işaret etmek için çalışma alanı yapılandırmanızı veya paket bildirimlerinizi değiştirin.

2. Doğrudan AST Erişimcilerini Yeniden Düzenleyin Özel araçlarınız veya dahili uzantılarınız blok üyelerini almak için ham sözdizimi düğümlerinde geziniyorsa, kod tabanınızı doğrudan sembolleri tüketecek şekilde güncelleyin:

   // Önce
   for (const entry of block.node.entries()) { /* ... */ }
   
   // Sonra
   for (const entry of block.entries) { /* ... */ }
   

3. Doğrulama ve Tip Kontrollerini Çalıştırın Tüm dahili sözleşmelerin güncellenmiş sembol tablosu tanımlarıyla hizalandığından emin olmak için çalışma alanı test paketlerinizi ve tip kontrol komutlarınızı yürütün:

   pnpm install
   pnpm typecheck
   pnpm test:packages