@seekalfred/primitives 0.7.1 → 0.7.4

package/dist/multi-select/multi-select.js

@@ -2,14 +2,99 @@
 import { cn, cnAll } from "../lib/cn.js";
 import { SwapText } from "../lib/swap-text.js";
 import { useFlip } from "../lib/flip.js";
+import { Tooltip as Tooltip$1, TooltipTrigger as TooltipTrigger$1 } from "../tooltip/tooltip.js";
 import { labelVariants } from "../label/label.js";
-import { selectPopoverVariants, selectTriggerVariants, selectVariants } from "../select/select.js";
+import { selectItemVariants, selectPopoverVariants, selectTriggerVariants, selectVariants } from "../select/select.js";
+import { cva } from "class-variance-authority";
 import { forwardRef, useContext, useRef, useState } from "react";
-import { Button, ButtonContext, FieldError, Label, ListBox, Popover, Select, SelectStateContext, SelectValue } from "react-aria-components";
+import { Autocomplete, Button, ButtonContext, FieldError, Header, Input, Label, ListBox, ListBoxItem, ListBoxSection, Popover, SearchField, Select, SelectStateContext, SelectValue, useFilter } from "react-aria-components";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/multi-select/multi-select.tsx
+/** The key of the create row. Never reaches `onChange`. */
+const CREATE_KEY = "__multi-select-create__";
+const defaultCreateLabel = (value) => `Create \u201c${value}\u201d`;
+/** Whether `text` already names an option (by its text or its key) or a pick, ignoring case. */
+function isTaken(state, text) {
+	const want = text.toLocaleLowerCase();
+	if ((state?.value ?? []).some((key) => String(key).toLocaleLowerCase() === want)) return true;
+	if (!state) return false;
+	for (const key of state.collection.getKeys()) {
+		const node = state.collection.getItem(key);
+		if (node?.type === "item" && node.key !== CREATE_KEY && (node.textValue.toLocaleLowerCase() === want || String(node.key).toLocaleLowerCase() === want)) return true;
+	}
+	return false;
+}
+/**
+* The list with a search field over it (React Aria's Autocomplete): the field
+* keeps focus and drives the options with the arrow keys, Enter picks.
+*/
+function SearchList({ query, onQueryChange, creatable, searchLabel, searchPlaceholder, emptyLabel, children }) {
+	const state = useContext(SelectStateContext);
+	const { contains } = useFilter({ sensitivity: "base" });
+	const text = query.trim();
+	const offerCreate = creatable && text !== "" && !isTaken(state, text);
+	return /* @__PURE__ */ jsxs(Autocomplete, {
+		inputValue: query,
+		onInputChange: onQueryChange,
+		filter: (textValue, input, node) => node.key === CREATE_KEY ? offerCreate : contains(textValue, input),
+		children: [/* @__PURE__ */ jsxs(SearchField, {
+			"aria-label": searchLabel,
+			autoFocus: true,
+			"data-slot": "multi-select-search",
+			className: multiSelectSearchClass,
+			children: [/* @__PURE__ */ jsxs("svg", {
+				"aria-hidden": "true",
+				viewBox: "0 0 16 16",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: "1.75",
+				strokeLinecap: "round",
+				className: "size-4 flex-none text-muted-foreground",
+				children: [/* @__PURE__ */ jsx("circle", {
+					cx: "7",
+					cy: "7",
+					r: "4.5"
+				}), /* @__PURE__ */ jsx("path", { d: "m10.5 10.5 3 3" })]
+			}), /* @__PURE__ */ jsx(Input, {
+				placeholder: searchPlaceholder,
+				"data-slot": "multi-select-search-input",
+				className: "min-w-0 flex-1 appearance-none border-0 bg-transparent p-0 font-sans text-sm text-foreground outline-none placeholder:text-muted-foreground [&::-webkit-search-cancel-button]:hidden"
+			})]
+		}), /* @__PURE__ */ jsx(ListBox, {
+			"data-slot": "multi-select-list",
+			renderEmptyState: () => /* @__PURE__ */ jsx("p", {
+				"data-slot": "multi-select-empty",
+				className: "m-0 px-2 py-1.5 text-sm text-muted-foreground",
+				children: emptyLabel
+			}),
+			className: "min-h-0 flex-1 overflow-y-auto outline-none",
+			children
+		})]
+	});
+}
+/** The search row: a quiet field over the list, underlined while focused. */
+const multiSelectSearchClass = "relative mb-1 flex h-(--density-control-h-sm) flex-none items-center gap-2 border-b-(length:--border-width) border-border px-2 after:pointer-events-none after:absolute after:inset-x-0 after:bottom-0 after:h-(--focus-ring-width) after:bg-transparent has-[input:focus]:after:bg-(--color-control-edge)";
+/** The row that creates the typed value. Kept in the collection; the filter shows it. */
+function CreateItem({ label }) {
+	return /* @__PURE__ */ jsxs(ListBoxItem, {
+		id: CREATE_KEY,
+		textValue: label,
+		"data-slot": "multi-select-create",
+		className: cnAll(selectItemVariants(), "text-text-secondary data-[focused]:text-foreground"),
+		children: [/* @__PURE__ */ jsx("svg", {
+			"aria-hidden": "true",
+			viewBox: "0 0 16 16",
+			fill: "none",
+			stroke: "currentColor",
+			strokeWidth: "1.75",
+			strokeLinecap: "round",
+			className: "size-3.5 flex-none",
+			children: /* @__PURE__ */ jsx("path", { d: "M8 3.5v9M3.5 8h9" })
+		}), label]
+	});
+}
 /** The picked options as chips, then "+N", reading Select's own state. */
-function Chips({ placeholder, maxVisible }) {
+function Chips({ placeholder, maxVisible, moreLabel, moreRef }) {
 	const state = useContext(SelectStateContext);
 	const keys = state?.value ?? [];
 	const labelOf = (key) => state?.collection.getItem(key)?.textValue ?? String(key);
@@ -43,19 +128,50 @@ function Chips({ placeholder, maxVisible }) {
 				children: labelOf(key)
 			}, String(key))),
 			rest > 0 ? /* @__PURE__ */ jsxs("span", {
+				ref: moreRef,
 				"data-flip": "",
 				"data-slot": "multi-select-more",
 				className: "multi-select-chip text-text-secondary tabular-nums",
-				children: ["+", /* @__PURE__ */ jsx(SwapText, {
-					swapKey: String(rest),
-					dir: count.dir,
-					motion: "rise",
-					children: rest
-				})]
+				children: [
+					"+",
+					/* @__PURE__ */ jsx(SwapText, {
+						swapKey: String(rest),
+						dir: count.dir,
+						motion: "rise",
+						children: rest
+					}),
+					moreLabel ? /* @__PURE__ */ jsx("span", {
+						"data-slot": "multi-select-more-label",
+						className: "whitespace-pre",
+						children: ` ${moreLabel}`
+					}) : null
+				]
 			}) : null
 		]
 	});
 }
+/** The labels of the picks folded into "+N", in the order they were picked. */
+function useHiddenLabels(maxVisible) {
+	const state = useContext(SelectStateContext);
+	return (state?.value ?? []).slice(maxVisible).map((key) => state?.collection.getItem(key)?.textValue ?? String(key));
+}
+/**
+* Wraps the trigger in a tooltip naming the picks hidden behind "+N", placed
+* against the +N chip rather than the whole field. Always rendered, so turning
+* `overflowTooltip` on or off never swaps the trigger element (and drops its
+* focus); disabled while off or while nothing is hidden, so it never opens empty.
+*/
+function OverflowTooltip({ enabled, maxVisible, anchorRef, children }) {
+	const hidden = useHiddenLabels(maxVisible);
+	return /* @__PURE__ */ jsxs(TooltipTrigger$1, {
+		isDisabled: !enabled || hidden.length === 0,
+		children: [children, /* @__PURE__ */ jsx(Tooltip$1, {
+			triggerRef: anchorRef,
+			"data-slot": "multi-select-overflow-tooltip",
+			children: hidden.join(", ")
+		})]
+	});
+}
 /** Clears every pick. It sits outside the trigger, so it is its own tab stop. */
 function Clear({ label, disabled }) {
 	const state = useContext(SelectStateContext);
@@ -84,9 +200,65 @@ function Clear({ label, disabled }) {
 		})
 	});
 }
