Bu belge ADR-016'nın uygulama rehberidir. Faz sırası için derleyici faz modeli, kimlik kuralları için semantic kimlik modeli birlikte okunur.
K-103/K-104/K-108/K-126 ile çalışan hat
Parsed AST
│ checker: çözüm + tür/akış/etki kanıtı
▼
Bound AST + HirOlusturmaBilgisi
│ zorunlu lowering
▼
HirProgram
├─ HirDugumId → HirIfadeTuru::Deger(Tur) / DegerDondurmez
├─ HirDugumId → SymbolId / IslemId / YapiId
├─ HirDugumId → zorunlu HirKaynakAraligi
├─ semantic ID → canonical tanım
└─ salt-okunur kaynak AST (tanı ve v0 uyumluluğu)BaglanmisProgram artık HirProgram taşır. hir().ifade_bilgisi(ifade) bir ifadenin düğüm kimliğini, checker'ın kanıtladığı değer/dönüşsüz türünü ve semantic bağını verir. Değer konumunda olmayan çağrı cümlesi türsüz bırakılmaz; HirIfadeTuru::DegerDondurmez taşır. sembol_adi, islem ve yapi sorguları depolama konumunu ID'den ayrı tutar. K-120 ile LSP'nin tükettiği tanım ve kullanım dizinleri compiler/src/hir/gezinme.rs yaprak modülünün sorumluluğudur; HIR kökü veri sahipliğini, bu modül semantic gezinme sorgularını taşır.
K-121 ile yerel çağrı çıkarımı HIR üretiminden önce ayrı bir keşif geçişidir. Kopya AST'deki geçici/dar sonuç HIR'a yazılmaz; erişilebilir çağrı kısıtları birleştirildikten sonra asıl AST yalnız nihai işlem imzalarıyla denetlenir ve tek tutarlı HIR üretilir. Böylece aynı çağrı kümesinin kaynak sırası HirIfadeTurunu değiştiremez.
K-108/ADR-020 ile her HirIfadeBilgisi ayrıca zorunlu HirKaynakAraligi taşır. K-126/ADR-030 bunu bütün parser AST ifadelerinde kesinleştirdi: her yaprak kendi lexer tokenını, her bileşik ifade tükettiği ilk token başlangıcından son token bitimine kadar bölgeyi ayrı bir AstKaynakAraligi zarfında taşır. Checker aynı (satır, sütun, uzunluk) üçlüsünü HIR'a kopyalar; invariant iki katmanın birebir eşliğini doğrular. NonZeroUsize bileşenleri sıfır/konumsuz kaydı yapısal olarak engeller.
K-112/ADR-023 bu yapısal sözleşmeyi yürütülebilir çapraz kontrole bağladı. Debug/test faz çıkışında her canlı AST ifadesinin tam bir HIR kaydı, benzersiz HirDugumIdsi ve varyantla uyumlu bağı olması; HIR tablosunda canlı AST'ye karşılık gelmeyen kayıt bulunmaması zorunludur. Doğrulayıcı, özellik→alan dönüşümünde alt düğümün klonlanmasıyla eski AST adresinde kalan gerçek bir yetim HIR kaydını buldu; dönüşüm artık kutulu düğümü taşır.
Neden AST hemen silinmedi?
Bootstrap yorumlayıcısı büyük bir davranış yüzeyini AST üzerinden yürütür; formatter, LSP ve Türkçe tanılar da kaynak yazımına ihtiyaç duyar. AST'yi tek committe kopya bir dev enum'a çevirmek, semantik kazanım olmadan geniş hata yüzeyi oluşturur. Bunun yerine geçiş iki kanıtlı dilimdir:
- K-103: typed HIR kaydı zorunlu faz ürünü oldu.
- K-104: standart runtime ve
dene, değişken/işlem/yapı kararlarını yalnız HIR bağlarından almaya başladı; kaynak adı yalnız tanı/gösterim verisidir. - K-120: LSP definition/rename, sembol tanım+yazım+okuma dizinini ve işlem/yapı ID bağlarını production'da tüketmeye başladı.
- K-121: yerel çağrı keşfi HIR öncesine ayrıldı; yalnız nihai imzalı checker geçişinin tür ve bağ kayıtları kalıcı HIR gerçeği oldu.
- K-126: parser AST'sindeki bütün ifade düğümleri kesin kaynaklandı; checker tanıları ve LSP bu aralığı üretim hattında tüketmeye başladı.
B-019 iki dilimle kapandı. Raw Program alan v0 API'nin ad-temelli davranışı uyumluluk sınırıdır, yeni iç kod için örnek değildir.
yorumlayici/hir_gecisi.rs iki yürütme kolunu açıkça ayırır. HIR kolu bağ bulamazsa kaynak adına geri düşmez; iç değişmez hatası verir. Scheduler görev ifadelerini klonlamak yerine özgün düğümü ödünç alır, böylece HIR kimliği eşzamanlı yürütmede korunur.
Düğüm kimliği ve ömür
HirDugumId program içi semantic düğüm kimliğidir. Checker'ın private AST adresi yalnız lowering sırasında bu kimliğin kayıt anahtarıdır. Public API adresi açmaz; HirProgram AST'yi kutuda sabit tutar ve bağlı program klonlama yüzeyi sunmaz. Kalıcı paket/ABI kimliği gerekiyorsa ayrı bir karar gerekir.
Büyüme kuralları
- Yeni ifade checker'da başarılı tür döndürüyorsa HIR kaydı otomatik oluşur.
- Geçici çıkarım/keşif geçişi HIR üretmez; yalnız nihai doğrulama geçişi
HirOlusturmaBilgisisahibi olabilir. - Yeni semantic bağ
Stringolarak HIR'a eklenmez; tür güvenli ID ister. - Runtime'ın HIR tüketicisi, bağ eksikliğini kaynak adından tahmin ederek onarmaz; iç değişmez hatası üretir.
- LSP'nin semantic tüketicisi de başarısız bağlı programı metin taramasıyla onarmaz; definition/rename için
nulldöner ve mevcut tanıyı korur. - Kaynak aralığı
Optionyapılmaz veya sonradan doldurulmaz; B-020/K-108 değişmezi her HIR ifade kurucusunda korunur. - Yeni parser AST düğümü
ayristirici/kaynak.rskapısından tam tükettiği token bölgesiyleIfade::Kaynaklizarfına alınmadan üretilemez. Alt ifadeler ebeveyn aralığını paylaşmaz; kendi kesin aralığını taşır. - Yeni ifade varyantı invariant ziyaretçisinde bütün alt ifadeleri, beklenen
HirBaginı ve imkânsız biçimlerini tanımlar. - Yerinde AST dönüşümü kutulu alt düğümü klonlamaz; HIR eşlemesini koruyacak biçimde taşır.
hir_modeli_testi.rsve mimari sınır testi olmadan HIR sahipliği değişmez.
Kaynak: docs/typed-hir-modeli.md · Bütün belgeler