GPUI Deck

커버리지와 현황

**2026-11-21**에 확인한 참조 카탈로그: shadcn/ui All Components.

2026-11-21에 확인한 참조 카탈로그: shadcn/ui All Components. 주 카탈로그에는 66개 항목이 있으며, 아래에 각각 한 번씩 나열합니다. 별도의 AI Elements 카탈로그는 이 비교 대상이 아닙니다. 주 카탈로그에 이미 있는 대화 컴포넌트는 계속 포함합니다.

GPUI Deck은 42개의 공개 라이브러리 패밀리와 23개의 복사 가능한 화면 표현/조합 레시피를 문서화하며, 이를 통해 65개의 서로 다른 구현을 제공합니다. 나머지 카탈로그 항목인 Native Select는 GPUI에서 명시적으로 Select에 매핑됩니다. 아래 66개 참조 항목 모두가 구현된 범위나 플랫폼 매핑을 가지며, 할당되지 않았거나 Pending 상태로 남은 항목은 없습니다.

이는 카탈로그 커버리지이며, shadcn/ui와의 완전한 기능 동등성이 아닙니다. 각 계약에는 명시적인 한계가 있으며, HTML 전용 매핑은 브라우저 컨트롤이나 운영체제 선택기를 구현하지 않습니다. 이 수치는 성능, 접근성 적합성, 네이티브 데스크톱 검증 완료 여부를 측정하지 않습니다.

목표는 비교 가능한 애플리케이션 구축 범위입니다. 공유 동작은 라이브러리에 두고, 재사용 가능한 화면 표현과 화면 조합의 소스는 애플리케이션에 속합니다. 아래 그룹은 shadcn의 내부 아키텍처가 아니라 우리의 구현 책임을 설명합니다. two_styles와 catalogue 네이티브 예제는 재사용 가능한 화면 표현 레시피를 사용합니다. 레시피 소스는 이 저장소에서 배포되며, 로컬 소스 CLI가 레시피, 의존성, 토큰, 라이선스를 소비자가 소유하는 모듈에 설치합니다. 원격 레지스트리는 제공하지 않습니다.

상태의 의미

  • Available: 공개 패밀리와 소비자 예제가 명시된 범위를 다룹니다.
  • Recipe: 재사용 가능한 애플리케이션 소스와 동작하는 소비자 예제가 명시된 화면 표현을 다룹니다. 레시피는 라이브러리의 공개 export 밖에 있습니다.
  • Mapped: 명시적인 GPUI 플랫폼 대응물이 네이티브 애플리케이션의 필요를 충족합니다. 브라우저 전용 계약은 별칭 뒤에 숨기지 않고 문서화합니다.

동작과 시맨틱 기반

이 컴포넌트들은 상호작용, 상태, 포커스, 또는 재사용 가능한 시맨틱 계약을 소유합니다. 외형은 계속 애플리케이션이 소유합니다. 구현된 정확한 API는 폼 가이드, 내비게이션과 오버레이 가이드, 레이아웃과 데이터 가이드에서 설명합니다.

