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

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

@@ -0,0 +1,89 @@
+import React from "react";
+import type { IconName } from "../../lib/icons";
+/**
+ * NotificationItem 인터페이스
+ * @typedef {Object} NotificationItem
+ * @property {string} id - 알림 고유 ID
+ * @property {string} title - 알림 제목
+ * @property {string} message - 알림 메시지
+ * @property {Date | string} timestamp - 알림 타임스탬프
+ * @property {"info" | "warning" | "error" | "success"} [type] - 알림 타입
+ * @property {IconName | React.ReactNode} [icon] - 아이콘
+ * @property {() => void} [onClick] - 클릭 핸들러
+ * @property {string} [href] - 링크 URL
+ */
+export interface NotificationItem {
+    id: string;
+    title: string;
+    message: string;
+    timestamp: Date | string;
+    type?: "info" | "warning" | "error" | "success";
+    icon?: IconName | React.ReactNode;
+    onClick?: () => void;
+    href?: string;
+}
+/**
+ * NotificationCard 컴포넌트의 props / NotificationCard component props
+ * @typedef {Object} NotificationCardProps
+ * @property {string} [title="알림 및 공지"] - 카드 제목 / Card title
+ * @property {NotificationItem[]} items - 알림 항목 배열 / Notification items array
+ * @property {string} [emptyMessage="알림이 없습니다."] - 빈 상태 메시지 / Empty state message
+ * @property {number} [maxItems] - 최대 표시 항목 수 / Maximum items to display
+ * @property {() => void} [onViewAll] - 전체 보기 핸들러 / View all handler
+ * @property {string} [viewAllLabel="모든 알림 보기"] - 전체 보기 라벨 / View all label
+ * @property {boolean} [showHeader=true] - 헤더 표시 여부 / Show header
+ * @property {boolean} [showCount=true] - 개수 표시 여부 / Show count
+ * @property {React.ReactNode} [emptyState] - 빈 상태 컴포넌트 / Empty state component
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface NotificationCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    title?: string;
+    items: NotificationItem[];
+    emptyMessage?: string;
+    maxItems?: number;
+    onViewAll?: () => void;
+    viewAllLabel?: string;
+    showHeader?: boolean;
+    showCount?: boolean;
+    emptyState?: React.ReactNode;
+}
+/**
+ * NotificationCard 컴포넌트 / NotificationCard component
+ *
+ * 알림 목록을 표시하는 카드 컴포넌트입니다.
+ * 여러 알림 항목을 표시하며, 타입별로 다른 스타일을 적용할 수 있습니다.
+ *
+ * Card component that displays a list of notifications.
+ * Shows multiple notification items and can apply different styles by type.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <NotificationCard
+ *   items={[
+ *     {
+ *       id: "1",
+ *       title: "새 주문",
+ *       message: "주문 #1234가 생성되었습니다",
+ *       timestamp: new Date(),
+ *       type: "success"
+ *     }
+ *   ]}
+ * />
+ *
+ * @example
+ * // 최대 항목 수 제한 / Maximum items limit
+ * <NotificationCard
+ *   title="최근 알림"
+ *   items={notifications}
+ *   maxItems={5}
+ *   onViewAll={() => navigate("/notifications")}
+ *   showCount
+ * />
+ *
+ * @param {NotificationCardProps} props - NotificationCard 컴포넌트의 props / NotificationCard component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} NotificationCard 컴포넌트 / NotificationCard component
+ */
+export declare const NotificationCard: React.ForwardRefExoticComponent<NotificationCardProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=NotificationCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationCard.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/NotificationCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAChD,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,gBAAgB,8FAuI5B,CAAC"}

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

