@krelborn/stylesui 0.0.0-stage → 0.9.0

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+export { Accordion, AccordionItem } from "./components/Accordion";
+export type { AccordionIndicator, AccordionItemProps, AccordionProps, AccordionVariant } from "./components/Accordion";
+export { Alert } from "./components/Alert";
+export type { AlertProps, AlertTone } from "./components/Alert";
+export { Avatar } from "./components/Avatar";
+export type { AvatarProps, AvatarSize } from "./components/Avatar";
+export { AvatarGroup } from "./components/AvatarGroup";
+export type { AvatarGroupProps } from "./components/AvatarGroup";
+export { Badge } from "./components/Badge";
+export type { BadgeElement, BadgeProps, BadgeTone, BadgeVariant } from "./components/Badge";
+export { Box } from "./components/Box";
+export type { BoxElement, BoxProps, PolymorphicProps } from "./components/Box";
+export { Button } from "./components/Button";
+export type { ButtonProps, ButtonSize, ButtonVariant } from "./components/Button";
+export { Card } from "./components/Card";
+export type { CardPadding, CardProps } from "./components/Card";
+export { Center } from "./components/Center";
+export type { CenterProps, CenterWidth } from "./components/Center";
+export { Checkbox } from "./components/Checkbox";
+export type { CheckboxProps } from "./components/Checkbox";
+export { Cluster } from "./components/Cluster";
+export type { ClusterProps } from "./components/Cluster";
+export { Code } from "./components/Code";
+export type { CodeProps } from "./components/Code";
+export { Autocomplete, Combobox, ComboboxOption } from "./components/Combobox";
+export type { AutocompleteProps, ComboboxOptionProps, ComboboxProps } from "./components/Combobox";
+export { useContextMenu } from "./components/ContextMenu";
+export type { UseContextMenuOptions, UseContextMenuResult } from "./components/ContextMenu";
+export { Counter } from "./components/Counter";
+export type { CounterProps } from "./components/Counter";
+export { Cover } from "./components/Cover";
+export type { CoverProps } from "./components/Cover";
+export { Divider } from "./components/Divider";
+export type { DividerOrientation, DividerProps } from "./components/Divider";
+export { Field } from "./components/Field";
+export type { FieldElement, FieldProps } from "./components/Field";
+export { Fieldset } from "./components/Fieldset";
+export type { FieldsetProps } from "./components/Fieldset";
+export { Frame } from "./components/Frame";
+export type { FrameProps } from "./components/Frame";
+export { Grid } from "./components/Grid";
+export type { GridProps } from "./components/Grid";
+export { Heading } from "./components/Heading";
+export type { HeadingLevel, HeadingProps, HeadingSize } from "./components/Heading";
+export { AddIcon, CheckIcon, ChevronDownIcon, ChevronRightIcon, CloseIcon, ColorModeIcon, DeleteIcon, InfoIcon, MenuIcon, MoreHorizontalIcon, MoreVerticalIcon, PaletteIcon, RefreshIcon, RemoveIcon, SendIcon, } from "./components/Icon";
+export type { IconProps } from "./components/Icon";
+export { IconButton } from "./components/IconButton";
+export type { IconButtonProps } from "./components/IconButton";
+export { Kbd } from "./components/Kbd";
+export type { KbdProps } from "./components/Kbd";
+export { Link } from "./components/Link";
+export type { LinkElement, LinkProps, LinkTone, LinkUnderline } from "./components/Link";
+export { Listbox, ListboxOption } from "./components/Listbox";
+export type { ListboxOptionProps, ListboxProps } from "./components/Listbox";
+export { Menu, MenuGroup, MenuItem, MenuItemCheckbox, MenuItemRadio, MenuRadioGroup, MenuSeparator, Submenu, useMenu, } from "./components/Menu";
+export type { MenuDensity, MenuGroupProps, MenuItemCheckboxProps, MenuItemElement, MenuItemProps, MenuItemRadioProps, MenuOverlayProps, MenuProps, MenuRadioGroupProps, MenuSeparatorProps, SubmenuProps, UseMenuOptions, UseMenuResult, } from "./components/Menu";
+export { Menubar, MenubarMenu } from "./components/Menubar";
+export type { MenubarMenuProps, MenubarProps } from "./components/Menubar";
+export { NavBar, NavBarItem, NavBarMenu, NavBarMenuGroup, NavBarMenuItem } from "./components/NavBar";
+export type { NavBarCollapse, NavBarItemProps, NavBarMenuGroupProps, NavBarMenuItemProps, NavBarMenuProps, NavBarProps, } from "./components/NavBar";
+export { NavList, NavListGroup, NavListItem } from "./components/NavList";
+export type { NavListGroupProps, NavListItemElement, NavListItemProps, NavListProps } from "./components/NavList";
+export { PageLayout } from "./components/PageLayout";
+export type { PageLayoutProps } from "./components/PageLayout";
+export { Popover, usePopover } from "./components/Popover";
+export type { PopoverProps, UsePopoverOptions, UsePopoverResult } from "./components/Popover";
+export { Prose } from "./components/Prose";
+export type { ProseCodeOverflow, ProseProps, ProseSize } from "./components/Prose";
+export { Radio } from "./components/Radio";
+export type { RadioProps } from "./components/Radio";
+export { RadioGroup } from "./components/RadioGroup";
+export type { RadioGroupOrientation, RadioGroupProps } from "./components/RadioGroup";
+export { Row } from "./components/Row";
+export type { RowProps } from "./components/Row";
+export { Segment, SegmentedControl } from "./components/SegmentedControl";
+export type { SegmentedControlProps, SegmentProps } from "./components/SegmentedControl";
+export { Select } from "./components/Select";
+export type { SelectProps } from "./components/Select";
+export { Sidebar } from "./components/Sidebar";
+export type { SidebarProps } from "./components/Sidebar";
+export { SkipLink } from "./components/SkipLink";
+export type { SkipLinkProps } from "./components/SkipLink";
+export { Stack } from "./components/Stack";
+export type { StackProps } from "./components/Stack";
+export { StatusDot } from "./components/StatusDot";
+export type { StatusDotProps, StatusDotSize, StatusDotVariant } from "./components/StatusDot";
+export { Switch } from "./components/Switch";
+export type { SwitchProps } from "./components/Switch";
+export { Switcher } from "./components/Switcher";
+export type { SwitcherProps } from "./components/Switcher";
+export { Tab, TabList, TabPanel, Tabs } from "./components/Tabs";
+export type { TabListProps, TabPanelProps, TabProps, TabsActivation, TabsOrientation, TabsProps, TabsVariant, } from "./components/Tabs";
+export { Text } from "./components/Text";
+export type { TextProps, TextSize, TextTone, TextWeight } from "./components/Text";
+export { Textarea } from "./components/Textarea";
+export type { TextareaProps } from "./components/Textarea";
+export { TextInput } from "./components/TextInput";
+export type { TextInputProps, TextInputType } from "./components/TextInput";
+export { Theme } from "./components/Theme";
+export type { PaletteName, ThemeMode, ThemeName, ThemeProps } from "./components/Theme";
+export { Tooltip, useTooltip } from "./components/Tooltip";
+export type { TooltipProps, TooltipRelationship, UseTooltipOptions, UseTooltipResult } from "./components/Tooltip";
+export { VisuallyHidden } from "./components/VisuallyHidden";
+export type { VisuallyHiddenProps } from "./components/VisuallyHidden";
+export type { ControlSize } from "./forms";
+export type { Alignment, Justification, Space } from "./layout";
+export type { OverlayDelay, OverlayPlacement } from "./overlays";

