@yahoo/uds 3.99.0 → 3.100.0-beta.2

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

@@ -0,0 +1,240 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+//#region src/components/client/Tooltip/util.ts
+/**
+* Splits a CSS value on whitespace, but keeps parenthesized groups
+* (e.g. `rgb(0, 0, 0)`) together as single tokens.
+*/
+function tokenizeCSSValue(value) {
+	const tokens = [];
+	let current = "";
+	let depth = 0;
+	for (const char of value) {
+		if (char === "(") depth++;
+		if (char === ")") depth--;
+		if (char === " " && depth === 0) {
+			if (current) tokens.push(current);
+			current = "";
+		} else current += char;
+	}
+	if (current) tokens.push(current);
+	return tokens;
+}
+/**
+* Returns `true` if the token is a CSS color value.
+*
+* In a box-shadow context (after filtering `inset`), every token is either a
+* length or a color. Colors always start with `#` (hex), a letter (named
+* colors like `red`, `transparent`, `currentcolor`), or are a CSS function
+* containing `(` (e.g. `rgb(…)`, `hsl(…)`, `oklch(…)`).
+*/
+function isColorToken(token) {
+	const ch = token[0];
+	return ch !== "-" && ch !== "." && (ch < "0" || ch > "9");
+}
+/**
+* Splits a CSS multi-shadow value (comma-separated) into individual
+* shadow strings, correctly handling commas nested inside color functions
+* like `rgb()`, `rgba()`, `hsl()`, etc.
+*/
+function splitShadows(value) {
+	const shadows = [];
+	let current = "";
+	let depth = 0;
+	for (let i = 0; i < value.length; i++) {
+		const char = value[i];
+		if (char === "(") {
+			depth++;
+			current += char;
+		} else if (char === ")") {
+			depth--;
+			current += char;
+		} else if (char === "," && depth === 0) {
+			if (current.trim()) shadows.push(current.trim());
+			current = "";
+		} else current += char;
+	}
+	if (current.trim()) shadows.push(current.trim());
+	return shadows;
+}
+/**
+* Parses a single CSS shadow value string into its constituent parts.
+*
+* Handles all standard CSS box-shadow / drop-shadow permutations:
+* - Color before or after length values (`red 0 4px 8px` or `0 4px 8px red`)
+* - Optional blur and spread radii (defaults to 0)
+* - `inset` keyword at any position (silently ignored)
+* - All color formats: named, hex (3/4/6/8-digit), rgb/rgba, hsl/hsla, oklch,
+*   oklab, lab, lch, color(), color-mix(), light-dark(), etc.
+* - `none` / empty values → zeroed-out result with `transparent` color
+*/
+function parseSingleShadow(shadow) {
+	const value = shadow.trim();
+	if (!value || value.toLowerCase() === "none") return {
+		x: 0,
+		y: 0,
+		blur: 0,
+		spread: 0,
+		color: "transparent"
+	};
+	const tokens = tokenizeCSSValue(value);
+	const lengths = [];
+	const colorParts = [];
+	for (const token of tokens) {
+		if (token.toLowerCase() === "inset") continue;
+		if (isColorToken(token)) colorParts.push(token);
+		else lengths.push(token);
+	}
+	return {
+		x: lengths.length > 0 ? parseFloat(lengths[0]) : 0,
+		y: lengths.length > 1 ? parseFloat(lengths[1]) : 0,
+		blur: lengths.length > 2 ? parseFloat(lengths[2]) : 0,
+		spread: lengths.length > 3 ? parseFloat(lengths[3]) : 0,
+		color: colorParts.length > 0 ? colorParts.join(" ") : "rgb(0 0 0 / 1)"
+	};
+}
+/**
+* Parses a CSS shadow value — which may contain multiple comma-separated
+* layers — into an array of {@link ParsedShadow} objects.
+*
+* @example
+* ```ts
+* parseShadow('0px 4px 8px 0px rgb(0 0 0 / 0.12)')
+* // → [{ x: 0, y: 4, blur: 8, spread: 0, color: 'rgb(0 0 0 / 0.12)' }]
+*
+* parseShadow('0px 4px 8px rgb(0 0 0 / 0.12), 0px 1px 2px rgba(0, 0, 0, 0.08)')
+* // → [
+* //     { x: 0, y: 4, blur: 8, spread: 0, color: 'rgb(0 0 0 / 0.12)' },
+* //     { x: 0, y: 1, blur: 2, spread: 0, color: 'rgba(0, 0, 0, 0.08)' },
+* //   ]
+* ```
+*/
+function parseShadow(shadowValue) {
+	const trimmed = shadowValue.trim();
+	if (!trimmed || trimmed.toLowerCase() === "none") return [];
+	return splitShadows(trimmed).map(parseSingleShadow);
+}
+/** Base width of the arrow triangle (px). */
+const ARROW_WIDTH = 12;
+/** Height (protrusion) of the arrow triangle from the edge (px). */
+const ARROW_HEIGHT = 8;
+/**
+* Fraction of the container border-radius applied to round the arrow tip
+* (0 = sharp point, 1 = same radius as the container corners).
+*/
+const ARROW_TIP_RADIUS_FRACTION = .5;
+/**
+* Returns the side of the tooltip where the arrow should appear.
+* The arrow points *toward* the trigger, so it lives on the opposite
+* side of the placement direction.
+*/
+function getArrowSide(placement) {
+	switch (placement.split("-")[0]) {
+		case "bottom": return "top";
+		case "top": return "bottom";
+		case "left": return "right";
+		case "right": return "left";
+		default: return "top";
+	}
+}
+/**
+* Generates an SVG `<path>` string for a rounded rectangle with an arrow
+* pointing toward the trigger element.
+*
+* The path is traced clockwise, inserting the arrow triangle on the
+* appropriate edge.  The arrow extends *outside* the 0,0 → width,height
+* rectangle so the host `<svg>` must use `overflow: visible`.
+*/
+function generateTooltipPath({ width, height, placement, borderRadius, arrowWidth = ARROW_WIDTH, arrowHeight = ARROW_HEIGHT, arrowCenter, offsetX: ox = 0, offsetY: oy = 0 }) {
+	const aw = arrowWidth / 2;
+	const ah = arrowHeight;
+	const arrowSide = getArrowSide(placement);
+	const arrowEdge = arrowSide === "top" || arrowSide === "bottom" ? width : height;
+	const otherEdge = arrowSide === "top" || arrowSide === "bottom" ? height : width;
+	const maxRadius = Math.min(otherEdge / 2, (arrowEdge - arrowWidth) / 2);
+	const r = Math.max(0, Math.min(borderRadius, maxRadius));
+	const minAc = r + aw;
+	const edgeLength = arrowSide === "top" || arrowSide === "bottom" ? width : height;
+	let ac = arrowCenter ?? edgeLength / 2;
+	ac = Math.max(minAc, Math.min(edgeLength - minAc, ac));
+	const edgeLen = Math.sqrt(aw * aw + ah * ah);
+	const tipR = r > 0 && edgeLen > 0 ? Math.min(r * ARROW_TIP_RADIUS_FRACTION, edgeLen / 2) : 0;
+	const daw = edgeLen > 0 ? aw / edgeLen : 0;
+	const dah = edgeLen > 0 ? ah / edgeLen : 0;
+	const d = [];
+	d.push(`M ${r + ox} ${oy}`);
+	if (arrowSide === "top") {
+		d.push(`L ${ac - aw + ox} ${oy}`);
+		if (tipR > 0) {
+			d.push(`L ${ac - tipR * daw + ox} ${-ah + tipR * dah + oy}`);
+			d.push(`Q ${ac + ox} ${-ah + oy} ${ac + tipR * daw + ox} ${-ah + tipR * dah + oy}`);
+		} else d.push(`L ${ac + ox} ${-ah + oy}`);
+		d.push(`L ${ac + aw + ox} ${oy}`);
+	}
+	d.push(`L ${width - r + ox} ${oy}`);
+	d.push(`A ${r} ${r} 0 0 1 ${width + ox} ${r + oy}`);
+	if (arrowSide === "right") {
+		d.push(`L ${width + ox} ${ac - aw + oy}`);
+		if (tipR > 0) {
+			d.push(`L ${width + ah - tipR * dah + ox} ${ac - tipR * daw + oy}`);
+			d.push(`Q ${width + ah + ox} ${ac + oy} ${width + ah - tipR * dah + ox} ${ac + tipR * daw + oy}`);
+		} else d.push(`L ${width + ah + ox} ${ac + oy}`);
+		d.push(`L ${width + ox} ${ac + aw + oy}`);
+	}
+	d.push(`L ${width + ox} ${height - r + oy}`);
+	d.push(`A ${r} ${r} 0 0 1 ${width - r + ox} ${height + oy}`);
+	if (arrowSide === "bottom") {
+		d.push(`L ${ac + aw + ox} ${height + oy}`);
+		if (tipR > 0) {
+			d.push(`L ${ac + tipR * daw + ox} ${height + ah - tipR * dah + oy}`);
+			d.push(`Q ${ac + ox} ${height + ah + oy} ${ac - tipR * daw + ox} ${height + ah - tipR * dah + oy}`);
+		} else d.push(`L ${ac + ox} ${height + ah + oy}`);
+		d.push(`L ${ac - aw + ox} ${height + oy}`);
+	}
+	d.push(`L ${r + ox} ${height + oy}`);
+	d.push(`A ${r} ${r} 0 0 1 ${ox} ${height - r + oy}`);
+	if (arrowSide === "left") {
+		d.push(`L ${ox} ${ac + aw + oy}`);
+		if (tipR > 0) {
+			d.push(`L ${-ah + tipR * dah + ox} ${ac + tipR * daw + oy}`);
+			d.push(`Q ${-ah + ox} ${ac + oy} ${-ah + tipR * dah + ox} ${ac - tipR * daw + oy}`);
+		} else d.push(`L ${-ah + ox} ${ac + oy}`);
+		d.push(`L ${ox} ${ac - aw + oy}`);
+	}
+	d.push(`L ${ox} ${r + oy}`);
+	d.push(`A ${r} ${r} 0 0 1 ${r + ox} ${oy}`);
+	d.push("Z");
+	return d.join(" ");
+}
+/**
+* Computes the pixel offset the tooltip must shift so that the SVG arrow
+* (after clamping) visually aligns with the Ariakit arrow's actual position.
+*
+* When the desired `arrowCenter` falls inside the safe zone the delta is 0.
+* When it falls outside (e.g. a tiny trigger near a rounded corner), the
+* returned delta tells the caller how far to translate the tooltip element
+* so the clamped arrow ends up over the trigger center.
+*/
+function getArrowClampDelta({ width, height, placement, borderRadius, arrowCenter, arrowWidth = ARROW_WIDTH }) {
+	const aw = arrowWidth / 2;
+	const side = getArrowSide(placement);
+	const arrowEdge = side === "top" || side === "bottom" ? width : height;
+	const otherEdge = side === "top" || side === "bottom" ? height : width;
+	const maxRadius = Math.min(otherEdge / 2, (arrowEdge - arrowWidth) / 2);
+	const minAc = Math.max(0, Math.min(borderRadius, maxRadius)) + aw;
+	const maxAc = arrowEdge - minAc;
+	let delta = 0;
+	if (arrowCenter < minAc) delta = arrowCenter - minAc;
+	else if (arrowCenter > maxAc) delta = arrowCenter - maxAc;
+	if (side === "top" || side === "bottom") return {
+		x: delta,
+		y: 0
+	};
+	return {
+		x: 0,
+		y: delta
+	};
+}
+
+//#endregion
+export { ARROW_HEIGHT, ARROW_TIP_RADIUS_FRACTION, ARROW_WIDTH, generateTooltipPath, getArrowClampDelta, getArrowSide, parseShadow };

