@sonhoseong/mfa-lib 1.3.7 → 1.3.10

package/dist/components/toast/ToastContainer.js

@@ -1,4 +1,8 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Toast Container - KOMCA 패턴
+ * 토스트 알림 UI 렌더링
+ */
+import React from 'react';
 import { useToast } from './ToastContext';
 // 타입별 아이콘
 const icons = {
@@ -36,10 +40,17 @@ const ToastContainer = ({ position = 'top-right' }) => {
     };
     if (toasts.length === 0)
         return null;
-    return (_jsxs("div", { style: getPositionStyles(), children: [_jsx("div", { className: "toast-list", children: toasts.map((toast) => (_jsxs("div", { className: `toast-item toast-${toast.type}`, style: {
-                        backgroundColor: colors[toast.type].bg,
-                        borderLeftColor: colors[toast.type].border,
-                    }, children: [_jsx("div", { className: "toast-icon", style: { color: colors[toast.type].icon }, children: icons[toast.type] }), _jsxs("div", { className: "toast-content", children: [toast.title && _jsx("div", { className: "toast-title", children: toast.title }), _jsx("div", { className: "toast-message", children: toast.message })] }), _jsx("button", { className: "toast-close", onClick: () => removeToast(toast.id), "aria-label": "\uB2EB\uAE30", children: "\u2715" })] }, toast.id))) }), _jsx("style", { children: `
+    return (React.createElement("div", { style: getPositionStyles() },
+        React.createElement("div", { className: "toast-list" }, toasts.map((toast) => (React.createElement("div", { key: toast.id, className: `toast-item toast-${toast.type}`, style: {
+                backgroundColor: colors[toast.type].bg,
+                borderLeftColor: colors[toast.type].border,
+            } },
+            React.createElement("div", { className: "toast-icon", style: { color: colors[toast.type].icon } }, icons[toast.type]),
+            React.createElement("div", { className: "toast-content" },
+                toast.title && React.createElement("div", { className: "toast-title" }, toast.title),
+                React.createElement("div", { className: "toast-message" }, toast.message)),
+            React.createElement("button", { className: "toast-close", onClick: () => removeToast(toast.id), "aria-label": "\uB2EB\uAE30" }, "\u2715"))))),
+        React.createElement("style", null, `
                 .toast-list {
                     display: flex;
                     flex-direction: column;
@@ -120,6 +131,6 @@ const ToastContainer = ({ position = 'top-right' }) => {
                     background: rgba(0, 0, 0, 0.1);
                     color: #374151;
                 }
-            ` })] }));
+            `)));
 };
 export default ToastContainer;

package/dist/components/toast/ToastContext.js

@@ -1,9 +1,8 @@
-import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Toast Context - KOMCA 패턴
  * 전역 토스트 알림 상태 관리
  */
-import { createContext, useContext, useCallback, useState } from 'react';
+import React, { createContext, useContext, useCallback, useState } from 'react';
 const ToastContext = createContext(null);
 /**
  * Toast Provider
@@ -41,7 +40,7 @@ export const ToastProvider = ({ children, defaultDuration = 3000, maxToasts = 5,
     const info = useCallback((message, title) => {
         addToast({ type: 'info', message, title });
     }, [addToast]);
-    return (_jsx(ToastContext.Provider, { value: { toasts, addToast, removeToast, success, error, warning, info }, children: children }));
+    return (React.createElement(ToastContext.Provider, { value: { toasts, addToast, removeToast, success, error, warning, info } }, children));
 };
 /**
  * useToast Hook

package/dist/hooks/index.d.ts

@@ -1,11 +1,19 @@
 /**
- * Hooks 모듈 - KOMCA 패턴
+ * Hooks 모듈
  */
 export * from './use-auth';
+export * from './use-supabase-auth';
 export * from './use-initialize';
 export * from './use-track-history';
 export * from './use-navigate';
 export * from './use-global-loading';
 export * from './use-modal';
 export * from './use-error-notification';
+export { default as useNetworkStatus } from './use-network-status';
+export type { ConnectionType } from './use-network-status';
+export * from './use-permission';
+export * from './use-recent-menu';
+export * from './use-debounce';
+export * from './use-scroll-restoration';
+export * from './use-effect-once';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,aAAa,CAAC;AAG5B,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,aAAa,CAAC;AAG5B,cAAc,0BAA0B,CAAC;AAGzC,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,0BAA0B,CAAC;AAGzC,cAAc,mBAAmB,CAAC"}

package/dist/hooks/index.js

@@ -1,8 +1,10 @@
 /**
- * Hooks 모듈 - KOMCA 패턴
+ * Hooks 모듈
  */
 // Auth Hooks
 export * from './use-auth';
+// Supabase Auth Hooks
+export * from './use-supabase-auth';
 // Initialize Hook
 export * from './use-initialize';
 // Track History Hook
@@ -15,3 +17,15 @@ export * from './use-global-loading';
 export * from './use-modal';
 // Error Notification Hook
 export * from './use-error-notification';
+// Network Status Hook
+export { default as useNetworkStatus } from './use-network-status';
+// Permission Hook
+export * from './use-permission';
+// Recent Menu Hook
+export * from './use-recent-menu';
+// Debounce & Throttle Hooks
+export * from './use-debounce';
+// Scroll Restoration Hook
+export * from './use-scroll-restoration';
+// Effect Once & Lifecycle Hooks
+export * from './use-effect-once';

package/dist/hooks/use-auth.d.ts

@@ -1,5 +1,5 @@
 /**
- * Auth Hooks - KOMCA 패턴
+ * Auth Hooks
  * 로그인, 로그아웃, 토큰 갱신
  */
 import { User } from '../types';
@@ -29,6 +29,7 @@ export declare function useLogout(logoutApi?: LogoutFn): () => Promise<void>;
 export declare function useTokenRefresh(refreshApi?: RefreshFn): () => Promise<string | null>;
 /**
  * 인증 상태 확인 Hook
+ * useSelector를 사용하여 상태 변경시 리렌더링 보장
  */
 export declare function useAuthState(): {
     isAuthenticated: boolean;

package/dist/hooks/use-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-auth.d.ts","sourceRoot":"","sources":["../../src/hooks/use-auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGhC,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,IAAI,CAAC;CACZ;AAGD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAGxE,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAG3C,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAErD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,aACN,YAAY,KAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuChF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,QAAQ,SACf,OAAO,CAAC,IAAI,CAAC,CAuB3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,SAAS,SACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BpD;AAED;;GAEG;AACH,wBAAgB,YAAY;;;;EAS3B"}
+{"version":3,"file":"use-auth.d.ts","sourceRoot":"","sources":["../../src/hooks/use-auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGhC,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,IAAI,CAAC;CACZ;AAGD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAGxE,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAG3C,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAErD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,aACN,YAAY,KAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuChF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,QAAQ,SACf,OAAO,CAAC,IAAI,CAAC,CAuB3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,SAAS,SACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2BpD;AAED;;;GAGG;AACH,wBAAgB,YAAY;;;;EAS3B"}

package/dist/hooks/use-auth.js

@@ -1,9 +1,10 @@
 /**
- * Auth Hooks - KOMCA 패턴
+ * Auth Hooks
  * 로그인, 로그아웃, 토큰 갱신
  */
 import { useCallback } from 'react';
-import { getHostStore, dispatchToHost } from '../store/store-access';
+import { useSelector } from 'react-redux';
+import { getStore, setAccessToken, setUser, logout, selectAccessToken, selectUser } from '../store/app-store';
 import { storage } from '../utils/storage';
 /**
  * 로그인 Hook
@@ -11,9 +12,9 @@ import { storage } from '../utils/storage';
 export function useLogin(loginApi) {
     return useCallback(async (request) => {
         try {
+            const store = getStore();
             let response;
             if (loginApi) {
-                // 실제 API 호출
                 response = await loginApi(request);
             }
             else {
@@ -34,8 +35,8 @@ export function useLogin(loginApi) {
                 }
             }
             // Store에 저장
-            dispatchToHost({ type: 'app/setAccessToken', payload: response.accessToken });
-            dispatchToHost({ type: 'app/setUser', payload: response.user });
+            store.dispatch(setAccessToken(response.accessToken));
+            store.dispatch(setUser(response.user));
             // Storage에도 저장 (새로고침 대비)
             storage.setAccessToken(response.accessToken);
             storage.setUser(response.user);
@@ -54,21 +55,20 @@ export function useLogin(loginApi) {
 export function useLogout(logoutApi) {
     return useCallback(async () => {
         try {
+            const store = getStore();
             // API 호출 (있는 경우)
             if (logoutApi) {
                 await logoutApi();
             }
             // Store 초기화
-            dispatchToHost({ type: 'app/setAccessToken', payload: '' });
-            dispatchToHost({ type: 'app/setUser', payload: null });
-            dispatchToHost({ type: 'recentMenu/resetRecentMenu' });
+            store.dispatch(logout());
+            store.dispatch({ type: 'recentMenu/resetRecentMenu' });
             // Storage 초기화
             storage.clearAuth();
             console.log('[Logout] 로그아웃 완료');
         }
         catch (error) {
             console.error('[Logout] 로그아웃 실패:', error);
-            // 에러가 발생해도 로컬 상태는 초기화
             storage.clearAuth();
             throw error;
         }
@@ -80,14 +80,14 @@ export function useLogout(logoutApi) {
 export function useTokenRefresh(refreshApi) {
     return useCallback(async () => {
         try {
+            const store = getStore();
             if (!refreshApi) {
                 console.warn('[Token Refresh] refresh API가 설정되지 않았습니다.');
                 return null;
             }
             const newToken = await refreshApi();
             if (newToken) {
-                // Store에 저장
-                dispatchToHost({ type: 'app/setAccessToken', payload: newToken });
+                store.dispatch(setAccessToken(newToken));
                 storage.setAccessToken(newToken);
                 console.log('[Token Refresh] 토큰 갱신 성공');
                 return newToken;
@@ -96,8 +96,8 @@ export function useTokenRefresh(refreshApi) {
         }
         catch (error) {
             console.error('[Token Refresh] 토큰 갱신 실패:', error);
-            // 갱신 실패시 로그아웃 처리
-            dispatchToHost({ type: 'app/setAccessToken', payload: '' });
+            const store = getStore();
+            store.dispatch(setAccessToken(''));
             storage.setAccessToken('');
             throw error;
         }
@@ -105,13 +105,14 @@ export function useTokenRefresh(refreshApi) {
 }
 /**
  * 인증 상태 확인 Hook
+ * useSelector를 사용하여 상태 변경시 리렌더링 보장
  */
 export function useAuthState() {
-    const store = getHostStore();
-    const state = store?.getState();
+    const accessToken = useSelector(selectAccessToken);
+    const user = useSelector(selectUser);
     return {
-        isAuthenticated: !!state?.app?.accessToken,
-        user: state?.app?.user || null,
-        accessToken: state?.app?.accessToken || '',
+        isAuthenticated: !!accessToken,
+        user,
+        accessToken,
     };
 }

package/dist/hooks/use-debounce.d.ts

@@ -0,0 +1,56 @@
+/**
+ * useDebounce / useThrottle Hooks
+ * 입력 지연 및 스로틀링을 위한 훅
+ */
+/**
+ * useDebounce Hook
+ * 값이 변경된 후 지정된 시간이 지난 뒤에 업데이트
+ *
+ * @example
+ * const [search, setSearch] = useState('');
+ * const debouncedSearch = useDebounce(search, 300);
+ *
+ * useEffect(() => {
+ *   // debouncedSearch 값이 변경될 때만 API 호출
+ *   fetchSearchResults(debouncedSearch);
+ * }, [debouncedSearch]);
+ */
+export declare function useDebounce<T>(value: T, delay?: number): T;
+/**
+ * useDebouncedCallback Hook
+ * 콜백 함수를 디바운스 처리
+ *
+ * @example
+ * const handleSearch = useDebouncedCallback((query: string) => {
+ *   fetchSearchResults(query);
+ * }, 300);
+ *
+ * <input onChange={(e) => handleSearch(e.target.value)} />
+ */
+export declare function useDebouncedCallback<T extends (...args: any[]) => any>(callback: T, delay?: number): (...args: Parameters<T>) => void;
+/**
+ * useThrottle Hook
+ * 값 업데이트를 지정된 간격으로 제한
+ *
+ * @example
+ * const [scrollY, setScrollY] = useState(0);
+ * const throttledScrollY = useThrottle(scrollY, 100);
+ */
+export declare function useThrottle<T>(value: T, interval?: number): T;
+/**
+ * useThrottledCallback Hook
+ * 콜백 함수를 스로틀 처리
+ *
+ * @example
+ * const handleScroll = useThrottledCallback(() => {
+ *   console.log('Scrolling...', window.scrollY);
+ * }, 100);
+ *
+ * useEffect(() => {
+ *   window.addEventListener('scroll', handleScroll);
+ *   return () => window.removeEventListener('scroll', handleScroll);
+ * }, [handleScroll]);
+ */
+export declare function useThrottledCallback<T extends (...args: any[]) => any>(callback: T, interval?: number): (...args: Parameters<T>) => void;
+export default useDebounce;
+//# sourceMappingURL=use-debounce.d.ts.map

package/dist/hooks/use-debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-debounce.d.ts","sourceRoot":"","sources":["../../src/hooks/use-debounce.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAE,MAAY,GAAG,CAAC,CAc/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACpE,QAAQ,EAAE,CAAC,EACX,KAAK,GAAE,MAAY,GAClB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CA8BlC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,GAAE,MAAY,GAAG,CAAC,CAsBlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACpE,QAAQ,EAAE,CAAC,EACX,QAAQ,GAAE,MAAY,GACrB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAqClC;AAED,eAAe,WAAW,CAAC"}

package/dist/hooks/use-debounce.js

@@ -0,0 +1,140 @@
+/**
+ * useDebounce / useThrottle Hooks
+ * 입력 지연 및 스로틀링을 위한 훅
+ */
+import { useState, useEffect, useCallback, useRef } from 'react';
+/**
+ * useDebounce Hook
+ * 값이 변경된 후 지정된 시간이 지난 뒤에 업데이트
+ *
+ * @example
+ * const [search, setSearch] = useState('');
+ * const debouncedSearch = useDebounce(search, 300);
+ *
+ * useEffect(() => {
+ *   // debouncedSearch 값이 변경될 때만 API 호출
+ *   fetchSearchResults(debouncedSearch);
+ * }, [debouncedSearch]);
+ */
+export function useDebounce(value, delay = 300) {
+    const [debouncedValue, setDebouncedValue] = useState(value);
+    useEffect(() => {
+        const timer = setTimeout(() => {
+            setDebouncedValue(value);
+        }, delay);
+        return () => {
+            clearTimeout(timer);
+        };
+    }, [value, delay]);
+    return debouncedValue;
+}
+/**
+ * useDebouncedCallback Hook
+ * 콜백 함수를 디바운스 처리
+ *
+ * @example
+ * const handleSearch = useDebouncedCallback((query: string) => {
+ *   fetchSearchResults(query);
+ * }, 300);
+ *
+ * <input onChange={(e) => handleSearch(e.target.value)} />
+ */
+export function useDebouncedCallback(callback, delay = 300) {
+    const timeoutRef = useRef(null);
+    const callbackRef = useRef(callback);
+    // 콜백 참조 업데이트
+    useEffect(() => {
+        callbackRef.current = callback;
+    }, [callback]);
+    // 클린업
+    useEffect(() => {
+        return () => {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+            }
+        };
+    }, []);
+    return useCallback((...args) => {
+        if (timeoutRef.current) {
+            clearTimeout(timeoutRef.current);
+        }
+        timeoutRef.current = setTimeout(() => {
+            callbackRef.current(...args);
+        }, delay);
+    }, [delay]);
+}
+/**
+ * useThrottle Hook
+ * 값 업데이트를 지정된 간격으로 제한
+ *
+ * @example
+ * const [scrollY, setScrollY] = useState(0);
+ * const throttledScrollY = useThrottle(scrollY, 100);
+ */
+export function useThrottle(value, interval = 300) {
+    const [throttledValue, setThrottledValue] = useState(value);
+    const lastExecuted = useRef(Date.now());
+    useEffect(() => {
+        const now = Date.now();
+        const timeSinceLastExec = now - lastExecuted.current;
+        if (timeSinceLastExec >= interval) {
+            lastExecuted.current = now;
+            setThrottledValue(value);
+        }
+        else {
+            const timer = setTimeout(() => {
+                lastExecuted.current = Date.now();
+                setThrottledValue(value);
+            }, interval - timeSinceLastExec);
+            return () => clearTimeout(timer);
+        }
+    }, [value, interval]);
+    return throttledValue;
+}
+/**
+ * useThrottledCallback Hook
+ * 콜백 함수를 스로틀 처리
+ *
+ * @example
+ * const handleScroll = useThrottledCallback(() => {
+ *   console.log('Scrolling...', window.scrollY);
+ * }, 100);
+ *
+ * useEffect(() => {
+ *   window.addEventListener('scroll', handleScroll);
+ *   return () => window.removeEventListener('scroll', handleScroll);
+ * }, [handleScroll]);
+ */
+export function useThrottledCallback(callback, interval = 300) {
+    const lastExecuted = useRef(0);
+    const timeoutRef = useRef(null);
+    const callbackRef = useRef(callback);
+    // 콜백 참조 업데이트
+    useEffect(() => {
+        callbackRef.current = callback;
+    }, [callback]);
+    // 클린업
+    useEffect(() => {
+        return () => {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+            }
+        };
+    }, []);
+    return useCallback((...args) => {
+        const now = Date.now();
+        const timeSinceLastExec = now - lastExecuted.current;
+        if (timeSinceLastExec >= interval) {
+            lastExecuted.current = now;
+            callbackRef.current(...args);
+        }
+        else if (!timeoutRef.current) {
+            timeoutRef.current = setTimeout(() => {
+                lastExecuted.current = Date.now();
+                callbackRef.current(...args);
+                timeoutRef.current = null;
+            }, interval - timeSinceLastExec);
+        }
+    }, [interval]);
+}
+export default useDebounce;

package/dist/hooks/use-effect-once.d.ts

@@ -0,0 +1,77 @@
+/**
+ * useEffectOnce Hook
+ * 조건이 충족되면 한 번만 실행되는 useEffect
+ * KOMCA 패턴 업그레이드 버전
+ */
+import { DependencyList } from 'react';
+/**
+ * useEffectOnce
+ * ready 조건이 true가 되면 한 번만 실행
+ *
+ * @example
+ * // 기본 사용
+ * useEffectOnce(() => {
+ *   console.log('한 번만 실행');
+ * }, isLoaded);
+ *
+ * @example
+ * // cleanup 함수 포함
+ * useEffectOnce(() => {
+ *   const subscription = subscribe();
+ *   return () => subscription.unsubscribe();
+ * }, isReady);
+ */
+export declare function useEffectOnce(effect: () => (() => void) | void, ready?: boolean): void;
+/**
+ * useMount
+ * 컴포넌트 마운트 시 한 번만 실행
+ *
+ * @example
+ * useMount(() => {
+ *   analytics.pageView();
+ * });
+ */
+export declare function useMount(effect: () => (() => void) | void): void;
+/**
+ * useUnmount
+ * 컴포넌트 언마운트 시 실행
+ *
+ * @example
+ * useUnmount(() => {
+ *   cleanup();
+ * });
+ */
+export declare function useUnmount(cleanup: () => void): void;
+/**
+ * useUpdateEffect
+ * 첫 렌더링을 제외하고 deps가 변경될 때만 실행
+ *
+ * @example
+ * useUpdateEffect(() => {
+ *   console.log('count가 변경됨 (첫 렌더링 제외)');
+ * }, [count]);
+ */
+export declare function useUpdateEffect(effect: () => (() => void) | void, deps: DependencyList): void;
+/**
+ * useIsFirstRender
+ * 첫 렌더링인지 여부 반환
+ *
+ * @example
+ * const isFirstRender = useIsFirstRender();
+ * if (isFirstRender) {
+ *   // 첫 렌더링 시에만 실행
+ * }
+ */
+export declare function useIsFirstRender(): boolean;
+/**
+ * usePrevious
+ * 이전 값 반환
+ *
+ * @example
+ * const [count, setCount] = useState(0);
+ * const prevCount = usePrevious(count);
+ * // count: 5, prevCount: 4
+ */
+export declare function usePrevious<T>(value: T): T | undefined;
+export default useEffectOnce;
+//# sourceMappingURL=use-effect-once.d.ts.map

package/dist/hooks/use-effect-once.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect-once.d.ts","sourceRoot":"","sources":["../../src/hooks/use-effect-once.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAkC,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,EACjC,KAAK,GAAE,OAAc,GACpB,IAAI,CAoBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAEhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAOpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,EACjC,IAAI,EAAE,cAAc,GACnB,IAAI,CAYN;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAS1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAQtD;AAED,eAAe,aAAa,CAAC"}

package/dist/hooks/use-effect-once.js

@@ -0,0 +1,124 @@
+/**
+ * useEffectOnce Hook
+ * 조건이 충족되면 한 번만 실행되는 useEffect
+ * KOMCA 패턴 업그레이드 버전
+ */
+import { useEffect, useRef } from 'react';
+/**
+ * useEffectOnce
+ * ready 조건이 true가 되면 한 번만 실행
+ *
+ * @example
+ * // 기본 사용
+ * useEffectOnce(() => {
+ *   console.log('한 번만 실행');
+ * }, isLoaded);
+ *
+ * @example
+ * // cleanup 함수 포함
+ * useEffectOnce(() => {
+ *   const subscription = subscribe();
+ *   return () => subscription.unsubscribe();
+ * }, isReady);
+ */
+export function useEffectOnce(effect, ready = true) {
+    const hasRun = useRef(false);
+    const cleanupRef = useRef(undefined);
+    const effectRef = useRef(effect);
+    effectRef.current = effect;
+    useEffect(() => {
+        if (hasRun.current || !ready) {
+            return;
+        }
+        hasRun.current = true;
+        cleanupRef.current = effectRef.current();
+        return () => {
+            if (typeof cleanupRef.current === 'function') {
+                cleanupRef.current();
+            }
+        };
+    }, [ready]);
+}
+/**
+ * useMount
+ * 컴포넌트 마운트 시 한 번만 실행
+ *
+ * @example
+ * useMount(() => {
+ *   analytics.pageView();
+ * });
+ */
+export function useMount(effect) {
+    useEffectOnce(effect, true);
+}
+/**
+ * useUnmount
+ * 컴포넌트 언마운트 시 실행
+ *
+ * @example
+ * useUnmount(() => {
+ *   cleanup();
+ * });
+ */
+export function useUnmount(cleanup) {
+    const cleanupRef = useRef(cleanup);
+    cleanupRef.current = cleanup;
+    useEffect(() => {
+        return () => cleanupRef.current();
+    }, []);
+}
+/**
+ * useUpdateEffect
+ * 첫 렌더링을 제외하고 deps가 변경될 때만 실행
+ *
+ * @example
+ * useUpdateEffect(() => {
+ *   console.log('count가 변경됨 (첫 렌더링 제외)');
+ * }, [count]);
+ */
+export function useUpdateEffect(effect, deps) {
+    const isFirstMount = useRef(true);
+    useEffect(() => {
+        if (isFirstMount.current) {
+            isFirstMount.current = false;
+            return;
+        }
+        return effect();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, deps);
+}
+/**
+ * useIsFirstRender
+ * 첫 렌더링인지 여부 반환
+ *
+ * @example
+ * const isFirstRender = useIsFirstRender();
+ * if (isFirstRender) {
+ *   // 첫 렌더링 시에만 실행
+ * }
+ */
+export function useIsFirstRender() {
+    const isFirst = useRef(true);
+    if (isFirst.current) {
+        isFirst.current = false;
+        return true;
+    }
+    return false;
+}
+/**
+ * usePrevious
+ * 이전 값 반환
+ *
+ * @example
+ * const [count, setCount] = useState(0);
+ * const prevCount = usePrevious(count);
+ * // count: 5, prevCount: 4
+ */
+export function usePrevious(value) {
+    const ref = useRef(undefined);
+    useEffect(() => {
+        ref.current = value;
+    }, [value]);
+    return ref.current;
+}
+export default useEffectOnce;

package/dist/hooks/use-error-notification.d.ts

@@ -1,5 +1,5 @@
 /**
- * Error Notification Hook - KOMCA 패턴
+ * Error Notification Hook
  * API 에러 발생시 자동 알림
  */
 import { ErrorDetail } from '../network/axios-factory';

package/dist/hooks/use-error-notification.js

@@ -1,5 +1,5 @@
 /**
- * Error Notification Hook - KOMCA 패턴
+ * Error Notification Hook
  * API 에러 발생시 자동 알림
  */
 import { useEffect } from 'react';

package/dist/hooks/use-global-loading.d.ts

@@ -1,5 +1,5 @@
 /**
- * Global Loading Hook - KOMCA 패턴
+ * Global Loading Hook
  * API 호출 시 전역 로딩 표시
  */
 /**