package/dist/index.js

@@ -0,0 +1,92 @@
+import { Accordion as e } from "./components/Accordion/Accordion.js";
+import { AccordionItem as t } from "./components/Accordion/AccordionItem.js";
+import { Alert as n } from "./components/Alert/Alert.js";
+import { Avatar as r } from "./components/Avatar/Avatar.js";
+import { AvatarGroup as i } from "./components/AvatarGroup/AvatarGroup.js";
+import { Badge as a } from "./components/Badge/Badge.js";
+import { Box as o } from "./components/Box/Box.js";
+import { Button as s } from "./components/Button/Button.js";
+import { Card as c } from "./components/Card/Card.js";
+import { Center as l } from "./components/Center/Center.js";
+import { Checkbox as u } from "./components/Checkbox/Checkbox.js";
+import { Cluster as d } from "./components/Cluster/Cluster.js";
+import { Code as f } from "./components/Code/Code.js";
+import { Autocomplete as p } from "./components/Combobox/Autocomplete.js";
+import { Combobox as m } from "./components/Combobox/Combobox.js";
+import { ComboboxOption as h } from "./components/Combobox/ComboboxOption.js";
+import { useContextMenu as g } from "./components/ContextMenu/useContextMenu.js";
+import { Counter as _ } from "./components/Counter/Counter.js";
+import { Cover as v } from "./components/Cover/Cover.js";
+import { Divider as y } from "./components/Divider/Divider.js";
+import { Field as b } from "./components/Field/Field.js";
+import { Fieldset as x } from "./components/Fieldset/Fieldset.js";
+import { Frame as S } from "./components/Frame/Frame.js";
+import { Grid as C } from "./components/Grid/Grid.js";
+import { Heading as w } from "./components/Heading/Heading.js";
+import { AddIcon as T } from "./components/Icon/AddIcon.js";
+import { CheckIcon as E } from "./components/Icon/CheckIcon.js";
+import { ChevronDownIcon as D } from "./components/Icon/ChevronDownIcon.js";
+import { ChevronRightIcon as O } from "./components/Icon/ChevronRightIcon.js";
+import { CloseIcon as k } from "./components/Icon/CloseIcon.js";
+import { ColorModeIcon as A } from "./components/Icon/ColorModeIcon.js";
+import { DeleteIcon as j } from "./components/Icon/DeleteIcon.js";
+import { InfoIcon as M } from "./components/Icon/InfoIcon.js";
+import { MenuIcon as N } from "./components/Icon/MenuIcon.js";
+import { MoreHorizontalIcon as P } from "./components/Icon/MoreHorizontalIcon.js";
+import { MoreVerticalIcon as F } from "./components/Icon/MoreVerticalIcon.js";
+import { PaletteIcon as I } from "./components/Icon/PaletteIcon.js";
+import { RefreshIcon as L } from "./components/Icon/RefreshIcon.js";
+import { RemoveIcon as R } from "./components/Icon/RemoveIcon.js";
+import { SendIcon as z } from "./components/Icon/SendIcon.js";
+import { IconButton as B } from "./components/IconButton/IconButton.js";
+import { Kbd as V } from "./components/Kbd/Kbd.js";
+import { Link as H } from "./components/Link/Link.js";
+import { Listbox as U } from "./components/Listbox/Listbox.js";
+import { ListboxOption as W } from "./components/Listbox/ListboxOption.js";
+import { Menu as G } from "./components/Menu/Menu.js";
+import { MenuGroup as K } from "./components/Menu/MenuGroup.js";
+import { MenuItem as q } from "./components/Menu/MenuItem.js";
+import { MenuItemCheckbox as J } from "./components/Menu/MenuItemCheckbox.js";
+import { MenuItemRadio as Y } from "./components/Menu/MenuItemRadio.js";
+import { MenuRadioGroup as X } from "./components/Menu/MenuRadioGroup.js";
+import { MenuSeparator as Z } from "./components/Menu/MenuSeparator.js";
+import { Submenu as Q } from "./components/Menu/Submenu.js";
+import { useMenu as $ } from "./components/Menu/useMenu.js";
+import { Menubar as ee } from "./components/Menubar/Menubar.js";
+import { MenubarMenu as te } from "./components/Menubar/MenubarMenu.js";
+import { NavBar as ne } from "./components/NavBar/NavBar.js";
+import { NavBarItem as re } from "./components/NavBar/NavBarItem.js";
+import { NavBarMenu as ie } from "./components/NavBar/NavBarMenu.js";
+import { NavBarMenuGroup as ae } from "./components/NavBar/NavBarMenuGroup.js";
+import { NavBarMenuItem as oe } from "./components/NavBar/NavBarMenuItem.js";
+import { NavList as se } from "./components/NavList/NavList.js";
+import { NavListGroup as ce } from "./components/NavList/NavListGroup.js";
+import { NavListItem as le } from "./components/NavList/NavListItem.js";
+import { PageLayout as ue } from "./components/PageLayout/PageLayout.js";
+import { Popover as de } from "./components/Popover/Popover.js";
+import { usePopover as fe } from "./components/Popover/usePopover.js";
+import { Prose as pe } from "./components/Prose/Prose.js";
+import { Radio as me } from "./components/Radio/Radio.js";
+import { RadioGroup as he } from "./components/RadioGroup/RadioGroup.js";
+import { Row as ge } from "./components/Row/Row.js";
+import { Segment as _e } from "./components/SegmentedControl/Segment.js";
+import { SegmentedControl as ve } from "./components/SegmentedControl/SegmentedControl.js";
+import { Select as ye } from "./components/Select/Select.js";
+import { Sidebar as be } from "./components/Sidebar/Sidebar.js";
+import { SkipLink as xe } from "./components/SkipLink/SkipLink.js";
+import { Stack as Se } from "./components/Stack/Stack.js";
+import { StatusDot as Ce } from "./components/StatusDot/StatusDot.js";
+import { Switch as we } from "./components/Switch/Switch.js";
+import { Switcher as Te } from "./components/Switcher/Switcher.js";
+import { Tab as Ee } from "./components/Tabs/Tab.js";
+import { TabList as De } from "./components/Tabs/TabList.js";
+import { TabPanel as Oe } from "./components/Tabs/TabPanel.js";
+import { Tabs as ke } from "./components/Tabs/Tabs.js";
+import { Text as Ae } from "./components/Text/Text.js";
+import { Textarea as je } from "./components/Textarea/Textarea.js";
+import { TextInput as Me } from "./components/TextInput/TextInput.js";
+import { Theme as Ne } from "./components/Theme/Theme.js";
+import { Tooltip as Pe } from "./components/Tooltip/Tooltip.js";
+import { useTooltip as Fe } from "./components/Tooltip/useTooltip.js";
+import { VisuallyHidden as Ie } from "./components/VisuallyHidden/VisuallyHidden.js";
+export { e as Accordion, t as AccordionItem, T as AddIcon, n as Alert, p as Autocomplete, r as Avatar, i as AvatarGroup, a as Badge, o as Box, s as Button, c as Card, l as Center, E as CheckIcon, u as Checkbox, D as ChevronDownIcon, O as ChevronRightIcon, k as CloseIcon, d as Cluster, f as Code, A as ColorModeIcon, m as Combobox, h as ComboboxOption, _ as Counter, v as Cover, j as DeleteIcon, y as Divider, b as Field, x as Fieldset, S as Frame, C as Grid, w as Heading, B as IconButton, M as InfoIcon, V as Kbd, H as Link, U as Listbox, W as ListboxOption, G as Menu, K as MenuGroup, N as MenuIcon, q as MenuItem, J as MenuItemCheckbox, Y as MenuItemRadio, X as MenuRadioGroup, Z as MenuSeparator, ee as Menubar, te as MenubarMenu, P as MoreHorizontalIcon, F as MoreVerticalIcon, ne as NavBar, re as NavBarItem, ie as NavBarMenu, ae as NavBarMenuGroup, oe as NavBarMenuItem, se as NavList, ce as NavListGroup, le as NavListItem, ue as PageLayout, I as PaletteIcon, de as Popover, pe as Prose, me as Radio, he as RadioGroup, L as RefreshIcon, R as RemoveIcon, ge as Row, _e as Segment, ve as SegmentedControl, ye as Select, z as SendIcon, be as Sidebar, xe as SkipLink, Se as Stack, Ce as StatusDot, Q as Submenu, we as Switch, Te as Switcher, Ee as Tab, De as TabList, Oe as TabPanel, ke as Tabs, Ae as Text, Me as TextInput, je as Textarea, Ne as Theme, Pe as Tooltip, Ie as VisuallyHidden, g as useContextMenu, $ as useMenu, fe as usePopover, Fe as useTooltip };

