/**
 * Combobox - a text input that filters a dropdown `listbox` as you type, then
 * commits a selection. The look is ours (theme tokens); the mechanics (query,
 * filtering, `aria-activedescendant` keyboard nav, open/dismiss, portalling)
 * come from the active adapter's `combobox` slot - the zero-dependency
 * {@link builtinCombobox} by default, swappable to cmdk / Base UI / etc. via
 * `UIAdapterProvider`.
 *
 * @example
 * ```tsx
 * import { Combobox, ComboboxInput, ComboboxContent, ComboboxItem } from "veryfront/ui";
 *
 * <Combobox onValueChange={setFramework}>
 *   <ComboboxInput placeholder="Search framework…" />
 *   <ComboboxContent>
 *     <ComboboxItem value="next">Next.js</ComboboxItem>
 *     <ComboboxItem value="remix">Remix</ComboboxItem>
 *     <ComboboxItem value="astro">Astro</ComboboxItem>
 *   </ComboboxContent>
 * </Combobox>;
 * ```
 *
 * @module react/components/ui/combobox
 */
import * as React from "react";
/** Props accepted by `<Combobox>` (the root; owns query/open/value state). */
export interface ComboboxProps {
    /** `ComboboxInput` + `ComboboxContent` parts to compose. */
    children: React.ReactNode;
    /** Controlled selected value (pair with `onValueChange`). */
    value?: string;
    /** Initial selected value when uncontrolled. */
    defaultValue?: string;
    /** Fires with the newly-selected value. */
    onValueChange?: (value: string) => void;
    /** Controlled open state of the listbox (pair with `onOpenChange`). */
    open?: boolean;
    /** Initial open state when uncontrolled. */
    defaultOpen?: boolean;
    /** Fires when the listbox opens or closes. */
    onOpenChange?: (open: boolean) => void;
    /** Initial input text. */
    defaultInputValue?: string;
}
/** Combobox root - renders no node of its own (state + context only). */
export declare function Combobox(props: ComboboxProps): React.ReactElement;
/** Props accepted by `<ComboboxInput>`. */
export interface ComboboxInputProps extends React.InputHTMLAttributes<HTMLInputElement> {
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLInputElement>;
}
/** The `role="combobox"` text input that drives filtering. */
export declare function ComboboxInput({ className, ...props }: ComboboxInputProps): React.ReactElement;
/** Props accepted by `<ComboboxContent>`. */
export interface ComboboxContentProps extends React.HTMLAttributes<HTMLDivElement> {
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLDivElement>;
}
/** The floating `role="listbox"` surface, shown while filtering. */
export declare function ComboboxContent({ className, children, ...props }: ComboboxContentProps): React.ReactElement | null;
/** Props accepted by `<ComboboxItem>`. */
export interface ComboboxItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect"> {
    /** The value this option commits when chosen. */
    value: string;
    /** Text used for filtering and the input after selection. Defaults to plain child text, then value. */
    textValue?: string;
    /** Disable selection and dim the option. */
    disabled?: boolean;
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLDivElement>;
}
/** A selectable, filterable option. Hides itself when it doesn't match the query. */
export declare function ComboboxItem({ value, textValue, disabled, className, children, onClick, ref, ...props }: ComboboxItemProps): React.ReactElement | null;
//# sourceMappingURL=combobox.d.ts.map