@windmorph/react 0.0.0-stage → 0.1.1

package/dist/components/select/Select.d.ts

@@ -0,0 +1,187 @@
+import { Density } from "../../tokens/density.js";
+import { WrapperRootDOMProps } from "../../utils/root-props.js";
+import { TextFieldVariant } from "../text-field/text-field-styles.js";
+import { FieldShellClassNames } from "./field-shell.js";
+import { OptionListClassNames } from "./option-list.js";
+import { AriaAttributes, CSSProperties, ReactNode, Ref } from "react";
+import { AriaSelectOptions } from "react-aria";
+import { Key as Key$1, Key as SelectKey } from "react-stately";
+import { SelectProps, SelectionMode } from "react-stately/useSelectState";
+//#region src/components/select/Select.d.ts
+/** How the options open: a menu under the field (M3), a bottom sheet, or a sheet on phones. */
+export type SelectPresentation = 'menu' | 'sheet' | 'auto';
+/** Words the Select shows or announces; override them for other languages. */
+export interface SelectLabels {
+  /** Shown in an empty list. @default "No options" */
+  empty: string;
+  /** The loading indicator's name. @default "Loading options" */
+  loading: string;
+  /** For more chosen options than fit: `+{count}`. @default (count) => `+${count}` */
+  more: (count: number) => string;
+  /** With `searchable`: the search field's placeholder and name. @default "Search" */
+  search: string;
+  /** With `searchable`: shown when no option matches the search. @default "No results" */
+  noResults: string;
+  /** The error icon's name (M3: "Error"). @default "Error" */
+  error: string;
+}
+/** A chosen option, as `renderValue` receives it. */
+export interface SelectedOption<T> {
+  key: Key$1;
+  /** Its plain text (`textValue`, or the item's text). */
+  textValue: string;
+  /** Its object from `items`, if the options come from `items`. */
+  value: T | null;
+}
+export interface SelectClassNames extends FieldShellClassNames, OptionListClassNames {
+  /** The text showing the chosen option(s) or the placeholder. */
+  value?: string;
+  /** With `searchable`: the search field. */
+  search?: string;
+  /**
+   * The bottom sheet the options open in (`presentation="sheet"`, or `"auto"` on compact
+   * windows): the sheet's surface, as its `classNames.panel`.
+   */
+  sheet?: string;
+}
+/** React Aria props this API names the library's way (`disabled`, `open`…), or leaves out. */
+type RenamedProps = 'isDisabled' | 'isRequired' | 'isInvalid' | 'isOpen' | 'label' | 'description' | 'validationState' | 'selectedKey' | 'defaultSelectedKey' | 'onSelectionChange' | 'shouldCloseOnSelect' | 'allowsEmptyCollection';
+type SelectProps$1<T extends object, M extends SelectionMode = 'single'> = Omit<SelectProps<T, M>, RenamedProps> & Pick<AriaSelectOptions<T, M>, 'id' | 'name' | 'autoComplete' | 'form'> & Omit<WrapperRootDOMProps, keyof SelectProps<T, M>> & {
+  /** The trigger button's id, for a `<label for>` or an error summary's link. */
+  id?: string;
+  /** The container style, as `TextField`'s: a filled surface or an outline. @default "filled" */
+  variant?: TextFieldVariant;
+  /**
+   * Web density, `0` to `-3`: each step takes 4px off the field (56px at 0, 44px at -3) and
+   * off its menu's options (44px at 0, 32px at -3). Left out, it takes the density of the
+   * nearest `ThemeProvider` or `ThemeScope`. M3 asks for density to be the reader's choice
+   * rather than a default, so prefer setting it there, from a setting.
+   * @default 0
+   */
+  density?: Density;
+  /** The field's label. Give `aria-label` instead when there's no visible label. */
+  label?: ReactNode;
+  /** Accessible name when there's no visible label. */
+  'aria-label'?: string;
+  /**
+   * Shown in the field when nothing is chosen. With a `label`, it appears once the label
+   * floats (on focus), as in `TextField`.
+   */
+  placeholder?: string;
+  /**
+   * Helper text below the field. Replaced visually by the error when invalid, and shown in
+   * the error colour while the field is invalid.
+   */
+  supportingText?: ReactNode;
+  /** Marks the field invalid (in addition to `validate` and `required`). */
+  invalid?: boolean;
+  /** A choice is required: adds the `*` to the label and validates on submit. */
+  required?: boolean;
+  /**
+   * Read as `invalid` when that's left out, for a form library that sets the attribute. The
+   * trigger is a button, which ARIA doesn't let carry `aria-invalid`, so the state reaches
+   * assistive technology as the field's error text, its description.
+   */
+  'aria-invalid'?: AriaAttributes['aria-invalid'];
+  /**
+   * Read as `required` when that's left out, for a form library that sets the attribute: the
+   * label's `*`, in the trigger's name (a button can't carry `aria-required`).
+   */
+  'aria-required'?: AriaAttributes['aria-required'];
+  /** Disables the field: it can't be focused or opened. @default false */
+  disabled?: boolean;
+  /**
+   * The choice can be seen but not changed: the menu doesn't open and the keyboard doesn't
+   * change it. The root gets `data-readonly`; say so in the supporting text (M3).
+   * @default false
+   */
+  readOnly?: boolean;
+  /** Decorative icon at the start, in a 48px box. */
+  leadingIcon?: ReactNode;
+  /**
+   * The icon shown before the arrow while the field is invalid (M3 strongly recommends one).
+   * Defaults to Material Symbols `error`, named by `labels.error`; `false` turns it off.
+   */
+  errorIcon?: ReactNode | false;
+  /** Whether the menu is open (controlled); with `defaultOpen` and `onOpenChange`. */
+  open?: boolean;
+  /**
+   * Whether choosing an option closes the menu.
+   * @default true for a single choice, false with `selectionMode="multiple"`
+   */
+  closeOnSelect?: boolean;
+  /**
+   * With `selectionMode="multiple"`, the most options that can be chosen; the rest show as
+   * disabled until one is removed.
+   */
+  maxSelections?: number;
+  /**
+   * `menu` (default) opens an M3 menu under the field on every window, as Compose's exposed
+   * dropdown menu does; `sheet` always opens a bottom sheet; `auto` opens a sheet on
+   * compact windows and a menu on larger ones, for long lists.
+   * @default "menu"
+   */
+  presentation?: SelectPresentation;
+  /**
+   * A search field at the top of the menu or sheet that filters the options as you type,
+   * for long lists (pair it with `presentation="auto"`). The search takes focus in the menu;
+   * a sheet shows the list first, so the keyboard doesn't cover it.
+   * @default false
+   */
+  searchable?: boolean;
+  /**
+   * With `searchable`: whether an option matches the search. Defaults to a match anywhere in
+   * its text, ignoring case and accents ("thai" finds "Thailand"). The option's `key` lets
+   * it match on more than its text, e.g. a country's ISO code.
+   */
+  filter?: (textValue: string, search: string, key: Key$1) => boolean;
+  /** With `searchable`: the typed text (controlled); cleared when the list closes. */
+  searchValue?: string;
+  /** With `searchable`: the initial typed text, when uncontrolled. @default "" */
+  defaultSearchValue?: string;
+  /**
+   * With `searchable`: called as the search changes. Given it, the app filters `items` itself
+   * (e.g. on a server, with `loading` meanwhile) and the built-in filter is off.
+   */
+  onSearchChange?: (search: string) => void;
+  /**
+   * What the field shows for the chosen option(s), e.g. a dialling code or a flag, instead of
+   * their text. Screen readers still hear the options' text.
+   */
+  renderValue?: (selected: SelectedOption<T>[]) => ReactNode;
+  /**
+   * Shows a loading indicator in the list, e.g. while options are fetched.
+   * The indicator's code loads when it first shows, and ahead of that when the field is
+   * hovered or focused while this prop is set at all, so pass `loading={false}` (rather than
+   * leaving it out) on a field that loads options.
+   */
+  loading?: boolean;
+  /** Words the Select shows or announces, for other languages. */
+  labels?: Partial<SelectLabels>;
+  /** Classes for the root element, merged with `classNames.root`; consumer classes win. */
+  className?: string;
+  /** Classes for each part, by slot. */
+  classNames?: SelectClassNames;
+  /** Inline styles for the root element. */
+  style?: CSSProperties;
+  /** Ref to the root `<div>` element. Use `triggerRef` for the field's button. */
+  ref?: Ref<HTMLDivElement>;
+  /** Ref to the field's button. */
+  triggerRef?: Ref<HTMLButtonElement>;
+};
+/**
+ * M3 exposed dropdown menu, read-only (Compose's `ExposedDropdownMenuBox` with a
+ * `PrimaryNotEditable` anchor): a text-field-styled button that opens a menu of options.
+ * Single or multiple selection, sections, descriptions and icons, typeahead, a hidden
+ * native `<select>` for forms, and validation as in `TextField` (React Aria `useSelect`).
+ *
+ * @example
+ * <Select label="Sort by" defaultValue="newest">
+ *   <SelectItem key="newest">Newest first</SelectItem>
+ *   <SelectItem key="price">Price, low to high</SelectItem>
+ * </Select>
+ */
+export declare function Select<T extends object, M extends SelectionMode = 'single'>(props: SelectProps$1<T, M>): import("react").JSX.Element;
+//#endregion
+export { type SelectKey, SelectProps$1 as SelectProps };
+//# sourceMappingURL=Select.d.ts.map