package/dist/layout/Space.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Step on the spacing scale, mapped to the `--sui-space-*` tokens; 0 is no space
+ */
+export type Space = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;

package/dist/layout/alignment.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Placement of children on a container's cross axis
+ */
+export type Alignment = "start" | "center" | "end" | "stretch" | "baseline";
+/**
+ * Distribution of children along a container's main axis
+ */
+export type Justification = "start" | "center" | "end" | "between";

package/dist/layout/index.d.ts

@@ -0,0 +1,5 @@
+export type { Alignment, Justification } from "./alignment";
+export { listRole } from "./listRole";
+export type { Space } from "./Space";
+export { spaceValue } from "./spaceValue";
+export { withCustomProperties } from "./withCustomProperties";

package/dist/layout/listRole.d.ts

@@ -0,0 +1,11 @@
+import type { AriaRole } from "react";
+import type { BoxElement } from "../components/Box";
+/**
+ * Picks the role for a container that removes list markers, which makes WebKit stop exposing
+ * `ul` and `ol` as lists
+ *
+ * @param element the element the container renders
+ * @param role the role the consumer passed, if any
+ * @returns `list` for a `ul` or `ol` without a role, otherwise the given role
+ */
+export declare function listRole(element: BoxElement, role: AriaRole | undefined): AriaRole | undefined;

