Animation HyperFrames
Toutes les connaissances en mouvement dans une seule compétence : règles (recettes atomiques), plans de scène (modèles de scènes multiphases), transitions (de scène à scène), techniques (motifs plus larges de motion design) et adaptateurs (API par moteur d'exécution).
Pour le contrat de composition (attributs de données, sous-compositions, déterminisme), voir hyperframes-core.
Par défaut : composer des règles atomiques
Choisissez 2 à 4 règles dans rules-index.md, assemblez-les avec une seule timeline GSAP en pause, c'est fait. C'est plus rapide et produit moins de code que de partir d'un plan de scène.
Charger un plan de scène quand
- La scène correspond à un modèle multiphase pré-conçu existant (révélation de marque, preuve sociale, etc.) et que la réutilisation de son pipeline de phases fait gagner un temps d'écriture significatif.
- Vous voulez un code de référence exécutable pour une chorégraphie complexe de 4 à 5 phases.
Les plans de scène se trouvent dans blueprints-index.md. Chaque entrée pointe vers blueprints/<id>.md (recette). Ne lisez pas de manière spéculative ; ne le chargez qu'après avoir décidé que vous avez besoin d'une orchestration au niveau de la scène.
Routage
| Pour… | Lisez |
|---|---|
| Choisir un motif de mouvement atomique par déclencheur / tag | rules-index.md |
| Lire la recette HTML / CSS / GSAP complète d'une règle | rules/<nom>.md |
| Choisir un modèle de scène multiphase | blueprints-index.md |
| Lire la recette complète d'un plan de scène | blueprints/<id>.md |
| Créer une transition de scène (par CSS, entre deux clips) | transitions/overview.md, transitions/catalog.md |
| Consulter une technique plus large de motion design | techniques.md |
| Analyser la carte d'animation d'une composition existante | scripts/animation-map.mjs |
| API GSAP — timeline / tweens / paramètres de position | adapters/gsap.md |
| GSAP — recettes d'effets prêts à l'emploi | rules/gsap-effects.md |
| GSAP — transformations / performances | adapters/gsap-transforms-and-perf.md |
| GSAP — easings / stagger | adapters/gsap-easing-and-stagger.md |
| GSAP — timeline / étiquettes | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie (exports After Effects, window.__hfLottie) | adapters/lottie.md |
Three.js / WebGL (scènes 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 calcul) | adapters/typegpu.md |
HTML comme texture + post-fx WebGL/GLSL (capture DOM en direct via drawElementImage) | adapters/html-in-canvas-patterns.md |
Effets d'animation de texte nommés (24 IDs via la compétence animate-text externe) | adapters/animate-text.md |
Choisir un moteur d'exécution
- GSAP est le moteur par défaut pour 95 % du travail de mouvement — couvre l'orchestration des timelines, les transformations, les easings, le stagger. Toutes les règles atomiques de cette compétence sont basées sur GSAP.
- Lottie lorsque un actif a sa propre timeline pré-intégrée (typiquement des exports After Effects).
- Three.js pour les scènes 3D, les mouvements de caméra, les visuels pilotés par shaders.
- Anime.js pour des tweens légers lorsque GSAP est trop lourd.
- CSS pour des motifs simples répétés, de la décoration, des scintillements — aucun coût d'animation JavaScript.
- WAAPI pour des keyframes natifs du navigateur sans dépendre de GSAP.
- TypeGPU / WebGPU pour des canvases rendus sur GPU (particules, verre liquide, shaders personnalisés).
Plusieurs moteurs d'exécution peuvent coexister dans une même composition. Chacun enregistre ses instances sur la variable globale spécifique au moteur afin qu'HyperFrames puisse toutes les parcourir en une seule passe.
Contraintes critiques
Prérequis : hyperframes-core → Règles non négociables (timeline unique en pause, data-duration détermine la durée, pas de Math.random / Date.now / performance.now, pas de repeat: -1, pas de gsap.set sur les clips de scène ultérieurs, pas d'animation de display / visibility, pas de construction de timeline dans async / setTimeout / Promise). Ne les répétez pas ici.
Ajouts pour la création d'animations au-dessus du contrat de base :
- Constantes de mise en page pré-calculées — ne jamais dériver les positions de
getBoundingClientRect()au moment du tween. Les mesures DOM au moment du tween se désynchronisent car le moteur de rendu échantillonne en parallèle ; calculez les coordonnées une fois lors de la configuration de la composition et réutilisez-les. - Le mouvement spatial utilise uniquement les alias de transformation GSAP (
x,y,scale,rotation). La liste autorisée de base permet aussiopacity/color/backgroundColor/borderRadiuspour les tweens de propriétés non spatiales — mais jamaiswidth/height/top/leftpour les changements de mise en page.
Scripts
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Lit chaque timeline GSAP enregistrée sur window.__timelines, énumère les tweens, échantillonne les boîtes englobantes, calcule des indicateurs, et produit animation-map.json. Utilisez-le pour auditer la chorégraphie (zones mortes, cohérence du stagger, avertissements de cycle de vie) après la création.
Voir aussi
hyperframes-core— structure de la composition, attributs de données, sous-compositions, contrat de rendu déterministehyperframes-creative— palettes, typographie, narration, planification des temps forts (direction créative non liée à l'animation)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render