package/dist/components/client/index.cjs

@@ -21,6 +21,7 @@ const require_components_client_Input_InputHelpText = require('./Input/InputHelp
 const require_components_client_Menu_Menu_index = require('./Menu/Menu.index.cjs');
 const require_components_client_providers_UDSBreakpointsConfigProvider = require('./providers/UDSBreakpointsConfigProvider.cjs');
 const require_components_client_Toast_UDSToastConfigProvider = require('./Toast/UDSToastConfigProvider.cjs');
+const require_components_client_Tooltip_UDSTooltipConfigProvider = require('./Tooltip/UDSTooltipConfigProvider.cjs');
 const require_components_client_providers_UDSConfigProvider = require('./providers/UDSConfigProvider.cjs');
 const require_components_client_Radio_Radio = require('./Radio/Radio.cjs');
 const require_components_client_Radio_RadioGroupProvider = require('./Radio/RadioGroupProvider.cjs');
@@ -29,6 +30,9 @@ const require_components_client_Toast_ToastContainer = require('./Toast/ToastCon
 const require_components_client_Toast_Toast = require('./Toast/Toast.cjs');
 const require_components_client_Toast_createToast = require('./Toast/createToast.cjs');
 const require_components_client_Toast_ToastPortal = require('./Toast/ToastPortal.cjs');
+const require_components_client_Tooltip_Tooltip = require('./Tooltip/Tooltip.cjs');
+const require_components_client_Tooltip_TooltipContent = require('./Tooltip/TooltipContent.cjs');
+const require_components_client_Tooltip_TooltipTrigger = require('./Tooltip/TooltipTrigger.cjs');
 
 exports.Avatar = require_components_client_Avatar_Avatar.Avatar;
 exports.AvatarIcon = require_components_client_Avatar_AvatarIcon.AvatarIcon;
@@ -59,9 +63,13 @@ exports.Switch = require_components_client_Switch.Switch;
 exports.Toast = require_components_client_Toast_Toast.Toast;
 exports.ToastContainer = require_components_client_Toast_ToastContainer.ToastContainer;
 exports.ToastPortal = require_components_client_Toast_ToastPortal.ToastPortal;
+exports.Tooltip = require_components_client_Tooltip_Tooltip.Tooltip;
+exports.TooltipContent = require_components_client_Tooltip_TooltipContent.TooltipContent;
+exports.TooltipTrigger = require_components_client_Tooltip_TooltipTrigger.TooltipTrigger;
 exports.UDSBreakpointsConfigProvider = require_components_client_providers_UDSBreakpointsConfigProvider.UDSBreakpointsConfigProvider;
 exports.UDSConfigProvider = require_components_client_providers_UDSConfigProvider.UDSConfigProvider;
 exports.UDSToastConfigProvider = require_components_client_Toast_UDSToastConfigProvider.UDSToastConfigProvider;
+exports.UDSTooltipConfigProvider = require_components_client_Tooltip_UDSTooltipConfigProvider.UDSTooltipConfigProvider;
 exports.createToast = require_components_client_Toast_createToast.createToast;
 exports.useBreakpointsConfig = require_components_client_providers_UDSBreakpointsConfigProvider.useBreakpointsConfig;
 exports.useToastConfig = require_components_client_Toast_UDSToastConfigProvider.useToastConfig;

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

@@ -1,4 +1,5 @@
 
+import { UniversalTooltipContentProps, UniversalTooltipProps, UniversalTooltipTriggerProps } from "../../types/dist/index.cjs";
 import { SpringMotionConfig, SpringMotionConfigProps } from "./SpringMotionConfig.cjs";
 import { AvatarIcon, AvatarIconProps } from "./Avatar/AvatarIcon.cjs";
 import { AvatarText, AvatarTextProps } from "./Avatar/AvatarText.cjs";
@@ -37,6 +38,11 @@ import { ToastPortal, ToastPortalProps } from "./Toast/ToastPortal.cjs";
 import { UDSToastConfigProvider, UDSToastConfigProviderProps, useToastConfig } from "./Toast/UDSToastConfigProvider.cjs";
 import { ToastLoadingPromise, createToast } from "./Toast/createToast.cjs";
 import "./Toast/index.cjs";
+import { Tooltip } from "./Tooltip/Tooltip.cjs";
+import { TooltipContent } from "./Tooltip/TooltipContent.cjs";
+import { TooltipTrigger } from "./Tooltip/TooltipTrigger.cjs";
+import { UDSTooltipConfigProvider, UDSTooltipConfigProviderProps } from "./Tooltip/UDSTooltipConfigProvider.cjs";
+import "./Tooltip/index.cjs";
 import { UDSBreakpointsConfigProvider, UDSBreakpointsConfigProviderProps, useBreakpointsConfig } from "./providers/UDSBreakpointsConfigProvider.cjs";
 import { UDSConfigProvider, UDSConfigProviderProps } from "./providers/UDSConfigProvider.cjs";
-export { Avatar, AvatarIcon, type AvatarIconProps, AvatarImage, type AvatarImageProps, type AvatarProps, AvatarText, type AvatarTextProps, Badge, type BadgeProps, Button, type ButtonProps, Checkbox, type CheckboxProps, Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, IconButton, type IconButtonProps, Input, InputHelpText, type InputHelpTextProps, type InputProps, Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, Pressable, type PressableProps, Radio, RadioGroupProvider, type RadioGroupProviderProps, type RadioProps, SpringMotionConfig, type SpringMotionConfigProps, Switch, type SwitchProps, Toast, ToastContainer, type ToastContainerProps, type ToastLoadingPromise, ToastPortal, type ToastPortalProps, type ToastProps, UDSBreakpointsConfigProvider, type UDSBreakpointsConfigProviderProps, UDSConfigProvider, type UDSConfigProviderProps, UDSToastConfigProvider, type UDSToastConfigProviderProps, createToast, useBreakpointsConfig, useToastConfig };
+export { Avatar, AvatarIcon, type AvatarIconProps, AvatarImage, type AvatarImageProps, type AvatarProps, AvatarText, type AvatarTextProps, Badge, type BadgeProps, Button, type ButtonProps, Checkbox, type CheckboxProps, Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, IconButton, type IconButtonProps, Input, InputHelpText, type InputHelpTextProps, type InputProps, Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, Pressable, type PressableProps, Radio, RadioGroupProvider, type RadioGroupProviderProps, type RadioProps, SpringMotionConfig, type SpringMotionConfigProps, Switch, type SwitchProps, Toast, ToastContainer, type ToastContainerProps, type ToastLoadingPromise, ToastPortal, type ToastPortalProps, type ToastProps, Tooltip, TooltipContent, type UniversalTooltipContentProps as TooltipContentProps, type UniversalTooltipProps as TooltipProps, TooltipTrigger, type UniversalTooltipTriggerProps as TooltipTriggerProps, UDSBreakpointsConfigProvider, type UDSBreakpointsConfigProviderProps, UDSConfigProvider, type UDSConfigProviderProps, UDSToastConfigProvider, type UDSToastConfigProviderProps, UDSTooltipConfigProvider, type UDSTooltipConfigProviderProps, createToast, useBreakpointsConfig, useToastConfig };

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

@@ -1,4 +1,5 @@
 
+import { UniversalTooltipContentProps, UniversalTooltipProps, UniversalTooltipTriggerProps } from "../../types/dist/index.js";
 import { SpringMotionConfig, SpringMotionConfigProps } from "./SpringMotionConfig.js";
 import { AvatarIcon, AvatarIconProps } from "./Avatar/AvatarIcon.js";
 import { AvatarText, AvatarTextProps } from "./Avatar/AvatarText.js";
@@ -37,6 +38,11 @@ import { ToastPortal, ToastPortalProps } from "./Toast/ToastPortal.js";
 import { UDSToastConfigProvider, UDSToastConfigProviderProps, useToastConfig } from "./Toast/UDSToastConfigProvider.js";
 import { ToastLoadingPromise, createToast } from "./Toast/createToast.js";
 import "./Toast/index.js";
+import { Tooltip } from "./Tooltip/Tooltip.js";
+import { TooltipContent } from "./Tooltip/TooltipContent.js";
+import { TooltipTrigger } from "./Tooltip/TooltipTrigger.js";
+import { UDSTooltipConfigProvider, UDSTooltipConfigProviderProps } from "./Tooltip/UDSTooltipConfigProvider.js";
+import "./Tooltip/index.js";
 import { UDSBreakpointsConfigProvider, UDSBreakpointsConfigProviderProps, useBreakpointsConfig } from "./providers/UDSBreakpointsConfigProvider.js";
 import { UDSConfigProvider, UDSConfigProviderProps } from "./providers/UDSConfigProvider.js";
-export { Avatar, AvatarIcon, type AvatarIconProps, AvatarImage, type AvatarImageProps, type AvatarProps, AvatarText, type AvatarTextProps, Badge, type BadgeProps, Button, type ButtonProps, Checkbox, type CheckboxProps, Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, IconButton, type IconButtonProps, Input, InputHelpText, type InputHelpTextProps, type InputProps, Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, Pressable, type PressableProps, Radio, RadioGroupProvider, type RadioGroupProviderProps, type RadioProps, SpringMotionConfig, type SpringMotionConfigProps, Switch, type SwitchProps, Toast, ToastContainer, type ToastContainerProps, type ToastLoadingPromise, ToastPortal, type ToastPortalProps, type ToastProps, UDSBreakpointsConfigProvider, type UDSBreakpointsConfigProviderProps, UDSConfigProvider, type UDSConfigProviderProps, UDSToastConfigProvider, type UDSToastConfigProviderProps, createToast, useBreakpointsConfig, useToastConfig };
+export { Avatar, AvatarIcon, type AvatarIconProps, AvatarImage, type AvatarImageProps, type AvatarProps, AvatarText, type AvatarTextProps, Badge, type BadgeProps, Button, type ButtonProps, Checkbox, type CheckboxProps, Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, IconButton, type IconButtonProps, Input, InputHelpText, type InputHelpTextProps, type InputProps, Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, Pressable, type PressableProps, Radio, RadioGroupProvider, type RadioGroupProviderProps, type RadioProps, SpringMotionConfig, type SpringMotionConfigProps, Switch, type SwitchProps, Toast, ToastContainer, type ToastContainerProps, type ToastLoadingPromise, ToastPortal, type ToastPortalProps, type ToastProps, Tooltip, TooltipContent, type UniversalTooltipContentProps as TooltipContentProps, type UniversalTooltipProps as TooltipProps, TooltipTrigger, type UniversalTooltipTriggerProps as TooltipTriggerProps, UDSBreakpointsConfigProvider, type UDSBreakpointsConfigProviderProps, UDSConfigProvider, type UDSConfigProviderProps, UDSToastConfigProvider, type UDSToastConfigProviderProps, UDSTooltipConfigProvider, type UDSTooltipConfigProviderProps, createToast, useBreakpointsConfig, useToastConfig };

package/dist/components/client/index.js

@@ -20,6 +20,7 @@ import { InputHelpText } from "./Input/InputHelpText.js";
 import { Menu_index_exports } from "./Menu/Menu.index.js";
 import { UDSBreakpointsConfigProvider, useBreakpointsConfig } from "./providers/UDSBreakpointsConfigProvider.js";
 import { UDSToastConfigProvider, useToastConfig } from "./Toast/UDSToastConfigProvider.js";
+import { UDSTooltipConfigProvider } from "./Tooltip/UDSTooltipConfigProvider.js";
 import { UDSConfigProvider } from "./providers/UDSConfigProvider.js";
 import { Radio } from "./Radio/Radio.js";
 import { RadioGroupProvider } from "./Radio/RadioGroupProvider.js";
@@ -28,5 +29,8 @@ import { ToastContainer } from "./Toast/ToastContainer.js";
 import { Toast } from "./Toast/Toast.js";
 import { createToast } from "./Toast/createToast.js";
 import { ToastPortal } from "./Toast/ToastPortal.js";
+import { Tooltip } from "./Tooltip/Tooltip.js";
+import { TooltipContent } from "./Tooltip/TooltipContent.js";
+import { TooltipTrigger } from "./Tooltip/TooltipTrigger.js";
 
-export { Avatar, AvatarIcon, AvatarImage, AvatarText, Badge, Button, Checkbox, Chip, ChipButton, ChipDismissible, ChipLink, ChipToggle, IconButton, Input, InputHelpText, Menu_index_exports as Menu, Pressable, Radio, RadioGroupProvider, SpringMotionConfig, Switch, Toast, ToastContainer, ToastPortal, UDSBreakpointsConfigProvider, UDSConfigProvider, UDSToastConfigProvider, createToast, useBreakpointsConfig, useToastConfig };
+export { Avatar, AvatarIcon, AvatarImage, AvatarText, Badge, Button, Checkbox, Chip, ChipButton, ChipDismissible, ChipLink, ChipToggle, IconButton, Input, InputHelpText, Menu_index_exports as Menu, Pressable, Radio, RadioGroupProvider, SpringMotionConfig, Switch, Toast, ToastContainer, ToastPortal, Tooltip, TooltipContent, TooltipTrigger, UDSBreakpointsConfigProvider, UDSConfigProvider, UDSToastConfigProvider, UDSTooltipConfigProvider, createToast, useBreakpointsConfig, useToastConfig };

package/dist/components/client/providers/UDSConfigProvider.cjs

@@ -4,15 +4,19 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
 const require_components_client_providers_UDSBreakpointsConfigProvider = require('./UDSBreakpointsConfigProvider.cjs');
 const require_components_client_Toast_UDSToastConfigProvider = require('../Toast/UDSToastConfigProvider.cjs');
+const require_components_client_Tooltip_UDSTooltipConfigProvider = require('../Tooltip/UDSTooltipConfigProvider.cjs');
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/components/client/providers/UDSConfigProvider.tsx
-const UDSConfigProvider = ({ children, value: { breakpoints, toast } }) => {
+const UDSConfigProvider = ({ children, value: { breakpoints, toast, tooltip } }) => {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_client_providers_UDSBreakpointsConfigProvider.UDSBreakpointsConfigProvider, {
 		value: breakpoints,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_client_Toast_UDSToastConfigProvider.UDSToastConfigProvider, {
 			value: toast,
-			children
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_client_Tooltip_UDSTooltipConfigProvider.UDSTooltipConfigProvider, {
+				value: tooltip,
+				children
+			})
 		})
 	});
 };

