Guía

Editor

La extensión de Ascua para VS Code, y ascua-ts-plugin para Zed y el resto: colores dentro de las plantillas, errores de tipos, autocompletado e ir a la definición.

Qué hace

Dentro de cada view`…`, mientras escribes:

  • los errores de tipos de las plantillas, subrayados donde están;
  • autocompletado de props dentro de la etiqueta de un componente, con los obligatorios primero y sin los que ya escribiste;
  • autocompletado del HTML: después de <, las etiquetas y tus componentes; dentro de una etiqueta, sus atributos y los globales, los eventos (oninput, onkeydown…), prop: con las propiedades que se pueden escribir en ese elemento, class: y ref. Con el valor ya puesto: comillas para un atributo, ${} para un evento;
  • ir a la definición desde <Tarjeta hasta la función;
  • la firma del componente al pasar por encima de su etiqueta;
  • los errores de sintaxis de una plantilla, en su línea.

Lo hace ascua-ts-plugin, un plugin de tsserver: el mismo análisis que ascua-check en la línea de comandos.

VS Code

Descargar ascua-vscode-0.1.0.vsix · 76 kB

sh
code --install-extension ascua-vscode-0.1.0.vsix

O en VS Code: Extensions → … → Install from VSIX…

La extensión trae el plugin y además pinta las plantillas: etiquetas, atributos, tus componentes, el CSS de <style> y cada ${…} como TypeScript. No hace falta tocar el tsconfig.json ni elegir la versión de TypeScript: usa la que trae VS Code o la del proyecto.

Solo trabaja en los proyectos que dependen de ascua en su package.json. En los demás, un html`…` de Lit no es suyo y lo deja en paz.

Zed y otros editores

El plugin se instala en el proyecto y se declara en el tsconfig.json:

sh
stil add -D ascua-ts-plugin
json
{
  "compilerOptions": {
    "plugins": [{ "name": "ascua-ts-plugin" }]
  }
}

El editor tiene que usar la versión de TypeScript del proyecto: tsserver busca los plugins junto al TypeScript que ejecuta. Zed lo hace solo; en otros editores, es la opción que elige el TypeScript del espacio de trabajo.

Los colores. Zed colorea como HTML las plantillas con la etiqueta html, pero no las de view, y una extensión de Zed no puede añadirlo. El compilador acepta las dos, así que en Zed puedes escribir html`…` en lugar de view`…`: es lo mismo.

Con qué TypeScript

Con el 5 y el 6, que son los que tienen tsserver. TypeScript 7, el nativo, todavía no admite plugins: un proyecto que compila con él necesita además typescript@6 para el editor. Los colores de VS Code no dependen de eso, y ascua-check sirve con los tres.