プラグインインストール時: セットアップまたは freshness コマンドの前に、このスキルが HyperFrames プラグイン内にある場合は プラグイン実行ルール に従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用します。
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 |
| モーションブラー — 要素へのシャッタースミア、および使用すべきでない場合 | 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 → 1 つの一時停止タイムライン + 譲れないルール(単一の一時停止タイムライン、data-duration が長さを決定、Math.random / Date.now / performance.now の禁止、有限なルート data-duration なしでの repeat: -1 の禁止、後のシーンのクリップに対するページロード時の gsap.set の禁止、display または生の visibility トゥイーンの禁止、タイムラインは完全に構築された後にのみ登録(document.fonts.ready などの非同期コールバック内での実行を含む))。コアにより、明示的なタイムライン境界での GSAP autoAlpha およびゼロ期間の可視性設定は引き続き許可されます。これらの例外は、クリップ内の非クリップ要素またはラッパーでのみ使用してください。フレームワークは .clip のライフサイクルを所有します。ここで完全な契約を再述する必要はありません。
コアの契約に加えて、アニメーション作成に関する追加事項:
- 事前計算されたレイアウト定数 — トゥイーン時に
getBoundingClientRect()から位置を導出しないでください。トゥイーン時の DOM 測定は、レンダラーが並行してサンプリングするため同期が取れなくなります。コンポジションセットアップ時に座標を 1 度計算し、再利用してください。 - 空間モーションには GSAP トランスフォームエイリアスのみを使用(
x、y、scale、rotation)。コアの許可リストでは、非空間プロパティのトゥイーンに対してopacity/color/backgroundColor/borderRadiusも許可されていますが、レイアウト変更のためにwidth/height/top/leftを使用することは絶対にしないでください。
スクリプト
node <SKILL_DIR>/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