package/dist/components/client/providers/UDSConfigProvider.d.cts

@@ -12,7 +12,8 @@ declare const UDSConfigProvider: {
     children,
     value: {
       breakpoints,
-      toast
+      toast,
+      tooltip
     }
   }: UDSConfigProviderProps): react_jsx_runtime0.JSX.Element;
   displayName: string;

package/dist/components/client/providers/UDSConfigProvider.d.ts

@@ -12,7 +12,8 @@ declare const UDSConfigProvider: {
     children,
     value: {
       breakpoints,
-      toast
+      toast,
+      tooltip
     }
   }: UDSConfigProviderProps): react_jsx_runtime0.JSX.Element;
   displayName: string;

package/dist/components/client/providers/UDSConfigProvider.js

@@ -2,15 +2,19 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { UDSBreakpointsConfigProvider } from "./UDSBreakpointsConfigProvider.js";
 import { UDSToastConfigProvider } from "../Toast/UDSToastConfigProvider.js";
+import { UDSTooltipConfigProvider } from "../Tooltip/UDSTooltipConfigProvider.js";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/client/providers/UDSConfigProvider.tsx
-const UDSConfigProvider = ({ children, value: { breakpoints, toast } }) => {
+const UDSConfigProvider = ({ children, value: { breakpoints, toast, tooltip } }) => {
 	return /* @__PURE__ */ jsx(UDSBreakpointsConfigProvider, {
 		value: breakpoints,
 		children: /* @__PURE__ */ jsx(UDSToastConfigProvider, {
 			value: toast,
-			children
+			children: /* @__PURE__ */ jsx(UDSTooltipConfigProvider, {
+				value: tooltip,
+				children
+			})
 		})
 	});
 };

package/dist/components/index.cjs

@@ -29,6 +29,7 @@ const require_components_client_Input_InputHelpText = require('./client/Input/In
 const require_components_client_Menu_Menu_index = require('./client/Menu/Menu.index.cjs');
 const require_components_client_providers_UDSBreakpointsConfigProvider = require('./client/providers/UDSBreakpointsConfigProvider.cjs');
 const require_components_client_Toast_UDSToastConfigProvider = require('./client/Toast/UDSToastConfigProvider.cjs');
+const require_components_client_Tooltip_UDSTooltipConfigProvider = require('./client/Tooltip/UDSTooltipConfigProvider.cjs');
 const require_components_client_providers_UDSConfigProvider = require('./client/providers/UDSConfigProvider.cjs');
 const require_components_client_Radio_Radio = require('./client/Radio/Radio.cjs');
 const require_components_client_Radio_RadioGroupProvider = require('./client/Radio/RadioGroupProvider.cjs');
@@ -37,6 +38,9 @@ const require_components_client_Toast_ToastContainer = require('./client/Toast/T
 const require_components_client_Toast_Toast = require('./client/Toast/Toast.cjs');
 const require_components_client_Toast_createToast = require('./client/Toast/createToast.cjs');
 const require_components_client_Toast_ToastPortal = require('./client/Toast/ToastPortal.cjs');
+const require_components_client_Tooltip_Tooltip = require('./client/Tooltip/Tooltip.cjs');
+const require_components_client_Tooltip_TooltipContent = require('./client/Tooltip/TooltipContent.cjs');
+const require_components_client_Tooltip_TooltipTrigger = require('./client/Tooltip/TooltipTrigger.cjs');
 
 exports.Avatar = require_components_client_Avatar_Avatar.Avatar;
 exports.AvatarIcon = require_components_client_Avatar_AvatarIcon.AvatarIcon;
@@ -75,9 +79,13 @@ exports.Text = require_components_Text.Text;
 exports.Toast = require_components_client_Toast_Toast.Toast;
 exports.ToastContainer = require_components_client_Toast_ToastContainer.ToastContainer;
 exports.ToastPortal = require_components_client_Toast_ToastPortal.ToastPortal;
+exports.Tooltip = require_components_client_Tooltip_Tooltip.Tooltip;
+exports.TooltipContent = require_components_client_Tooltip_TooltipContent.TooltipContent;
+exports.TooltipTrigger = require_components_client_Tooltip_TooltipTrigger.TooltipTrigger;
 exports.UDSBreakpointsConfigProvider = require_components_client_providers_UDSBreakpointsConfigProvider.UDSBreakpointsConfigProvider;
 exports.UDSConfigProvider = require_components_client_providers_UDSConfigProvider.UDSConfigProvider;
 exports.UDSToastConfigProvider = require_components_client_Toast_UDSToastConfigProvider.UDSToastConfigProvider;
+exports.UDSTooltipConfigProvider = require_components_client_Tooltip_UDSTooltipConfigProvider.UDSTooltipConfigProvider;
 exports.VStack = require_components_VStack.VStack;
 exports.createToast = require_components_client_Toast_createToast.createToast;
 exports.useBreakpointsConfig = require_components_client_providers_UDSBreakpointsConfigProvider.useBreakpointsConfig;

package/dist/components/index.d.cts

@@ -1,4 +1,5 @@
 
+import { UniversalTooltipContentProps, UniversalTooltipProps, UniversalTooltipTriggerProps } from "../types/dist/index.cjs";
 import { Box, BoxProps } from "./Box.cjs";
 import { Divider, DividerProps } from "./Divider/Divider.cjs";
 import "./Divider/index.cjs";
@@ -41,7 +42,11 @@ import { ToastContainer, ToastContainerProps } from "./client/Toast/ToastContain
 import { ToastPortal, ToastPortalProps } from "./client/Toast/ToastPortal.cjs";
 import { UDSToastConfigProvider, UDSToastConfigProviderProps, useToastConfig } from "./client/Toast/UDSToastConfigProvider.cjs";
 import { ToastLoadingPromise, createToast } from "./client/Toast/createToast.cjs";
+import { Tooltip } from "./client/Tooltip/Tooltip.cjs";
+import { TooltipContent } from "./client/Tooltip/TooltipContent.cjs";
+import { TooltipTrigger } from "./client/Tooltip/TooltipTrigger.cjs";
+import { UDSTooltipConfigProvider, UDSTooltipConfigProviderProps } from "./client/Tooltip/UDSTooltipConfigProvider.cjs";
 import { UDSBreakpointsConfigProvider, UDSBreakpointsConfigProviderProps, useBreakpointsConfig } from "./client/providers/UDSBreakpointsConfigProvider.cjs";
 import { UDSConfigProvider, UDSConfigProviderProps } from "./client/providers/UDSConfigProvider.cjs";
 import "./client/index.cjs";
-export { Avatar, AvatarIcon, type AvatarIconProps, AvatarImage, type AvatarImageProps, type AvatarProps, AvatarText, type AvatarTextProps, Badge, type BadgeProps, Box, type BoxProps, Button, type ButtonProps, Checkbox, type CheckboxProps, Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, Divider, type DividerProps, FormLabel, type FormLabelProps, HStack, type HStackProps, Icon, IconButton, type IconButtonProps, type IconProps, Image, type ImageProps, Input, InputHelpText, type InputHelpTextProps, type InputProps, Link, type LinkProps, Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, Pressable, type PressableProps, Radio, RadioGroupProvider, type RadioGroupProviderProps, type RadioProps, SpringMotionConfig, type SpringMotionConfigProps, Switch, type SwitchProps, Text, type TextProps, Toast, ToastContainer, type ToastContainerProps, type ToastLoadingPromise, ToastPortal, type ToastPortalProps, type ToastProps, UDSBreakpointsConfigProvider, type UDSBreakpointsConfigProviderProps, UDSConfigProvider, type UDSConfigProviderProps, UDSToastConfigProvider, type UDSToastConfigProviderProps, VStack, type VStackProps, createToast, useBreakpointsConfig, useToastConfig };
+export { Avatar, AvatarIcon, type AvatarIconProps, AvatarImage, type AvatarImageProps, type AvatarProps, AvatarText, type AvatarTextProps, Badge, type BadgeProps, Box, type BoxProps, Button, type ButtonProps, Checkbox, type CheckboxProps, Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, Divider, type DividerProps, FormLabel, type FormLabelProps, HStack, type HStackProps, Icon, IconButton, type IconButtonProps, type IconProps, Image, type ImageProps, Input, InputHelpText, type InputHelpTextProps, type InputProps, Link, type LinkProps, Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, Pressable, type PressableProps, Radio, RadioGroupProvider, type RadioGroupProviderProps, type RadioProps, SpringMotionConfig, type SpringMotionConfigProps, Switch, type SwitchProps, Text, type TextProps, Toast, ToastContainer, type ToastContainerProps, type ToastLoadingPromise, ToastPortal, type ToastPortalProps, type ToastProps, Tooltip, TooltipContent, type UniversalTooltipContentProps as TooltipContentProps, type UniversalTooltipProps as TooltipProps, TooltipTrigger, type UniversalTooltipTriggerProps as TooltipTriggerProps, UDSBreakpointsConfigProvider, type UDSBreakpointsConfigProviderProps, UDSConfigProvider, type UDSConfigProviderProps, UDSToastConfigProvider, type UDSToastConfigProviderProps, UDSTooltipConfigProvider, type UDSTooltipConfigProviderProps, VStack, type VStackProps, createToast, useBreakpointsConfig, useToastConfig };

package/dist/components/index.d.ts

@@ -1,4 +1,5 @@
 
+import { UniversalTooltipContentProps, UniversalTooltipProps, UniversalTooltipTriggerProps } from "../types/dist/index.js";
 import { Box, BoxProps } from "./Box.js";
 import { Divider, DividerProps } from "./Divider/Divider.js";
 import "./Divider/index.js";
@@ -41,7 +42,11 @@ import { ToastContainer, ToastContainerProps } from "./client/Toast/ToastContain
 import { ToastPortal, ToastPortalProps } from "./client/Toast/ToastPortal.js";
 import { UDSToastConfigProvider, UDSToastConfigProviderProps, useToastConfig } from "./client/Toast/UDSToastConfigProvider.js";
 import { ToastLoadingPromise, createToast } from "./client/Toast/createToast.js";
+import { Tooltip } from "./client/Tooltip/Tooltip.js";
+import { TooltipContent } from "./client/Tooltip/TooltipContent.js";
+import { TooltipTrigger } from "./client/Tooltip/TooltipTrigger.js";
+import { UDSTooltipConfigProvider, UDSTooltipConfigProviderProps } from "./client/Tooltip/UDSTooltipConfigProvider.js";
 import { UDSBreakpointsConfigProvider, UDSBreakpointsConfigProviderProps, useBreakpointsConfig } from "./client/providers/UDSBreakpointsConfigProvider.js";
 import { UDSConfigProvider, UDSConfigProviderProps } from "./client/providers/UDSConfigProvider.js";
 import "./client/index.js";
-export { Avatar, AvatarIcon, type AvatarIconProps, AvatarImage, type AvatarImageProps, type AvatarProps, AvatarText, type AvatarTextProps, Badge, type BadgeProps, Box, type BoxProps, Button, type ButtonProps, Checkbox, type CheckboxProps, Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, Divider, type DividerProps, FormLabel, type FormLabelProps, HStack, type HStackProps, Icon, IconButton, type IconButtonProps, type IconProps, Image, type ImageProps, Input, InputHelpText, type InputHelpTextProps, type InputProps, Link, type LinkProps, Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, Pressable, type PressableProps, Radio, RadioGroupProvider, type RadioGroupProviderProps, type RadioProps, SpringMotionConfig, type SpringMotionConfigProps, Switch, type SwitchProps, Text, type TextProps, Toast, ToastContainer, type ToastContainerProps, type ToastLoadingPromise, ToastPortal, type ToastPortalProps, type ToastProps, UDSBreakpointsConfigProvider, type UDSBreakpointsConfigProviderProps, UDSConfigProvider, type UDSConfigProviderProps, UDSToastConfigProvider, type UDSToastConfigProviderProps, VStack, type VStackProps, createToast, useBreakpointsConfig, useToastConfig };
+export { Avatar, AvatarIcon, type AvatarIconProps, AvatarImage, type AvatarImageProps, type AvatarProps, AvatarText, type AvatarTextProps, Badge, type BadgeProps, Box, type BoxProps, Button, type ButtonProps, Checkbox, type CheckboxProps, Chip, ChipButton, type ChipButtonProps, ChipDismissible, type ChipDismissibleProps, ChipLink, type ChipLinkProps, type ChipProps, ChipToggle, type ChipToggleProps, Divider, type DividerProps, FormLabel, type FormLabelProps, HStack, type HStackProps, Icon, IconButton, type IconButtonProps, type IconProps, Image, type ImageProps, Input, InputHelpText, type InputHelpTextProps, type InputProps, Link, type LinkProps, Menu_index_d_exports as Menu, type MenuContentProps, type MenuDividerProps, type MenuItemCheckboxProps, type MenuItemProps, type MenuPlacement, type MenuProviderProps, type MenuTriggerProps, Pressable, type PressableProps, Radio, RadioGroupProvider, type RadioGroupProviderProps, type RadioProps, SpringMotionConfig, type SpringMotionConfigProps, Switch, type SwitchProps, Text, type TextProps, Toast, ToastContainer, type ToastContainerProps, type ToastLoadingPromise, ToastPortal, type ToastPortalProps, type ToastProps, Tooltip, TooltipContent, type UniversalTooltipContentProps as TooltipContentProps, type UniversalTooltipProps as TooltipProps, TooltipTrigger, type UniversalTooltipTriggerProps as TooltipTriggerProps, UDSBreakpointsConfigProvider, type UDSBreakpointsConfigProviderProps, UDSConfigProvider, type UDSConfigProviderProps, UDSToastConfigProvider, type UDSToastConfigProviderProps, UDSTooltipConfigProvider, type UDSTooltipConfigProviderProps, VStack, type VStackProps, createToast, useBreakpointsConfig, useToastConfig };

package/dist/components/index.js

@@ -28,6 +28,7 @@ import { InputHelpText } from "./client/Input/InputHelpText.js";
 import { Menu_index_exports } from "./client/Menu/Menu.index.js";
 import { UDSBreakpointsConfigProvider, useBreakpointsConfig } from "./client/providers/UDSBreakpointsConfigProvider.js";
 import { UDSToastConfigProvider, useToastConfig } from "./client/Toast/UDSToastConfigProvider.js";
+import { UDSTooltipConfigProvider } from "./client/Tooltip/UDSTooltipConfigProvider.js";
 import { UDSConfigProvider } from "./client/providers/UDSConfigProvider.js";
 import { Radio } from "./client/Radio/Radio.js";
 import { RadioGroupProvider } from "./client/Radio/RadioGroupProvider.js";
@@ -36,5 +37,8 @@ import { ToastContainer } from "./client/Toast/ToastContainer.js";
 import { Toast } from "./client/Toast/Toast.js";
 import { createToast } from "./client/Toast/createToast.js";
 import { ToastPortal } from "./client/Toast/ToastPortal.js";
+import { Tooltip } from "./client/Tooltip/Tooltip.js";
+import { TooltipContent } from "./client/Tooltip/TooltipContent.js";
+import { TooltipTrigger } from "./client/Tooltip/TooltipTrigger.js";
 
-export { Avatar, AvatarIcon, AvatarImage, AvatarText, Badge, Box, Button, Checkbox, Chip, ChipButton, ChipDismissible, ChipLink, ChipToggle, Divider, FormLabel, HStack, Icon, IconButton, Image, Input, InputHelpText, Link, Menu_index_exports as Menu, Pressable, Radio, RadioGroupProvider, SpringMotionConfig, Switch, Text, Toast, ToastContainer, ToastPortal, UDSBreakpointsConfigProvider, UDSConfigProvider, UDSToastConfigProvider, VStack, createToast, useBreakpointsConfig, useToastConfig };
+export { Avatar, AvatarIcon, AvatarImage, AvatarText, Badge, Box, Button, Checkbox, Chip, ChipButton, ChipDismissible, ChipLink, ChipToggle, Divider, FormLabel, HStack, Icon, IconButton, Image, Input, InputHelpText, Link, Menu_index_exports as Menu, Pressable, Radio, RadioGroupProvider, SpringMotionConfig, Switch, Text, Toast, ToastContainer, ToastPortal, Tooltip, TooltipContent, TooltipTrigger, UDSBreakpointsConfigProvider, UDSConfigProvider, UDSToastConfigProvider, UDSTooltipConfigProvider, VStack, createToast, useBreakpointsConfig, useToastConfig };

package/dist/config/dist/index.cjs

@@ -3,6 +3,100 @@
 //#region ../config/dist/index.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
 const yosConfig = {
+	tooltip: {
+		variables: {
+			"size/default/root": {
+				shadow: { rest: {
+					type: "elevationAliases",
+					valueType: "alias",
+					value: "elevation-0"
+				} },
+				spacingHorizontal: { rest: {
+					type: "spacingAliases",
+					valueType: "alias",
+					value: "3"
+				} },
+				spacingVertical: { rest: {
+					type: "spacingAliases",
+					valueType: "alias",
+					value: "2"
+				} },
+				gap: { rest: {
+					type: "spacingAliases",
+					valueType: "alias",
+					value: "1"
+				} }
+			},
+			"size/default/svg": {
+				borderRadius: { rest: {
+					type: "borderRadii",
+					valueType: "alias",
+					value: "md"
+				} },
+				strokeWidth: { rest: {
+					type: "borderWidths",
+					valueType: "alias",
+					value: "thin"
+				} }
+			},
+			"size/default/title": { textVariant: { rest: {
+				type: "textVariants",
+				valueType: "alias",
+				value: "ui1/emphasized"
+			} } },
+			"size/default/body": { textVariant: { rest: {
+				type: "textVariants",
+				valueType: "alias",
+				value: "ui3/emphasized"
+			} } },
+			"size/default/icon": { size: { rest: {
+				type: "iconSizes",
+				valueType: "alias",
+				value: "xs"
+			} } },
+			"variant/default/root": { color: { rest: {
+				type: "foregroundPaletteColors",
+				valueType: "alias",
+				value: "primary"
+			} } },
+			"variant/default/svg": {
+				backgroundColor: { rest: {
+					type: "elevationAliases",
+					valueType: "alias",
+					value: "elevation-0"
+				} },
+				blurBackgroundColorFallback: { rest: {
+					type: "elevationAliases",
+					valueType: "alias",
+					value: "elevation-0"
+				} },
+				fillOpacity: { rest: {
+					type: "opacitySteps",
+					valueType: "alias",
+					value: "100"
+				} },
+				stroke: { rest: {
+					type: "elevationAliases",
+					valueType: "alias",
+					value: "elevation-0"
+				} }
+			},
+			"variant/default/blur": { backdropBlur: { rest: {
+				type: "positiveIntegers",
+				valueType: "custom",
+				value: 0
+			} } },
+			"variant/default/icon": { color: { rest: {
+				type: "foregroundPaletteColors",
+				valueType: "alias",
+				value: "primary"
+			} } }
+		},
+		defaults: {
+			size: "default",
+			variant: "default"
+		}
+	},
 	toast: {
 		variables: {
 			"variant/success/root": {
@@ -19843,7 +19937,7 @@ const yosConfig = {
 			} }
 		}
 	},
-	version: "v0.77.0",
+	version: "v0.79.0",
 	colorMode: {
 		light: {
 			palette: {