카탈로그 항목상태현재 범위 또는 공백
AccordionAvailable고정 항목, 단일/다중 열린 섹션, 독립적인 헤더 탐색, 활성 패널만 렌더링.
Alert DialogAvailableAlertDialog는 Dialog의 상태와 포커스를 재사용합니다. 배경 클릭 닫기는 차단되며 확인은 애플리케이션에 속합니다.
BreadcrumbAvailable현재 항목에 aria_current(Page)를 둔, 이름이 있는 네이티브 Navigation, List, ListItem 구조. 접힌 상위 항목과 크럼별 드롭다운은 카탈로그의 Home › … › page 경로처럼 항목 안에 일반 DropdownMenu를 조합합니다. 애플리케이션이 경로, 상위 Button, 이동 콜백, 구분자, 접기 정책, 스타일을 제공합니다. 라우팅, 너비 측정, 포커스 컨트롤러는 없습니다.
ButtonAvailable네이티브 포인터/키보드 활성화, 비활성화 상태, 포커스, 접근 가능한 이름, 선택 스타일과 독립적인 명시적 현재 페이지 메타데이터. 콘텐츠와 스타일은 애플리케이션에 속합니다. 복사형 레시피로 여섯 가지 버튼 스타일을 제공합니다.
CheckboxAvailable제어되는 checked/unchecked/mixed 상태. 애플리케이션이 표시기와 레이블 화면 표현을 제공합니다.
CollapsibleAvailable하나의 유지되는 펼침 상태, Button 트리거, 활성 콘텐츠만 렌더링, 콘텐츠가 닫힐 때의 포커스 처리.
ComboboxAvailable편집 가능한 단일/다중 선택, 그룹으로 묶인 결과, 제거 가능한 선택 값, 네이티브 쿼리/포커스/IME와 남은 선택을 보존하는 교체 가능한 항목. 가져오기/요청 순서는 애플리케이션이 소유합니다. 자유 형식 값이나 네트워크 관리자는 없습니다.
CommandAvailable교체 가능한 명령 항목, 이름이 있는 결과 그룹, 단어 시작 우선순위와 연속 그룹을 갖춘 순서 기반(퍼지) 순위 매칭, 키보드/포인터 액션, Dialog 조합. 항목 교체 시 네이티브 쿼리와 남은 하이라이트가 보존됩니다. 가져오기는 애플리케이션이 소유합니다.
Context MenuAvailable보조 클릭과 키보드로 열기, 포커스 가능한 대상, 공유되는 일반/checked/mixed/radio 명령과 리프 디스패치를 갖춘 중첩 하위 메뉴, 닫기, 포커스 복원. 값은 애플리케이션이 소유합니다. 터치 길게 누르기는 누른 위치에서 메뉴를 엽니다. 대상 콘텐츠는 상호작용하지 않습니다.
DialogAvailable모달 열기/닫기, 네이티브 모달 플래그, 장식용 배경 유무와 관계없는 배경 포인터/휠 격리, 초기 포커스, 포커스 가두기, 닫기, 포커스 반환. 애플리케이션이 표면과 콘텐츠를 제공합니다.
DirectionAvailable범위가 지정된 DirectionProvider, 중첩 재정의, 논리적 행 레이아웃, Tabs, RadioGroup, ToggleGroup, Slider, Carousel, Chart, Menubar, NavigationMenu의 상속된 가로 탐색. Slider 포인터 기하도 반전됩니다. 애플리케이션 레이아웃은 Direction::row를 사용하며, 텍스트 셰이핑과 편집은 GPUI가 소유합니다.
Dropdown MenuAvailable공유 메뉴로 들어가는 Button, 애플리케이션이 제어하는 checked/mixed/radio 시맨틱, 활성 항목 탐색, 한 글자 검색, 중첩 하위 메뉴 탐색. 리프 활성화는 하나의 루트 액션을 내보내기 전에 메뉴 트리를 닫습니다. 두 번째 선택 저장소는 없습니다.
FieldAvailableCombobox 쿼리를 포함한 기존 Input/Textarea 기반 컨트롤에 레이블 포커스, 도움말/오류 설명, required/invalid 메타데이터를 제공합니다. ControlField는 Checkbox, Switch, RadioGroup, Select에 같은 레이블, 도움말보다 오류를 먼저 두는 설명, required/invalid 메타데이터를 제공하며, 레이블 클릭으로 컨트롤에 포커스를 주고 선택적으로 활성화합니다. 검증은 애플리케이션이 소유합니다.
Hover CardAvailable지연된 호버나 트리거 포커스에서 나타나는 상호작용하지 않는 풍부한 미리보기, 트리거/카드 사이 포인터 이동 시 지연된 닫힘, 닫기, 비활성화 상태, 유지되는 상태의 언마운트 정리. 열기와 닫기는 기존 포커스를 보존합니다. 터치 길게 누르기는 트리거를 활성화하지 않고 다음 누르기까지 즉시 미리보기를 보여줍니다. 상호작용하는 미리보기 컨트롤은 제공하지 않습니다.
InputAvailable유지되는 편집 엔진을 통한 한 줄 편집, 선택, 클립보드, 포커스, 네이티브 입력 인터페이스.
Input OTPAvailable애플리케이션이 렌더링하는 슬롯, 선택, 클립보드, 삭제, 실행 취소, 비활성화/읽기 전용 상태, 완료 이벤트를 갖춘 하나의 유지되는 숫자 편집기. 붙여넣은 결과 값 전체가 맞아야 하며 ASCII 숫자여야 합니다. 전송이나 코드 검증은 없습니다.
LabelAvailable제공된 기존 FocusHandle을 통한 클릭 시 포커스, 명시적 비활성화 플래그를 갖추고 추가 Tab 스톱이 없는, 이름이 있는 네이티브 일반 텍스트 레이블. 애플리케이션은 대상을 마운트된 상태로 유지하고 접근 가능한 이름과 일치하는 비활성화 상태를 제공합니다. 활성화 전달이나 네이티브 labelled-by 관계는 없으며, Field는 더 풍부한 텍스트 입력 연결을 유지합니다.
MenubarAvailable하나의 Tab 진입점을 갖춘 조정된 최상위 메뉴, 논리적 Left/Right와 Home/End 이동, Down/Up으로 열기, 열린 메뉴 사이 포인터 전환, 공유 Menu 명령 시맨틱.
Native SelectMappedGPUI Select로 앱이 제공하는 옵션 중 한 값을 선택합니다. 키보드 입력, 비활성 옵션, 네이티브 접근성 메타데이터를 지원합니다. 브라우저 폼 제출과 운영체제 선택기 UI는 플랫폼별 동작입니다.
Navigation MenuAvailable목적지 Link, 명시적 펼침 항목, 조정된 팝업, 로빙 포커스, 논리적 화살표, 열린 메뉴 사이 포인터 전환을 갖춘 이름이 있는 내비게이션. 팝업 콘텐츠는 일반 Tab 순회를 하는 일반 그룹으로 남습니다. 내비게이션 목적지는 애플리케이션이 소유합니다.
PopoverAvailable모서리 또는 충돌을 고려한 side/alignment 배치, 유지되는 열림 상태, 닫기, 일반 포커스 순회, 포커스 반환을 갖춘 비모달 콘텐츠.
ProgressAvailable제어되는 확정 진행률 또는 불확정 상태. 채움 기하와 애니메이션은 애플리케이션이 소유합니다.
Radio GroupAvailable고정 항목, 배타적 선택, 로빙 Tab 진입, 화살표로 즉시 선택.
ResizableAvailable둘 이상의 패널, 가로/세로 배치, 크기 조정 시 다시 맞추는 패널별 비율 및 측정된 픽셀 한계, 연쇄되는 포인터/키보드 크기 조정, 스냅·Enter 토글·크기 복원을 갖춘 접을 수 있는 패널, 애플리케이션이 저장한 크기를 위한 프로그래밍 방식 레이아웃 복원, 네이티브 분할자 값. 저장 위치는 애플리케이션이 소유합니다.
Scroll AreaAvailable기존 오버레이 스크롤바를 갖춘 네이티브 뷰포트, 세로/가로/양축, 유지되는 오프셋, 범위가 지정된 하위 요소 노출. 가상화, 스트리밍 고정, 별도의 키보드 스크롤 포커스는 없습니다.
SelectAvailable마운트된 상태에서 옵션 목록을 교체할 수 있습니다. 선택값과 열린 목록의 커서는 같은 값의 활성 옵션을 따라갑니다. 방향키·Home·End·문자 검색으로 이동하면 해당 행이 보이고, Enter로 확정하거나 Escape로 트리거에 돌아갑니다.
SeparatorAvailable가로/세로, 시맨틱 또는 장식용 구분. 애플리케이션이 시각 스타일을 제공합니다.
SliderAvailable썸별 포커스와 숫자 시맨틱을 갖춘 정렬된 단일/범위/다중 값, 가장 가까운 썸의 포인터 조정, 교차하지 않는 단계, 세로 및 RTL 기하.
SwitchAvailable제어되는 불리언 상태, 네이티브 활성화, 비활성화 상태, 포커스. 애플리케이션이 트랙과 썸을 제공합니다.
TabsAvailable고정 항목, 자동 또는 수동 활성화, 방향을 고려한 탐색, 활성 패널만 렌더링.
TextareaAvailable기존 TextareaState 편집 엔진 위의 공개 여러 줄 렌더러. 두 번째 편집기 구현은 없습니다.
ToastAvailable유지되는 알림 수명과 명시적/시간 초과 닫기. 호버, 포함된 포커스, 비활성 창에서는 남은 시간이 일시 정지됩니다. 표시할 때 포커스를 가져가지 않으며, 포커스된 상태에서 명시적으로 닫으면 이전 포커스를 복원합니다. ToasterState는 애플리케이션이 소유하는 값을 표시 한도, 대기하는 이전 항목, 제자리 교체, 모두 닫기, 명시적 포커스 진입과 함께 쌓습니다. 메시지, 액션, 배치, 유형별 스타일은 애플리케이션이 소유합니다.
ToggleAvailableButton의 활성화와 포커스 동작으로 조합한 제어되는 눌림 상태.
Toggle GroupAvailable다중 또는 선택적 단일 선택과 로빙 포커스를 갖춘 고정 항목. 포커스를 옮겨도 눌림 값은 바뀌지 않습니다.
TooltipAvailable선택적으로 상호작용하지 않는 풍부한 표시 콘텐츠를 갖춘 Button용 일반 텍스트 네이티브 설명, 지연된 포인터 호버, 즉시 키보드 포커스, Escape 닫기, 네이티브 GPUI 툴팁 배치. 상호작용하는 툴팁 콘텐츠와 터치 길게 누르기 동작은 포함하지 않습니다. 상호작용하는 미리보기는 HoverCard나 Popover에 속합니다.