@@ -0,0 +1,82 @@
+import React from "react";
+/**
+ * 멤버십 등급 인터페이스
+ * @typedef {Object} MembershipTier
+ * @property {"basic" | "pro" | "premium" | "admin"} tier - 등급
+ * @property {string} label - 등급 라벨
+ */
+export interface MembershipTier {
+    tier: "basic" | "pro" | "premium" | "admin";
+    label: string;
+}
+/**
+ * ProfileCard 컴포넌트의 props / ProfileCard component props
+ * @typedef {Object} ProfileCardProps
+ * @property {string} name - 사용자 이름 / User name
+ * @property {string} [email] - 이메일 / Email
+ * @property {string} [avatar] - 아바타 이미지 URL / Avatar image URL
+ * @property {string} [avatarAlt] - 아바타 대체 텍스트 / Avatar alt text
+ * @property {string} [greeting] - 인사말 / Greeting
+ * @property {Date | string} [memberSince] - 가입일 / Member since date
+ * @property {MembershipTier["tier"]} [membershipTier] - 멤버십 등급 / Membership tier
+ * @property {string} [membershipLabel] - 멤버십 라벨 / Membership label
+ * @property {() => void} [onSettingsClick] - 설정 클릭 핸들러 / Settings click handler
+ * @property {string} [settingsHref] - 설정 링크 URL / Settings link URL
+ * @property {"default" | "gradient" | "minimal"} [variant="default"] - 스타일 변형 / Style variant
+ * @property {boolean} [showAvatar=true] - 아바타 표시 여부 / Show avatar
+ * @property {boolean} [showMembership=true] - 멤버십 표시 여부 / Show membership
+ * @property {boolean} [showSettings=true] - 설정 버튼 표시 여부 / Show settings button
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface ProfileCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    name: string;
+    email?: string;
+    avatar?: string;
+    avatarAlt?: string;
+    greeting?: string;
+    memberSince?: Date | string;
+    membershipTier?: MembershipTier["tier"];
+    membershipLabel?: string;
+    onSettingsClick?: () => void;
+    settingsHref?: string;
+    variant?: "default" | "gradient" | "minimal";
+    showAvatar?: boolean;
+    showMembership?: boolean;
+    showSettings?: boolean;
+}
+/**
+ * ProfileCard 컴포넌트
+ *
+ * 사용자 프로필 정보를 표시하는 카드 컴포넌트입니다.
+ * 아바타, 이름, 이메일, 멤버십 등급 등을 표시할 수 있습니다.
+ *
+ * Card component that displays user profile information.
+ * Can show avatar, name, email, membership tier, and more.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <ProfileCard
+ *   name="홍길동"
+ *   email="hong@example.com"
+ *   avatar="/avatar.jpg"
+ *   membershipTier="premium"
+ *   memberSince={new Date("2024-01-01")}
+ * />
+ *
+ * @example
+ * // 그라디언트 스타일 / Gradient style
+ * <ProfileCard
+ *   name="김철수"
+ *   greeting="안녕하세요"
+ *   variant="gradient"
+ *   membershipTier="pro"
+ *   onSettingsClick={() => navigate("/settings")}
+ * />
+ *
+ * @param {ProfileCardProps} props - ProfileCard 컴포넌트의 props / ProfileCard component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} ProfileCard 컴포넌트 / ProfileCard component
+ */
+export declare const ProfileCard: React.ForwardRefExoticComponent<ProfileCardProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=ProfileCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileCard.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/ProfileCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,WAAW,yFA0KvB,CAAC"}

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

