@cdx-ui/primitives 0.3.3 → 0.3.4

package/lib/typescript/select/popupRole.d.ts

@@ -0,0 +1,18 @@
+import type { SelectContextValue } from './types';
+type PopupRoleSource = Pick<SelectContextValue, 'hasSearch' | 'labelId' | 'accessibilityLabel' | 'triggerId'>;
+/**
+ * Role and name of the popup surface. With `Select.Search` the popup is a dialog holding a
+ * searchbox and a listbox (a listbox may only own options), named by the field label, then
+ * `accessibilityLabel`. Without it the popup is the listbox.
+ */
+export declare function getPopupRoleProps({ hasSearch, labelId, accessibilityLabel, triggerId, }: PopupRoleSource): {
+    role: "dialog";
+    'aria-labelledby': string | undefined;
+    'aria-label': string | undefined;
+} | {
+    role: "listbox";
+    'aria-labelledby': string;
+    readonly 'aria-label'?: undefined;
+};
+export {};
+//# sourceMappingURL=popupRole.d.ts.map

package/lib/typescript/select/popupRole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popupRole.d.ts","sourceRoot":"","sources":["../../../src/select/popupRole.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,KAAK,eAAe,GAAG,IAAI,CACzB,kBAAkB,EAClB,WAAW,GAAG,SAAS,GAAG,oBAAoB,GAAG,WAAW,CAC7D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,SAAS,GACV,EAAE,eAAe;;;;;;;;EAQjB"}

package/lib/typescript/select/types.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode, RefObject } from 'react';
-import type { PressableProps, ViewProps } from 'react-native';
+import type { PressableProps, TextInputProps, ViewProps } from 'react-native';
 import type { EntryOrExitLayoutType } from 'react-native-reanimated';
 import type { OverlayPlacement } from '../overlay';
 import type { InteractionState } from '../types';
@@ -7,15 +7,19 @@ export interface SelectItemInteractionState extends InteractionState {
     highlighted: boolean;
     checked: boolean;
 }
