Instalación del plugin: Antes de los comandos de configuración o actualización, siga las reglas de ejecución de plugins cuando esta skill se encuentre dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las siguientes instrucciones de actualización.
Animación HyperFrames
Todo el conocimiento de movimiento en una skill: reglas (recetas atómicas), planos (plantillas de escenas multifase), transiciones (de escena a escena), técnicas (patrones de diseño de movimiento más amplios) y adaptadores (API por entorno de ejecución).
Para el contrato de composición (atributos de datos, subcomposiciones, determinismo), consulte hyperframes-core.
Por defecto: componer reglas atómicas
Elija de 2 a 4 reglas de rules-index.md, combínelas con una sola línea de tiempo de GSAP en pausa. 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 predefinida de varias fases (revelación de marca, prueba social, etc.) y reutilizar su canalización de fase ahorra tiempo de autoría real.
- Desea código de referencia 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 lea de forma especulativa; cárguelo solo cuando ya haya decidido que necesita una orquestación a nivel de escena.
Enrutamiento
| Qué buscar... | Leer |
|---|---|
| Elegir un patrón de movimiento atómico por activador/etiqueta | rules-index.md |
| Leer la receta completa HTML / CSS / GSAP 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 (basada en CSS, entre dos clips) | transitions/overview.md, transitions/catalog.md |
| Consultar una técnica de diseño de movimiento más amplia | 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: línea de tiempo / tweens / parámetros de posición | adapters/gsap.md |
| GSAP: recetas de efectos listas para usar | rules/gsap-effects.md |
| GSAP: transformaciones / rendimiento | adapters/gsap-transforms-and-perf.md |
| GSAP: easings / 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 |
| 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 |
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, 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 skill externa 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 líneas de tiempo, transformaciones, easing y escalonado. Todas las reglas atómicas de esta 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 y visuales basados en shaders.
- Anime.js para interpolaciones ligeras cuando GSAP es excesivo.
- CSS para motivos repetitivos simples, decoración y brillos, sin costo de animación en 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 buscarlos a todos en una sola pasada.
Restricciones críticas
Requisito previo: hyperframes-core → Una línea de tiempo en pausa + Reglas innegociables (una sola línea de tiempo en pausa, data-duration gobierna la duración, no Math.random / Date.now / performance.now, no repeat: -1 sin una duración raíz finita data-duration, no gsap.set al cargar la página en clips de escenas posteriores, no interpolaciones 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). GSAP autoAlpha y conjuntos de visibilidad de duración cero en límites explícitos de la línea de tiempo siguen permitidos por el núcleo. Utilice 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 aquí el contrato completo.
Adiciones de creación de animación sobre el contrato del núcleo:
- Constantes de diseño precalculadas — nunca derive posiciones de
getBoundingClientRect()en el momento de la interpolación. Las mediciones del DOM en ese momento se desincronizan porque el renderizador muestrea en paralelo; calcule las coordenadas una vez durante la configuración de la composición y reutilícelas. - El movimiento espacial utiliza 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 <SKILL_DIR>/scripts/animation-map.mjs <composition-dir> \
--out <composition-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 y genera animation-map.json. Úselo para auditar la coreografía (zonas muertas, consistencia del escalonado, 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. Establezca HYPERFRAMES_SKILL_PKG_VERSION=<version> solo cuando ejecute la skill fuera de la CLI/instalación de la skill empaquetada y necesite 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 determinista.hyperframes-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.