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

package/dist/Tooltip.d.mts

@@ -1,5 +1,6 @@
-import { nt as Theme } from "./index-CR8qkP8U.mjs";
-import { ElementType, HTMLAttributes, ReactElement, ReactNode, SyntheticEvent } from "react";
+import { nt as Theme } from "./index-DOH6uskj.mjs";
+import { n as PopoverPosition } from "./computePopoverPosition-JgOwCM7k.mjs";
+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 };

package/dist/Tooltip.mjs

@@ -1,266 +1 @@
-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-COrXZxhm.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, 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,
-		onOpen,
-		onClose
-	});
-	useEffect(() => {
-		latest.current = {
-			isOpen,
-			isOpenProp,
-			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 (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);
-			}
-		},
-		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",
-		"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: 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 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
-	};
-};
-/**
-* @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 = 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 = 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 = useRef(null);
-	const surfaceRef = useRef(null);
-	const own = children.props;
-	const ref = useMergedRefs(anchorRef, own.ref);
-	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,
-		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__ */ jsxs(Fragment$1, { children: [cloneElement(children, {
-		...handlers,
-		...ariaProps,
-		ref
-	}), isShown && /* @__PURE__ */ jsx(Portal, { children: /* @__PURE__ */ 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__ */ jsx(TooltipArrow, {
-			...slotProps?.arrow,
-			as: slots?.arrow,
-			style: {
-				...slotProps?.arrow?.style,
-				...getArrowStyle(arrow)
-			},
-			"aria-hidden": "true"
-		}) : null]
-	}) })] });
-}
-export { Tooltip };
+export { t as Tooltip } from "./Tooltip-CwbuEQzf.mjs";

package/dist/TransferList.d.cts

