Instalación de plugins: Antes de los comandos de configuración o frescura, siga las reglas de ejecución de plugins cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización a continuación.
HyperFrames Animación
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 entorno de ejecución).
Para el contrato de composición (atributos de datos, subcomposiciones, determinismo), consulte hyperframes-core.
Predeterminado: componer reglas atómicas
Seleccione de 2 a 4 reglas de rules-index.md, combínelas con una única línea de tiempo pausada de GSAP y listo. Esto es más rápido y produce menos código que comenzar con un plano.
Cargar un plano cuando
- La escena coincide con una plantilla multifase preexistente (revelación de marca, prueba social, etc.) y reutilizar su canalización de fases ahorra tiempo de autoría.
- Desea código ejecutable que sea la verdad fundamental 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 lea de forma especulativa; cárguelo solo cuando ya haya decidido que necesita orquestación a nivel de escena.
Enrutamiento
| Si desea… | Lea |
|---|---|
| Elegir un patrón de movimiento atómico por disparador / etiqueta | rules-index.md |
| Leer la receta completa de una regla (HTML / CSS / GSAP) | 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 (controlada por CSS, entre dos clips) | transitions/overview.md, transitions/catalog.md |
| Buscar una técnica más amplia de diseño de movimiento | techniques.md |
| Desenfoque de movimiento (smear del 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 intercambiables | 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 → 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(), currentTime seek) | 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 mediante 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 entorno de ejecución
- GSAP es el predeterminado para el 95% del trabajo de movimiento — cubre orquestación de timeline, transformaciones, easing, 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 (normalmente exportaciones de After Effects), incluidos personajes que caminan, gesticulan o reaccionan.
- Three.js para escenas 3D, movimiento de cámara, visuales basados en shaders.
- Anime.js para interpolación ligera 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).
Varios entornos de ejecución pueden coexistir en una misma composición. Cada uno registra sus instancias en el ámbito global específico del entorno para que HyperFrames pueda buscar en todos ellos en una sola pasada.
Restricciones críticas
Requisito previo: hyperframes-core → Una línea de tiempo pausada + Reglas no negociables (una única línea de tiempo pausada, data-duration gobierna la duración, sin Math.random / Date.now / performance.now, sin repeat: -1 sin un data-duration raíz finito, sin gsap.set en carga de página para clips de escenas posteriores, sin interpolaciones de display o visibility sin procesar, y registrar la línea de tiempo solo después de que esté completamente construida, incluso cuando la construcción se ejecute dentro de una devolución de llamada asíncrona como document.fonts.ready). El núcleo permite autoAlpha de GSAP y configuraciones de visibilidad de duración cero en límites explícitos de la línea de tiempo. Use 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 repita el contrato completo aquí.
Adiciones de artesanía de animación sobre el contrato del núcleo:
- Constantes de diseño precalculadas — nunca derive posiciones de
getBoundingClientRect()en tiempo de interpolación. Las mediciones DOM en tiempo de interpolación se desincronizan porque el renderizador muestrea en paralelo; calcule las coordenadas una vez en la configuración de la composición y reutilícelas. - 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 <SKILL_DIR>/scripts/animation-map.mjs <composición-dir> \
--out <composición-dir>/.hyperframes/anim-map
Lee cada línea de tiempo de GSAP registrada en window.__timelines, enumera los tweens, muestrea las cajas delimitadoras, calcula banderas y genera animation-map.json. Úselo para auditar la coreografía (zonas muertas, consistencia de stagger, advertencias del 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 del paquete HyperFrames incluido. Establezca HYPERFRAMES_SKILL_PKG_VERSION=<versión> solo cuando ejecute el skill fuera de la CLI/skill de instalación incluida y necesite fijar explícitamente esa versión de inicio.
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 ritmo (dirección creativa no relacionada con animación)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render