makepad-2.0-splash

Visão geral da skill makepad-2.0-splash

O que a makepad-2.0-splash faz

A skill makepad-2.0-splash é voltada para trabalhar com Makepad 2.0 Splash, a linguagem de scripting de UI em runtime usada dentro de script_mod!{}. Ela ajuda você a gerar ou adaptar código Splash para interfaces interativas, widgets com estado, fluxos de hot reload e apps orientados por Canvas, sem precisar inferir a sintaxe a partir de exemplos espalhados.

Quem deve usar

Use a skill makepad-2.0-splash se você estiver construindo UI em Makepad com Rust e precisar de sintaxe Splash confiável, tratamento de estado, ligação de eventos ou padrões de render/update. Ela é especialmente útil em tarefas de frontend que envolvem comportamento de UI em tempo real, troca de abas, timers, atualização de texto ou shells de app em que o script precisa estar válido já na primeira tentativa.

O que a torna diferente

Ao contrário de um prompt genérico sobre Makepad, esta skill é ancorada nas regras reais de Splash: sintaxe separada por espaços, use mod.prelude.widgets.*, script_mod!{}, mod.state e padrões de interação no estilo on_render/fn tick(). Isso faz a makepad-2.0-splash ser mais útil quando o bloqueio não é o design, e sim acertar a estrutura do script e o modelo de runtime.

Como usar a skill makepad-2.0-splash

Instale e leia na ordem certa

Para instalar makepad-2.0-splash, use o fluxo de instalação de skills do repositório e comece por skills/makepad-2.0-splash/SKILL.md. Depois, leia references/splash-language-reference.md para as regras de sintaxe, references/splash-scripting-patterns.md para padrões de apps em funcionamento e references/canvas-splash-patterns.md se seu app for controlado por Canvas ou por um fluxo POST /splash. Essa ordem leva você mais rápido da instalação ao uso prático de makepad-2.0-splash.

Transforme um objetivo vago em um bom prompt

O melhor resultado de instalação da makepad-2.0-splash vem de dar à skill uma tarefa concreta de UI, e não um pedido genérico como “faça um app Splash”. Entradas fortes nomeiam a árvore de widgets, o estado e o modelo de interação, por exemplo: “Crie uma UI Splash com duas abas, estado de contador, troca de abas e um render de inicialização.” Entradas fracas omitem restrições e obrigam o modelo a adivinhar a estrutura dos widgets, o caminho de atualização e se o código deve usar script_eval!, on_render ou fn tick().

Use os padrões do repositório, não só o título principal

Para o uso da makepad-2.0-splash, foque nos padrões que afetam a correção: defina os bindings let antes de usar, mantenha o estado local e explícito e siga o modelo de runtime em que a interação acontece dentro do Splash, em vez de repostar código repetidamente. Se você estiver gerando código para Canvas, o arquivo canvas-splash-patterns.md é o guia de decisão mais importante, porque explica quando fazer POST uma única vez, como atualizar dados e por que postar em loop quebra o estado dos widgets.

Fluxo prático para obter um resultado melhor

Um bom fluxo de trabalho com a makepad-2.0-splash é: descreva o objetivo da UI, identifique o estado persistente, escolha a origem do evento e então peça código que siga a sintaxe do repositório. Se você precisa de algo que possa colar diretamente no Rust, especifique se a saída deve ser apenas o bloco Splash ou um wrapper completo script_mod!{}. Também diga se você precisa de compatibilidade com hot reload, compatibilidade com Canvas ou um exemplo mínimo, porque essas restrições mudam a estrutura do script gerado.

FAQ da skill makepad-2.0-splash

A makepad-2.0-splash é só para Makepad 2.0?

Sim. Esta skill é focada em Makepad 2.0 Splash, não em fluxos antigos de live_design! nem em scripting genérico de UI. Se a sua base de código ainda depende de macros de UI em tempo de compilação, a skill pode ajudar com conceitos de migração, mas não substitui um plano de migração dedicado.

Preciso saber Splash antes de instalá-la?

Não, mas você precisa saber qual resultado de app quer alcançar. A skill é amigável para iniciantes em tarefas de UI estruturada porque expõe sintaxe e padrões de trabalho, mas pressupõe que você consiga descrever com clareza uma árvore de widgets, uma mudança de estado ou um fluxo de eventos para que a makepad-2.0-splash gere código útil.

Quando ela é uma má escolha?

Não use makepad-2.0-splash se você só precisa de ajuda genérica com Rust, dicas de estilo parecidas com CSS ou um prompt simples de “frontend development” sem contexto de Makepad. Ela também é uma escolha ruim quando a tarefa é mais arquitetural e não gira de fato em torno da sintaxe Splash, do estado em runtime ou das regras de execução via Canvas.

Como ela se compara a um prompt normal?

Um prompt normal pode gerar uma resposta plausível, mas tem mais chance de ignorar restrições específicas do Splash, como sintaxe por whitespace, escopo de widgets ou o modelo de atualização em runtime. A makepad-2.0-splash skill é melhor quando a correção importa mais do que brainstorm, especialmente para código que você pretende executar imediatamente.

Como melhorar a skill makepad-2.0-splash

Informe o modelo de estado que está faltando

O maior salto de qualidade vem de nomear o estado de forma explícita. Em vez de pedir “um dashboard”, forneça campos como selected_tab, elapsed, items ou connected, além de como cada campo muda. Isso permite que a makepad-2.0-splash produza código mais fácil de renderizar, atualizar e depurar.

Especifique os limites da interação

Diga à skill o que deve acontecer na inicialização, no clique, no tick ou na atualização de dados. Muitas falhas acontecem porque a responsabilidade do evento fica ambígua, o que leva a código que renderiza uma vez, mas não atualiza corretamente. Para a makepad-2.0-splash, quanto mais você definir o loop de eventos logo de saída, menos retrabalho terá depois da primeira resposta.

Peça o nível certo de completude

Se você só precisa de um trecho, diga isso. Se precisa de um bloco pronto para colar, peça a estrutura completa de script_mod!{} e mencione se o boilerplate em Rust deve vir incluído. Isso evita saídas parciais que parecem corretas isoladamente, mas não se encaixam no seu projeto.

Itere primeiro na sintaxe, depois no comportamento

Se a primeira versão estiver próxima, mas inválida, corrija os problemas de sintaxe antes de pedir novas funcionalidades. Depois refine layout, estado e fluxo de eventos. Para a makepad-2.0-splash, o ciclo de melhoria mais comum é: corrigir o escopo dos widgets, confirmar o padrão de render/update e então otimizar a estrutura da UI para o seu app real.