HyperFrames コア
HyperFrames は HTML からビデオをレンダリングします。コンポジションとは、その DOM が data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生をフレームワークが所有する HTML ファイルです。
このスキルは技術契約 — 1つの hyperframes プロジェクトを構築する方法です。以下の本文が構築ガイドです;トピック別の詳細は references/ にあります(次にインデックスを参照)、必要に応じて読んでください。その他の関心事は、兄弟ドメインスキル — hyperframes-animation、hyperframes-creative、media-use、hyperframes-cli、hyperframes-registry にあります。/hyperframes の機能マップに各スキルの対象範囲が記載されています。
リファレンス
| ファイル | 読む目的… |
|---|---|
references/minimal-composition.md | 最小のレンダリング可能なコンポジションスケルトンから始める |
references/composition-patterns.md | モノリシック vs モジュラーを選択する;モジュラー index.html を構造化する;サブコンポジションのアーキタイプを選ぶ |
references/data-attributes.md | 任意の data-*(ルート / クリップ / サブコンポホスト / レガシーエイリアス)を調べる;class="clip" を使用する |
references/tracks-and-clips.md | data-track-index を選択する;同じトラックの重なり / z-index を処理する;クリップを別のクリップに対してタイミング調整する |
references/sub-compositions.md | サブコンポジション(ホスト属性、<template>、インスタンスごとの変数)を配線し、その内部でアニメーションさせる |
references/variables-and-media.md | 変数を宣言する;<video>/<audio> を配置し、ボリューム、トリムを設定する |
references/determinism-rules.md | シーク可能なタイムラインを構築する;決定論の禁止事項;アニメーションプロパティ許可リスト;レイアウト / テキストフィット |
references/full-screen-motion.md | 共有背景を使用して全画面モーションを作成する |
references/storyboard-format.md | STORYBOARD.md 計画(および解析されたマニフェスト)を作成する |
references/review-loop.md | ライブボードで plan → sketch → build のレビューパスを実行する — すべてのストーリーボード計画ワークフローで共有 |
references/production-loop.md | 承認された計画を納品されたビデオにする — ステージの依存関係(オーディオ、フレーム、アセンブリ、トランジション、キャプション、検証、納品)に従い、自由形式のビルドが直接続く |
references/brief-contract.md | ブリーフの基本ルール — モードの導出(協調 / 自律)、共有フィールドレジストリ、質問の不変条件(質問自体は /hyperframes → インテント層に存在) |
references/brief-format.md | BRIEF.md を作成する — ワークフローのセットアップが書き、後続のすべてのステップが読む確定されたインテント文書 |
references/script-format.md | オプションの SCRIPT.md ロックされたナレーションを作成する |
references/subagent-dispatch.md | サブエージェントディスパッチ動詞(並列ファンアウト / バックグラウンド / 待機)をハーネスにマッピングする |
references/tailwind.md | Tailwind v4 プロジェクトで作業する(init --tailwind;ランタイム契約は Studio の v3 とは異なる) |
アニメーションランタイムの詳細(GSAP API、Lottie、Three.js など)については、hyperframes-animation → adapters/<runtime>.md を参照してください。
コンポジションの構築
2つのルート形式(互換性なし)
- スタンドアロン(トップレベルの
index.html) — ルート<div data-composition-id="…">が<body>内に直接配置される。<template>ラッパーは不要(ラップするとすべてのコンテンツが隠れ、レンダリングが壊れます)。 - サブコンポジション(
data-composition-srcで読み込まれる) — ルートは必ず<template>でラップする必要があります。
⚠ 転送ルール:ランタイムは
<template>の内容のみをクローンします;外側のもの(<head>のスタイル/スクリプトを含む)はすべて破棄されます —<style>/<script>はテンプレート内に配置してください。 ⚠ ホストIDルール:ホストスロットのdata-composition-idは、内部テンプレートのdata-composition-idおよびwindow.__timelines["<id>"]キーと完全に一致する必要があります —-mount/-slot/-hostサフィックスは付けないでください。
ファイル構造、ホスト配線、およびプリレンダリングチェックリスト → references/sub-compositions.md。
ルートはサイズ指定が必要(サイレントレイアウトバグ)
スタンドアロンルートには、明示的なサイズ指定のボックス(width/height をpxで)が必要であり、height:100% 要素までのすべての祖先が解決された高さを持っている必要があります — そうしないと、flex/100% の子要素が約0に縮小し、コンテンツが左上隅に詰まります。自動化されたゲートだけに頼らずにこれを検出しないでください;スナップショットを検査してください。スケルトン → references/minimal-composition.md。
1つの一時停止タイムライン
各コンポジションは、ページ読み込み時に同期的に構築された、window.__timelines["<id>"](キー = ルート data-composition-id)に正確に1つの gsap.timeline({ paused: true }) を登録します。レンダリング期間 = ルート data-duration,タイムラインの長さではありません。サブタイムラインを手動でホストにネストしないでください。完全な契約(非GSAPランタイムを含む)→ references/determinism-rules.md + hyperframes-animation/adapters/。
譲歩できないルール(自動化ゲートが見逃す可能性のあるサイレントバグ)
ここに提示されています;完全な根拠はリンク先のリファレンスにあります。違反しないでください:
- レンダリング時間のクロック / シードされていない
Math.random/ ネットワーク / 入力状態は禁止;repeat: -1は禁止(有限カウントを使用)。→determinism-rules.md - ビジュアルプロパティ許可リストのみをアニメーション化;
displayや生のvisibilityをトゥイーンしないでください。GSAPautoAlphaとゼロ期間タイムラインバウンダリ設定のみが可視性の例外であり、クリップ以外の要素またはクリップ内のラッパーにのみ適用されます。フレームワークのみが.clipの可視性を制御します。ページ読み込み時に後続シーンのクリップに対してgsap.setを行わないでください。→determinism-rules.md - 本文テキストに
<br>は禁止;変換された要素はブロックレベルでサイズ指定されている必要があります;パルスする絶対配置デコレーティブはピーククリアランスが必要です。→determinism-rules.md <video>/<audio>はホストルートの直接の子でなければなりません(サブコンポ<template>/ラッパー内には絶対に配置しない);フレームワークが再生を所有します。→variables-and-media.md- すべての
idはアセンブルされたページ全体で一意でなければなりません;サブコンポ内では、IDにコンポジションIDをプレフィックスとして付けます(#<id>-hero)。重複した<video>/<img>ID は空白でレンダリングされます — プロデューサーはgetElementByIdでフレームを注入し、ファイルをまたがる重複はlintをすり抜けます。→composition-patterns.md - 全画面シーンの塗りつぶしは、全面にわたる子要素(
position:absolute; inset:0)に配置し、決してコンポジションルート自体には配置しないでください — プロデューサーのフレーム合成はルート要素自体のbackgroundをドロップする可能性があり(フレームは黒でレンダリングされます)、プレビュー/snapshotで正しく表示されていても同様です。→composition-patterns.md
既存のコンポジションの編集
- 最初にファイルを読んでください。無関係なタイミング、トラック、ID、変数、メディアパスは保持してください。
- 既存のコンポジションIDとタイムラインキーに一致させてください。
- クリップを追加する:重複しない
data-track-indexを選択するか、意図的に周囲のタイミングを調整してください。 - 任意のコンポジション要素に対する
data-hiddenは、プレビューとレンダリングの両方でその要素を非表示にし、時間ウィンドウをオーバーライドします;これは非破壊的/可逆的であり、Studioのタイムラインの目のアイコンで切り替えられます。 - サブコンポジションを追加する:ホストを配線する前に、その内部の
data-composition-idを確認してください。
バリデーション
コマンドの詳細については hyperframes-cli を使用してください
-
npx hyperframes checkがパスする(lint、ランタイム、レイアウト、モーション、コントラストにわたって0の検出結果) - サブコンポジションを含むプロジェクト:
npx hyperframes snapshot --at <midpoints>を実行し、各フレームを目視確認する - レビュー用に
npx hyperframes preview(ユーザーはStudioのタイムラインで何でも編集できます) - ユーザーが承認した後にのみ
npx hyperframes render