参照カタログは 2026-11-21 に確認しました。 shadcn/ui All Components。 そのメインカタログには 66 のエントリー があり、以下にそれぞれ 1 回ずつ記載しています。別枠の AI Elements カタログはこの比較の対象外ですが、メインカタログにすでに含まれている会話系コンポーネントは対象に含めています。
GPUI Deck は 42 の公開ライブラリファミリーと、コピーして使える 23 の プレゼンテーション/構成レシピ をドキュメント化しており、65 の個別の実装 を提供します。 残る 1 つのカタログエントリーである Native Select は、GPUI では Select にマッピング されます。 66 の参照エントリーすべてに、実装済みのスコープまたはプラットフォームへのマッピングがあります。 未割り当てのもの、Pending のものはありません。
これはカタログのカバレッジであり、shadcn/ui の機能の完全な同等性ではありません。各契約には明示的な制限があり、HTML 固有のマッピングはブラウザーのコントロールやオペレーティングシステムのピッカーを実装するものではありません。これらの数は、パフォーマンス、アクセシビリティ適合性、ネイティブデスクトップでの検証の完了度を測るものではありません。
目標は、アプリケーション構築の幅において同等であることです。共有される動作はライブラリに置き、再利用可能なプレゼンテーションと画面の構成は、そのソースをアプリケーションが所有します。以下のグループは、shadcn の内部アーキテクチャではなく、私たちの実装上の責務を説明するものです。two_styles と catalogue のネイティブサンプルは、再利用可能なプレゼンテーションレシピを使用します。レシピのソースはこのリポジトリで配布され、ローカルのソース CLI がレシピ、依存関係、トークン、ライセンスをコンシューマーが所有するモジュールにインストールします。リモートレジストリは提供されません。
ステータスの意味
- Available: 公開ファミリーとコンシューマーのサンプルが、記載したスコープをカバーしています。
- Recipe: 再利用可能なアプリケーションソースと動作するコンシューマーのサンプルが、記載したプレゼンテーションをカバーしています。レシピはライブラリの公開エクスポートの外にあります。
- Mapped: 明示的な GPUI のプラットフォーム相当機能が、ネイティブアプリケーションの必要を満たします。ブラウザー専用の契約は、エイリアスの背後に隠さず、ドキュメント化されています。
動作とセマンティクスの基盤
これらのコンポーネントは、インタラクション、状態、フォーカス、または再利用可能なセマンティクスの契約を担います。 外観はアプリケーションが所有します。実装済みの API の詳細は、 フォームガイド、 ナビゲーションとオーバーレイのガイド、 レイアウトとデータのガイドで説明しています。
| カタログエントリー | ステータス | 現在のスコープまたはギャップ |
|---|---|---|
| Accordion | Available | 固定のアイテム、単一/複数のセクションの展開、独立したヘッダーナビゲーション、アクティブなパネルのみのマウント。 |
| Alert Dialog | Available | AlertDialog は Dialog の状態とフォーカスを再利用します。背景クリックによる閉鎖はブロックされ、確認はアプリケーションが担います。 |
| Breadcrumb | Available | 名前付きのネイティブな Navigation、List、ListItem 構造で、現在のアイテムには aria_current(Page) を付与します。折りたたまれた祖先や各項目のドロップダウンは、カタログの Home › … › page パスと同様に、項目内に通常の DropdownMenu を合成します。パス、祖先の Button、ナビゲーションのコールバック、区切り、折りたたみのポリシー、スタイリングはアプリケーションが用意します。ルーティング、幅の計測、フォーカスコントローラーはありません。 |
| Button | Available | ネイティブのポインター/キーボード操作による起動、無効状態、フォーカス、アクセシブルな名前付け、選択スタイルとは独立した現在のページの明示的なメタデータ。コンテンツとスタイルはアプリケーションが担います。 コピーできるレシピに 6 つのボタンスタイルがあります。 |
| Checkbox | Available | 制御されるオン/オフ/混在の状態。インジケーターとラベルのプレゼンテーションはアプリケーションが用意します。 |
| Collapsible | Available | 保持される 1 つの開閉状態、Button のトリガー、アクティブなコンテンツのみのマウント、コンテンツが閉じるときのフォーカス処理。 |
| Combobox | Available | 編集可能な単一/複数の選択、グループ化された結果、削除可能な選択済みの値、ネイティブのクエリ/フォーカス/IME と残る選択肢を保持する置き換え可能なアイテム。取得とリクエストの順序はアプリケーションが担います。自由形式の値やネットワークマネージャーはありません。 |
| Command | Available | 置き換え可能なコマンドアイテム、名前付きの結果グループ、単語の先頭を優先し連続するグループを重視する順序付きの (ファジー) マッチングによるランキング、キーボード/ポインターによるアクション、Dialog との合成。アイテムを置き換えても、ネイティブのクエリと残るハイライトは保持されます。取得はアプリケーションが担います。 |
| Context Menu | Available | 副ボタンクリックとキーボードによる開閉、フォーカス可能な対象、共有されるプレーン/チェック/混在/ラジオのコマンド、およびリーフのディスパッチ、解除、フォーカス復元を備えたネストされたサブメニュー。値はアプリケーションが所有します。タッチの長押しは、押した位置でメニューを開きます。対象のコンテンツは非インタラクティブです。 |
| Dialog | Available | モーダルの開閉、ネイティブのモーダルフラグ、装飾的な背景の有無にかかわらず背景のポインター/ホイールを遮断、初期フォーカス、フォーカスの封じ込め、解除、フォーカスの復帰。サーフェスとコンテンツはアプリケーションが用意します。 |
| Direction | Available | スコープ付きの DirectionProvider、ネストによる上書き、論理的な行レイアウト、Tabs、RadioGroup、ToggleGroup、Slider、Carousel、Chart、Menubar、NavigationMenu に継承される水平ナビゲーション。Slider のポインター座標も反転します。アプリケーションのレイアウトは Direction::row を使用し、テキストのシェーピングと編集は GPUI が担います。 |
| Dropdown Menu | Available | 共有メニューへの Button による入口、アプリケーションが制御するチェック/混在/ラジオのセマンティクス、有効なアイテム間のナビゲーション、1 文字検索、ネストされたサブメニューのナビゲーション。リーフの起動は、1 つのルートアクションを発行する前にメニューツリー全体を閉じます。2 つ目の選択ストアはありません。 |
| Field | Available | 既存の Input/Textarea ベースのコントロール (Combobox のクエリを含む) 向けの、ラベルフォーカス、ヘルプ/エラーの説明、必須/無効のメタデータ。ControlField は Checkbox、Switch、RadioGroup、Select に、同じラベル、ヘルプより先に置くエラーの説明、必須/無効のメタデータを提供し、ラベルのクリックでコントロールをフォーカスし、必要に応じて起動します。バリデーションはアプリケーションが担います。 |
| Hover Card | Available | 遅延ホバーまたはトリガーのフォーカスで表示される非インタラクティブなリッチプレビュー、トリガーとカード間のポインター移動をまたぐ遅延クローズ、解除、無効状態、保持される状態のアンマウント時クリーンアップ。開閉と解除では既存のフォーカスを維持します。タッチの長押しは、トリガーを起動せずにすぐプレビューし、次の押下まで続きます。インタラクティブなプレビューコントロールは提供されません。 |
| Input | Available | 保持される編集エンジンを通じた、単一行の編集、選択、クリップボード、フォーカス、ネイティブの入力インターフェース。 |
| Input OTP | Available | アプリケーションが描画するスロットを持つ、保持される 1 つの数値エディター。選択、クリップボード、削除、取り消し、無効/読み取り専用の状態、完了イベントを備えます。貼り付け後の値全体が収まり、ASCII 数字のみを含む必要があります。送信やコードの検証はありません。 |
| Label | Available | 既存の FocusHandle を渡すことでクリックによるフォーカスを行う、名前付きのネイティブなプレーンテキストラベル。明示的な無効フラグがあり、Tab ストップは追加されません。アプリケーションは対象をマウントしたままにし、そのアクセシブルな名前と一致する無効状態を用意します。起動の転送やネイティブの labelled-by 関係はありません。Field はより豊富なテキスト入力との関連付けを保持します。 |
| Menubar | Available | 協調して動くトップレベルのメニュー。Tab での入口は 1 つで、論理的な Left/Right と Home/End の移動、Down/Up による展開、メニューが開いている間のポインターによる切り替え、共有される Menu のコマンドセマンティクスを備えます。 |
| Native Select | Mapped | GPUI の Select で、アプリが渡した選択肢から 1 つの値を選びます。キーボード入力、無効な選択肢、ネイティブのアクセシビリティ情報に対応します。ブラウザーのフォーム送信と OS の選択 UI はプラットフォーム固有です。 |
| Navigation Menu | Available | 遷移先の Link、明示的な開閉エントリー、協調して動くポップアップ、ローヴィングフォーカス、論理的な矢印キー、メニューが開いている間のポインターによる切り替えを備えた、名前付きのナビゲーション。ポップアップの内容は通常のグループのままで、Tab による通常の移動ができます。ナビゲーションの遷移先はアプリケーションが所有します。 |
| Popover | Available | 角、または衝突を考慮した辺/アラインメントによる配置を持つ非モーダルなコンテンツ、保持される開閉状態、解除、通常のフォーカス移動、フォーカスの復帰。 |
| Progress | Available | 制御される既知の進捗または不定の状態。塗りのジオメトリとアニメーションはアプリケーションが担います。 |
| Radio Group | Available | 固定のアイテム、排他的な選択、ローヴィングな Tab の入口、矢印キーによる即時選択。 |
| Resizable | Available | 2 つ以上のパネル、水平/垂直の配置、パネルごとの割合およびピクセルでの計測による上下限 (リサイズ時に再調整)、連鎖するポインター/キーボードでのリサイズ、スナップ付きの折りたたみ可能なパネル、Enter による切り替えとサイズの復元、アプリケーションが保存したサイズのためのプログラムによるレイアウト復元、ネイティブのスプリッター値。保存先はアプリケーションが所有します。 |
| Scroll Area | Available | 既存のオーバーレイスクロールバーを備えたネイティブのビューポート、垂直/水平/両方の軸、保持されるオフセット、スコープ付きの子孫の表示。仮想化、ストリーミングのアンカー、別個のキーボードスクロールフォーカスはありません。 |
| Select | Available | マウントした状態で選択肢を入れ替えられます。確定値と開いているメニューのカーソルは、有効な同じ値を引き継ぎます。矢印キー、Home、End、文字検索で移動先を表示し、Enter で確定、Escape でトリガーに戻ります。 |
| Separator | Available | 水平/垂直の、セマンティックまたは装飾的な区切り。視覚スタイルはアプリケーションが用意します。 |
| Slider | Available | 順序付けされた単一/範囲/複数の値、サムごとのフォーカスと数値セマンティクス、最も近いサムへのポインター調整、交差しないステップ、垂直と RTL のジオメトリ。 |
| Switch | Available | 制御されるブール状態、ネイティブの起動、無効状態、フォーカス。トラックとサムはアプリケーションが用意します。 |
| Tabs | Available | 固定のアイテム、自動または手動のアクティベーション、向きに応じたナビゲーション、アクティブなパネルのみのマウント。 |
| Textarea | Available | 既存の TextareaState 編集エンジン上の公開された複数行レンダラー。2 つ目のエディター実装はありません。 |
| Toast | Available | 保持される通知の存続期間と、明示的/タイムアウトによる解除。ホバー、封じ込められたフォーカス、非アクティブなウィンドウでは残り時間が一時停止します。表示がフォーカスを奪うことはなく、フォーカスされた状態での明示的な解除は、以前のフォーカスを復元します。ToasterState は、アプリケーションが所有する値を、表示上限、待機中の古いエントリー、その場での置き換え、すべて解除、明示的なフォーカスの移動とともにスタックします。メッセージ、アクション、配置、種類ごとのスタイルはアプリケーションが担います。 |
| Toggle | Available | Button の起動とフォーカスの動作から合成される、制御された押下状態。 |
| Toggle Group | Available | 複数選択、または任意の単一選択を持つ固定のアイテムとローヴィングフォーカス。フォーカスの移動では押下値は変わりません。 |
| Tooltip | Available | Button に対するプレーンテキストのネイティブな説明。任意で非インタラクティブなリッチな可視コンテンツ、遅延ポインターホバー、即時のキーボードフォーカス、Escape による解除、GPUI ネイティブのツールチップ配置を備えます。インタラクティブなツールチップのコンテンツとタッチの長押しの動作は含まれません。インタラクティブなプレビューは HoverCard または Popover に属します。 |
プレゼンテーションと構成のレシピ
これらのエントリーが主に必要とするのは、一貫した視覚的デフォルトと適切なセマンティクスを備えた、再利用可能なソースの構成です。
既存の GPUI のレイアウトとコントロールが役割を果たすべきであり、視覚的な名前ごとに新しい状態コントローラーを追加する必要はありません。
公開されているレシピは crates/base/examples/recipes にあり、視覚的なスタイリングはコンシューマーに置き、ネイティブの two-style サンプルに組み込まれています。
| カタログエントリー | ステータス | 現在のスコープまたはギャップ |
|---|---|---|
| Alert | Recipe | インラインのタイトル/説明、デフォルトの情報提供用 Note セマンティクス、明示的な緊急の Alert セマンティクス、独立した破壊的スタイル。通知キュー、閉じる状態、ライブリージョンの配信コントローラーはありません。 |
| Aspect Ratio | Recipe | GPUI のレイアウトによる有限で正の幅/高さの比率、幅で制御されるフレーム、クリップされるアプリケーション所有のコンテンツ。ラッパーはロール、名前、フォーカスストップを追加しません。メディアのセマンティクスとオブジェクトフィットは子要素が担います。明示的な高さや最小/最大の制約は、GPUI の通常のレイアウトルールに従います。 |
| Avatar | Recipe | 画像がない、読み込み中、または失敗した場合のために、アプリケーションが明示的に渡すフォールバックテキストを持つ、名前付きの円形画像。読み込み、その遅延、キャッシュは GPUI が担います。ラッパーは 1 つの Image の名前を保持し、フォーカスストップはありません。AvatarGroup はアバターを重ねて表示し、表示数を制限し、隠れた人々を「+N」の Label で名前付けします。イニシャルの生成、ステータスバッジ、別個の読み込みコントローラーはありません。 |
| Badge | Recipe | secondary/accent の外観を持つ、静的で名前付きのラベル。クリック、トグル、自動的なライブアナウンスはありません。 |
| Button Group | Recipe | 連結された水平/垂直のボタン、共有される罫線、装飾的な区切り、任意の静的テキスト。既存の Button のアクション、無効状態、個別の Tab ストップは維持されます。ローヴィングな選択モデルはありません。 |
| Card | Recipe | 名前付きのリージョン、レベル 2 の見出し、説明、ヘッダーのアクション、コンテンツ、フッターのスロット。レイアウトとパレットはアプリケーションが担います。カードのフォーカスストップや状態コントローラーはありません。 |
| Empty | Recipe | 見出し、説明、任意のメディア、渡されたアクションを持つ、名前付きの静的なグループ。コマンド検索のサンプルは、既存の状態を使ってクエリをクリアし、入力フォーカスを復元します。読み込みコントローラーや自動的なライブアナウンスはありません。 |
| Input Group | Recipe | 既存の InputBase、CommandInput、またはその他の渡されたコントロールのための共有フレーム、先頭/末尾のアドオン、水平/垂直の配置、フォーカス/エラーのプレゼンテーション。ネイティブの編集、Field のメタデータ、アドオンのアクション、無効のポリシーは、渡されたコントロールとアプリケーションが担います。別個のエディターやフォーカスコントローラーはありません。 |
| Item | Recipe | タイトル、説明、先頭のメディア、全幅のヘッダー/フッター、渡された末尾のアクションを持つ、名前付きの行。スロットは自身のコンテンツのセマンティクスのみを持ち、フォーカスストップは追加しません。行全体の起動、選択、ItemGroup、リストコントローラーはありません。 |
| Kbd | Recipe | 記号と + で結合した組み合わせに対する読み上げ用ラベルの上書きを備えた、静的で名前付きのキーキャップ。フォーカスストップ、ショートカットの登録、イベントのディスパッチ、プラットフォームのグリフへの自動変換はありません。 |
| Pagination | Recipe | 制御される前へ/次へおよび番号付きページの Button、ネイティブの現在のページのメタデータ、一定幅の省略記号の連なり、名前付きのナビゲーション、空/最初/最後のページの境界。ルーティングやデータの読み込みはありません。 |
| Sheet | Recipe | 既存の Dialog ライフサイクルを使用する上/右/下/左のプレゼンテーション、ビューポートに制限された推奨サイズ、固定のヘッダー/フッター、1 つの垂直な ScrollArea の本体。アプリケーションは DialogState/ScrollHandle を保持し、ビューポートに収まるヘッダー/フッターのコンテンツを用意します。ドラッグ操作、アニメーション、別個のモーダル/スクロールキーのコントローラーはありません。 |
| Skeleton | Recipe | 幅、高さ、角丸、色をアプリケーションが制御する、静的で装飾的なプレースホルダー。フォーカスストップ、ネイティブのロール/名前、シマー、読み込み状態はありません。 |
| Spinner | Recipe | 回転する円弧、サイズ/色のスタイリング、GPUI App の reduced-motion サポートを備えた、名前付きの不定 Progress。マウントはアプリケーションが制御します。独立したタスク、タイマー、自動的なライブアナウンスはありません。 |
| Table | Available | 共有される固定/可変の列、ヘッダー/ボディ/フッターの行、キャプション、ネイティブのテーブル/行/セルのセマンティクス。アプリケーションが用意する行選択とヘッダーのソート方向は任意です。スパン、ソート/フィルタリングエンジン、選択コントローラー、仮想化はありません。 |
| Typography | Recipe | 明示的な正のレベルを持つ名前付きの Heading、インラインコード用のネイティブなスタイル付きテキストランを持つ Paragraph、ネイティブの Code セマンティクスを持つ独立して名前付けされる InlineCode。Paragraph はアクセシブルな名前を 1 つの完全な形で公開し、そのコード範囲には視覚的なスタイルはあっても、個別の Code ノードはありません。パレット、フォントの選択、幅、視覚的なサイズはアプリケーションが担います。Markdown パーサー、シンタックスハイライト、コピーアクション、エディターはありません。 |
より大きな複合的な機能
これらのエントリーは、低レベルの動作とプレゼンテーションを組み合わせて、より完全なワークフローにしたものです。 これらも幅の目標の一部であり、同じ入力、ポップアップ、フォーカス、スクロールの仕組みを独立して実装し直すのではなく、動作する共有コンポーネントから育てていくべきものです。
| カタログエントリー | ステータス | 現在のスコープまたはギャップ |
|---|---|---|
| Attachment | Recipe | 完全なファイル名で名付けられた静的なネイティブ Group、可視のメディアタイプ/サイズの説明、任意の既存のアクション。Help は CodeBlock と同じ文字列からメモリ内の JSON メタデータを導出し、Inspect JSON はそのコードのビューポートにフォーカスします。書式設定とアクションの動作はアプリケーションが担います。ファイルアクセス、アップロード/ダウンロード、進捗、プレビューレンダラー、コンテナーのフォーカスストップはありません。 |
| Bubble | Recipe | 受信/送信の会話サーフェス、グループ化された作成者/時刻のメタデータ、渡されたリアクションの Button。ローカルのトランスクリプトでデモしています。スタイリング、リアクションの値、メッセージの内容はアプリケーションが所有します。チャットのトランスポートはありません。 |
| Calendar | Available | 単一/複数/両端を含む範囲の選択、別個のフォーカス、設定可能な週の開始曜日を持つ 6 週間表示、無効な日付の述語、範囲内に制限されたナビゲーション、RTL、ネイティブの multiselectable メタデータ。範囲内で利用できない日付は、キーボードで見つけられますが選択できません。非グレゴリオ暦の計算、時計、タイムゾーン変換はありません。 選択を変更せずに指定した年月へ移動できます。 |
| Carousel | Available | 1 つ以上の連続するスライドを 1 ビューに表示し、最後のビューもいっぱいに表示しながら 1 スライドずつ進めます。境界で止まる、またはループする前へ/次へ、水平/垂直のキー、RTL、離散的なポインタースワイプ、ビュー内のみのマウント、スライドがビューを離れるときの安全なフォーカス、ホバー、フォーカス、非アクティブなウィンドウ、reduced-motion で一時停止しユーザーのナビゲーションで停止するオプトインの自動再生。メディア、スライド幅、アクション、再生/一時停止コントロールはアプリケーションが所有します。慣性やスナップ間の自由なスクロールはありません。 |
| Chart | Available | グループ化、積み上げ、円、レーダーのレイアウトにわたる、ヘッドレスなカテゴリーデータ、可視のシリーズ、ポインター/キーボードによるポイントの確認。レイアウトが範囲、積み上げの区間、スライスの割合、線形または角度による当たり判定を担います。軸またはスポークのラベル、凡例の Toggle、正確な値の表示、同じデータの Table を備えた、コピー可能なネイティブの折れ線/棒/面、積み上げ棒/面、円/ドーナツ、レーダーのプロット。負の値はゼロとは別に積み上げられ、正でない円の合計にはスライスがありません。時間/対数のスケール、スライスごとの凡例選択、外部のチャートエンジンはありません。 アプリがプロットと表の名前、カテゴリー列の見出し、単位と小数目盛りを含む数値書式を指定できます。 |
| Code Block | Recipe | 全文のネイティブな Code の名前を持つ読み取り専用の複数行コード、元の文字列をコピーする Button、2 軸に制限されたオーバーフローの ScrollArea。アプリケーションはスクロール/フォーカスのハンドルを保持します。フォーカスされたコードでの矢印/ページ/Home/End のナビゲーションと封じ込められたホイールスクロールは、親の境界を保ちます。パーサー、シンタックスハイライト、エディター、選択モデル、行番号、コピーのフィードバック状態はありません。 |
| Data Table | Recipe | 固定列、安定した ID を持つ差し替え可能な行、カスタムセルとテキスト・数値・日付のソートキーを提供します。更新後も検索、単一列ソート、列の表示設定、引き続き選べる行の選択を保持します。ページサイズの変更時は先頭に表示していた行を含むページに移動します。空状態、行アクション、ネイティブの選択・ソート情報も提供します。列の並べ替え、サーバーへの要求、仮想化はアプリが担当します。 |
| Date Picker | Available | Popover 内の単一/複数/範囲の Calendar の値。単一または完全な範囲の確定ではイベントの前に閉じ、部分的な値や複数の値では開いたままになります。プリセットの Button は同じプログラムによる setter を使用します。parse_date_text は、Schedule フィールドのように、アプリケーションが渡す today を基準に、入力された ISO の日付と英語の相対表現 (today、in 3 days、2 weeks ago) を読み取ります。トリガーの書式と外観はアプリケーションが所有します。他の言語、自由形式のフレーズ、プリセットの取得は提供されません。 |
| Drawer | Available | 4 辺に配置できるモーダルです。Dialog のフォーカス管理、Escape と背景クリックによる閉じ方を利用します。ハンドルを辺の方向へドラッグすると閉じます。上下のパネルはウィンドウの高さに対する割合で停止位置を設定できます。本文のスクロールや編集は独立して動作します。 |
| Marker | Recipe | 2 つの装飾的な Separator の間に、名前付きのネイティブな Label を 1 つ置く、静的な日付/ステータスの境界。テキストは制限された幅の中で折り返され、その内容と書式はアプリケーションが担います。Schedule は、別の日付やタイムラインの状態を持たずに、保持されている Calendar の選択を読み取ります。フォーカスストップ、アクション、自動的なライブアナウンスはありません。 |
| Message | Recipe | アプリケーションが渡す作成者/時刻の Label、折り返される Paragraph の本文、任意の既存のアクションを持つ、読み取り専用のネイティブな Comment。Schedule は、保持されているセッションのメモとそのローカルの編集時刻を表示し、共有の Textarea にフォーカスを戻す Button を備えます。メッセージのフォーカスストップ、配信状態、トランスポート、履歴、ストリーミング、自動的なライブアナウンスはありません。 |
| Message Scroller | Available | 安定したメッセージキー、初期/追加/ストリーミング時の最下部への追従、見えている履歴アンカーの同一フレームでの保持、未読数、最新へのジャンプを備えた既存の ScrollArea。仮想化、トランスポート、強制的なフォーカス変更はありません。 |
| Questionnaire | Available | アプリケーションが所有する型付きの回答、線形の質問/確認/完了の状態、バリデーションで制御される進行、Back、保持される回答。サンプルでは実際の Input エディターとアプリケーションが所有するフォーカスの変更を接続しています。スキーマインタープリターや条件分岐はありません。 |
| Sidebar | Recipe | 専用の TabsState 上で、通常の Button、明示的な起動、現在のページのメタデータを持つ名前付きのナビゲーション。静的なグループと任意の全体/グループの Collapsible 状態は、エントリーがアンマウントされるときに選択を保持しフォーカスを復元します。任意のアイコンレールは、名前付き、現在、フォーカス中のエントリーを、ホバーツールチップ付きのアイコンのみの Button としてマウントしたままにします。640 px 未満では、設定画面はナビゲーションを本文の上に置き、Projects カタログはナビゲーション用の Sheet を開きます。ルーティング、任意にネストされたメニューツリー、以前に TabList にバインドされた状態の再利用はありません。 |
| Trace | Recipe | 保持される Collapsible の状態の上に、アプリケーションが渡す要約、名前付きの読み取り専用 Paragraph の詳細、任意の既存のアクションを置きます。共有される Button の起動、展開/無効のメタデータ、アクティブなコンテンツのみのマウント、閉じるときのフォーカスが維持されます。Help は記録された操作ではなく現在のフォームの値を表示します。実行履歴、ストリーミング、パーサー、別個の開閉状態、スクロールコントローラーはありません。 |
完了基準と現在の作業
目標は、ネイティブ GPUI 上で、動作、アクセシビリティ、視覚的デフォルト、ソース配布にわたって shadcn/ui 水準の使いやすさを実現することです。66 エントリーのカタログが数えるのは、スコープのカバレッジだけです。
それは完了率でも、リリース準備が整っているという主張でもありません。上記の Available、Recipe、Mapped は、同等性が完了していることを意味しません。
作業は、別の進捗レポートを作らず、ここと Git で管理します。機能は、ドキュメント化されたコンシューマーの契約が実装され、ネイティブのサンプルで動作が確認され、既存の適切なテストレイヤーでカバーされ、正確にドキュメント化されたときに完了となります。プラットフォームでの観察は、自動チェックとは別に記録します。
| 優先度 | 作業 | 終了条件 | 現在の状態 |
|---|---|---|---|
| 1 | 既存の正確性とコアインタラクションのギャップ | 観察された不具合を修正する。単一選択の ToggleGroup と複数展開の Accordion をサポートする。ネイティブの値、キーボード/ポインターによる起動、無効状態、閉じるときのフォーカスを検証する | 重点的なテストとカタログのコンシューマーとともに実装済み |
| 2 | 残っている一般的なコンポーネントの契約 | 公式のコンポーネントのサンプルを上記の各スコープと照らして監査する。手動の Tabs アクティベーション、ポップアップの辺/アラインメント、範囲入力/日付選択、およびコンシューマーが必要とする残りの選択/テーブル/ナビゲーション機能を、重点的なテストとサンプルとともに実装する | 挙げられた一般的なギャップは実装済み。保持される値、構成、ソース配布、ネイティブメタデータの中核的な監査は完了。機能の制限は、スコープの表に明示されたまま |
| 3 | 視覚的デフォルトとアクセシビリティ | 一貫して見えるキーボードフォーカス、無効/ホバー/選択/エラーの状態、再利用可能でアプリケーションが所有するトークン、狭いウィンドウでのレイアウト、使えるライト/ダークのプレゼンテーション | カタログのフォーカスとコピー可能なライト/ダークのトークンは実装済み。ネイティブの Calendar/Sheet のスモークテストは実施済み。名前のないカタログのボタン/リンクは回帰テスト付きで修正済み。より広いネイティブでのレビューは未実施 |
| 4 | ソース配布と開発者体験 | 小さく完結したスターター、コンパイル可能な公開サンプル、明示されたサポート対象 API の境界、レシピの依存関係とトークンを解決するソースコピーのワークフロー | スターター、doctest のゲート、アプリケーショントークン、依存関係を認識するソース CLI は実装済み。サポート対象の入力/コントロールの境界とコンシューマー向けのテスト feature はドキュメント化済み。未使用の ThemeAppearance は削除済み |
| 5 | リリースの検証 | 既存のフォーマット、lint、動作テストスイート全体、ネイティブサンプルのビルドが通る。代表的なネイティブの IME、スクリーンリーダー、DPI、視覚的なフローについて、プラットフォームごとの観察がある | 未完了 |
各リビジョンの Rust の検査とネイティブサンプルのビルド結果は Verify ワークフローに記録されます。Docs ワークフローはインストール例の GPUI バージョンを検査し、WebAssembly プレビューをビルドしてブラウザーテストを実行します。
shadcn の公式サンプルがカバーする「提供されない」制限は、明示的な境界の範囲内で実装されました。入力された日付は、任意の自然言語ではなく ISO といくつかの英語の相対表現を受け付け、レイアウトの保存はアプリケーションに残ります。タッチの長押しは、GPUI のシミュレートされたタッチイベントでのみ検証されており、タッチハードウェアでは試していません。Carousel の自動再生、 Sidebar のレール、ControlField、AvatarGroup は、ヘッドレスと構成のカバレッジのみで、 ネイティブでの外観は観察していません。
既存のテストは、ドキュメント化された選択/オーバーレイの契約、保持される値の setter、利用できない Calendar の日付/RTL、テーブルの選択/表示切り替え、Sidebar を閉じる動作、 ネイティブの読み取り専用メタデータ、複数行/スクロールされた UTF-16 のポイント検索、モーダルフラグ (非モーダルの Popover を含む)、さらに装飾的な背景なしでの背景のポインター/ホイールの遮断をカバーしています。構成の チェックには、320/980 px での Sidebar と、320×520/980×840 での Sheet のすべての辺が含まれます。
ネイティブの Windows での観察は、starter の編集/Tab/Enter、Selection ビューと 範囲ポップアップ、利用できない日曜日のフォーカスとブロックされた起動、上部 Sheet の レイアウト/本体のスクロール/フォーカスの復帰をカバーしています。UI Automation の名前を確認し、 欠けていたものは修正し、Navigation/Selection で再度観察しました。これらは限定的な視覚とメタデータの観察であり、スクリーンリーダーの音声での検証ではありません。
その後のネイティブ Windows での検証 (QHD モニター 1 台、100% スケーリングを想定、ライトとダークの
プレゼンテーション) では、カタログの折れ線、積み上げ棒/面、円、
ドーナツ、レーダーの各チャート、レーダーのポインターによる確認、1 スライドおよび 2
スライド表示の Carousel と Next、Component APIs へ移動する Breadcrumb の省略記号メニューを観察しました。two_styles では、Item のメディア/ヘッダー/フッターのレイアウト、
リッチな Edit session のツールチップ、入力された日付 (「in 3 days」は適用され、「2026-02-30」は
Field のエラーを表示)、および Schedule の区切りが plan ペインの約 96 px の下限で止まることを観察しました。この検証により、レーダーのスポークラベルは外周から離れ、
Item のメディアにあったフォント依存の記録グリフは、描画したドットに置き換えられました。
未実施のものは、実際の韓国語/CJK の IME での composition/候補/確定/キャンセル、スクリーンリーダーの 音声とアクション、混在 DPI、タッチハードウェア、残りのデスクトップでの視覚的レビューです。自動化 ツールはハングルキーをサポートしていないため、そのネイティブのフローでは手動で韓国語 モードを選択する必要があります。ヘッドレスなハンドラーのテストは、ネイティブの IME の動作を裏付けるものではありません。全体の目標は未完了のままです。 公式の Accordion multiple の例、 Toggle Group の使い方、 Slider の range、 Calendar、 Combobox は、具体的な 動作のリファレンスとなります。Data Table ガイド と Sidebar は、 選択、列の表示切り替え、折りたたみ/グループの構成のリファレンスとなります。 Sheet のリファレンスは、 4 辺への配置を説明しています。Calendar の利用できない日付のフォーカスは、 APG の無効なグリッドに関するガイダンスに従っています。 そのアプリケーションの述語と週の順序は、明示的なネイティブの契約のままです。 紹介ページと テーマ設定ガイドも、視覚的デフォルトと ソースの再利用を目標の一部としています。ブラウザー固有の API には、追加のエイリアスではなく、明示的なネイティブの 同等機能が必要です。
Windows で実機確認する手順
リポジトリのルートで PowerShell を開き、確認したいサンプルのコマンドを実行します。次のサンプルを起動する前に、開いているサンプルのウィンドウを閉じてください。
cargo run -p gpui-deck --example starter --locked
cargo run -p gpui-deck --example catalogue --locked
cargo run -p gpui-deck --example two_styles --locked -- settingscatalogue では Navigation のほか、OTP、Drawer、Toast、メディア、チャート、会話、アンケートのサンプルも確認できます。
| 確認項目 | 操作 | 期待する結果 |
|---|---|---|
ハングルの組み立てとフォント · starter | タスクバーで韓国語 IME を 가 モードにします。Your name に 한글 と入力し、英数入力に切り替え、半角スペースと ABC 123 を続けて入力して Say hello を押します。 | 子音と母音を組み合わせる途中で文字が消えたり重複したりせず、結果に Hello, 한글 ABC 123! と表示されます。入力欄と結果の両方で文字が欠けず、四角い代替記号も出ません。 |
IME の変換候補 · starter | 入力欄を空にし、가 モードで 한 と入力して漢字変換キーを押します。Esc で一度キャンセルし、候補を開き直して一つ選びます。キーボード配列によっては右 Ctrl が漢字変換キーです。 | 入力カーソルの近くに候補が表示されます。キャンセルすると 한 が残り、候補を選ぶと選択した一文字に置き換わります。候補を選んだ時点では Say hello は実行されません。Microsoft の韓国語 IME ガイド |
スクリーンリーダーとキーボード · catalogue | Navigation タブで Project sections ボタンが現れるまでウィンドウ幅を狭めます。Windows のナレーターを起動し、アプリに戻って Tab でボタンに移動します。Enter で開き、Esc で閉じてから再び開きます。Tab で Members に移動し、Enter を押します。 | 読み上げだけでボタンと項目を区別できます。Esc で同じボタンにフォーカスが戻ります。Members を選ぶとパネルが閉じ、本文に Members が表示されます。ナレーターの起動と終了には Win+Ctrl+Enter を使います。Microsoft のナレーター ガイド |
表示倍率の異なるモニター · two_styles | 表示倍率が異なる 2 台のモニター(例:100% と 150%)の間で同じウィンドウを移動します。それぞれのモニターで最初の画面の Session actions を開き、Show cursor をクリックします。starter の漢字変換候補も両方のモニターで開きます。 | メニューはボタンの近くに、変換候補は入力カーソルの近くに表示されます。文字や枠線が欠けず、クリックすると状態が Cursor visible と Cursor hidden の間で切り替わります。 |
タッチ操作 · two_styles | タッチスクリーンで Session actions: right-click or の文言と Shift・F10 のキー表示がある概要欄を長押しします。指を離し、Show cursor をタップします。 | 指を離しても押した位置の近くにメニューが一つ残ります。項目をタップすると状態が一度だけ切り替わり、メニューが閉じます。 |
使用した入力方式、スクリーンリーダー、モニターの表示倍率と、実際に見えた内容や聞こえた内容を記録します。モニターが 1 台しかない場合やタッチスクリーンがない場合は、該当する項目を 未確認 とします。ブラウザーのプレビューと自動チェックの結果は実機での観察と分けて記録し、性能は測定した場合にのみ報告します。
参照上の違い
shadcn の紹介ページは、ソースの所有、 構成、配布、視覚的デフォルトを説明しています。同等の幅には、 ヘッドレスな動作だけでなく、コンシューマー向けのそれらのレシピも含まれます。
現在の Combobox のドキュメントは、編集可能なオートコンプリートと追加の選択バリエーションを扱っています。 ここでの実装は、グループ化された単一/複数選択とアイテムの 置き換えを提供します。チップのプレゼンテーションと非同期リクエストの 所有はアプリケーションに残ります。これらの機能は、コンポーネントを増やすのではなく、同じファミリーを深めるものです。 Command は、2 つ目の独立した コマンドエンジンを必要とせず、ダイアログとの合成を含んでいます。
Date Picker は、 カレンダーとポップアップの部品から構成されます。 Data Table は、 共有された基盤の上にアプリケーション固有のテーブルを構築するためのガイドです。 Native Select は、 ブラウザーの HTML コントロールを明示的にラップしているため、そのプラットフォームの契約には適応が必要です。