import React, { type JSX } from "react";
import "./Checkbox.scss";
export interface CheckboxProps {
    /**
     * ID used for semantic targeting, as can be used in attributes like `<label htmlFor="some-id">`.
     */
    id?: string;
    /**
     * The visible text labeling the checkbox element.
     */
    text?: string;
    /**
     * Helper text that adds some more information on what the option means, or inform
     * the user about the consequences of the checkbox.
     *
     * Only works if the `renderLabel` prop isn't set.
     */
    explanation?: string;
    /**
     * @deprecated - this works exclusively as a checkbox now, if you want a different component,
     * use the `Switch` component.
     *
     * Shows a different checkbox variant. `type="switch"` shows a switch-like component
     * without a visual label.
     */
    type?: "regular" | "switch";
    /**
     * Set the value.
     * Same as `checked` on `<input type="checkbox" />`.
     */
    isChecked?: boolean;
    /**
     * Value for when it is not clear if the state of this checkbox
     * is "checked" or not (for hierarchical checkboxes).
     */
    isIndeterminate?: boolean;
    /**
     * Disallow the user to change the checkbox value.
     * Same as `disabled` on `<input type="checkbox" />`.
     */
    isDisabled?: boolean;
    /**
     * The name that the value of the checkbox will be associated with.
     * Same as `name` on `<input type="checkbox" />`.
     */
    name?: string;
    /**
     * This can be used to retrieve the value it is referring to through onChange.
     */
    value?: string;
    onChange?: (event: React.ChangeEvent<HTMLInputElement>) => void;
    onClick?: (event: React.MouseEvent<HTMLInputElement, MouseEvent>) => void;
    className?: string;
    classNameCheckboxLabel?: string;
    /**
     * Visually show that the currently selected value has an issue the user needs to attend to.
     */
    error?: boolean;
    innerRef?: React.Ref<HTMLInputElement>;
    /**
     * Renders a completely custom label. Can change its contents or
     * appearance based on the props of the checkbox item.
     *
     * Overrides the `text` prop.
     */
    renderLabel?: (props: CheckboxProps) => JSX.Element | null;
}
/**
 * @deprecated - use `LabeledCheckbox` components in a `LabeledCheckboxGroup` instead.
 *
 * E.g. with React Hook Form:
 *
 * @example
 * ```tsx
 * <LabeledCheckboxGroup>
 *   <LabeledCheckbox {...register("orderedMeals")} label="Anchovies pasta" value="anchovies-pasta" />
 *   <LabeledCheckbox {...register("orderedMeals")} label="Banana dessert" value="banana-dessert" />
 * </LabeledCheckboxGroup>
 * ```
 */
export declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;