HyperFrames アニメーション は何をしますか?
すべてのモーション知識を1つのスキルに集約:ルール(原子レシピ)、ブループリント(多相シーンテンプレート)、トランジション(シーン間)、技法(より広範なモーションデザインパターン)、アダプター(ランタイム固有 API)。
構成契約(データ属性、サブコンポジション、決定性)については hyperframes-core を参照してください。
デフォルト:原子ルールの合成
rules-index.md からルールを2~4つ選び、単一の一時停止 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 をテクスチャとして+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