/** Where the listbox should put the active option when a key opens it. */
export type SelectOpenIntent = 'selected' | 'first' | 'last';
/** Ten is the normative page jump for a listbox — a headless package has no rendered row height to divide by. */
export declare const SELECT_PAGE_SIZE = 10;
/** What a keydown on a closed trigger asks for. Every action but `'ignore'` wants `preventDefault()`. */
export type SelectClosedAction = 
/** Open the listbox with the active option placed as `intent` says. */
{
    kind: 'open';
    intent: SelectOpenIntent;
}
/** A letter arrived on a multiple-select: open the listbox and search there, since a closed multi-select has no single "current" option to walk from. */
 | {
    kind: 'open-for-typeahead';
}
/** A letter arrived on a single-select: match it against the options and select the hit without opening, as a native `<select>` does. */
 | {
    kind: 'typeahead';
}
/** Not a key this trigger claims. */
 | {
    kind: 'ignore';
};
/** What a keydown on an open listbox asks for; `index` is already clamped into range. */
export type SelectOpenAction = 
/** Move the active option to `index`. */
{
    kind: 'activate';
    index: number;
}
/** Select the active option, and close unless `closeOnSelect` is off. */
 | {
    kind: 'commit';
}
/** Alt+ArrowUp: select the active option and close, the keyboard equivalent of clicking it. */
 | {
    kind: 'commit-and-close';
}
/** Tab: add the active option to the selection without ever removing it, then close and let the browser's own Tab run. */
 | {
    kind: 'commit-on-exit';
}
/** A letter arrived: run the typeahead and activate its hit. */
 | {
    kind: 'typeahead';
}
/** Alt+ArrowDown, the open key: claimed so it cannot move focus, but nothing else happens. */
 | {
    kind: 'claim';
}
/** Not a key the listbox claims. */
 | {
    kind: 'ignore';
};
/** A keydown, reduced to what the decision needs. */
export interface SelectKeyEvent {
    key: string;
    altKey: boolean;
    ctrlKey: boolean;
    metaKey: boolean;
}
/** Whether the adapter should call `preventDefault()` for this action; Tab is the exception, because focus is not trapped and the browser's own Tab has to carry focus onward. */
export declare function selectKeyPrevented(action: SelectClosedAction | SelectOpenAction): boolean;
/**
 * The action for a keydown on a closed trigger.
 *
 * @param event the keydown
 * @param multiple whether the Select holds more than one value
 * @returns what the adapter should do; see {@link SelectClosedAction}
 */
export declare function selectClosedAction(event: SelectKeyEvent, multiple: boolean): SelectClosedAction;
/**
 * The action for a keydown while the listbox is open, over virtual focus: DOM focus stays on the trigger, so these move the active option, not the focused element.
 *
 * @param event the keydown
 * @param currentIndex the active option's index, or `-1` when none is active
 * @param optionCount how many options the listbox renders
 * @returns what the adapter should do; see {@link SelectOpenAction}
 */
export declare function selectOpenAction(event: SelectKeyEvent, currentIndex: number, optionCount: number): SelectOpenAction;