@paragrav/rhf-utils 0.0.121 → 0.0.125

package/README.md

@@ -171,7 +171,10 @@ Currently, only `zod` is supported.
   }}
   utils={{
     submitOnChange: true,
-    resetValuesOnSubmitError: true,
+    resetValuesOnSubmitted: {
+      onSuccess: 'current',
+      onError: 'defaults',
+    },
     // custom option props
     // (see "Extend RhfUtilsFormOptions" section)
     enableMyFormNavigationPrompt: true,
@@ -235,17 +238,17 @@ These options can be set globally and/or per form.
 
 ```ts
 type RhfUtilsFormOptions = {
-  /** 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;
-
   /** Stop propagation of submit event. Useful for portals. */
   stopSubmitPropagation?: boolean;
 
-  /** Reset form after successful submit. */
-  resetFormAfterSubmitSuccessful?: UseResetFormAfterSubmitSuccessfulOptions;
+  /** Request submit via listener on form change. */
+  submitOnChange?: boolean;
+
+  /** Reset form after submitted. */
+  resetFormOnSubmitted?: {
+    onSuccess?: 'defaults' | 'current';
+    onError?: 'defaults';
+  };
 
   /** Control dev tool options. (Lazy-loaded when truthy value supplied.) */
   devTool?: true | Pick<DevtoolUIProps, 'placement' | 'styles'>;

package/dist/esm/devtool/LazyDevTool.mjs

@@ -6,8 +6,7 @@ const a = e.lazy(
     default: o.DevTool
   }))
 ), u = ({ isDevelopment: o, props: r }) => {
-  if (!o)
-    return null;
+  if (!o) return null;
   const { control: l } = n();
   return /* @__PURE__ */ t(e.Suspense, { fallback: null, children: /* @__PURE__ */ t(a, { control: l, ...r }) });
 };

package/dist/esm/errors/flat/context/FlatFieldErrorsContextProvider.mjs

@@ -18,7 +18,7 @@ const C = ({
     orphans: s,
     // computed
     hasErrors: !e(t),
-    hasOrphans: e(s)
+    hasOrphans: !e(s)
   };
   return /* @__PURE__ */ a(f, { value: i, children: m });
 };

package/dist/esm/errors/flat/context/useFlatFieldErrorsContextOutput.mjs

@@ -6,8 +6,7 @@ const C = (r) => {
   const l = p(), t = F();
   u.useEffect(() => {
     var o, m;
-    if (!t.hasErrors)
-      return;
+    if (!t.hasErrors) return;
     const e = (o = r == null ? void 0 : r.console) == null ? void 0 : o.call(r, t);
     e && E(
       e.message ?? a,

package/dist/esm/errors/flat/getFlatFieldErrors.mjs

@@ -9,8 +9,7 @@ const u = (t) => {
           d,
           ""
         );
-        if (r === o)
-          return e;
+        if (r === o) return e;
         const f = c(t, r, void 0);
         return f && e.push([r, f]), e;
       },

package/dist/esm/exports.mjs

@@ -1,5 +1,5 @@
 import { default as e } from "./client/zod/context/RhfUtilsClientForZodContextProvider.mjs";
-import { default as s } from "./client/zod/context/RhfUtilsZodForm.mjs";
+import { default as a } from "./client/zod/context/RhfUtilsZodForm.mjs";
 import { default as u } from "./client/zod/context/useRhfUtilsZodForm.mjs";
 import { default as m } from "./errors/flat/context/useFlatFieldErrorsContext.mjs";
 import { default as d } from "./errors/flat/context/useFlatFieldErrorsContextHasOnlyOrphans.mjs";
@@ -7,44 +7,46 @@ import { default as x } from "./errors/message/FormErrorMessageByPath.mjs";
 import { default as F } from "./errors/nonfield/FormNonFieldErrorMarker.mjs";
 import { default as C } from "./errors/root/RootErrorsListFromFlatFieldErrorsContext.mjs";
 import { getOnSubmitTrpcClientErrorHandler as E } from "./errors/trpc/getOnSubmitTrpcClientErrorHandler.mjs";
-import { trpcClientErrorToFormSubmitErrorsSchemaTransformer as R } from "./errors/trpc/trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs";
-import { default as b } from "./form/context/utils/useRhfUtilsContext.mjs";
+import { trpcClientErrorToFormSubmitErrorsSchemaTransformer as c } from "./errors/trpc/trpcClientErrorToFormSubmitErrorsSchemaTransformer.mjs";
+import { default as R } from "./form/context/utils/useRhfUtilsContext.mjs";
 import { default as y } from "./form/context/utils/useRhfUtilsContextRequestSubmit.mjs";
-import { default as B } from "./form/context/group/FormGroupContextProvider.mjs";
-import { default as P } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
-import { default as U } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
+import { default as T } from "./form/context/group/FormGroupContextProvider.mjs";
+import { default as I } from "./form/context/group/useFormGroupChildIsMountedTracker.mjs";
+import { default as g } from "./form/context/group/useFormGroupChildIsSubmittingTracker.mjs";
 import { default as O } from "./form/context/group/useFormGroupChildTracker.mjs";
-import { default as Z } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
-import { default as v } from "./form/context/group/useFormGroupIsChildBusy.mjs";
-import { default as A } from "./form/context/group/useFormGroupIsParentBusy.mjs";
-import { default as L } from "./form/context/group/useFormGroupParentTracker.mjs";
+import { default as M } from "./form/context/group/useFormGroupIsAnyBusy.mjs";
+import { default as q } from "./form/context/group/useFormGroupIsChildBusy.mjs";
+import { default as N } from "./form/context/group/useFormGroupIsParentBusy.mjs";
+import { default as D } from "./form/context/group/useFormGroupParentTracker.mjs";
 import { default as j } from "./form/context/group/useFormOrParentIsBusy.mjs";
 import { default as z } from "./form/utils/getSubmitterButtonData.mjs";
 import { default as K } from "./form/utils/useFormRequestSubmit.mjs";
-import { FormSubmitError as V } from "./submit/error/FormSubmitError.mjs";
+import { default as V } from "./form/utils/useShouldFormBlockNavigation.mjs";
+import { FormSubmitError as X } from "./submit/error/FormSubmitError.mjs";
 export {
   x as FormErrorMessageByPath,
-  B as FormGroupContextProvider,
+  T as FormGroupContextProvider,
   F as FormNonFieldErrorMarker,
-  V as FormSubmitError,
+  X as FormSubmitError,
   e as RhfUtilsClientForZodContextProvider,
-  s as RhfUtilsZodForm,
+  a as RhfUtilsZodForm,
   C as RootErrorsListFromFlatFieldErrorsContext,
   E as getOnSubmitTrpcClientErrorHandler,
   z as getSubmitterButtonData,
-  R as trpcClientErrorToFormSubmitErrorsSchemaTransformer,
+  c as trpcClientErrorToFormSubmitErrorsSchemaTransformer,
   m as useFlatFieldErrorsContext,
   d as useFlatFieldErrorsContextHasOnlyOrphans,
-  P as useFormGroupChildIsMountedTracker,
-  U as useFormGroupChildIsSubmittingTracker,
+  I as useFormGroupChildIsMountedTracker,
+  g as useFormGroupChildIsSubmittingTracker,
   O as useFormGroupChildTracker,
-  Z as useFormGroupIsAnyBusy,
-  v as useFormGroupIsChildBusy,
-  A as useFormGroupIsParentBusy,
-  L as useFormGroupParentTracker,
+  M as useFormGroupIsAnyBusy,
+  q as useFormGroupIsChildBusy,
+  N as useFormGroupIsParentBusy,
+  D as useFormGroupParentTracker,
   j as useFormOrParentIsBusy,
   K as useFormRequestSubmit,
-  b as useRhfUtilsContext,
+  R as useRhfUtilsContext,
   y as useRhfUtilsContextRequestSubmit,
-  u as useRhfUtilsZodForm
+  u as useRhfUtilsZodForm,
+  V as useShouldFormBlockNavigation
 };

package/dist/esm/form/Form.mjs

@@ -1,9 +1,9 @@
-import { jsx as s, jsxs as j } from "react/jsx-runtime";
+import { jsx as h, jsxs as T } from "react/jsx-runtime";
 import "react";
-import { useFormContext as v } from "react-hook-form";
+import { useFormContext as j } from "react-hook-form";
 import w from "../client/config/useRhfUtilsClientConfigContext.mjs";
 import E from "../devtool/LazyDevTool.mjs";
-import { FormSubmitError as c } from "../submit/error/FormSubmitError.mjs";
+import { FormSubmitError as s } from "../submit/error/FormSubmitError.mjs";
 import S from "../submit/error/setCtxErrorsByFormSubmitErrors.mjs";
 import U from "../utils/PassthroughChildren.mjs";
 import _ from "./_Controller.mjs";
@@ -12,66 +12,74 @@ function G({
   formRef: m,
   //
   onSubmit: a,
-  onSubmitError: h,
+  onSubmitError: d,
   onSubmitInvalid: i,
   Children: l,
   //
   form: F,
-  utils: o
+  utils: r
 }) {
-  const n = v(), r = w(), y = async (t) => {
-    o != null && o.stopSubmitPropagation && t.stopPropagation();
+  const n = j(), t = w(), y = async (o) => {
+    r != null && r.stopSubmitPropagation && o.stopPropagation();
     try {
-      await n.handleSubmit(f, i)(t);
+      await n.handleSubmit(f, i)(o);
     } catch (e) {
-      b(e, t);
+      b(e, o);
     }
-  }, f = (t, e) => a == null ? void 0 : a(
-    t,
+  }, f = (o, e) => a == null ? void 0 : a(
+    o,
     {
       formId: p,
       formRef: m,
       context: n,
-      utils: o,
-      FormSubmitError: c
+      utils: r,
+      FormSubmitError: s
     },
     e
-  ), b = (t, e) => {
+  ), b = (o, e) => {
     var x;
-    const C = t instanceof c ? (
+    const C = o instanceof s ? (
       // consumer can manually throw FormSubmitError (e.g., manual validation)
-      t.errors
+      o.errors
     ) : (
       // if error is not FormSubmitError, consumer can provide global handler
-      (x = r == null ? void 0 : r.onSubmitUnknownError) == null ? void 0 : x.call(r, t)
+      (x = t == null ? void 0 : t.onSubmitUnknownError) == null ? void 0 : x.call(t, o)
     );
-    C && S(n, C), h == null || h(
-      t,
+    C && S(n, C), d == null || d(
+      o,
       {
         formId: p,
         formRef: m,
         context: n,
-        utils: o
+        utils: r
       },
       e
     );
-  }, d = {
+  }, c = {
     formId: p,
     formRef: m,
     context: n,
-    utils: o,
+    utils: r,
     Controller: _,
-    FormSubmitError: c
-  }, P = (r == null ? void 0 : r.FormComponent) ?? "form", T = (r == null ? void 0 : r.FormChildren) ?? U;
-  return /* @__PURE__ */ s(P, { ...F, ref: m, onSubmit: y, children: /* @__PURE__ */ j(T, { ...d, children: [
-    (o == null ? void 0 : o.devTool) && /* @__PURE__ */ s(
-      E,
-      {
-        props: typeof o.devTool == "object" ? o.devTool : void 0
-      }
-    ),
-    /* @__PURE__ */ s(l, { ...d })
-  ] }) });
+    FormSubmitError: s
+  }, v = (t == null ? void 0 : t.FormComponent) ?? "form", P = (t == null ? void 0 : t.FormChildren) ?? U;
+  return /* @__PURE__ */ h(
+    v,
+    {
+      ...F,
+      ref: m,
+      onSubmit: (o) => void y(o),
+      children: /* @__PURE__ */ T(P, { ...c, children: [
+        (r == null ? void 0 : r.devTool) && /* @__PURE__ */ h(
+          E,
+          {
+            props: typeof r.devTool == "object" ? r.devTool : void 0
+          }
+        ),
+        /* @__PURE__ */ h(l, { ...c })
+      ] })
+    }
+  );
 }
 export {
   G as default

package/dist/esm/form/context/utils/RhfUtilsContextProvider.mjs

@@ -1,30 +1,29 @@
 import { jsx as l } from "react/jsx-runtime";
-import C from "../../../client/config/useRhfUtilsClientConfigContext.mjs";
-import F from "../../../errors/flat/context/useFlatFieldErrorsContextOutput.mjs";
-import x from "../../../submit/useFormOnSubmitSuccessfulAndReset.mjs";
-import O from "../../../submit/useResetFormOnSubmitError.mjs";
-import b from "../../../submit/useResetFormOnSubmitSuccessful.mjs";
-import d from "../../../submit/useSubmitFormOnChange.mjs";
-import { _RhfUtilsContextProvider as h } from "./useRhfUtilsContext.mjs";
-const M = ({
-  formId: f,
-  formRef: t,
-  onSubmitSuccessfulAndReset: e,
+import d from "../../../client/config/useRhfUtilsClientConfigContext.mjs";
+import i from "../../../errors/flat/context/useFlatFieldErrorsContextOutput.mjs";
+import u from "../../../submit/useFormOnSubmitSuccessfulAndReset.mjs";
+import x from "../../../submit/useResetFormOnSubmitted.mjs";
+import F from "../../../submit/useSubmitFormOnChange.mjs";
+import { _RhfUtilsContextProvider as O } from "./useRhfUtilsContext.mjs";
+const P = ({
+  formId: C,
+  formRef: m,
+  onSubmitSuccessfulAndReset: t,
   options: r,
-  children: a
+  children: f
 }) => {
-  var u;
-  const m = C();
-  return F((u = m == null ? void 0 : m.fieldErrors) == null ? void 0 : u.output), d(t, {
+  var a;
+  const e = d();
+  return i((a = e == null ? void 0 : e.fieldErrors) == null ? void 0 : a.output), F(m, {
     disabled: !(r != null && r.submitOnChange)
-  }), O({
-    disabled: !(r != null && r.resetValuesOnSubmitError)
-  }), b(
-    (r == null ? void 0 : r.resetFormAfterSubmitSuccessful) || !!e
-  ), x(() => {
-    e == null || e();
-  }), /* @__PURE__ */ l(h, { value: { formId: f, formRef: t, options: r }, children: a });
+  }), x(
+    (r == null ? void 0 : r.resetFormOnSubmitted) ?? (t && {
+      onSuccess: "defaults"
+    })
+  ), u(() => {
+    t == null || t();
+  }), /* @__PURE__ */ l(O, { value: { formId: C, formRef: m, options: r }, children: f });
 };
 export {
-  M as default
+  P as default
 };

package/dist/esm/form/utils/useFormRequestSubmit.mjs

@@ -1,6 +1,5 @@
 const u = (t) => (r) => {
-  if (!t.current)
-    throw new Error();
+  if (!t.current) throw new Error();
   e(t.current, r);
 }, e = (t, r) => {
   t.requestSubmit(r);

package/dist/esm/form/utils/useShouldFormBlockNavigation.mjs

@@ -0,0 +1,9 @@
+const s = (o, { isDirty: a, isSubmitting: t, isValid: l }) => (
+  // enabled
+  o && // dirty
+  a && // allow redirecting in submit handler
+  !(t && l)
+), u = s;
+export {
+  u as default
+};

package/dist/esm/submit/useFormOnSubmitSuccessfulAndReset.mjs

@@ -1,13 +1,11 @@
-import r from "react";
-import { useFormState as f } from "react-hook-form";
-import c from "./useFormOnSubmitSuccessful.mjs";
+import f from "react";
+import { useFormState as i } from "react-hook-form";
+import { useRefIfValueWasTrue as m } from "../utils/useRefIfValueWasTrue.mjs";
 const n = (t) => {
-  const { isSubmitSuccessful: u, isDirty: s } = f(), e = r.useRef(!1);
-  c(() => {
-    e.current = !0;
-  }), r.useEffect(() => {
-    t && e.current && !u && !s && (t(), e.current = !1);
-  }, [u, s]);
+  const { isDirty: s, isSubmitSuccessful: e } = i(), [u, r] = m(e);
+  f.useEffect(() => {
+    t && (s || !e && !u || (t(), r()));
+  }, [e, s]);
 };
 export {
   n as default

package/dist/esm/submit/useFormOnSubmitted.mjs

@@ -0,0 +1,12 @@
+import u from "react";
+import { useFormState as o } from "react-hook-form";
+import { useRefIfValueWasTrue as m } from "../utils/useRefIfValueWasTrue.mjs";
+const c = (e, f) => {
+  const { isSubmitSuccessful: i, isSubmitting: t } = o(), [r, s] = m(t);
+  u.useEffect(() => {
+    e && (t || r && (s(), e(i)));
+  }, [t]);
+};
+export {
+  c as default
+};

package/dist/esm/submit/useResetFormOnSubmitted.mjs

@@ -0,0 +1,21 @@
+import { useFormContext as m } from "react-hook-form";
+import n from "./useFormOnSubmitted.mjs";
+const S = (e) => {
+  const { reset: r, getValues: u } = m();
+  n((s) => {
+    if (!e) return;
+    const t = e[s ? "onSuccess" : "onError"];
+    if (!t) return;
+    const o = t === "current" ? u() : void 0;
+    r(o, {
+      // keep submit stuff for tracking relevant state (e.g., `useFormOnSubmitSuccessful`)
+      keepIsSubmitSuccessful: !0,
+      keepIsSubmitted: !0,
+      keepSubmitCount: !0,
+      keepErrors: !0
+    });
+  });
+};
+export {
+  S as default
+};

package/dist/esm/submit/useSubmitFormOnChange.mjs

@@ -1,15 +1,13 @@
-import m from "react";
-import a from "../form/utils/useFormRequestSubmit.mjs";
-const o = (t, e) => {
-  const u = a(t);
-  m.useEffect(() => {
-    if (e != null && e.disabled)
-      return;
+import c from "react";
+import m from "../form/utils/useFormRequestSubmit.mjs";
+const d = (t, e) => {
+  const u = !(e != null && e.disabled), a = m(t);
+  c.useEffect(() => {
+    if (!u) return;
     const r = t.current;
-    if (!r)
-      throw new Error();
+    if (!r) throw new Error();
     const n = () => {
-      u();
+      a();
     };
     return r.addEventListener("change", n), () => {
       r.removeEventListener("change", n);
@@ -17,5 +15,5 @@ const o = (t, e) => {
   }, []);
 };
 export {
-  o as default
+  d as default
 };

package/dist/esm/utils/createContext.mjs

@@ -2,8 +2,7 @@ import r from "react";
 function i() {
   const e = r.createContext(void 0), t = () => r.useContext(e), n = () => {
     const o = t();
-    if (o === void 0)
-      throw new Error();
+    if (o === void 0) throw new Error();
     return o;
   };
   return {

package/dist/esm/utils/useRefIfValueWasTrue.mjs

@@ -0,0 +1,14 @@
+import t from "react";
+const u = (r) => {
+  const e = t.useRef(!1);
+  t.useEffect(() => {
+    r && (e.current = !0);
+  }, [r]);
+  const s = () => {
+    e.current = !1;
+  };
+  return [e.current, s];
+};
+export {
+  u as useRefIfValueWasTrue
+};

package/dist/types/exports.d.ts

@@ -28,4 +28,5 @@ export { default as useFormGroupParentTracker } from './form/context/group/useFo
 export { default as useFormOrParentIsBusy } from './form/context/group/useFormOrParentIsBusy';
 export { default as getSubmitterButtonData } from './form/utils/getSubmitterButtonData';
 export { default as useFormRequestSubmit } from './form/utils/useFormRequestSubmit';
+export { default as useShouldFormBlockNavigation } from './form/utils/useShouldFormBlockNavigation';
 export { FormSubmitError } from './submit/error/FormSubmitError';

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

@@ -1,5 +1,5 @@
 import { DevtoolUIProps } from '@hookform/devtools/dist/devToolUI';
-import { UseResetFormAfterSubmitSuccessfulOptions } from '../submit/useResetFormOnSubmitSuccessful';
+import { UseResetFormOnSubmittedOptions } from '../submit/useResetFormOnSubmitted';
 import { Register } from '../register';
 
 /**
@@ -8,14 +8,12 @@ import { Register } from '../register';
  * Can be extended using {@link Register.RhfUtilsFormOptions}.
  */
 export type RhfUtilsFormOptions = {
-    /** 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;
     /** Stop propagation of submit event. Useful for portals. */
     stopSubmitPropagation?: boolean;
-    /** Reset form after successful submit. */
-    resetFormAfterSubmitSuccessful?: UseResetFormAfterSubmitSuccessfulOptions;
+    /** Request submit via listener on form change. */
+    submitOnChange?: boolean;
+    /** Reset form after submit. */
+    resetFormOnSubmitted?: UseResetFormOnSubmittedOptions;
     /**
      * Control dev tool options.
      * (Lazy-loaded when truthy value supplied.

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

@@ -1,3 +1,4 @@
+import { MaybePromise } from '@trpc/server/unstable-core-do-not-import';
 import { default as React } from 'react';
 import { SubmitErrorHandler, UseFormProps } from 'react-hook-form';
 import { RhfUtilsFormOptions } from './RhfUtilsFormOptions';
@@ -7,7 +8,7 @@ import { UseRhfUtilsFormOnSubmitContext, UseRhfUtilsFormOnSubmitErrorContext } f
 
 export type UseRhfUtilsFormProps<TFieldValues extends SafeFieldValues, TTransformedValues extends SafeFieldValues> = {
     defaultValues?: UseFormProps<TFieldValues>['defaultValues'];
-    onSubmit?: (values: TTransformedValues, context: UseRhfUtilsFormOnSubmitContext<TFieldValues, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => unknown | Promise<unknown>;
+    onSubmit?: (values: TTransformedValues, context: UseRhfUtilsFormOnSubmitContext<TFieldValues, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => MaybePromise<unknown>;
     /** Submit error handler. (Only for errors not of instance `FormError`, which are handled internally.) */
     onSubmitError?: (error: unknown, context: UseRhfUtilsFormOnSubmitErrorContext<TFieldValues, TTransformedValues>, event: React.BaseSyntheticEvent<SubmitEvent>) => void;
     /** Submit handler when form is invalid. */

package/dist/types/form/utils/useShouldFormBlockNavigation.d.ts

@@ -0,0 +1,13 @@
+import { FieldValues, FormState } from 'react-hook-form';
+
+/**
+ * Returns `boolean` value when the form should block navigation.
+ *
+ * Evaluates to `true` when `enabled` and `isDirty` except when `isSubmitting` and `isValid`,
+ * because we don't want to block navigation when the form is submitting and valid.
+ *
+ * NOTE: If you need to block navigation during a potentially prolonged submission request,
+ * you will need to provide your own behaviors above and beyond this hook.
+ */
+declare const useShouldFormBlockNavigation: (enabled: boolean, { isDirty, isSubmitting, isValid }: FormState<FieldValues>) => boolean;
+export default useShouldFormBlockNavigation;

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

@@ -1,3 +1,5 @@
+import { MaybePromise } from '@trpc/server/unstable-core-do-not-import';
+
 /**
  * Calls a callback after a successful submit and after a form reset.
  *
@@ -7,7 +9,7 @@
  * Using RHF and following its rules, we are not able to get the state `isSubmitSuccessful=true` and `isDirty=false`.
  * So, this has to keep track of previous state.
  *
- * SubmitSuccessfulAndReset = was `isSubmitSuccessful` and now `!isSubmitSuccessful && !isDirty`
+ * SubmitSuccessfulAndReset = was `isSubmitSuccessful` and now `!isDirty`
  */
-declare const useFormOnSubmitSuccessfulAndReset: (callback?: () => void) => void;
+declare const useFormOnSubmitSuccessfulAndReset: (callback?: () => MaybePromise<unknown>) => void;
 export default useFormOnSubmitSuccessfulAndReset;

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

@@ -0,0 +1,6 @@
+import { MaybePromise } from '@trpc/server/unstable-core-do-not-import';
+
+declare const useFormOnSubmitted: (callback?: (success: boolean) => MaybePromise<unknown>, options?: {
+    successful?: boolean;
+}) => void;
+export default useFormOnSubmitted;

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

@@ -0,0 +1,23 @@
+/**
+ * Configuration for hook.
+ * - `undefined`: disabled
+ */
+export type UseResetFormOnSubmittedOptions = undefined | {
+    /**
+     * Reset values on submit successful.
+     * - `'defaults'`: reset to default values
+     * - `'current'`: reset to current values
+     */
+    onSuccess?: 'defaults' | 'current';
+    /**
+     * Reset values on submit error. (reset to default values)
+     */
+    onError?: 'defaults';
+};
+/**
+ * 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 useResetFormOnSubmitted: (options: UseResetFormOnSubmittedOptions) => void;
+export default useResetFormOnSubmitted;

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

@@ -1,6 +1,7 @@
 import { default as React } from 'react';
 
 declare const useSubmitFormOnChange: (formRef: React.RefObject<HTMLFormElement>, options?: {
+    /** Disable-able so that default behavior is enabled for sake of simplicity of usage. */
     disabled?: boolean;
 }) => void;
 export default useSubmitFormOnChange;

package/dist/types/utils/types.d.ts

@@ -0,0 +1 @@
+export type MaybePromise<T> = T | Promise<T>;

package/dist/types/utils/useRefIfValueWasTrue.d.ts

@@ -0,0 +1 @@
+export declare const useRefIfValueWasTrue: (value: boolean) => readonly [boolean, () => void];

package/package.json

@@ -2,7 +2,7 @@
   "name": "@paragrav/rhf-utils",
   "author": "paragrav.dev",
   "license": "MIT",
-  "version": "0.0.121",
+  "version": "0.0.125",
   "description": "Integration utilities for react-hook-form.",
   "type": "module",
   "sideEffects": false,

package/dist/esm/submit/useFormOnSubmitSuccessful.mjs

@@ -1,11 +0,0 @@
-import s from "react";
-import { useFormState as u } from "react-hook-form";
-const r = (t) => {
-  const { isSubmitSuccessful: e } = u();
-  s.useEffect(() => {
-    t && e && t();
-  }, [t, e]);
-};
-export {
-  r as default
-};

package/dist/esm/submit/useResetFormOnSubmitError.mjs

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

package/dist/esm/submit/useResetFormOnSubmitSuccessful.mjs

@@ -1,20 +0,0 @@
-import { useFormContext as a } from "react-hook-form";
-import l from "./useFormOnSubmitSuccessful.mjs";
-const f = (e) => {
-  const { reset: u, getValues: t } = a();
-  l(() => {
-    if (!e)
-      return;
-    const r = e === !0 || e.values === void 0 ? void 0 : e.values.resetToCurrentValues ? t() : e.values, s = e === !0 ? (
-      // default
-      void 0
-    ) : (
-      // custom settings
-      e.state
-    );
-    u(r, s);
-  });
-};
-export {
-  f as default
-};