@krds.ui/react 0.0.0-stage → 0.1.1

package/dist/types/index.d.ts

@@ -0,0 +1,2561 @@
+import { AnchorHTMLAttributes } from 'react';
+import { ButtonHTMLAttributes } from 'react';
+import { ComponentPropsWithoutRef } from 'react';
+import { ComponentPropsWithRef } from 'react';
+import { ComponentType } from 'react';
+import { default as default_2 } from 'react';
+import { ElementType } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { HTMLAttributes } from 'react';
+import { InputHTMLAttributes } from 'react';
+import { JSX as JSX_2 } from 'react';
+import { Key } from 'react';
+import { MutableRefObject } from 'react';
+import { PropsWithChildren } from 'react';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { SelectHTMLAttributes } from 'react';
+import { TextareaHTMLAttributes } from 'react';
+
+export declare const Accordion: ForwardRefExoticComponent<AccordionProps & RefAttributes<HTMLDivElement>> & {
+    Root: ForwardRefExoticComponent<AccordionProps & RefAttributes<HTMLDivElement>>;
+    Item: ForwardRefExoticComponent< AccordionItemProps & RefAttributes<HTMLDivElement>>;
+    Header: ForwardRefExoticComponent< AccordionHeaderProps & RefAttributes<HTMLHeadingElement>>;
+    Panel: ForwardRefExoticComponent< AccordionPanelProps & RefAttributes<HTMLDivElement>>;
+};
+
+export declare interface AccordionHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'onClick'> {
+    /** 헤더 제목 */
+    children: ReactNode;
+    /** 커스텀 클릭 핸들러 */
+    onClick?: () => void;
+}
+
+/**
+ * KRDS AccordionItem Component ( Pattern)
+ * @param value 아이템 값 (고유 식별자)
+ * @param children 자식 컴포넌트들 (Header와 Panel)
+ */
+export declare const AccordionItem: ForwardRefExoticComponent<AccordionItemProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface AccordionItemProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** 아이템 값 (고유 식별자) */
+    value: string;
+    /** 자식 컴포넌트들 (Header와 Panel) */
+    children: ReactNode;
+}
+
+export declare interface AccordionPanelProps extends HTMLAttributes<HTMLDivElement> {
+    /** 패널 내용 */
+    children: ReactNode;
+}
+
+export declare interface AccordionProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** 아코디언 스타일 변형 */
+    variant?: AccordionVariant;
+    /** 다중 선택 허용 여부 (false일 경우 한 번에 하나만 열림) */
+    allowMultiple?: boolean;
+    /** 열린 아이템 값 배열 (제어 상태) */
+    value?: string[];
+    /** 열린 아이템 변경 핸들러 */
+    onChange?: (values: string[]) => void;
+    /** 초기 열린 아이템 값 배열 (비제어 상태) */
+    defaultValue?: string[];
+    /** 자식 컴포넌트들 */
+    children: ReactNode;
+}
+
+declare type AccordionVariant = 'default' | 'line';
+
+/**
+ * KRDS Badge 컴포넌트
+ * @param variant 배지 종류 ('outline' | 'filled' | 'light')
+ * @param color 배지 색상 ('primary' | 'secondary' | 'gray' | 'point' | 'danger' | 'warning' | 'success' | 'information' | 'disabled')
+ * @param size 배지 크기 ('small' | 'medium' | 'large')
+ * @param rounded 배지 모양 원형 여부
+ * @param children 배지 내용
+ * @param className 추가 커스텀 클래스
+ */
+export declare const Badge: ForwardRefExoticComponent<BadgeProps & RefAttributes<HTMLSpanElement>>;
+
+export declare type BadgeColor = 'primary' | 'secondary' | 'gray' | 'point' | 'danger' | 'warning' | 'success' | 'information' | 'disabled';
+
+export declare interface BadgeProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'size'> {
+    variant?: BadgeVariant;
+    color?: BadgeColor;
+    size?: BadgeSize;
+    rounded?: boolean;
+    children: React.ReactNode;
+}
+
+export declare type BadgeSize = 'small' | 'medium' | 'large';
+
+export declare type BadgeVariant = 'outline' | 'filled' | 'light';
+
+/**
+ * KRDS Badge Wrapper 컴포넌트
+ * @param children 배지 컴포넌트들
+ * @param className 추가 커스텀 클래스
+ */
+export declare const BadgeWrapper: ForwardRefExoticComponent<BadgeWrapperProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface BadgeWrapperProps extends HTMLAttributes<HTMLDivElement> {
+    children: React.ReactNode;
+}
+
+declare interface BaseTagProps {
+    /** 태그 텍스트 */
+    children: ReactNode;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+/**
+ * KRDS Breadcrumb Component
+ * @param items 브레드크럼 아이템 목록 ('home' | 'link' | 'disabled')
+ * @param className 추가 클래스명
+ * @param ariaLabel 접근성 레이블
+ */
+export declare const Breadcrumb: default_2.ForwardRefExoticComponent<BreadcrumbProps & default_2.RefAttributes<HTMLElement>>;
+
+export declare interface BreadcrumbItem {
+    /** 링크 텍스트 */
+    text: string;
+    /** 링크 URL */
+    href: string;
+    /** 비활성화 여부 */
+    disabled?: boolean;
+}
+
+export declare interface BreadcrumbProps extends HTMLAttributes<HTMLElement> {
+    /** 브레드크럼 아이템 목록 */
+    items: BreadcrumbItem[];
+    /** 추가 클래스명 */
+    className?: string;
+    /** 접근성 레이블 */
+    ariaLabel?: string;
+}
+
+export declare const Button: PolymorphicButtonComponent;
+
+declare type ButtonOwnProps = {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    children?: ReactNode;
+    className?: string;
+    disabled?: boolean;
+    role?: string;
+};
+
+export declare type ButtonProps<T extends ElementType = 'button'> = ButtonOwnProps & {
+    as?: T;
+} & Omit<ComponentPropsWithRef<T>, keyof ButtonOwnProps>;
+
+export declare type ButtonSize = 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';
+
+export declare type ButtonVariant = 'primary' | 'secondary' | 'tertiary' | 'text' | 'link' | 'icon';
+
+/**
+ * KRDS Calendar Component
+ * @param mode 달력 모드 ('single' | 'range')
+ * @param position 달력 위치 ('top' | 'bottom')
+ * @param value 현재 선택된 날짜 (단일 선택)
+ * @param defaultValue 기본 선택된 날짜 (단일 선택)
+ * @param startDate 범위 선택 시작 날짜
+ * @param endDate 범위 선택 종료 날짜
+ * @param defaultStartDate 기본 범위 선택 시작 날짜
+ * @param defaultEndDate 기본 범위 선택 종료 날짜
+ * @param disabledDates 비활성화할 날짜 배열
+ * @param eventDates 이벤트가 있는 날짜 배열
+ * @param isOpen 달력 열림 상태
+ * @param defaultIsOpen 기본 달력 열림 상태
+ * @param label 입력 필드 레이블
+ * @param placeholder 입력 필드 placeholder
+ * @param disabled 비활성화 여부
+ * @param readOnly 읽기 전용 여부
+ */
+export declare const Calendar: ForwardRefExoticComponent<CalendarProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface CalendarButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     * 버튼 variant
+     */
+    variant?: 'icon' | 'move' | 'switch' | 'date' | 'action';
+    /**
+     * 활성 상태
+     */
+    isActive?: boolean;
+    /**
+     * 선택 상태
+     */
+    isSelected?: boolean;
+}
+
+export declare interface CalendarDate {
+    year: number;
+    month: number;
+    day: number;
+    isToday?: boolean;
+    isDisabled?: boolean;
+    isOld?: boolean;
+    isNew?: boolean;
+    isDayOff?: boolean;
+    hasEvent?: boolean;
+    isSelected?: boolean;
+    isStart?: boolean;
+    isEnd?: boolean;
+    isPeriod?: boolean;
+}
+
+export declare interface CalendarDropdownProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * 드롭다운 열림 상태
+     */
+    isOpen?: boolean;
+    /**
+     * 드롭다운 항목들
+     */
+    items?: CalendarYearMonth[];
+    /**
+     * 항목 선택 콜백
+     */
+    onItemSelect?: (item: CalendarYearMonth) => void;
+    /**
+     * 드롭다운 토글 콜백
+     */
+    onToggle?: () => void;
+}
+
+export declare interface CalendarInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'onChange'> {
+    /**
+     * 달력 모드
+     */
+    mode?: CalendarMode;
+    /**
+     * 입력값 변경 콜백
+     */
+    onChange?: (value: string) => void;
+}
+
+export declare type CalendarMode = 'single' | 'range';
+
+export declare type CalendarPosition = 'top' | 'bottom';
+
+export declare interface CalendarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /**
+     * 달력 모드 ('single' | 'range')
+     */
+    mode?: CalendarMode;
+    /**
+     * 달력 위치 ('top' | 'bottom')
+     */
+    position?: CalendarPosition;
+    /**
+     * 현재 선택된 날짜 (단일 선택 모드)
+     */
+    value?: string;
+    /**
+     * 기본 선택된 날짜 (단일 선택 모드)
+     */
+    defaultValue?: string;
+    /**
+     * 범위 선택 시작 날짜
+     */
+    startDate?: string;
+    /**
+     * 범위 선택 종료 날짜
+     */
+    endDate?: string;
+    /**
+     * 기본 범위 선택 시작 날짜
+     */
+    defaultStartDate?: string;
+    /**
+     * 기본 범위 선택 종료 날짜
+     */
+    defaultEndDate?: string;
+    /**
+     * 비활성화할 날짜 배열 (YYYY.MM.DD 형식)
+     */
+    disabledDates?: string[];
+    /**
+     * 이벤트가 있는 날짜 배열 (YYYY.MM.DD 형식)
+     */
+    eventDates?: string[];
+    /**
+     * 달력이 열려있는지 여부
+     */
+    isOpen?: boolean;
+    /**
+     * 기본 달력 열림 상태
+     */
+    defaultIsOpen?: boolean;
+    /**
+     * 달력 열림/닫힘 상태 변경 콜백
+     */
+    onOpenChange?: (isOpen: boolean) => void;
+    /**
+     * 날짜 선택 변경 콜백 (단일 선택)
+     */
+    onChange?: (value: string) => void;
+    /**
+     * 범위 선택 변경 콜백
+     */
+    onRangeChange?: (startDate: string, endDate: string) => void;
+    /**
+     * 년도 변경 콜백
+     */
+    onYearChange?: (year: number) => void;
+    /**
+     * 월 변경 콜백
+     */
+    onMonthChange?: (month: number) => void;
+    /**
+     * 오늘 버튼 클릭 콜백
+     */
+    onTodayClick?: () => void;
+    /**
+     * 확인 버튼 클릭 콜백
+     */
+    onConfirm?: () => void;
+    /**
+     * 취소 버튼 클릭 콜백
+     */
+    onCancel?: () => void;
+    /**
+     * 입력 필드 레이블
+     */
+    label?: string;
+    /**
+     * 입력 필드 ID
+     */
+    inputId?: string;
+    /**
+     * 입력 필드 placeholder (단일 선택)
+     */
+    placeholder?: string;
+    /**
+     * 시작 날짜 입력 필드 placeholder
+     */
+    startPlaceholder?: string;
+    /**
+     * 종료 날짜 입력 필드 placeholder
+     */
+    endPlaceholder?: string;
+    /**
+     * 시작 날짜 입력 필드 title
+     */
+    startTitle?: string;
+    /**
+     * 종료 날짜 입력 필드 title
+     */
+    endTitle?: string;
+    /**
+     * 달력 열기 버튼 aria-label
+     */
+    openButtonLabel?: string;
+    /**
+     * 이전 달 버튼 aria-label
+     */
+    prevButtonLabel?: string;
+    /**
+     * 다음 달 버튼 aria-label
+     */
+    nextButtonLabel?: string;
+    /**
+     * 년도 선택 버튼 aria-label
+     */
+    yearSelectLabel?: string;
+    /**
+     * 월 선택 버튼 aria-label
+     */
+    monthSelectLabel?: string;
+    /**
+     * 오늘 버튼 텍스트
+     */
+    todayButtonText?: string;
+    /**
+     * 취소 버튼 텍스트
+     */
+    cancelButtonText?: string;
+    /**
+     * 확인 버튼 텍스트
+     */
+    confirmButtonText?: string;
+    /**
+     * 비활성화 여부
+     */
+    disabled?: boolean;
+    /**
+     * 읽기 전용 여부
+     */
+    readOnly?: boolean;
+}
+
+export declare interface CalendarTableProps extends HTMLAttributes<HTMLTableElement> {
+    /**
+     * 달력 데이터
+     */
+    dates?: CalendarDate[];
+    /**
+     * 달력 모드
+     */
+    mode?: CalendarMode;
+    /**
+     * 현재 년도
+     */
+    currentYear?: number;
+    /**
+     * 현재 월
+     */
+    currentMonth?: number;
+    /**
+     * 날짜 클릭 콜백
+     */
+    onDateClick?: (date: CalendarDate) => void;
+}
+
+export declare interface CalendarYearMonth {
+    value: number;
+    label: string;
+    isActive?: boolean;
+    isDisabled?: boolean;
+}
+
+/**
+ * KRDS Checkbox Component
+ * @param size 체크박스 크기 ('medium' | 'large')
+ * @param checked 체크박스 선택 상태
+ * @param disabled 체크박스 비활성화 상태
+ * @param label 체크박스 레이블 텍스트
+ * @param description 추가 설명 텍스트
+ * @param className 사용자 정의 클래스명
+ */
+export declare const Checkbox: default_2.ForwardRefExoticComponent<CheckboxProps & default_2.RefAttributes<HTMLInputElement>>;
+
+/**
+ * KRDS CheckboxChip Component
+ * @param size 체크박스 칩 크기 ('small' | 'medium' | 'large')
+ * @param checked 체크박스 선택 상태
+ * @param disabled 체크박스 비활성화 상태
+ * @param className 사용자 정의 클래스명
+ */
+export declare const CheckboxChip: default_2.ForwardRefExoticComponent<CheckboxChipProps & default_2.RefAttributes<HTMLInputElement>>;
+
+export declare interface CheckboxChipProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'defaultValue'> {
+    /** 체크박스 크기 */
+    size?: CheckboxChipSize;
+    /** 비제어 상태에서 사용할 초기 체크 상태 */
+    defaultValue?: boolean;
+}
+
+declare type CheckboxChipSize = 'small' | 'medium' | 'large';
+
+/**
+ * KRDS CheckboxGroup Component
+ * @param column 레이아웃 방향 (true: 세로, false: 가로)
+ * @param className 사용자 정의 클래스명
+ */
+export declare const CheckboxGroup: default_2.FC<CheckboxGroupProps>;
+
+export declare interface CheckboxGroupProps {
+    /** 그룹 내 체크박스들 */
+    children: React.ReactNode;
+    /** 세로 배치 여부 */
+    column?: boolean;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'defaultValue'> {
+    /** 체크박스 크기 */
+    size?: CheckboxSize;
+    /** 추가 설명 텍스트 */
+    description?: string;
+    /** 비제어 상태에서 사용할 초기 체크 상태 */
+    defaultValue?: boolean;
+    /** 레이블 텍스트 (children이 없을 경우 사용) */
+    label?: string;
+}
+
+declare type CheckboxSize = 'medium' | 'large';
+
+/**
+ * KRDS CoachMark Component
+ * @param title 코치 마크 제목
+ * @param description 코치 마크 설명
+ * @param currentStep 현재 단계
+ * @param totalSteps 총 단계 수
+ * @param onSkip 그만보기 버튼 클릭 핸들러
+ * @param onPrevious 이전으로 버튼 클릭 핸들러
+ * @param onNext 다음으로 버튼 클릭 핸들러
+ * @param children 코치 마크 내용
+ * @param isVisible 코치 마크 표시 여부
+ */
+export declare const CoachMark: ForwardRefExoticComponent<Omit<CoachMarkProps, "ref"> & RefAttributes<HTMLDivElement>>;
+
+export declare interface CoachMarkProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
+    /** 코치 마크 제목 */
+    title?: string;
+    /** 코치 마크 설명 */
+    description?: string;
+    /** 현재 단계 */
+    currentStep?: number;
+    /** 총 단계 수 */
+    totalSteps?: number;
+    /** 그만보기 버튼 클릭 핸들러 */
+    onSkip?: () => void;
+    /** 이전으로 버튼 클릭 핸들러 */
+    onPrevious?: () => void;
+    /** 다음으로 버튼 클릭 핸들러 */
+    onNext?: () => void;
+    /** 코치 마크 내용 */
+    children?: ReactNode;
+    /** 코치 마크 표시 여부 */
+    isVisible?: boolean;
+}
+
+/**
+ * KRDS ContextualHelp Component
+ * @param label 도움말 라벨 텍스트
+ * @param title 팝오버 제목
+ * @param children 팝오버 내용
+ * @param position 팝오버 위치 ('top' | 'bottom')
+ * @param alignment 팝오버 정렬 ('left' | 'center' | 'right')
+ * @param open 팝오버 열림/닫힘 상태
+ * @param defaultOpen 기본 팝오버 열림/닫힘 상태
+ * @param onOpenChange 팝오버 상태 변경 핸들러
+ * @param className 사용자 정의 클래스명
+ */
+export declare const ContextualHelp: ForwardRefExoticComponent<ContextualHelpProps & RefAttributes<HTMLDivElement>>;
+
+declare type ContextualHelpAlignment = 'left' | 'center' | 'right';
+
+declare type ContextualHelpPosition = 'top' | 'bottom';
+
+export declare interface ContextualHelpProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** 도움말 라벨 텍스트 */
+    label?: string;
+    /** 팝오버 제목 */
+    title: string;
+    /** 팝오버 내용 */
+    children: ReactNode;
+    /** 팝오버 위치 ('top' | 'bottom') */
+    position?: ContextualHelpPosition;
+    /** 팝오버 정렬 ('left' | 'center' | 'right') */
+    alignment?: ContextualHelpAlignment;
+    /** 팝오버 열림/닫힘 상태 (제어모드) */
+    open?: boolean;
+    /** 기본 팝오버 열림/닫힘 상태 (비제어모드) */
+    defaultOpen?: boolean;
+    /** 팝오버 상태 변경 핸들러 */
+    onOpenChange?: (open: boolean) => void;
+    /** 사용자 정의 클래스명 */
+    className?: string;
+}
+
+export declare const CriticalAlert: ForwardRefExoticComponent<CriticalAlertsProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface CriticalAlertItemProps {
+    /**
+     * alert의 종류
+     */
+    variant: CriticalAlertVariant;
+    /**
+     * alert의 내용
+     */
+    message: string;
+    /**
+     * 상세보기 링크 URL
+     */
+    href?: string;
+    /**
+     * 상세보기 링크 텍스트
+     */
+    linkText?: string;
+}
+
+/**
+ * KRDS Critical Alert Component
+ * @param alerts alert 목록
+ * @param className custom class name
+ */
+export declare const CriticalAlerts: ForwardRefExoticComponent<CriticalAlertsProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface CriticalAlertsProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * alert 목록
+     */
+    alerts: CriticalAlertItemProps[];
+}
+
+export declare type CriticalAlertVariant = 'danger' | 'ok' | 'info';
+
+/**
+ * KRDS DateInput Component
+ * @param value 제어 상태일 때 입력된 값
+ * @param defaultValue 비제어 상태일 때의 초기 값
+ * @param onChange 입력 값이 변경될 때 호출되는 콜백
+ * @param label 레이블
+ * @param hint 도움말 텍스트
+ * @param error 에러 메시지
+ * @param success 성공 메시지
+ * @param information 정보 메시지
+ * @param size 입력 필드 크기 ('small' | 'medium' | 'large')
+ * @param isCalendarOpen 달력 열림 상태
+ * @param calendarPosition 달력 위치 ('top' | 'bottom')
+ * @param disabledDates 비활성화할 날짜 배열
+ * @param eventDates 이벤트가 있는 날짜 배열
+ * @param disabled disabled 상태
+ * @param readOnly readOnly 상태
+ */
+export declare const DateInput: ForwardRefExoticComponent<DateInputProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface DateInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'defaultValue' | 'size' | 'type'> {
+    /** 입력 값이 변경될 때 호출되는 콜백 */
+    onChange?: (value: string) => void;
+    /** 레이블 */
+    label?: string;
+    /** 도움말 텍스트 */
+    hint?: string;
+    /** 에러 메시지 */
+    error?: string;
+    /** 성공 메시지 */
+    success?: string;
+    /** 정보 메시지 */
+    information?: string;
+    /** 입력 필드 크기 ('small' | 'medium' | 'large') */
+    size?: 'small' | 'medium' | 'large';
+    /** 제어 상태일 때 입력된 값 */
+    value?: string;
+    /** 비제어 상태일 때의 초기 값 */
+    defaultValue?: string;
+    /** 달력이 열려있는지 여부 */
+    isCalendarOpen?: boolean;
+    /** 기본 달력 열림 상태 */
+    defaultIsCalendarOpen?: boolean;
+    /** 달력 열림/닫힘 상태 변경 콜백 */
+    onCalendarOpenChange?: (isOpen: boolean) => void;
+    /** 달력 위치 ('top' | 'bottom') */
+    calendarPosition?: 'top' | 'bottom';
+    /** 비활성화할 날짜 배열 (YYYY.MM.DD 형식) */
+    disabledDates?: string[];
+    /** 이벤트가 있는 날짜 배열 (YYYY.MM.DD 형식) */
+    eventDates?: string[];
+    /** 년도 변경 콜백 */
+    onYearChange?: (year: number) => void;
+    /** 월 변경 콜백 */
+    onMonthChange?: (month: number) => void;
+    /** 오늘 버튼 클릭 콜백 */
+    onTodayClick?: () => void;
+    /** 확인 버튼 클릭 콜백 */
+    onConfirm?: () => void;
+    /** 취소 버튼 클릭 콜백 */
+    onCancel?: () => void;
+    /** 달력 열기 버튼 aria-label */
+    openButtonLabel?: string;
+    /** 이전 달 버튼 aria-label */
+    prevButtonLabel?: string;
+    /** 다음 달 버튼 aria-label */
+    nextButtonLabel?: string;
+    /** 년도 선택 버튼 aria-label */
+    yearSelectLabel?: string;
+    /** 월 선택 버튼 aria-label */
+    monthSelectLabel?: string;
+    /** 오늘 버튼 텍스트 */
+    todayButtonText?: string;
+    /** 취소 버튼 텍스트 */
+    cancelButtonText?: string;
+    /** 확인 버튼 텍스트 */
+    confirmButtonText?: string;
+}
+
+declare interface DeletableTagProps extends BaseTagProps, Omit<HTMLAttributes<HTMLSpanElement>, 'children'> {
+    /** 태그 타입 */
+    variant?: 'deletable';
+    /** 삭제 버튼 클릭 핸들러 */
+    onDelete?: () => void;
+    /** 삭제 버튼 비활성화 */
+    deleteDisabled?: boolean;
+}
+
+declare interface DesktopBanner {
+    badgeText?: string;
+    buttonText: string;
+    onButtonClick: () => void;
+    children?: ReactNode;
+}
+
+declare interface DesktopLeafItem {
+    id?: string;
+    label: string;
+    href?: string;
+    isExternal?: boolean;
+    asButton?: boolean;
+    description?: string;
+    onClick?: () => void;
+}
+
+declare interface DesktopMainDropdown {
+    type: 'dropdown';
+    id?: string;
+    label: string;
+    isDropdownTrigger?: boolean;
+    mainListClassName?: string;
+    sections: DesktopSubSection[];
+}
+
+declare type DesktopMainItem = DesktopMainDropdown | DesktopMainLink;
+
+declare interface DesktopMainLink {
+    type: 'link';
+    id?: string;
+    label: string;
+    href?: string;
+    isExternal?: boolean;
+    renderAsButton?: boolean;
+    onClick?: () => void;
+}
+
+declare interface DesktopMenuConfig {
+    items: DesktopMainItem[];
+}
+
+declare interface DesktopSubLink {
+    type: 'link';
+    id?: string;
+    label: string;
+    href: string;
+    isExternal?: boolean;
+    onClick?: () => void;
+}
+
+declare interface DesktopSubMenu {
+    type: 'menu';
+    id?: string;
+    label: string;
+    href?: string;
+    isExternal?: boolean;
+    quickLinkLabel?: string;
+    quickLinkHref?: string;
+    quickLinkExternal?: boolean;
+    layout?: 'default' | 'between' | 'single-list';
+    items: DesktopLeafItem[];
+    banner?: DesktopBanner;
+}
+
+declare type DesktopSubSection = DesktopSubMenu | DesktopSubLink;
+
+/**
+ * KRDS Disclosure Component
+ * @param buttonText 토글 버튼 텍스트
+ * @param children 확장 가능한 콘텐츠
+ * @param defaultExpanded 초기 확장 상태
+ * @param expanded 제어된 확장 상태
+ * @param onToggle 확장 상태 변경 콜백
+ * @param className 커스텀 클래스명
+ */
+export declare const Disclosure: ForwardRefExoticComponent<Omit<DisclosureProps, "ref"> & RefAttributes<HTMLDivElement>>;
+
+export declare type DisclosureProps = {
+    /** 토글 버튼 텍스트 */
+    buttonText: string;
+    /** 확장 가능한 콘텐츠 */
+    children: ReactNode;
+    /** 초기 확장 상태 */
+    defaultExpanded?: boolean;
+    /** 제어된 확장 상태 */
+    expanded?: boolean;
+    /** 확장 상태 변경 시 호출되는 콜백 */
+    onToggle?: (expanded: boolean) => void;
+    /** 커스텀 클래스명 */
+    className?: string;
+} & Omit<ComponentPropsWithRef<'div'>, 'children' | 'className' | 'onToggle'>;
+
+declare interface DropdownItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     * 아이템 활성 상태
+     */
+    isActive?: boolean;
+}
+
+declare interface DropdownProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick' | 'onChange' | 'content'> {
+    /**
+     * 드롭다운 열림 상태 (controlled)
+     */
+    isOpen?: boolean;
+    /**
+     * 기본 드롭다운 열림 상태 (uncontrolled)
+     */
+    defaultOpen?: boolean;
+    /**
+     * 드롭다운 상태 변경 시 호출되는 콜백 함수
+     */
+    onOpenChange?: (isOpen: boolean) => void;
+    /**
+     * 드롭다운 버튼 텍스트 또는 콘텐츠
+     */
+    buttonText: ReactNode;
+    /**
+     * 드롭다운 버튼 클래스명
+     */
+    buttonClassName?: string;
+    /**
+     * 드롭다운 메뉴 콘텐츠 (리스트 아이템)
+     */
+    children?: ReactNode;
+    /**
+     * 커스텀 드롭다운 콘텐츠
+     */
+    content?: ReactNode;
+    /**
+     * 사용자 정의 클래스명
+     */
+    className?: string;
+}
+
+export declare interface FileItem {
+    id: string;
+    name: string;
+    size: number;
+    type: string;
+    status: 'ready' | 'uploading' | 'completed' | 'error';
+    errorMessage?: string;
+    onDownload?: () => void;
+    onPreview?: () => void;
+    deletable?: boolean;
+}
+
+/**
+ * KRDS FileUpload Component
+ * @param title 타이틀 영역 제목
+ * @param description 컨텐츠 영역 설명
+ * @param uploadText 업로드 영역 안내 텍스트
+ * @param maxFiles 최대 파일 개수
+ * @param maxFileSize 최대 파일 크기 (bytes)
+ * @param acceptedFileTypes 허용된 파일 확장자 배열
+ * @param files 파일 목록
+ * @param onFilesChange 파일 목록 변경 핸들러
+ * @param onFileUpload 파일 업로드 핸들러
+ * @param onFileDelete 파일 삭제 핸들러
+ * @param onAllFilesDelete 전체 파일 삭제 핸들러
+ * @param disabled 비활성화 상태
+ * @param allowDelete 파일 삭제 허용 여부
+ * @param className 커스텀 클래스명
+ */
+export declare const FileUpload: default_2.ForwardRefExoticComponent<Omit<FileUploadProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface FileUploadProps extends Omit<ComponentPropsWithRef<'div'>, 'onChange'> {
+    title?: string;
+    description?: string;
+    uploadText?: string;
+    maxFiles?: number;
+    maxFileSize?: number;
+    acceptedFileTypes?: string[];
+    files?: FileItem[];
+    onFilesChange?: (files: FileItem[]) => void;
+    onFileUpload?: (file: File) => Promise<void>;
+    onFileDelete?: (fileId: string) => void;
+    onAllFilesDelete?: () => void;
+    disabled?: boolean;
+    allowDelete?: boolean;
+    className?: string;
+    children?: ReactNode;
+}
+
+export declare type FileUploadSize = 'small' | 'medium' | 'large';
+
+/**
+ * KRDS Footer Component
+ * @param quickLinks 퀵 링크 목록
+ * @param address 주소
+ * @param contacts 연락처 목록
+ * @param logo 메인 로고 설정
+ * @param links 링크 목록
+ * @param socialLinks 소셜 미디어 링크 목록
+ * @param bottomLinks 하단 링크 목록
+ * @param copyright 저작권 텍스트
+ * @param identifierText 식별자 텍스트 (하위 호환성)
+ * @param identifier 식별자 설정 (identifierText보다 우선)
+ * @param defaultLinkTarget 모든 링크의 기본 타겟 설정
+ * @param hideQuickLinks 퀵 링크 섹션 숨김 여부
+ * @param hideIdentifier 식별자 섹션 숨김 여부
+ */
+export declare const Footer: ForwardRefExoticComponent<Omit<FooterProps, "ref"> & RefAttributes<HTMLElement>>;
+
+export declare interface FooterBottomLink extends FooterLinkBase {
+    text: string;
+    isHighlighted?: boolean;
+}
+
+declare interface FooterContact {
+    title: string;
+    description: string;
+}
+
+declare interface FooterIdentifier {
+    logo?: FooterLogo;
+    text: string;
+}
+
+export declare interface FooterLink extends FooterLinkBase {
+    text: string;
+}
+
+declare interface FooterLinkBase {
+    href: string;
+    target?: '_blank' | '_self' | '_parent' | '_top';
+    rel?: string;
+}
+
+declare interface FooterLogo {
+    src?: string;
+    alt: string;
+    width?: number | string;
+    height?: number | string;
+    href?: string;
+    target?: '_blank' | '_self' | '_parent' | '_top';
+}
+
+export declare interface FooterProps extends Omit<ComponentPropsWithRef<'footer'>, 'children'> {
+    quickLinks?: FooterQuickLink[];
+    address?: string;
+    contacts?: FooterContact[];
+    links?: FooterLink[];
+    socialLinks?: FooterSocialLink[];
+    bottomLinks?: FooterBottomLink[];
+    logo?: FooterLogo;
+    copyright?: string;
+    identifierText?: string;
+    identifier?: FooterIdentifier;
+    defaultLinkTarget?: '_blank' | '_self';
+    hideQuickLinks?: boolean;
+    hideIdentifier?: boolean;
+}
+
+export declare interface FooterQuickLink {
+    title: string;
+    onClick?: () => void;
+}
+
+export declare interface FooterSocialLink extends FooterLinkBase {
+    platform: string;
+    icon?: ReactNode;
+    label?: string;
+}
+
+export declare const Header: typeof HeaderComponent & HeaderComponentSubmodules;
+
+export declare interface HeaderBrandingProps extends ComponentPropsWithoutRef<'div'> {
+    /** 로고 링크 URL */
+    logoHref?: string;
+    /** 로고 클릭 핸들러 */
+    onLogoClick?: () => void;
+    /** 로고 이미지 대체 텍스트 */
+    logoAltText?: string;
+    /** 자식 컴포넌트들 (주로 Navi) */
+    children?: ReactNode;
+}
+
+declare const HeaderComponent: ForwardRefExoticComponent<Omit<HeaderProps, "ref"> & RefAttributes<HTMLElement>>;
+
+declare interface HeaderComponentSubmodules {
+    Container: ForwardRefExoticComponent<ComponentPropsWithoutRef<'div'> & RefAttributes<HTMLDivElement>>;
+    Utilities: ComponentType<HeaderUtilitiesProps>;
+    Utility: ForwardRefExoticComponent<HeaderUtilityProps & RefAttributes<HTMLLIElement>> & {
+        Dropdown: ComponentType<HeaderUtilityDropdownProps>;
+        DropdownItem: ComponentType<DropdownItemProps>;
+    };
+    Branding: ComponentType<HeaderBrandingProps>;
+    Navi: ComponentType<HeaderNaviProps>;
+    NaviButton: {
+        Search: ForwardRefExoticComponent<HeaderNaviButtonSearchProps & RefAttributes<HTMLButtonElement>>;
+        Login: ForwardRefExoticComponent<HeaderNaviButtonLoginProps & RefAttributes<HTMLAnchorElement | HTMLButtonElement>>;
+        Join: ForwardRefExoticComponent<HeaderNaviButtonJoinProps & RefAttributes<HTMLButtonElement>>;
+        MyGov: ForwardRefExoticComponent<HeaderMyGovProps & RefAttributes<HTMLButtonElement>>;
+        Logout: ForwardRefExoticComponent<HeaderNaviButtonLogoutProps & RefAttributes<HTMLButtonElement>>;
+    };
+    MainMenu: ForwardRefExoticComponent<HeaderMainMenuProps & RefAttributes<HTMLElement>>;
+}
+
+export declare interface HeaderMainMenuProps extends Omit<MainMenuProps, 'mobileTrigger' | 'mobileTriggerPortalId' | 'desktopPortalId' | 'mobilePortalId' | 'mobileTriggerContainerElement'> {
+    /** 커스텀 모바일 트리거 */
+    mobileTrigger?: ReactNode;
+    /** 모바일 트리거 props */
+    mobileTriggerProps?: MobileTriggerProps;
+    /** 전체 메뉴 버튼 레이블 */
+    allMenuButtonLabel?: string;
+}
+
+export declare type HeaderMyGovMenuItem = (HeaderMyGovMenuItemBase & {
+    href: string;
+} & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children' | 'className' | 'href'>) | (HeaderMyGovMenuItemBase & {
+    href?: undefined;
+} & Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'className'>);
+
+declare type HeaderMyGovMenuItemBase = {
+    key?: Key;
+    label: ReactNode;
+    className?: string;
+};
+
+export declare interface HeaderMyGovProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'className' | 'name'> {
+    /** 마이GOV 버튼 레이블 */
+    label?: ReactNode;
+    /** 사용자 이름 */
+    name: ReactNode;
+    /** 남은 시간 표시 (예: "29:30") */
+    remainingTime?: ReactNode;
+    /** 남은 시간 레이블 */
+    remainingTimeLabel?: ReactNode;
+    /** 시간 연장 버튼 레이블 */
+    extendTimeLabel?: ReactNode;
+    /** 시간 연장 버튼 클릭 핸들러 */
+    onExtendTime?: () => void;
+    /** 드롭다운 메뉴 아이템들 */
+    items?: HeaderMyGovMenuItem[];
+    /** 컨테이너 커스텀 클래스 */
+    className?: string;
+    /** 버튼 커스텀 클래스 */
+    buttonClassName?: string;
+    /** 드롭다운 고유 ID */
+    dropdownId?: string;
+}
+
+export declare type HeaderNaviButtonJoinProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    /** 회원가입 버튼 레이블 */
+    label?: ReactNode;
+};
+
+export declare type HeaderNaviButtonLoginProps = ({
+    /** 로그인 링크 URL (지정 시 <a> 태그로 렌더링) */
+    href: string;
+    /** 로그인 버튼 레이블 */
+    label?: ReactNode;
+} & AnchorHTMLAttributes<HTMLAnchorElement>) | ({
+    href?: undefined;
+    /** 로그인 버튼 레이블 */
+    label?: ReactNode;
+} & ButtonHTMLAttributes<HTMLButtonElement>);
+
+export declare interface HeaderNaviButtonLogoutProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** 로그아웃 버튼 내용 */
+    children?: ReactNode;
+}
+
+export declare interface HeaderNaviButtonSearchProps extends Omit<ComponentPropsWithoutRef<'button'>, 'children'> {
+    /** 검색 버튼 레이블 */
+    label?: ReactNode;
+    /** 검색 버튼 title 속성 */
+    title?: string;
+}
+
+export declare interface HeaderNaviProps extends ComponentPropsWithoutRef<'div'> {
+    /** NaviButton 컴포넌트들 */
+    children?: ReactNode;
+}
+
+export declare interface HeaderProps extends ComponentPropsWithRef<'header'> {
+    /** 자식 컴포넌트들 */
+    children?: ReactNode;
+    /** 모바일 메뉴 트리거 Portal ID */
+    mobileMenuTriggerPortalId?: string;
+    /** 데스크톱 메뉴 Portal ID */
+    desktopMenuPortalId?: string;
+    /** 모바일 메뉴 Portal ID */
+    mobileMenuPortalId?: string;
+}
+
+export declare type HeaderUtilitiesProps = ComponentPropsWithoutRef<'div'> & {
+    /** 유틸리티 아이템들 */
+    children?: ReactNode;
+};
+
+export declare interface HeaderUtilityDropdownProps extends Omit<DropdownProps, 'buttonText' | 'children' | 'className'> {
+    /** 드롭다운 고유 ID */
+    id?: string;
+    /** 드롭다운 버튼 레이블 */
+    label?: ReactNode;
+    /** 드롭다운 버튼 텍스트 (label 별칭) */
+    buttonText?: ReactNode;
+    /** 드롭다운 아이템들 */
+    children: ReactNode;
+    /** 드롭다운 컨테이너 커스텀 클래스 */
+    dropdownClassName?: string;
+    /** 드롭다운 아이템 커스텀 클래스 */
+    itemClassName?: string;
+}
+
+export declare interface HeaderUtilityProps extends ComponentPropsWithoutRef<'li'> {
+    /** 자식 컴포넌트 */
+    children?: ReactNode;
+}
+
+/**
+ * KRDS HelpCoachProcess Component
+ * @param children 코치 태스크들
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpCoachProcess: default_2.ForwardRefExoticComponent<{
+    children?: default_2.ReactNode;
+    className?: string;
+} & default_2.RefAttributes<HTMLUListElement>>;
+
+/**
+ * KRDS HelpCoachTask Component
+ * @param title 태스크 제목
+ * @param isCurrent 현재 태스크 여부
+ * @param expandText 펼치기 버튼 텍스트
+ * @param steps 단계 목록
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpCoachTask: default_2.ForwardRefExoticComponent<{
+    title: string;
+    isCurrent?: boolean;
+    expandText: string;
+    steps: string[];
+    className?: string;
+} & default_2.RefAttributes<HTMLLIElement>>;
+
+export declare interface HelpContent {
+    title: string;
+    description?: ReactNode;
+    links?: HelpLink[];
+}
+
+/**
+ * KRDS HelpContentArea Component
+ * @param children 컨텐츠 영역 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpContentArea: default_2.ForwardRefExoticComponent<{
+    children?: default_2.ReactNode;
+    className?: string;
+} & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface HelpLink {
+    label: string;
+    href: string;
+    icon?: string;
+    iconPosition?: 'left' | 'right';
+    external?: boolean;
+}
+
+/**
+ * KRDS HelpLinkList Component
+ * @param links 링크 목록
+ * @param iconPosition 아이콘 위치 ('left' | 'right')
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpLinkList: default_2.ForwardRefExoticComponent<HelpLinkListProps & default_2.RefAttributes<HTMLUListElement>>;
+
+export declare interface HelpLinkListProps extends HTMLAttributes<HTMLUListElement> {
+    /** 링크 목록 */
+    links: Array<{
+        text: string;
+        href: string;
+        target?: string;
+        icon?: string;
+    }>;
+    /** 아이콘 위치 ('left' | 'right') */
+    iconPosition?: 'left' | 'right';
+}
+
+/**
+ * KRDS HelpPanel Component
+ * @param isOpen 도움말 패널 열림 상태
+ * @param defaultOpen 비제어 상태에서 사용할 초기 열림 상태
+ * @param onOpenChange 도움말 패널 열림/닫힘 상태 변경 핸들러
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpPanel: default_2.ForwardRefExoticComponent<HelpPanelProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/**
+ * KRDS HelpPanelAction Component
+ * @param children 액션 버튼들
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpPanelAction: default_2.ForwardRefExoticComponent<{
+    children?: default_2.ReactNode;
+    className?: string;
+} & default_2.RefAttributes<HTMLDivElement>>;
+
+/**
+ * KRDS HelpPanelClose Component
+ * @param children 닫기 버튼 텍스트
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpPanelClose: default_2.ForwardRefExoticComponent<HelpPanelCloseProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface HelpPanelCloseProps extends HTMLAttributes<HTMLButtonElement> {
+    /** 닫기 버튼 텍스트 */
+    children?: React.ReactNode;
+}
+
+/**
+ * KRDS HelpPanelContent Component
+ * @param children 도움말 패널 내용
+ * @param srOnlyTitle 스크린 리더 전용 제목
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpPanelContent: default_2.ForwardRefExoticComponent<HelpPanelContentProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface HelpPanelContentProps extends HTMLAttributes<HTMLDivElement> {
+    /** 도움말 패널 내용 */
+    children?: React.ReactNode;
+    /** 스크린 리더 전용 제목 */
+    srOnlyTitle?: string;
+}
+
+export declare interface HelpPanelContextValue {
+    /** 도움말 패널 열림 상태 */
+    isOpen: boolean;
+    /** 패널 열기 */
+    open: () => void;
+    /** 패널 닫기 */
+    close: () => void;
+    /** 패널 열림 상태 토글 */
+    toggle: () => void;
+    /** 패널 열림 상태 설정 */
+    setOpen: (isOpen: boolean) => void;
+    /** 패널 DOM id */
+    panelId: string;
+    /** 포커스를 복원할 대상 */
+    lastFocusedElementRef: MutableRefObject<HTMLElement | null>;
+}
+
+export declare interface HelpPanelProps extends HTMLAttributes<HTMLDivElement> {
+    /** 도움말 패널 열림 상태 */
+    isOpen?: boolean;
+    /** 비제어 상태에서 사용할 초기 열림 상태 */
+    defaultOpen?: boolean;
+    /** 도움말 패널 열림/닫힘 상태 변경 핸들러 */
+    onOpenChange?: (isOpen: boolean) => void;
+    /** 도움말 패널 내용 */
+    children?: React.ReactNode;
+}
+
+/**
+ * KRDS HelpPanelTrigger Component
+ * @param children 트리거 버튼 텍스트
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpPanelTrigger: default_2.ForwardRefExoticComponent<HelpPanelTriggerProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface HelpPanelTriggerProps extends HTMLAttributes<HTMLButtonElement> {
+    /** 트리거 버튼 텍스트 */
+    children?: React.ReactNode;
+}
+
+/**
+ * KRDS HelpRelatedService Component
+ * @param children 관련 서비스 그룹들
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpRelatedService: default_2.ForwardRefExoticComponent<{
+    children?: default_2.ReactNode;
+    className?: string;
+} & default_2.RefAttributes<HTMLDivElement>>;
+
+/**
+ * KRDS HelpSection Component
+ * @param title 섹션 제목
+ * @param description 섹션 설명
+ * @param children 섹션 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpSection: default_2.ForwardRefExoticComponent<HelpSectionProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface HelpSectionProps extends HTMLAttributes<HTMLDivElement> {
+    /** 섹션 제목 */
+    title: string;
+    /** 섹션 설명 */
+    description?: string;
+    /** 섹션 내용 */
+    children?: React.ReactNode;
+}
+
+/**
+ * KRDS HelpServiceGroup Component
+ * @param title 서비스 그룹 제목
+ * @param children 서비스 그룹 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpServiceGroup: default_2.ForwardRefExoticComponent<{
+    title: string;
+    children?: default_2.ReactNode;
+    className?: string;
+} & default_2.RefAttributes<HTMLDivElement>>;
+
+/**
+ * KRDS HelpTutorialTitle Component
+ * @param title 따라하기 제목
+ * @param href 이전으로 돌아가기 링크
+ * @param className 사용자 정의 클래스명
+ */
+export declare const HelpTutorialTitle: default_2.ForwardRefExoticComponent<{
+    title: string;
+    href?: string;
+    className?: string;
+} & default_2.RefAttributes<HTMLHeadingElement>>;
+
+/**
+ * KRDS Identifier 컴포넌트
+ * @param logoAlt 로고 alt 텍스트
+ * @param text 식별자 텍스트
+ * @param className 추가 커스텀 클래스
+ */
+export declare const Identifier: ForwardRefExoticComponent<IdentifierProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface IdentifierProps extends HTMLAttributes<HTMLDivElement> {
+    /** 로고 alt 텍스트 */
+    logoAlt?: string;
+    /** 식별자 텍스트 */
+    text?: string;
+}
+
+/**
+ * KRDS InPageNavigation Component
+ * @param caption 페이지 구성 설명 텍스트
+ * @param title 페이지 제목
+ * @param items 네비게이션 아이템 목록
+ * @param actionText 액션 버튼 텍스트
+ * @param onActionClick 액션 버튼 클릭 핸들러
+ * @param infoText 추가 정보 텍스트 (HTML 태그 지원)
+ * @param scrollDown 스크롤 시 상단 위치 조정 여부
+ * @param scrollContainerRef 스크롤 컨테이너 참조
+ */
+export declare const InPageNavigation: ForwardRefExoticComponent<Omit<InPageNavigationProps, "ref"> & RefAttributes<HTMLDivElement>>;
+
+export declare interface InPageNavigationProps extends ComponentPropsWithRef<'div'> {
+    /** 페이지 구성 설명 텍스트 */
+    caption?: string;
+    /** 페이지 제목 */
+    title?: string;
+    /** 네비게이션 아이템 목록 */
+    items?: NavigationItem[];
+    /** 액션 버튼 텍스트 */
+    actionText?: string;
+    /** 액션 버튼 클릭 핸들러 */
+    onActionClick?: () => void;
+    /** 추가 정보 텍스트 (HTML 태그 지원) */
+    infoText?: ReactNode;
+    /** 스크롤 시 상단 위치 조정 여부 */
+    scrollDown?: boolean;
+    /** 스크롤 컨테이너 참조 */
+    scrollContainerRef?: React.RefObject<HTMLElement | null>;
+}
+
+export declare interface LanguageOption {
+    value: string;
+    label: string;
+    external?: boolean;
+    href?: string;
+}
+
+export declare const LanguageSwitcher: default_2.ForwardRefExoticComponent<LanguageSwitcherProps & default_2.RefAttributes<HTMLDivElement>> & {
+    Root: default_2.ForwardRefExoticComponent<LanguageSwitcherProps & default_2.RefAttributes<HTMLDivElement>>;
+    Trigger: default_2.ForwardRefExoticComponent<{
+        label?: string;
+        className?: string;
+    } & default_2.RefAttributes<HTMLButtonElement>>;
+    Menu: default_2.ForwardRefExoticComponent<LanguageSwitcherMenuProps & default_2.RefAttributes<HTMLDivElement>>;
+    Current: ({ label, className }: LanguageSwitcherCurrentProps) => default_2.JSX.Element;
+    OptionList: ({ className, ...props }: LanguageSwitcherOptionListProps) => default_2.JSX.Element;
+    OptionItem: ({ value, label, href, external, className, ...props }: LanguageSwitcherOptionItemProps) => default_2.JSX.Element;
+};
+
+declare type LanguageSwitcherCurrentProps = HTMLAttributes<HTMLDivElement> & {
+    label?: string;
+};
+
+declare type LanguageSwitcherMenuProps = HTMLAttributes<HTMLDivElement>;
+
+declare type LanguageSwitcherOptionItemProps = HTMLAttributes<HTMLLIElement> & {
+    value: string;
+    label: string;
+    href?: string;
+    external?: boolean;
+};
+
+declare type LanguageSwitcherOptionListProps = HTMLAttributes<HTMLUListElement>;
+
+export declare interface LanguageSwitcherProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string, option: LanguageOption) => void;
+    options?: LanguageOption[];
+    className?: string;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    closeOnClickOutside?: boolean;
+}
+
+/**
+ * KRDS Link 컴포넌트
+ * @param variant 링크 스타일 타입 ('default' | 'basic')
+ * @param underline 밑줄 표시 여부 ('always' | 'hover' | 'none')
+ * @param preserveColorOnHover hover 시 컬러 유지 여부
+ * @param icon 외부 링크 아이콘 또는 커스텀 아이콘
+ * @param external 외부 링크 여부
+ * @param size 링크 크기 ('xsmall' | 'small' | 'medium' | 'large' | 'xlarge')
+ * @param disabled 비활성화 여부
+ * @param children 링크 텍스트 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare const Link: ForwardRefExoticComponent<LinkProps & RefAttributes<HTMLAnchorElement>>;
+
+export declare interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'size'> {
+    /** 링크 스타일 타입 ('default' | 'basic') */
+    variant?: LinkVariant;
+    /** 밑줄 표시 여부 ('always' | 'hover' | 'none') */
+    underline?: LinkUnderline;
+    /** hover 시 컬러 유지 여부 (pure 클래스) */
+    preserveColorOnHover?: boolean;
+    /** 외부 링크 아이콘 또는 커스텀 아이콘 */
+    icon?: ReactNode;
+    /** 외부 링크 여부 (rel, target 자동 설정) */
+    external?: boolean;
+    /** 링크 크기 ('xsmall' | 'small' | 'medium' | 'large' | 'xlarge') */
+    size?: LinkSize;
+    /** 비활성화 여부 */
+    disabled?: boolean;
+    /** 링크 텍스트 내용 */
+    children?: ReactNode;
+    /** 사용자 정의 클래스명 */
+    className?: string;
+}
+
+export declare type LinkSize = 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';
+
+declare interface LinkTagProps extends BaseTagProps, Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> {
+    /** 태그 타입 */
+    variant: 'link';
+    /** 링크 URL */
+    href: string;
+}
+
+export declare type LinkUnderline = 'always' | 'hover' | 'none';
+
+export declare type LinkVariant = 'default' | 'basic' | 'unstyled';
+
+declare interface MainMenuBaseProps {
+    desktop: DesktopMenuConfig;
+    mobile: MobileMenuConfig;
+    mobileTrigger?: ReactNode;
+    onMobileMenuOpen?: () => void;
+    onMobileMenuClose?: () => void;
+    desktopPortalId?: string;
+    mobilePortalId?: string;
+}
+
+declare type MainMenuProps = MainMenuBaseProps & ({
+    mobileTriggerPortalId: string;
+    mobileTriggerContainerElement?: never;
+} | {
+    mobileTriggerPortalId?: never;
+    mobileTriggerContainerElement: HTMLElement;
+});
+
+/**
+ * KRDS Masthead Component
+ * @param text 배너 텍스트
+ * @param className 커스텀 클래스명
+ */
+export declare const Masthead: ForwardRefExoticComponent<MastheadProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface MastheadProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    text: string;
+    className?: string;
+}
+
+declare type MobileDepth3Item = MobileDepth3Link | MobileDepth4;
+
+declare interface MobileDepth3Link {
+    type: 'link';
+    id?: string;
+    label: string;
+    href: string;
+    isExternal?: boolean;
+}
+
+declare interface MobileDepth4 {
+    type: 'depth4';
+    id?: string;
+    label: string;
+    title: string;
+    items: Array<{
+        id?: string;
+        label: string;
+        href: string;
+        isExternal?: boolean;
+    }>;
+}
+
+declare interface MobileLinkItem {
+    id?: string;
+    label: string;
+    href: string;
+    isExternal?: boolean;
+    onClick?: () => void;
+}
+
+declare interface MobileMainItem {
+    id?: string;
+    label: string;
+    panels: MobilePanel[];
+}
+
+declare interface MobileMenuConfig {
+    id?: string;
+    header?: {
+        utilities?: MobileUtilityItem[];
+        login?: {
+            isLoggedIn: boolean;
+            userName?: string;
+            loginText?: string;
+            logoutText?: string;
+            onLogin?: () => void;
+            onLogout?: () => void;
+        };
+        services?: MobileLinkItem[];
+        search?: {
+            placeholder?: string;
+            onSearch?: (query: string) => void;
+        };
+    };
+    body: {
+        mainItems: MobileMainItem[];
+    };
+    bottomLinks?: MobileLinkItem[];
+}
+
+declare interface MobilePanel {
+    id?: string;
+    label: string;
+    items: MobilePanelItem[];
+}
+
+declare interface MobilePanelDepth3 {
+    type: 'depth3';
+    id?: string;
+    label: string;
+    items: Array<MobileDepth3Item>;
+}
+
+declare type MobilePanelItem = MobilePanelLink | MobilePanelDepth3;
+
+declare interface MobilePanelLink {
+    type: 'link';
+    id?: string;
+    label: string;
+    href: string;
+    isExternal?: boolean;
+}
+
+declare interface MobileTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    label?: string;
+    icon?: ReactNode;
+}
+
+declare interface MobileUtilityItem {
+    id?: string;
+    label: string;
+    href?: string;
+    onClick?: () => void;
+}
+
+export declare const Modal: {
+    ({ children, size, variant, open, defaultOpen, onOpenChange, closeOnEsc, closeOnOverlayClick, usePortal, portalContainer }: ModalRootProps): default_2.JSX.Element;
+    displayName: string;
+} & {
+    Root: {
+        ({ children, size, variant, open, defaultOpen, onOpenChange, closeOnEsc, closeOnOverlayClick, usePortal, portalContainer }: ModalRootProps): default_2.JSX.Element;
+        displayName: string;
+    };
+    Trigger: default_2.ForwardRefExoticComponent<Omit<ModalTriggerProps, "ref"> & default_2.RefAttributes<HTMLButtonElement>>;
+    Content: default_2.ForwardRefExoticComponent<Omit<default_2.DetailedHTMLProps<default_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
+    Header: default_2.ForwardRefExoticComponent<Omit<ModalHeaderProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
+    Title: default_2.ForwardRefExoticComponent<Omit<default_2.DetailedHTMLProps<default_2.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>, "ref"> & default_2.RefAttributes<HTMLHeadingElement>>;
+    Description: default_2.ForwardRefExoticComponent<Omit<default_2.DetailedHTMLProps<default_2.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "ref"> & default_2.RefAttributes<HTMLParagraphElement>>;
+    Body: default_2.ForwardRefExoticComponent<Omit<ModalBodyProps, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
+    Footer: default_2.ForwardRefExoticComponent<Omit<default_2.DetailedHTMLProps<default_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
+    Close: default_2.ForwardRefExoticComponent<Omit<ModalCloseProps, "ref"> & default_2.RefAttributes<HTMLButtonElement>>;
+};
+
+export declare type ModalBodyProps = default_2.ComponentProps<'div'> & {
+    descriptionId?: string;
+};
+
+export declare type ModalCloseProps = default_2.ComponentProps<'button'> & {
+    asChild?: boolean;
+};
+
+export declare type ModalContentProps = default_2.ComponentProps<'div'>;
+
+export declare type ModalFooterProps = default_2.ComponentProps<'div'>;
+
+export declare type ModalHeaderProps = default_2.ComponentProps<'div'> & {
+    title?: default_2.ReactNode;
+    titleId?: string;
+};
+
+export declare type ModalOverlayProps = default_2.ComponentProps<'div'>;
+
+export declare interface ModalRootProps extends PropsWithChildren {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    size?: ModalSize;
+    variant?: ModalVariant;
+    closeOnEsc?: boolean;
+    closeOnOverlayClick?: boolean;
+    usePortal?: boolean;
+    portalContainer?: string | HTMLElement;
+}
+
+export declare type ModalSize = 'sm' | 'md' | 'lg';
+
+export declare type ModalTriggerProps = default_2.ComponentProps<'button'> & {
+    asChild?: boolean;
+};
+
+export declare type ModalVariant = 'default' | 'bottom-sheet';
+
+export declare interface NavigationItem {
+    /** 네비게이션 링크의 href */
+    href: string;
+    /** 네비게이션 링크 텍스트 */
+    label: string;
+    /** 현재 활성화된 링크 여부 */
+    active?: boolean;
+}
+
+/**
+ * KRDS Pagination Component
+ * @param totalPages 전체 페이지 수
+ * @param currentPage 현재 페이지 (제어)
+ * @param defaultPage 초기 페이지 (비제어)
+ * @param onChange 페이지 변경 핸들러
+ * @param prevLabel 이전 버튼 레이블
+ * @param nextLabel 다음 버튼 레이블
+ * @param boundaryCount 경계 영역에 표시할 페이지 수 (0-3)
+ * @param siblingCount 현재 주변 표시 페이지 수 (0-3)
+ * @param disabled 비활성 상태
+ * @param className 커스텀 클래스명
+ */
+export declare const Pagination: default_2.FC<PaginationProps>;
+
+export declare interface PaginationProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** 전체 페이지 수 */
+    totalPages: number;
+    /** 현재 페이지 (제어 상태) */
+    currentPage?: number;
+    /** 초기 페이지 (비제어 상태) */
+    defaultPage?: number;
+    /** 페이지 변경 핸들러 */
+    onChange?: (page: number) => void;
+    /** 이전 버튼 레이블 */
+    prevLabel?: string;
+    /** 다음 버튼 레이블 */
+    nextLabel?: string;
+    /** 경계 영역에 항상 표시할 페이지 수 (앞/뒤) */
+    boundaryCount?: 0 | 1 | 2 | 3;
+    /** 현재 페이지 주변에 표시할 형제 페이지 수 */
+    siblingCount?: 0 | 1 | 2 | 3;
+    /** 비활성 상태 */
+    disabled?: boolean;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+declare type PolymorphicButtonComponent = <T extends ElementType = 'button'>(props: ButtonProps<T> & {
+    ref?: PolymorphicRef<T>;
+}) => default_2.ReactElement | null;
+
+declare type PolymorphicRef<T extends ElementType> = ComponentPropsWithRef<T>['ref'];
+
+/**
+ * KRDS Radio 컴포넌트
+ * @param value 라디오 버튼의 값 (RadioGroup 내에서 사용)
+ * @param checked 선택 상태 (controlled mode)
+ * @param defaultChecked 초기 선택 상태 (uncontrolled mode)
+ * @param disabled 비활성화 여부
+ * @param size 라디오 버튼 크기 ('medium' | 'large')
+ * @param description 부가적인 설명 텍스트
+ * @param onChange 값 변경 시 호출되는 콜백
+ * @param className 추가 커스텀 클래스
+ */
+export declare const Radio: default_2.ForwardRefExoticComponent<RadioProps & default_2.RefAttributes<HTMLInputElement>>;
+
+/**
+ * KRDS RadioChip 컴포넌트
+ * @param value 라디오 칩의 값 (RadioGroup 내에서 사용)
+ * @param checked 선택 상태 (controlled mode)
+ * @param defaultChecked 초기 선택 상태 (uncontrolled mode)
+ * @param disabled 비활성화 여부
+ * @param size 라디오 칩 크기 ('small' | 'medium' | 'large')
+ * @param onChange 값 변경 시 호출되는 콜백
+ * @param className 추가 커스텀 클래스
+ */
+export declare const RadioChip: default_2.ForwardRefExoticComponent<RadioChipProps & default_2.RefAttributes<HTMLInputElement>>;
+
+export declare interface RadioChipProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'defaultValue' | 'defaultChecked'> {
+    /** 라디오 칩 크기 */
+    size?: RadioChipSize;
+    /** 비제어 상태에서 사용할 초기 체크 상태 */
+    defaultChecked?: boolean;
+}
+
+declare type RadioChipSize = 'small' | 'medium' | 'large';
+
+/**
+ * KRDS RadioGroup 컴포넌트
+ * @param value 라디오 그룹의 값 (controlled mode)
+ * @param defaultValue 초기 값 (uncontrolled mode)
+ * @param onChange 값 변경 시 호출되는 콜백
+ * @param name 라디오 그룹의 이름
+ * @param children Radio 또는 RadioChip 컴포넌트들
+ * @param className 추가 커스텀 클래스
+ * @param column 세로 배치 여부
+ */
+export declare const RadioGroup: default_2.FC<RadioGroupProps>;
+
+export declare interface RadioGroupProps {
+    /** 라디오 그룹의 값 (controlled mode) */
+    value?: string;
+    /** 초기 값 (uncontrolled mode) */
+    defaultValue?: string;
+    /** 값이 변경될 때 호출되는 콜백 */
+    onChange?: (value: string) => void;
+    /** 라디오 그룹의 이름 (name 속성) */
+    name: string;
+    /** 자식 요소들 */
+    children: ReactNode;
+    /** 추가 CSS 클래스 */
+    className?: string;
+    /** 세로 배치 여부 */
+    column?: boolean;
+}
+
+export declare interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'defaultChecked'> {
+    /** 라디오 버튼 크기 */
+    size?: RadioSize;
+    /** 추가 설명 텍스트 */
+    description?: string;
+    /** 비제어 상태에서 사용할 초기 체크 상태 */
+    defaultChecked?: boolean;
+}
+
+declare type RadioSize = 'medium' | 'large';
+
+/**
+ * KRDS Resize Component
+ * @param value 현재 선택된 크기 ('sm' | 'md' | 'lg' | 'xlg' | 'xxlg')
+ * @param defaultValue 기본 선택된 크기
+ * @param onChange 크기 변경 시 호출되는 콜백 함수
+ * @param buttonText 드롭다운 버튼 텍스트
+ * @param resetText 초기화 버튼 텍스트
+ * @param labels 각 크기 옵션의 라벨
+ * @param className 사용자 정의 클래스명
+ */
+export declare const Resize: default_2.ForwardRefExoticComponent<ResizeProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface ResizeProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick' | 'onChange'> {
+    /**
+     * 현재 선택된 크기
+     */
+    value?: ResizeScale;
+    /**
+     * 기본 선택된 크기
+     */
+    defaultValue?: ResizeScale;
+    /**
+     * 크기 변경 시 호출되는 콜백 함수
+     */
+    onChange?: (scale: ResizeScale) => void;
+    /**
+     * 드롭다운 버튼 텍스트
+     */
+    buttonText?: string;
+    /**
+     * 초기화 버튼 텍스트
+     */
+    resetText?: string;
+    /**
+     * 각 크기 옵션의 라벨
+     */
+    labels?: {
+        sm: string;
+        md: string;
+        lg: string;
+        xlg: string;
+        xxlg: string;
+    };
+    /**
+     * 사용자 정의 클래스명
+     */
+    className?: string;
+}
+
+export declare type ResizeScale = 'sm' | 'md' | 'lg' | 'xlg' | 'xxlg';
+
+export declare const Select: default_2.FC<SelectProps>;
+
+export declare interface SelectOption {
+    value: string;
+    label: string;
+}
+
+export declare interface SelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, 'size' | 'onChange'> {
+    /** 제어 상태일 때 선택된 값 */
+    value?: string;
+    /** 비제어 상태일 때의 초기 선택 값 */
+    defaultValue?: string;
+    /** 선택 값이 변경될 때 호출되는 콜백 */
+    onChange?: (value: string) => void;
+    /** 선택 옵션들 */
+    options: SelectOption[];
+    /** 레이블 */
+    label?: string;
+    /** 도움말 텍스트 */
+    hint?: string;
+    /** 에러 메시지 */
+    error?: string;
+    /** Select 크기 */
+    size?: SelectSize;
+    /** Select 변형 */
+    variant?: SelectVariant;
+}
+
+export declare type SelectSize = 'small' | 'medium' | 'large';
+
+export declare type SelectVariant = 'default' | 'sorting';
+
+export declare const SideNavigation: ForwardRefExoticComponent<SideNavigationProps & RefAttributes<HTMLElement>> & {
+    Title: ForwardRefExoticComponent<SideNavigationTitleProps & RefAttributes<HTMLHeadingElement>>;
+    Menu: ForwardRefExoticComponent<SideNavigationMenuProps & RefAttributes<HTMLUListElement>>;
+    Item: ForwardRefExoticComponent<SideNavigationItemProps & RefAttributes<HTMLLIElement>>;
+    SubItem: ForwardRefExoticComponent<SideNavigationSubItemProps & RefAttributes<HTMLLIElement>>;
+    Toggle: ForwardRefExoticComponent<SideNavigationToggleProps & RefAttributes<HTMLButtonElement>>;
+    SubMenu: ForwardRefExoticComponent<SideNavigationSubMenuProps & RefAttributes<HTMLDivElement>>;
+    Link: ForwardRefExoticComponent<SideNavigationLinkProps & RefAttributes<HTMLAnchorElement>>;
+    PopupToggle: ForwardRefExoticComponent<SideNavigationPopupToggleProps & RefAttributes<HTMLButtonElement>>;
+    Popup: ForwardRefExoticComponent<SideNavigationPopupProps & RefAttributes<HTMLDivElement>>;
+    PopupTitle: ForwardRefExoticComponent<SideNavigationPopupTitleProps & RefAttributes<HTMLButtonElement>>;
+    PopupMenu: ForwardRefExoticComponent<SideNavigationPopupMenuProps & RefAttributes<HTMLUListElement>>;
+};
+
+export declare interface SideNavigationItemProps extends HTMLAttributes<HTMLLIElement> {
+    /** 자식 요소들 (버튼, 링크, 서브메뉴 등) */
+    children: React.ReactNode;
+    /** 활성화 상태 */
+    active?: boolean;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'onClick'> {
+    /** 링크 텍스트 */
+    children: React.ReactNode;
+    /** 링크 URL */
+    href?: string;
+    /** 현재 페이지 여부 */
+    current?: boolean;
+    /** 클릭 핸들러 */
+    onClick?: () => void;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationMenuProps extends HTMLAttributes<HTMLUListElement> {
+    /** 자식 메뉴 아이템들 */
+    children: React.ReactNode;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationPopupMenuProps extends HTMLAttributes<HTMLUListElement> {
+    /** 4depth 메뉴 아이템들 */
+    children: React.ReactNode;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationPopupProps extends HTMLAttributes<HTMLDivElement> {
+    /** 팝업 내용 */
+    children: React.ReactNode;
+    /** 활성화 상태 */
+    active?: boolean;
+    /** 메뉴 ID */
+    id?: string;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationPopupTitleProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    /** 제목 텍스트 */
+    children: React.ReactNode;
+    /** 클릭 핸들러 */
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationPopupToggleProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    /** 버튼 텍스트 */
+    children: React.ReactNode;
+    /** 확장된 상태 */
+    expanded?: boolean;
+    /** 클릭 핸들러 */
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /** 추가 CSS 클래스 */
+    className?: string;
+    /** ARIA controls 속성 */
+    'aria-controls'?: string;
+}
+
+export declare interface SideNavigationProps extends HTMLAttributes<HTMLElement> {
+    /** 자식 요소들 */
+    children: React.ReactNode;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationSubItemProps extends HTMLAttributes<HTMLLIElement> {
+    /** 자식 요소들 */
+    children: React.ReactNode;
+    /** 활성화 상태 */
+    active?: boolean;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationSubMenuProps extends HTMLAttributes<HTMLDivElement> {
+    /** 서브메뉴 아이템들 */
+    children: React.ReactNode;
+    /** 메뉴 ID */
+    id?: string;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationTitleProps extends HTMLAttributes<HTMLHeadingElement> {
+    /** 제목 텍스트 */
+    children: React.ReactNode;
+    /** 추가 CSS 클래스 */
+    className?: string;
+}
+
+export declare interface SideNavigationToggleProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    /** 버튼 텍스트 */
+    children: React.ReactNode;
+    /** 활성화 상태 */
+    active?: boolean;
+    /** 확장된 상태 */
+    expanded?: boolean;
+    /** 클릭 핸들러 */
+    onClick?: () => void;
+    /** 추가 CSS 클래스 */
+    className?: string;
+    /** ARIA controls 속성 */
+    'aria-controls'?: string;
+}
+
+/**
+ * KRDS SkipLink 컴포넌트
+ * @param targetId 이동할 대상 요소 ID
+ * @param children 링크 텍스트 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare const SkipLink: default_2.ForwardRefExoticComponent<SkipLinkProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface SkipLinkProps extends Omit<HTMLAttributes<HTMLDivElement>, 'id'> {
+    /** 이동할 대상 요소 ID */
+    targetId?: string;
+    /** 링크 텍스트 내용 */
+    children?: string;
+    /** 사용자 정의 클래스명 */
+    className?: string;
+}
+
+/**
+ * KRDS Spinner 컴포넌트
+ * @param label 스피너 옆에 표시할 텍스트
+ * @param className 추가 커스텀 클래스
+ * @param children input 등 자식 요소가 있을 경우 form-spinner 래퍼로 감쌈
+ */
+export declare const Spinner: default_2.FC<SpinnerProps>;
+
+export declare interface SpinnerProps {
+    label?: string;
+    className?: string;
+    children?: React.ReactNode;
+}
+
+/**
+ * KRDS StepIndicator Component
+ * @param steps 단계 목록
+ * @param currentStep 현재 활성 단계 인덱스 (0부터 시작, 기본값 -1)
+ * @param currentStepText 스크린 리더용 현재 단계 텍스트
+ * @param pageTitle 페이지 타이틀 텍스트
+ */
+export declare const StepIndicator: ForwardRefExoticComponent<StepIndicatorProps & RefAttributes<HTMLOListElement>>;
+
+export declare interface StepIndicatorProps extends Omit<HTMLAttributes<HTMLOListElement>, 'children'> {
+    /** 단계 목록 */
+    steps: StepItem[];
+    /** 현재 활성 단계 인덱스 (0부터 시작) */
+    currentStep?: number;
+    /** 스크린 리더용 현재 단계 텍스트 */
+    currentStepText?: string;
+    /** 페이지 타이틀 텍스트 */
+    pageTitle?: string;
+}
+
+export declare interface StepItem {
+    /** 단계 번호 */
+    step: string;
+    /** 단계 제목 */
+    title: string;
+    /** 고유 식별자 (선택사항, key로 사용) */
+    id?: string;
+}
+
+/**
+ * KRDS StructuredList Component
+ * @param children 구조화 목록 아이템들
+ * @param className 사용자 정의 클래스명
+ */
+export declare const StructuredList: ForwardRefExoticComponent<StructuredListProps & RefAttributes<HTMLUListElement>>;
+
+/**
+ * KRDS StructuredListAction Component
+ * @param children 액션 텍스트
+ * @param onClick 클릭 핸들러
+ * @param href 링크 URL
+ * @param variant 버튼 종류 ('primary' | 'secondary' | 'text')
+ * @param title 버튼 제목
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListAction({ children, onClick, href, variant, title, className }: StructuredListActionProps): JSX_2.Element;
+
+export declare interface StructuredListActionProps {
+    children: default_2.ReactNode;
+    onClick?: () => void;
+    href?: string;
+    variant?: 'primary' | 'secondary' | 'text';
+    title?: string;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListBadge Component
+ * @param children 뱃지 텍스트
+ * @param variant 뱃지 종류 ('filled' | 'light')
+ * @param color 뱃지 색상 ('primary' | 'success' | 'secondary')
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListBadge({ children, variant, color, className }: StructuredListBadgeProps): JSX_2.Element;
+
+export declare type StructuredListBadgeProps = BadgeProps;
+
+/**
+ * KRDS StructuredListBody Component
+ * @param children 본문 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListBody({ children, className }: StructuredListBodyProps): JSX_2.Element;
+
+export declare interface StructuredListBodyProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListButtons Component
+ * @param children 버튼 요소들
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListButtons({ children, className }: StructuredListButtonsProps): JSX_2.Element;
+
+export declare interface StructuredListButtonsProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListContent Component
+ * @param children 내용 요소들
+ * @param href 링크 URL
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListContent({ children, href, className }: StructuredListContentProps): JSX_2.Element;
+
+export declare interface StructuredListContentProps {
+    children: default_2.ReactNode;
+    href?: string;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListDescription Component
+ * @param children 설명 텍스트
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListDescription({ children, className }: StructuredListDescriptionProps): JSX_2.Element;
+
+export declare interface StructuredListDescriptionProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListFooter Component
+ * @param children 푸터 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListFooter({ children, className }: StructuredListFooterProps): JSX_2.Element;
+
+export declare interface StructuredListFooterProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListHeader Component
+ * @param children 헤더 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListHeader({ children, className }: StructuredListHeaderProps): JSX_2.Element;
+
+export declare interface StructuredListHeaderProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListItem Component
+ * @param children 구조화 목록 아이템 내용
+ * @param className 사용자 정의 클래스명
+ */
+export declare const StructuredListItem: ForwardRefExoticComponent<StructuredListItemProps & RefAttributes<HTMLLIElement>>;
+
+export declare interface StructuredListItemProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListMeta Component
+ * @param label 메타 레이블
+ * @param children 메타 값
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListMeta({ label, children, className }: StructuredListMetaProps): JSX_2.Element;
+
+export declare interface StructuredListMetaProps {
+    label?: string;
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+export declare interface StructuredListProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListTag Component
+ * @param children 태그 텍스트
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListTag({ children, className }: StructuredListTagProps): JSX_2.Element;
+
+export declare interface StructuredListTagProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS StructuredListTitle Component
+ * @param children 제목 텍스트
+ * @param className 사용자 정의 클래스명
+ */
+export declare function StructuredListTitle({ children, className }: StructuredListTitleProps): JSX_2.Element;
+
+export declare interface StructuredListTitleProps {
+    children: default_2.ReactNode;
+    className?: string;
+}
+
+/**
+ * KRDS Tab Root Component
+ * @param value 활성 탭 값 (제어 모드)
+ * @param defaultValue 기본 활성 탭 값 (비제어 모드)
+ * @param onValueChange 탭 변경 콜백
+ * @param variant 탭 변형 ('line' | 'fill')
+ * @param size 탭 크기 ('normal' | 'full')
+ * @param children 자식 컴포넌트
+ * @param className 커스텀 클래스명
+ */
+export declare const Tab: default_2.ForwardRefExoticComponent<TabProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare const TabContent: default_2.ForwardRefExoticComponent<TabContentProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface TabContentProps extends HTMLAttributes<HTMLDivElement> {
+    /** 자식 컴포넌트 */
+    children: ReactNode;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+export declare const Table: ForwardRefExoticComponent<TableProps & RefAttributes<HTMLTableElement>> & {
+    Caption: ForwardRefExoticComponent<TableCaptionProps & RefAttributes<HTMLElement>>;
+    Colgroup: ForwardRefExoticComponent<TableColgroupProps & RefAttributes<HTMLTableColElement>>;
+    Col: ForwardRefExoticComponent<TableColProps & RefAttributes<HTMLTableColElement>>;
+    Thead: ForwardRefExoticComponent<TableTheadProps & RefAttributes<HTMLTableSectionElement>>;
+    Tbody: ForwardRefExoticComponent<TableTbodyProps & RefAttributes<HTMLTableSectionElement>>;
+    TFoot: ForwardRefExoticComponent<TableTFootProps & RefAttributes<HTMLTableSectionElement>>;
+    Tr: ForwardRefExoticComponent<TableTrProps & RefAttributes<HTMLTableRowElement>>;
+    Th: ForwardRefExoticComponent<TableThProps & RefAttributes<HTMLTableCellElement>>;
+    Td: ForwardRefExoticComponent<TableTdProps & RefAttributes<HTMLTableCellElement>>;
+};
+
+export declare type TableCaptionProps = default_2.HTMLAttributes<HTMLElement>;
+
+export declare type TableColgroupProps = default_2.ColgroupHTMLAttributes<HTMLTableColElement>;
+
+export declare type TableColProps = default_2.ColHTMLAttributes<HTMLTableColElement>;
+
+export declare interface TableProps extends default_2.TableHTMLAttributes<HTMLTableElement> {
+    /** enables horizontal scroll */
+    scroll?: boolean;
+    /** enables mobile scroll */
+    mobScroll?: boolean;
+}
+
+export declare type TableTbodyProps = default_2.HTMLAttributes<HTMLTableSectionElement>;
+
+export declare type TableTdProps = default_2.TdHTMLAttributes<HTMLTableCellElement>;
+
+declare type TableTFootProps = default_2.HTMLAttributes<HTMLTableSectionElement>;
+
+export declare type TableTheadProps = default_2.HTMLAttributes<HTMLTableSectionElement>;
+
+export declare type TableThProps = default_2.ThHTMLAttributes<HTMLTableCellElement>;
+
+export declare type TableTrProps = default_2.HTMLAttributes<HTMLTableRowElement>;
+
+/**
+ * KRDS TabList Component
+ * @param children 자식 컴포넌트 (TabTrigger들)
+ * @param className 커스텀 클래스명
+ */
+export declare const TabList: default_2.ForwardRefExoticComponent<TabListProps & default_2.RefAttributes<HTMLUListElement>>;
+
+export declare interface TabListProps extends HTMLAttributes<HTMLUListElement> {
+    /** 자식 컴포넌트 (TabTrigger들) */
+    children?: ReactNode;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+/**
+ * KRDS TabPanel Component
+ * @param value 탭 값
+ * @param children 자식 컴포넌트
+ * @param className 커스텀 클래스명
+ */
+export declare const TabPanel: default_2.ForwardRefExoticComponent<TabPanelProps & default_2.RefAttributes<HTMLElement>>;
+
+export declare interface TabPanelProps extends HTMLAttributes<HTMLElement> {
+    /** 탭 식별자 */
+    value: string;
+    /** 자식 컴포넌트 */
+    children: ReactNode;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+export declare interface TabProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** 활성 탭 값 (제어 모드) */
+    value?: string;
+    /** 기본 활성 탭 값 (비제어 모드) */
+    defaultValue?: string;
+    /** 탭 변경 콜백 */
+    onValueChange?: (value: string) => void;
+    /** 탭 변형 ('line' | 'fill') */
+    variant?: TabVariant;
+    /** 탭 크기 ('normal' | 'full') */
+    size?: TabSize;
+    /** 자식 컴포넌트 */
+    children: ReactNode;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+export declare type TabSize = 'normal' | 'full';
+
+/**
+ * KRDS TabTrigger Component
+ * @param value 탭 값
+ * @param children 자식 컴포넌트
+ * @param className 커스텀 클래스명
+ */
+export declare const TabTrigger: default_2.ForwardRefExoticComponent<TabTriggerProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface TabTriggerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'value'> {
+    /** 탭 식별자 */
+    value: string;
+    /** 자식 컴포넌트 */
+    children: ReactNode;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+export declare type TabVariant = 'line' | 'fill';
+
+/**
+ * KRDS Tag Component
+ * @param variant tag type ('deletable' | 'link')
+ * @param onDelete delete button click handler
+ * @param deleteDisabled delete button disabled state
+ * @param className custom class name
+ */
+export declare const Tag: default_2.ForwardRefExoticComponent<TagProps & default_2.RefAttributes<HTMLSpanElement | HTMLAnchorElement>>;
+
+export declare type TagProps = DeletableTagProps | LinkTagProps;
+
+export declare type TagSize = 'small' | 'medium' | 'large';
+
+/**
+ * KRDS TagWrap Component
+ * @param size tag group size ('small' | 'medium' | 'large')
+ * @param className custom class name
+ */
+export declare const TagWrap: default_2.ForwardRefExoticComponent<TagWrapProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface TagWrapProps extends HTMLAttributes<HTMLDivElement> {
+    /** 태그들 */
+    children: ReactNode;
+    /** 태그 크기 */
+    size?: TagSize;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+/**
+ * KRDS Textarea Component
+ * @param value 제어 상태일 때 입력된 값
+ * @param defaultValue 비제어 상태일 때의 초기 값
+ * @param onChange 입력 값이 변경될 때 호출되는 콜백
+ * @param label 레이블
+ * @param countTotal 글자수 총합 표시값
+ * @param maxLength 최대 글자수
+ * @param showCount 글자수 카운터 표시 여부
+ * @param disabled disabled 상태
+ * @param readOnly readOnly 상태
+ * @param className custom class name
+ */
+export declare const Textarea: default_2.FC<TextareaProps>;
+
+export declare interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange' | 'value' | 'defaultValue'> {
+    /** 입력 값이 변경될 때 호출되는 콜백 */
+    onChange?: (value: string) => void;
+    /** 레이블 */
+    label?: string;
+    /** 글자수 카운터 표시 여부 */
+    showCount?: boolean;
+    /** 글자수 총합 표시값 */
+    countTotal?: number;
+    /** 제어 상태일 때 입력된 값 */
+    value?: string;
+    /** 비제어 상태일 때의 초기 값 */
+    defaultValue?: string;
+}
+
+/**
+ * KRDS TextInput Component
+ * @param value 제어 상태일 때 입력된 값
+ * @param defaultValue 비제어 상태일 때의 초기 값
+ * @param onChange 입력 값이 변경될 때 호출되는 콜백
+ * @param label 레이블
+ * @param hint 도움말 텍스트
+ * @param error 에러 메시지
+ * @param success 성공 메시지
+ * @param information 정보 메시지
+ * @param size 입력 필드 크기 ('small' | 'medium' | 'large' | 'xlarge')
+ * @param showPasswordToggle 비밀번호 보기/숨기기 버튼 표시 여부
+ * @param showClearButton 삭제 버튼 표시 여부
+ * @param type 입력 필드 타입
+ * @param disabled disabled 상태
+ * @param readOnly readOnly 상태
+ * @param className custom class name
+ */
+export declare const TextInput: ForwardRefExoticComponent<TextInputProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface TextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'defaultValue' | 'size'> {
+    /** 입력 값이 변경될 때 호출되는 콜백 */
+    onChange?: (value: string) => void;
+    /** 레이블 */
+    label?: string;
+    /** 도움말 텍스트 */
+    hint?: string;
+    /** 에러 메시지 */
+    error?: string;
+    /** 성공 메시지 */
+    success?: string;
+    /** 정보 메시지 */
+    information?: string;
+    /** 입력 필드 크기 ('small' | 'medium' | 'large') */
+    size?: 'small' | 'medium' | 'large';
+    /** 제어 상태일 때 입력된 값 */
+    value?: string;
+    /** 비제어 상태일 때의 초기 값 */
+    defaultValue?: string;
+    /** 비밀번호 보기/숨기기 버튼 표시 여부 */
+    showPasswordToggle?: boolean;
+    /** 삭제 버튼 표시 여부 */
+    showClearButton?: boolean;
+}
+
+/**
+ * KRDS TextList Component
+ * @param type 텍스트 목록 타입 ('decimal' | 'dash' | 'hollow' | 'ordered')
+ * @param children 자식 요소
+ * @param className 커스텀 클래스명
+ */
+export declare const TextList: ForwardRefExoticComponent<TextListProps & RefAttributes<HTMLOListElement | HTMLUListElement>>;
+
+/**
+ * KRDS TextListItem Component
+ * @param children 자식 요소
+ * @param className 커스텀 클래스명
+ * @param number 번호 (ordered 타입에서 사용)
+ */
+export declare const TextListItem: ForwardRefExoticComponent<TextListItemProps & RefAttributes<HTMLLIElement>>;
+
+export declare interface TextListItemProps extends HTMLAttributes<HTMLLIElement> {
+    /** 자식 요소 */
+    children?: ReactNode;
+    /** 커스텀 클래스명 */
+    className?: string;
+    /** 번호 (ordered 타입에서 사용) */
+    number?: string;
+}
+
+export declare interface TextListProps extends Omit<HTMLAttributes<HTMLUListElement | HTMLOListElement>, 'type'> {
+    /** 텍스트 목록 타입 */
+    type?: TextListType;
+    /** 자식 요소 */
+    children?: ReactNode;
+    /** 커스텀 클래스명 */
+    className?: string;
+}
+
+export declare type TextListType = 'decimal' | 'dash' | 'hollow' | 'ordered';
+
+/**
+ * KRDS ToggleSwitch Component
+ * @param size 토글 스위치 크기 ('medium' | 'large')
+ * @param label 토글 스위치 라벨 텍스트
+ * @param checked 체크 상태 (제어된 컴포넌트)
+ * @param defaultChecked 기본 체크 상태 (비제어 컴포넌트)
+ * @param onChange 값 변경 핸들러
+ * @param className 추가 CSS 클래스명
+ */
+export declare const ToggleSwitch: default_2.ForwardRefExoticComponent<ToggleSwitchProps & default_2.RefAttributes<HTMLInputElement>>;
+
+export declare interface ToggleSwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'type' | 'onChange'> {
+    /**
+     * 토글 스위치 크기
+     */
+    size?: ToggleSwitchSize;
+    /**
+     * 토글 스위치 라벨 텍스트
+     */
+    label?: string;
+    /**
+     * 값 변경 핸들러
+     */
+    onChange?: (checked: boolean, event: React.ChangeEvent<HTMLInputElement>) => void;
+}
+
+export declare type ToggleSwitchSize = 'medium' | 'large';
+
+/**
+ * KRDS Tooltip Component
+ * @param text 툴팁에 표시될 텍스트
+ * @param variant 툴팁 방향 ('vertical' | 'horizontal' | 'box')
+ * @param className 추가 클래스명
+ */
+export declare const Tooltip: default_2.ForwardRefExoticComponent<TooltipProps & default_2.RefAttributes<HTMLElement>>;
+
+export declare interface TooltipProps {
+    children: ReactNode;
+    text: string;
+    variant?: 'horizontal' | 'vertical' | 'box';
+    className?: string;
+}
+
+export declare const TutorialPanel: ForwardRefExoticComponent<TutorialPanelRootProps & RefAttributes<HTMLDivElement>> & {
+    Root: ForwardRefExoticComponent<TutorialPanelRootProps & RefAttributes<HTMLDivElement>>;
+    Trigger: ForwardRefExoticComponent<TutorialPanelTriggerProps & RefAttributes<HTMLButtonElement>>;
+    Container: ForwardRefExoticComponent<TutorialPanelContainerProps & RefAttributes<HTMLDivElement>>;
+    Tabs: ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & RefAttributes<HTMLDivElement>>;
+    TabPanel: ForwardRefExoticComponent<TutorialPanelTabContentProps & RefAttributes<HTMLElement>>;
+    HelpContent: ForwardRefExoticComponent<TutorialPanelHelpContentProps & RefAttributes<HTMLDivElement>>;
+    TutorialContent: ForwardRefExoticComponent<TutorialPanelTutorialContentProps & RefAttributes<HTMLDivElement>>;
+    Close: ForwardRefExoticComponent<TutorialPanelCloseProps & RefAttributes<HTMLButtonElement>>;
+};
+
+export declare interface TutorialPanelCloseProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    children?: ReactNode;
+}
+
+export declare interface TutorialPanelContainerProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+
+export declare interface TutorialPanelHelpContentProps extends HTMLAttributes<HTMLDivElement> {
+    helpContent?: HelpContent;
+    relatedServices?: HelpContent[];
+}
+
+export declare interface TutorialPanelRootProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onToggle'> {
+    isOpen?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    activeTab?: 'help' | 'tutorial';
+    defaultActiveTab?: 'help' | 'tutorial';
+    onTabChange?: (tab: 'help' | 'tutorial') => void;
+    children: ReactNode;
+}
+
+export declare interface TutorialPanelTabContentProps extends HTMLAttributes<HTMLElement> {
+    value: 'help' | 'tutorial';
+    children: ReactNode;
+}
+
+export declare interface TutorialPanelTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    children?: ReactNode;
+}
+
+export declare interface TutorialPanelTutorialContentProps extends HTMLAttributes<HTMLDivElement> {
+    title?: string;
+    steps?: TutorialStep[];
+    onTutorialStop?: () => void;
+    stopButtonText?: string;
+}
+
+export declare interface TutorialStep {
+    title: string;
+    current?: boolean;
+    steps?: string[];
+    content?: ReactNode;
+}
+
+export declare const useHelpPanelContext: () => HelpPanelContextValue | null;
+
+export { }