package/dist/layout/listRole.js

@@ -0,0 +1,5 @@
+// src/layout/listRole.ts
+function e(e, t) {
+	return t === void 0 && (e === "ul" || e === "ol") ? "list" : t;
+}
+export { e as listRole };

package/dist/layout/spaceValue.d.ts

@@ -0,0 +1,8 @@
+import type { Space } from "./Space";
+/**
+ * Resolves a spacing step to a CSS value
+ *
+ * @param space the spacing step
+ * @returns `0px` (a length, so it stays valid inside `calc()`), or the matching `--sui-space-*` token with the default theme's value as fallback
+ */
+export declare function spaceValue(space: Space): string;

package/dist/layout/spaceValue.js

@@ -0,0 +1,5 @@
+// src/layout/spaceValue.ts
+function e(e) {
+	return e === 0 ? "0px" : `var(--sui-space-${e}, ${e * .25}rem)`;
+}
+export { e as spaceValue };

package/dist/layout/withCustomProperties.d.ts

@@ -0,0 +1,9 @@
+import type { CSSProperties } from "react";
+/**
+ * Merges a component's custom properties with the consumer's style
+ *
+ * @param customProperties the component's custom properties; undefined values are not rendered
+ * @param style the consumer's style, whose declarations win on conflict
+ * @returns the merged style
+ */
+export declare function withCustomProperties(customProperties: Record<`--${string}`, string | undefined>, style: CSSProperties | undefined): CSSProperties;

