@krds.ui/vue 0.0.14 → 0.0.16

package/dist/types/index.d.ts

@@ -4,185 +4,13 @@ import { ComponentProvideOptions } from 'vue';
 import { DefineComponent } from 'vue';
 import { ExtractPropTypes } from 'vue';
 import { Plugin as Plugin_2 } from 'vue';
+import { PropType } from 'vue';
 import { PublicProps } from 'vue';
 import { RendererElement } from 'vue';
 import { RendererNode } from 'vue';
 import { SlotsType } from 'vue';
 import { VNode } from 'vue';
 
-declare const __VLS_component: DefineComponent<KrdsPanelProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
-"update:modelValue": (value: boolean) => any;
-}, string, PublicProps, Readonly<KrdsPanelProps> & Readonly<{
-"onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
-}>, {
-modelValue: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
-
-declare const __VLS_component_2: DefineComponent<KrdsContextualHelpProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsContextualHelpProps> & Readonly<{}>, {
-tooltipTitle: string;
-position: "top left" | "top center" | "top right" | "bottom left" | "bottom center" | "bottom right";
-}, {}, {}, {}, string, ComponentProvideOptions, false, {
-containerRef: HTMLDivElement;
-tooltipBtnRef: HTMLButtonElement;
-tooltipPopoverRef: HTMLDivElement;
-closeBtnRef: HTMLButtonElement;
-}, HTMLDivElement>;
-
-declare const __VLS_component_3: DefineComponent<KrdsCoachMarkProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-close: () => any;
-"update:modelValue": (value: number | null) => any;
-}, string, PublicProps, Readonly<KrdsCoachMarkProps> & Readonly<{
-onClose?: (() => any) | undefined;
-"onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
-}>, {
-modelValue: number | null;
-coachMarkClass: string | string[];
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
-
-declare const __VLS_component_4: DefineComponent<KrdsTooltipProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsTooltipProps> & Readonly<{}>, {
-disabled: boolean;
-type: TooltipType;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {
-containerRef: HTMLDivElement;
-popoverRef: HTMLDivElement;
-}, HTMLDivElement>;
-
-declare const __VLS_component_5: DefineComponent<KrdsLanguageSwitcherProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-close: () => any;
-"update:modelValue": (value: string) => any;
-}, string, PublicProps, Readonly<KrdsLanguageSwitcherProps> & Readonly<{
-onClose?: (() => any) | undefined;
-"onUpdate:modelValue"?: ((value: string) => any) | undefined;
-}>, {
-type: "default" | "external";
-modelValue: string;
-dropPosition: DropdownPosition;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {
-dropdownRef: HTMLDivElement;
-buttonRef: HTMLButtonElement;
-}, any>;
-
-declare const __VLS_component_6: DefineComponent<KrdsAccordionItemProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
-toggle: (id: string) => any;
-}, string, PublicProps, Readonly<KrdsAccordionItemProps> & Readonly<{
-onToggle?: ((id: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
-
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: {
-        default?(_: {}): any;
-    };
-    refs: {};
-    rootEl: HTMLDivElement;
-};
-
-declare function __VLS_template_2(): {
-    attrs: Partial<{}>;
-    slots: {
-        default?(_: {}): any;
-    };
-    refs: {
-        containerRef: HTMLDivElement;
-        tooltipBtnRef: HTMLButtonElement;
-        tooltipPopoverRef: HTMLDivElement;
-        closeBtnRef: HTMLButtonElement;
-    };
-    rootEl: HTMLDivElement;
-};
-
-declare function __VLS_template_3(): {
-    attrs: Partial<{}>;
-    slots: {
-        'coach-mark-content'?(_: {}): any;
-    };
-    refs: {};
-    rootEl: any;
-};
-
-declare function __VLS_template_4(): {
-    attrs: Partial<{}>;
-    slots: {
-        default?(_: {}): any;
-    };
-    refs: {
-        containerRef: HTMLDivElement;
-        popoverRef: HTMLDivElement;
-    };
-    rootEl: HTMLDivElement;
-};
-
-declare function __VLS_template_5(): {
-    attrs: Partial<{}>;
-    slots: {
-        default?(_: {}): any;
-        'prev-item'?(_: {}): any;
-    };
-    refs: {
-        dropdownRef: HTMLDivElement;
-        buttonRef: HTMLButtonElement;
-    };
-    rootEl: any;
-};
-
-declare function __VLS_template_6(): {
-    attrs: Partial<{}>;
-    slots: {
-        title?(_: {}): any;
-        content?(_: {}): any;
-    };
-    refs: {};
-    rootEl: HTMLDivElement;
-};
-
-declare type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-
-declare type __VLS_TemplateResult_2 = ReturnType<typeof __VLS_template_2>;
-
-declare type __VLS_TemplateResult_3 = ReturnType<typeof __VLS_template_3>;
-
-declare type __VLS_TemplateResult_4 = ReturnType<typeof __VLS_template_4>;
-
-declare type __VLS_TemplateResult_5 = ReturnType<typeof __VLS_template_5>;
-
-declare type __VLS_TemplateResult_6 = ReturnType<typeof __VLS_template_6>;
-
-declare type __VLS_WithTemplateSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
-
-declare type __VLS_WithTemplateSlots_2<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
-
-declare type __VLS_WithTemplateSlots_3<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
-
-declare type __VLS_WithTemplateSlots_4<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
-
-declare type __VLS_WithTemplateSlots_5<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
-
-declare type __VLS_WithTemplateSlots_6<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
-
 /**
  * 알림 타입
  */
@@ -260,6 +88,8 @@ export declare interface ComponentSlots {
  */
 export declare type ComponentState = 'default' | 'hover' | 'active' | 'focus' | 'disabled';
 
+declare type ContextualHelpPosition = 'top left' | 'top center' | 'top right' | 'bottom left' | 'bottom center' | 'bottom right';
+
 /**
  * CSS 변수 타입
  */
@@ -270,7 +100,7 @@ export declare type CSSCustomProperties = Record<`--${string}`, string | number>
  */
 export declare type Direction = 'horizontal' | 'vertical';
 
-declare type DropdownPosition = 'left' | 'center' | 'right';
+export declare type DropdownPosition = 'left' | 'center' | 'right';
 
 /**
  * 파일 정보 인터페이스
@@ -344,16 +174,26 @@ export declare interface KrdsAccordionGroupProps extends BaseComponentProps {
     typeLine?: boolean;
 }
 
-export declare const KrdsAccordionItem: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
+export declare const KrdsAccordionItem: DefineComponent<KrdsAccordionItemProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsAccordionItemProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
+/**
+ * KRDS AccordionItem 컴포넌트 이벤트
+ */
 export declare interface KrdsAccordionItemEmits {
     (e: 'toggle', id: string): void;
 }
 
+/**
+ * KRDS AccordionItem 컴포넌트 속성
+ */
 export declare interface KrdsAccordionItemProps {
+    /** 아이템 고유 식별자 */
     id: string;
+    /** 현재 열려 있는 아이템의 id */
     openItem?: string;
+    /** 헤더 텍스트 (title 슬롯으로 대체 가능) */
     title?: string;
+    /** 본문 텍스트 (content 슬롯으로 대체 가능) */
     content?: string;
 }
 
@@ -377,21 +217,13 @@ export declare interface KrdsBadgeProps extends BaseComponentProps {
     size?: 'large' | 'medium' | 'small';
 }
 
-export declare const KrdsBreadcrumb: DefineComponent<KrdsBreadcrumbProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-"item-click": (item: BreadcrumbItem, event: MouseEvent) => any;
-}, string, PublicProps, Readonly<KrdsBreadcrumbProps> & Readonly<{
-"onItem-click"?: ((item: BreadcrumbItem, event: MouseEvent) => any) | undefined;
-}>, {
-id: string;
-ariaLabel: string;
-showHomeIcon: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLElement>;
+export declare const KrdsBreadcrumb: DefineComponent<KrdsBreadcrumbProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsBreadcrumbProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
  * KRDS Breadcrumb 컴포넌트 이벤트
  */
 export declare interface KrdsBreadcrumbEmits {
-    'item-click': [item: BreadcrumbItem, event: MouseEvent];
+    (e: 'item-click', item: BreadcrumbItem, event: MouseEvent): void;
 }
 
 /**
@@ -446,6 +278,254 @@ export declare interface KrdsButtonProps extends BaseComponentProps {
     disabled?: boolean;
 }
 
+export declare const KrdsCarousel: DefineComponent<ExtractPropTypes<{
+    variant: {
+        type: () => KrdsCarouselVariant;
+        default: string;
+    };
+    activeIndex: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    loop: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    autoplay: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    autoplayDelay: {
+        type: NumberConstructor;
+        default: number;
+    };
+    pauseOnHover: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    speed: {
+        type: NumberConstructor;
+        default: number;
+    };
+    spaceBetween: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    pagination: {
+        type: () => KrdsCarouselPaginationType;
+        default: undefined;
+    };
+    navigation: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    moreHref: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    ariaLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    prevLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    nextLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    playLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    stopLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    moreLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>, () => VNode< RendererNode, RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("change" | "play" | "stop" | "update:activeIndex" | "more-click")[], "change" | "play" | "stop" | "update:activeIndex" | "more-click", PublicProps, Readonly< ExtractPropTypes<{
+    variant: {
+        type: () => KrdsCarouselVariant;
+        default: string;
+    };
+    activeIndex: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    loop: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    autoplay: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    autoplayDelay: {
+        type: NumberConstructor;
+        default: number;
+    };
+    pauseOnHover: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    speed: {
+        type: NumberConstructor;
+        default: number;
+    };
+    spaceBetween: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    pagination: {
+        type: () => KrdsCarouselPaginationType;
+        default: undefined;
+    };
+    navigation: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    moreHref: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    ariaLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    prevLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    nextLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    playLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    stopLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    moreLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>> & Readonly<{
+    onChange?: ((...args: any[]) => any) | undefined;
+    onPlay?: ((...args: any[]) => any) | undefined;
+    onStop?: ((...args: any[]) => any) | undefined;
+    "onUpdate:activeIndex"?: ((...args: any[]) => any) | undefined;
+    "onMore-click"?: ((...args: any[]) => any) | undefined;
+}>, {
+    variant: KrdsCarouselVariant;
+    id: string;
+    ariaLabel: string;
+    navigation: boolean;
+    activeIndex: number;
+    loop: boolean;
+    autoplay: boolean;
+    autoplayDelay: number;
+    pauseOnHover: boolean;
+    speed: number;
+    spaceBetween: number;
+    pagination: KrdsCarouselPaginationType;
+    moreHref: string;
+    prevLabel: string;
+    nextLabel: string;
+    playLabel: string;
+    stopLabel: string;
+    moreLabel: string;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/**
+ * KRDS Carousel 컴포넌트 이벤트
+ */
+export declare interface KrdsCarouselEmits {
+    /** 현재 슬라이드 인덱스 업데이트 (v-model:activeIndex) */
+    (e: 'update:activeIndex', value: number): void;
+    /** 슬라이드 변경 완료 */
+    (e: 'change', value: number): void;
+    /** 자동 재생 시작 */
+    (e: 'play'): void;
+    /** 자동 재생 정지 */
+    (e: 'stop'): void;
+    /** 더 보기 클릭 */
+    (e: 'more-click', event: MouseEvent): void;
+}
+
+/**
+ * 페이지네이션 표시 방식
+ * - `bullets`: 불릿(점) 목록, 클릭으로 이동 가능
+ * - `fraction`: `현재 / 전체` 분수 표기
+ * - `none`: 표시하지 않음
+ */
+export declare type KrdsCarouselPaginationType = 'bullets' | 'fraction' | 'none';
+
+/**
+ * KRDS Carousel 컴포넌트 속성
+ */
+export declare interface KrdsCarouselProps {
+    /** 캐러셀 형태 (기본값: visual) */
+    variant?: KrdsCarouselVariant;
+    /** 현재 슬라이드 인덱스 (v-model:activeIndex) */
+    activeIndex?: number;
+    /** 처음/마지막 슬라이드에서 순환 이동 여부 (기본값: true) */
+    loop?: boolean;
+    /** 자동 재생 여부. true면 재생/정지 버튼을 노출하고 즉시 재생을 시작한다 (기본값: false) */
+    autoplay?: boolean;
+    /** 자동 재생 간격 (ms, 기본값: 2500) */
+    autoplayDelay?: number;
+    /** 마우스 오버 시 자동 재생 일시 정지 여부 (기본값: true). 포커스 진입 시에는 값과 무관하게 항상 정지한다 */
+    pauseOnHover?: boolean;
+    /** 슬라이드 전환 속도 (ms, 기본값: 400) */
+    speed?: number;
+    /** 슬라이드 사이 간격 (px, 기본값: visual 0 / banner 16) */
+    spaceBetween?: number;
+    /** 페이지네이션 표시 방식 (기본값: visual bullets / banner fraction) */
+    pagination?: KrdsCarouselPaginationType;
+    /** 이전/다음 버튼 표시 여부 (기본값: true) */
+    navigation?: boolean;
+    /** 더 보기 링크 URL. 지정하면 더 보기 버튼을 표시한다 */
+    moreHref?: string;
+    /** 캐러셀 영역 접근성 라벨 */
+    ariaLabel?: string;
+    /** 이전 버튼 라벨 */
+    prevLabel?: string;
+    /** 다음 버튼 라벨 */
+    nextLabel?: string;
+    /** 재생 버튼 라벨 */
+    playLabel?: string;
+    /** 정지 버튼 라벨 */
+    stopLabel?: string;
+    /** 더 보기 버튼 라벨 */
+    moreLabel?: string;
+    /** 엘리먼트 ID */
+    id?: string;
+}
+
+/**
+ * 캐러셀 형태
+ * - `visual`: 비주얼 배너형 (원본 carousel.html, 이전/다음 버튼이 슬라이드 좌우에 겹쳐 배치)
+ * - `banner`: 배너형 (원본 carousel_banner.html, 인디케이터 안에 페이지네이션·재생 제어·내비게이션 배치)
+ */
+export declare type KrdsCarouselVariant = 'visual' | 'banner';
+
 export declare const KrdsCheckArea: DefineComponent<KrdsCheckAreaProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsCheckAreaProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
@@ -480,12 +560,27 @@ export declare interface KrdsCheckboxProps extends BaseFormProps {
     chip?: boolean;
 }
 
-export declare const KrdsCoachMark: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
+export declare const KrdsCoachMark: DefineComponent<KrdsCoachMarkProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsCoachMarkProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS CoachMark 컴포넌트 이벤트
+ */
+export declare interface KrdsCoachMarkEmits {
+    (e: 'update:modelValue', value: number | null): void;
+    (e: 'close'): void;
+}
 
+/**
+ * KRDS CoachMark 컴포넌트 속성
+ */
 export declare interface KrdsCoachMarkProps extends BaseComponentProps {
+    /** 코치마크 래퍼에 추가할 클래스 */
     coachMarkClass?: string | string[];
+    /** 전체 단계 데이터 */
     stepsData: StepsData[];
+    /** 이 코치마크가 담당하는 단계 번호 */
     activeStep: number;
+    /** 현재 노출 중인 단계 (v-model) */
     modelValue?: number | null;
 }
 
@@ -499,12 +594,18 @@ export declare type KrdsComponent<Props = object, Slots = object, Emits = object
     __krdsEmits: Emits;
 };
 
-export declare const KrdsContextualHelp: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
+export declare const KrdsContextualHelp: DefineComponent<KrdsContextualHelpProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsContextualHelpProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
+/**
+ * KRDS ContextualHelp 컴포넌트 속성
+ */
 export declare interface KrdsContextualHelpProps {
+    /** 툴팁 제목 */
     tooltipTitle?: string;
+    /** 도움말 아이콘 사용 여부 (false 면 툴팁 아이콘) */
     helpIcon?: boolean;
-    position?: 'top left' | 'top center' | 'top right' | 'bottom left' | 'bottom center' | 'bottom right';
+    /** 툴팁 노출 위치 */
+    position?: ContextualHelpPosition;
 }
 
 export declare const KrdsCriticalAlerts: DefineComponent<KrdsCriticalAlertsProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsCriticalAlertsProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
@@ -530,47 +631,17 @@ export declare interface KrdsCriticalAlertsProps extends BaseComponentProps {
     linkText?: string;
 }
 
-export declare const KrdsDateInput: DefineComponent<KrdsDateInputProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-focus: (event: FocusEvent) => any;
-input: (event: Event) => any;
-blur: (event: FocusEvent) => any;
-change: (event: Event) => any;
-"update:modelValue": (value: string) => any;
-}, string, PublicProps, Readonly<KrdsDateInputProps> & Readonly<{
-onFocus?: ((event: FocusEvent) => any) | undefined;
-onInput?: ((event: Event) => any) | undefined;
-onBlur?: ((event: FocusEvent) => any) | undefined;
-onChange?: ((event: Event) => any) | undefined;
-"onUpdate:modelValue"?: ((value: string) => any) | undefined;
-}>, {
-name: string;
-required: boolean;
-readonly: boolean;
-disabled: boolean;
-size: Size;
-class: string;
-id: string;
-modelValue: string;
-placeholder: string;
-autofocus: boolean;
-eventDates: string[];
-holidays: string[];
-initialYear: number;
-initialMonth: number;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {
-datePickerButtonRef: HTMLButtonElement;
-datePickerAreaRef: HTMLDivElement;
-}, HTMLDivElement>;
+export declare const KrdsDateInput: DefineComponent<KrdsDateInputProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsDateInputProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
  * KRDS DateInput 컴포넌트 이벤트
  */
 export declare interface KrdsDateInputEmits {
-    'update:modelValue': [value: string];
-    input: [event: Event];
-    change: [event: Event];
-    focus: [event: FocusEvent];
-    blur: [event: FocusEvent];
+    (e: 'update:modelValue', value: string): void;
+    (e: 'input', event: Event): void;
+    (e: 'change', event: Event): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
 }
 
 /**
@@ -618,212 +689,212 @@ export declare interface KrdsDisclosureProps extends BaseComponentProps {
     modelValue?: boolean;
 }
 
-export declare const KrdsFileUpload: DefineComponent<ExtractPropTypes<    {
-modelValue: {
-type: () => FileInfo[];
-default: () => never[];
-};
-size: {
-type: () => Size;
-default: string;
-};
-accept: {
-type: StringConstructor;
-default: undefined;
-};
-maxFiles: {
-type: NumberConstructor;
-default: number;
-};
-maxFileSize: {
-type: NumberConstructor;
-default: number;
-};
-multiple: {
-type: BooleanConstructor;
-default: boolean;
-};
-disabled: {
-type: BooleanConstructor;
-default: boolean;
-};
-dragAndDrop: {
-type: BooleanConstructor;
-default: boolean;
-};
-title: {
-type: StringConstructor;
-default: string;
-};
-description: {
-type: StringConstructor;
-default: string;
-};
-placeholder: {
-type: StringConstructor;
-default: string;
-};
-showPreview: {
-type: BooleanConstructor;
-default: boolean;
-};
-showDownload: {
-type: BooleanConstructor;
-default: boolean;
-};
-showPreviewButton: {
-type: BooleanConstructor;
-default: boolean;
-};
-showClearAll: {
-type: BooleanConstructor;
-default: boolean;
-};
-name: {
-type: StringConstructor;
-default: undefined;
-};
-required: {
-type: BooleanConstructor;
-default: boolean;
-};
-readonly: {
-type: BooleanConstructor;
-default: boolean;
-};
-class: {
-type: StringConstructor;
-default: undefined;
-};
-style: {
-type: (StringConstructor | ObjectConstructor)[];
-default: undefined;
-};
-id: {
-type: StringConstructor;
-default: undefined;
-};
-}>, () => VNode<RendererNode, RendererElement, {
-[key: string]: any;
-}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("update:modelValue" | "file-added" | "file-removed" | "file-error" | "upload-start" | "upload-progress" | "upload-complete" | "upload-error" | "clear-all" | "download" | "preview")[], "update:modelValue" | "file-added" | "file-removed" | "file-error" | "upload-start" | "upload-progress" | "upload-complete" | "upload-error" | "clear-all" | "download" | "preview", PublicProps, Readonly<ExtractPropTypes<    {
-modelValue: {
-type: () => FileInfo[];
-default: () => never[];
-};
-size: {
-type: () => Size;
-default: string;
-};
-accept: {
-type: StringConstructor;
-default: undefined;
-};
-maxFiles: {
-type: NumberConstructor;
-default: number;
-};
-maxFileSize: {
-type: NumberConstructor;
-default: number;
-};
-multiple: {
-type: BooleanConstructor;
-default: boolean;
-};
-disabled: {
-type: BooleanConstructor;
-default: boolean;
-};
-dragAndDrop: {
-type: BooleanConstructor;
-default: boolean;
-};
-title: {
-type: StringConstructor;
-default: string;
-};
-description: {
-type: StringConstructor;
-default: string;
-};
-placeholder: {
-type: StringConstructor;
-default: string;
-};
-showPreview: {
-type: BooleanConstructor;
-default: boolean;
-};
-showDownload: {
-type: BooleanConstructor;
-default: boolean;
-};
-showPreviewButton: {
-type: BooleanConstructor;
-default: boolean;
-};
-showClearAll: {
-type: BooleanConstructor;
-default: boolean;
-};
-name: {
-type: StringConstructor;
-default: undefined;
-};
-required: {
-type: BooleanConstructor;
-default: boolean;
-};
-readonly: {
-type: BooleanConstructor;
-default: boolean;
-};
-class: {
-type: StringConstructor;
-default: undefined;
-};
-style: {
-type: (StringConstructor | ObjectConstructor)[];
-default: undefined;
-};
-id: {
-type: StringConstructor;
-default: undefined;
-};
+export declare const KrdsFileUpload: DefineComponent<ExtractPropTypes<{
+    modelValue: {
+        type: () => FileInfo[];
+        default: () => never[];
+    };
+    size: {
+        type: () => Size;
+        default: string;
+    };
+    accept: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    maxFiles: {
+        type: NumberConstructor;
+        default: number;
+    };
+    maxFileSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    multiple: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    dragAndDrop: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    description: {
+        type: StringConstructor;
+        default: string;
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    showPreview: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showDownload: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showPreviewButton: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showClearAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    name: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    required: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: (StringConstructor | ObjectConstructor)[];
+        default: undefined;
+    };
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>, () => VNode< RendererNode, RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("update:modelValue" | "file-added" | "file-removed" | "file-error" | "upload-start" | "upload-progress" | "upload-complete" | "upload-error" | "clear-all" | "download" | "preview")[], "update:modelValue" | "file-added" | "file-removed" | "file-error" | "upload-start" | "upload-progress" | "upload-complete" | "upload-error" | "clear-all" | "download" | "preview", PublicProps, Readonly< ExtractPropTypes<{
+    modelValue: {
+        type: () => FileInfo[];
+        default: () => never[];
+    };
+    size: {
+        type: () => Size;
+        default: string;
+    };
+    accept: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    maxFiles: {
+        type: NumberConstructor;
+        default: number;
+    };
+    maxFileSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    multiple: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    dragAndDrop: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    description: {
+        type: StringConstructor;
+        default: string;
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    showPreview: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showDownload: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showPreviewButton: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showClearAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    name: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    required: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: (StringConstructor | ObjectConstructor)[];
+        default: undefined;
+    };
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>> & Readonly<{
-"onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
-"onFile-added"?: ((...args: any[]) => any) | undefined;
-"onFile-removed"?: ((...args: any[]) => any) | undefined;
-"onFile-error"?: ((...args: any[]) => any) | undefined;
-"onUpload-start"?: ((...args: any[]) => any) | undefined;
-"onUpload-progress"?: ((...args: any[]) => any) | undefined;
-"onUpload-complete"?: ((...args: any[]) => any) | undefined;
-"onUpload-error"?: ((...args: any[]) => any) | undefined;
-"onClear-all"?: ((...args: any[]) => any) | undefined;
-onDownload?: ((...args: any[]) => any) | undefined;
-onPreview?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onFile-added"?: ((...args: any[]) => any) | undefined;
+    "onFile-removed"?: ((...args: any[]) => any) | undefined;
+    "onFile-error"?: ((...args: any[]) => any) | undefined;
+    "onUpload-start"?: ((...args: any[]) => any) | undefined;
+    "onUpload-progress"?: ((...args: any[]) => any) | undefined;
+    "onUpload-complete"?: ((...args: any[]) => any) | undefined;
+    "onUpload-error"?: ((...args: any[]) => any) | undefined;
+    "onClear-all"?: ((...args: any[]) => any) | undefined;
+    onDownload?: ((...args: any[]) => any) | undefined;
+    onPreview?: ((...args: any[]) => any) | undefined;
 }>, {
-name: string;
-required: boolean;
-readonly: boolean;
-disabled: boolean;
-size: Size;
-class: string;
-style: string | Record<string, any>;
-id: string;
-title: string;
-modelValue: FileInfo[];
-placeholder: string;
-accept: string;
-maxFiles: number;
-maxFileSize: number;
-multiple: boolean;
-dragAndDrop: boolean;
-description: string;
-showPreview: boolean;
-showDownload: boolean;
-showPreviewButton: boolean;
-showClearAll: boolean;
+    name: string;
+    required: boolean;
+    readonly: boolean;
+    disabled: boolean;
+    size: Size;
+    class: string;
+    style: string | Record<string, any>;
+    id: string;
+    title: string;
+    modelValue: FileInfo[];
+    placeholder: string;
+    accept: string;
+    multiple: boolean;
+    maxFiles: number;
+    maxFileSize: number;
+    dragAndDrop: boolean;
+    description: string;
+    showPreview: boolean;
+    showDownload: boolean;
+    showPreviewButton: boolean;
+    showClearAll: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -930,47 +1001,38 @@ export declare interface KrdsFormLabelProps extends BaseComponentProps {
     for?: string;
 }
 
-export declare const KrdsHeader: DefineComponent<ExtractPropTypes<    {
-id: {
-type: StringConstructor;
-default: string;
-};
-mobileNavId: {
-type: StringConstructor;
-default: string;
-};
-class: {
-type: StringConstructor;
-default: undefined;
-};
-}>, () => VNode<RendererNode, RendererElement, {
-[key: string]: any;
-}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
-id: {
-type: StringConstructor;
-default: string;
-};
-mobileNavId: {
-type: StringConstructor;
-default: string;
-};
-class: {
-type: StringConstructor;
-default: undefined;
-};
+export declare const KrdsHeader: DefineComponent<ExtractPropTypes<{
+    id: {
+        type: StringConstructor;
+        default: string;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>, () => VNode< RendererNode, RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
+    id: {
+        type: StringConstructor;
+        default: string;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>> & Readonly<{}>, {
-class: string;
-id: string;
-mobileNavId: string;
+    class: string;
+    id: string;
 }, SlotsType<{
-/** 유틸리티 메뉴 슬롯 */
-utility?(): VNode[];
-/** 브랜딩 영역 슬롯 (로고, 액션 버튼) */
-branding?(): VNode[];
-/** 데스크탑 네비게이션 메뉴 슬롯 */
-navigation?(): VNode[];
-/** 모바일 네비게이션 메뉴 슬롯 */
-mobileNavigation?(): VNode[];
+    /** 유틸리티 메뉴 슬롯 */
+    utility?(): VNode[];
+    /** 브랜딩 영역 슬롯 (로고, 액션 버튼) */
+    branding?(): VNode[];
+    /** 데스크탑 네비게이션 슬롯 — KrdsMainMenu 등 완성된 메뉴 요소를 그대로 전달 */
+    navigation?(): VNode[];
+    /** 모바일 네비게이션 슬롯 — KrdsMainMenu(variant="mobile") 등 완성된 드로어 요소를 그대로 전달 */
+    mobileNavigation?(): VNode[];
 }>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -979,8 +1041,6 @@ mobileNavigation?(): VNode[];
 export declare interface KrdsHeaderProps {
     /** 헤더 ID */
     id?: string;
-    /** 모바일 메뉴 ID */
-    mobileNavId?: string;
     /** 추가 CSS 클래스 */
     class?: string;
 }
@@ -1089,12 +1149,27 @@ export declare interface KrdsInputProps extends BaseFormProps {
     loading?: boolean;
 }
 
-export declare const KrdsLanguageSwitcher: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
+export declare const KrdsLanguageSwitcher: DefineComponent<KrdsLanguageSwitcherProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsLanguageSwitcherProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
+/**
+ * KRDS LanguageSwitcher 컴포넌트 이벤트
+ */
+export declare interface KrdsLanguageSwitcherEmits {
+    (e: 'update:modelValue', value: string): void;
+    (e: 'close'): void;
+}
+
+/**
+ * KRDS LanguageSwitcher 컴포넌트 속성
+ */
 export declare interface KrdsLanguageSwitcherProps extends BaseComponentProps {
+    /** 언어 목록 */
     languageList: LanguageData[];
+    /** 선택된 언어 코드 (v-model) */
     modelValue?: string;
+    /** 동작 타입 (default: 언어 선택, external: 외부 페이지 이동) */
     type?: 'default' | 'external';
+    /** 드롭다운 정렬 위치 */
     dropPosition?: DropdownPosition;
 }
 
@@ -1153,87 +1228,212 @@ export declare interface KrdsLinkProps extends BaseComponentProps {
  */
 export declare type KrdsLinkSize = 'small' | 'medium' | 'large';
 
+export declare const KrdsMainMenu: DefineComponent<ExtractPropTypes<{
+    items: {
+        type: PropType<MainMenuItem[]>;
+        default: () => never[];
+    };
+    variant: {
+        type: PropType<MainMenuVariant>;
+        default: string;
+    };
+    ariaLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    open: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    mobileId: {
+        type: StringConstructor;
+        default: string;
+    };
+    backdrop: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    closeLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => VNode< RendererNode, RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("item-click" | "update:open" | "menu-toggle")[], "item-click" | "update:open" | "menu-toggle", PublicProps, Readonly< ExtractPropTypes<{
+    items: {
+        type: PropType<MainMenuItem[]>;
+        default: () => never[];
+    };
+    variant: {
+        type: PropType<MainMenuVariant>;
+        default: string;
+    };
+    ariaLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    open: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    mobileId: {
+        type: StringConstructor;
+        default: string;
+    };
+    backdrop: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    closeLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    "onItem-click"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:open"?: ((...args: any[]) => any) | undefined;
+    "onMenu-toggle"?: ((...args: any[]) => any) | undefined;
+}>, {
+    variant: MainMenuVariant;
+    items: MainMenuItem[];
+    ariaLabel: string;
+    backdrop: boolean;
+    open: boolean;
+    mobileId: string;
+    closeLabel: string;
+}, SlotsType<{
+    /** PC 서브 패널 배너 영역 */
+    banner?(props: {
+        item: MainMenuItem;
+        subItem?: MainMenuSubItem;
+        index: number;
+        subIndex: number;
+    }): VNode[];
+    /** 모바일 드로어 헤더 영역 (유틸리티, 로그인, 검색 등) */
+    header?(): VNode[];
+    /** 모바일 드로어 하단 영역 */
+    bottom?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/**
+ * KRDS MainMenu 컴포넌트 이벤트
+ */
+export declare interface KrdsMainMenuEmits {
+    /** 모바일 드로어 열림 상태 변경 */
+    (event: 'update:open', value: boolean): void;
+    /** PC 메가 패널 열림/닫힘 */
+    (event: 'menu-toggle', index: number, expanded: boolean): void;
+    /** 메뉴 아이템 클릭 */
+    (event: 'item-click', item: MainMenuAnyItem, mouseEvent: MouseEvent): void;
+}
+
+/**
+ * KRDS MainMenu 컴포넌트 속성
+ */
+export declare interface KrdsMainMenuProps {
+    /** 메뉴 아이템 배열 */
+    items?: MainMenuItem[];
+    /** 렌더링 방식 */
+    variant?: MainMenuVariant;
+    /** 메뉴 영역 레이블 */
+    ariaLabel?: string;
+    /** 모바일 드로어 열림 상태 (v-model:open) */
+    open?: boolean;
+    /** 모바일 드로어 요소 id (외부 트리거의 `aria-controls` 대상) */
+    mobileId?: string;
+    /** PC 메가 패널 배경 딤(backdrop) 사용 여부 */
+    backdrop?: boolean;
+    /** 모바일 드로어 닫기 버튼 레이블 */
+    closeLabel?: string;
+}
+
 export declare const KrdsMasthead: DefineComponent<BaseComponentProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<BaseComponentProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
+/**
+ * KRDS Masthead 컴포넌트 이벤트
+ */
+export declare interface KrdsMastheadEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+
 /**
  * KRDS Masthead 컴포넌트 속성
  */
 export declare type KrdsMastheadProps = BaseComponentProps;
 
-export declare const KrdsModal: DefineComponent<ExtractPropTypes<    {
-modelValue: {
-type: BooleanConstructor;
-default: boolean;
-};
-modalId: {
-type: StringConstructor;
-default: undefined;
-};
-backdrop: {
-type: BooleanConstructor;
-default: boolean;
-};
-size: {
-type: () => KrdsModalSize;
-default: string;
-};
-full: {
-type: BooleanConstructor;
-default: boolean;
-};
-bottomSheet: {
-type: BooleanConstructor;
-default: boolean;
-};
-persistent: {
-type: BooleanConstructor;
-default: boolean;
-};
+export declare const KrdsModal: DefineComponent<ExtractPropTypes<{
+    modelValue: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    modalId: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    backdrop: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    size: {
+        type: () => KrdsModalSize;
+        default: string;
+    };
+    full: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    bottomSheet: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    persistent: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>, () => VNode<RendererNode, RendererElement, {
-[key: string]: any;
-}> | null, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, "update:modelValue"[], "update:modelValue", PublicProps, Readonly<ExtractPropTypes<    {
-modelValue: {
-type: BooleanConstructor;
-default: boolean;
-};
-modalId: {
-type: StringConstructor;
-default: undefined;
-};
-backdrop: {
-type: BooleanConstructor;
-default: boolean;
-};
-size: {
-type: () => KrdsModalSize;
-default: string;
-};
-full: {
-type: BooleanConstructor;
-default: boolean;
-};
-bottomSheet: {
-type: BooleanConstructor;
-default: boolean;
-};
-persistent: {
-type: BooleanConstructor;
-default: boolean;
-};
+    [key: string]: any;
+}> | null, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, "update:modelValue"[], "update:modelValue", PublicProps, Readonly< ExtractPropTypes<{
+    modelValue: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    modalId: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    backdrop: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    size: {
+        type: () => KrdsModalSize;
+        default: string;
+    };
+    full: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    bottomSheet: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    persistent: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>> & Readonly<{
-"onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-size: KrdsModalSize;
-modelValue: boolean;
-modalId: string;
-backdrop: boolean;
-full: boolean;
-bottomSheet: boolean;
-persistent: boolean;
+    size: KrdsModalSize;
+    modelValue: boolean;
+    modalId: string;
+    backdrop: boolean;
+    full: boolean;
+    bottomSheet: boolean;
+    persistent: boolean;
 }, SlotsType<{
-title?: () => any;
-default?: () => any;
-footer?: () => any;
+    title?: () => any;
+    default?: () => any;
+    footer?: () => any;
 }>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 export declare interface KrdsModalProps {
@@ -1248,24 +1448,14 @@ export declare interface KrdsModalProps {
 
 export declare type KrdsModalSize = 'small' | 'medium' | 'large';
 
-export declare const KrdsPagination: DefineComponent<KrdsPaginationProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-"update:modelValue": (value: number) => any;
-}, string, PublicProps, Readonly<KrdsPaginationProps> & Readonly<{
-"onUpdate:modelValue"?: ((value: number) => any) | undefined;
-}>, {
-id: string;
-modelValue: number;
-min: number;
-ariaLabel: string;
-pageRange: number;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+export declare const KrdsPagination: DefineComponent<KrdsPaginationProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsPaginationProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
  * KRDS Pagination 컴포넌트 이벤트
  */
 export declare interface KrdsPaginationEmits {
     /** v-model 업데이트 이벤트 */
-    'update:modelValue': [value: number];
+    (e: 'update:modelValue', value: number): void;
 }
 
 /**
@@ -1286,9 +1476,20 @@ export declare interface KrdsPaginationProps {
     pageRange?: number;
 }
 
-export declare const KrdsPanel: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export declare const KrdsPanel: DefineComponent<KrdsPanelProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsPanelProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
+/**
+ * KRDS Panel 컴포넌트 이벤트
+ */
+export declare interface KrdsPanelEmits {
+    (e: 'update:modelValue', value: boolean): void;
+}
+
+/**
+ * KRDS Panel 컴포넌트 속성
+ */
 export declare interface KrdsPanelProps {
+    /** 도움말 패널 펼침 상태 (v-model) */
     modelValue?: boolean;
 }
 
@@ -1317,20 +1518,19 @@ export declare interface KrdsRadioProps extends BaseFormProps {
     chip?: boolean;
 }
 
-export declare const KrdsResize: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-close: () => any;
-"update:modelValue": (value: string) => any;
-}, string, PublicProps, Readonly<{}> & Readonly<{
-onClose?: (() => any) | undefined;
-"onUpdate:modelValue"?: ((value: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {
-dropdownRef: HTMLDivElement;
-buttonRef: HTMLButtonElement;
-}, any>;
+export declare const KrdsResize: DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("close" | "update:modelValue")[], "close" | "update:modelValue", PublicProps, Readonly<{}> & Readonly<{
+    onClose?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
+/**
+ * KRDS Resize 컴포넌트 이벤트
+ */
 export declare interface KrdsResizeEmits {
-    'update:modelValue': [value: string];
-    close: [];
+    (e: 'update:modelValue', value: string): void;
+    (e: 'close'): void;
 }
 
 export declare const KrdsSelect: DefineComponent<KrdsSelectProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsSelectProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
@@ -1366,18 +1566,18 @@ export declare interface KrdsSelectProps extends BaseFormProps {
     sort?: boolean;
 }
 
-export declare const KrdsSideNavigation: DefineComponent<    {
-title: string;
-modelValue?: SideNavItem[] | undefined;
-}, () => VNode<RendererNode, RendererElement, {
-[key: string]: any;
+export declare const KrdsSideNavigation: DefineComponent<{
+    title: string;
+    modelValue?: SideNavItem[] | undefined;
+}, () => VNode< RendererNode, RendererElement, {
+    [key: string]: any;
 }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, "update:modelValue"[], "update:modelValue", PublicProps, Readonly<{
-title: string;
-modelValue?: SideNavItem[] | undefined;
+    title: string;
+    modelValue?: SideNavItem[] | undefined;
 }> & Readonly<{
-"onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-modelValue: SideNavItem[];
+    modelValue: SideNavItem[];
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -1411,57 +1611,57 @@ export declare interface KrdsSideNavigationProps {
  * <KrdsSkipLink href="#gnb">메인메뉴 바로가기</KrdsSkipLink>
  * ```
  */
-export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<    {
-/**
-* 건너뛸 대상 요소의 ID
-* @example '#main-content', '#breadcrumb'
-*/
-href: {
-type: StringConstructor;
-required: true;
-validator: (value: string) => boolean;
-};
-/**
-* 추가 CSS 클래스
-*/
-class: {
-type: (StringConstructor | ObjectConstructor | ArrayConstructor)[];
-default: undefined;
-};
-/**
-* 요소 ID
-*/
-id: {
-type: StringConstructor;
-default: string;
-};
-}>, () => VNode, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
-/**
-* 건너뛸 대상 요소의 ID
-* @example '#main-content', '#breadcrumb'
-*/
-href: {
-type: StringConstructor;
-required: true;
-validator: (value: string) => boolean;
-};
-/**
-* 추가 CSS 클래스
-*/
-class: {
-type: (StringConstructor | ObjectConstructor | ArrayConstructor)[];
-default: undefined;
-};
-/**
-* 요소 ID
-*/
-id: {
-type: StringConstructor;
-default: string;
-};
+export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
+    /**
+     * 건너뛸 대상 요소의 ID
+     * @example '#main-content', '#breadcrumb'
+     */
+    href: {
+        type: StringConstructor;
+        required: true;
+        validator: (value: string) => boolean;
+    };
+    /**
+     * 추가 CSS 클래스
+     */
+    class: {
+        type: (StringConstructor | ObjectConstructor | ArrayConstructor)[];
+        default: undefined;
+    };
+    /**
+     * 요소 ID
+     */
+    id: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => VNode, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
+    /**
+     * 건너뛸 대상 요소의 ID
+     * @example '#main-content', '#breadcrumb'
+     */
+    href: {
+        type: StringConstructor;
+        required: true;
+        validator: (value: string) => boolean;
+    };
+    /**
+     * 추가 CSS 클래스
+     */
+    class: {
+        type: (StringConstructor | ObjectConstructor | ArrayConstructor)[];
+        default: undefined;
+    };
+    /**
+     * 요소 ID
+     */
+    id: {
+        type: StringConstructor;
+        default: string;
+    };
 }>> & Readonly<{}>, {
-class: string | unknown[] | Record<string, any>;
-id: string;
+    class: string | unknown[] | Record<string, any>;
+    id: string;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -1472,18 +1672,18 @@ export declare interface KrdsSkipLinkProps extends BaseComponentProps {
     href: string;
 }
 
-export declare const KrdsSpinner: DefineComponent<ExtractPropTypes<    {
-label: {
-type: StringConstructor;
-default: undefined;
-};
-}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
-label: {
-type: StringConstructor;
-default: undefined;
-};
+export declare const KrdsSpinner: DefineComponent<ExtractPropTypes<{
+    label: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
+    label: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>> & Readonly<{}>, {
-label: string;
+    label: string;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 export declare const KrdsStep: DefineComponent<KrdsStepProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsStepProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
@@ -1593,172 +1793,172 @@ export declare interface KrdsTagProps extends BaseComponentProps {
     rel?: string;
 }
 
-export declare const KrdsTextarea: DefineComponent<ExtractPropTypes<    {
-modelValue: {
-type: StringConstructor;
-default: string;
-};
-size: {
-type: () => Size;
-default: undefined;
-};
-placeholder: {
-type: StringConstructor;
-default: undefined;
-};
-maxlength: {
-type: NumberConstructor;
-default: undefined;
-};
-minlength: {
-type: NumberConstructor;
-default: undefined;
-};
-rows: {
-type: NumberConstructor;
-default: number;
-};
-cols: {
-type: NumberConstructor;
-default: undefined;
-};
-autofocus: {
-type: BooleanConstructor;
-default: boolean;
-};
-name: {
-type: StringConstructor;
-default: undefined;
-};
-required: {
-type: BooleanConstructor;
-default: boolean;
-};
-readonly: {
-type: BooleanConstructor;
-default: boolean;
-};
-disabled: {
-type: BooleanConstructor;
-default: boolean;
-};
-showCount: {
-type: BooleanConstructor;
-default: boolean;
-};
-resize: {
-type: () => "none" | "both" | "horizontal" | "vertical";
-default: string;
-};
-class: {
-type: StringConstructor;
-default: undefined;
-};
-style: {
-type: (StringConstructor | ObjectConstructor)[];
-default: undefined;
-};
-id: {
-type: StringConstructor;
-default: undefined;
-};
+export declare const KrdsTextarea: DefineComponent<ExtractPropTypes<{
+    modelValue: {
+        type: StringConstructor;
+        default: string;
+    };
+    size: {
+        type: () => Size;
+        default: undefined;
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    maxlength: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    minlength: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    rows: {
+        type: NumberConstructor;
+        default: number;
+    };
+    cols: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    autofocus: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    name: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    required: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showCount: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    resize: {
+        type: () => "none" | "both" | "horizontal" | "vertical";
+        default: string;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: (StringConstructor | ObjectConstructor)[];
+        default: undefined;
+    };
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>, () => VNode<RendererNode, RendererElement, {
-[key: string]: any;
-}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("focus" | "input" | "blur" | "change" | "keydown" | "keyup" | "update:modelValue")[], "focus" | "input" | "blur" | "change" | "keydown" | "keyup" | "update:modelValue", PublicProps, Readonly<ExtractPropTypes<    {
-modelValue: {
-type: StringConstructor;
-default: string;
-};
-size: {
-type: () => Size;
-default: undefined;
-};
-placeholder: {
-type: StringConstructor;
-default: undefined;
-};
-maxlength: {
-type: NumberConstructor;
-default: undefined;
-};
-minlength: {
-type: NumberConstructor;
-default: undefined;
-};
-rows: {
-type: NumberConstructor;
-default: number;
-};
-cols: {
-type: NumberConstructor;
-default: undefined;
-};
-autofocus: {
-type: BooleanConstructor;
-default: boolean;
-};
-name: {
-type: StringConstructor;
-default: undefined;
-};
-required: {
-type: BooleanConstructor;
-default: boolean;
-};
-readonly: {
-type: BooleanConstructor;
-default: boolean;
-};
-disabled: {
-type: BooleanConstructor;
-default: boolean;
-};
-showCount: {
-type: BooleanConstructor;
-default: boolean;
-};
-resize: {
-type: () => "none" | "both" | "horizontal" | "vertical";
-default: string;
-};
-class: {
-type: StringConstructor;
-default: undefined;
-};
-style: {
-type: (StringConstructor | ObjectConstructor)[];
-default: undefined;
-};
-id: {
-type: StringConstructor;
-default: undefined;
-};
+    [key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("focus" | "input" | "blur" | "change" | "keydown" | "keyup" | "update:modelValue")[], "focus" | "input" | "blur" | "change" | "keydown" | "keyup" | "update:modelValue", PublicProps, Readonly< ExtractPropTypes<{
+    modelValue: {
+        type: StringConstructor;
+        default: string;
+    };
+    size: {
+        type: () => Size;
+        default: undefined;
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    maxlength: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    minlength: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    rows: {
+        type: NumberConstructor;
+        default: number;
+    };
+    cols: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    autofocus: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    name: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    required: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showCount: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    resize: {
+        type: () => "none" | "both" | "horizontal" | "vertical";
+        default: string;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: (StringConstructor | ObjectConstructor)[];
+        default: undefined;
+    };
+    id: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>> & Readonly<{
-onFocus?: ((...args: any[]) => any) | undefined;
-onInput?: ((...args: any[]) => any) | undefined;
-onBlur?: ((...args: any[]) => any) | undefined;
-onChange?: ((...args: any[]) => any) | undefined;
-onKeydown?: ((...args: any[]) => any) | undefined;
-onKeyup?: ((...args: any[]) => any) | undefined;
-"onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    onFocus?: ((...args: any[]) => any) | undefined;
+    onInput?: ((...args: any[]) => any) | undefined;
+    onBlur?: ((...args: any[]) => any) | undefined;
+    onChange?: ((...args: any[]) => any) | undefined;
+    onKeydown?: ((...args: any[]) => any) | undefined;
+    onKeyup?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-name: string;
-required: boolean;
-readonly: boolean;
-disabled: boolean;
-size: Size;
-class: string;
-style: string | Record<string, any>;
-id: string;
-resize: "horizontal" | "vertical" | "none" | "both";
-modelValue: string;
-placeholder: string;
-maxlength: number;
-minlength: number;
-autofocus: boolean;
-rows: number;
-cols: number;
-showCount: boolean;
+    name: string;
+    required: boolean;
+    readonly: boolean;
+    disabled: boolean;
+    size: Size;
+    class: string;
+    style: string | Record<string, any>;
+    id: string;
+    resize: "horizontal" | "vertical" | "none" | "both";
+    modelValue: string;
+    placeholder: string;
+    maxlength: number;
+    minlength: number;
+    autofocus: boolean;
+    rows: number;
+    cols: number;
+    showCount: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -1838,13 +2038,21 @@ export declare interface KrdsToggleSwitchProps extends BaseFormProps {
     size?: 'medium' | 'large';
 }
 
-export declare const KrdsTooltip: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
+export declare const KrdsTooltip: DefineComponent<KrdsTooltipProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsTooltipProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
+/**
+ * KRDS Tooltip 컴포넌트 속성
+ */
 export declare interface KrdsTooltipProps extends BaseComponentProps {
+    /** 트리거 버튼 타입 */
     type?: TooltipType;
+    /** 툴팁 본문 */
     tooltipContent: string;
+    /** 세로 방향 배치 여부 */
     vertical?: boolean;
+    /** 박스형 여부 */
     box?: boolean;
+    /** 비활성화 여부 */
     disabled?: boolean;
 }
 
@@ -1914,6 +2122,126 @@ export declare interface LoadingProps {
     loadingText?: string;
 }
 
+/** 클릭 이벤트로 전달되는 아이템 타입 */
+export declare type MainMenuAnyItem = MainMenuItem | MainMenuSubItem | MainMenuLinkItem | MainMenuDepth4Item;
+
+/**
+ * 모바일 4depth 아이템 인터페이스
+ */
+export declare interface MainMenuDepth4Item {
+    /** 텍스트 */
+    text: string;
+    /** 링크 URL */
+    href?: string;
+    /** 새 창 열림 여부 */
+    external?: boolean;
+    /** 현재 페이지 여부 (강조 표시) */
+    selected?: boolean;
+    /** 클릭 핸들러 */
+    onClick?: (event: MouseEvent) => void;
+}
+
+/**
+ * 1depth 메인 메뉴 아이템 인터페이스
+ *
+ * `subItems`가 있으면 2depth 목록을 가진 메가 패널을, `items`만 있으면
+ * 2depth 목록 없이 링크만 나열하는 `single-list` 패널을 렌더링한다.
+ * 둘 다 없으면 단순 링크(`is-link`)로 렌더링된다.
+ */
+export declare interface MainMenuItem {
+    /** 텍스트 */
+    text: string;
+    /** 링크 URL (하위 메뉴가 없을 때 단순 링크로 사용) */
+    href?: string;
+    /** 새 창 열림 여부 */
+    external?: boolean;
+    /** 2depth 아이템 목록 */
+    subItems?: MainMenuSubItem[];
+    /** 2depth 없이 바로 나열되는 링크 목록 (`single-list`) */
+    items?: MainMenuLinkItem[];
+    /** `single-list` 패널 제목 */
+    title?: string;
+    /** `single-list` 배너 영역 표시 여부 (`banner` 슬롯 필요) */
+    banner?: boolean;
+    /** `single-list` 패널 레이아웃 */
+    layout?: MainMenuLayout;
+    /** 현재 페이지 여부 (강조 표시) */
+    selected?: boolean;
+    /** 클릭 핸들러 */
+    onClick?: (event: MouseEvent) => void;
+}
+
+/**
+ * 서브 패널 레이아웃
+ * - `default`: 배너 영역이 하단에 위치
+ * - `between`: 배너 영역이 우측에 위치
+ */
+export declare type MainMenuLayout = 'default' | 'between';
+
+/**
+ * 링크 아이템 인터페이스
+ *
+ * PC에서는 서브 패널의 마지막 뎁스, 모바일에서는 3depth로 렌더링된다.
+ */
+export declare interface MainMenuLinkItem {
+    /** 텍스트 */
+    text: string;
+    /** 링크 URL (없으면 button으로 렌더링) */
+    href?: string;
+    /** 새 창 열림 여부 */
+    external?: boolean;
+    /** 메뉴 설명 (PC에서 `type-description` 스타일로 렌더링) */
+    description?: string;
+    /** 현재 페이지 여부 (강조 표시) */
+    selected?: boolean;
+    /** 4depth 패널 제목 (모바일 전용, 기본값은 `text`) */
+    panelTitle?: string;
+    /** 하위 아이템 (모바일 4depth 전용) */
+    items?: MainMenuDepth4Item[];
+    /** 클릭 핸들러 */
+    onClick?: (event: MouseEvent) => void;
+}
+
+/**
+ * 2depth 아이템 인터페이스
+ *
+ * `items`가 있으면 서브 패널을 여는 트리거로, 없으면 바로가기 링크로 렌더링된다.
+ */
+export declare interface MainMenuSubItem {
+    /** 텍스트 */
+    text: string;
+    /** 링크 URL (`items`가 없을 때 바로가기 링크로 사용) */
+    href?: string;
+    /** 새 창 열림 여부 */
+    external?: boolean;
+    /** 서브 패널 제목 (기본값은 `text`) */
+    title?: string;
+    /** 서브 패널 제목 옆 바로가기 링크 (PC 전용) */
+    titleLink?: {
+        text?: string;
+        href: string;
+    };
+    /** 하위 아이템 (PC 마지막 뎁스 / 모바일 3depth) */
+    items?: MainMenuLinkItem[];
+    /** 배너 영역 표시 여부 (`banner` 슬롯 필요, PC 전용) */
+    banner?: boolean;
+    /** 서브 패널 레이아웃 (PC 전용) */
+    layout?: MainMenuLayout;
+    /** 모바일 3depth 초기 확장 상태 */
+    expanded?: boolean;
+    /** 현재 페이지 여부 (강조 표시) */
+    selected?: boolean;
+    /** 클릭 핸들러 */
+    onClick?: (event: MouseEvent) => void;
+}
+
+/**
+ * 메인 메뉴 렌더링 방식
+ * - `pc`: 데스크탑 메가 메뉴 (`.krds-main-menu`)
+ * - `mobile`: 모바일 드로어 메뉴 (`.krds-main-menu-mobile`)
+ */
+export declare type MainMenuVariant = 'pc' | 'mobile';
+
 /**
  * 네비게이션 아이템 인터페이스
  */
@@ -2077,3 +2405,17 @@ export declare type Variant = 'primary' | 'secondary' | 'tertiary';
 export declare const version: string;
 
 export { }
+
+/**
+ * KRDS Vue 디렉티브 타입 정의
+ */
+
+declare module '@vue/runtime-core' {
+  interface ComponentCustomProperties {
+    /**
+     * 스크린 리더 전용 텍스트 디렉티브
+     * 요소에 .sr-only 클래스를 추가하여 시각적으로는 숨기지만 스크린 리더에서는 읽을 수 있도록 합니다.
+     */
+    vSrOnly: never
+  }
+}