⚠ Vertragsstatus: Craft ist aktuell, Code ist es nicht
Das Ausgabeframework dieses Stacks ist Remotion + React (
/hyperframes-core). Die Motion Craft hier gilt weiterhin: Timing, Easing-Auswahl, die Form einer Bewegung, die benannten Regeln und Blaupausen. Der Code ist nicht aktuell: Beispiele und Adapter sind auf die veraltete HTML + pausierte GSAP-Timeline-Laufzeit geschrieben.Übersetzen Sie beim Lesen:
Hier In Remotion gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), nach Augenmaß abgestimmteine pausierte Timeline bei window.__timelines[id]nichts; jeder Wert ist eine Funktion von useCurrentFrame()data-start/data-durationauf einem Clip<Sequence from>/durationInFrames, in Framesein CSS-Keyframe oder -Transition frame-abgeleitetes styleinline (CSS-Animation rendert nicht)Fügen Sie niemals ein Beispiel aus diesem Skill unverändert in ein Remotion-Projekt ein.
HyperFrames Animation
Das gesamte Bewegungs-Know-how in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (breitere Motion-Design-Muster) und Adapter (pro Laufzeit-API).
Für den Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinismus) siehe hyperframes-core.
Standard: Atomare Regeln komponieren
Wählen Sie 2-4 Regeln aus rules-index.md, fügen Sie sie mit einer einzigen pausierten GSAP-Timeline zusammen, fertig. Das ist schneller und produziert weniger Code, als mit einer Blaupause zu beginnen.
Blaupause laden, wenn
- Die Szene zu einer vorhandenen vordefinierten mehrphasigen Vorlage passt (Marken-Reveal, Social-Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Authoring-Zeit spart
- Sie ausführbaren, verlässlichen Code für eine komplexe 4-5-Phasen-Choreografie möchten
Blaupausen sind in blueprints-index.md aufgeführt. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lesen Sie diese nicht spekulativ; laden Sie sie, wenn Sie sich bereits für eine szenenübergreifende Orchestrierung entschieden haben.
Navigation
| Wenn Sie… | 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 breitere 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 – vorgefertigte Effektrezepte | rules/gsap-effects.md |
| GSAP – Transforms/Performance | adapters/gsap-transforms-and-perf.md |
| GSAP – Eases/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 per drawElementImage erfassen) | adapters/html-in-canvas-patterns.md |
Benannte Textanimationseffekte (24 IDs per externem animate-text-Skill) | adapters/animate-text.md |
Eine Laufzeit auswählen
- GSAP ist die Standardwahl für 95% der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transforms, Easing, Stagger ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie wenn ein Asset eine eigene vorgefertigte Timeline hat (typischerweise After Effects Exporte).
- Three.js für 3D-Szenen, Kamerabewegungen, shadergetriebene Visuals.
- Anime.js für leichtgewichtiges Tweening, wenn GSAP zu viel ist.
- CSS für einfache wiederholte Motive, Dekoration, Schimmer – keine JavaScript-Animation kostet.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU/WebGPU für GPU-gerenderte Leinwände (Partikel, Liquid Glass, 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 → Unverhandelbare Regeln (einzelne pausierte Timeline, data-duration bestimmt die Länge, kein Math.random/Date.now/performance.now, kein repeat: -1, kein gsap.set beim Seitenladen für Spätszenen-Clips, kein display oder rohes visibility-Tweening, und keine Timeline-Erstellung innerhalb von async/setTimeout/Promise). GSAP autoAlpha und null-dauernde Sichtbarkeitssetzungen an expliziten Timeline-Grenzen bleiben durch den Kern erlaubt. Verwenden Sie diese Ausnahmen nur auf Nicht-Clip-Elementen oder Wrappern innerhalb eines Clips; das Framework besitzt den .clip-Lebenszyklus. Wiederholen Sie hier nicht den vollständigen Vertrag.
Zusätzliche Animations-Craft-Regeln über den Kernvertrag hinaus:
- Vorkalkulierte Layout-Konstanten – Leiten Sie Positionen niemals zur Tween-Zeit aus
getBoundingClientRect()ab. Tween-Zeit-DOM-Messungen desynchronisieren, weil der Renderer parallel abtastet; berechnen Sie Koordinaten einmalig beim Kompositions-Setup und verwenden Sie sie wieder. - Räumliche Bewegungen verwenden ausschließlich GSAP-Transform-Aliase (
x,y,scale,rotation). Die Zulässigkeitsliste 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 <kompositionsverzeichnis> \
--out <kompositionsverzeichnis>/.hyperframes/anim-map
Liest jede GSAP-Timeline aus, die auf window.__timelines registriert ist, listet Tweens auf, sammelt Bounding-Boxen, berechnet Flags und gibt animation-map.json aus. Verwenden Sie dies, um die Choreografie nach dem Authoring zu prü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 HyperFrames-Paketversion bootstrappen. Setzen Sie HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn Sie den Skill außerhalb des gebündelten CLI/Skill-Installs ausführen und diese Bootstrap-Version explizit festlegen müssen.
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