import { Radio as RadioPrimitive } from '@base-ui/react/radio';
import { RadioGroup as RadioGroupPrimitive } from '@base-ui/react/radio-group';
import * as React from 'react';
export type RadioState = 'error';
export type RadioGroupOrientation = 'horizontal' | 'vertical';
export interface RadioOption<TValue extends string | number = string> {
    value: TValue;
    label: React.ReactNode;
    /** Help text below this option's label. */
    description?: React.ReactNode;
    disabled?: boolean;
}
declare const radioStyles: (props?: ({
    state?: "error" | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
export interface RadioProps extends Omit<React.ComponentPropsWithRef<typeof RadioPrimitive.Root>, 'render'> {
    state?: RadioState;
}
/**
 * A single radio button. Must be inside a {@link RadioGroup}, which owns the
 * value and the arrow-key navigation.
 *
 * Renders a native `<button>` for the same reason {@link Checkbox} does: real
 * `:disabled` and working `<label htmlFor>` activation.
 */
export declare const Radio: React.ForwardRefExoticComponent<Omit<RadioProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
export interface RadioGroupProps extends Omit<React.ComponentPropsWithRef<typeof RadioGroupPrimitive>, 'render' | 'orientation'> {
    /**
     * Layout direction.
     * @default 'vertical'
     */
    orientation?: RadioGroupOrientation;
}
/**
 * Groups {@link Radio} items, owning the selected value and roving-focus keyboard
 * navigation.
 *
 * Needs an accessible name — `aria-label` or `aria-labelledby` — or the group
 * announces as an unnamed radiogroup.
 *
 * @example
 * <RadioGroup aria-label="Plan" defaultValue="basic">
 *   <Radio value="basic" aria-label="Basic" />
 *   <Radio value="pro" aria-label="Pro" />
 * </RadioGroup>
 */
export declare const RadioGroup: React.ForwardRefExoticComponent<Omit<RadioGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
export interface RadioGroupFieldProps<TValue extends string | number = string> extends Omit<RadioGroupProps, 'value' | 'defaultValue' | 'onValueChange'> {
    value?: TValue;
    defaultValue?: TValue;
    onValueChange?: (value: TValue) => void;
    /** Options rendered as labeled rows. */
    options: RadioOption<TValue>[];
    /** Visual state, applied to every option. */
    state?: RadioState;
    /** Accessible name for the group. Required unless `aria-labelledby` is given. */
    'aria-label'?: string;
}
/**
 * A {@link RadioGroup} with its options laid out as labeled rows.
 *
 * Labels and descriptions render through {@link Label} and {@link HelpText}, so
 * they cannot drift from a standalone field.
 *
 * Values keep their type: Base UI works in strings internally, and a caller
 * passing numbers gets numbers back rather than every consumer writing the same
 * `Number()` coercion.
 *
 * @example
 * <RadioGroupField
 *   aria-label="Plan"
 *   options={[{ value: 'basic', label: 'Basic' }, { value: 'pro', label: 'Pro', description: 'With support' }]}
 * />
 */
export declare function RadioGroupField<TValue extends string | number = string>({ options, value, defaultValue, onValueChange, state, orientation, ...rest }: RadioGroupFieldProps<TValue>): React.ReactElement;
export { radioStyles };
/**
 * shadcn's name for {@link Radio}.
 *
 * shadcn calls the control inside a group `RadioGroupItem`; Base UI and Strix call it `Radio`. The
 * same component under both names, so a pasted `RadioGroup`/`RadioGroupItem` composition works.
 */
export declare const RadioGroupItem: React.ForwardRefExoticComponent<Omit<RadioProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
//# sourceMappingURL=radio.d.ts.map