import { type Readable, type Signal } from '@vielzeug/ripple';
import { type ControlValidationMode, type FieldHandle } from './field-base';
export type CheckableChangePayload = {
    checked: boolean;
    originalEvent?: Event;
    value: string;
};
export type CheckableOptions = {
    checked: Readable<boolean | undefined>;
    clearIndeterminateFirst?: boolean;
    disabled?: Readable<boolean | undefined>;
    error?: Readable<string | undefined>;
    group?: {
        toggle: (value: string, originalEvent?: Event) => void;
    };
    helper?: Readable<string | undefined>;
    indeterminate?: Readable<boolean | undefined>;
    onToggle?: (payload: CheckableChangePayload) => void;
    prefix?: string;
    /** Marks an unchecked control invalid — feeds `validity`/`validationMessage` (see below). */
    required?: Readable<boolean | undefined>;
    /** Message for the unchecked+required case. Defaults to `'This field is required.'`. */
    requiredMessage?: Readable<string | undefined>;
    /** `AbortSignal` from the component lifecycle. All reactive subscriptions are torn down on abort. */
    signal: AbortSignal;
    validateOn?: Readable<ControlValidationMode>;
    value: Readable<string | undefined>;
};
export type CheckableHandle = FieldHandle & {
    /** The form submission value: null when unchecked/indeterminate, the value string when checked. */
    checkableFormValue: Readable<string | null>;
    checked: Signal<boolean>;
    handleClick: (event: MouseEvent) => boolean;
    handleKeydown: (event: KeyboardEvent) => boolean;
    indeterminate: Signal<boolean>;
    /**
     * Restores `checked`/`indeterminate` to their native "default" value. See `DirtyTracker`
     * for the two-state rationale. Wire into `useField({ onReset: checkable.reset })`.
     */
    reset: () => void;
    toggle: (event: Event) => void;
    /** Reactive validation message paired with `validity`. Empty string when valid. */
    validationMessage: Readable<string>;
    /**
     * Reactive `ValidityStateFlags` — `{ valueMissing: true }` while `required` and unchecked
     * (indeterminate counts as unchecked), `null` (valid) otherwise. Pass straight to
     * `useField({ validity: checkable.validity })`.
     */
    validity: Readable<ValidityStateFlags | null>;
};
export declare const createCheckable: (options: CheckableOptions) => CheckableHandle;
//# sourceMappingURL=checkable.d.ts.map