Animation HyperFrames
Tout le savoir-faire en motion dans un seul skill : règles (recettes atomiques), plans (gabarits de scène multi-phases), transitions (de scène à scène), techniques (motifs de motion design élargis) 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 avec 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.
Charger un plan lorsque
- La scène correspond à un gabarit multi-phases pré-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 se trouvent dans blueprints-index.md. Chaque entrée pointe vers blueprints/<id>.md (recette). Ne les lisez pas de manière spéculative ; chargez-les seulement lorsque vous avez décidé qu'une orchestration au niveau de la scène est nécessaire.
Routage
| Vous voulez… | 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/<name>.md |
| Choisir un gabarit de scène multi-phases | blueprints-index.md |
| Lire la recette complète d'un plan | blueprints/<id>.md |
| Créer une transition de scène (pilotée par CSS, entre deux clips) | transitions/overview.md, transitions/catalog.md |
| Rechercher une technique de motion design élargie | 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êtes à l'emploi | rules/gsap-effects.md |
| GSAP — transformations / perf | adapters/gsap-transforms-and-perf.md |
| GSAP — easing / stagger | adapters/gsap-easing-and-stagger.md |
| GSAP — timeline / labels | 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 live via drawElementImage) | adapters/html-in-canvas-patterns.md |
Effets d'animation textuelle nommés (24 IDs via le skill externe animate-text) | adapters/animate-text.md |
Choix d'un moteur d'exécution
- GSAP est le moteur par défaut pour 95 % du travail de motion — il couvre l'orchestration des timelines, les transformations, l'easing, le stagger. Toutes les règles atomiques de ce skill sont basées sur GSAP.
- Lottie lorsque un actif a sa propre timeline pré-intégrée (généralement des exports After Effects).
- Three.js pour les scènes 3D, le mouvement de caméra, les visuels pilotés par shaders.
- Anime.js pour un tweening léger lorsque GSAP est trop lourd.
- CSS pour des motifs simples et répétés, de la décoration, des scintillements — sans coût d'animation JavaScript.
- WAAPI pour les keyframes natives du navigateur sans dépendance à GSAP.
- TypeGPU / WebGPU pour les canvass rendus par GPU (particules, verre liquide, shaders personnalisés).
Plusieurs moteurs peuvent coexister dans une même composition. Chacun enregistre ses instances sur le global spécifique au moteur, ce qui permet à HyperFrames de tous les parcourir en une seule passe.
Contraintes critiques
Prérequis : hyperframes-core → Règles non négociables (timeline unique en pause, data-duration gouverne la durée, pas de Math.random / Date.now / performance.now, pas de repeat: -1, pas de gsap.set sur les clips de scènes ultérieures, pas d'animation display / visibility, pas de construction de timeline à l'intérieur de async / setTimeout / Promise). Ne les répétez pas ici.
Ajouts pour le travail d'animation par-dessus le contrat de base :
- Constantes de mise en page pré-calculées — ne déduisez jamais 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 blanche de base autorise égalementopacity/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, génère 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 création.
animation-map.mjs résout d'abord les packages d'aide depuis le projet actuel, puis peut amorcer la version du package HyperFrames intégré. Définissez HYPERFRAMES_SKILL_PKG_VERSION=<version> uniquement lorsque vous exécutez le skill en dehors de l'installation CLI/skill intégré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 temps (direction créative non liée à l'animation)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render