/**
 * Radio Atom Component
 *
 * A radio button component with label support and accessibility.
 */
import React from "react";
import type { EventKey } from "@almadar/core";
export interface RadioProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
    /** Radio options (string array or SelectOption array) */
    options?: string[];
    /** Current selected value */
    value?: string;
    /** Declarative event name for trait dispatch */
    action?: EventKey;
    /**
     * Label text displayed next to the radio button
     */
    label?: string;
    /**
     * Helper text displayed below the radio button
     */
    helperText?: string;
    /**
     * Error message displayed below the radio button
     */
    error?: string;
    /**
     * Size of the radio button
     * @default 'md'
     */
    size?: "sm" | "md" | "lg";
}
export declare const Radio: React.ForwardRefExoticComponent<RadioProps & React.RefAttributes<HTMLInputElement>>;
