Saltar para o conteúdo
Rascunho

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.

Hoje é um pacote de workspace, não uma instalação npm

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

js
// vite.config.js
import { defineConfig } from 'vite';
import xu from '@xuda/vite-plugin-xu';

export default defineConfig({ plugins: [xu()] });
js
// src/main.js
import { createApp } from '@xuda/core';
import App from './App.xu';

createApp(App).mount('#app');

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.