import { NativeSignal } from "native-signal/weak";
export interface BindOptions {
    /**
     * Which DOM event to listen to.
     * Defaults to "input" for text-like elements, "change" for select/checkbox/radio.
     * Override explicitly if needed.
     */
    event?: "input" | "change";
    /**
     * Value coercion to apply when reading from the DOM element.
     * Defaults are inferred from element type:
     *   checkbox        → boolean
     *   number / range  → number
     *   select[multiple]→ string[]
     *   everything else → string
     */
    coerce?: "string" | "number" | "boolean" | "array";
}
type BindableElement = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
/**
 * Bind a form element to a NativeSignal bidirectionally.
 *
 * - DOM → Signal: listens for the appropriate event and updates the signal.
 * - Signal → DOM: subscribes to the signal and updates the element value.
 *
 * @returns An unsubscribe function to unbind signal and element.
 */
export declare function bind<T>(el: BindableElement, signal: NativeSignal<T>, opts?: BindOptions): () => void;
/**
 * Create a bound input element in one call.
 *
 * @example
 * const [input, cleanup] = boundInput("text", mySignal, { placeholder: "Search…" });
 * root.appendChild(input);
 */
export declare function boundInput<T>(type: HTMLInputElement["type"], signal: NativeSignal<T>, attrs?: Record<string, string>, opts?: BindOptions): [HTMLInputElement, () => void];
/**
 * Create a bound <select> element.
 *
 * @example
 * const [sel, cleanup] = boundSelect(
 *   [{ value: "eq", label: "=" }, { value: "ne", label: "≠" }],
 *   operatorSignal,
 * );
 */
export declare function boundSelect<T extends string>(options: {
    value: T;
    label: string;
}[], signal: NativeSignal<T>, attrs?: Record<string, string>): [HTMLSelectElement, () => void];
/**
 * Create a bound <textarea>.
 */
export declare function boundTextarea(signal: NativeSignal<string>, attrs?: Record<string, string>): [HTMLTextAreaElement, () => void];
export {};
//# sourceMappingURL=bind.d.ts.map