Animação HyperFrames
Todo o conhecimento de movimento em uma skill: regras (receitas atômicas), blueprints (modelos de cena multifásicos), 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 de 2 a 4 regras de rules-index.md, cole-as em uma única timeline GSAP pausada. Pronto. Isso é mais rápido e produz menos código do que começar a partir de um blueprint.
Carregue um blueprint quando
- A cena corresponde a um modelo multifásico pré-projetado existente (revelação de marca, prova social, holofote de rolagem de página de demonstração, etc.) e reutilizar seu pipeline de fases economiza tempo real de autoria.
- Você deseja código executável e fiel à verdade para uma coreografia complexa de 4 a 5 fases.
Os blueprints residem em blueprints-index.md. Cada entrada aponta para blueprints/<id>.md (receita) e examples/<id>.html (exemplo executável). Não leia especulativamente; carregue quando já tiver decidido que precisa de orquestração em nível de cena.
Roteamento
| Se você deseja… | Leia |
|---|---|
| Selecionar um padrão de movimento atômico por gatilho / tag | rules-index.md |
| Ler a receita completa em HTML / CSS / GSAP de uma regra | rules/<nome>.md |
| Selecionar um modelo de cena multifásico | blueprints-index.md |
| Ler a receita completa de um blueprint | blueprints/<id>.md + examples/<id>.html |
| Criar uma transição de cena (orientada a 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 prontos para uso | 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 / rótulos | 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 + pós-efeitos WebGL/GLSL (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 — cobre orquestração de timeline, transformações, easing, stagger. Todas as regras atômicas nesta skill são baseadas em GSAP.
- Lottie quando um ativo possui sua própria timeline pré-definida (normalmente exportações do After Effects).
- Three.js para cenas 3D, movimento de câmera, visuais orientados por shader.
- Anime.js para tweening leve quando GSAP é exagero.
- CSS para motivos repetitivos simples, decoração, brilho — sem custo de animação JavaScript.
- WAAPI para keyframes nativos do navegador sem dependência de 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 fazer seek em todas elas em uma única passada.
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 além do contrato principal:
- Constantes de layout pré-calculadas — nunca derive posições de
getBoundingClientRect()no momento do tween. Medições de DOM no momento do tween dessincronizam porque o renderizador amostra em paralelo; calcule 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 alterações de layout.
Scripts
node skills/hyperframes-animation/scripts/animation-map.mjs <diretorio-da-composicao> \
--out <diretorio-da-composicao>/.hyperframes/anim-map
Lê cada timeline GSAP registrada em window.__timelines, enumera tweens, amostra bboxes, calcula flags e gera animation-map.json. Use para auditar a 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 à animação)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render