import * as React from 'react';
import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
/**
 * Accessible boolean or multi-select checkbox built on Radix UI.
 *
 * @description
 * Used to capture multiple-choice selections or a single boolean toggle
 * (e.g., "Accept terms and conditions").
 * Supports the standard size scale (`sm`, `md`, `lg`) for consistent form alignment.
 *
 * @ai-rules
 * 1. NEVER use a native `<input type="checkbox">`.
 * 2. Always pair with a real `<label>` using matching `id` and `htmlFor` props.
 * 3. Inside React Hook Form schemas, wrap in `<FormControl>` within a `<FormField>`.
 * 4. Use the `size` prop to match surrounding form element sizing.
 */
declare const Checkbox: React.ForwardRefExoticComponent<Omit<CheckboxPrimitive.CheckboxProps & React.RefAttributes<HTMLButtonElement>, "ref"> & {
    /**
     * Size variant — matches the form component sizing scale.
     * - `sm`: 14px square
     * - `md`: 16px square — **default**
     * - `lg`: 20px square
     */
    size?: "sm" | "md" | "lg";
} & React.RefAttributes<HTMLButtonElement>>;
export { Checkbox };