Animación HyperFrames
Todo el conocimiento de movimiento en un skill: reglas (recetas atómicas), planos (plantillas de escenas multifásicas), transiciones (de escena a escena), técnicas (patrones generales de diseño de movimiento) y adaptadores (API por tiempo de ejecución).
Para el contrato de composición (atributos de datos, sub-composiciones, determinismo) consulta hyperframes-core.
Por defecto: componer reglas atómicas
Selecciona de 2 a 4 reglas de rules-index.md, únelas con una sola línea de tiempo GSAP en pausa, y listo. Esto es más rápido y genera menos código que empezar desde un plano.
Cargar un plano cuando
- La escena coincide con una plantilla multifásica preexistente (revelación de marca, prueba social, etc.) y reutilizar su canalización de fases ahorra tiempo real de autoría.
- Quieres código verificable y ejecutable para una coreografía compleja de 4-5 fases.
Los planos se encuentran en blueprints-index.md. Cada entrada apunta a blueprints/<id>.md (receta). No lo leas de forma especulativa; cárgalo solo cuando hayas decidido que necesitas orquestación a nivel de escena.
Enrutamiento
| Quieres… | Lee |
|---|---|
| Elegir un patrón de movimiento atómico por disparador/etiqueta | rules-index.md |
| Leer la receta completa de una regla (HTML / CSS / GSAP) | rules/<name>.md |
| Elegir una plantilla de escena multifásica | blueprints-index.md |
| Leer la receta completa de un plano | blueprints/<id>.md |
| Crear una transición de escena (CSS-driven, entre dos clips) | transitions/overview.md, transitions/catalog.md |
| Consultar una técnica general de diseño de movimiento | techniques.md |
| Desenfoque de movimiento: arrastre de obturador en un elemento, y cuándo no usarlo | references/motion-blur.md |
| Analizar el mapa de animación de una composición existente | scripts/animation-map.mjs |
| API GSAP: timeline / tweens / parámetros de posición | adapters/gsap.md |
| GSAP: recetas de efectos precocinados | rules/gsap-effects.md |
| GSAP: transformaciones / rendimiento | adapters/gsap-transforms-and-perf.md |
| GSAP: easing / stagger | adapters/gsap-easing-and-stagger.md |
| GSAP: timeline / etiquetas | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie (exportaciones de After Effects, window.__hfLottie) | adapters/lottie.md |
| Animación de personajes (ciclo de marcha, mascota, títere articulado, gestos) | adapters/lottie.md → Personajes |
Three.js / WebGL (escenas 3D, AnimationMixer, hf-seek) | adapters/three.md |
Anime.js (window.__hfAnime) | adapters/animejs.md |
CSS keyframes (animation-delay / play-state / fill-mode) | adapters/css-animations.md |
Web Animations API (element.animate(), currentTime seek) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, canalizaciones de cómputo) | adapters/typegpu.md |
HTML como textura + post-efectos WebGL/GLSL (capturar DOM vivo mediante drawElementImage) | adapters/html-in-canvas-patterns.md |
Efectos de animación de texto con nombre (24 IDs mediante el skill externo animate-text) | adapters/animate-text.md |
Elegir un tiempo de ejecución
- GSAP es el predeterminado para el 95% del trabajo de movimiento: cubre orquestación de timelines, transformaciones, easing, stagger. Todas las reglas atómicas de este skill están basadas en GSAP.
- Lottie cuando un activo tiene su propia línea de tiempo predefinida (típicamente exportaciones de After Effects), incluidos personajes que caminan, gesticulan o reaccionan.
- Three.js para escenas 3D, movimiento de cámara, visuales basados en shaders.
- Anime.js para tweening ligero cuando GSAP es excesivo.
- CSS para motivos repetitivos simples, decoración, brillo: sin coste de animación JavaScript.
- WAAPI para keyframes nativos del navegador sin dependencia de GSAP.
- TypeGPU / WebGPU para lienzos renderizados por GPU (partículas, vidrio líquido, shaders personalizados).
Varios tiempos de ejecución pueden coexistir en una misma composición. Cada uno registra sus instancias en el global específico del runtime para que HyperFrames pueda buscar en todos ellos en un solo paso.
Restricciones críticas
Requisito previo: hyperframes-core → Reglas no negociables (línea de tiempo única en pausa, data-duration gobierna la duración, sin Math.random / Date.now / performance.now, sin repeat: -1, sin gsap.set al cargar la página en clips de escenas posteriores, sin tweens de display o visibility en bruto, y sin construcción de timelines dentro de async / setTimeout / Promise). GSAP autoAlpha y los conjuntos de visibilidad de duración cero en límites explícitos de la línea de tiempo siguen permitidos por el núcleo. Usa esas excepciones solo en elementos que no sean clips o envoltorios dentro de un clip; el framework es dueño del ciclo de vida de .clip. No repitas el contrato completo aquí.
Adiciones de artesanía de animación sobre el contrato del núcleo:
- Constantes de diseño precalculadas: nunca derives posiciones de
getBoundingClientRect()en el momento del tween. Las mediciones DOM en tiempo de tween se desincronizan porque el renderizador muestrea en paralelo; calcula coordenadas una vez al configurar la composición y reutilízalas. - El movimiento espacial usa solo los alias de transformación de GSAP (
x,y,scale,rotation). La lista permitida del núcleo también permiteopacity/color/backgroundColor/borderRadiuspara tweens de propiedades no espaciales, pero nuncawidth/height/top/leftpara cambios de diseño.
Scripts
node skills/hyperframes-animation/scripts/animation-map.mjs <directorio-de-composición> \
--out <directorio-de-composición>/.hyperframes/anim-map
Lee cada timeline GSAP registrado en window.__timelines, enumera los tweens, muestrea los bounding boxes, calcula indicadores y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia del stagger, advertencias del ciclo de vida) después de la autoría.
animation-map.mjs resuelve los paquetes auxiliares del proyecto actual primero, y luego puede iniciar la versión empaquetada del paquete HyperFrames. Establece HYPERFRAMES_SKILL_PKG_VERSION=<versión> solo cuando ejecutas el skill fuera del instalador empaquetado/CLI y necesitas fijar esa versión de arranque explícitamente.
Véase también
hyperframes-core— estructura de composición, atributos de datos, sub-composiciones, contrato de renderizado deterministahyperframes-creative— paletas, tipografía, narración, planificación de ritmos (dirección creativa no relacionada con animación)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render