import "./index.css";
import React, { InputHTMLAttributes } from "react";
export type ToggleSwitchSize = "md" | "sm";
interface ToggleSwitchBaseProps {
    "aria-invalid"?: never;
    "aria-label"?: never;
    "aria-required"?: never;
    /** Optional description text that appears below the toggle switch label. */
    description?: string;
    required?: never;
    /** The size of the toggle switch. */
    size?: ToggleSwitchSize;
}
interface ToggleSwitchWithVisibleLabel extends ToggleSwitchBaseProps {
    "aria-labelledby"?: never;
    /** When true, hides the visible label and sets it as aria-label on the input instead. */
    hideLabel?: false;
    /**
     * The label content for the toggle switch. Required unless
     * `aria-labelledby` is provided to reference an external label. When
     * using non-string content (e.g. JSX), it must not contain
     * interactive elements. This includes native HTML elements such as
     * `<a>` and `<button>`, as well as Tapestry or Tapestry-React
     * interactive components.
     */
    label: React.ReactNode;
}
interface ToggleSwitchWithHiddenLabel extends ToggleSwitchBaseProps {
    "aria-labelledby"?: never;
    /** When true, hides the visible label and sets it as aria-label on the input instead. */
    hideLabel: true;
    /** Label text for the toggle switch, used as an accessible `aria-label`. */
    label: string;
}
interface ToggleSwitchWithAriaLabelledBy extends ToggleSwitchBaseProps {
    "aria-labelledby": string;
    hideLabel?: never;
    /** Not available when `aria-labelledby` is provided. */
    label?: never;
}
export type ToggleSwitchProps = ToggleSwitchWithVisibleLabel | ToggleSwitchWithHiddenLabel | ToggleSwitchWithAriaLabelledBy;
export type ToggleSwitchElementProps = Omit<InputHTMLAttributes<HTMLInputElement>, keyof ToggleSwitchProps | "type" | "required" | "aria-required"> & ToggleSwitchProps;
/**
 * A toggle switch component that renders as a checkbox input styled as a switch.
 *
 * **Required:** You must provide either:
 * - `label` - Label content for the switch (must be a string when `hideLabel` is true)
 * - `aria-labelledby` - ID of an external element that provides the label
 *
 * When using non-string content for `label` (e.g. JSX), it must not contain
 * interactive elements. This includes native HTML elements such as `<a>` and
 * `<button>`, as well as Tapestry or Tapestry-React interactive components.
 */
export declare const ToggleSwitch: React.ForwardRefExoticComponent<ToggleSwitchElementProps & React.RefAttributes<HTMLInputElement>>;
export {};
//# sourceMappingURL=ToggleSwitch.d.ts.map