@soroush.tech/design-system 2.0.0 → 2.1.0-alpha.1

package/dist/Tooltip-CwbuEQzf.mjs

@@ -0,0 +1,332 @@
+import { a as src_exports, o as styled, t as createShouldForwardProp } from "./src-B-rNjHIL.mjs";
+import { n as useDefaultProps } from "./theme-DyyZQFzQ.mjs";
+import { t as themeDefault } from "./themeDefault-BeZJzqJj.mjs";
+import { t as getSurfaceRadius } from "./getSurfaceRadius-B1QE_VLa.mjs";
+import { t as useControlled } from "./useControlled-B4uQ9Bj6.mjs";
+import { Portal } from "./Portal.mjs";
+import { t as useAnchoredPlacement } from "./useAnchoredPlacement-txSaWzfk.mjs";
+import { t as useMergedRefs } from "./useMergedRefs-CdfwtmUd.mjs";
+import { n as resolveTooltipPlacement, t as getTooltipOrigins } from "./getTooltipOrigins-D0bLLXwY.mjs";
+import { cloneElement, useCallback, useEffect, useId, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+// src/Tooltip/hooks/useTooltip.ts
+const isKeyboardFocus = (event) => {
+	try {
+		return event.target.matches(":focus-visible");
+	} catch {
+		return true;
+	}
+};
+/**
+* The state of a tooltip: whether it is open (its own, or its owner's), the timers that open and
+* close it, and the handlers its child and the tooltip itself take. Opening and closing are
+* delayed; moving from the child onto the tooltip does not close it, so its text can be read and
+* selected (WCAG 1.4.13); Escape closes it at once.
+*/
+function useTooltip({ isOpen: isOpenProp, defaultOpen, isAtPoint = false, onOpen, onClose, enterDelay, leaveDelay, enterTouchDelay, leaveTouchDelay, shouldOpenOnHover, shouldOpenOnFocus, shouldOpenOnTouch }) {
+	const [isOpen, setIsOpen] = useControlled({
+		controlled: isOpenProp,
+		default: defaultOpen
+	});
+	const timer = useRef(void 0);
+	const latest = useRef({
+		isOpen,
+		isOpenProp,
+		isAtPoint,
+		onOpen,
+		onClose
+	});
+	useEffect(() => {
+		latest.current = {
+			isOpen,
+			isOpenProp,
+			isAtPoint,
+			onOpen,
+			onClose
+		};
+	});
+	const clear = useCallback(() => window.clearTimeout(timer.current), []);
+	const ask = useCallback((next, event, delay) => {
+		clear();
+		timer.current = window.setTimeout(() => {
+			const current = latest.current;
+			if (current.isOpen === next) return;
+			if (next && current.isAtPoint) return;
+			if (current.isOpenProp === void 0) setIsOpen(next);
+			(next ? current.onOpen : current.onClose)?.(event);
+		}, delay);
+	}, [clear, setIsOpen]);
+	useEffect(() => clear, [clear]);
+	useEffect(() => {
+		if (!isOpen) return void 0;
+		const handleKeyDown = (event) => {
+			if (event.key === "Escape") ask(false, event, 0);
+		};
+		document.addEventListener("keydown", handleKeyDown);
+		return () => document.removeEventListener("keydown", handleKeyDown);
+	}, [isOpen, ask]);
+	return {
+		isOpen,
+		childHandlers: {
+			onMouseEnter: (event) => {
+				if (shouldOpenOnHover) ask(true, event, enterDelay);
+			},
+			onMouseLeave: (event) => {
+				if (shouldOpenOnHover) ask(false, event, leaveDelay);
+			},
+			onFocus: (event) => {
+				if (shouldOpenOnFocus && isKeyboardFocus(event)) ask(true, event, enterDelay);
+			},
+			onBlur: (event) => {
+				if (shouldOpenOnFocus) ask(false, event, leaveDelay);
+			},
+			onTouchStart: (event) => {
+				if (shouldOpenOnTouch) ask(true, event, enterTouchDelay);
+			},
+			onTouchEnd: (event) => {
+				if (shouldOpenOnTouch) ask(false, event, leaveTouchDelay);
+			},
+			onTouchCancel: (event) => {
+				if (shouldOpenOnTouch) ask(false, event, leaveTouchDelay);
+			},
+			onPointerDown: (event) => {
+				if (event.pointerType !== "touch") ask(false, event, 0);
+			}
+		},
+		surfaceHandlers: {
+			onMouseEnter: () => {
+				if (shouldOpenOnHover) clear();
+			},
+			onMouseLeave: (event) => {
+				if (shouldOpenOnHover) ask(false, event, leaveDelay);
+			}
+		}
+	};
+}
+// src/Tooltip/Tooltip.tsx
+const MARGIN = 8;
+const GAP = 8;
+const ARROW = 8;
+const TooltipSurface = styled("div", {
+	name: "Tooltip",
+	label: "Tooltip",
+	shouldForwardProp: createShouldForwardProp([
+		"layer",
+		"isInteractive",
+		"borderRadius",
+		"bg",
+		"textColor"
+	])
+})(({ theme, layer, isInteractive, borderRadius, bg, textColor }) => ({
+	position: "fixed",
+	...!isInteractive && { pointerEvents: "none" },
+	top: 0,
+	left: 0,
+	visibility: "hidden",
+	zIndex: theme.zOrder[layer],
+	boxSizing: "border-box",
+	maxWidth: "20rem",
+	padding: `${theme.space[.5]} ${theme.space[1]}`,
+	borderRadius: getSurfaceRadius(theme, borderRadius),
+	boxShadow: theme.shadows[4],
+	backgroundColor: (0, src_exports.get)(theme, `background.${bg ?? "modal"}`),
+	color: (0, src_exports.get)(theme, `text.${textColor ?? themeDefault(theme, "textColor", "initial")}`),
+	fontFamily: (0, src_exports.get)(theme, "fonts.body"),
+	fontSize: theme.fontSizes[0],
+	lineHeight: (0, src_exports.get)(theme, "lineHeights.base"),
+	overflowWrap: "break-word"
+}));
+const TooltipDescription = styled("span", { label: "TooltipDescription" })({
+	position: "absolute",
+	width: 1,
+	height: 1,
+	margin: -1,
+	padding: 0,
+	border: 0,
+	overflow: "hidden",
+	clip: "rect(0 0 0 0)",
+	whiteSpace: "nowrap"
+});
+const TooltipTarget = styled("span", { label: "TooltipTarget" })({ display: "inline-grid" });
+const TooltipArrow = styled("span", {
+	name: "Tooltip",
+	slot: "arrow",
+	label: "TooltipArrow"
+})({
+	position: "absolute",
+	width: ARROW,
+	height: ARROW,
+	backgroundColor: "inherit",
+	transform: "rotate(45deg)",
+	pointerEvents: "none"
+});
+const getArrow = ({ anchorRect, surfaceSize, top, left }) => {
+	const { width, height } = surfaceSize;
+	if (top + height <= anchorRect.top + 1 || top >= anchorRect.bottom - 1) {
+		const side = top + height <= anchorRect.top + 1 ? "top" : "bottom";
+		const middle = anchorRect.left + anchorRect.width / 2 - left;
+		return {
+			side,
+			offset: Math.min(Math.max(middle, ARROW), width - ARROW)
+		};
+	}
+	const side = left + width <= anchorRect.left + 1 ? "left" : "right";
+	const middle = anchorRect.top + anchorRect.height / 2 - top;
+	return {
+		side,
+		offset: Math.min(Math.max(middle, ARROW), height - ARROW)
+	};
+};
+const isSameArrow = (a, b) => a !== null && a.side === b.side && a.offset === b.offset;
+const getArrowStyle = ({ side, offset }) => {
+	const half = ARROW / 2;
+	if (side === "top") return {
+		bottom: -4,
+		left: offset - half
+	};
+	if (side === "bottom") return {
+		top: -4,
+		left: offset - half
+	};
+	if (side === "left") return {
+		right: -4,
+		top: offset - half
+	};
+	return {
+		left: -4,
+		top: offset - half
+	};
+};
+const mergeForwarded = (own, forwarded) => Object.fromEntries(Object.entries(forwarded).filter(([, value]) => value !== void 0).map(([name, value]) => {
+	const current = own[name];
+	if (typeof value === "function" && typeof current === "function") return [name, (...args) => {
+		current(...args);
+		value(...args);
+	}];
+	if (name === "aria-describedby" && current) return [name, `${String(current)} ${String(value)}`];
+	return [name, value];
+}));
+const getChildName = (title, own) => {
+	const isHidden = own["aria-hidden"] === true || own["aria-hidden"] === "true";
+	const isNamed = own["aria-label"] !== void 0 || own["aria-labelledby"] !== void 0;
+	return typeof title === "string" && !isHidden && !isNamed ? { "aria-label": title } : {};
+};
+/**
+* @description A short description of one child, shown on hover, keyboard focus and a long touch -
+* a `role="tooltip"` in a `Portal`, placed beside its child and flipped for want of room. The
+* child is named by it (`aria-label`) or described by it (`aria-describedby`, with
+* `shouldDescribeChild`). It opens and closes after their delays, stays open while the pointer is
+* on the tooltip itself, closes on Escape, and never takes or traps the focus.
+*/
+function Tooltip({ children, anchorPosition, title, placement: placementProp, hasArrow: hasArrowProp, enterDelay: enterDelayProp, leaveDelay: leaveDelayProp, enterTouchDelay: enterTouchDelayProp, leaveTouchDelay: leaveTouchDelayProp, shouldDescribeChild: shouldDescribeChildProp, isDescriptionPersistent: isDescriptionPersistentProp, isOpen: isOpenProp, defaultOpen = false, onOpen, onClose, isInteractive: isInteractiveProp, shouldWrapDisabledChild: shouldWrapDisabledChildProp, shouldOpenOnHover: shouldOpenOnHoverProp, shouldOpenOnFocus: shouldOpenOnFocusProp, shouldOpenOnTouch: shouldOpenOnTouchProp, slots, slotProps, layer: layerProp, borderRadius: borderRadiusProp, bg: bgProp, textColor: textColorProp, className, "data-testid": dataTestid, ref: forwardedRef, ...forwarded }) {
+	const dp = useDefaultProps("Tooltip");
+	const placement = placementProp ?? dp.placement ?? "top";
+	const hasArrow = hasArrowProp ?? dp.hasArrow ?? false;
+	const shouldDescribeChild = shouldDescribeChildProp ?? dp.shouldDescribeChild ?? false;
+	const isDescriptionPersistent = isDescriptionPersistentProp ?? dp.isDescriptionPersistent ?? false;
+	const isInteractive = isInteractiveProp ?? dp.isInteractive ?? true;
+	const shouldWrapDisabledChild = shouldWrapDisabledChildProp ?? dp.shouldWrapDisabledChild ?? true;
+	const layer = layerProp ?? dp.layer ?? "tooltip";
+	const borderRadius = borderRadiusProp ?? dp.borderRadius;
+	const bg = bgProp ?? dp.bg;
+	const textColor = textColorProp ?? dp.textColor;
+	const id = useId();
+	const isAtPoint = anchorPosition !== void 0;
+	const { isOpen, childHandlers, surfaceHandlers } = useTooltip({
+		isOpen: isOpenProp,
+		defaultOpen,
+		isAtPoint,
+		onOpen,
+		onClose,
+		enterDelay: enterDelayProp ?? dp.enterDelay ?? 100,
+		leaveDelay: leaveDelayProp ?? dp.leaveDelay ?? 0,
+		enterTouchDelay: enterTouchDelayProp ?? dp.enterTouchDelay ?? 700,
+		leaveTouchDelay: leaveTouchDelayProp ?? dp.leaveTouchDelay ?? 1500,
+		shouldOpenOnHover: shouldOpenOnHoverProp ?? dp.shouldOpenOnHover ?? true,
+		shouldOpenOnFocus: shouldOpenOnFocusProp ?? dp.shouldOpenOnFocus ?? true,
+		shouldOpenOnTouch: shouldOpenOnTouchProp ?? dp.shouldOpenOnTouch ?? true
+	});
+	const hasTitle = title !== void 0 && title !== null && title !== "";
+	const isShown = isOpen && hasTitle;
+	const anchorRef = useRef(null);
+	const noAnchorRef = useRef(null);
+	const surfaceRef = useRef(null);
+	const childProps = children?.props ?? {};
+	const forwardedProps = mergeForwarded(childProps, forwarded);
+	const own = {
+		...childProps,
+		...forwardedProps
+	};
+	const isChildDisabled = shouldWrapDisabledChild && own.disabled === true;
+	const childRef = useMergedRefs(childProps.ref, forwardedRef);
+	const ref = useMergedRefs(isChildDisabled ? void 0 : anchorRef, childRef);
+	const [arrow, setArrow] = useState(null);
+	const getOrigins = useCallback((context) => getTooltipOrigins(resolveTooltipPlacement(placement, context), context.isRtl), [placement]);
+	const onPlaced = useCallback((placed) => {
+		if (!hasArrow) return;
+		const next = getArrow(placed);
+		setArrow((current) => isSameArrow(current, next) ? current : next);
+	}, [hasArrow]);
+	useAnchoredPlacement({
+		isOpen: isShown,
+		anchorRef: anchorPosition ? noAnchorRef : anchorRef,
+		anchorPosition,
+		surfaceRef,
+		getOrigins,
+		margin: MARGIN,
+		gap: GAP,
+		onPlaced
+	});
+	const handlers = Object.fromEntries(Object.entries(childHandlers).map(([name, handler]) => [name, (event) => {
+		own[name]?.(event);
+		handler(event);
+	}]));
+	const ownDescription = own["aria-describedby"];
+	const names = getChildName(title, own);
+	const descriptionId = `${id}-description`;
+	const hasPersistentDescription = children !== void 0 && shouldDescribeChild && isDescriptionPersistent && hasTitle;
+	const describedBy = (shown) => hasPersistentDescription ? [ownDescription, descriptionId].filter(Boolean).join(" ") : [ownDescription, shown ? id : void 0].filter(Boolean).join(" ") || void 0;
+	const ariaProps = shouldDescribeChild ? { "aria-describedby": describedBy(isShown) } : names;
+	const child = children ? cloneElement(children, {
+		...forwardedProps,
+		...isChildDisabled || isAtPoint ? {} : handlers,
+		...ariaProps,
+		ref
+	}) : null;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		isChildDisabled && !isAtPoint ? /* @__PURE__ */ jsx(TooltipTarget, {
+			ref: anchorRef,
+			...handlers,
+			children: child
+		}) : child,
+		hasPersistentDescription && /* @__PURE__ */ jsx(TooltipDescription, {
+			id: descriptionId,
+			children: title
+		}),
+		isShown && /* @__PURE__ */ jsx(Portal, { children: /* @__PURE__ */ jsxs(TooltipSurface, {
+			...slotProps?.root,
+			as: slots?.root,
+			ref: surfaceRef,
+			id,
+			role: "tooltip",
+			layer,
+			isInteractive,
+			borderRadius,
+			bg,
+			textColor,
+			className: [slotProps?.root?.className, className].filter(Boolean).join(" ") || void 0,
+			"data-testid": dataTestid ?? slotProps?.root?.["data-testid"],
+			...isAtPoint || !isInteractive ? {} : surfaceHandlers,
+			children: [title, hasArrow && arrow ? /* @__PURE__ */ jsx(TooltipArrow, {
+				...slotProps?.arrow,
+				as: slots?.arrow,
+				style: {
+					...slotProps?.arrow?.style,
+					...getArrowStyle(arrow)
+				},
+				"aria-hidden": "true"
+			}) : null]
+		}) })
+	] });
+}
+export { Tooltip as t };

