@underverse-ui/underverse 1.0.119 → 1.0.120

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to `@underverse-ui/underverse` are documented in this file.
 
+## Unreleased
+
+### Fixed
+
+- `Tooltip` now closes immediately when its trigger is pressed or when document-level pointer/Escape interactions indicate an overlay flow has taken over. This prevents portal tooltips from sticking on screen after opening dropdowns, popovers, or modals from a tooltip trigger, without overriding the normal hover close delay on pointer movement.
+
 ## [1.0.34] - 2026-02-24
 
 ### Changed

package/api-reference.json

@@ -1,6 +1,6 @@
 {
   "package": "@underverse-ui/underverse",
-  "version": "1.0.119",
+  "version": "1.0.120",
   "sourceEntry": "src/index.ts",
   "totalExports": 232,
   "exports": [

package/dist/index.cjs

@@ -3101,6 +3101,10 @@ var Tooltip = React10.forwardRef(({
       setIsOpen(false);
     }, delayClose);
   };
+  const closeNow = React10.useCallback(() => {
+    clearTimeout(timeoutRef.current);
+    setIsOpen(false);
+  }, []);
   const handleFocus = () => {
     if (disabled) return;
     setIsOpen(true);
@@ -3111,6 +3115,10 @@ var Tooltip = React10.forwardRef(({
   React10.useEffect(() => {
     return () => clearTimeout(timeoutRef.current);
   }, []);
+  React10.useEffect(() => {
+    if (isOpen) return;
+    clearTimeout(timeoutRef.current);
+  }, [isOpen]);
   React10.useLayoutEffect(() => {
     if (!isOpen) {
       lastAppliedRef.current = null;
@@ -3154,6 +3162,18 @@ var Tooltip = React10.forwardRef(({
     if (panelRef.current) ro.observe(panelRef.current);
     return () => ro.disconnect();
   }, [isOpen, updatePosition]);
+  React10.useEffect(() => {
+    if (!isOpen) return;
+    const handleDocumentKeyDown = (event) => {
+      if (event.key === "Escape") closeNow();
+    };
+    document.addEventListener("pointerdown", closeNow, true);
+    document.addEventListener("keydown", handleDocumentKeyDown);
+    return () => {
+      document.removeEventListener("pointerdown", closeNow, true);
+      document.removeEventListener("keydown", handleDocumentKeyDown);
+    };
+  }, [closeNow, isOpen]);
   const childProps = children.props;
   const childRef = childProps.ref;
   const passthroughRef = mergeRefs(forwardedRef, childRef, (node) => {
@@ -3186,6 +3206,22 @@ var Tooltip = React10.forwardRef(({
         handleMouseLeave();
       }
     ),
+    onPointerDown: chainEventHandlers(
+      triggerPassthroughProps.onPointerDown,
+      childProps.onPointerDown,
+      (e) => {
+        triggerRef.current = e.currentTarget;
+        closeNow();
+      }
+    ),
+    onClick: chainEventHandlers(
+      triggerPassthroughProps.onClick,
+      childProps.onClick,
+      (e) => {
+        triggerRef.current = e.currentTarget;
+        closeNow();
+      }
+    ),
     onFocus: chainEventHandlers(
       triggerPassthroughProps.onFocus,
       childProps.onFocus,