HyperFrames アニメーション
すべてのモーション知識を1つのスキルに集約:ルール(アトミックなレシピ)、ブループリント(マルチフェーズシーンテンプレート)、トランジション(シーン間の遷移)、テクニック(より広範なモーションデザインパターン)、そしてアダプタ(ランタイム別API)。
合成コントラクト(データ属性、サブコンポジション、決定性)については「hyperframes-core」を参照してください。
デフォルト:アトミックルールの合成
rules-index.md から2~4個のルールを選び、それらを1つの一時停止GSAPタイムラインに結合するだけで完了です。ブループリントから始めるよりも高速で、コード量も少なくなります。
ブループリントをロードするタイミング
- シーンが既存の設計済みマルチフェーズテンプレート(ブランドリビール、ソーシャルプルーフなど)に一致し、そのフェーズパイプラインを再利用することで作成時間を大幅に節約できる場合
- 複雑な4~5フェーズの振り付けを実行可能なグラウンドトゥルースコードが必要な場合
ブループリントは blueprints-index.md にあります。各エントリは blueprints/.md(レシピ)を指しています。推測で読まず、シーンレベルのオーケストレーションが必要と判断した時点でロードしてください。
ルーティング
| 目的 | 読むファイル |
|---|---|
| トリガー/タグでアトミックモーションパターンを選ぶ | rules-index.md |
| 1つのルールの完全なHTML/CSS/GSAPレシピを読む | rules/<name>.md |
| マルチフェーズシーンテンプレートを選ぶ | blueprints-index.md |
| 1つのブループリントの完全なレシピを読む | blueprints/<id>.md |
| シーン間の遷移を作成する(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テクスチャ + WebGL/GLSL ポストエフェクト(drawElementImage でライブDOMをキャプチャ) | adapters/html-in-canvas-patterns.md |
名前付きテキストアニメーションエフェクト(24個のID、外部 animate-text スキル経由) | 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測定は、レンダラーが並行してサンプリングするため非同期になります。座標はコンポジションのセットアップ時に1回計算して再利用してください。 - 空間モーションにはGSAPのtransformエイリアスのみを使用(
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