import { Ref } from 'vue';
import { FieldRules } from './useFormValidation';
export type { FieldRules, ValidationRule } from './useFormValidation';
/**
 * Field validation rules configuration.
 */
export interface FieldState {
    value: unknown;
    error: string | null;
    touched: boolean;
    dirty: boolean;
}
/**
 * Form state and methods.
 */
export interface UseFormReturn<T extends Record<string, unknown>> {
    data: T;
    errors: Record<string, string | null>;
    touched: Record<string, boolean>;
    dirty: Record<string, boolean>;
    isValid: Ref<boolean>;
    isDirty: Ref<boolean>;
    isSubmitting: Ref<boolean>;
    setFieldValue: <K extends keyof T>(field: K, value: T[K]) => void;
    setFieldError: (field: string, error: string | null) => void;
    setFieldTouched: (field: string, touched?: boolean) => void;
    validateField: (field: string) => boolean;
    validate: () => boolean;
    reset: (values?: Partial<T>) => void;
    /** Replace the full form state and treat the provided values as the new clean baseline. */
    replaceState: (values: T) => void;
    handleSubmit: (onSubmit: (data: T) => Promise<void> | void) => (e?: Event) => Promise<void>;
    getFieldProps: <K extends keyof T>(field: K) => {
        modelValue: T[K];
        'onUpdate:modelValue': (value: T[K]) => void;
        onBlur: () => void;
        error: string | null;
    };
}
/**
 * Form state management composable with validation.
 *
 * @param initialValues - Initial form values
 * @param rules - Validation rules for each field
 *
 * @example
 * ```typescript
 * const { data, errors, isValid, handleSubmit, getFieldProps } = useForm(
 *   { email: '', password: '' },
 *   {
 *     email: { required: true, email: true },
 *     password: { required: true, minLength: 8 },
 *   }
 * )
 *
 * // In template
 * <BaseInput v-bind="getFieldProps('email')" label="Email" />
 * <BaseInput v-bind="getFieldProps('password')" type="password" label="Password" />
 * <BaseButton @click="handleSubmit(onSubmit)" :disabled="!isValid">Submit</BaseButton>
 * ```
 */
/** Reactive form state with field-level validation, dirty tracking, and submit handling. */
export declare function useForm<T extends Record<string, unknown>>(initialValues: T, rules?: Partial<Record<keyof T, FieldRules>>): UseFormReturn<T>;