Plugin-Installation: Bevor Setup- oder Aktualisierungsbefehle ausgeführt werden, befolgen Sie die Plugin-Ausführungsregeln, wenn sich dieses Skill innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die untenstehenden Aktualisierungshinweise.
HyperFrames-Animation
Das gesamte Bewegungs-Wissen in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (pro Laufzeitumgebung).
Für den Kompositionsvertrag (Datenattribute, Subkompositionen, Determiniertheit) siehe hyperframes-core.
Standard: Atomare Regeln kombinieren
Wählen Sie 2-4 Regeln aus rules-index.md, verbinden Sie sie mit einer einzigen pausierten GSAP-Timeline – fertig. Dies ist schneller und erzeugt weniger Code, als mit einer Blaupause zu beginnen.
Blaupause laden, wenn
- Die Szene mit einer vorhandenen, vorgefertigten mehrphasigen Vorlage übereinstimmt (Marken-Enthüllung, Social Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline tatsächlich Autorenzeit spart
- Sie ausführbaren, verlässlichen Code für eine komplexe 4-5-Phasen-Choreografie benötigen
Blaupausen befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lesen Sie nicht spekulativ daraus; laden Sie es nur, wenn Sie bereits entschieden haben, dass Sie eine Szenen-Orchestrierung benötigen.
Weiterleitung
| Sie möchten… | Lesen Sie |
|---|---|
| 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 erstellen (CSS-gesteuert, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Eine allgemeine Motion-Design-Technik nachschlagen | techniques.md |
| Bewegungsunschärfe – Shutter-Smear auf einem Element und wann man sie nicht verwenden sollte | references/motion-blur.md |
| Den Animationsplan 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 / Performanz | adapters/gsap-transforms-and-perf.md |
| GSAP – Easing / Staffelung | 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 |
| Charakter-Animation (Gehzyklus, Maskottchen, gegliederte Puppe, Gesten) | adapters/lottie.md → Charaktere |
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-Suche) | 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 Text-Animationseffekte (24 IDs über externes animate-text-Skill) | adapters/animate-text.md |
Auswahl einer Laufzeitumgebung
- GSAP ist der Standard für 95% der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easing und Staffelung ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie wenn ein Asset eine eigene vorgefertigte Timeline hat (typischerweise After Effects-Exporte), einschließlich Charakteren, die gehen, gestikulieren oder reagieren.
- Three.js für 3D-Szenen, Kamerabewegungen, shader-gesteuerte Visuals.
- Anime.js für leichtgewichtiges Tweening, wenn GSAP übertrieben ist.
- CSS für einfache, wiederholte Motive, Dekoration, Schimmer – ohne JavaScript-Animationskosten.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Canvase (Partikel, Flüssigglas, benutzerdefinierte Shader).
Mehrere Laufzeitumgebungen können in einer Komposition koexistieren. Jede registriert ihre Instanzen in der laufzeitspezifischen globalen Variable, sodass HyperFrames alle in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Eine pausierte Timeline + Unverhandelbare Regeln (eine einzige pausierte Timeline, data-duration steuert die Länge, kein Math.random / Date.now / performance.now, kein repeat: -1 ohne eine endliche Wurzel-data-duration, kein gsap.set beim Seitenladen für Clips späterer Szenen, kein display oder rohes visibility-Tweening, und die Timeline erst registrieren, wenn sie vollständig aufgebaut ist – auch wenn der Aufbau innerhalb eines asynchronen Callbacks wie document.fonts.ready erfolgt). GSAP autoAlpha und null-dauer Sichtbarkeitseinstellungen an expliziten Timeline-Grenzen bleiben vom Kern erlaubt. Verwenden Sie diese Ausnahmen nur für Nicht-Clip-Elemente oder Wrapper innerhalb eines Clips; das Framework besitzt den .clip-Lebenszyklus. Wiederholen Sie hier nicht den vollständigen Vertrag.
Zusätzliche Animationshandwerksregeln über den Kernvertrag hinaus:
- Vorberechnete Layout-Konstanten – leiten Sie Positionen niemals von
getBoundingClientRect()zur Tween-Zeit ab. DOM-Messungen zur Tween-Zeit desynchronisieren, weil der Renderer parallel samplet; berechnen Sie Koordinaten einmal beim Kompositionsaufbau und verwenden Sie sie wieder. - Räumliche Bewegung verwendet nur GSAP-Transform-Aliasnamen (
x,y,scale,rotation). Die Zulassungsliste des Kerns erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Eigenschafts-Tweens – aber niemalswidth/height/top/leftfür Layoutänderungen.
Skripte
node <SKILL_DIR>/scripts/animation-map.mjs <compositions-verzeichnis> \
--out <compositions-verzeichnis>/.hyperframes/anim-map
Liest jede GSAP-Timeline, die auf window.__timelines registriert ist, zählt Tweens auf, samplet Begrenzungsrahmen, berechnet Flags und gibt animation-map.json aus. Verwenden Sie es, um die Choreografie (tote Zonen, Staffelungskonsistenz, Lebenszykluswarnungen) nach dem Erstellen zu auditieren.
animation-map.mjs löst Hilfspakete zuerst aus dem aktuellen Projekt auf und kann dann die gebündelte HyperFrames-Paketversion bootstrappen. Setzen Sie HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn Sie das Skill außerhalb der gebündelten CLI/Skill-Installation ausführen und diese Bootstrap-Version explizit festlegen müssen.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Subkompositionen, deterministischer Rendervertraghyperframes-creative– Paletten, Typografie, Erzählung, Beat-Planung (Nicht-Animations-Kreativrichtung)hyperframes-cli–npx hyperframes lint / check / snapshot / preview / render