@seekalfred/primitives 0.5.0 → 0.6.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-field.js","names":["AriaButton","AriaGroup","AriaInput"],"sources":["../../src/search-field/search-field.tsx"],"sourcesContent":["\"use client\";\n\nimport { forwardRef, useCallback, useMemo, useRef, 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 { FieldShell, useFieldWiring } from \"../lib/field-shell.js\";\nimport { fieldSurfaceVariants } from \"../lib/field-surface.js\";\nimport { mergeRefs } from \"../lib/merge-refs.js\";\nimport { prefersReducedMotion, useExitBackstop, useIsomorphicLayoutEffect } from \"../lib/motion.js\";\n\n/**\n * The field's box: a React Aria `Group` carrying the shared field surface (see\n * PasswordField for why a Group, and why `data-focus-within` darkens the border\n * as well). `group/shell` lets the glass read the box's focus and filled state.\n */\nconst shellClass = cn(\n  fieldSurfaceVariants(),\n  \"group/shell flex items-center gap-(--density-control-gap) h-(--density-control-h-md) px-(--density-control-pad-md) [&:where([data-focus-within])]:border-foreground\",\n);\n\n/** Borderless, fill-less input; the browser's own clear button and search decoration are hidden because the field has its own. */\nconst inputClass =\n  \"min-w-0 flex-1 appearance-none 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 [&::-webkit-search-cancel-button]:hidden [&::-webkit-search-decoration]:hidden\";\n\nconst clearClass =\n  \"motion-safe:button-motion grid size-6 cursor-pointer place-items-center rounded-md border-0 bg-transparent p-0 text-muted-foreground outline-none data-[hovered]:bg-muted data-[hovered]:text-foreground motion-safe:data-[pressed]:scale-96 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\n/** The glass wakes up with the field: muted at rest, full contrast while the field has focus or a value. */\nfunction SearchGlyph() {\n  return (\n    <svg\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth={2}\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      aria-hidden=\"true\"\n      className=\"size-4.5 flex-none text-muted-foreground motion-safe:transition-colors motion-safe:duration-(--duration-quick) motion-safe:ease-settle group-data-[filled]/shell:text-foreground group-data-[focus-within]/shell:text-foreground\"\n    >\n      <circle cx=\"11\" cy=\"11\" r=\"8\" />\n      <path d=\"m21 21-4.34-4.34\" />\n    </svg>\n  );\n}\n\n/**\n * The clear button, in a box that is always there so the field never changes\n * width. It scales in on the snappy spring while it fades and unblurs, and\n * leaves a little smaller. Nothing animates if it is there on first mount, and\n * while it leaves it is inert so it cannot be pressed or focused.\n */\nfunction ClearButton({\n  show,\n  label,\n  disabled,\n  onClear,\n}: {\n  show: boolean;\n  label: string;\n  disabled: boolean;\n  onClear: () => void;\n}) {\n  const [initial] = useState(show);\n  const [rendered, setRendered] = useState(show);\n  const [animated, setAnimated] = useState(false);\n  const leaving = rendered && !show;\n  if (show && !rendered) setRendered(true);\n  if (!animated && show !== initial) setAnimated(true);\n  const unmount = useCallback(() => setRendered(false), []);\n  useExitBackstop(leaving, unmount);\n  // Reduced motion removes it at once: an animation that is switched off never ends.\n  useIsomorphicLayoutEffect(() => {\n    if (leaving && prefersReducedMotion()) unmount();\n  }, [leaving, unmount]);\n  if (!rendered) return null;\n  return (\n    <span\n      ref={(node) => {\n        if (!node) return;\n        if (leaving) node.setAttribute(\"inert\", \"\");\n        else node.removeAttribute(\"inert\");\n      }}\n      aria-hidden={leaving || undefined}\n      onAnimationEnd={(event) => {\n        if (\n          leaving &&\n          event.target === event.currentTarget &&\n          event.animationName === \"field-clear-out\"\n        )\n          unmount();\n      }}\n      className={cn(\n        \"grid size-6 place-items-center\",\n        leaving\n          ? \"pointer-events-none motion-safe:animate-field-clear-out\"\n          : animated && \"motion-safe:animate-field-clear-in motion-reduce:animate-fade-in\",\n      )}\n    >\n      <AriaButton\n        type=\"button\"\n        isDisabled={disabled}\n        aria-label={label}\n        onPress={onClear}\n        className={clearClass}\n      >\n        <svg\n          viewBox=\"0 0 24 24\"\n          fill=\"none\"\n          stroke=\"currentColor\"\n          strokeWidth={2}\n          strokeLinecap=\"round\"\n          strokeLinejoin=\"round\"\n          aria-hidden=\"true\"\n          className=\"size-4\"\n        >\n          <path d=\"M18 6 6 18\" />\n          <path d=\"m6 6 12 12\" />\n        </svg>\n      </AriaButton>\n    </span>\n  );\n}\n\nexport interface SearchFieldProps extends Omit<\n  AriaInputProps,\n  \"className\" | \"style\" | \"size\" | \"type\" | \"value\" | \"defaultValue\" | \"onChange\"\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  /** The current text. Controlled: the field has no state of its own. */\n  value: string;\n  /** Called with the new text on every edit, and with `\"\"` when the clear button is pressed. */\n  onValueChange: (value: string) => void;\n  /** The clear button's accessible name. @default \"Clear search\" */\n  clearLabel?: string;\n}\n\n/**\n * A search input with a clear button. The button has a reserved box, so the\n * field never changes width as it comes and goes; pressing it clears the text\n * and returns focus to the input. `onChange` is not accepted: use `onValueChange`.\n * Native input props apply to the input, and `disabled` also disables the button.\n *\n * @example\n * <SearchField label=\"Search contacts\" value={query} onValueChange={setQuery} />\n */\nexport const SearchField = forwardRef<HTMLInputElement, SearchFieldProps>(function SearchField(\n  { label, value, onValueChange, clearLabel = \"Clear search\", className, ...props },\n  ref,\n) {\n  const inputRef = useRef<HTMLInputElement | null>(null);\n  const refs = useMemo(() => mergeRefs(ref, inputRef), [ref]);\n  const field = useFieldWiring({\n    enabled: true,\n    id: props.id,\n    describedBy: props[\"aria-describedby\"],\n    invalid: props[\"aria-invalid\"],\n    description: undefined,\n    error: undefined,\n  });\n  const disabled = Boolean(props.disabled);\n\n  const control = (\n    <AriaGroup\n      role=\"presentation\"\n      isDisabled={disabled}\n      data-filled={value ? \"true\" : undefined}\n      data-slot=\"search-field-shell\"\n      className={shellClass}\n    >\n      <SearchGlyph />\n      <AriaInput\n        ref={refs}\n        {...props}\n        {...field.controlProps}\n        type=\"search\"\n        value={value}\n        onChange={(event) => onValueChange(event.target.value)}\n        data-slot=\"search-field\"\n        className={cn(inputClass, className)}\n      />\n      {/* A clear button's box is reserved, so the field never changes width when it appears or leaves. */}\n      <span className=\"grid size-6 flex-none place-items-center\">\n        <ClearButton\n          show={value !== \"\"}\n          label={clearLabel}\n          disabled={disabled}\n          onClear={() => {\n            onValueChange(\"\");\n            inputRef.current?.focus();\n          }}\n        />\n      </span>\n    </AriaGroup>\n  );\n\n  if (!field.active) return control;\n  return (\n    <FieldShell\n      label={label}\n      controlId={field.controlId}\n      description={undefined}\n      hintId={undefined}\n      error={undefined}\n      errorId={undefined}\n    >\n      {control}\n    </FieldShell>\n  );\n});\n"],"mappings":"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"}

package/dist/select/select.d.ts

@@ -1,5 +1,5 @@
-import { ListBoxItemProps, SelectProps } from "react-aria-components";
 import { ReactNode } from "react";
+import { ListBoxItemProps, SelectProps } from "react-aria-components";
 //#region src/select/select.d.ts
 /**
  * Select, ported from the legacy shadcn/Radix component.
@@ -80,7 +80,7 @@ interface SelectProps$1 extends Omit<SelectProps<object>, "className" | "style"
   /** Extra classes for the wrapper. Merged last. */
   className?: string;
 }
-declare function Select$1({ children, label, labelHidden, placeholder, errorMessage, size, className, ...props }: SelectProps$1): import("react").JSX.Element;
+declare const Select$1: import("react").ForwardRefExoticComponent<SelectProps$1 & import("react").RefAttributes<HTMLButtonElement>>;
 /**
  * One option. Its `id` is the value.
  *
@@ -99,7 +99,7 @@ export interface SelectItemProps extends Omit<ListBoxItemProps, "className" | "s
   /** Extra classes. Merged last, so they win conflicts with ours. */
   className?: string;
 }
-export declare function SelectItem({ className, children, textValue, ...props }: SelectItemProps): import("react").JSX.Element;
+export declare const SelectItem: import("react").ForwardRefExoticComponent<SelectItemProps & import("react").RefAttributes<HTMLDivElement>>;
 //#endregion
 export { Select$1 as Select, SelectProps$1 as SelectProps };
 //# sourceMappingURL=select.d.ts.map

package/dist/select/select.js

@@ -1,9 +1,13 @@
 "use client";
 import { cn, cnAll } from "../lib/cn.js";
+import { useIsomorphicLayoutEffect } from "../lib/motion.js";
 import { fieldSurfaceVariants } from "../lib/field-surface.js";
+import { labelVariants } from "../label/label.js";
+import { RollingValue } from "../lib/rolling-value.js";
 import { cva } from "class-variance-authority";
