Movimiento 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 (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 sola línea de tiempo de GSAP pausada, 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 prediseñada existente (revelación de marca, prueba social, foco de desplazamiento en página demo, etc.) y reutilizar su canalización de fases ahorra tiempo real de autor.
- Quieres código de referencia ejecutable 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) y examples/<id>.html (muestra ejecutable). No lo leas especulativamente; cárgalo cuando ya hayas decidido que necesitas orquestación a nivel de escena.
Enrutamiento
| Para... | Lee |
|---|---|
| Elegir un patrón de movimiento atómico por disparo/etiqueta | rules-index.md |
| Leer la receta HTML / CSS / GSAP completa 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 + examples/<id>.html |
| Escribir una transición de escena (impulsada por CSS, entre dos clips) | transitions/overview.md, transitions/catalog.md |
| Consultar una técnica de diseño de movimiento más amplia | techniques.md |
| Analizar el mapa de animación de una composición existente | scripts/animation-map.mjs |
| API de GSAP — línea de tiempo / interpolaciones / 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 — suavizado / 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 de CSS (animation-delay / play-state / fill-mode) | adapters/css-animations.md |
API de Web Animations (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 en vivo mediante drawElementImage) | adapters/html-in-canvas-patterns.md |
Efectos de animación de texto con nombre (24 IDs mediante la habilidad animate-text externa) | 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 líneas de tiempo, transformaciones, suavizado, escalonado. Todas las reglas atómicas en 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 sombreadores.
- 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, sombreadores personalizados).
Múltiples tiempos de ejecución pueden coexistir en una composición. Cada uno registra sus instancias en el 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 (línea de tiempo pausada única, 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 display / visibility, sin construcción de línea de tiempo dentro de async / setTimeout / Promise). No repetirlas aquí.
Adiciones de artesanía de animación sobre el contrato principal:
- Constantes de diseño 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 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-motion/scripts/animation-map.mjs <composicion-dir> \
--out <composicion-dir>/.hyperframes/anim-map
Lee cada línea de tiempo de GSAP registrada en window.__timelines, enumera las interpolaciones, muestrea los cuadros delimitadores, calcula banderas, genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia de escalonamiento, advertencias de ciclo de vida) después de la autoría.
Ver también
/hyperframes→core/— estructura de composición, atributos de datos, subcomposiciones, contrato de renderizado determinista/hyperframes-design— paletas, tipografía, planificación de ritmo (dirección creativa no animada)/hyperframes→cli/—npx hyperframes lint / validate / inspect / preview / render