@krds.ui/vue 0.0.20 → 0.0.21

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,
@@ -401,6 +407,7 @@ export declare const KrdsAccordionItem: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 펼침·접힘 버튼을 눌렀을 때 (항목 id) */
     toggle: (id: string) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 아이템 고유 식별자 */
@@ -481,6 +488,7 @@ export declare const KrdsBadge: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 배지를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 배지 타입 */
@@ -560,6 +568,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<{
     /** 브레드크럼 아이템 배열 */
@@ -660,6 +669,7 @@ export declare const KrdsButton: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 버튼을 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 버튼 타입 */
@@ -728,6 +738,22 @@ export declare interface KrdsButtonEmits {
     (e: 'click', event: MouseEvent): void;
 }
 
+/**
+ * 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>;
@@ -853,10 +879,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) */
@@ -1122,6 +1153,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 +1193,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[];
@@ -1219,7 +1251,9 @@ export declare const KrdsCoachMark: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 이전·다음 버튼으로 단계가 바뀔 때 (v-model) */
     'update:modelValue': (value: number | null) => true;
+    /** 닫기 버튼으로 닫을 때 */
     close: () => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 코치마크 래퍼에 추가할 클래스 */
@@ -1368,6 +1402,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 +1533,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 +1632,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;
@@ -1656,6 +1696,7 @@ export declare const KrdsDisclosure: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 펼침 상태가 바뀔 때 (v-model) */
     'update:modelValue': (value: boolean) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 디스클로저 제목 */
@@ -1800,16 +1841,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 +1990,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 +2058,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: {
@@ -2112,6 +2310,7 @@ export declare const KrdsFormHint: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 도움말 문구를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 힌트 타입 */
@@ -2182,6 +2381,7 @@ export declare const KrdsFormLabel: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 레이블을 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** label의 for 속성 */
@@ -2326,6 +2526,7 @@ export declare const KrdsIdentifier: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 운영기관 식별자를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** CSS 클래스 */
@@ -2398,6 +2599,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<{
     /** 네비게이션 제목 */
@@ -2578,12 +2780,19 @@ export declare const KrdsInput: DefineComponent<ExtractPropTypes<{
 }>, () => 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 +2912,7 @@ export declare const KrdsInput: DefineComponent<ExtractPropTypes<{
     size: Size;
     icon: boolean;
     class: string;
+    id: string;
     modelValue: string | number;
     placeholder: string;
     maxlength: number;
@@ -2714,7 +2924,6 @@ export declare const KrdsInput: DefineComponent<ExtractPropTypes<{
     autofocus: boolean;
     state: "success" | "error" | "default" | "information";
     loading: boolean;
-    id: string;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -2790,7 +2999,9 @@ export declare const KrdsLanguageSwitcher: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 언어를 골랐을 때 (언어 코드, v-model) */
     'update:modelValue': (value: string) => true;
+    /** 언어 목록이 닫힐 때 */
     close: () => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 언어 목록 */
@@ -2863,9 +3074,12 @@ export declare const KrdsLayout: DefineComponent<ExtractPropTypes<{
 }>, () => 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,9 +3097,9 @@ 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;
@@ -2955,6 +3169,7 @@ export declare const KrdsLink: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 링크를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 링크 URL */
@@ -3081,8 +3296,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<{
     /** 메뉴 아이템 배열 */
@@ -3187,6 +3405,7 @@ export declare const KrdsMasthead: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 공식 배너를 클릭했을 때 */
     click: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** CSS 클래스 */
@@ -3251,6 +3470,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 +3570,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 +3606,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 +3645,20 @@ 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;
+    };
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 도움 패널을 펼치거나 접을 때 (v-model) */
     'update:modelValue': (value: boolean) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 도움말 패널 펼침 상태 (v-model) */
@@ -3434,10 +3666,22 @@ 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;
+    headerTopSelector: string;
+    headerInnerSelector: string;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -3453,6 +3697,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 +3748,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 +3799,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 +3830,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: {
@@ -3663,8 +3939,11 @@ export declare const KrdsSelect: DefineComponent<ExtractPropTypes<{
 }>, () => 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,10 +4018,10 @@ 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>;
 
@@ -3783,6 +4062,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;
@@ -3955,7 +4235,7 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         required: true;
     };
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status: {
         type: () => "done" | "active" | "pending";
         default: undefined;
@@ -3968,6 +4248,7 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 단계를 클릭했을 때 (단계 번호) */
     click: (event: MouseEvent, step: string | number) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 단계 번호 */
@@ -3980,7 +4261,7 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         required: true;
     };
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status: {
         type: () => "done" | "active" | "pending";
         default: undefined;
@@ -4004,8 +4285,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;
@@ -4018,9 +4305,13 @@ export declare const KrdsStepIndicator: DefineComponent<ExtractPropTypes<{
 }>, () => 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;
@@ -4039,6 +4330,7 @@ export declare const KrdsStepIndicator: DefineComponent<ExtractPropTypes<{
 
 /**
  * KRDS StepIndicator 컴포넌트 이벤트
+ * @deprecated 단계 표시기는 진행 상태만 보여 주므로 update:modelValue를 보내지 않습니다. 다음 주요 버전에서 제거합니다.
  */
 export declare interface KrdsStepIndicatorEmits {
     (e: 'update:modelValue', value: number): void;
@@ -4048,7 +4340,7 @@ export declare interface KrdsStepIndicatorEmits {
  * KRDS StepIndicator 컴포넌트 속성
  */
 export declare interface KrdsStepIndicatorProps extends BaseComponentProps {
-    /** 현재 활성 단계 인덱스 (0부터 시작) - v-model */
+    /** 현재 단계 인덱스 (0부터 시작). 앞 단계는 완료, 뒤 단계는 대기로 표시 */
     modelValue?: number;
 }
 
@@ -4060,7 +4352,7 @@ export declare interface KrdsStepProps extends BaseComponentProps {
     step: string | number;
     /** 단계 제목 */
     title: string;
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status?: 'done' | 'active' | 'pending';
 }
 
@@ -4131,6 +4423,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<{
     /** 테이블 캡션 */
@@ -4215,7 +4508,9 @@ export declare const KrdsTabs: DefineComponent<ExtractPropTypes<{
 }>, () => 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<{
     /** 탭 아이템 목록 */
@@ -4317,6 +4612,7 @@ export declare const KrdsTag: DefineComponent<ExtractPropTypes<{
 }>, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /** 삭제 버튼을 클릭했을 때 */
     remove: (event: MouseEvent) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     /** 링크 태그 여부 */
@@ -4501,12 +4797,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 +4908,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;
@@ -4746,7 +5049,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 +5111,8 @@ export declare const KrdsToggleSwitch: DefineComponent<ExtractPropTypes<{
     size: "medium" | "large";
     class: string;
     label: string;
-    modelValue: boolean;
     id: string;
+    modelValue: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -4943,9 +5248,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<{
     /** 읽어줄 텍스트 */