HyperFrames Kern
HyperFrames rendert Video aus HTML. Eine Komposition ist eine HTML-Datei, deren DOM mit data-* Attributen die zeitliche Abfolge deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird.
Dieser Skill ist der technische Vertrag – wie man ein HyperFrames-Projekt erstellt. Der folgende Text ist der Bauleitfaden; detaillierte Informationen zu den einzelnen Themen befinden sich in references/ (Index als nächstes), lese bei Bedarf nach. Andere Belange werden in den verwandten Domänen-Skills behandelt – hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. Die Fähigkeitskarte in /hyperframes sagt, was jeder abdeckt.
Referenzen
| Datei | Lies es, um… |
|---|---|
references/minimal-composition.md | mit dem kleinsten renderbaren Kompositionsskelett zu beginnen |
references/composition-patterns.md | monolithisch vs. modular zu wählen; ein modulares index.html zu strukturieren; einen Sub-Kompositions-Archetyp auszuwählen |
references/data-attributes.md | jedes data-* (root / clip / sub-comp host / legacy Aliase) nachzuschlagen; class="clip" zu verwenden |
references/tracks-and-clips.md | data-track-index zu wählen, Überlappungen / z-index auf demselben Track zu handhaben, einen Clip relativ zu einem anderen zu timen |
references/sub-compositions.md | eine Sub-Komposition zu verdrahten (host-Attribute, <template>, pro-Instanz-Variablen) und darin zu animieren |
references/variables-and-media.md | Variablen zu deklarieren; <video>/<audio> zu platzieren, Lautstärke einzustellen, zu trimmen |
references/determinism-rules.md | eine suchbare Zeitleiste zu bauen; Determinismus-Verbote; die Allowlist animierbarer Eigenschaften; Layout / Textanpassung |
references/full-screen-motion.md | Vollbild-Bewegung mit geteilten Hintergründen zu erstellen |
references/storyboard-format.md | einen STORYBOARD.md Plan zu erstellen (+ das geparste Manifest) |
references/review-loop.md | die Plan → Skizze → Bau Review-Durchläufe auf einem Live-Board auszuführen – geteilt von jedem Storyboard-Planungs-Workflow |
references/production-loop.md | einen genehmigten Plan zu einem gelieferten Video zu führen – die Stufen-Abhängigkeiten (Audio, Frames, Assembly, Übergänge, Untertitel, Verifizieren, Liefern); ein freiformatierter Build folgt direkt |
references/brief-contract.md | die Grundregeln des Briefings – Modus-Ableitung (kollaborativ / autonom), gemeinsames Feld-Register, Frage-Invarianten (das Fragen selbst lebt in /hyperframes → die Intentionsebene) |
references/brief-format.md | BRIEF.md zu erstellen – das bestätigte Absichtsdokument, das der Setup eines Workflows schreibt und jeder spätere Schritt liest |
references/script-format.md | das optionale SCRIPT.md fixierte Voiceover zu erstellen |
references/subagent-dispatch.md | Subagenten-Dispatch-Verben (paralleles Fan-Out / Hintergrund / Warten) auf dein Harness abzubilden |
references/tailwind.md | in einem Tailwind v4 Projekt zu arbeiten (init --tailwind; Laufzeitvertrag unterscheidet sich von Studios v3) |
Für spezifische Animationslaufzeiten (GSAP API, Lottie, Three.js usw.) gehe zu hyperframes-animation → adapters/<runtime>.md.
Eine Komposition erstellen
Zwei Wurzelformen (nicht austauschbar)
- Eigenständig (oberste Ebene
index.html) – root<div data-composition-id="…">sitzt direkt in<body>, kein<template>-Wrapper (das Einwickeln verbirgt alle Inhalte und bricht das Rendering). - Sub-Komposition (geladen über
data-composition-src) – root muss in<template>eingewickelt sein.
⚠ Transport-Regel: die Laufzeit klont nur
<template>-Inhalte; alles außerhalb (einschließlich<head>-Styles/Scripts) wird verworfen – platziere<style>/<script>innerhalb des Templates. ⚠ Host-ID-Regel:data-composition-iddes Host-Slots muss exakt demdata-composition-iddes inneren Templates und demwindow.__timelines["<id>"]-Schlüssel entsprechen – kein-mount/-slot/-host-Suffix.
Dateistruktur, Host-Verkabelung und die Pre-Render-Checkliste → references/sub-compositions.md.
Root muss dimensioniert sein (stiller Layout-Fehler)
Der eigenständige Root benötigt eine explizite größenbestimmte Box (width/height in px), und jeder Vorfahre bis zu einem height:100%-Element muss eine aufgelöste Höhe haben – sonst kollabiert ein flex-/100%-Kind auf ~0 und Inhalte stapeln sich in der oberen linken Ecke. Verlasse dich nicht nur auf automatisierte Gates, um dies zu erkennen; überprüfe einen Schnappschuss. Skelett → references/minimal-composition.md.
Eine pausierte Zeitleiste
Jede Komposition registriert genau eine gsap.timeline({ paused: true }) bei window.__timelines["<id>"] (Schlüssel = root data-composition-id), die synchron beim Laden der Seite erstellt wird. Render-Dauer = root data-duration, nicht Zeitleistenlänge. Verschachtele nicht manuell Sub-Zeitleisten in den Host. Vollständiger Vertrag (einschließlich Nicht-GSAP-Laufzeiten) → references/determinism-rules.md + hyperframes-animation/adapters/.
Unverhandelbare Regeln (stille Bugs, die automatisierte Gates übersehen können)
Hier aufgeführt; vollständige Begründung in der verlinkten Referenz. Nicht verletzen:
- Keine Renderzeit-Uhren / ungesätes
Math.random/ Netzwerk / Eingabezustand; keinrepeat: -1(endliche Anzahl verwenden). →determinism-rules.md - Nur die Allowlist visueller Eigenschaften animieren; niemals
displayoder rohesvisibilitytweenen. GSAPautoAlphaund Null-Dauer-Zeitleisten-Grenzen sind die einzigen Sichtbarkeitsausnahmen, und nur auf Nicht-Clip-Elementen oder Wrappern innerhalb eines Clips. Das Framework allein steuert die.clip-Sichtbarkeit. Nichtgsap.setfür später erscheinende Clips beim Laden der Seite setzen. →determinism-rules.md - Kein
<br>im Fließtext; transformierte Elemente müssen block-level + dimensioniert sein; pulsierende absolute dekorative Elemente benötigen Spitzenabstand. →determinism-rules.md <video>/<audio>muss ein direktes Kind des Host-Roots sein (niemals innerhalb eines Sub-Kompositions-<template>/Wrappers); das Framework besitzt die Wiedergabe. →variables-and-media.md- Jede
idmuss auf der zusammengebauten Seite eindeutig sein; innerhalb einer Sub-Komposition IDs mit der Kompositions-ID präfixen (#<id>-hero. Doppelte<video>/<img>-IDs rendern leer – der Producer injiziert Frames pergetElementById, und dateiübergreifende Duplikate entgehenlint. →composition-patterns.md - Eine full-screen Szenenfüllung gehört auf ein vollflächiges Kind (
position:absolute; inset:0), niemals auf den Kompositions-Root selbst – die Rahmenkomposition des Producers kann denbackgrounddes Root-Elements fallen lassen (der Rahmen rendert schwarz), selbst wenn die Vorschau/snapshotkorrekt angezeigt wird. →composition-patterns.md
Vorhandene Kompositionen bearbeiten
- Lies zuerst die Dateien. Erhalte nicht zusammenhängendes Timing, Tracks, IDs, Variablen, Medienpfade.
- Gleiche vorhandene Kompositions-IDs und Zeitleisten-Schlüssel ab.
- Hinzufügen eines Clips: wähle einen nicht überlappenden
data-track-indexoder passe das umgebende Timing bewusst an. data-hiddenauf einem Kompositionselement blendet es sowohl in der VORSCHAU als auch im RENDER aus und überschreibt sein Zeitfenster; es ist nicht destruktiv/umkehrbar und wird vom Zeitleisten-Augen-Symbol von Studio umgeschaltet.- Hinzufügen einer Sub-Komposition: überprüfe ihre interne
data-composition-id, bevor du den Host verdrahtest.
Validierung
Verwende hyperframes-cli für Befehlsdetails
-
npx hyperframes checkerfolgreich (0 Ergebnisse über Lint, Laufzeit, Layout, Bewegung und Kontrast) - Projekte mit Sub-Kompositionen:
npx hyperframes snapshot --at <midpoints>und überprüfe jedes Bild manuell -
npx hyperframes previewfür Review (der Benutzer kann alles in der Studio-Zeitleiste bearbeiten) -
npx hyperframes rendererst nach Genehmigung des Benutzers