From 3c678d4a53fe2742eaaa5f63cebca0d2a8fc388c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Greg=20Berg=C3=A9?= <berge.greg@gmail.com>
Date: Wed, 27 May 2026 09:51:44 +0200
Subject: [PATCH] Fix annotation hover interaction when card has a target link

---
 packages/gitbook/e2e/internal.spec.ts                         | 4 ++--
 .../components/DocumentView/Annotation/AnnotationPopover.tsx  | 2 +-
 packages/gitbook/src/components/RootLayout/globals.css        | 3 ++-
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/packages/gitbook/e2e/internal.spec.ts b/packages/gitbook/e2e/internal.spec.ts
index d7784bf316..45f3abf2e5 100644
--- a/packages/gitbook/e2e/internal.spec.ts
+++ b/packages/gitbook/e2e/internal.spec.ts
@@ -1056,8 +1056,8 @@ const testCases: TestsCase[] = [
                 url: 'blocks/annotations',
                 run: async (page) => {
                     await waitForCookiesDialog(page);
-                    await page.waitForSelector('[data-testid="annotation-button"]');
-                    await page.click('[data-testid="annotation-button"]');
+                    await page.waitForSelector('[data-annotation]');
+                    await page.click('[data-annotation]');
                 },
             },
             {
diff --git a/packages/gitbook/src/components/DocumentView/Annotation/AnnotationPopover.tsx b/packages/gitbook/src/components/DocumentView/Annotation/AnnotationPopover.tsx
index 2c36150e6d..1293433d03 100644
--- a/packages/gitbook/src/components/DocumentView/Annotation/AnnotationPopover.tsx
+++ b/packages/gitbook/src/components/DocumentView/Annotation/AnnotationPopover.tsx
@@ -18,7 +18,7 @@ export function AnnotationPopover(props: { children: React.ReactNode; body: Reac
             arrowProps={{ className: 'fill-tint-1' }}
         >
             <dfn
-                data-testid="annotation-button"
+                data-annotation=""
                 className="cursor-help underline decoration-1 decoration-dotted underline-offset-2"
                 // biome-ignore lint/a11y/noNoninteractiveTabindex: we want to be able to focus the definition to open the tooltip
                 tabIndex={0}
diff --git a/packages/gitbook/src/components/RootLayout/globals.css b/packages/gitbook/src/components/RootLayout/globals.css
index 7928c23cf3..e9e8aead70 100644
--- a/packages/gitbook/src/components/RootLayout/globals.css
+++ b/packages/gitbook/src/components/RootLayout/globals.css
@@ -170,7 +170,8 @@
 }
 
 @utility elevate-link {
-    & a[href]:not(.link-overlay) {
+    & a[href]:not(.link-overlay),
+    & [data-annotation] {
         position: relative;
         z-index: 20;
     }