@@ -0,0 +1,71 @@
+import React from "react";
+import type { IconName } from "../../lib/icons";
+import type { Color } from "../../lib/types/common";
+/**
+ * ProgressCard 컴포넌트의 props / ProgressCard component props
+ * @typedef {Object} ProgressCardProps
+ * @property {string} title - 카드 제목 / Card title
+ * @property {number} current - 현재 값 / Current value
+ * @property {number} total - 전체 값 / Total value
+ * @property {string} [unit] - 단위 / Unit
+ * @property {string} [description] - 카드 설명 / Card description
+ * @property {IconName | React.ReactNode} [icon] - 아이콘 / Icon
+ * @property {"blue" | "purple" | "green" | "orange" | "red" | "indigo" | "pink" | "gray"} [color] - 카드 색상 / Card color
+ * @property {"default" | "gradient" | "outline" | "elevated"} [variant="default"] - 카드 스타일 변형 / Card style variant
+ * @property {boolean} [showPercentage] - 퍼센트 표시 여부 / Show percentage
+ * @property {boolean} [showLabel] - 라벨 표시 여부 / Show label
+ * @property {"sm" | "md" | "lg"} [size="md"] - 카드 크기 / Card size
+ * @property {boolean} [loading] - 로딩 상태 / Loading state
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface ProgressCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    title: string;
+    current: number;
+    total: number;
+    unit?: string;
+    description?: string;
+    icon?: IconName | React.ReactNode;
+    color?: Color;
+    variant?: "default" | "gradient" | "outline" | "elevated";
+    showPercentage?: boolean;
+    showLabel?: boolean;
+    size?: "sm" | "md" | "lg";
+    loading?: boolean;
+}
+/**
+ * ProgressCard 컴포넌트 / ProgressCard component
+ *
+ * 진행률을 표시하는 카드 컴포넌트입니다.
+ * 현재 값과 전체 값을 비교하여 진행률을 시각적으로 표시합니다.
+ *
+ * Card component that displays progress.
+ * Compares current value with total value to visually display progress.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <ProgressCard
+ *   title="목표 달성률"
+ *   current={75}
+ *   total={100}
+ *   unit="%"
+ *   description="이번 달 목표"
+ * />
+ *
+ * @example
+ * // 퍼센트 표시 / Show percentage
+ * <ProgressCard
+ *   title="판매 진행률"
+ *   current={150}
+ *   total={200}
+ *   showPercentage
+ *   color="green"
+ *   variant="gradient"
+ * />
+ *
+ * @param {ProgressCardProps} props - ProgressCard 컴포넌트의 props / ProgressCard component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} ProgressCard 컴포넌트 / ProgressCard component
+ */
+export declare const ProgressCard: React.ForwardRefExoticComponent<ProgressCardProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=ProgressCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressCard.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/ProgressCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAyCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,YAAY,0FA8JxB,CAAC"}

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