package/dist/Tooltip.cjs

@@ -1,268 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-yC1f5WR2.cjs");
-const require_theme = require("./theme-XJvMdOnY.cjs");
-const require_themeDefault = require("./themeDefault-DbPHBbNO.cjs");
-const require_getSurfaceRadius = require("./getSurfaceRadius-DwOn3ALC.cjs");
-const require_useControlled = require("./useControlled-CzCxM4J3.cjs");
-const require_Portal = require("./Portal.cjs");
-const require_useAnchoredPlacement = require("./useAnchoredPlacement-ee6KzG3t.cjs");
-const require_useMergedRefs = require("./useMergedRefs-BtctsnmX.cjs");
-const require_getTooltipOrigins = require("./getTooltipOrigins-8b5zQafY.cjs");
-let react = require("react");
-let react_jsx_runtime = require("react/jsx-runtime");
-let _soroush_tech_styled_system_should_forward_prop = require("@soroush.tech/styled-system/should-forward-prop");
-// src/Tooltip/hooks/useTooltip.ts
-const isKeyboardFocus = (event) => {
-	try {
-		return event.target.matches(":focus-visible");
-	} catch {
-		return true;
-	}
-};
-/**
-* The state of a tooltip: whether it is open (its own, or its owner's), the timers that open and
-* close it, and the handlers its child and the tooltip itself take. Opening and closing are
-* delayed; moving from the child onto the tooltip does not close it, so its text can be read and
-* selected (WCAG 1.4.13); Escape closes it at once.
-*/
-function useTooltip({ isOpen: isOpenProp, defaultOpen, onOpen, onClose, enterDelay, leaveDelay, enterTouchDelay, leaveTouchDelay, shouldOpenOnHover, shouldOpenOnFocus, shouldOpenOnTouch }) {
-	const [isOpen, setIsOpen] = require_useControlled.useControlled({
-		controlled: isOpenProp,
-		default: defaultOpen
-	});
-	const timer = (0, react.useRef)(void 0);
-	const latest = (0, react.useRef)({
-		isOpen,
-		isOpenProp,
-		onOpen,
-		onClose
-	});
-	(0, react.useEffect)(() => {
-		latest.current = {
-			isOpen,
-			isOpenProp,
-			onOpen,
-			onClose
-		};
-	});
-	const clear = (0, react.useCallback)(() => window.clearTimeout(timer.current), []);
-	const ask = (0, react.useCallback)((next, event, delay) => {
-		clear();
-		timer.current = window.setTimeout(() => {
-			const current = latest.current;
-			if (current.isOpen === next) return;
-			if (current.isOpenProp === void 0) setIsOpen(next);
-			(next ? current.onOpen : current.onClose)?.(event);
-		}, delay);
-	}, [clear, setIsOpen]);
-	(0, react.useEffect)(() => clear, [clear]);
-	(0, react.useEffect)(() => {
-		if (!isOpen) return void 0;
-		const handleKeyDown = (event) => {
-			if (event.key === "Escape") ask(false, event, 0);
-		};
-		document.addEventListener("keydown", handleKeyDown);
-		return () => document.removeEventListener("keydown", handleKeyDown);
-	}, [isOpen, ask]);
-	return {
-		isOpen,
-		childHandlers: {
-			onMouseEnter: (event) => {
-				if (shouldOpenOnHover) ask(true, event, enterDelay);
-			},
-			onMouseLeave: (event) => {
-				if (shouldOpenOnHover) ask(false, event, leaveDelay);
-			},
-			onFocus: (event) => {
-				if (shouldOpenOnFocus && isKeyboardFocus(event)) ask(true, event, enterDelay);
-			},
-			onBlur: (event) => {
-				if (shouldOpenOnFocus) ask(false, event, leaveDelay);
-			},
-			onTouchStart: (event) => {
-				if (shouldOpenOnTouch) ask(true, event, enterTouchDelay);
-			},
-			onTouchEnd: (event) => {
-				if (shouldOpenOnTouch) ask(false, event, leaveTouchDelay);
-			},
-			onTouchCancel: (event) => {
-				if (shouldOpenOnTouch) ask(false, event, leaveTouchDelay);
-			}
-		},
-		surfaceHandlers: {
-			onMouseEnter: () => {
-				if (shouldOpenOnHover) clear();
-			},
-			onMouseLeave: (event) => {
-				if (shouldOpenOnHover) ask(false, event, leaveDelay);
-			}
-		}
-	};
-}
-// src/Tooltip/Tooltip.tsx
-const MARGIN = 8;
-const GAP = 8;
-const ARROW = 8;
-const TooltipSurface = require_src.styled("div", {
-	name: "Tooltip",
-	label: "Tooltip",
-	shouldForwardProp: (0, _soroush_tech_styled_system_should_forward_prop.createShouldForwardProp)([
-		"layer",
-		"borderRadius",
-		"bg",
-		"textColor"
-	])
-})(({ theme, layer, borderRadius, bg, textColor }) => ({
-	position: "fixed",
-	top: 0,
-	left: 0,
-	visibility: "hidden",
-	zIndex: theme.zOrder[layer],
-	boxSizing: "border-box",
-	maxWidth: "20rem",
-	padding: `${theme.space[.5]} ${theme.space[1]}`,
-	borderRadius: require_getSurfaceRadius.getSurfaceRadius(theme, borderRadius),
-	boxShadow: theme.shadows[4],
-	backgroundColor: (0, require_src.src_exports.get)(theme, `background.${bg ?? "modal"}`),
-	color: (0, require_src.src_exports.get)(theme, `text.${textColor ?? require_themeDefault.themeDefault(theme, "textColor", "initial")}`),
-	fontFamily: (0, require_src.src_exports.get)(theme, "fonts.body"),
-	fontSize: theme.fontSizes[0],
-	lineHeight: (0, require_src.src_exports.get)(theme, "lineHeights.base"),
-	overflowWrap: "break-word"
-}));
-const TooltipArrow = require_src.styled("span", {
-	name: "Tooltip",
-	slot: "arrow",
-	label: "TooltipArrow"
-})({
-	position: "absolute",
-	width: ARROW,
-	height: ARROW,
-	backgroundColor: "inherit",
-	transform: "rotate(45deg)",
-	pointerEvents: "none"
-});
-const getArrow = ({ anchorRect, surfaceSize, top, left }) => {
-	const { width, height } = surfaceSize;
-	if (top + height <= anchorRect.top + 1 || top >= anchorRect.bottom - 1) {
-		const side = top + height <= anchorRect.top + 1 ? "top" : "bottom";
-		const middle = anchorRect.left + anchorRect.width / 2 - left;
-		return {
-			side,
-			offset: Math.min(Math.max(middle, ARROW), width - ARROW)
-		};
-	}
-	const side = left + width <= anchorRect.left + 1 ? "left" : "right";
-	const middle = anchorRect.top + anchorRect.height / 2 - top;
-	return {
-		side,
-		offset: Math.min(Math.max(middle, ARROW), height - ARROW)
-	};
-};
-const isSameArrow = (a, b) => a !== null && a.side === b.side && a.offset === b.offset;
-const getArrowStyle = ({ side, offset }) => {
-	const half = ARROW / 2;
-	if (side === "top") return {
-		bottom: -4,
-		left: offset - half
-	};
-	if (side === "bottom") return {
-		top: -4,
-		left: offset - half
-	};
-	if (side === "left") return {
-		right: -4,
-		top: offset - half
-	};
-	return {
-		left: -4,
-		top: offset - half
-	};
-};
-/**
-* @description A short description of one child, shown on hover, keyboard focus and a long touch -
-* a `role="tooltip"` in a `Portal`, placed beside its child and flipped for want of room. The
-* child is named by it (`aria-label`) or described by it (`aria-describedby`, with
-* `shouldDescribeChild`). It opens and closes after their delays, stays open while the pointer is
-* on the tooltip itself, closes on Escape, and never takes or traps the focus.
-*/
-function Tooltip({ children, title, placement: placementProp, hasArrow: hasArrowProp, enterDelay: enterDelayProp, leaveDelay: leaveDelayProp, enterTouchDelay: enterTouchDelayProp, leaveTouchDelay: leaveTouchDelayProp, shouldDescribeChild: shouldDescribeChildProp, isOpen: isOpenProp, defaultOpen = false, onOpen, onClose, shouldOpenOnHover: shouldOpenOnHoverProp, shouldOpenOnFocus: shouldOpenOnFocusProp, shouldOpenOnTouch: shouldOpenOnTouchProp, slots, slotProps, layer: layerProp, borderRadius: borderRadiusProp, bg: bgProp, textColor: textColorProp, className, "data-testid": dataTestid }) {
-	const dp = require_theme.useDefaultProps("Tooltip");
-	const placement = placementProp ?? dp.placement ?? "top";
-	const hasArrow = hasArrowProp ?? dp.hasArrow ?? false;
-	const shouldDescribeChild = shouldDescribeChildProp ?? dp.shouldDescribeChild ?? false;
-	const layer = layerProp ?? dp.layer ?? "tooltip";
-	const borderRadius = borderRadiusProp ?? dp.borderRadius;
-	const bg = bgProp ?? dp.bg;
-	const textColor = textColorProp ?? dp.textColor;
-	const id = (0, react.useId)();
-	const { isOpen, childHandlers, surfaceHandlers } = useTooltip({
-		isOpen: isOpenProp,
-		defaultOpen,
-		onOpen,
-		onClose,
-		enterDelay: enterDelayProp ?? dp.enterDelay ?? 100,
-		leaveDelay: leaveDelayProp ?? dp.leaveDelay ?? 0,
-		enterTouchDelay: enterTouchDelayProp ?? dp.enterTouchDelay ?? 700,
-		leaveTouchDelay: leaveTouchDelayProp ?? dp.leaveTouchDelay ?? 1500,
-		shouldOpenOnHover: shouldOpenOnHoverProp ?? dp.shouldOpenOnHover ?? true,
-		shouldOpenOnFocus: shouldOpenOnFocusProp ?? dp.shouldOpenOnFocus ?? true,
-		shouldOpenOnTouch: shouldOpenOnTouchProp ?? dp.shouldOpenOnTouch ?? true
-	});
-	const isShown = isOpen && title !== void 0 && title !== null && title !== "";
-	const anchorRef = (0, react.useRef)(null);
-	const surfaceRef = (0, react.useRef)(null);
-	const own = children.props;
-	const ref = require_useMergedRefs.useMergedRefs(anchorRef, own.ref);
-	const [arrow, setArrow] = (0, react.useState)(null);
-	const getOrigins = (0, react.useCallback)((context) => require_getTooltipOrigins.getTooltipOrigins(require_getTooltipOrigins.resolveTooltipPlacement(placement, context), context.isRtl), [placement]);
-	const onPlaced = (0, react.useCallback)((placed) => {
-		if (!hasArrow) return;
-		const next = getArrow(placed);
-		setArrow((current) => isSameArrow(current, next) ? current : next);
-	}, [hasArrow]);
-	require_useAnchoredPlacement.useAnchoredPlacement({
-		isOpen: isShown,
-		anchorRef,
-		surfaceRef,
-		getOrigins,
-		margin: MARGIN,
-		gap: GAP,
-		onPlaced
-	});
-	const handlers = Object.fromEntries(Object.entries(childHandlers).map(([name, handler]) => [name, (event) => {
-		own[name]?.(event);
-		handler(event);
-	}]));
-	const ownDescription = own["aria-describedby"];
-	const names = typeof title === "string" && own["aria-label"] === void 0 && own["aria-labelledby"] === void 0 ? { "aria-label": title } : {};
-	const ariaProps = shouldDescribeChild ? { "aria-describedby": isShown ? [ownDescription, id].filter(Boolean).join(" ") : ownDescription } : names;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react.cloneElement)(children, {
-		...handlers,
-		...ariaProps,
-		ref
-	}), isShown && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Portal.Portal, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(TooltipSurface, {
-		...slotProps?.root,
-		as: slots?.root,
-		ref: surfaceRef,
-		id,
-		role: "tooltip",
-		layer,
-		borderRadius,
-		bg,
-		textColor,
-		className: [slotProps?.root?.className, className].filter(Boolean).join(" ") || void 0,
-		"data-testid": dataTestid ?? slotProps?.root?.["data-testid"],
-		...surfaceHandlers,
-		children: [title, hasArrow && arrow ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TooltipArrow, {
-			...slotProps?.arrow,
-			as: slots?.arrow,
-			style: {
-				...slotProps?.arrow?.style,
-				...getArrowStyle(arrow)
-			},
-			"aria-hidden": "true"
-		}) : null]
-	}) })] });
-}
-exports.Tooltip = Tooltip;
+const require_Tooltip = require("./Tooltip-CrPRvmj3.cjs");
+exports.Tooltip = require_Tooltip.Tooltip;