-import { Button, FieldError, Label, ListBox, ListBoxItem, Popover, Select, SelectValue } from "react-aria-components";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { forwardRef, useContext, useState } from "react";
+import { Button, FieldError, Label, ListBox, ListBoxItem, Popover, Select, SelectStateContext, SelectValue } from "react-aria-components";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 //#region src/select/select.tsx
 /**
 * Select, ported from the legacy shadcn/Radix component.
@@ -33,8 +37,12 @@ const selectVariants = cva(["group flex w-full flex-col gap-1.5 box-border font-
 const selectTriggerVariants = cva([
 	"group-data-[invalid]:border-destructive-strong",
 	fieldSurfaceVariants(),
+	"[&:where([data-pressed])]:border-foreground",
+	"data-[hovered]:not-data-[disabled]:bg-muted",
+	"data-[pressed]:bg-muted",
+	"group/trigger",
 	"flex items-center justify-between gap-2 text-start",
-	"text-base leading-(--leading-normal) cursor-pointer",
+	"leading-(--leading-normal) cursor-pointer",
 	"[&_svg]:pointer-events-none [&_svg]:shrink-0",
 	"[&_svg:not([class*='size-'])]:size-(--icon-sm)"
 ], {
@@ -46,18 +54,28 @@ const selectTriggerVariants = cva([
 	* axis without giving it here would be exactly the drift
 	* `fieldSurfaceVariants` exists to prevent.
 	*
-	* Type stays `text-base` at every rung, matching Input. A row whose two
-	* controls disagree about type size reads as a mistake.
+	* Type matches Input's at every rung: 14px on `sm` (16px on a touch
+	* screen), 16px on `md` and `lg`. A row whose two controls disagree
+	* about type size reads as a mistake. The trigger is a button, so iOS
+	* would not zoom on it; the coarse-pointer rule is there to keep it
+	* equal to the field beside it.
 	*/
 size: {
-		sm: "h-(--density-control-h-sm) px-(--density-control-pad-sm)",
-		md: "h-(--density-control-h-md) px-(--density-control-pad-md)",
-		lg: "h-(--density-control-h-lg) px-(--density-control-pad-lg)"
+		sm: "h-(--density-control-h-sm) px-(--density-control-pad-sm) text-sm pointer-coarse:text-base",
+		md: "h-(--density-control-h-md) px-(--density-control-pad-md) text-base",
+		lg: "h-(--density-control-h-lg) px-(--density-control-pad-lg) text-base"
 	} },
 	defaultVariants: { size: "md" }
 });
 const selectPopoverVariants = cva([
 	"w-(--trigger-width) min-w-32 overflow-y-auto",
+	"[--menu-x:0px] [--menu-y:-6px] origin-top",
+	"data-[placement=top]:[--menu-y:6px] data-[placement=top]:origin-bottom",
+	"data-[placement=left]:[--menu-x:6px] data-[placement=left]:[--menu-y:0px] data-[placement=left]:origin-right",
+	"data-[placement=right]:[--menu-x:-6px] data-[placement=right]:[--menu-y:0px] data-[placement=right]:origin-left",
+	"motion-safe:data-[entering]:animate-select-popover-in motion-reduce:data-[entering]:animate-select-fade-in",
+	"motion-safe:data-[exiting]:animate-select-popover-out motion-reduce:data-[exiting]:animate-select-fade-out",
+	"data-[exiting]:pointer-events-none",
 	"rounded-md border-(length:--border-width) border-border p-1",
 	"bg-card text-card-foreground shadow-floating",
 	"box-border font-sans text-sm leading-(--leading-normal)"
@@ -67,13 +85,61 @@ const selectItemVariants = cva([
 	"rounded-2xs py-1.5 pe-2 ps-8",
 	"box-border text-sm leading-(--leading-normal) text-card-foreground",
 	"outline-none data-[focused]:bg-muted",
+	"motion-safe:transition-colors motion-safe:duration-(--duration-instant) motion-safe:ease-settle",
 	"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 data-[disabled]:opacity-(--opacity-disabled)"
 ]);
-function Select$1({ children, label, labelHidden, placeholder, errorMessage, size = "md", className, ...props }) {
+/**
+* The shown value. React Aria's own `SelectValue` stays, visually hidden, as the
+* text a screen reader reads; the copy the eye sees rolls when the selection
+* changes: a later option rises from below, an earlier one drops from above. The
+* direction is read from the option's place in the list. A pre-selected value
+* does not animate on first mount.
+*/
+function ValueRoll({ placeholder }) {
+	const state = useContext(SelectStateContext);
+	const key = state?.selectedKey ?? null;
+	let index = -1;
+	if (state && key != null) {
+		let n = 0;
+		for (const item of state.collection) {
+			if (item.type !== "item") continue;
+			if (item.key === key) index = n;
+			n += 1;
+		}
+	}
+	const [previous, setPrevious] = useState(index);
+	const [dir, setDir] = useState(1);
+	if (previous !== index) {
+		setPrevious(index);
+		setDir(index > previous ? 1 : -1);
+	}
+	const text = state?.selectedItem?.textValue ?? "";
+	const built = (state?.collection.size ?? 0) > 0 || state?.selectedKey != null;
+	const [mounted, setMounted] = useState(false);
+	useIsomorphicLayoutEffect(() => setMounted(true), []);
+	const settled = built || mounted;
+	const swapKey = key == null ? "placeholder" : `value-${String(key)}`;
+	return /* @__PURE__ */ jsx(RollingValue, {
+		srValue: /* @__PURE__ */ jsx(SelectValue, {
+			"data-slot": "select-value",
+			className: "sr-only",
+			children: ({ isPlaceholder, selectedText }) => isPlaceholder ? placeholder : selectedText
+		}),
+		swapKey,
+		dir,
+		instanceKey: settled ? "live" : "boot",
+		children: key == null ? /* @__PURE__ */ jsx("span", {
+			"data-slot": "select-placeholder",
+			className: "text-muted-foreground",
+			children: placeholder
+		}) : text
+	});
+}
+const Select$1 = forwardRef(function Select$2({ children, label, labelHidden, placeholder, errorMessage, size = "md", className, ...props }, ref) {
 	return /* @__PURE__ */ jsxs(Select, {
 		...props,
 		"data-slot": "select",
@@ -81,20 +147,14 @@ function Select$1({ children, label, labelHidden, placeholder, errorMessage, siz
 		children: [
 			/* @__PURE__ */ jsx(Label, {
 				"data-slot": "select-label",
-				className: cnAll("text-sm leading-(--leading-normal) text-foreground", labelHidden && "sr-only"),
+				className: cnAll(labelVariants(), labelHidden && "sr-only"),
 				children: label
 			}),
 			/* @__PURE__ */ jsxs(Button, {
+				ref,
 				"data-slot": "select-trigger",
 				className: selectTriggerVariants({ size }),
-				children: [/* @__PURE__ */ jsx(SelectValue, {
-					"data-slot": "select-value",
-					children: ({ isPlaceholder, selectedText }) => isPlaceholder ? /* @__PURE__ */ jsx("span", {
-						"data-slot": "select-placeholder",
-						className: "text-muted-foreground",
-						children: placeholder
-					}) : selectedText
-				}), /* @__PURE__ */ jsx("svg", {
+				children: [/* @__PURE__ */ jsx(ValueRoll, { placeholder }), /* @__PURE__ */ jsx("svg", {
 					"aria-hidden": "true",
 					viewBox: "0 0 16 16",
 					fill: "none",
@@ -102,7 +162,7 @@ function Select$1({ children, label, labelHidden, placeholder, errorMessage, siz
 					strokeWidth: "1.75",
 					strokeLinecap: "round",
 					strokeLinejoin: "round",
-					className: "text-muted-foreground",
+					className: "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" })
 				})]
 			}),
@@ -122,14 +182,15 @@ function Select$1({ children, label, labelHidden, placeholder, errorMessage, siz
 			})
 		]
 	});
-}
-function SelectItem({ className, children, textValue, ...props }) {
+});
+const SelectItem = forwardRef(function SelectItem({ className, children, textValue, ...props }, ref) {
 	return /* @__PURE__ */ jsx(ListBoxItem, {
+		ref,
 		...props,
 		textValue: textValue ?? (typeof children === "string" ? children : void 0),
 		"data-slot": "select-item",
 		className: cn(selectItemVariants(), className),
-		children: ({ isSelected }) => /* @__PURE__ */ jsxs(Fragment, { children: [isSelected ? /* @__PURE__ */ jsx("svg", {
+		children: ({ isSelected }) => /* @__PURE__ */ jsxs(Fragment$1, { children: [isSelected ? /* @__PURE__ */ jsx("svg", {
 			"data-slot": "select-item-check",
 			"aria-hidden": "true",
 			viewBox: "0 0 16 16",
@@ -138,11 +199,11 @@ function SelectItem({ className, children, textValue, ...props }) {
 			strokeWidth: "2",
 			strokeLinecap: "round",
 			strokeLinejoin: "round",
-			className: "absolute start-2 size-3.5",
+			className: "absolute start-2 size-3.5 motion-safe:animate-select-check-in",
 			children: /* @__PURE__ */ jsx("path", { d: "m3.5 8.5 3 3 6-6" })
 		}) : null, children] })
 	});
-}
+});
 //#endregion
 export { Select$1 as Select, SelectItem, selectItemVariants, selectPopoverVariants, selectTriggerVariants, selectVariants };
 

package/dist/select/select.js.map

@@ -1 +1 @@
-{"version":3,"file":"select.js","names":["Select","AriaSelect","AriaLabel","AriaButton","AriaSelectValue","AriaFieldError","AriaPopover","AriaListBox","AriaListBoxItem"],"sources":["../../src/select/select.tsx"],"sourcesContent":["\"use client\";\n\nimport { cva } from \"class-variance-authority\";\nimport type { ReactNode } from \"react\";\nimport {\n  Button as AriaButton,\n  FieldError as AriaFieldError,\n  Label as AriaLabel,\n  ListBox as AriaListBox,\n  ListBoxItem as AriaListBoxItem,\n  Popover as AriaPopover,\n  Select as AriaSelect,\n  SelectValue as AriaSelectValue,\n  type ListBoxItemProps as AriaListBoxItemProps,\n  type SelectProps as AriaSelectProps,\n} from \"react-aria-components\";\n\nimport { cn, cnAll } from \"../lib/cn.js\";\nimport { fieldSurfaceVariants } from \"../lib/field-surface.js\";\n\n/**\n * Select, ported from the legacy shadcn/Radix component.\n *\n * FOUR PARTS COLLAPSE INTO ONE. The census reads `SelectItem` 35 and\n * `Select`, `SelectTrigger`, `SelectValue`, `SelectContent` 15 each --\n * those four always appear together in the same shape, exactly like\n * Dialog's header trio, so they are one component and a prop.\n * `SelectGroup`, `SelectLabel`, `SelectSeparator`, `SelectScrollUpButton`\n * and `SelectScrollDownButton` have ZERO call sites and are not ported.\n *\n * `label` IS REQUIRED. The legacy exports a `SelectLabel` that nobody\n * renders and passes no `aria-label` anywhere, so all 15 selects are\n * unnamed comboboxes -- the same finding as Progress, Slider and\n * ScrollArea. Pass `labelHidden` when the surrounding UI already says it.\n *\n * The trigger reuses `fieldSurfaceVariants`, shared with Input and\n * Textarea. A select and a text field sit in the same form row and must\n * be the same box; the legacy styled them separately and drifted --\n * `h-10` here against Input's `h-9`, for no stated reason.\n *\n * The popover is `card`, not a `popover` role: `--popover` is\n * byte-identical to `--card` in the legacy theme. Item hover is `muted`,\n * not `accent`, for the same reason.\n */\n/*\n * `group` is load-bearing, not decoration. React Aria puts `data-invalid` on\n * THIS element, never on the trigger -- so the trigger's own\n * `data-[invalid]:` rule, inherited from the shared field surface, can never\n * match and `isInvalid` painted nothing at all. The trigger reads the state\n * from here instead.\n */\nexport const selectVariants = cva([\"group flex w-full flex-col gap-1.5 box-border font-sans\"]);\n\nexport const selectTriggerVariants = cva(\n  [\n    // See selectVariants: the invalid state lives on the ROOT, so this reads it\n    // from the group rather than from itself.\n    \"group-data-[invalid]:border-destructive-strong\",\n    fieldSurfaceVariants(),\n    \"flex items-center justify-between gap-2 text-start\",\n    \"text-base leading-(--leading-normal) cursor-pointer\",\n    \"[&_svg]:pointer-events-none [&_svg]:shrink-0\",\n    \"[&_svg:not([class*='size-'])]:size-(--icon-sm)\",\n  ],\n  {\n    variants: {\n      /**\n       * The same rungs and the same tokens as Input and Button. 14 of the\n       * product's 32 `SelectTrigger` call sites override the height by hand,\n       * and a Select sits in the same form row as a field -- giving Input the\n       * axis without giving it here would be exactly the drift\n       * `fieldSurfaceVariants` exists to prevent.\n       *\n       * Type stays `text-base` at every rung, matching Input. A row whose two\n       * controls disagree about type size reads as a mistake.\n       */\n      size: {\n        sm: \"h-(--density-control-h-sm) px-(--density-control-pad-sm)\",\n        md: \"h-(--density-control-h-md) px-(--density-control-pad-md)\",\n        lg: \"h-(--density-control-h-lg) px-(--density-control-pad-lg)\",\n      },\n    },\n    defaultVariants: { size: \"md\" },\n  },\n);\n\nexport const selectPopoverVariants = cva([\n  // --trigger-width is set inline by React Aria, so the list matches the\n  // control it came from rather than guessing a width.\n  \"w-(--trigger-width) min-w-32 overflow-y-auto\",\n  \"rounded-md border-(length:--border-width) border-border p-1\",\n  \"bg-card text-card-foreground shadow-floating\",\n  \"box-border font-sans text-sm leading-(--leading-normal)\",\n]);\n\nexport const selectItemVariants = cva([\n  \"relative flex cursor-pointer select-none items-center gap-2\",\n  \"rounded-2xs py-1.5 pe-2 ps-8\",\n  \"box-border text-sm leading-(--leading-normal) text-card-foreground\",\n  // data-focused, not :hover. React Aria drives one highlight from both\n  // pointer and keyboard, so the row under the mouse and the row the\n  // arrows reached are the same row.\n  \"outline-none data-[focused]:bg-muted\",\n  \"data-[focus-visible]:outline-solid\",\n  \"data-[focus-visible]:outline-(length:--focus-ring-width)\",\n  \"data-[focus-visible]:outline-offset-(--focus-ring-offset)\",\n  \"data-[focus-visible]:outline-(--color-ring)\",\n  \"data-[disabled]:cursor-not-allowed data-[disabled]:opacity-(--opacity-disabled)\",\n]);\n\n/**\n * A single-choice picker.\n *\n * @example\n * <Select label=\"Country\" placeholder=\"Pick one\"\n *         selectedKey={code} onSelectionChange={setCode}>\n *   <SelectItem id=\"gb\">United Kingdom</SelectItem>\n *   <SelectItem id=\"us\">United States</SelectItem>\n * </Select>\n */\nexport interface SelectProps\n  extends Omit<AriaSelectProps<object>, \"className\" | \"style\" | \"children\" | \"items\"> {\n  /** `SelectItem` children. */\n  children?: ReactNode;\n  /**\n   * What is being chosen, and the control's accessible name.\n   *\n   * **Required.** All 15 legacy selects are unnamed: the legacy exports a\n   * `SelectLabel` that nobody renders and passes no `aria-label`.\n   */\n  label: ReactNode;\n  /** Render the label for screen readers only. */\n  labelHidden?: boolean;\n  /** Shown while nothing is selected. */\n  placeholder?: string;\n  /**\n   * Why the selection is wrong. Rendered under the control, and it is what\n   * makes `isInvalid` reach a screen reader.\n   *\n   * React Aria marks the ROOT `data-invalid` and leaves the button untouched,\n   * and an `aria-invalid` handed to that button is dropped by\n   * `filterDOMProps`, whose allowlist stops at the labelling attributes -- the\n   * same silent loss as `aria-current` on a pagination button. So without a\n   * message, an invalid select is invalid only in colour, which is WCAG 1.4.1\n   * on its own. React Aria wires this into `aria-describedby` for us.\n   */\n  errorMessage?: ReactNode;\n  /**\n   * Control scale of the trigger. Height and inline padding come from the\n   * same `--density-control-*` tokens as Input and Button, so a Select, a\n   * field and a button on one rung are the same height.\n   *\n   * Type does not scale with it, matching Input.\n   *\n   * @default \"md\"\n   */\n  size?: \"sm\" | \"md\" | \"lg\";\n  /** Extra classes for the wrapper. Merged last. */\n  className?: string;\n}\n\nexport function Select({\n  children,\n  label,\n  labelHidden,\n  placeholder,\n  errorMessage,\n  size = \"md\",\n  className,\n  ...props\n}: SelectProps) {\n  return (\n    <AriaSelect {...props} data-slot=\"select\" className={cn(selectVariants(), className)}>\n      <AriaLabel\n        data-slot=\"select-label\"\n        className={cnAll(\n          \"text-sm leading-(--leading-normal) text-foreground\",\n          labelHidden && \"sr-only\",\n        )}\n      >\n        {label}\n      </AriaLabel>\n\n      <AriaButton data-slot=\"select-trigger\" className={selectTriggerVariants({ size })}>\n        <AriaSelectValue data-slot=\"select-value\">\n          {({ isPlaceholder, selectedText }) =>\n            isPlaceholder ? (\n              <span data-slot=\"select-placeholder\" className=\"text-muted-foreground\">\n                {placeholder}\n              </span>\n            ) : (\n              selectedText\n            )\n          }\n        </AriaSelectValue>\n        {/*\n          aria-hidden: the chevron is decoration. The button already\n          announces itself as a combobox, and a second name source only\n          makes it announce twice.\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=\"text-muted-foreground\"\n        >\n          <path d=\"m4 6 4 4 4-4\" />\n        </svg>\n      </AriaButton>\n\n      {errorMessage == null ? null : (\n        // Not conditional on isInvalid: React Aria renders FieldError only\n        // while the field IS invalid, so gating it here as well would just be\n        // two sources of truth for one state.\n        <AriaFieldError\n          data-slot=\"select-error\"\n          className=\"text-sm leading-(--leading-normal) text-destructive-strong\"\n        >\n          {errorMessage}\n        </AriaFieldError>\n      )}\n\n      <AriaPopover data-slot=\"select-popover\" className={selectPopoverVariants()}>\n        <AriaListBox data-slot=\"select-list\" className=\"outline-none\">\n          {children}\n        </AriaListBox>\n      </AriaPopover>\n    </AriaSelect>\n  );\n}\n\n/**\n * One option. Its `id` is the value.\n *\n * @example\n * <SelectItem id=\"gb\">United Kingdom</SelectItem>\n */\nexport interface SelectItemProps\n  extends Omit<AriaListBoxItemProps, \"className\" | \"style\" | \"children\"> {\n  children?: ReactNode;\n  /**\n   * The option's text, for the trigger and for typeahead.\n   *\n   * Derived from `children` when they are a string. Pass it explicitly\n   * when the option renders anything richer than text.\n   */\n  textValue?: string;\n  /** Extra classes. Merged last, so they win conflicts with ours. */\n  className?: string;\n}\n\nexport function SelectItem({ className, children, textValue, ...props }: SelectItemProps) {\n  return (\n    <AriaListBoxItem\n      {...props}\n      /*\n        textValue, derived from string children.\n        React Aria infers an item's text from its children -- but ONLY\n        when they are a string. This item uses FUNCTION children so the\n        tick can be rendered in JS, which defeats that inference: the\n        trigger showed an empty value after selecting, and typeahead had\n        nothing to match on. Neither is visible in the type system.\n      */\n      textValue={textValue ?? (typeof children === \"string\" ? children : undefined)}\n      data-slot=\"select-item\"\n      className={cn(selectItemVariants(), className)}\n    >\n      {({ isSelected }) => (\n        <>\n          {/*\n            The tick is rendered in JS rather than toggled with CSS, so\n            the precedence is explicit and a test can read it from the\n            DOM. ps-8 above reserves the gutter, so selecting an option\n            does not shift its label.\n          */}\n          {isSelected ? (\n            <svg\n              data-slot=\"select-item-check\"\n              aria-hidden=\"true\"\n              viewBox=\"0 0 16 16\"\n              fill=\"none\"\n              stroke=\"currentColor\"\n              strokeWidth=\"2\"\n              strokeLinecap=\"round\"\n              strokeLinejoin=\"round\"\n              className=\"absolute start-2 size-3.5\"\n            >\n              <path d=\"m3.5 8.5 3 3 6-6\" />\n            </svg>\n          ) : null}\n          {children}\n        </>\n      )}\n    </AriaListBoxItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,iBAAiB,IAAI,CAAC,yDAAyD,CAAC;AAE7F,MAAa,wBAAwB,IACnC;CAGE;CACA,qBAAqB;CACrB;CACA;CACA;CACA;AACF,GACA;CACE,UAAU;;;;;;;;;;;AAWR,MAAM;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;CACN,EACF;CACA,iBAAiB,EAAE,MAAM,KAAK;AAChC,CACF;AAEA,MAAa,wBAAwB,IAAI;CAGvC;CACA;CACA;CACA;AACF,CAAC;AAED,MAAa,qBAAqB,IAAI;CACpC;CACA;CACA;CAIA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAqDD,SAAgBA,SAAO,EACrB,UACA,OACA,aACA,aACA,cACA,OAAO,MACP,WACA,GAAG,SACW;CACd,OACE,qBAACC,QAAD;EAAY,GAAI;EAAO,aAAU;EAAS,WAAW,GAAG,eAAe,GAAG,SAAS;EAAnF,UAAA;GACE,oBAACC,OAAD;IACE,aAAU;IACV,WAAW,MACT,sDACA,eAAe,SACjB;IAEC,UAAA;GACQ,CAAA;GAEX,qBAACC,QAAD;IAAY,aAAU;IAAiB,WAAW,sBAAsB,EAAE,KAAK,CAAC;IAAhF,UAAA,CACE,oBAACC,aAAD;KAAiB,aAAU;KACvB,WAAA,EAAE,eAAe,mBACjB,gBACE,oBAAC,QAAD;MAAM,aAAU;MAAqB,WAAU;MAC5C,UAAA;KACG,CAAA,IAEN;IAGW,CAAA,GAMjB,oBAAC,OAAD;KACE,eAAY;KACZ,SAAQ;KACR,MAAK;KACL,QAAO;KACP,aAAY;KACZ,eAAc;KACd,gBAAe;KACf,WAAU;KAEV,UAAA,oBAAC,QAAD,EAAM,GAAE,eAAgB,CAAA;IACrB,CAAA,CACK;;GAEX,gBAAgB,OAAO,OAItB,oBAACC,YAAD;IACE,aAAU;IACV,WAAU;IAET,UAAA;GACa,CAAA;GAGlB,oBAACC,SAAD;IAAa,aAAU;IAAiB,WAAW,sBAAsB;IACvE,UAAA,oBAACC,SAAD;KAAa,aAAU;KAAc,WAAU;KAC5C;IACU,CAAA;GACF,CAAA;EACH;;AAEhB;AAsBA,SAAgB,WAAW,EAAE,WAAW,UAAU,WAAW,GAAG,SAA0B;CACxF,OACE,oBAACC,aAAD;EACE,GAAI;EASJ,WAAW,cAAc,OAAO,aAAa,WAAW,WAAW,KAAA;EACnE,aAAU;EACV,WAAW,GAAG,mBAAmB,GAAG,SAAS;EAE3C,WAAA,EAAE,iBACF,qBAAA,UAAA,EAAA,UAAA,CAOG,aACC,oBAAC,OAAD;GACE,aAAU;GACV,eAAY;GACZ,SAAQ;GACR,MAAK;GACL,QAAO;GACP,aAAY;GACZ,eAAc;GACd,gBAAe;GACf,WAAU;GAEV,UAAA,oBAAC,QAAD,EAAM,GAAE,mBAAoB,CAAA;EACzB,CAAA,IACH,MACH,QACD,EAAA,CAAA;CAEW,CAAA;AAErB"}
+{"version":3,"file":"select.js","names":["AriaSelectValue","Select","AriaSelect","AriaLabel","AriaButton","AriaFieldError","AriaPopover","AriaListBox","AriaListBoxItem"],"sources":["../../src/select/select.tsx"],"sourcesContent":["\"use client\";\n\nimport { cva } from \"class-variance-authority\";\nimport { forwardRef, useContext, useState, type ReactNode } from \"react\";\nimport {\n  Button as AriaButton,\n  FieldError as AriaFieldError,\n  Label as AriaLabel,\n  ListBox as AriaListBox,\n  ListBoxItem as AriaListBoxItem,\n  Popover as AriaPopover,\n  Select as AriaSelect,\n  SelectStateContext,\n  SelectValue as AriaSelectValue,\n  type ListBoxItemProps as AriaListBoxItemProps,\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 { fieldSurfaceVariants } from \"../lib/field-surface.js\";\nimport { useIsomorphicLayoutEffect } from \"../lib/motion.js\";\nimport { RollingValue } from \"../lib/rolling-value.js\";\n\n/**\n * Select, ported from the legacy shadcn/Radix component.\n *\n * FOUR PARTS COLLAPSE INTO ONE. The census reads `SelectItem` 35 and\n * `Select`, `SelectTrigger`, `SelectValue`, `SelectContent` 15 each --\n * those four always appear together in the same shape, exactly like\n * Dialog's header trio, so they are one component and a prop.\n * `SelectGroup`, `SelectLabel`, `SelectSeparator`, `SelectScrollUpButton`\n * and `SelectScrollDownButton` have ZERO call sites and are not ported.\n *\n * `label` IS REQUIRED. The legacy exports a `SelectLabel` that nobody\n * renders and passes no `aria-label` anywhere, so all 15 selects are\n * unnamed comboboxes -- the same finding as Progress, Slider and\n * ScrollArea. Pass `labelHidden` when the surrounding UI already says it.\n *\n * The trigger reuses `fieldSurfaceVariants`, shared with Input and\n * Textarea. A select and a text field sit in the same form row and must\n * be the same box; the legacy styled them separately and drifted --\n * `h-10` here against Input's `h-9`, for no stated reason.\n *\n * The popover is `card`, not a `popover` role: `--popover` is\n * byte-identical to `--card` in the legacy theme. Item hover is `muted`,\n * not `accent`, for the same reason.\n */\n/*\n * `group` is load-bearing, not decoration. React Aria puts `data-invalid` on\n * THIS element, never on the trigger -- so the trigger's own\n * `data-[invalid]:` rule, inherited from the shared field surface, can never\n * match and `isInvalid` painted nothing at all. The trigger reads the state\n * from here instead.\n */\nexport const selectVariants = cva([\"group flex w-full flex-col gap-1.5 box-border font-sans\"]);\n\nexport const selectTriggerVariants = cva(\n  [\n    // See selectVariants: the invalid state lives on the ROOT, so this reads it\n    // from the group rather than from itself.\n    \"group-data-[invalid]:border-destructive-strong\",\n    fieldSurfaceVariants(),\n    // While the menu is open the trigger is pressed and focus has moved into the\n    // list, so the border keeps the darkness it had instead of falling back.\n    \"[&:where([data-pressed])]:border-foreground\",\n    // The fill follows the border: hovered, pressed and open all read as one\n    // state. Ordinary variants, not :where(): the base background is a plain\n    // class, so a zero-specificity rule would lose to it. Nothing else paints\n    // the background, and a disabled trigger is never hovered or pressed.\n    \"data-[hovered]:not-data-[disabled]:bg-muted\",\n    \"data-[pressed]:bg-muted\",\n    \"group/trigger\",\n    \"flex items-center justify-between gap-2 text-start\",\n    \"leading-(--leading-normal) cursor-pointer\",\n    \"[&_svg]:pointer-events-none [&_svg]:shrink-0\",\n    \"[&_svg:not([class*='size-'])]:size-(--icon-sm)\",\n  ],\n  {\n    variants: {\n      /**\n       * The same rungs and the same tokens as Input and Button. 14 of the\n       * product's 32 `SelectTrigger` call sites override the height by hand,\n       * and a Select sits in the same form row as a field -- giving Input the\n       * axis without giving it here would be exactly the drift\n       * `fieldSurfaceVariants` exists to prevent.\n       *\n       * Type matches Input's at every rung: 14px on `sm` (16px on a touch\n       * screen), 16px on `md` and `lg`. A row whose two controls disagree\n       * about type size reads as a mistake. The trigger is a button, so iOS\n       * would not zoom on it; the coarse-pointer rule is there to keep it\n       * equal to the field beside it.\n       */\n      size: {\n        sm: \"h-(--density-control-h-sm) px-(--density-control-pad-sm) text-sm pointer-coarse:text-base\",\n        md: \"h-(--density-control-h-md) px-(--density-control-pad-md) text-base\",\n        lg: \"h-(--density-control-h-lg) px-(--density-control-pad-lg) text-base\",\n      },\n    },\n    defaultVariants: { size: \"md\" },\n  },\n);\n\nexport const selectPopoverVariants = cva([\n  // --trigger-width is set inline by React Aria, so the list matches the\n  // control it came from rather than guessing a width.\n  \"w-(--trigger-width) min-w-32 overflow-y-auto\",\n  // Grows from the trigger edge: offset toward it and a little small, 240ms in,\n  // 120ms out. React Aria marks the first frame data-entering and the leaving\n  // one data-exiting and keeps the list mounted until the animation ends.\n  \"[--menu-x:0px] [--menu-y:-6px] origin-top\",\n  \"data-[placement=top]:[--menu-y:6px] data-[placement=top]:origin-bottom\",\n  \"data-[placement=left]:[--menu-x:6px] data-[placement=left]:[--menu-y:0px] data-[placement=left]:origin-right\",\n  \"data-[placement=right]:[--menu-x:-6px] data-[placement=right]:[--menu-y:0px] data-[placement=right]:origin-left\",\n  \"motion-safe:data-[entering]:animate-select-popover-in motion-reduce:data-[entering]:animate-select-fade-in\",\n  \"motion-safe:data-[exiting]:animate-select-popover-out motion-reduce:data-[exiting]:animate-select-fade-out\",\n  \"data-[exiting]:pointer-events-none\",\n  \"rounded-md border-(length:--border-width) border-border p-1\",\n  \"bg-card text-card-foreground shadow-floating\",\n  \"box-border font-sans text-sm leading-(--leading-normal)\",\n]);\n\nexport const selectItemVariants = cva([\n  \"relative flex cursor-pointer select-none items-center gap-2\",\n  \"rounded-2xs py-1.5 pe-2 ps-8\",\n  \"box-border text-sm leading-(--leading-normal) text-card-foreground\",\n  // data-focused, not :hover. React Aria drives one highlight from both\n  // pointer and keyboard, so the row under the mouse and the row the\n  // arrows reached are the same row.\n  \"outline-none data-[focused]:bg-muted\",\n  \"motion-safe:transition-colors motion-safe:duration-(--duration-instant) motion-safe:ease-settle\",\n  \"data-[focus-visible]:outline-solid\",\n  \"data-[focus-visible]:outline-(length:--focus-ring-width)\",\n  \"data-[focus-visible]:outline-offset-(--focus-ring-offset)\",\n  \"data-[focus-visible]:outline-(--color-ring)\",\n  \"data-[disabled]:cursor-not-allowed data-[disabled]:opacity-(--opacity-disabled)\",\n]);\n\n/**\n * A single-choice picker.\n *\n * @example\n * <Select label=\"Country\" placeholder=\"Pick one\"\n *         selectedKey={code} onSelectionChange={setCode}>\n *   <SelectItem id=\"gb\">United Kingdom</SelectItem>\n *   <SelectItem id=\"us\">United States</SelectItem>\n * </Select>\n */\nexport interface SelectProps extends Omit<\n  AriaSelectProps<object>,\n  \"className\" | \"style\" | \"children\" | \"items\"\n> {\n  /** `SelectItem` children. */\n  children?: ReactNode;\n  /**\n   * What is being chosen, and the control's accessible name.\n   *\n   * **Required.** All 15 legacy selects are unnamed: the legacy exports a\n   * `SelectLabel` that nobody renders and passes no `aria-label`.\n   */\n  label: ReactNode;\n  /** Render the label for screen readers only. */\n  labelHidden?: boolean;\n  /** Shown while nothing is selected. */\n  placeholder?: string;\n  /**\n   * Why the selection is wrong. Rendered under the control, and it is what\n   * makes `isInvalid` reach a screen reader.\n   *\n   * React Aria marks the ROOT `data-invalid` and leaves the button untouched,\n   * and an `aria-invalid` handed to that button is dropped by\n   * `filterDOMProps`, whose allowlist stops at the labelling attributes -- the\n   * same silent loss as `aria-current` on a pagination button. So without a\n   * message, an invalid select is invalid only in colour, which is WCAG 1.4.1\n   * on its own. React Aria wires this into `aria-describedby` for us.\n   */\n  errorMessage?: ReactNode;\n  /**\n   * Control scale of the trigger. Height and inline padding come from the\n   * same `--density-control-*` tokens as Input and Button, so a Select, a\n   * field and a button on one rung are the same height.\n   *\n   * Type does not scale with it, matching Input.\n   *\n   * @default \"md\"\n   */\n  size?: \"sm\" | \"md\" | \"lg\";\n  /** Extra classes for the wrapper. Merged last. */\n  className?: string;\n}\n\n/**\n * The shown value. React Aria's own `SelectValue` stays, visually hidden, as the\n * text a screen reader reads; the copy the eye sees rolls when the selection\n * changes: a later option rises from below, an earlier one drops from above. The\n * direction is read from the option's place in the list. A pre-selected value\n * does not animate on first mount.\n */\nfunction ValueRoll({ placeholder }: { placeholder?: string }) {\n  const state = useContext(SelectStateContext);\n  const key = state?.selectedKey ?? null;\n  let index = -1;\n  if (state && key != null) {\n    let n = 0;\n    for (const item of state.collection) {\n      if (item.type !== \"item\") continue;\n      if (item.key === key) index = n;\n      n += 1;\n    }\n  }\n  const [previous, setPrevious] = useState(index);\n  const [dir, setDir] = useState(1);\n  if (previous !== index) {\n    setPrevious(index);\n    setDir(index > previous ? 1 : -1);\n  }\n  const text = state?.selectedItem?.textValue ?? \"\";\n  // React Aria resolves a default selection after the first render, so the key\n  // starts as null and then settles. Until the collection is built nothing is\n  // shown, and the swap remounts once it is, so that settling is not a change.\n  const built = (state?.collection.size ?? 0) > 0 || state?.selectedKey != null;\n  const [mounted, setMounted] = useState(false);\n  useIsomorphicLayoutEffect(() => setMounted(true), []);\n  const settled = built || mounted;\n  const swapKey = key == null ? \"placeholder\" : `value-${String(key)}`;\n  return (\n    <RollingValue\n      srValue={\n        <AriaSelectValue data-slot=\"select-value\" className=\"sr-only\">\n          {({ isPlaceholder, selectedText }) => (isPlaceholder ? placeholder : selectedText)}\n        </AriaSelectValue>\n      }\n      swapKey={swapKey}\n      dir={dir}\n      instanceKey={settled ? \"live\" : \"boot\"}\n    >\n      {key == null ? (\n        <span data-slot=\"select-placeholder\" className=\"text-muted-foreground\">\n          {placeholder}\n        </span>\n      ) : (\n        text\n      )}\n    </RollingValue>\n  );\n}\n\nexport const Select = forwardRef<HTMLButtonElement, SelectProps>(function Select(\n  { children, label, labelHidden, placeholder, errorMessage, size = \"md\", className, ...props },\n  ref,\n) {\n  return (\n    <AriaSelect {...props} data-slot=\"select\" className={cn(selectVariants(), className)}>\n      {/*\n        The Label's own classes, so a Select's label and the Label over an\n        Input in the same form are one style (same size, weight, colour and\n        line height). The select-label slot stays for consumers that target it.\n      */}\n      <AriaLabel\n        data-slot=\"select-label\"\n        className={cnAll(labelVariants(), labelHidden && \"sr-only\")}\n      >\n        {label}\n      </AriaLabel>\n\n      {/*\n        The ref goes on the TRIGGER, not the AriaSelect root above. The root\n        is a field-level wrapper div; the trigger is the always-visible\n        interactive surface a caller actually wants to focus or click,\n        the same reasoning that puts Input's ref on the real control.\n      */}\n      <AriaButton ref={ref} data-slot=\"select-trigger\" className={selectTriggerVariants({ size })}>\n        <ValueRoll placeholder={placeholder} />\n        {/*\n          aria-hidden: the chevron is decoration. The button already\n          announces itself as a combobox, and a second name source only\n          makes it announce twice.\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=\"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      {errorMessage == null ? null : (\n        // Not conditional on isInvalid: React Aria renders FieldError only\n        // while the field IS invalid, so gating it here as well would just be\n        // two sources of truth for one state.\n        <AriaFieldError\n          data-slot=\"select-error\"\n          className=\"text-sm leading-(--leading-normal) text-destructive-strong\"\n        >\n          {errorMessage}\n        </AriaFieldError>\n      )}\n\n      <AriaPopover data-slot=\"select-popover\" className={selectPopoverVariants()}>\n        <AriaListBox data-slot=\"select-list\" className=\"outline-none\">\n          {children}\n        </AriaListBox>\n      </AriaPopover>\n    </AriaSelect>\n  );\n});\n\n/**\n * One option. Its `id` is the value.\n *\n * @example\n * <SelectItem id=\"gb\">United Kingdom</SelectItem>\n */\nexport interface SelectItemProps extends Omit<\n  AriaListBoxItemProps,\n  \"className\" | \"style\" | \"children\"\n> {\n  children?: ReactNode;\n  /**\n   * The option's text, for the trigger and for typeahead.\n   *\n   * Derived from `children` when they are a string. Pass it explicitly\n   * when the option renders anything richer than text.\n   */\n  textValue?: string;\n  /** Extra classes. Merged last, so they win conflicts with ours. */\n  className?: string;\n}\n\nexport const SelectItem = forwardRef<HTMLDivElement, SelectItemProps>(function SelectItem(\n  { className, children, textValue, ...props },\n  ref,\n) {\n  return (\n    <AriaListBoxItem\n      ref={ref}\n      {...props}\n      /*\n        textValue, derived from string children.\n        React Aria infers an item's text from its children -- but ONLY\n        when they are a string. This item uses FUNCTION children so the\n        tick can be rendered in JS, which defeats that inference: the\n        trigger showed an empty value after selecting, and typeahead had\n        nothing to match on. Neither is visible in the type system.\n      */\n      textValue={textValue ?? (typeof children === \"string\" ? children : undefined)}\n      data-slot=\"select-item\"\n      className={cn(selectItemVariants(), className)}\n    >\n      {({ isSelected }) => (\n        <>\n          {/*\n            The tick is rendered in JS rather than toggled with CSS, so\n            the precedence is explicit and a test can read it from the\n            DOM. ps-8 above reserves the gutter, so selecting an option\n            does not shift its label.\n          */}\n          {isSelected ? (\n            <svg\n              data-slot=\"select-item-check\"\n              aria-hidden=\"true\"\n              viewBox=\"0 0 16 16\"\n              fill=\"none\"\n              stroke=\"currentColor\"\n              strokeWidth=\"2\"\n              strokeLinecap=\"round\"\n              strokeLinejoin=\"round\"\n              className=\"absolute start-2 size-3.5 motion-safe:animate-select-check-in\"\n            >\n              <path d=\"m3.5 8.5 3 3 6-6\" />\n            </svg>\n          ) : null}\n          {children}\n        </>\n      )}\n    </AriaListBoxItem>\n  );\n});\n"],"mappings":"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"}

package/dist/separator/separator.d.ts

@@ -36,7 +36,7 @@ interface SeparatorProps$1 extends Omit<SeparatorProps, "className" | "style"> {
   /** Extra classes. Merged last, so they win conflicts with ours. */
   className?: string;
 }
-declare function Separator$1({ className, orientation, ...props }: SeparatorProps$1): import("react").JSX.Element;
+declare const Separator$1: import("react").ForwardRefExoticComponent<SeparatorProps$1 & import("react").RefAttributes<HTMLElement>>;
 //#endregion
 export { Separator$1 as Separator, SeparatorProps$1 as SeparatorProps };
 //# sourceMappingURL=separator.d.ts.map

package/dist/separator/separator.js

@@ -1,6 +1,7 @@
 "use client";
 import { cn } from "../lib/cn.js";
 import { cva } from "class-variance-authority";
+import { forwardRef } from "react";
 import { Separator } from "react-aria-components";
 import { jsx } from "react/jsx-runtime";
 //#region src/separator/separator.tsx
@@ -35,14 +36,15 @@ const separatorVariants = cva([
 	} },
 	defaultVariants: { orientation: "horizontal" }
 });
-function Separator$1({ className, orientation = "horizontal", ...props }) {
+const Separator$1 = forwardRef(function Separator$2({ className, orientation = "horizontal", ...props }, ref) {
 	return /* @__PURE__ */ jsx(Separator, {
+		ref,
 		...props,
 		orientation,
 		"data-slot": "separator",
 		className: cn(separatorVariants({ orientation }), className)
 	});
-}
+});
 //#endregion
 export { Separator$1 as Separator, separatorVariants };
 

package/dist/separator/separator.js.map

@@ -1 +1 @@
-{"version":3,"file":"separator.js","names":["Separator","AriaSeparator"],"sources":["../../src/separator/separator.tsx"],"sourcesContent":["\"use client\";\n\nimport { cva } from \"class-variance-authority\";\nimport {\n  Separator as AriaSeparator,\n  type SeparatorProps as AriaSeparatorProps,\n} from \"react-aria-components\";\n\nimport { cn } from \"../lib/cn.js\";\n\n/**\n * Separator, ported from the legacy component onto React Aria's Separator.\n *\n * Census: 7 files, 6 uses, one of them `orientation=\"vertical\"`. No other\n * prop is ever passed.\n *\n * `decorative` is NOT ported -- zero call sites pass it, and React Aria has\n * no equivalent. That does change the semantics of all six existing uses,\n * which is worth saying out loud rather than burying: the legacy defaulted\n * to `decorative: true` and therefore rendered `role=\"none\"`, so every\n * divider in the app is currently invisible to assistive technology. React\n * Aria renders an `<hr>` for a horizontal separator, whose implicit role IS\n * separator. A visible line between two groups of content is a separator;\n * announcing it is the correct behaviour, and it is what the element the\n * legacy chose (a `div`) was pretending not to be.\n *\n * Every string in the cva blocks below is a STATIC literal. Tailwind scans\n * source text, so a class assembled at runtime is invisible to it and would\n * simply never be emitted.\n */\nexport const separatorVariants = cva(\n  [\n    // border-none, not border-0. `border-0` sets the WIDTH to zero but leaves\n    // border-style at solid, so the computed style still claims a border that\n    // simply measures nothing -- the same bookkeeping the Checkbox parity run\n    // turned up on the legacy input. `border-none` says what is true.\n    \"shrink-0 bg-border border-none\",\n    // The user-agent <hr> ships a block margin and a 1px inset border, and\n    // React Aria renders an <hr> for the horizontal case. The reset in\n    // @seekalfred/styles is OPT-IN, so a consumer may load none -- unreset,\n    // every divider is a grooved double line with space around it.\n    \"m-0\",\n    \"box-border\",\n  ],\n  {\n    variants: {\n      orientation: {\n        // h-px / w-px, not the legacy h-[1px] / w-[1px]. Those are bracket\n        // values that check:hardcoding rejects, and `px` is a first-class\n        // Tailwind step rather than an arbitrary one.\n        horizontal: \"h-px w-full\",\n        vertical: \"h-full w-px\",\n      },\n    },\n    defaultVariants: { orientation: \"horizontal\" },\n  },\n);\n\n/**\n * A visual divider between two groups of content.\n *\n * @example\n * <Separator />\n * <Separator orientation=\"vertical\" />\n */\nexport interface SeparatorProps extends Omit<AriaSeparatorProps, \"className\" | \"style\"> {\n  /** @default \"horizontal\" */\n  orientation?: \"horizontal\" | \"vertical\";\n  /** Extra classes. Merged last, so they win conflicts with ours. */\n  className?: string;\n}\n\nexport function Separator({ className, orientation = \"horizontal\", ...props }: SeparatorProps) {\n  return (\n    <AriaSeparator\n      {...props}\n      orientation={orientation}\n      data-slot=\"separator\"\n      className={cn(separatorVariants({ orientation }), className)}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAa,oBAAoB,IAC/B;CAKE;CAKA;CACA;AACF,GACA;CACE,UAAU,EACR,aAAa;EAIX,YAAY;EACZ,UAAU;CACZ,EACF;CACA,iBAAiB,EAAE,aAAa,aAAa;AAC/C,CACF;AAgBA,SAAgBA,YAAU,EAAE,WAAW,cAAc,cAAc,GAAG,SAAyB;CAC7F,OACE,oBAACC,WAAD;EACE,GAAI;EACS;EACb,aAAU;EACV,WAAW,GAAG,kBAAkB,EAAE,YAAY,CAAC,GAAG,SAAS;CAC5D,CAAA;AAEL"}
+{"version":3,"file":"separator.js","names":["Separator","AriaSeparator"],"sources":["../../src/separator/separator.tsx"],"sourcesContent":["\"use client\";\n\nimport { cva } from \"class-variance-authority\";\nimport { forwardRef } from \"react\";\nimport {\n  Separator as AriaSeparator,\n  type SeparatorProps as AriaSeparatorProps,\n} from \"react-aria-components\";\n\nimport { cn } from \"../lib/cn.js\";\n\n/**\n * Separator, ported from the legacy component onto React Aria's Separator.\n *\n * Census: 7 files, 6 uses, one of them `orientation=\"vertical\"`. No other\n * prop is ever passed.\n *\n * `decorative` is NOT ported -- zero call sites pass it, and React Aria has\n * no equivalent. That does change the semantics of all six existing uses,\n * which is worth saying out loud rather than burying: the legacy defaulted\n * to `decorative: true` and therefore rendered `role=\"none\"`, so every\n * divider in the app is currently invisible to assistive technology. React\n * Aria renders an `<hr>` for a horizontal separator, whose implicit role IS\n * separator. A visible line between two groups of content is a separator;\n * announcing it is the correct behaviour, and it is what the element the\n * legacy chose (a `div`) was pretending not to be.\n *\n * Every string in the cva blocks below is a STATIC literal. Tailwind scans\n * source text, so a class assembled at runtime is invisible to it and would\n * simply never be emitted.\n */\nexport const separatorVariants = cva(\n  [\n    // border-none, not border-0. `border-0` sets the WIDTH to zero but leaves\n    // border-style at solid, so the computed style still claims a border that\n    // simply measures nothing -- the same bookkeeping the Checkbox parity run\n    // turned up on the legacy input. `border-none` says what is true.\n    \"shrink-0 bg-border border-none\",\n    // The user-agent <hr> ships a block margin and a 1px inset border, and\n    // React Aria renders an <hr> for the horizontal case. The reset in\n    // @seekalfred/styles is OPT-IN, so a consumer may load none -- unreset,\n    // every divider is a grooved double line with space around it.\n    \"m-0\",\n    \"box-border\",\n  ],\n  {\n    variants: {\n      orientation: {\n        // h-px / w-px, not the legacy h-[1px] / w-[1px]. Those are bracket\n        // values that check:hardcoding rejects, and `px` is a first-class\n        // Tailwind step rather than an arbitrary one.\n        horizontal: \"h-px w-full\",\n        vertical: \"h-full w-px\",\n      },\n    },\n    defaultVariants: { orientation: \"horizontal\" },\n  },\n);\n\n/**\n * A visual divider between two groups of content.\n *\n * @example\n * <Separator />\n * <Separator orientation=\"vertical\" />\n */\nexport interface SeparatorProps extends Omit<AriaSeparatorProps, \"className\" | \"style\"> {\n  /** @default \"horizontal\" */\n  orientation?: \"horizontal\" | \"vertical\";\n  /** Extra classes. Merged last, so they win conflicts with ours. */\n  className?: string;\n}\n\nexport const Separator = forwardRef<HTMLElement, SeparatorProps>(function Separator(\n  { className, orientation = \"horizontal\", ...props },\n  ref,\n) {\n  return (\n    <AriaSeparator\n      ref={ref}\n      {...props}\n      orientation={orientation}\n      data-slot=\"separator\"\n      className={cn(separatorVariants({ orientation }), className)}\n    />\n  );\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,oBAAoB,IAC/B;CAKE;CAKA;CACA;AACF,GACA;CACE,UAAU,EACR,aAAa;EAIX,YAAY;EACZ,UAAU;CACZ,EACF;CACA,iBAAiB,EAAE,aAAa,aAAa;AAC/C,CACF;AAgBA,MAAaA,cAAY,WAAwC,SAASA,YACxE,EAAE,WAAW,cAAc,cAAc,GAAG,SAC5C,KACA;CACA,OACE,oBAACC,WAAD;EACO;EACL,GAAI;EACS;EACb,aAAU;EACV,WAAW,GAAG,kBAAkB,EAAE,YAAY,CAAC,GAAG,SAAS;CAC5D,CAAA;AAEL,CAAC"}

package/dist/sheet/sheet.d.ts

@@ -91,6 +91,6 @@ export interface SheetProps extends Omit<DialogProps, "overlayClassName"> {
    */
   bodyLabel?: string;
 }
-export declare function Sheet({ side, className, onBack, backLabel, scrollResetKey, bodyClassName, bodyLabel, title, children, ...props }: SheetProps): import("react").JSX.Element;
+export declare const Sheet: import("react").ForwardRefExoticComponent<SheetProps & import("react").RefAttributes<HTMLElement>>;
 //#endregion
 //# sourceMappingURL=sheet.d.ts.map

package/dist/sheet/sheet.js

@@ -1,9 +1,10 @@
 "use client";
 import { cn } from "../lib/cn.js";
-import { Dialog } from "../dialog/dialog.js";
 import { Button } from "../button/button.js";
+import { Dialog } from "../dialog/dialog.js";
 import { ScrollArea } from "../scroll-area/scroll-area.js";
 import { cva } from "class-variance-authority";
+import { forwardRef } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/sheet/sheet.tsx
 /**
@@ -70,9 +71,11 @@ function BackArrowGlyph() {
 		children: /* @__PURE__ */ jsx("path", { d: "M10 3 5 8l5 5" })
 	});
 }
-function Sheet({ side = "right", className, onBack, backLabel = "Back", scrollResetKey, bodyClassName, bodyLabel, title, children, ...props }) {
+const Sheet = forwardRef(function Sheet({ side = "right", className, onBack, backLabel = "Back", scrollResetKey, bodyClassName, bodyLabel, title, children, ...props }, ref) {
 	return /* @__PURE__ */ jsx(Dialog, {
+		entrance: "none",
 		...props,
+		ref,
 		title,
 		beforeTitle: onBack ? /* @__PURE__ */ jsx(Button, {
 			variant: "ghost",
@@ -92,7 +95,7 @@ function Sheet({ side = "right", className, onBack, backLabel = "Back", scrollRe
 			children
 		})
 	});
-}
+});
 //#endregion
 export { Sheet, sheetOverlayVariants, sheetPanelVariants };
 

package/dist/sheet/sheet.js.map

@@ -1 +1 @@
-{"version":3,"file":"sheet.js","names":[],"sources":["../../src/sheet/sheet.tsx"],"sourcesContent":["\"use client\";\n\nimport { cva } from \"class-variance-authority\";\n\nimport { Button } from \"../button/button.js\";\nimport { cn } from \"../lib/cn.js\";\nimport { Dialog, type DialogProps } from \"../dialog/dialog.js\";\nimport { ScrollArea } from \"../scroll-area/scroll-area.js\";\n\n/**\n * Sheet: a dialog that arrives from an edge.\n *\n * A PRESET over `Dialog`, like `AlertDialog`. The legacy `sheet.tsx` is\n * `@radix-ui/react-dialog` again -- the same import, the same parts, the\n * same close button -- with one prop changing where it sits. Keeping a\n * second copy is how the legacy `dialog.tsx` and `alert-dialog.tsx`\n * drifted, and this is the same file for the third time.\n *\n * Census: 2 files, 3 uses. `side=\"right\"` twice, `side=\"left\"` once, and\n * `className` four times. `SheetHeader`, `SheetFooter`, `SheetTitle`,\n * `SheetDescription` and `SheetClose` are exported by the legacy and used\n * by NOBODY -- so all three sheets in the app render a `role=\"dialog\"`\n * with no title at all. Radix even warns about it in the console.\n *\n * `title` is required here, inherited from Dialog, so that is no longer\n * expressible.\n *\n * `side` is `\"left\" | \"right\"` only. The legacy also offers `\"top\"` and\n * `\"bottom\"`; both have zero call sites, and each is two lines to add the\n * day something needs one.\n *\n * A REAL BUG THE PORT FIXES: the legacy panel is `w-3/4 sm:max-w-sm`, and\n * `sm:max-w-sm` names `--container-sm`, which this repo does not define --\n * so in Alfred it would compile to NOTHING and the sheet would be 75% of\n * the viewport at every width, on a phone and on a 4K monitor alike. The\n * width here is a spacing-scale step that actually resolves.\n *\n * NOT PORTED: the slide-in animation. It comes from tailwindcss-animate,\n * which this repo does not ship. React Aria exposes `data-entering` and\n * `data-exiting`, and `--animate-*` tokens now exist, so it is a small\n * follow-up rather than a blocker.\n */\nexport const sheetOverlayVariants = cva(\"p-0\", {\n  variants: {\n    // The overlay is a flex box centring the panel. A sheet replaces that\n    // centring with an edge alignment rather than positioning the panel\n    // absolutely, so the scrim and the panel stay one layout.\n    side: {\n      left: \"justify-start items-stretch\",\n      right: \"justify-end items-stretch\",\n    },\n  },\n  defaultVariants: { side: \"right\" },\n});\n\nexport const sheetPanelVariants = cva(\n  [\n    // max-w-96 is 384px and RESOLVES. See the note above on sm:max-w-sm.\n    \"h-full w-full max-w-96\",\n    // Square against the edge it is attached to: a rounded corner flush\n    // with the viewport edge reads as a rendering fault.\n    \"rounded-none\",\n    \"max-h-full overflow-y-auto\",\n  ],\n  {\n    variants: {\n      side: {\n        left: \"border-y-0 border-s-0\",\n        right: \"border-y-0 border-e-0\",\n      },\n    },\n    defaultVariants: { side: \"right\" },\n  },\n);\n\n/**\n * A panel that arrives from the side.\n *\n * @example\n * <Sheet isOpen={open} onOpenChange={setOpen} title=\"Filters\">\n *   ...\n * </Sheet>\n */\nexport interface SheetProps extends Omit<DialogProps, \"overlayClassName\"> {\n  /**\n   * Which edge it is attached to.\n   *\n   * `\"top\"` and `\"bottom\"` exist in the legacy and have zero call sites.\n   *\n   * @default \"right\"\n   */\n  side?: \"left\" | \"right\";\n  /**\n   * Show a back control, and what it does.\n   *\n   * A side panel that goes a level deeper REPLACES its own contents rather\n   * than stacking a second modal on top, so the browser's back affordance and\n   * the escape key both do the wrong thing -- they close the whole panel\n   * instead of returning one level. The product's own note calls this the\n   * thing that \"makes items 119 and 120 one change rather than two\".\n   */\n  onBack?: () => void;\n  /** Accessible name and label for the back control. @default \"Back\" */\n  backLabel?: string;\n  /**\n   * Change this when the panel's contents change, and the body scrolls back\n   * to the top.\n   *\n   * Going a level deeper and landing halfway down the new view is\n   * disorienting, and it is the kind of thing every call site forgets --\n   * which is why it belongs here rather than in each of them.\n   */\n  scrollResetKey?: string | number;\n  /** Extra classes for the scrolling body region. */\n  bodyClassName?: string;\n  /**\n   * Names the scrolling body region. Defaults to `title` when that is a\n   * string, which it is at every call site in the product.\n   *\n   * The body is a `ScrollArea`, so it is focusable -- a scrollable region that\n   * is not reachable by keyboard is WCAG 2.1.1, and axe caught exactly that\n   * when this was a plain div. The product's own `SidePanelBody` still is one.\n   * A focusable element needs a role and a role needs a name, so this is the\n   * only combination that is actually correct.\n   */\n  bodyLabel?: string;\n}\n\nfunction BackArrowGlyph() {\n  return (\n    <svg\n      aria-hidden=\"true\"\n      viewBox=\"0 0 16 16\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"1.5\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      // Logical, so it points the right way once the panel mirrors in RTL.\n      className=\"size-(--icon-sm) rtl:-scale-x-100\"\n    >\n      <path d=\"M10 3 5 8l5 5\" />\n    </svg>\n  );\n}\n\nexport function Sheet({\n  side = \"right\",\n  className,\n  onBack,\n  backLabel = \"Back\",\n  scrollResetKey,\n  bodyClassName,\n  bodyLabel,\n  title,\n  children,\n  ...props\n}: SheetProps) {\n  return (\n    /*\n      No data-slot here. Dialog spreads its props onto the ModalOverlay and\n      writes data-slot=\"dialog-overlay\" AFTER the spread, so a data-slot\n      passed from here is overwritten before it reaches the DOM -- it read as\n      working while rendering nothing. A sheet is identified by its side\n      variant and its panel classes instead.\n    */\n    <Dialog\n      {...props}\n      title={title}\n      beforeTitle={\n        onBack ? (\n          <Button\n            variant=\"ghost\"\n            size=\"sm\"\n            data-slot=\"sheet-back\"\n            className=\"-ms-2 w-fit\"\n            startIcon={<BackArrowGlyph />}\n            onPress={onBack}\n          >\n            {backLabel}\n          </Button>\n        ) : undefined\n      }\n      overlayClassName={sheetOverlayVariants({ side })}\n      className={cn(sheetPanelVariants({ side }), className)}\n    >\n      {/*\n        The scrolling region is its own element so the title and the back\n        control stay put while the content moves. A panel that scrolled as one\n        block would take its own heading off screen.\n      */}\n      {/*\n        No data-slot=\"sheet-body\" here, for the same reason the overlay has\n        none: ScrollArea spreads its props and writes data-slot=\"scroll-area\"\n        AFTER the spread, so one passed from here is overwritten before it\n        reaches the DOM. It read as wired while selecting nothing.\n      */}\n      <ScrollArea\n        scrollResetKey={scrollResetKey}\n        label={bodyLabel ?? (typeof title === \"string\" ? title : \"\")}\n        className={cn(\"min-h-0 flex-1\", bodyClassName)}\n      >\n        {children}\n      </ScrollArea>\n    </Dialog>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAa,uBAAuB,IAAI,OAAO;CAC7C,UAAU,EAIR,MAAM;EACJ,MAAM;EACN,OAAO;CACT,EACF;CACA,iBAAiB,EAAE,MAAM,QAAQ;AACnC,CAAC;AAED,MAAa,qBAAqB,IAChC;CAEE;CAGA;CACA;AACF,GACA;CACE,UAAU,EACR,MAAM;EACJ,MAAM;EACN,OAAO;CACT,EACF;CACA,iBAAiB,EAAE,MAAM,QAAQ;AACnC,CACF;AAuDA,SAAS,iBAAiB;CACxB,OACE,oBAAC,OAAD;EACE,eAAY;EACZ,SAAQ;EACR,MAAK;EACL,QAAO;EACP,aAAY;EACZ,eAAc;EACd,gBAAe;EAEf,WAAU;EAEV,UAAA,oBAAC,QAAD,EAAM,GAAE,gBAAiB,CAAA;CACtB,CAAA;AAET;AAEA,SAAgB,MAAM,EACpB,OAAO,SACP,WACA,QACA,YAAY,QACZ,gBACA,eACA,WACA,OACA,UACA,GAAG,SACU;CACb,OAQE,oBAAC,QAAD;EACE,GAAI;EACG;EACP,aACE,SACE,oBAAC,QAAD;GACE,SAAQ;GACR,MAAK;GACL,aAAU;GACV,WAAU;GACV,WAAW,oBAAC,gBAAD,CAAiB,CAAA;GAC5B,SAAS;GAER,UAAA;EACK,CAAA,IACN,KAAA;EAEN,kBAAkB,qBAAqB,EAAE,KAAK,CAAC;EAC/C,WAAW,GAAG,mBAAmB,EAAE,KAAK,CAAC,GAAG,SAAS;EAarD,UAAA,oBAAC,YAAD;GACkB;GAChB,OAAO,cAAc,OAAO,UAAU,WAAW,QAAQ;GACzD,WAAW,GAAG,kBAAkB,aAAa;GAE5C;EACS,CAAA;CACN,CAAA;AAEZ"}
+{"version":3,"file":"sheet.js","names":[],"sources":["../../src/sheet/sheet.tsx"],"sourcesContent":["\"use client\";\n\nimport { cva } from \"class-variance-authority\";\nimport { forwardRef } from \"react\";\n\nimport { Button } from \"../button/button.js\";\nimport { cn } from \"../lib/cn.js\";\nimport { Dialog, type DialogProps } from \"../dialog/dialog.js\";\nimport { ScrollArea } from \"../scroll-area/scroll-area.js\";\n\n/**\n * Sheet: a dialog that arrives from an edge.\n *\n * A PRESET over `Dialog`, like `AlertDialog`. The legacy `sheet.tsx` is\n * `@radix-ui/react-dialog` again -- the same import, the same parts, the\n * same close button -- with one prop changing where it sits. Keeping a\n * second copy is how the legacy `dialog.tsx` and `alert-dialog.tsx`\n * drifted, and this is the same file for the third time.\n *\n * Census: 2 files, 3 uses. `side=\"right\"` twice, `side=\"left\"` once, and\n * `className` four times. `SheetHeader`, `SheetFooter`, `SheetTitle`,\n * `SheetDescription` and `SheetClose` are exported by the legacy and used\n * by NOBODY -- so all three sheets in the app render a `role=\"dialog\"`\n * with no title at all. Radix even warns about it in the console.\n *\n * `title` is required here, inherited from Dialog, so that is no longer\n * expressible.\n *\n * `side` is `\"left\" | \"right\"` only. The legacy also offers `\"top\"` and\n * `\"bottom\"`; both have zero call sites, and each is two lines to add the\n * day something needs one.\n *\n * A REAL BUG THE PORT FIXES: the legacy panel is `w-3/4 sm:max-w-sm`, and\n * `sm:max-w-sm` names `--container-sm`, which this repo does not define --\n * so in Alfred it would compile to NOTHING and the sheet would be 75% of\n * the viewport at every width, on a phone and on a 4K monitor alike. The\n * width here is a spacing-scale step that actually resolves.\n *\n * NOT PORTED: the slide-in animation. It comes from tailwindcss-animate,\n * which this repo does not ship. React Aria exposes `data-entering` and\n * `data-exiting`, and `--animate-*` tokens now exist, so it is a small\n * follow-up rather than a blocker.\n */\nexport const sheetOverlayVariants = cva(\"p-0\", {\n  variants: {\n    // The overlay is a flex box centring the panel. A sheet replaces that\n    // centring with an edge alignment rather than positioning the panel\n    // absolutely, so the scrim and the panel stay one layout.\n    side: {\n      left: \"justify-start items-stretch\",\n      right: \"justify-end items-stretch\",\n    },\n  },\n  defaultVariants: { side: \"right\" },\n});\n\nexport const sheetPanelVariants = cva(\n  [\n    // max-w-96 is 384px and RESOLVES. See the note above on sm:max-w-sm.\n    \"h-full w-full max-w-96\",\n    // Square against the edge it is attached to: a rounded corner flush\n    // with the viewport edge reads as a rendering fault.\n    \"rounded-none\",\n    \"max-h-full overflow-y-auto\",\n  ],\n  {\n    variants: {\n      side: {\n        left: \"border-y-0 border-s-0\",\n        right: \"border-y-0 border-e-0\",\n      },\n    },\n    defaultVariants: { side: \"right\" },\n  },\n);\n\n/**\n * A panel that arrives from the side.\n *\n * @example\n * <Sheet isOpen={open} onOpenChange={setOpen} title=\"Filters\">\n *   ...\n * </Sheet>\n */\nexport interface SheetProps extends Omit<DialogProps, \"overlayClassName\"> {\n  /**\n   * Which edge it is attached to.\n   *\n   * `\"top\"` and `\"bottom\"` exist in the legacy and have zero call sites.\n   *\n   * @default \"right\"\n   */\n  side?: \"left\" | \"right\";\n  /**\n   * Show a back control, and what it does.\n   *\n   * A side panel that goes a level deeper REPLACES its own contents rather\n   * than stacking a second modal on top, so the browser's back affordance and\n   * the escape key both do the wrong thing -- they close the whole panel\n   * instead of returning one level. The product's own note calls this the\n   * thing that \"makes items 119 and 120 one change rather than two\".\n   */\n  onBack?: () => void;\n  /** Accessible name and label for the back control. @default \"Back\" */\n  backLabel?: string;\n  /**\n   * Change this when the panel's contents change, and the body scrolls back\n   * to the top.\n   *\n   * Going a level deeper and landing halfway down the new view is\n   * disorienting, and it is the kind of thing every call site forgets --\n   * which is why it belongs here rather than in each of them.\n   */\n  scrollResetKey?: string | number;\n  /** Extra classes for the scrolling body region. */\n  bodyClassName?: string;\n  /**\n   * Names the scrolling body region. Defaults to `title` when that is a\n   * string, which it is at every call site in the product.\n   *\n   * The body is a `ScrollArea`, so it is focusable -- a scrollable region that\n   * is not reachable by keyboard is WCAG 2.1.1, and axe caught exactly that\n   * when this was a plain div. The product's own `SidePanelBody` still is one.\n   * A focusable element needs a role and a role needs a name, so this is the\n   * only combination that is actually correct.\n   */\n  bodyLabel?: string;\n}\n\nfunction BackArrowGlyph() {\n  return (\n    <svg\n      aria-hidden=\"true\"\n      viewBox=\"0 0 16 16\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"1.5\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      // Logical, so it points the right way once the panel mirrors in RTL.\n      className=\"size-(--icon-sm) rtl:-scale-x-100\"\n    >\n      <path d=\"M10 3 5 8l5 5\" />\n    </svg>\n  );\n}\n\nexport const Sheet = forwardRef<HTMLElement, SheetProps>(function Sheet(\n  {\n    side = \"right\",\n    className,\n    onBack,\n    backLabel = \"Back\",\n    scrollResetKey,\n    bodyClassName,\n    bodyLabel,\n    title,\n    children,\n    ...props\n  },\n  ref,\n) {\n  return (\n    /*\n      No data-slot here. Dialog spreads its props onto the ModalOverlay and\n      writes data-slot=\"dialog-overlay\" AFTER the spread, so a data-slot\n      passed from here is overwritten before it reaches the DOM -- it read as\n      working while rendering nothing. A sheet is identified by its side\n      variant and its panel classes instead.\n    */\n    <Dialog\n      entrance=\"none\"\n      {...props}\n      ref={ref}\n      title={title}\n      beforeTitle={\n        onBack ? (\n          <Button\n            variant=\"ghost\"\n            size=\"sm\"\n            data-slot=\"sheet-back\"\n            className=\"-ms-2 w-fit\"\n            startIcon={<BackArrowGlyph />}\n            onPress={onBack}\n          >\n            {backLabel}\n          </Button>\n        ) : undefined\n      }\n      overlayClassName={sheetOverlayVariants({ side })}\n      className={cn(sheetPanelVariants({ side }), className)}\n    >\n      {/*\n        The scrolling region is its own element so the title and the back\n        control stay put while the content moves. A panel that scrolled as one\n        block would take its own heading off screen.\n      */}\n      {/*\n        No data-slot=\"sheet-body\" here, for the same reason the overlay has\n        none: ScrollArea spreads its props and writes data-slot=\"scroll-area\"\n        AFTER the spread, so one passed from here is overwritten before it\n        reaches the DOM. It read as wired while selecting nothing.\n      */}\n      <ScrollArea\n        scrollResetKey={scrollResetKey}\n        label={bodyLabel ?? (typeof title === \"string\" ? title : \"\")}\n        className={cn(\"min-h-0 flex-1\", bodyClassName)}\n      >\n        {children}\n      </ScrollArea>\n    </Dialog>\n  );\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,uBAAuB,IAAI,OAAO;CAC7C,UAAU,EAIR,MAAM;EACJ,MAAM;EACN,OAAO;CACT,EACF;CACA,iBAAiB,EAAE,MAAM,QAAQ;AACnC,CAAC;AAED,MAAa,qBAAqB,IAChC;CAEE;CAGA;CACA;AACF,GACA;CACE,UAAU,EACR,MAAM;EACJ,MAAM;EACN,OAAO;CACT,EACF;CACA,iBAAiB,EAAE,MAAM,QAAQ;AACnC,CACF;AAuDA,SAAS,iBAAiB;CACxB,OACE,oBAAC,OAAD;EACE,eAAY;EACZ,SAAQ;EACR,MAAK;EACL,QAAO;EACP,aAAY;EACZ,eAAc;EACd,gBAAe;EAEf,WAAU;EAEV,UAAA,oBAAC,QAAD,EAAM,GAAE,gBAAiB,CAAA;CACtB,CAAA;AAET;AAEA,MAAa,QAAQ,WAAoC,SAAS,MAChE,EACE,OAAO,SACP,WACA,QACA,YAAY,QACZ,gBACA,eACA,WACA,OACA,UACA,GAAG,SAEL,KACA;CACA,OAQE,oBAAC,QAAD;EACE,UAAS;EACT,GAAI;EACC;EACE;EACP,aACE,SACE,oBAAC,QAAD;GACE,SAAQ;GACR,MAAK;GACL,aAAU;GACV,WAAU;GACV,WAAW,oBAAC,gBAAD,CAAiB,CAAA;GAC5B,SAAS;GAER,UAAA;EACK,CAAA,IACN,KAAA;EAEN,kBAAkB,qBAAqB,EAAE,KAAK,CAAC;EAC/C,WAAW,GAAG,mBAAmB,EAAE,KAAK,CAAC,GAAG,SAAS;EAarD,UAAA,oBAAC,YAAD;GACkB;GAChB,OAAO,cAAc,OAAO,UAAU,WAAW,QAAQ;GACzD,WAAW,GAAG,kBAAkB,aAAa;GAE5C;EACS,CAAA;CACN,CAAA;AAEZ,CAAC"}

package/dist/side-nav/index.d.ts

@@ -0,0 +1,2 @@
+import { SideNav, SideNavGroup, SideNavProps, SideNavSection, sideNavHeaderVariants, sideNavItemVariants, sideNavMenuVariants, sideNavVariants } from "./side-nav.js";
+export { SideNav, type SideNavGroup, type SideNavProps, type SideNavSection, sideNavHeaderVariants, sideNavItemVariants, sideNavMenuVariants, sideNavVariants };

package/dist/side-nav/index.js

@@ -0,0 +1,2 @@
+import { SideNav, sideNavHeaderVariants, sideNavItemVariants, sideNavMenuVariants, sideNavVariants } from "./side-nav.js";
+export { SideNav, sideNavHeaderVariants, sideNavItemVariants, sideNavMenuVariants, sideNavVariants };

package/dist/side-nav/side-nav.d.ts

@@ -0,0 +1,72 @@
+import { ReactNode } from "react";
+//#region src/side-nav/side-nav.d.ts
+/**
+ * SideNav: the sections of one screen, listed down its side.
+ *
+ * A row of tabs holds a handful of choices. Past about eight it no longer
+ * fits a laptop, hides its ends off the edge and stops being a switch: it is
+ * a list of sections. SideNav lists them vertically, grouped under plain
+ * headings, and shows the chosen one beside the list.
+ *
+ * WIDE (its own box at least 48rem: a container query, so it follows the
+ * space the page gives it, not the window): the grouped list on the inline
+ * start, sticky while the section scrolls. It is React Aria's ListBox with one
+ * section per group, so each group is announced by its heading; the up and
+ * down arrows move through every section ACROSS the groups and choose as
+ * they go (the same automatic activation as Tabs); Home and End jump to the
+ * ends; typing a section's first letters jumps to it.
+ *
+ * NARROW (under 48rem): a column of sections does not fit beside anything on
+ * a phone, so the list gives way to one Select above the body.
+ *
+ * The chosen section's title is the body's `<h2>`, one size for every
+ * section, with the screen's description of that section under it -- so no
+ * section draws its own title at its own size.
+ *
+ * WHY NOT `Tabs orientation="vertical"`: React Aria's TabList is a flat
+ * collection with no sections, so it cannot carry group headings, and a
+ * heading placed among the tabs would be announced as part of a tab's name.
+ * A group with no sections is not drawn.
+ */
+export declare const sideNavVariants: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
+export declare const sideNavMenuVariants: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
+export declare const sideNavHeaderVariants: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
+export declare const sideNavItemVariants: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
+/** One section of the screen. */
+export interface SideNavSection {
+  /** The section's key, reported by `onSelectionChange`. */
+  id: string;
+  /** Its name in the menu, and the body's heading while it is chosen. */
+  label: string;
+}
+/** A heading and the sections under it. */
+export interface SideNavGroup {
+  /** The plain heading the sections sit under. */
+  label: string;
+  /** The group's sections, in order. A group with none is not drawn. */
+  sections: readonly SideNavSection[];
+}
+export interface SideNavProps {
+  /** What the menu is for. Names the navigation landmark and the list. */
+  "aria-label": string;
+  /** The sections, grouped. */
+  groups: readonly SideNavGroup[];
+  /** The chosen section's `id`. Controlled: the screen owns it (often in the URL). */
+  selectedKey: string;
+  /** Called with a section's `id` when a different one is chosen. */
+  onSelectionChange: (key: string) => void;
+  /**
+   * The visible label of the Select that replaces the menu under 48rem wide.
+   * @default "Section"
+   */
+  selectLabel?: string;
+  /** One or two sentences under the chosen section's title. */
+  description?: ReactNode;
+  /** The chosen section's body. */
+  children?: ReactNode;
+  /** Extra classes for the root. Merged last. */
+  className?: string;
+}
+export declare const SideNav: import("react").ForwardRefExoticComponent<SideNavProps & import("react").RefAttributes<HTMLDivElement>>;
+//#endregion
+//# sourceMappingURL=side-nav.d.ts.map