@soroush.tech/design-system 2.1.0-alpha.0 → 2.1.0-alpha.2

package/dist/Tooltip.cjs

@@ -1,312 +1,4 @@
 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-BSfjNMut.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, isAtPoint = false, 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,
-		isAtPoint,
-		onOpen,
-		onClose
-	});
-	(0, react.useEffect)(() => {
-		latest.current = {
-			isOpen,
-			isOpenProp,
-			isAtPoint,
-			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 (next && current.isAtPoint) 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);
-			},
-			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 = require_src.styled("div", {
-	name: "Tooltip",
-	label: "Tooltip",
-	shouldForwardProp: (0, _soroush_tech_styled_system_should_forward_prop.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: 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 TooltipDescription = require_src.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 = require_src.styled("span", { label: "TooltipTarget" })({ display: "inline-grid" });
-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, 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, 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 isDescriptionPersistent = isDescriptionPersistentProp ?? dp.isDescriptionPersistent ?? false;
-	const isInteractive = isInteractiveProp ?? dp.isInteractive ?? true;
-	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 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 = (0, react.useRef)(null);
-	const noAnchorRef = (0, react.useRef)(null);
-	const surfaceRef = (0, react.useRef)(null);
-	const own = children?.props ?? {};
-	const isChildDisabled = own.disabled === true;
-	const ref = require_useMergedRefs.useMergedRefs(isChildDisabled ? void 0 : 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: 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 = typeof title === "string" && own["aria-label"] === void 0 && own["aria-labelledby"] === void 0 ? { "aria-label": title } : {};
-	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 ? (0, react.cloneElement)(children, {
-		...isChildDisabled || isAtPoint ? {} : handlers,
-		...ariaProps,
-		ref
-	}) : null;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
-		isChildDisabled && !isAtPoint ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TooltipTarget, {
-			ref: anchorRef,
-			...handlers,
-			children: child
-		}) : child,
-		hasPersistentDescription && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TooltipDescription, {
-			id: descriptionId,
-			children: title
-		}),
-		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,
-			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__ */ (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-rkGm1HnP.cjs");
+exports.Tooltip = require_Tooltip.Tooltip;
+exports.TooltipGroup = require_Tooltip.TooltipGroup;

package/dist/Tooltip.d.cts

@@ -1,6 +1,6 @@
-import { nt as Theme } from "./index-DvVQLBZc.cjs";
+import { nt as Theme } from "./index-CK-uaK5U.cjs";
 import { n as PopoverPosition } from "./computePopoverPosition-JgOwCM7k.cjs";
-import { ElementType, HTMLAttributes, ReactElement, ReactNode, SyntheticEvent } from "react";
+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. */
@@ -16,7 +16,14 @@ interface TooltipSlotProps {
   root?: SlotProps;
   arrow?: SlotProps;
 }
-interface TooltipProps {
+/**
+ * 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.
@@ -62,6 +69,12 @@ 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
@@ -92,5 +105,23 @@ 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, 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, 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;
+interface TooltipGroupProps {
+  children?: ReactNode;
+  /**
+   * How long after a tooltip of the group closes the next one opens with no enter delay, in
+   * milliseconds - and for as long as one is open. After it, the tooltip's own `enterDelay`
+   * applies again. A tooltip that opens closes the one still showing, at once. It wins over
+   * `skipDelayDuration` in `theme.components.Tooltip.defaultProps`.
+   */
+  skipDelayDuration?: number;
+}
+/**
+ * Lets the tooltips inside it open at once, with no enter delay, when the pointer or the focus
+ * moves to the next one just after another closed - a toolbar or a rail read from one icon to the
+ * next. It renders nothing of its own. Tooltips outside a group are unchanged, a touch keeps its
+ * own delay, and a tooltip whose `isOpen` the app controls is left alone: the group neither opens
+ * nor closes it, and it does not start the window.
+ */
+declare function TooltipGroup({ children, skipDelayDuration }: Readonly<TooltipGroupProps>): import("react").JSX.Element;
+export { Tooltip, TooltipForwardedProps, TooltipGroup, TooltipGroupProps, type TooltipPlacement, TooltipProps, TooltipSlotProps, TooltipSlots };

package/dist/Tooltip.d.mts

@@ -1,6 +1,6 @@
-import { nt as Theme } from "./index-BWiDilH8.mjs";
+import { nt as Theme } from "./index-B-1sp9oV.mjs";
 import { n as PopoverPosition } from "./computePopoverPosition-JgOwCM7k.mjs";
-import { ElementType, HTMLAttributes, ReactElement, ReactNode, SyntheticEvent } from "react";
+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. */
@@ -16,7 +16,14 @@ interface TooltipSlotProps {
   root?: SlotProps;
   arrow?: SlotProps;
 }
-interface TooltipProps {
+/**
+ * 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.
@@ -62,6 +69,12 @@ 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
@@ -92,5 +105,23 @@ 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, 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, 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;
+interface TooltipGroupProps {
+  children?: ReactNode;
+  /**
+   * How long after a tooltip of the group closes the next one opens with no enter delay, in
+   * milliseconds - and for as long as one is open. After it, the tooltip's own `enterDelay`
+   * applies again. A tooltip that opens closes the one still showing, at once. It wins over
+   * `skipDelayDuration` in `theme.components.Tooltip.defaultProps`.
+   */
+  skipDelayDuration?: number;
+}
+/**
+ * Lets the tooltips inside it open at once, with no enter delay, when the pointer or the focus
+ * moves to the next one just after another closed - a toolbar or a rail read from one icon to the
+ * next. It renders nothing of its own. Tooltips outside a group are unchanged, a touch keeps its
+ * own delay, and a tooltip whose `isOpen` the app controls is left alone: the group neither opens
+ * nor closes it, and it does not start the window.
+ */
+declare function TooltipGroup({ children, skipDelayDuration }: Readonly<TooltipGroupProps>): import("react").JSX.Element;
+export { Tooltip, TooltipForwardedProps, TooltipGroup, TooltipGroupProps, type TooltipPlacement, TooltipProps, TooltipSlotProps, TooltipSlots };