Instalación de plugins: Antes de los comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando este skill se encuentre dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización que se muestran a continuación.
Animación HyperFrames
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 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, combínalas 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 desde un plano.
Cargar un plano cuando
- La escena coincide con una plantilla prediseñada de varias fases existente (revelación de marca, prueba social, etc.) y reutilizar su proceso de fases ahorra tiempo de autoría real.
- Deseas un 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 leas de forma especulativa; cárgalo solo cuando ya hayas decidido que necesitas orquestación a nivel de escena.
Enrutamiento
| Si deseas… | Lee |
|---|---|
| Elegir un patrón de movimiento atómico por activador / etiqueta | rules-index.md |
| Leer la receta HTML/CSS/GSAP completa 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 |
| Buscar una técnica de diseño de movimiento más amplia | techniques.md |
| Desenfoque de movimiento: barrido 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 / interpolaciones / parámetros de posición | adapters/gsap.md |
| GSAP: recetas de efectos integrables | rules/gsap-effects.md |
| GSAP: transformaciones / rendimiento | adapters/gsap-transforms-and-perf.md |
| GSAP: easing / 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, 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 a través del 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: cubre orquestación de líneas de tiempo, transformaciones, easing 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 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 interpolaciones ligeras cuando GSAP es excesivo.
- CSS para motivos repetitivos 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 buscar en todos ellos en un solo paso.
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 rige la duración, sin Math.random / Date.now / performance.now, sin repeat: -1 sin una data-duration raíz finita, sin gsap.set al cargar la página en clips de escenas posteriores, sin interpolaciones de display o visibility brutas, 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 los conjuntos de visibilidad de duración cero en límites explícitos de la línea de tiempo siguen permitidos por el núcleo. Usa esas excepciones solo en elementos que no sean clips o en envoltorios dentro de un clip; el framework es dueño del ciclo de vida de .clip. No replantees el contrato completo aquí.
Adiciones de creación de animaciones 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 tiempo de 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 alias de transformación de GSAP (
x,y,scale,rotation). La lista de permitidos 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, muestra los cuadros delimitadores (bboxes), calcula banderas y genera animation-map.json. Úsalo para auditar la coreografía (zonas muertas, consistencia del escalonado, advertencias de 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 del paquete empaquetado de HyperFrames. Establece HYPERFRAMES_SKILL_PKG_VERSION=<version> solo cuando ejecutes el skill fuera del CLI/instalación del skill empaquetado 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 determinista.hyperframes-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