@base-ui/react 1.4.1 → 1.6.0

package/esm/combobox/popup/ComboboxPopup.js

@@ -1,111 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import { useStore } from '@base-ui/utils/store';
-import { FloatingFocusManager } from "../../floating-ui-react/index.js";
-import { useRenderElement } from "../../internals/useRenderElement.js";
-import { useComboboxFloatingContext, useComboboxRootContext, useComboboxDerivedItemsContext } from "../root/ComboboxRootContext.js";
-import { selectors } from "../store.js";
-import { popupStateMapping } from "../../utils/popupStateMapping.js";
-import { useComboboxPositionerContext } from "../positioner/ComboboxPositionerContext.js";
-import { useOpenChangeComplete } from "../../internals/useOpenChangeComplete.js";
-import { transitionStatusMapping } from "../../internals/stateAttributesMapping.js";
-import { contains, getTarget } from "../../floating-ui-react/utils.js";
-import { getDisabledMountTransitionStyles } from "../../utils/getDisabledMountTransitionStyles.js";
-import { ComboboxInternalDismissButton } from "../utils/ComboboxInternalDismissButton.js";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-const stateAttributesMapping = {
-  ...popupStateMapping,
-  ...transitionStatusMapping
-};
-
-/**
- * A container for the list.
- * Renders a `<div>` element.
- *
- * Documentation: [Base UI Combobox](https://base-ui.com/react/components/combobox)
- */
-export const ComboboxPopup = /*#__PURE__*/React.forwardRef(function ComboboxPopup(componentProps, forwardedRef) {
-  const {
-    render,
-    className,
-    style,
-    initialFocus,
-    finalFocus,
-    ...elementProps
-  } = componentProps;
-  const store = useComboboxRootContext();
-  const positioning = useComboboxPositionerContext();
-  const floatingRootContext = useComboboxFloatingContext();
-  const {
-    filteredItems
-  } = useComboboxDerivedItemsContext();
-  const mounted = useStore(store, selectors.mounted);
-  const open = useStore(store, selectors.open);
-  const openMethod = useStore(store, selectors.openMethod);
-  const transitionStatus = useStore(store, selectors.transitionStatus);
-  const inputInsidePopup = useStore(store, selectors.inputInsidePopup);
-  const inputElement = useStore(store, selectors.inputElement);
-  const modal = useStore(store, selectors.modal);
-  const empty = filteredItems.length === 0;
-  useOpenChangeComplete({
-    open,
-    ref: store.state.popupRef,
-    onComplete() {
-      if (open) {
-        store.state.onOpenChangeComplete(true);
-      }
-    }
-  });
-  const state = {
-    open,
-    side: positioning.side,
-    align: positioning.align,
-    anchorHidden: positioning.anchorHidden,
-    transitionStatus,
-    empty
-  };
-  const element = useRenderElement('div', componentProps, {
-    state,
-    ref: [forwardedRef, store.state.popupRef],
-    props: [{
-      role: inputInsidePopup ? 'dialog' : 'presentation',
-      tabIndex: -1,
-      onFocus(event) {
-        const target = getTarget(event.nativeEvent);
-        if (openMethod !== 'touch' && (contains(store.state.listElement, target) || target === event.currentTarget)) {
-          store.state.inputRef.current?.focus();
-        }
-      }
-    }, getDisabledMountTransitionStyles(transitionStatus), elementProps],
-    stateAttributesMapping
-  });
-
-  // Default initial focus logic:
-  // If opened by touch, focus the popup element to prevent the virtual keyboard from opening
-  // (this is required for Android specifically as iOS handles this automatically).
-  const computedDefaultInitialFocus = inputInsidePopup ? interactionType => interactionType === 'touch' ? store.state.popupRef.current : inputElement : false;
-  const resolvedInitialFocus = initialFocus === undefined ? computedDefaultInitialFocus : initialFocus;
-  let resolvedFinalFocus;
-  if (finalFocus != null) {
-    resolvedFinalFocus = finalFocus;
-  } else {
-    resolvedFinalFocus = inputInsidePopup ? undefined : false;
-  }
-  const focusManagerModal = !inputInsidePopup || modal;
-  return /*#__PURE__*/_jsx(FloatingFocusManager, {
-    context: floatingRootContext,
-    disabled: !mounted,
-    modal: focusManagerModal,
-    openInteractionType: openMethod,
-    initialFocus: resolvedInitialFocus,
-    returnFocus: resolvedFinalFocus,
-    getInsideElements: () => [store.state.startDismissRef.current, store.state.endDismissRef.current],
-    children: /*#__PURE__*/_jsxs(React.Fragment, {
-      children: [element, focusManagerModal && /*#__PURE__*/_jsx(ComboboxInternalDismissButton, {
-        ref: store.state.endDismissRef
-      })]
-    })
-  });
-});
-if (process.env.NODE_ENV !== "production") ComboboxPopup.displayName = "ComboboxPopup";