@@ -0,0 +1,63 @@
+import React from "react";
+import type { IconName } from "../../lib/icons";
+import type { Color } from "../../lib/types/common";
+/**
+ * QuickActionCard 컴포넌트의 props / QuickActionCard component props
+ * @typedef {Object} QuickActionCardProps
+ * @property {string} title - 카드 제목 / Card title
+ * @property {string} [description] - 카드 설명 / Card description
+ * @property {IconName | React.ReactNode} [icon] - 아이콘 / Icon
+ * @property {string} [href] - 링크 URL / Link URL
+ * @property {() => void} [onClick] - 클릭 핸들러 / Click handler
+ * @property {"gradient" | "outline" | "solid"} [variant="gradient"] - 카드 스타일 변형 / Card style variant
+ * @property {"blue" | "purple" | "green" | "orange" | "red" | "indigo" | "pink" | "gray"} [color="blue"] - 카드 색상 / Card color
+ * @property {boolean} [loading] - 로딩 상태 / Loading state
+ * @extends {React.HTMLAttributes<HTMLAnchorElement | HTMLButtonElement>}
+ */
+export interface QuickActionCardProps extends React.HTMLAttributes<HTMLAnchorElement | HTMLButtonElement> {
+    title: string;
+    description?: string;
+    icon?: IconName | React.ReactNode;
+    href?: string;
+    onClick?: () => void;
+    variant?: "gradient" | "outline" | "solid";
+    color?: Color;
+    loading?: boolean;
+}
+/**
+ * QuickActionCard 컴포넌트 / QuickActionCard component
+ *
+ * 빠른 액션을 수행하는 카드 컴포넌트입니다.
+ * 링크나 버튼으로 동작하며, 클릭 가능한 액션 카드로 사용됩니다.
+ *
+ * Card component for quick actions.
+ * Works as a link or button, used as a clickable action card.
+ *
+ * @component
+ * @example
+ * // 링크 카드 / Link card
+ * <QuickActionCard
+ *   title="새 주문 생성"
+ *   description="주문을 빠르게 생성하세요"
+ *   icon="plus"
+ *   href="/orders/new"
+ *   color="blue"
+ * />
+ *
+ * @example
+ * // 버튼 카드 / Button card
+ * <QuickActionCard
+ *   title="리포트 다운로드"
+ *   description="최신 리포트를 다운로드하세요"
+ *   icon="download"
+ *   onClick={handleDownload}
+ *   variant="outline"
+ *   color="green"
+ * />
+ *
+ * @param {QuickActionCardProps} props - QuickActionCard 컴포넌트의 props / QuickActionCard component props
+ * @param {React.Ref<HTMLAnchorElement | HTMLButtonElement>} ref - anchor 또는 button 요소 ref / anchor or button element ref
+ * @returns {JSX.Element} QuickActionCard 컴포넌트 / QuickActionCard component
+ */
+export declare const QuickActionCard: React.ForwardRefExoticComponent<QuickActionCardProps & React.RefAttributes<HTMLAnchorElement | HTMLButtonElement>>;
+//# sourceMappingURL=QuickActionCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuickActionCard.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/QuickActionCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAqB,SAAQ,KAAK,CAAC,cAAc,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IACvG,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IAC3C,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,eAAe,oHAgI3B,CAAC"}

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