@@ -1,4 +1,4 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
+import { nt as Theme } from "./index-C6a3kDn2.cjs";
 import { SpaceProps } from "@soroush.tech/styled-system";
 type TransferListValue = string | number;
 interface TransferListItem {

package/dist/TransferList.d.mts

@@ -1,4 +1,4 @@
-import { nt as Theme } from "./index-CR8qkP8U.mjs";
+import { nt as Theme } from "./index-DOH6uskj.mjs";
 import { SpaceProps } from "@soroush.tech/styled-system";
 type TransferListValue = string | number;
 interface TransferListItem {

package/dist/Typography.d.cts

@@ -1,3 +1,3 @@
-import { jt as TypographyVariant } from "./index-Lsm4v8fB.cjs";
-import { a as TypographyProps, i as TypographyAlign, n as TextColorToken, r as Typography, t as BackgroundToken } from "./index-CGyIuCRh.cjs";
+import { jt as TypographyVariant } from "./index-C6a3kDn2.cjs";
+import { a as TypographyProps, i as TypographyAlign, n as TextColorToken, r as Typography, t as BackgroundToken } from "./index-DMysZsti.cjs";
 export { BackgroundToken, TextColorToken, Typography, TypographyAlign, TypographyProps, type TypographyVariant };

package/dist/Typography.d.mts

@@ -1,3 +1,3 @@
-import { jt as TypographyVariant } from "./index-CR8qkP8U.mjs";
-import { a as TypographyProps, i as TypographyAlign, n as TextColorToken, r as Typography, t as BackgroundToken } from "./index-C2a-5yop.mjs";
+import { jt as TypographyVariant } from "./index-DOH6uskj.mjs";
+import { a as TypographyProps, i as TypographyAlign, n as TextColorToken, r as Typography, t as BackgroundToken } from "./index-COgZvhXQ.mjs";
 export { BackgroundToken, TextColorToken, Typography, TypographyAlign, TypographyProps, type TypographyVariant };

package/dist/View.d.cts

@@ -1,2 +1,2 @@
-import { _n as ViewBorderWidthToken, gn as ViewBorderRadiusToken, hn as ViewBorderColorToken, mn as ViewBackgroundToken, pn as View, vn as ViewColorToken, yn as ViewProps } from "./index-Lsm4v8fB.cjs";
+import { _n as ViewBorderWidthToken, gn as ViewBorderRadiusToken, hn as ViewBorderColorToken, mn as ViewBackgroundToken, pn as View, vn as ViewColorToken, yn as ViewProps } from "./index-C6a3kDn2.cjs";
 export { View, ViewBackgroundToken, ViewBorderColorToken, ViewBorderRadiusToken, ViewBorderWidthToken, ViewColorToken, ViewProps };

package/dist/View.d.mts

@@ -1,2 +1,2 @@
-import { _n as ViewBorderWidthToken, gn as ViewBorderRadiusToken, hn as ViewBorderColorToken, mn as ViewBackgroundToken, pn as View, vn as ViewColorToken, yn as ViewProps } from "./index-CR8qkP8U.mjs";
+import { _n as ViewBorderWidthToken, gn as ViewBorderRadiusToken, hn as ViewBorderColorToken, mn as ViewBackgroundToken, pn as View, vn as ViewColorToken, yn as ViewProps } from "./index-DOH6uskj.mjs";
 export { View, ViewBackgroundToken, ViewBorderColorToken, ViewBorderRadiusToken, ViewBorderWidthToken, ViewColorToken, ViewProps };

package/dist/Zoom.d.cts

@@ -1,4 +1,4 @@
-import { n as TransitionProps } from "./useTransition-C89K0mS7.cjs";
+import { n as TransitionProps } from "./useTransition-BJ375Sto.cjs";
 type ZoomProps = TransitionProps;
 /**
  * @description Zooms one child in from nothing and out to nothing. The child holds a `ref` and

package/dist/Zoom.d.mts

@@ -1,4 +1,4 @@
-import { n as TransitionProps } from "./useTransition-3EoagwIe.mjs";
+import { n as TransitionProps } from "./useTransition-DDGpvgci.mjs";
 type ZoomProps = TransitionProps;
 /**
  * @description Zooms one child in from nothing and out to nothing. The child holds a `ref` and

package/dist/catalog.cjs

@@ -618,6 +618,18 @@ const tooltipCatalog = defineCatalogEntry()({
 			values: [true, false],
 			default: false
 		},
+		isInteractive: {
+			values: [true, false],
+			default: true
+		},
+		shouldWrapDisabledChild: {
+			values: [true, false],
+			default: true
+		},
+		isDescriptionPersistent: {
+			values: [true, false],
+			default: false
+		},
 		shouldOpenOnHover: {
 			values: [true, false],
 			default: true

package/dist/catalog.d.cts

@@ -1,4 +1,4 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
+import { nt as Theme } from "./index-C6a3kDn2.cjs";
 /** A value that survives `JSON.stringify` - all a catalog holds. */
 type JsonValue = string | number | boolean | null | JsonValue[] | {
   [key: string]: JsonValue;

package/dist/catalog.d.mts

@@ -1,4 +1,4 @@
-import { nt as Theme } from "./index-CR8qkP8U.mjs";
+import { nt as Theme } from "./index-DOH6uskj.mjs";
 /** A value that survives `JSON.stringify` - all a catalog holds. */
 type JsonValue = string | number | boolean | null | JsonValue[] | {
   [key: string]: JsonValue;

package/dist/catalog.mjs

@@ -617,6 +617,18 @@ const tooltipCatalog = defineCatalogEntry()({
 			values: [true, false],
 			default: false
 		},
+		isInteractive: {
+			values: [true, false],
+			default: true
+		},
+		shouldWrapDisabledChild: {
+			values: [true, false],
+			default: true
+		},
+		isDescriptionPersistent: {
+			values: [true, false],
+			default: false
+		},
 		shouldOpenOnHover: {
 			values: [true, false],
 			default: true

package/dist/computePopoverPosition-JgOwCM7k.d.cts

@@ -0,0 +1,12 @@
+type PopoverVerticalOrigin = 'top' | 'center' | 'bottom' | number;
+type PopoverHorizontalOrigin = 'left' | 'center' | 'right' | number;
+interface PopoverOrigin {
+  vertical: PopoverVerticalOrigin;
+  horizontal: PopoverHorizontalOrigin;
+}
+type PopoverReference = 'anchorEl' | 'anchorPosition' | 'none';
+interface PopoverPosition {
+  top: number;
+  left: number;
+}
+export { PopoverPosition as n, PopoverReference as r, PopoverOrigin as t };

package/dist/computePopoverPosition-JgOwCM7k.d.mts

@@ -0,0 +1,12 @@
+type PopoverVerticalOrigin = 'top' | 'center' | 'bottom' | number;
+type PopoverHorizontalOrigin = 'left' | 'center' | 'right' | number;
+interface PopoverOrigin {
+  vertical: PopoverVerticalOrigin;
+  horizontal: PopoverHorizontalOrigin;
+}
+type PopoverReference = 'anchorEl' | 'anchorPosition' | 'none';
+interface PopoverPosition {
+  top: number;
+  left: number;
+}
+export { PopoverPosition as n, PopoverReference as r, PopoverOrigin as t };

package/dist/engine.d.cts

@@ -1,4 +1,4 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
+import { nt as Theme } from "./index-C6a3kDn2.cjs";
 import { ComponentType, RefAttributes } from "react";
 import { CacheProvider, Interpolation } from "@emotion/react";
 /** `Global`, retyped against this package's own `Theme` (see `styled.ts`'s `StyledTags`). */

package/dist/engine.d.mts

@@ -1,4 +1,4 @@
-import { nt as Theme } from "./index-CR8qkP8U.mjs";
+import { nt as Theme } from "./index-DOH6uskj.mjs";
 import { CacheProvider, Interpolation } from "@emotion/react";
 import { ComponentType, RefAttributes } from "react";
 /** `Global`, retyped against this package's own `Theme` (see `styled.ts`'s `StyledTags`). */

package/dist/{index-4maWM1H8.d.mts → index-2jMSUeji.d.cts}

@@ -1,4 +1,4 @@
-import { nt as Theme } from "./index-CR8qkP8U.mjs";
+import { nt as Theme } from "./index-C6a3kDn2.cjs";
 import { KeyboardEvent, MouseEvent, ReactNode, Ref, RefCallback, SyntheticEvent } from "react";
 type ModalCloseReason = 'escapeKey' | 'backdropClick';
 type EventHandlers = Record<string, ((event: SyntheticEvent) => void) | undefined>;

package/dist/{index-76zijQoi.d.mts → index-3Xe5X6Ny.d.mts}

@@ -1,5 +1,5 @@
-import { nt as Theme } from "./index-CR8qkP8U.mjs";
-import { n as IconProps, r as IconName } from "./index-D48qVo1X.mjs";
+import { nt as Theme } from "./index-DOH6uskj.mjs";
+import { n as IconProps, r as IconName } from "./index-hTgl9zwe.mjs";
 import { SpaceProps } from "@soroush.tech/styled-system";
 import { ButtonHTMLAttributes } from "react";
 type TableSortLabelDirection = 'asc' | 'desc';

package/dist/{index-C7EUYyom.d.cts → index-B-p51b0z.d.cts}

@@ -1,5 +1,5 @@
-import { a as PaginationItemSize } from "./index-Dxu6Ks2A.cjs";
-import "./index-DBF5n3ey.cjs";
+import { a as PaginationItemSize } from "./index-CHWMSBhQ.cjs";
+import "./index-v1I6VA9w.cjs";
 import { HTMLAttributes } from "react";
 type TablePaginationActionType = 'first' | 'previous' | 'next' | 'last';
 interface TablePaginationActionsProps extends HTMLAttributes<HTMLDivElement> {

package/dist/index-B2XL_zZY.d.mts

@@ -0,0 +1,44 @@
+import { nt as Theme } from "./index-DOH6uskj.mjs";
+import { t as MenuItemValue } from "./MenuListContext-DURKFg_T.mjs";
+import { LayoutProps, SpaceProps } from "@soroush.tech/styled-system";
+import { AriaAttributes, KeyboardEvent, ReactNode } from "react";
+interface MenuListProps extends SpaceProps<Theme>, LayoutProps<Theme> {
+  /** `MenuItem` rows and `MenuDivider`s. */
+  children?: ReactNode;
+  /** Fired with a row's `value` when a row that has one is chosen. */
+  onSelect?: (value: MenuItemValue) => void;
+  /** Carry the arrow keys past the last row to the first, and back. Default: `true`. */
+  shouldWrap?: boolean;
+  /** Focus the selected row, or the first enabled one, on mount. Default: `false`. */
+  shouldAutoFocus?: boolean;
+  /** Accent color for every row - resolves to `theme.palette[color]`. A row's own value wins. */
+  color?: keyof Theme['palette'];
+  /** Base text color for every row - resolves against `theme.text`. A row's own value wins. */
+  textColor?: keyof Theme['text'];
+  /** Density token for every row - resolves against `theme.sizes`. A row's own value wins. */
+  size?: keyof Theme['sizes'];
+  /** Compact vertical padding for every row. */
+  dense?: boolean;
+  onKeyDown?: (event: KeyboardEvent<HTMLElement>) => void;
+  id?: string;
+  className?: string;
+  'aria-label'?: string;
+  'aria-labelledby'?: string;
+  'data-testid'?: string;
+}
+/**
+ * What an app may put on the `role="menu"` list a `Menu` or a `ContextMenu` renders, through
+ * `slotProps.list`: its marks (`data-*`), class, `aria-*` and an `onKeyDown`, which runs before the
+ * list's own. The list's `role`, `id` and name are the menu's, and win.
+ */
+type MenuListSlotProps = Pick<MenuListProps, 'className' | 'data-testid' | 'onKeyDown'> & Omit<AriaAttributes, 'aria-label' | 'aria-labelledby'> & {
+  [name: `data-${string}`]: string | number | boolean | undefined;
+};
+/**
+ * @description A `role="menu"` list that owns the keyboard: the arrow keys, Home and End
+ * move focus between its own rows, skipping disabled ones; typing jumps to a row by its
+ * label. Rows are found in the DOM by their nearest `role="menu"`, so a nested submenu's
+ * rows are never this list's. Renders in place - `Menu` floats one next to a trigger.
+ */
+declare function MenuList({ children, onSelect, shouldWrap: shouldWrapProp, shouldAutoFocus, color, textColor, size, dense, onKeyDown, ...rest }: Readonly<MenuListProps>): import("react").JSX.Element;
+export { MenuListProps as n, MenuListSlotProps as r, MenuList as t };

package/dist/{index-D4PcgL-c.d.cts → index-B5_-Bxoo.d.cts}

@@ -1,5 +1,5 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
-import { t as TableCellPadding } from "./TableContext-fIyMD_Bj.cjs";
+import { nt as Theme } from "./index-C6a3kDn2.cjs";
+import { t as TableCellPadding } from "./TableContext-VuMFtVNr.cjs";
 import { ElementType, ThHTMLAttributes } from "react";
 import { BorderProps, SpaceProps, TypographyProps } from "@soroush.tech/styled-system";
 /** The table section a cell lives in - drives `TableCell`'s th/td element resolution. */

package/dist/{index-DBF5n3ey.d.cts → index-BFUn2EWp.d.mts}

@@ -1,7 +1,7 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
-import { a as PaginationItemSize, i as PaginationItemShape, l as UsePaginationProps, n as PaginationItemColor, o as PaginationItemVariant, s as PaginationItemType } from "./index-Dxu6Ks2A.cjs";
-import { HTMLAttributes } from "react";
+import { nt as Theme } from "./index-DOH6uskj.mjs";
+import { a as PaginationItemSize, i as PaginationItemShape, l as UsePaginationProps, n as PaginationItemColor, o as PaginationItemVariant, s as PaginationItemType } from "./index-C-ebcNOc.mjs";
 import { SpaceProps } from "@soroush.tech/styled-system";
+import { HTMLAttributes } from "react";
 type PaginationColor = PaginationItemColor;
 type PaginationVariant = PaginationItemVariant;
 type PaginationShape = PaginationItemShape;

package/dist/{index-Byk1_ms9.d.cts → index-BKM4d_F4.d.cts}

@@ -1,5 +1,5 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
-import { t as MenuItemValue } from "./MenuListContext-BwgQHUu9.cjs";
+import { nt as Theme } from "./index-C6a3kDn2.cjs";
+import { t as MenuItemValue } from "./MenuListContext-AnAxu0he.cjs";
 import { ElementType, KeyboardEvent, MouseEvent, ReactNode } from "react";
 type MenuItemColor = keyof Theme['palette'];
 type MenuItemSize = keyof Theme['sizes'];

package/dist/index-BL5Kj3Ka.d.mts

@@ -0,0 +1 @@
+import "./index-DOH6uskj.mjs";

package/dist/{index-SotXsXXb.d.mts → index-BLypGp0N.d.mts}

@@ -1,7 +1,7 @@
-import { nt as Theme, tt as TabsVariants } from "./index-CR8qkP8U.mjs";
-import "./index-CF_pl72E.mjs";
-import { t as TabValue } from "./TabsContext-0ZtedNyH.mjs";
-import { n as TabScrollButtonProps } from "./index-C_J58B_n.mjs";
+import { nt as Theme, tt as TabsVariants } from "./index-DOH6uskj.mjs";
+import "./index-i8BxMDEC.mjs";
+import { t as TabValue } from "./TabsContext-VJcdZQOf.mjs";
+import { n as TabScrollButtonProps } from "./index-DlNBgVwb.mjs";
 import { SpaceProps } from "@soroush.tech/styled-system";
 import { ComponentType, ReactNode, Ref } from "react";
 type TabsVariant = keyof TabsVariants;

package/dist/{index-hoHPfsc1.d.cts → index-BVDN2XbT.d.mts}

@@ -1,7 +1,7 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
-import { n as ButtonColor, o as ButtonSize, s as ButtonVariant } from "./index-BzQze7eY.cjs";
-import { ElementType, HTMLAttributes } from "react";
+import { nt as Theme } from "./index-DOH6uskj.mjs";
+import { n as ButtonColor, o as ButtonSize, s as ButtonVariant } from "./index-CCEfrBNN.mjs";
 import { SpaceProps } from "@soroush.tech/styled-system";
+import { ElementType, HTMLAttributes } from "react";
 type ButtonGroupOrientation = 'horizontal' | 'vertical';
 type ButtonGroupRadius = keyof Theme['radii'];
 interface ButtonGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'>, SpaceProps<Theme> {

package/dist/{index-CLTFsCYC.d.cts → index-Bhb0bFxe.d.mts}

@@ -1,5 +1,5 @@
-import { nt as Theme } from "./index-Lsm4v8fB.cjs";
-import { r as TransitionTimeout, t as TransitionCallbacks } from "./useTransition-C89K0mS7.cjs";
+import { nt as Theme } from "./index-DOH6uskj.mjs";
+import { r as TransitionTimeout, t as TransitionCallbacks } from "./useTransition-DDGpvgci.mjs";
 import { ReactNode } from "react";
 type CollapseOrientation = 'vertical' | 'horizontal';
 interface CollapseProps extends TransitionCallbacks {