package/dist/layout/withCustomProperties.js

@@ -0,0 +1,8 @@
+// src/layout/withCustomProperties.ts
+function e(e, t) {
+	return {
+		...e,
+		...t
+	};
+}
+export { e as withCustomProperties };

package/dist/links/LinkOrButtonProps.d.ts

@@ -0,0 +1,17 @@
+import type { ComponentPropsWithRef, JSXElementConstructor } from "react";
+/**
+ * What a link-or-button component can render: a link, a button, or a component that renders an anchor, such as a
+ * router's link
+ */
+export type LinkOrButtonElement = "a" | "button" | JSXElementConstructor<never>;
+type PropsOnlyOn<Element extends "a" | "button", Other extends "a" | "button"> = {
+    [Name in Exclude<keyof ComponentPropsWithRef<Element>, keyof ComponentPropsWithRef<Other>>]?: never;
+};
+type ElementProps<E extends LinkOrButtonElement> = E extends JSXElementConstructor<infer Props> ? Props : E extends "button" ? ComponentPropsWithRef<"button"> & PropsOnlyOn<"a", "button"> : ComponentPropsWithRef<"a"> & PropsOnlyOn<"button", "a">;
+type OmitFromEach<Props, Name extends PropertyKey> = Props extends unknown ? Omit<Props, Name> : never;
+/**
+ * The props of the link, button or component given in `as`, less the names a component sets itself. When `as` may be
+ * either a link or a button, only props both accept are allowed.
+ */
+export type LinkOrButtonProps<E extends LinkOrButtonElement, Omitted extends PropertyKey> = OmitFromEach<ElementProps<E>, Omitted>;
+export {};