@@ -0,0 +1,88 @@
+import React from "react";
+type RoutingStatus = "normal" | "warning" | "critical";
+/**
+ * 라우팅 분할 세그먼트 인터페이스 / RoutingBreakdownSegment interface
+ * @typedef {Object} RoutingBreakdownSegment
+ * @property {string} id - 세그먼트 고유 ID / Segment unique ID
+ * @property {string} label - 세그먼트 라벨 / Segment label
+ * @property {number} value - 세그먼트 값 / Segment value
+ * @property {string} [color] - 커스텀 색상 / Custom color
+ * @property {RoutingStatus} [status] - 상태 / Status
+ * @property {string} [icon] - 아이콘 이름 / Icon name
+ * @property {string} [detail] - 상세 정보 / Detail information
+ */
+export interface RoutingBreakdownSegment {
+    id: string;
+    label: string;
+    value: number;
+    color?: string;
+    status?: RoutingStatus;
+    icon?: string;
+    detail?: string;
+}
+/**
+ * RoutingBreakdownCard 컴포넌트의 props / RoutingBreakdownCard component props
+ * @typedef {Object} RoutingBreakdownCardProps
+ * @property {string} [title="PG / 결제수단 비중"] - 카드 제목 / Card title
+ * @property {string} [description="라우팅별 처리 비율과 상태"] - 카드 설명 / Card description
+ * @property {RoutingBreakdownSegment[]} segments - 세그먼트 배열 / Segments array
+ * @property {string} [totalLabel="총 거래"] - 총계 라벨 / Total label
+ * @property {React.ReactNode} [totalValue] - 총계 값 / Total value
+ * @property {string} [highlightId] - 강조할 세그먼트 ID / Highlighted segment ID
+ * @property {React.ReactNode} [actions] - 액션 컴포넌트 / Actions component
+ * @property {React.ReactNode} [emptyState] - 빈 상태 컴포넌트 / Empty state component
+ * @property {(segment: RoutingBreakdownSegment, percentage: number) => React.ReactNode} [formatter] - 커스텀 포맷터 / Custom formatter
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface RoutingBreakdownCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    title?: string;
+    description?: string;
+    segments: RoutingBreakdownSegment[];
+    totalLabel?: string;
+    totalValue?: React.ReactNode;
+    highlightId?: string;
+    actions?: React.ReactNode;
+    emptyState?: React.ReactNode;
+    formatter?: (segment: RoutingBreakdownSegment, percentage: number) => React.ReactNode;
+}
+/**
+ * RoutingBreakdownCard 컴포넌트
+ *
+ * PG 라우팅 또는 결제수단별 비중을 표시하는 카드 컴포넌트입니다.
+ * 진행 바와 세그먼트별 상세 정보를 제공합니다.
+ *
+ * Card component that displays PG routing or payment method breakdown.
+ * Provides progress bar and detailed information for each segment.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <RoutingBreakdownCard
+ *   title="PG 라우팅 비중"
+ *   segments={[
+ *     { id: "pg1", label: "PG A", value: 5000, status: "normal" },
+ *     { id: "pg2", label: "PG B", value: 3000, status: "warning" },
+ *     { id: "pg3", label: "PG C", value: 2000, status: "normal" }
+ *   ]}
+ *   totalValue="10,000"
+ * />
+ *
+ * @example
+ * // 강조 기능 / Highlight feature
+ * <RoutingBreakdownCard
+ *   segments={segments}
+ *   highlightId="pg1"
+ *   formatter={(segment, percentage) => (
+ *     <div>
+ *       <span>{segment.value.toLocaleString()}</span>
+ *       <span>{percentage}%</span>
+ *     </div>
+ *   )}
+ * />
+ *
+ * @param {RoutingBreakdownCardProps} props - RoutingBreakdownCard 컴포넌트의 props / RoutingBreakdownCard component props
+ * @returns {JSX.Element} RoutingBreakdownCard 컴포넌트 / RoutingBreakdownCard component
+ */
+export declare const RoutingBreakdownCard: React.FC<RoutingBreakdownCardProps>;
+export {};
+//# sourceMappingURL=RoutingBreakdownCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RoutingBreakdownCard.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/RoutingBreakdownCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,KAAK,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yBAA0B,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;CACvF;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA8HpE,CAAC"}

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

