import { ComponentPropsWithoutRef, ReactElement } from 'react';
import { LayoutUtilProps, FieldLabelProps } from '../../types';
/**
 * Props for the CheckboxGroup component
 * @extends ComponentPropsWithoutRef<"fieldset">
 * @extends LayoutUtilProps
 * @extends Omit<FieldLabelProps, "labelProps">
 */
export type CheckboxGroupProps = ComponentPropsWithoutRef<"fieldset"> & LayoutUtilProps & Omit<FieldLabelProps, "labelProps"> & {
    /**
     * required flag for label
     * @accessibility This does not enforce error when nothing is selected.
     * @default false
     */
    required?: boolean;
    /**
     * legend for the fieldset
     */
    legend: string | ReactElement;
};
/**
 * CheckboxGroup component for grouping related checkboxes together.
 *
 * Features:
 * - Groups multiple checkboxes with a common legend
 * - Supports required field indication
 * - Optional helper text and descriptions
 * - Full accessibility support with fieldset/legend
 * - Focus management for keyboard navigation
 * - Layout utility props for positioning and spacing
 * - Flexible layout direction (row/column)
 * - Screen reader support with hidden labels
 *
 * @example
 * <CheckboxGroup legend="Select your interests" required>
 *   <Checkbox label="Technology" />
 *   <Checkbox label="Sports" />
 *   <Checkbox label="Music" />
 * </CheckboxGroup>
 */
export declare const CheckboxGroup: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref"> & LayoutUtilProps & Omit<FieldLabelProps, "labelProps"> & {
    /**
     * required flag for label
     * @accessibility This does not enforce error when nothing is selected.
     * @default false
     */
    required?: boolean;
    /**
     * legend for the fieldset
     */
    legend: string | ReactElement;
} & import('react').RefAttributes<HTMLFieldSetElement>>;