@krds.ui/vue 0.0.19 → 0.0.21

package/dist/types/index.d.ts

@@ -18,6 +18,7 @@ export declare type AlertType = 'danger' | 'ok' | 'info';
 
 /**
  * 정렬 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type Alignment = 'left' | 'center' | 'right' | 'justify';
 
@@ -84,6 +85,10 @@ declare namespace components {
         KrdsButtonGroupProps,
         KrdsIcon,
         KrdsIconProps,
+        KrdsFloatingButton,
+        KrdsFloatingButtonProps,
+        KrdsFloatingButtonEmits,
+        KrdsFloatingButtonItem,
         KrdsLink,
         KrdsLinkProps,
         KrdsLinkEmits,
@@ -172,6 +177,8 @@ declare namespace components {
         DropdownPosition,
         KrdsResize,
         KrdsResizeEmits,
+        KrdsResizeProps,
+        KrdsResizeScale,
         KrdsModal,
         KrdsModalProps,
         KrdsModalSize,
@@ -244,6 +251,7 @@ declare namespace components {
 
 /**
  * 컴포넌트 슬롯 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare interface ComponentSlots {
     default?: () => unknown;
@@ -252,6 +260,7 @@ export declare interface ComponentSlots {
 
 /**
  * 컴포넌트 상태 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type ComponentState = 'default' | 'hover' | 'active' | 'focus' | 'disabled';
 
@@ -259,11 +268,13 @@ declare type ContextualHelpPosition = 'top left' | 'top center' | 'top right' |
 
 /**
  * CSS 변수 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type CSSCustomProperties = Record<`--${string}`, string | number>;
 
 /**
  * 방향 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type Direction = 'horizontal' | 'vertical';
 
@@ -302,6 +313,7 @@ export declare interface FileInfo {
  *
  * @param prefix - ID 접두사
  * @returns 고유한 ID 문자열
+ * @deprecated 모듈 전역 카운터라 SSR에서 요청 간 값이 공유된다. Vue의 `useId()`를 사용. 다음 breaking 릴리스에서 제거 예정
  */
 export declare function generateId(prefix?: string): string;
 
@@ -310,11 +322,13 @@ export declare function generateId(prefix?: string): string;
  * 브라우저와 Node.js 환경에서 모두 작동합니다.
  *
  * @returns 7자리 랜덤 문자열
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare function generateUid(): string;
 
 /**
  * 아이콘 속성
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare interface IconProps {
     /** 아이콘 이름 */
