Animación HyperFrames
Todo el conocimiento de movimiento en un solo skill: reglas (recetas atómicas), planos (plantillas de escenas multifase), transiciones (de escena a escena), técnicas (patrones de diseño de movimiento más amplios) y adaptadores (APIs por tiempo de ejecución).
Para el contrato de composición (atributos de datos, subcomposiciones, determinismo), consulta hyperframes-core.
Predeterminado: componer reglas atómicas
Elige de 2 a 4 reglas de rules-index.md, pégalas en una sola línea de tiempo GSAP pausada y 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 (revelación de marca, prueba social, etc.) y reutilizar su canalización de fases ahorra tiempo de autoría.
- Deseas código verificable ejecutable para una coreografía compleja de 4 a 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
| Si deseas… | Lee |
|---|---|
| Elegir un patrón de movimiento atómico por activador / etiqueta | rules-index.md |
| Leer la receta HTML/CSS/GSAP completa de una regla | 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 (impulsada por CSS, entre dos clips) | transitions/overview.md, transitions/catalog.md |
| Buscar una técnica de diseño de movimiento más amplia | techniques.md |
| Analizar el mapa de animación de una composición existente | scripts/animation-map.mjs |
| API GSAP: línea de tiempo / interpolaciones / parámetros de posición | adapters/gsap.md |
| GSAP: recetas de efectos directos | 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 |
Keyframes CSS (animation-delay / play-state / fill-mode) | adapters/css-animations.md |
Web Animations API (element.animate(), búsqueda currentTime) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, canalizaciones de cómputo) | adapters/typegpu.md |
HTML como textura + postefectos WebGL/GLSL (capturar DOM vivo con drawElementImage) | adapters/html-in-canvas-patterns.md |
Efectos de animación de texto con nombre (24 IDs mediante 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 líneas de tiempo, transformaciones, easing y stagger. Todas las reglas atómicas de este skill se basan 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 impulsados por shaders.
- Anime.js para interpolaciones ligeras cuando GSAP es excesivo.
- CSS para motivos simples y repetidos, decoración y destellos (sin costo 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).
Múltiples tiempos de ejecución pueden coexistir en una misma composición. Cada uno registra sus instancias en el global específico del tiempo de ejecución para que HyperFrames pueda buscarlos a todos en una sola pasada.
Restricciones críticas
Prerrequisito: hyperframes-core → Reglas no negociables (una sola línea de tiempo pausada, data-duration gobierna la duración, no usar Math.random / Date.now / performance.now, no repeat: -1, no gsap.set en clips de escenas posteriores, no animar display / visibility, no construir líneas de tiempo dentro de async / setTimeout / Promise). No repetir aquí.
Adiciones de creación de animación sobre el contrato principal:
- Constantes de diseño precalculadas — nunca derivar posiciones de
getBoundingClientRect()en tiempo de interpolación. Las mediciones DOM en tiempo de interpolación 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 permitida del núcleo también permiteopacity/color/backgroundColor/borderRadiuspara interpolaciones de propiedades no espaciales, pero nuncawidth/height/top/leftpara cambios de diseño.
Scripts
node skills/hyperframes-animation/scripts/animation-map.mjs <directorio-de-composicion> \
--out <directorio-de-composicion>/.hyperframes/anim-map
Lee cada línea de tiempo GSAP registrada en window.__timelines, enumera las interpolaciones, muestra los cuadros delimitadores, calcula banderas y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia de stagger, advertencias de ciclo de vida) después de la autoría.
Ver también
hyperframes-core— estructura de composición, atributos de datos, subcomposiciones, 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 / validate / inspect / preview / render