HyperFrames アニメーション
すべてのモーション知識を1つのスキルに集約:ルール(原子的なレシピ)、ブループリント(マルチフェーズシーンテンプレート)、トランジション(シーン間の遷移)、テクニック(広範なモーションデザインパターン)、そしてアダプター(ランタイム固有のAPI)。
合成契約(データ属性、サブ構成、決定論性)については hyperframes-core を参照してください。
デフォルト:原子的なルールを合成する
rules-index.md から2~4個のルールを選び、それらを1つの一時停止されたGSAPタイムラインで結合するだけで完了です。これはブループリントから始めるよりも高速で、コードも少なくて済みます。
ブループリントを読み込む場合
- シーンが既存の事前設計されたマルチフェーズテンプレート(ブランドリビール、ソーシャルプルーフ、デモページスクロールスポットライトなど)に一致し、そのフェーズパイプラインを再利用することで実際の作成時間を節約できる場合
- 複雑な4~5フェーズの振り付けのための実行可能なグラウンドトゥルースコードが必要な場合
ブループリントは blueprints-index.md に格納されています。各エントリは blueprints/<id>.md(レシピ)と examples/<id>.html(実行可能サンプル)を指します。推測で読み込まず、シーンレベルのオーケストレーションが必要だと判断した後に読み込んでください。
ルーティング
| 目的 | 読むファイル |
|---|---|
| トリガー/タグで原子的なモーションパターンを選択する | rules-index.md |
| 1つのルールの完全なHTML/CSS/GSAPレシピを読む | rules/<name>.md |
| マルチフェーズシーンテンプレートを選択する | blueprints-index.md |
| 1つのブループリントの完全なレシピを読む | blueprints/<id>.md + examples/<id>.html |
| シーン遷移(CSS駆動、2つのクリップ間)を作成する | transitions/overview.md, transitions/catalog.md |
| 広範なモーションデザイン技術を調べる | techniques.md |
| 既存の構成のアニメーションマップを分析する | scripts/animation-map.mjs |
| GSAP API — タイムライン / トゥイーン / 位置パラメータ | adapters/gsap.md |
| GSAP — ドロップインエフェクトレシピ | rules/gsap-effects.md |
| GSAP — トランスフォーム / パフォーマンス | adapters/gsap-transforms-and-perf.md |
| GSAP — イージング / スタッガー | adapters/gsap-easing-and-stagger.md |
| GSAP — タイムライン / ラベル | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie(After Effectsの書き出し、window.__hfLottie) | adapters/lottie.md |
Three.js / WebGL(3Dシーン、AnimationMixer、hf-seek) | adapters/three.md |
Anime.js(window.__hfAnime) | adapters/animejs.md |
CSSキーフレーム(animation-delay / play-state / fill-mode) | adapters/css-animations.md |
Web Animations API(element.animate()、currentTimeシーク) | adapters/waapi.md |
TypeGPU / WebGPU(navigator.gpu、WGSL、コンピュートパイプライン) | adapters/typegpu.md |
HTML-as-texture + WebGL/GLSLポストエフェクト(drawElementImageでライブDOMをキャプチャ) | adapters/html-in-canvas-patterns.md |
名前付きテキストアニメーションエフェクト(外部 animate-text スキルによる24個のID) | adapters/animate-text.md |
ランタイムの選択
- GSAP は95%のモーション作業のデフォルト — タイムラインオーケストレーション、トランスフォーム、イージング、スタッガーをカバー。このスキルのすべての原子的ルールはGSAPベースです。
- Lottie は、アセットに事前に準備されたタイムラインがある場合(通常はAfter Effectsの書き出し)。
- Three.js は3Dシーン、カメラモーション、シェーダ駆動のビジュアル用。
- Anime.js はGSAPが過剰な場合の軽量トゥイーン用。
- CSS はシンプルな繰り返しモチーフ、デコレーション、きらめき用 — JavaScriptアニメーションコストなし。
- WAAPI はGSAP依存なしでネイティブブラウザキーフレームを使用する場合。
- TypeGPU / WebGPU はGPUレンダリングキャンバス用(パーティクル、リキッドグラス、カスタムシェーダー)。
複数のランタイムが1つの構成で共存できます。各ランタイムはランタイム固有のグローバルにインスタンスを登録し、HyperFramesが1回のパスですべてをシークできるようにします。
重要な制約
前提条件: hyperframes-core → 譲れないルール(単一の一時停止タイムライン、data-duration が長さを制御、Math.random / Date.now / performance.now なし、repeat: -1 なし、後続シーンのクリップに対する gsap.set なし、display / visibility アニメーションなし、async / setTimeout / Promise 内でのタイムライン構築なし)。ここでは再述しません。
コアの契約に追加するアニメーション作成の注意点:
- 事前計算されたレイアウト定数 — トゥイーン時に
getBoundingClientRect()から位置を導出しないでください。トゥイーン時のDOM測定は、レンダラーが並行してサンプリングするため同期が取れなくなります。構成設定時に一度だけ座標を計算し、再利用してください。 - 空間モーションはGSAPトランスフォームエイリアスのみを使用(
x、y、scale、rotation)。コアの許可リストは、非空間プロパティのトゥイーンに対してopacity/color/backgroundColor/borderRadiusも許可します — ただし、レイアウト変更のためにwidth/height/top/leftを使用することは絶対に避けてください。
スクリプト
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
window.__timelines に登録されたすべてのGSAPタイムラインを読み取り、トゥイーンを列挙し、バウンディングボックスをサンプリングし、フラグを計算し、animation-map.json を出力します。作成後に振り付けを監査(デッドゾーン、スタッガーの一貫性、ライフサイクル警告)するために使用してください。
関連項目
hyperframes-core— 構成構造、データ属性、サブ構成、決定論的レンダリング契約hyperframes-creative— パレット、タイポグラフィ、ナレーション、ビート計画(非アニメーションのクリエイティブディレクション)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render