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

package/dist/components/Toast.d.ts

@@ -1,4 +1,16 @@
-import * as React from "react";
+import React from "react";
+/**
+ * Toast 메시지 타입 / Toast message type
+ * @typedef {Object} Toast
+ * @property {string} id - Toast 고유 ID / Toast unique ID
+ * @property {"success" | "error" | "warning" | "info"} type - Toast 타입 / Toast type
+ * @property {string} [title] - Toast 제목 / Toast title
+ * @property {string} message - Toast 메시지 / Toast message
+ * @property {number} [duration] - 표시 시간(ms), 0이면 자동 제거 안 함 / Display duration (ms), 0 means no auto-remove
+ * @property {Object} [action] - 액션 버튼 / Action button
+ * @property {string} action.label - 액션 버튼 레이블 / Action button label
+ * @property {() => void} action.onClick - 액션 버튼 클릭 핸들러 / Action button click handler
+ */
 export interface Toast {
     id: string;
     type: "success" | "error" | "warning" | "info";
@@ -16,12 +28,74 @@ interface ToastContextType {
     removeToast: (id: string) => void;
     clearToasts: () => void;
 }
+/**
+ * useToast Hook
+ *
+ * Toast를 추가, 제거, 초기화하는 훅입니다.
+ * ToastProvider 내부에서만 사용 가능합니다.
+ *
+ * Hook for adding, removing, and clearing toasts.
+ * Can only be used within ToastProvider.
+ *
+ * @example
+ * const { addToast, removeToast, clearToasts } = useToast()
+ *
+ * addToast({
+ *   type: "success",
+ *   message: "저장되었습니다",
+ *   duration: 3000
+ * })
+ *
+ * @returns {ToastContextType} Toast 컨텍스트 값 / Toast context value
+ * @throws {Error} ToastProvider 외부에서 사용 시 에러 발생 / Error when used outside ToastProvider
+ */
 export declare function useToast(): ToastContextType;
+/**
+ * ToastProvider 컴포넌트의 props / ToastProvider component props
+ * @typedef {Object} ToastProviderProps
+ * @property {React.ReactNode} children - 자식 컴포넌트 / Child components
+ * @property {number} [maxToasts=5] - 최대 Toast 개수 / Maximum number of toasts
+ * @property {"top-right" | "top-left" | "bottom-right" | "bottom-left" | "top-center" | "bottom-center"} [position="top-right"] - Toast 표시 위치 / Toast display position
+ */
 interface ToastProviderProps {
     children: React.ReactNode;
     maxToasts?: number;
     position?: "top-right" | "top-left" | "bottom-right" | "bottom-left" | "top-center" | "bottom-center";
 }
+/**
+ * ToastProvider 컴포넌트 / ToastProvider component
+ *
+ * Toast 시스템의 컨텍스트를 제공하는 Provider 컴포넌트입니다.
+ * 앱의 루트 레벨에서 사용하여 전역 Toast 기능을 활성화합니다.
+ *
+ * Provider component that provides context for the Toast system.
+ * Use at the root level of your app to enable global Toast functionality.
+ *
+ * @component
+ * @example
+ * // App.tsx
+ * <ToastProvider position="top-center" maxToasts={3}>
+ *   <App />
+ * </ToastProvider>
+ *
+ * @example
+ * // 컴포넌트에서 사용 / Usage in component
+ * const { addToast } = useToast()
+ *
+ * const handleSave = () => {
+ *   addToast({
+ *     type: "success",
+ *     message: "저장되었습니다",
+ *     title: "성공"
+ *   })
+ * }
+ *
+ * @param {ToastProviderProps} props - ToastProvider 컴포넌트의 props / ToastProvider component props
+ * @returns {JSX.Element} ToastProvider 컴포넌트 / ToastProvider component
+ *
+ * @todo 접근성 개선: ToastItem에 role="alert" 또는 role="status" 추가 필요 / Accessibility: Add role="alert" or role="status" to ToastItem
+ * @todo 접근성 개선: aria-live="polite" 또는 aria-live="assertive" 추가 필요 / Accessibility: Add aria-live="polite" or aria-live="assertive"
+ */
 export declare function ToastProvider({ children, maxToasts, position }: ToastProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare const showToast: (toast: Omit<Toast, "id">) => void;
 export declare const showSuccessToast: (message: string, title?: string, duration?: number) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../src/components/Toast.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,IAAI,CAAA;KACpB,CAAA;CACF;AAGD,UAAU,gBAAgB;IACxB,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;IAC5C,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,WAAW,EAAE,MAAM,IAAI,CAAA;CACxB;AAMD,wBAAgB,QAAQ,qBAMvB;AAGD,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,eAAe,CAAA;CACtG;AAGD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,SAAa,EACb,QAAsB,EACvB,EAAE,kBAAkB,2CAkCpB;AAuLD,eAAO,MAAM,SAAS,GAAI,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAGjD,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,WAAW,MAAM,SAElF,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,WAAW,MAAM,SAEhF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,WAAW,MAAM,SAElF,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,WAAW,MAAM,SAE/E,CAAA"}
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../src/components/Toast.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,IAAI,CAAA;KACpB,CAAA;CACF;AAGD,UAAU,gBAAgB;IACxB,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;IAC5C,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,WAAW,EAAE,MAAM,IAAI,CAAA;CACxB;AAKD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,IAAI,gBAAgB,CAM3C;AAED;;;;;;GAMG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,eAAe,CAAA;CACtG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,SAAa,EACb,QAAsB,EACvB,EAAE,kBAAkB,2CAkCpB;AAwKD,eAAO,MAAM,SAAS,GAAI,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAGjD,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,WAAW,MAAM,SAElF,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,WAAW,MAAM,SAEhF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,WAAW,MAAM,SAElF,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,WAAW,MAAM,SAE/E,CAAA"}

package/dist/components/Toggle.d.ts

@@ -0,0 +1,62 @@
+import React from "react";
+/**
+ * Toggle 컴포넌트의 props / Toggle component props
+ * @typedef {Object} ToggleProps
+ * @property {"default" | "outline" | "filled" | "ghost" | "glass"} [variant="default"] - Toggle 스타일 변형 / Toggle style variant
+ * @property {"sm" | "md" | "lg"} [size="md"] - Toggle 크기 / Toggle size
+ * @property {boolean} [pressed] - 제어 모드에서 눌림 상태 / Pressed state in controlled mode
+ * @property {(pressed: boolean) => void} [onPressedChange] - 상태 변경 콜백 / State change callback
+ * @property {string} [label] - Toggle 라벨 텍스트 / Toggle label text
+ * @property {string} [description] - Toggle 설명 텍스트 / Toggle description text
+ * @property {React.ReactNode} [icon] - 아이콘 / Icon
+ * @property {"left" | "right"} [iconPosition="left"] - 아이콘 위치 / Icon position
+ * @extends {Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'size'>}
+ */
+export interface ToggleProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'size'> {
+    variant?: "default" | "outline" | "filled" | "ghost" | "glass";
+    size?: "sm" | "md" | "lg";
+    pressed?: boolean;
+    onPressedChange?: (pressed: boolean) => void;
+    label?: string;
+    description?: string;
+    icon?: React.ReactNode;
+    iconPosition?: "left" | "right";
+}
+/**
+ * Toggle 컴포넌트 / Toggle component
+ *
+ * 눌림 상태를 가지는 토글 버튼 컴포넌트입니다.
+ * Switch와 달리 버튼 형태로 표시되며, 여러 개를 그룹으로 사용할 수 있습니다.
+ *
+ * Toggle button component with pressed state.
+ * Unlike Switch, displayed as a button and can be used in groups.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Toggle label="알림" />
+ *
+ * @example
+ * // 제어 모드 / Controlled mode
+ * const [pressed, setPressed] = useState(false)
+ * <Toggle
+ *   pressed={pressed}
+ *   onPressedChange={setPressed}
+ *   label="다크 모드"
+ *   icon={<Icon name="moon" />}
+ * />
+ *
+ * @example
+ * // 아이콘만 / Icon only
+ * <Toggle
+ *   icon={<Icon name="heart" />}
+ *   variant="ghost"
+ * />
+ *
+ * @param {ToggleProps} props - Toggle 컴포넌트의 props / Toggle component props
+ * @param {React.Ref<HTMLButtonElement>} ref - button 요소 ref / button element ref
+ * @returns {JSX.Element} Toggle 컴포넌트 / Toggle component
+ */
+declare const Toggle: React.ForwardRefExoticComponent<ToggleProps & React.RefAttributes<HTMLButtonElement>>;
+export { Toggle };
+//# sourceMappingURL=Toggle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Toggle.d.ts","sourceRoot":"","sources":["../../src/components/Toggle.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC9F,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;IAC9D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,QAAA,MAAM,MAAM,uFAqFX,CAAA;AAGD,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/components/Tooltip.d.ts

@@ -1,4 +1,15 @@
-import * as React from "react";
+import React from "react";
+/**
+ * Tooltip 컴포넌트의 props / Tooltip component props
+ * @typedef {Object} TooltipProps
+ * @property {string} content - Tooltip 내용 / Tooltip content
+ * @property {React.ReactNode} children - Tooltip이 연결될 요소 / Element to attach tooltip to
+ * @property {"top" | "bottom" | "left" | "right"} [position="top"] - Tooltip 표시 위치 / Tooltip display position
+ * @property {"default" | "light" | "dark"} [variant="default"] - Tooltip 스타일 변형 / Tooltip style variant
+ * @property {number} [delay=300] - Tooltip 표시 지연 시간(ms) / Tooltip display delay (ms)
+ * @property {boolean} [disabled=false] - Tooltip 비활성화 여부 / Disable tooltip
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface TooltipProps extends React.HTMLAttributes<HTMLDivElement> {
     content: string;
     children: React.ReactNode;
@@ -7,6 +18,42 @@ export interface TooltipProps extends React.HTMLAttributes<HTMLDivElement> {
     delay?: number;
     disabled?: boolean;
 }
+/**
+ * Tooltip 컴포넌트 / Tooltip component
+ *
+ * 호버 시 추가 정보를 표시하는 툴팁 컴포넌트입니다.
+ * 마우스 호버 시 지연 시간 후 표시됩니다.
+ *
+ * Tooltip component that displays additional information on hover.
+ * Appears after a delay when the mouse hovers over the element.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Tooltip content="이것은 도움말입니다">
+ *   <Button>호버하세요</Button>
+ * </Tooltip>
+ *
+ * @example
+ * // 다양한 위치 / Different positions
+ * <Tooltip content="위치 변경" position="bottom">
+ *   <Icon name="info" />
+ * </Tooltip>
+ *
+ * @example
+ * // 커스텀 스타일 / Custom styles
+ * <Tooltip content="라이트 스타일" variant="light" delay={500}>
+ *   <span>호버</span>
+ * </Tooltip>
+ *
+ * @param {TooltipProps} props - Tooltip 컴포넌트의 props / Tooltip component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} Tooltip 컴포넌트 / Tooltip component
+ *
+ * @todo 접근성 개선: role="tooltip" 추가 필요 / Accessibility: Add role="tooltip"
+ * @todo 접근성 개선: aria-describedby 연결 필요 / Accessibility: Connect aria-describedby
+ * @todo 접근성 개선: 키보드 포커스 시 Tooltip 표시 필요 / Accessibility: Show tooltip on keyboard focus
+ */
 declare const Tooltip: React.ForwardRefExoticComponent<TooltipProps & React.RefAttributes<HTMLDivElement>>;
 export declare const TooltipLight: React.ForwardRefExoticComponent<Omit<TooltipProps, "variant"> & React.RefAttributes<HTMLDivElement>>;
 export declare const TooltipDark: React.ForwardRefExoticComponent<Omit<TooltipProps, "variant"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../src/components/Tooltip.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IAC9C,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,QAAA,MAAM,OAAO,qFA8IZ,CAAA;AAID,eAAO,MAAM,YAAY,sGAIxB,CAAA;AAGD,eAAO,MAAM,WAAW,sGAIvB,CAAA;AAGD,OAAO,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../src/components/Tooltip.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IAC9C,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,QAAA,MAAM,OAAO,qFA+IZ,CAAA;AAID,eAAO,MAAM,YAAY,sGAIxB,CAAA;AAGD,eAAO,MAAM,WAAW,sGAIvB,CAAA;AAGD,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/dist/components/Upload.d.ts

@@ -0,0 +1,87 @@
+import React from "react";
+/**
+ * 업로드된 파일 정보 인터페이스 / Uploaded file information interface
+ * @typedef {Object} UploadedFile
+ * @property {string} id - 파일 고유 ID / File unique ID
+ * @property {File} file - 파일 객체 / File object
+ * @property {string} name - 파일 이름 / File name
+ * @property {number} size - 파일 크기 (bytes) / File size in bytes
+ * @property {string} type - 파일 타입 / File type
+ * @property {number} [progress] - 업로드 진행률 (0-100) / Upload progress (0-100)
+ * @property {"pending" | "uploading" | "success" | "error"} [status] - 업로드 상태 / Upload status
+ * @property {string} [url] - 업로드된 파일 URL / Uploaded file URL
+ * @property {string} [error] - 에러 메시지 / Error message
+ */
+export interface UploadedFile {
+    id: string;
+    file: File;
+    name: string;
+    size: number;
+    type: string;
+    progress?: number;
+    status?: "pending" | "uploading" | "success" | "error";
+    url?: string;
+    error?: string;
+}
+/**
+ * Upload 컴포넌트의 props / Upload component props
+ * @typedef {Object} UploadProps
+ * @property {UploadedFile[]} [files] - 업로드된 파일 목록 / Uploaded files list
+ * @property {(files: File[]) => void} [onChange] - 파일 선택 핸들러 / File selection handler
+ * @property {(file: UploadedFile) => void} [onRemove] - 파일 제거 핸들러 / File removal handler
+ * @property {boolean} [multiple=false] - 다중 파일 선택 허용 / Allow multiple file selection
+ * @property {string} [accept] - 허용할 파일 타입 (예: "image/*", ".pdf") / Accepted file types
+ * @property {number} [maxSize] - 최대 파일 크기 (bytes) / Maximum file size in bytes
+ * @property {number} [maxFiles] - 최대 파일 개수 / Maximum number of files
+ * @property {boolean} [disabled=false] - 비활성화 상태 / Disabled state
+ * @property {boolean} [dragDrop=true] - 드래그 앤 드롭 활성화 / Enable drag and drop
+ * @property {string} [placeholder="파일을 선택하거나 여기에 드래그하세요"] - 플레이스홀더 / Placeholder
+ * @property {"sm" | "md" | "lg"} [size="md"] - 크기 / Size
+ * @property {string} [className] - 추가 클래스명 / Additional class name
+ */
+export interface UploadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    files?: UploadedFile[];
+    onChange?: (files: File[]) => void;
+    onRemove?: (file: UploadedFile) => void;
+    multiple?: boolean;
+    accept?: string;
+    maxSize?: number;
+    maxFiles?: number;
+    disabled?: boolean;
+    dragDrop?: boolean;
+    placeholder?: string;
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+/**
+ * Upload 컴포넌트 / Upload component
+ *
+ * 파일을 업로드할 수 있는 컴포넌트입니다.
+ * 드래그 앤 드롭, 다중 파일 선택, 파일 크기 제한 등을 지원합니다.
+ *
+ * Component for uploading files.
+ * Supports drag and drop, multiple file selection, file size limits, and more.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Upload
+ *   onChange={(files) => console.log(files)}
+ * />
+ *
+ * @example
+ * // 이미지만, 다중 선택 / Images only, multiple selection
+ * <Upload
+ *   accept="image/*"
+ *   multiple
+ *   maxSize={5 * 1024 * 1024} // 5MB
+ *   maxFiles={5}
+ *   files={uploadedFiles}
+ *   onRemove={(file) => handleRemove(file)}
+ * />
+ *
+ * @param {UploadProps} props - Upload 컴포넌트의 props / Upload component props
+ * @returns {JSX.Element} Upload 컴포넌트 / Upload component
+ */
+export declare const Upload: React.ForwardRefExoticComponent<UploadProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Upload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Upload.d.ts","sourceRoot":"","sources":["../../src/components/Upload.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;IACtD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACzF,KAAK,CAAC,EAAE,YAAY,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,MAAM,oFAiNlB,CAAA"}

package/dist/components/advanced/AdvancedPageTransition.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+export type TransitionType = 'fade' | 'slide' | 'scale' | 'flip' | 'morph' | 'cube' | 'zoom' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right';
+export type TransitionEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'bounce' | 'elastic' | 'smooth';
+export interface AdvancedPageTransitionProps {
+    children: React.ReactNode;
+    className?: string;
+    type?: TransitionType;
+    duration?: number;
+    easing?: TransitionEasing;
+    delay?: number;
+    autoStart?: boolean;
+    onStart?: () => void;
+    onComplete?: () => void;
+    showProgress?: boolean;
+    progressClassName?: string;
+}
+export declare const AdvancedPageTransition: React.ForwardRefExoticComponent<AdvancedPageTransitionProps & React.RefAttributes<HTMLDivElement>>;
+export declare const FadePageTransition: React.ForwardRefExoticComponent<Omit<AdvancedPageTransitionProps, "type"> & React.RefAttributes<HTMLDivElement>>;
+export declare const SlidePageTransition: React.ForwardRefExoticComponent<Omit<AdvancedPageTransitionProps, "type"> & React.RefAttributes<HTMLDivElement>>;
+export declare const ScalePageTransition: React.ForwardRefExoticComponent<Omit<AdvancedPageTransitionProps, "type"> & React.RefAttributes<HTMLDivElement>>;
+export declare const FlipPageTransition: React.ForwardRefExoticComponent<Omit<AdvancedPageTransitionProps, "type"> & React.RefAttributes<HTMLDivElement>>;
+export declare const MorphPageTransition: React.ForwardRefExoticComponent<Omit<AdvancedPageTransitionProps, "type"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CubePageTransition: React.ForwardRefExoticComponent<Omit<AdvancedPageTransitionProps, "type"> & React.RefAttributes<HTMLDivElement>>;
+export declare const ZoomPageTransition: React.ForwardRefExoticComponent<Omit<AdvancedPageTransitionProps, "type"> & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=AdvancedPageTransition.d.ts.map

package/dist/components/advanced/AdvancedPageTransition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdvancedPageTransition.d.ts","sourceRoot":"","sources":["../../../src/components/advanced/AdvancedPageTransition.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAG1D,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,CAAA;AAEjB,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,aAAa,GACb,QAAQ,GACR,SAAS,GACT,QAAQ,CAAA;AAEZ,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,eAAO,MAAM,sBAAsB,oGAkNjC,CAAA;AAKF,eAAO,MAAM,kBAAkB,kHAE7B,CAAA;AAEF,eAAO,MAAM,mBAAmB,kHAE9B,CAAA;AAEF,eAAO,MAAM,mBAAmB,kHAE9B,CAAA;AAEF,eAAO,MAAM,kBAAkB,kHAE7B,CAAA;AAEF,eAAO,MAAM,mBAAmB,kHAE9B,CAAA;AAEF,eAAO,MAAM,kBAAkB,kHAE7B,CAAA;AAEF,eAAO,MAAM,kBAAkB,kHAE7B,CAAA"}

package/dist/components/advanced/index.d.ts

@@ -0,0 +1,4 @@
+export * from './AdvancedPageTransition';
+export { usePageTransition } from './usePageTransition';
+export { usePageTransitionManager } from './usePageTransitionManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/advanced/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/advanced/index.ts"],"names":[],"mappings":"AACA,cAAc,0BAA0B,CAAA;AAGxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/components/advanced/usePageTransition.d.ts

@@ -0,0 +1,33 @@
+export type TransitionType = 'fade' | 'slide' | 'scale' | 'flip' | 'morph' | 'cube' | 'zoom' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right';
+export type TransitionEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'bounce' | 'elastic' | 'smooth';
+export interface TransitionConfig {
+    type: TransitionType;
+    duration: number;
+    easing: TransitionEasing;
+    delay?: number;
+    stagger?: number;
+    direction?: 'forward' | 'backward';
+    onStart?: () => void;
+    onComplete?: () => void;
+    onReverse?: () => void;
+}
+export interface PageTransitionState {
+    isTransitioning: boolean;
+    isVisible: boolean;
+    currentStep: number;
+    progress: number;
+}
+export interface PageTransitionControls {
+    start: (config?: Partial<TransitionConfig>) => Promise<void>;
+    reverse: () => Promise<void>;
+    pause: () => void;
+    resume: () => void;
+    reset: () => void;
+}
+export declare const usePageTransition: (initialConfig?: Partial<TransitionConfig>) => [PageTransitionState, PageTransitionControls];
+export declare const useFadeTransition: (config?: Partial<TransitionConfig>) => [PageTransitionState, PageTransitionControls];
+export declare const useSlideTransition: (config?: Partial<TransitionConfig>) => [PageTransitionState, PageTransitionControls];
+export declare const useScaleTransition: (config?: Partial<TransitionConfig>) => [PageTransitionState, PageTransitionControls];
+export declare const useMorphTransition: (config?: Partial<TransitionConfig>) => [PageTransitionState, PageTransitionControls];
+export declare const useCubeTransition: (config?: Partial<TransitionConfig>) => [PageTransitionState, PageTransitionControls];
+//# sourceMappingURL=usePageTransition.d.ts.map

package/dist/components/advanced/usePageTransition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageTransition.d.ts","sourceRoot":"","sources":["../../../src/components/advanced/usePageTransition.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,CAAA;AAEjB,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,aAAa,GACb,QAAQ,GACR,SAAS,GACT,QAAQ,CAAA;AAEZ,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,gBAAgB,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,OAAO,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,eAAO,MAAM,iBAAiB,GAC5B,gBAAe,OAAO,CAAC,gBAAgB,CAAM,KAC5C,CAAC,mBAAmB,EAAE,sBAAsB,CAgJ9C,CAAA;AAGD,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,CAAC,gBAAgB,CAAC,kDAEnE,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAS,OAAO,CAAC,gBAAgB,CAAC,kDAEpE,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAS,OAAO,CAAC,gBAAgB,CAAC,kDAEpE,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAS,OAAO,CAAC,gBAAgB,CAAC,kDAEpE,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,CAAC,gBAAgB,CAAC,kDAEnE,CAAA"}

package/dist/components/advanced/usePageTransitionManager.d.ts

@@ -0,0 +1,44 @@
+import { TransitionType, TransitionEasing, TransitionConfig } from './usePageTransition';
+export interface PageTransitionManagerConfig {
+    defaultType?: TransitionType;
+    defaultDuration?: number;
+    defaultEasing?: TransitionEasing;
+    enableHistory?: boolean;
+    enableProgress?: boolean;
+    enableDebug?: boolean;
+}
+export interface PageTransitionEvent {
+    id: string;
+    type: TransitionType;
+    duration: number;
+    easing: TransitionEasing;
+    timestamp: number;
+    status: 'pending' | 'active' | 'completed' | 'failed';
+}
+export interface PageTransitionManagerState {
+    isTransitioning: boolean;
+    currentTransition: PageTransitionEvent | null;
+    transitionHistory: PageTransitionEvent[];
+    totalTransitions: number;
+    averageDuration: number;
+}
+export interface PageTransitionManagerControls {
+    startTransition: (config: Partial<TransitionConfig>) => Promise<string>;
+    cancelTransition: (id: string) => void;
+    pauseAll: () => void;
+    resumeAll: () => void;
+    clearHistory: () => void;
+    getTransitionStats: () => {
+        total: number;
+        average: number;
+        byType: Record<TransitionType, number>;
+        byStatus: Record<string, number>;
+    };
+}
+export declare const usePageTransitionManager: (config?: PageTransitionManagerConfig) => [PageTransitionManagerState, PageTransitionManagerControls];
+export declare const useFadeTransitionManager: (config?: PageTransitionManagerConfig) => [PageTransitionManagerState, PageTransitionManagerControls];
+export declare const useSlideTransitionManager: (config?: PageTransitionManagerConfig) => [PageTransitionManagerState, PageTransitionManagerControls];
+export declare const useScaleTransitionManager: (config?: PageTransitionManagerConfig) => [PageTransitionManagerState, PageTransitionManagerControls];
+export declare const useMorphTransitionManager: (config?: PageTransitionManagerConfig) => [PageTransitionManagerState, PageTransitionManagerControls];
+export declare const useCubeTransitionManager: (config?: PageTransitionManagerConfig) => [PageTransitionManagerState, PageTransitionManagerControls];
+//# sourceMappingURL=usePageTransitionManager.d.ts.map

package/dist/components/advanced/usePageTransitionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageTransitionManager.d.ts","sourceRoot":"","sources":["../../../src/components/advanced/usePageTransitionManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAExF,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,gBAAgB,CAAA;IAChC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,cAAc,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,gBAAgB,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAA;CACtD;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,OAAO,CAAA;IACxB,iBAAiB,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAC7C,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;IACxC,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,kBAAkB,EAAE,MAAM;QACxB,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACjC,CAAA;CACF;AAED,eAAO,MAAM,wBAAwB,GACnC,SAAQ,2BAAgC,KACvC,CAAC,0BAA0B,EAAE,6BAA6B,CAqL5D,CAAA;AAGD,eAAO,MAAM,wBAAwB,GAAI,SAAS,2BAA2B,gEAE5E,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,SAAS,2BAA2B,gEAE7E,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,SAAS,2BAA2B,gEAE7E,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,SAAS,2BAA2B,gEAE7E,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,SAAS,2BAA2B,gEAE5E,CAAA"}

package/dist/components/dashboard/ActivityFeed.d.ts

@@ -0,0 +1,87 @@
+import React from "react";
+import type { IconName } from "../../lib/icons";
+/**
+ * ActivityItem 인터페이스 / ActivityItem interface
+ * @typedef {Object} ActivityItem
+ * @property {string} id - 활동 항목 고유 ID / Activity item unique ID
+ * @property {string} title - 활동 제목 / Activity title
+ * @property {string} [description] - 활동 설명 / Activity description
+ * @property {Date | string} timestamp - 활동 타임스탬프 / Activity timestamp
+ * @property {IconName | React.ReactNode} [icon] - 아이콘 / Icon
+ * @property {string | React.ReactNode} [badge] - 배지 / Badge
+ * @property {() => void} [onClick] - 클릭 핸들러 / Click handler
+ * @property {Record<string, unknown>} [metadata] - 추가 메타데이터 / Additional metadata
+ */
+export interface ActivityItem {
+    id: string;
+    title: string;
+    description?: string;
+    timestamp: Date | string;
+    icon?: IconName | React.ReactNode;
+    badge?: string | React.ReactNode;
+    onClick?: () => void;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * ActivityFeed 컴포넌트의 props / ActivityFeed component props
+ * @typedef {Object} ActivityFeedProps
+ * @property {string} [title] - 피드 제목 / Feed title
+ * @property {ActivityItem[]} items - 활동 항목 배열 / Activity items array
+ * @property {string} [emptyMessage="활동 내역이 없습니다."] - 빈 상태 메시지 / Empty state message
+ * @property {boolean} [showHeader=true] - 헤더 표시 여부 / Show header
+ * @property {number} [maxItems] - 최대 표시 항목 수 / Maximum items to display
+ * @property {() => void} [onViewAll] - 전체 보기 핸들러 / View all handler
+ * @property {string} [viewAllLabel="전체 보기"] - 전체 보기 라벨 / View all label
+ * @property {React.ReactNode} [emptyState] - 빈 상태 컴포넌트 / Empty state component
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface ActivityFeedProps extends React.HTMLAttributes<HTMLDivElement> {
+    title?: string;
+    items: ActivityItem[];
+    emptyMessage?: string;
+    showHeader?: boolean;
+    maxItems?: number;
+    onViewAll?: () => void;
+    viewAllLabel?: string;
+    emptyState?: React.ReactNode;
+}
+/**
+ * ActivityFeed 컴포넌트 / ActivityFeed component
+ *
+ * 활동 내역을 표시하는 피드 컴포넌트입니다.
+ * 타임스탬프를 상대 시간으로 표시하며, 최대 항목 수 제한을 지원합니다.
+ *
+ * Feed component that displays activity history.
+ * Shows timestamps as relative time and supports maximum items limit.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <ActivityFeed
+ *   title="최근 활동"
+ *   items={[
+ *     {
+ *       id: "1",
+ *       title: "새 주문 생성",
+ *       description: "주문 #1234",
+ *       timestamp: new Date(),
+ *       icon: "shoppingCart"
+ *     }
+ *   ]}
+ * />
+ *
+ * @example
+ * // 최대 항목 수 제한 / Maximum items limit
+ * <ActivityFeed
+ *   title="활동 내역"
+ *   items={activities}
+ *   maxItems={10}
+ *   onViewAll={() => navigate("/activities")}
+ * />
+ *
+ * @param {ActivityFeedProps} props - ActivityFeed 컴포넌트의 props / ActivityFeed component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} ActivityFeed 컴포넌트 / ActivityFeed component
+ */
+export declare const ActivityFeed: React.ForwardRefExoticComponent<ActivityFeedProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=ActivityFeed.d.ts.map

package/dist/components/dashboard/ActivityFeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFeed.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/ActivityFeed.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,YAAY,0FAsJxB,CAAC"}

package/dist/components/dashboard/BarChart.d.ts

@@ -0,0 +1,82 @@
+import React from "react";
+/**
+ * BarChartData 인터페이스 / BarChartData interface
+ * @typedef {Object} BarChartData
+ * @property {string} label - 막대 라벨 / Bar label
+ * @property {number} value - 막대 값 / Bar value
+ * @property {string} [color] - 커스텀 색상 / Custom color
+ * @property {boolean} [highlight] - 강조 표시 여부 / Highlight display
+ */
+export interface BarChartData {
+    label: string;
+    value: number;
+    color?: string;
+    highlight?: boolean;
+}
+/**
+ * BarChart 컴포넌트의 props / BarChart component props
+ * @typedef {Object} BarChartProps
+ * @property {BarChartData[]} data - 차트 데이터 배열 / Chart data array
+ * @property {string} [title] - 차트 제목 / Chart title
+ * @property {number} [height=200] - 차트 높이 (px) / Chart height (px)
+ * @property {boolean} [showValues=true] - 값 표시 여부 / Show values
+ * @property {boolean} [showLabels=true] - 라벨 표시 여부 / Show labels
+ * @property {number} [maxValue] - 최대값 (자동 계산 시 생략) / Maximum value (omit for auto-calculation)
+ * @property {"blue" | "purple" | "green" | "orange" | "red" | "indigo" | "pink" | "gray"} [colorScheme="blue"] - 색상 스킴 / Color scheme
+ * @property {"default" | "gradient"} [variant="gradient"] - 차트 스타일 변형 / Chart style variant
+ * @property {boolean} [showGrid=true] - 그리드 표시 여부 / Show grid
+ * @property {boolean} [showTooltip] - 툴팁 표시 여부 / Show tooltip
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface BarChartProps extends React.HTMLAttributes<HTMLDivElement> {
+    data: BarChartData[];
+    title?: string;
+    height?: number;
+    showValues?: boolean;
+    showLabels?: boolean;
+    maxValue?: number;
+    colorScheme?: "blue" | "purple" | "green" | "orange" | "red" | "indigo" | "pink" | "gray";
+    variant?: "default" | "gradient";
+    showGrid?: boolean;
+    showTooltip?: boolean;
+}
+/**
+ * BarChart 컴포넌트
+ *
+ * 막대 차트를 표시하는 컴포넌트입니다.
+ * 다양한 색상 스킴과 그라디언트 스타일을 지원합니다.
+ *
+ * Bar chart component that displays data in bar format.
+ * Supports various color schemes and gradient styles.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <BarChart
+ *   data={[
+ *     { label: "월", value: 100 },
+ *     { label: "화", value: 200 },
+ *     { label: "수", value: 150 }
+ *   ]}
+ *   title="주간 매출"
+ * />
+ *
+ * @example
+ * // 커스텀 색상 및 강조 / Custom color and highlight
+ * <BarChart
+ *   data={[
+ *     { label: "1월", value: 1000, highlight: true },
+ *     { label: "2월", value: 1200 },
+ *     { label: "3월", value: 1500 }
+ *   ]}
+ *   colorScheme="green"
+ *   variant="gradient"
+ *   showTooltip
+ * />
+ *
+ * @param {BarChartProps} props - BarChart 컴포넌트의 props / BarChart component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} BarChart 컴포넌트 / BarChart component
+ */
+export declare const BarChart: React.ForwardRefExoticComponent<BarChartProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=BarChart.d.ts.map

package/dist/components/dashboard/BarChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BarChart.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/BarChart.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1F,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA6CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,QAAQ,sFAyKpB,CAAC"}