Referencias y fuentes

Esquema de configuración

El JSON Schema de la configuración de un proyecto Lagune, para autocompletar y validar en tu editor, siguiendo la versión actual de Lagune o fijado a una versión concreta.

El archivo .lagune/configs.json registra las categorías que usa un proyecto e indexa sus propias especializaciones. Su JSON Schema permite que tu editor autocomplete cada campo y señale una errata o una categoría desconocida mientras editas el archivo.

El esquema actual​

Siempre que Lagune escribe el archivo y no encuentra ningún $schema en él, lo apunta al esquema actual:

{
"$schema": "https://lagune.ai/schemas/configs.json",
"categories": ["owasp", "javascript"]
}

Esta dirección sigue siempre la versión actual de Lagune. Un archivo escrito antes de Lagune 0.16.0 la recibe en su próximo cambio, y hasta entonces todas las fases lo advierten.

Fijar una versión​

Cada versión de Lagune a partir de la 0.16.0 incluye el esquema tal como era en ella, publicado en npm y servido por jsDelivr. Para fijar una, pon la versión después de lagune@ en la dirección de $schema:

{
"$schema": "https://cdn.jsdelivr.net/npm/lagune@0.16.0/schemas/configs.json"
}

La versión admite cualquier rango semver:

VersiónEsquema
0.16.0El de la 0.16.0
0.16.x o 0.16El de la última versión 0.16
0.x o 0El de la última versión 0.x
latestEl de la última versión

Preguntas frecuentes

No. El esquema solo ayuda a tu editor, y Lagune lee el archivo igual con $schema o sin él.

No. Lagune solo escribe $schema cuando el archivo no tiene ninguno, y conserva cualquier dirección que hayas puesto.

Cuando el proyecto usa una versión concreta de Lagune, para que tu editor valide el archivo según lo que acepta esa versión.