HyperFrames アニメーション
すべてのモーション知識が1つのスキルに集約されています:ルール(アトミックレシピ)、ブループリント(マルチフェーズシーンテンプレート)、トランジション(シーン間)、テクニック(より広範なモーションデザインパターン)、アダプター(ランタイム別API)。
コンポジションのコントラクト(データ属性、サブコンポジション、決定論)については hyperframes-core を参照してください。
デフォルト:アトミックルールの合成
rules-index.md から2~4個のルールを選び、それらを1つの一時停止されたGSAPタイムラインで結合するだけです。ブループリントから始めるよりも高速で、コード量が少なくなります。
ブループリントを読み込むケース
- シーンが既存のプリデザインされたマルチフェーズテンプレート(ブランドリビール、ソーシャルプルーフなど)に一致し、そのフェーズパイプラインを再利用することで作成時間を節約できる場合
- 複雑な4~5フェーズの振り付けについて、実行可能なグラウンドトゥルースコードが必要な場合
ブループリントは blueprints-index.md にあります。各エントリは blueprints/<id>.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 |
| モーションブラー — 要素のシャッタースミア、使用すべきでない場合 | 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テクスチャ + 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