import type { FormValidityHandle } from '../utils/formControl.js';
import type { PrimitivePropsWithRef } from '../utils/primitive.js';
/** What `Switch`'s forwarded ref is: the root `<button>` with constraint-validation methods assigned onto it, typed via `React.useRef<SwitchHandle>(null)`. */
export type SwitchHandle = HTMLButtonElement & FormValidityHandle;
/** @internal Shared state distributed from {@link Switch} to its {@link SwitchThumb} via context. */
export interface SwitchContextValue {
    checked: boolean;
    disabled: boolean;
}
/** Props for the {@link Switch} root. */
export interface SwitchProps extends Omit<PrimitivePropsWithRef<'button'>, 'defaultChecked'> {
    /**
     * Checked state, for controlled usage; pair with `onCheckedChange`.
     * @default undefined
     */
    checked?: boolean | undefined;
    /**
     * Initial checked state, for uncontrolled usage.
     * @default false
     */
    defaultChecked?: boolean | undefined;
    /**
     * Fires with the new checked state whenever it changes, controlled or not.
     * @default undefined
     */
    onCheckedChange?: ((checked: boolean) => void) | undefined;
    /**
     * Marks the underlying hidden input as required for native form validation.
     * @default false
     */
    required?: boolean | undefined;
    /**
     * Name/value for native form participation via a hidden input.
     * @default undefined
     */
    name?: string | undefined;
    /**
     * Value submitted with the hidden input when checked.
     * @default 'on'
     */
    value?: string | undefined;
    /**
     * Displays a state the user may not change, keeping the tab stop and focus ring while adding `aria-readonly`/`data-readonly` and refusing the flip; still submits its value.
     * @default false
     */
    readOnly?: boolean | undefined;
    /**
     * Marks the switch as invalid, exposed as `aria-invalid`/`data-invalid`; presentational only — use `setCustomValidity()` on the ref to block submission.
     * @default false
     */
    invalid?: boolean | undefined;
    /**
     * Disables the switch and excludes it from the tab order.
     * @default false
     */
    disabled?: boolean | undefined;
    /**
     * The `id` of the `<form>` this switch submits with when it is not a DOM descendant of it, mirrored onto the hidden input.
     * @default undefined — the nearest ancestor `<form>`, as for a native input.
     */
    form?: string | undefined;
    /**
     * Visible caption rendered into a derived `SwitchLabel`, the accessible name for `role="switch"`; ignored when `children` is given.
     * @default undefined — no label rendered.
     */
    label?: string | undefined;
    /**
     * Which side of the derived `SwitchThumb` the derived `SwitchLabel` sits on, meaningful only with `label`; ignored when `children` is given.
     * @default 'end'
     */
    labelPosition?: 'start' | 'end' | undefined;
    /**
     * Size rung the skin scales the track by, mirrored to `data-size` on the root.
     * @default undefined — the skin's own default size.
     */
    size?: 'sm' | 'lg' | (string & {}) | undefined;
}
/** Props for the {@link SwitchThumb}, the sliding handle inside a {@link Switch}. */
export interface SwitchThumbProps extends PrimitivePropsWithRef<'span'> {
}
/** Props for the {@link SwitchLabel}, the switch's visible text. */
export interface SwitchLabelProps extends PrimitivePropsWithRef<'span'> {
}