-export interface ISelectProps {
+/** Selection mode for `Select`. */
+export type SelectType = 'single' | 'multiple';
+/**
+ * Decides whether an option stays visible for the current search query. Receives the option's
+ * `label` from `items` and the query.
+ */
+export type SelectFilter = (textValue: string, inputValue: string) => boolean;
+interface ISelectBaseProps {
     /**
      * Options used to resolve `Select.Value` labels and drive keyboard navigation.
      * Render matching `Select.Item` elements inside `Select.Content`.
      */
     items: SelectItemData[];
-    value?: string;
-    defaultValue?: string;
-    onValueChange?: (value: string) => void;
     /** Controlled open state. Use `defaultOpen` for the uncontrolled variant. */
     isOpen?: boolean;
     defaultOpen?: boolean;
@@ -27,8 +31,54 @@ export interface ISelectProps {
     /** Prevents `Select.Content` from rendering. Reserved for native picker integration. */
     native?: boolean;
     accessibilityLabel?: string;
+    /** Controlled search query typed into `Select.Search`. */
+    inputValue?: string;
+    /** Uncontrolled initial search query. */
+    defaultInputValue?: string;
+    /**
+     * Called when the search query changes, including the reset to `''` when the popup closes.
+     * Pair with `inputValue` to replace `items` with server results.
+     */
+    onInputChange?: (inputValue: string) => void;
+    /**
+     * Decides which options stay visible for a non-empty query. Every option is visible while the
+     * query is empty.
+     * @default case- and accent-insensitive `contains`
+     */
+    filter?: SelectFilter;
     children?: ReactNode;
 }
+export interface ISelectSingleProps extends ISelectBaseProps {
+    /**
+     * Selection mode. `single` selects one option and closes the popup.
+     * @default 'single'
+     */
+    type?: 'single';
+    /** Controlled selected value. */
+    value?: string;
+    /** Uncontrolled initial value. */
+    defaultValue?: string;
+    /** Called with the newly selected value. */
+    onValueChange?: (value: string) => void;
+}
+export interface ISelectMultipleProps extends ISelectBaseProps {
+    /**
+     * Selection mode. `multiple` toggles options on press and keeps the popup open.
+     * Each toggle commits immediately.
+     */
+    type: 'multiple';
+    /** Controlled selected values. An empty array means no selection. */
+    value?: string[];
+    /** Uncontrolled initial values. */
+    defaultValue?: string[];
+    /** Called with the full array of selected values after each toggle. */
+    onValueChange?: (value: string[]) => void;
+}
+/**
+ * Discriminated union: `type` narrows `value` / `defaultValue` / `onValueChange` to `string`
+ * (single, the default) or `string[]` (multiple).
+ */
+export type ISelectProps = ISelectSingleProps | ISelectMultipleProps;
 export interface ISelectTriggerProps extends PressableProps {
     isHovered?: boolean;
     isActive?: boolean;
@@ -38,9 +88,22 @@ export interface ISelectTriggerProps extends PressableProps {
     /** @platform web — merged with form field helper/error ids */
     'aria-describedby'?: string;
 }
+/** State passed to a `Select.Value` function child. */
+export interface SelectValueRenderProps {
+    /** `true` when nothing is selected. */
+    isPlaceholder: boolean;
+    /** Selected options, in `items` order. Values missing from `items` are omitted. */
+    selectedItems: SelectItemData[];
+    /** Labels of `selectedItems` joined with `', '`. Empty when nothing is selected. */
+    selectedText: string;
+}
 export interface ISelectValueProps {
     placeholder?: string;
-    children?: ReactNode;
+    /**
+     * Replaces the default display. A function child receives the selection state; return
+     * `null` or `undefined` to fall back to the default (placeholder or `selectedText`).
+     */
+    children?: ReactNode | ((state: SelectValueRenderProps) => ReactNode);
 }
 export interface ISelectContentProps extends ViewProps {
     /** Preferred dropdown placement relative to the trigger. Defaults to `bottom-start`. */
@@ -53,6 +116,31 @@ export interface ISelectContentProps extends ViewProps {
     enteringAnimation?: EntryOrExitLayoutType;
     /** Exit animation for the dropdown. Defaults to a 100ms fade. */
     exitingAnimation?: EntryOrExitLayoutType;
+    /**
+     * Accessible name of the visually hidden button that lets screen-reader users close the
+     * popup on web.
+     * @default 'Dismiss'
+     */
+    dismissAccessibilityLabel?: string;
+    children?: ReactNode;
+}
+export interface ISelectSheetContentProps extends ViewProps {
+    children?: ReactNode;
+}
+export interface ISelectSearchProps extends Omit<TextInputProps, 'value' | 'defaultValue' | 'onChangeText' | 'children'> {
+    /** Accessible name of the search input. Recommended, because a placeholder is not a label. */
+    accessibilityLabel?: string;
+    /**
+     * Text the polite live region announces when the result count changes, such as
+     * `"3 results"` (the English default). When nothing matches, the `Select.Empty` text is
+     * announced instead.
+     */
+    getResultCountLabel?: (count: number) => string;
+}
+export interface ISelectListboxProps extends ViewProps {
+    children?: ReactNode;
+}
+export interface ISelectEmptyProps extends ViewProps {
     children?: ReactNode;
 }
 export interface ISelectItemProps extends PressableProps {
@@ -70,6 +158,7 @@ export interface ISelectItemLabelProps {
 export interface SelectItemData {
     value: string;
     label: string;
+    /** Prevents the option from being selected or highlighted by keyboard. */
     disabled?: boolean;
 }
 export interface SelectItemCollectionContextValue {
@@ -81,8 +170,22 @@ export interface SelectContextValue {
     open: boolean;
     items: SelectItemData[];
     setOpen: (open: boolean) => void;
-    value: string | undefined;
-    onValueChange: (value: string) => void;
+    type: SelectType;
+    /** Raw selection: `string` in single mode, `string[]` in multiple mode. */
+    value: string | string[] | undefined;
+    /** Selection normalized to an array for both modes. */
+    selectedValues: string[];
+    isSelected: (value: string) => boolean;
+    /** Adds or removes `value` from the selection without closing. */
+    toggleValue: (value: string) => void;
+    /** Replaces the selection with `value` and closes the popup. */
+    selectValueAndClose: (value: string) => void;
+    /** Commits an option press: `toggleValue` in multiple mode, `selectValueAndClose` in single. */
+    commitValue: (value: string) => void;
+    /** Disabled via the root, `SelectItemData.disabled`, or a mounted `Select.Item disabled`. */
+    isItemDisabled: (value: string) => boolean;
+    /** Called by `Select.Item` so item-level `disabled` reaches keyboard navigation. */
+    registerDisabledItem: (value: string) => () => void;
     disabled: boolean;
     required: boolean;
     invalid: boolean;
@@ -91,6 +194,23 @@ export interface SelectContextValue {
     triggerRef: RefObject<any>;
     contentId: string;
     triggerId: string;
+    /** Current search query. Reset to `''` when the popup closes. */
+    inputValue: string;
+    setInputValue: (inputValue: string) => void;
+    /** `items` that pass `filter` for the current query, in `items` order. */
+    visibleItems: SelectItemData[];
+    isItemVisible: (value: string) => boolean;
+    /** `true` while a `Select.Search` is mounted: the popup becomes a dialog around the listbox. */
+    hasSearch: boolean;
+    /** Called by `Select.Search` on mount. Returns the unregister function. */
+    registerSearch: () => () => void;
+    /** Plain text of `Select.Empty`, announced when nothing matches. */
+    emptyText: string | undefined;
+    setEmptyText: (text: string | undefined) => void;
+    /** Id of the listbox inside the dialog when `hasSearch` is `true`. */
+    listboxId: string;
+    /** `Field.Label` id when the select is inside a `Field`. */
+    labelId?: string;
     /** Currently highlighted value during keyboard navigation */
     activeValue: string | undefined;
     setActiveValue: (value: string | undefined) => void;
@@ -98,4 +218,5 @@ export interface SelectContextValue {
     /** From `Form.Field` via `useFormControl` on the select root (helper/error `aria-describedby`). */
     ariaDescribedBy?: string;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/select/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/select/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/select/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/select/useContentFocus.d.ts

@@ -1,19 +1,16 @@
 import type { RefObject } from 'react';
-import type { SelectItemData } from './types';
 export interface UseContentFocusOptions {
     open: boolean;
     triggerRef: RefObject<any>;
-    items: SelectItemData[];
-    value: string | undefined;
     setActiveValue: (value: string | undefined) => void;
 }
 /**
  * Manages focus lifecycle for overlay content:
+ * - Clears `activeValue` when the overlay closes
  * - Restores focus to the trigger when the overlay closes (web)
- * - Initializes `activeValue` to the current value or first enabled item
  *
- * Initial focus on open is handled via a ref callback in SelectContent
- * to avoid timing issues with deferred portal rendering.
+ * Initial focus on open is handled by `FocusScope autoFocus` in SelectContent, and the
+ * highlight while open by `useQueryHighlight`.
  */
-export declare function useContentFocus({ open, triggerRef, items, value, setActiveValue, }: UseContentFocusOptions): void;
+export declare function useContentFocus({ open, triggerRef, setActiveValue }: UseContentFocusOptions): void;
 //# sourceMappingURL=useContentFocus.d.ts.map

package/lib/typescript/select/useContentFocus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useContentFocus.d.ts","sourceRoot":"","sources":["../../../src/select/useContentFocus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,UAAU,EACV,KAAK,EACL,KAAK,EACL,cAAc,GACf,EAAE,sBAAsB,QAwBxB"}
+{"version":3,"file":"useContentFocus.d.ts","sourceRoot":"","sources":["../../../src/select/useContentFocus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,sBAAsB,QAc3F"}

package/lib/typescript/select/useListboxNavigation.d.ts

@@ -1,12 +1,25 @@
-import type { SelectItemData } from './types';
+import type { SelectItemData, SelectType } from './types';
 export interface UseListboxNavigationOptions {
+    /** Options to navigate, in display order. Pass the filtered list when a search is present. */
     items: SelectItemData[];
     activeValue: string | undefined;
     setActiveValue: (value: string | undefined) => void;
-    onSelect: (value: string) => void;
+    type: SelectType;
+    /** Commit for `type="multiple"`: toggles the highlighted option and keeps the listbox open. */
+    onToggle: (value: string) => void;
+    /** Commit for `type="single"`: selects the highlighted option and closes the listbox. */
+    onSelectAndClose: (value: string) => void;
+    /** Excludes options from keyboard highlight and commit. */
+    isItemDisabled: (value: string) => boolean;
     onDismiss: () => void;
+    /**
+     * Keys arrive from the `Select.Search` input (virtual focus). Space types instead of
+     * committing, Home/End move the caret, and Enter is always consumed so the input neither
+     * blurs nor submits an enclosing form.
+     */
+    isSearch?: boolean;
 }
-export declare function useListboxNavigation({ items, activeValue, setActiveValue, onSelect, onDismiss, }: UseListboxNavigationOptions): {
+export declare function useListboxNavigation({ items, activeValue, setActiveValue, type, onToggle, onSelectAndClose, isItemDisabled, onDismiss, isSearch, }: UseListboxNavigationOptions): {
     handleKeyDown: (e: any) => void;
     getEnabledItems: () => SelectItemData[];
 };

package/lib/typescript/select/useListboxNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useListboxNavigation.d.ts","sourceRoot":"","sources":["../../../src/select/useListboxNavigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,SAAS,GACV,EAAE,2BAA2B;uBAUtB,GAAG;;EA0DV"}
+{"version":3,"file":"useListboxNavigation.d.ts","sourceRoot":"","sources":["../../../src/select/useListboxNavigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1D,MAAM,WAAW,2BAA2B;IAC1C,8FAA8F;IAC9F,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,UAAU,CAAC;IACjB,+FAA+F;IAC/F,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,yFAAyF;IACzF,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,2DAA2D;IAC3D,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,WAAW,EACX,cAAc,EACd,IAAI,EACJ,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,QAAgB,GACjB,EAAE,2BAA2B;uBAatB,GAAG;;EAmEV"}

package/lib/typescript/select/useQueryHighlight.d.ts

@@ -0,0 +1,21 @@
+import type { SelectItemData } from './types';
+export interface UseQueryHighlightOptions {
+    open: boolean;
+    inputValue: string;
+    visibleItems: SelectItemData[];
+    selectedValues: string[];
+    isItemDisabled: (value: string) => boolean;
+    activeValue: string | undefined;
+    setActiveValue: (value: string | undefined) => void;
+}
+/**
+ * Owns the highlight while open:
+ * - Unset (on open, or once async `items` arrive): the first enabled selected item, or the
+ *   first enabled item.
+ * - Query change: the first enabled match.
+ * - Hidden by the filter or a swapped `items` list: the first enabled item.
+ *
+ * Otherwise the highlight stays put, so a multiple-mode toggle does not move it.
+ */
+export declare function useQueryHighlight({ open, inputValue, visibleItems, selectedValues, isItemDisabled, activeValue, setActiveValue, }: UseQueryHighlightOptions): void;
+//# sourceMappingURL=useQueryHighlight.d.ts.map

package/lib/typescript/select/useQueryHighlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryHighlight.d.ts","sourceRoot":"","sources":["../../../src/select/useQueryHighlight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,GACf,EAAE,wBAAwB,QA8B1B"}

package/lib/typescript/select/useSelectTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSelectTrigger.d.ts","sourceRoot":"","sources":["../../../src/select/useSelectTrigger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useSelectTrigger.d.ts","sourceRoot":"","sources":["../../../src/select/useSelectTrigger.ts"],"names":[],"mappings":"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"}

package/lib/typescript/select/useSelectTrigger.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSelectTrigger.web.d.ts","sourceRoot":"","sources":["../../../src/select/useSelectTrigger.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EAElB,MAAM,OAAO,CAAC;AAaf,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAS5B;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,EACnC,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CA6NxB;AAED,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,GACvB,CAAC"}
+{"version":3,"file":"useSelectTrigger.web.d.ts","sourceRoot":"","sources":["../../../src/select/useSelectTrigger.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EAElB,MAAM,OAAO,CAAC;AAaf,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAS5B;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,EACnC,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CAiOxB;AAED,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,GACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/primitives",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -69,8 +69,8 @@
     "@react-stately/disclosure": "3.1.1",
     "@react-stately/radio": "3.12.0",
     "@react-stately/toggle": "3.9.4",
-    "@cdx-ui/formatters": "0.3.3",
-    "@cdx-ui/utils": "0.3.3"
+    "@cdx-ui/formatters": "0.3.4",
+    "@cdx-ui/utils": "0.3.4"
   },
   "devDependencies": {
     "@types/react": "19.2.14",

package/src/select/SelectContent.tsx

@@ -1,14 +1,29 @@
-import React, { forwardRef, useCallback, useRef, type ComponentRef } from 'react';
+import React, { forwardRef, useCallback, useMemo, useRef, type ComponentRef } from 'react';
 import { Platform, View } from 'react-native';
 import { FadeIn, FadeOut } from 'react-native-reanimated';
 import { composeEventHandlers, mergeRefs } from '@cdx-ui/utils';
+import { FocusScope } from '@react-native-aria/focus';
 import { OverlayContainer, useAnchoredOverlay, useDismissOverlay, useEscapeKey } from '../overlay';
 import { Slot } from '../slot';
 import { dataAttributes, mergeDataAttributes } from '../utils/dataAttributes';
-import { useSelectContext } from './context';
+import { SelectContentProvider, useSelectContext } from './context';
+import { getPopupRoleProps } from './popupRole';
+import { SelectDismissButton } from './SelectDismissButton';
 import type { ISelectContentProps } from './types';
 import { useContentFocus } from './useContentFocus';
 import { useListboxNavigation } from './useListboxNavigation';
+import { useQueryHighlight } from './useQueryHighlight';
+
+/**
+ * Keeps DOM focus in the search input when the pointer goes down elsewhere in the popup, so
+ * typing continues after an option is clicked (virtual focus).
+ */
+function keepSearchInputFocus(e: { target: unknown; preventDefault: () => void }) {
+  const target = e.target as { closest?: (selector: string) => unknown } | null;
+  if (target?.closest?.('input, textarea') == null) {
+    e.preventDefault();
+  }
+}
 
 export interface SelectContentProps extends ISelectContentProps {
   asChild?: boolean;
@@ -27,6 +42,7 @@ export const SelectContent = forwardRef<ComponentRef<typeof View>, SelectContent
       placement = 'bottom-start',
       offset = 4,
       crossOffset = 0,
+      dismissAccessibilityLabel = 'Dismiss',
       ...props
     },
     ref,
@@ -38,25 +54,22 @@ export const SelectContent = forwardRef<ComponentRef<typeof View>, SelectContent
       triggerId,
       activeValue,
       setActiveValue,
-      value,
-      onValueChange,
+      type,
+      selectedValues,
+      toggleValue,
+      selectValueAndClose,
+      isItemDisabled,
       native,
       triggerRef,
-      items,
+      inputValue,
+      visibleItems,
+      hasSearch,
+      labelId,
+      accessibilityLabel,
     } = useSelectContext();
 
     const contentRef = useRef<HTMLElement | null>(null);
-
-    const focusOnMount = useCallback((node: unknown) => {
-      contentRef.current = node as HTMLElement | null;
-      if (node && Platform.OS === 'web') {
-        requestAnimationFrame(() => {
-          setTimeout(() => {
-            (node as HTMLElement).focus?.();
-          }, 100);
-        });
-      }
-    }, []);
+    const dismissButtonRef = useRef<HTMLButtonElement | null>(null);
 
     const dismiss = useCallback(() => setOpen(false), [setOpen]);
 
@@ -73,35 +86,42 @@ export const SelectContent = forwardRef<ComponentRef<typeof View>, SelectContent
       collisionBehavior: 'flip-shift',
       width: 'anchor',
     });
-    const mergedRef = mergeRefs(ref, focusOnMount as unknown as React.Ref<View>, floatingRef);
+    const mergedRef = mergeRefs(ref, contentRef as unknown as React.Ref<View>, floatingRef);
 
-    useDismissOverlay(overlayOpen, contentRef, [triggerRef], dismiss);
+    useDismissOverlay(overlayOpen, contentRef, [triggerRef, dismissButtonRef], dismiss);
     useEscapeKey(overlayOpen, dismiss);
 
     const { handleKeyDown } = useListboxNavigation({
-      items,
+      items: visibleItems,
       activeValue,
       setActiveValue,
-      onSelect: (val) => {
-        onValueChange(val);
-        setOpen(false);
-      },
+      type,
+      onToggle: toggleValue,
+      onSelectAndClose: selectValueAndClose,
+      isItemDisabled,
       onDismiss: dismiss,
+      isSearch: hasSearch,
     });
 
-    useContentFocus({
+    useContentFocus({ open, triggerRef, setActiveValue });
+
+    useQueryHighlight({
       open,
-      triggerRef,
-      items,
-      value,
+      inputValue,
+      visibleItems,
+      selectedValues,
+      isItemDisabled,
+      activeValue,
       setActiveValue,
     });
 
+    const contentContext = useMemo(() => ({ handleKeyDown }), [handleKeyDown]);
+
     if (!overlayOpen) {
       return null;
     }
 
-    const webProps =
+    const platformProps =
       Platform.OS === 'web'
         ? {
             onKeyDown: composeEventHandlers(
@@ -109,38 +129,53 @@ export const SelectContent = forwardRef<ComponentRef<typeof View>, SelectContent
               handleKeyDown,
             ),
             tabIndex: -1,
+            'aria-multiselectable': (!hasSearch && type === 'multiple') || undefined,
+            ...(hasSearch ? { onMouseDown: keepSearchInputFocus } : {}),
           }
-        : {};
+        : { onAccessibilityEscape: composeEventHandlers(props.onAccessibilityEscape, dismiss) };
+
+    const roleProps = getPopupRoleProps({ hasSearch, labelId, accessibilityLabel, triggerId });
 
     const Comp = asChild ? Slot : View;
 
     return (
-      <OverlayContainer
-        onDismiss={dismiss}
-        entering={enteringAnimation ?? FadeIn.duration(150)}
-        exiting={exitingAnimation ?? FadeOut.duration(100)}
-      >
-        <Comp
-          ref={mergedRef}
-          onLayout={composeEventHandlers(onLayout, onFloatingLayout)}
-          style={[style, overlayStyle]}
-          role="listbox"
-          id={contentId}
-          aria-labelledby={triggerId}
-          {...props}
-          {...mergeDataAttributes(
-            props,
-            dataAttributes({
-              state: 'open',
-              side: position?.resolvedPlacement.side,
-              align: position?.resolvedPlacement.align,
-            }),
-          )}
-          {...webProps}
+      <SelectContentProvider value={contentContext}>
+        <OverlayContainer
+          onDismiss={dismiss}
+          entering={enteringAnimation ?? FadeIn.duration(150)}
+          exiting={exitingAnimation ?? FadeOut.duration(100)}
         >
-          {children}
-        </Comp>
-      </OverlayContainer>
+          {/* With search, autofocus lands on the input; otherwise options are not tabbable, so it
+              falls back to the focusable popup. Nested in the React tree, the scope also lets focus
+              enter this body-portalled popup from inside a `Drawer`'s contained scope. */}
+          <FocusScope autoFocus>
+            <Comp
+              ref={mergedRef}
+              onLayout={composeEventHandlers(onLayout, onFloatingLayout)}
+              style={[style, overlayStyle]}
+              id={contentId}
+              {...roleProps}
+              {...props}
+              {...mergeDataAttributes(
+                props,
+                dataAttributes({
+                  state: 'open',
+                  side: position?.resolvedPlacement.side,
+                  align: position?.resolvedPlacement.align,
+                }),
+              )}
+              {...platformProps}
+            >
+              {children}
+            </Comp>
+            <SelectDismissButton
+              ref={dismissButtonRef}
+              onDismiss={dismiss}
+              accessibilityLabel={dismissAccessibilityLabel}
+            />
+          </FocusScope>
+        </OverlayContainer>
+      </SelectContentProvider>
     );
   },
 );

package/src/select/SelectDismissButton.tsx

@@ -0,0 +1,14 @@
+import { forwardRef } from 'react';
+
+export interface SelectDismissButtonProps {
+  onDismiss: () => void;
+  accessibilityLabel: string;
+}
+
+/**
+ * Web-only. Native screen readers close the popup with the iOS escape gesture
+ * (`onAccessibilityEscape` on `SelectContent`) and Android back (`onRequestClose`).
+ */
+export const SelectDismissButton = forwardRef<unknown, SelectDismissButtonProps>(() => null);
+
+SelectDismissButton.displayName = 'SelectDismissButton';

package/src/select/SelectDismissButton.web.tsx

@@ -0,0 +1,26 @@
+import { forwardRef } from 'react';
+import { VisuallyHidden } from '@react-aria/visually-hidden';
+import type { SelectDismissButtonProps } from './SelectDismissButton';
+
+export type { SelectDismissButtonProps };
+
+/**
+ * Visually hidden close control for screen-reader users, who cannot press Escape or click
+ * outside while browsing the popup. Out of the Tab order (Tab already closes the listbox).
+ * Rendered as a sibling of the listbox because a listbox may only own options.
+ */
+export const SelectDismissButton = forwardRef<HTMLButtonElement, SelectDismissButtonProps>(
+  ({ onDismiss, accessibilityLabel }, ref) => (
+    <VisuallyHidden>
+      <button
+        ref={ref}
+        type="button"
+        tabIndex={-1}
+        aria-label={accessibilityLabel}
+        onClick={onDismiss}
+      />
+    </VisuallyHidden>
+  ),
+);
+
+SelectDismissButton.displayName = 'SelectDismissButton';