feat(toast): handle onShow and onHide callbacks

Author: vvv-sss

src/providers/toast/provider.tsx

@@ -53,11 +53,17 @@ export function ToastProvider({
         payload: {
           id,
           component: options.component,
+          onShow: options.onShow,
+          onHide: options.onHide,
         },
       });
 
       total.set((value) => value + 1);
 
+      if (options.onShow) {
+        options.onShow();
+      }
+
       return id;
     },
     [total]
@@ -69,14 +75,28 @@ export function ToastProvider({
   const hide = useCallback(
     (ids?: string | string[]) => {
       if (ids === undefined) {
-        // Hide all toasts
+        // Hide all toasts - call onHide for each toast before hiding
+        toasts.forEach((toast) => {
+          if (toast.onHide) {
+            toast.onHide();
+          }
+        });
         dispatch({ type: 'HIDE_ALL' });
         heights.set({});
         total.set(0);
       } else {
-        // Hide specific toast(s)
+        // Hide specific toast(s) - call onHide for each toast before hiding
         const idsArray = Array.isArray(ids) ? ids : [ids];
         const idsToRemove = idsArray;
+
+        // Find and call onHide callbacks before removing
+        idsToRemove.forEach((id) => {
+          const toast = toasts.find((t) => String(t.id) === String(id));
+          if (toast?.onHide) {
+            toast.onHide();
+          }
+        });
+
         dispatch({
           type: 'HIDE',
           payload: { ids: idsArray },
@@ -94,7 +114,7 @@ export function ToastProvider({
         total.set((value) => value - 1);
       }
     },
-    [total, heights]
+    [total, heights, toasts]
   );
 
   const contextValue = useMemo<ToasterContextValue>(

src/providers/toast/types.ts

@@ -98,6 +98,14 @@ export interface ToastShowOptions {
    * A function that receives toast props and returns a React element
    */
   component: (props: ToastComponentProps) => React.ReactElement;
+  /**
+   * Callback function called when the toast is shown
+   */
+  onShow?: () => void;
+  /**
+   * Callback function called when the toast is hidden
+   */
+  onHide?: () => void;
 }
 
 /**
@@ -112,6 +120,14 @@ export interface ToastItem {
    * A function that receives toast props and returns a React element
    */
   component: (props: ToastComponentProps) => React.ReactElement;
+  /**
+   * Callback function called when the toast is shown
+   */
+  onShow?: () => void;
+  /**
+   * Callback function called when the toast is hidden
+   */
+  onHide?: () => void;
 }
 
 /**