/**
 * Bridge between reactive {@link Form} / {@link FormField} objects and the DOM.
 *
 * Provides `bindField()` to two-way-bind a single field to an input element,
 * and `bindForm()` to wire an entire `<form>` element to a {@link Form}.
 *
 * @module bquery/forms
 */
import type { BindFieldOptions, BindFormOptions, Form, FormField } from './types';
/**
 * Two-way bind a reactive {@link FormField} to a DOM input element.
 *
 * Supports `<input>` (text, number, checkbox, radio, file, date), `<textarea>`,
 * `<select>` (including `multiple`), `[contenteditable]` elements, and custom
 * Web Components that expose a `.value` property (e.g. `<bq-input>`).
 *
 * Returns a cleanup function that detaches the listeners and the reactive
 * effect that mirrors the field's value into the element.
 *
 * @param field - Reactive field
 * @param element - Target DOM element
 * @param options - Optional binding overrides
 * @returns A cleanup function
 */
export declare const bindField: <T>(field: FormField<T>, element: Element, options?: BindFieldOptions) => (() => void);
/**
 * Wire a {@link Form} to a `<form>` (or any container) element.
 *
 * The binding:
 * - Auto-discovers `[name]` inputs inside the container and calls
 *   {@link bindField} for each matching form field.
 * - Hooks the container's `submit` event to call `form.handleSubmit()`
 *   (preventing the default browser submit).
 * - Mirrors per-field error messages into `[data-bq-error-for="<name>"]`
 *   elements when present, or a custom `errorSlot` lookup function.
 *
 * Returns a cleanup function that detaches every listener and reactive effect.
 *
 * @example
 * ```html
 * <form id="register">
 *   <input name="email" type="email" />
 *   <span data-bq-error-for="email"></span>
 *   <button type="submit">Save</button>
 * </form>
 * ```
 * ```ts
 * const cleanup = bindForm(form, document.getElementById('register')!);
 * ```
 */
export declare const bindForm: <T extends Record<string, unknown>>(form: Form<T>, formElement: HTMLElement, options?: BindFormOptions) => (() => void);
//# sourceMappingURL=bind.d.ts.map