package/dist/components/select/Select.js

@@ -0,0 +1,319 @@
+"use client";
+import { densityAttribute } from "../../tokens/density.js";
+import { cn } from "../../utils/cn.js";
+import { usePreloadLoadingIndicator } from "../loading-indicator/lazy-loading-indicator.js";
+import { FOCUSABLE_DISABLED_OPTIONS } from "../../utils/focusable-disabled.js";
+import { assertCollectionChildren } from "../../utils/assert-collection-children.js";
+import { ariaFlag, pickDescriptionAria, splitRootProps } from "../../utils/root-props.js";
+import { useTypeaheadDelegate } from "../../utils/typeahead.js";
+import { LazyBottomSheet, usePreloadBottomSheet } from "../sheet/lazy-bottom-sheet.js";
+import { renderedDescription } from "../../utils/rendered-description.js";
+import { matchesSearch } from "../../utils/search.js";
+import { DropdownArrow, FieldShell, fieldState } from "./field-shell.js";
+import { OptionList, OptionPopover } from "./option-list.js";
+import { SearchList } from "./search-list.js";
+import { useSelectionCap } from "./selection-cap.js";
+import { useId, useRef, useSyncExternalStore } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { HiddenSelect, mergeProps, useButton, useFocusRing, useHover, useObjectRef, useSelect } from "react-aria";
+import { useControlledState } from "react-stately/useControlledState";
+import { useSelectState } from "react-stately/useSelectState";
+//#region src/components/select/Select.tsx
+const DEFAULT_LABELS = {
+	empty: "No options",
+	loading: "Loading options",
+	more: (count) => `+${count}`,
+	search: "Search",
+	noResults: "No results",
+	error: "Error"
+};
+const COMPACT_WINDOW = "(max-width: 599.98px)";
+/** A read-only Select's keyboard finds no option, so arrows and typeahead change nothing. */
+const READ_ONLY_DELEGATE = {
+	getFirstKey: () => null,
+	getLastKey: () => null,
+	getKeyBelow: () => null,
+	getKeyAbove: () => null,
+	getKeyForSearch: () => null
+};
+function subscribeToWindow(onChange) {
+	const query = window.matchMedia(COMPACT_WINDOW);
+	query.addEventListener("change", onChange);
+	return () => query.removeEventListener("change", onChange);
+}
+/**
+* M3 exposed dropdown menu, read-only (Compose's `ExposedDropdownMenuBox` with a
+* `PrimaryNotEditable` anchor): a text-field-styled button that opens a menu of options.
+* Single or multiple selection, sections, descriptions and icons, typeahead, a hidden
+* native `<select>` for forms, and validation as in `TextField` (React Aria `useSelect`).
+*
+* @example
+* <Select label="Sort by" defaultValue="newest">
+*   <SelectItem key="newest">Newest first</SelectItem>
+*   <SelectItem key="price">Price, low to high</SelectItem>
+* </Select>
+*/
+function Select(props) {
+	const { variant = "filled", density, label, placeholder, supportingText, invalid: invalidProp, required: requiredProp, "aria-invalid": ariaInvalid, "aria-required": ariaRequired, disabled = false, readOnly = false, leadingIcon, errorIcon, open, maxSelections, presentation = "menu", searchable = false, filter = matchesSearch, searchValue, defaultSearchValue, onSearchChange, renderValue, loading, labels: labelsProp, className, classNames, style, ref, triggerRef: triggerRefProp, name, autoComplete, form, errorMessage, closeOnSelect, ...otherProps } = props;
+	if (typeof props.children !== "function") assertCollectionChildren(props.children, "Select", "SelectItem and SelectSection elements");
+	const { root: rootData, rest } = splitRootProps(otherProps, { wrapper: true });
+	const invalid = invalidProp ?? ariaFlag(ariaInvalid);
+	const required = requiredProp ?? ariaFlag(ariaRequired);
+	const labels = {
+		...DEFAULT_LABELS,
+		...labelsProp
+	};
+	const stately = rest;
+	const cap = useSelectionCap({
+		multiple: stately.selectionMode === "multiple",
+		maxSelections,
+		value: stately.value,
+		defaultValue: stately.defaultValue,
+		onChange: stately.onChange
+	});
+	const [search, setSearch] = useControlledState(searchValue, defaultSearchValue ?? "", onSearchChange);
+	const ariaProps = {
+		...stately,
+		...cap.valueProps,
+		onOpenChange: (isOpen) => {
+			if (!isOpen && search !== "") setSearch("");
+			stately.onOpenChange?.(isOpen);
+		},
+		label,
+		description: supportingText,
+		errorMessage,
+		isInvalid: invalid,
+		isRequired: required,
+		isDisabled: disabled,
+		...closeOnSelect !== void 0 && { shouldCloseOnSelect: closeOnSelect },
+		...FOCUSABLE_DISABLED_OPTIONS,
+		...readOnly ? {
+			isOpen: false,
+			keyboardDelegate: READ_ONLY_DELEGATE
+		} : open !== void 0 && { isOpen: open },
+		placeholder,
+		name,
+		autoComplete,
+		form
+	};
+	const state = useSelectState(ariaProps);
+	const triggerRef = useObjectRef(triggerRefProp);
+	const typeaheadDelegate = useTypeaheadDelegate(state, triggerRef, {
+		disabledBehavior: "all",
+		currentKey: state.selectionManager.selectionMode === "single" ? state.selectedKey : null
+	});
+	const containerRef = useRef(null);
+	const releaseFocusRef = useRef(false);
+	const touchOnTriggerRef = useRef(false);
+	const touchLeftTriggerRef = useRef(false);
+	const onTrigger = (target) => Boolean(triggerRef.current?.contains(target));
+	const strayTouchProps = {
+		onPointerDownCapture: (event) => {
+			touchOnTriggerRef.current = event.pointerType !== "mouse" && onTrigger(event.target);
+			touchLeftTriggerRef.current = false;
+		},
+		onPointerUpCapture: (event) => {
+			touchLeftTriggerRef.current = !onTrigger(event.target);
+		},
+		onClickCapture: (event) => {
+			if (!touchOnTriggerRef.current) return;
+			touchOnTriggerRef.current = false;
+			if (!touchLeftTriggerRef.current && onTrigger(event.target)) return;
+			if (disabled || state.isOpen) return;
+			releaseFocusRef.current = false;
+			triggerRef.current?.focus({ preventScroll: true });
+			if (!readOnly) state.open();
+		}
+	};
+	const listBoxRef = useRef(null);
+	const popoverRef = useRef(null);
+	const dialogId = useId();
+	const { labelProps, triggerProps, valueProps, menuProps, descriptionProps, errorMessageProps, isInvalid, validationErrors, validationDetails } = useSelect(readOnly ? ariaProps : {
+		...ariaProps,
+		keyboardDelegate: typeaheadDelegate
+	}, state, triggerRef);
+	const isCompact = useSyncExternalStore(subscribeToWindow, () => window.matchMedia(COMPACT_WINDOW).matches, () => false);
+	const asSheet = presentation === "sheet" || presentation === "auto" && isCompact;
+	usePreloadBottomSheet(containerRef, asSheet);
+	usePreloadLoadingIndicator(containerRef, loading !== void 0);
+	const { buttonProps } = useButton(searchable ? {
+		...triggerProps,
+		"aria-haspopup": "dialog",
+		"aria-controls": state.isOpen && !asSheet ? dialogId : void 0
+	} : triggerProps, triggerRef);
+	const { focusProps, isFocusVisible, isFocused } = useFocusRing();
+	const fieldButtonProps = mergeProps(pickDescriptionAria(rest), buttonProps, focusProps);
+	const { hoverProps, isHovered } = useHover({ isDisabled: disabled });
+	const chosenOptions = [...state.collection.getKeys()].filter((key) => state.selectionManager.isSelected(key)).map((key) => {
+		const item = state.collection.getItem(key);
+		return {
+			key,
+			textValue: item?.textValue ?? "",
+			value: item?.value ?? null
+		};
+	});
+	const chosen = chosenOptions.map((option) => option.textValue);
+	const valueText = chosen.length > 2 ? `${chosen.slice(0, 2).join(", ")} ${labels.more(chosen.length - 2)}` : chosen.join(", ");
+	const hasValue = chosen.length > 0;
+	const hasLabel = label !== void 0 && label !== null;
+	const focused = isFocused || state.isOpen;
+	const resolvedError = typeof errorMessage === "function" ? errorMessage({
+		isInvalid,
+		validationErrors,
+		validationDetails
+	}) : errorMessage ?? validationErrors.join(" ");
+	const searchLabelling = hasLabel ? { "aria-labelledby": labelProps.id } : { "aria-label": rest["aria-label"] };
+	const list = searchable ? /* @__PURE__ */ jsx(SearchList, {
+		listProps: {
+			...stately.items !== void 0 && { items: stately.items },
+			children: stately.children,
+			...stately.disabledKeys !== void 0 && { disabledKeys: stately.disabledKeys },
+			selectionMode: stately.selectionMode ?? "single",
+			disallowEmptySelection: stately.selectionMode !== "multiple",
+			selectedKeys: state.selectionManager.selectedKeys,
+			onSelectionChange: (keys) => {
+				state.selectionManager.setSelectedKeys(keys === "all" ? [] : keys);
+				if (stately.selectionMode !== "multiple") state.close();
+			}
+		},
+		search,
+		onSearchChange: setSearch,
+		filter: onSearchChange ? null : filter,
+		autoFocusSearch: !asSheet,
+		labelling: searchLabelling,
+		dialogProps: asSheet ? void 0 : {
+			id: dialogId,
+			role: "dialog",
+			...searchLabelling
+		},
+		labels: {
+			search: labels.search,
+			noResults: labels.noResults,
+			loading: labels.loading
+		},
+		loading: loading ?? false,
+		isBlocked: cap.isBlocked,
+		embedded: asSheet,
+		classNames
+	}) : /* @__PURE__ */ jsx(OptionList, {
+		embedded: asSheet,
+		listBoxProps: menuProps,
+		state,
+		listBoxRef,
+		emptyLabel: labels.empty,
+		loading,
+		loadingLabel: labels.loading,
+		isBlocked: cap.isBlocked,
+		classNames
+	});
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(FieldShell, {
+		variant,
+		density,
+		label,
+		labelProps,
+		required,
+		state: fieldState({
+			disabled,
+			invalid: isInvalid,
+			focused,
+			hovered: isHovered
+		}),
+		floated: hasValue || focused,
+		open: state.isOpen,
+		leadingIcon,
+		trailing: /* @__PURE__ */ jsx(DropdownArrow, { open: state.isOpen }),
+		errorIcon,
+		errorIconLabel: labels.error,
+		readOnly,
+		supportingText,
+		descriptionProps,
+		errorText: resolvedError,
+		errorMessageProps,
+		showError: isInvalid && Boolean(resolvedError),
+		containerRef,
+		containerProps: {
+			...hoverProps,
+			...strayTouchProps
+		},
+		onContainerPointerDown: (event) => {
+			if (disabled || triggerRef.current?.contains(event.target)) return;
+			event.preventDefault();
+			releaseFocusRef.current = false;
+			triggerRef.current?.focus();
+			if (!readOnly) state.toggle();
+		},
+		rootProps: {
+			...rootData,
+			"data-focus-visible": isFocusVisible || void 0
+		},
+		rootRef: ref,
+		className,
+		classNames,
+		style,
+		children: [name || autoComplete || form || stately.validationBehavior === "native" ? /* @__PURE__ */ jsx(HiddenSelect, {
+			state,
+			triggerRef,
+			label,
+			name,
+			isDisabled: disabled,
+			...autoComplete && { autoComplete },
+			...form && { form }
+		}) : null, /* @__PURE__ */ jsx("button", {
+			...fieldButtonProps,
+			"aria-describedby": renderedDescription(fieldButtonProps["aria-describedby"], [!supportingText && descriptionProps.id, !(isInvalid && resolvedError) && errorMessageProps.id]),
+			onFocus: (event) => {
+				fieldButtonProps.onFocus?.(event);
+				if (!releaseFocusRef.current) return;
+				releaseFocusRef.current = false;
+				triggerRef.current?.blur();
+			},
+			onPointerDown: (event) => {
+				releaseFocusRef.current = false;
+				fieldButtonProps.onPointerDown?.(event);
+			},
+			onKeyDown: (event) => {
+				releaseFocusRef.current = false;
+				fieldButtonProps.onKeyDown?.(event);
+			},
+			ref: triggerRef,
+			type: "button",
+			className: cn("flex min-w-0 flex-1 cursor-pointer items-center self-stretch bg-transparent p-0 text-start outline-none", "disabled:cursor-default"),
+			children: /* @__PURE__ */ jsx("span", {
+				...valueProps,
+				className: cn("min-w-0 flex-1 truncate text-body-large", hasValue ? "text-[color:var(--_md-comp-text-field-input-text-color)]" : "text-on-surface-variant", !hasValue && hasLabel && "opacity-0 group-data-floated/field:opacity-100", "group-data-[field-state=disabled]/field:text-on-surface/38", classNames?.value),
+				children: hasValue && renderValue ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+					"aria-hidden": "true",
+					children: renderValue(chosenOptions)
+				}), /* @__PURE__ */ jsx("span", {
+					className: "sr-only",
+					children: valueText
+				})] }) : hasValue ? valueText : placeholder ?? "\xA0"
+			})
+		})]
+	}), asSheet ? /* @__PURE__ */ jsx(LazyBottomSheet, {
+		skipPartiallyExpanded: true,
+		open: state.isOpen,
+		onOpenChange: (open) => open ? state.open() : state.close(),
+		classNames: classNames?.sheet ? { panel: classNames.sheet } : void 0,
+		...typeof label === "string" ? { "aria-label": label } : { "aria-label": rest["aria-label"] ?? "" },
+		children: /* @__PURE__ */ jsx("div", {
+			...densityAttribute(density),
+			className: "flex min-h-0 flex-1 flex-col px-[8px] pb-[16px]",
+			children: list
+		})
+	}) : /* @__PURE__ */ jsx(OptionPopover, {
+		state,
+		triggerRef: containerRef,
+		popoverRef,
+		density,
+		onPressOutside: () => {
+			releaseFocusRef.current = true;
+		},
+		minWidth: searchable ? 280 : 0,
+		children: list
+	})] });
+}
+//#endregion
+export { Select };
+
+//# sourceMappingURL=Select.js.map

