openmonetis/hooks/use-form-state.ts

import { useCallback, useState } from "react";

/**
 * Hook for managing form state with type-safe field updates
 *
 * @param initialValues - Initial form values
 * @returns Object with formState, updateField, resetForm, setFormState
 *
 * @example
 * ```tsx
 * const { formState, updateField, resetForm } = useFormState({
 *   name: '',
 *   email: ''
 * });
 *
 * updateField('name', 'John');
 * ```
 */
export function useFormState<T extends Record<string, any>>(initialValues: T) {
	const [formState, setFormState] = useState<T>(initialValues);

	/**
	 * Updates a single field in the form state
	 */
	const updateField = useCallback(
		<K extends keyof T>(field: K, value: T[K]) => {
			setFormState((prev) => ({ ...prev, [field]: value }));
		},
		[],
	);

	/**
	 * Resets form to initial values
	 */
	const resetForm = useCallback(() => {
		setFormState(initialValues);
	}, [initialValues]);

	/**
	 * Updates multiple fields at once
	 */
	const updateFields = useCallback((updates: Partial<T>) => {
		setFormState((prev) => ({ ...prev, ...updates }));
	}, []);

	return {
		formState,
		updateField,
		updateFields,
		resetForm,
		setFormState,
	};
}