@hua-labs/ui 1.1.0-alpha.6 → 2.0.0-alpha.10

package/dist/overlay.d.mts

@@ -0,0 +1,513 @@
+export { M as Modal, a as ModalProps } from './Modal-LokAqhCz.mjs';
+import React from 'react';
+
+/**
+ * ConfirmModal 컴포넌트의 props / ConfirmModal component props
+ * @typedef {Object} ConfirmModalProps
+ * @property {boolean} isOpen - 모달 열림/닫힘 상태 / Modal open/close state
+ * @property {() => void} onClose - 닫기 콜백 / Close callback
+ * @property {() => void} onConfirm - 확인 콜백 / Confirm callback
+ * @property {string} title - 모달 제목 / Modal title
+ * @property {string} message - 모달 메시지 / Modal message
+ * @property {string} [warning] - 경고 메시지 / Warning message
+ * @property {string} [confirmText="확인"] - 확인 버튼 텍스트 / Confirm button text
+ * @property {string} [cancelText="취소"] - 취소 버튼 텍스트 / Cancel button text
+ * @property {string} [confirmButtonText] - 확인 버튼 커스텀 텍스트 / Custom confirm button text
+ * @property {"danger" | "warning" | "info" | "success" | "error"} [type="danger"] - 모달 타입 / Modal type
+ * @property {boolean} [loading=false] - 로딩 상태 / Loading state
+ * @property {boolean} [disabled=false] - 비활성화 여부 / Disabled state
+ * @property {boolean} [showInput=false] - 입력 필드 표시 여부 / Show input field
+ * @property {string} [inputValue=""] - 입력 필드 값 / Input field value
+ * @property {(value: string) => void} [onInputChange] - 입력 값 변경 콜백 / Input value change callback
+ * @property {string} [inputPlaceholder] - 입력 필드 플레이스홀더 / Input field placeholder
+ * @property {string} [inputLabel] - 입력 필드 라벨 / Input field label
+ * @property {string} [requiredInputValue] - 필수 입력 값 (확인 버튼 활성화 조건) / Required input value (confirm button activation condition)
+ * @property {boolean} [showCancel=true] - 취소 버튼 표시 여부 / Show cancel button
+ * @property {"sm" | "md" | "lg" | "xl" | "2xl"} [size="md"] - 모달 크기 / Modal size
+ */
+interface ConfirmModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onConfirm: () => void;
+    title: string;
+    message: string;
+    warning?: string;
+    confirmText?: string;
+    cancelText?: string;
+    confirmButtonText?: string;
+    type?: "danger" | "warning" | "info" | "success" | "error";
+    loading?: boolean;
+    disabled?: boolean;
+    showInput?: boolean;
+    inputValue?: string;
+    onInputChange?: (value: string) => void;
+    inputPlaceholder?: string;
+    inputLabel?: string;
+    requiredInputValue?: string;
+    showCancel?: boolean;
+    size?: "sm" | "md" | "lg" | "xl" | "2xl";
+}
+/**
+ * ConfirmModal 컴포넌트 / ConfirmModal component
+ *
+ * 확인/취소가 필요한 모달 컴포넌트입니다.
+ * 다양한 타입(danger, warning, info, success, error)을 지원하며,
+ * 입력 필드와 필수 입력 값 검증을 지원합니다.
+ *
+ * Modal component that requires confirmation/cancellation.
+ * Supports various types (danger, warning, info, success, error),
+ * and supports input fields and required input value validation.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <ConfirmModal
+ *   isOpen={isOpen}
+ *   onClose={() => setIsOpen(false)}
+ *   onConfirm={handleConfirm}
+ *   title="삭제 확인"
+ *   message="정말 삭제하시겠습니까?"
+ * />
+ *
+ * @example
+ * // 입력 필드와 함께 / With input field
+ * <ConfirmModal
+ *   isOpen={isOpen}
+ *   onClose={() => setIsOpen(false)}
+ *   onConfirm={handleDelete}
+ *   title="삭제 확인"
+ *   message="삭제하려면 'DELETE'를 입력하세요"
+ *   showInput
+ *   inputLabel="확인 입력"
+ *   requiredInputValue="DELETE"
+ *   inputValue={inputValue}
+ *   onInputChange={setInputValue}
+ * />
+ *
+ * @param {ConfirmModalProps} props - ConfirmModal 컴포넌트의 props / ConfirmModal component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} ConfirmModal 컴포넌트 / ConfirmModal component
+ */
+declare const ConfirmModal: React.ForwardRefExoticComponent<ConfirmModalProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Popover 컴포넌트의 props / Popover component props
+ * @typedef {Object} PopoverProps
+ * @property {React.ReactNode} children - Popover 내용 / Popover content
+ * @property {React.ReactNode} trigger - Popover를 열기 위한 트리거 요소 / Trigger element to open popover
+ * @property {boolean} [open] - 제어 모드에서 열림/닫힘 상태 / Open/close state in controlled mode
+ * @property {(open: boolean) => void} [onOpenChange] - 상태 변경 콜백 / State change callback
+ * @property {"top" | "bottom" | "left" | "right"} [position="bottom"] - Popover 표시 위치 / Popover display position
+ * @property {"start" | "center" | "end"} [align="center"] - Popover 정렬 / Popover alignment
+ * @property {number} [offset=8] - 트리거와 Popover 사이 간격 (px) / Spacing between trigger and popover (px)
+ * @property {boolean} [disabled=false] - Popover 비활성화 여부 / Disable popover
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+interface PopoverProps extends React.HTMLAttributes<HTMLDivElement> {
+    children: React.ReactNode;
+    trigger: React.ReactNode;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    position?: "top" | "bottom" | "left" | "right";
+    align?: "start" | "center" | "end";
+    offset?: number;
+    disabled?: boolean;
+    /** Popover 콘텐츠 영역 추가 클래스 / Additional class for popover content area */
+    contentClassName?: string;
+}
+/**
+ * Popover 컴포넌트 / Popover component
+ *
+ * 트리거 요소를 클릭하면 표시되는 팝오버 컴포넌트입니다.
+ * 외부 클릭 시 자동으로 닫힙니다.
+ *
+ * Popover component that appears when the trigger element is clicked.
+ * Automatically closes when clicking outside.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Popover trigger={<Button>열기</Button>}>
+ *   <div className="p-4">Popover 내용</div>
+ * </Popover>
+ *
+ * @example
+ * // 제어 모드 / Controlled mode
+ * const [open, setOpen] = useState(false)
+ * <Popover
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   trigger={<Button>제어 모드</Button>}
+ *   position="top"
+ * >
+ *   <div className="p-4">내용</div>
+ * </Popover>
+ *
+ * @param {PopoverProps} props - Popover 컴포넌트의 props / Popover component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} Popover 컴포넌트 / Popover component
+ */
+declare const Popover: React.ForwardRefExoticComponent<PopoverProps & React.RefAttributes<HTMLDivElement>>;
+declare const PopoverTrigger: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const PopoverContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Dropdown 컴포넌트의 props / Dropdown component props
+ * @typedef {Object} DropdownProps
+ * @property {React.ReactNode} trigger - Dropdown을 열기 위한 트리거 요소 / Trigger element to open dropdown
+ * @property {React.ReactNode} children - Dropdown 내용 / Dropdown content
+ * @property {boolean} [open] - 제어 모드에서 열림/닫힘 상태 / Open/close state in controlled mode
+ * @property {(open: boolean) => void} [onOpenChange] - 상태 변경 콜백 / State change callback
+ * @property {"top" | "bottom" | "left" | "right"} [placement="bottom"] - Dropdown 표시 위치 / Dropdown display position
+ * @property {"start" | "center" | "end"} [align="start"] - Dropdown 정렬 / Dropdown alignment
+ * @property {number} [offset=8] - 트리거와 Dropdown 사이 간격 (px) / Spacing between trigger and dropdown (px)
+ * @property {boolean} [disabled=false] - Dropdown 비활성화 여부 / Disable dropdown
+ * @property {boolean} [showArrow=true] - 화살표 표시 여부 / Show arrow
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+interface DropdownProps extends React.HTMLAttributes<HTMLDivElement> {
+    trigger: React.ReactNode;
+    children: React.ReactNode;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    placement?: "top" | "bottom" | "left" | "right";
+    align?: "start" | "center" | "end";
+    offset?: number;
+    disabled?: boolean;
+    showArrow?: boolean;
+}
+/**
+ * Dropdown 컴포넌트 / Dropdown component
+ *
+ * 트리거 요소를 클릭하면 표시되는 드롭다운 메뉴 컴포넌트입니다.
+ * 외부 클릭 시 자동으로 닫히며, 뷰포트 경계를 자동으로 감지하여 위치를 조정합니다.
+ *
+ * Dropdown menu component that appears when the trigger element is clicked.
+ * Automatically closes on outside click and adjusts position by detecting viewport boundaries.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Dropdown trigger={<Button>메뉴</Button>}>
+ *   <Menu>
+ *     <MenuItem>항목 1</MenuItem>
+ *     <MenuItem>항목 2</MenuItem>
+ *   </Menu>
+ * </Dropdown>
+ *
+ * @example
+ * // 제어 모드, 화살표 없음 / Controlled mode, no arrow
+ * const [open, setOpen] = useState(false)
+ * <Dropdown
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   trigger={<Button>제어 모드</Button>}
+ *   placement="top"
+ *   showArrow={false}
+ * >
+ *   <div className="p-4">내용</div>
+ * </Dropdown>
+ *
+ * @param {DropdownProps} props - Dropdown 컴포넌트의 props / Dropdown component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} Dropdown 컴포넌트 / Dropdown component
+ */
+declare const Dropdown: React.ForwardRefExoticComponent<DropdownProps & React.RefAttributes<HTMLDivElement>>;
+interface DropdownItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    icon?: React.ReactNode;
+    variant?: "default" | "destructive" | "disabled";
+}
+declare const DropdownItem: React.ForwardRefExoticComponent<DropdownItemProps & React.RefAttributes<HTMLButtonElement>>;
+interface DropdownSeparatorProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DropdownSeparator: React.ForwardRefExoticComponent<DropdownSeparatorProps & React.RefAttributes<HTMLDivElement>>;
+interface DropdownLabelProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DropdownLabel: React.ForwardRefExoticComponent<DropdownLabelProps & React.RefAttributes<HTMLDivElement>>;
+declare const DropdownMenu: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const DropdownGroup: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Drawer 컴포넌트의 props / Drawer component props
+ * @typedef {Object} DrawerProps
+ * @property {boolean} open - Drawer 열림/닫힘 상태 / Drawer open/close state
+ * @property {(open: boolean) => void} onOpenChange - 상태 변경 콜백 / State change callback
+ * @property {React.ReactNode} children - Drawer 내용 / Drawer content
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ * @property {"left" | "right" | "top" | "bottom"} [side="right"] - Drawer 표시 위치 / Drawer display position
+ * @property {"sm" | "md" | "lg" | "xl" | "full"} [size="md"] - Drawer 크기 / Drawer size
+ * @property {boolean} [showBackdrop=true] - 배경 오버레이 표시 여부 / Show backdrop overlay
+ * @property {string} [backdropClassName] - 배경 오버레이 추가 CSS 클래스 / Backdrop overlay additional CSS class
+ * @property {boolean} [closeOnBackdropClick=true] - 배경 클릭 시 닫기 여부 / Close on backdrop click
+ * @property {boolean} [closeOnEscape=true] - ESC 키로 닫기 여부 / Close on ESC key
+ */
+interface DrawerProps {
+    /** Drawer 열림/닫힘 상태 / Drawer open/close state */
+    isOpen?: boolean;
+    /** @deprecated use isOpen instead */
+    open?: boolean;
+    /** Drawer 닫기 콜백 / Drawer close callback */
+    onClose?: () => void;
+    /** @deprecated use onClose instead */
+    onOpenChange?: (open: boolean) => void;
+    /** Drawer 내용 / Drawer content */
+    children: React.ReactNode;
+    /** 추가 CSS 클래스 / Additional CSS class */
+    className?: string;
+    /** Drawer 표시 위치 / Drawer display position */
+    side?: "left" | "right" | "top" | "bottom";
+    /** Drawer 크기 / Drawer size */
+    size?: "sm" | "md" | "lg" | "xl" | "full";
+    /** 배경 오버레이 표시 여부 / Show backdrop overlay */
+    showBackdrop?: boolean;
+    /** 배경 오버레이 추가 CSS 클래스 / Backdrop overlay additional CSS class */
+    backdropClassName?: string;
+    /** 배경 클릭 시 닫기 여부 / Close on backdrop click */
+    closeOnBackdropClick?: boolean;
+    /** ESC 키로 닫기 여부 / Close on ESC key */
+    closeOnEscape?: boolean;
+    /** 닫기 버튼 표시 여부 / Show close button */
+    closable?: boolean;
+}
+/**
+ * Drawer 컴포넌트 / Drawer component
+ *
+ * 사이드에서 슬라이드되는 패널 컴포넌트입니다.
+ * Modal과 유사하지만 특정 방향에서 슬라이드되는 애니메이션을 제공합니다.
+ * ESC 키로 닫기, 배경 클릭으로 닫기 기능을 지원합니다.
+ *
+ * Panel component that slides from the side.
+ * Similar to Modal but provides slide animation from a specific direction.
+ * Supports closing with ESC key and backdrop click.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * const [open, setOpen] = useState(false)
+ *
+ * <Drawer open={open} onOpenChange={setOpen}>
+ *   <DrawerHeader>제목</DrawerHeader>
+ *   <DrawerContent>내용</DrawerContent>
+ *   <DrawerFooter>
+ *     <Button onClick={() => setOpen(false)}>닫기</Button>
+ *   </DrawerFooter>
+ * </Drawer>
+ *
+ * @example
+ * // 왼쪽에서 열기 / Open from left
+ * <Drawer open={open} onOpenChange={setOpen} side="left" size="lg">
+ *   <DrawerContent>사이드바 내용</DrawerContent>
+ * </Drawer>
+ *
+ * @param {DrawerProps} props - Drawer 컴포넌트의 props / Drawer component props
+ * @param {React.Ref<HTMLDivElement>} ref - Drawer 컨테이너 ref / Drawer container ref
+ * @returns {JSX.Element} Drawer 컴포넌트 / Drawer component
+ *
+ * @todo 접근성 개선: role="dialog", aria-modal="true" 추가 필요 / Accessibility: Add role="dialog", aria-modal="true"
+ * @todo 접근성 개선: aria-labelledby, aria-describedby 연결 필요 / Accessibility: Connect aria-labelledby, aria-describedby
+ */
+declare const Drawer: React.ForwardRefExoticComponent<DrawerProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DrawerHeader 컴포넌트의 props / DrawerHeader component props
+ * @typedef {Object} DrawerHeaderProps
+ * @property {React.ReactNode} children - 헤더 내용 / Header content
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ * @property {boolean} [showCloseButton=true] - 닫기 버튼 표시 여부 / Show close button
+ * @property {() => void} [onClose] - 닫기 버튼 클릭 콜백 / Close button click callback
+ */
+interface DrawerHeaderProps {
+    children: React.ReactNode;
+    className?: string;
+    showCloseButton?: boolean;
+    onClose?: () => void;
+}
+/**
+ * DrawerHeader 컴포넌트 / DrawerHeader component
+ * Drawer의 헤더 영역을 표시합니다.
+ * Displays the header area of a Drawer.
+ *
+ * @component
+ * @param {DrawerHeaderProps} props - DrawerHeader 컴포넌트의 props / DrawerHeader component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} DrawerHeader 컴포넌트 / DrawerHeader component
+ */
+declare const DrawerHeader: React.ForwardRefExoticComponent<DrawerHeaderProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DrawerContent 컴포넌트의 props / DrawerContent component props
+ * @typedef {Object} DrawerContentProps
+ * @property {React.ReactNode} children - 콘텐츠 / Content
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ */
+interface DrawerContentProps {
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * DrawerContent 컴포넌트 / DrawerContent component
+ * Drawer의 메인 콘텐츠 영역을 표시합니다.
+ * Displays the main content area of a Drawer.
+ *
+ * @component
+ * @param {DrawerContentProps} props - DrawerContent 컴포넌트의 props / DrawerContent component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} DrawerContent 컴포넌트 / DrawerContent component
+ */
+declare const DrawerContent: React.ForwardRefExoticComponent<DrawerContentProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DrawerFooter 컴포넌트의 props / DrawerFooter component props
+ * @typedef {Object} DrawerFooterProps
+ * @property {React.ReactNode} children - 푸터 내용 / Footer content
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ */
+interface DrawerFooterProps {
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * DrawerFooter 컴포넌트 / DrawerFooter component
+ * Drawer의 푸터 영역을 표시합니다. 주로 액션 버튼을 배치합니다.
+ * Displays the footer area of a Drawer. Typically used for action buttons.
+ *
+ * @component
+ * @param {DrawerFooterProps} props - DrawerFooter 컴포넌트의 props / DrawerFooter component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} DrawerFooter 컴포넌트 / DrawerFooter component
+ */
+declare const DrawerFooter: React.ForwardRefExoticComponent<DrawerFooterProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * BottomSheet 컴포넌트의 props / BottomSheet component props
+ * @typedef {Object} BottomSheetProps
+ * @property {boolean} open - BottomSheet 열림/닫힘 상태 / BottomSheet open/close state
+ * @property {(open: boolean) => void} onOpenChange - 상태 변경 콜백 / State change callback
+ * @property {React.ReactNode} children - BottomSheet 내용 / BottomSheet content
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ * @property {"sm" | "md" | "lg" | "xl" | "full"} [height="md"] - BottomSheet 높이 / BottomSheet height
+ * @property {boolean} [showBackdrop=true] - 배경 오버레이 표시 여부 / Show backdrop overlay
+ * @property {string} [backdropClassName] - 배경 오버레이 추가 CSS 클래스 / Backdrop overlay additional CSS class
+ * @property {boolean} [closeOnBackdropClick=true] - 배경 클릭 시 닫기 여부 / Close on backdrop click
+ * @property {boolean} [closeOnEscape=true] - ESC 키로 닫기 여부 / Close on ESC key
+ * @property {boolean} [showDragHandle=true] - 드래그 핸들 표시 여부 / Show drag handle
+ * @property {number[]} [snapPoints=[25, 50, 75, 100]] - 스냅 포인트 (퍼센트) / Snap points (percentage)
+ * @property {number} [defaultSnap=50] - 기본 스냅 포인트 (퍼센트) / Default snap point (percentage)
+ */
+interface BottomSheetProps {
+    /** BottomSheet 열림/닫힘 상태 / BottomSheet open/close state */
+    isOpen?: boolean;
+    /** @deprecated use isOpen instead */
+    open?: boolean;
+    /** BottomSheet 닫기 콜백 / BottomSheet close callback */
+    onClose?: () => void;
+    /** @deprecated use onClose instead */
+    onOpenChange?: (open: boolean) => void;
+    /** BottomSheet 내용 / BottomSheet content */
+    children: React.ReactNode;
+    /** 추가 CSS 클래스 / Additional CSS class */
+    className?: string;
+    /** BottomSheet 높이 / BottomSheet height */
+    height?: "sm" | "md" | "lg" | "xl" | "full";
+    /** 배경 오버레이 표시 여부 / Show backdrop overlay */
+    showBackdrop?: boolean;
+    /** 배경 오버레이 추가 CSS 클래스 / Backdrop overlay additional CSS class */
+    backdropClassName?: string;
+    /** 배경 클릭 시 닫기 여부 / Close on backdrop click */
+    closeOnBackdropClick?: boolean;
+    /** ESC 키로 닫기 여부 / Close on ESC key */
+    closeOnEscape?: boolean;
+    /** 드래그 핸들 표시 여부 / Show drag handle */
+    showDragHandle?: boolean;
+    /** 닫기 버튼 표시 여부 / Show close button */
+    closable?: boolean;
+    /** 스냅 포인트 (퍼센트) / Snap points (percentage) */
+    snapPoints?: number[];
+    /** 기본 스냅 포인트 (퍼센트) / Default snap point (percentage) */
+    defaultSnap?: number;
+}
+/**
+ * BottomSheet 컴포넌트 / BottomSheet component
+ *
+ * 화면 하단에서 올라오는 시트 컴포넌트입니다.
+ * 모바일 친화적인 UI를 제공하며, 드래그로 높이를 조절할 수 있습니다.
+ * 스냅 포인트를 지원하여 특정 높이에서 멈출 수 있습니다.
+ *
+ * Sheet component that slides up from the bottom of the screen.
+ * Provides mobile-friendly UI and allows height adjustment by dragging.
+ * Supports snap points to stop at specific heights.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * const [open, setOpen] = useState(false)
+ *
+ * <BottomSheet open={open} onOpenChange={setOpen}>
+ *   <BottomSheetHeader>제목</BottomSheetHeader>
+ *   <BottomSheetContent>내용</BottomSheetContent>
+ * </BottomSheet>
+ *
+ * @example
+ * // 커스텀 스냅 포인트 / Custom snap points
+ * <BottomSheet
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   snapPoints={[30, 60, 90]}
+ *   defaultSnap={30}
+ * >
+ *   <BottomSheetContent>내용</BottomSheetContent>
+ * </BottomSheet>
+ *
+ * @param {BottomSheetProps} props - BottomSheet 컴포넌트의 props / BottomSheet component props
+ * @param {React.Ref<HTMLDivElement>} ref - BottomSheet 컨테이너 ref / BottomSheet container ref
+ * @returns {JSX.Element} BottomSheet 컴포넌트 / BottomSheet component
+ *
+ * @todo 접근성 개선: role="dialog", aria-modal="true" 추가 필요 / Accessibility: Add role="dialog", aria-modal="true"
+ * @todo 접근성 개선: aria-labelledby, aria-describedby 연결 필요 / Accessibility: Connect aria-labelledby, aria-describedby
+ */
+declare const BottomSheet: React.ForwardRefExoticComponent<BottomSheetProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * BottomSheetHeader 컴포넌트의 props / BottomSheetHeader component props
+ * @typedef {Object} BottomSheetHeaderProps
+ * @property {React.ReactNode} children - 헤더 내용 / Header content
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ * @property {boolean} [showCloseButton=true] - 닫기 버튼 표시 여부 / Show close button
+ * @property {() => void} [onClose] - 닫기 버튼 클릭 콜백 / Close button click callback
+ */
+interface BottomSheetHeaderProps {
+    children: React.ReactNode;
+    className?: string;
+    showCloseButton?: boolean;
+    onClose?: () => void;
+}
+/**
+ * BottomSheetHeader 컴포넌트 / BottomSheetHeader component
+ * BottomSheet의 헤더 영역을 표시합니다.
+ * Displays the header area of a BottomSheet.
+ *
+ * @component
+ * @param {BottomSheetHeaderProps} props - BottomSheetHeader 컴포넌트의 props / BottomSheetHeader component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} BottomSheetHeader 컴포넌트 / BottomSheetHeader component
+ */
+declare const BottomSheetHeader: React.ForwardRefExoticComponent<BottomSheetHeaderProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * BottomSheetContent 컴포넌트의 props / BottomSheetContent component props
+ * @typedef {Object} BottomSheetContentProps
+ * @property {React.ReactNode} children - 콘텐츠 / Content
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ */
+interface BottomSheetContentProps {
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * BottomSheetContent 컴포넌트 / BottomSheetContent component
+ * BottomSheet의 메인 콘텐츠 영역을 표시합니다.
+ * Displays the main content area of a BottomSheet.
+ *
+ * @component
+ * @param {BottomSheetContentProps} props - BottomSheetContent 컴포넌트의 props / BottomSheetContent component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} BottomSheetContent 컴포넌트 / BottomSheetContent component
+ */
+declare const BottomSheetContent: React.ForwardRefExoticComponent<BottomSheetContentProps & React.RefAttributes<HTMLDivElement>>;
+
+export { BottomSheet, BottomSheetContent, BottomSheetHeader, ConfirmModal, Drawer, DrawerContent, DrawerFooter, DrawerHeader, Dropdown, DropdownGroup, DropdownItem, DropdownLabel, DropdownMenu, DropdownSeparator, Popover, PopoverContent, PopoverTrigger };

