Aggrega Catalog (SchemaLibrary) şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json
Katalog içeriğinin (Components, Features vb.)
SchemaLibrary varlıklarının yazımına ilişkin açıklayıcı rehberlik için SchemaLibrary yazım referansına bakın; bu sayfa, o referansın tanımladığı yapısal şemayı belgeler.
Üst düzey tür: object
Özellikler
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | evet | Sabit: "aggrega.ai/v1beta1" |
kind | const “SchemaLibrary” | evet | Sabit: "SchemaLibrary" |
metadata | object | evet | |
spec | object | evet | SchemaLibrary’nin içeriği. spec.schemas zorunludur ve en az bir girdi bildirmelidir; spec.templates isteğe bağlıdır ve yalnızca kütüphane parametreli yardımcılar kullandığında bulunur. |
Ek özelliklere izin verilmez.
schemalibrary.metadata
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Kütüphanenin PascalCase tanımlayıcısı. ^[A-Z][A-Za-z0-9]*$. |
version | string | evet | Kütüphanenin katı Anlamsal Sürümlemesi (ör. 1.0.0). Release başına kilit dosyası her kütüphane için bir sürümü sabitler. Desen: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | hayır | Kütüphanenin neyi kapsadığına dair kısa bir özet. |
labels | string eşlemi | hayır | Yazar tarafından bildirilen etiketler. Derleyici içeriğe karşı tarafsızdır ve etiket değerlerini yorumlamaz: bunlar, kütüphaneyi okuyan herhangi bir şeyin eşleştirme yapabilmesi için taşınan opak meta verilerdir. |
annotations | string eşlemi | hayır | Yazar tarafından bildirilen ek açıklamalar. Etiketlerle aynı opak meta veri yaklaşımı. |
Ek özelliklere izin verilmez.
schemalibrary.spec
SchemaLibrary’nin içeriği. spec.schemas zorunludur ve en az bir girdi bildirmelidir; spec.templates isteğe bağlıdır ve yalnızca kütüphane parametreli yardımcılar kullandığında bulunur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
schemas | object eşlemi | evet | Yeniden kullanılabilir şema tanımlarının adlandırılmış eşlemi. Her girdinin içeriği, ayrıştırma zamanında kompakt biçim derleyicisi tarafından doğrulanır; zarf düzeyindeki doğrulama yalnızca yapısal sarmalamayı denetler. Anahtarlar: PascalCase tanımlayıcı — ^[A-Z][A-Za-z0-9]*$. Girdi anahtarları yalın ad kimlik referanslarında (<Library>#/schemas/<name>) yer alır; zarf düzeyindeki kısıt, PascalCase olmayan anahtarların katalog ekosistemine yayılmasını önler. En az 1 girdi. |
templates | object eşlemi | hayır | Parametreli yardımcıların isteğe bağlı adlandırılmış eşlemi. Şema girdileri şablonlara $instantiate: aracılığıyla adlarıyla başvurur; yalnızca değişmez skaler yerine koyma yapılır — gömülü Go şablonları, koşullar ve döngüler yoktur. Kütüphane yerine koyma katmanı, yazımın ayrı bir şablonlama yüzeyi getirmek yerine şema dilinde kalması için bilinçli olarak tam şablon değerlendirmesinden daha dardır. Anahtarlar: PascalCase tanımlayıcı — ^[A-Z][A-Za-z0-9]*$. Şema girdi anahtarlarıyla aynı zarf düzeyi disiplin geçerlidir; şablon adlarına örnekleme zamanında $instantiate: aracılığıyla başvurulur. |
Ek özelliklere izin verilmez.