Three.js (referência oficial para LLM)
Esta skill fornece o pacote oficial de documentação Three.js para LLM, para que o agente possa gerar código three.js moderno correto sem inventar APIs desatualizadas ou baseadas em CDN r128.
Adaptação de stack (este construtor de aplicativos)
Você está em um workspace TanStack Start + React, não em uma página HTML simples:
| Padrão de documentação oficial | Faça isso aqui em vez disso |
|---|---|
<script type="importmap"> + three via CDN | npm install three (+ @types/three se necessário); importe de "three" / "three/addons/…" |
| Bootstrap canvas HTML simples | Prefira @react-three/fiber + drei para integração com jogos/UI (building-games + 3d-libs.md) |
Demonstração standalone de WebGLRenderer | Ok para um módulo de canvas autônomo; instale three via npm para que o build do Vercel o tenha |
| Sempre versão "latest" via CDN | Fixe a versão via package.json para que dev e deploy correspondam |
three não está pré-instalado — adicione-o com npm e mantenha-o em package.json.
Quando carregar o quê
- Jogo / produto 3D interativo → comece com
building-games(loop, controles, orientação, câmera, primeira execução, steer sign). - Integração com R3F / drei / rapier →
building-games/references/3d-libs.md. - API profunda do three, TSL, WebGPU, materiais, carregadores, pós-processamento → carregue
references/llms-full.txt(dump oficial completo desta skill).
Não carregue llms-full.txt para jogos simples em canvas 2D (Pong, tetris, etc.).
Referência completa
Leia sob demanda:
references/llms-full.txt
Fonte: https://threejs.org/docs/llms-full.txt (cópia fixada para uso offline em sandbox).
O conteúdo inclui: imports modernos, WebGLRenderer vs WebGPURenderer, referência completa de TSL, NodeMaterial, carregadores, pós-processamento, compute e tabelas de API.
Padrões rápidos para este produto
- Prefira WebGLRenderer (ou o padrão R3F) a menos que o usuário precise de TSL/WebGPU compute.
- Cap da razão de pixels (
renderer.setPixelRatio(Math.min(devicePixelRatio, 2))ou R3Fdpr={[1,2]}). - Descarte geometrias/materiais/texturas ao desmontar (three não coleta lixo de recursos GPU automaticamente).
- Para jogos: ainda obedeça aos
building-gamesde controle e orientação (self-tests).
Verificação final
- three (e stack R3F se usada) está em
package.jsone os imports resolvem. - Nenhum padrão de script-tag r128 / cdnjs.
- Se TSL/WebGPU for usado: materiais e imports correspondem a
llms-full(node materials,await renderer.init()).