@@ -0,0 +1,90 @@
+import React from "react";
+import type { IconName } from "../../lib/icons";
+export type SettlementTimelineStatus = "pending" | "processing" | "completed" | "failed";
+/**
+ * 정산 타임라인 아이템 인터페이스 / SettlementTimelineItem interface
+ * @typedef {Object} SettlementTimelineItem
+ * @property {string} id - 아이템 고유 ID / Item unique ID
+ * @property {string} title - 제목 / Title
+ * @property {string} [description] - 설명 / Description
+ * @property {SettlementTimelineStatus} status - 상태 / Status
+ * @property {number} [amount] - 금액 / Amount
+ * @property {string} [currency] - 통화 / Currency
+ * @property {string | Date} [date] - 날짜 / Date
+ * @property {string} [meta] - 메타 정보 / Meta information
+ * @property {IconName} [icon] - 아이콘 / Icon
+ */
+export interface SettlementTimelineItem {
+    id: string;
+    title: string;
+    description?: string;
+    status: SettlementTimelineStatus;
+    amount?: number;
+    currency?: string;
+    date?: string | Date;
+    meta?: string;
+    icon?: IconName;
+}
+/**
+ * SettlementTimeline 컴포넌트의 props / SettlementTimeline component props
+ * @typedef {Object} SettlementTimelineProps
+ * @property {SettlementTimelineItem[]} items - 타임라인 아이템 배열 / Timeline items array
+ * @property {string} [highlightedId] - 강조할 아이템 ID / Highlighted item ID
+ * @property {string} [locale="ko-KR"] - 로케일 / Locale
+ * @property {string} [defaultCurrency="KRW"] - 기본 통화 / Default currency
+ * @property {React.ReactNode} [emptyState] - 빈 상태 컴포넌트 / Empty state component
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface SettlementTimelineProps extends React.HTMLAttributes<HTMLDivElement> {
+    items: SettlementTimelineItem[];
+    highlightedId?: string;
+    locale?: string;
+    defaultCurrency?: string;
+    emptyState?: React.ReactNode;
+}
+/**
+ * SettlementTimeline 컴포넌트
+ *
+ * 정산 처리 단계를 타임라인 형태로 표시하는 컴포넌트입니다.
+ * 각 단계의 상태, 금액, 날짜를 시각적으로 표시합니다.
+ *
+ * Timeline component that displays settlement processing stages.
+ * Visually shows status, amount, and date for each stage.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <SettlementTimeline
+ *   items={[
+ *     {
+ *       id: "1",
+ *       title: "정산 요청",
+ *       status: "completed",
+ *       amount: 1000000,
+ *       currency: "KRW",
+ *       date: new Date("2024-01-01")
+ *     },
+ *     {
+ *       id: "2",
+ *       title: "처리 중",
+ *       status: "processing",
+ *       amount: 1000000,
+ *       currency: "KRW"
+ *     }
+ *   ]}
+ * />
+ *
+ * @example
+ * // 강조 기능 / Highlight feature
+ * <SettlementTimeline
+ *   items={timelineItems}
+ *   highlightedId="2"
+ *   locale="en-US"
+ *   defaultCurrency="USD"
+ * />
+ *
+ * @param {SettlementTimelineProps} props - SettlementTimeline 컴포넌트의 props / SettlementTimeline component props
+ * @returns {JSX.Element} SettlementTimeline 컴포넌트 / SettlementTimeline component
+ */
+export declare const SettlementTimeline: React.FC<SettlementTimelineProps>;
+//# sourceMappingURL=SettlementTimeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SettlementTimeline.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/SettlementTimeline.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEzF;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAwB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACnF,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA8GhE,CAAC"}

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

@@ -0,0 +1,70 @@
+import React from "react";
+import type { IconName } from "../../lib/icons";
+import type { Color } from "../../lib/types/common";
+/**
+ * StatCard 컴포넌트의 props / StatCard component props
+ * @typedef {Object} StatCardProps
+ * @property {string} title - 카드 제목 / Card title
+ * @property {string | number | null | undefined} value - 통계 값 / Statistic value
+ * @property {string} [description] - 카드 설명 / Card description
+ * @property {IconName | React.ReactNode} [icon] - 아이콘 / Icon
+ * @property {Object} [trend] - 추세 정보 / Trend information
+ * @property {number} trend.value - 추세 값 / Trend value
+ * @property {string} trend.label - 추세 라벨 / Trend label
+ * @property {boolean} [trend.positive] - 긍정적 추세 여부 / Positive trend
+ * @property {"default" | "gradient" | "outline" | "elevated"} [variant="default"] - 카드 스타일 변형 / Card style variant
+ * @property {"blue" | "purple" | "green" | "orange" | "red" | "indigo" | "pink" | "gray"} [color] - 카드 색상 / Card color
+ * @property {boolean} [loading] - 로딩 상태 / Loading state
+ * @property {React.ReactNode} [emptyState] - 빈 상태 컴포넌트 / Empty state component
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface StatCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    title: string;
+    value: string | number | null | undefined;
+    description?: string;
+    icon?: IconName | React.ReactNode;
+    trend?: {
+        value: number;
+        label: string;
+        positive?: boolean;
+    };
+    variant?: "default" | "gradient" | "outline" | "elevated";
+    color?: Color;
+    loading?: boolean;
+    emptyState?: React.ReactNode;
+}
+/**
+ * StatCard 컴포넌트 / StatCard component
+ *
+ * 통계 정보를 표시하는 카드 컴포넌트입니다.
+ * 제목, 값, 설명, 아이콘, 추세 정보를 포함할 수 있습니다.
+ *
+ * Card component that displays statistic information.
+ * Can include title, value, description, icon, and trend information.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <StatCard
+ *   title="총 사용자"
+ *   value="1,234"
+ *   description="지난 달 대비"
+ *   icon="users"
+ * />
+ *
+ * @example
+ * // 추세 정보 포함 / With trend information
+ * <StatCard
+ *   title="매출"
+ *   value="₩1,000,000"
+ *   trend={{ value: 12.5, label: "전월 대비", positive: true }}
+ *   color="green"
+ *   variant="gradient"
+ * />
+ *
+ * @param {StatCardProps} props - StatCard 컴포넌트의 props / StatCard component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} StatCard 컴포넌트 / StatCard component
+ */
+export declare const StatCard: React.ForwardRefExoticComponent<StatCardProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=StatCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StatCard.d.ts","sourceRoot":"","sources":["../../../src/components/dashboard/StatCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,QAAQ,sFA4IpB,CAAC"}

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

