boottent-design 0.1.260 → 0.1.262

package/dist/design-system/components/article-asset-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — article-asset-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/blog-review-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — blog-review-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/camp-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — camp-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/company-info-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — company-info-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/dday-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — dday-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/environment-asset-photo.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — environment-asset-photo.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/event-asset-banner.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — event-asset-banner.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/event-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — event-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/lecturer-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — lecturer-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/main-banner-image.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — main-banner-image.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/mobile-camp-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — mobile-camp-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/partner-list-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — partner-list-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/portfolio-asset-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — portfolio-asset-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/premium-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — premium-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/title-tag-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — title-tag-card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/youtube-video-modal.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — youtube-video-modal.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/design-system.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > boottent-design 허브 — 먼저 이 문서를 읽고 필요한 스포크 문서로 이동하라.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 ## 0. 원칙 (먼저 읽어라)
 
@@ -41,7 +41,7 @@ boottent-design은 모든 소비 앱의 **단일 진실 원천(SSOT)** 이다. U
 
 ## 4. 인벤토리
 
-### 4.1 UI 프리미티브 (45종)
+### 4.1 UI 프리미티브 (46종)
 
 | 컴포넌트 | 설명 | 문서 |
 |----------|------|------|
@@ -72,6 +72,7 @@ boottent-design은 모든 소비 앱의 **단일 진실 원천(SSOT)** 이다. U
 | `multi-select` | 여러 개의 옵션을 검색하고 칩(Badge) 형태로 다중 선택할 수 있는 컴포넌트입니다. | [ui/multi-select.md](./ui/multi-select.md) |
 | `navigation-menu` | 웹사이트 전반에 걸친 상위 내비게이션 구조를 제공하며, 호버 시 하위 메뉴를 시각적으로 풍부하게 보여주… | [ui/navigation-menu.md](./ui/navigation-menu.md) |
 | `popover` | 클릭이나 클릭 이외의 트리거로 인해 요소 근처에 부유하는 콘텐츠 박스를 보여주는 컴포넌트입니다. | [ui/popover.md](./ui/popover.md) |
+| `portal` | 모달 · 다이얼로그 · 알럿 · 커스텀 오버레이를 명령형(imperative)으로 열고 닫는 포털 런타… | [ui/portal.md](./ui/portal.md) |
 | `progress` | 작업의 완료율이나 진행 상태를 시각적으로 보여주는 프로그레스 바 컴포넌트입니다. | [ui/progress.md](./ui/progress.md) |
 | `radio-group` | 여러 옵션 중 하나만 선택할 수 있게 하는 라디오 버튼 그룹 컴포넌트입니다. | [ui/radio-group.md](./ui/radio-group.md) |
 | `scroll-area` | 브라우저 기본 스크롤바 대신 커스터마이징 가능한 세련된 스크롤바를 제공하는 컴포넌트입니다. | [ui/scroll-area.md](./ui/scroll-area.md) |

package/dist/design-system/tokens.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 디자인 토큰 — 색상 · 타이포그래피 · 기타.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 디자인 시스템 허브](./design-system.md)
 

package/dist/design-system/ui/accordion.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — accordion.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/alert-dialog.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — alert-dialog.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/anchor.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — anchor.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/aspect-ratio.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — aspect-ratio.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/avatar.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — avatar.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/badge.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — badge.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/button.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — button.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/calendar.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — calendar.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/callout.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — callout.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/card-label.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — card-label.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — card.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/checkbox.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — checkbox.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/circled-check-button.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — circled-check-button.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/command.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — command.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/dialog.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — dialog.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/dropdown-menu.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — dropdown-menu.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/file-uploader.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — file-uploader.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/form.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — form.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/highlight-text.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — highlight-text.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/icons.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — icons.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/image.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — image.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/input.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — input.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/label.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — label.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/month-picker.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — month-picker.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/multi-select.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — multi-select.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/navigation-menu.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — navigation-menu.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/popover.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — popover.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/portal.md

@@ -0,0 +1,64 @@
+# ui/portal.md — boottent-design
+
+> [!WARNING]
+> **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
+> UI 프리미티브 — portal.
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
+
+[← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
+
+## portal
+
+> 모달 · 다이얼로그 · 알럿 · 커스텀 오버레이를 명령형(imperative)으로 열고 닫는 포털 런타임입니다.
+상태를 직접 관리하지 않고 `usePortal()`의 `confirm`/`alert`/`dialog`/`custom`을 호출하면 됩니다.
+앱 루트에 `<PortalProvider />`를 한 번 mount 하면 됩니다. (토스트는 별도 시스템 `boottent-design/ui/toast` 를 사용하세요.)
+
+### ✅ 언제 사용
+- 삭제·결제 등 확인이 필요한 작업을 명령형으로 띄울 때 (`confirm`)
+- 단순 안내/경고를 단일 버튼으로 띄울 때 (`alert`)
+- 폼·상세 등 임의 콘텐츠를 헤더/푸터가 있는 다이얼로그로 띄울 때 (`dialog`)
+- 완전히 자유로운 레이아웃의 오버레이가 필요할 때 (`custom`)
+
+### 🚫 주의
+- 컴포넌트 트리 안에서 선언적으로 여닫는 단순 모달이면 `boottent-design/ui/dialog`(Radix Dialog)를 직접 쓰는 편이 낫습니다.
+- 앱 루트에 `<PortalProvider />`는 **정확히 한 번만** mount 하세요(중복 mount 시 오버레이가 두 번 렌더됩니다).
+- `forceMount: true` 오버레이는 사용자가 닫을 수 없으며, `forceClosePortal(id)`로만 닫힙니다.
+
+### Import
+```tsx
+import { /* ... */ } from "boottent-design/ui/portal";
+```
+
+### 예시
+```tsx
+// 1) 앱 루트(레이아웃)에 한 번 mount
+import { PortalProvider } from "boottent-design/ui/portal";
+// <PortalProvider />
+// 2) 어디서든 명령형으로 호출
+import { usePortal } from "boottent-design/ui/portal";
+function DeleteButton() {
+const { confirm } = usePortal();
+return (
+<button
+onClick={() =>
+confirm({
+title: "삭제하시겠어요?",
+description: "이 작업은 되돌릴 수 없습니다.",
+confirmText: "삭제",
+onConfirm: () => {
+// delete...
+},
+})
+}
+>
+삭제
+</button>
+);
+}
+```
+
+### 🔗 관련 · 대안
+- Dialog
+- AlertDialog
+- ui/toast (useToast)
+

package/dist/design-system/ui/progress.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — progress.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/radio-group.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — radio-group.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/scroll-area.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — scroll-area.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/select.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — select.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/separator.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — separator.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/simple-table.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — simple-table.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/skeleton.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — skeleton.
-> 버전: boottent-design v0.1.260 · 생성: 2026. 6. 25. 오후 6:11:06
+> 버전: boottent-design v0.1.261 · 생성: 2026. 6. 29. 오후 4:02:50
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)