화면 표현과 조합 레시피

이 항목들은 주로 일관된 시각 기본값과 적절한 시맨틱을 갖춘 재사용 가능한 소스 조합이 필요합니다. 기존 GPUI 레이아웃과 컨트롤이 작업을 맡아야 하며, 시각적 이름마다 새로운 상태 컨트롤러를 추가할 필요는 없습니다. 배포되는 레시피는 crates/base/examples/recipes에 있으며, 시각 스타일은 소비자에게 두고, 네이티브 two-style 예제에 조합됩니다.

카탈로그 항목상태현재 범위 또는 공백
AlertRecipe인라인 제목/설명, 기본 정보용 Note 시맨틱, 명시적 긴급 Alert 시맨틱, 독립적인 파괴적 스타일. 알림 큐, 닫기 상태, 라이브 영역 전달 컨트롤러는 없습니다.
Aspect RatioRecipeGPUI 레이아웃을 통한 유한한 양수 너비/높이 비율, 너비로 제어되는 프레임, 잘린 애플리케이션 소유 콘텐츠. 래퍼는 역할, 이름, 포커스 스톱을 추가하지 않으며, 미디어 시맨틱과 object fit은 자식에 속합니다. 명시적 높이나 최소/최대 제약은 GPUI의 일반 레이아웃 규칙을 따릅니다.
AvatarRecipe소스가 없거나 대기 중이거나 실패했을 때 애플리케이션이 제공하는 명시적 대체 텍스트를 갖춘 이름이 있는 원형 이미지. 로딩, 로딩 지연, 캐싱은 GPUI가 소유하며, 래퍼는 하나의 Image 이름을 유지하고 포커스 스톱이 없습니다. AvatarGroup은 아바타를 겹치고, 보이는 수를 제한하며, 숨겨진 사람을 "+N" Label로 명명합니다. 이니셜 생성기, 상태 배지, 별도의 로딩 컨트롤러는 없습니다.
BadgeRecipesecondary/accent 외형을 갖춘 정적인 이름이 있는 레이블. 클릭, 토글, 자동 라이브 알림은 없습니다.
Button GroupRecipe연결된 가로/세로 버튼, 공유 테두리, 장식용 구분자, 선택적 정적 텍스트. 기존 Button 액션, 비활성화 상태, 개별 Tab 스톱이 보존되며, 로빙 선택 모델은 없습니다.
CardRecipe이름이 있는 영역, 2단계 제목, 설명, 헤더 액션, 콘텐츠, 푸터 슬롯. 레이아웃과 팔레트는 애플리케이션에 속하며, 카드 포커스 스톱이나 상태 컨트롤러는 없습니다.
EmptyRecipe제목, 설명, 선택적 미디어, 제공된 액션을 갖춘 이름이 있는 정적 그룹. 명령 검색 예제는 기존 상태를 통해 쿼리를 지우고 입력 포커스를 복원합니다. 로딩 컨트롤러나 자동 라이브 알림은 없습니다.
Input GroupRecipe기존 InputBase, CommandInput 또는 제공된 다른 컨트롤을 위한 공유 프레임, 앞/뒤 애드온, 가로/세로 배치, 포커스/오류 화면 표현. 네이티브 편집, Field 메타데이터, 애드온 액션, 비활성화 정책은 제공된 컨트롤과 애플리케이션에 남습니다. 별도의 편집기나 포커스 컨트롤러는 없습니다.
ItemRecipe제목, 설명, 앞쪽 미디어, 전체 너비 헤더/푸터, 제공된 뒤쪽 액션을 갖춘 이름이 있는 행. 슬롯은 콘텐츠의 시맨틱만 전달하고 포커스 스톱을 추가하지 않습니다. 행 전체 활성화, 선택, ItemGroup, 목록 컨트롤러는 없습니다.
KbdRecipe기호와 +로 연결한 조합에 대한 읽기 쉬운 레이블 재정의를 갖춘 정적인 이름이 있는 키캡. 포커스 스톱, 단축키 등록, 이벤트 디스패치, 자동 플랫폼 글리프 변환은 없습니다.
PaginationRecipe제어되는 이전/다음 및 번호가 매겨진 페이지 Button, 네이티브 현재 페이지 메타데이터, 일정한 너비의 생략 구간, 이름이 있는 내비게이션, 빈/첫/마지막 페이지 경계. 라우팅이나 데이터 로딩은 없습니다.
SheetRecipe기존 Dialog 생명주기를 사용하는 위/오른쪽/아래/왼쪽 화면 표현, 뷰포트로 제한되는 선호 크기, 고정 헤더/푸터, 하나의 세로 ScrollArea 본문. 애플리케이션은 DialogState/ScrollHandle을 유지하고 뷰포트에 맞는 헤더/푸터 콘텐츠를 제공합니다. 드래그 상호작용, 애니메이션, 별도의 모달/스크롤 키 컨트롤러는 없습니다.
SkeletonRecipe애플리케이션이 제어하는 너비, 높이, 둥글기, 색상을 갖춘 정적 장식용 자리 표시자. 포커스 스톱, 네이티브 역할/이름, 반짝임 효과, 로딩 상태는 없습니다.
SpinnerRecipe회전하는 호, 크기/색상 스타일, GPUI App의 모션 감소 지원을 갖춘 이름이 있는 불확정 Progress. 마운트는 애플리케이션이 제어하며, 독립적인 작업, 타이머, 자동 라이브 알림은 없습니다.
TableAvailable공유되는 고정/유연 열, 헤더/본문/푸터 행, 캡션과 네이티브 table/row/cell 시맨틱, 애플리케이션이 선택적으로 제공하는 행 선택과 헤더 정렬 방향. 병합, 정렬/필터링 엔진, 선택 컨트롤러, 가상화는 없습니다.
TypographyRecipe명시적 양수 레벨을 갖춘 이름이 있는 Heading, 인라인 코드를 위한 네이티브 스타일 텍스트 런을 갖춘 Paragraph, 네이티브 Code 시맨틱을 갖추고 독립적으로 이름이 붙는 InlineCode. Paragraph는 하나의 완전한 접근 가능한 이름을 노출하며, 코드 범위는 별도의 Code 노드 없이 시각 스타일만 갖습니다. 팔레트, 글꼴 선택, 너비, 시각적 크기는 애플리케이션에 속합니다. Markdown 파서, 구문 강조, 복사 액션, 편집기는 없습니다.