package/dist/links/index.d.ts

@@ -0,0 +1 @@
+export type { LinkOrButtonElement, LinkOrButtonProps } from "./LinkOrButtonProps";

package/dist/menus/closeWhenFocusLeaves.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hides an open menu when focus moves out of it, as a light dismiss would, leaving focus where it went
+ *
+ * @param menu the menu that lost focus
+ * @param relatedTarget the element taking focus, or `null` when focus is between elements or lost with an item that
+ *   was removed, in which case the menu waits a task to see where it lands
+ * @param staysOn whether focus on an element outside the menu keeps it open, such as on its trigger
+ */
+export declare function closeWhenFocusLeaves(menu: HTMLElement, relatedTarget: Element | null, staysOn: (focused: Element) => boolean): void;

package/dist/menus/closeWhenFocusLeaves.js

@@ -0,0 +1,11 @@
+import { syncPopover as e } from "../overlays/syncPopover.js";
+// src/menus/closeWhenFocusLeaves.ts
+function t(e, t, r) {
+	e.matches(":popover-open") && (t === null ? setTimeout(() => {
+		n(e, e.ownerDocument.activeElement, r);
+	}, 0) : n(e, t, r));
+}
+function n(t, n, r) {
+	(n === null || !t.contains(n) && !r(n)) && t.matches(":popover-open") && e(t, !1);
+}
+export { t as closeWhenFocusLeaves };

package/dist/menus/focusItem.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Moves focus to a menu item and scrolls it into view within the menu, as far as it needs and no further
+ *
+ * @param item the item to focus
+ */
+export declare function focusItem(item: HTMLElement): void;

package/dist/menus/focusItem.js

@@ -0,0 +1,9 @@
+// src/menus/focusItem.ts
+var e = {
+	block: "nearest",
+	container: "nearest"
+};
+function t(t) {
+	t.focus({ preventScroll: !0 }), t.scrollIntoView(e);
+}
+export { t as focusItem };

package/dist/menus/focusOnOpening.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Where focus goes as a menu opens: its first or last item, or the menu itself
+ */
+export type OpeningFocus = "first" | "last" | "menu";
+/**
+ * Moves focus into a menu that has just opened
+ *
+ * @param menu the menu element
+ * @param openingFocus where focus goes; a menu with no items takes it itself
+ */
+export declare function focusOnOpening(menu: HTMLElement, openingFocus: OpeningFocus): void;

package/dist/menus/focusOnOpening.js

@@ -0,0 +1,11 @@
+import { renderedItems as e } from "./renderedItems.js";
+// src/menus/focusOnOpening.ts
+function t(t, n) {
+	let r = e(t);
+	({
+		first: r.at(0),
+		last: r.at(-1),
+		menu: t
+	}[n] ?? t).focus();
+}
+export { t as focusOnOpening };

package/dist/menus/hasModifier.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether a key was pressed with Alt, Ctrl or Meta, which leaves it to the browser and the app
+ *
+ * @param event the key event
+ * @returns true when any of the three was held
+ */
+export declare function hasModifier(event: Pick<KeyboardEvent, "altKey" | "ctrlKey" | "metaKey">): boolean;

package/dist/menus/hasModifier.js

@@ -0,0 +1,5 @@
+// src/menus/hasModifier.ts
+function e(e) {
+	return e.altKey || e.ctrlKey || e.metaKey;
+}
+export { e as hasModifier };

package/dist/menus/index.d.ts

@@ -0,0 +1,11 @@
+export { closeWhenFocusLeaves } from "./closeWhenFocusLeaves";
+export { focusItem } from "./focusItem";
+export { focusOnOpening } from "./focusOnOpening";
+export type { OpeningFocus } from "./focusOnOpening";
+export { hasModifier } from "./hasModifier";
+export { itemText } from "./itemText";
+export { leaveMenuOnTab } from "./leaveMenuOnTab";
+export { graceTriangle, isInsideTriangle } from "./pointerIntent";
+export type { Point, Triangle } from "./pointerIntent";
+export { renderedItems } from "./renderedItems";
+export { watchRemovals } from "./watchRemovals";

