BASILISCO para Visual Studio Code

BASILISCO Language Support

El entorno de edición de BASILISCO dentro de Visual Studio Code.

BASILISCO Language Support incorpora herramientas de edición para proyectos escritos en BASILISCO, el lenguaje de programación cuyo compilador e intérprete se distribuyen mediante la CLI bsk/basilisco.

La extensión conecta el editor con las herramientas reales del lenguaje. Los diagnósticos se obtienen ejecutando el analizador de BASILISCO; el resaltado, las ayudas de edición y los comandos se integran directamente en Visual Studio Code.

Características

Requisitos

• Visual Studio Code 1.85.0 o superior.
• BASILISCO 0.6.0 o compatible instalado en el equipo.
• El ejecutable bsk o basilisco debe estar disponible en el PATH.

Comprueba la instalación desde una terminal:

bsk --version
# o
basilisco --version

Si el ejecutable no se llama bsk o no está en el PATH, configura basilisco.executable con el nombre o la ruta absoluta del ejecutable.

Instalación

Desde un archivo VSIX

1. Descarga basilisco-0.3.1.vsix desde la sección Releases o desde el canal de distribución donde se publique.
2. Abre Visual Studio Code.
3. Abre la vista Extensions.
4. Selecciona el menú ... y elige Install from VSIX....
5. Selecciona el archivo descargado y reinicia la ventana si VS Code lo solicita.

Desde el Marketplace

Busca BASILISCO Language Support en Visual Studio Marketplace cuando la publicación esté disponible.

Primeros pasos

1. Instala BASILISCO CLI y verifica que bsk --version funcione.
2. Abre una carpeta de proyecto en VS Code.
3. Crea o abre un archivo con extensión .bsk.
4. Escribe código BASILISCO: el editor aplicará el resaltado y, si está habilitado, ejecutará el análisis automático.
5. Usa Ctrl+Shift+P y escribe BASILISCO: para consultar los comandos disponibles.

Ejemplo mínimo de archivo:

funcion saludar(nombre) {
    mostrar("Hola " + nombre)
}

sea usuario = "BASILISCO"
saludar(usuario)

Los archivos .bsk son la extensión canónica. También se reconoce .nexo como extensión heredada.

Comandos disponibles

Abre la paleta con Ctrl+Shift+P y busca BASILISCO:.

Configuración

Las opciones se encuentran en Settings → Extensions → BASILISCO o en settings.json.

{
  "basilisco.executable": "bsk",
  "basilisco.extraArgs": [],
  "basilisco.diagnostics.enable": true,
  "basilisco.diagnostics.delay": 450,
  "basilisco.semanticHighlighting.enable": true,
  "basilisco.formatter.indentSize": 2
}

Alcance y limitaciones de la versión 0.3.1

La extensión utiliza la CLI de BASILISCO para análisis y formato. Es importante distinguir las funciones implementadas de las que todavía requieren infraestructura adicional:

• Los diagnósticos se basan en el lexer, parser y analizador semántico reales invocados por bsk analizar. Como la CLI devuelve errores en texto, la extensión reconstruye rangos a partir de los mensajes; algunos rangos pueden ser aproximados.
• Hover, navegación, referencias, renombrado y Signature Help se basan en declaraciones locales detectadas en el documento. No constituyen todavía una resolución semántica completa entre ámbitos, módulos o símbolos exportados.
• La extensión no incluye todavía un servidor LSP independiente.
• No incluye depurador DAP. No se anuncian breakpoints, ejecución paso a paso ni inspección de variables porque el runtime no ofrece actualmente esa interfaz.
• La calidad y disponibilidad de las operaciones que delegan en la CLI dependen de la versión de BASILISCO instalada.

Solución de problemas

VS Code indica que no encuentra bsk

Ejecuta bsk --version en una terminal. Si funciona únicamente con una ruta específica, establece esa ruta en basilisco.executable y reinicia la ventana de VS Code.

No aparecen diagnósticos

Verifica que basilisco.diagnostics.enable esté activado, que el archivo esté guardado y que la CLI pueda analizarlo desde una terminal. Revisa View → Output → BASILISCO para consultar la salida de la extensión.

El archivo no se reconoce como BASILISCO

Comprueba que tenga extensión .bsk o .nexo. También puedes seleccionar BASILISCO desde el selector de lenguaje de la esquina inferior derecha.

Desarrollo y empaquetado

npm install
npm test
npm run package

El comando npm run package utiliza @vscode/vsce para generar el paquete VSIX. No se recomienda editar manualmente el manifiesto VSIX.

Reportar problemas y contribuir

• Código fuente: https://github.com/alexandevs2309/nexo
• Reporte de errores: https://github.com/alexandevs2309/nexo/issues

Al reportar un problema, incluye la versión de VS Code, la versión de BASILISCO, el sistema operativo, el mensaje de error y un ejemplo mínimo que permita reproducirlo.

Licencia

Este proyecto se distribuye bajo la licencia Apache-2.0. Consulta el archivo LICENSE.

BASILISCO — Lenguaje, herramientas y experiencia de desarrollo.