더 큰 결합 기능

이 항목들은 하위 수준의 동작과 화면 표현을 결합해 더 완전한 워크플로를 만듭니다. 여전히 범위 목표의 일부이며, 같은 입력, 팝업, 포커스, 스크롤 기구를 독립적으로 다시 구현하기보다 동작하는 공유 컴포넌트에서 성장해야 합니다.

카탈로그 항목상태현재 범위 또는 공백
AttachmentRecipe전체 파일 이름으로 명명된 정적 네이티브 Group, 보이는 미디어 유형/크기 설명, 선택적 기존 액션. Help는 CodeBlock과 같은 문자열에서 메모리 내 JSON 메타데이터를 만들며, Inspect JSON은 해당 코드 뷰포트에 포커스를 줍니다. 서식과 액션 동작은 애플리케이션에 속합니다. 파일 접근, 업로드/다운로드, 진행률, 미리보기 렌더러, 컨테이너 포커스 스톱은 없습니다.
BubbleRecipe로컬 대화 기록에서 보여주는 수신/발신 대화 표면, 그룹으로 묶인 작성자/시간 메타데이터, 제공된 반응 Button. 스타일, 반응 값, 메시지 콘텐츠는 애플리케이션이 소유하며, 채팅 전송은 없습니다.
CalendarAvailable단일/다중/포함 범위 선택, 별도의 포커스, 설정 가능한 첫 요일을 갖춘 6주, 비활성화 날짜 조건자, 제한된 탐색, RTL, 네이티브 multiselectable 메타데이터. 범위 안의 사용할 수 없는 날짜는 키보드로 찾을 수 있지만 선택할 수 없습니다. 비그레고리력 계산, 시계, 시간대 변환은 없습니다. 선택값을 유지하면서 지정한 연월로 바로 이동할 수 있습니다.
CarouselAvailable뷰당 하나 이상의 연속 슬라이드를 한 슬라이드씩 넘기며 마지막 뷰를 채움, 제한 또는 순환 이전/다음, 가로/세로 키, RTL, 불연속 포인터 스와이프, 보이는 슬라이드만 마운트, 슬라이드가 뷰를 벗어날 때의 안전한 포커스, 호버·포커스·비활성 창·모션 감소에서 일시 정지하고 사용자 탐색 시 멈추는 선택적 자동 재생. 미디어, 슬라이드 너비, 액션, 재생/일시 정지 컨트롤은 애플리케이션이 소유합니다. 관성이나 스냅 사이의 자유 스크롤은 없습니다.
ChartAvailable그룹, 누적, 파이, 레이더 레이아웃에 걸친 헤드리스 범주형 데이터, 보이는 시리즈, 포인터/키보드 데이터 포인트 검사. 레이아웃이 범위, 누적 구간, 조각 비율, 선형 또는 각도 기반 히트 테스트를 소유합니다. 축 또는 방사형 레이블, 범례 Toggle, 정확한 값 표시, 같은 데이터의 Table을 갖춘 복사 가능한 네이티브 line/bar/area, 누적 bar/area, pie/donut, radar 플롯. 음수 값은 0과 별도로 누적되며, 합계가 양수가 아닌 파이에는 조각이 없습니다. 시간/로그 척도, 조각별 범례 선택, 외부 차트 엔진은 없습니다. 앱이 차트·표 이름, 범주 열 제목과 숫자 서식을 지정해 단위와 소수 눈금을 표시할 수 있습니다.
Code BlockRecipe전체 텍스트를 네이티브 Code 이름으로 갖는 읽기 전용 여러 줄 코드, 원본 문자열을 복사하는 Button, 제한된 양축 ScrollArea 오버플로. 애플리케이션이 스크롤/포커스 핸들을 유지합니다. 포커스된 코드의 화살표/페이지/Home/End 탐색과 포함된 휠 스크롤은 부모 경계를 보존합니다. 파서, 구문 강조, 편집기, 선택 모델, 줄 번호, 복사 피드백 상태는 없습니다.
Data TableRecipe고정 열, 안정적인 ID로 교체할 수 있는 행, 사용자 정의 셀과 텍스트·숫자·날짜 정렬 키를 제공합니다. 행을 새로 고쳐도 검색, 단일 열 정렬, 열 표시 설정과 유효한 행의 선택이 유지됩니다. 페이지 크기를 바꾸면 기존 첫 행이 보이는 페이지로 이동합니다. 빈 상태, 행 액션, 네이티브 선택·정렬 정보도 제공합니다. 열 재배치, 서버 요청, 가상화는 앱이 담당합니다.
Date PickerAvailablePopover 안의 단일/다중/범위 Calendar 값. 단일/완성된 범위 활성화는 이벤트 전에 닫히고, 부분/다중 값은 열린 상태를 유지합니다. 프리셋 Button은 같은 프로그래밍 방식 설정자를 사용합니다. parse_date_text는 Schedule 필드처럼 애플리케이션이 제공하는 오늘 날짜를 기준으로 입력된 ISO 날짜와 영어 상대 표현(today, in 3 days, 2 weeks ago)을 읽습니다. 트리거 서식과 외형은 애플리케이션이 소유합니다. 다른 언어, 자유 형식 구문, 프리셋 가져오기는 제공하지 않습니다.
DrawerAvailable네 방향 모달 패널로 Dialog의 포커스 처리, Escape와 배경 클릭 닫기를 사용합니다. 손잡이를 가장자리로 끌면 닫힙니다. 위·아래 패널은 창 높이의 일정 비율에 멈추도록 설정할 수 있습니다. 본문 스크롤과 입력은 독립적으로 동작합니다.
MarkerRecipe두 개의 장식용 Separator 사이에 이름이 있는 네이티브 Label 하나를 둔 정적 날짜/상태 경계. 텍스트는 제한된 너비 안에서 줄바꿈되며, 콘텐츠와 서식은 애플리케이션에 속합니다. Schedule은 다른 날짜나 타임라인 상태 없이 유지되는 Calendar 선택을 읽습니다. 포커스 스톱, 액션, 자동 라이브 알림은 없습니다.
MessageRecipe애플리케이션이 제공하는 작성자/시간 Label, 줄바꿈되는 Paragraph 본문, 선택적 기존 액션을 갖춘 읽기 전용 네이티브 Comment. Schedule은 유지되는 세션 메모와 로컬 편집 시간을 보여주며, Button으로 공유 Textarea에 포커스를 돌려줍니다. 메시지 포커스 스톱, 전달 상태, 전송, 기록, 스트리밍, 자동 라이브 알림은 없습니다.
Message ScrollerAvailable안정적인 메시지 키, 초기/추가/스트림 하단 따라가기, 보이는 기록 고정점의 같은 프레임 보존, 읽지 않은 수, 최신으로 이동을 갖춘 기존 ScrollArea. 가상화, 전송, 강제 포커스 변경은 없습니다.
QuestionnaireAvailable선형 질문/검토/완료 상태, 검증으로 제한되는 진행, Back, 유지되는 답변을 갖춘 타입이 지정된 애플리케이션 소유 답변. 예제는 실제 Input 편집기와 애플리케이션이 소유하는 포커스 변경을 연결합니다. 스키마 해석기나 조건부 분기는 없습니다.
SidebarRecipe전용 TabsState 위에서 일반 Button, 명시적 활성화, 현재 페이지 메타데이터를 갖춘 이름이 있는 내비게이션. 정적 그룹과 선택적 전체/그룹 Collapsible 상태는 선택을 보존하고 항목이 언마운트될 때 포커스를 복원합니다. 선택적 아이콘 레일은 이름이 있는 현재/포커스된 항목을 호버 툴팁을 갖춘 아이콘 전용 Button으로 마운트된 상태로 유지합니다. 640 px 미만에서 Settings는 탐색을 본문 위에 배치하고, Projects 카탈로그는 탐색용 Sheet를 제공합니다. 라우팅, 임의의 중첩 메뉴 트리, 이전에 TabList에 바인딩된 상태의 재사용은 없습니다.
TraceRecipe유지되는 Collapsible 상태 위에서 애플리케이션이 제공하는 요약, 이름이 있는 읽기 전용 Paragraph 세부 내용, 선택적 기존 액션. 공유 Button 활성화, expanded/disabled 메타데이터, 활성 콘텐츠만 렌더링, 닫힐 때의 포커스가 보존됩니다. Help는 기록된 작업이 아니라 현재 폼 값을 보여줍니다. 실행 기록, 스트리밍, 파서, 별도의 펼침 상태, 스크롤 컨트롤러는 없습니다.

