Animação HyperFrames
Todo o conhecimento de movimento em uma skill: regras (receitas atômicas), blueprints (modelos de cena multifásica), transições (cena a cena), técnicas (padrões mais amplos de motion design) e adaptadores (APIs por runtime).
Para o contrato de composição (atributos de dados, subcomposições, determinismo), consulte hyperframes-core.
Padrão: compor regras atômicas
Escolha 2 a 4 regras de rules-index.md, junte-as em uma única timeline GSAP pausada, pronto. Isso é mais rápido e gera menos código do que começar com um blueprint.
Carregue um blueprint quando
- A cena corresponder a um modelo multifásico pré-projetado existente (brand-reveal, social-proof etc.) e reutilizar seu pipeline de fases economizar tempo real de autoria.
- Você quiser um código de referência executável para uma coreografia complexa de 4 a 5 fases.
Os blueprints estão em blueprints-index.md. Cada entrada aponta para blueprints/<id>.md (receita). Não leia especulativamente; carregue-o somente quando já tiver decidido que precisa de orquestração em nível de cena.
Roteamento
| Se você quiser… | Leia |
|---|---|
| Escolher um padrão de movimento atômico por gatilho / tag | rules-index.md |
| Ler uma regra completa (HTML / CSS / GSAP) | rules/<nome>.md |
| Escolher um modelo de cena multifásica | blueprints-index.md |
| Ler uma receita completa de blueprint | blueprints/<id>.md |
| Criar uma transição de cena (CSS, entre dois clipes) | transitions/overview.md, transitions/catalog.md |
| Consultar uma técnica mais ampla de motion design | techniques.md |
| Analisar o mapa de animação de uma composição existente | scripts/animation-map.mjs |
| API GSAP — timeline / tweens / parâmetros de posição | adapters/gsap.md |
| GSAP — receitas de efeitos prontas | rules/gsap-effects.md |
| GSAP — transformações / desempenho | adapters/gsap-transforms-and-perf.md |
| GSAP — eases / stagger | adapters/gsap-easing-and-stagger.md |
| GSAP — timeline / labels | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie (exportações do After Effects, window.__hfLottie) | adapters/lottie.md |
Three.js / WebGL (cenas 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 computação) | adapters/typegpu.md |
HTML-como-textura + WebGL/GLSL pós-efeitos (capturar DOM ao vivo via drawElementImage) | adapters/html-in-canvas-patterns.md |
Efeitos de animação de texto nomeados (24 IDs via skill externa animate-text) | adapters/animate-text.md |
Escolhendo um runtime
- GSAP é o padrão para 95% do trabalho de movimento — abrange orquestração de timeline, transformações, easing, stagger. Todas as regras atômicas desta skill são baseadas em GSAP.
- Lottie quando um ativo tem sua própria timeline pré-definida (normalmente exportações do After Effects).
- Three.js para cenas 3D, movimento de câmera, visuais baseados em shaders.
- Anime.js para tweens leves quando GSAP é exagero.
- CSS para motivos simples e repetitivos, decoração, brilho — sem custo de animação em JavaScript.
- WAAPI para keyframes nativos do navegador sem dependência do GSAP.
- TypeGPU / WebGPU para canvases renderizados por GPU (partículas, vidro líquido, shaders personalizados).
Múltiplos runtimes podem coexistir em uma composição. Cada um registra suas instâncias no global específico do runtime para que o HyperFrames possa sincronizar todos eles em uma única passagem.
Restrições Críticas
Pré-requisito: hyperframes-core → Regras Inegociáveis (timeline única pausada, data-duration governa a duração, sem Math.random / Date.now / performance.now, sem repeat: -1, sem gsap.set em clipes de cenas posteriores, sem animação de display / visibility, sem construção de timeline dentro de async / setTimeout / Promise). Não as repita aqui.
Acréscimos de animação sobre o contrato do core:
- Constantes de layout pré-calculadas — nunca derive posições de
getBoundingClientRect()no momento do tween. Medidas de DOM durante o tween dessincronizam porque o renderizador amostra em paralelo; compute as coordenadas uma vez na configuração da composição e reutilize. - Movimento espacial usa apenas aliases de transformação do GSAP (
x,y,scale,rotation). A lista de permissões do core também permiteopacity/color/backgroundColor/borderRadiuspara tweens de propriedades não espaciais — mas nuncawidth/height/top/leftpara mudanças de layout.
Scripts
node skills/hyperframes-animation/scripts/animation-map.mjs <diretório-da-composição> \
--out <diretório-da-composição>/.hyperframes/anim-map
Lê cada timeline GSAP registrada em window.__timelines, enumera tweens, amostra bboxes, calcula flags e gera animation-map.json. Use-o para auditar coreografia (zonas mortas, consistência de stagger, avisos de ciclo de vida) após a autoria.
Veja Também
hyperframes-core— estrutura de composição, atributos de dados, subcomposições, contrato de renderização determinísticahyperframes-creative— paletas, tipografia, narração, planejamento de batidas (direção criativa não relacionada a animação)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render