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

package/dist/components/ThemeProvider.d.ts

@@ -1,5 +1,14 @@
-import * as React from "react";
+import React from "react";
 type Theme = "light" | "dark" | "system";
+/**
+ * ThemeProvider 컴포넌트의 props / ThemeProvider component props
+ * @typedef {Object} ThemeProviderProps
+ * @property {React.ReactNode} children - 자식 컴포넌트 / Child components
+ * @property {"light" | "dark" | "system"} [defaultTheme="light"] - 기본 테마 / Default theme
+ * @property {string} [storageKey="hua-ui-theme"] - localStorage 키 / localStorage key
+ * @property {boolean} [enableSystem=true] - 시스템 테마 감지 활성화 / Enable system theme detection
+ * @property {boolean} [enableTransition=true] - 테마 전환 애니메이션 활성화 / Enable theme transition animation
+ */
 interface ThemeProviderProps {
     children: React.ReactNode;
     defaultTheme?: Theme;
@@ -7,13 +16,69 @@ interface ThemeProviderProps {
     enableSystem?: boolean;
     enableTransition?: boolean;
 }
+/**
+ * ThemeProvider의 상태 타입 / ThemeProvider state type
+ * @typedef {Object} ThemeProviderState
+ * @property {"light" | "dark" | "system"} theme - 현재 테마 / Current theme
+ * @property {(theme: "light" | "dark" | "system") => void} setTheme - 테마 설정 함수 / Theme setter function
+ * @property {"light" | "dark"} resolvedTheme - 실제 적용된 테마 (system일 경우 시스템 테마) / Actually applied theme (system theme when system is selected)
+ * @property {() => void} toggleTheme - 테마 토글 함수 / Theme toggle function
+ */
 interface ThemeProviderState {
     theme: Theme;
     setTheme: (theme: Theme) => void;
     resolvedTheme: "light" | "dark";
     toggleTheme: () => void;
 }
-export declare function ThemeProvider({ children, defaultTheme, storageKey, enableSystem, enableTransition, ...props }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * ThemeProvider 컴포넌트 / ThemeProvider component
+ *
+ * 테마 관리를 위한 Context Provider 컴포넌트입니다.
+ * localStorage에 테마를 저장하고, 시스템 테마를 감지할 수 있습니다.
+ * useTheme 훅을 통해 테마 상태에 접근할 수 있습니다.
+ *
+ * Context Provider component for theme management.
+ * Saves theme to localStorage and can detect system theme.
+ * Access theme state through useTheme hook.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <ThemeProvider>
+ *   <App />
+ * </ThemeProvider>
+ *
+ * @example
+ * // 커스텀 설정 / Custom settings
+ * <ThemeProvider
+ *   defaultTheme="dark"
+ *   storageKey="my-app-theme"
+ *   enableSystem={true}
+ *   enableTransition={true}
+ * >
+ *   <App />
+ * </ThemeProvider>
+ *
+ * @param {ThemeProviderProps} props - ThemeProvider 컴포넌트의 props / ThemeProvider component props
+ * @returns {JSX.Element} ThemeProvider 컴포넌트 / ThemeProvider component
+ */
+export declare function ThemeProvider({ children, defaultTheme, // system에서 light로 변경
+storageKey, enableSystem, enableTransition, ...props }: ThemeProviderProps): React.ReactElement;
+/**
+ * useTheme 훅 / useTheme hook
+ *
+ * ThemeProvider의 테마 상태에 접근하는 훅입니다.
+ * ThemeProvider 내부에서만 사용할 수 있습니다.
+ *
+ * Hook to access ThemeProvider's theme state.
+ * Can only be used inside ThemeProvider.
+ *
+ * @example
+ * const { theme, setTheme, resolvedTheme, toggleTheme } = useTheme()
+ *
+ * @returns {ThemeProviderState} 테마 상태와 함수들 / Theme state and functions
+ * @throws {Error} ThemeProvider 외부에서 사용 시 에러 발생 / Error when used outside ThemeProvider
+ */
 export declare const useTheme: () => ThemeProviderState;
 export {};
 //# sourceMappingURL=ThemeProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/components/ThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAExC,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,YAAY,CAAC,EAAE,KAAK,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAA;IAC/B,WAAW,EAAE,MAAM,IAAI,CAAA;CACxB;AAWD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAuB,EACvB,UAA2B,EAC3B,YAAmB,EACnB,gBAAuB,EACvB,GAAG,KAAK,EACT,EAAE,kBAAkB,2CAyEpB;AAED,eAAO,MAAM,QAAQ,0BAOpB,CAAA"}
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/components/ThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyD,MAAM,OAAO,CAAA;AAE7E,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAExC;;;;;;;;GAQG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,YAAY,CAAC,EAAE,KAAK,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAA;IAC/B,WAAW,EAAE,MAAM,IAAI,CAAA;CACxB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAsB,EAAG,qBAAqB;AAC9C,UAA2B,EAC3B,YAAmB,EACnB,gBAAuB,EACvB,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAyEzC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,0BAOpB,CAAA"}

package/dist/components/ThemeToggle.d.ts

@@ -1,3 +1,15 @@
+/**
+ * ThemeToggle 컴포넌트의 props / ThemeToggle component props
+ * @typedef {Object} ThemeToggleProps
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ * @property {"sm" | "md" | "lg"} [size="md"] - Toggle 크기 / Toggle size
+ * @property {"button" | "icon" | "switch"} [variant="button"] - Toggle 스타일 변형 / Toggle style variant
+ * @property {boolean} [showLabel=false] - 라벨 표시 여부 / Show label
+ * @property {Object} [label] - 커스텀 라벨 텍스트 / Custom label text
+ * @property {string} [label.light="라이트"] - 라이트 모드 라벨 / Light mode label
+ * @property {string} [label.dark="다크"] - 다크 모드 라벨 / Dark mode label
+ * @property {string} [label.system="시스템"] - 시스템 모드 라벨 / System mode label
+ */
 interface ThemeToggleProps {
     className?: string;
     size?: "sm" | "md" | "lg";
@@ -9,6 +21,38 @@ interface ThemeToggleProps {
         system?: string;
     };
 }
+/**
+ * ThemeToggle 컴포넌트 / ThemeToggle component
+ *
+ * 테마를 전환하는 토글 컴포넌트입니다.
+ * ThemeProvider와 함께 사용하며, light/dark/system 테마를 지원합니다.
+ *
+ * Toggle component for switching themes.
+ * Used with ThemeProvider, supports light/dark/system themes.
+ *
+ * @component
+ * @example
+ * // 기본 사용 (버튼 스타일) / Basic usage (button style)
+ * <ThemeToggle />
+ *
+ * @example
+ * // 아이콘만 표시 / Icon only
+ * <ThemeToggle variant="icon" size="lg" />
+ *
+ * @example
+ * // Switch 스타일 / Switch style
+ * <ThemeToggle variant="switch" />
+ *
+ * @example
+ * // 라벨과 함께 / With label
+ * <ThemeToggle
+ *   showLabel
+ *   label={{ light: "밝게", dark: "어둡게" }}
+ * />
+ *
+ * @param {ThemeToggleProps} props - ThemeToggle 컴포넌트의 props / ThemeToggle component props
+ * @returns {JSX.Element} ThemeToggle 컴포넌트 / ThemeToggle component
+ */
 export declare function ThemeToggle({ className, size, variant, showLabel, label, ...props }: ThemeToggleProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=ThemeToggle.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ThemeToggle.d.ts","sourceRoot":"","sources":["../../src/components/ThemeToggle.tsx"],"names":[],"mappings":"AAOA,UAAU,gBAAgB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,IAAW,EACX,OAAkB,EAClB,SAAiB,EACjB,KAIC,EACD,GAAG,KAAK,EACT,EAAE,gBAAgB,2CAiHlB"}
+{"version":3,"file":"ThemeToggle.d.ts","sourceRoot":"","sources":["../../src/components/ThemeToggle.tsx"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,UAAU,gBAAgB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,IAAW,EACX,OAAkB,EAClB,SAAiB,EACjB,KAIC,EACD,GAAG,KAAK,EACT,EAAE,gBAAgB,2CAiHlB"}

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"}