완료 기준과 현재 작업

목표는 네이티브 GPUI에서 동작, 접근성, 시각 기본값, 소스 배포 전반에 걸친 shadcn/ui 수준의 사용성입니다. 66개 항목 카탈로그는 범위 커버리지만 셉니다. 이는 완료율이나 출시 준비 상태에 대한 주장이 아닙니다. 위의 Available, Recipe, Mapped는 동등성이 완성되었다는 뜻이 아닙니다.

작업은 별도의 진행 보고서 없이 이곳과 Git에서 추적합니다. 기능은 문서화된 소비자 계약이 구현되고, 네이티브 예제에서 실행되고, 적절한 기존 테스트 계층에서 다뤄지고, 정확하게 문서화되었을 때 완료됩니다. 플랫폼 관찰은 자동화된 검사와 별도로 기록합니다.

우선순위작업종료 조건현재 상태
1기존 정확성과 핵심 상호작용 공백관찰된 실패를 수정하고, 단일 선택 ToggleGroup과 다중 열림 Accordion을 지원하며, 네이티브 값, 키보드/포인터 활성화, 비활성화 상태, 닫힐 때의 포커스를 검증집중된 테스트와 카탈로그 소비자로 구현됨
2남은 공통 컴포넌트 계약공식 컴포넌트 예제를 위의 각 범위와 대조해 점검하고, 수동 Tabs 활성화, 팝업 side/alignment, 범위 입력/날짜 선택, 소비자가 요구하는 나머지 선택/테이블/내비게이션 기능을 집중된 테스트 및 예제와 함께 구현나열된 공통 공백 구현됨. 핵심 유지 값, 조합, 소스 배포, 네이티브 메타데이터 점검 완료. 기능 한계는 범위 표에 명시적으로 남아 있음
3시각 기본값과 접근성일관되게 보이는 키보드 포커스, 비활성화/호버/선택/오류 상태, 재사용 가능한 애플리케이션 소유 토큰, 좁은 창 레이아웃, 사용 가능한 라이트/다크 화면 표현카탈로그 포커스와 복사 가능한 라이트/다크 토큰 구현됨. 네이티브 Calendar/Sheet 스모크 수행. 이름 없는 카탈로그 버튼/링크를 회귀 커버리지와 함께 수정. 더 넓은 네이티브 검토는 대기 중
4소스 배포와 개발자 경험작고 완전한 starter, 컴파일 가능한 공개 예제, 명시적으로 지원되는 API 경계, 레시피 의존성과 토큰을 해결하는 소스 복사 워크플로Starter, doctest 게이트, 애플리케이션 토큰, 의존성을 인식하는 소스 CLI 구현됨. 지원되는 입력/컨트롤 경계와 소비자 테스트 feature 문서화. 사용하지 않는 ThemeAppearance 제거
5출시 검증기존 포매팅, 린트, 전체 동작 스위트, 네이티브 예제 빌드 통과. 대표적인 네이티브 IME, 스크린리더, DPI, 시각 흐름에 대한 플랫폼별 관찰 확보완료되지 않음