package/dist/components/select/Select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.js","names":[],"sources":["../../../src/components/select/Select.tsx"],"sourcesContent":["'use client';\n\nimport {\n  useId,\n  useRef,\n  useSyncExternalStore,\n  type AriaAttributes,\n  type CSSProperties,\n  type HTMLAttributes,\n  type ReactNode,\n  type Ref,\n} from 'react';\nimport {\n  HiddenSelect,\n  mergeProps,\n  useButton,\n  useFocusRing,\n  useHover,\n  useObjectRef,\n  useSelect,\n  type AriaSelectOptions,\n} from 'react-aria';\nimport {\n  useSelectState,\n  type SelectionMode,\n  type SelectProps as StatelySelectProps,\n} from 'react-stately/useSelectState';\nimport { useControlledState } from 'react-stately/useControlledState';\nimport type { Key } from 'react-stately';\nimport { matchesSearch } from '../../utils/search';\nimport { assertCollectionChildren } from '../../utils/assert-collection-children';\nimport { densityAttribute, type Density } from '../../tokens/density';\nimport { cn } from '../../utils/cn';\nimport { renderedDescription } from '../../utils/rendered-description';\nimport {\n  ariaFlag,\n  pickDescriptionAria,\n  splitRootProps,\n  type WrapperRootDOMProps,\n} from '../../utils/root-props';\nimport { useTypeaheadDelegate } from '../../utils/typeahead';\nimport { usePreloadLoadingIndicator } from '../loading-indicator/lazy-loading-indicator';\nimport { LazyBottomSheet, usePreloadBottomSheet } from '../sheet/lazy-bottom-sheet';\nimport type { TextFieldVariant } from '../text-field/text-field-styles';\nimport { DropdownArrow, FieldShell, fieldState, type FieldShellClassNames } from './field-shell';\nimport {\n  FOCUSABLE_DISABLED_OPTIONS,\n  OptionList,\n  OptionPopover,\n  type OptionListClassNames,\n} from './option-list';\nimport { SearchList } from './search-list';\nimport { useSelectionCap } from './selection-cap';\n\n/** How the options open: a menu under the field (M3), a bottom sheet, or a sheet on phones. */\nexport type SelectPresentation = 'menu' | 'sheet' | 'auto';\n\n/** Words the Select shows or announces; override them for other languages. */\nexport interface SelectLabels {\n  /** Shown in an empty list. @default \"No options\" */\n  empty: string;\n  /** The loading indicator's name. @default \"Loading options\" */\n  loading: string;\n  /** For more chosen options than fit: `+{count}`. @default (count) => `+${count}` */\n  more: (count: number) => string;\n  /** With `searchable`: the search field's placeholder and name. @default \"Search\" */\n  search: string;\n  /** With `searchable`: shown when no option matches the search. @default \"No results\" */\n  noResults: string;\n  /** The error icon's name (M3: \"Error\"). @default \"Error\" */\n  error: string;\n}\n\nconst DEFAULT_LABELS: SelectLabels = {\n  empty: 'No options',\n  loading: 'Loading options',\n  more: (count) => `+${count}`,\n  search: 'Search',\n  noResults: 'No results',\n  error: 'Error',\n};\n\n/** A chosen option, as `renderValue` receives it. */\nexport interface SelectedOption<T> {\n  key: Key;\n  /** Its plain text (`textValue`, or the item's text). */\n  textValue: string;\n  /** Its object from `items`, if the options come from `items`. */\n  value: T | null;\n}\n\nexport interface SelectClassNames extends FieldShellClassNames, OptionListClassNames {\n  /** The text showing the chosen option(s) or the placeholder. */\n  value?: string;\n  /** With `searchable`: the search field. */\n  search?: string;\n  /**\n   * The bottom sheet the options open in (`presentation=\"sheet\"`, or `\"auto\"` on compact\n   * windows): the sheet's surface, as its `classNames.panel`.\n   */\n  sheet?: string;\n}\n\n/** React Aria props this API names the library's way (`disabled`, `open`…), or leaves out. */\ntype RenamedProps =\n  | 'isDisabled'\n  | 'isRequired'\n  | 'isInvalid'\n  | 'isOpen'\n  | 'label'\n  | 'description'\n  | 'validationState'\n  // React Stately's deprecated single-selection API; `value` / `defaultValue` / `onChange` replace it.\n  | 'selectedKey'\n  | 'defaultSelectedKey'\n  | 'onSelectionChange'\n  | 'shouldCloseOnSelect'\n  | 'allowsEmptyCollection';\n\nexport type SelectProps<T extends object, M extends SelectionMode = 'single'> = Omit<\n  StatelySelectProps<T, M>,\n  RenamedProps\n> &\n  Pick<AriaSelectOptions<T, M>, 'id' | 'name' | 'autoComplete' | 'form'> &\n  Omit<WrapperRootDOMProps, keyof StatelySelectProps<T, M>> & {\n    /** The trigger button's id, for a `<label for>` or an error summary's link. */\n    id?: string;\n    /** The container style, as `TextField`'s: a filled surface or an outline. @default \"filled\" */\n    variant?: TextFieldVariant;\n    /**\n     * Web density, `0` to `-3`: each step takes 4px off the field (56px at 0, 44px at -3) and\n     * off its menu's options (44px at 0, 32px at -3). Left out, it takes the density of the\n     * nearest `ThemeProvider` or `ThemeScope`. M3 asks for density to be the reader's choice\n     * rather than a default, so prefer setting it there, from a setting.\n     * @default 0\n     */\n    density?: Density;\n    /** The field's label. Give `aria-label` instead when there's no visible label. */\n    label?: ReactNode;\n    /** Accessible name when there's no visible label. */\n    'aria-label'?: string;\n    /**\n     * Shown in the field when nothing is chosen. With a `label`, it appears once the label\n     * floats (on focus), as in `TextField`.\n     */\n    placeholder?: string;\n    /**\n     * Helper text below the field. Replaced visually by the error when invalid, and shown in\n     * the error colour while the field is invalid.\n     */\n    supportingText?: ReactNode;\n    /** Marks the field invalid (in addition to `validate` and `required`). */\n    invalid?: boolean;\n    /** A choice is required: adds the `*` to the label and validates on submit. */\n    required?: boolean;\n    /**\n     * Read as `invalid` when that's left out, for a form library that sets the attribute. The\n     * trigger is a button, which ARIA doesn't let carry `aria-invalid`, so the state reaches\n     * assistive technology as the field's error text, its description.\n     */\n    'aria-invalid'?: AriaAttributes['aria-invalid'];\n    /**\n     * Read as `required` when that's left out, for a form library that sets the attribute: the\n     * label's `*`, in the trigger's name (a button can't carry `aria-required`).\n     */\n    'aria-required'?: AriaAttributes['aria-required'];\n    /** Disables the field: it can't be focused or opened. @default false */\n    disabled?: boolean;\n    /**\n     * The choice can be seen but not changed: the menu doesn't open and the keyboard doesn't\n     * change it. The root gets `data-readonly`; say so in the supporting text (M3).\n     * @default false\n     */\n    readOnly?: boolean;\n    /** Decorative icon at the start, in a 48px box. */\n    leadingIcon?: ReactNode;\n    /**\n     * The icon shown before the arrow while the field is invalid (M3 strongly recommends one).\n     * Defaults to Material Symbols `error`, named by `labels.error`; `false` turns it off.\n     */\n    errorIcon?: ReactNode | false;\n    /** Whether the menu is open (controlled); with `defaultOpen` and `onOpenChange`. */\n    open?: boolean;\n    /**\n     * Whether choosing an option closes the menu.\n     * @default true for a single choice, false with `selectionMode=\"multiple\"`\n     */\n    closeOnSelect?: boolean;\n    /**\n     * With `selectionMode=\"multiple\"`, the most options that can be chosen; the rest show as\n     * disabled until one is removed.\n     */\n    maxSelections?: number;\n    /**\n     * `menu` (default) opens an M3 menu under the field on every window, as Compose's exposed\n     * dropdown menu does; `sheet` always opens a bottom sheet; `auto` opens a sheet on\n     * compact windows and a menu on larger ones, for long lists.\n     * @default \"menu\"\n     */\n    presentation?: SelectPresentation;\n    /**\n     * A search field at the top of the menu or sheet that filters the options as you type,\n     * for long lists (pair it with `presentation=\"auto\"`). The search takes focus in the menu;\n     * a sheet shows the list first, so the keyboard doesn't cover it.\n     * @default false\n     */\n    searchable?: boolean;\n    /**\n     * With `searchable`: whether an option matches the search. Defaults to a match anywhere in\n     * its text, ignoring case and accents (\"thai\" finds \"Thailand\"). The option's `key` lets\n     * it match on more than its text, e.g. a country's ISO code.\n     */\n    filter?: (textValue: string, search: string, key: Key) => boolean;\n    /** With `searchable`: the typed text (controlled); cleared when the list closes. */\n    searchValue?: string;\n    /** With `searchable`: the initial typed text, when uncontrolled. @default \"\" */\n    defaultSearchValue?: string;\n    /**\n     * With `searchable`: called as the search changes. Given it, the app filters `items` itself\n     * (e.g. on a server, with `loading` meanwhile) and the built-in filter is off.\n     */\n    onSearchChange?: (search: string) => void;\n    /**\n     * What the field shows for the chosen option(s), e.g. a dialling code or a flag, instead of\n     * their text. Screen readers still hear the options' text.\n     */\n    renderValue?: (selected: SelectedOption<T>[]) => ReactNode;\n    /**\n     * Shows a loading indicator in the list, e.g. while options are fetched.\n     * The indicator's code loads when it first shows, and ahead of that when the field is\n     * hovered or focused while this prop is set at all, so pass `loading={false}` (rather than\n     * leaving it out) on a field that loads options.\n     */\n    loading?: boolean;\n    /** Words the Select shows or announces, for other languages. */\n    labels?: Partial<SelectLabels>;\n    /** Classes for the root element, merged with `classNames.root`; consumer classes win. */\n    className?: string;\n    /** Classes for each part, by slot. */\n    classNames?: SelectClassNames;\n    /** Inline styles for the root element. */\n    style?: CSSProperties;\n    /** Ref to the root `<div>` element. Use `triggerRef` for the field's button. */\n    ref?: Ref<HTMLDivElement>;\n    /** Ref to the field's button. */\n    triggerRef?: Ref<HTMLButtonElement>;\n  };\n\nconst COMPACT_WINDOW = '(max-width: 599.98px)';\n\n/** A read-only Select's keyboard finds no option, so arrows and typeahead change nothing. */\nconst READ_ONLY_DELEGATE: NonNullable<AriaSelectOptions<object>['keyboardDelegate']> = {\n  getFirstKey: () => null,\n  getLastKey: () => null,\n  getKeyBelow: () => null,\n  getKeyAbove: () => null,\n  getKeyForSearch: () => null,\n};\n\nfunction subscribeToWindow(onChange: () => void) {\n  const query = window.matchMedia(COMPACT_WINDOW);\n  query.addEventListener('change', onChange);\n  return () => query.removeEventListener('change', onChange);\n}\n\n/**\n * M3 exposed dropdown menu, read-only (Compose's `ExposedDropdownMenuBox` with a\n * `PrimaryNotEditable` anchor): a text-field-styled button that opens a menu of options.\n * Single or multiple selection, sections, descriptions and icons, typeahead, a hidden\n * native `<select>` for forms, and validation as in `TextField` (React Aria `useSelect`).\n *\n * @example\n * <Select label=\"Sort by\" defaultValue=\"newest\">\n *   <SelectItem key=\"newest\">Newest first</SelectItem>\n *   <SelectItem key=\"price\">Price, low to high</SelectItem>\n * </Select>\n */\nexport function Select<T extends object, M extends SelectionMode = 'single'>(\n  props: SelectProps<T, M>,\n) {\n  const {\n    variant = 'filled',\n    density,\n    label,\n    placeholder,\n    supportingText,\n    invalid: invalidProp,\n    required: requiredProp,\n    'aria-invalid': ariaInvalid,\n    'aria-required': ariaRequired,\n    disabled = false,\n    readOnly = false,\n    leadingIcon,\n    errorIcon,\n    open,\n    maxSelections,\n    presentation = 'menu',\n    searchable = false,\n    filter = matchesSearch,\n    searchValue,\n    defaultSearchValue,\n    onSearchChange,\n    renderValue,\n    loading,\n    labels: labelsProp,\n    className,\n    classNames,\n    style,\n    ref,\n    triggerRef: triggerRefProp,\n    name,\n    autoComplete,\n    form,\n    errorMessage,\n    closeOnSelect,\n    ...otherProps\n  } = props;\n  // Items given as elements (not `items` with a render function) must come from a client.\n  if (typeof props.children !== 'function') {\n    assertCollectionChildren(props.children, 'Select', 'SelectItem and SelectSection elements');\n  }\n  const { root: rootData, rest } = splitRootProps(otherProps, { wrapper: true });\n  const invalid = invalidProp ?? ariaFlag(ariaInvalid);\n  const required = requiredProp ?? ariaFlag(ariaRequired);\n  const labels = { ...DEFAULT_LABELS, ...labelsProp };\n  const stately = rest as Omit<StatelySelectProps<T, M>, RenamedProps>;\n  const cap = useSelectionCap({\n    multiple: stately.selectionMode === 'multiple',\n    maxSelections,\n    value: stately.value,\n    defaultValue: stately.defaultValue,\n    onChange: stately.onChange,\n  });\n  const [search, setSearch] = useControlledState(\n    searchValue,\n    defaultSearchValue ?? '',\n    onSearchChange,\n  );\n  const ariaProps = {\n    ...stately,\n    ...cap.valueProps,\n    // The search starts afresh each time the list opens.\n    onOpenChange: (isOpen: boolean) => {\n      if (!isOpen && search !== '') setSearch('');\n      stately.onOpenChange?.(isOpen);\n    },\n    label,\n    description: supportingText,\n    errorMessage,\n    isInvalid: invalid,\n    isRequired: required,\n    isDisabled: disabled,\n    ...(closeOnSelect !== undefined && { shouldCloseOnSelect: closeOnSelect }),\n    ...FOCUSABLE_DISABLED_OPTIONS,\n    ...(readOnly\n      ? { isOpen: false, keyboardDelegate: READ_ONLY_DELEGATE }\n      : open !== undefined && { isOpen: open }),\n    placeholder,\n    name,\n    autoComplete,\n    form,\n  } as AriaSelectOptions<T, M>;\n\n  const state = useSelectState<T, M>(ariaProps);\n  const triggerRef = useObjectRef(triggerRefProp);\n  // Typeahead on the closed field moves to the next option starting with the letter (M3),\n  // and still skips disabled options.\n  const typeaheadDelegate = useTypeaheadDelegate(state, triggerRef, {\n    disabledBehavior: 'all',\n    currentKey: state.selectionManager.selectionMode === 'single' ? state.selectedKey : null,\n  });\n  const containerRef = useRef<HTMLDivElement>(null);\n  // Set by a press outside the menu and the field: the focus the menu hands back to the\n  // field on closing (WAI-ARIA, right after Escape or a choice) is let go, so one press\n  // outside leaves the field, as it does any other field.\n  const releaseFocusRef = useRef(false);\n  // Chrome's touch adjustment can split a tap between the trigger and the padding just above\n  // or below it (the 8px either side of the value line): `pointerdown` reaches the trigger\n  // while `pointerup` or the click lands beside it, so React Aria cancels the press or never\n  // sees it, and about a third of the field ignored a finger (2026-10-17). A touch that\n  // starts on the trigger but doesn't end there (its `pointerup` and its click both on it)\n  // opens the menu on its click instead. The mouse never gets here: it opens on the press\n  // start.\n  const touchOnTriggerRef = useRef(false);\n  const touchLeftTriggerRef = useRef(false);\n  const onTrigger = (target: EventTarget) => Boolean(triggerRef.current?.contains(target as Node));\n  const strayTouchProps: HTMLAttributes<HTMLDivElement> = {\n    onPointerDownCapture: (event) => {\n      touchOnTriggerRef.current = event.pointerType !== 'mouse' && onTrigger(event.target);\n      touchLeftTriggerRef.current = false;\n    },\n    onPointerUpCapture: (event) => {\n      touchLeftTriggerRef.current = !onTrigger(event.target);\n    },\n    onClickCapture: (event) => {\n      if (!touchOnTriggerRef.current) return;\n      touchOnTriggerRef.current = false;\n      if (!touchLeftTriggerRef.current && onTrigger(event.target)) return;\n      if (disabled || state.isOpen) return;\n      releaseFocusRef.current = false;\n      triggerRef.current?.focus({ preventScroll: true });\n      if (!readOnly) state.open();\n    },\n  };\n  const listBoxRef = useRef<HTMLUListElement>(null);\n  const popoverRef = useRef<HTMLDivElement>(null);\n  const dialogId = useId();\n  const {\n    labelProps,\n    triggerProps,\n    valueProps,\n    menuProps,\n    descriptionProps,\n    errorMessageProps,\n    isInvalid,\n    validationErrors,\n    validationDetails,\n  } = useSelect<T, M>(\n    readOnly ? ariaProps : { ...ariaProps, keyboardDelegate: typeaheadDelegate },\n    state,\n    triggerRef,\n  );\n  const isCompact = useSyncExternalStore(\n    subscribeToWindow,\n    () => window.matchMedia(COMPACT_WINDOW).matches,\n    () => false,\n  );\n  const asSheet = presentation === 'sheet' || (presentation === 'auto' && isCompact);\n  // The sheet's code loads on first open, or ahead of it when the field is hovered or focused.\n  usePreloadBottomSheet(containerRef, asSheet);\n  // A field that takes `loading` (it loads options) preloads the indicator on hover or focus.\n  usePreloadLoadingIndicator(containerRef, loading !== undefined);\n  // `useSelect`'s trigger props are React Aria button props; `useButton` makes them DOM props.\n  const { buttonProps } = useButton(\n    // A searchable field opens a dialog holding the search and the list (as PhoneField's).\n    searchable\n      ? {\n          ...triggerProps,\n          'aria-haspopup': 'dialog',\n          'aria-controls': state.isOpen && !asSheet ? dialogId : undefined,\n        }\n      : triggerProps,\n    triggerRef,\n  );\n  const { focusProps, isFocusVisible, isFocused } = useFocusRing();\n  // The trigger sets its own widget attributes; an app's description ones join them.\n  const fieldButtonProps = mergeProps(pickDescriptionAria(rest), buttonProps, focusProps);\n  const { hoverProps, isHovered } = useHover({ isDisabled: disabled });\n\n  // In the list's order, not the order they were picked, so the field reads like the list.\n  const chosenOptions: SelectedOption<T>[] = [...state.collection.getKeys()]\n    .filter((key) => state.selectionManager.isSelected(key))\n    .map((key) => {\n      const item = state.collection.getItem(key);\n      return { key, textValue: item?.textValue ?? '', value: item?.value ?? null };\n    });\n  const chosen = chosenOptions.map((option) => option.textValue);\n  const valueText =\n    chosen.length > 2\n      ? `${chosen.slice(0, 2).join(', ')} ${labels.more(chosen.length - 2)}`\n      : chosen.join(', ');\n  const hasValue = chosen.length > 0;\n  const hasLabel = label !== undefined && label !== null;\n  const focused = isFocused || state.isOpen;\n  const resolvedError =\n    typeof errorMessage === 'function'\n      ? errorMessage({ isInvalid, validationErrors, validationDetails })\n      : (errorMessage ?? validationErrors.join(' '));\n\n  const searchLabelling = hasLabel\n    ? { 'aria-labelledby': labelProps.id }\n    : { 'aria-label': (rest as { 'aria-label'?: string })['aria-label'] };\n  const list = searchable ? (\n    <SearchList\n      listProps={{\n        ...(stately.items !== undefined && { items: stately.items }),\n        children: stately.children,\n        ...(stately.disabledKeys !== undefined && { disabledKeys: stately.disabledKeys }),\n        selectionMode: stately.selectionMode ?? 'single',\n        // A single choice stays chosen when pressed again, as in a non-searchable Select.\n        disallowEmptySelection: stately.selectionMode !== 'multiple',\n        selectedKeys: state.selectionManager.selectedKeys,\n        onSelectionChange: (keys) => {\n          state.selectionManager.setSelectedKeys(keys === 'all' ? [] : keys);\n          if (stately.selectionMode !== 'multiple') state.close();\n        },\n      }}\n      search={search}\n      onSearchChange={setSearch}\n      filter={onSearchChange ? null : filter}\n      autoFocusSearch={!asSheet}\n      labelling={searchLabelling}\n      dialogProps={asSheet ? undefined : { id: dialogId, role: 'dialog', ...searchLabelling }}\n      labels={{ search: labels.search, noResults: labels.noResults, loading: labels.loading }}\n      loading={loading ?? false}\n      isBlocked={cap.isBlocked}\n      embedded={asSheet}\n      classNames={classNames}\n    />\n  ) : (\n    <OptionList\n      embedded={asSheet}\n      listBoxProps={menuProps}\n      state={state}\n      listBoxRef={listBoxRef}\n      emptyLabel={labels.empty}\n      loading={loading}\n      loadingLabel={labels.loading}\n      isBlocked={cap.isBlocked}\n      classNames={classNames}\n    />\n  );\n\n  return (\n    <>\n      <FieldShell\n        variant={variant}\n        density={density}\n        label={label}\n        labelProps={labelProps}\n        required={required}\n        state={fieldState({ disabled, invalid: isInvalid, focused, hovered: isHovered })}\n        floated={hasValue || focused}\n        open={state.isOpen}\n        leadingIcon={leadingIcon}\n        trailing={<DropdownArrow open={state.isOpen} />}\n        errorIcon={errorIcon}\n        errorIconLabel={labels.error}\n        readOnly={readOnly}\n        supportingText={supportingText}\n        descriptionProps={descriptionProps}\n        errorText={resolvedError}\n        errorMessageProps={errorMessageProps}\n        showError={isInvalid && Boolean(resolvedError)}\n        containerRef={containerRef}\n        // No handler is shared: the hover ones and the touch fallback's capture ones.\n        containerProps={{ ...hoverProps, ...strayTouchProps }}\n        onContainerPointerDown={(event) => {\n          // A press anywhere on the field (not only its text) opens it, like Compose.\n          if (disabled || triggerRef.current?.contains(event.target as Node)) return;\n          event.preventDefault();\n          releaseFocusRef.current = false;\n          triggerRef.current?.focus();\n          if (!readOnly) state.toggle();\n        }}\n        rootProps={{ ...rootData, 'data-focus-visible': isFocusVisible || undefined }}\n        rootRef={ref}\n        className={className}\n        classNames={classNames}\n        style={style}\n      >\n        {/* The native select is for forms: submitting under `name`, autofill and native\n            validation. Without them it's left out, so a long list's text (e.g. country names\n            from Intl, which can differ between server and browser) isn't rendered twice. */}\n        {name || autoComplete || form || stately.validationBehavior === 'native' ? (\n          <HiddenSelect\n            state={state}\n            triggerRef={triggerRef}\n            label={label}\n            name={name}\n            isDisabled={disabled}\n            {...(autoComplete && { autoComplete })}\n            {...(form && { form })}\n          />\n        ) : null}\n        <button\n          {...fieldButtonProps}\n          aria-describedby={renderedDescription(fieldButtonProps['aria-describedby'], [\n            !supportingText && descriptionProps.id,\n            !(isInvalid && resolvedError) && errorMessageProps.id,\n          ])}\n          onFocus={(event) => {\n            fieldButtonProps.onFocus?.(event);\n            if (!releaseFocusRef.current) return;\n            releaseFocusRef.current = false;\n            triggerRef.current?.blur();\n          }}\n          // Using the field again means it's wanted, whatever came before.\n          onPointerDown={(event) => {\n            releaseFocusRef.current = false;\n            fieldButtonProps.onPointerDown?.(event);\n          }}\n          onKeyDown={(event) => {\n            releaseFocusRef.current = false;\n            fieldButtonProps.onKeyDown?.(event);\n          }}\n          ref={triggerRef}\n          type=\"button\"\n          className={cn(\n            'flex min-w-0 flex-1 cursor-pointer items-center self-stretch bg-transparent p-0 text-start outline-none',\n            'disabled:cursor-default',\n          )}\n        >\n          <span\n            {...valueProps}\n            className={cn(\n              'min-w-0 flex-1 truncate text-body-large',\n              hasValue\n                ? 'text-[color:var(--_md-comp-text-field-input-text-color)]'\n                : 'text-on-surface-variant',\n              // With a label, the placeholder shows once the label floats (as TextField).\n              !hasValue && hasLabel && 'opacity-0 group-data-floated/field:opacity-100',\n              'group-data-[field-state=disabled]/field:text-on-surface/38',\n              classNames?.value,\n            )}\n          >\n            {hasValue && renderValue ? (\n              <>\n                <span aria-hidden=\"true\">{renderValue(chosenOptions)}</span>\n                <span className=\"sr-only\">{valueText}</span>\n              </>\n            ) : hasValue ? (\n              valueText\n            ) : (\n              (placeholder ?? ' ')\n            )}\n          </span>\n        </button>\n      </FieldShell>\n      {asSheet ? (\n        <LazyBottomSheet\n          // Opens at its own height (up to the window, the list scrolling inside), never half\n          // the window, which left the last options off-screen on a short phone.\n          skipPartiallyExpanded\n          open={state.isOpen}\n          onOpenChange={(open) => (open ? state.open() : state.close())}\n          classNames={classNames?.sheet ? { panel: classNames.sheet } : undefined}\n          {...(typeof label === 'string'\n            ? { 'aria-label': label }\n            : { 'aria-label': (rest as { 'aria-label'?: string })['aria-label'] ?? '' })}\n        >\n          <div\n            {...densityAttribute(density)}\n            className=\"flex min-h-0 flex-1 flex-col px-[8px] pb-[16px]\"\n          >\n            {list}\n          </div>\n        </LazyBottomSheet>\n      ) : (\n        <OptionPopover\n          state={state}\n          triggerRef={containerRef}\n          popoverRef={popoverRef}\n          density={density}\n          onPressOutside={() => {\n            releaseFocusRef.current = true;\n          }}\n          // Room to type in a searchable menu, however narrow the field.\n          minWidth={searchable ? 280 : 0}\n        >\n          {list}\n        </OptionPopover>\n      )}\n    </>\n  );\n}\n\nexport type { Key as SelectKey } from 'react-stately';\n"],"mappings":"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"}

package/dist/components/select/field-shell.d.ts

@@ -0,0 +1,29 @@
+import "../text-field/text-field-styles.js";
+import { CSSProperties, HTMLAttributes, ReactNode, Ref } from "react";
+//#region src/components/select/field-shell.d.ts
+export interface FieldShellClassNames {
+  /** The root element, merged with `className`. */
+  root?: string;
+  /** The filled or outlined container around the label, value and icons. */
+  container?: string;
+  /** The floating label. */
+  label?: string;
+  /** The row holding the field's value (the button, or the chips and input). */
+  field?: string;
+  /** The leading icon's 48px box. */
+  leadingIcon?: string;
+  /** The trailing box holding the arrow (and the error icon). */
+  trailingIcon?: string;
+  /** The helper text below the field. */
+  supportingText?: string;
+  /** The error message below the field. */
+  errorText?: string;
+  /** The built-in error icon. */
+  errorIcon?: string;
+  /** The outlined field's border (a `<fieldset>`, notched for the floated label). */
+  outline?: string;
+  /** The filled field's active indicator, the line along the container's bottom. */
+  activeIndicator?: string;
+}
+//#endregion
+//# sourceMappingURL=field-shell.d.ts.map