/**
 * Standalone reactive field composable.
 *
 * @module bquery/forms
 */
import type { MaybeSignal } from '../reactive/index';
import type { UseFormFieldOptions, UseFormFieldReturn } from './types';
/**
 * Creates a standalone reactive form field with optional automatic validation.
 *
 * This helper is useful when you want field-level state without creating a full form,
 * or when you want to bind an existing signal to the forms validation model.
 *
 * @template T - The type of the field value
 * @param initialValue - Plain initial value, an existing writable signal to reuse, or a
 * computed / readonly reactive source to snapshot
 * @param options - Validation mode, validators, debounce, and initial error configuration
 * @returns A reactive field handle with validation helpers
 *
 * @example
 * ```ts
 * import { useFormField, required } from '@bquery/bquery/forms';
 *
 * const email = useFormField('', {
 *   validators: [required()],
 *   validateOn: 'blur',
 * });
 *
 * email.value.value = 'ada@example.com';
 * email.touch();
 * ```
 */
export declare const useFormField: <T>(initialValue: MaybeSignal<T>, options?: UseFormFieldOptions<T>) => UseFormFieldReturn<T>;
//# sourceMappingURL=use-field.d.ts.map