각 리비전의 Rust 검사와 네이티브 예제 빌드 결과는 Verify 워크플로에서 확인할 수 있습니다. Docs 워크플로는 설치 예제의 GPUI 버전, WebAssembly 미리보기 빌드와 사이트의 브라우저 테스트를 확인합니다.

shadcn의 공식 예제가 다루는 "제공하지 않음" 한계는 이제 명시적인 경계 안에서 구현되었습니다. 입력된 날짜는 임의의 자연어가 아니라 ISO와 몇 가지 영어 상대 표현을 받으며, 레이아웃 저장은 애플리케이션에 남습니다. 터치 길게 누르기는 시뮬레이션된 GPUI 터치 이벤트로만 실행했으며, 터치 하드웨어에서는 시도하지 않았습니다. Carousel 자동 재생, Sidebar 레일, ControlField, AvatarGroup은 헤드리스 및 조합 커버리지만 있으며, 네이티브 외형은 관찰하지 않았습니다.

기존 테스트는 문서화된 선택/오버레이 계약, 유지 값 설정자, 사용할 수 없는 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% 배율로 가정, 라이트 및 다크 화면 표현)에서는 카탈로그의 line, 누적 bar/area, pie, donut, radar 차트, radar 포인터 검사, 뷰당 한 개와 두 개 슬라이드에서 Next를 사용한 Carousel, Component APIs로 이동하는 Breadcrumb 생략 메뉴를 관찰했습니다. two_styles에서는 Item 미디어/헤더/푸터 레이아웃, 풍부한 Edit session 툴팁, 입력된 날짜("in 3 days"는 적용되고 "2026-02-30"은 Field 오류를 표시), 플랜 패널의 약 96 px 하한에서 멈추는 일정 구분선을 관찰했습니다. 그 점검에서 radar 방사형 레이블을 테두리에서 떨어지도록 옮기고, Item 미디어의 글꼴에 의존하는 녹화 글리프를 그린 점으로 교체했습니다.

