Animation HyperFrames
Toutes les connaissances sur le mouvement en une seule compétence : règles (recettes atomiques), blueprints (modèles de scènes multi-phases), transitions (de scène à scène), techniques (modèles 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.
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 blueprint.
Charger un blueprint quand
- La scène correspond à un modèle multi-phase pré-existant (brand-reveal, social-proof, etc.) et réutiliser son pipeline de phases fait gagner du temps de création
- Vous voulez un code source exécutable 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 le lisez pas par spéculation ; chargez-le lorsque vous avez déjà décidé que vous avez 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 complète HTML / CSS / GSAP d'une règle | rules/<nom>.md |
| Choisir un modèle 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 |
| Rechercher une technique plus large de motion design | techniques.md |
| Flou de mouvement — 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 / tweens / 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 — 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 personnage (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 |
CSS keyframes (animation-delay / play-state / fill-mode) | adapters/css-animations.md |
Web Animations API (element.animate(), seek 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 d'animation de texte 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 d'animation — 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 a 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 un tweening léger quand GSAP est trop lourd.
- CSS pour des motifs répétés simples, de la décoration, du 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 sur le global spécifique au runtime afin qu'HyperFrames puisse toutes les chercher en une seule passe.
Contraintes critiques
Prérequis : hyperframes-core → Règles non négociables (timeline en pause unique, data-duration gouverne la durée, pas de Math.random / Date.now / performance.now, pas de repeat: -1, pas de gsap.set au chargement de la page sur les clips de scènes ultérieures, pas de tweens display ou de visibility brute, et pas de construction de timeline à l'intérieur d'async / setTimeout / Promise). Les autoAlpha de GSAP et les réglages de visibilité à durée nulle aux limites explicites de timeline restent autorisés par le core. 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 .clip. Ne reformulez pas l'intégralité du contrat ici.
Ajouts de la compétence animation par-dessus le contrat du core :
- 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 à la mise en place de la composition et réutilisez-les. - Le mouvement spatial n'utilise que les alias de transformation GSAP (
x,y,scale,rotation). La liste autorisée du core permet aussiopacity/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 bounding boxes, calcule les indicateurs, et génère 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 packages d'aide du projet courant, puis peut amorcer la version groupée du package HyperFrames. Définissez HYPERFRAMES_SKILL_PKG_VERSION=<version> uniquement lorsque vous exécutez la compétence en dehors de l'installation groupée du CLI/de la compétence et que vous avez besoin de figer 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 du rythme (direction créative non-animation)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render