import type { ControlSize } from "@charcuterie/tokens";
import type { ReactNode } from "react";
import type { ListboxItem } from "../Listbox/Listbox.tsx";
export type ComboboxOptionProps = {
    /** The stable DOM id `aria-activedescendant` points at. */
    id: string;
    isActive: boolean;
    isSelected: boolean;
    /** Already stepped down for a short window by `usePanelItemSize`. */
    itemSize: ControlSize;
    item: ListboxItem;
    onSelect: (value: string) => void;
    /**
     * `aria-posinset`/`aria-setsize`, required when the list is
     * virtualized: most of it is not in the DOM, so a screen reader
     * would otherwise announce "2 of 12" for a 4,000-item list.
     */
    posInSet?: number;
    setSize?: number;
};
/**
 * `role="option"` with **`tabIndex={-1}`**, and both halves matter.
 * The APG combobox keeps focus in the text input and tracks the
 * active option with `aria-activedescendant`, so no option is ever a
 * tab stop — `tabIndex={-1}` is that. It is a `<button>` (which
 * ARIA-in-HTML allows `role="option"` on, and `Listbox` uses too)
 * rather than a `<div>`, so `onClick` carries its own keyboard route
 * and the package keeps its no-Biome-suppression record.
 *
 * The one caveat is not to run `expectAgentDrivable` on an individual
 * option: its roving-tabindex rule would (correctly) reject a native
 * control with `tabIndex={-1}`, and a combobox legitimately has zero
 * tab stops in its popup. Tests query the options with `getByRole`.
 *
 * "Active" is a visual state only — the option the arrow keys have
 * moved to, highlighted because nothing here holds real focus.
 */
export declare const ComboboxOption: ({ id, isActive, isSelected, item, itemSize, onSelect, posInSet, setSize, }: ComboboxOptionProps) => ReactNode;
//# sourceMappingURL=ComboboxOption.d.ts.map