실제 한국어/CJK IME, 스크린리더 음성과 조작, 혼합 DPI, 터치 하드웨어와 나머지 데스크톱 시각 검토는 출시 전 확인할 항목입니다. 공식 Accordion multiple 예제, Toggle Group 사용법, Slider range, Calendar, Combobox가 구체적인 동작 참고 자료를 제공합니다. Data Table 가이드와 Sidebar는 선택, 열 표시 여부, 접기/그룹 조합 참고 자료를 제공합니다. Sheet 참고 자료는 네 가장자리 배치를 설명합니다. 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 -- settings

catalogue에서는 Navigation 외에 OTP·Drawer·Toast, 미디어·차트, 대화·설문 예제도 확인할 수 있습니다.

확인할 항목조작통과 기준
한글 조합과 글꼴 · starter작업 표시줄에서 한국어 입력기의 가 모드를 선택합니다. Your name에 한글을 직접 입력하고 영문 모드로 전환해 ABC 123을 이어 쓴 뒤 Say hello를 누릅니다.자모가 조합되는 동안 글자가 사라지거나 두 번 들어가지 않습니다. 결과에 Hello, 한글 ABC 123!이 표시되고, 입력란과 결과 모두 글자가 네모로 나오거나 잘리지 않습니다.
IME 후보 · starter입력란을 비우고 가 모드에서 한을 입력한 뒤 한자 키로 후보를 엽니다. 한 번은 Esc로 취소하고, 다시 열어 후보 하나를 선택합니다. 키보드 배열에 따라 오른쪽 Ctrl이 한자 키입니다.후보창이 입력 커서 근처에 뜹니다. 취소하면 한이 남고, 선택하면 선택한 글자 하나로 바뀝니다. 후보 선택만으로 Say hello가 실행되지 않습니다. Microsoft 한국어 IME 안내
스크린리더와 키보드 · catalogueNavigation 탭에서 창 폭을 줄여 Project sections 버튼이 보이게 합니다. Windows 내레이터를 켜고 앱으로 돌아와 Tab으로 버튼을 찾습니다. Enter로 열고 Esc로 닫은 뒤, 다시 열어 Tab으로 Members를 찾아 Enter를 누릅니다.화면을 보지 않고 음성으로 탐색 버튼과 항목을 구별할 수 있습니다. Esc 후 같은 버튼으로 포커스가 돌아오고, Members를 선택하면 패널이 닫히고 본문에 Members가 표시됩니다. 내레이터 시작·종료 단축키는 Win+Ctrl+Enter입니다. Microsoft 내레이터 안내
서로 다른 디스플레이 배율 · two_styles같은 창을 100%와 150%처럼 배율이 다른 두 모니터 사이로 옮깁니다. 첫 화면의 Session actions 메뉴를 각 모니터에서 열고 Show cursor를 클릭합니다. 같은 방법으로 starter의 한자 후보창 위치도 확인합니다.메뉴와 후보창이 각각 버튼과 입력 커서 근처에 나타납니다. 글자·테두리가 잘리지 않고 클릭한 항목이 동작해 Cursor visible과 Cursor hidden이 바뀝니다.
터치 · two_styles터치스크린에서 Session actions: right-click or 문구와 Shift·F10 키 표시가 있는 요약 영역을 손가락으로 길게 누르고 뗍니다. Show cursor를 터치합니다.손을 뗀 뒤에도 누른 위치 근처에 메뉴 하나가 남습니다. 항목을 터치하면 상태가 한 번 바뀌고 메뉴가 닫힙니다.

