Animación HyperFrames
Todo el conocimiento de movimiento en un único skill: reglas (recetas atómicas), planos (plantillas de escenas multifase), transiciones (de escena a escena), técnicas (patrones generales de diseño de movimiento) y adaptadores (APIs por tiempo de ejecución).
Para el contrato de composición (atributos de datos, subcomposiciones, determinismo) consulta hyperframes-core.
Por defecto: componer reglas atómicas
Elige de 2 a 4 reglas de rules-index.md, pégalas juntas con una única línea de tiempo pausada de GSAP, listo. Esto es más rápido y produce menos código que empezar desde un plano.
Cargar un plano cuando
- La escena coincide con una plantilla multifase preexistente (brand-reveal, social-proof, etc.) y reutilizar su pipeline de fases ahorra tiempo de autoría real.
- Quieres un código de referencia 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 cuando ya hayas decidido que necesitas una orquestación a nivel de escena.
Enrutamiento
| Si quieres… | Lee |
|---|---|
| Elegir un patrón de movimiento atómico por activador / etiqueta | rules-index.md |
| Leer la receta completa de una regla (HTML / CSS / GSAP) | rules/<name>.md |
| Elegir una plantilla de escena multifase | 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 |
| Analizar el mapa de animación de una composición existente | scripts/animation-map.mjs |
| API de GSAP — línea de tiempo / tweens / parámetros de posición | adapters/gsap.md |
| GSAP — recetas de efectos prefabricadas | rules/gsap-effects.md |
| GSAP — transformaciones / rendimiento | adapters/gsap-transforms-and-perf.md |
| GSAP — easing / stagger | adapters/gsap-easing-and-stagger.md |
| GSAP — línea de tiempo / etiquetas | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie (exportaciones de After Effects, window.__hfLottie) | adapters/lottie.md |
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, pipelines de cómputo) | adapters/typegpu.md |
HTML-como-textura + post-efectos WebGL/GLSL (capturar DOM vivo vía drawElementImage) | adapters/html-in-canvas-patterns.md |
Efectos de animación de texto nombrados (24 IDs vía skill externo animate-text) | adapters/animate-text.md |
Cómo elegir un runtime
- GSAP es el runtime por defecto para el 95% del trabajo de movimiento: cubre orquestación de líneas de tiempo, transformaciones, easing y 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 (normalmente exportaciones de After Effects).
- Three.js para escenas 3D, movimiento de cámara y gráficos basados en shaders.
- Anime.js para interpolaciones ligeras cuando GSAP es excesivo.
- CSS para motivos repetitivos simples, decoración y brillos: sin coste de animación JavaScript.
- WAAPI para keyframes nativos del navegador sin dependencia de GSAP.
- TypeGPU / WebGPU para canvas renderizados por GPU (partículas, vidrio líquido, shaders personalizados).
Varios runtimes pueden coexistir en una misma composición. Cada uno registra sus instancias en el global específico del runtime para que HyperFrames pueda buscarlos a todos en una sola pasada.
Restricciones críticas
Prerrequisito: hyperframes-core → Reglas no negociables (línea de tiempo única pausada, data-duration gobierna la duración, sin Math.random / Date.now / performance.now, sin repeat: -1, sin gsap.set en clips de escenas posteriores, sin animación de display / visibility, sin construir líneas de tiempo dentro de async / setTimeout / Promise). No las repitas aquí.
Adiciones de animación sobre el contrato del core:
- Constantes de layout precalculadas: nunca derivar posiciones de
getBoundingClientRect()en tiempo de tween. Las mediciones del DOM en tiempo de tween se desincronizan porque el renderizador muestrea en paralelo; calcula las coordenadas una vez al configurar la composición y reutilízalas. - El movimiento espacial solo usa alias de transformación de GSAP (
x,y,scale,rotation). La lista blanca del core también permiteopacity/color/backgroundColor/borderRadiuspara tweens de propiedades no espaciales, pero nuncawidth/height/top/leftpara cambios de layout.
Scripts
node skills/hyperframes-animation/scripts/animation-map.mjs <directorio-de-composición> \
--out <directorio-de-composición>/.hyperframes/anim-map
Lee cada línea de tiempo de GSAP registrada en window.__timelines, enumera los tweens, muestrea los bounding boxes, calcula flags y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia del stagger, advertencias de ciclo de vida) después de la autoría.
Véase también
hyperframes-core: estructura de composición, atributos de datos, subcomposiciones, contrato de renderizado determinista.hyperframes-creative: paletas, tipografía, narración, planificación de ritmos (dirección creativa no relacionada con animación).hyperframes-cli:npx hyperframes lint / validate / inspect / preview / render.