From 415d0facec905c84bf1b4c5c68f9dda11410c35c Mon Sep 17 00:00:00 2001
From: Ivan Tur <49621041+turfle@users.noreply.github.com>
Date: Sat, 10 Jan 2026 04:49:05 +0200
Subject: [PATCH] feat(ui): add reusable Tooltip component and integrate with
 settings (#538)

Co-authored-by: Ivan Tur <49621041+buiiz@users.noreply.github.com>
---
 src/components/ui/SettingContainer.tsx |  15 ++--
 src/components/ui/Tooltip.tsx          | 114 +++++++++++++++++++++++++
 src/components/ui/index.ts             |   1 +
 3 files changed, 120 insertions(+), 10 deletions(-)
 create mode 100644 src/components/ui/Tooltip.tsx

diff --git a/src/components/ui/SettingContainer.tsx b/src/components/ui/SettingContainer.tsx
index ce24b46..1777f40 100644
--- a/src/components/ui/SettingContainer.tsx
+++ b/src/components/ui/SettingContainer.tsx
@@ -1,4 +1,5 @@
 import React, { useEffect, useRef, useState } from "react";
+import { Tooltip } from "./Tooltip";
 
 interface SettingContainerProps {
   title: string;
@@ -90,12 +91,11 @@ export const SettingContainer: React.FC<SettingContainerProps> = ({
                 />
               </svg>
               {showTooltip && (
-                <div className="absolute bottom-full left-1/2 transform -translate-x-1/2 mb-2 px-3 py-2 bg-background border border-mid-gray/80 rounded-lg shadow-lg z-50 max-w-xs min-w-[200px] whitespace-normal animate-in fade-in-0 zoom-in-95 duration-200">
+                <Tooltip targetRef={tooltipRef} position="top">
                   <p className="text-sm text-center leading-relaxed">
                     {description}
                   </p>
-                  <div className="absolute top-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-l-[6px] border-r-[6px] border-t-[6px] border-l-transparent border-r-transparent border-t-mid-gray/80"></div>
-                </div>
+                </Tooltip>
               )}
             </div>
           </div>
@@ -164,16 +164,11 @@ export const SettingContainer: React.FC<SettingContainerProps> = ({
                 />
               </svg>
               {showTooltip && (
-                <div
-                  className={`absolute ${tooltipPosition === "top" ? "bottom-full" : "top-[150%]"} left-1/2 transform -translate-x-1/2 mb-2 px-3 py-2 bg-background border border-mid-gray/80 rounded-lg shadow-lg z-50 max-w-xs min-w-[200px] whitespace-normal animate-in fade-in-0 zoom-in-95 duration-200`}
-                >
+                <Tooltip targetRef={tooltipRef} position={tooltipPosition}>
                   <p className="text-sm text-center leading-relaxed">
                     {description}
                   </p>
-                  <div
-                    className={`absolute ${tooltipPosition === "top" ? "top-full" : "bottom-full rotate-180"} left-1/2 transform -translate-x-1/2 w-0 h-0 border-l-[6px] border-r-[6px] border-t-[6px] border-l-transparent border-r-transparent border-t-mid-gray/80`}
-                  ></div>
-                </div>
+                </Tooltip>
               )}
             </div>
           </div>
diff --git a/src/components/ui/Tooltip.tsx b/src/components/ui/Tooltip.tsx
new file mode 100644
index 0000000..1c1d208
--- /dev/null
+++ b/src/components/ui/Tooltip.tsx
@@ -0,0 +1,114 @@
+import React, { useCallback, useEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+
+type TooltipPosition = "top" | "bottom";
+
+interface TooltipCoords {
+  top: number;
+  left: number;
+  arrowLeft: number;
+  actualPosition: TooltipPosition;
+}
+
+interface TooltipProps {
+  targetRef: React.RefObject<HTMLElement>;
+  position?: TooltipPosition;
+  children: React.ReactNode;
+}
+
+const TOOLTIP_WIDTH = 200;
+const VIEWPORT_PADDING = 12;
+const GAP = 8;
+const ARROW_MARGIN = 12;
+const DEFAULT_HEIGHT = 60;
+
+export const Tooltip: React.FC<TooltipProps> = ({
+  targetRef,
+  position = "top",
+  children,
+}) => {
+  const [coords, setCoords] = useState<TooltipCoords | null>(null);
+  const tooltipRef = useRef<HTMLDivElement>(null);
+
+  const updatePosition = useCallback(() => {
+    if (!targetRef.current) return;
+
+    const targetRect = targetRef.current.getBoundingClientRect();
+    const tooltipHeight = tooltipRef.current?.offsetHeight || DEFAULT_HEIGHT;
+
+    let actualPosition = position;
+    let top: number;
+
+    if (position === "top") {
+      const spaceAbove = targetRect.top - tooltipHeight - GAP;
+      if (spaceAbove < VIEWPORT_PADDING) {
+        actualPosition = "bottom";
+        top = targetRect.bottom + GAP;
+      } else {
+        top = targetRect.top - GAP - tooltipHeight;
+      }
+    } else {
+      const spaceBelow =
+        window.innerHeight - targetRect.bottom - tooltipHeight - GAP;
+      if (spaceBelow < VIEWPORT_PADDING) {
+        actualPosition = "top";
+        top = targetRect.top - GAP - tooltipHeight;
+      } else {
+        top = targetRect.bottom + GAP;
+      }
+    }
+
+    const targetCenter = targetRect.left + targetRect.width / 2;
+    let left = targetCenter - TOOLTIP_WIDTH / 2;
+
+    if (left < VIEWPORT_PADDING) {
+      left = VIEWPORT_PADDING;
+    } else if (left + TOOLTIP_WIDTH > window.innerWidth - VIEWPORT_PADDING) {
+      left = window.innerWidth - TOOLTIP_WIDTH - VIEWPORT_PADDING;
+    }
+
+    const arrowLeft = Math.min(
+      Math.max(targetCenter - left, ARROW_MARGIN),
+      TOOLTIP_WIDTH - ARROW_MARGIN,
+    );
+
+    setCoords({ top, left, arrowLeft, actualPosition });
+  }, [targetRef, position]);
+
+  useEffect(() => {
+    updatePosition();
+
+    window.addEventListener("scroll", updatePosition, true);
+    window.addEventListener("resize", updatePosition);
+
+    return () => {
+      window.removeEventListener("scroll", updatePosition, true);
+      window.removeEventListener("resize", updatePosition);
+    };
+  }, [updatePosition]);
+
+  const arrowClasses =
+    coords?.actualPosition === "top" ? "top-full" : "bottom-full rotate-180";
+
+  return createPortal(
+    <div
+      ref={tooltipRef}
+      style={{
+        position: "fixed",
+        top: coords?.top ?? -9999,
+        left: coords?.left ?? -9999,
+        width: TOOLTIP_WIDTH,
+        zIndex: 9999,
+        opacity: coords ? 1 : 0,
+      }}
+      className="px-3 py-2 bg-background border border-mid-gray/80 rounded-lg shadow-lg whitespace-normal transition-opacity duration-150"
+    >
+      {children}
+      <div
+        style={{ left: coords?.arrowLeft ?? 0 }}
+        className={`absolute ${arrowClasses} transform -translate-x-1/2 w-0 h-0 border-l-[6px] border-r-[6px] border-t-[6px] border-l-transparent border-r-transparent border-t-mid-gray/80`}
+      />
+    </div>,
+    document.body,
+  );
+};
diff --git a/src/components/ui/index.ts b/src/components/ui/index.ts
index 71f2e28..11a10f1 100644
--- a/src/components/ui/index.ts
+++ b/src/components/ui/index.ts
@@ -5,3 +5,4 @@ export { SettingContainer } from "./SettingContainer";
 export { SettingsGroup } from "./SettingsGroup";
 export { TextDisplay } from "./TextDisplay";
 export { Textarea } from "./Textarea";
+export { Tooltip } from "./Tooltip";