HyperFrames Animation
Toute la connaissance du mouvement dans une seule compétence : règles (recettes atomiques), blueprints (gabarits de scène multiphases), transitions (de scène à scène), techniques (motifs plus larges de motion-design) 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, collez-les ensemble sur une seule timeline GSAP en pause, c'est fait. C'est plus rapide et produit moins de code que de partir d'un blueprint.
Charger un blueprint lorsque
- La scène correspond à un gabarit multiphase existant prédéfini (brand-reveal, social-proof, etc.) et réutiliser son pipeline de phases fait gagner du temps de conception.
- Vous voulez du code exécutable de vérité terrain pour une chorégraphie complexe en 4-5 phases.
Les blueprints se trouvent dans blueprints-index.md. Chaque entrée pointe vers blueprints/<id>.md (recette). Ne les lisez pas spéculativement ; chargez-les seulement lorsque vous avez déjà décidé d'avoir besoin d'une orchestration au niveau de la scène.
Routage
| Vous voulez… | Lisez |
|---|---|
| Choisir un motif de mouvement atomique par déclencheur / étiquette | rules-index.md |
| Lire la recette HTML/CSS/GSAP complète d'une règle | rules/<nom>.md |
| Choisir un gabarit de scène multiphase | 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 |
| Chercher 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 / performance | 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 (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 en texture + post-fx WebGL/GLSL (capture DOM live via drawElementImage) | adapters/html-in-canvas-patterns.md |
Effets nommés d'animation de texte (24 IDs via compétence externe animate-text) | adapters/animate-text.md |
Choisir un runtime
- GSAP est le runtime par défaut pour 95 % du travail de mouvement — couvre l'orchestration des timelines, transformations, easing, stagger. Toutes les règles atomiques de cette compétence sont basées sur GSAP.
- Lottie lorsqu'un actif possède sa propre timeline pré-intégrée (généralement exports After Effects).
- Three.js pour les scènes 3D, mouvements de caméra, visuels pilotés par shaders.
- Anime.js pour des transitions légères quand GSAP est excessif.
- CSS pour des motifs simples et répétés, décoration, scintillement — aucun coût d'animation JavaScript.
- WAAPI pour les keyframes natifs du navigateur sans dépendance GSAP.
- TypeGPU / WebGPU pour les canevas rendus par GPU (particules, verre liquide, shaders personnalisés).
Plusieurs runtimes peuvent coexister dans une même composition. Chacun enregistre ses instances sur la variable globale propre au runtime, de sorte qu'HyperFrames puisse les parcourir toutes en une seule passe.
Contraintes critiques
Prérequis : hyperframes-core → Règles non négociables (timeline unique en pause, data-duration régit la durée, pas de Math.random / Date.now / performance.now, pas de repeat: -1, pas de gsap.set sur les clips des scènes ultérieures, pas d'animation sur display / visibility, pas de construction de timeline à l'intérieur de async / setTimeout / Promise). Ne pas les répéter ici.
Ajouts propres au travail d'animation par-dessus le contrat central :
- 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 du noyau permet égalementopacity/color/backgroundColor/borderRadiuspour les 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 <dossier-composition> \
--out <dossier-composition>/.hyperframes/anim-map
Lit chaque timeline GSAP enregistrée sur window.__timelines, énumère les tweens, échantillonne les boîtes englobantes, calcule des indicateurs, 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 composition, attributs de données, sous-compositions, contrat de rendu déterministehyperframes-creative— palettes, typographie, narration, planification des beats (direction créative non-animation)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render