Esquema del catálogo de Aggrega (SchemaLibrary)
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json
Una colección reutilizable de definiciones JSON Schema 2020-12 a las que el contenido del catálogo (Components, Features, etc.) puede hacer $ref mediante la referencia de identidad por nombre simple
Consulta la referencia de autoría de la SchemaLibrary para obtener orientación en prosa sobre cómo escribir entidades SchemaLibrary; esta página documenta el esquema estructural que describe esa referencia.
Tipo de nivel superior: object
Propiedades
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sí | Constante: "aggrega.ai/v1beta1" |
kind | const “SchemaLibrary” | sí | Constante: "SchemaLibrary" |
metadata | object | sí | |
spec | object | sí | El contenido de la SchemaLibrary. spec.schemas es obligatorio y debe declarar al menos una entrada; spec.templates es opcional y solo está presente cuando la biblioteca usa helpers parametrizados. |
No se permiten propiedades adicionales.
schemalibrary.metadata
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | Identificador PascalCase de la biblioteca. Es el nombre ^[A-Z][A-Za-z0-9]*$. |
version | string | sí | Versionado semántico estricto de la biblioteca (p. ej., 1.0.0). El archivo de bloqueo de cada Release fija una versión por biblioteca. Patrón: ^(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 | no | Un resumen conciso de lo que cubre la biblioteca. |
labels | mapa de string | no | Etiquetas declaradas por el autor. El compilador es neutral respecto al contenido y no interpreta los valores de las etiquetas: son metadatos opacos, transmitidos para que lo que lea la biblioteca pueda usarlos para hacer coincidencias. |
annotations | mapa de string | no | Anotaciones declaradas por el autor. La misma postura de metadatos opacos que las etiquetas. |
No se permiten propiedades adicionales.
schemalibrary.spec
El contenido de la SchemaLibrary. spec.schemas es obligatorio y debe declarar al menos una entrada; spec.templates es opcional y solo está presente cuando la biblioteca usa helpers parametrizados.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
schemas | mapa de object | sí | Mapa con nombre de definiciones de esquema reutilizables. El contenido de cada entrada lo valida el compilador de la forma compacta en el momento del análisis; la validación a nivel del envoltorio solo comprueba la estructura que lo envuelve. Claves: identificador PascalCase — ^[A-Z][A-Za-z0-9]*$. Las claves de las entradas aparecen en las referencias de identidad por nombre simple (<Library>#/schemas/<name>); la restricción a nivel del envoltorio impide que claves que no son PascalCase se propaguen por el ecosistema del catálogo. Al menos 1 entrada. |
templates | mapa de object | no | Mapa con nombre opcional de helpers parametrizados. Las entradas de esquema hacen referencia a plantillas por nombre mediante $instantiate:; solo sustitución literal de escalares — sin plantillas Go incrustadas, sin condicionales, sin bucles. La capa de sustitución de la biblioteca es intencionadamente más estrecha que una evaluación completa de plantillas, para que la autoría permanezca en el lenguaje de esquemas en lugar de introducir una superficie de plantillas aparte. Claves: identificador PascalCase — ^[A-Z][A-Za-z0-9]*$. La misma disciplina a nivel del envoltorio que las claves de las entradas de esquema; los nombres de plantilla se referencian mediante $instantiate: en el momento de la instanciación. |
No se permiten propiedades adicionales.