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,
  };
}