import type * as React from 'react';
import type { RadioGroupChangeReason } from '../radio-group/types.js';
import type { PrimitivePropsWithRef } from '../utils/primitive.js';
/** @internal Shared state distributed from {@link RadioCard} to its parts via context. */
export interface RadioCardContextValue {
    value: string;
    checked: boolean;
    disabled: boolean;
    /** Roving tabindex: only the checked card — or the first enabled one when nothing is checked — is a tab stop. */
    tabStop: boolean;
    /** Whether the group has settled which card holds the tab stop, resolved after initial render for server-rendered unselected groups. */
    tabStopResolved: boolean;
    required: boolean;
    /** The group's `readOnly`: the card keeps its tab stop and refuses the selection. */
    readOnly: boolean;
    name: string | undefined;
    /** The group's `form` id, forwarded to this card's hidden radio input. */
    form: string | undefined;
    labelId: string;
    descriptionId: string;
    /** Whether a `RadioCardLabel` is mounted, so the control only points `aria-labelledby` at an id that exists. */
    hasLabel: boolean;
    /** Whether a `RadioCardDescription` is mounted, so the control only points `aria-describedby` at an id that exists. */
    hasDescription: boolean;
    setHasLabel: (present: boolean) => void;
    setHasDescription: (present: boolean) => void;
    onSelect: (reason: RadioGroupChangeReason) => void;
}
/** Props for the {@link RadioCardRoot}, the `<label>` whose whole surface is the hit target. */
export interface RadioCardRootProps extends PrimitivePropsWithRef<'label'> {
    /** Unique identifier compared against the enclosing `RadioGroup`'s selected `value`. */
    value: string;
    /**
     * Disables this card only; the enclosing `RadioGroup`'s own `disabled` still wins when set.
     * @default false
     */
    disabled?: boolean | undefined;
    /**
     * Size rung the skin scales the card by, mirrored to `data-size`.
     * @default undefined — the skin's own default size.
     */
    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
}
/** Props for the {@link RadioCard} recipe, rendering a label with optional title and description wired to its value. */
export interface RadioCardProps extends Omit<RadioCardRootProps, 'asChild'> {
    /**
     * The card's title line, rendered into a derived `RadioCardLabel` and ignored when `children` is given.
     * @default undefined — no label is rendered, and the control falls back to the card's whole text content.
     */
    label?: React.ReactNode | undefined;
    /**
     * Supporting copy under the title, rendered into a derived `RadioCardDescription` and ignored when `children` is given.
     * @default undefined — no description is rendered.
     */
    description?: React.ReactNode | undefined;
}
/** Props for the {@link RadioCardControl}, the real (visually hidden, still focusable) radio input. */
export interface RadioCardControlProps extends Omit<PrimitivePropsWithRef<'input'>, 'checked' | 'defaultChecked' | 'type' | 'value'> {
}
/** Props for the {@link RadioCardIndicator}, the decorative dot or ring drawn on the card. */
export interface RadioCardIndicatorProps extends PrimitivePropsWithRef<'span'> {
}
/** Props for the {@link RadioCardLabel}, the card's title line. */
export interface RadioCardLabelProps extends PrimitivePropsWithRef<'span'> {
}
/** Props for the {@link RadioCardDescription}, the supporting copy under the title. */
export interface RadioCardDescriptionProps extends PrimitivePropsWithRef<'span'> {
}