Animación HyperFrames
Todo el conocimiento de movimiento en una sola habilidad: 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 (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 juntas con una sola línea de tiempo de GSAP en pausa, listo. Esto es más rápido y produce menos código que comenzar desde un plano.
Cargar un plano cuando
- La escena coincide con una plantilla multifásica predefinida existente (brand-reveal, social-proof, etc.) y reutilizar su canalización de fases ahorra tiempo real de autoría
- Deseas código de verdad 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 ya hayas decidido que necesitas orquestación a nivel de escena.
Enrutamiento
| Quieres… | Lee |
|---|---|
| Elegir un patrón de movimiento atómico por desencadenante / etiqueta | rules-index.md |
| Leer la receta completa HTML / CSS / GSAP de una regla | rules/<name>.md |
| Elegir una plantilla de escena multifásica | blueprints-index.md |
| Leer la receta completa de un plano | blueprints/<id>.md |
| Escribir 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 / escalonamiento | 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, títere articulado, gestos) | adapters/lottie.md → Personajes |
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(), búsqueda currentTime) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, canalizaciones 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 mediante la habilidad 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 timelines, transformaciones, easing, escalonamiento. Todas las reglas atómicas de esta habilidad se basan en GSAP.
- Lottie cuando un activo tiene su propia línea de tiempo predefinida (normalmente 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 tiempos de ejecución pueden coexistir 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 buscarlos a todos en una sola pasada.
Restricciones críticas
Prerrequisito: 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 sin procesar, y sin construcción de timeline dentro de async / setTimeout / Promise). Siguen permitidos por el núcleo autoAlpha de GSAP y los conjuntos de visibilidad de duración cero en límites explícitos de timeline. Usa esas excepciones solo en elementos que no sean clips o envoltorios dentro de un clip; el framework posee el 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 diseño precalculadas — nunca derives 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 los 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 <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Lee cada timeline de GSAP registrado en window.__timelines, enumera interpolaciones, muestrea los cuadros delimitadores, calcula indicadores y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia del escalonamiento, advertencias del ciclo de vida) después de la autoría.
animation-map.mjs resuelve los 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 la habilidad fuera de la instalación empaquetada de CLI/skill y necesites fijar esa versión de inicio explícitamente.
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 la animación)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render