/**
 * TyCheckbox Web Component
 *
 * "Just the box" primitive — renders only the checkbox visual + state.
 * Label, required asterisk, and error display are the consumer's
 * responsibility — wrap in a `<label>` for click delegation.
 *
 * - Boolean checked state, form-associated
 * - Keyboard accessibility (Space/Enter)
 * - Sizes (xs, sm, md, lg, xl) and semantic flavors
 *
 * @example
 * <label>
 *   <ty-checkbox name="terms" required></ty-checkbox>
 *   I agree to the <a href="/terms">terms</a>
 * </label>
 */
import type { Flavor, Size } from "../types/common.js";
import { TyComponent } from "../base/ty-component.js";
import type { PropertyChange } from "../utils/property-manager.js";
/**
 * Component internal state (for typing TyComponent)
 */
interface CheckboxState {
    checked: boolean;
    listenersSetup: boolean;
}
/**
 * TyCheckbox Element Interface
 */
export interface TyCheckboxElement extends HTMLElement {
    checked: boolean;
    value: string;
    name: string;
    disabled: boolean;
    required: boolean;
    size: Size;
    flavor: Flavor;
    form: HTMLFormElement | null;
}
/**
 * Ty Checkbox Component
 *
 * @example
 * ```html
 * <!-- Basic checkbox -->
 * <ty-checkbox>Subscribe to newsletter</ty-checkbox>
 *
 * <!-- Pre-checked with custom value -->
 * <ty-checkbox
 *   checked
 *   value="accepted"
 *   required>
 *   Accept terms
 * </ty-checkbox>
 *
 * <!-- With error state -->
 * <ty-checkbox
 *   required
 *   error="You must agree to continue"
 *   flavor="danger">
 *   Agree to terms
 * </ty-checkbox>
 *
 * <!-- Different sizes -->
 * <ty-checkbox size="sm">Small</ty-checkbox>
 * <ty-checkbox size="lg">Large</ty-checkbox>
 *
 * <!-- Semantic flavors -->
 * <ty-checkbox flavor="primary" checked>Primary</ty-checkbox>
 * <ty-checkbox flavor="success" checked>Success</ty-checkbox>
 *
 * <!-- Rich content (with icon) -->
 * <ty-checkbox checked>
 *   <ty-icon name="star"></ty-icon>
 *   Premium feature
 * </ty-checkbox>
 * ```
 */
export declare class TyCheckbox extends TyComponent<CheckboxState> implements TyCheckboxElement {
    static formAssociated: boolean;
    protected static properties: {
        checked: {
            type: "boolean";
            visual: boolean;
            formValue: boolean;
            emitChange: boolean;
            default: boolean;
        };
        value: {
            type: "string";
            default: string;
        };
        name: {
            type: "string";
            default: string;
        };
        disabled: {
            type: "boolean";
            visual: boolean;
            default: boolean;
        };
        required: {
            type: "boolean";
            visual: boolean;
            default: boolean;
        };
        size: {
            type: "string";
            visual: boolean;
            default: string;
            validate: (v: any) => boolean;
            coerce: (v: any) => any;
        };
        flavor: {
            type: "string";
            visual: boolean;
            default: string;
            validate: (v: any) => boolean;
            coerce: (v: any) => any;
        };
    };
    private _listenersSetup;
    private _clickHandler;
    private _keydownHandler;
    private _focusHandler;
    private _blurHandler;
    constructor();
    /**
     * Called when component connects to DOM
     * TyComponent already handled pre-connection property capture
     */
    protected onConnect(): void;
    /**
     * Called when component disconnects from DOM
     */
    protected onDisconnect(): void;
    /**
     * Handle property changes - called BEFORE render
     */
    protected onPropertiesChanged(_changes: PropertyChange[]): void;
    /**
     * Override form value to return value when checked, null when unchecked
     */
    protected getFormValue(): FormDataEntryValue | null;
    /**
     * Build CSS class list for checkbox container
     */
    private buildClassList;
    /**
     * Handle checkbox click event - standards compliant approach
     */
    private handleCheckboxClick;
    /**
     * Handle checkbox keyboard events - space/enter to toggle
     */
    private handleCheckboxKeydown;
    /**
     * Remove event listeners for cleanup
     */
    private removeEventListeners;
    /**
     * Setup event listeners for checkbox functionality
     * IMPORTANT: Only called ONCE, not on every render
     */
    private setupEventListeners;
    /**
     * Render the checkbox — just the box visual.
     * Label, required asterisk, and error UI are the consumer's responsibility.
     */
    protected render(): void;
    get checked(): boolean;
    set checked(value: boolean);
    get value(): string;
    set value(val: string);
    get name(): string;
    set name(val: string);
    get disabled(): boolean;
    set disabled(value: boolean);
    get required(): boolean;
    set required(value: boolean);
    get size(): Size;
    set size(value: Size);
    get flavor(): Flavor;
    set flavor(value: Flavor);
    get form(): HTMLFormElement | null;
}
export {};
//# sourceMappingURL=checkbox.d.ts.map