Installation des plugins : Avant les commandes de configuration ou de fraîcheur, suivez les règles d'exécution des plugins lorsque cette compétence se trouve dans un plugin HyperFrames. Pour les installations autonomes, conservez les instructions de mise à jour ci-dessous.
HyperFrames Animation
Toute la connaissance du mouvement en une seule compétence : règles (recettes atomiques), plans (modèles de scènes multi-phases), transitions (de scène à scène), techniques (schémas 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, assemblez-les avec une seule timeline GSAP en pause, et le tour est joué. C'est plus rapide et produit moins de code que de partir d'un plan.
Charger un plan quand
- La scène correspond à un modèle multi-phases préconçu existant (brand-reveal, social-proof, etc.) et réutiliser son pipeline de phases fait gagner du temps de conception
- Vous souhaitez disposer d'un code de référence fiable pour une chorégraphie complexe en 4-5 phases
Les plans se trouvent dans blueprints-index.md. Chaque entrée pointe vers blueprints/<id>.md (recette). Ne le lisez pas par curiosité ; chargez-le lorsque vous avez déjà décidé d'utiliser une orchestration au niveau de la scène.
Routage
| Pour… | Lisez |
|---|---|
| Choisir un motif de mouvement atomique par déclencheur / balise | rules-index.md |
| Lire la recette complète HTML / CSS / GSAP d'une règle | rules/<name>.md |
| Choisir un modèle 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 (CSS, entre deux clips) | transitions/overview.md, transitions/catalog.md |
| Consulter une technique plus large de motion design | techniques.md |
| Flou de mouvement — effet de traînée 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 — timelines / tweens / paramètres de position | adapters/gsap.md |
| GSAP — recettes d'effets prêtes à 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 / labels | 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(), recherche currentTime) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, pipelines de calcul) | adapters/typegpu.md |
HTML-en-texture + post-fx WebGL/GLSL (capture DOM en direct via drawElementImage) | adapters/html-in-canvas-patterns.md |
Effets de texte animés nommés (24 IDs 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 mouvement — il couvre l'orchestration des timelines, les transformations, l'easing, le 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 des exports After Effects), y compris les personnages qui marchent, gesticulent ou réagissent.
- Three.js pour les scènes 3D, le mouvement de caméra, les visuels pilotés par shaders.
- Anime.js pour des tweens légers quand GSAP est superflu.
- CSS pour des motifs simples répétés, de la décoration, des scintillements — aucun coût JavaScript d'animation.
- WAAPI pour les keyframes natives du navigateur sans dépendance GSAP.
- TypeGPU / WebGPU pour les canvas rendus par GPU (particules, verre liquide, shaders personnalisés).
Plusieurs runtimes peuvent coexister dans une même composition. Chacun enregistre ses instances dans la variable globale spécifique au runtime afin qu'HyperFrames puisse toutes les parcourir en une seule passe.
Contraintes critiques
Prérequis : hyperframes-core → Une timeline en pause + Règles non négociables (une seule timeline en pause, data-duration régit la durée, pas de Math.random / Date.now / performance.now, pas de repeat: -1 sans data-duration racine finie, pas de gsap.set au chargement de la page sur les clips des scènes ultérieures, pas de tweens sur display ou visibility bruts, et enregistrez la timeline seulement après qu'elle soit entièrement construite, même si la construction se fait dans un callback asynchrone comme document.fonts.ready). Les autoAlpha de GSAP et les réglages de visibilité sans durée aux limites explicites de la timeline restent autorisés par le noyau. N'utilisez ces exceptions que sur des éléments non-clip ou des wrappers à l'intérieur d'un clip ; le framework gère le cycle de vie des .clip. Ne répétez pas ici l'intégralité du contrat.
Ajouts de conception d'animation par-dessus le contrat du noyau :
- 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 autorisée du noyau permet égalementopacity/color/backgroundColor/borderRadiuspour les tweens de propriétés non spatiales — mais jamaiswidth/height/top/leftpour les changements de disposition.
Scripts
node <SKILL_DIR>/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Lit chaque timeline GSAP enregistrée dans 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.
animation-map.mjs résout d'abord les paquets d'aide du projet courant, puis peut amorcer la version du paquet HyperFrames fourni. Définissez HYPERFRAMES_SKILL_PKG_VERSION=<version> uniquement lorsque vous exécutez la compétence en dehors de l'installation CLI/compétence fournie et que vous devez fixer 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 forts (direction créative non-animation)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render