vite-plugin-xu
Um plugin Vite em tempo de compilação que compila um componente de ficheiro único .xu para um verdadeiro módulo ES.
O @xuda/vite-plugin-xu compila componentes de ficheiro único .xu para módulos ES em tempo de compilação, e
recarrega-os a quente em desenvolvimento ao nível de um recarregamento completo do componente.
O @xuda/vite-plugin-xu e o pacote @xuda/compiler de que depende têm ambos "private": true
no seu package.json. Ao contrário do xuda-cli, do create-xuda-cli e do @xuda/core, nenhum dos dois está publicado
no npm ainda. O único consumidor funcional neste repositório, examples/hello, usa-o como dependência
file:: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".
Configuração
O examples/hello é um projeto completo e funcional construído desta forma: um contador, uma montagem condicional e uma
lista com chaves, conduzidos inteiramente por funções simples e por mutação simples sobre um armazenamento reactive(), sem
signals, .value nem camada de datasource visíveis no próprio componente.
O que o plugin é, mecanicamente
Um único hook transform. O load predefinido do Vite já leu o ficheiro, por isso o hook recebe a fonte .xu
como texto, chama o @xuda/compiler e devolve o módulo emitido. Não há resolvedor personalizado
nem módulo virtual: o .xu continua a ser um ficheiro real com um caminho real, o que mantém os rastreios de pilha e o
grafo de HMR honestos.
O enforce: 'pre' é importante: sem ele, o vite:esbuild pode chegar primeiro ao ficheiro e falhar em
<template>, o que parece que o ficheiro está estragado em vez de a ordem do pipeline estar errada. O Vite
acrescenta também ?import às importações que não são JS (e ?t=… num novo pedido de HMR), por isso o plugin retira
isso antes do seu teste de inclusão, ou o ficheiro não é compilado em silêncio e o navegador reporta um erro de sintaxe
num ficheiro que o autor nunca escreveu.
HMR
O nível implementado é o recarregamento completo do componente: ao editar, o módulo volta a executar-se, cada instância montada
desse componente é desmontada e montada de novo a partir do novo módulo, e o estado do componente é reposto. Um
reactive({ count: 0 }) em <script> volta a 0. A preservação do estado não é tentada de propósito,
porque depois de uma edição ao <script> não há forma fiável de saber qual metade do
objeto reativo antigo continua a significar o mesmo.
No modo serve, o plugin acrescenta um rodapé import.meta.hot.accept. O __XUDA_HMR__ é instalado pelo
createApp em @xuda/core na primeira vez que uma aplicação é montada, por isso o plugin nunca injeta uma importação no
código do utilizador. Se nenhuma aplicação montada reclamar o componente atualizado (ninguém o estava a mostrar, ou a página não
arrancou), a atualização recorre a um recarregamento completo da página em vez de não fazer nada em silêncio. Uma
compilação de produção não recebe rodapé de HMR.
Opções
Veja A linguagem .xu para o dialeto baseado em blocos que o xuda-cli compila,
e o aviso aí presente para saber como o dialeto deste compilador difere dele.