package/dist/menus/itemText.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reads the text type-ahead matches for a menu item
+ *
+ * @param item the item element
+ * @returns the text of the elements its `aria-labelledby` names, joined by spaces, so a description or shortcut is
+ *   left out; its own text when it names none in its document
+ */
+export declare function itemText(item: HTMLElement): string;

package/dist/menus/itemText.js

@@ -0,0 +1,6 @@
+// src/menus/itemText.ts
+function e(e) {
+	let t = (e.getAttribute("aria-labelledby") ?? "").split(/\s+/).map((t) => e.ownerDocument.getElementById(t)).filter((e) => e !== null);
+	return t.length === 0 ? e.textContent ?? "" : t.map((e) => e.textContent).join(" ");
+}
+export { e as itemText };

package/dist/menus/leaveMenuOnTab.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Closes a menu on Tab or Shift+Tab, moving focus back to where the menu was opened from. Tab then moves on from
+ * there, as though the menu were not there, and Shift+Tab stops there.
+ *
+ * @param event the key event the menu received
+ * @param returnTo the element focus goes back to; with none, the key is left alone
+ * @param close closes the menu
+ */
+export declare function leaveMenuOnTab(event: Pick<KeyboardEvent, "altKey" | "ctrlKey" | "defaultPrevented" | "key" | "metaKey" | "preventDefault" | "shiftKey">, returnTo: HTMLElement | null, close: () => void): void;

package/dist/menus/leaveMenuOnTab.js

@@ -0,0 +1,6 @@
+import { hasModifier as e } from "./hasModifier.js";
+// src/menus/leaveMenuOnTab.ts
+function t(t, n, r) {
+	t.key !== "Tab" || n === null || t.defaultPrevented || e(t) || (t.shiftKey && t.preventDefault(), n.focus(), r());
+}
+export { t as leaveMenuOnTab };

package/dist/menus/pointerIntent.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A point in viewport coordinates, as a pointer event's `clientX` and `clientY` give it
+ */
+export interface Point {
+    /**
+     * Distance from the viewport's left edge
+     */
+    x: number;
+    /**
+     * Distance from the viewport's top edge
+     */
+    y: number;
+}
+/**
+ * Three corners of a triangle
+ */
+export type Triangle = readonly [Point, Point, Point];
+/**
+ * The triangle a pointer crosses on its way from a submenu's item into the submenu, so moving diagonally over the
+ * items between does not close it
+ *
+ * @param exit where the pointer left the submenu's item
+ * @param submenu the submenu's bounds
+ * @returns the triangle from just behind the exit point to the two corners of the submenu's side facing it: its
+ *   nearer side when the submenu sits beside the exit point, else its top or bottom
+ */
+export declare function graceTriangle(exit: Point, { bottom, left, right, top }: DOMRectReadOnly): Triangle;
+/**
+ * Whether a point is inside a triangle or on its edge
+ *
+ * @param point the point
+ * @param triangle the triangle
+ * @returns true when the point is inside or on an edge; false for a flat triangle, such as one to a submenu that has no
+ *   size
+ */
+export declare function isInsideTriangle(point: Point, [first, second, third]: Triangle): boolean;

package/dist/menus/pointerIntent.js

@@ -0,0 +1,68 @@
+function e(e, { bottom: t, left: n, right: r, top: i }) {
+	return e.x <= n ? [
+		{
+			x: e.x - 5,
+			y: e.y
+		},
+		{
+			x: n,
+			y: i
+		},
+		{
+			x: n,
+			y: t
+		}
+	] : e.x >= r ? [
+		{
+			x: e.x + 5,
+			y: e.y
+		},
+		{
+			x: r,
+			y: i
+		},
+		{
+			x: r,
+			y: t
+		}
+	] : e.y <= i ? [
+		{
+			x: e.x,
+			y: e.y - 5
+		},
+		{
+			x: n,
+			y: i
+		},
+		{
+			x: r,
+			y: i
+		}
+	] : [
+		{
+			x: e.x,
+			y: e.y + 5
+		},
+		{
+			x: n,
+			y: t
+		},
+		{
+			x: r,
+			y: t
+		}
+	];
+}
+function t(e, [t, r, i]) {
+	if (n(t, r, i) === 0) return !1;
+	let a = [
+		n(t, r, e),
+		n(r, i, e),
+		n(i, t, e)
+	];
+	return a.every((e) => e >= 0) || a.every((e) => e <= 0);
+}
+function n(e, t, n) {
+	return (t.x - e.x) * (n.y - e.y) - (t.y - e.y) * (n.x - e.x);
+}
+export { e as graceTriangle, t as isInsideTriangle };