-const MultiSelect = forwardRef(function MultiSelect({ children, label, labelHidden, placeholder = "Select options", errorMessage, maxVisible = 2, clearLabel = "Clear selections", size = "md", className, ...props }, ref) {
+const MultiSelect = forwardRef(function MultiSelect({ children, label, labelHidden, placeholder = "Select options", errorMessage, maxVisible = 2, moreLabel, overflowTooltip = false, clearLabel = "Clear selections", size = "md", className, searchable = false, searchLabel = "Search options", searchPlaceholder = "Search", emptyLabel = "No options found", onCreate, createLabel = defaultCreateLabel, ...props }, ref) {
+	const moreRef = useRef(null);
+	const creatable = onCreate != null;
+	const withSearch = searchable || creatable;
+	const [query, setQuery] = useState("");
+	const [ownValue, setOwnValue] = useState(() => props.defaultValue ?? []);
+	const value = props.value ?? ownValue;
+	const creatableProps = creatable ? {
+		value,
+		defaultValue: void 0,
+		onChange: (keys) => {
+			let next = keys;
+			if (keys.includes(CREATE_KEY)) {
+				const text = query.trim();
+				next = keys.filter((key) => key !== CREATE_KEY);
+				if (text !== "" && !next.includes(text)) next.push(text);
+				setQuery("");
+				onCreate(text);
+			}
+			setOwnValue(next);
+			props.onChange?.(next);
+		}
+	} : {};
+	const trigger = /* @__PURE__ */ jsxs(Button, {
+		ref,
+		"data-slot": "multi-select-trigger",
+		className: cnAll(selectTriggerVariants({ size }), "pe-16 multi-select-trigger"),
+		children: [
+			/* @__PURE__ */ jsx(SelectValue, {
+				"data-slot": "multi-select-value",
+				className: "sr-only",
+				children: ({ isPlaceholder, selectedText }) => isPlaceholder ? placeholder : selectedText
+			}),
+			/* @__PURE__ */ jsx(Chips, {
+				placeholder,
+				maxVisible,
+				moreLabel,
+				moreRef
+			}),
+			/* @__PURE__ */ jsx("svg", {
+				"aria-hidden": "true",
+				viewBox: "0 0 16 16",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: "1.75",
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				className: "absolute end-(--density-control-pad-md) text-muted-foreground motion-safe:transition-[rotate] motion-safe:duration-(--duration-gentle) motion-safe:ease-gentle group-aria-expanded/trigger:rotate-180",
+				children: /* @__PURE__ */ jsx("path", { d: "m4 6 4 4 4-4" })
+			})
+		]
+	});
 	return /* @__PURE__ */ jsxs(Select, {
 		...props,
+		...creatableProps,
+		onOpenChange: (isOpen) => {
+			if (!isOpen) setQuery("");
+			props.onOpenChange?.(isOpen);
+		},
 		selectionMode: "multiple",
 		"data-slot": "multi-select",
 		className: cn(selectVariants(), className),
@@ -98,32 +270,11 @@ const MultiSelect = forwardRef(function MultiSelect({ children, label, labelHidd
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				className: "relative",
-				children: [/* @__PURE__ */ jsxs(Button, {
-					ref,
-					"data-slot": "multi-select-trigger",
-					className: cnAll(selectTriggerVariants({ size }), "pe-16 multi-select-trigger"),
-					children: [
-						/* @__PURE__ */ jsx(SelectValue, {
-							"data-slot": "multi-select-value",
-							className: "sr-only",
-							children: ({ isPlaceholder, selectedText }) => isPlaceholder ? placeholder : selectedText
-						}),
-						/* @__PURE__ */ jsx(Chips, {
-							placeholder,
-							maxVisible
-						}),
-						/* @__PURE__ */ jsx("svg", {
-							"aria-hidden": "true",
-							viewBox: "0 0 16 16",
-							fill: "none",
-							stroke: "currentColor",
-							strokeWidth: "1.75",
-							strokeLinecap: "round",
-							strokeLinejoin: "round",
-							className: "absolute end-(--density-control-pad-md) text-muted-foreground motion-safe:transition-[rotate] motion-safe:duration-(--duration-gentle) motion-safe:ease-gentle group-aria-expanded/trigger:rotate-180",
-							children: /* @__PURE__ */ jsx("path", { d: "m4 6 4 4 4-4" })
-						})
-					]
+				children: [/* @__PURE__ */ jsx(OverflowTooltip, {
+					enabled: overflowTooltip,
+					maxVisible,
+					anchorRef: moreRef,
+					children: trigger
 				}), /* @__PURE__ */ jsx(Clear, {
 					label: clearLabel,
 					disabled: props.isDisabled ?? false
@@ -136,8 +287,16 @@ const MultiSelect = forwardRef(function MultiSelect({ children, label, labelHidd
 			}),
 			/* @__PURE__ */ jsx(Popover, {
 				"data-slot": "multi-select-popover",
-				className: selectPopoverVariants(),
-				children: /* @__PURE__ */ jsx(ListBox, {
+				className: withSearch ? cnAll(selectPopoverVariants({ reveal: "fade" }), "flex flex-col overflow-y-hidden") : selectPopoverVariants(),
+				children: withSearch ? /* @__PURE__ */ jsxs(SearchList, {
+					query,
+					onQueryChange: setQuery,
+					creatable,
+					searchLabel,
+					searchPlaceholder,
+					emptyLabel,
+					children: [children, creatable ? /* @__PURE__ */ jsx(CreateItem, { label: createLabel(query.trim()) }) : null]
+				}) : /* @__PURE__ */ jsx(ListBox, {
 					"data-slot": "multi-select-list",
 					className: "outline-none",
 					children
@@ -146,7 +305,22 @@ const MultiSelect = forwardRef(function MultiSelect({ children, label, labelHidd
 		]
 	});
 });
+const multiSelectGroupVariants = cva(["flex flex-col not-first:mt-1"]);
+const multiSelectGroupHeaderVariants = cva(["px-2 pt-1.5 pb-1 text-xs leading-(--leading-normal) font-semibold text-muted-foreground"]);
+const MultiSelectGroup = forwardRef(function MultiSelectGroup({ title, children, id, className }, ref) {
+	return /* @__PURE__ */ jsxs(ListBoxSection, {
+		ref,
+		id,
+		"data-slot": "multi-select-group",
+		className: cn(multiSelectGroupVariants(), className),
+		children: [/* @__PURE__ */ jsx(Header, {
+			"data-slot": "multi-select-group-header",
+			className: multiSelectGroupHeaderVariants(),
+			children: title
+		}), children]
+	});
+});
 //#endregion
-export { MultiSelect };
+export { MultiSelect, MultiSelectGroup, multiSelectGroupHeaderVariants, multiSelectGroupVariants };
 
 //# sourceMappingURL=multi-select.js.map

package/dist/multi-select/multi-select.js.map

@@ -1 +1 @@
-{"version":3,"file":"multi-select.js","names":["AriaButton","AriaSelect","AriaLabel","AriaSelectValue","AriaFieldError","AriaPopover","AriaListBox"],"sources":["../../src/multi-select/multi-select.tsx"],"sourcesContent":["\"use client\";\n\nimport { forwardRef, useContext, useRef, useState, type ReactNode } from \"react\";\nimport {\n  Button as AriaButton,\n  ButtonContext,\n  FieldError as AriaFieldError,\n  Label as AriaLabel,\n  ListBox as AriaListBox,\n  Popover as AriaPopover,\n  Select as AriaSelect,\n  SelectStateContext,\n  SelectValue as AriaSelectValue,\n  type Key,\n  type SelectProps as AriaSelectProps,\n} from \"react-aria-components\";\n\nimport { labelVariants } from \"../label/label.js\";\nimport { cn, cnAll } from \"../lib/cn.js\";\nimport { useFlip } from \"../lib/flip.js\";\nimport { SwapText } from \"../lib/swap-text.js\";\nimport { selectPopoverVariants, selectTriggerVariants, selectVariants } from \"../select/select.js\";\n\n/**\n * MultiSelect: pick several options from a list. A Select in multiple mode\n * (React Aria), so the keyboard, typeahead, focus and screen-reader behaviour\n * are Select's own; the list stays open while picking.\n *\n * The trigger shows the first picks as chips and the rest as \"+N\". A new chip\n * fades up from a blur and grows in on the snappy spring while the chips beside\n * it glide over; the count rolls up or down as it changes. A clear button scales\n * in beside the chevron when anything is picked. Options are `SelectItem`s, whose\n * tick pops in as an option is picked.\n */\nexport interface MultiSelectProps extends Omit<\n  AriaSelectProps<object, \"multiple\">,\n  \"className\" | \"style\" | \"children\" | \"items\" | \"selectionMode\"\n> {\n  /** `SelectItem` children. */\n  children?: ReactNode;\n  /** What is being chosen, and the control's accessible name. */\n  label: ReactNode;\n  labelHidden?: boolean;\n  /** Shown while nothing is picked. @default \"Select options\" */\n  placeholder?: string;\n  /** Why the selection is wrong. Rendered under the control. */\n  errorMessage?: ReactNode;\n  /** Chips shown in the trigger before the rest become \"+N\". @default 2 */\n  maxVisible?: number;\n  /** Accessible name of the clear button. @default \"Clear selections\" */\n  clearLabel?: string;\n  /** @default \"md\" */\n  size?: \"sm\" | \"md\" | \"lg\";\n  /** Extra classes for the wrapper. Merged last. */\n  className?: string;\n}\n\n/** The picked options as chips, then \"+N\", reading Select's own state. */\nfunction Chips({ placeholder, maxVisible }: { placeholder: string; maxVisible: number }) {\n  const state = useContext(SelectStateContext);\n  const keys = (state?.value as Key[] | undefined) ?? [];\n  const labelOf = (key: Key) => state?.collection.getItem(key)?.textValue ?? String(key);\n  const shown = keys.slice(0, maxVisible);\n  const rest = keys.length - shown.length;\n  const row = useRef<HTMLSpanElement>(null);\n  // The chips beside a new or removed one glide to their new place.\n  useFlip(row, keys.join(\"|\"), \"var(--duration-smooth)\", \"var(--ease-smooth)\");\n  // Chips there at first paint never animate; later ones grow in.\n  const [initial] = useState(() => new Set(keys));\n  const [count, setCount] = useState({ rest, dir: 1 });\n  if (count.rest !== rest) setCount({ rest, dir: rest > count.rest ? 1 : -1 });\n  return (\n    <span\n      ref={row}\n      aria-hidden=\"true\"\n      className=\"relative flex min-h-6.5 min-w-0 flex-1 items-center gap-1.5 overflow-hidden\"\n    >\n      {keys.length === 0 ? (\n        <span\n          data-slot=\"multi-select-placeholder\"\n          className=\"truncate text-muted-foreground motion-safe:animate-fade-in\"\n        >\n          {placeholder}\n        </span>\n      ) : null}\n      {shown.map((key) => (\n        <span\n          key={String(key)}\n          data-flip=\"\"\n          data-slot=\"multi-select-chip\"\n          className={cnAll(\n            \"multi-select-chip\",\n            !initial.has(key) && \"motion-safe:animate-chip-reveal\",\n          )}\n        >\n          {labelOf(key)}\n        </span>\n      ))}\n      {rest > 0 ? (\n        <span\n          data-flip=\"\"\n          data-slot=\"multi-select-more\"\n          className=\"multi-select-chip text-text-secondary tabular-nums\"\n        >\n          +\n          <SwapText swapKey={String(rest)} dir={count.dir} motion=\"rise\">\n            {rest}\n          </SwapText>\n        </span>\n      ) : null}\n    </span>\n  );\n}\n\n/** Clears every pick. It sits outside the trigger, so it is its own tab stop. */\nfunction Clear({ label, disabled }: { label: string; disabled: boolean }) {\n  const state = useContext(SelectStateContext);\n  const keys = (state?.value as Key[] | undefined) ?? [];\n  if (!state || keys.length === 0 || disabled) return null;\n  // Select hands its trigger props to every Button inside it; clear that, or this\n  // button would become a second trigger named by the label.\n  return (\n    <ButtonContext.Provider value={null}>\n      <AriaButton\n        aria-label={label}\n        data-slot=\"multi-select-clear\"\n        onPress={() => {\n          state.setValue([]);\n          state.close();\n        }}\n        className=\"multi-select-clear motion-safe:animate-field-clear-in motion-reduce:animate-fade-in\"\n      >\n        <svg\n          aria-hidden=\"true\"\n          viewBox=\"0 0 16 16\"\n          fill=\"none\"\n          stroke=\"currentColor\"\n          strokeWidth=\"1.75\"\n          strokeLinecap=\"round\"\n          className=\"size-3.5\"\n        >\n          <path d=\"m4 4 8 8M12 4l-8 8\" />\n        </svg>\n      </AriaButton>\n    </ButtonContext.Provider>\n  );\n}\n\nexport const MultiSelect = forwardRef<HTMLButtonElement, MultiSelectProps>(function MultiSelect(\n  {\n    children,\n    label,\n    labelHidden,\n    placeholder = \"Select options\",\n    errorMessage,\n    maxVisible = 2,\n    clearLabel = \"Clear selections\",\n    size = \"md\",\n    className,\n    ...props\n  },\n  ref,\n) {\n  return (\n    <AriaSelect<object, \"multiple\">\n      {...props}\n      selectionMode=\"multiple\"\n      data-slot=\"multi-select\"\n      className={cn(selectVariants(), className)}\n    >\n      <AriaLabel\n        data-slot=\"multi-select-label\"\n        className={cnAll(labelVariants(), labelHidden && \"sr-only\")}\n      >\n        {label}\n      </AriaLabel>\n      <div className=\"relative\">\n        <AriaButton\n          ref={ref}\n          data-slot=\"multi-select-trigger\"\n          className={cnAll(selectTriggerVariants({ size }), \"pe-16 multi-select-trigger\")}\n        >\n          <AriaSelectValue data-slot=\"multi-select-value\" className=\"sr-only\">\n            {({ isPlaceholder, selectedText }) => (isPlaceholder ? placeholder : selectedText)}\n          </AriaSelectValue>\n          <Chips placeholder={placeholder} maxVisible={maxVisible} />\n          <svg\n            aria-hidden=\"true\"\n            viewBox=\"0 0 16 16\"\n            fill=\"none\"\n            stroke=\"currentColor\"\n            strokeWidth=\"1.75\"\n            strokeLinecap=\"round\"\n            strokeLinejoin=\"round\"\n            className=\"absolute end-(--density-control-pad-md) text-muted-foreground motion-safe:transition-[rotate] motion-safe:duration-(--duration-gentle) motion-safe:ease-gentle group-aria-expanded/trigger:rotate-180\"\n          >\n            <path d=\"m4 6 4 4 4-4\" />\n          </svg>\n        </AriaButton>\n        <Clear label={clearLabel} disabled={props.isDisabled ?? false} />\n      </div>\n      {errorMessage == null ? null : (\n        <AriaFieldError\n          data-slot=\"multi-select-error\"\n          className=\"text-sm leading-(--leading-normal) text-destructive-strong\"\n        >\n          {errorMessage}\n        </AriaFieldError>\n      )}\n      <AriaPopover data-slot=\"multi-select-popover\" className={selectPopoverVariants()}>\n        <AriaListBox data-slot=\"multi-select-list\" className=\"outline-none\">\n          {children}\n        </AriaListBox>\n      </AriaPopover>\n    </AriaSelect>\n  );\n});\n"],"mappings":"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"}
+{"version":3,"file":"multi-select.js","names":["AriaAutocomplete","AriaSearchField","AriaInput","AriaListBox","AriaListBoxItem","TooltipTrigger","Tooltip","AriaButton","AriaSelectValue","AriaSelect","AriaLabel","AriaFieldError","AriaPopover","AriaListBoxSection","AriaHeader"],"sources":["../../src/multi-select/multi-select.tsx"],"sourcesContent":["\"use client\";\n\nimport { cva } from \"class-variance-authority\";\nimport {\n  forwardRef,\n  useContext,\n  useRef,\n  useState,\n  type ContextType,\n  type ReactNode,\n  type RefObject,\n} from \"react\";\nimport {\n  Autocomplete as AriaAutocomplete,\n  Button as AriaButton,\n  ButtonContext,\n  FieldError as AriaFieldError,\n  Header as AriaHeader,\n  Input as AriaInput,\n  Label as AriaLabel,\n  ListBox as AriaListBox,\n  ListBoxItem as AriaListBoxItem,\n  ListBoxSection as AriaListBoxSection,\n  Popover as AriaPopover,\n  SearchField as AriaSearchField,\n  Select as AriaSelect,\n  SelectStateContext,\n  SelectValue as AriaSelectValue,\n  type Key,\n  type SelectProps as AriaSelectProps,\n  useFilter,\n} from \"react-aria-components\";\n\nimport { labelVariants } from \"../label/label.js\";\nimport { cn, cnAll } from \"../lib/cn.js\";\nimport { useFlip } from \"../lib/flip.js\";\nimport { SwapText } from \"../lib/swap-text.js\";\nimport {\n  selectItemVariants,\n  selectPopoverVariants,\n  selectTriggerVariants,\n  selectVariants,\n} from \"../select/select.js\";\nimport { Tooltip, TooltipTrigger } from \"../tooltip/tooltip.js\";\n\n/**\n * MultiSelect: pick several options from a list. A Select in multiple mode\n * (React Aria), so the keyboard, typeahead, focus and screen-reader behaviour\n * are Select's own; the list stays open while picking.\n *\n * The trigger shows the first picks as chips and the rest as \"+N\". A new chip\n * fades up from a blur and grows in on the snappy spring while the chips beside\n * it glide over; the count rolls up or down as it changes. A clear button scales\n * in beside the chevron when anything is picked. Options are `SelectItem`s, whose\n * tick pops in as an option is picked; `MultiSelectGroup` gathers them under a\n * heading.\n *\n * Opt in to `searchable` for a search field at the top of the list that filters\n * the options as you type (React Aria's Autocomplete, so the arrow keys and Enter\n * work from the field). Pass `onCreate` to also offer a \"Create “…”\" row when the\n * typed text matches no option.\n */\nexport interface MultiSelectProps extends Omit<\n  AriaSelectProps<object, \"multiple\">,\n  \"className\" | \"style\" | \"children\" | \"items\" | \"selectionMode\"\n> {\n  /** `SelectItem` children. */\n  children?: ReactNode;\n  /** What is being chosen, and the control's accessible name. */\n  label: ReactNode;\n  labelHidden?: boolean;\n  /** Shown while nothing is picked. @default \"Select options\" */\n  placeholder?: string;\n  /** Why the selection is wrong. Rendered under the control. */\n  errorMessage?: ReactNode;\n  /** Chips shown in the trigger before the rest become \"+N\". @default 2 */\n  maxVisible?: number;\n  /**\n   * Words after the overflow count, so `\"more\"` reads \"+2 more\". Off by default:\n   * the count alone, \"+2\".\n   */\n  moreLabel?: string;\n  /**\n   * While some picks are folded into \"+N\", hovering or focusing the trigger shows\n   * a tooltip listing them. Off by default.\n   *\n   * @default false\n   */\n  overflowTooltip?: boolean;\n  /** Accessible name of the clear button. @default \"Clear selections\" */\n  clearLabel?: string;\n  /** @default \"md\" */\n  size?: \"sm\" | \"md\" | \"lg\";\n  /** Extra classes for the wrapper. Merged last. */\n  className?: string;\n  /**\n   * Puts a search field at the top of the list. Typing filters the options (and\n   * groups) by their text, ignoring case and accents; the arrow keys and Enter\n   * work from the field. Cleared each time the list closes. Off by default.\n   * Turned on by `onCreate` too.\n   *\n   * @default false\n   */\n  searchable?: boolean;\n  /** Accessible name of the search field. @default \"Search options\" */\n  searchLabel?: string;\n  /** Placeholder of the search field. @default \"Search\" */\n  searchPlaceholder?: string;\n  /** Shown in the list while the search matches nothing. @default \"No options found\" */\n  emptyLabel?: string;\n  /**\n   * Makes the list creatable, and searchable. While the typed text (trimmed)\n   * matches no option's text or id nor a picked value, ignoring case, the list ends\n   * with a \"Create “text”\" row. Picking it calls `onCreate` with the text, adds\n   * the text itself as a picked key (through `onChange`, as any pick) and clears\n   * the search. Render a `SelectItem` whose `id` is that text so it lists like\n   * the others; until then its chip shows the text.\n   */\n  onCreate?: (value: string) => void;\n  /** The create row's text for the typed value. @default (value) => `Create “${value}”` */\n  createLabel?: (value: string) => string;\n}\n\n/** The key of the create row. Never reaches `onChange`. */\nconst CREATE_KEY = \"__multi-select-create__\";\n\nconst defaultCreateLabel = (value: string) => `Create \\u201c${value}\\u201d`;\n\ntype SelectState = NonNullable<ContextType<typeof SelectStateContext>>;\n\n/** Whether `text` already names an option (by its text or its key) or a pick, ignoring case. */\nfunction isTaken(state: SelectState | null, text: string) {\n  const want = text.toLocaleLowerCase();\n  const keys = (state?.value as Key[] | undefined) ?? [];\n  if (keys.some((key) => String(key).toLocaleLowerCase() === want)) return true;\n  if (!state) return false;\n  for (const key of state.collection.getKeys()) {\n    const node = state.collection.getItem(key);\n    if (\n      node?.type === \"item\" &&\n      node.key !== CREATE_KEY &&\n      // The key too: creating text equal to an unpicked option's id would pick\n      // that option AND tell the owner to create a duplicate.\n      (node.textValue.toLocaleLowerCase() === want || String(node.key).toLocaleLowerCase() === want)\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * The list with a search field over it (React Aria's Autocomplete): the field\n * keeps focus and drives the options with the arrow keys, Enter picks.\n */\nfunction SearchList({\n  query,\n  onQueryChange,\n  creatable,\n  searchLabel,\n  searchPlaceholder,\n  emptyLabel,\n  children,\n}: {\n  query: string;\n  onQueryChange: (query: string) => void;\n  creatable: boolean;\n  searchLabel: string;\n  searchPlaceholder: string;\n  emptyLabel: string;\n  children: ReactNode;\n}) {\n  const state = useContext(SelectStateContext);\n  const { contains } = useFilter({ sensitivity: \"base\" });\n  const text = query.trim();\n  const offerCreate = creatable && text !== \"\" && !isTaken(state, text);\n  return (\n    <AriaAutocomplete\n      inputValue={query}\n      onInputChange={onQueryChange}\n      filter={(textValue, input, node) =>\n        node.key === CREATE_KEY ? offerCreate : contains(textValue, input)\n      }\n    >\n      <AriaSearchField\n        aria-label={searchLabel}\n        autoFocus\n        data-slot=\"multi-select-search\"\n        className={multiSelectSearchClass}\n      >\n        <svg\n          aria-hidden=\"true\"\n          viewBox=\"0 0 16 16\"\n          fill=\"none\"\n          stroke=\"currentColor\"\n          strokeWidth=\"1.75\"\n          strokeLinecap=\"round\"\n          className=\"size-4 flex-none text-muted-foreground\"\n        >\n          <circle cx=\"7\" cy=\"7\" r=\"4.5\" />\n          <path d=\"m10.5 10.5 3 3\" />\n        </svg>\n        <AriaInput\n          placeholder={searchPlaceholder}\n          data-slot=\"multi-select-search-input\"\n          className=\"min-w-0 flex-1 appearance-none border-0 bg-transparent p-0 font-sans text-sm text-foreground outline-none placeholder:text-muted-foreground [&::-webkit-search-cancel-button]:hidden\"\n        />\n      </AriaSearchField>\n      <AriaListBox\n        data-slot=\"multi-select-list\"\n        renderEmptyState={() => (\n          <p\n            data-slot=\"multi-select-empty\"\n            className=\"m-0 px-2 py-1.5 text-sm text-muted-foreground\"\n          >\n            {emptyLabel}\n          </p>\n        )}\n        className=\"min-h-0 flex-1 overflow-y-auto outline-none\"\n      >\n        {children}\n      </AriaListBox>\n    </AriaAutocomplete>\n  );\n}\n\n/** The search row: a quiet field over the list, underlined while focused. */\nconst multiSelectSearchClass =\n  \"relative mb-1 flex h-(--density-control-h-sm) flex-none items-center gap-2 border-b-(length:--border-width) border-border px-2 after:pointer-events-none after:absolute after:inset-x-0 after:bottom-0 after:h-(--focus-ring-width) after:bg-transparent has-[input:focus]:after:bg-(--color-control-edge)\";\n\n/** The row that creates the typed value. Kept in the collection; the filter shows it. */\nfunction CreateItem({ label }: { label: string }) {\n  return (\n    <AriaListBoxItem\n      id={CREATE_KEY}\n      textValue={label}\n      data-slot=\"multi-select-create\"\n      className={cnAll(selectItemVariants(), \"text-text-secondary data-[focused]:text-foreground\")}\n    >\n      <svg\n        aria-hidden=\"true\"\n        viewBox=\"0 0 16 16\"\n        fill=\"none\"\n        stroke=\"currentColor\"\n        strokeWidth=\"1.75\"\n        strokeLinecap=\"round\"\n        className=\"size-3.5 flex-none\"\n      >\n        <path d=\"M8 3.5v9M3.5 8h9\" />\n      </svg>\n      {label}\n    </AriaListBoxItem>\n  );\n}\n\n/** The picked options as chips, then \"+N\", reading Select's own state. */\nfunction Chips({\n  placeholder,\n  maxVisible,\n  moreLabel,\n  moreRef,\n}: {\n  placeholder: string;\n  maxVisible: number;\n  moreLabel: string | undefined;\n  moreRef: RefObject<HTMLSpanElement | null>;\n}) {\n  const state = useContext(SelectStateContext);\n  const keys = (state?.value as Key[] | undefined) ?? [];\n  const labelOf = (key: Key) => state?.collection.getItem(key)?.textValue ?? String(key);\n  const shown = keys.slice(0, maxVisible);\n  const rest = keys.length - shown.length;\n  const row = useRef<HTMLSpanElement>(null);\n  // The chips beside a new or removed one glide to their new place.\n  useFlip(row, keys.join(\"|\"), \"var(--duration-smooth)\", \"var(--ease-smooth)\");\n  // Chips there at first paint never animate; later ones grow in.\n  const [initial] = useState(() => new Set(keys));\n  const [count, setCount] = useState({ rest, dir: 1 });\n  if (count.rest !== rest) setCount({ rest, dir: rest > count.rest ? 1 : -1 });\n  return (\n    <span\n      ref={row}\n      aria-hidden=\"true\"\n      className=\"relative flex min-h-6.5 min-w-0 flex-1 items-center gap-1.5 overflow-hidden\"\n    >\n      {keys.length === 0 ? (\n        <span\n          data-slot=\"multi-select-placeholder\"\n          className=\"truncate text-muted-foreground motion-safe:animate-fade-in\"\n        >\n          {placeholder}\n        </span>\n      ) : null}\n      {shown.map((key) => (\n        <span\n          key={String(key)}\n          data-flip=\"\"\n          data-slot=\"multi-select-chip\"\n          className={cnAll(\n            \"multi-select-chip\",\n            !initial.has(key) && \"motion-safe:animate-chip-reveal\",\n          )}\n        >\n          {labelOf(key)}\n        </span>\n      ))}\n      {rest > 0 ? (\n        <span\n          ref={moreRef}\n          data-flip=\"\"\n          data-slot=\"multi-select-more\"\n          className=\"multi-select-chip text-text-secondary tabular-nums\"\n        >\n          +\n          <SwapText swapKey={String(rest)} dir={count.dir} motion=\"rise\">\n            {rest}\n          </SwapText>\n          {/* The chip is a flex box, which drops a leading space in a bare text\n              node; whitespace-pre keeps \"+2 more\" from reading \"+2more\". */}\n          {moreLabel ? (\n            <span data-slot=\"multi-select-more-label\" className=\"whitespace-pre\">\n              {` ${moreLabel}`}\n            </span>\n          ) : null}\n        </span>\n      ) : null}\n    </span>\n  );\n}\n\n/** The labels of the picks folded into \"+N\", in the order they were picked. */\nfunction useHiddenLabels(maxVisible: number) {\n  const state = useContext(SelectStateContext);\n  const keys = (state?.value as Key[] | undefined) ?? [];\n  return keys\n    .slice(maxVisible)\n    .map((key) => state?.collection.getItem(key)?.textValue ?? String(key));\n}\n\n/**\n * Wraps the trigger in a tooltip naming the picks hidden behind \"+N\", placed\n * against the +N chip rather than the whole field. Always rendered, so turning\n * `overflowTooltip` on or off never swaps the trigger element (and drops its\n * focus); disabled while off or while nothing is hidden, so it never opens empty.\n */\nfunction OverflowTooltip({\n  enabled,\n  maxVisible,\n  anchorRef,\n  children,\n}: {\n  enabled: boolean;\n  maxVisible: number;\n  anchorRef: RefObject<HTMLSpanElement | null>;\n  children: ReactNode;\n}) {\n  const hidden = useHiddenLabels(maxVisible);\n  return (\n    <TooltipTrigger isDisabled={!enabled || hidden.length === 0}>\n      {children}\n      <Tooltip triggerRef={anchorRef} data-slot=\"multi-select-overflow-tooltip\">\n        {hidden.join(\", \")}\n      </Tooltip>\n    </TooltipTrigger>\n  );\n}\n\n/** Clears every pick. It sits outside the trigger, so it is its own tab stop. */\nfunction Clear({ label, disabled }: { label: string; disabled: boolean }) {\n  const state = useContext(SelectStateContext);\n  const keys = (state?.value as Key[] | undefined) ?? [];\n  if (!state || keys.length === 0 || disabled) return null;\n  // Select hands its trigger props to every Button inside it; clear that, or this\n  // button would become a second trigger named by the label.\n  return (\n    <ButtonContext.Provider value={null}>\n      <AriaButton\n        aria-label={label}\n        data-slot=\"multi-select-clear\"\n        onPress={() => {\n          state.setValue([]);\n          state.close();\n        }}\n        className=\"multi-select-clear motion-safe:animate-field-clear-in motion-reduce:animate-fade-in\"\n      >\n        <svg\n          aria-hidden=\"true\"\n          viewBox=\"0 0 16 16\"\n          fill=\"none\"\n          stroke=\"currentColor\"\n          strokeWidth=\"1.75\"\n          strokeLinecap=\"round\"\n          className=\"size-3.5\"\n        >\n          <path d=\"m4 4 8 8M12 4l-8 8\" />\n        </svg>\n      </AriaButton>\n    </ButtonContext.Provider>\n  );\n}\n\nexport const MultiSelect = forwardRef<HTMLButtonElement, MultiSelectProps>(function MultiSelect(\n  {\n    children,\n    label,\n    labelHidden,\n    placeholder = \"Select options\",\n    errorMessage,\n    maxVisible = 2,\n    moreLabel,\n    overflowTooltip = false,\n    clearLabel = \"Clear selections\",\n    size = \"md\",\n    className,\n    searchable = false,\n    searchLabel = \"Search options\",\n    searchPlaceholder = \"Search\",\n    emptyLabel = \"No options found\",\n    onCreate,\n    createLabel = defaultCreateLabel,\n    ...props\n  },\n  ref,\n) {\n  const moreRef = useRef<HTMLSpanElement>(null);\n  const creatable = onCreate != null;\n  const withSearch = searchable || creatable;\n  const [query, setQuery] = useState(\"\");\n  // Creating adds a key no option has yet, so the value is held here: the create\n  // row's own key is swapped for the typed text before anyone sees it.\n  const [ownValue, setOwnValue] = useState<readonly Key[]>(() => props.defaultValue ?? []);\n  const value = props.value ?? ownValue;\n  const creatableProps: Partial<AriaSelectProps<object, \"multiple\">> = creatable\n    ? {\n        value,\n        defaultValue: undefined,\n        onChange: (keys) => {\n          let next = keys;\n          if (keys.includes(CREATE_KEY)) {\n            const text = query.trim();\n            next = keys.filter((key) => key !== CREATE_KEY);\n            if (text !== \"\" && !next.includes(text)) next.push(text);\n            setQuery(\"\");\n            onCreate(text);\n          }\n          setOwnValue(next);\n          props.onChange?.(next);\n        },\n      }\n    : {};\n  const trigger = (\n    <AriaButton\n      ref={ref}\n      data-slot=\"multi-select-trigger\"\n      className={cnAll(selectTriggerVariants({ size }), \"pe-16 multi-select-trigger\")}\n    >\n      <AriaSelectValue data-slot=\"multi-select-value\" className=\"sr-only\">\n        {({ isPlaceholder, selectedText }) => (isPlaceholder ? placeholder : selectedText)}\n      </AriaSelectValue>\n      <Chips\n        placeholder={placeholder}\n        maxVisible={maxVisible}\n        moreLabel={moreLabel}\n        moreRef={moreRef}\n      />\n      <svg\n        aria-hidden=\"true\"\n        viewBox=\"0 0 16 16\"\n        fill=\"none\"\n        stroke=\"currentColor\"\n        strokeWidth=\"1.75\"\n        strokeLinecap=\"round\"\n        strokeLinejoin=\"round\"\n        className=\"absolute end-(--density-control-pad-md) text-muted-foreground motion-safe:transition-[rotate] motion-safe:duration-(--duration-gentle) motion-safe:ease-gentle group-aria-expanded/trigger:rotate-180\"\n      >\n        <path d=\"m4 6 4 4 4-4\" />\n      </svg>\n    </AriaButton>\n  );\n  return (\n    <AriaSelect<object, \"multiple\">\n      {...props}\n      {...creatableProps}\n      onOpenChange={(isOpen) => {\n        // Each opening starts from the whole list.\n        if (!isOpen) setQuery(\"\");\n        props.onOpenChange?.(isOpen);\n      }}\n      selectionMode=\"multiple\"\n      data-slot=\"multi-select\"\n      className={cn(selectVariants(), className)}\n    >\n      <AriaLabel\n        data-slot=\"multi-select-label\"\n        className={cnAll(labelVariants(), labelHidden && \"sr-only\")}\n      >\n        {label}\n      </AriaLabel>\n      <div className=\"relative\">\n        <OverflowTooltip enabled={overflowTooltip} maxVisible={maxVisible} anchorRef={moreRef}>\n          {trigger}\n        </OverflowTooltip>\n        <Clear label={clearLabel} disabled={props.isDisabled ?? false} />\n      </div>\n      {errorMessage == null ? null : (\n        <AriaFieldError\n          data-slot=\"multi-select-error\"\n          className=\"text-sm leading-(--leading-normal) text-destructive-strong\"\n        >\n          {errorMessage}\n        </AriaFieldError>\n      )}\n      <AriaPopover\n        data-slot=\"multi-select-popover\"\n        className={\n          withSearch\n            ? cnAll(selectPopoverVariants({ reveal: \"fade\" }), \"flex flex-col overflow-y-hidden\")\n            : selectPopoverVariants()\n        }\n      >\n        {withSearch ? (\n          <SearchList\n            query={query}\n            onQueryChange={setQuery}\n            creatable={creatable}\n            searchLabel={searchLabel}\n            searchPlaceholder={searchPlaceholder}\n            emptyLabel={emptyLabel}\n          >\n            {children}\n            {creatable ? <CreateItem label={createLabel(query.trim())} /> : null}\n          </SearchList>\n        ) : (\n          <AriaListBox data-slot=\"multi-select-list\" className=\"outline-none\">\n            {children}\n          </AriaListBox>\n        )}\n      </AriaPopover>\n    </AriaSelect>\n  );\n});\n\nexport const multiSelectGroupVariants = cva([\"flex flex-col not-first:mt-1\"]);\n\nexport const multiSelectGroupHeaderVariants = cva([\n  \"px-2 pt-1.5 pb-1 text-xs leading-(--leading-normal) font-semibold text-muted-foreground\",\n]);\n\n/**\n * A run of options under a heading, such as \"Countries\" and \"Regions\". React\n * Aria's ListBoxSection, so the heading names the group for assistive tech and\n * the arrow keys move straight through from one group to the next.\n *\n * @example\n * <MultiSelect label=\"Markets\">\n *   <MultiSelectGroup title=\"Countries\">\n *     <SelectItem id=\"IN\">India</SelectItem>\n *   </MultiSelectGroup>\n *   <MultiSelectGroup title=\"Regions\">\n *     <SelectItem id=\"europe\">Europe</SelectItem>\n *   </MultiSelectGroup>\n * </MultiSelect>\n */\nexport interface MultiSelectGroupProps {\n  /** The heading drawn above the group, and the group's accessible name. */\n  title: ReactNode;\n  /** `SelectItem` children. */\n  children?: ReactNode;\n  /** Identifies the group in the collection. Defaults to a generated id. */\n  id?: Key;\n  /** Extra classes for the group. Merged last. */\n  className?: string;\n}\n\nexport const MultiSelectGroup = forwardRef<HTMLElement, MultiSelectGroupProps>(\n  function MultiSelectGroup({ title, children, id, className }, ref) {\n    return (\n      <AriaListBoxSection\n        ref={ref}\n        id={id}\n        data-slot=\"multi-select-group\"\n        className={cn(multiSelectGroupVariants(), className)}\n      >\n        <AriaHeader\n          data-slot=\"multi-select-group-header\"\n          className={multiSelectGroupHeaderVariants()}\n        >\n          {title}\n        </AriaHeader>\n        {children}\n      </AriaListBoxSection>\n    );\n  },\n);\n"],"mappings":"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"}

package/dist/password-field/password-field.d.ts

@@ -17,6 +17,21 @@ export interface PasswordFieldProps extends Omit<InputProps, "className" | "styl
    * after mount and changed words rise in. Nothing animates on first render.
    */
   description?: string;
+  /**
+   * Error text under the field. Sets `aria-invalid`, so the box takes its
+   * invalid border, and is announced as an alert when it appears. Opens and
+   * closes like `description`; an empty or `undefined` value closes the row.
+   * The same prop as Input's. Inside a React Aria `TextField` (which supplies
+   * the label and description) the error row is still rendered, after the
+   * control, and named in the input's `aria-describedby`.
+   */
+  error?: string;
+  /**
+   * The field must be filled: the input is `required` (announced by screen
+   * readers, and checked by native form validation) and the label shows the
+   * required marker.
+   */
+  isRequired?: boolean;
   /** Translated or reworded toggle names. */
   messages?: Partial<PasswordFieldMessages>;
 }
@@ -31,6 +46,7 @@ export interface PasswordFieldProps extends Omit<InputProps, "className" | "styl
  *
  * @example
  * <PasswordField label="Password" description="At least eight characters." />
+ * <PasswordField label="API secret" isRequired error={errors.secret?.message} {...register("secret")} />
  */
 export declare const PasswordField: import("react").ForwardRefExoticComponent<PasswordFieldProps & import("react").RefAttributes<HTMLInputElement>>;
 //#endregion

package/dist/password-field/password-field.js

@@ -1,11 +1,12 @@
 "use client";
 import { cn } from "../lib/cn.js";
 import { fieldSurfaceVariants } from "../lib/field-surface.js";
+import { FieldMessage } from "../lib/field-message.js";
 import { FieldShell, useFieldWiring } from "../lib/field-shell.js";
 import { EyeMorph } from "../lib/eye-morph.js";
-import { forwardRef, useState } from "react";
-import { Button, Group, Input } from "react-aria-components";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { forwardRef, useId, useState } from "react";
+import { Button, Group, Input, InputContext, useSlottedContext } from "react-aria-components";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 //#region src/password-field/password-field.tsx
 const defaultPasswordFieldMessages = {
 	showPassword: "Show password",
@@ -37,8 +38,9 @@ const toggleClass = "field-toggle-button grid size-7.5 flex-none cursor-pointer
 *
 * @example
 * <PasswordField label="Password" description="At least eight characters." />
+* <PasswordField label="API secret" isRequired error={errors.secret?.message} {...register("secret")} />
 */
-const PasswordField = forwardRef(function PasswordField({ label, description, messages: messagesProp, className, ...props }, ref) {
+const PasswordField = forwardRef(function PasswordField({ label, description, error, isRequired, messages: messagesProp, className, ...props }, ref) {
 	const messages = {
 		...defaultPasswordFieldMessages,
 		...messagesProp
@@ -51,20 +53,35 @@ const PasswordField = forwardRef(function PasswordField({ label, description, me
 		describedBy: props["aria-describedby"],
 		invalid: props["aria-invalid"],
 		description,
-		error: void 0
+		error
 	});
+	const inputContext = useSlottedContext(InputContext);
+	const generatedId = useId();
+	const insideErrorId = field.inside && error ? `${generatedId}-error` : void 0;
+	const [errorRow, setErrorRow] = useState(Boolean(insideErrorId));
+	if (insideErrorId && !errorRow) setErrorRow(true);
+	const insideProps = insideErrorId ? {
+		"aria-invalid": true,
+		"aria-describedby": [
+			inputContext?.["aria-describedby"],
+			props["aria-describedby"],
+			insideErrorId
+		].filter(Boolean).join(" ")
+	} : {};
 	const disabled = Boolean(props.disabled);
 	const ariaInvalid = props["aria-invalid"];
 	const control = /* @__PURE__ */ jsxs(Group, {
 		role: "presentation",
 		isDisabled: disabled,
-		isInvalid: ariaInvalid !== void 0 && ariaInvalid !== false && ariaInvalid !== "false",
+		isInvalid: Boolean(error) || ariaInvalid !== void 0 && ariaInvalid !== false && ariaInvalid !== "false",
 		"data-slot": "password-field-shell",
 		className: shellClass,
 		children: [/* @__PURE__ */ jsx(Input, {
 			ref,
 			...props,
+			...isRequired ? { required: true } : {},
 			...field.controlProps,
+			...insideProps,
 			type: visible ? "text" : "password",
 			"data-slot": "password-field",
 			"data-reveal": toggled ? visible ? "shown" : "hidden" : void 0,
@@ -82,14 +99,26 @@ const PasswordField = forwardRef(function PasswordField({ label, description, me
 			children: /* @__PURE__ */ jsx(EyeMorph, { slashed: visible })
 		})]
 	});
+	if (field.inside) return /* @__PURE__ */ jsxs(Fragment$1, { children: [control, errorRow ? /* @__PURE__ */ jsx("div", {
+		"data-slot": "password-field-error-row",
+		className: "grid min-w-0 font-sans",
+		children: /* @__PURE__ */ jsx(FieldMessage, {
+			id: insideErrorId,
+			text: error,
+			tone: "error",
+			wordExit: "sharp",
+			numbers: false
+		})
+	}) : null] });
 	if (!field.active) return control;
 	return /* @__PURE__ */ jsx(FieldShell, {
 		label,
 		controlId: field.controlId,
 		description,
 		hintId: field.hintId,
-		error: void 0,
-		errorId: void 0,
+		error,
+		errorId: field.errorId,
+		required: isRequired,
 		wordExit: "sharp",
 		numbers: false,
 		children: control

package/dist/password-field/password-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"password-field.js","names":["AriaGroup","AriaInput","AriaButton"],"sources":["../../src/password-field/password-field.tsx"],"sourcesContent":["\"use client\";\n\nimport { forwardRef, useState } from \"react\";\nimport {\n  Button as AriaButton,\n  Group as AriaGroup,\n  Input as AriaInput,\n  type InputProps as AriaInputProps,\n} from \"react-aria-components\";\n\nimport { cn } from \"../lib/cn.js\";\nimport { EyeMorph } from \"../lib/eye-morph.js\";\nimport { FieldShell, useFieldWiring } from \"../lib/field-shell.js\";\nimport { fieldSurfaceVariants } from \"../lib/field-surface.js\";\n\n/** The toggle's accessible names. Both have English defaults; pass the ones you translate. */\nexport interface PasswordFieldMessages {\n  showPassword: string;\n  hidePassword: string;\n}\n\nexport const defaultPasswordFieldMessages: PasswordFieldMessages = {\n  showPassword: \"Show password\",\n  hidePassword: \"Hide password\",\n};\n\n/**\n * The field's box. A React Aria `Group` rather than the input, because the\n * toggle sits inside the same border: it carries the shared field surface (the\n * 160ms border transition, the darker border on hover and focus, the muted\n * disabled look, the invalid border) and the input inside is borderless.\n *\n * `data-focus-within` darkens the border too. A Group reports focus-visible\n * from the input modality, so a mouse click into the input, or onto the toggle,\n * would otherwise leave the border pale; a plain Input is different because\n * React Aria treats a text input as always keyboard-focused.\n */\nconst shellClass = cn(\n  fieldSurfaceVariants(),\n  \"flex items-center h-(--density-control-h-md) ps-(--density-control-pad-md) field-toggle-shell [&:where([data-focus-within])]:border-border-strong\",\n);\n\n/** The input inside the box: no border, no fill, no outline of its own. */\nconst inputClass =\n  \"min-w-0 flex-1 border-0 bg-transparent p-0 font-sans text-base text-foreground outline-none placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground data-[disabled]:cursor-not-allowed motion-safe:data-[reveal=shown]:animate-field-reveal-shown motion-safe:data-[reveal=hidden]:animate-field-reveal-hidden\";\n\nconst toggleClass =\n  \"field-toggle-button grid size-7.5 flex-none cursor-pointer place-items-center rounded-control border-0 bg-transparent p-0 text-muted-foreground outline-none data-[hovered]:bg-muted data-[hovered]:text-foreground aria-pressed:text-foreground data-[focus-visible]:outline-solid data-[focus-visible]:outline-(length:--focus-ring-width) data-[focus-visible]:outline-offset-(--focus-ring-offset) data-[focus-visible]:outline-(--color-ring) data-[disabled]:cursor-not-allowed\";\n\nexport interface PasswordFieldProps extends Omit<\n  AriaInputProps,\n  \"className\" | \"style\" | \"size\" | \"type\"\n> {\n  /** Extra classes for the input. Merged last, so they win conflicts with ours. */\n  className?: string;\n  /** The visible label, tied to the input with `htmlFor`. */\n  label: string;\n  /**\n   * Helper text under the field, named by `aria-describedby`. A string, because\n   * the copy is animated word by word: it opens on a spring when it appears\n   * after mount and changed words rise in. Nothing animates on first render.\n   */\n  description?: string;\n  /** Translated or reworded toggle names. */\n  messages?: Partial<PasswordFieldMessages>;\n}\n\n/**\n * A password input with a show and hide toggle. Switching resolves the text in\n * place from a soft blur, and the eye is one outline that a slash draws across.\n * Native input props apply to the input; `disabled` also disables the toggle,\n * and `aria-invalid` gives the box its invalid border.\n *\n * The toggle's name changes with the state and it is also `aria-pressed`, so a\n * screen reader may announce both (\"Hide password, pressed\").\n *\n * @example\n * <PasswordField label=\"Password\" description=\"At least eight characters.\" />\n */\nexport const PasswordField = forwardRef<HTMLInputElement, PasswordFieldProps>(\n  function PasswordField({ label, description, messages: messagesProp, className, ...props }, ref) {\n    const messages = { ...defaultPasswordFieldMessages, ...messagesProp };\n    const [visible, setVisible] = useState(false);\n    // data-reveal only appears after the first toggle, so the animation runs on each change but never on mount.\n    const [toggled, setToggled] = useState(false);\n    const field = useFieldWiring({\n      enabled: true,\n      id: props.id,\n      describedBy: props[\"aria-describedby\"],\n      invalid: props[\"aria-invalid\"],\n      description,\n      error: undefined,\n    });\n    const disabled = Boolean(props.disabled);\n    const ariaInvalid = props[\"aria-invalid\"];\n    const invalid = ariaInvalid !== undefined && ariaInvalid !== false && ariaInvalid !== \"false\";\n\n    const control = (\n      <AriaGroup\n        role=\"presentation\"\n        isDisabled={disabled}\n        isInvalid={invalid}\n        data-slot=\"password-field-shell\"\n        className={shellClass}\n      >\n        <AriaInput\n          ref={ref}\n          {...props}\n          {...field.controlProps}\n          type={visible ? \"text\" : \"password\"}\n          data-slot=\"password-field\"\n          data-reveal={toggled ? (visible ? \"shown\" : \"hidden\") : undefined}\n          className={cn(inputClass, className)}\n        />\n        <AriaButton\n          type=\"button\"\n          isDisabled={disabled}\n          aria-label={visible ? messages.hidePassword : messages.showPassword}\n          aria-pressed={visible}\n          onPress={() => {\n            setVisible((current) => !current);\n            setToggled(true);\n          }}\n          className={toggleClass}\n        >\n          <EyeMorph slashed={visible} />\n        </AriaButton>\n      </AriaGroup>\n    );\n\n    if (!field.active) return control;\n    return (\n      <FieldShell\n        label={label}\n        controlId={field.controlId}\n        description={description}\n        hintId={field.hintId}\n        error={undefined}\n        errorId={undefined}\n        wordExit=\"sharp\"\n        numbers={false}\n      >\n        {control}\n      </FieldShell>\n    );\n  },\n);\n"],"mappings":";;;;;;;;;AAqBA,MAAa,+BAAsD;CACjE,cAAc;CACd,cAAc;AAChB;;;;;;;;;;;;AAaA,MAAM,aAAa,GACjB,qBAAqB,GACrB,mJACF;;AAGA,MAAM,aACJ;AAEF,MAAM,cACJ;;;;;;;;;;;;;AAgCF,MAAa,gBAAgB,WAC3B,SAAS,cAAc,EAAE,OAAO,aAAa,UAAU,cAAc,WAAW,GAAG,SAAS,KAAK;CAC/F,MAAM,WAAW;EAAE,GAAG;EAA8B,GAAG;CAAa;CACpE,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAE5C,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,QAAQ,eAAe;EAC3B,SAAS;EACT,IAAI,MAAM;EACV,aAAa,MAAM;EACnB,SAAS,MAAM;EACf;EACA,OAAO,KAAA;CACT,CAAC;CACD,MAAM,WAAW,QAAQ,MAAM,QAAQ;CACvC,MAAM,cAAc,MAAM;CAG1B,MAAM,UACJ,qBAACA,OAAD;EACE,MAAK;EACL,YAAY;EACZ,WANY,gBAAgB,KAAA,KAAa,gBAAgB,SAAS,gBAAgB;EAOlF,aAAU;EACV,WAAW;EALb,UAAA,CAOE,oBAACC,OAAD;GACO;GACL,GAAI;GACJ,GAAI,MAAM;GACV,MAAM,UAAU,SAAS;GACzB,aAAU;GACV,eAAa,UAAW,UAAU,UAAU,WAAY,KAAA;GACxD,WAAW,GAAG,YAAY,SAAS;EACpC,CAAA,GACD,oBAACC,QAAD;GACE,MAAK;GACL,YAAY;GACZ,cAAY,UAAU,SAAS,eAAe,SAAS;GACvD,gBAAc;GACd,eAAe;IACb,YAAY,YAAY,CAAC,OAAO;IAChC,WAAW,IAAI;GACjB;GACA,WAAW;GAEX,UAAA,oBAAC,UAAD,EAAU,SAAS,QAAU,CAAA;EACnB,CAAA,CACH;;CAGb,IAAI,CAAC,MAAM,QAAQ,OAAO;CAC1B,OACE,oBAAC,YAAD;EACS;EACP,WAAW,MAAM;EACJ;EACb,QAAQ,MAAM;EACd,OAAO,KAAA;EACP,SAAS,KAAA;EACT,UAAS;EACT,SAAS;EAER,UAAA;CACS,CAAA;AAEhB,CACF"}
+{"version":3,"file":"password-field.js","names":["AriaGroup","AriaInput","AriaButton"],"sources":["../../src/password-field/password-field.tsx"],"sourcesContent":["\"use client\";\n\nimport { forwardRef, useId, useState } from \"react\";\nimport {\n  Button as AriaButton,\n  Group as AriaGroup,\n  Input as AriaInput,\n  InputContext,\n  useSlottedContext,\n  type InputProps as AriaInputProps,\n} from \"react-aria-components\";\n\nimport { cn } from \"../lib/cn.js\";\nimport { EyeMorph } from \"../lib/eye-morph.js\";\nimport { FieldMessage } from \"../lib/field-message.js\";\nimport { FieldShell, useFieldWiring } from \"../lib/field-shell.js\";\nimport { fieldSurfaceVariants } from \"../lib/field-surface.js\";\n\n/** The toggle's accessible names. Both have English defaults; pass the ones you translate. */\nexport interface PasswordFieldMessages {\n  showPassword: string;\n  hidePassword: string;\n}\n\nexport const defaultPasswordFieldMessages: PasswordFieldMessages = {\n  showPassword: \"Show password\",\n  hidePassword: \"Hide password\",\n};\n\n/**\n * The field's box. A React Aria `Group` rather than the input, because the\n * toggle sits inside the same border: it carries the shared field surface (the\n * 160ms border transition, the darker border on hover and focus, the muted\n * disabled look, the invalid border) and the input inside is borderless.\n *\n * `data-focus-within` darkens the border too. A Group reports focus-visible\n * from the input modality, so a mouse click into the input, or onto the toggle,\n * would otherwise leave the border pale; a plain Input is different because\n * React Aria treats a text input as always keyboard-focused.\n */\nconst shellClass = cn(\n  fieldSurfaceVariants(),\n  \"flex items-center h-(--density-control-h-md) ps-(--density-control-pad-md) field-toggle-shell [&:where([data-focus-within])]:border-border-strong\",\n);\n\n/** The input inside the box: no border, no fill, no outline of its own. */\nconst inputClass =\n  \"min-w-0 flex-1 border-0 bg-transparent p-0 font-sans text-base text-foreground outline-none placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground data-[disabled]:cursor-not-allowed motion-safe:data-[reveal=shown]:animate-field-reveal-shown motion-safe:data-[reveal=hidden]:animate-field-reveal-hidden\";\n\nconst toggleClass =\n  \"field-toggle-button grid size-7.5 flex-none cursor-pointer place-items-center rounded-control border-0 bg-transparent p-0 text-muted-foreground outline-none data-[hovered]:bg-muted data-[hovered]:text-foreground aria-pressed:text-foreground data-[focus-visible]:outline-solid data-[focus-visible]:outline-(length:--focus-ring-width) data-[focus-visible]:outline-offset-(--focus-ring-offset) data-[focus-visible]:outline-(--color-ring) data-[disabled]:cursor-not-allowed\";\n\nexport interface PasswordFieldProps extends Omit<\n  AriaInputProps,\n  \"className\" | \"style\" | \"size\" | \"type\"\n> {\n  /** Extra classes for the input. Merged last, so they win conflicts with ours. */\n  className?: string;\n  /** The visible label, tied to the input with `htmlFor`. */\n  label: string;\n  /**\n   * Helper text under the field, named by `aria-describedby`. A string, because\n   * the copy is animated word by word: it opens on a spring when it appears\n   * after mount and changed words rise in. Nothing animates on first render.\n   */\n  description?: string;\n  /**\n   * Error text under the field. Sets `aria-invalid`, so the box takes its\n   * invalid border, and is announced as an alert when it appears. Opens and\n   * closes like `description`; an empty or `undefined` value closes the row.\n   * The same prop as Input's. Inside a React Aria `TextField` (which supplies\n   * the label and description) the error row is still rendered, after the\n   * control, and named in the input's `aria-describedby`.\n   */\n  error?: string;\n  /**\n   * The field must be filled: the input is `required` (announced by screen\n   * readers, and checked by native form validation) and the label shows the\n   * required marker.\n   */\n  isRequired?: boolean;\n  /** Translated or reworded toggle names. */\n  messages?: Partial<PasswordFieldMessages>;\n}\n\n/**\n * A password input with a show and hide toggle. Switching resolves the text in\n * place from a soft blur, and the eye is one outline that a slash draws across.\n * Native input props apply to the input; `disabled` also disables the toggle,\n * and `aria-invalid` gives the box its invalid border.\n *\n * The toggle's name changes with the state and it is also `aria-pressed`, so a\n * screen reader may announce both (\"Hide password, pressed\").\n *\n * @example\n * <PasswordField label=\"Password\" description=\"At least eight characters.\" />\n * <PasswordField label=\"API secret\" isRequired error={errors.secret?.message} {...register(\"secret\")} />\n */\nexport const PasswordField = forwardRef<HTMLInputElement, PasswordFieldProps>(\n  function PasswordField(\n    { label, description, error, isRequired, messages: messagesProp, className, ...props },\n    ref,\n  ) {\n    const messages = { ...defaultPasswordFieldMessages, ...messagesProp };\n    const [visible, setVisible] = useState(false);\n    // data-reveal only appears after the first toggle, so the animation runs on each change but never on mount.\n    const [toggled, setToggled] = useState(false);\n    const field = useFieldWiring({\n      enabled: true,\n      id: props.id,\n      describedBy: props[\"aria-describedby\"],\n      invalid: props[\"aria-invalid\"],\n      description,\n      error,\n    });\n    // Inside a React Aria TextField the shell (and its error row) is skipped, since the\n    // field supplies the label and description. The error is ours, not the field's,\n    // so it is rendered after the control here and added to the input's\n    // aria-describedby, after the field's own ids (an explicit prop replaces the\n    // context's, so they are carried over). Without this the box turned red with no text.\n    const inputContext = useSlottedContext(InputContext) as {\n      \"aria-describedby\"?: string;\n    } | null;\n    const generatedId = useId();\n    const insideErrorId = field.inside && error ? `${generatedId}-error` : undefined;\n    // The row's wrapper (it carries the font the shell would) is added the first time an\n    // error arrives and then kept, so the row can animate closed; without one, nothing is added.\n    const [errorRow, setErrorRow] = useState(Boolean(insideErrorId));\n    if (insideErrorId && !errorRow) setErrorRow(true);\n    const insideProps = insideErrorId\n      ? {\n          \"aria-invalid\": true,\n          \"aria-describedby\": [\n            inputContext?.[\"aria-describedby\"],\n            props[\"aria-describedby\"],\n            insideErrorId,\n          ]\n            .filter(Boolean)\n            .join(\" \"),\n        }\n      : {};\n    const disabled = Boolean(props.disabled);\n    const ariaInvalid = props[\"aria-invalid\"];\n    const invalid =\n      Boolean(error) ||\n      (ariaInvalid !== undefined && ariaInvalid !== false && ariaInvalid !== \"false\");\n\n    const control = (\n      <AriaGroup\n        role=\"presentation\"\n        isDisabled={disabled}\n        isInvalid={invalid}\n        data-slot=\"password-field-shell\"\n        className={shellClass}\n      >\n        <AriaInput\n          ref={ref}\n          {...props}\n          {...(isRequired ? { required: true } : {})}\n          {...field.controlProps}\n          {...insideProps}\n          type={visible ? \"text\" : \"password\"}\n          data-slot=\"password-field\"\n          data-reveal={toggled ? (visible ? \"shown\" : \"hidden\") : undefined}\n          className={cn(inputClass, className)}\n        />\n        <AriaButton\n          type=\"button\"\n          isDisabled={disabled}\n          aria-label={visible ? messages.hidePassword : messages.showPassword}\n          aria-pressed={visible}\n          onPress={() => {\n            setVisible((current) => !current);\n            setToggled(true);\n          }}\n          className={toggleClass}\n        >\n          <EyeMorph slashed={visible} />\n        </AriaButton>\n      </AriaGroup>\n    );\n\n    if (field.inside) {\n      // Always this shape inside a field, so an error arriving later does not remount the input.\n      return (\n        <>\n          {control}\n          {errorRow ? (\n            <div data-slot=\"password-field-error-row\" className=\"grid min-w-0 font-sans\">\n              <FieldMessage\n                id={insideErrorId}\n                text={error}\n                tone=\"error\"\n                wordExit=\"sharp\"\n                numbers={false}\n              />\n            </div>\n          ) : null}\n        </>\n      );\n    }\n    if (!field.active) return control;\n    return (\n      <FieldShell\n        label={label}\n        controlId={field.controlId}\n        description={description}\n        hintId={field.hintId}\n        error={error}\n        errorId={field.errorId}\n        required={isRequired}\n        wordExit=\"sharp\"\n        numbers={false}\n      >\n        {control}\n      </FieldShell>\n    );\n  },\n);\n"],"mappings":";;;;;;;;;;AAwBA,MAAa,+BAAsD;CACjE,cAAc;CACd,cAAc;AAChB;;;;;;;;;;;;AAaA,MAAM,aAAa,GACjB,qBAAqB,GACrB,mJACF;;AAGA,MAAM,aACJ;AAEF,MAAM,cACJ;;;;;;;;;;;;;;AAgDF,MAAa,gBAAgB,WAC3B,SAAS,cACP,EAAE,OAAO,aAAa,OAAO,YAAY,UAAU,cAAc,WAAW,GAAG,SAC/E,KACA;CACA,MAAM,WAAW;EAAE,GAAG;EAA8B,GAAG;CAAa;CACpE,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAE5C,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,QAAQ,eAAe;EAC3B,SAAS;EACT,IAAI,MAAM;EACV,aAAa,MAAM;EACnB,SAAS,MAAM;EACf;EACA;CACF,CAAC;CAMD,MAAM,eAAe,kBAAkB,YAAY;CAGnD,MAAM,cAAc,MAAM;CAC1B,MAAM,gBAAgB,MAAM,UAAU,QAAQ,GAAG,YAAY,UAAU,KAAA;CAGvE,MAAM,CAAC,UAAU,eAAe,SAAS,QAAQ,aAAa,CAAC;CAC/D,IAAI,iBAAiB,CAAC,UAAU,YAAY,IAAI;CAChD,MAAM,cAAc,gBAChB;EACE,gBAAgB;EAChB,oBAAoB;GAClB,eAAe;GACf,MAAM;GACN;EACF,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;CACb,IACA,CAAC;CACL,MAAM,WAAW,QAAQ,MAAM,QAAQ;CACvC,MAAM,cAAc,MAAM;CAK1B,MAAM,UACJ,qBAACA,OAAD;EACE,MAAK;EACL,YAAY;EACZ,WAPF,QAAQ,KAAK,KACZ,gBAAgB,KAAA,KAAa,gBAAgB,SAAS,gBAAgB;EAOrE,aAAU;EACV,WAAW;EALb,UAAA,CAOE,oBAACC,OAAD;GACO;GACL,GAAI;GACJ,GAAK,aAAa,EAAE,UAAU,KAAK,IAAI,CAAC;GACxC,GAAI,MAAM;GACV,GAAI;GACJ,MAAM,UAAU,SAAS;GACzB,aAAU;GACV,eAAa,UAAW,UAAU,UAAU,WAAY,KAAA;GACxD,WAAW,GAAG,YAAY,SAAS;EACpC,CAAA,GACD,oBAACC,QAAD;GACE,MAAK;GACL,YAAY;GACZ,cAAY,UAAU,SAAS,eAAe,SAAS;GACvD,gBAAc;GACd,eAAe;IACb,YAAY,YAAY,CAAC,OAAO;IAChC,WAAW,IAAI;GACjB;GACA,WAAW;GAEX,UAAA,oBAAC,UAAD,EAAU,SAAS,QAAU,CAAA;EACnB,CAAA,CACH;;CAGb,IAAI,MAAM,QAER,OACE,qBAAA,YAAA,EAAA,UAAA,CACG,SACA,WACC,oBAAC,OAAD;EAAK,aAAU;EAA2B,WAAU;EAClD,UAAA,oBAAC,cAAD;GACE,IAAI;GACJ,MAAM;GACN,MAAK;GACL,UAAS;GACT,SAAS;EACV,CAAA;CACE,CAAA,IACH,IACJ,EAAA,CAAA;CAGN,IAAI,CAAC,MAAM,QAAQ,OAAO;CAC1B,OACE,oBAAC,YAAD;EACS;EACP,WAAW,MAAM;EACJ;EACb,QAAQ,MAAM;EACP;EACP,SAAS,MAAM;EACf,UAAU;EACV,UAAS;EACT,SAAS;EAER,UAAA;CACS,CAAA;AAEhB,CACF"}

package/dist/popover/index.d.ts

@@ -1,2 +1,2 @@
-import { Popover, PopoverProps, PopoverTrigger, popoverVariants } from "./popover.js";
-export { Popover, type PopoverProps, PopoverTrigger, popoverVariants };
+import { Popover, PopoverHoverTrigger, PopoverHoverTriggerProps, PopoverProps, PopoverTrigger, popoverVariants } from "./popover.js";
+export { Popover, PopoverHoverTrigger, type PopoverHoverTriggerProps, type PopoverProps, PopoverTrigger, popoverVariants };

package/dist/popover/index.js

@@ -1,2 +1,2 @@
-import { Popover, PopoverTrigger, popoverVariants } from "./popover.js";
-export { Popover, PopoverTrigger, popoverVariants };
+import { Popover, PopoverHoverTrigger, PopoverTrigger, popoverVariants } from "./popover.js";
+export { Popover, PopoverHoverTrigger, PopoverTrigger, popoverVariants };

package/dist/popover/popover.d.ts

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { DialogTrigger as PopoverTrigger, PopoverProps } from "react-aria-components";
+import { JSX, ReactNode } from "react";
+import { DialogTrigger as PopoverTrigger, PopoverProps, PreviewTriggerProps } from "react-aria-components";
 //#region src/popover/popover.d.ts
 /**
  * Popover, ported from the legacy shadcn/Radix component.
@@ -65,6 +65,43 @@ interface PopoverProps$1 extends Omit<PopoverProps, "className" | "style" | "chi
   onAction?: () => void;
 }
 declare const Popover$1: import("react").ForwardRefExoticComponent<PopoverProps$1 & import("react").RefAttributes<HTMLElement>>;
+export interface PopoverHoverTriggerProps extends Omit<PreviewTriggerProps, "delay" | "closeDelay"> {
+  /** The trigger, then the `Popover`. The trigger must be focusable (a `Button` or `Link`). */
+  children: ReactNode;
+  /**
+   * Milliseconds the pointer rests on the trigger, or keyboard focus sits on
+   * it, before the card opens.
+   * @default 600
+   */
+  delay?: number;
+  /**
+   * Milliseconds after the pointer leaves the trigger and the card, or focus
+   * leaves both, before it closes. Moving onto the card keeps it open.
+   * @default 200
+   */
+  closeDelay?: number;
+}
+/**
+ * Opens a popover on hover instead of press: a hover card.
+ *
+ * React Aria's `PreviewTrigger`. The card opens after `delay` when the pointer
+ * rests on the trigger or keyboard focus reaches it, and on a long press on
+ * touch. It stays open while the pointer travels onto it (a safe area covers
+ * the gap) and closes `closeDelay` after the pointer or focus leaves both.
+ * Escape closes it; Tab from the trigger moves into it. It is non-modal: no
+ * focus trap and no underlay, and the page behind stays usable.
+ *
+ * The trigger keeps its own press action, so a Link still navigates and a
+ * Button still runs `onPress`. Content anyone needs must not live only in the
+ * card: touch without a long press never sees it.
+ *
+ * @example
+ * <PopoverHoverTrigger delay={300}>
+ *   <Button variant="ghost" aria-label="3 more sources">+3</Button>
+ *   <Popover placement="bottom start">...</Popover>
+ * </PopoverHoverTrigger>
+ */
+export declare function PopoverHoverTrigger({ delay, closeDelay, ...props }: PopoverHoverTriggerProps): JSX.Element;
 //#endregion
 export { Popover$1 as Popover, PopoverProps$1 as PopoverProps, PopoverTrigger };
 //# sourceMappingURL=popover.d.ts.map