DESIGN.md doğrulayıcı

YAML frontmatter'ı, zorunlu primary rengini, renklerin bir renk formatında (hex, rgb, hsl, oklch, bir renk adı ve benzerleri) yazılıp yazılmadığını, px, em veya rem cinsinden font boyutlarını ve yarıçapları, tipografi özelliklerini, bileşen özelliklerini ve bunların token referanslarını (YAML'ın metin olarak okumadığı, tırnak içine alınmamış referanslar dahil), omitted listesini, tekrarlanan ya da sırası bozuk bölümleri ve her bileşenin metin ile arka plan renkleri arasındaki kontrastı WCAG AA'nın 4.5:1 alt sınırına göre. Hatalar dosyayı geçersiz kılar; uyarılar düzeltilmeye değer noktaları işaretler.

Hayır. Doğrulama tamamen tarayıcında çalışır: yapıştırdığın metin ya da seçtiğin dosya asla sunucularımıza gönderilmez. Önizlemenin yaptığı tek istek font stil sayfaları içindir: sunucumuz bunları Google Fonts'tan alır ve bu isteklerde yalnızca tipografi token'larındaki font ailesi adları bulunur.

Stitch'in kullandığı ve google-labs-code/design.md deposunda yayımlanan Google DESIGN.md formatını. Doğrulayıcı, Design Extractor'ın ürettiği her DESIGN.md'yi kontrol ederken kullandığı kuralların aynısını uygular, ayrıca bileşen renklerinde bir kontrast kontrolü yapar.

"{colors.brand}" gibi bir referans, frontmatter'da var olan bir token'ı göstermelidir; burada colors altındaki bir brand girdisini. Eksik token'ı ekle ya da referansı var olan bir token'a yönlendir. Referansları tırnak içinde tut: YAML, tırnaksız bir {colors.brand} ifadesini metin olarak değil, bir mapping olarak okur.

Evet. Google'ın açık kaynaklı komut satırı aracı, bir dosyayı pipeline'ında kontrol eder: npx @google/design.md lint DESIGN.md komutunu çalıştır. Bir JSON raporu yazdırır ve hata bulduğunda 1 koduyla çıkar; böylece bozuk bir dosyada iş başarısız olur. Kural seti bu sayfayla örtüşür, ancak bazı önem dereceleri farklıdır.