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:yref. Con el valor ya puesto: comillas para un atributo,${}para un evento; - ir a la definición desde
<Tarjetahasta 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
code --install-extension ascua-vscode-0.1.0.vsixO 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:
stil add -D ascua-ts-plugin{
"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.