20260102 #121 토스트 전역 핸들링을 위한 커스텀 훅 use toast 추가

CHANGELOG.md

@@ -12,6 +12,11 @@ This file is automatically generated and maintained by the centralized workflow
 
 # Chuseok22 Version Changelog
 
+## [0.4.1] - 2026-01-02
+
+🐛 **patch**: 하단 네비게이션을 통한 페이지 이동 시 replace 동작
+- commit: `05a52d7`
+
 ## [0.4.0] - 2026-01-02
 
 ✨ **minor**: 학생회관 메뉴 페이지 장바구니 추가 기능 개발

package.json

@@ -1,6 +1,6 @@
 {
   "name": "campus-table-fe",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "private": true,
   "scripts": {
     "dev": "next dev",

src/constants/version.ts

@@ -1 +1 @@
-export const APP_VERSION: string = '0.4.0';
+export const APP_VERSION: string = '0.4.1';

src/features/menu/components/MenuPageContainer.tsx

@@ -10,6 +10,7 @@ import { useCart } from "@/features/cart/hooks/useCart";
 import OrderSummaryBar from "@/features/menu/components/bar/OrderSummaryBar";
 import { ItemCount } from "@/features/menu/components/button/CartButton";
 import CartToast from "@/features/menu/components/toast/CartToast";
+import { useToast } from "@/shared/hooks/useToast";
 
 interface MenuPageContainerProps {
   hakgwanMenuData: HakgwanMenuData;
@@ -26,8 +27,7 @@ export default function MenuPageContainer({
     return 0;
   });
 
-  const [toastVisible, setToastVisible] = useState<boolean>(false);
-  const [toastMessage, setToastMessage] = useState<string>("");
+  const { visible: toastVisible, message: toastMessage, showToast } = useToast(3000);
 
   const { cartInfo, addToCart } = useCart();
 
@@ -47,18 +47,10 @@ export default function MenuPageContainer({
   const handleAddToCart = (menuId: number): void => {
     addToCart(menuId, {
       onSuccess: () => {
-        setToastMessage("장바구니에 쏙 담았어요!");
-        setToastVisible(true);
-        setTimeout(() => {
-          setToastVisible(false);
-        }, 3000);
+        showToast("장바구니에 쏙 담았어요!");
       },
       onError: (message) => {
-        setToastMessage(message);
-        setToastVisible(true);
-        setTimeout(() => {
-          setToastVisible(false);
-        }, 3000);
+        showToast(message);
       }
     });
   };

src/shared/hooks/useToast.ts

@@ -0,0 +1,83 @@
+"use client";
+
+import { useCallback, useEffect, useRef, useState } from "react";
+
+interface UseToastReturn {
+  visible: boolean;
+  message: string;
+  showToast: (message: string) => void;
+}
+
+/**
+ * 토스트 메시지 관리 훅
+ * - 타이머 충돌 방지
+ * - 기존 토스트가 있으면 새로운 토스트로 교체
+ */
+export function useToast(
+  duration: number = 3000,
+  animationDuration: number = 200,
+): UseToastReturn {
+  const [visible, setVisible] = useState<boolean>(false);
+  const [message, setMessage] = useState<string>("");
+  const timerRef = useRef<number | null>(null);
+  const hideTimerRef = useRef<number | null>(null);
+  const visibleRef = useRef<boolean>(false);
+
+  const showToast = useCallback((message: string) => {
+    // 기존 타이머 정리
+    if (timerRef.current) {
+      window.clearTimeout(timerRef.current);
+    }
+    if (hideTimerRef.current) {
+      window.clearTimeout(hideTimerRef.current);
+    }
+
+    // 이미 토스트가 표시중이면 먼저 제거
+    if (visibleRef.current) {
+      // 기존 토스트 숨김
+      setVisible(false);
+      visibleRef.current = false;
+
+      // 애니메이션 완료 대기
+      hideTimerRef.current = window.setTimeout(() => {
+        setMessage(message);
+        setVisible(true);
+        visibleRef.current = true;
+
+        // duration 후 토스트 숨김
+        timerRef.current = window.setTimeout(() => {
+          setVisible(false);
+          visibleRef.current = false;
+          timerRef.current = null;
+        }, duration);
+
+        hideTimerRef.current = null;
+      }, animationDuration);
+    } else {
+      // 기존 토스트가 없는 경우
+      setMessage(message);
+      setVisible(true);
+      visibleRef.current = true;
+
+      timerRef.current = window.setTimeout(() => {
+        setVisible(false);
+        visibleRef.current = false;
+        timerRef.current = null;
+      }, duration);
+    }
+  }, [duration, animationDuration]);
+
+  // 컴포넌트 언마운트 시 타이머 정리
+  useEffect(() => {
+    return () => {
+      if (timerRef.current) {
+        window.clearTimeout(timerRef.current);
+      }
+      if (hideTimerRef.current) {
+        window.clearTimeout(hideTimerRef.current);
+      }
+    };
+  }, []);
+
+  return { visible, message, showToast };
+}