Animación con HyperFrames
Todo el conocimiento de movimiento en una sola habilidad: reglas (recetas atómicas), planos (plantillas de escenas multifase), transiciones (de escena a escena), técnicas (patrones más amplios de diseño de movimiento) y adaptadores (API por entorno 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 en una única línea de tiempo de GSAP en pausa, 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 prediseñada multifase existente (presentación de marca, prueba social, foco de desplazamiento en página de demostración, etc.) y reutilizar su flujo de fases ahorra tiempo de creación.
- Deseas código verificable y 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) y examples/<id>.html (ejemplo ejecutable). No los leas de forma especulativa; cárgalos solo cuando ya hayas decidido que necesitas orquestación a nivel de escena.
Enrutamiento
| Si 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 multifase | blueprints-index.md |
| Leer la receta completa de un plano | blueprints/<id>.md + examples/<id>.html |
| Crear una transición de escena (impulsada por 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: timeline / tweens / 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: timeline / 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 con currentTime) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, tuberías de cómputo) | adapters/typegpu.md |
HTML como textura + postefectos WebGL/GLSL (capturar DOM en vivo con drawElementImage) | adapters/html-in-canvas-patterns.md |
Efectos de animación de texto con nombre (24 ID mediante la habilidad externa animate-text) | adapters/animate-text.md |
Elegir un entorno 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 esta habilidad 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, visuales impulsados por shaders.
- Anime.js para interpolaciones ligeras cuando GSAP es excesivo.
- CSS para motivos repetidos simples, decoración, brillo: sin costo de animación JavaScript.
- WAAPI para keyframes nativos del navegador sin depender de GSAP.
- TypeGPU / WebGPU para lienzos renderizados por GPU (partículas, vidrio líquido, shaders personalizados).
Múltiples entornos de ejecución pueden coexistir en una misma composición. Cada uno registra sus instancias en el ámbito global específico del entorno para que HyperFrames pueda buscar en todas ellas en una sola pasada.
Restricciones críticas
Requisito previo: hyperframes-core → Reglas no negociables (una sola línea de tiempo en pausa, 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 construcción de timeline dentro de async / setTimeout / Promise). No repetir aquí.
Adiciones de diseño de animación sobre el contrato base:
- Constantes de layout precalculadas: nunca derivar posiciones de
getBoundingClientRect()en tiempo de interpolación. Las mediciones del 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 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 layout.
Scripts
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Lee cada línea de tiempo de GSAP registrada en window.__timelines, enumera los tweens, muestrea las cajas delimitadoras, 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 crear la animación.
Ver también
hyperframes-core: estructura de composición, atributos de datos, subcomposiciones, contrato de render determinista.hyperframes-creative: paletas, tipografía, narración, planificación de tiempos (dirección creativa no relacionada con animación).hyperframes-cli:npx hyperframes lint / validate / inspect / preview / render.