Animación HyperFrames
Todo el conocimiento de movimiento en un solo skill: reglas (recetas atómicas), planos (plantillas de escenas multifase), transiciones (entre escenas), 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.
Predeterminado: componer reglas atómicas
Elige de 2 a 4 reglas de rules-index.md, pégalas con una única 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 prediseñada existente (revelación de marca, prueba social, etc.) y reutilizar su proceso de fases ahorra tiempo de autoría.
- Quieres código verificable para una coreografía compleja de 4 a 5 fases.
Los planos están 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 atómico por desencadenante/etiqueta | rules-index.md |
| Leer la receta completa HTML/CSS/GSAP de una regla | rules/<nombre>.md |
| Elegir una plantilla de escena multifase | blueprints-index.md |
| Leer la receta completa de un plano | blueprints/<id>.md |
| Crear una transición entre escenas (con CSS, entre dos clips) | transitions/overview.md, transitions/catalog.md |
| Buscar 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 / 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: facilidades/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 |
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 mediante el skill externo animate-text) | adapters/animate-text.md |
Elegir un tiempo de ejecución
- GSAP es el predeterminado para el 95% del trabajo de movimiento: abarca orquestación de líneas de tiempo, transformaciones, facilidades y escalonado. Todas las reglas atómicas de este skill están basadas en GSAP.
- Lottie cuando un activo tiene su propia línea de tiempo precargada (normalmente exportaciones de After Effects).
- Three.js para escenas 3D, movimiento de cámara, visuales basados en sombreadores.
- Anime.js para interpolaciones ligeras cuando GSAP es excesivo.
- CSS para motivos simples repetidos, decoración, destellos: sin coste 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, sombreadores personalizados).
Varios tiempos de ejecución pueden coexistir en una misma composición. Cada uno registra sus instancias en el ámbito global específico del runtime para que HyperFrames pueda buscar en todos ellos en una sola pasada.
Restricciones críticas
Requisito previo: hyperframes-core → Reglas no negociables (única 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 líneas de tiempo dentro de async / setTimeout / Promise). No repetir aquí.
Adiciones de creación de animaciones sobre el contrato del núcleo:
- Constantes de diseño precalculadas: nunca derivar posiciones de
getBoundingClientRect()en el momento de la interpolación. Las mediciones del DOM en tiempo de interpolación se desincronizan porque el renderizador muestrea en paralelo; calcula las coordenadas una vez en la configuración de 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 <directorio-de-composición> \
--out <directorio-de-composición>/.hyperframes/anim-map
Lee cada línea de tiempo de GSAP registrada en window.__timelines, enumera las interpolaciones, muestrea los cuadros delimitadores, calcula banderas y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia de escalonado, advertencias de ciclo de vida) después de la autoría.
animation-map.mjs resuelve los paquetes auxiliares desde el proyecto actual primero; luego puede iniciar la versión del paquete HyperFrames incluido. Establece HYPERFRAMES_SKILL_PKG_VERSION=<versión> solo cuando ejecutes el skill fuera de la CLI/instalación del skill incluida y necesites fijar explícitamente esa versión de inicio.
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 ritmo (dirección creativa no relacionada con animación)hyperframes-cli:npx hyperframes lint / validate / inspect / preview / render