Function useForm

packages/core/src/forms/useForm.ts:34–258

(
  ctx: WidgetContext<State>,
  options: UseFormOptions<T>,
)

 * Form management hook for Rezi widgets.
 */
export function useForm<T extends Record<string, unknown>, State = void>(
  ctx: WidgetContext<State>,
  options: UseFormOptions<T>,
): UseFormReturn<T> {
  const [state, setState] = ctx.useState<FormState<T>>(() => createInitialState(options));
  const stateRef = ctx.useRef(state);
  stateRef.current = state;

  const initialValuesRef = ctx.useRef<T>(cloneInitialValues(options.initialValues));

  const asyncValidatorRef = ctx.useRef<
    ReturnType<typeof createDebouncedAsyncValidator<T>> | undefined
  >(undefined);

  const pendingAsyncValuesRef = ctx.useRef<T | null>(null);
  const submittingRef = ctx.useRef(false);
  const submitAttemptRef = ctx.useRef(0);
  const validateRef = ctx.useRef(options.validate);
  validateRef.current = options.validate;
  const nonTextBindingWarningsRef = ctx.useRef<Set<string>>(new Set());

  const fieldArrayKeysRef = ctx.useRef<Partial<Record<keyof T, string[]>>>({});
  const fieldArrayKeyCounterRef = ctx.useRef<number>(0);

  const updateFormState = (
    nextState: FormState<T> | ((prev: FormState<T>) => FormState<T>),
  ): void => {
    setState((prev) => {
      const resolved =
        typeof nextState === "function"
          ? (nextState as (prev: FormState<T>) => FormState<T>)(prev)
          : nextState;
      stateRef.current = resolved;
      return resolved;
    });
  };

  const wizardSteps = options.wizard?.steps ?? [];
  const stepCount = wizardSteps.length;
  const hasWizard = stepCount > 0;
  const currentStep = hasWizard ? clampStepIndex(state.currentStep, stepCount) : 0;
  const isFirstStep = !hasWizard || currentStep === 0;
  const isLastStep = !hasWizard || currentStep === stepCount - 1;

  const {
    isFieldDisabledInternal,
    isFieldReadOnlyInternal,
    isFieldEditableInternal,
    filterDisabledValidationErrors,
    runSyncValidationFiltered,
    runAsyncValidationFiltered,
    warnUnsupportedTextBinding,
    canBindFieldAsText,
  } = createFormStateAccessors({
    stateRef,
    initialValuesRef,
    validateRef,
    validateAsync: options.validateAsync,