Installation du plugin : Avant les commandes de configuration ou de mise à jour, suivez les règles d’exécution du plugin lorsque cette compétence se trouve dans un plugin HyperFrames. Pour une installation autonome, 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ène multiphases), transitions (de scène à scène), techniques (motifs de motion-design généraux) 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. C’est plus rapide et produit moins de code que de partir d’un plan.
Charger un plan lorsque
- La scène correspond à un modèle multiphase préconçu existant (dévoilement de marque, preuve sociale, etc.) et la réutilisation de son pipeline de phases fait gagner du temps de création.
- Vous voulez un code de référence exécutable pour une chorégraphie complexe en 4 à 5 phases.
Les plans se trouvent dans blueprints-index.md. Chaque entrée pointe vers plans/<id>.md (recette). Ne les lisez pas de manière spéculative ; chargez-les 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 modèle de scène multiphase | blueprints-index.md |
| Lire la recette complète d’un plan | plans/<id>.md |
| Créer une transition de scène (CSS, entre deux clips) | transitions/apercu.md, transitions/catalogue.md |
| Consulter une technique de motion-design plus large | techniques.md |
| Flou de mouvement – traînée d’obturateur sur un élément et quand ne pas l’utiliser | references/flou-de-mouvement.md |
| Analyser la carte d’animation d’une composition existante | scripts/carte-animation.mjs |
| API GSAP – timeline / tweens / paramètres de position | adaptateurs/gsap.md |
| GSAP – recettes d’effets prêtes à l’emploi | regles/effets-gsap.md |
| GSAP – transformations / performances | adaptateurs/gsap-transformations-et-perf.md |
| GSAP – easing / stagger | adaptateurs/gsap-easing-et-stagger.md |
| GSAP – timeline / étiquettes | adaptateurs/gsap-timeline-et-etiquettes.md |
Lottie / dotLottie (exports After Effects, window.__hfLottie) | adaptateurs/lottie.md |
| Animation de personnage (cycle de marche, mascotte, marionnette articulée, gestes) | adaptateurs/lottie.md → Personnages |
Three.js / WebGL (scènes 3D, AnimationMixer, hf-seek) | adaptateurs/three.md |
Anime.js (window.__hfAnime) | adaptateurs/animejs.md |
Keyframes CSS (animation-delay / play-state / fill-mode) | adaptateurs/animations-css.md |
Web Animations API (element.animate(), currentTime seek) | adaptateurs/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, pipelines de calcul) | adaptateurs/typegpu.md |
HTML en texture + post-fx WebGL/GLSL (capture DOM en direct via drawElementImage) | adaptateurs/modeles-html-dans-canvas.md |
Effets d’animation de texte nommés (24 ID via la compétence externe animate-text) | adaptateurs/animer-texte.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, les staggers. Toutes les règles atomiques de cette compétence sont basées sur GSAP.
- Lottie lorsqu’un asset a sa propre timeline pré-intégrée (généralement des exports After Effects), y compris pour 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 shader.
- Anime.js pour les tweens légers lorsque GSAP est trop lourd.
- CSS pour des motifs simples et répétés, décorations, scintillement — sans coût JavaScript d’animation.
- WAAPI pour les keyframes natifs 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 le global 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 gère la durée, pas de Math.random / Date.now / performance.now, pas de repeat: -1 sans une data-duration racine finie, pas de gsap.set au chargement de page pour les clips de scène ultérieure, pas de tweens sur display ou visibility brute, et enregistrement de la timeline seulement après qu’elle est entièrement construite, y compris lorsque la construction se déroule dans un callback asynchrone tel que document.fonts.ready). autoAlpha de GSAP et les réglages de visibilité à durée nulle aux limites explicites de la timeline restent autorisés par le noyau. Utilisez ces exceptions uniquement sur des éléments non-clip ou des wrappers à l’intérieur d’un clip ; le framework possède le cycle de vie .clip. Ne répétez pas l’intégralité du contrat ici.
Ajouts spécifiques au travail d’animation en plus du contrat du noyau :
- Constantes de disposition précalculées — ne dérivez 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/carte-animation.mjs <repertoire-composition> \
--out <repertoire-composition>/.hyperframes/carte-anim
Lit chaque timeline GSAP enregistrée sur window.__timelines, énumère les tweens, échantillonne les boîtes englobantes, calcule les indicateurs, génère carte-animation.json. Utilisez-le pour auditer la chorégraphie (zones mortes, cohérence des staggers, avertissements de cycle de vie) après la création.
carte-animation.mjs résout d’abord les packages d’aide depuis le projet actuel, puis peut amorcer la version du package HyperFrames inclus. Définissez HYPERFRAMES_SKILL_PKG_VERSION=<version> uniquement lorsque la compétence est exécutée en dehors de l’installation CLI/compétence 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 temps forts (direction créative non-animation)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render