hyperframes-registry

プラグインのインストール： セットアップまたは最新状態の確認コマンドを実行する前に、このスキルが HyperFrames プラグイン内にある場合は、プラグインの実行ルールに従ってください。

HyperFrames レジストリ

アイテムを出発点にするほうが、自分でエフェクトを書くより速く、通常はより適切です。インストールしたアイテムは、プロジェクト内の通常のソースです。変更したり、不要な部分を削ったり、スタイルを変えたりできます。

検索とインストール

npx hyperframes catalog --query "<what the beat should do, in English>" --json
npx hyperframes add <name> --json        # prints the written files and the mount snippet

• 動画が英語でなくても、英語で検索してください。カタログは英語でインデックス化されており、別の文字体系では No searchable words in query と表示されますが、これは検索対象がないという意味ではありません。
• 検索はローカルで行われ、情報は送信されません。デフォルトの words ティアでは、検索語を再利用しているアイテムのみが見つかります。--on-device では、約 33 MB のダウンロードを一度行った後、意味に基づいて順位付けされます。ダウンロードを案内して、実行するかどうかはユーザーに判断してもらってください。決して無断で有効にしないでください。--json のエンベロープには、検索に使われたティアが記載されます。
• --type block|component と --tag <tag> で絞り込めます。add <tag> は、そのタグが付いたすべてのブロックをインストールします。依存関係は先にインストールされます。以前インストールしたアイテムでも、add にはネットワーク接続が必要です。検索はキャッシュされたマニフェストを使ってオフラインで実行できます。
• 適合するものが見つからない場合は、どちらのティアでも、自作に移る前にその旨を報告してください。catalog --query は、入力済みの次のコマンドを出力します（--json では report_gap）：npx hyperframes feedback --search-miss "<query>" --wanted "<the move you needed>" --tier <tier>。想像上のアイテム名ではなく、必要なエフェクトを説明してください。

ティア、dropped と unindexed、古いインデックス、オフライン時の動作については、references/search.md を参照してください。

収録内容

ブロック：独自のタイムラインを持つシーン	例
トランジション	beat-freeze-cut、chromatic-radial-split、cinematic-zoom
オーバーレイとローワーサード	camcorder-hud、editorial-flash-overlay、lt-clean-bar
タイトルカードとキネティックタイポグラフィ	canopy-part-title、code-slice-hero
ソーシャル、チャット、UI カード	ai-chat-reveal、chatgpt-exchange
コード、チャート、データ、マップ	code-diff、bar-chart-race、data-chart
3D、シェーダー、背景	app-showcase、aurora、blob

コンポーネント：シーンにマージするスニペット	例
モーションの基本要素とテキストエフェクト	agent-cursor、blur-in、bottom-up-letters
キャプションのスタイル	caption-clip-wipe、caption-editorial-emphasis
カメラの動き	camera-shake、camera-scan-gate
製品デモと UI プロップ	before-after-wipe、browser-device-stage
テクスチャ、パーティクル、エフェクト	ascii-render-pass、grain-overlay

組み込み

• ブロック：compositions/<name>.html にインストールされます。data-composition-src、ブロック独自の ID と一致する data-composition-id、data-start、必要な data-duration を指定してマウントします。add が出力するスニペットを出発点にしてください。references/wiring-blocks.md を参照してください。
• コンポーネント：compositions/components/<name>.html にインストールされます。そのマークアップ、<style>、スクリプトをシーンにコピーし、タイムラインと連携する場合はコメントブロックに従ってください。references/wiring-components.md を参照してください。
• 適合する最大単位を使い、その後編集してください。インストールしたアイテムの ID は元のプレフィックスを維持し、アイテム同士が衝突しないようにしてください。
• アイテムは独自の変数を保持します。ホストの data-variable-values で、1 つのマウントに対する値を設定してください（add --vars '{"title":"…"}' を実行すると、その設定が書き込まれます）。色とフォントの変数は、ブランドのものを指定してください。
• ビート同期ブロックは、npx hyperframes beats --json のヒット時刻を使用します。マウントの data-start をビート時刻から差し引いてください。
• インストール先のパスは hyperframes.json で指定します（references/install-locations.md を参照）。

コントリビューション

上流への PR 用に新しいブロックまたはコンポーネントを作成する場合は、references/contributing.md、スターターテンプレートの references/templates.md、品質基準の references/component-quality-bar.md を参照してください。