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 más amplios de diseño de movimiento) y adaptadores (APIs por runtime).
Para el contrato de composición (atributos de datos, sub-composiciones, determinismo), consulta hyperframes-core.
Por defecto: componer reglas atómicas
Elige de 2 a 4 reglas de rules-index.md, pégalas en una sola línea de tiempo GSAP en pausa y listo. Esto es más rápido y genera menos código que empezar desde un plano.
Carga un plano cuando
- La escena coincide con una plantilla multifase pre-diseñada existente (revelación de marca, prueba social, etc.) y reutilizar su pipeline de fases ahorra tiempo de autoría real.
- Deseas código ejecutable de referencia 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). No lo leas especulativamente; cárgalo solo cuando ya 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 |
| Consultar una técnica más amplia de diseño de movimiento | techniques.md |
| Desenfoque de movimiento: efecto de obturador en un elemento y cuándo no usarlo | references/motion-blur.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 integrados | 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 |
| Animación de personajes (ciclo de caminata, mascota, marioneta articulada, gestos) | adapters/lottie.md → Characters |
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, pipelines de cómputo) | adapters/typegpu.md |
HTML como textura + post-efectos WebGL/GLSL (capturar DOM en vivo con drawElementImage) | adapters/html-in-canvas-patterns.md |
Efectos de animación de texto con nombre (24 IDs a través del skill externo animate-text) | adapters/animate-text.md |
Elegir un runtime
- GSAP es el valor predeterminado para el 95% del trabajo de movimiento: cubre orquestación de timeline, 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 (generalmente exportaciones de After Effects), incluidos personajes que caminan, gesticulan o reaccionan.
- 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 dependencia de GSAP.
- TypeGPU / WebGPU para lienzos renderizados por GPU (partículas, vidrio líquido, shaders personalizados).
Múltiples runtimes pueden coexistir en una misma composición. Cada uno registra sus instancias en el ámbito 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 (línea de tiempo única 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 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 de timeline explícitos siguen permitidos por el núcleo. Usa esas excepciones solo en elementos que no sean clips o en contenedores dentro de un clip; el framework es dueño del ciclo de vida .clip. No reafirmes el contrato completo aquí.
Adiciones de creación de animación sobre el contrato del núcleo:
- Constantes de diseño precalculadas: nunca derives posiciones de
getBoundingClientRect()en el momento de la 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 usa solo alias de transformación de GSAP (
x,y,scale,rotation). La lista blanca 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 <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Lee cada timeline GSAP registrado en window.__timelines, enumera tweens, muestrea bboxes, calcula banderas y genera animation-map.json. Úsalo para auditar coreografía (zonas muertas, consistencia de stagger, advertencias de ciclo de vida) después de la autoría.
animation-map.mjs resuelve paquetes auxiliares del proyecto actual primero, luego puede iniciar la versión empaquetada del paquete HyperFrames. Establece HYPERFRAMES_SKILL_PKG_VERSION=<version> solo cuando ejecutes el skill fuera de la instalación empaquetada de CLI/skill y necesites fijar explícitamente esa versión de inicio.
Ver también
hyperframes-core— estructura de composición, atributos de datos, sub-composiciones, 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 / check / snapshot / preview / render