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

package/dist/components/Input.d.ts

@@ -1,12 +1,44 @@
-import * as React from "react";
-export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'> {
-    variant?: "default" | "outline" | "filled" | "ghost";
-    size?: "sm" | "md" | "lg";
-    error?: boolean;
-    success?: boolean;
-    leftIcon?: React.ReactNode;
-    rightIcon?: React.ReactNode;
+import React from "react";
+/**
+ * Input 컴포넌트의 props / Input component props
+ * HTML input 요소의 모든 표준 속성을 상속받습니다.
+ * Inherits all standard attributes of HTML input element.
+ * @typedef {Object} InputProps
+ * @extends {React.InputHTMLAttributes<HTMLInputElement>}
+ */
+export interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
 }
+/**
+ * Input 컴포넌트 / Input component
+ *
+ * 표준 HTML input 요소를 래핑한 스타일링된 입력 필드 컴포넌트입니다.
+ * 접근성 속성(aria-invalid)을 자동으로 처리합니다.
+ *
+ * Styled input field component wrapping standard HTML input element.
+ * Automatically handles accessibility attributes (aria-invalid).
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Input type="text" placeholder="이름을 입력하세요" />
+ *
+ * @example
+ * // 에러 상태 / Error state
+ * <Input
+ *   type="email"
+ *   placeholder="이메일"
+ *   aria-invalid={true}
+ * />
+ *
+ * @example
+ * // ref 사용 / Using ref
+ * const inputRef = useRef<HTMLInputElement>(null)
+ * <Input ref={inputRef} type="text" />
+ *
+ * @param {InputProps} props - Input 컴포넌트의 props / Input component props
+ * @param {React.Ref<HTMLInputElement>} ref - input 요소 ref / input element ref
+ * @returns {JSX.Element} Input 컴포넌트 / Input component
+ */
 declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
 export { Input };
 //# sourceMappingURL=Input.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../src/components/Input.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC3F,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;IACpD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B;AAED,QAAA,MAAM,KAAK,qFA4DV,CAAA;AAGD,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../src/components/Input.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;GAMG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC;CAAG;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,QAAA,MAAM,KAAK,qFAoBV,CAAA;AAGD,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/components/Label.d.ts

@@ -0,0 +1,50 @@
+import React from "react";
+/**
+ * Label 컴포넌트의 props / Label component props
+ * @typedef {Object} LabelProps
+ * @property {boolean} [required=false] - 필수 필드 여부 / Required field indicator
+ * @property {boolean} [error=false] - 에러 상태 표시 / Error state
+ * @property {boolean} [disabled=false] - 비활성화 상태 / Disabled state
+ * @property {"default" | "glass"} [variant="default"] - Label 스타일 변형 / Label style variant
+ * @extends {React.LabelHTMLAttributes<HTMLLabelElement>}
+ */
+export interface LabelProps extends React.LabelHTMLAttributes<HTMLLabelElement> {
+    required?: boolean;
+    error?: boolean;
+    disabled?: boolean;
+    variant?: "default" | "glass";
+}
+/**
+ * Label 컴포넌트 / Label component
+ *
+ * 폼 필드의 레이블을 표시하는 컴포넌트입니다.
+ * 필수 필드 표시와 에러 상태를 지원합니다.
+ *
+ * Component for displaying form field labels.
+ * Supports required field indicator and error state.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Label htmlFor="email">이메일</Label>
+ * <Input id="email" />
+ *
+ * @example
+ * // 필수 필드 / Required field
+ * <Label required htmlFor="name">이름</Label>
+ * <Input id="name" required />
+ *
+ * @example
+ * // 에러 상태 / Error state
+ * <Label error htmlFor="password">비밀번호</Label>
+ * <Input id="password" aria-invalid />
+ *
+ * @param {LabelProps} props - Label 컴포넌트의 props / Label component props
+ * @param {React.Ref<HTMLLabelElement>} ref - label 요소 ref / label element ref
+ * @returns {JSX.Element} Label 컴포넌트 / Label component
+ *
+ * @todo 접근성 개선: required일 때 aria-required="true" 추가 필요 / Accessibility improvement: add aria-required="true" when required
+ */
+declare const Label: React.ForwardRefExoticComponent<LabelProps & React.RefAttributes<HTMLLabelElement>>;
+export { Label };
+//# sourceMappingURL=Label.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Label.d.ts","sourceRoot":"","sources":["../../src/components/Label.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,QAAA,MAAM,KAAK,qFAuCV,CAAA;AAGD,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/components/LanguageToggle.d.ts