@@ -327,6 +341,7 @@ export declare interface IconProps {
 
 /**
  * 입력 상태 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type InputState = ComponentState | 'error' | 'success';
 
@@ -392,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<{
     /** 아이템 고유 식별자 */
@@ -472,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<{
     /** 배지 타입 */
@@ -551,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<{
     /** 브레드크럼 아이템 배열 */
@@ -651,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<{
     /** 버튼 타입 */
@@ -719,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>;
@@ -844,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) */
@@ -1113,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<{
     /** 모델 값 */
@@ -1152,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[];
@@ -1210,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<{
     /** 코치마크 래퍼에 추가할 클래스 */
@@ -1271,6 +1314,7 @@ export declare interface KrdsCoachMarkProps extends BaseComponentProps {
 
 /**
  * KRDS 컴포넌트 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type KrdsComponent<Props = object, Slots = object, Emits = object> = Component & {
     __krdsComponent: true;
@@ -1317,9 +1361,9 @@ export declare const KrdsContextualHelp: DefineComponent<ExtractPropTypes<{
         default: string;
     };
 }>> & Readonly<{}>, {
+    position: ContextualHelpPosition;
     tooltipTitle: string;
     helpIcon: boolean;
-    position: ContextualHelpPosition;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -1358,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<{
     /** 알림 타입 */
@@ -1470,6 +1515,11 @@ export declare const KrdsDateInput: DefineComponent<ExtractPropTypes<{
         type: NumberConstructor;
         default: undefined;
     };
+    /** 달력을 body에 렌더 (overflow로 잘리는 컨테이너 안에서 사용. 모달 안에서는 쓰지 않음) */
+    teleport: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** CSS 클래스 */
     class: {
         type: StringConstructor;
@@ -1483,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<{
     /** 선택된 날짜 값 */
@@ -1549,6 +1604,11 @@ export declare const KrdsDateInput: DefineComponent<ExtractPropTypes<{
         type: NumberConstructor;
         default: undefined;
     };
+    /** 달력을 body에 렌더 (overflow로 잘리는 컨테이너 안에서 사용. 모달 안에서는 쓰지 않음) */
+    teleport: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** CSS 클래스 */
     class: {
         type: StringConstructor;
@@ -1572,14 +1632,15 @@ 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;
     initialMonth: number;
+    teleport: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -1617,6 +1678,8 @@ export declare interface KrdsDateInputProps extends BaseFormProps {
     initialYear?: number;
     /** 초기 표시 월 (기본: 현재 월) */
     initialMonth?: number;
+    /** 달력을 body에 렌더 (overflow로 잘리는 컨테이너 안에서 사용. 모달 안에서는 쓰지 않음) */
+    teleport?: boolean;
 }
 
 export declare const KrdsDisclosure: DefineComponent<ExtractPropTypes<{
@@ -1633,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<{
     /** 디스클로저 제목 */
@@ -1777,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<{
     /** 파일 목록 */
@@ -1915,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;
@@ -1983,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: {
@@ -2089,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<{
     /** 힌트 타입 */
@@ -2159,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 속성 */
@@ -2303,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 클래스 */
@@ -2375,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<{
     /** 네비게이션 제목 */
@@ -2555,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<{
     /** 입력값 */
@@ -2680,6 +2912,7 @@ export declare const KrdsInput: DefineComponent<ExtractPropTypes<{
     size: Size;
     icon: boolean;
     class: string;
+    id: string;
     modelValue: string | number;
     placeholder: string;
     maxlength: number;
@@ -2691,7 +2924,6 @@ export declare const KrdsInput: DefineComponent<ExtractPropTypes<{
     autofocus: boolean;
     state: "success" | "error" | "default" | "information";
     loading: boolean;
-    id: string;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -2767,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<{
     /** 언어 목록 */
@@ -2840,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: {
@@ -2860,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;
@@ -2932,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 */
@@ -3058,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<{
     /** 메뉴 아이템 배열 */
@@ -3164,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 클래스 */
@@ -3228,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) */
@@ -3327,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) */
@@ -3362,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>;
@@ -3401,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) */
@@ -3411,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>;
 
 /**
@@ -3430,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<{
@@ -3477,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<{
     /** 모델 값 */
@@ -3527,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[];
@@ -3558,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: {
@@ -3640,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<{
     /** 선택된 값 */
@@ -3716,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>;
 
@@ -3760,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;
@@ -3796,9 +4099,16 @@ export declare interface KrdsSideNavigationProps {
  *
  * @example
  * ```vue
+ * <!-- 단일 링크 -->
  * <KrdsSkipLink href="#main-content">본문 바로가기</KrdsSkipLink>
- * <KrdsSkipLink href="#breadcrumb">본문 바로가기</KrdsSkipLink>
- * <KrdsSkipLink href="#gnb">메인메뉴 바로가기</KrdsSkipLink>
+ *
+ * <!-- 여러 링크: 컴포넌트를 나란히 두면 #krds-skip-link가 중복되므로 links 사용 -->
+ * <KrdsSkipLink
+ *   :links="[
+ *     { href: '#main-content', label: '본문 바로가기' },
+ *     { href: '#gnb', label: '메인메뉴 바로가기' }
+ *   ]"
+ * />
  * ```
  */
 export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
@@ -3808,9 +4118,22 @@ export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
      */
     href: {
         type: StringConstructor;
-        required: true;
+        default: undefined;
         validator: (value: string) => boolean;
     };
+    /**
+     * 여러 건너뛰기 링크 (하나의 래퍼 안에 렌더링, 지정 시 href·기본 슬롯 대신 사용)
+     */
+    links: {
+        type: PropType<{
+            href: string;
+            label: string;
+        }[]>;
+        default: undefined;
+        validator: (value: {
+            href: string;
+        }[]) => boolean;
+    };
     /**
      * 추가 CSS 클래스
      */
@@ -3832,9 +4155,22 @@ export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
      */
     href: {
         type: StringConstructor;
-        required: true;
+        default: undefined;
         validator: (value: string) => boolean;
     };
+    /**
+     * 여러 건너뛰기 링크 (하나의 래퍼 안에 렌더링, 지정 시 href·기본 슬롯 대신 사용)
+     */
+    links: {
+        type: PropType<{
+            href: string;
+            label: string;
+        }[]>;
+        default: undefined;
+        validator: (value: {
+            href: string;
+        }[]) => boolean;
+    };
     /**
      * 추가 CSS 클래스
      */
@@ -3851,15 +4187,25 @@ export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
     };
 }>> & Readonly<{}>, {
     class: string | unknown[] | Record<string, any>;
+    href: string;
     id: string;
+    links: {
+        href: string;
+        label: string;
+    }[];
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS SkipLink 컴포넌트 속성
  */
 export declare interface KrdsSkipLinkProps extends BaseComponentProps {
-    /** 건너뛸 대상 요소의 ID */
-    href: string;
+    /** 건너뛸 대상 요소의 ID (단일 링크, 기본 슬롯이 링크 텍스트) */
+    href?: string;
+    /** 여러 건너뛰기 링크 (하나의 래퍼 안에 렌더링, 지정 시 href·기본 슬롯 대신 사용) */
+    links?: {
+        href: string;
+        label: string;
+    }[];
 }
 
 export declare const KrdsSpinner: DefineComponent<ExtractPropTypes<{
@@ -3889,7 +4235,7 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         required: true;
     };
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status: {
         type: () => "done" | "active" | "pending";
         default: undefined;
@@ -3902,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<{
     /** 단계 번호 */
@@ -3914,7 +4261,7 @@ export declare const KrdsStep: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         required: true;
     };
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status: {
         type: () => "done" | "active" | "pending";
         default: undefined;
@@ -3938,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;
@@ -3952,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;
@@ -3973,6 +4330,7 @@ export declare const KrdsStepIndicator: DefineComponent<ExtractPropTypes<{
 
 /**
  * KRDS StepIndicator 컴포넌트 이벤트
+ * @deprecated 단계 표시기는 진행 상태만 보여 주므로 update:modelValue를 보내지 않습니다. 다음 주요 버전에서 제거합니다.
  */
 export declare interface KrdsStepIndicatorEmits {
     (e: 'update:modelValue', value: number): void;
@@ -3982,7 +4340,7 @@ export declare interface KrdsStepIndicatorEmits {
  * KRDS StepIndicator 컴포넌트 속성
  */
 export declare interface KrdsStepIndicatorProps extends BaseComponentProps {
-    /** 현재 활성 단계 인덱스 (0부터 시작) - v-model */
+    /** 현재 단계 인덱스 (0부터 시작). 앞 단계는 완료, 뒤 단계는 대기로 표시 */
     modelValue?: number;
 }
 
@@ -3994,7 +4352,7 @@ export declare interface KrdsStepProps extends BaseComponentProps {
     step: string | number;
     /** 단계 제목 */
     title: string;
-    /** 단계 상태 강제 설정 (선택적) */
+    /** 단계 상태 (지정하지 않으면 KrdsStepIndicator가 순서에 따라 정함) */
     status?: 'done' | 'active' | 'pending';
 }
 
@@ -4065,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<{
     /** 테이블 캡션 */
@@ -4149,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<{
     /** 탭 아이템 목록 */
@@ -4251,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<{
     /** 링크 태그 여부 */
@@ -4435,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<{
     /** 입력값 */
@@ -4539,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;
@@ -4680,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<{
     /** 모델 값 */
@@ -4740,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>;
 
 /**
@@ -4877,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<{
     /** 읽어줄 텍스트 */
@@ -4981,6 +5356,7 @@ export declare interface LayoutSize {
 
 /**
  * 로딩 상태 속성
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare interface LoadingProps {
     /** 로딩 중 여부 */
@@ -5124,19 +5500,23 @@ export declare interface NavigationItem {
 /**
  * 유틸리티 타입들
  */
+/** @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정 */
 export declare type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
 
 /**
  * 위치 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type Position = 'top' | 'bottom' | 'left' | 'right';
 
+/** @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정 */
 export declare type RequiredKeys<T> = {
     [K in keyof T]-?: object extends Pick<T, K> ? never : K;
 }[keyof T];
 
 /**
  * 반응형 값 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type ResponsiveValue<T> = T | {
     mobile?: T;