Aggrega-Schema für den Katalog (SchemaLibrary)
Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.
Schema-ID: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json
Eine wiederverwendbare Sammlung von Definitionen in JSON Schema 2020-12, auf die Kataloginhalte (Components, Features usw.) über die Identitätsreferenz per bloßem Namen
Siehe die Authoring-Referenz zur SchemaLibrary für Anleitungen in Prosaform zum Verfassen von SchemaLibrary-Entitäten; diese Seite dokumentiert das strukturelle Schema, das diese Referenz beschreibt.
Typ der obersten Ebene: object
Eigenschaften
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ja | Konstante: "aggrega.ai/v1beta1" |
kind | const “SchemaLibrary” | ja | Konstante: "SchemaLibrary" |
metadata | object | ja | |
spec | object | ja | Der Inhalt der SchemaLibrary. spec.schemas ist erforderlich und muss mindestens einen Eintrag deklarieren; spec.templates ist optional und nur vorhanden, wenn die Bibliothek parametrisierte Helper verwendet. |
Zusätzliche Eigenschaften sind nicht zulässig.
schemalibrary.metadata
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | ja | PascalCase-Bezeichner der Bibliothek. Er ist der Name ^[A-Z][A-Za-z0-9]*$. |
version | string | ja | Strikte semantische Versionierung der Bibliothek (z. B. 1.0.0). Das Lockfile pro Release legt eine Version pro Bibliothek fest. Muster: ^(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 | nein | Eine knappe Zusammenfassung dessen, was die Bibliothek abdeckt. |
labels | Map von string | nein | Vom Autor deklarierte Labels. Der Compiler ist inhaltsneutral und interpretiert Label-Werte nicht: Sie sind opake Metadaten, mitgeführt für alles, was die Bibliothek liest und darauf abgleichen will. |
annotations | Map von string | nein | Vom Autor deklarierte Annotationen. Dieselbe Haltung opaker Metadaten wie bei Labels. |
Zusätzliche Eigenschaften sind nicht zulässig.
schemalibrary.spec
Der Inhalt der SchemaLibrary. spec.schemas ist erforderlich und muss mindestens einen Eintrag deklarieren; spec.templates ist optional und nur vorhanden, wenn die Bibliothek parametrisierte Helper verwendet.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
schemas | Map von object | ja | Benannte Map wiederverwendbarer Schemadefinitionen. Der Inhalt jedes Eintrags wird beim Parsen vom Compiler der Kompaktform validiert; die Validierung auf Ebene der Hülle prüft nur die strukturelle Umhüllung. Schlüssel: PascalCase-Bezeichner — ^[A-Z][A-Za-z0-9]*$. Eintragsschlüssel erscheinen in Identitätsreferenzen per bloßem Namen (<Library>#/schemas/<name>); die Einschränkung auf Ebene der Hülle verhindert, dass Schlüssel, die nicht PascalCase sind, sich durch das Katalog-Ökosystem verbreiten. Mindestens 1 Eintrag. |
templates | Map von object | nein | Optionale benannte Map parametrisierter Helper. Schemaeinträge referenzieren Templates über den Namen per $instantiate:; nur literale Ersetzung von Skalaren — keine eingebetteten Go-Templates, keine Bedingungen, keine Schleifen. Die Ersetzungsschicht der Bibliothek ist bewusst enger als eine vollständige Template-Auswertung, damit das Authoring in der Schemasprache bleibt, statt eine separate Templating-Oberfläche einzuführen. Schlüssel: PascalCase-Bezeichner — ^[A-Z][A-Za-z0-9]*$. Dieselbe Disziplin auf Ebene der Hülle wie bei den Schlüsseln der Schemaeinträge; Template-Namen werden zum Zeitpunkt der Instanziierung über $instantiate: referenziert. |
Zusätzliche Eigenschaften sind nicht zulässig.