package/esm/combobox/popup/ComboboxPopupDataAttributes.js

@@ -1,39 +0,0 @@
-import { CommonPopupDataAttributes } from "../../utils/popupStateMapping.js";
-export let ComboboxPopupDataAttributes = function (ComboboxPopupDataAttributes) {
-  /**
-   * Present when the popup is open.
-   */
-  ComboboxPopupDataAttributes[ComboboxPopupDataAttributes["open"] = CommonPopupDataAttributes.open] = "open";
-  /**
-   * Present when the popup is closed.
-   */
-  ComboboxPopupDataAttributes[ComboboxPopupDataAttributes["closed"] = CommonPopupDataAttributes.closed] = "closed";
-  /**
-   * Present when the popup is animating in.
-   */
-  ComboboxPopupDataAttributes[ComboboxPopupDataAttributes["startingStyle"] = CommonPopupDataAttributes.startingStyle] = "startingStyle";
-  /**
-   * Present when the popup is animating out.
-   */
-  ComboboxPopupDataAttributes[ComboboxPopupDataAttributes["endingStyle"] = CommonPopupDataAttributes.endingStyle] = "endingStyle";
-  /**
-   * Indicates which side the popup is positioned relative to the trigger.
-   * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start'}
-   */
-  ComboboxPopupDataAttributes[ComboboxPopupDataAttributes["side"] = CommonPopupDataAttributes.side] = "side";
-  /**
-   * Indicates how the popup is aligned relative to specified side.
-   * @type {'start' | 'center' | 'end'}
-   */
-  ComboboxPopupDataAttributes[ComboboxPopupDataAttributes["align"] = CommonPopupDataAttributes.align] = "align";
-  /**
-   * Present if animations should be instant.
-   * @type {'click' | 'dismiss'}
-   */
-  ComboboxPopupDataAttributes["instant"] = "data-instant";
-  /**
-   * Present when the items list is empty.
-   */
-  ComboboxPopupDataAttributes["empty"] = "data-empty";
-  return ComboboxPopupDataAttributes;
-}({});

package/esm/combobox/portal/ComboboxPortal.d.ts

@@ -1,22 +0,0 @@
-import * as React from 'react';
-import { FloatingPortal } from "../../floating-ui-react/index.js";
-/**
- * A portal element that moves the popup to a different part of the DOM.
- * By default, the portal element is appended to `<body>`.
- * Renders a `<div>` element.
- *
- * Documentation: [Base UI Combobox](https://base-ui.com/react/components/combobox)
- */
-export declare const ComboboxPortal: React.ForwardRefExoticComponent<Omit<ComboboxPortalProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export interface ComboboxPortalState {}
-export interface ComboboxPortalProps extends FloatingPortal.Props<ComboboxPortalState> {
-  /**
-   * Whether to keep the portal mounted in the DOM while the popup is hidden.
-   * @default false
-   */
-  keepMounted?: boolean | undefined;
-}
-export declare namespace ComboboxPortal {
-  type State = ComboboxPortalState;
-  type Props = ComboboxPortalProps;
-}

package/esm/combobox/portal/ComboboxPortal.js

