import { LitElement } from 'lit';
import { LabelPosition } from '../../../shared/form-control-utils';
import { ValidationMessages } from '../../../shared/face-mixin';

export interface ToggleChangeEventDetail {
    checked: boolean;
    name: string;
    value: string;
}
export type ToggleChangeEvent = CustomEvent<ToggleChangeEventDetail>;
export interface ToggleProps {
    label?: string;
    labelPosition?: LabelPosition;
    labelHidden?: boolean;
    noLabel?: boolean;
    checked?: boolean;
    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
    variant?: 'default' | 'success' | 'warning' | 'danger' | 'monochrome';
    disabled?: boolean;
    readonly?: boolean;
    required?: boolean;
    invalid?: boolean;
    errorMessage?: string;
    helpText?: string;
    name?: string;
    value?: string;
    validationMessages?: ValidationMessages;
    onClick?: (event: MouseEvent) => void;
    onToggleChange?: (event: ToggleChangeEvent) => void;
}
declare const AgToggle_base: (new (...args: any[]) => import('../../../shared/face-mixin').FaceMixinInterface) & typeof LitElement;
/**
 * AgToggle - Accessible binary toggle/switch component
 *
 * A semantic button element implementing the WAI-ARIA Switch pattern
 * for binary on/off state controls with comprehensive accessibility support.
 *
 * Features:
 * - WAI-ARIA Switch pattern compliance with role="switch"
 * - Semantic <button> element foundation
 * - Required accessible name via aria-label or aria-labelledby
 * - Keyboard navigation (Space/Enter activation)
 * - Minimalist styling via design tokens
 * - Size variants with consistent proportions
 * - Form integration support
 */
export declare class AgToggle extends AgToggle_base implements ToggleProps {
    static styles: import('lit').CSSResult[];
    private _toggleId;
    private _labelId;
    private _helperId;
    private _errorId;
    /**
     * Label text for the toggle
     */
    label: string;
    /**
     * Position of the label relative to the toggle
     */
    labelPosition: LabelPosition;
    /**
     * Visually hide the label (still accessible to screen readers)
     */
    labelHidden: boolean;
    /**
     * Remove label completely
     */
    noLabel: boolean;
    /**
     * Current checked state of the toggle
     */
    checked: boolean;
    /**
     * Toggle size variant
     */
    size: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
    /**
     * Visual variant
     */
    variant: 'default' | 'success' | 'warning' | 'danger' | 'monochrome';
    /**
     * Disabled state
     */
    disabled: boolean;
    /**
     * Read-only state - visually interactive but doesn't change
     */
    readonly: boolean;
    /**
     * Required field indicator
     */
    required: boolean;
    /**
     * Invalid state for validation feedback
     */
    invalid: boolean;
    /**
     * Error message text displayed when invalid
     */
    errorMessage: string;
    /**
     * Helper text displayed below toggle
     */
    helpText: string;
    /**
     * Form integration - value submitted when checked (defaults to 'on' like native checkbox)
     */
    value: string;
    /**
     * Click event callback
     */
    onClick?: (event: MouseEvent) => void;
    /**
     * Consumer-supplied validation messages (overrides built-in English fallbacks)
     */
    validationMessages: ValidationMessages | undefined;
    /**
     * Toggle change event callback
     */
    onToggleChange?: (event: ToggleChangeEvent) => void;
    constructor();
    /**
     * FACE lifecycle: called when the parent form is reset.
     * Restores checked to false and clears form value and validity.
     */
    formResetCallback(): void;
    /**
     * FACE lifecycle: called on session restore or browser autofill.
     * Restores checked state from the previously saved form value.
     * A non-null state means the toggle was on; null means it was off.
     */
    formStateRestoreCallback(state: File | string | FormData | null, _mode: 'restore' | 'autocomplete'): void;
    /**
     * Sync validity state to ElementInternals.
     * Toggle has no inner <input> to delegate to, so required validation
     * is implemented directly: unchecked + required = valueMissing.
     */
    private _syncValidity;
    /**
     * Sync CustomStateSet states so :state() pseudo-classes work from external CSS.
     *
     * Must be called AFTER _syncValidity() so that :state(invalid) reads the
     * freshly-updated _internals.validity.valid value.
     *
     * Exposed states:
     *  :state(checked)  — toggle is on
     *  :state(disabled) — toggle is disabled
     *  :state(readonly) — toggle is read-only
     *  :state(required) — toggle is required
     *  :state(invalid)  — FACE constraint validation is failing
     */
    private _syncStates;
    updated(changedProperties: Map<string, unknown>): void;
    protected firstUpdated(): void;
    private renderLabel;
    private _handleClick;
    private _handleKeydown;
    private _performToggle;
    render(): import('lit').TemplateResult<1>;
}
export {};
//# sourceMappingURL=_Toggle.d.ts.map