@hjmds/design-contracts 1.29.0 → 1.31.0

package/dist/catalog.d.ts

@@ -33,6 +33,17 @@ export type ComponentCatalogEntry = Readonly<{
     nonVisualEvidence?: ComponentNonVisualEvidence;
     /** Why the row exists at its current maturity and what event moves it forward. */
     roadmap?: ComponentRoadmap;
+    /**
+     * Stable kebab-case id. Defaults to the kebab form of `name` (`componentIdOf`). Set it only when a row
+     * was renamed after its id shipped, so documentation keys and consumer catalog snapshots survive.
+     */
+    id?: string;
+    /** Purpose-based Korean item name used by both Storybooks (docs/STORYBOOK_NAVIGATION.md §1.3). */
+    label?: string;
+    /** Public renderer symbols that are named regions or variants of this contract, not rows of their own. */
+    companions?: readonly string[];
+    /** Optional extensions that reuse this contract without inheriting its maturity (public-component-map.md). */
+    extensions?: readonly string[];
     /**
      * 만들지 않기로 **확정한** 항목의 사유. `status`는 구현 성숙도 축이고 이것은
      * "만들 것인가"라는 다른 질문이라 직교 필드로 둔다.
@@ -75,6 +86,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Text";
+    readonly label: "본문 글자";
+    readonly companions: readonly ["StatusText"];
+    readonly extensions: readonly ["GravityLetters"];
     readonly category: "foundation";
     readonly platform: "shared";
     readonly status: "stable";
@@ -87,6 +101,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "TextFormat";
+    readonly label: "글자 서식";
     readonly category: "foundation";
     readonly platform: "web";
     readonly status: "stable";
@@ -98,6 +113,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Heading";
+    readonly label: "제목";
     readonly category: "foundation";
     readonly platform: "shared";
     readonly status: "stable";
@@ -108,6 +124,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Icon";
+    readonly label: "아이콘";
     readonly category: "foundation";
     readonly platform: "shared";
     readonly status: "stable";
@@ -118,6 +135,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Surface";
+    readonly label: "배경 영역";
     readonly category: "layout";
     readonly platform: "shared";
     readonly status: "stable";
@@ -128,6 +146,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Divider";
+    readonly label: "구분선";
     readonly category: "layout";
     readonly platform: "shared";
     readonly status: "stable";
@@ -138,6 +157,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Section";
+    readonly label: "섹션";
     readonly category: "layout";
     readonly platform: "shared";
     readonly status: "stable";
@@ -149,6 +169,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Stack";
+    readonly label: "가로·세로 배치";
     readonly category: "layout";
     readonly platform: "shared";
     readonly status: "stable";
@@ -159,6 +180,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Container";
+    readonly label: "컨테이너";
     readonly category: "layout";
     readonly platform: "shared";
     readonly status: "stable";
@@ -173,6 +195,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "AspectRatio";
+    readonly label: "화면 비율";
     readonly category: "layout";
     readonly platform: "shared";
     readonly status: "stable";
@@ -187,6 +210,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Grid";
+    readonly label: "격자";
     readonly category: "layout";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -203,6 +227,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Layout";
+    readonly label: "화면 기본 구조";
     readonly category: "layout";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -214,6 +239,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Top";
+    readonly label: "화면 제목과 설명";
     readonly category: "layout";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -224,6 +250,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Masonry";
+    readonly label: "높이가 다른 카드 배치";
     readonly category: "layout";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -240,6 +267,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Splitter";
+    readonly label: "분할 영역 조절";
     readonly category: "layout";
     readonly platform: "web";
     readonly status: "stable";
@@ -250,6 +278,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Button";
+    readonly label: "버튼";
+    readonly companions: readonly ["ClipboardButton"];
+    readonly extensions: readonly ["ReactionPicker", "InlineConfirm"];
     readonly category: "action";
     readonly platform: "shared";
     readonly status: "stable";
@@ -260,6 +291,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "IconButton";
+    readonly label: "아이콘 버튼";
+    readonly companions: readonly ["ClipboardIconButton"];
+    readonly extensions: readonly ["NotificationBell"];
     readonly category: "action";
     readonly platform: "shared";
     readonly status: "stable";
@@ -271,6 +305,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Link";
+    readonly label: "링크";
     readonly category: "action";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -281,6 +316,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "BottomCTA";
+    readonly label: "하단 실행 버튼";
     readonly category: "action";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -297,6 +333,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "FloatingActionButton";
+    readonly label: "플로팅 실행 버튼";
     readonly category: "action";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -313,6 +350,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "AuthScreenLayout";
+    readonly label: "로그인 화면";
+    readonly id: "auth-screen";
+    readonly companions: readonly ["AuthScreenHero", "AuthScreenFooter"];
     readonly category: "layout";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -329,6 +369,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "AuthProviderButton";
+    readonly label: "소셜 로그인 버튼";
     readonly category: "action";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -340,6 +381,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Field";
+    readonly label: "입력 필드";
+    readonly companions: readonly ["TextField"];
+    readonly extensions: readonly ["FieldGroup", "DateEntry", "GestureSheetInput"];
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -351,6 +395,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "SearchField";
+    readonly label: "검색 입력";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -361,6 +406,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "TextArea";
+    readonly label: "여러 줄 입력";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -373,6 +419,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "PasswordField";
+    readonly label: "비밀번호 입력";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -385,6 +432,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "OtpField";
+    readonly label: "인증번호 입력";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -396,6 +444,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Checkbox";
+    readonly label: "체크박스";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -406,6 +455,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Radio";
+    readonly label: "라디오 버튼";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -417,6 +467,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "CheckboxGroup";
+    readonly label: "체크박스 그룹";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -428,6 +479,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "RadioGroup";
+    readonly label: "라디오 버튼 그룹";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -439,6 +491,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Switch";
+    readonly label: "스위치";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -450,6 +503,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Chip";
+    readonly label: "선택 칩";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -460,6 +514,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "beta";
     };
     readonly name: "ImageChoiceGroup";
+    readonly label: "이미지 선택";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "beta";
@@ -471,6 +526,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "SegmentedControl";
+    readonly label: "버튼형 선택";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -486,6 +542,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "ToggleGroup";
+    readonly label: "토글 그룹";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -502,6 +559,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "TagsInput";
+    readonly label: "태그 입력";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -517,6 +575,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Slider";
+    readonly label: "슬라이더";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -528,6 +587,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "NumberField";
+    readonly label: "숫자 입력";
+    readonly extensions: readonly ["DurationField"];
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -539,6 +600,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Select";
+    readonly label: "목록에서 선택";
+    readonly companions: readonly ["NativeSelect"];
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -554,6 +617,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Combobox";
+    readonly label: "검색형 선택";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -565,6 +629,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "DatePicker";
+    readonly label: "날짜 선택";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -577,6 +642,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "DateRangePicker";
+    readonly label: "기간 선택";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -587,6 +653,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "ColorPicker";
+    readonly label: "색상 선택기";
     readonly category: "input";
     readonly platform: "web";
     readonly status: "stable";
@@ -603,6 +670,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "FilePicker";
+    readonly label: "파일 선택";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -614,6 +682,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Form";
+    readonly label: "입력 양식";
     readonly category: "input";
     readonly platform: "shared";
     readonly status: "stable";
@@ -629,6 +698,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Agreement";
+    readonly label: "약관 동의";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -640,6 +710,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Mentions";
+    readonly label: "사용자 언급";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -652,6 +723,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "TransferList";
+    readonly label: "목록 간 항목 이동";
     readonly category: "input";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -663,6 +735,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "UploadItem";
+    readonly label: "업로드 항목";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -678,6 +751,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Tabs";
+    readonly label: "탭";
+    readonly companions: readonly ["TabPanel"];
     readonly category: "navigation";
     readonly platform: "shared";
     readonly status: "stable";
@@ -688,6 +763,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "TopBar";
+    readonly label: "상단 탐색 막대";
+    readonly companions: readonly ["NavigationBar", "TopBarAction"];
     readonly category: "navigation";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -700,6 +777,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Sidebar";
+    readonly label: "사이드바";
     readonly category: "navigation";
     readonly platform: "web";
     readonly status: "stable";
@@ -715,6 +793,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "BottomNavigation";
+    readonly label: "하단 탐색";
+    readonly companions: readonly ["BottomNavigationInsetProvider"];
     readonly category: "navigation";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -726,9 +806,21 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Breadcrumb";
+    readonly label: "이동 경로";
     readonly category: "navigation";
     readonly platform: "web";
     readonly status: "stable";
+}, {
+    readonly recipe: "carouselRecipe";
+    readonly surfaceStatus: {
+        readonly web: "beta";
+        readonly native: "beta";
+    };
+    readonly name: "PageIndicator";
+    readonly label: "페이지 위치 표시";
+    readonly category: "navigation";
+    readonly platform: "shared";
+    readonly status: "beta";
 }, {
     readonly recipe: "paginationRecipe";
     readonly behavior: "pagination";
@@ -737,6 +829,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "beta";
     };
     readonly name: "Pagination";
+    readonly label: "페이지 이동";
     readonly category: "navigation";
     readonly platform: "shared";
     readonly status: "stable";
@@ -752,6 +845,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "LoadMore";
+    readonly label: "더 보기";
     readonly category: "navigation";
     readonly platform: "shared";
     readonly status: "stable";
@@ -766,6 +860,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Steps";
+    readonly label: "단계 탐색";
+    readonly extensions: readonly ["StepPlayer"];
     readonly category: "navigation";
     readonly platform: "shared";
     readonly status: "stable";
@@ -777,6 +873,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Menubar";
+    readonly label: "메뉴 막대";
     readonly category: "navigation";
     readonly platform: "web";
     readonly status: "stable";
@@ -788,6 +885,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "ContextMenu";
+    readonly label: "상황별 메뉴";
+    readonly extensions: readonly ["NativeContextMenu"];
     readonly category: "navigation";
     readonly platform: "web";
     readonly status: "stable";
@@ -800,6 +899,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Menu";
+    readonly label: "메뉴";
+    readonly extensions: readonly ["MorphingMenu"];
     readonly category: "navigation";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -811,6 +912,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Anchor";
+    readonly label: "문서 내 바로가기";
     readonly category: "navigation";
     readonly platform: "web";
     readonly status: "stable";
@@ -821,6 +923,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Avatar";
+    readonly label: "아바타";
+    readonly companions: readonly ["AvatarGroup"];
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -837,6 +941,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Asset";
+    readonly label: "이미지·영상 표시";
+    readonly companions: readonly ["AssetGroup"];
+    readonly extensions: readonly ["VoiceNote"];
     readonly category: "data-display";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -847,6 +954,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Badge";
+    readonly label: "배지";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -857,6 +965,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "CounterBadge";
+    readonly label: "숫자 배지";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -867,6 +976,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Card";
+    readonly label: "카드";
+    readonly extensions: readonly ["DocumentResource"];
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -877,6 +988,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "List";
+    readonly label: "목록";
+    readonly companions: readonly ["CollectionRail"];
+    readonly extensions: readonly ["TaskList"];
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -887,6 +1001,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "ListRow";
+    readonly label: "목록 행";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -898,6 +1013,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "VirtualList";
+    readonly label: "가상 목록";
     readonly category: "data-display";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -910,6 +1026,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Collapsible";
+    readonly label: "접기와 펼치기";
+    readonly companions: readonly ["CollapsibleMarker"];
+    readonly extensions: readonly ["FolderPreview"];
     readonly category: "data-display";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -925,6 +1044,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Accordion";
+    readonly label: "아코디언";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -935,6 +1055,9 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Statistic";
+    readonly label: "수치 표시";
+    readonly companions: readonly ["StatisticGroup"];
+    readonly extensions: readonly ["AnimatedStatistic"];
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -949,6 +1072,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Timeline";
+    readonly label: "타임라인";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -960,6 +1084,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "beta";
     };
     readonly name: "DataTable";
+    readonly label: "데이터 표";
+    readonly companions: readonly ["Table", "LineScore", "MatrixTable", "ComparisonTable"];
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -971,6 +1097,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "beta";
     };
     readonly name: "Chart";
+    readonly label: "차트";
+    readonly companions: readonly ["LineChart", "BarChart", "PieChart", "RadarChart", "ScatterChart", "Sparkline", "ChartLegend"];
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "beta";
@@ -982,6 +1110,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Tree";
+    readonly label: "트리 목록";
     readonly category: "data-display";
     readonly platform: "web";
     readonly status: "stable";
@@ -993,6 +1122,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Calendar";
+    readonly label: "달력";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1004,6 +1134,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Carousel";
+    readonly label: "캐러셀";
+    readonly extensions: readonly ["CarouselMotion"];
     readonly category: "data-display";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -1015,6 +1147,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "DescriptionList";
+    readonly label: "설명 목록";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1029,6 +1162,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Image";
+    readonly label: "이미지";
+    readonly extensions: readonly ["GridReveal", "ImageViewer"];
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1039,6 +1174,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "QRCode";
+    readonly label: "큐알 코드";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1049,6 +1185,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Tag";
+    readonly label: "태그";
     readonly category: "data-display";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1061,6 +1198,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Tour";
+    readonly label: "사용 안내 둘러보기";
     readonly category: "overlay";
     readonly platform: "web";
     readonly status: "stable";
@@ -1071,6 +1209,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "EmptyState";
+    readonly label: "빈 상태";
     readonly category: "feedback";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1081,6 +1220,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Notice";
+    readonly label: "안내 메시지";
     readonly category: "feedback";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1091,6 +1231,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Progress";
+    readonly label: "진행 표시";
+    readonly extensions: readonly ["ScrollProgress"];
     readonly category: "feedback";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1101,6 +1243,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "ThinkingOrb";
+    readonly label: "생각 중 표시";
     readonly category: "feedback";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1111,6 +1254,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Spinner";
+    readonly label: "로딩 표시";
     readonly category: "feedback";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1121,6 +1265,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Skeleton";
+    readonly label: "스켈레톤";
     readonly category: "feedback";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1131,6 +1276,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Result";
+    readonly label: "결과 안내";
     readonly category: "feedback";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1146,6 +1292,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "BottomInfo";
+    readonly label: "하단 안내";
     readonly category: "feedback";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -1158,6 +1305,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Toast";
+    readonly label: "토스트";
+    readonly companions: readonly ["ToastProvider", "ToastRegion"];
     readonly category: "feedback";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -1168,6 +1317,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Watermark";
+    readonly label: "워터마크";
     readonly category: "feedback";
     readonly platform: "web";
     readonly status: "stable";
@@ -1179,6 +1329,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Dialog";
+    readonly label: "대화상자";
+    readonly companions: readonly ["OverlayStackProvider", "ImmersiveOverlay"];
     readonly category: "overlay";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -1190,6 +1342,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "AlertDialog";
+    readonly label: "확인 대화상자";
     readonly category: "overlay";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -1201,6 +1354,8 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "Sheet";
+    readonly label: "시트";
+    readonly extensions: readonly ["GestureSheet", "GestureSheetProvider"];
     readonly category: "overlay";
     readonly platform: "adaptive";
     readonly status: "stable";
@@ -1212,6 +1367,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "SidePanel";
+    readonly label: "측면 패널";
     readonly category: "overlay";
     readonly platform: "web";
     readonly status: "stable";
@@ -1223,6 +1379,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Popover";
+    readonly label: "팝오버";
     readonly category: "overlay";
     readonly platform: "web";
     readonly status: "stable";
@@ -1234,6 +1391,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Tooltip";
+    readonly label: "툴팁";
     readonly category: "overlay";
     readonly platform: "web";
     readonly status: "stable";
@@ -1245,6 +1403,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "CommandPalette";
+    readonly label: "명령 검색";
     readonly category: "overlay";
     readonly platform: "web";
     readonly status: "stable";
@@ -1255,6 +1414,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "Affix";
+    readonly label: "고정 배치";
     readonly category: "utility";
     readonly platform: "web";
     readonly status: "stable";
@@ -1266,6 +1426,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "stable";
     };
     readonly name: "DesignSystemProvider";
+    readonly label: "디자인 시스템 설정";
     readonly category: "provider";
     readonly platform: "shared";
     readonly status: "stable";
@@ -1278,6 +1439,7 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "SkipNav";
+    readonly label: "본문 바로가기";
     readonly category: "utility";
     readonly platform: "web";
     readonly status: "stable";
@@ -1293,231 +1455,283 @@ export declare const componentCatalog: readonly [{
         readonly native: "unsupported";
     };
     readonly name: "VisuallyHidden";
+    readonly label: "화면 읽기 도구용 글자";
     readonly category: "utility";
     readonly platform: "web";
     readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "ScreenLayout";
+    readonly label: "화면 골격";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "CompositionLayout";
+    readonly label: "구성 골격";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "SettingsScreen";
+    readonly label: "설정 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "searchScreenRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "SearchScreen";
+    readonly label: "검색 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "EditorScreen";
+    readonly label: "편집 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "PermissionScreen";
+    readonly label: "권한 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "OnboardingScreen";
+    readonly label: "온보딩 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "ModerationScreen";
+    readonly label: "신고 화면";
+    readonly companions: readonly ["ModerationForm"];
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "ChatScreen";
+    readonly label: "채팅 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "NotificationInboxScreen";
+    readonly label: "알림함 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "commentThreadRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "CommentThreadScreen";
+    readonly label: "댓글 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "ListDetailScreen";
+    readonly label: "목록 상세 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "MediaSelectionScreen";
+    readonly label: "미디어 선택 화면";
+    readonly companions: readonly ["MediaSelectionCell"];
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "screenPatternRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "ProfileScreen";
+    readonly label: "프로필 화면";
     readonly category: "layout";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "chatMessageRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "ChatMessage";
+    readonly label: "채팅 말풍선";
     readonly category: "data-display";
     readonly platform: "adaptive";
+    readonly status: "stable";
+}, {
+    readonly recipe: "typingIndicatorRecipe";
+    readonly surfaceStatus: {
+        readonly web: "beta";
+        readonly native: "beta";
+    };
+    readonly name: "TypingIndicator";
+    readonly label: "입력 중 표시";
+    readonly category: "feedback";
+    readonly platform: "adaptive";
     readonly status: "beta";
 }, {
-    readonly recipe: "notificationRowRecipe";
+    readonly recipe: "chatDateSeparatorRecipe";
     readonly surfaceStatus: {
         readonly web: "beta";
         readonly native: "beta";
     };
-    readonly name: "NotificationRow";
+    readonly name: "ChatDateSeparator";
+    readonly label: "대화 날짜 구분";
     readonly category: "data-display";
     readonly platform: "adaptive";
     readonly status: "beta";
+}, {
+    readonly recipe: "notificationRowRecipe";
+    readonly surfaceStatus: {
+        readonly web: "stable";
+        readonly native: "stable";
+    };
+    readonly name: "NotificationRow";
+    readonly label: "알림 미리보기 행";
+    readonly category: "data-display";
+    readonly platform: "adaptive";
+    readonly status: "stable";
 }, {
     readonly recipe: "listRowRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "NotificationItem";
+    readonly label: "알림 목록 항목";
     readonly category: "data-display";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "commentThreadRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "CommentThreadRow";
+    readonly label: "댓글 행";
     readonly category: "data-display";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "profileSummaryRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "ProfileSummary";
+    readonly label: "프로필 요약";
     readonly category: "data-display";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "iconTileRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "IconTile";
+    readonly label: "아이콘 타일";
     readonly category: "data-display";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "composerQuickInsertRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "MessageComposer";
+    readonly label: "메시지 작성창";
     readonly category: "input";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }, {
     readonly recipe: "sheetRecipe";
     readonly surfaceStatus: {
-        readonly web: "beta";
-        readonly native: "beta";
+        readonly web: "stable";
+        readonly native: "stable";
     };
     readonly name: "PhotoSourceSheet";
+    readonly label: "사진 출처 시트";
     readonly category: "overlay";
     readonly platform: "adaptive";
-    readonly status: "beta";
+    readonly status: "stable";
 }];
 export type ComponentName = (typeof componentCatalog)[number]["name"];
+/**
+ * Kebab id of a catalog row: the explicit `id` override, else the kebab form of `name`
+ * (QRCode → qr-code, BottomCTA → bottom-cta). `component-definitions.ts` mirrors this at the type level.
+ */
+export declare function componentIdOf(entry: Pick<ComponentCatalogEntry, "name" | "id">): string;
 export declare function summarizeComponentRoadmap(entries?: readonly ComponentCatalogEntry[]): Readonly<Record<ComponentRoadmapState, number>>;
 /** One typed registry prevents catalog recipe names from drifting into strings. */
 export declare const recipeRegistry: {
@@ -1528,6 +1742,9 @@ export declare const recipeRegistry: {
         readonly ringWidth: 2;
         readonly ringOffset: 2;
         readonly checkSize: 20;
+        readonly itemLabelGap: 4;
+        readonly itemLabelVariant: "caption";
+        readonly itemLabelLines: 1;
     };
     readonly affixRecipe: {
         readonly edge: "top";
@@ -2131,6 +2348,30 @@ export declare const recipeRegistry: {
                 alpha?: number;
             }>;
         };
+        readonly prominentDestination: {
+            readonly diameter: number;
+            readonly icon: "lg";
+            readonly background: Readonly<{
+                source: "theme";
+                key: "primary";
+                alpha?: number;
+            }>;
+            readonly content: Readonly<{
+                source: "theme";
+                key: "onPrimary";
+                alpha?: number;
+            }>;
+            readonly shadow: {
+                readonly color: "#000000";
+                readonly opacity: 0.12;
+                readonly radius: 12;
+                readonly offsetY: 4;
+            };
+        };
+        readonly iconSizes: {
+            readonly large: 44;
+            readonly xlarge: 52;
+        };
         readonly adaptive: {
             readonly web: "fixed-compact-viewport";
             readonly native: "navigator-tab-bar";
@@ -4117,6 +4358,20 @@ export declare const recipeRegistry: {
                 readonly reducedMotion: "instant";
             };
         };
+        readonly immersive: {
+            readonly background: Readonly<{
+                source: "theme";
+                key: "bg";
+                alpha?: number;
+            }>;
+            readonly controls: {
+                readonly padding: 16;
+                readonly gap: 8;
+                readonly actionGap: 12;
+            };
+            readonly orientations: readonly ["portrait", "landscape-left", "landscape-right"];
+            readonly statusBarHidden: true;
+        };
     };
     readonly dataTableRecipe: {
         readonly slots: readonly ["root", "header", "headerCell", "sortButton", "sortIcon", "row", "cell", "selectionCell", "emptyState", "errorState"];
@@ -7831,6 +8086,9 @@ export declare const recipeRegistry: {
                 alpha?: number;
             }>;
         };
+        readonly press: {
+            readonly minTouchTarget: 44;
+        };
     };
     readonly surfaceRecipe: {
         readonly default: {
@@ -7980,6 +8238,33 @@ export declare const recipeRegistry: {
             readonly size: "medium";
             readonly layout: "content";
             readonly overflow: "scroll";
+            readonly indicator: "underline";
+        };
+        readonly indicators: {
+            readonly underline: {
+                readonly listDivider: true;
+                readonly background: null;
+                readonly selectedContent: Readonly<{
+                    source: "theme";
+                    key: "text";
+                    alpha?: number;
+                }>;
+                readonly radius: null;
+            };
+            readonly filled: {
+                readonly listDivider: false;
+                readonly background: Readonly<{
+                    source: "theme";
+                    key: "surfaceAccent";
+                    alpha?: number;
+                }>;
+                readonly selectedContent: Readonly<{
+                    source: "theme";
+                    key: "contentBrand";
+                    alpha?: number;
+                }>;
+                readonly radius: "full";
+            };
         };
         readonly sizes: {
             readonly small: {
@@ -8915,6 +9200,13 @@ export declare const recipeRegistry: {
         readonly timelineInset: 10;
         readonly mediaWidth: 210;
         readonly mediaGap: 2;
+        readonly reactionSummary: {
+            readonly minHeight: 24;
+            readonly paddingInline: 8;
+            readonly itemGap: 4;
+            readonly emojiGap: 2;
+            readonly minCount: 2;
+        };
     };
     readonly commentThreadRecipe: {
         readonly avatarSize: 32;
@@ -8926,6 +9218,7 @@ export declare const recipeRegistry: {
         readonly likeColumnWidth: 44;
         readonly mediaMaxWidth: 160;
         readonly mediaRadius: 12;
+        readonly panelGap: 8;
         readonly menuGlyphSize: 20;
         readonly actionAnchor: {
             readonly authorTextVariant: "caption";
@@ -8945,6 +9238,10 @@ export declare const recipeRegistry: {
     };
     readonly profileSummaryRecipe: Readonly<{
         avatarSize: 72;
+        editAction: Readonly<{
+            readonly tone: "secondary";
+            readonly size: "small";
+        }>;
     }>;
     readonly iconTileRecipe: Readonly<{
         iconSize: 64;
@@ -8954,12 +9251,33 @@ export declare const recipeRegistry: {
         ghostOpacity: 0.55;
         gap: 6;
         iconRadius: "22%";
+        shapes: Readonly<Record<import("./screen-patterns.js").IconTileShape, number>>;
+        fillMinSize: 48;
+        fillMaxSize: 68;
+        defaults: Readonly<{
+            frame: import("./screen-patterns.js").IconTileFrame;
+            shape: import("./screen-patterns.js").IconTileShape;
+            size: import("./screen-patterns.js").IconTileSize;
+        }>;
     }>;
     readonly composerQuickInsertRecipe: {
         readonly itemSize: 44;
         readonly emojiSize: 26;
         readonly gap: 8;
     };
+    readonly typingIndicatorRecipe: {
+        readonly dotSize: 6;
+        readonly dotGap: 4;
+        readonly cycleMs: 1200;
+        readonly staggerMs: 160;
+        readonly restOpacity: 0.35;
+    };
+    readonly chatDateSeparatorRecipe: {
+        readonly paddingTop: 12;
+        readonly paddingBottom: 4;
+        readonly textVariant: "caption";
+        readonly tone: "muted";
+    };
 };
 export type RecipeName = keyof typeof recipeRegistry;
 //# sourceMappingURL=catalog.d.ts.map