@@ -1,4 +1,18 @@
-import * as React from "react";
+import React from "react";
+/**
+ * LanguageToggle 컴포넌트의 props / LanguageToggle component props
+ * @typedef {Object} LanguageToggleProps
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ * @property {"sm" | "md" | "lg"} [size="md"] - Toggle 크기 / Toggle size
+ * @property {"button" | "icon" | "dropdown"} [variant="button"] - Toggle 스타일 변형 / Toggle style variant
+ * @property {boolean} [showLabel=false] - 라벨 표시 여부 / Show label
+ * @property {Array<Object>} [languages] - 언어 목록 / Language list
+ * @property {string} languages[].code - 언어 코드 / Language code
+ * @property {string} languages[].name - 언어 이름 / Language name
+ * @property {string} [languages[].flag] - 언어 플래그 이모지 / Language flag emoji
+ * @property {string} [currentLanguage="ko"] - 현재 선택된 언어 코드 / Currently selected language code
+ * @property {(language: string) => void} [onLanguageChange] - 언어 변경 콜백 / Language change callback
+ */
 export interface LanguageToggleProps {
     className?: string;
     size?: "sm" | "md" | "lg";
@@ -12,6 +26,32 @@ export interface LanguageToggleProps {
     currentLanguage?: string;
     onLanguageChange?: (language: string) => void;
 }
+/**
+ * LanguageToggle 컴포넌트 / LanguageToggle component
+ *
+ * 언어를 전환하는 토글 컴포넌트입니다.
+ * 여러 언어를 지원하며, 버튼, 아이콘, 드롭다운 형태로 표시할 수 있습니다.
+ *
+ * Toggle component for switching languages.
+ * Supports multiple languages and can be displayed as button, icon, or dropdown.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <LanguageToggle />
+ *
+ * @example
+ * // 드롭다운 형태 / Dropdown variant
+ * <LanguageToggle
+ *   variant="dropdown"
+ *   currentLanguage="en"
+ *   onLanguageChange={(lang) => console.log(lang)}
+ * />
+ *
+ * @param {LanguageToggleProps} props - LanguageToggle 컴포넌트의 props / LanguageToggle component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} LanguageToggle 컴포넌트 / LanguageToggle component
+ */
 declare const LanguageToggle: React.ForwardRefExoticComponent<LanguageToggleProps & React.RefAttributes<HTMLDivElement>>;
 export { LanguageToggle };
 //# sourceMappingURL=LanguageToggle.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"LanguageToggle.d.ts","sourceRoot":"","sources":["../../src/components/LanguageToggle.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;IACF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9C;AAED,QAAA,MAAM,cAAc,4FAmKnB,CAAA;AAGD,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"LanguageToggle.d.ts","sourceRoot":"","sources":["../../src/components/LanguageToggle.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;IACF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,QAAA,MAAM,cAAc,4FAmKnB,CAAA;AAGD,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/components/Link.d.ts

@@ -0,0 +1,52 @@
+import React from "react";
+/**
+ * Link 컴포넌트의 props / Link component props
+ * @typedef {Object} LinkProps
+ * @property {string} href - 링크 URL / Link URL
+ * @property {React.ReactNode} children - 링크 텍스트 또는 내용 / Link text or content
+ * @property {"default" | "primary" | "secondary" | "ghost" | "underline"} [variant="default"] - Link 스타일 변형 / Link style variant
+ * @property {"sm" | "md" | "lg"} [size="md"] - Link 크기 / Link size
+ * @property {boolean} [external=false] - 외부 링크 여부 (target="_blank" 자동 설정) / External link (auto sets target="_blank")
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ * @property {() => void} [onClick] - 클릭 이벤트 핸들러 / Click event handler
+ */
+export interface LinkProps {
+    href: string;
+    children: React.ReactNode;
+    variant?: "default" | "primary" | "secondary" | "ghost" | "underline";
+    size?: "sm" | "md" | "lg";
+    external?: boolean;
+    className?: string;
+    onClick?: () => void;
+}
+/**
+ * Link 컴포넌트 / Link component
+ *
+ * 링크를 표시하는 컴포넌트입니다.
+ * 외부 링크의 경우 자동으로 `target="_blank"`와 `rel="noopener noreferrer"`를 설정합니다.
+ *
+ * Link component for displaying links.
+ * Automatically sets `target="_blank"` and `rel="noopener noreferrer"` for external links.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Link href="/about">소개</Link>
+ *
+ * @example
+ * // 외부 링크 / External link
+ * <Link href="https://example.com" external>
+ *   외부 사이트
+ * </Link>
+ *
+ * @example
+ * // Primary 스타일 / Primary style
+ * <Link href="/contact" variant="primary" size="lg">
+ *   문의하기
+ * </Link>
+ *
+ * @param {LinkProps} props - Link 컴포넌트의 props / Link component props
+ * @returns {JSX.Element} Link 컴포넌트 / Link component
+ */
+export declare function Link({ href, children, className, variant, size, external, onClick }: LinkProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAA;IACrE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,OAAmB,EACnB,IAAW,EACX,QAAgB,EAChB,OAAO,EACR,EAAE,SAAS,2CA+BX"}

package/dist/components/LoadingSpinner.d.ts

@@ -1,10 +1,49 @@
-import * as React from "react";
-export interface LoadingSpinnerProps extends React.HTMLAttributes<HTMLDivElement> {
+/**
+ * LoadingSpinner 컴포넌트의 props / LoadingSpinner component props
+ * @typedef {Object} LoadingSpinnerProps
+ * @property {"sm" | "md" | "lg" | "xl"} [size="md"] - Spinner 크기 / Spinner size
+ * @property {"default" | "dots" | "bars" | "ring" | "ripple"} [variant="default"] - Spinner 애니메이션 타입 / Spinner animation type
+ * @property {string} [text] - Spinner 아래 표시할 텍스트 / Text to display below spinner
+ * @property {"default" | "primary" | "secondary" | "success" | "warning" | "error" | "glass"} [color="default"] - Spinner 색상 / Spinner color
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ */
+export interface LoadingSpinnerProps {
     size?: "sm" | "md" | "lg" | "xl";
     variant?: "default" | "dots" | "bars" | "ring" | "ripple";
     text?: string;
-    color?: "default" | "primary" | "secondary" | "success" | "warning" | "error";
+    color?: "default" | "primary" | "secondary" | "success" | "warning" | "error" | "glass";
+    className?: string;
 }
-declare const LoadingSpinner: React.ForwardRefExoticComponent<LoadingSpinnerProps & React.RefAttributes<HTMLDivElement>>;
-export { LoadingSpinner };
+/**
+ * LoadingSpinner 컴포넌트 / LoadingSpinner component
+ *
+ * 로딩 상태를 표시하는 스피너 컴포넌트입니다.
+ * 다양한 애니메이션 타입과 크기를 지원합니다.
+ *
+ * Spinner component that displays loading state.
+ * Supports various animation types and sizes.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <LoadingSpinner />
+ *
+ * @example
+ * // 텍스트와 함께 / With text
+ * <LoadingSpinner
+ *   text="로딩 중..."
+ *   size="lg"
+ *   color="primary"
+ * />
+ *
+ * @example
+ * // 다양한 애니메이션 / Various animations
+ * <LoadingSpinner variant="dots" />
+ * <LoadingSpinner variant="bars" color="success" />
+ * <LoadingSpinner variant="ripple" size="xl" />
+ *
+ * @param {LoadingSpinnerProps} props - LoadingSpinner 컴포넌트의 props / LoadingSpinner component props
+ * @returns {JSX.Element} LoadingSpinner 컴포넌트 / LoadingSpinner component
+ */
+export declare function LoadingSpinner({ className, size, variant, text, color }: LoadingSpinnerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=LoadingSpinner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"LoadingSpinner.d.ts","sourceRoot":"","sources":["../../src/components/LoadingSpinner.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC/E,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAChC,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;CAC9E;AAED,QAAA,MAAM,cAAc,4FAsFnB,CAAA;AAGD,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"LoadingSpinner.d.ts","sourceRoot":"","sources":["../../src/components/LoadingSpinner.tsx"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAChC,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACvF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,IAAW,EACX,OAAmB,EACnB,IAAI,EACJ,KAAiB,EAClB,EAAE,mBAAmB,2CAiFrB"}

package/dist/components/Menu.d.ts

@@ -1,10 +1,58 @@
-import * as React from "react";
+import React from "react";
+/**
+ * Menu 컴포넌트의 props / Menu component props
+ * @typedef {Object} MenuProps
+ * @property {React.ReactNode} children - MenuItem, MenuSeparator, MenuLabel 컴포넌트들 / MenuItem, MenuSeparator, MenuLabel components
+ * @property {"default" | "horizontal" | "vertical" | "compact"} [variant="default"] - 메뉴 방향 및 스타일 / Menu direction and style
+ * @property {"sm" | "md" | "lg"} [size="md"] - 메뉴 아이템 크기 / Menu item size
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface MenuProps extends React.HTMLAttributes<HTMLDivElement> {
     children: React.ReactNode;
     variant?: "default" | "horizontal" | "vertical" | "compact";
     size?: "sm" | "md" | "lg";
 }
+/**
+ * Menu 컴포넌트 / Menu component
+ *
+ * 메뉴 리스트를 제공하는 컴포넌트입니다.
+ * MenuItem, MenuSeparator, MenuLabel과 함께 사용합니다.
+ *
+ * Component that provides menu lists.
+ * Used with MenuItem, MenuSeparator, and MenuLabel.
+ *
+ * @component
+ * @example
+ * // 기본 수직 메뉴 / Basic vertical menu
+ * <Menu>
+ *   <MenuItem icon={<Icon name="home" />}>홈</MenuItem>
+ *   <MenuItem icon={<Icon name="settings" />}>설정</MenuItem>
+ *   <MenuSeparator />
+ *   <MenuItem>로그아웃</MenuItem>
+ * </Menu>
+ *
+ * @example
+ * // 수평 메뉴 / Horizontal menu
+ * <Menu variant="horizontal">
+ *   <MenuItem>메뉴 1</MenuItem>
+ *   <MenuItem>메뉴 2</MenuItem>
+ * </Menu>
+ *
+ * @param {MenuProps} props - Menu 컴포넌트의 props / Menu component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} Menu 컴포넌트 / Menu component
+ */
 declare const Menu: React.ForwardRefExoticComponent<MenuProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * MenuItem 컴포넌트의 props / MenuItem component props
+ * @typedef {Object} MenuItemProps
+ * @property {React.ReactNode} [icon] - 메뉴 아이템 아이콘 / Menu item icon
+ * @property {"default" | "horizontal" | "vertical" | "compact"} [variant] - 메뉴 변형 (Menu에서 자동 전달) / Menu variant (auto-passed from Menu)
+ * @property {"sm" | "md" | "lg"} [size] - 메뉴 크기 (Menu에서 자동 전달) / Menu size (auto-passed from Menu)
+ * @property {boolean} [active=false] - 활성화 상태 / Active state
+ * @property {boolean} [disabled=false] - 비활성화 상태 / Disabled state
+ * @extends {React.ButtonHTMLAttributes<HTMLButtonElement>}
+ */
 export interface MenuItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     icon?: React.ReactNode;
     variant?: "default" | "horizontal" | "vertical" | "compact";
@@ -12,15 +60,58 @@ export interface MenuItemProps extends React.ButtonHTMLAttributes<HTMLButtonElem
     active?: boolean;
     disabled?: boolean;
 }
+/**
+ * MenuItem 컴포넌트 / MenuItem component
+ * 메뉴의 개별 아이템을 표시합니다.
+ * Displays an individual menu item.
+ *
+ * @component
+ * @param {MenuItemProps} props - MenuItem 컴포넌트의 props / MenuItem component props
+ * @param {React.Ref<HTMLButtonElement>} ref - button 요소 ref / button element ref
+ * @returns {JSX.Element} MenuItem 컴포넌트 / MenuItem component
+ */
 declare const MenuItem: React.ForwardRefExoticComponent<MenuItemProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * MenuSeparator 컴포넌트의 props / MenuSeparator component props
+ * @typedef {Object} MenuSeparatorProps
+ * @property {"default" | "horizontal" | "vertical" | "compact"} [variant] - 메뉴 변형 (Menu에서 자동 전달) / Menu variant (auto-passed from Menu)
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface MenuSeparatorProps extends React.HTMLAttributes<HTMLDivElement> {
     variant?: "default" | "horizontal" | "vertical" | "compact";
 }
+/**
+ * MenuSeparator 컴포넌트 / MenuSeparator component
+ * 메뉴 아이템들을 구분하는 구분선을 표시합니다.
+ * Displays a separator line between menu items.
+ *
+ * @component
+ * @param {MenuSeparatorProps} props - MenuSeparator 컴포넌트의 props / MenuSeparator component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} MenuSeparator 컴포넌트 / MenuSeparator component
+ */
 declare const MenuSeparator: React.ForwardRefExoticComponent<MenuSeparatorProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * MenuLabel 컴포넌트의 props / MenuLabel component props
+ * @typedef {Object} MenuLabelProps
+ * @property {"default" | "horizontal" | "vertical" | "compact"} [variant] - 메뉴 변형 (Menu에서 자동 전달) / Menu variant (auto-passed from Menu)
+ * @property {"sm" | "md" | "lg"} [size] - 메뉴 크기 (Menu에서 자동 전달) / Menu size (auto-passed from Menu)
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface MenuLabelProps extends React.HTMLAttributes<HTMLDivElement> {
     variant?: "default" | "horizontal" | "vertical" | "compact";
     size?: "sm" | "md" | "lg";
 }
+/**
+ * MenuLabel 컴포넌트 / MenuLabel component
+ * 메뉴 섹션의 레이블을 표시합니다.
+ * Displays a label for a menu section.
+ *
+ * @component
+ * @param {MenuLabelProps} props - MenuLabel 컴포넌트의 props / MenuLabel component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} MenuLabel 컴포넌트 / MenuLabel component
+ */
 declare const MenuLabel: React.ForwardRefExoticComponent<MenuLabelProps & React.RefAttributes<HTMLDivElement>>;
 export declare const MenuHorizontal: React.ForwardRefExoticComponent<Omit<MenuProps, "variant"> & React.RefAttributes<HTMLDivElement>>;
 export declare const MenuVertical: React.ForwardRefExoticComponent<Omit<MenuProps, "variant"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../../src/components/Menu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED,QAAA,MAAM,IAAI,kFAsDT,CAAA;AAGD,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IAClF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,QAAA,MAAM,QAAQ,yFA4Eb,CAAA;AAGD,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC9E,OAAO,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;CAC5D;AAED,QAAA,MAAM,aAAa,2FAqBlB,CAAA;AAGD,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC1E,OAAO,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED,QAAA,MAAM,SAAS,uFAsCd,CAAA;AAID,eAAO,MAAM,cAAc,mGAI1B,CAAA;AAGD,eAAO,MAAM,YAAY,mGAIxB,CAAA;AAGD,eAAO,MAAM,WAAW,mGAIvB,CAAA;AAGD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../../src/components/Menu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;GAOG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,QAAA,MAAM,IAAI,kFAsDT,CAAA;AAGD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IAClF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,QAAQ,yFA4Eb,CAAA;AAGD;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC9E,OAAO,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;CAC5D;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,aAAa,2FAqBlB,CAAA;AAGD;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC1E,OAAO,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,SAAS,uFAsCd,CAAA;AAID,eAAO,MAAM,cAAc,mGAI1B,CAAA;AAGD,eAAO,MAAM,YAAY,mGAIxB,CAAA;AAGD,eAAO,MAAM,WAAW,mGAIvB,CAAA;AAGD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,CAAA"}

package/dist/components/Modal.d.ts

@@ -1,15 +1,77 @@
-import * as React from "react";
-export interface ModalProps extends React.HTMLAttributes<HTMLDivElement> {
+import React from "react";
+/**
+ * Modal 컴포넌트의 props / Modal component props
+ * @typedef {Object} ModalProps
+ * @property {boolean} isOpen - 모달 열림/닫힘 상태 / Modal open/close state
+ * @property {() => void} onClose - 모달 닫기 콜백 함수 / Modal close callback function
+ * @property {React.ReactNode} children - 모달 내용 / Modal content
+ * @property {"sm" | "md" | "lg" | "xl" | "2xl" | "3xl"} [size="md"] - 모달 크기 / Modal size
+ * @property {boolean} [showCloseButton=true] - 닫기 버튼 표시 여부 / Show close button
+ * @property {boolean} [closeOnOverlayClick=true] - 오버레이 클릭 시 닫기 여부 / Close on overlay click
+ * @property {string} [title] - 모달 제목 / Modal title
+ * @property {string} [description] - 모달 설명 / Modal description
+ * @property {boolean} [showBackdrop=true] - 배경 오버레이 표시 여부 / Show backdrop overlay
+ * @property {string} [backdropClassName] - 배경 오버레이 추가 CSS 클래스 / Additional CSS class for backdrop
+ * @property {boolean} [centered=true] - 모달을 화면 중앙에 배치할지 여부 / Center modal on screen
+ * @property {string} [className] - 모달 컨테이너 추가 CSS 클래스 / Additional CSS class for modal container
+ */
+export interface ModalProps {
     isOpen: boolean;
     onClose: () => void;
     children: React.ReactNode;
-    size?: "sm" | "md" | "lg" | "xl" | "2xl";
+    size?: "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
     showCloseButton?: boolean;
     closeOnOverlayClick?: boolean;
     title?: string;
+    description?: string;
     showBackdrop?: boolean;
+    backdropClassName?: string;
     centered?: boolean;
+    className?: string;
 }
-declare const Modal: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>>;
-export { Modal };
+/**
+ * Modal 컴포넌트 / Modal component
+ *
+ * 오버레이와 함께 표시되는 모달 다이얼로그 컴포넌트입니다.
+ * ESC 키로 닫기, 오버레이 클릭으로 닫기, 접근성 속성(ARIA)을 지원합니다.
+ *
+ * Modal dialog component displayed with overlay.
+ * Supports closing with ESC key, overlay click, and ARIA accessibility attributes.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * const [isOpen, setIsOpen] = useState(false)
+ *
+ * <Modal isOpen={isOpen} onClose={() => setIsOpen(false)}>
+ *   <p>모달 내용</p>
+ * </Modal>
+ *
+ * @example
+ * // 제목과 설명 포함 / With title and description
+ * <Modal
+ *   isOpen={isOpen}
+ *   onClose={() => setIsOpen(false)}
+ *   title="확인"
+ *   description="이 작업을 계속하시겠습니까?"
+ * >
+ *   <Button onClick={handleConfirm}>확인</Button>
+ * </Modal>
+ *
+ * @example
+ * // 큰 크기 모달 / Large size modal
+ * <Modal
+ *   isOpen={isOpen}
+ *   onClose={() => setIsOpen(false)}
+ *   size="xl"
+ *   closeOnOverlayClick={false}
+ * >
+ *   <div>큰 모달 내용</div>
+ * </Modal>
+ *
+ * @param {ModalProps} props - Modal 컴포넌트의 props / Modal component props
+ * @param {React.Ref<HTMLDivElement>} ref - 모달 컨테이너 ref / Modal container ref
+ * @returns {JSX.Element} Modal 컴포넌트 / Modal component
+ */
+export declare const Modal: React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Modal.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/components/Modal.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACtE,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAA;IACxC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,QAAA,MAAM,KAAK,mFAoIV,CAAA;AAGD,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/components/Modal.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAA;IAChD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,KAAK,mFA2JhB,CAAA"}

package/dist/components/Navigation.d.ts

@@ -0,0 +1,72 @@
+import React from "react";
+/**
+ * Navigation 컴포넌트의 props / Navigation component props
+ * @typedef {Object} NavigationProps
+ * @property {string} [value] - 제어 모드에서 활성 탭 값 / Active tab value in controlled mode
+ * @property {string} [defaultValue] - 비제어 모드에서 기본 활성 탭 값 / Default active tab value in uncontrolled mode
+ * @property {(value: string) => void} [onValueChange] - 탭 변경 콜백 / Tab change callback
+ * @property {"pills" | "underline" | "cards"} [variant="pills"] - Navigation 스타일 변형 / Navigation style variant
+ * @property {"small" | "medium" | "large"} [scale="medium"] - Navigation 크기 / Navigation size
+ * @extends {Omit<React.HTMLAttributes<HTMLDivElement>, 'style'>}
+ */
+export interface NavigationProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'style'> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    variant?: "pills" | "underline" | "cards";
+    scale?: "small" | "medium" | "large";
+}
+/**
+ * NavigationList 컴포넌트의 props / NavigationList component props
+ * @typedef {Object} NavigationListProps
+ * @property {string} [value] - 활성 탭 값 / Active tab value
+ * @property {(value: string) => void} [onValueChange] - 탭 변경 콜백 / Tab change callback
+ * @property {"pills" | "underline" | "cards"} [variant="pills"] - Navigation 스타일 변형 / Navigation style variant
+ * @property {"small" | "medium" | "large"} [scale="medium"] - Navigation 크기 / Navigation size
+ * @extends {Omit<React.HTMLAttributes<HTMLDivElement>, 'style'>}
+ */
+export interface NavigationListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'style'> {
+    value?: string;
+    onValueChange?: (value: string) => void;
+    variant?: "pills" | "underline" | "cards";
+    scale?: "small" | "medium" | "large";
+}
+declare const NavigationList: React.ForwardRefExoticComponent<NavigationListProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * NavigationItem 컴포넌트의 props / NavigationItem component props
+ * @typedef {Object} NavigationItemProps
+ * @property {string} value - 탭 값 / Tab value
+ * @property {(value: string) => void} [onValueChange] - 탭 변경 콜백 / Tab change callback
+ * @property {"pills" | "underline" | "cards"} [variant] - Navigation 스타일 변형 (자동으로 설정됨) / Navigation style variant (auto-set)
+ * @property {"small" | "medium" | "large"} [scale] - Navigation 크기 (자동으로 설정됨) / Navigation size (auto-set)
+ * @property {boolean} [active] - 활성 상태 (자동으로 설정됨) / Active state (auto-set)
+ * @extends {Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'style'>}
+ */
+export interface NavigationItemProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'style'> {
+    value: string;
+    onValueChange?: (value: string) => void;
+    variant?: "pills" | "underline" | "cards";
+    scale?: "small" | "medium" | "large";
+    active?: boolean;
+}
+declare const NavigationItem: React.ForwardRefExoticComponent<NavigationItemProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * NavigationContent 컴포넌트의 props / NavigationContent component props
+ * @typedef {Object} NavigationContentProps
+ * @property {string} value - 탭 값 / Tab value
+ * @property {boolean} [active] - 활성 상태 (자동으로 설정됨) / Active state (auto-set)
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface NavigationContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    value: string;
+    active?: boolean;
+}
+declare const NavigationContent: React.ForwardRefExoticComponent<NavigationContentProps & React.RefAttributes<HTMLDivElement>>;
+export interface NavigationComponent extends React.ForwardRefExoticComponent<NavigationProps & React.RefAttributes<HTMLDivElement>> {
+    List: typeof NavigationList;
+    Item: typeof NavigationItem;
+    Content: typeof NavigationContent;
+}
+declare const NavigationComponent: NavigationComponent;
+export { NavigationComponent as Navigation, NavigationList, NavigationItem, NavigationContent };
+//# sourceMappingURL=Navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Navigation.d.ts","sourceRoot":"","sources":["../../src/components/Navigation.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACzC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;CACrC;AA+ED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACzC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;CACrC;AAED,QAAA,MAAM,cAAc,4FA0DnB,CAAA;AAGD;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACvG,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACzC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IACpC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,QAAA,MAAM,cAAc,+FA2EnB,CAAA;AAGD;;;;;;GAMG;AACH,MAAM,WAAW,sBAAuB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAClF,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,QAAA,MAAM,iBAAiB,+FAYtB,CAAA;AAID,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,yBAAyB,CAAC,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IACjI,IAAI,EAAE,OAAO,cAAc,CAAA;IAC3B,IAAI,EAAE,OAAO,cAAc,CAAA;IAC3B,OAAO,EAAE,OAAO,iBAAiB,CAAA;CAClC;AAED,QAAA,MAAM,mBAAmB,EAAiB,mBAAmB,CAAA;AAK7D,OAAO,EAAE,mBAAmB,IAAI,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/components/PageNavigation.d.ts

@@ -0,0 +1,48 @@
+import React from "react";
+/**
+ * PageNavigation 컴포넌트의 props / PageNavigation component props
+ * @typedef {Object} PageNavigationProps
+ * @property {Object} [prevPage] - 이전 페이지 정보 / Previous page information
+ * @property {string} prevPage.title - 이전 페이지 제목 / Previous page title
+ * @property {string} prevPage.href - 이전 페이지 링크 / Previous page link
+ * @property {Object} [nextPage] - 다음 페이지 정보 / Next page information
+ * @property {string} nextPage.title - 다음 페이지 제목 / Next page title
+ * @property {string} nextPage.href - 다음 페이지 링크 / Next page link
+ * @property {boolean} [showOnMobile=false] - 모바일에서 표시 여부 / Show on mobile
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface PageNavigationProps extends React.HTMLAttributes<HTMLDivElement> {
+    prevPage?: {
+        title: string;
+        href: string;
+    };
+    nextPage?: {
+        title: string;
+        href: string;
+    };
+    showOnMobile?: boolean;
+}
+/**
+ * PageNavigation 컴포넌트 / PageNavigation component
+ *
+ * 이전/다음 페이지로 이동하는 네비게이션 컴포넌트입니다.
+ * 문서 페이지나 가이드 페이지에서 사용하기 적합합니다.
+ *
+ * Navigation component for moving to previous/next pages.
+ * Suitable for documentation or guide pages.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <PageNavigation
+ *   prevPage={{ title: "이전 페이지", href: "/prev" }}
+ *   nextPage={{ title: "다음 페이지", href: "/next" }}
+ * />
+ *
+ * @param {PageNavigationProps} props - PageNavigation 컴포넌트의 props / PageNavigation component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} PageNavigation 컴포넌트 / PageNavigation component
+ */
+declare const PageNavigation: React.ForwardRefExoticComponent<PageNavigationProps & React.RefAttributes<HTMLDivElement>>;
+export { PageNavigation };
+//# sourceMappingURL=PageNavigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PageNavigation.d.ts","sourceRoot":"","sources":["../../src/components/PageNavigation.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC/E,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,cAAc,4FAwDnB,CAAA;AAGD,OAAO,EAAE,cAAc,EAAE,CAAA"}