import { ForwardedRef, RefObject } from 'react'; /** * Imperative handle exposed by group fields (`RadioGroup`, `CheckboxGroup`, `Selector`, `ButtonGroup`) whose * focusable control is not a single element the group can point a DOM ref at. * * `focus()` moves focus to the group's first tabbable option at call time, which is what form libraries * such as react-hook-form need (`field.ref` → `ref.focus()` on validation error). */ export type FocusHandle = { focus: () => void; }; export type UseFocusManagerRefOptions = { /** * Restricts which descendants of the wrapper may receive focus, e.g. only ``s when the wrapper also * contains other controls (such as a "show more" button). */ accept?: (node: Element) => boolean; }; /** * Bridges a forwarded {@link FocusHandle} ref to a wrapper element. Returns the ref to attach to the * wrapper; `focus()` on the forwarded handle focuses the first tabbable descendant via react-aria's * focus manager. Resolution happens when `focus()` is called, so options that render, enable or * disable after mount are handled, and roving-tabindex groups (radios) focus their tab stop * (the selected option) rather than the first option. When no option is tabbable (e.g. a radio * group whose `value` matches no radio, such as `''`), the first focusable option is used instead. */ export declare function useFocusManagerRef(forwardedRef: ForwardedRef, { accept }?: UseFocusManagerRefOptions): RefObject; /** `accept` predicate for groups whose options are `` elements. */ export declare const acceptInputs: (node: Element) => boolean;