@paragrav/rhf-utils 0.0.45 → 0.0.50

package/dist/esm/errors/useFormErrorsToConsole.mjs

@@ -1,21 +1,25 @@
 import a from "react";
-import { useFormContext as c, useFormState as l } from "react-hook-form";
-import E from "../isEmptyObject.mjs";
+import { useFormContext as l, useFormState as E } from "react-hook-form";
+import c from "../isEmptyObject.mjs";
 import d from "./outputErrors.mjs";
-const v = (e, m, r) => {
-  const { getValues: f } = c(), { errors: u } = l();
+const h = (e, f, r) => {
+  const { getValues: m } = l(), { errors: u } = E();
   a.useEffect(() => {
-    if (!(r != null && r.disabled) && !E(m) && (d(e, { values: f(), errors: u }, r), console[r != null && r.isError ? "error" : "debug"](e, {
-      form: {
-        values: f(),
-        // form values
-        errors: u
-      },
-      other: r == null ? void 0 : r.data
-    }), r != null && r.isError))
+    if (!(r != null && r.disabled) && !c(f) && (d(e, { values: m(), errors: u }, r), console[r != null && r.isError ? "error" : "debug"](
+      "useFormErrorsToConsole",
+      e,
+      {
+        form: {
+          values: m(),
+          // form values
+          errors: u
+        },
+        other: r == null ? void 0 : r.data
+      }
+    ), r != null && r.isError))
       throw new Error(e);
   }, [u]);
 };
 export {
-  v as default
+  h as default
 };

package/dist/esm/exports.mjs

@@ -0,0 +1,76 @@
+import { default as e } from "./devtool/LazyDevTool.mjs";
+import { default as s } from "./errors/context/index.mjs";
+import { default as u } from "./errors/context/provider.mjs";
+import { default as f } from "./errors/message/FormErrorMessage.mjs";
+import { default as d } from "./errors/message/FormErrorMessageByPath.mjs";
+import { default as x } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
+import { default as i } from "./errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute.mjs";
+import { default as E } from "./errors/orphan/useFormHasOrphanAndNoFieldErrors.mjs";
+import { default as b } from "./errors/orphan/useOrphanFormErrorsMemo.mjs";
+import { default as c } from "./errors/orphan/useOrphanFormErrorsToConsole.mjs";
+import { default as P } from "./errors/root/useRootFormFieldErrorsMemo.mjs";
+import { default as v } from "./errors/useFormErrorConsoleDebug.mjs";
+import { default as G } from "./errors/useFormErrorsEffect.mjs";
+import { default as g } from "./errors/useFormErrorsIfAny.mjs";
+import { default as I } from "./errors/useFormErrorsMemo.mjs";
+import { default as B } from "./errors/useFormRequestSubmit.mjs";
+import { default as T } from "./form/Form.mjs";
+import { default as N } from "./form/FormWithProviders.mjs";
+import { default as U } from "./form/useForm.mjs";
+import { default as q } from "./form/useFormWithProviders.mjs";
+import { default as L } from "./form/context/FormProvider.mjs";
+import { default as w } from "./form/context/utils/FormUtilsContextProvider.mjs";
+import { default as K } from "./form/context/utils/useFormUtilsContext.mjs";
+import { default as V } from "./form/context/group/FormGroupContextProvider.mjs";
+import { default as Y } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
+import { default as _ } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
+import { default as rr } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
+import { default as er } from "./form/context/group/useFormGroupIsChildBusy.mjs";
+import { default as sr } from "./form/context/group/useFormGroupIsParentBusy.mjs";
+import { default as ur } from "./form/context/group/useFormGroupParentTracker.mjs";
+import { default as fr } from "./form/utils/getSubmitterButtonData.mjs";
+import { FormSubmitError as dr } from "./submit/error/FormSubmitError.mjs";
+import { default as xr } from "./submit/useFormOnSubmitSuccessful.mjs";
+import { default as ir } from "./submit/useFormOnSubmitSuccessfulAndReset.mjs";
+import { default as Er } from "./submit/useResetFormOnSubmitError.mjs";
+import { default as br } from "./submit/useResetFormOnSubmitSuccessful.mjs";
+import { default as cr } from "./submit/useSubmitFormOnChange.mjs";
+export {
+  T as Form,
+  f as FormErrorMessage,
+  d as FormErrorMessageByPath,
+  u as FormErrorsFlatContextProvider,
+  V as FormGroupContextProvider,
+  x as FormNonFieldErrorMarker,
+  i as FormNonFieldErrorMarkerHtmlAttribute,
+  L as FormProvider,
+  dr as FormSubmitError,
+  w as FormUtilsContextProvider,
+  N as FormWithProviders,
+  e as LazyDevTool,
+  fr as getSubmitterButtonData,
+  U as useForm,
+  v as useFormErrorConsoleDebug,
+  G as useFormErrorsEffect,
+  s as useFormErrorsFlatContext,
+  g as useFormErrorsIfAny,
+  I as useFormErrorsMemo,
+  Y as useFormGroupChildIsMountedTracker,
+  _ as useFormGroupChildIsSubmittingTracker,
+  rr as useFormGroupIsAnyBusy,
+  er as useFormGroupIsChildBusy,
+  sr as useFormGroupIsParentBusy,
+  ur as useFormGroupParentTracker,
+  E as useFormHasOrphanAndNoFieldErrors,
+  xr as useFormOnSubmitSuccessful,
+  ir as useFormOnSubmitSuccessfulAndReset,
+  B as useFormRequestSubmit,
+  K as useFormUtilsContext,
+  q as useFormWithProviders,
+  b as useOrphanFormErrorsMemo,
+  c as useOrphanFormErrorsToConsole,
+  br as useResetFormAfterSubmitSuccessful,
+  Er as useResetFormOnSubmitError,
+  P as useRootFormFieldErrorsMemo,
+  cr as useSubmitFormOnChange
+};

package/dist/esm/form/Form.mjs

@@ -1,82 +1,71 @@
-import { jsxs as v, jsx as d } from "react/jsx-runtime";
+import { jsxs as O, jsx as t } from "react/jsx-runtime";
 import "react";
-import { useFormContext as T } from "react-hook-form";
-import w from "../devtool/LazyDevTool.mjs";
-import { useFormErrorsFlatContextMaybe as C } from "../errors/context/index.mjs";
-import P from "../errors/root/FormRootErrors.mjs";
-import V from "../utils/useImperativeForwardedRef.mjs";
-import b from "./FormBase.mjs";
-import { FormError as p } from "./FormError.mjs";
-function A({
-  isDev: s,
-  formId: F,
-  formRef: i,
+import { useFormContext as v } from "react-hook-form";
+import T from "../devtool/LazyDevTool.mjs";
+import V from "../errors/root/FormRootErrorsFromContext.mjs";
+import j from "../submit/error/handleFormSubmitError.mjs";
+import w from "../submit/useResetFormOnSubmitError.mjs";
+import E from "../submit/useSubmitFormOnChange.mjs";
+import P from "../utils/useImperativeForwardedRef.mjs";
+import S from "./FormBase.mjs";
+function H({
+  isDev: u,
+  formId: h,
+  formRef: F,
+  Fields: f,
   //
-  onSubmit: a,
-  onSubmitError: m,
-  onSubmitInvalid: h,
+  onSubmit: d,
+  onSubmitError: l,
+  onSubmitInvalid: x,
   //
   options: r,
   //
-  children: y,
-  ...u
+  children: g,
+  ...R
 }) {
-  var l;
-  const e = T(), x = V(i), f = (l = C()) == null ? void 0 : l.roots, E = (t) => (r != null && r.stopSubmitPropagation && t.stopPropagation(), e.handleSubmit(
-    R,
-    // `as` required due to conditional generic
-    h
-  )(t)), R = async (t, c) => {
+  const m = v(), c = P(F);
+  E(c, !(r != null && r.submitOnChange)), w(!(r != null && r.resetValuesOnSubmitError));
+  const b = async (e) => {
+    r != null && r.stopSubmitPropagation && e.stopPropagation();
     try {
-      await (a == null ? void 0 : a(
-        t,
-        e,
-        c
-      ));
-    } catch (o) {
-      if (r != null && r.disableEmptyRootError || e.setError("root", {}), o instanceof p) {
-        Object.entries(o.errors).forEach(([g, j]) => {
-          e.setError(g, {
-            type: "FormError",
-            message: j
-          });
-        });
-        return;
-      }
-      m == null || m(
-        o,
-        t,
-        e,
-        c
-      );
+      await m.handleSubmit(y, x)(e);
+    } catch (a) {
+      C(a, e);
     }
+  }, y = (e, a) => d == null ? void 0 : d(
+    e,
+    m,
+    a
+  ), C = (e, a) => {
+    j(e, m), l == null || l(e, m, a);
   };
-  return /* @__PURE__ */ v(
-    b,
+  return /* @__PURE__ */ O(
+    S,
     {
-      id: F,
-      onSubmit: E,
+      id: h,
+      onSubmit: b,
       noValidate: !0,
-      ...u,
-      ref: x,
       style: {
         position: "relative"
       },
+      ...R,
+      ref: c,
       children: [
-        (r == null ? void 0 : r.devTool) !== "disabled" && /* @__PURE__ */ d(
-          w,
+        (r == null ? void 0 : r.devTool) !== "disabled" && /* @__PURE__ */ t(
+          T,
           {
-            isDev: s,
+            isDev: u,
             placement: "top-right",
             ...r == null ? void 0 : r.devTool
           }
         ),
-        y,
-        f && /* @__PURE__ */ d(P, { errors: f })
+        f && /* @__PURE__ */ t(f, { ctx: m }),
+        g,
+        !(r != null && r.hideRootErrors) && /* @__PURE__ */ t(V, {})
       ]
     }
   );
 }
 export {
-  A as default
+  H as default
 };

package/dist/esm/form/FormWithProviders.mjs

@@ -0,0 +1,10 @@
+import { jsx as o } from "react/jsx-runtime";
+import i from "../errors/context/provider.mjs";
+import m from "./useFormWithProviders.mjs";
+function s({ children: e, ...t }) {
+  const r = m(t);
+  return /* @__PURE__ */ o(r.Provider, { children: /* @__PURE__ */ o(i, { formRef: r.ref, children: /* @__PURE__ */ o(r.Form, { children: e }) }) });
+}
+export {
+  s as default
+};

package/dist/esm/form/context/group/useFormGroupChildIsMountedTracker.mjs

@@ -6,7 +6,9 @@ const c = () => {
     const e = (t) => {
       r(s, t);
     };
-    return e(!0), () => e(!1);
+    return e(!0), () => {
+      e(!1);
+    };
   }, []);
 }, m = c;
 export {

package/dist/esm/form/useForm.mjs

@@ -16,11 +16,11 @@ const p = ({
     Form: ({ children: n }) => /* @__PURE__ */ i(
       f,
       {
-        ...o,
         isDev: e,
         formId: r,
         formRef: t,
         onSubmit: o == null ? void 0 : o.onSubmit,
+        ...o,
         children: n
       }
     )

package/dist/esm/form/{useFormWithProvider.mjs → useFormWithProviders.mjs}

@@ -1,18 +1,18 @@
-import { jsx as f } from "react/jsx-runtime";
+import { jsx as s } from "react/jsx-runtime";
 import "react";
-import d from "./context/FormProvider.mjs";
-import s from "./useForm.mjs";
+import f from "./context/FormProvider.mjs";
+import d from "./useForm.mjs";
 const n = ({
   isDev: o,
   rhf: e,
   form: t,
   utils: m
 }) => {
-  const r = s({ isDev: o, rhf: e, form: t });
+  const r = d({ isDev: o, rhf: e, form: t });
   return {
     ...r,
-    Provider: ({ children: i }) => /* @__PURE__ */ f(
-      d,
+    Provider: ({ children: i }) => /* @__PURE__ */ s(
+      f,
       {
         isDev: o,
         formRef: r.ref,

package/dist/esm/{form/FormError.mjs → submit/error/FormSubmitError.mjs}

@@ -1,8 +1,8 @@
-class e extends Error {
+class t extends Error {
   constructor(r, o) {
     super(o), this.errors = r;
   }
 }
 export {
-  e as FormError
+  t as FormSubmitError
 };

package/dist/esm/submit/error/handleFormSubmitError.mjs

@@ -0,0 +1,12 @@
+import { FormSubmitError as m } from "./FormSubmitError.mjs";
+const n = (r, o) => {
+  r instanceof m && Object.entries(r.errors).forEach(([t, e]) => {
+    o.setError(t, {
+      type: "FormSubmitError",
+      message: e
+    });
+  });
+};
+export {
+  n as default
+};

package/dist/esm/submit/useResetFormOnSubmitError.mjs

@@ -0,0 +1,18 @@
+import i from "react";
+import { useFormContext as m, useFormState as n } from "react-hook-form";
+const f = (t) => {
+  const { reset: r } = m(), { isSubmitting: e, isSubmitSuccessful: u, isSubmitted: o, submitCount: s } = n();
+  i.useEffect(() => {
+    t || e || u || o && s !== 0 && r(void 0);
+  }, [
+    t,
+    e,
+    u,
+    o,
+    r,
+    s
+  ]);
+}, b = f;
+export {
+  b as default
+};

package/dist/esm/submit/useSubmitFormOnChange.mjs

@@ -0,0 +1,21 @@
+import s from "react";
+import u from "../errors/useFormRequestSubmit.mjs";
+const m = (t, n) => {
+  const o = u(t);
+  s.useEffect(() => {
+    if (n)
+      return;
+    const e = t.current;
+    if (!e)
+      throw new Error();
+    const r = () => {
+      o();
+    };
+    return e.addEventListener("change", r), () => {
+      e.removeEventListener("change", r);
+    };
+  }, []);
+}, a = m;
+export {
+  a as default
+};

package/dist/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Playground</title>
+    <script type="module" crossorigin src="/assets/index-BgBykTYQ.js"></script>
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/types/errors/context/provider.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="react" />
 type Props = React.PropsWithChildren<{
-    formRef: React.MutableRefObject<HTMLFormElement>;
+    formRef: React.RefObject<HTMLFormElement>;
     isDev?: boolean;
     outputErrors?: boolean;
 }>;

package/dist/types/errors/orphan/getOrphansFromFieldErrors.d.ts

@@ -0,0 +1,5 @@
+import { FlatFieldErrors } from '../flat/types';
+import { FieldErrors } from 'react-hook-form';
+
+declare const getOrphansFromFieldErrors: (errors: FieldErrors, parentElement: Pick<HTMLElement, 'querySelector'>) => FlatFieldErrors;
+export default getOrphansFromFieldErrors;

package/dist/types/errors/orphan/getOrphansFromFlatFieldErrors.d.ts

@@ -0,0 +1,4 @@
+import { FlatFieldErrors } from '../flat/types';
+
+declare const getOrphansFromFlatFieldErrors: (errors: FlatFieldErrors, parentElement: Pick<HTMLElement, 'querySelector'>) => FlatFieldErrors;
+export default getOrphansFromFlatFieldErrors;

package/dist/types/errors/root/FormRootErrorsFromContext.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+declare const FormRootErrorsFromContext: React.FC;
+export default FormRootErrorsFromContext;

package/dist/types/errors/root/getRootsFromFieldErrors.d.ts

@@ -0,0 +1,5 @@
+import { FlatFieldErrors } from '../flat/types';
+import { FieldErrors } from 'react-hook-form';
+
+declare const getRootsFromFieldErrors: (errors: FieldErrors) => FlatFieldErrors;
+export default getRootsFromFieldErrors;

package/dist/types/errors/root/getRootsFromFlatFieldErrors.d.ts

@@ -0,0 +1,4 @@
+import { FlatFieldErrors } from '../flat/types';
+
+declare const getRootsFromFlatFieldErrors: (errors: FlatFieldErrors) => FlatFieldErrors;
+export default getRootsFromFlatFieldErrors;

package/dist/types/errors/useFormErrorsIfAny.d.ts

@@ -2,5 +2,5 @@
  * Returns errors only if there are errors.
  * Allows simple typeguard without `isEmpty` dependency.
  */
-declare const useFormErrorsIfAny: () => false | import('react-hook-form').FieldErrors<import("react-hook-form").FieldValues>;
+declare const useFormErrorsIfAny: () => false | import('react-hook-form').FieldErrors<import('react-hook-form').FieldValues>;
 export default useFormErrorsIfAny;

package/dist/types/exports.d.ts

@@ -0,0 +1,37 @@
+export { default as LazyDevTool } from './devtool/LazyDevTool';
+export { default as useFormErrorsFlatContext } from './errors/context';
+export { default as FormErrorsFlatContextProvider } from './errors/context/provider';
+export { default as FormErrorMessage } from './errors/message/FormErrorMessage';
+export { default as FormErrorMessageByPath } from './errors/message/FormErrorMessageByPath';
+export { default as FormNonFieldErrorMarker } from './errors/nonfield/FormNonFieldErrorMarker';
+export { default as FormNonFieldErrorMarkerHtmlAttribute } from './errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute';
+export { default as useFormHasOrphanAndNoFieldErrors } from './errors/orphan/useFormHasOrphanAndNoFieldErrors';
+export { default as useOrphanFormErrorsMemo } from './errors/orphan/useOrphanFormErrorsMemo';
+export { default as useOrphanFormErrorsToConsole } from './errors/orphan/useOrphanFormErrorsToConsole';
+export { default as useRootFormFieldErrorsMemo } from './errors/root/useRootFormFieldErrorsMemo';
+export { default as useFormErrorConsoleDebug } from './errors/useFormErrorConsoleDebug';
+export { default as useFormErrorsEffect } from './errors/useFormErrorsEffect';
+export { default as useFormErrorsIfAny } from './errors/useFormErrorsIfAny';
+export { default as useFormErrorsMemo } from './errors/useFormErrorsMemo';
+export { default as useFormRequestSubmit } from './errors/useFormRequestSubmit';
+export { default as Form } from './form/Form';
+export { default as FormWithProviders } from './form/FormWithProviders';
+export { default as useForm } from './form/useForm';
+export { default as useFormWithProviders } from './form/useFormWithProviders';
+export { default as FormProvider } from './form/context/FormProvider';
+export { default as FormUtilsContextProvider } from './form/context/utils/FormUtilsContextProvider';
+export { default as useFormUtilsContext } from './form/context/utils/useFormUtilsContext';
+export { default as FormGroupContextProvider } from './form/context/group/FormGroupContextProvider';
+export { default as useFormGroupChildIsMountedTracker } from './form/context/group/useFormGroupChildIsMountedTracker';
+export { default as useFormGroupChildIsSubmittingTracker } from './form/context/group/useFormGroupChildIsSubmittingTracker';
+export { default as useFormGroupIsAnyBusy } from './form/context/group/useFormGroupIsAnyBusy';
+export { default as useFormGroupIsChildBusy } from './form/context/group/useFormGroupIsChildBusy';
+export { default as useFormGroupIsParentBusy } from './form/context/group/useFormGroupIsParentBusy';
+export { default as useFormGroupParentTracker } from './form/context/group/useFormGroupParentTracker';
+export { default as getSubmitterButtonData } from './form/utils/getSubmitterButtonData';
+export { FormSubmitError } from './submit/error/FormSubmitError';
+export { default as useFormOnSubmitSuccessful } from './submit/useFormOnSubmitSuccessful';
+export { default as useFormOnSubmitSuccessfulAndReset } from './submit/useFormOnSubmitSuccessfulAndReset';
+export { default as useResetFormOnSubmitError } from './submit/useResetFormOnSubmitError';
+export { default as useResetFormAfterSubmitSuccessful } from './submit/useResetFormOnSubmitSuccessful';
+export { default as useSubmitFormOnChange } from './submit/useSubmitFormOnChange';

package/dist/types/form/ErrorBoundary.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+
+type Props = React.PropsWithChildren;
+type State = {
+    error: null | Error;
+};
+export declare class ErrorBoundary extends React.Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): {
+        error: Error;
+    };
+    componentDidCatch(error: unknown, errorInfo: React.ErrorInfo): void;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};

package/dist/types/form/Form.d.ts

@@ -7,17 +7,24 @@ export type FormProps<TFieldValues extends FieldValues, TTransformedValues exten
     isDev: boolean;
     formId?: string;
     formRef?: React.RefObject<HTMLFormElement>;
+    Fields?: React.FC<{
+        ctx: UseFormReturn<TFieldValues, unknown, TTransformedValues>;
+    }>;
     onSubmit?: (values: TTransformedValues, context: UseFormReturn<TFieldValues, unknown, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => unknown | Promise<unknown>;
     /** Submit error handler. (Only for errors not of instance `FormError`, which are handled internally.) */
-    onSubmitError?: (error: unknown, values: TTransformedValues, context: UseFormReturn<TFieldValues, unknown, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => void;
+    onSubmitError?: (error: unknown, context: UseFormReturn<TFieldValues, unknown, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => void;
     /** Submit handler when form is invalid. */
     onSubmitInvalid?: SubmitErrorHandler<TFieldValues>;
     options?: {
+        hideRootErrors?: boolean;
+        /** Request submit via listener on form change. */
+        submitOnChange?: boolean;
+        /** Reset form values if submit throw errors. Use case: optimistic UI toggle form that submits on each change */
+        resetValuesOnSubmitError?: boolean;
         stopSubmitPropagation?: boolean;
-        disableEmptyRootError?: boolean;
         devTool?: DevtoolUIProps | 'disabled';
     };
     className?: string;
 }>;
-declare function Form<TFieldValues extends FieldValues, TTransformedValues extends FieldValues>({ isDev, formId, formRef, onSubmit, onSubmitError, onSubmitInvalid, options, children, ...props }: FormProps<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
+declare function Form<TFieldValues extends FieldValues, TTransformedValues extends FieldValues>({ isDev, formId, formRef, Fields, onSubmit, onSubmitError, onSubmitInvalid, options, children, ...props }: FormProps<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
 export default Form;

package/dist/types/form/FormWithProviders.d.ts

@@ -0,0 +1,13 @@
+import { UseFormProps } from './useForm';
+import { FieldValues } from 'react-hook-form';
+
+export type FormWithProviders<TFieldValues extends FieldValues, TTransformedValues extends FieldValues> = React.PropsWithChildren<UseFormProps<TFieldValues, TTransformedValues>>;
+/**
+ * {@link FormProvider} (and utils) with immediate descendent {@link Form}.
+ * (Syntactic sugar for {@link useForm}. Use this for most applications.)
+ *
+ * Use {@link useForm} if you need to specific nesting hierarchy.
+ * (e.g., wrapping `<tr>` with provider and nesting `<form>` within `<td>` to appease HTML rules.)
+ */
+declare function FormWithProviders<TFieldValues extends FieldValues, TTransformedValues extends FieldValues>({ children, ...props }: FormWithProviders<TFieldValues, TTransformedValues>): import("react/jsx-runtime").JSX.Element;
+export default FormWithProviders;

package/dist/types/form/{useFormWithProvider.d.ts → useFormWithProviders.d.ts}

@@ -3,11 +3,11 @@ import { FormUtilsContextProviderProps } from './context/utils/FormUtilsContextP
 import { FieldValues } from 'react-hook-form';
 import { default as React } from 'react';
 
-export type UseFormWithProviderProps<TFieldValues extends FieldValues, TTransformedValues extends FieldValues> = UseFormProps<TFieldValues, TTransformedValues> & {
+export type UseFormWithProvidersProps<TFieldValues extends FieldValues, TTransformedValues extends FieldValues> = UseFormProps<TFieldValues, TTransformedValues> & {
     /** {@link FormUtilsContextProviderProps} props for `FormUtilsContextProvider`. */
     utils?: FormUtilsContextProviderProps;
 };
-export type UseFormWithProviderReturn = ReturnType<typeof useFormWithProvider>;
+export type UseFormWithProvidersReturn = ReturnType<typeof useFormWithProviders>;
 /**
  * Base Rhf Form hook. Use `Form` in `index.ts` for most cases.
  * Use this if you need to separate form components.
@@ -17,7 +17,7 @@ export type UseFormWithProviderReturn = ReturnType<typeof useFormWithProvider>;
  * see https://caniuse.com/?search=form%20attribute
  * @returns Form provider and form.
  */
-declare const useFormWithProvider: <TFieldValues extends FieldValues, TTransformedValues extends FieldValues>({ isDev, rhf, form, utils, }: UseFormWithProviderProps<TFieldValues, TTransformedValues>) => {
+declare const useFormWithProviders: <TFieldValues extends FieldValues, TTransformedValues extends FieldValues>({ isDev, rhf, form, utils, }: UseFormWithProvidersProps<TFieldValues, TTransformedValues>) => {
     readonly Provider: React.FC<{
         children?: React.ReactNode;
     }>;
@@ -28,4 +28,4 @@ declare const useFormWithProvider: <TFieldValues extends FieldValues, TTransform
         children?: React.ReactNode;
     }>;
 };
-export default useFormWithProvider;
+export default useFormWithProviders;

package/dist/types/main.d.ts

@@ -1,35 +1 @@
-export { default as LazyDevTool } from './devtool/LazyDevTool';
-export { default as useFormErrorsFlatContext } from './errors/context';
-export { default as FormErrorsFlatContextProvider } from './errors/context/provider';
-export { default as FormErrorMessage } from './errors/message/FormErrorMessage';
-export { default as FormErrorMessageByPath } from './errors/message/FormErrorMessageByPath';
-export { default as FormNonFieldErrorMarker } from './errors/nonfield/FormNonFieldErrorMarker';
-export { default as FormNonFieldErrorMarkerHtmlAttribute } from './errors/nonfield/FormNonFieldErrorMarkerHtmlAttribute';
-export { default as useFormHasOrphanAndNoFieldErrors } from './errors/orphan/useFormHasOrphanAndNoFieldErrors';
-export { default as useOrphanFormErrorsMemo } from './errors/orphan/useOrphanFormErrorsMemo';
-export { default as useOrphanFormErrorsToConsole } from './errors/orphan/useOrphanFormErrorsToConsole';
-export { default as useRootFormFieldErrorsMemo } from './errors/root/useRootFormFieldErrorsMemo';
-export { default as useFormErrorConsoleDebug } from './errors/useFormErrorConsoleDebug';
-export { default as useFormErrorsEffect } from './errors/useFormErrorsEffect';
-export { default as useFormErrorsIfAny } from './errors/useFormErrorsIfAny';
-export { default as useFormErrorsMemo } from './errors/useFormErrorsMemo';
-export { default as useFormRequestSubmit } from './errors/useFormRequestSubmit';
-export { default as Form } from './form/Form';
-export { FormError } from './form/FormError';
-export { default as FormWithProvider } from './form/FormWithProvider';
-export { default as useForm } from './form/useForm';
-export { default as useFormWithProvider } from './form/useFormWithProvider';
-export { default as FormProvider } from './form/context/FormProvider';
-export { default as FormUtilsContextProvider } from './form/context/utils/FormUtilsContextProvider';
-export { default as useFormUtilsContext } from './form/context/utils/useFormUtilsContext';
-export { default as FormGroupContextProvider } from './form/context/group/FormGroupContextProvider';
-export { default as useFormGroupChildIsMountedTracker } from './form/context/group/useFormGroupChildIsMountedTracker';
-export { default as useFormGroupChildIsSubmittingTracker } from './form/context/group/useFormGroupChildIsSubmittingTracker';
-export { default as useFormGroupIsAnyBusy } from './form/context/group/useFormGroupIsAnyBusy';
-export { default as useFormGroupIsChildBusy } from './form/context/group/useFormGroupIsChildBusy';
-export { default as useFormGroupIsParentBusy } from './form/context/group/useFormGroupIsParentBusy';
-export { default as useFormGroupParentTracker } from './form/context/group/useFormGroupParentTracker';
-export { default as getSubmitterButtonData } from './form/utils/getSubmitterButtonData';
-export { default as useFormOnSubmitSuccessful } from './submit/useFormOnSubmitSuccessful';
-export { default as useFormOnSubmitSuccessfulAndReset } from './submit/useFormOnSubmitSuccessfulAndReset';
-export { default as useResetFormAfterSubmitSuccessful } from './submit/useResetFormOnSubmitSuccessful';
+export {};

package/dist/types/{form/FormError.d.ts → submit/error/FormSubmitError.d.ts}

@@ -1,6 +1,6 @@
 import { FieldPath, FieldValues } from 'react-hook-form';
 
-export declare class FormError<TFieldValues extends FieldValues> extends Error {
+export declare class FormSubmitError<TFieldValues extends FieldValues = FieldValues> extends Error {
     errors: Partial<Record<FieldPath<TFieldValues> | `root.${string}`, string>>;
     constructor(errors: Partial<Record<FieldPath<TFieldValues> | `root.${string}`, string>>, message?: string);
 }

package/dist/types/submit/error/handleFormSubmitError.d.ts

@@ -0,0 +1,7 @@
+import { FieldValues, UseFormReturn } from 'react-hook-form';
+
+/**
+ * Handle form submit error if {@link FormSubmitError}. Add items to RHF form errors.
+ */
+declare const handleFormSubmitError: <TFieldValues extends FieldValues, TTransformedValues extends FieldValues>(error: unknown, ctx: UseFormReturn<TFieldValues, unknown, TTransformedValues>) => void;
+export default handleFormSubmitError;

package/dist/types/submit/useResetFormOnSubmitError.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Handle resetting after successful submit with no server validation errors.
+ * See `Rules` section: https://react-hook-form.com/api/useform/reset/
+ * Specifically: "- It's recommended to reset inside useEffect after submission."
+ */
+declare const useResetFormOnSubmitError: (disabled?: boolean) => void;
+export default useResetFormOnSubmitError;

package/dist/types/submit/useSubmitFormOnChange.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+
+declare const useSubmitFormOnChange: (formRef: React.RefObject<HTMLFormElement>, disabled?: boolean) => void;
+export default useSubmitFormOnChange;