@soroush.tech/design-system 2.0.0-rc.2 → 2.0.0-rc.4

package/dist/TextInput.mjs

@@ -1,8 +1,8 @@
 import { a as src_exports, i as props, o as styled, t as createShouldForwardProp } from "./src-DLGYOJMh.mjs";
+import { r as useTheme } from "./theme-oBfFhJm9.mjs";
 import { t as themeDefault } from "./themeDefault-Z3KmyIbm.mjs";
-import { r as useTheme } from "./theme-Z9_QludW.mjs";
+import { n as getFocusRing, r as getInputMinWidth, t as inputVariantStyles } from "./inputVariantStyles-q_cZsCJg.mjs";
 import { useFormControl } from "./FormControl.mjs";
-import { t as inputVariantStyles } from "./inputVariantStyles-CcqpGfuP.mjs";
 import { forwardRef, useCallback, useLayoutEffect, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/TextInput/TextAreaAutoResize.tsx
@@ -63,10 +63,10 @@ const baseStyle = {
 	alignItems: "center",
 	transition: "border-color 0.15s ease"
 };
-const backgroundStyle = ({ theme, textColor = themeDefault(theme, "accentTextColor", "primary") }) => {
+const backgroundStyle = ({ theme, textColor, color = themeDefault(theme, "color", "primary") }) => {
 	return {
 		backgroundColor: (0, src_exports.get)(theme, `background.${themeDefault(theme, "inputBg", "terminal")}`),
-		color: (0, src_exports.get)(theme, `text.${textColor}`),
+		color: textColor ? (0, src_exports.get)(theme, `text.${textColor}`) : (0, src_exports.get)(theme, `palette.${color}.main`),
 		fontFamily: (0, src_exports.get)(theme, "fonts.body"),
 		fontSize: (0, src_exports.get)(theme, "fontSizes.1"),
 		lineHeight: (0, src_exports.get)(theme, "lineHeights.base")
@@ -75,18 +75,14 @@ const backgroundStyle = ({ theme, textColor = themeDefault(theme, "accentTextCol
 const colorBorder = ({ theme, color = themeDefault(theme, "color", "primary"), error }) => {
 	return { borderColor: error ? (0, src_exports.get)(theme, "palette.error.main") : (0, src_exports.get)(theme, `palette.${color}.light`) };
 };
-const focusVisibleRing = ({ theme }) => {
-	return { "&:has(:focus-visible)": {
-		outline: `2px solid ${(0, src_exports.get)(theme, `palette.${themeDefault(theme, "color", "primary")}.main`)}`,
-		outlineOffset: "2px"
-	} };
-};
+const focusVisibleRing = ({ theme, color = themeDefault(theme, "color", "primary"), error }) => ({ "&:has(:focus-visible)": getFocusRing(theme, color, error) });
 const focusWithinColor = ({ theme, color = themeDefault(theme, "color", "primary"), error }) => ({ "&:focus-within": { borderColor: error ? (0, src_exports.get)(theme, "palette.error.main") : (0, src_exports.get)(theme, `palette.${color}.main`) } });
 const borderRadiusStyle = ({ variant: v = "default", borderRadius, theme }) => {
 	if (v === "underline" || v === "text" || !borderRadius) return {};
 	return { borderRadius: (0, src_exports.get)(theme, `radii.${borderRadius}`) };
 };
-const layoutStyles = ({ fullWidth, disabled }) => ({
+const layoutStyles = ({ theme, fullWidth, disabled }) => ({
+	minWidth: getInputMinWidth(theme),
 	...fullWidth ? {
 		display: "flex",
 		width: "100%"
@@ -176,7 +172,7 @@ function TextInput({ autoComplete, autoFocus, borderRadius, classes, components,
 	const { id, error, disabled, required, size, fullWidth } = fc;
 	const theme = useTheme();
 	const color = fc.color ?? themeDefault(theme, "color", "primary");
-	const textColor = fc.textColor ?? themeDefault(theme, "accentTextColor", "primary");
+	const textColor = fc.textColor;
 	const variant = variantProp ?? themeDefault(theme, "inputVariant", "default");
 	const isAutoResize = resize;
 	const isMultiline = multiline || rows !== void 0 && Number(rows) > 1;
@@ -203,14 +199,18 @@ function TextInput({ autoComplete, autoFocus, borderRadius, classes, components,
 	};
 	let inputElement = /* @__PURE__ */ jsx(StyledInput, {
 		inputComponent: resolvedInputComponent,
-		inputSize,
+		inputSize: inputSize ?? (resolvedInputComponent ? void 0 : 1),
 		...inputElProps
 	});
 	if (isTextarea) inputElement = isAutoResize ? /* @__PURE__ */ jsx(StyledAutoResizeTextarea, {
 		...inputElProps,
+		cols: 1,
 		minRows: minRows ?? rows,
 		maxRows
-	}) : /* @__PURE__ */ jsx(StyledTextarea, { ...inputElProps });
+	}) : /* @__PURE__ */ jsx(StyledTextarea, {
+		...inputElProps,
+		cols: 1
+	});
 	return /* @__PURE__ */ jsx(TextInputRoot, {
 		as: components?.Root,
 		color,

package/dist/ToggleButton/ToggleButton.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_src = require("../src-DU81aGy9.cjs");
-const require_themeDefault = require("../themeDefault-Cebi08Cv.cjs");
 const require_utils = require("../utils.cjs");
-const require_theme = require("../theme-BxXuXRgQ.cjs");
+const require_theme = require("../theme-DzfwuzMZ.cjs");
+const require_themeDefault = require("../themeDefault-Cebi08Cv.cjs");
 const require_ButtonGroupContext = require("../ButtonGroupContext-NtkVeDVE.cjs");
 const require_Button = require("../Button.cjs");
 const require_ToggleButtonGroupContext = require("../ToggleButtonGroupContext-Ewc5Ixas.cjs");

package/dist/ToggleButton/ToggleButton.d.cts

@@ -1,4 +1,4 @@
-import { i as ButtonProps } from "../index-XxydXX8l.cjs";
+import { i as ButtonProps } from "../index-BQge4W7L.cjs";
 import { r as ToggleButtonValue } from "../ToggleButtonGroupContext-10jEsQdg.cjs";
 //#region src/ToggleButton/ToggleButton/ToggleButton.d.ts
 interface ToggleButtonProps extends Omit<ButtonProps, 'variant' | 'href' | 'target' | 'rel' | 'value' | 'onChange'> {

package/dist/ToggleButton/ToggleButton.d.mts

@@ -1,4 +1,4 @@
-import { i as ButtonProps } from "../index-Bxd9NOWb.mjs";
+import { i as ButtonProps } from "../index-DK3zgGPe.mjs";
 import { r as ToggleButtonValue } from "../ToggleButtonGroupContext-10jEsQdg.mjs";
 //#region src/ToggleButton/ToggleButton/ToggleButton.d.ts
 interface ToggleButtonProps extends Omit<ButtonProps, 'variant' | 'href' | 'target' | 'rel' | 'value' | 'onChange'> {

package/dist/ToggleButton/ToggleButton.mjs

@@ -1,7 +1,7 @@
 import { a as src_exports, o as styled } from "../src-DLGYOJMh.mjs";
-import { t as themeDefault } from "../themeDefault-Z3KmyIbm.mjs";
 import { alpha } from "../utils.mjs";
-import { r as useTheme } from "../theme-Z9_QludW.mjs";
+import { r as useTheme } from "../theme-oBfFhJm9.mjs";
+import { t as themeDefault } from "../themeDefault-Z3KmyIbm.mjs";
 import { t as ButtonGroupContext } from "../ButtonGroupContext-DS-kl9lG.mjs";
 import { Button } from "../Button.mjs";
 import { t as ToggleButtonGroupContext } from "../ToggleButtonGroupContext-DxIyy8ze.mjs";

package/dist/ToggleButton/ToggleButtonGroup.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_src = require("../src-DU81aGy9.cjs");
+const require_theme = require("../theme-DzfwuzMZ.cjs");
 const require_themeDefault = require("../themeDefault-Cebi08Cv.cjs");
-const require_theme = require("../theme-BxXuXRgQ.cjs");
 const require_ButtonGroup = require("../ButtonGroup.cjs");
 const require_ToggleButtonGroupContext = require("../ToggleButtonGroupContext-Ewc5Ixas.cjs");
 let react = require("react");

package/dist/ToggleButton/ToggleButtonGroup.d.cts

@@ -1,4 +1,4 @@
-import { a as ButtonGroupProps } from "../index-BjfPEP_5.cjs";
+import { a as ButtonGroupProps } from "../index-Dk4KuTPB.cjs";
 import { r as ToggleButtonValue } from "../ToggleButtonGroupContext-10jEsQdg.cjs";
 //#region src/ToggleButton/ToggleButtonGroup/ToggleButtonGroup.d.ts
 interface ToggleButtonGroupProps extends Omit<ButtonGroupProps, 'variant' | 'onChange'> {

package/dist/ToggleButton/ToggleButtonGroup.d.mts

@@ -1,4 +1,4 @@
-import { a as ButtonGroupProps } from "../index-B8DNxyEw.mjs";
+import { a as ButtonGroupProps } from "../index-MWUGpG-Y.mjs";
 import { r as ToggleButtonValue } from "../ToggleButtonGroupContext-10jEsQdg.mjs";
 //#region src/ToggleButton/ToggleButtonGroup/ToggleButtonGroup.d.ts
 interface ToggleButtonGroupProps extends Omit<ButtonGroupProps, 'variant' | 'onChange'> {

package/dist/ToggleButton/ToggleButtonGroup.mjs

@@ -1,6 +1,6 @@
 import { o as styled } from "../src-DLGYOJMh.mjs";
+import { r as useTheme } from "../theme-oBfFhJm9.mjs";
 import { t as themeDefault } from "../themeDefault-Z3KmyIbm.mjs";
-import { r as useTheme } from "../theme-Z9_QludW.mjs";
 import { ButtonGroup } from "../ButtonGroup.mjs";
 import { t as ToggleButtonGroupContext } from "../ToggleButtonGroupContext-DxIyy8ze.mjs";
 import { useMemo } from "react";

package/dist/Tooltip.cjs

@@ -0,0 +1,270 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_src = require("./src-DU81aGy9.cjs");
+const require_theme = require("./theme-DzfwuzMZ.cjs");
+const require_themeDefault = require("./themeDefault-Cebi08Cv.cjs");
+const require_getSurfaceRadius = require("./getSurfaceRadius-BTUV1E8H.cjs");
+const require_useControlled = require("./useControlled-C666KpQ0.cjs");
+const require_Portal = require("./Portal.cjs");
+const require_useAnchoredPlacement = require("./useAnchoredPlacement-B1FyGoZV.cjs");
+const require_useMergedRefs = require("./useMergedRefs-2zTDXgPO.cjs");
+const require_getTooltipOrigins = require("./getTooltipOrigins-B_7XXtQq.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");
+//#region 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);
+			}
+		}
+	};
+}
+//#endregion
+//#region 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]
+	}) })] });
+}
+//#endregion
+exports.Tooltip = Tooltip;

package/dist/Tooltip.d.cts

@@ -0,0 +1,78 @@
+import { nt as Theme } from "./index-XN4-ZqTB.cjs";
+import { ElementType, HTMLAttributes, ReactElement, ReactNode, SyntheticEvent } from "react";
+//#region src/Tooltip/utils/getTooltipOrigins.d.ts
+/** 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. */
+type TooltipPlacement = FixedTooltipPlacement | 'auto' | 'auto-start' | 'auto-end';
+//#endregion
+//#region src/Tooltip/Tooltip.d.ts
+interface TooltipSlots {
+  root?: ElementType;
+  arrow?: ElementType;
+}
+type SlotProps = HTMLAttributes<HTMLElement> & {
+  'data-testid'?: string;
+};
+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 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'`. */
+  placement?: TooltipPlacement;
+  /** Swaps the element a part is drawn as - it keeps its styles. `root` is the surface. */
+  slots?: TooltipSlots;
+  /** Props for a part: they are put first, so the tooltip's own `ref`, `id`, `role`, pointer handlers and the arrow's position win. */
+  slotProps?: TooltipSlotProps;
+  /** Draws an arrow towards the child. Default: `false`. */
+  hasArrow?: boolean;
+  /** How long the pointer or focus rests on the child before it opens, in milliseconds. Default: `100`. */
+  enterDelay?: number;
+  /** How long after they leave before it closes. Default: `0`. */
+  leaveDelay?: number;
+  /** How long a touch is held before it opens. Default: `700`. */
+  enterTouchDelay?: number;
+  /** How long after a touch ends before it closes. Default: `1500`. */
+  leaveTouchDelay?: number;
+  /** Describes the child (`aria-describedby`, while open) instead of naming it (`aria-label`). Default: `false`. */
+  shouldDescribeChild?: boolean;
+  /** Whether it is shown. Controlled with `onOpen` and `onClose`. */
+  isOpen?: boolean;
+  /** Whether it is shown at first, when uncontrolled. Default: `false`. */
+  defaultOpen?: boolean;
+  /** Fired when it asks to open. */
+  onOpen?: (event: Event | SyntheticEvent) => void;
+  /** Fired when it asks to close. */
+  onClose?: (event: Event | SyntheticEvent) => void;
+  /** Opens on hover. Default: `true`. */
+  shouldOpenOnHover?: boolean;
+  /** Opens on keyboard focus. Default: `true`. */
+  shouldOpenOnFocus?: boolean;
+  /** Opens on a long touch. Default: `true`. */
+  shouldOpenOnTouch?: boolean;
+  /** Corner radius, resolves against `theme.radii`. Default: `theme.defaults.surfaceRadius`, else square. */
+  borderRadius?: keyof Theme['radii'];
+  /** Background, resolves against `theme.background`. Default: `'modal'`. */
+  bg?: keyof Theme['background'];
+  /** Text color, resolves against `theme.text`. Default: `theme.defaults.textColor`, else `'initial'`. */
+  textColor?: keyof Theme['text'];
+  /** Stacking layer from `theme.zOrder`. Default: `'tooltip'`. */
+  layer?: keyof Theme['zOrder'];
+  className?: string;
+  'data-testid'?: string;
+}
+/**
+ * @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.
+ */
+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;
+//#endregion
+export { Tooltip, type TooltipPlacement, TooltipProps, TooltipSlotProps, TooltipSlots };

package/dist/Tooltip.d.mts

@@ -0,0 +1,78 @@
+import { nt as Theme } from "./index-CRQ7XLri.mjs";
+import { ElementType, HTMLAttributes, ReactElement, ReactNode, SyntheticEvent } from "react";
+//#region src/Tooltip/utils/getTooltipOrigins.d.ts
+/** 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. */
+type TooltipPlacement = FixedTooltipPlacement | 'auto' | 'auto-start' | 'auto-end';
+//#endregion
+//#region src/Tooltip/Tooltip.d.ts
+interface TooltipSlots {
+  root?: ElementType;
+  arrow?: ElementType;
+}
+type SlotProps = HTMLAttributes<HTMLElement> & {
+  'data-testid'?: string;
+};
+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 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'`. */
+  placement?: TooltipPlacement;
+  /** Swaps the element a part is drawn as - it keeps its styles. `root` is the surface. */
+  slots?: TooltipSlots;
+  /** Props for a part: they are put first, so the tooltip's own `ref`, `id`, `role`, pointer handlers and the arrow's position win. */
+  slotProps?: TooltipSlotProps;
+  /** Draws an arrow towards the child. Default: `false`. */
+  hasArrow?: boolean;
+  /** How long the pointer or focus rests on the child before it opens, in milliseconds. Default: `100`. */
+  enterDelay?: number;
+  /** How long after they leave before it closes. Default: `0`. */
+  leaveDelay?: number;
+  /** How long a touch is held before it opens. Default: `700`. */
+  enterTouchDelay?: number;
+  /** How long after a touch ends before it closes. Default: `1500`. */
+  leaveTouchDelay?: number;
+  /** Describes the child (`aria-describedby`, while open) instead of naming it (`aria-label`). Default: `false`. */
+  shouldDescribeChild?: boolean;
+  /** Whether it is shown. Controlled with `onOpen` and `onClose`. */
+  isOpen?: boolean;
+  /** Whether it is shown at first, when uncontrolled. Default: `false`. */
+  defaultOpen?: boolean;
+  /** Fired when it asks to open. */
+  onOpen?: (event: Event | SyntheticEvent) => void;
+  /** Fired when it asks to close. */
+  onClose?: (event: Event | SyntheticEvent) => void;
+  /** Opens on hover. Default: `true`. */
+  shouldOpenOnHover?: boolean;
+  /** Opens on keyboard focus. Default: `true`. */
+  shouldOpenOnFocus?: boolean;
+  /** Opens on a long touch. Default: `true`. */
+  shouldOpenOnTouch?: boolean;
+  /** Corner radius, resolves against `theme.radii`. Default: `theme.defaults.surfaceRadius`, else square. */
+  borderRadius?: keyof Theme['radii'];
+  /** Background, resolves against `theme.background`. Default: `'modal'`. */
+  bg?: keyof Theme['background'];
+  /** Text color, resolves against `theme.text`. Default: `theme.defaults.textColor`, else `'initial'`. */
+  textColor?: keyof Theme['text'];
+  /** Stacking layer from `theme.zOrder`. Default: `'tooltip'`. */
+  layer?: keyof Theme['zOrder'];
+  className?: string;
+  'data-testid'?: string;
+}
+/**
+ * @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.
+ */
+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;
+//#endregion
+export { Tooltip, type TooltipPlacement, TooltipProps, TooltipSlotProps, TooltipSlots };