import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
import * as RadixCheckbox from '@radix-ui/react-checkbox';
import { type VariantProps } from 'class-variance-authority';
/** Agent-readiness curated handle for Checkbox. */
export interface CheckboxHandle {
    getChecked: () => boolean | 'indeterminate';
    setChecked: (checked: boolean | 'indeterminate') => void;
    toggle: () => void;
}
declare const checkboxVariants: (props?: ({
    size?: "sm" | "md" | "lg" | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
type RadixRootProps = ComponentPropsWithoutRef<typeof RadixCheckbox.Root>;
export interface CheckboxProps extends Omit<RadixRootProps, 'checked' | 'onCheckedChange' | 'children'>, VariantProps<typeof checkboxVariants> {
    /**
     * Visible label rendered next to the box. Accepts a string or any React
     * node — useful for consent labels that embed a privacy / T&C link.
     */
    label: ReactNode;
    checked?: boolean | 'indeterminate';
    onCheckedChange?: (checked: boolean | 'indeterminate') => void;
    size?: 'sm' | 'md' | 'lg';
    disabledReason?: string;
    value?: string;
}
export declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLButtonElement>>;
export {};
//# sourceMappingURL=checkbox.d.ts.map