import type * as React from 'react';
import type { FormValidityHandle } from '../utils/formControl.cjs';
import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
/** A checkbox's tri-state value: checked, unchecked, or indeterminate (partially checked). */
export type CheckedState = boolean | 'indeterminate';
/**
 * The `Checkbox` root `<button>` plus its constraint-validation methods, assigned onto the same node so existing `HTMLButtonElement` ref usage keeps working.
 */
export type CheckboxHandle = HTMLButtonElement & FormValidityHandle;
/** @internal Shared state distributed from {@link Checkbox} to its {@link CheckboxIndicator} via context. */
export interface CheckboxContextValue {
    checked: CheckedState;
    disabled: boolean;
}
/** Props for the {@link Checkbox} root. */
export interface CheckboxProps extends Omit<PrimitivePropsWithRef<'button'>, 'defaultChecked'> {
    /**
     * Checked state, for controlled usage. Pair with `onCheckedChange`.
     * @default undefined — uncontrolled, tracks its own checked state internally.
     */
    checked?: CheckedState | undefined;
    /**
     * Initial checked state, for uncontrolled usage.
     * @default false
     */
    defaultChecked?: CheckedState | undefined;
    /**
     * Fires with the new checked state whenever it changes, controlled or not.
     * @default undefined — no-op if omitted.
     */
    onCheckedChange?: ((checked: CheckedState) => void) | undefined;
    /**
     * Marks the underlying hidden input as required for native form validation.
     * @default false
     */
    required?: boolean | undefined;
    /**
     * Name for native form participation via a hidden input.
     * @default undefined — no hidden input rendered.
     */
    name?: string | undefined;
    /**
     * Value submitted with the hidden input when checked.
     * @default 'on'
     */
    value?: string | undefined;
    /**
     * Id of the `<form>` that owns this checkbox when it renders outside it, forwarded to the hidden input's `form` attribute.
     * @default undefined — the checkbox belongs to its nearest ancestor `<form>`, if any.
     */
    form?: string | undefined;
    /**
     * Freezes the checked state without freezing the control: keeps focus and `aria-readonly`/`data-readonly`, and ignores click and Space.
     * @default false
     */
    readOnly?: boolean | undefined;
    /**
     * Marks the checkbox as invalid, exposed as `aria-invalid`/`data-invalid`.
     * @default false
     */
    invalid?: boolean | undefined;
    /**
     * Disables the checkbox and excludes it from the tab order.
     * @default false
     */
    disabled?: boolean | undefined;
    /**
     * Renders a derived `CheckboxIndicator` holding this content in place of the default check glyph, ignored when `children` is given.
     * @default undefined — the default check/dash glyph.
     */
    indicator?: React.ReactNode | undefined;
    /**
     * Size rung the skin scales the box by, mirrored to `data-size` on the root.
     * @default undefined — the skin's own default size.
     */
    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
}
/** Props for the {@link CheckboxIndicator}, the visual mark shown when checked or indeterminate. */
export interface CheckboxIndicatorProps extends PrimitivePropsWithRef<'span'> {
    /**
     * Keep mounted regardless of state (for exit animations).
     * @default false
     */
    forceMount?: boolean | undefined;
}