@@ -1,38 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import { useStore } from '@base-ui/utils/store';
-import { FloatingPortal } from "../../floating-ui-react/index.js";
-import { useComboboxRootContext } from "../root/ComboboxRootContext.js";
-import { ComboboxPortalContext } from "./ComboboxPortalContext.js";
-import { selectors } from "../store.js";
-
-/**
- * A portal element that moves the popup to a different part of the DOM.
- * By default, the portal element is appended to `<body>`.
- * Renders a `<div>` element.
- *
- * Documentation: [Base UI Combobox](https://base-ui.com/react/components/combobox)
- */
-import { jsx as _jsx } from "react/jsx-runtime";
-export const ComboboxPortal = /*#__PURE__*/React.forwardRef(function ComboboxPortal(props, forwardedRef) {
-  const {
-    keepMounted = false,
-    ...portalProps
-  } = props;
-  const store = useComboboxRootContext();
-  const mounted = useStore(store, selectors.mounted);
-  const forceMounted = useStore(store, selectors.forceMounted);
-  const shouldRender = mounted || keepMounted || forceMounted;
-  if (!shouldRender) {
-    return null;
-  }
-  return /*#__PURE__*/_jsx(ComboboxPortalContext.Provider, {
-    value: keepMounted,
-    children: /*#__PURE__*/_jsx(FloatingPortal, {
-      ref: forwardedRef,
-      ...portalProps
-    })
-  });
-});
-if (process.env.NODE_ENV !== "production") ComboboxPortal.displayName = "ComboboxPortal";

package/esm/combobox/positioner/ComboboxPositioner.d.ts

@@ -1,37 +0,0 @@
-import * as React from 'react';
-import { type Side, type Align, type UseAnchorPositioningSharedParameters } from "../../utils/useAnchorPositioning.js";
-import type { BaseUIComponentProps } from "../../internals/types.js";
-/**
- * Positions the popup against the trigger.
- * Renders a `<div>` element.
- *
- * Documentation: [Base UI Combobox](https://base-ui.com/react/components/combobox)
- */
-export declare const ComboboxPositioner: React.ForwardRefExoticComponent<Omit<ComboboxPositionerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export interface ComboboxPositionerState {
-  /**
-   * Whether the popup is currently open.
-   */
-  open: boolean;
-  /**
-   * The side of the anchor the component is placed on.
-   */
-  side: Side;
-  /**
-   * The alignment of the component relative to the anchor.
-   */
-  align: Align;
-  /**
-   * Whether the anchor element is hidden.
-   */
-  anchorHidden: boolean;
-  /**
-   * Whether there are no items to display.
-   */
-  empty: boolean;
-}
-export interface ComboboxPositionerProps extends UseAnchorPositioningSharedParameters, BaseUIComponentProps<'div', ComboboxPositionerState> {}
-export declare namespace ComboboxPositioner {
-  type State = ComboboxPositionerState;
-  type Props = ComboboxPositionerProps;
-}

package/esm/combobox/positioner/ComboboxPositioner.js

