import { JSX } from '@emotion/react/jsx-runtime';
import { FieldsetHTMLAttributes } from 'react';
import { Props } from '../@types/Props.js';
import { ThemeRadioGroup } from './theme.js';

type Orientation = 'vertical' | 'horizontal';
interface RadioGroupProps extends FieldsetHTMLAttributes<HTMLFieldSetElement>, Props {
    id?: string;
    /**
     * Appears as a legend at the top of the radio group
     */
    label?: string;
    /**
     * Visually hides the label
     */
    hideLabel?: boolean;
    /**
     * Additional text or component that appears below the label
     */
    supporting?: string | JSX.Element;
    /**
     * The direction in which radio buttons are stacked
     */
    orientation?: Orientation;
    /**
     * If passed, error styling should applies to this radio group. The string appears as an inline error message.
     */
    error?: string;
    /**
     * Partial or complete theme to override the component's colour palette.
     * The sanctioned colours have been set out by the design system team.
     * The colours which can be changed are:
     *
     *  `textLabel`<br>
     *  `textOptional`<br>
     *  `textSupporting`<br>
     *  `textError`<br>
     *  `textSuccess`<br>
     *  `borderHover`<br>
     *  `borderError`<br>
     */
    theme?: Partial<ThemeRadioGroup>;
}
/**
 * [Storybook](https://guardian.github.io/storybooks/?path=/story/source_react-components-radiogroup--default-default-theme) •
 * [Design System](https://theguardian.design/2a1e5182b/p/2891dd-radio-button/b/46940d) •
 * [GitHub](https://github.com/guardian/csnx/tree/main/libs/@guardian/source/src/react-components/radio/RadioGroup.tsx) •
 * [NPM](https://www.npmjs.com/package/@guardian/source)
 *
 * Radio buttons allow users to make a single selection from a set of options.
 *
 * The following themes are supported: `default`, `brand`
 */
declare const RadioGroup: ({ id, name, label, hideLabel, supporting, orientation, error, cssOverrides, children, theme, ...props }: RadioGroupProps) => JSX.Element;

export { RadioGroup };
export type { RadioGroupProps };