HyperFrames Animation
Sämtliches Bewegungs- und Animationswissen in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (übergreifende Motion-Design-Muster) und Adapter (laufzeitspezifische APIs).
Informationen zum Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinismus) findest du unter hyperframes-core.
Standard: Atomare Regeln kombinieren
Wähle 2-4 Regeln aus rules-index.md aus, verbinde sie mit einer einzelnen pausierten GSAP-Timeline – fertig. Dieser Ansatz ist schneller und erzeugt weniger Code als der Start mit einer Blaupause.
Blaupause laden, wenn
- Die Szene einer vorhandenen, vorgefertigten mehrphasigen Vorlage entspricht (Marken-Reveal, Social-Proof, usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Autorenzeit spart
- Du ausführbaren Code als Referenz für eine komplexe 4-5-phasige Choreografie benötigst
Blaupausen befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lies sie nicht spekulativ; lade sie erst, wenn du dich bereits für eine szenenweite Orchestrierung entschieden hast.
Navigation
| 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 Blaupause lesen | blueprints/<id>.md |
| Einen Szenenübergang (CSS-gesteuert, zwischen zwei Clips) erstellen | transitions/overview.md, transitions/catalog.md |
| Eine übergreifende 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 Effekt-Rezepte | 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 externes animate-text-Skill) | adapters/animate-text.md |
Laufzeit auswählen
- GSAP ist der Standard für 95 % der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easings und Stagger ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie wenn ein Asset eine eigene eingebaute Zeitleiste besitzt (typischerweise 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, wiederholte Motive, Dekoration, Glitzereffekte – keine JavaScript-Animationskosten.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Canvas (Partikel, Flüssigglas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition koexistieren. Jede registriert ihre Instanzen im laufzeitspezifischen globalen Objekt, sodass HyperFrames alle von ihnen in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Nicht verhandelbare Regeln (einheitliche pausierte Zeitleiste, data-duration bestimmt die Länge, kein Math.random / Date.now / performance.now, kein repeat: -1, kein gsap.set bei Seitenladen für Clips späterer Szenen, kein display oder reines visibility-Tweening, keine Timeline-Erstellung innerhalb von async / setTimeout / Promise). GSAP autoAlpha und null-Dauer Sichtbarkeitseinstellungen an expliziten Timeline-Grenzen bleiben vom Kern erlaubt. Verwende diese Ausnahmen nur bei Nicht-Clip-Elementen oder Wrappern innerhalb eines Clips; das Framework kontrolliert den .clip-Lebenszyklus. Formuliere den vollständigen Vertrag hier nicht neu.
Zusätzliche Animationsregeln auf Basis des Kernvertrags:
- Vorberechnete Layout-Konstanten – leite Positionen niemals von
getBoundingClientRect()zur Tween-Zeit ab. DOM-Messungen zur Tween-Zeit desynchronisieren, da der Renderer parallel abtastet; berechne Koordinaten einmalig beim Kompositionsaufbau und verwende sie wieder. - Räumliche Bewegung verwendet nur GSAP-Transformations-Aliasnamen (
x,y,scale,rotation). Die Kern-Erlaubnisliste erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Eigenschaften – aber niemalswidth/height/top/leftfür Layoutänderungen.
Skripte
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Liest jede GSAP-Timeline, die auf window.__timelines registriert ist, listet Tweens auf, sammelt Begrenzungsrahmen, berechnet Flags und gibt animation-map.json aus. Verwende es zur Prüfung der Choreografie (tote Zonen, Stagger-Konsistenz, Lebenszykluswarnungen) nach der Erstellung.
animation-map.mjs löst zuerst Hilfspakete aus dem aktuellen Projekt auf und kann dann die gebündelte HyperFrames-Paketversion starten. Setze HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn du das Skill außerhalb der gebündelten CLI/Skill-Installation ausführst und die zu startende Version explizit festlegen möchtest.
Siehe auch
hyperframes-core— Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Rendervertraghyperframes-creative— Paletten, Typografie, Erzählung, Beat-Planung (nicht-animatorische kreative Richtung)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render