Animation HyperFrames
Tout le savoir sur le mouvement dans une seule compétence : règles (recettes atomiques), blueprints (gabarits de scènes multi-phases), transitions (de scène à scène), techniques (patrons de motion-design plus larges) et adaptateurs (API par runtime).
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. Cette méthode est plus rapide et produit moins de code que de partir d’un blueprint.
Charger un blueprint quand
- La scène correspond à un gabarit multi-phases préexistant (brand-reveal, social-proof, etc.) et que réutiliser son pipeline de phases fait gagner un temps d’écriture significatif
- Vous voulez un code source exécutable pour une chorégraphie complexe de 4 à 5 phases
Les blueprints se trouvent dans blueprints-index.md. Chaque entrée pointe vers blueprints/<id>.md (recette). Ne les lisez pas par curiosité ; chargez-les uniquement après avoir décidé que vous avez besoin d’une orchestration au niveau de la scène.
Aiguillage
| Pour… | Lisez |
|---|---|
| Choisir un motif de mouvement atomique par déclencheur / étiquette | rules-index.md |
| Lire la recette complète HTML / CSS / GSAP d’une règle | rules/<name>.md |
| Choisir un gabarit de scène multi-phases | blueprints-index.md |
| Lire la recette complète d’un blueprint | blueprints/<id>.md |
| Créer une transition de scène (pilotée par CSS, entre deux clips) | transitions/overview.md, transitions/catalog.md |
| Consulter une technique de motion-design plus large | techniques.md |
| Flou de mouvement – effet de traînée d’obturateur sur un élément, et quand ne pas l’utiliser | references/motion-blur.md |
| Analyser la carte d’animation d’une composition existante | scripts/animation-map.mjs |
| API GSAP – timeline / interpolations / 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 – easing / stagger | adapters/gsap-easing-and-stagger.md |
| GSAP – timeline / libellés | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie (exports After Effects, window.__hfLottie) | adapters/lottie.md |
| Animation de personnages (cycle de marche, mascotte, marionnette articulée, gestes) | adapters/lottie.md → Personnages |
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-en-texture + post-effets WebGL/GLSL (capturer le DOM en direct via drawElementImage) | adapters/html-in-canvas-patterns.md |
Effets de texte animés nommés (24 ID via la compétence externe animate-text) | adapters/animate-text.md |
Choisir un runtime
- GSAP est le runtime par défaut pour 95 % du travail de motion – il couvre l’orchestration de timeline, les transformations, l’easing, le stagger. Toutes les règles atomiques de cette compétence sont basées sur GSAP.
- Lottie quand un actif possède sa propre timeline pré-intégrée (généralement des exports After Effects), y compris les personnages qui marchent, gesticulent ou réagissent.
- Three.js pour les scènes 3D, la caméra animée, les visuels pilotés par shaders.
- Anime.js pour des interpolations légères quand GSAP est excessif.
- CSS pour les motifs simples et répétés, la décoration, les scintillements – sans coût JavaScript d’animation.
- WAAPI pour les keyframes natifs du navigateur sans dépendance à GSAP.
- TypeGPU / WebGPU pour les canvas rendus sur GPU (particules, verre liquide, shaders personnalisés).
Plusieurs runtimes peuvent coexister dans une même composition. Chacun enregistre ses instances sur le global spécifique au runtime afin qu’HyperFrames puisse toutes les rechercher en une seule passe.
Contraintes critiques
Prérequis : hyperframes-core → Règles non négociables (timeline unique en pause, data-duration régit la longueur, pas de Math.random / Date.now / performance.now, pas de repeat: -1, pas de gsap.set au chargement de la page pour les clips de scènes ultérieures, pas d’interpolation sur display ou visibility brute, et pas de construction de timeline dans async / setTimeout / Promise). GSAP autoAlpha et les définitions de visibilité à durée nulle aux limites explicites de la timeline restent autorisés par le cœur. N’utilisez ces exceptions que sur des éléments non-clips ou des wrappers à l’intérieur d’un clip ; le framework possède le cycle de vie de .clip. Ne répétez pas ici l’intégralité du contrat.
Ajouts pour le savoir-faire en animation au-dessus du contrat du cœur :
- Constantes de mise en page pré-calculées – ne dérivez jamais les positions de
getBoundingClientRect()au moment de l’interpolation. Les mesures DOM au moment de l’interpolation 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 transform GSAP (
x,y,scale,rotation). La liste autorisée du cœur permet égalementopacity/color/backgroundColor/borderRadiuspour les interpolations 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 toutes les timelines GSAP enregistrées sur window.__timelines, énumère les interpolations, échantillonne les boîtes englobantes, calcule les indicateurs, et produit animation-map.json. Utilisez-le pour auditer la chorégraphie (zones mortes, cohérence du stagger, avertissements sur le cycle de vie) après la phase d’écriture.
animation-map.mjs résout d’abord les paquets d’aide du projet courant, puis peut amorcer la version groupée du paquet HyperFrames. Définissez HYPERFRAMES_SKILL_PKG_VERSION=<version> uniquement lorsque vous exécutez la compétence en dehors du CLI/installation groupée et que vous devez épingler explicitement cette version d’amorçage.
Voir aussi
hyperframes-core– structure de composition, attributs de données, sous-compositions, contrat de rendu déterministehyperframes-creative– palettes, typographie, narration, planification des beats (direction créative non-animée)hyperframes-cli–npx hyperframes lint / check / snapshot / preview / render