Animación HyperFrames
Todo el conocimiento de motion en un solo skill: reglas (recetas atómicas), planos (plantillas de escenas multifase), transiciones (de escena a escena), técnicas (patrones generales de motion design) 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 2-4 reglas de rules-index.md, pégalas en una sola línea de tiempo de GSAP en pausa, 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 predefinida (revelación de marca, prueba social, etc.) y reutilizar su pipeline de fases ahorra tiempo de autoría real.
- Quieres código ejecutable de verdad para una coreografía compleja de 4-5 fases.
Los planos están en blueprints-index.md. Cada entrada apunta a blueprints/<id>.md (receta). No lo leas especulativamente; cárgalo solo cuando ya hayas decidido que necesitas orquestación a nivel de escena.
Enrutamiento
| Si quieres… | Lee |
|---|---|
| Elegir un patrón de motion atómico por disparador/etiqueta | rules-index.md |
| Leer la receta completa HTML/CSS/GSAP 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 (con CSS, entre dos clips) | transitions/overview.md, transitions/catalog.md |
| Buscar una técnica general de motion design | 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 plug-and-play | 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 |
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-fx 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 motion — cubre orquestación de timelines, transformaciones, easing, 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 (típicamente exportaciones de After Effects).
- Three.js para escenas 3D, movimiento de cámara, visuales basadas en shaders.
- Anime.js para interpolación ligera cuando GSAP es excesivo.
- CSS para motivos simples repetidos, decoración, brillo — 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).
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 buscarlos a todos 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 al cargar la página en clips de escenas posteriores, sin interpolaciones de display o visibility en bruto, y sin construcción de timeline dentro de async / setTimeout / Promise). GSAP autoAlpha y configuraciones de visibilidad de duración cero en límites explícitos del timeline siguen permitidos por el núcleo. Usa esas excepciones solo en elementos que no sean clips o en envoltorios dentro de un clip; el framework es dueño del ciclo de vida de .clip. No reiteres el contrato completo aquí.
Adiciones de artesanía de animación sobre el contrato del núcleo:
- Constantes de layout precalculadas — nunca derives 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 los alias de transformación de GSAP (
x,y,scale,rotation). La lista de permitidos 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 <directorio-de-composicion> \
--out <directorio-de-composicion>/.hyperframes/anim-map
Lee cada timeline de GSAP registrado en window.__timelines, enumera los tweens, muestrea los bounding boxes, 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.
animation-map.mjs primero resuelve los paquetes auxiliares del proyecto actual, luego puede iniciar la versión empaquetada del paquete HyperFrames. Establece HYPERFRAMES_SKILL_PKG_VERSION=<version> solo cuando ejecutas el skill fuera del CLI empaquetado / instalación del skill y necesitas fijar esa versión de inicio explícitamente.
Véase 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 beats (dirección creativa no animada)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render