@@ -1,110 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import { useStore } from '@base-ui/utils/store';
-import { useIsoLayoutEffect } from '@base-ui/utils/useIsoLayoutEffect';
-import { useStableCallback } from '@base-ui/utils/useStableCallback';
-import { inertValue } from '@base-ui/utils/inertValue';
-import { useComboboxFloatingContext, useComboboxRootContext, useComboboxDerivedItemsContext } from "../root/ComboboxRootContext.js";
-import { ComboboxPositionerContext } from "./ComboboxPositionerContext.js";
-import { useAnchorPositioning } from "../../utils/useAnchorPositioning.js";
-import { useComboboxPortalContext } from "../portal/ComboboxPortalContext.js";
-import { DROPDOWN_COLLISION_AVOIDANCE } from "../../internals/constants.js";
-import { selectors } from "../store.js";
-import { InternalBackdrop } from "../../utils/InternalBackdrop.js";
-import { usePositioner } from "../../utils/usePositioner.js";
-import { useAnchoredPopupScrollLock } from "../../utils/useAnchoredPopupScrollLock.js";
-
-/**
- * Positions the popup against the trigger.
- * Renders a `<div>` element.
- *
- * Documentation: [Base UI Combobox](https://base-ui.com/react/components/combobox)
- */
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-export const ComboboxPositioner = /*#__PURE__*/React.forwardRef(function ComboboxPositioner(componentProps, forwardedRef) {
-  const {
-    render,
-    className,
-    anchor,
-    positionMethod = 'absolute',
-    side = 'bottom',
-    align = 'center',
-    sideOffset = 0,
-    alignOffset = 0,
-    collisionBoundary = 'clipping-ancestors',
-    collisionPadding = 5,
-    arrowPadding = 5,
-    sticky = false,
-    disableAnchorTracking = false,
-    collisionAvoidance = DROPDOWN_COLLISION_AVOIDANCE,
-    style: styleProp,
-    ...elementProps
-  } = componentProps;
-  const store = useComboboxRootContext();
-  const {
-    filteredItems
-  } = useComboboxDerivedItemsContext();
-  const floatingRootContext = useComboboxFloatingContext();
-  const keepMounted = useComboboxPortalContext();
-  const modal = useStore(store, selectors.modal);
-  const open = useStore(store, selectors.open);
-  const mounted = useStore(store, selectors.mounted);
-  const openMethod = useStore(store, selectors.openMethod);
-  const positionerElement = useStore(store, selectors.positionerElement);
-  const triggerElement = useStore(store, selectors.triggerElement);
-  const inputElement = useStore(store, selectors.inputElement);
-  const inputGroupElement = useStore(store, selectors.inputGroupElement);
-  const inputInsidePopup = useStore(store, selectors.inputInsidePopup);
-  const transitionStatus = useStore(store, selectors.transitionStatus);
-  const empty = filteredItems.length === 0;
-  const resolvedAnchor = anchor ?? (inputInsidePopup ? triggerElement : inputGroupElement ?? inputElement);
-  const positioning = useAnchorPositioning({
-    anchor: resolvedAnchor,
-    floatingRootContext,
-    positionMethod,
-    mounted,
-    side,
-    sideOffset,
-    align,
-    alignOffset,
-    arrowPadding,
-    collisionBoundary,
-    collisionPadding,
-    sticky,
-    disableAnchorTracking,
-    keepMounted,
-    collisionAvoidance,
-    lazyFlip: true
-  });
-  useAnchoredPopupScrollLock(open && modal, openMethod === 'touch', positionerElement, triggerElement);
-  const state = {
-    open,
-    side: positioning.side,
-    align: positioning.align,
-    anchorHidden: positioning.anchorHidden,
-    empty
-  };
-  useIsoLayoutEffect(() => {
-    store.set('popupSide', positioning.side);
-  }, [store, positioning.side]);
-  const setPositionerElement = useStableCallback(element => {
-    store.set('positionerElement', element);
-  });
-  const element = usePositioner(componentProps, state, {
-    styles: positioning.positionerStyles,
-    transitionStatus,
-    props: elementProps,
-    refs: [forwardedRef, setPositionerElement],
-    hidden: !mounted,
-    inert: !open
-  });
-  return /*#__PURE__*/_jsxs(ComboboxPositionerContext.Provider, {
-    value: positioning,
-    children: [mounted && modal && /*#__PURE__*/_jsx(InternalBackdrop, {
-      inert: inertValue(!open),
-      cutout: inputGroupElement ?? inputElement ?? triggerElement
-    }), element]
-  });
-});
-if (process.env.NODE_ENV !== "production") ComboboxPositioner.displayName = "ComboboxPositioner";

package/esm/combobox/positioner/ComboboxPositionerContext.d.ts

@@ -1,6 +0,0 @@
-import * as React from 'react';
-import type { UseAnchorPositioningReturnValue } from "../../utils/useAnchorPositioning.js";
-export type ComboboxPositionerContext = Pick<UseAnchorPositioningReturnValue, 'side' | 'align' | 'arrowRef' | 'arrowUncentered' | 'arrowStyles' | 'anchorHidden' | 'isPositioned'>;
-export declare const ComboboxPositionerContext: React.Context<ComboboxPositionerContext | undefined>;
-export declare function useComboboxPositionerContext(optional?: false): ComboboxPositionerContext;
-export declare function useComboboxPositionerContext(optional: true): ComboboxPositionerContext | undefined;

package/esm/combobox/positioner/ComboboxPositionerDataAttributes.js