package/dist/menus/renderedItems.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reads the items a menu renders
+ *
+ * @param menu the menu element
+ * @returns the menu's own items that are not hidden or inert, in document order, leaving out the items of any menu
+ *   nested inside it
+ */
+export declare function renderedItems(menu: HTMLElement): HTMLElement[];

package/dist/menus/renderedItems.js

@@ -0,0 +1,4 @@
+function e(e) {
+	return Array.from(e.querySelectorAll("[role=\"menuitem\"], [role=\"menuitemcheckbox\"], [role=\"menuitemradio\"]")).filter((t) => t.parentElement?.closest("[role=\"menu\"]") === e && t.closest("[hidden], [inert]") === null);
+}
+export { e as renderedItems };

package/dist/menus/watchRemovals.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Keeps focus inside a menu when the focused item is removed from it or from one of its submenus, by moving focus to
+ * the innermost menu that held the item and is still open
+ *
+ * @param menu the open menu
+ * @returns a function that stops watching, to call when the menu closes
+ */
+export declare function watchRemovals(menu: HTMLElement): () => void;

package/dist/menus/watchRemovals.js

@@ -0,0 +1,23 @@
+// src/menus/watchRemovals.ts
+function e(e) {
+	let n = null, r = [];
+	function i(i) {
+		n = i.target instanceof Element ? i.target : null, r = n === null ? [] : t(n, e);
+	}
+	let a = new MutationObserver(() => {
+		let t = e.ownerDocument.activeElement, i = t === null || t === e.ownerDocument.body, a = n !== null && !e.contains(n);
+		i && a && e.matches(":popover-open") && (r.find((e) => e.isConnected && e.matches(":popover-open")) ?? e).focus();
+	});
+	return e.addEventListener("focusin", i), a.observe(e, {
+		childList: !0,
+		subtree: !0
+	}), () => {
+		e.removeEventListener("focusin", i), a.disconnect();
+	};
+}
+function t(e, t) {
+	let n = [], r = e.closest("[role=\"menu\"]");
+	for (; r !== null && t.contains(r);) n.push(r), r = r.parentElement?.closest("[role=\"menu\"]") ?? null;
+	return n;
+}
+export { e as watchRemovals };

package/dist/overlays/OverlayDelay.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Delays before an overlay shows and hides, in milliseconds
+ */
+export interface OverlayDelay {
+    /**
+     * Time between the pointer leaving the trigger and overlay, and the overlay hiding
+     */
+    hide?: number;
+    /**
+     * Time between the pointer entering the trigger and the overlay showing
+     */
+    show?: number;
+}

package/dist/overlays/OverlayPlacement.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Side of the trigger an overlay opens on. `top` and `bottom` centre it on the trigger, and `top-start`, `top-end`,
+ * `bottom-start` and `bottom-end` line its start or end edge up with the trigger's instead, so it grows away from that
+ * edge. `start` and `end` follow the writing direction.
+ */
+export type OverlayPlacement = "bottom" | "bottom-end" | "bottom-start" | "end" | "start" | "top" | "top-end" | "top-start";

package/dist/overlays/anchorNameFor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Builds the `anchor-name` that ties an overlay to its trigger
+ *
+ * @param id the overlay's generated id
+ * @returns a dashed ident unique to the id, with the punctuation React's ids contain removed
+ */
+export declare function anchorNameFor(id: string): string;

package/dist/overlays/anchorNameFor.js

@@ -0,0 +1,5 @@
+// src/overlays/anchorNameFor.ts
+function e(e) {
+	return `--sui-overlay-${e.replace(/[^\w-]/g, "")}`;
+}
+export { e as anchorNameFor };