@capra/core 1.12.0 → 1.13.0

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import * as React$1 from "react";
-import React, { Suspense, useCallback, useState } from "react";
-import { AnglesLeft, AnglesRight, ArrowUpRightFromSquare, AttentionOutlined, AttentionSolid, CalendarNextOutlined, CalendarOutlined, CalendarPrevOutlined, CaretRight, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, CircleXmark, CloseOutlined, DragGrip, Exclamation, EyeInvisibleOutlined, EyeOutlined, InfoOutlined, InfoSolid, Loading, SuccessOutlined, SuccessSolid, SwapRightOutlined, WarningOutlined, WarningSolid } from "@capra/icons";
-import { Breadcrumb as Breadcrumb$1, Breadcrumbs as Breadcrumbs$1, Button as Button$1, ButtonContext, Calendar, CalendarCell, CalendarGrid, CalendarGridBody, CalendarGridHeader, CalendarHeaderCell, Collection, ComboBox, DateInput, DatePicker, DatePickerStateContext, DateRangePicker, DateRangePickerStateContext, DateSegment, Dialog, DialogTrigger, Disclosure, DisclosurePanel, Focusable, Group, Header, Heading, HeadingContext, Input, InputContext, LabelContext, Link as Link$1, ListBox, ListBoxItem, Menu as Menu$1, MenuItem, MenuSection, MenuTrigger, Modal as Modal$1, ModalOverlay, NumberField as NumberField$1, OverlayArrow, OverlayTriggerStateContext, Popover as Popover$1, Pressable, RangeCalendar, RangeCalendarStateContext, RouterProvider, Separator, SubmenuTrigger, Text as Text$1, TextArea as TextArea$1, TextContext, TextField as TextField$1, Tooltip as Tooltip$1, TooltipTrigger, Tree as Tree$1, TreeItem, TreeItemContent, composeRenderProps, useContextProps, useSlottedContext } from "react-aria-components";
-import { FocusScope, UNSAFE_PortalProvider, useDateFormatter, useFocusWithin, usePreventScroll } from "react-aria";
+import React, { Suspense } from "react";
+import { AnglesLeft, AnglesRight, ArrowUpRightFromSquare, AttentionOutlined, AttentionSolid, CalendarNextOutlined, CalendarOutlined, CalendarPrevOutlined, CaretRight, CheckOutlined, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, CircleXmark, CloseOutlined, DragGrip, Exclamation, EyeInvisibleOutlined, EyeOutlined, InfoOutlined, InfoSolid, Loading, SuccessOutlined, SuccessSolid, SwapRightOutlined, WarningOutlined, WarningSolid } from "@capra/icons";
+import { Autocomplete, Breadcrumb as Breadcrumb$1, Breadcrumbs as Breadcrumbs$1, Button as Button$1, ButtonContext, Calendar, CalendarCell, CalendarGrid, CalendarGridBody, CalendarGridHeader, CalendarHeaderCell, Collection, ComboBox, DateInput, DatePicker, DatePickerStateContext, DateRangePicker, DateRangePickerStateContext, DateSegment, Dialog, DialogTrigger, Disclosure, DisclosurePanel, FieldInputContext, Focusable, Group, Header, Heading, HeadingContext, Input, InputContext, LabelContext, Link as Link$1, ListBox, ListBoxItem, ListBoxSection, Menu as Menu$1, MenuItem, MenuSection, MenuTrigger, Modal as Modal$1, ModalOverlay, NumberField as NumberField$1, OverlayArrow, OverlayTriggerStateContext, Popover as Popover$1, Pressable, RangeCalendar, RangeCalendarStateContext, RouterProvider, Select, SelectStateContext, SelectValue, Separator, SubmenuTrigger, Tag as Tag$1, TagGroup, TagList, Text as Text$1, TextArea as TextArea$1, TextContext, TextField as TextField$1, Tooltip as Tooltip$1, TooltipTrigger, Tree as Tree$1, TreeItem, TreeItemContent, composeRenderProps, useContextProps, useFilter, useSlottedContext } from "react-aria-components";
+import { FocusScope, UNSAFE_PortalProvider, mergeProps, useButton, useDateFormatter, useFocusRing, useFocusWithin, usePreventScroll } from "react-aria";
 import { createRoot } from "react-dom/client";
 import { createPortal } from "react-dom";
 //#region ../../node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/lite.mjs
