import React from 'react';
export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'> {
    /**
     * Checkbox content (for composable API)
     */
    children?: React.ReactNode;
    /**
     * Indeterminate state (shows minus icon instead of check)
     * @default false
     */
    indeterminate?: boolean;
    /**
     * Checkbox size
     * @default 'md'
     */
    size?: 'sm' | 'md';
}
/**
 * Checkbox Component
 *
 * A versatile checkbox component with label, validation states, and helper text.
 * Uses composable API with CheckboxInput, CheckboxLabel, CheckboxHelper, and CheckboxError sub-components.
 *
 * @public
 *
 * @example
 * ```tsx
 * // Composable API (recommended)
 * <Checkbox size="md">
 *   <CheckboxInput checked={isChecked} onChange={handleChange} indeterminate={isIndeterminate} />
 *   <CheckboxLabel>Accept terms and conditions</CheckboxLabel>
 *   <CheckboxHelper>You can change this later</CheckboxHelper>
 * </Checkbox>
 *
 * ```
 *
 * @remarks
 * - Composable API provides maximum flexibility and control
 * - All sub-components (CheckboxInput, CheckboxLabel, CheckboxHelper, etc.) support `asChild`
 * - Supports checked, unchecked, and indeterminate states
 * - Automatically generates accessible IDs for labels and descriptions
 * - Accessible: includes ARIA attributes and keyboard navigation
 */
export declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
//# sourceMappingURL=Checkbox.d.ts.map