/**
 * 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.
 */
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;
    indeterminate: boolean;
    value: string;
    name: string;
    disabled: boolean;
    required: boolean;
    size: Size;
    flavor: Flavor;
    form: HTMLFormElement | null;
}
/**
 * Ty Checkbox Component
 */
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;
        };
        indeterminate: {
            type: "boolean";
            visual: 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: Size;
            validate: (v: any) => boolean;
            coerce: (v: any) => any;
        };
        flavor: {
            type: "string";
            visual: boolean;
            default: string;
        };
    };
    private _customFlavorSheet;
    private _listenersSetup;
    private _clickHandler;
    private _keydownHandler;
    private _focusHandler;
    private _blurHandler;
    constructor();
    /** TyComponent already handled pre-connection property capture. */
    protected onConnect(): void;
    /** Custom (non-built-in) flavors — see utils/flavor-sheet.ts. */
    private _syncCustomFlavor;
    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;
    private buildClassList;
    private handleCheckboxClick;
    private handleCheckboxKeydown;
    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;
    /** required + unchecked => valueMissing; otherwise valid. */
    private updateValidity;
    get checked(): boolean;
    set checked(value: boolean);
    get indeterminate(): boolean;
    set indeterminate(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 {};