Communitygithub.com

vectojs/vectojs-skills

Habilidades de agente para construir, otimizar, incorporar e exportar projetos VectoJS com Codex, Claude Code, Cursor e GitHub Copilot.

O que é vectojs-skills?

Este skill capacita agentes de IA (Codex, Claude Code, Cursor, GitHub Copilot) a integrar uma interface VectoJS 2D em uma textura Three.js, roteando a entrada do ponteiro 3D de volta para a cena VectoJS. Ele fornece um fluxo de trabalho completo: instalação dos pacotes necessários, criação de um ThreeAdapter por painel de textura, adição de entidades VectoJS à cena interna, inserção da malha/textura na cena Three.js hospedeira e o roteamento correto de eventos de ponteiro e roda via raycasting UV. O skill documenta limitações importantes — como a saída ser um plano texturizado plano (não DOM renderizado em 3D), a dependência do aplicativo hospedeiro para câmera, renderizador, controles e raycaster, e que a resolução da textura afeta nitidez e custo de upload. Também aborda erros comuns (confundir canvas offscreen com DOM, esquecer updateIntersection, usar coordenadas de tela em vez de UVs) e fornece detalhes verificados sobre versões e backends, como a otimização de renderização do Three.js a partir da versão 0.1.4, as limitações de entrada nativa em texturas (IME/edição de texto não funcionam) e a largura de linha do stroke() ser limitada a 1px.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add vectojs/vectojs-skills

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

VectoJS Three

Use este skill para colocar uma interface VectoJS 2D ao vivo em uma textura Three.js e rotear a entrada do ponteiro 3D de volta para a cena VectoJS.

Fluxo de trabalho de integração

  1. Instale @vectojs/core, @vectojs/three, three e @vectojs/ui se estiver usando componentes de UI.
  2. Crie um ThreeAdapter para cada textura de painel VectoJS.
  3. Adicione entidades VectoJS a adapter.vectoScene e, em seguida, inicie a cena interna.
  4. Adicione adapter.mesh ou a textura/material do adaptador à cena Three.js hospedeira.
  5. No loop de ponteiro/roda do hospedeiro, faça raycasting contra a malha do adaptador e chame adapter.updateIntersection(...).
  6. Chame adapter.dispose() ao remover o painel.

Leia references/three-recipes.md para trechos de código.

Restrições

  • A saída padrão é um plano texturizado plano, não DOM renderizado em 3D.
  • O teste de colisão lógico do VectoJS permanece 2D mesmo quando a malha é transformada no espaço do mundo.
  • O aplicativo hospedeiro possui a câmera, o renderizador, os controles, a sessão XR, o raycaster e as regras de oclusão.
  • Os UVs do raycast devem mapear para width/height lógicos do adaptador; não use o tamanho do backing-store para cálculos de layout.
  • A resolução da textura afeta a nitidez e o custo de upload. Escolha dimensões de acordo com a distância de visualização.

Erros comuns

ErroCorreção
Adicionar um canvas offscreen do adaptador ao DOMAdicione adapter.mesh ao Three.js; o canvas dá suporte à textura.
Esquecer de chamar updateIntersectionRoteie eventos do raycaster do hospedeiro para o adaptador a cada evento de ponteiro/roda.
Despachar por coordenadas de telaUse UVs do raycast por meio de ThreeAdapter.
Manter texturas descartadas ativasChame adapter.dispose() e remova referências do hospedeiro.
Esperar acessibilidade total do DOM dentro de XRTrate o painel 3D como textura de canvas; forneça semânticas de nível de hospedeiro onde necessário.

Peculiaridades de versão e backend (verificadas na fonte)

  • three ≤ 0.1.3: ThreeRenderer.flush() realizava uma renderização GL completa, e a Cena era liberada em torno de cada nó não agrupado — o custo por quadro crescia O(N²) no número de entidades. three 0.1.4 renderiza uma vez por quadro por meio do gancho present(); atualize antes de qualquer outra análise de desempenho.
  • Entrada nativa dentro de uma textura é limitada. O canvas do adaptador está offscreen, portanto os elementos de acessibilidade projetados da Cena nunca são conectados ao documento; updateIntersection recai no despacho de eventos próprio do VectoJS. Botões/hover/roda funcionam; edição de texto nativa completa (IME) não — mantenha a entrada de texto fora do painel 3D ou aceite entrada simplificada.
  • A largura da linha stroke() é efetivamente 1px na maioria das plataformas (LineBasicMaterial.linewidth é uma limitação conhecida do WebGL). Desenhe linhas grossas como formas preenchidas.
  • ThreeRenderer.drawImage aloca uma textura por chamada por quadro (descartada em clear()); reutilize um canvas de origem quando possível. fillText é armazenado em cache desde three 0.1.4 (LRU chaveado por fonte|cor|texto, 256 entradas) — em ≤ 0.1.3 tinha o mesmo custo por chamada, então prefira MSDFTextEntity nessa versão.

Habilidades Relacionadas