プラグインインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルが 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 パッケージバージョンをブートストラップできます。HYPERFRAMES_SKILL_PKG_VERSION=<version> は、スキルをバンドルされたCLI/スキルインストールの外部で実行し、そのブートストラップバージョンを明示的に固定する必要がある場合にのみ設定してください。
関連項目
hyperframes-core— コンポジション構造、データ属性、サブコンポジション、決定論的レンダリングコントラクトhyperframes-creative— パレット、タイポグラフィ、ナレーション、ビート計画(非アニメーションのクリエイティブディレクション)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render