@@ -1,30 +0,0 @@
-import { CommonPopupDataAttributes } from "../../utils/popupStateMapping.js";
-export let ComboboxPositionerDataAttributes = function (ComboboxPositionerDataAttributes) {
-  /**
-   * Present when the popup is open.
-   */
-  ComboboxPositionerDataAttributes[ComboboxPositionerDataAttributes["open"] = CommonPopupDataAttributes.open] = "open";
-  /**
-   * Present when the popup is closed.
-   */
-  ComboboxPositionerDataAttributes[ComboboxPositionerDataAttributes["closed"] = CommonPopupDataAttributes.closed] = "closed";
-  /**
-   * Present when the anchor is hidden.
-   */
-  ComboboxPositionerDataAttributes[ComboboxPositionerDataAttributes["anchorHidden"] = CommonPopupDataAttributes.anchorHidden] = "anchorHidden";
-  /**
-   * Indicates which side the popup is positioned relative to the trigger.
-   * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start'}
-   */
-  ComboboxPositionerDataAttributes[ComboboxPositionerDataAttributes["side"] = CommonPopupDataAttributes.side] = "side";
-  /**
-   * Indicates how the popup is aligned relative to specified side.
-   * @type {'start' | 'center' | 'end'}
-   */
-  ComboboxPositionerDataAttributes[ComboboxPositionerDataAttributes["align"] = CommonPopupDataAttributes.align] = "align";
-  /**
-   * Present when the items list is empty.
-   */
-  ComboboxPositionerDataAttributes["empty"] = "data-empty";
-  return ComboboxPositionerDataAttributes;
-}({});

package/esm/combobox/root/AriaCombobox.d.ts

