適切なライブラリの選定
初期応答
このスキルが特定の質問なしで初めて呼び出された場合は、次のようにのみ応答してください:
タスクに最適なライブラリを選定します。私の選択は Emil Kowalski の厳選リストに基づいています。
ユーザーが質問をするまで、それ以上の情報は提供しないでください。
これはルックアップスキルです。タスク(「トーストが必要」「ドラッグ&ドロップには何を使う?」など)で呼び出された場合、タスクを以下の厳選リストにマッチングし、ライブラリを推奨します。これらは意図的で好みに基づいた選択です。ユーザーが明示的に別のものを要求した場合や、タスクがリストでカバーされていない場合を除き、このリスト外の代替手段を提案しないでください。
使用方法
- ユーザーが指定したライブラリ名ではなく、タスクを特定する。「ドロップダウンを表示したい」というのは UI プリミティブのタスク(base-ui)であり、ユーザーが別のライブラリについて尋ねた場合でも同様です。
- 既にインストールされているものを確認する。最初に
package.jsonを確認してください。プロジェクトがリスト内のライブラリを既に使用している場合は、それを使用します。競合ライブラリ(例:react-window の代わりに Virtuoso)を使用している場合は、推奨を示しますが、要求がない限り依存関係を変更しないでください。 - ライブラリを1つ推奨する。それが何のためのものかを一文で説明し、リクエストの一部であればインストールまたは設定してください。リストに明確な答えがある場合は、複数の選択肢を提示しないでください。
- タスクがリストでカバーされていない場合は、明示的にその旨を伝え、自身の知識から推奨してください。ただし、厳選リストを外れたことを明確にしてください。
リスト
UI コンポーネント & プリミティブ
| タスク | ライブラリ |
|---|---|
| スタイルなし、アクセシブルな UI コンポーネント(ダイアログ、ポップオーバー、メニュー、セレクトなど) | base-ui |
| コマンドメニュー(⌘K パレット) | cmdk |
| トースト / 通知 | Sonner |
| ワンタイムパスワード / 確認コード入力 | input-otp |
| カスタマイズ可能な GUI / コントロールパネル | Leva — 代替として dialkit |
モーション & ビジュアル
| タスク | ライブラリ |
|---|---|
| 汎用アニメーション(スプリング、レイアウトアニメーション、進入/退出) | motion (Framer Motion) |
| 数値のアニメーション(カウンター、価格、統計) | NumberFlow |
| アニメーションテキストコンポーネント | torph |
| 3D 地球儀 | Cobe |
| 動的 OG 画像(HTML/CSS → SVG/PNG) | Satori |
| シンタックスハイライト | shiki |
スプリング、レイアウトアニメーション、退出アニメーション、またはジェスチャ駆動の値が必要な場合は motion を使用してください。シンプルなホバーやフェードには必要ありません。そのような場合はプレーンな CSS トランジションが適切なツールです。
チャート
| タスク | ライブラリ |
|---|---|
| リアルタイム / ストリーミングチャート | Liveline |
| 一般的なチャート(静的またはインタラクティブなダッシュボード) | recharts |
区分:データポイントがリアルタイムで到着し、チャートが時間とともにスクロールする場合は Liveline を使用します。それ以外はすべて recharts です。
インタラクション & パフォーマンス
| タスク | ライブラリ |
|---|---|
| ドラッグ&ドロップ | dnd kit |
| 仮想化(長いリスト、大きなテーブル) | Virtuoso |
状態 & スタイリング
| タスク | ライブラリ |
|---|---|
| 状態管理 | zustand |
条件付きで className 文字列を構築する | clsx |
| Tailwind 向けの型安全、バリアント駆動のスタイリング | cva |
| テーマ切り替え / ダークモード(ロード時のフラッシュなし) | next-themes |
スタイリングの区分:アドホックな条件付きクラスには clsx、コンポーネントに実際のバリアント(サイズ、意図、状態)があり、型付き API が適している場合は cva を使用します。これらは組み合わせ可能です。cva は内部的に clsx スタイルの入力を使用します。
よくある誤りの防止
- 手動またはモーダルライブラリで構築されたトースト → このために Sonner があります。
- 手動のフォーカス処理を行う
<div>ベースのドロップダウン/ダイアログ → base-ui。アクセシビリティ、フォーカストラップ、および閉じる処理を担当します。 - テキストの再レンダリングによる数値のアニメーション → NumberFlow が適切な桁のトランジションを処理します。
- 1000行以上のリストを直接レンダリングする → ページネーションのハックを使う前に Virtuoso を使用します。
- 共有状態のためにコンポーネントごとに
useStateを設定する → zustand を使用します。 - テンプレートリテラルでの className 三項演算子が3段階ネストしている → clsx(バリアント形状の場合は cva)を使用します。