package/dist/overlay.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Overlay Components Entrypoint
+ *
+ * 오버레이/팝업 관련 컴포넌트들의 엔트리 포인트입니다.
+ * 모달, 팝오버, 드롭다운, 드로어, 바텀시트 등 합성 컴포넌트를 포함합니다.
+ *
+ * Entry point for overlay/popup components.
+ * Includes composite components like Modal, Popover, Dropdown, Drawer, BottomSheet.
+ *
+ * @example
+ * import { Popover, PopoverTrigger, PopoverContent } from '@hua-labs/ui/overlay';
+ * import { Dropdown, DropdownItem } from '@hua-labs/ui/overlay';
+ */
+export { Modal } from './components/Modal';
+export type { ModalProps } from './components/Modal';
+export { ConfirmModal } from './components/ConfirmModal';
+export { Popover, PopoverTrigger, PopoverContent } from './components/Popover';
+export { Dropdown, DropdownItem, DropdownSeparator, DropdownLabel, DropdownMenu, DropdownGroup } from './components/Dropdown';
+export { Drawer, DrawerHeader, DrawerContent, DrawerFooter } from './components/Drawer';
+export { BottomSheet, BottomSheetHeader, BottomSheetContent } from './components/BottomSheet';
+//# sourceMappingURL=overlay.d.ts.map

package/dist/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG9H,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}