@@ -1,255 +0,0 @@
-import * as React from 'react';
-import { type BaseUIChangeEventDetails, type BaseUIGenericEventDetails } from "../../internals/createBaseUIEventDetails.js";
-import { REASONS } from "../../internals/reasons.js";
-import { Group } from "../../internals/resolveValueLabel.js";
-/**
- * @internal
- */
-export declare function AriaCombobox<Value, Mode extends SelectionMode = 'none'>(props: Omit<AriaComboboxProps<Value, Mode>, 'items'> & {
-  items: readonly Group<any>[];
-}): React.JSX.Element;
-export declare function AriaCombobox<Value, Mode extends SelectionMode = 'none'>(props: Omit<AriaComboboxProps<Value, Mode>, 'items'> & {
-  items?: readonly any[] | undefined;
-}): React.JSX.Element;
-type SelectionMode = 'single' | 'multiple' | 'none';
-type ComboboxItemValueType<ItemValue, Mode extends SelectionMode> = Mode extends 'multiple' ? ItemValue[] : ItemValue;
-interface ComboboxRootProps<ItemValue> {
-  children?: React.ReactNode;
-  /**
-   * Identifies the field when a form is submitted.
-   */
-  name?: string | undefined;
-  /**
-   * Identifies the form that owns the internal input.
-   * Useful when the combobox is rendered outside the form.
-   */
-  form?: string | undefined;
-  /**
-   * The id of the component.
-   */
-  id?: string | undefined;
-  /**
-   * Whether the user must choose a value before submitting a form.
-   * @default false
-   */
-  required?: boolean | undefined;
-  /**
-   * Whether the user should be unable to choose a different option from the popup.
-   * @default false
-   */
-  readOnly?: boolean | undefined;
-  /**
-   * Whether the component should ignore user interaction.
-   * @default false
-   */
-  disabled?: boolean | undefined;
-  /**
-   * Whether the popup is initially open.
-   *
-   * To render a controlled popup, use the `open` prop instead.
-   * @default false
-   */
-  defaultOpen?: boolean | undefined;
-  /**
-   * Whether the popup is currently open. Use when controlled.
-   */
-  open?: boolean | undefined;
-  /**
-   * Event handler called when the popup is opened or closed.
-   */
-  onOpenChange?: ((open: boolean, eventDetails: AriaCombobox.ChangeEventDetails) => void) | undefined;
-  /**
-   * Event handler called after any animations complete when the popup is opened or closed.
-   */
-  onOpenChangeComplete?: ((open: boolean) => void) | undefined;
-  /**
-   * Whether the popup opens when clicking the input.
-   * @default true
-   */
-  openOnInputClick?: boolean | undefined;
-  /**
-   * Whether the first matching item is highlighted automatically.
-   * - `false`: do not highlight automatically.
-   * - `true`: highlight after the user types and keep the highlight while the query changes.
-   * - `'always'`: highlight the first item as soon as the list opens.
-   * @default false
-   */
-  autoHighlight?: boolean | 'always' | undefined;
-  /**
-   * Whether the highlighted item should be preserved when the pointer leaves the list.
-   * @default false
-   */
-  keepHighlight?: boolean | undefined;
-  /**
-   * Whether moving the pointer over items should highlight them.
-   * Disabling this prop allows CSS `:hover` to be differentiated from the `:focus` (`data-highlighted`) state.
-   * @default true
-   */
-  highlightItemOnHover?: boolean | undefined;
-  /**
-   * Whether to loop keyboard focus back to the input when the end of the list is reached while using the arrow keys. The first item can then be reached by pressing <kbd>ArrowDown</kbd> again from the input, or the last item can be reached by pressing <kbd>ArrowUp</kbd> from the input.
-   * The input is always included in the focus loop per [ARIA Authoring Practices](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/).
-   * When disabled, focus does not move when on the last element and the user presses <kbd>ArrowDown</kbd>, or when on the first element and the user presses <kbd>ArrowUp</kbd>.
-   * @default true
-   */
-  loopFocus?: boolean | undefined;
-  /**
-   * The input value of the combobox. Use when controlled.
-   */
-  inputValue?: React.ComponentProps<'input'>['value'] | undefined;
-  /**
-   * Callback fired when the input value of the combobox changes.
-   */
-  onInputValueChange?: ((value: string, eventDetails: AriaCombobox.ChangeEventDetails) => void) | undefined;
-  /**
-   * The uncontrolled input value when initially rendered.
-   *
-   * To render a controlled input, use the `inputValue` prop instead.
-   */
-  defaultInputValue?: React.ComponentProps<'input'>['defaultValue'] | undefined;
-  /**
-   * A ref to imperative actions.
-   * - `unmount`: When specified, the combobox will not be unmounted when closed.
-   * Instead, the `unmount` function must be called to unmount the combobox manually.
-   * Useful when the combobox's animation is controlled by an external library.
-   */
-  actionsRef?: React.RefObject<AriaCombobox.Actions | null> | undefined;
-  /**
-   * Callback fired when an item is highlighted or unhighlighted.
-   * Receives the highlighted item value (or `undefined` if no item is highlighted) and event details with a `reason` property describing why the highlight changed.
-   * The `reason` can be:
-   * - `'keyboard'`: the highlight changed due to keyboard navigation.
-   * - `'pointer'`: the highlight changed due to pointer hovering.
-   * - `'none'`: the highlight changed programmatically.
-   */
-  onItemHighlighted?: ((itemValue: ItemValue | undefined, eventDetails: AriaCombobox.HighlightEventDetails) => void) | undefined;
-  /**
-   * A ref to the hidden input element.
-   */
-  inputRef?: React.Ref<HTMLInputElement> | undefined;
-  /**
-   * Whether list items are presented in a grid layout.
-   * When enabled, arrow keys navigate across rows and columns inferred from DOM rows.
-   * @default false
-   */
-  grid?: boolean | undefined;
-  /**
-   * The items to be displayed in the list.
-   * Can be either a flat array of items or an array of groups with items.
-   */
-  items?: readonly any[] | readonly Group<any>[] | undefined;
-  /**
-   * Filtered items to display in the list.
-   * When provided, the list will use these items instead of filtering the `items` prop internally.
-   * Use when you want to control filtering logic externally with the `useFilter()` hook.
-   */
-  filteredItems?: readonly any[] | readonly Group<any>[] | undefined;
-  /**
-   * Filter function used to match items vs input query.
-   */
-  filter?: null | ((itemValue: ItemValue, query: string, itemToString?: (itemValue: ItemValue) => string) => boolean) | undefined;
-  /**
-   * When the item values are objects (`<Combobox.Item value={object}>`), this function converts the object value to a string representation for display in the input.
-   * If the shape of the object is `{ value, label }`, the label will be used automatically without needing to specify this prop.
-   */
-  itemToStringLabel?: ((itemValue: ItemValue) => string) | undefined;
-  /**
-   * When the item values are objects (`<Combobox.Item value={object}>`), this function converts the object value to a string representation for form submission.
-   * If the shape of the object is `{ value, label }`, the value will be used automatically without needing to specify this prop.
-   */
-  itemToStringValue?: ((itemValue: ItemValue) => string) | undefined;
-  /**
-   * Custom comparison logic used to determine if a combobox item value matches the current selected value. Useful when item values are objects without matching referentially.
-   * Defaults to `Object.is` comparison.
-   */
-  isItemEqualToValue?: ((itemValue: ItemValue, value: ItemValue) => boolean) | undefined;
-  /**
-   * Whether the items are being externally virtualized.
-   * @default false
-   */
-  virtualized?: boolean | undefined;
-  /**
-   * Whether the list is rendered inline without using the popup.
-   * @default false
-   */
-  inline?: boolean | undefined;
-  /**
-   * Determines if the popup enters a modal state when open.
-   * - `true`: user interaction is limited to the popup: document page scroll is locked and pointer interactions on outside elements are disabled.
-   * - `false`: user interaction with the rest of the document is allowed.
-   * @default false
-   */
-  modal?: boolean | undefined;
-  /**
-   * The maximum number of items to display in the list.
-   * @default -1
-   */
-  limit?: number | undefined;
-  /**
-   * Controls how the component behaves with respect to list filtering and inline autocompletion.
-   * - `list` (default): items are dynamically filtered based on the input value. The input value does not change based on the active item.
-   * - `both`: items are dynamically filtered based on the input value, which will temporarily change based on the active item (inline autocompletion).
-   * - `inline`: items are static (not filtered), and the input value will temporarily change based on the active item (inline autocompletion).
-   * - `none`: items are static (not filtered), and the input value will not change based on the active item.
-   * @default 'list'
-   */
-  autoComplete?: 'list' | 'both' | 'inline' | 'none' | undefined;
-  /**
-   * Provides a hint to the browser for autofill on the hidden input element.
-   * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/autocomplete
-   */
-  formAutoComplete?: string | undefined;
-  /**
-   * The locale to use for string comparison.
-   * Defaults to the user's runtime locale.
-   */
-  locale?: Intl.LocalesArgument | undefined;
-  /**
-   * Whether clicking an item should submit the owning form.
-   * @default false
-   */
-  submitOnItemClick?: boolean | undefined;
-  /**
-   * INTERNAL: When `selectionMode` is `none`, controls whether selecting an item fills the input.
-   */
-  fillInputOnItemPress?: boolean | undefined;
-}
-export interface AriaComboboxState {}
-export type AriaComboboxProps<Value, Mode extends SelectionMode = 'none'> = ComboboxRootProps<Value> & {
-  /**
-   * How the combobox should remember the selected value.
-   * - `single`: Remembers the last selected value.
-   * - `multiple`: Remember all selected values.
-   * - `none`: Do not remember the selected value.
-   * @default 'none'
-   */
-  selectionMode?: Mode | undefined;
-  /**
-   * The selected value of the combobox. Use when controlled.
-   */
-  selectedValue?: ComboboxItemValueType<Value, Mode> | undefined;
-  /**
-   * The uncontrolled selected value of the combobox when it's initially rendered.
-   *
-   * To render a controlled combobox, use the `selectedValue` prop instead.
-   */
-  defaultSelectedValue?: ComboboxItemValueType<Value, Mode> | null | undefined;
-  /**
-   * Callback fired when the selected value of the combobox changes.
-   */
-  onSelectedValueChange?: ((value: ComboboxItemValueType<Value, Mode>, eventDetails: AriaCombobox.ChangeEventDetails) => void) | undefined;
-};
-export declare namespace AriaCombobox {
-  type Props<Value, Mode extends SelectionMode = 'none'> = AriaComboboxProps<Value, Mode>;
-  type State = AriaComboboxState;
-  interface Actions {
-    unmount: () => void;
-  }
-  type HighlightEventReason = 'keyboard' | 'pointer' | 'none';
-  type HighlightEventDetails = BaseUIGenericEventDetails<HighlightEventReason, {
-    index: number;
-  }>;
-  type ChangeEventReason = typeof REASONS.triggerPress | typeof REASONS.outsidePress | typeof REASONS.itemPress | typeof REASONS.closePress | typeof REASONS.escapeKey | typeof REASONS.listNavigation | typeof REASONS.focusOut | typeof REASONS.inputChange | typeof REASONS.inputClear | typeof REASONS.clearPress | typeof REASONS.chipRemovePress | typeof REASONS.none;
-  type ChangeEventDetails = BaseUIChangeEventDetails<ChangeEventReason>;
-}
-export {};