결과에는 사용한 입력기·스크린리더·모니터 배율과 실제로 본 화면 또는 들은 내용을 적습니다. 모니터가 한 대이거나 터치스크린이 없으면 해당 항목은 미확인으로 남깁니다. 브라우저 미리보기와 자동 테스트 결과는 네이티브 실측과 별도로 기록하고, 성능은 직접 측정한 경우에만 보고합니다.

참고 자료와의 차이

shadcn 소개는 소스 소유권, 조합, 배포, 시각 기본값을 설명합니다. 비교 가능한 범위에는 헤드리스 동작뿐 아니라 소비자를 위한 레시피도 포함됩니다.

현재 Combobox 문서는 편집 가능한 자동 완성과 추가 선택 변형을 다룹니다. 여기의 구현은 그룹으로 묶인 단일/다중 선택과 항목 교체를 제공합니다. 애플리케이션은 칩 화면 표현과 비동기 요청 소유권을 유지하며, 이 기능들은 컴포넌트를 추가하기보다 같은 패밀리를 심화합니다. Command는 두 번째 독립 명령 엔진을 요구하지 않고 대화상자 조합을 포함합니다.

Date Picker는 캘린더와 팝업 부분으로 조합됩니다. Data Table은 공유 기반 위에서 애플리케이션별 테이블을 만드는 가이드입니다. Native Select는 브라우저 HTML 컨트롤을 명시적으로 감싸므로, 그 플랫폼 계약은 조정이 필요합니다.