@yahoo/uds 3.177.0 → 3.179.0

package/dist/automated-config/dist/generated/generatedConfigs.cjs

@@ -48333,7 +48333,7 @@ const ToastConfig = {
 	}
 };
 const TooltipConfig = {
-	description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.",
+	description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.",
 	label: "Tooltip",
 	variants: {
 		size: {

package/dist/automated-config/dist/generated/generatedConfigs.d.cts

@@ -5300,7 +5300,7 @@ declare const ToastConfig: {
   };
 };
 declare const TooltipConfig: {
-  readonly description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.";
+  readonly description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.";
   readonly label: "Tooltip";
   readonly variants: {
     readonly size: {

package/dist/automated-config/dist/generated/generatedConfigs.d.ts

@@ -5300,7 +5300,7 @@ declare const ToastConfig: {
   };
 };
 declare const TooltipConfig: {
-  readonly description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.";
+  readonly description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.";
   readonly label: "Tooltip";
   readonly variants: {
     readonly size: {

package/dist/automated-config/dist/generated/generatedConfigs.js

@@ -48333,7 +48333,7 @@ const ToastConfig = {
 	}
 };
 const TooltipConfig = {
-	description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.",
+	description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.",
 	label: "Tooltip",
 	variants: {
 		size: {

package/dist/components/client/Popover/UDSPopoverConfigProvider.d.cts

@@ -24,7 +24,7 @@ declare function usePopoverConfig(sizeProp?: PopoverSize | undefined, variantPro
   gap: SpacingAlias;
   dismissButtonSpacing: SpacingAlias;
   dismissIconSize: number;
-  ariaKitPlacement: ("bottom-start" | "bottom-end" | "top-start" | "top-end" | ("bottom" | "left" | "right" | "top") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
+  ariaKitPlacement: ("top-start" | "top-end" | "bottom-start" | "bottom-end" | ("top" | "bottom" | "left" | "right") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
   animationDuration: number;
 };
 //#endregion

package/dist/components/client/Popover/UDSPopoverConfigProvider.d.ts

@@ -25,7 +25,7 @@ declare function usePopoverConfig(sizeProp?: PopoverSize | undefined, variantPro
   gap: SpacingAlias;
   dismissButtonSpacing: SpacingAlias;
   dismissIconSize: number;
-  ariaKitPlacement: ("bottom-start" | "bottom-end" | "top-start" | "top-end" | ("bottom" | "left" | "right" | "top") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
+  ariaKitPlacement: ("top-start" | "top-end" | "bottom-start" | "bottom-end" | ("top" | "bottom" | "left" | "right") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
   animationDuration: number;
 };
 //#endregion

package/dist/components/client/Tooltip/Tooltip.cjs

@@ -12,7 +12,7 @@ let _ariakit_react = require("@ariakit/react");
 * @componentType Client component
 *
 * @description
-* Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.
+* Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.
 *
 * Tooltips are not meant for critical information or required actions. If the user must take action, use a Dialog, Popover, or Inline messaging instead.
 *

package/dist/components/client/Tooltip/Tooltip.d.cts

@@ -8,7 +8,7 @@ type TooltipProps = UniversalTooltipProps;
  * @componentType Client component
  *
  * @description
- * Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.
+ * Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.
  *
  * Tooltips are not meant for critical information or required actions. If the user must take action, use a Dialog, Popover, or Inline messaging instead.
  *

package/dist/components/client/Tooltip/Tooltip.d.ts

@@ -9,7 +9,7 @@ type TooltipProps = UniversalTooltipProps;
  * @componentType Client component
  *
  * @description
- * Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.
+ * Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.
  *
  * Tooltips are not meant for critical information or required actions. If the user must take action, use a Dialog, Popover, or Inline messaging instead.
  *

package/dist/components/client/Tooltip/Tooltip.js

@@ -11,7 +11,7 @@ import { TooltipProvider } from "@ariakit/react";
 * @componentType Client component
 *
 * @description
-* Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.
+* Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.
 *
 * Tooltips are not meant for critical information or required actions. If the user must take action, use a Dialog, Popover, or Inline messaging instead.
 *

package/dist/components/client/Tooltip/TooltipTrigger.cjs

@@ -1,14 +1,74 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_components_client_Tooltip_tooltipContext = require("./tooltipContext.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _ariakit_react = require("@ariakit/react");
 //#region src/components/client/Tooltip/TooltipTrigger.tsx
+/**
+* Touch devices (mobile browsers and in-app webviews) don't produce real hover
+* or keyboard focus, so Ariakit's anchor never opens the tooltip from a tap.
+* Track the pointer type of the last press and toggle the tooltip when a touch
+* tap results in a click. A tap anywhere outside the trigger or the tooltip
+* closes it again.
+*/
+function useTouchToggle() {
+	const store = (0, _ariakit_react.useTooltipContext)();
+	const isControlled = (0, react.useContext)(require_components_client_Tooltip_tooltipContext.TooltipInternalContext)?.isControlled ?? false;
+	const open = (0, _ariakit_react.useStoreState)(store, "open");
+	const lastPointerTypeRef = (0, react.useRef)(null);
+	const openedByTouchRef = (0, react.useRef)(false);
+	(0, react.useEffect)(() => {
+		if (!open) {
+			openedByTouchRef.current = false;
+			return;
+		}
+		if (!store || isControlled || !openedByTouchRef.current) return;
+		const onPointerDownOutside = (event) => {
+			const target = event.target;
+			const { anchorElement, contentElement } = store.getState();
+			if (target && (anchorElement?.contains(target) || contentElement?.contains(target))) return;
+			store.hide();
+		};
+		document.addEventListener("pointerdown", onPointerDownOutside, true);
+		return () => document.removeEventListener("pointerdown", onPointerDownOutside, true);
+	}, [
+		open,
+		store,
+		isControlled
+	]);
+	const onPointerDown = (event) => {
+		lastPointerTypeRef.current = event.pointerType;
+		if (event.pointerType === "touch" && store) store.setDisclosureElement(event.currentTarget);
+	};
+	const onClick = (event) => {
+		const pointerType = lastPointerTypeRef.current;
+		lastPointerTypeRef.current = null;
+		if (pointerType !== "touch" || !store || isControlled || event.defaultPrevented) return;
+		if (store.getState().open) {
+			store.hide();
+			return;
+		}
+		store.setAnchorElement(event.currentTarget);
+		store.setDisclosureElement(event.currentTarget);
+		openedByTouchRef.current = true;
+		store.show();
+	};
+	return {
+		onPointerDown,
+		onClick
+	};
+}
 function TooltipTrigger({ children }) {
-	if ((0, react.isValidElement)(children) && children.type !== react.Fragment) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_ariakit_react.TooltipAnchor, { render: children });
+	const touchProps = useTouchToggle();
+	if ((0, react.isValidElement)(children) && children.type !== react.Fragment) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_ariakit_react.TooltipAnchor, {
+		render: children,
+		...touchProps
+	});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_ariakit_react.TooltipAnchor, {
 		className: "inline",
+		...touchProps,
 		children
 	});
 }

package/dist/components/client/Tooltip/TooltipTrigger.js

@@ -1,13 +1,73 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 "use client";
-import { Fragment, isValidElement } from "react";
+import { TooltipInternalContext } from "./tooltipContext.js";
+import { Fragment, isValidElement, useContext, useEffect, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
-import { TooltipAnchor } from "@ariakit/react";
+import { TooltipAnchor, useStoreState, useTooltipContext } from "@ariakit/react";
 //#region src/components/client/Tooltip/TooltipTrigger.tsx
+/**
+* Touch devices (mobile browsers and in-app webviews) don't produce real hover
+* or keyboard focus, so Ariakit's anchor never opens the tooltip from a tap.
+* Track the pointer type of the last press and toggle the tooltip when a touch
+* tap results in a click. A tap anywhere outside the trigger or the tooltip
+* closes it again.
+*/
+function useTouchToggle() {
+	const store = useTooltipContext();
+	const isControlled = useContext(TooltipInternalContext)?.isControlled ?? false;
+	const open = useStoreState(store, "open");
+	const lastPointerTypeRef = useRef(null);
+	const openedByTouchRef = useRef(false);
+	useEffect(() => {
+		if (!open) {
+			openedByTouchRef.current = false;
+			return;
+		}
+		if (!store || isControlled || !openedByTouchRef.current) return;
+		const onPointerDownOutside = (event) => {
+			const target = event.target;
+			const { anchorElement, contentElement } = store.getState();
+			if (target && (anchorElement?.contains(target) || contentElement?.contains(target))) return;
+			store.hide();
+		};
+		document.addEventListener("pointerdown", onPointerDownOutside, true);
+		return () => document.removeEventListener("pointerdown", onPointerDownOutside, true);
+	}, [
+		open,
+		store,
+		isControlled
+	]);
+	const onPointerDown = (event) => {
+		lastPointerTypeRef.current = event.pointerType;
+		if (event.pointerType === "touch" && store) store.setDisclosureElement(event.currentTarget);
+	};
+	const onClick = (event) => {
+		const pointerType = lastPointerTypeRef.current;
+		lastPointerTypeRef.current = null;
+		if (pointerType !== "touch" || !store || isControlled || event.defaultPrevented) return;
+		if (store.getState().open) {
+			store.hide();
+			return;
+		}
+		store.setAnchorElement(event.currentTarget);
+		store.setDisclosureElement(event.currentTarget);
+		openedByTouchRef.current = true;
+		store.show();
+	};
+	return {
+		onPointerDown,
+		onClick
+	};
+}
 function TooltipTrigger({ children }) {
-	if (isValidElement(children) && children.type !== Fragment) return /* @__PURE__ */ jsx(TooltipAnchor, { render: children });
+	const touchProps = useTouchToggle();
+	if (isValidElement(children) && children.type !== Fragment) return /* @__PURE__ */ jsx(TooltipAnchor, {
+		render: children,
+		...touchProps
+	});
 	return /* @__PURE__ */ jsx(TooltipAnchor, {
 		className: "inline",
+		...touchProps,
 		children
 	});
 }

package/dist/tailwind-internal/dist/packages/automated-config/dist/generated/generatedConfigs.cjs

@@ -48334,7 +48334,7 @@ const ToastConfig = {
 	}
 };
 const TooltipConfig = {
-	description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.",
+	description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.",
 	label: "Tooltip",
 	variants: {
 		size: {

package/dist/tailwind-internal/dist/packages/automated-config/dist/generated/generatedConfigs.js

@@ -48334,7 +48334,7 @@ const ToastConfig = {
 	}
 };
 const TooltipConfig = {
-	description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or long-press, and should clarify meaning—not introduce new concepts.",
+	description: "Tooltips provide short, contextual help for UI elements. They appear on hover, focus, or tap, and should clarify meaning—not introduce new concepts.",
 	label: "Tooltip",
 	variants: {
 		size: {