From 845eaa42c5d926e9a6b8ba1d700bdceb5a6257e9 Mon Sep 17 00:00:00 2001
From: awesomerobot <kris.aubuchon@discourse.org>
Date: Fri, 5 Dec 2025 17:38:57 -0500
Subject: [PATCH 1/4] UX: add hover delay to reduce annoyance

---
 .../components/topic-list-tooltip.gjs         | 28 +++++++++++++++++++
 settings.yml                                  |  7 +++++
 2 files changed, 35 insertions(+)

diff --git a/javascripts/discourse/components/topic-list-tooltip.gjs b/javascripts/discourse/components/topic-list-tooltip.gjs
index 0534822..d5d9228 100644
--- a/javascripts/discourse/components/topic-list-tooltip.gjs
+++ b/javascripts/discourse/components/topic-list-tooltip.gjs
@@ -1,7 +1,9 @@
 import Component from "@glimmer/component";
+import { cancel } from "@ember/runloop";
 import { getOwner } from "@ember/owner";
 import { htmlSafe } from "@ember/template";
 import replaceEmoji from "discourse/helpers/replace-emoji";
+import discourseLater from "discourse/lib/later";
 import DTooltip from "float-kit/components/d-tooltip";
 
 const triggers = {
@@ -19,6 +21,8 @@ import("discourse/plugins/discourse-ai/discourse/services/gists")
   });
 
 export default class TopicListTooltip extends Component {
+  hoverTimeout = null;
+
   get gistsService() {
     try {
       return getOwner(this).lookup("service:gists");
@@ -65,12 +69,36 @@ export default class TopicListTooltip extends Component {
     return null;
   }
 
+  cancelPending() {
+    if (this.hoverTimeout) {
+      cancel(this.hoverTimeout);
+      this.hoverTimeout = null;
+    }
+  }
+
+  beforeTrigger = async (instance) => {
+    this.cancelPending();
+
+    return new Promise((resolve) => {
+      this.hoverTimeout = discourseLater(() => {
+        this.hoverTimeout = null;
+        resolve();
+      }, settings.hover_delay_seconds * 1000);
+    });
+  };
+
+  onClose = () => {
+    this.cancelPending();
+  };
+
   <template>
     {{#if this.shouldShowTooltip}}
       <DTooltip
         @triggers={{triggers}}
         @untriggers={{triggers}}
         @placement="bottom-start"
+        @beforeTrigger={{this.beforeTrigger}}
+        @onClose={{this.onClose}}
       >
         <:trigger>
           {{yield}}
diff --git a/settings.yml b/settings.yml
index 6083581..2f5cd84 100644
--- a/settings.yml
+++ b/settings.yml
@@ -4,3 +4,10 @@ tooltip_content:
   choices:
     - first_post_excerpt
     - ai_topic_gist
+
+hover_delay_seconds:
+  type: float
+  default: 0.25
+  min: 0
+  max: 2.0
+  description: "Delay in seconds before showing the tooltip on hover (helps prevent tooltips from appearing during scrolling)"

From 79f19bc26f6cd5b10a2697d9897795e1aff957b1 Mon Sep 17 00:00:00 2001
From: awesomerobot <kris.aubuchon@discourse.org>
Date: Fri, 5 Dec 2025 17:46:17 -0500
Subject: [PATCH 2/4] lint

---
 .../components/topic-list-tooltip.gjs         | 32 +++++++++----------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/javascripts/discourse/components/topic-list-tooltip.gjs b/javascripts/discourse/components/topic-list-tooltip.gjs
index d5d9228..5c9cbec 100644
--- a/javascripts/discourse/components/topic-list-tooltip.gjs
+++ b/javascripts/discourse/components/topic-list-tooltip.gjs
@@ -1,6 +1,6 @@
 import Component from "@glimmer/component";
-import { cancel } from "@ember/runloop";
 import { getOwner } from "@ember/owner";
+import { cancel } from "@ember/runloop";
 import { htmlSafe } from "@ember/template";
 import replaceEmoji from "discourse/helpers/replace-emoji";
 import discourseLater from "discourse/lib/later";
@@ -23,6 +23,21 @@ import("discourse/plugins/discourse-ai/discourse/services/gists")
 export default class TopicListTooltip extends Component {
   hoverTimeout = null;
 
+  beforeTrigger = async (instance) => {
+    this.cancelPending();
+
+    return new Promise((resolve) => {
+      this.hoverTimeout = discourseLater(() => {
+        this.hoverTimeout = null;
+        resolve();
+      }, settings.hover_delay_seconds * 1000);
+    });
+  };
+
+  onClose = () => {
+    this.cancelPending();
+  };
+
   get gistsService() {
     try {
       return getOwner(this).lookup("service:gists");
@@ -76,21 +91,6 @@ export default class TopicListTooltip extends Component {
     }
   }
 
-  beforeTrigger = async (instance) => {
-    this.cancelPending();
-
-    return new Promise((resolve) => {
-      this.hoverTimeout = discourseLater(() => {
-        this.hoverTimeout = null;
-        resolve();
-      }, settings.hover_delay_seconds * 1000);
-    });
-  };
-
-  onClose = () => {
-    this.cancelPending();
-  };
-
   <template>
     {{#if this.shouldShowTooltip}}
       <DTooltip

From 78cfbc68fe64d7491214b89531d98df1799ec7c7 Mon Sep 17 00:00:00 2001
From: awesomerobot <kris.aubuchon@discourse.org>
Date: Fri, 5 Dec 2025 17:56:22 -0500
Subject: [PATCH 3/4] remove unused

---
 javascripts/discourse/components/topic-list-tooltip.gjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/javascripts/discourse/components/topic-list-tooltip.gjs b/javascripts/discourse/components/topic-list-tooltip.gjs
index 5c9cbec..2ea4cec 100644
--- a/javascripts/discourse/components/topic-list-tooltip.gjs
+++ b/javascripts/discourse/components/topic-list-tooltip.gjs
@@ -23,7 +23,7 @@ import("discourse/plugins/discourse-ai/discourse/services/gists")
 export default class TopicListTooltip extends Component {
   hoverTimeout = null;
 
-  beforeTrigger = async (instance) => {
+  beforeTrigger = async () => {
     this.cancelPending();
 
     return new Promise((resolve) => {

From 0c8076fd1ec2caa9e3ace46c87aedee2c199f9d6 Mon Sep 17 00:00:00 2001
From: awesomerobot <kris.aubuchon@discourse.org>
Date: Fri, 5 Dec 2025 18:38:03 -0500
Subject: [PATCH 4/4] ms const

---
 javascripts/discourse/components/topic-list-tooltip.gjs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/javascripts/discourse/components/topic-list-tooltip.gjs b/javascripts/discourse/components/topic-list-tooltip.gjs
index 2ea4cec..c08a549 100644
--- a/javascripts/discourse/components/topic-list-tooltip.gjs
+++ b/javascripts/discourse/components/topic-list-tooltip.gjs
@@ -11,6 +11,8 @@ const triggers = {
   desktop: ["hover"],
 };
 
+const MILLISECONDS_PER_SECOND = 1000;
+
 let TABLE_AI_LAYOUT = "table-ai";
 import("discourse/plugins/discourse-ai/discourse/services/gists")
   .then((module) => {
@@ -30,7 +32,7 @@ export default class TopicListTooltip extends Component {
       this.hoverTimeout = discourseLater(() => {
         this.hoverTimeout = null;
         resolve();
-      }, settings.hover_delay_seconds * 1000);
+      }, settings.hover_delay_seconds * MILLISECONDS_PER_SECOND);
     });
   };