@@ -323,11 +323,50 @@ HelperText.displayName = "HelperText";
 //#endregion
 //#region src/components/input-helpers/fieldLayout.module.css
 var fieldLayout_module_default = {
-	"field": "capra-fieldLayout-module-GZD11W-field",
-	"fieldContent": "capra-fieldLayout-module-GZD11W-fieldContent",
-	"labelRow": "capra-fieldLayout-module-GZD11W-labelRow"
+	"field": "capra-fieldLayout-module-0mM4jW-field",
+	"fieldContent": "capra-fieldLayout-module-0mM4jW-fieldContent",
+	"labelRow": "capra-fieldLayout-module-0mM4jW-labelRow"
 };
 //#endregion
+//#region src/components/input-helpers/useAnchorWidth.ts
+/**
+* Element that visually bounds the field (select trigger or text input shell). The popover matches
+* its width and left edge, which differs from the field root in horizontal layouts where the label
+* sits beside the control.
+*/
+function getShellElement(anchor) {
+	return anchor.querySelector("[data-capra-anchor-width-target]") ?? anchor.querySelector("[data-capra-text-input]") ?? anchor;
+}
+/** Element React Aria anchors the popover to: the select trigger or the combobox input. */
+function getTriggerElement(anchor) {
+	return anchor.querySelector("[data-capra-anchor-width-target]") ?? anchor.querySelector("input") ?? anchor;
+}
+function useAnchorWidth(additionalDependencies = []) {
+	const anchorRef = React$1.useRef(null);
+	const [width, setWidth] = React$1.useState(null);
+	const [offset, setOffset] = React$1.useState(0);
+	React$1.useEffect(() => {
+		const anchor = anchorRef.current;
+		if (!anchor) return;
+		const measure = () => {
+			const shell = getShellElement(anchor);
+			const trigger = getTriggerElement(anchor);
+			setWidth(shell.offsetWidth + "px");
+			setOffset(shell.getBoundingClientRect().left - trigger.getBoundingClientRect().left);
+		};
+		const observer = new ResizeObserver(measure);
+		observer.observe(anchor);
+		const shell = getShellElement(anchor);
+		if (shell !== anchor) observer.observe(shell);
+		return () => observer.disconnect();
+	}, additionalDependencies);
+	return [
+		anchorRef,
+		width,
+		offset
+	];
+}
+//#endregion
 //#region src/components/Autocomplete/AutocompleteField.module.css
 var AutocompleteField_module_default = {
 	"item": "capra-AutocompleteField-module-MVvKYa-item",
@@ -386,41 +425,6 @@ function AutocompleteFieldWithoutRef(props, ref) {
 		style: { width: shouldAutoSizeDropdown ? width : void 0 }
 	}, /* @__PURE__ */ React.createElement(ListBox, { className: AutocompleteField_module_default.listbox }, children)));
 }
-function useResizeObserver({ ref, onResize, additionalDependencies = [] }) {
-	React.useEffect(() => {
-		if (!ref.current) return;
-		const observer = new ResizeObserver((entries) => {
-			onResize(entries[0]);
-		});
-		observer.observe(ref.current);
-		return () => observer.disconnect();
-	}, [
-		ref,
-		onResize,
-		...additionalDependencies
-	]);
-}
-function useAnchorWidth(additionalDependencies = []) {
-	const anchorRef = React.useRef(null);
-	const [width, setWidth] = useState(null);
-	const [offset, setOffset] = useState(0);
-	useResizeObserver({
-		ref: anchorRef,
-		onResize: useCallback(() => {
-			if (anchorRef.current) {
-				setWidth(anchorRef.current.offsetWidth + "px");
-				const input = anchorRef.current.querySelector("input");
-				if (input) setOffset(anchorRef.current.offsetLeft - input.offsetLeft);
-			}
-		}, [anchorRef]),
-		additionalDependencies
-	});
-	return [
-		anchorRef,
-		width,
-		offset
-	];
-}
 /**
 * AutocompleteField combines a text field with a suggestions list. Consumers can supply static `AutocompleteField.Item` children or an `items` collection with an optional default item renderer. The field allows custom values that are not in the list.
 */
