Communitygithub.com

vectojs/vectojs-skills

Habilidades de agente para construir, optimizar, integrar y exportar proyectos VectoJS con Codex, Claude Code, Cursor y GitHub Copilot.

¿Qué es vectojs-skills?

Este skill proporciona un conjunto de herramientas y directrices para desenvolvedores que trabajan con VectoJS en entornos 3D como Three.js, permitiendo la integración de interfaces 2D en texturas 3D. Es compatible con plataformas como Claude Code, Codex, Cursor y GitHub Copilot. El skill detalla el flujo de trabajo de integración, desde la instalación de dependencias hasta la creación de adaptadores y el manejo de eventos de puntero 3D. También incluye advertencias sobre errores comunes, limitaciones en la accesibilidad DOM dentro de texturas y recomendaciones de rendimiento basadas en versiones verificadas de Three.js. Es útil para desarrolladores que buscan incrustar paneles VectoJS en escenas 3D interactivas, optimizando la resolución de texturas y evitando costos de renderizado innecesarios.

Compatible con✓Claude Code✓Codex CLI✓Cursor
npx skills add vectojs/vectojs-skills

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

VectoJS Three

Usa este skill para colocar una interfaz 2D VectoJS en vivo sobre una textura de Three.js y enrutar la entrada del puntero 3D de vuelta a la escena VectoJS.

Flujo de trabajo de integración

  1. Instala @vectojs/core, @vectojs/three, three y @vectojs/ui si usas componentes de UI.
  2. Crea un ThreeAdapter por cada textura de panel VectoJS.
  3. Añade entidades VectoJS a adapter.vectoScene, luego inicia la escena interna.
  4. Añade adapter.mesh o la textura/material del adaptador a la escena Three.js anfitriona.
  5. En el bucle de puntero/rueda del anfitrión, haz raycasting contra el mesh del adaptador y llama a adapter.updateIntersection(...).
  6. Llama a adapter.dispose() al eliminar el panel.

Consulta references/three-recipes.md para ver fragmentos de código.

Restricciones

  • La salida predeterminada es un plano texturizado plano, no renderizado en DOM en 3D.
  • Las pruebas de impacto lógicas de VectoJS siguen siendo 2D incluso cuando el mesh se transforma en el espacio del mundo.
  • La aplicación anfitriona posee la cámara, el renderizador, los controles, la sesión XR, el raycaster y las reglas de oclusión.
  • Las coordenadas UV del raycaster deben mapearse a las dimensiones lógicas (width/height) del adaptador; no uses el tamaño del almacenamiento de respaldo para el diseño.
  • La resolución de la textura afecta la nitidez y el costo de subida. Elige dimensiones según la distancia de visualización.

Errores comunes

ErrorCorrección
Añadir un canvas de adaptador fuera de pantalla al DOMAñade adapter.mesh a Three.js; el canvas respalda la textura.
Olvidar llamar a updateIntersectionEnruta los eventos del raycaster anfitrión al adaptador en cada evento de puntero/rueda.
Despachar por coordenadas de pantallaUsa las coordenadas UV del raycaster a través de ThreeAdapter.
Mantener texturas eliminadas vivasLlama a adapter.dispose() y elimina las referencias del anfitrión.
Esperar accesibilidad DOM completa dentro de XRTrata el panel 3D como textura de canvas; proporciona semántica a nivel de anfitrión donde sea necesario.

Versionado y peculiaridades del backend (verificado en fuente)

  • three ≤ 0.1.3: ThreeRenderer.flush() realizaba un renderizado GL completo, y la Scene se vaciaba alrededor de cada nodo no agrupado; el costo por fotograma crecía O(N²) en número de entidades. three 0.1.4 renderiza una vez por fotograma mediante el hook present(); actualiza antes de perfilar cualquier otra cosa.
  • La entrada nativa dentro de una textura es limitada. El canvas del adaptador está fuera de pantalla, por lo que los elementos de accesibilidad proyectados de la Scene nunca están conectados al documento; updateIntersection recurre al envío de eventos propio de VectoJS. Botones/desplazamiento/rueda funcionan; la edición completa de IME/texto nativa no — mantén la entrada de texto fuera del panel 3D o acepta una entrada simplificada.
  • El ancho de línea de stroke() es efectivamente 1px en la mayoría de plataformas (LineBasicMaterial.linewidth es una limitación conocida de WebGL). Dibuja líneas gruesas como formas rellenas en su lugar.
  • ThreeRenderer.drawImage asigna una textura por llamada por fotograma (se elimina en clear()); reutiliza un canvas de origen cuando sea posible. fillText se almacena en caché desde three 0.1.4 (LRU con clave por fuente|color|texto, 256 entradas) — en ≤ 0.1.3 tenía el mismo costo por llamada, así que prefiere MSDFTextEntity ahí.

Skills relacionados