@hua-labs/ui 1.0.0 → 1.1.0-alpha.0.2

package/dist/components/ConfirmModal.d.ts

@@ -1,4 +1,28 @@
-import * as React from "react";
+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
+ */
 export interface ConfirmModalProps {
     isOpen: boolean;
     onClose: () => void;
@@ -21,6 +45,47 @@ export interface ConfirmModalProps {
     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>>;
 export { ConfirmModal };
 //# sourceMappingURL=ConfirmModal.d.ts.map

package/dist/components/ConfirmModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfirmModal.d.ts","sourceRoot":"","sources":["../../src/components/ConfirmModal.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAA;CACzC;AAED,QAAA,MAAM,YAAY,0FAkLjB,CAAA;AAGD,OAAO,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"ConfirmModal.d.ts","sourceRoot":"","sources":["../../src/components/ConfirmModal.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,QAAA,MAAM,YAAY,0FAiLjB,CAAA;AAGD,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/components/Container.d.ts

@@ -1,10 +1,49 @@
 import React from "react";
+/**
+ * Container 컴포넌트의 props
+ * @typedef {Object} ContainerProps
+ * @property {"sm" | "md" | "lg" | "xl" | "full"} [size="lg"] - 컨테이너 최대 너비
+ * @property {"none" | "sm" | "md" | "lg" | "xl"} [padding="md"] - 내부 패딩 크기
+ * @property {boolean} [centered=true] - 컨테이너를 중앙 정렬할지 여부
+ * @property {boolean} [fluid=false] - 최대 너비 제한 없이 전체 너비 사용
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface ContainerProps extends React.HTMLAttributes<HTMLDivElement> {
     size?: "sm" | "md" | "lg" | "xl" | "full";
     padding?: "none" | "sm" | "md" | "lg" | "xl";
     centered?: boolean;
     fluid?: boolean;
 }
+/**
+ * Container 컴포넌트
+ *
+ * 콘텐츠를 감싸는 컨테이너 컴포넌트입니다.
+ * 반응형 최대 너비와 패딩을 제공하여 일관된 레이아웃을 구성합니다.
+ *
+ * @component
+ * @example
+ * // 기본 사용
+ * <Container>
+ *   <h1>제목</h1>
+ *   <p>내용</p>
+ * </Container>
+ *
+ * @example
+ * // 작은 크기, 패딩 없음
+ * <Container size="sm" padding="none">
+ *   <div>콘텐츠</div>
+ * </Container>
+ *
+ * @example
+ * // 전체 너비 사용
+ * <Container fluid padding="xl">
+ *   <div>전체 너비 콘텐츠</div>
+ * </Container>
+ *
+ * @param {ContainerProps} props - Container 컴포넌트의 props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref
+ * @returns {JSX.Element} Container 컴포넌트
+ */
 declare const Container: React.ForwardRefExoticComponent<ContainerProps & React.RefAttributes<HTMLDivElement>>;
 export { Container };
 //# sourceMappingURL=Container.d.ts.map

package/dist/components/Container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/components/Container.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC1E,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IACzC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,QAAA,MAAM,SAAS,uFAuCd,CAAA;AAGD,OAAO,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/components/Container.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC1E,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IACzC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,QAAA,MAAM,SAAS,uFAyCd,CAAA;AAGD,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/dist/components/ContextMenu.d.ts

@@ -1,4 +1,17 @@
-import * as React from "react";
+import React from "react";
+/**
+ * ContextMenu 컴포넌트의 props / ContextMenu component props
+ * @typedef {Object} ContextMenuProps
+ * @property {React.ReactNode} children - ContextMenu 내용 / ContextMenu content
+ * @property {boolean} [open] - 제어 모드에서 열림/닫힘 상태 / Open/close state in controlled mode
+ * @property {(open: boolean) => void} [onOpenChange] - 상태 변경 콜백 / State change callback
+ * @property {React.ReactNode} [trigger] - ContextMenu를 열기 위한 트리거 요소 (우클릭 이벤트) / Trigger element to open context menu (right-click event)
+ * @property {"top" | "bottom" | "left" | "right"} [placement="bottom"] - ContextMenu 표시 위치 / ContextMenu display position
+ * @property {"start" | "center" | "end"} [align="start"] - ContextMenu 정렬 / ContextMenu alignment
+ * @property {number} [offset=8] - 트리거와 ContextMenu 사이 간격 (px) / Spacing between trigger and context menu (px)
+ * @property {boolean} [disabled=false] - ContextMenu 비활성화 여부 / Disable context menu
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface ContextMenuProps extends React.HTMLAttributes<HTMLDivElement> {
     children: React.ReactNode;
     open?: boolean;
@@ -9,6 +22,43 @@ export interface ContextMenuProps extends React.HTMLAttributes<HTMLDivElement> {
     offset?: number;
     disabled?: boolean;
 }
+/**
+ * ContextMenu 컴포넌트 / ContextMenu component
+ *
+ * 우클릭 시 표시되는 컨텍스트 메뉴 컴포넌트입니다.
+ * 트리거 요소에 우클릭 이벤트를 자동으로 연결합니다.
+ *
+ * Context menu component that appears on right-click.
+ * Automatically connects right-click events to the trigger element.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <ContextMenu trigger={<div>우클릭하세요</div>}>
+ *   <div className="p-2">
+ *     <button>항목 1</button>
+ *     <button>항목 2</button>
+ *   </div>
+ * </ContextMenu>
+ *
+ * @example
+ * // 제어 모드 / Controlled mode
+ * const [open, setOpen] = useState(false)
+ * <ContextMenu
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   trigger={<div>우클릭</div>}
+ * >
+ *   <Menu>
+ *     <MenuItem>복사</MenuItem>
+ *     <MenuItem>삭제</MenuItem>
+ *   </Menu>
+ * </ContextMenu>
+ *
+ * @param {ContextMenuProps} props - ContextMenu 컴포넌트의 props / ContextMenu component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} ContextMenu 컴포넌트 / ContextMenu component
+ */
 declare const ContextMenu: React.ForwardRefExoticComponent<ContextMenuProps & React.RefAttributes<HTMLDivElement>>;
 export interface ContextMenuItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     icon?: React.ReactNode;

package/dist/components/ContextMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextMenu.d.ts","sourceRoot":"","sources":["../../src/components/ContextMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IAC/C,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,QAAA,MAAM,WAAW,yFAmIhB,CAAA;AAGD,MAAM,WAAW,oBAAqB,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACzF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAA;CACjD;AAED,QAAA,MAAM,eAAe,gGAwCpB,CAAA;AAGD,MAAM,WAAW,yBAA0B,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;CAAG;AAE1F,QAAA,MAAM,oBAAoB,kGAQzB,CAAA;AAGD,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;CAAG;AAEtF,QAAA,MAAM,gBAAgB,8FAUrB,CAAA;AAID,QAAA,MAAM,gBAAgB,6GAUrB,CAAA;AAGD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"ContextMenu.d.ts","sourceRoot":"","sources":["../../src/components/ContextMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IAC/C,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,QAAA,MAAM,WAAW,yFAmIhB,CAAA;AAGD,MAAM,WAAW,oBAAqB,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACzF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAA;CACjD;AAED,QAAA,MAAM,eAAe,gGAwCpB,CAAA;AAGD,MAAM,WAAW,yBAA0B,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;CAAG;AAE1F,QAAA,MAAM,oBAAoB,kGAQzB,CAAA;AAGD,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;CAAG;AAEtF,QAAA,MAAM,gBAAgB,8FAUrB,CAAA;AAID,QAAA,MAAM,gBAAgB,6GAUrB,CAAA;AAGD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/components/DatePicker.d.ts

@@ -0,0 +1,62 @@
+import React from "react";
+/**
+ * DatePicker 컴포넌트의 props / DatePicker component props
+ * @typedef {Object} DatePickerProps
+ * @property {Date | null} [value] - 선택된 날짜 / Selected date
+ * @property {(date: Date | null) => void} [onChange] - 날짜 변경 핸들러 / Date change handler
+ * @property {Date} [minDate] - 최소 날짜 / Minimum date
+ * @property {Date} [maxDate] - 최대 날짜 / Maximum date
+ * @property {string} [placeholder="날짜를 선택하세요"] - 플레이스홀더 / Placeholder
+ * @property {boolean} [disabled=false] - 비활성화 상태 / Disabled state
+ * @property {boolean} [error=false] - 에러 상태 / Error state
+ * @property {string} [dateFormat="YYYY-MM-DD"] - 날짜 포맷 / Date format
+ * @property {string} [locale="ko-KR"] - 로케일 / Locale
+ * @property {"sm" | "md" | "lg"} [size="md"] - 크기 / Size
+ * @property {string} [className] - 추가 클래스명 / Additional class name
+ * @extends {Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>}
+ */
+export interface DatePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    value?: Date | null;
+    onChange?: (date: Date | null) => void;
+    minDate?: Date;
+    maxDate?: Date;
+    placeholder?: string;
+    disabled?: boolean;
+    error?: boolean;
+    dateFormat?: string;
+    locale?: string;
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+/**
+ * DatePicker 컴포넌트 / DatePicker component
+ *
+ * 날짜를 선택할 수 있는 컴포넌트입니다.
+ * 캘린더 팝오버를 통해 직관적으로 날짜를 선택할 수 있습니다.
+ *
+ * Component for selecting dates.
+ * Allows intuitive date selection through a calendar popover.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <DatePicker
+ *   value={selectedDate}
+ *   onChange={setSelectedDate}
+ * />
+ *
+ * @example
+ * // 날짜 범위 제한 / Date range restriction
+ * <DatePicker
+ *   value={date}
+ *   onChange={setDate}
+ *   minDate={new Date("2024-01-01")}
+ *   maxDate={new Date("2024-12-31")}
+ *   placeholder="날짜 선택"
+ * />
+ *
+ * @param {DatePickerProps} props - DatePicker 컴포넌트의 props / DatePicker component props
+ * @returns {JSX.Element} DatePicker 컴포넌트 / DatePicker component
+ */
+export declare const DatePicker: React.ForwardRefExoticComponent<DatePickerProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=DatePicker.d.ts.map

package/dist/components/DatePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../src/components/DatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IAC7F,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAA;IACtC,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,UAAU,wFAuOtB,CAAA"}

package/dist/components/Divider.d.ts

@@ -1,11 +1,21 @@
-import * as React from "react";
+import React from "react";
+/**
+ * Divider 컴포넌트의 props / Divider component props
+ * @typedef {Object} DividerProps
+ * @property {"horizontal" | "vertical"} [orientation="horizontal"] - Divider 방향 / Divider orientation
+ * @property {"solid" | "dashed" | "dotted" | "gradient" | "glass"} [variant="solid"] - Divider 스타일 변형 / Divider style variant
+ * @property {"sm" | "md" | "lg"} [size="md"] - Divider 크기 / Divider size
+ * @property {"none" | "sm" | "md" | "lg" | "xl"} [spacing="md"] - Divider 주변 여백 / Divider spacing
+ * @property {"default" | "muted" | "primary" | "secondary"} [color="default"] - Divider 색상 / Divider color
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface DividerProps extends React.HTMLAttributes<HTMLDivElement> {
     orientation?: "horizontal" | "vertical";
-    variant?: "solid" | "dashed" | "dotted" | "gradient";
+    variant?: "solid" | "dashed" | "dotted" | "gradient" | "glass";
     size?: "sm" | "md" | "lg";
     spacing?: "none" | "sm" | "md" | "lg" | "xl";
     color?: "default" | "muted" | "primary" | "secondary";
 }
-declare const Divider: React.ForwardRefExoticComponent<DividerProps & React.RefAttributes<HTMLDivElement>>;
+declare const Divider: React.NamedExoticComponent<DividerProps & React.RefAttributes<HTMLDivElement>>;
 export { Divider };
 //# sourceMappingURL=Divider.d.ts.map

package/dist/components/Divider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Divider.d.ts","sourceRoot":"","sources":["../../src/components/Divider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAA;IACpD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAC5C,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAA;CACtD;AAED,QAAA,MAAM,OAAO,qFA6DZ,CAAA;AAGD,OAAO,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"Divider.d.ts","sourceRoot":"","sources":["../../src/components/Divider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;IAC9D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAC5C,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAA;CACtD;AAqGD,QAAA,MAAM,OAAO,gFAA+B,CAAA;AAE5C,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/dist/components/Drawer.d.ts

@@ -1,4 +1,18 @@
-import * as React from "react";
+import React from "react";
+/**
+ * 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 {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -7,26 +21,114 @@ interface DrawerProps {
     side?: "left" | "right" | "top" | "bottom";
     size?: "sm" | "md" | "lg" | "xl" | "full";
     showBackdrop?: boolean;
+    backdropClassName?: string;
     closeOnBackdropClick?: boolean;
     closeOnEscape?: 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>>;
 export { Drawer, DrawerHeader, DrawerContent, DrawerFooter };
 //# sourceMappingURL=Drawer.d.ts.map

package/dist/components/Drawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Drawer.d.ts","sourceRoot":"","sources":["../../src/components/Drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,UAAU,WAAW;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC1C,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IACzC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,QAAA,MAAM,MAAM,oFA2GX,CAAA;AAGD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,QAAA,MAAM,YAAY,0FAoBjB,CAAA;AAGD,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,QAAA,MAAM,aAAa,2FAYlB,CAAA;AAGD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,QAAA,MAAM,YAAY,0FAYjB,CAAA;AAGD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"Drawer.d.ts","sourceRoot":"","sources":["../../src/components/Drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB;;;;;;;;;;;;;GAaG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC1C,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IACzC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,QAAA,MAAM,MAAM,oFA6GX,CAAA;AAGD;;;;;;;GAOG;AACH,UAAU,iBAAiB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,YAAY,0FAoBjB,CAAA;AAGD;;;;;GAKG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,aAAa,2FAYlB,CAAA;AAGD;;;;;GAKG;AACH,UAAU,iBAAiB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,YAAY,0FAYjB,CAAA;AAGD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA"}

package/dist/components/Dropdown.d.ts

@@ -1,4 +1,18 @@
-import * as React from "react";
+import React from "react";
+/**
+ * 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>}
+ */
 export interface DropdownProps extends React.HTMLAttributes<HTMLDivElement> {
     trigger: React.ReactNode;
     children: React.ReactNode;
@@ -10,6 +24,42 @@ export interface DropdownProps extends React.HTMLAttributes<HTMLDivElement> {
     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>>;
 export interface DropdownItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     icon?: React.ReactNode;

package/dist/components/Dropdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dropdown.d.ts","sourceRoot":"","sources":["../../src/components/Dropdown.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IAC/C,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,QAAA,MAAM,QAAQ,sFA+Mb,CAAA;AAID,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACtF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAA;CACjD;AAED,QAAA,MAAM,YAAY,6FAwCjB,CAAA;AAGD,MAAM,WAAW,sBAAuB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;CAAG;AAEvF,QAAA,MAAM,iBAAiB,+FAQtB,CAAA;AAGD,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;CAAG;AAEnF,QAAA,MAAM,aAAa,2FAUlB,CAAA;AAID,QAAA,MAAM,YAAY,6GAUjB,CAAA;AAGD,QAAA,MAAM,aAAa,6GAUlB,CAAA;AAGD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA"}
+{"version":3,"file":"Dropdown.d.ts","sourceRoot":"","sources":["../../src/components/Dropdown.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IAC/C,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,QAAA,MAAM,QAAQ,sFA+Mb,CAAA;AAID,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACtF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAA;CACjD;AAED,QAAA,MAAM,YAAY,6FAwCjB,CAAA;AAGD,MAAM,WAAW,sBAAuB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;CAAG;AAEvF,QAAA,MAAM,iBAAiB,+FAQtB,CAAA;AAGD,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;CAAG;AAEnF,QAAA,MAAM,aAAa,2FAUlB,CAAA;AAID,QAAA,MAAM,YAAY,6GAUjB,CAAA;AAGD,QAAA,MAAM,aAAa,6GAUlB,CAAA;AAGD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA"}

package/dist/components/EmotionAnalysis.d.ts

@@ -1,4 +1,26 @@
-import * as React from "react";
+import React from "react";
+/**
+ * EmotionAnalysis 컴포넌트의 props / EmotionAnalysis component props
+ * @typedef {Object} EmotionAnalysisProps
+ * @property {Object} [primaryEmotion] - 주요 감정 정보 / Primary emotion information
+ * @property {string} primaryEmotion.name - 감정 이름 / Emotion name
+ * @property {number} primaryEmotion.intensity - 감정 강도 (0-100) / Emotion intensity (0-100)
+ * @property {string} [primaryEmotion.color] - 감정 색상 / Emotion color
+ * @property {Array<Object>} [emotionDistribution] - 감정 분포 배열 / Emotion distribution array
+ * @property {string} emotionDistribution[].emotion - 감정 이름 / Emotion name
+ * @property {number} emotionDistribution[].percentage - 감정 비율 (0-100) / Emotion percentage (0-100)
+ * @property {string} emotionDistribution[].color - 감정 색상 / Emotion color
+ * @property {string[]} [keywords] - 키워드 배열 / Keywords array
+ * @property {number} [intensity=50] - 전체 강도 (0-100) / Overall intensity (0-100)
+ * @property {number} [positivity=70] - 긍정성 (0-100) / Positivity (0-100)
+ * @property {number} [energy=60] - 에너지 (0-100) / Energy (0-100)
+ * @property {boolean} [showMeter=true] - 강도 미터 표시 여부 / Show intensity meter
+ * @property {boolean} [showDistribution=true] - 분포 표시 여부 / Show distribution
+ * @property {boolean} [showKeywords=true] - 키워드 표시 여부 / Show keywords
+ * @property {boolean} [showMetrics=true] - 메트릭 표시 여부 / Show metrics
+ * @property {"compact" | "detailed" | "card"} [layout="detailed"] - 레이아웃 타입 / Layout type
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 interface EmotionAnalysisProps extends React.HTMLAttributes<HTMLDivElement> {
     primaryEmotion?: {
         name: string;
@@ -20,6 +42,42 @@ interface EmotionAnalysisProps extends React.HTMLAttributes<HTMLDivElement> {
     showMetrics?: boolean;
     layout?: "compact" | "detailed" | "card";
 }
+/**
+ * EmotionAnalysis 컴포넌트 / EmotionAnalysis component
+ *
+ * 감정 분석 결과를 표시하는 컴포넌트입니다.
+ * 주요 감정, 감정 분포, 키워드, 메트릭(강도, 긍정성, 에너지)을 표시할 수 있습니다.
+ *
+ * Component that displays emotion analysis results.
+ * Can display primary emotion, emotion distribution, keywords, and metrics (intensity, positivity, energy).
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <EmotionAnalysis
+ *   primaryEmotion={{ name: "기쁨", intensity: 80 }}
+ *   keywords={["행복", "만족"]}
+ * />
+ *
+ * @example
+ * // 상세 레이아웃 / Detailed layout
+ * <EmotionAnalysis
+ *   primaryEmotion={{ name: "평온", intensity: 65, color: "green" }}
+ *   emotionDistribution={[
+ *     { emotion: "기쁨", percentage: 40, color: "yellow" },
+ *     { emotion: "평온", percentage: 60, color: "green" }
+ *   ]}
+ *   keywords={["안정", "편안"]}
+ *   intensity={65}
+ *   positivity={75}
+ *   energy={50}
+ *   layout="detailed"
+ * />
+ *
+ * @param {EmotionAnalysisProps} props - EmotionAnalysis 컴포넌트의 props / EmotionAnalysis component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} EmotionAnalysis 컴포넌트 / EmotionAnalysis component
+ */
 declare const EmotionAnalysis: React.ForwardRefExoticComponent<EmotionAnalysisProps & React.RefAttributes<HTMLDivElement>>;
 export { EmotionAnalysis };
 //# sourceMappingURL=EmotionAnalysis.d.ts.map

package/dist/components/EmotionAnalysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmotionAnalysis.d.ts","sourceRoot":"","sources":["../../src/components/EmotionAnalysis.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,UAAU,oBAAqB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,mBAAmB,CAAC,EAAE,KAAK,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,KAAK,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;CACzC;AAED,QAAA,MAAM,eAAe,6FAgSpB,CAAA;AAID,OAAO,EAAE,eAAe,EAAE,CAAA"}
+{"version":3,"file":"EmotionAnalysis.d.ts","sourceRoot":"","sources":["../../src/components/EmotionAnalysis.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,UAAU,oBAAqB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,mBAAmB,CAAC,EAAE,KAAK,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,KAAK,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,QAAA,MAAM,eAAe,6FAgSpB,CAAA;AAID,OAAO,EAAE,eAAe,EAAE,CAAA"}