@blastlabs/utils 1.12.0 → 1.13.0

package/dist/hooks/auth/useAuth.js

@@ -0,0 +1,384 @@
+import { useState, useEffect, useCallback, useRef } from 'react';
+/**
+ * 인증 관리 Hook
+ *
+ * 로그인, 로그아웃, 회원가입, 토큰 관리 등 인증 관련 기능을 제공합니다.
+ *
+ * @example
+ * ```tsx
+ * // 기본 사용 (로그인 유지 옵션 포함)
+ * function LoginPage() {
+ *   const [rememberMe, setRememberMe] = useState(false);
+ *   const { login, isLoggingIn, error, isAuthenticated } = useAuth({
+ *     loginFn: (credentials) => api.login(credentials),
+ *     onLoginSuccess: (user) => {
+ *       console.log('로그인 성공:', user);
+ *       navigate('/dashboard');
+ *     },
+ *   });
+ *
+ *   const handleSubmit = async (e) => {
+ *     e.preventDefault();
+ *     // rememberMe가 true면 localStorage, false면 sessionStorage 사용
+ *     await login({ email, password }, { rememberMe });
+ *   };
+ *
+ *   if (isAuthenticated) {
+ *     return <Navigate to="/dashboard" />;
+ *   }
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input type="email" value={email} onChange={(e) => setEmail(e.target.value)} />
+ *       <input type="password" value={password} onChange={(e) => setPassword(e.target.value)} />
+ *       <label>
+ *         <input type="checkbox" checked={rememberMe} onChange={(e) => setRememberMe(e.target.checked)} />
+ *         로그인 유지
+ *       </label>
+ *       <button type="submit" disabled={isLoggingIn}>
+ *         {isLoggingIn ? '로그인 중...' : '로그인'}
+ *       </button>
+ *       {error && <div>{error.message}</div>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 자동 토큰 갱신과 함께 사용
+ * function App() {
+ *   const { user, isAuthenticated, isLoading, logout } = useAuth({
+ *     getUserFn: () => api.getMe(),
+ *     logoutFn: () => api.logout(),
+ *     refreshTokenFn: () => api.refreshToken(),
+ *     autoRefresh: true,
+ *     refreshInterval: 300000, // 5분마다 갱신
+ *     onLogoutSuccess: () => navigate('/login'),
+ *   });
+ *
+ *   if (isLoading) return <div>로딩중...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {isAuthenticated ? (
+ *         <>
+ *           <div>환영합니다, {user?.name}님</div>
+ *           <button onClick={logout}>로그아웃</button>
+ *         </>
+ *       ) : (
+ *         <LoginPage />
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 회원가입 포함
+ * function RegisterPage() {
+ *   const { register, isRegistering, error } = useAuth({
+ *     registerFn: (data) => api.register(data),
+ *     onRegisterSuccess: (user) => {
+ *       toast.success('회원가입 성공!');
+ *       navigate('/');
+ *     },
+ *   });
+ *
+ *   const handleSubmit = async (data) => {
+ *     await register(data);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input name="email" />
+ *       <input name="password" type="password" />
+ *       <input name="name" />
+ *       <button type="submit" disabled={isRegistering}>
+ *         회원가입
+ *       </button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Storage에 저장되는 값 확인하기
+ * function DebugAuth() {
+ *   const { login, user, token } = useAuth({
+ *     loginFn: api.login,
+ *     storageKey: 'my_app_token',      // 커스텀 키 사용 가능
+ *     userStorageKey: 'my_app_user',
+ *   });
+ *
+ *   const handleLogin = async () => {
+ *     await login({ email, password }, { rememberMe: true });
+ *
+ *     // 로그인 후 storage 확인
+ *     console.log('Token:', localStorage.getItem('my_app_token'));
+ *     // 출력: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+ *
+ *     console.log('User:', localStorage.getItem('my_app_user'));
+ *     // 출력: {"id":"123","name":"John Doe","email":"john@example.com"}
+ *   };
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // rememberMe에 따른 storage 동작
+ * function LoginWithRememberMe() {
+ *   const [rememberMe, setRememberMe] = useState(false);
+ *   const { login } = useAuth({ loginFn: api.login });
+ *
+ *   const handleLogin = async () => {
+ *     await login({ email, password }, { rememberMe });
+ *
+ *     if (rememberMe) {
+ *       // localStorage에 저장 (브라우저 종료해도 유지)
+ *       console.log(localStorage.getItem('auth_token'));    // "eyJ..."
+ *       console.log(sessionStorage.getItem('auth_token'));  // null
+ *     } else {
+ *       // sessionStorage에 저장 (브라우저 종료 시 삭제)
+ *       console.log(localStorage.getItem('auth_token'));    // null
+ *       console.log(sessionStorage.getItem('auth_token'));  // "eyJ..."
+ *     }
+ *   };
+ * }
+ * ```
+ */
+export function useAuth(options = {}) {
+    const { loginFn, logoutFn, registerFn, getUserFn, refreshTokenFn, onLoginSuccess, onLogoutSuccess, onRegisterSuccess, onError, storageKey = 'auth_token', userStorageKey = 'auth_user', useSessionStorage = false, autoRefresh = false, refreshInterval = 300000, // 5분
+    autoLoadUser = true, } = options;
+    const [user, setUser] = useState(null);
+    const [token, setTokenState] = useState(() => {
+        // SSR 환경에서는 storage 접근 불가
+        if (typeof window === 'undefined')
+            return null;
+        // 초기 로드 시 localStorage와 sessionStorage 모두 확인
+        return localStorage.getItem(storageKey) || sessionStorage.getItem(storageKey);
+    });
+    const [isLoading, setIsLoading] = useState(autoLoadUser);
+    const [isLoggingIn, setIsLoggingIn] = useState(false);
+    const [isLoggingOut, setIsLoggingOut] = useState(false);
+    const [isRegistering, setIsRegistering] = useState(false);
+    const [error, setError] = useState(null);
+    const refreshIntervalRef = useRef(null);
+    // 토큰 설정 함수 (storage 타입 동적 선택 가능)
+    const setToken = useCallback((newToken, rememberMe = !useSessionStorage) => {
+        setTokenState(newToken);
+        // SSR 환경에서는 storage 접근 불가
+        if (typeof window === 'undefined')
+            return;
+        const storage = rememberMe ? localStorage : sessionStorage;
+        const otherStorage = rememberMe ? sessionStorage : localStorage;
+        if (newToken) {
+            storage.setItem(storageKey, newToken);
+            // 다른 storage에서는 제거 (중복 방지)
+            otherStorage.removeItem(storageKey);
+        }
+        else {
+            // 로그아웃 시 양쪽 모두 제거
+            localStorage.removeItem(storageKey);
+            sessionStorage.removeItem(storageKey);
+        }
+    }, [storageKey, useSessionStorage]);
+    // 사용자 정보 저장 (rememberMe 옵션 추가)
+    const saveUser = useCallback((userData, rememberMe = !useSessionStorage) => {
+        setUser(userData);
+        // SSR 환경에서는 storage 접근 불가
+        if (typeof window === 'undefined')
+            return;
+        const storage = rememberMe ? localStorage : sessionStorage;
+        const otherStorage = rememberMe ? sessionStorage : localStorage;
+        if (userData) {
+            storage.setItem(userStorageKey, JSON.stringify(userData));
+            // 다른 storage에서는 제거
+            otherStorage.removeItem(userStorageKey);
+        }
+        else {
+            // 로그아웃 시 양쪽 모두 제거
+            localStorage.removeItem(userStorageKey);
+            sessionStorage.removeItem(userStorageKey);
+        }
+    }, [userStorageKey, useSessionStorage]);
+    // 사용자 정보 로드
+    const loadUser = useCallback(async () => {
+        if (!getUserFn || !token) {
+            setIsLoading(false);
+            return;
+        }
+        try {
+            const userData = await getUserFn();
+            saveUser(userData);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to load user');
+            setError(error);
+            setToken(null);
+            saveUser(null);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [getUserFn, token, saveUser, setToken]);
+    // 초기 로드
+    useEffect(() => {
+        // SSR 환경에서는 storage 접근 불가
+        if (typeof window === 'undefined') {
+            setIsLoading(false);
+            return;
+        }
+        if (autoLoadUser && token) {
+            // localStorage와 sessionStorage 모두 확인
+            const savedUser = localStorage.getItem(userStorageKey) || sessionStorage.getItem(userStorageKey);
+            if (savedUser) {
+                try {
+                    setUser(JSON.parse(savedUser));
+                    setIsLoading(false);
+                }
+                catch {
+                    // JSON 파싱 실패 시 API에서 다시 가져오기
+                    loadUser();
+                }
+            }
+            else {
+                loadUser();
+            }
+        }
+        else {
+            setIsLoading(false);
+        }
+    }, []);
+    // 로그인
+    const login = useCallback(async (credentials, loginOptions) => {
+        if (!loginFn) {
+            throw new Error('loginFn is required for login');
+        }
+        const rememberMe = loginOptions?.rememberMe ?? !useSessionStorage;
+        setIsLoggingIn(true);
+        setError(null);
+        try {
+            const result = await loginFn(credentials);
+            if (result.token) {
+                setToken(result.token, rememberMe);
+            }
+            saveUser(result.user, rememberMe);
+            onLoginSuccess?.(result.user);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Login failed');
+            setError(error);
+            onError?.(error, 'login');
+            throw error;
+        }
+        finally {
+            setIsLoggingIn(false);
+        }
+    }, [loginFn, setToken, saveUser, onLoginSuccess, onError, useSessionStorage]);
+    // 로그아웃
+    const logout = useCallback(async () => {
+        setIsLoggingOut(true);
+        setError(null);
+        try {
+            if (logoutFn) {
+                await logoutFn();
+            }
+            setToken(null);
+            saveUser(null);
+            onLogoutSuccess?.();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Logout failed');
+            setError(error);
+            onError?.(error, 'logout');
+            throw error;
+        }
+        finally {
+            setIsLoggingOut(false);
+        }
+    }, [logoutFn, setToken, saveUser, onLogoutSuccess, onError]);
+    // 회원가입
+    const register = useCallback(async (data, registerOptions) => {
+        if (!registerFn) {
+            throw new Error('registerFn is required for register');
+        }
+        const rememberMe = registerOptions?.rememberMe ?? !useSessionStorage;
+        setIsRegistering(true);
+        setError(null);
+        try {
+            const result = await registerFn(data);
+            if (result.token) {
+                setToken(result.token, rememberMe);
+            }
+            saveUser(result.user, rememberMe);
+            onRegisterSuccess?.(result.user);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Registration failed');
+            setError(error);
+            onError?.(error, 'register');
+            throw error;
+        }
+        finally {
+            setIsRegistering(false);
+        }
+    }, [registerFn, setToken, saveUser, onRegisterSuccess, onError, useSessionStorage]);
+    // 토큰 갱신
+    const refreshToken = useCallback(async () => {
+        if (!refreshTokenFn) {
+            return;
+        }
+        try {
+            const result = await refreshTokenFn();
+            setToken(result.token);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Token refresh failed');
+            setError(error);
+            onError?.(error, 'refresh');
+            // 토큰 갱신 실패 시 로그아웃
+            await logout();
+        }
+    }, [refreshTokenFn, setToken, onError, logout]);
+    // 자동 토큰 갱신
+    useEffect(() => {
+        if (autoRefresh && token && refreshTokenFn) {
+            refreshIntervalRef.current = setInterval(() => {
+                refreshToken();
+            }, refreshInterval);
+            return () => {
+                if (refreshIntervalRef.current) {
+                    clearInterval(refreshIntervalRef.current);
+                }
+            };
+        }
+    }, [autoRefresh, token, refreshTokenFn, refreshToken, refreshInterval]);
+    // 사용자 정보 새로고침
+    const refetchUser = useCallback(async () => {
+        if (!getUserFn) {
+            throw new Error('getUserFn is required for refetchUser');
+        }
+        setIsLoading(true);
+        await loadUser();
+    }, [getUserFn, loadUser]);
+    return {
+        user,
+        isAuthenticated: !!user,
+        isLoading,
+        isLoggingIn,
+        isLoggingOut,
+        isRegistering,
+        error,
+        login,
+        logout,
+        register,
+        refreshToken,
+        refetchUser,
+        token,
+        setToken,
+        setUser: saveUser,
+    };
+}

package/dist/hooks/form/useCRUDForm.d.ts

@@ -1,37 +1,15 @@
-import type { FieldValues } from 'react-hook-form';
+import type { FieldValues, UseFormReturn } from 'react-hook-form';
 /**
  * CRUD Form Mode
  */
 export type FormMode = 'create' | 'edit';
-export type UseFormReturn<TFieldValues extends Record<string, any> = Record<string, any>> = {
-    watch: (name?: any) => any;
-    getValues: (name?: any) => any;
-    setValue: (name: any, value: any, options?: {
-        shouldValidate?: boolean;
-        shouldDirty?: boolean;
-        shouldTouch?: boolean;
-    }) => void;
-    trigger?: (name?: any) => Promise<boolean>;
-    formState: {
-        errors?: Record<string, any>;
-        dirtyFields?: Record<string, any>;
-        touchedFields?: Record<string, any>;
-        isValid?: boolean;
-        isSubmitting?: boolean;
-        submitCount?: number;
-        defaultValues?: TFieldValues;
-    };
-    handleSubmit?: (...args: any[]) => any;
-    register?: (...args: any[]) => any;
-    reset?: (...args: any[]) => any;
-    [key: string]: any;
-};
+type TId = string | number | null;
 /**
  * useCRUDForm 옵션
  */
-export interface UseCRUDFormOptions<TData extends FieldValues = FieldValues, TId = string | number> {
+export interface UseCRUDFormOptions<TData extends FieldValues = FieldValues> {
     /** 편집 모드일 때의 ID (있으면 edit mode, 없으면 create mode) */
-    id?: TId | null;
+    id?: TId;
     /** react-hook-form instance */
     form: UseFormReturn<TData>;
     /** 편집 모드일 때 데이터를 fetch하는 함수 */
@@ -39,7 +17,7 @@ export interface UseCRUDFormOptions<TData extends FieldValues = FieldValues, TId
     /** 생성 API 함수 */
     createFn?: (data: TData) => Promise<any>;
     /** 수정 API 함수 */
-    updateFn?: (id: TId, data: TData) => Promise<any>;
+    updateFn?: (id: Exclude<TId, null | undefined>, data: TData) => Promise<any>;
     /** 삭제 API 함수 (옵션) */
     deleteFn?: (id: TId) => Promise<any>;
     /** 성공 시 콜백 */
@@ -228,5 +206,6 @@ export interface UseCRUDFormReturn<TData = any, TId = string | number> {
  * }
  * ```
  */
-export declare function useCRUDForm<TData extends FieldValues = FieldValues, TId = string | number>(options: UseCRUDFormOptions<TData, TId>): UseCRUDFormReturn<TData, TId>;
+export declare function useCRUDForm<TData extends FieldValues = FieldValues>(options: UseCRUDFormOptions<TData>): UseCRUDFormReturn<TData>;
+export {};
 //# sourceMappingURL=useCRUDForm.d.ts.map

package/dist/hooks/form/useCRUDForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCRUDForm.d.ts","sourceRoot":"","sources":["../../../src/hooks/form/useCRUDForm.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useCRUDForm.d.ts","sourceRoot":"","sources":["../../../src/hooks/form/useCRUDForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAiCzC,KAAK,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAClC;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW;IACzE,oDAAoD;IACpD,EAAE,CAAC,EAAE,GAAG,CAAC;IAET,+BAA+B;IAC/B,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAE3B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAEtC,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAEzC,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAE7E,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC,cAAc;IACd,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE,cAAc;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAEjD,qCAAqC;IACrC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;IAEvC,oCAAoC;IACpC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,KAAK,GAAG,CAAC;IAErD,sCAAsC;IACtC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,MAAM;IACnE,cAAc;IACd,IAAI,EAAE,QAAQ,CAAC;IAEf,eAAe;IACf,UAAU,EAAE,OAAO,CAAC;IAEpB,eAAe;IACf,YAAY,EAAE,OAAO,CAAC;IAEtB,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC;IAEnB,+BAA+B;IAC/B,YAAY,EAAE,OAAO,CAAC;IAEtB,WAAW;IACX,UAAU,EAAE,OAAO,CAAC;IAEpB,SAAS;IACT,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,4CAA4C;IAC5C,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,aAAa;IACb,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,iBAAiB;IACjB,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqJG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW,EACjE,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,GACjC,iBAAiB,CAAC,KAAK,CAAC,CAiI1B"}

package/dist/hooks/index.d.ts

@@ -11,4 +11,5 @@ export * from './time';
 export * from './form';
 export * from './ui';
 export * from './storage';
+export * from './auth';
 //# 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;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,eAAe,CAAC;AAG9B,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,QAAQ,CAAC;AAGvB,cAAc,MAAM,CAAC;AAGrB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,eAAe,CAAC;AAG9B,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,QAAQ,CAAC;AAGvB,cAAc,MAAM,CAAC;AAGrB,cAAc,WAAW,CAAC;AAG1B,cAAc,QAAQ,CAAC"}

package/dist/hooks/index.js

@@ -18,3 +18,5 @@ export * from './form';
 export * from './ui';
 // Storage
 export * from './storage';
+// Authentication
+export * from './auth';

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

@@ -3,4 +3,5 @@
  */
 export * from './useMediaQuery';
 export * from './useWindowSize';
+export * from './useTabs';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/hooks/ui/index.js

@@ -3,3 +3,4 @@
  */
 export * from './useMediaQuery';
 export * from './useWindowSize';
+export * from './useTabs';

package/dist/hooks/ui/useTabs.d.ts

@@ -0,0 +1,33 @@
+type UseTabsOptions = {
+    items: Array<{
+        id: string;
+    }>;
+    defaultTab?: string;
+    syncWithUrl?: boolean;
+    urlParamName?: string;
+};
+type UseTabsReturn = {
+    selectedTab: string;
+    selectedIndex: number;
+    setSelectedTab: (tabId: string) => void;
+    setSelectedIndex: (index: number) => void;
+    getTabId: (index: number) => string | undefined;
+    getTabIndex: (tabId: string) => number;
+};
+/**
+ * 탭 상태 관리 훅
+ * URL 동기화 및 상태 관리 로직을 제공
+ *
+ * @example
+ * ```tsx
+ * const { selectedTab, setSelectedTab, selectedIndex } = useTabs({
+ *   items: tabs,
+ *   defaultTab: 'tab1',
+ *   syncWithUrl: true,
+ *   urlParamName: 'tab'
+ * });
+ * ```
+ */
+export declare function useTabs({ items, defaultTab, syncWithUrl, urlParamName, }: UseTabsOptions): UseTabsReturn;
+export {};
+//# sourceMappingURL=useTabs.d.ts.map

package/dist/hooks/ui/useTabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabs.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/useTabs.ts"],"names":[],"mappings":"AAIA,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAChD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,UAAU,EACV,WAAmB,EACnB,YAAoB,GACrB,EAAE,cAAc,GAAG,aAAa,CA4GhC"}

package/dist/hooks/ui/useTabs.js

@@ -0,0 +1,117 @@
+'use client';
+import { useState, useEffect, useMemo, useCallback } from 'react';
+/**
+ * 탭 상태 관리 훅
+ * URL 동기화 및 상태 관리 로직을 제공
+ *
+ * @example
+ * ```tsx
+ * const { selectedTab, setSelectedTab, selectedIndex } = useTabs({
+ *   items: tabs,
+ *   defaultTab: 'tab1',
+ *   syncWithUrl: true,
+ *   urlParamName: 'tab'
+ * });
+ * ```
+ */
+export function useTabs({ items, defaultTab, syncWithUrl = false, urlParamName = 'tab', }) {
+    // URL에서 탭 ID 가져오기
+    const getTabFromUrl = useCallback(() => {
+        if (!syncWithUrl || typeof window === 'undefined') {
+            return undefined;
+        }
+        const params = new URLSearchParams(window.location.search);
+        return params.get(urlParamName) || undefined;
+    }, [syncWithUrl, urlParamName]);
+    // 초기 선택된 탭 결정 (우선순위: URL > defaultTab > 첫 번째)
+    const initialSelectedTab = useMemo(() => {
+        if (syncWithUrl) {
+            const urlTab = getTabFromUrl();
+            if (urlTab)
+                return urlTab;
+        }
+        return defaultTab || items[0]?.id || '';
+    }, [syncWithUrl, defaultTab, items, getTabFromUrl]);
+    const [selectedTab, setSelectedTabState] = useState(initialSelectedTab);
+    // 선택된 탭의 인덱스
+    const selectedIndex = useMemo(() => {
+        const index = items.findIndex((item) => item.id === selectedTab);
+        return index >= 0 ? index : 0;
+    }, [items, selectedTab]);
+    // URL 업데이트 함수
+    const updateUrl = (tabId) => {
+        if (!syncWithUrl || typeof window === 'undefined')
+            return;
+        const url = new URL(window.location.href);
+        if (tabId === defaultTab) {
+            // 기본 탭이면 URL에서 제거 (깔끔한 URL 유지)
+            url.searchParams.delete(urlParamName);
+        }
+        else {
+            url.searchParams.set(urlParamName, tabId);
+        }
+        window.history.pushState({}, '', url.toString());
+    };
+    // 탭 ID로 선택
+    const setSelectedTab = (tabId) => {
+        setSelectedTabState(tabId);
+        if (syncWithUrl) {
+            updateUrl(tabId);
+        }
+    };
+    // 인덱스로 선택
+    const setSelectedIndex = (index) => {
+        const tabId = items[index]?.id;
+        if (tabId) {
+            setSelectedTab(tabId);
+        }
+    };
+    // 인덱스로 탭 ID 가져오기
+    const getTabId = (index) => {
+        return items[index]?.id;
+    };
+    // 탭 ID로 인덱스 가져오기
+    const getTabIndex = (tabId) => {
+        return items.findIndex((item) => item.id === tabId);
+    };
+    // 브라우저 뒤로가기/앞으로가기 지원
+    useEffect(() => {
+        if (!syncWithUrl || typeof window === 'undefined')
+            return;
+        const handlePopState = () => {
+            const urlTab = getTabFromUrl();
+            if (urlTab) {
+                setSelectedTabState(urlTab);
+            }
+            else if (defaultTab) {
+                setSelectedTabState(defaultTab);
+            }
+            else if (items[0]?.id) {
+                setSelectedTabState(items[0].id);
+            }
+        };
+        window.addEventListener('popstate', handlePopState);
+        return () => {
+            window.removeEventListener('popstate', handlePopState);
+        };
+    }, [syncWithUrl, defaultTab, items, getTabFromUrl]);
+    // URL 초기 동기화
+    useEffect(() => {
+        if (!syncWithUrl || typeof window === 'undefined')
+            return;
+        const urlTab = getTabFromUrl();
+        if (urlTab && urlTab !== selectedTab) {
+            // URL과 상태가 다를 때만 업데이트 (초기 로드 시)
+            setSelectedTabState(urlTab);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [syncWithUrl, urlParamName]); // 초기 마운트 시에만 실행
+    return {
+        selectedTab,
+        selectedIndex,
+        setSelectedTab,
+        setSelectedIndex,
+        getTabId,
+        getTabIndex,
+    };
+}

package/dist/index.js

@@ -8,7 +8,7 @@ export * from './string';
 export * from './number';
 // Mock data utilities
 export * from './mock';
-// React Hooks (import separately: 'goodchuck-utils/hooks')
+// React Hooks (import separately: '@blastlabs/utils/hooks')
 // Note: Hooks are not exported from main entry to avoid React dependency for non-React users
 // export * from './hooks';
 // Array utilities (placeholder for future)

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@blastlabs/utils",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "blastlabs-generate-entity": "./bin/generate-entity.cjs"
+  },
   "files": [
-    "dist"
+    "dist",
+    "bin"
   ],
   "scripts": {
     "prepare": "npm run build:tsc",