HyperFrames アニメーション
すべてのモーション知識を1つのスキルに集約: ルール(アトミックレシピ)、ブループリント(マルチフェーズシーンテンプレート)、トランジション(シーンからシーンへ)、テクニック(幅広いモーションデザインパターン)、アダプター(ランタイムごとの API)。
コンポジションのコントラクト(データ属性、サブコンポジション、決定論)については hyperframes-core を参照してください。
デフォルト:アトミックルールを構成する
rules-index.md から2~4個のルールを選び、単一の一時停止 GSAP タイムラインで結合するだけです。ブループリントから始めるよりも高速で、コード量も少なくなります。
ブループリントをロードする場合
- シーンが既存の事前設計されたマルチフェーズテンプレート(ブランドリビール、ソーシャルプルーフなど)に一致し、そのフェーズパイプラインを再利用することで実際の作成時間を節約できる場合
- 複雑な4~5フェーズの振り付けに対して、実行可能な真実のコードが必要な場合
ブループリントは blueprints-index.md にあります。各エントリは blueprints/<id>.md(レシピ)を指しています。推測で読むのではなく、シーンレベルのオーケストレーションが必要だと判断した後にロードしてください。
ルーティング
| 目的 | 参照先 |
|---|---|
| トリガーやタグでアトミックモーションパターンを選ぶ | rules-index.md |
| 特定のルールの完全な HTML / CSS / GSAP レシピを読む | rules/<name>.md |
| マルチフェーズシーンテンプレートを選ぶ | blueprints-index.md |
| ブループリントの完全なレシピを読む | blueprints/<id>.md |
| シーントランジションを作成する(CSS 駆動、2つのクリップ間) | transitions/overview.md, transitions/catalog.md |
| 幅広いモーションデザインテクニックを調べる | techniques.md |
| モーションブラー — 要素のシャッタースミア、使用すべきでない場合 | references/motion-blur.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 |
| キャラクターアニメーション(歩行サイクル、マスコット、関節パペット、ジェスチャー) | 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 内でのタイムライン構築不可)。GSAP の autoAlpha と明示的なタイムライン境界でのゼロデュレーション可視性設定はコアによって許可されています。これらの例外は、クリップ内の非クリップ要素またはラッパーにのみ使用してください。フレームワークは .clip のライフサイクルを所有しています。ここで完全なコントラクトを再説明しないでください。
コアのコントラクトに加えてのアニメーション作成に関する追加:
- 事前計算されたレイアウト定数 — トゥイーン時に
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 を出力します。作成後に振り付けを監査(デッドゾーン、スタッガー一貫性、ライフサイクル警告)するために使用してください。
animation-map.mjs は最初に現在のプロジェクトからヘルパーパッケージを解決し、次にバンドルされた HyperFrames パッケージバージョンをブートストラップできます。バンドルされた CLI/スキルインストールの外部でスキルを実行し、そのブートストラップバージョンを明示的に固定する必要がある場合にのみ HYPERFRAMES_SKILL_PKG_VERSION=<version> を設定してください。
関連項目
hyperframes-core— コンポジション構造、データ属性、サブコンポジション、決定論的レンダリングコントラクトhyperframes-creative— パレット、タイポグラフィ、ナレーション、ビート計画(非アニメーションクリエイティブディレクション)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render