import { Checkbox as CheckboxPrimitive } from '@base-ui/react/checkbox';
import * as React from 'react';
export type CheckboxState = 'error';
declare const checkboxStyles: (props?: ({
    state?: "error" | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
export interface CheckboxProps extends Omit<React.ComponentPropsWithRef<typeof CheckboxPrimitive.Root>, 'render'> {
    /** Visual state. `error` paints the border in the error color. */
    state?: CheckboxState;
    /** Override the checked glyph. */
    checkIcon?: React.ReactNode;
    /** Override the indeterminate glyph. */
    indeterminateIcon?: React.ReactNode;
}
/**
 * A single checkbox, without a label.
 *
 * Use this when composing your own layout; use {@link CheckboxField} for the
 * common checkbox-plus-label-plus-help-text row.
 *
 * Renders a native `<button>` rather than Base UI's default `<span role="checkbox">`.
 * That is what makes `:disabled` real and lets a `<label htmlFor>` activate the
 * control, both of which `Label isSelector`'s `peer-*` styling depends on.
 *
 * @example <Checkbox aria-label="Agree to terms" />
 * @example <Checkbox indeterminate aria-label="Select all" />
 */
export declare const Checkbox: React.ForwardRefExoticComponent<Omit<CheckboxProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
export interface CheckboxFieldProps extends CheckboxProps {
    /** Label rendered beside the checkbox. */
    label: React.ReactNode;
    /** Help text below the row. Announced as an alert in the error state. */
    helperText?: React.ReactNode;
    /** Applied to the outermost element. */
    containerClassName?: string;
}
/**
 * A checkbox with its label and optional help text, wired together.
 *
 * The label and help text render through {@link Label} and {@link HelpText}
 * rather than repeating their type and color classes, so this row cannot drift
 * from a standalone field.
 *
 * @example <CheckboxField label="Agree to terms" helperText="Required to continue" state="error" />
 */
export declare const CheckboxField: React.ForwardRefExoticComponent<Omit<CheckboxFieldProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
export { checkboxStyles };
//# sourceMappingURL=checkbox.d.ts.map