Reladraw: yerleşimi algoritmanın değil yazarın belirlediği diyagram dili

Diyagramlar için metin tabanlı yeni bir dil Hacker News'te dikkat çekiyor: GitHub'da Apache-2.0 lisansıyla yayımlanan Reladraw 366 puan ve yüzden fazla yorum topladı. TypeScript ile yazılmış, çalışma anında ek bağımlılık kullanmıyor ve bir ayrıştırıcı, bir yerleşim çözücüsü, bir SVG görüntüleyici, komut satırı aracı ile tarayıcı oyun alanından oluşuyor.

Otomatik yerleşim ile elle yerleşim arasındaki boşluk

Yazar sorunu iki araç ailesi arasında bir seçim olarak tanımlıyor. Mermaid, Graphviz ve D2 düğümlerle bağlantılar bildirildikten sonra her şeyi kendileri yerleştirir; bu, kafanızda belirli bir resim olduğu anda işe yaramaz hale gelir. draw.io, Excalidraw ve Figma tam kontrol verir, ama her düzenleme yavaş bir el işine dönüşür.

Reladraw ikisinin arasında duruyor. Her konum başka bir şeye göre belirtiliyor ve dosyada tek bir koordinat yok: belgelerdeki gerçek bir satır node resolver right of parser biçiminde. Aralıklar kesin değil, en küçük mesafedir; bu yüzden iki düğüm arasına üçüncüsünü koymak onları tam olarak ihtiyacı kadar ayırır.

Dil nasıl okunuyor

Dosyada her satırda bir ifade bulunur, blok yoktur ve girinti yok sayılır. Noktalı ad iç içe olmayı anlatır: server.docker, server düğümünün içinde çizilir. Bir bağlantıya düğümün hangi yanından çıkıp hangi yanından gireceği ve yolda hangi aralıktan geçeceği söylenebilir.

Referans örnek arch.reladraw, elle çizilmiş bir draw.io diyagramını 44 ifadeyle yeniden üretiyor ve above-left of hub ile between cluster.desktop1 and cluster.laptop1 gibi yönergeler kullanıyor. Çözücü yerleşim aramaz, mesafeleri hesaplar; düğümler varsayılan olarak birbirinin üzerine binmez.

Tasarım neden ajanları hedefliyor

Yazarın savı şu: asıl durum diyagram çizmek değil, onu değiştirmektir. Piksel koordinatlarıyla bir ajan resmi sayılardan yeniden kurmak zorundadır; otomatik yerleşimde ise düzen hiçbir yere yazılmamıştır. Konum belirtildiğinde düzenleme bir cümlenin değiştirilmesidir. Depoda, kod ajanlarına sözdizimini öğreten bir ajan becerisi de var; npx skills add reladraw/reladraw -g komutuyla kuruluyor.

Hâlâ eksik olanlar

Projenin durum listesinde sıradaki büyük parça tanılama raporu: bugün araç ya çiziyor ya başarısız oluyor ve başarıyla çizdiği bir resimde neyin yanlış olduğunu söyleyemiyor. Tartışmada bir yorumcu, daha fazla elle kontrol sunan bir alternatif olarak D2'nin TALA yerleşim motoruna işaret etti; yazar, TALA'nın otomatik yerleşimi koruyup yalnızca onu yönlendirmenin yollarını eklediğini söyledi. Bildirilen kavisli bağlantı hatası oyun alanında düzeltildi.