プラグインインストール: セットアップやフレッシュネスコマンドを実行する前に、このスキルが 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種類) | 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 のライフサイクルを管理します。ここで完全なコントラクトを再記述する必要はありません。
コアのコントラクトに追加されるアニメーション作成上の注意点:
- 事前計算されたレイアウト定数 — トゥイーン時に
getBoundingRect()から位置を導き出さないでください。トゥイーン時の DOM 測定は、レンダラーが並行してサンプリングするため、同期が取れなくなります。コンポジションセットアップ時に座標を一度計算し、再利用してください。 - 空間モーションは 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 パッケージバージョンをブートストラップできます。バンドルされたCLI/スキルインストールの外部でスキルを実行し、そのブートストラップバージョンを明示的に固定する必要がある場合にのみ、HYPERFRAMES_SKILL_PKG_VERSION=<バージョン> を設定してください。
関連項目
hyperframes-core— コンポジション構造、データ属性、サブコンポジション、決定論的レンダリングコントラクトhyperframes-creative— パレット、タイポグラフィ、ナレーション、ビート計画 (非アニメーションのクリエイティブディレクション)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render