HyperFrames Animation
Das gesamte Bewegungs- und Animationswissen in einem Skill: Regeln (atomare Rezepte), Vorlagen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (pro Laufzeit-API).
Für den Kompositionsvertrag (Datenattribute, Sub-Kompositionen, Deterministisches Verhalten) siehe hyperframes-core.
Standard: Atomare Regeln kombinieren
Wähle 2-4 Regeln aus rules-index.md, verbinde sie mit einer einzigen pausierten GSAP-Timeline – fertig. Dies ist schneller und produziert weniger Code als der Einsatz einer Vorlage.
Vorlage laden, wenn
- Die Szene einer vorhandenen, vorgefertigten mehrphasigen Vorlage entspricht (Markenenthüllung, Social Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline tatsächlich Autorenzeit spart
- Du ausführbaren Ground-Truth-Code für eine komplexe Choreografie mit 4-5 Phasen benötigst
Vorlagen befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lies sie nicht spekulativ; lade sie erst, wenn du bereits entschieden hast, dass eine Szenen-Orchestrierung nötig ist.
Routingtabelle
| Gewünschte Aktion… | Lese |
|---|---|
| Ein atomares Bewegungsmuster nach Auslöser / Tag auswählen | rules-index.md |
| Das vollständige HTML/CSS/GSAP-Rezept einer Regel lesen | rules/<name>.md |
| Eine mehrphasige Szenenvorlage auswählen | blueprints-index.md |
| Das vollständige Rezept einer Vorlage lesen | blueprints/<id>.md |
| Einen Szenenübergang entwerfen (CSS-getrieben, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Eine allgemeinere Motion-Design-Technik nachschlagen | techniques.md |
| Die Animationskarte einer bestehenden Komposition analysieren | scripts/animation-map.mjs |
| GSAP-API – Timeline / Tweens / Positionsparameter | adapters/gsap.md |
| GSAP – Fertige Effektrezepte | rules/gsap-effects.md |
| GSAP – Transformationen / 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 (After Effects Exporte, window.__hfLottie) | adapters/lottie.md |
Three.js / WebGL (3D-Szenen, 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(), currentTime seek) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, Compute-Pipelines) | adapters/typegpu.md |
HTML-als-Textur + WebGL/GLSL-Post-FX (Live-DOM via drawElementImage erfassen) | adapters/html-in-canvas-patterns.md |
Benannte Textanimationseffekte (24 IDs über externen animate-text-Skill) | adapters/animate-text.md |
Auswahl der Laufzeitumgebung
- GSAP ist der Standard für 95% der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easing und Stagger ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie wenn ein Asset eine eigene vorgefertigte Timeline hat (in der Regel After Effects Exporte).
- Three.js für 3D-Szenen, Kamerabewegungen, shader-basierte Grafiken.
- Anime.js für leichtes Tweening, wenn GSAP zu viel ist.
- CSS für einfache, sich wiederholende Motive, Dekoration, Schimmer – keine JavaScript-Animationskosten.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Canvaselemente (Partikel, flüssiges Glas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition koexistieren. Jede registriert ihre Instanzen im laufzeitspezifischen globalen Objekt, sodass HyperFrames alle in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Nicht verhandelbare Regeln (Einzige pausierte Timeline, data-duration bestimmt die Länge, kein Math.random / Date.now / performance.now, kein repeat: -1, kein gsap.set auf späteren Szenen-Clips, keine Animation von display / visibility, keine Timeline-Konstruktion innerhalb von async / setTimeout / Promise). Wiederhole diese hier nicht.
Zusätzliche Regeln für die Animationserstellung, die über den Vertrag des Kerns hinausgehen:
- Vorberechnete Layout-Konstanten – leite Positionen niemals zur Tween-Zeit aus
getBoundingClientRect()ab. DOM-Messungen zur Tween-Zeit desynchronisieren, da der Renderer parallel abtastet; berechne Koordinaten einmalig beim Einrichten der Komposition und verwende sie wieder. - Räumliche Bewegungen verwenden ausschließlich GSAP-Transformations-Aliase (
x,y,scale,rotation). Die Whitelist des Kerns erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Eigenschafts-Tweens – aber niemalswidth/height/top/leftfür Layout-Änderungen.
Skripte
node skills/hyperframes-animation/scripts/animation-map.mjs <kompositions-verzeichnis> \
--out <kompositions-verzeichnis>/.hyperframes/anim-map
Liest jede auf window.__timelines registrierte GSAP-Timeline aus, zählt Tweens auf, tastet Bounding-Boxen ab, berechnet Flags und gibt animation-map.json aus. Verwende dies, um die Choreografie nach der Erstellung zu überprüfen (tote Zonen, Stagger-Konsistenz, Lebenszyklus-Warnungen).
animation-map.mjs löst Hilfspakete zuerst aus dem aktuellen Projekt auf und kann dann die gebündelte Version des HyperFrames-Pakets bootstrappen. Setze HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn das Skill außerhalb der gebündelten CLI/Skill-Installation ausgeführt wird und du diese Bootstrap-Version explizit festlegen musst.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Sub-Kompositionen, deterministischer Render-Vertraghyperframes-creative– Paletten, Typografie, Erzählung, Taktplanung (Nicht-Animations-Kreativdirektion)hyperframes-cli–npx hyperframes lint / validate / inspect / preview / render