プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルが HyperFrames プラグイン内にある場合は プラグイン実行ルール に従ってください。スタンドアロンインストールでは以下の更新手順をそのまま使用します。
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 → Characters |
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 禁止、有限のルート data-duration なしでの repeat: -1 禁止、後のシーンのクリップに対するページ読み込み時の gsap.set 禁止、display や生の visibility トゥイーン禁止、タイムラインは完全に構築された後にのみ登録(構築が document.fonts.ready などの非同期コールバック内で実行される場合も含む))。GSAP の autoAlpha と明示的なタイムライン境界でのゼロデュレーション可視性設定はコアで許可されています。これらの例外はクリップ以外の要素またはクリップ内のラッパーに対してのみ使用してください。フレームワークが .clip のライフサイクルを所有します。ここで完全な契約を再記述しないでください。
コアの契約に加えてアニメーション作成に関する追加事項:
- 事前計算されたレイアウト定数 – トゥイーン時に
getBoundingClientRect()から位置を導出しないでください。トゥイーン時の 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 パッケージバージョンをブートストラップします。HYPERFRAMES_SKILL_PKG_VERSION=<version> は、スキルをバンドルされた CLI/スキルインストールの外で実行し、そのブートストラップバージョンを明示的に固定する必要がある場合のみ設定します。
関連情報
hyperframes-core– コンポジション構造、データ属性、サブコンポジション、決定論的レンダリング契約hyperframes-creative– パレット、タイポグラフィ、ナレーション、ビート計画(アニメーション以外のクリエイティブディレクション)hyperframes-cli–npx hyperframes lint / check / snapshot / preview / render