From e09451855b106a43dc5aab5016cd7442dac8e5ce Mon Sep 17 00:00:00 2001
From: Brandon Cheng <gluxon@users.noreply.github.com>
Date: Fri, 3 May 2024 16:13:46 -0400
Subject: [PATCH] [core] style: comment why start/clear timeout handlers are
 attached to mouse events (#6784)

---
 packages/core/src/components/toast/toast2.tsx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/core/src/components/toast/toast2.tsx b/packages/core/src/components/toast/toast2.tsx
index d365a408438..8f933ff7781 100644
--- a/packages/core/src/components/toast/toast2.tsx
+++ b/packages/core/src/components/toast/toast2.tsx
@@ -85,6 +85,9 @@ export const Toast2 = React.forwardRef<HTMLDivElement, ToastProps>((props, ref)
     return (
         <div
             className={classNames(Classes.TOAST, Classes.intentClass(intent), className)}
+            // Pause timeouts if users are hovering over or click on the toast. The toast may have
+            // actions the user wants to click. It'd be a poor experience to "pull the toast" out
+            // from under them.
             onBlur={startTimeout}
             onFocus={clearTimeout}
             onMouseEnter={clearTimeout}