@@ -0,0 +1,73 @@
+import React from "react";
+import type { IconName } from "../../lib/icons";
+import type { Color } from "../../lib/types/common";
+/**
+ * SummaryCard 컴포넌트의 props
+ * @typedef {Object} SummaryCardProps
+ * @property {string} title - 카드 제목
+ * @property {string | number} value - 요약 값
+ * @property {string} [subtitle] - 부제목
+ * @property {IconName | React.ReactNode} [icon] - 아이콘
+ * @property {"blue" | "purple" | "green" | "orange" | "red" | "indigo" | "pink" | "gray"} [color] - 카드 색상
+ * @property {"default" | "gradient" | "outline"} [variant="default"] - 카드 스타일 변형
+ * @property {string} [href] - 링크 URL
+ * @property {() => void} [onClick] - 클릭 핸들러
+ * @property {boolean} [loading] - 로딩 상태
+ * @property {string | React.ReactNode} [badge] - 배지
+ * @property {React.ReactNode} [footer] - 푸터 콘텐츠
+ * @property {boolean} [showAction] - 액션 버튼 표시 여부
+ * @property {string} [actionLabel] - 액션 버튼 라벨
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface SummaryCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    title: string;
+    value: string | number;
+    subtitle?: string;
+    icon?: IconName | React.ReactNode;
+    color?: Color;
+    variant?: "default" | "gradient" | "outline";
+    href?: string;
+    onClick?: () => void;
+    loading?: boolean;
+    badge?: string | React.ReactNode;
+    footer?: React.ReactNode;
+    showAction?: boolean;
+    actionLabel?: string;
+}
+/**
+ * SummaryCard 컴포넌트 / SummaryCard component
+ *
+ * 요약 정보를 표시하는 카드 컴포넌트입니다.
+ * 제목, 값, 부제목, 아이콘을 포함하며, 클릭 가능한 링크나 액션 버튼을 지원합니다.
+ *
+ * Card component that displays summary information.
+ * Includes title, value, subtitle, icon, and supports clickable links or action buttons.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <SummaryCard
+ *   title="총 매출"
+ *   value="₩10,000,000"
+ *   subtitle="이번 달"
+ *   icon="dollarSign"
+ * />
+ *
+ * @example
+ * // 클릭 가능한 카드 / Clickable card
+ * <SummaryCard
+ *   title="주문"
+ *   value="1,234"
+ *   href="/orders"
+ *   showAction
+ *   actionLabel="자세히 보기"
+ *   color="blue"
+ *   variant="gradient"
+ * />
+ *
+ * @param {SummaryCardProps} props - SummaryCard 컴포넌트의 props / SummaryCard component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} SummaryCard 컴포넌트 / SummaryCard component
+ */
+export declare const SummaryCard: React.ForwardRefExoticComponent<SummaryCardProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=SummaryCard.d.ts.map