Animación HyperFrames
Todo el conocimiento de movimiento en una sola skill: reglas (recetas atómicas), planos (plantillas de escenas multifásicas), transiciones (de escena a escena), técnicas (patrones más amplios de diseño de movimiento) y adaptadores (API 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 de GSAP pausada, 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 multifásica prediseñada existente (revelación de marca, prueba social, foco de desplazamiento de página de demostración, etc.) y reutilizar su canalización de fases ahorra tiempo real de autoría.
- Quieres código fuente ejecutable para una coreografía compleja de 4 a 5 fases.
Los planos viven en blueprints-index.md. Cada entrada apunta a blueprints/<id>.md (receta) y examples/<id>.html (ejemplo ejecutable). No lo leas de forma especulativa; cárgalo solo cuando ya hayas decidido que necesitas orquestación a nivel de escena.
Enrutamiento
| 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 multifásica | blueprints-index.md |
| Leer la receta completa de un plano | blueprints/<id>.md + examples/<id>.html |
| Crear una transición de escena (mediante CSS, entre dos clips) | transitions/overview.md, transitions/catalog.md |
| Consultar una técnica más amplia 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 / interpolaciones / parámetros de posición | adapters/gsap.md |
| GSAP — recetas de efectos de inserción directa | rules/gsap-effects.md |
| GSAP — transformaciones / rendimiento | adapters/gsap-transforms-and-perf.md |
| GSAP — suavizados / escalonado | 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 |
Fotogramas clave CSS (animation-delay / play-state / fill-mode) | adapters/css-animations.md |
API de Animaciones Web (element.animate(), búsqueda con currentTime) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, canalizaciones de cómputo) | adapters/typegpu.md |
HTML como textura + posprocesamiento WebGL/GLSL (capturar DOM en vivo con drawElementImage) | adapters/html-in-canvas-patterns.md |
Efectos de animación de texto con nombre (24 IDs mediante la skill externa 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, suavizados, escalonado. Todas las reglas atómicas de esta skill se basan en GSAP.
- Lottie cuando un activo tiene su propia línea de tiempo precocinada (normalmente exportaciones de After Effects).
- Three.js para escenas 3D, movimiento de cámara, imágenes impulsadas por shaders.
- Anime.js para interpolación ligera cuando GSAP es excesivo.
- CSS para motivos repetidos simples, decoración, brillo — sin costo de animación en JavaScript.
- WAAPI para fotogramas clave nativos del navegador sin depender de GSAP.
- TypeGPU / WebGPU para lienzos renderizados por GPU (partículas, vidrio líquido, shaders personalizados).
Se puede usar múltiples tiempos de ejecución en una misma composición. Cada uno registra sus instancias en el ámbito global específico del tiempo de ejecución para que HyperFrames pueda buscar en todos ellos en una sola pasada.
Restricciones críticas
Requisito previo: hyperframes-core → Reglas no negociables (una única línea de tiempo 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 animar display / visibility, sin construcción de líneas de tiempo dentro de async / setTimeout / Promise). No repetir aquí.
Adiciones de creación de animaciones además del contrato principal:
- Constantes de diseño precalculadas — nunca derivar posiciones de
getBoundingClientRect()en el momento de la interpolación. Las mediciones del DOM en el momento de la 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 usa solo 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-composicion> \
--out <directorio-composicion>/.hyperframes/anim-map
Lee cada línea de tiempo de GSAP registrada en window.__timelines, enumera las interpolaciones, muestrea las cajas delimitadoras, calcula banderas y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia de escalonado, advertencias del 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 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.