⚠ コントラクトステータス: クラフトは現行、コードは旧式
このスタックの出力フレームワークは Remotion + React (
/hyperframes-core) です。 ここにあるモーションクラフトは依然として有効です:タイミング、イージングの選択、動作の形状、名前付きルールとブループリント。 コードは無効です:例とアダプターは、廃止されたHTML + 一時停止GSAPタイムラインランタイム向けに書かれています。読みながら翻訳してください:
こちらの記述 Remotionでは gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), 目視で調整window.__timelines[id]の一時停止タイムラインなし;すべての値は useCurrentFrame()の関数クリップの data-start/data-duration<Sequence from>/durationInFrames(フレーム単位)CSSキーフレームまたはトランジション フレームから導出したインライン style(CSSアニメーションはレンダリングされない)このスキルの例をそのままRemotionプロジェクトに貼り付けないでください。
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 |
| 既存のコンポジションのアニメーションマップを分析 | 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