package/dist/Tooltip.d.cts

@@ -1,5 +1,6 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
-import { ElementType, HTMLAttributes, ReactElement, ReactNode, SyntheticEvent } from "react";
+import { nt as Theme } from "./index-C6a3kDn2.cjs";
+import { n as PopoverPosition } from "./computePopoverPosition-JgOwCM7k.cjs";
+import { ElementType, HTMLAttributes, ReactElement, ReactNode, Ref, SyntheticEvent } from "react";
 /** A side of its child a tooltip sits on - and, after the dash, which end of that side it lines up with. */
 type FixedTooltipPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
 /** A fixed placement, or `auto` - the side with the most room, chosen as it is placed. */
@@ -15,9 +16,25 @@ interface TooltipSlotProps {
   root?: SlotProps;
   arrow?: SlotProps;
 }
-interface TooltipProps {
-  /** The one element the tooltip is about - it holds a `ref` and takes the handlers. */
-  children: ReactElement;
+/**
+ * What a parent that clones its child (a `Menu` with a `Tooltip` for a trigger) hands the tooltip
+ * instead: it is not the tooltip's, so it goes on to the child. The tooltip's own props are left out.
+ */
+type TooltipForwardedProps = Omit<HTMLAttributes<HTMLElement>, 'title' | 'children' | 'className' | 'color'> & {
+  ref?: Ref<HTMLElement>;
+};
+interface TooltipProps extends TooltipForwardedProps {
+  /**
+   * The one element the tooltip is about - it holds a `ref` and takes the handlers. Without it, the
+   * tooltip is at `anchorPosition`, and open when `isOpen` says so.
+   */
+  children?: ReactElement;
+  /**
+   * A point in the window - client coordinates, as Popover's - to place the tooltip at instead of
+   * beside the child: a hint that depends on where the pointer is. It follows the point and the
+   * `title` as they change.
+   */
+  anchorPosition?: PopoverPosition;
   /** What the tooltip says. Nothing says no tooltip. */
   title?: ReactNode;
   /** The side of the child it sits on, and the end it lines up with; `auto` takes the side with the most room. Flips for want of room. Default: `'top'`. */
@@ -38,6 +55,12 @@ interface TooltipProps {
   leaveTouchDelay?: number;
   /** Describes the child (`aria-describedby`, while open) instead of naming it (`aria-label`). Default: `false`. */
   shouldDescribeChild?: boolean;
+  /**
+   * With `shouldDescribeChild`: the child is described the whole time, as by a native `title`, not
+   * only while the tooltip is open. A visually hidden copy of a `title` sits beside the child for it
+   * to point at. Default: `false`.
+   */
+  isDescriptionPersistent?: boolean;
   /** Whether it is shown. Controlled with `onOpen` and `onClose`. */
   isOpen?: boolean;
   /** Whether it is shown at first, when uncontrolled. Default: `false`. */
@@ -46,6 +69,18 @@ interface TooltipProps {
   onOpen?: (event: Event | SyntheticEvent) => void;
   /** Fired when it asks to close. */
   onClose?: (event: Event | SyntheticEvent) => void;
+  /**
+   * Whether a disabled child (`disabled`) is wrapped in an element of its own, which takes the pointer
+   * handlers and the placement, since a disabled control sends no pointer events. Left out for a child
+   * that is only marked disabled and still takes them - a menu row. Default: `true`.
+   */
+  shouldWrapDisabledChild?: boolean;
+  /**
+   * Whether the pointer can be moved onto the tooltip, which then stays open (WCAG 1.4.13). With
+   * `false` it takes no pointer events - a click goes to what is under it - and closes as the
+   * pointer leaves the child: for a text hint that holds nothing to use. Default: `true`.
+   */
+  isInteractive?: boolean;
   /** Opens on hover. Default: `true`. */
   shouldOpenOnHover?: boolean;
   /** Opens on keyboard focus. Default: `true`. */
@@ -70,5 +105,5 @@ interface TooltipProps {
  * `shouldDescribeChild`). It opens and closes after their delays, stays open while the pointer is
  * on the tooltip itself, closes on Escape, and never takes or traps the focus.
  */
-declare function Tooltip({ children, title, placement: placementProp, hasArrow: hasArrowProp, enterDelay: enterDelayProp, leaveDelay: leaveDelayProp, enterTouchDelay: enterTouchDelayProp, leaveTouchDelay: leaveTouchDelayProp, shouldDescribeChild: shouldDescribeChildProp, isOpen: isOpenProp, defaultOpen, onOpen, onClose, shouldOpenOnHover: shouldOpenOnHoverProp, shouldOpenOnFocus: shouldOpenOnFocusProp, shouldOpenOnTouch: shouldOpenOnTouchProp, slots, slotProps, layer: layerProp, borderRadius: borderRadiusProp, bg: bgProp, textColor: textColorProp, className, 'data-testid': dataTestid }: Readonly<TooltipProps>): import("react").JSX.Element;
-export { Tooltip, type TooltipPlacement, TooltipProps, TooltipSlotProps, TooltipSlots };
+declare function Tooltip({ children, anchorPosition, title, placement: placementProp, hasArrow: hasArrowProp, enterDelay: enterDelayProp, leaveDelay: leaveDelayProp, enterTouchDelay: enterTouchDelayProp, leaveTouchDelay: leaveTouchDelayProp, shouldDescribeChild: shouldDescribeChildProp, isDescriptionPersistent: isDescriptionPersistentProp, isOpen: isOpenProp, defaultOpen, onOpen, onClose, isInteractive: isInteractiveProp, shouldWrapDisabledChild: shouldWrapDisabledChildProp, shouldOpenOnHover: shouldOpenOnHoverProp, shouldOpenOnFocus: shouldOpenOnFocusProp, shouldOpenOnTouch: shouldOpenOnTouchProp, slots, slotProps, layer: layerProp, borderRadius: borderRadiusProp, bg: bgProp, textColor: textColorProp, className, 'data-testid': dataTestid, ref: forwardedRef, ...forwarded }: Readonly<TooltipProps>): import("react").JSX.Element;
+export { Tooltip, TooltipForwardedProps, type TooltipPlacement, TooltipProps, TooltipSlotProps, TooltipSlots };