@@ -811,7 +815,7 @@ function RadioTileWithoutRef({ children, checked, disabled, description, icon, F
 const RadioTile = fixedForwardRef(RadioTileWithoutRef);
 //#endregion
 //#region src/components/Switch/Switch.module.css
-var Switch_module_default = { "switch": "capra-Switch-module-16LYpW-switch" };
+var Switch_module_default = { "switch": "capra-Switch-module-j8Yc-q-switch" };
 //#endregion
 //#region src/components/Switch/Switch.tsx
 const Switch = React$1.forwardRef((props, ref) => {
@@ -2290,6 +2294,430 @@ const DatePickerFieldWithRef = React$1.forwardRef(DatePickerFieldInner);
 DatePickerFieldWithRef.displayName = "DatePickerField";
 const DatePickerField = DatePickerFieldWithRef;
 //#endregion
+//#region src/components/SelectField/SelectField.module.css
+var SelectField_module_default = {
+	"chevron": "capra-SelectField-module-1X4diq-chevron",
+	"dropdownPanel": "capra-SelectField-module-1X4diq-dropdownPanel",
+	"emptyState": "capra-SelectField-module-1X4diq-emptyState",
+	"errorIndicator": "capra-SelectField-module-1X4diq-errorIndicator",
+	"header": "capra-SelectField-module-1X4diq-header",
+	"item": "capra-SelectField-module-1X4diq-item",
+	"itemCheck": "capra-SelectField-module-1X4diq-itemCheck",
+	"itemContent": "capra-SelectField-module-1X4diq-itemContent",
+	"leadingSlot": "capra-SelectField-module-1X4diq-leadingSlot",
+	"listbox": "capra-SelectField-module-1X4diq-listbox",
+	"multipleOpenButton": "capra-SelectField-module-1X4diq-multipleOpenButton",
+	"multipleTrigger": "capra-SelectField-module-1X4diq-multipleTrigger",
+	"search": "capra-SelectField-module-1X4diq-search",
+	"section": "capra-SelectField-module-1X4diq-section",
+	"singleTrigger": "capra-SelectField-module-1X4diq-singleTrigger",
+	"tag": "capra-SelectField-module-1X4diq-tag",
+	"tagGroup": "capra-SelectField-module-1X4diq-tagGroup",
+	"tagIcon": "capra-SelectField-module-1X4diq-tagIcon",
+	"tagLabel": "capra-SelectField-module-1X4diq-tagLabel",
+	"tagList": "capra-SelectField-module-1X4diq-tagList",
+	"tagRemove": "capra-SelectField-module-1X4diq-tagRemove",
+	"trailingSlot": "capra-SelectField-module-1X4diq-trailingSlot",
+	"triggerShell": "capra-SelectField-module-1X4diq-triggerShell",
+	"value": "capra-SelectField-module-1X4diq-value",
+	"valueIcon": "capra-SelectField-module-1X4diq-valueIcon",
+	"valueText": "capra-SelectField-module-1X4diq-valueText",
+	"warningIndicator": "capra-SelectField-module-1X4diq-warningIndicator"
+};
+//#endregion
+//#region src/components/SelectField/SelectField.tsx
+/** When true, SelectField.Item indents by default (inside SelectField.Section that contains SelectField.Header). */
+const SelectFieldSectionIndentContext = React$1.createContext(false);
+function normalizeIterable(value) {
+	return value === void 0 ? void 0 : Array.from(value);
+}
+function getItemLabelFromNode(node) {
+	if (typeof node === "string") return node;
+	if (typeof node === "number") return String(node);
+	if (React$1.isValidElement(node)) {
+		if (typeof node.props.textValue === "string") return node.props.textValue;
+		return getItemLabelFromNode(node.props.children);
+	}
+	return "";
+}
+function removeKeysFromSelection(selection, keys) {
+	return (selection ?? []).filter((selectedKey) => !keys.has(selectedKey));
+}
+function getItemIcon(item) {
+	if (item && typeof item === "object" && "icon" in item) {
+		const icon = item.icon;
+		return icon && typeof icon === "object" && "__brand" in icon ? icon : void 0;
+	}
+}
+function isDefaultSection(item) {
+	const children = item.children;
+	return children != null && typeof children !== "string" && typeof children[Symbol.iterator] === "function";
+}
+function SelectFieldIndicators(props) {
+	const { appearance } = props;
+	return /* @__PURE__ */ React$1.createElement(React$1.Fragment, null, appearance === "warning" ? /* @__PURE__ */ React$1.createElement("span", {
+		className: SelectField_module_default.warningIndicator,
+		"aria-hidden": true
+	}, /* @__PURE__ */ React$1.createElement(WarningOutlined, { size: "sm" })) : null, appearance === "danger" ? /* @__PURE__ */ React$1.createElement("span", {
+		className: SelectField_module_default.errorIndicator,
+		"aria-hidden": true
+	}, /* @__PURE__ */ React$1.createElement(Exclamation, { size: "sm" })) : null, /* @__PURE__ */ React$1.createElement("span", {
+		className: SelectField_module_default.chevron,
+		"aria-hidden": true
+	}, /* @__PURE__ */ React$1.createElement(ChevronDown, { size: "sm" })));
+}
+function SelectFieldTriggerButton(props) {
+	const { appearance, buttonRef, children, className, ...rest } = props;
+	const localRef = React$1.useRef(null);
+	const ref = buttonRef ?? localRef;
+	const [mergedProps, mergedRef] = useContextProps({
+		...rest,
+		className
+	}, ref, ButtonContext);
+	const { buttonProps, isPressed } = useButton(mergedProps, mergedRef);
+	const { focusProps, isFocused, isFocusVisible } = useFocusRing(mergedProps);
+	return /* @__PURE__ */ React$1.createElement("button", {
+		...mergeProps(buttonProps, focusProps),
+		ref: mergedRef,
+		className,
+		"aria-invalid": appearance === "danger" ? true : void 0,
+		"data-pressed": isPressed || void 0,
+		"data-focused": isFocused || void 0,
+		"data-focus-visible": isFocusVisible || void 0,
+		"data-disabled": mergedProps.isDisabled || void 0
+	}, children);
+}
+function SelectFieldTrigger(props) {
+	const { appearance, disabled, leadingSlot, placeholder, required, selectedItemsLabel, size, triggerRef } = props;
+	const state = React$1.useContext(SelectStateContext);
+	const openButtonRef = React$1.useRef(null);
+	if (!state) return null;
+	if (!(state.selectionManager.selectionMode === "multiple")) return /* @__PURE__ */ React$1.createElement(SelectFieldTriggerButton, {
+		appearance,
+		className: clsx(SelectField_module_default.triggerShell, SelectField_module_default.singleTrigger),
+		"data-capra-anchor-width-target": "",
+		"data-size": size,
+		"data-disabled": disabled || void 0,
+		"aria-required": required || void 0,
+		isDisabled: disabled
+	}, leadingSlot ? /* @__PURE__ */ React$1.createElement("span", { className: SelectField_module_default.leadingSlot }, leadingSlot) : null, /* @__PURE__ */ React$1.createElement(SelectValue, { className: SelectField_module_default.value }, ({ isPlaceholder, selectedText, selectedItems }) => {
+		const ValueIcon = getItemIcon(selectedItems[0]);
+		return /* @__PURE__ */ React$1.createElement(React$1.Fragment, null, ValueIcon ? /* @__PURE__ */ React$1.createElement("span", {
+			className: SelectField_module_default.valueIcon,
+			"aria-hidden": true
+		}, /* @__PURE__ */ React$1.createElement(ValueIcon, { size: "sm" })) : null, /* @__PURE__ */ React$1.createElement("span", {
+			className: SelectField_module_default.valueText,
+			"data-placeholder": isPlaceholder || !selectedText || void 0
+		}, selectedText || placeholder));
+	}), /* @__PURE__ */ React$1.createElement("span", { className: SelectField_module_default.trailingSlot }, /* @__PURE__ */ React$1.createElement(SelectFieldIndicators, { appearance })));
+	const hasSelection = !state.selectionManager.isEmpty;
+	const handleEmptyTriggerPress = (event) => {
+		if (disabled || hasSelection || state.isOpen) return;
+		if (event.target.closest("button")) return;
+		openButtonRef.current?.focus();
+		state.open();
+	};
+	return /* @__PURE__ */ React$1.createElement(Group, {
+		ref: triggerRef,
+		className: clsx(SelectField_module_default.triggerShell, SelectField_module_default.multipleTrigger),
+		"data-capra-anchor-width-target": "",
+		"data-size": size,
+		"data-disabled": disabled || void 0,
+		"data-empty": hasSelection ? void 0 : "",
+		onClick: handleEmptyTriggerPress
+	}, leadingSlot ? /* @__PURE__ */ React$1.createElement("span", { className: SelectField_module_default.leadingSlot }, leadingSlot) : null, /* @__PURE__ */ React$1.createElement(ButtonContext.Provider, { value: null }, /* @__PURE__ */ React$1.createElement(SelectValue, { className: SelectField_module_default.value }, ({ state: selectState }) => {
+		const tagItems = selectState.selectedItems.filter((item) => item != null).map((item) => ({
+			id: item.key,
+			label: item.textValue || getItemLabelFromNode(item.rendered) || String(item.key),
+			icon: getItemIcon(item.value)
+		}));
+		return /* @__PURE__ */ React$1.createElement(TagGroup, {
+			"aria-label": selectedItemsLabel,
+			className: SelectField_module_default.tagGroup,
+			onRemove: disabled ? void 0 : (keys) => {
+				const value = selectState.value;
+				if (Array.isArray(value)) selectState.setValue(removeKeysFromSelection(value, keys));
+			}
+		}, /* @__PURE__ */ React$1.createElement(TagList, {
+			className: SelectField_module_default.tagList,
+			items: tagItems,
+			renderEmptyState: () => /* @__PURE__ */ React$1.createElement("span", {
+				className: SelectField_module_default.valueText,
+				"data-placeholder": placeholder ? true : void 0
+			}, placeholder)
+		}, (item) => /* @__PURE__ */ React$1.createElement(Tag$1, {
+			id: item.id,
+			textValue: item.label,
+			className: SelectField_module_default.tag,
+			"data-size": size === "sm" ? "sm" : "md"
+		}, ({ allowsRemoving }) => /* @__PURE__ */ React$1.createElement(React$1.Fragment, null, item.icon ? /* @__PURE__ */ React$1.createElement("span", {
+			className: SelectField_module_default.tagIcon,
+			"aria-hidden": true
+		}, /* @__PURE__ */ React$1.createElement(item.icon, { size: "xs" })) : null, /* @__PURE__ */ React$1.createElement("span", { className: SelectField_module_default.tagLabel }, item.label), allowsRemoving ? /* @__PURE__ */ React$1.createElement(Button$1, {
+			slot: "remove",
+			className: SelectField_module_default.tagRemove,
+			"aria-label": "Delete",
+			excludeFromTabOrder: true
+		}, /* @__PURE__ */ React$1.createElement(CloseOutlined, { size: "xs" })) : null))));
+	})), /* @__PURE__ */ React$1.createElement(SelectFieldTriggerButton, {
+		appearance,
+		buttonRef: openButtonRef,
+		className: SelectField_module_default.multipleOpenButton,
+		isDisabled: disabled,
+		"aria-required": required || void 0
+	}, /* @__PURE__ */ React$1.createElement("span", { className: SelectField_module_default.trailingSlot }, /* @__PURE__ */ React$1.createElement(SelectFieldIndicators, { appearance }))));
+}
+function SelectFieldItem(props) {
+	const { id, textValue, isDisabled, indent: indentProp, value, children } = props;
+	const indentFromSectionHeader = React$1.useContext(SelectFieldSectionIndentContext);
+	const indent = indentProp !== void 0 ? indentProp : indentFromSectionHeader;
+	return /* @__PURE__ */ React$1.createElement(ListBoxItem, {
+		id,
+		value,
+		textValue: textValue || getItemLabelFromNode(children),
+		isDisabled,
+		className: SelectField_module_default.item,
+		"data-indent": indent || void 0
+	}, ({ isSelected, selectionMode }) => /* @__PURE__ */ React$1.createElement("div", { className: SelectField_module_default.itemContent }, selectionMode === "multiple" ? /* @__PURE__ */ React$1.createElement("span", {
+		className: SelectField_module_default.itemCheck,
+		"data-selected": isSelected || void 0,
+		"aria-hidden": true
+	}, isSelected ? /* @__PURE__ */ React$1.createElement(CheckOutlined, { size: "sm" }) : null) : null, typeof children === "string" ? /* @__PURE__ */ React$1.createElement(Text, { slot: "label" }, children) : children));
+}
+function SelectFieldHeader(props) {
+	const { id, label = "Header", FORCE__className: classNameOverride, children } = props;
+	return /* @__PURE__ */ React$1.createElement(Header, {
+		id,
+		className: clsx(SelectField_module_default.header, classNameOverride)
+	}, children ?? label);
+}
+SelectFieldHeader.displayName = "SelectField.Header";
+function isSelectFieldHeaderElement(child) {
+	return React$1.isValidElement(child) && child.type === SelectFieldHeader;
+}
+function SelectFieldSection(props) {
+	const { children, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, FORCE__className: classNameOverride, className, ...rest } = props;
+	const autoHeaderId = React$1.useId();
+	const childArray = React$1.Children.toArray(children);
+	let headerIndex = -1;
+	for (let i = 0; i < childArray.length; i++) if (isSelectFieldHeaderElement(childArray[i])) {
+		headerIndex = i;
+		break;
+	}
+	const hasHeader = headerIndex >= 0;
+	if (process.env.NODE_ENV !== "production") {
+		if (!hasHeader && !ariaLabel?.trim() && !ariaLabelledBy?.trim()) console.error("SelectField.Section: provide aria-label or aria-labelledby when the section has no direct SelectField.Header child.");
+	}
+	const labelledBy = hasHeader ? ariaLabelledBy ?? autoHeaderId : ariaLabelledBy;
+	const effectiveAriaLabel = hasHeader ? void 0 : ariaLabel;
+	const resolvedChildren = hasHeader && headerIndex >= 0 ? childArray.map((child, i) => {
+		if (i === headerIndex && isSelectFieldHeaderElement(child)) return React$1.cloneElement(child, { id: child.props.id ?? autoHeaderId });
+		return child;
+	}) : children;
+	return /* @__PURE__ */ React$1.createElement(SelectFieldSectionIndentContext.Provider, { value: hasHeader }, /* @__PURE__ */ React$1.createElement(ListBoxSection, {
+		"aria-label": effectiveAriaLabel,
+		"aria-labelledby": labelledBy,
+		className: clsx(SelectField_module_default.section, className, classNameOverride),
+		...rest
+	}, resolvedChildren));
+}
+SelectFieldSection.displayName = "SelectField.Section";
+function defaultSelectFieldItemRenderer(item) {
+	if (isDefaultSection(item)) {
+		const { id, label, "aria-label": ariaLabel, children } = item;
+		return /* @__PURE__ */ React$1.createElement(SelectFieldSection, {
+			key: String(id),
+			"aria-label": label ? void 0 : ariaLabel
+		}, label ? /* @__PURE__ */ React$1.createElement(SelectFieldHeader, { label }) : null, /* @__PURE__ */ React$1.createElement(Collection, { items: children }, (child) => defaultSelectFieldItemRenderer(child)));
+	}
+	const Icon = item.icon;
+	return /* @__PURE__ */ React$1.createElement(SelectFieldItem, {
+		id: item.id,
+		textValue: item.label
+	}, Icon ? /* @__PURE__ */ React$1.createElement(React$1.Fragment, null, /* @__PURE__ */ React$1.createElement(Icon, { size: "sm" }), /* @__PURE__ */ React$1.createElement(Text, { slot: "label" }, item.label)) : item.label);
+}
+function SelectFieldLabel(props) {
+	const { children, required } = props;
+	const { elementType: _elementType, ...labelContextWithoutElementType } = useSlottedContext(LabelContext) ?? {};
+	return /* @__PURE__ */ React$1.createElement(LabelContext.Provider, { value: labelContextWithoutElementType }, /* @__PURE__ */ React$1.createElement(Label, { required }, children));
+}
+function AutocompleteTextInput(props) {
+	const { placeholder, shouldFocus, size } = props;
+	const ref = React$1.useRef(null);
+	const [mergedProps, mergedRef] = useContextProps({
+		"aria-label": props["aria-label"],
+		placeholder,
+		type: "search"
+	}, ref, FieldInputContext);
+	const { onChange, value, ...inputProps } = mergedProps;
+	const inputRef = mergedRef;
+	React$1.useLayoutEffect(() => {
+		if (!shouldFocus) return;
+		const input = inputRef.current;
+		if (!input) return;
+		requestAnimationFrame(() => {
+			try {
+				input.focus({ preventScroll: true });
+			} catch {}
+		});
+	}, [inputRef, shouldFocus]);
+	return /* @__PURE__ */ React$1.createElement(TextInput, {
+		...inputProps,
+		ref: inputRef,
+		size,
+		value: typeof value === "string" ? value : "",
+		onChange: (event) => {
+			onChange?.(event.target.value);
+		}
+	});
+}
+function SelectFieldInner(props, ref) {
+	const { appearance = "default", autoFocus, canSearch, defaultOpen, disabled, disabledKeys, helperText, id, isOpen, items, children, label, layout, leadingSlot, name, onOpenChange, placeholder, required, searchPlaceholder, selectionMode = "single", shouldAutoSizeDropdown = true, size = "md", FORCE__className: classNameOverride, "aria-describedby": ariaDescribedBy, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy } = props;
+	const [searchValue, setSearchValue] = React$1.useState("");
+	const [popoverWidth, setPopoverWidth] = React$1.useState();
+	const [uncontrolledOpen, setUncontrolledOpen] = React$1.useState(Boolean(defaultOpen));
+	const isPopoverOpen = isOpen ?? uncontrolledOpen;
+	const { contains } = useFilter({ sensitivity: "base" });
+	const [anchorRef, width, offset] = useAnchorWidth([
+		canSearch,
+		selectionMode,
+		size
+	]);
+	const multipleTriggerRef = React$1.useRef(null);
+	const selectedItemsLabel = label ? `Selected ${label}` : ariaLabel ?? "Selected items";
+	React$1.useImperativeHandle(ref, () => anchorRef.current, [anchorRef]);
+	React$1.useLayoutEffect(() => {
+		const trigger = multipleTriggerRef.current ?? anchorRef.current;
+		if (selectionMode !== "multiple" || !isPopoverOpen || popoverWidth || !trigger) return;
+		setPopoverWidth(`${trigger.offsetWidth}px`);
+	}, [
+		isPopoverOpen,
+		popoverWidth,
+		selectionMode,
+		width,
+		anchorRef
+	]);
+	const itemList = React$1.useMemo(() => items ? Array.from(items) : void 0, [items]);
+	const resolvedChildren = children ?? (itemList ? defaultSelectFieldItemRenderer : void 0);
+	const handleOpenChange = React$1.useCallback((nextOpen) => {
+		if (isOpen === void 0) setUncontrolledOpen(nextOpen);
+		if (selectionMode === "multiple" && !nextOpen) setPopoverWidth(void 0);
+		if (!nextOpen) setSearchValue("");
+		onOpenChange?.(nextOpen);
+	}, [
+		isOpen,
+		onOpenChange,
+		selectionMode
+	]);
+	const dropdownWidth = selectionMode === "multiple" ? popoverWidth ?? width ?? void 0 : width ?? void 0;
+	const listBoxSearchProps = canSearch ? {
+		autoFocus: false,
+		renderEmptyState: () => /* @__PURE__ */ React$1.createElement("span", { className: SelectField_module_default.emptyState }, "No results")
+	} : {};
+	const listBox = /* @__PURE__ */ React$1.createElement(ListBox, {
+		...listBoxSearchProps,
+		className: SelectField_module_default.listbox,
+		"data-selection-mode": selectionMode,
+		items: itemList
+	}, resolvedChildren);
+	const popoverContent = canSearch ? /* @__PURE__ */ React$1.createElement(Autocomplete, {
+		filter: contains,
+		inputValue: searchValue,
+		onInputChange: setSearchValue
+	}, /* @__PURE__ */ React$1.createElement("div", { className: SelectField_module_default.search }, /* @__PURE__ */ React$1.createElement(AutocompleteTextInput, {
+		"aria-label": searchPlaceholder || "Search",
+		placeholder: searchPlaceholder || "Search",
+		shouldFocus: isPopoverOpen,
+		size
+	})), listBox) : listBox;
+	const selectContent = /* @__PURE__ */ React$1.createElement(React$1.Fragment, null, /* @__PURE__ */ React$1.createElement("div", { className: fieldLayout_module_default.labelRow }, /* @__PURE__ */ React$1.createElement(SelectFieldLabel, { required }, label)), /* @__PURE__ */ React$1.createElement("div", { className: fieldLayout_module_default.fieldContent }, /* @__PURE__ */ React$1.createElement(SelectFieldTrigger, {
+		appearance,
+		disabled,
+		leadingSlot,
+		placeholder,
+		required,
+		selectedItemsLabel,
+		size,
+		triggerRef: selectionMode === "multiple" ? multipleTriggerRef : void 0
+	}), /* @__PURE__ */ React$1.createElement(HelperText, {
+		appearance,
+		disabled
+	}, helperText)), /* @__PURE__ */ React$1.createElement(Popover$1, {
+		className: SelectField_module_default.dropdownPanel,
+		offset: 2,
+		crossOffset: offset,
+		triggerRef: selectionMode === "multiple" ? multipleTriggerRef : void 0,
+		style: { width: shouldAutoSizeDropdown ? dropdownWidth : void 0 }
+	}, popoverContent));
+	if (props.selectionMode === "multiple") {
+		const handleChange = (nextValue) => {
+			props.onChange?.(new Set(nextValue));
+		};
+		return /* @__PURE__ */ React$1.createElement(Select, {
+			id,
+			ref: anchorRef,
+			name,
+			className: clsx(fieldLayout_module_default.field, classNameOverride),
+			"data-capra-field-root": "",
+			"data-layout": layout,
+			isDisabled: disabled,
+			isRequired: required,
+			isInvalid: appearance === "danger",
+			validationBehavior: "aria",
+			placeholder,
+			selectionMode: "multiple",
+			disabledKeys,
+			value: normalizeIterable(props.value),
+			defaultValue: normalizeIterable(props.defaultValue),
+			onChange: handleChange,
+			isOpen,
+			defaultOpen,
+			onOpenChange: handleOpenChange,
+			autoFocus,
+			"aria-label": ariaLabel,
+			"aria-labelledby": ariaLabelledBy,
+			"aria-describedby": ariaDescribedBy
+		}, selectContent);
+	}
+	const handleChange = (nextValue) => {
+		props.onChange?.(nextValue ?? null);
+	};
+	return /* @__PURE__ */ React$1.createElement(Select, {
+		id,
+		ref: anchorRef,
+		name,
+		className: clsx(fieldLayout_module_default.field, classNameOverride),
+		"data-capra-field-root": "",
+		"data-layout": layout,
+		isDisabled: disabled,
+		isRequired: required,
+		isInvalid: appearance === "danger",
+		validationBehavior: "aria",
+		placeholder,
+		selectionMode: "single",
+		disabledKeys,
+		value: props.value,
+		defaultValue: props.defaultValue,
+		onChange: handleChange,
+		isOpen,
+		defaultOpen,
+		onOpenChange: handleOpenChange,
+		autoFocus,
+		"aria-label": ariaLabel,
+		"aria-labelledby": ariaLabelledBy,
+		"aria-describedby": ariaDescribedBy
+	}, selectContent);
+}
+const SelectFieldRoot = React$1.forwardRef(SelectFieldInner);
+/**
+* Composed select field with Capra label/helper text layout, single and multiple selection, and an optional popover search input.
+*/
+const SelectField = Object.assign(SelectFieldRoot, {
+	Item: SelectFieldItem,
+	Header: SelectFieldHeader,
+	Section: SelectFieldSection
+});
+//#endregion
 //#region src/components/DateRangePickerField/DateRangePickerField.module.css
 var DateRangePickerField_module_default = {
 	"cell": "capra-DateRangePickerField-module-QpPhpG-cell",
@@ -5169,4 +5597,4 @@ function Tree({ FORCE__className: classNameOverride, items, selectionMode = "mul
 	}, /* @__PURE__ */ React$1.createElement(Collection, { items }, renderTreeItem)));
 }
 //#endregion
-export { Alert, Anchor, AutocompleteField, Badge, BadgeLayout, Breadcrumb, Breadcrumbs, Button, ButtonLink, Card, Checkbox, Collapse, CustomTooltipTrigger, DatePickerField, DateRangePickerField, Divider, Drawer, EmptyState, IconButton, InputRow, Label, Link, ListItem, Menu, Modal, NumberField, Pagination, PasswordField, Pill, Popover, Radio, RadioGroup, RadioTile, Ribbon, RouterProvider, SKELETON_SIZE, SKELETON_SIZE_TOKENS, Skeleton, SkeletonGroup, Spinner, Switch, TabNav, Tag, Text, TextArea, TextField, Toast, Tooltip, TopNav, Tree, VerticalNavigation, VisuallyHidden, submenuPanelClassName, tagColors };
+export { Alert, Anchor, AutocompleteField, Badge, BadgeLayout, Breadcrumb, Breadcrumbs, Button, ButtonLink, Card, Checkbox, Collapse, CustomTooltipTrigger, DatePickerField, DateRangePickerField, Divider, Drawer, EmptyState, IconButton, InputRow, Label, Link, ListItem, Menu, Modal, NumberField, Pagination, PasswordField, Pill, Popover, Radio, RadioGroup, RadioTile, Ribbon, RouterProvider, SKELETON_SIZE, SKELETON_SIZE_TOKENS, SelectField, Skeleton, SkeletonGroup, Spinner, Switch, TabNav, Tag, Text, TextArea, TextField, Toast, Tooltip, TopNav, Tree, VerticalNavigation, VisuallyHidden, submenuPanelClassName, tagColors };