Animação HyperFrames
Todo o conhecimento de movimento em uma única skill: regras (receitas atômicas), blueprints (modelos de cenas multifásicas), transições (de cena para cena), técnicas (padrões mais amplos de design de movimento) 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 e 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, etc.) e reutilizar seu pipeline de fases economiza tempo real de autoria
- Você deseja 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 no nível da cena.
Roteamento
| O que você quer... | Leia |
|---|---|
| Escolher um padrão de movimento atômico por gatilho / tag | rules-index.md |
| Ler a receita completa HTML / CSS / GSAP de uma regra | rules/<name>.md |
| Escolher um modelo de cena multifásica | blueprints-index.md |
| Ler a receita completa de um blueprint | blueprints/<id>.md |
| Criar uma transição de cena (orientada por CSS, entre dois clipes) | transitions/overview.md, transitions/catalog.md |
| Consultar uma técnica mais ampla de design de movimento | 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 — easings / 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 |
Keyframes CSS (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 tem sua própria timeline pré-definida (tipicamente exportações do After Effects).
- Three.js para cenas 3D, movimento de câmera, visuais orientados por shaders.
- Anime.js para tweening leve quando GSAP é exagero.
- CSS para motivos repetidos 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 buscar todos 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 repetir aqui.
Acréscimos de artesanato de animação sobre o contrato do core:
- Constantes de layout pré-calculadas — nunca derive posições de
getBoundingClientRect()no momento do tween. Medições do DOM em tempo de 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 mudanças de layout.
Scripts
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Lê cada timeline GSAP registrada em window.__timelines, enumera tweens, amostra bboxes, calcula flags, gera animation-map.json. Use 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-animada)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render