import type * as React from 'react';
import type { FormValidityHandle } from '../utils/formControl.js';
import type { PrimitivePropsWithRef } from '../utils/primitive.js';
/** Root `<label>` plus FormValidityHandle methods, assigned additively. */
export type CheckboxCardHandle = HTMLLabelElement & FormValidityHandle;
/** @internal Shared state distributed from {@link CheckboxCard} to its parts via context. */
export interface CheckboxCardContextValue {
    checked: boolean;
    disabled: boolean;
    readOnly: boolean;
    required: boolean;
    invalid: boolean;
    name: string | undefined;
    value: string;
    form: string | undefined;
    labelId: string;
    descriptionId: string;
    /** Whether a `CheckboxCardLabel` is mounted, so the control only points `aria-labelledby` at an id that exists. */
    hasLabel: boolean;
    /** Whether a `CheckboxCardDescription` is mounted, so the control only points `aria-describedby` at an id that exists. */
    hasDescription: boolean;
    setHasLabel: (present: boolean) => void;
    setHasDescription: (present: boolean) => void;
    onCheckedChange: (checked: boolean) => void;
}
/** Props for the {@link CheckboxCardRoot}, the `<label>` whose whole surface is the hit target. */
export interface CheckboxCardRootProps extends Omit<PrimitivePropsWithRef<'label'>, 'defaultChecked'> {
    /**
     * Checked state, for controlled usage, paired with `onCheckedChange`.
     * @default undefined — uncontrolled, tracks its own checked state internally.
     */
    checked?: boolean | undefined;
    /**
     * Initial checked state, for uncontrolled usage, seeding the first render.
     * @default false — the card starts unselected.
     */
    defaultChecked?: boolean | undefined;
    /**
     * Fires with the new checked state whenever it changes, controlled or not.
     * @default undefined — no-op if omitted.
     */
    onCheckedChange?: ((checked: boolean) => void) | undefined;
    /**
     * Name on native checkbox input for form submission; input always exists,
     * making the card clickable.
     * @default undefined — the control is unnamed and contributes nothing to form data.
     */
    name?: string | undefined;
    /**
     * Value submitted with the control when checked.
     * @default 'on' — the same default the HTML checkbox itself uses.
     */
    value?: string | undefined;
    /**
     * Marks the control required for native form validation; an unchecked card blocks submission with `valueMissing`.
     * @default false
     */
    required?: boolean | undefined;
    /**
     * Form ID for this card when rendered outside it; forwarded to input's
     * `form` attribute since root doesn't submit.
     * @default undefined — the card belongs to its nearest ancestor `<form>`, if any.
     */
    form?: string | undefined;
    /**
     * Disables the control, removes it from tab order, and emits `data-disabled`.
     * @default false
     */
    disabled?: boolean | undefined;
    /**
     * Freeze selection: control keeps tab stop, gains `aria-readonly`,
     * submits name/value; clicking and Space do nothing.
     * @default false
     */
    readOnly?: boolean | undefined;
    /**
     * Marks the card invalid, exposed as `aria-invalid` on the control and `data-invalid` on the root.
     * @default false
     */
    invalid?: boolean | undefined;
    /**
     * Size rung the skin scales the card by, mirrored to `data-size`.
     * @default undefined — the skin's own default size.
     */
    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
}
/** Derived checkbox-card props; no `asChild`, since the recipe renders sibling parts. */
export interface CheckboxCardProps extends Omit<CheckboxCardRootProps, 'asChild'> {
    /**
     * Card title line, rendered into the derived label; ignored when `children` is given.
     * @default undefined — no label is rendered, and the control falls back to the card's whole text content.
     */
    label?: React.ReactNode | undefined;
    /**
     * Supporting copy under the title, rendered into the derived description; ignored when `children` is given.
     * @default undefined — no description is rendered.
     */
    description?: React.ReactNode | undefined;
}
/** Props for the {@link CheckboxCardControl}, the real (visually hidden, still focusable) checkbox input. */
export interface CheckboxCardControlProps extends Omit<PrimitivePropsWithRef<'input'>, 'checked' | 'defaultChecked' | 'type' | 'value'> {
}
/** Props for the {@link CheckboxCardIndicator}, the decorative check mark or box drawn on the card. */
export interface CheckboxCardIndicatorProps extends PrimitivePropsWithRef<'span'> {
}
/** Props for the {@link CheckboxCardLabel}, the card's title line. */
export interface CheckboxCardLabelProps extends PrimitivePropsWithRef<'span'> {
}
/** Props for the {@link CheckboxCardDescription}, the supporting copy under the title. */
export interface CheckboxCardDescriptionProps extends PrimitivePropsWithRef<'span'> {
}