HyperFrames アニメーション
すべてのモーション知識を1つのスキルにまとめました:ルール(アトミックレシピ)、ブループリント(マルチフェーズシーンテンプレート)、遷移(シーン間)、技法(幅広いモーションデザインパターン)、そしてアダプタ(ランタイムごとのAPI)。
コンポジション契約(データ属性、サブコンポジション、決定論)については hyperframes-core を参照してください。
デフォルト:アトミックルールを合成する
rules-index.md から2~4個のルールを選び、単一の一時停止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 |
| 既存コンポジションのアニメーションマップを分析する | 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 スキルによる24ID) | 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 パッケージバージョンをブートストラップできます。HYPERFRAMES_SKILL_PKG_VERSION=<version> は、バンドルされたCLI/スキルインストールの外部でスキルを実行し、そのブートストラップバージョンを明示的に固定する必要がある場合にのみ設定してください。
関連情報
hyperframes-core— コンポジション構造、データ属性、サブコンポジション、決定論的レンダリング契約hyperframes-creative— パレット、タイポグラフィ、ナレーション、ビート計画(アニメーション以外のクリエイティブディレクション)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render