@krds.ui/vue 0.0.20 → 0.0.22

package/dist/types/index.d.ts

@@ -85,6 +85,10 @@ declare namespace components {
         KrdsButtonGroupProps,
         KrdsIcon,
         KrdsIconProps,
+        KrdsFloatingButton,
+        KrdsFloatingButtonProps,
+        KrdsFloatingButtonEmits,
+        KrdsFloatingButtonItem,
         KrdsLink,
         KrdsLinkProps,
         KrdsLinkEmits,
@@ -173,6 +177,8 @@ declare namespace components {
         DropdownPosition,
         KrdsResize,
         KrdsResizeEmits,
+        KrdsResizeProps,
+        KrdsResizeScale,
         KrdsModal,
         KrdsModalProps,
         KrdsModalSize,
@@ -355,7 +361,7 @@ export declare const KrdsAccordionGroup: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 라인 타입 아코디언 여부 */
@@ -371,7 +377,10 @@ export declare const KrdsAccordionGroup: DefineComponent<ExtractPropTypes<{
 }>> & Readonly<{}>, {
     class: string;
     typeLine: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 아코디언 항목 (KrdsAccordionItem) */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 export declare interface KrdsAccordionGroupProps extends BaseComponentProps {
     typeLine?: boolean;
@@ -398,9 +407,10 @@ export declare const KrdsAccordionItem: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 펼침·접힘 버튼을 눌렀을 때 (항목 id) */
     toggle: (id: string) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 아이템 고유 식별자 */
@@ -429,7 +439,12 @@ export declare const KrdsAccordionItem: DefineComponent<ExtractPropTypes<{
     title: string;
     openItem: string;
     content: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 제목 (title 속성 대신) */
+    title?(): VNode[];
+    /** 펼쳤을 때 보이는 내용 (content 속성 대신) */
+    content?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS AccordionItem 컴포넌트 이벤트
@@ -478,9 +493,10 @@ export declare const KrdsBadge: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 배지를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 배지 타입 */
@@ -516,7 +532,10 @@ export declare const KrdsBadge: DefineComponent<ExtractPropTypes<{
     size: Size;
     class: string;
     color: ColorVariant_2;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 배지 글자 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Badge 컴포넌트 이벤트
@@ -560,6 +579,7 @@ export declare const KrdsBreadcrumb: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 경로 항목을 클릭했을 때 */
     'item-click': (item: BreadcrumbItem, event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 브레드크럼 아이템 배열 */
@@ -657,9 +677,10 @@ export declare const KrdsButton: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 버튼을 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 버튼 타입 */
@@ -719,7 +740,10 @@ export declare const KrdsButton: DefineComponent<ExtractPropTypes<{
     border: boolean;
     pure: boolean;
     class: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 버튼 내용 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Button 컴포넌트 이벤트
@@ -728,9 +752,28 @@ export declare interface KrdsButtonEmits {
     (e: 'click', event: MouseEvent): void;
 }
 
-export declare const KrdsButtonGroup: DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+/**
+ * KRDS ButtonGroup 컴포넌트
+ *
+ * 입력 필드 안에 버튼을 여러 개 넣을 때 묶는 래퍼입니다 (KRDS `.btn-group`, 예: 내용 삭제 + 비밀번호 보기).
+ * KRDS에는 일반 버튼 묶음 스타일이 없으므로 입력 필드 밖에서는 사용하지 않습니다.
+ *
+ * @example
+ * ```vue
+ * <KrdsInput id="pw" type="password" icon>
+ *   <KrdsButtonGroup>
+ *     <KrdsButton icon pure class="btn-delete-input"><span class="sr-only">내용 삭제</span><KrdsIcon name="ico-delete-fill" /></KrdsButton>
+ *     <KrdsButton icon><span class="sr-only">입력한 비밀번호 보기</span><KrdsIcon name="ico-pw-visible" /></KrdsButton>
+ *   </KrdsButtonGroup>
+ * </KrdsInput>
+ * ```
+ */
+export declare const KrdsButtonGroup: DefineComponent<{}, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
+    /** 입력 필드 안에 넣을 버튼들 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS ButtonGroup 컴포넌트 속성
@@ -853,10 +896,15 @@ export declare const KrdsCarousel: DefineComponent<ExtractPropTypes<{
 }>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 현재 슬라이드 순서가 바뀔 때 (v-model:active-index) */
     'update:activeIndex': (value: number) => true;
+    /** 슬라이드가 바뀌었을 때 (새 순서) */
     change: (value: number) => true;
+    /** 자동 재생을 시작했을 때 */
     play: () => true;
+    /** 자동 재생을 멈췄을 때 */
     stop: () => true;
+    /** 더 보기 버튼을 클릭했을 때 */
     'more-click': (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 캐러셀 형태 (기본값: visual) */
@@ -974,7 +1022,10 @@ export declare const KrdsCarousel: DefineComponent<ExtractPropTypes<{
     playLabel: string;
     stopLabel: string;
     moreLabel: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 슬라이드 (자식 요소 하나가 한 장) */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Carousel 컴포넌트 이벤트
@@ -1060,7 +1111,7 @@ export declare const KrdsCheckArea: DefineComponent<ExtractPropTypes<{
         type: BooleanConstructor;
         default: boolean;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 추가 클래스 */
@@ -1076,7 +1127,10 @@ export declare const KrdsCheckArea: DefineComponent<ExtractPropTypes<{
 }>> & Readonly<{}>, {
     class: string;
     column: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 체크박스·라디오 버튼 묶음 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS CheckArea 컴포넌트 속성
@@ -1122,6 +1176,7 @@ export declare const KrdsCheckbox: DefineComponent<ExtractPropTypes<{
 }>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 체크 상태가 바뀔 때 (v-model) */
     'update:modelValue': (value: boolean) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 모델 값 */
@@ -1161,8 +1216,8 @@ export declare const KrdsCheckbox: DefineComponent<ExtractPropTypes<{
     disabled: boolean;
     size: "medium" | "large";
     class: string;
-    modelValue: boolean;
     id: string;
+    modelValue: boolean;
     chip: boolean;
 }, SlotsType<{
     default?: () => VNode[];
@@ -1216,10 +1271,12 @@ export declare const KrdsCoachMark: DefineComponent<ExtractPropTypes<{
         type: PropType<string | Record<string, string | number>>;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 이전·다음 버튼으로 단계가 바뀔 때 (v-model) */
     'update:modelValue': (value: number | null) => true;
+    /** 닫기 버튼으로 닫을 때 */
     close: () => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 코치마크 래퍼에 추가할 클래스 */
@@ -1254,7 +1311,10 @@ export declare const KrdsCoachMark: DefineComponent<ExtractPropTypes<{
     style: string | Record<string, string | number>;
     modelValue: number;
     coachMarkClass: string | string[];
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 코치마크 말풍선 아래에 함께 보여 줄 내용 */
+    'coach-mark-content'?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS CoachMark 컴포넌트 이벤트
@@ -1308,7 +1368,7 @@ export declare const KrdsContextualHelp: DefineComponent<ExtractPropTypes<{
         type: PropType<ContextualHelpPosition>;
         default: string;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 툴팁 제목 */
@@ -1330,7 +1390,10 @@ export declare const KrdsContextualHelp: DefineComponent<ExtractPropTypes<{
     position: ContextualHelpPosition;
     tooltipTitle: string;
     helpIcon: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 도움말 내용 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS ContextualHelp 컴포넌트 속성
@@ -1368,6 +1431,7 @@ export declare const KrdsCriticalAlerts: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 공지 링크를 클릭했을 때 */
     'link-click': (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 알림 타입 */
@@ -1498,10 +1562,15 @@ export declare const KrdsDateInput: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 날짜를 입력하거나 달력에서 고를 때 (v-model) */
     'update:modelValue': (value: string) => true;
+    /** 입력할 때 (네이티브 input) */
     input: (event: Event) => true;
+    /** 값이 확정됐을 때 (네이티브 change) */
     change: (event: Event) => true;
+    /** 초점을 받았을 때 */
     focus: (event: FocusEvent) => true;
+    /** 초점을 잃었을 때 */
     blur: (event: FocusEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 선택된 날짜 값 */
@@ -1592,10 +1661,10 @@ export declare const KrdsDateInput: DefineComponent<ExtractPropTypes<{
     disabled: boolean;
     size: Size;
     class: string;
+    id: string;
     modelValue: string;
     placeholder: string;
     autofocus: boolean;
-    id: string;
     eventDates: string[];
     holidays: string[];
     initialYear: number;
@@ -1653,9 +1722,10 @@ export declare const KrdsDisclosure: DefineComponent<ExtractPropTypes<{
         type: BooleanConstructor;
         default: boolean;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 펼침 상태가 바뀔 때 (v-model) */
     'update:modelValue': (value: boolean) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 디스클로저 제목 */
@@ -1672,7 +1742,10 @@ export declare const KrdsDisclosure: DefineComponent<ExtractPropTypes<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
     modelValue: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 펼쳤을 때 보이는 내용 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Disclosure 컴포넌트 이벤트
@@ -1800,16 +1873,27 @@ export declare const KrdsFileUpload: DefineComponent<ExtractPropTypes<{
 }>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 파일을 추가·삭제해 목록이 바뀔 때 (v-model) */
     'update:modelValue': (files: FileInfo[]) => true;
+    /** 파일을 추가했을 때 */
     'file-added': (file: FileInfo) => true;
+    /** 파일을 삭제했을 때 (파일 id) */
     'file-removed': (fileId: string) => true;
+    /** 추가한 파일이 검사(크기·형식 등)에 실패했을 때 (오류 메시지) */
     'file-error': (file: FileInfo, error: string) => true;
+    /** 보내지 않음 (기존 코드 호환용 선언), 업로드는 사용하는 쪽에서 처리 */
     'upload-start': (file: FileInfo) => true;
+    /** 보내지 않음 (기존 코드 호환용 선언), 업로드는 사용하는 쪽에서 처리 */
     'upload-progress': (file: FileInfo, progress: number) => true;
+    /** 보내지 않음 (기존 코드 호환용 선언), 업로드는 사용하는 쪽에서 처리 */
     'upload-complete': (file: FileInfo) => true;
+    /** 보내지 않음 (기존 코드 호환용 선언), 업로드는 사용하는 쪽에서 처리 */
     'upload-error': (file: FileInfo, error: string) => true;
+    /** 전체 삭제 버튼을 눌렀을 때 */
     'clear-all': () => true;
+    /** 파일의 다운로드 버튼을 눌렀을 때 */
     download: (file: FileInfo) => true;
+    /** 파일의 미리보기 버튼을 눌렀을 때 */
     preview: (file: FileInfo) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 파일 목록 */
@@ -1938,13 +2022,13 @@ export declare const KrdsFileUpload: DefineComponent<ExtractPropTypes<{
     class: string;
     style: string | Record<string, any>;
     title: string;
+    id: string;
     modelValue: FileInfo[];
     placeholder: string;
-    id: string;
     accept: string;
-    multiple: boolean;
     maxFiles: number;
     maxFileSize: number;
+    multiple: boolean;
     dragAndDrop: boolean;
     description: string;
     showPreview: boolean;
@@ -2006,6 +2090,152 @@ export declare interface KrdsFileUploadProps extends BaseFormProps {
     showClearAll?: boolean;
 }
 
+/**
+ * KRDS FloatingButton 컴포넌트
+ *
+ * 화면에서 가장 자주 쓰는 중요한 작업을 화면 오른쪽 아래에 고정해 보여 주는 버튼입니다.
+ * `items`가 없으면 단일형(아이콘 + 레이블), 있으면 확장형(+ 버튼으로 항목을 펼치고 X로 닫음)입니다.
+ *
+ * @example
+ * ```vue
+ * <!-- 단일형 -->
+ * <KrdsFloatingButton label="채팅 상담" icon="ico-faq" @click="openChat" />
+ *
+ * <!-- 아이콘만 -->
+ * <KrdsFloatingButton label="맨 위로" icon="ico-go-top" hide-label @click="scrollToTop" />
+ *
+ * <!-- 확장형 -->
+ * <KrdsFloatingButton
+ *   label="상담 메뉴"
+ *   :items="[
+ *     { label: '전화 상담', icon: 'ico-call', href: 'tel:1555-6365' },
+ *     { label: '이메일 문의', icon: 'ico-email', href: 'mailto:krds@nia.or.kr' }
+ *   ]"
+ * />
+ * ```
+ */
+export declare const KrdsFloatingButton: DefineComponent<ExtractPropTypes<{
+    /** 단일형 버튼의 레이블, 확장형은 확장 버튼의 이름 (화면에는 숨김) */
+    label: {
+        type: StringConstructor;
+        required: true;
+    };
+    /** 단일형 버튼의 아이콘 클래스 */
+    icon: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 단일형 버튼의 링크 주소 */
+    href: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /** 단일형 링크를 새 창으로 열기 ('새 창 열림' 안내 포함) */
+    external: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 단일형 레이블을 화면에서 숨김 (아이콘만 표시, 화면낭독기는 읽음) */
+    hideLabel: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 확장형 항목 (지정하면 확장형, 3개 이하 권장) */
+    items: {
+        type: PropType<KrdsFloatingButtonItem[]>;
+        default: undefined;
+    };
+}>, () => VNode< RendererNode, RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 단일형 버튼 클릭 */
+    click: (event: MouseEvent) => true;
+    /** 확장형 항목 선택 (링크 항목은 event.preventDefault()로 라우터 이동 가능) */
+    select: (item: KrdsFloatingButtonItem, index: number, event: MouseEvent) => true;
+}, string, PublicProps, Readonly< ExtractPropTypes<{
+    /** 단일형 버튼의 레이블, 확장형은 확장 버튼의 이름 (화면에는 숨김) */
+    label: {
+        type: StringConstructor;
+        required: true;
+    };
+    /** 단일형 버튼의 아이콘 클래스 */
+    icon: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 단일형 버튼의 링크 주소 */
+    href: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /** 단일형 링크를 새 창으로 열기 ('새 창 열림' 안내 포함) */
+    external: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 단일형 레이블을 화면에서 숨김 (아이콘만 표시, 화면낭독기는 읽음) */
+    hideLabel: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 확장형 항목 (지정하면 확장형, 3개 이하 권장) */
+    items: {
+        type: PropType<KrdsFloatingButtonItem[]>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+    onSelect?: ((item: KrdsFloatingButtonItem, index: number, event: MouseEvent) => any) | undefined;
+}>, {
+    icon: string;
+    href: string;
+    external: boolean;
+    hideLabel: boolean;
+    items: KrdsFloatingButtonItem[];
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/**
+ * KRDS FloatingButton 컴포넌트 이벤트
+ */
+export declare interface KrdsFloatingButtonEmits {
+    /** 단일형 버튼 클릭 */
+    (e: 'click', event: MouseEvent): void;
+    /** 확장형 항목 선택 (링크 항목은 event.preventDefault()로 라우터 이동 가능) */
+    (e: 'select', item: KrdsFloatingButtonItem, index: number, event: MouseEvent): void;
+}
+
+/**
+ * 플로팅 버튼 항목 (단일형 버튼·확장형 항목 공통)
+ */
+export declare interface KrdsFloatingButtonItem {
+    /** 버튼 이름 (레이블) */
+    label: string;
+    /** 아이콘 클래스 (예: 'ico-faq') */
+    icon: string;
+    /** 링크 주소 (없으면 버튼으로 렌더링) */
+    href?: string;
+    /** 링크를 새 창으로 열기 ('새 창 열림' 안내 포함) */
+    external?: boolean;
+}
+
+/**
+ * KRDS FloatingButton 컴포넌트 속성
+ */
+export declare interface KrdsFloatingButtonProps extends BaseComponentProps {
+    /** 단일형 버튼의 레이블, 확장형은 확장 버튼의 이름 (화면에는 숨김) */
+    label: string;
+    /** 단일형 버튼의 아이콘 클래스 */
+    icon?: string;
+    /** 단일형 버튼의 링크 주소 */
+    href?: string;
+    /** 단일형 링크를 새 창으로 열기 ('새 창 열림' 안내 포함) */
+    external?: boolean;
+    /** 단일형 레이블을 화면에서 숨김 (아이콘만 표시, 화면낭독기는 읽음) */
+    hideLabel?: boolean;
+    /** 확장형 항목 (지정하면 확장형, 3개 이하 권장) */
+    items?: KrdsFloatingButtonItem[];
+}
+
 export declare const KrdsFooter: DefineComponent<ExtractPropTypes<{
     /** Footer ID */
     id: {
@@ -2033,7 +2263,16 @@ export declare const KrdsFooter: DefineComponent<ExtractPropTypes<{
 }>> & Readonly<{}>, {
     class: string;
     id: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 푸터 위 빠른 링크 영역 */
+    top?(): VNode[];
+    /** 로고 */
+    logo?(): VNode[];
+    /** 기관 정보와 링크 */
+    content?(): VNode[];
+    /** 하단 메뉴·저작권·운영기관 식별자 */
+    bottom?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Footer 컴포넌트 속성
@@ -2059,7 +2298,7 @@ export declare const KrdsFormGroup: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /** CSS 클래스 */
@@ -2081,7 +2320,10 @@ export declare const KrdsFormGroup: DefineComponent<ExtractPropTypes<{
     class: string;
     style: string | Record<string, any>;
     id: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 레이블·입력 요소·도움말 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS FormGroup 컴포넌트 속성
@@ -2109,9 +2351,10 @@ export declare const KrdsFormHint: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 도움말 문구를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 힌트 타입 */
@@ -2141,7 +2384,10 @@ export declare const KrdsFormHint: DefineComponent<ExtractPropTypes<{
     class: string;
     style: string | Record<string, any>;
     id: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 도움말 문구 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS FormHint 컴포넌트 이벤트
@@ -2179,9 +2425,10 @@ export declare const KrdsFormLabel: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 레이블을 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** label의 for 속성 */
@@ -2211,7 +2458,10 @@ export declare const KrdsFormLabel: DefineComponent<ExtractPropTypes<{
     style: string | Record<string, any>;
     id: string;
     for: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 레이블 문구 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS FormLabel 컴포넌트 이벤트
@@ -2323,9 +2573,10 @@ export declare const KrdsIdentifier: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: string;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 운영기관 식별자를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** CSS 클래스 */
@@ -2343,7 +2594,10 @@ export declare const KrdsIdentifier: DefineComponent<ExtractPropTypes<{
 }>, {
     class: string;
     logoLabel: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 운영기관 안내 문구 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Identifier 컴포넌트 이벤트
@@ -2398,6 +2652,7 @@ export declare const KrdsInPageNavigation: DefineComponent<ExtractPropTypes<{
 }>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 탐색 항목을 클릭하거나 키보드로 선택했을 때 */
     itemClick: (item: NavigationItem, event: MouseEvent | KeyboardEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 네비게이션 제목 */
@@ -2575,15 +2830,22 @@ export declare const KrdsInput: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 입력값이 바뀔 때 (v-model) */
     'update:modelValue': (value: string | number) => true;
+    /** 입력할 때 (네이티브 input) */
     input: (event: Event) => true;
+    /** 값이 확정됐을 때 (네이티브 change) */
     change: (event: Event) => true;
+    /** 초점을 받았을 때 */
     focus: (event: FocusEvent) => true;
+    /** 초점을 잃었을 때 */
     blur: (event: FocusEvent) => true;
+    /** 키를 눌렀을 때 */
     keydown: (event: KeyboardEvent) => true;
+    /** 키를 뗐을 때 */
     keyup: (event: KeyboardEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 입력값 */
@@ -2703,6 +2965,7 @@ export declare const KrdsInput: DefineComponent<ExtractPropTypes<{
     size: Size;
     icon: boolean;
     class: string;
+    id: string;
     modelValue: string | number;
     placeholder: string;
     maxlength: number;
@@ -2714,8 +2977,10 @@ export declare const KrdsInput: DefineComponent<ExtractPropTypes<{
     autofocus: boolean;
     state: "success" | "error" | "default" | "information";
     loading: boolean;
-    id: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 입력 필드 안쪽 버튼 (icon 속성과 함께, 여러 개면 KrdsButtonGroup) */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Input 컴포넌트 이벤트
@@ -2787,10 +3052,12 @@ export declare const KrdsLanguageSwitcher: DefineComponent<ExtractPropTypes<{
         type: PropType<DropdownPosition>;
         default: string;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 언어를 골랐을 때 (언어 코드, v-model) */
     'update:modelValue': (value: string) => true;
+    /** 언어 목록이 닫힐 때 */
     close: () => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 언어 목록 */
@@ -2820,7 +3087,12 @@ export declare const KrdsLanguageSwitcher: DefineComponent<ExtractPropTypes<{
     type: "default" | "external";
     modelValue: string;
     dropPosition: DropdownPosition;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 언어 버튼 문구 (예: Language) */
+    default?(): VNode[];
+    /** 언어 목록 위에 넣을 내용 */
+    'prev-item'?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS LanguageSwitcher 컴포넌트 이벤트
@@ -2860,12 +3132,15 @@ export declare const KrdsLayout: DefineComponent<ExtractPropTypes<{
         type: BooleanConstructor;
         default: boolean;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-    resize: (_size: LayoutSize) => true;
-    scroll: (_details: ScrollDetails) => true;
-    'scroll-height': (_height: number) => true;
+    /** 창 크기가 바뀔 때 (레이아웃 크기) */
+    resize: (size: LayoutSize) => true;
+    /** 스크롤할 때 (위치·방향) */
+    scroll: (details: ScrollDetails) => true;
+    /** 문서 스크롤 높이가 바뀔 때 */
+    'scroll-height': (height: number) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 레이아웃 ID */
     id: {
@@ -2883,14 +3158,17 @@ export declare const KrdsLayout: DefineComponent<ExtractPropTypes<{
         default: boolean;
     };
 }>> & Readonly<{
-    onResize?: ((_size: LayoutSize) => any) | undefined;
-    onScroll?: ((_details: ScrollDetails) => any) | undefined;
-    "onScroll-height"?: ((_height: number) => any) | undefined;
+    onResize?: ((size: LayoutSize) => any) | undefined;
+    onScroll?: ((details: ScrollDetails) => any) | undefined;
+    "onScroll-height"?: ((height: number) => any) | undefined;
 }>, {
     class: string;
     id: string;
     enableScrollDetection: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 페이지 내용 (공식 배너·헤더·본문·푸터) */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Layout 컴포넌트 이벤트
@@ -2952,9 +3230,10 @@ export declare const KrdsLink: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 링크를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 링크 URL */
@@ -3008,7 +3287,10 @@ export declare const KrdsLink: DefineComponent<ExtractPropTypes<{
     href: string;
     target: string;
     basic: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 링크 내용 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Link 컴포넌트 이벤트
@@ -3081,8 +3363,11 @@ export declare const KrdsMainMenu: DefineComponent<ExtractPropTypes<{
 }>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 모바일 메뉴가 열리거나 닫힐 때 (v-model:open) */
     'update:open': (value: boolean) => true;
+    /** 1차 메뉴를 펼치거나 접을 때 (순서, 펼침 여부) */
     'menu-toggle': (index: number, expanded: boolean) => true;
+    /** 메뉴 항목을 클릭했을 때 */
     'item-click': (item: MainMenuAnyItem, mouseEvent: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 메뉴 아이템 배열 */
@@ -3184,9 +3469,10 @@ export declare const KrdsMasthead: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 공식 배너를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** CSS 클래스 */
@@ -3198,7 +3484,10 @@ export declare const KrdsMasthead: DefineComponent<ExtractPropTypes<{
     onClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
     class: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 공식 배너 문구 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Masthead 컴포넌트 이벤트
@@ -3251,6 +3540,7 @@ export declare const KrdsModal: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }> | null, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 모달이 열리거나 닫힐 때 (v-model) */
     'update:modelValue': (value: boolean) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 모달 표시 여부 (v-model) */
@@ -3350,6 +3640,7 @@ export declare const KrdsPagination: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 페이지를 바꿀 때 (페이지 번호, v-model) */
     'update:modelValue': (value: number) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 현재 페이지 번호 (v-model) */
@@ -3385,9 +3676,9 @@ export declare const KrdsPagination: DefineComponent<ExtractPropTypes<{
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((value: number) => any) | undefined;
 }>, {
+    id: string;
     modelValue: number;
     min: number;
-    id: string;
     ariaLabel: string;
     pageRange: number;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
@@ -3424,9 +3715,20 @@ export declare const KrdsPanel: DefineComponent<ExtractPropTypes<{
         type: BooleanConstructor;
         default: boolean;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+    /** 헤더 상단 영역 선택자 (기본값: '#krds-masthead', KrdsInPageNavigation과 같음) */
+    headerTopSelector: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 헤더 내부 영역 선택자 (기본값: '#krds-header .header-in', KrdsInPageNavigation과 같음) */
+    headerInnerSelector: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 도움 패널을 펼치거나 접을 때 (v-model) */
     'update:modelValue': (value: boolean) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 도움말 패널 펼침 상태 (v-model) */
@@ -3434,11 +3736,26 @@ export declare const KrdsPanel: DefineComponent<ExtractPropTypes<{
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 헤더 상단 영역 선택자 (기본값: '#krds-masthead', KrdsInPageNavigation과 같음) */
+    headerTopSelector: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 헤더 내부 영역 선택자 (기본값: '#krds-header .header-in', KrdsInPageNavigation과 같음) */
+    headerInnerSelector: {
+        type: StringConstructor;
+        default: string;
+    };
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
     modelValue: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    headerTopSelector: string;
+    headerInnerSelector: string;
+}, SlotsType<{
+    /** 도움 패널 내용 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Panel 컴포넌트 이벤트
@@ -3453,6 +3770,10 @@ export declare interface KrdsPanelEmits {
 export declare interface KrdsPanelProps {
     /** 도움말 패널 펼침 상태 (v-model) */
     modelValue?: boolean;
+    /** 헤더 상단 영역 선택자 (기본값: '#krds-masthead') */
+    headerTopSelector?: string;
+    /** 헤더 내부 영역 선택자 (기본값: '#krds-header .header-in') */
+    headerInnerSelector?: string;
 }
 
 export declare const KrdsRadio: DefineComponent<ExtractPropTypes<{
@@ -3500,6 +3821,7 @@ export declare const KrdsRadio: DefineComponent<ExtractPropTypes<{
 }>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 이 항목을 선택할 때 (항목 value, v-model) */
     'update:modelValue': (value: string | number | boolean) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 모델 값 */
@@ -3550,8 +3872,8 @@ export declare const KrdsRadio: DefineComponent<ExtractPropTypes<{
     disabled: boolean;
     size: "medium" | "large";
     class: string;
-    modelValue: string | number | boolean;
     id: string;
+    modelValue: string | number | boolean;
     chip: boolean;
 }, SlotsType<{
     default?: () => VNode[];
@@ -3581,24 +3903,51 @@ export declare interface KrdsRadioProps extends BaseFormProps {
     chip?: boolean;
 }
 
-export declare const KrdsResize: DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+export declare const KrdsResize: DefineComponent<ExtractPropTypes<{
+    /** 선택한 화면 크기 (v-model). 지정하면 그 크기로 화면을 확대·축소한다 */
+    modelValue: {
+        type: PropType<KrdsResizeScale>;
+        default: undefined;
+    };
+}>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-    'update:modelValue': (value: string) => true;
+    /** 화면 크기를 골랐을 때 (v-model) */
+    'update:modelValue': (value: KrdsResizeScale) => true;
+    /** 크기 목록이 닫힐 때 */
     close: () => true;
-}, string, PublicProps, Readonly<{}> & Readonly<{
+}, string, PublicProps, Readonly< ExtractPropTypes<{
+    /** 선택한 화면 크기 (v-model). 지정하면 그 크기로 화면을 확대·축소한다 */
+    modelValue: {
+        type: PropType<KrdsResizeScale>;
+        default: undefined;
+    };
+}>> & Readonly<{
     onClose?: (() => any) | undefined;
-    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    "onUpdate:modelValue"?: ((value: KrdsResizeScale) => any) | undefined;
+}>, {
+    modelValue: KrdsResizeScale;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Resize 컴포넌트 이벤트
  */
 export declare interface KrdsResizeEmits {
-    (e: 'update:modelValue', value: string): void;
+    (e: 'update:modelValue', value: KrdsResizeScale): void;
     (e: 'close'): void;
 }
 
+/**
+ * KRDS Resize 컴포넌트 속성
+ */
+export declare interface KrdsResizeProps {
+    /** 선택한 화면 크기 (v-model). 지정하면 그 크기로 화면을 확대·축소한다 */
+    modelValue?: KrdsResizeScale;
+}
+
+/** 화면 크기 (작게 sm · 보통 md · 조금 크게 lg · 크게 xlg · 가장 크게 xxlg) */
+export declare type KrdsResizeScale = 'sm' | 'md' | 'lg' | 'xlg' | 'xxlg';
+
 export declare const KrdsSelect: DefineComponent<ExtractPropTypes<{
     /** 선택된 값 */
     modelValue: {
@@ -3660,11 +4009,14 @@ export declare const KrdsSelect: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 선택한 값이 바뀔 때 (v-model) */
     'update:modelValue': (value: string | number | null) => true;
+    /** 초점을 받았을 때 */
     focus: (event: FocusEvent) => true;
+    /** 초점을 잃었을 때 */
     blur: (event: FocusEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 선택된 값 */
@@ -3739,12 +4091,15 @@ export declare const KrdsSelect: DefineComponent<ExtractPropTypes<{
     class: string;
     sort: boolean;
     title: string;
+    id: string;
     modelValue: string | number | null;
     placeholder: string;
     state: "success" | "error" | "default" | "information";
-    id: string;
     options: SelectOption[];
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 직접 넣는 option 요소 (options 속성과 함께 쓸 수 있음) */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Select 컴포넌트 이벤트
@@ -3783,6 +4138,7 @@ export declare const KrdsSideNavigation: DefineComponent<{
 }, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 메뉴를 펼치거나 접어 항목 상태가 바뀔 때 (v-model) */
     'update:modelValue': (value: SideNavItem[]) => true;
 }, string, PublicProps, Readonly<{
     title: string;
@@ -3913,7 +4269,10 @@ export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
         href: string;
         label: string;
     }[];
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 링크 문구 (links를 쓰지 않을 때) */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS SkipLink 컴포넌트 속성
@@ -3955,7 +4314,7 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         required: true;
     };
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status: {
         type: () => "done" | "active" | "pending";
         default: undefined;
@@ -3965,9 +4324,10 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 단계를 클릭했을 때 (단계 번호) */
     click: (event: MouseEvent, step: string | number) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 단계 번호 */
@@ -3980,7 +4340,7 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         required: true;
     };
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status: {
         type: () => "done" | "active" | "pending";
         default: undefined;
@@ -3995,7 +4355,10 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
 }>, {
     class: string;
     status: "active" | "done" | "pending";
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 단계 제목 아래 추가 내용 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Step 컴포넌트 이벤트
@@ -4004,8 +4367,14 @@ export declare interface KrdsStepEmits {
     (e: 'click', event: MouseEvent, step: string | number): void;
 }
 
+/**
+ * KRDS StepIndicator 컴포넌트
+ *
+ * 진행 상태를 보여 주기만 하는 컴포넌트입니다 (KRDS 원본과 같이 단계를 눌러 이동하지 않음).
+ * 단계 이동은 이전/다음 버튼 등에서 `model-value`를 바꿔 반영합니다.
+ */
 export declare const KrdsStepIndicator: DefineComponent<ExtractPropTypes<{
-    /** 현재 활성 단계 인덱스 (0부터 시작) - v-model */
+    /** 현재 단계 인덱스 (0부터 시작). 앞 단계는 완료, 뒤 단계는 대기로 표시 */
     modelValue: {
         type: NumberConstructor;
         default: number;
@@ -4015,12 +4384,16 @@ export declare const KrdsStepIndicator: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /**
+     * 보내지 않음: 단계 표시기는 진행 상태만 보여 주므로 v-model 값이 바뀌지 않습니다 (기존 코드 호환용, 다음 주요 버전에서 제거)
+     * @deprecated
+     */
     'update:modelValue': (value: number) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
-    /** 현재 활성 단계 인덱스 (0부터 시작) - v-model */
+    /** 현재 단계 인덱스 (0부터 시작). 앞 단계는 완료, 뒤 단계는 대기로 표시 */
     modelValue: {
         type: NumberConstructor;
         default: number;
@@ -4035,10 +4408,14 @@ export declare const KrdsStepIndicator: DefineComponent<ExtractPropTypes<{
 }>, {
     class: string;
     modelValue: number;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 단계 (KrdsStep) */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS StepIndicator 컴포넌트 이벤트
+ * @deprecated 단계 표시기는 진행 상태만 보여 주므로 update:modelValue를 보내지 않습니다. 다음 주요 버전에서 제거합니다.
  */
 export declare interface KrdsStepIndicatorEmits {
     (e: 'update:modelValue', value: number): void;
@@ -4048,7 +4425,7 @@ export declare interface KrdsStepIndicatorEmits {
  * KRDS StepIndicator 컴포넌트 속성
  */
 export declare interface KrdsStepIndicatorProps extends BaseComponentProps {
-    /** 현재 활성 단계 인덱스 (0부터 시작) - v-model */
+    /** 현재 단계 인덱스 (0부터 시작). 앞 단계는 완료, 뒤 단계는 대기로 표시 */
     modelValue?: number;
 }
 
@@ -4060,7 +4437,7 @@ export declare interface KrdsStepProps extends BaseComponentProps {
     step: string | number;
     /** 단계 제목 */
     title: string;
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status?: 'done' | 'active' | 'pending';
 }
 
@@ -4131,6 +4508,7 @@ export declare const KrdsTable: DefineComponent<ExtractPropTypes<{
 }>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 행을 클릭했을 때 (행, 순서) */
     'row-click': (row: TableRow, index: number) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 테이블 캡션 */
@@ -4212,10 +4590,12 @@ export declare const KrdsTabs: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 선택한 탭 id가 바뀔 때 (v-model) */
     'update:modelValue': (id: string) => true;
+    /** 탭을 바꿨을 때 (탭 id) */
     change: (id: string) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 탭 아이템 목록 */
@@ -4257,7 +4637,7 @@ export declare const KrdsTabs: DefineComponent<ExtractPropTypes<{
     modelValue: string;
     full: boolean;
     selectedText: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<Record<string, () => VNode[]>>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Tabs 컴포넌트 이벤트
@@ -4314,9 +4694,10 @@ export declare const KrdsTag: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 삭제 버튼을 클릭했을 때 */
     remove: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 링크 태그 여부 */
@@ -4352,7 +4733,10 @@ export declare const KrdsTag: DefineComponent<ExtractPropTypes<{
     href: string;
     target: string;
     rel: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 태그 글자 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Tag 컴포넌트 이벤트
@@ -4372,7 +4756,7 @@ export declare const KrdsTagGroup: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: undefined;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 태그 그룹 크기 */
@@ -4388,7 +4772,10 @@ export declare const KrdsTagGroup: DefineComponent<ExtractPropTypes<{
 }>> & Readonly<{}>, {
     size: KrdsTagGroupSize;
     class: string;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 태그 (KrdsTag) */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS TagGroup 컴포넌트 속성
@@ -4501,12 +4888,19 @@ export declare const KrdsTextarea: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 입력값이 바뀔 때 (v-model) */
     'update:modelValue': (value: string) => true;
+    /** 입력할 때 (네이티브 input) */
     input: (event: Event) => true;
+    /** 값이 확정됐을 때 (네이티브 change) */
     change: (event: Event) => true;
+    /** 초점을 받았을 때 */
     focus: (event: FocusEvent) => true;
+    /** 초점을 잃었을 때 */
     blur: (event: FocusEvent) => true;
+    /** 키를 눌렀을 때 */
     keydown: (event: KeyboardEvent) => true;
+    /** 키를 뗐을 때 */
     keyup: (event: KeyboardEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 입력값 */
@@ -4605,12 +4999,12 @@ export declare const KrdsTextarea: DefineComponent<ExtractPropTypes<{
     size: Size;
     class: string;
     resize: "horizontal" | "vertical" | "none" | "both";
+    id: string;
     modelValue: string;
     placeholder: string;
     maxlength: number;
     minlength: number;
     autofocus: boolean;
-    id: string;
     rows: number;
     cols: number;
     showCount: boolean;
@@ -4668,7 +5062,7 @@ export declare const KrdsTextList: DefineComponent<ExtractPropTypes<{
         type: () => "decimal" | "dash" | "hollow" | "ordered";
         default: string;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 리스트 타입 */
@@ -4684,7 +5078,10 @@ export declare const KrdsTextList: DefineComponent<ExtractPropTypes<{
 }>> & Readonly<{}>, {
     type: "ol" | "ul";
     variant: "decimal" | "dash" | "hollow" | "ordered";
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 목록 항목 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS TextList 컴포넌트 속성
@@ -4746,7 +5143,9 @@ export declare const KrdsToggleSwitch: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 켜짐 상태가 바뀔 때 (v-model) */
     'update:modelValue': (value: boolean) => true;
+    /** 켜거나 껐을 때 */
     change: (value: boolean) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 모델 값 */
@@ -4806,8 +5205,8 @@ export declare const KrdsToggleSwitch: DefineComponent<ExtractPropTypes<{
     size: "medium" | "large";
     class: string;
     label: string;
-    modelValue: boolean;
     id: string;
+    modelValue: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -4858,7 +5257,7 @@ export declare const KrdsTooltip: DefineComponent<ExtractPropTypes<{
         type: BooleanConstructor;
         default: boolean;
     };
-}>, () => VNode<RendererNode, RendererElement, {
+}>, () => VNode< RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 트리거 버튼 타입 */
@@ -4891,7 +5290,10 @@ export declare const KrdsTooltip: DefineComponent<ExtractPropTypes<{
     disabled: boolean;
     type: TooltipType;
     box: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}, SlotsType<{
+    /** 툴팁을 여는 버튼 내용 */
+    default?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS Tooltip 컴포넌트 속성
@@ -4943,9 +5345,13 @@ export declare const KrdsTts: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 읽기를 시작했을 때 (읽는 문장) */
     play: (text: string) => true;
+    /** 일시 정지했을 때 */
     pause: () => true;
+    /** 읽기가 끝났을 때 */
     end: () => true;
+    /** 음성 합성을 지원하지 않거나 읽기에 실패했을 때 */
     error: (error: Error) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 읽어줄 텍스트 */